/**
 * runToolLiveView — shared live-run state machine + produce() seam.
 *
 * Consolidates the Ink lifecycle duplicated across fit/graph/sim/yagni runners:
 * loading → running → done | error, session/envelope capture, setExitCode on
 * hard errors, and the ThemeProvider/ClockProvider render boundary.
 */
import { type LiveRunDoneData, type LiveRunHeaderMeta, type ProgressCallback, type ProgressEvent, type ProgressSurface } from '@opensip-cli/cli-ui';
import { type LiveViewContext, type ToolRunCompletion, type ToolSessionContribution } from '@opensip-cli/core';
import type { SignalEnvelope } from '@opensip-cli/contracts';
/** Open string so new tools can contribute live views without editing cli-live. */
export type LiveRunTool = string;
export type LiveRunOutcome = {
    readonly kind: 'done';
    readonly done: LiveRunDoneData;
    readonly session?: ToolSessionContribution;
    readonly envelope?: SignalEnvelope;
} | {
    readonly kind: 'error';
    readonly message: string;
    readonly exitCode: number;
    readonly suggestion?: string;
};
export interface LiveRunProduceHelpers {
    readonly setHeaderMetadata: (metadata: readonly LiveRunHeaderMeta[]) => void;
    readonly setShowRunHeader: (show: boolean) => void;
    readonly setRunning: (subscribe: (cb: ProgressCallback) => void) => void;
}
export interface LiveRunSpec {
    readonly tool: LiveRunTool;
    readonly meta: {
        readonly title: string;
        readonly description: string;
    };
    readonly surface: ProgressSurface;
    readonly loadingSurface?: ProgressSurface;
    readonly verbose: boolean;
    readonly quiet: boolean;
    readonly progressOnDone?: boolean;
    readonly loadingMessage?: string;
    readonly initialHeaderMetadata?: readonly LiveRunHeaderMeta[];
    readonly initialShowRunHeader?: boolean;
    readonly projectPath?: string;
    readonly walkedUp?: number;
    readonly produce: (emit: (event: ProgressEvent) => void, helpers: LiveRunProduceHelpers) => Promise<LiveRunOutcome>;
}
export interface HostGlue {
    readonly setExitCode?: (code: number) => void;
    readonly liveContext?: LiveViewContext;
}
/**
 * Render a tool live view through the shared shell. Resolves once the Ink app
 * exits with the captured {@link ToolRunCompletion}. When the run is an embedded
 * suite step, skips Ink entirely and runs {@link runToolLiveHeadless} so only the
 * suite's own live view reaches the terminal.
 */
export declare function runToolLiveView(spec: LiveRunSpec, glue?: HostGlue): Promise<ToolRunCompletion>;
//# sourceMappingURL=run-tool-live-view.d.ts.map