/**
 * Debug PTY Capture — optional session recording for offline analysis.
 *
 * Activated by setting `PARALLAX_DEBUG_CAPTURE=1`. When enabled, all PTY
 * output and stdin are recorded per-session using `pty-state-capture`.
 * Capture files persist in `.parallax/pty-captures/<sessionId>/` after
 * the agent session is killed, enabling post-mortem analysis of state
 * transitions, stall classifications, and coordinator timing.
 *
 * The `pty-state-capture` package is dynamically imported — if not
 * installed, capture is silently disabled. This means it can stay out
 * of production dependencies entirely.
 *
 * @module services/debug-capture
 */
/**
 * Returns true if debug capture is enabled via environment variable.
 */
export declare function isDebugCaptureEnabled(): boolean;
/**
 * Open a capture session for a PTY session. Call this when spawning.
 */
export declare function captureSessionOpen(sessionId: string, agentType: string): Promise<void>;
/**
 * Feed PTY output data to the capture. Call this on every data chunk.
 */
export declare function captureFeed(sessionId: string, chunk: string, direction?: "stdout" | "stderr" | "stdin"): Promise<void>;
/**
 * Record a lifecycle event (session_ready, session_stopped, etc.).
 */
export declare function captureLifecycle(sessionId: string, event: "session_started" | "session_ready" | "session_stopped" | "session_error", detail?: string): Promise<void>;
/**
 * Get a snapshot of a capture session's current state.
 */
export declare function captureSnapshot(sessionId: string): unknown | null;
/** @internal Reset module state for testing only. */
export declare function _resetForTesting(): void;
//# sourceMappingURL=debug-capture.d.ts.map