/** State for hosted lifecycle terminal. */
export interface HostedLifecycleTerminalState {
    status: "completed" | "failed" | "cancelled";
    metadata?: {
        modelId?: string;
        usage?: {
            inputTokens?: number;
            outputTokens?: number;
            cachedInputTokens?: number;
            cacheCreationInputTokens?: number;
            cacheReadInputTokens?: number;
            reasoningTokens?: number;
        };
        usageCaptureStatus?: "complete" | "partial" | "missing";
    };
    terminalErrorCode?: string | null;
    terminalErrorMessage?: string | null;
}
/** Public API contract for hosted lifecycle execution. */
export interface HostedLifecycleExecution<TChunk> {
    stream: AsyncIterable<TChunk>;
    waitForFinish: () => Promise<void>;
}
/** Public API contract for hosted lifecycle adapter. */
export interface HostedLifecycleAdapter<TRun, TChunk> {
    startRun: (input: {
        abortSignal: AbortSignal;
    }) => Promise<TRun> | TRun;
    appendEvents?: (run: TRun, chunk: TChunk) => Promise<void> | void;
    persistTranscriptChunk?: (run: TRun, chunk: TChunk) => Promise<void> | void;
    persistTranscriptTerminalState?: (run: TRun, terminalState: HostedLifecycleTerminalState) => Promise<void> | void;
    onTerminalState?: (run: TRun, terminalState: HostedLifecycleTerminalState) => Promise<void> | void;
    finalizeRun?: (run: TRun, terminalState: HostedLifecycleTerminalState) => Promise<void> | void;
    cancelRun?: (run: TRun, terminalState: HostedLifecycleTerminalState) => Promise<void> | void;
}
/** Options accepted by hosted lifecycle runner. */
export interface HostedLifecycleRunnerOptions<TRun, TChunk> {
    abortSignal: AbortSignal;
    execution: HostedLifecycleExecution<TChunk>;
    adapter: HostedLifecycleAdapter<TRun, TChunk>;
    resolveTerminalState: () => Promise<HostedLifecycleTerminalState> | HostedLifecycleTerminalState;
    resolveErrorTerminalState?: (error: unknown) => Promise<HostedLifecycleTerminalState> | HostedLifecycleTerminalState;
}
/** Result returned from hosted lifecycle run. */
export interface HostedLifecycleRunResult<TRun> {
    run: TRun;
    terminalState: HostedLifecycleTerminalState;
}
/** Run hosted lifecycle. */
export declare function runHostedLifecycle<TRun, TChunk>(options: HostedLifecycleRunnerOptions<TRun, TChunk>): Promise<HostedLifecycleRunResult<TRun>>;
//# sourceMappingURL=lifecycle.d.ts.map