Interface DebugController

packages/core/src/debug/debugController.ts:245–348

 * Debug controller interface.
 */
export interface DebugController {
  /* --- Low-level Engine Access --- */

  /**
   * Enable debug tracing.
   * @param config - Optional configuration overrides
   */
  enable(config?: Partial<DebugConfig>): Promise<void>;

  /**
   * Disable debug tracing.
   */
  disable(): Promise<void>;

  /**
   * Reset (clear) all debug records while keeping tracing enabled.
   */
  reset(): Promise<void>;

  /* --- Query Interface --- */

  /**
   * Query debug records from the engine.
   * @param filter - Optional query filter
   */
  query(filter?: DebugQuery): Promise<readonly DebugRecord[]>;

  /**
   * Get the payload for a specific record.
   * @param recordId - The record ID
   */
  getPayload<T extends DebugPayload>(recordId: bigint): Promise<T | null>;

  /**
   * Get debug statistics.
   */
  getStats(): Promise<DebugStats>;

  /**
   * Export all debug records to a buffer for offline analysis.
   */
  export(): Promise<Uint8Array>;

  /**
   * Export a deterministic, versioned JSON debug bundle.
   */
  exportBundle(options?: DebugBundleExportOptions): Promise<DebugBundle>;

  /**
   * Export the debug bundle as UTF-8 JSON bytes.
   */
  exportBundleBytes(options?: DebugBundleExportOptions): Promise<Uint8Array>;

  /* --- High-level Features --- */

  /**
   * Frame inspector for analyzing frame history.
   */