import { type ChildRunExecutionResult, type ChildRunExecutionSnapshot } from "../child-run/execution-snapshot.js";
/** State for hosted child lifecycle terminal. */
export interface HostedChildLifecycleTerminalState {
    status: "completed" | "failed" | "cancelled";
    usage?: {
        inputTokens?: number;
        outputTokens?: number;
        totalTokens?: number;
    };
    terminalErrorCode?: string | null;
    terminalErrorMessage?: string | null;
}
export interface HostedChildLifecycleCompletedState extends Omit<HostedChildLifecycleTerminalState, "status"> {
    status: "completed";
}
/** Public API contract for hosted child lifecycle adapter. */
export interface HostedChildLifecycleAdapter {
    pending?: () => Promise<void> | void;
    running?: () => Promise<void> | void;
    completed?: (terminalState: HostedChildLifecycleTerminalState) => Promise<void> | void;
    failed?: (terminalState: HostedChildLifecycleTerminalState) => Promise<void> | void;
    cancelled?: (terminalState: HostedChildLifecycleTerminalState) => Promise<void> | void;
}
export interface HostedChildLifecycleErrorState extends Omit<HostedChildLifecycleTerminalState, "status"> {
    status: "failed" | "cancelled";
}
/** Options accepted by hosted child lifecycle runner. */
export interface HostedChildLifecycleRunnerOptions<TResult> {
    adapter: HostedChildLifecycleAdapter;
    execute: () => Promise<TResult> | TResult;
    resolveCompletedState?: (result: TResult) => Promise<HostedChildLifecycleCompletedState> | HostedChildLifecycleCompletedState;
    resolveErrorState: (error: unknown) => Promise<HostedChildLifecycleErrorState> | HostedChildLifecycleErrorState;
    onLifecycleError?: (error: unknown) => Promise<void> | void;
}
/** Result returned from hosted child lifecycle run. */
export type HostedChildLifecycleRunResult<TResult> = {
    status: "completed";
    result: TResult;
    terminalState: HostedChildLifecycleTerminalState;
} | {
    status: "failed" | "cancelled";
    error: unknown;
    terminalState: HostedChildLifecycleTerminalState;
};
/** Result returned from hosted child execution lifecycle. */
export type HostedChildExecutionLifecycleResult<TLocalResult extends ChildRunExecutionResult> = {
    status: "completed";
    result: TLocalResult;
    snapshot: ChildRunExecutionSnapshot;
    terminalState: HostedChildLifecycleTerminalState;
} | {
    status: "failed" | "cancelled";
    error: unknown;
    terminalState: HostedChildLifecycleTerminalState;
};
/** Should skip hosted child terminal persistence helper. */
export declare function shouldSkipHostedChildTerminalPersistence(terminalState: Pick<HostedChildLifecycleTerminalState, "terminalErrorCode">): boolean;
/** Options accepted by hosted child execution lifecycle. */
export interface HostedChildExecutionLifecycleOptions<TLocalResult extends ChildRunExecutionResult> {
    adapter: HostedChildLifecycleAdapter;
    executionFailedCode: string;
    abortSignal?: AbortSignal | undefined;
    execute: () => Promise<TLocalResult> | TLocalResult;
    getExecutionSnapshot: () => ChildRunExecutionSnapshot | null;
    onLifecycleError?: (error: unknown) => Promise<void> | void;
    skipTerminalPersistence?: (terminalState: HostedChildLifecycleTerminalState) => boolean;
}
/**
 * Terminal error code for a child whose work finished but whose terminal state
 * could not be persisted. Distinct from an execution failure code on purpose:
 * the child produced its result, the run record did not survive it.
 */
export declare const HOSTED_CHILD_FINALIZATION_FAILED_CODE = "CHILD_FINALIZATION_FAILED";
/** Run hosted child lifecycle. */
export declare function runHostedChildLifecycle<TResult>(options: HostedChildLifecycleRunnerOptions<TResult>): Promise<HostedChildLifecycleRunResult<TResult>>;
/** Run hosted child execution lifecycle. */
export declare function runHostedChildExecutionLifecycle<TLocalResult extends ChildRunExecutionResult>(options: HostedChildExecutionLifecycleOptions<TLocalResult>): Promise<HostedChildExecutionLifecycleResult<TLocalResult>>;
//# sourceMappingURL=child-lifecycle.d.ts.map