import type { HostedLifecycleTerminalState } from "./lifecycle.js";
import type { StreamSnapshot } from "../streaming/lifecycle/types.js";
/** Error shape for hosted terminal. */
export interface HostedTerminalError {
    code: string;
    message: string;
}
/** State for hosted response finalization. */
export interface HostedResponseFinalizationState<TMessage, TChunk> {
    persistedMessage: TMessage;
    finalizedMessage: TMessage;
    fallbackChunks: readonly TChunk[];
    hasIncompleteToolParts: boolean;
    metadata?: HostedLifecycleTerminalState["metadata"];
}
/** State for hosted detached finalization. */
export interface HostedDetachedFinalizationState<TChunk> {
    hasContent: boolean;
    fallbackChunks: readonly TChunk[];
    hasIncompleteToolParts: boolean;
}
/** Options accepted by finalize hosted response. */
export interface FinalizeHostedResponseOptions<TMessage, TChunk> {
    isAborted: boolean;
    getFinalStep: () => Promise<unknown>;
    buildState: (finalStep: unknown) => Promise<HostedResponseFinalizationState<TMessage, TChunk>> | HostedResponseFinalizationState<TMessage, TChunk>;
    shouldFailEmptyMessage: (input: {
        isAborted: boolean;
        message: TMessage;
    }) => boolean;
    resolveEmptyTerminalError: (input: {
        finalStep: unknown;
        streamError?: unknown | null;
    }) => HostedTerminalError | Promise<HostedTerminalError>;
    appendFallbackChunk: (chunk: TChunk) => Promise<void> | void;
    flushMirror: () => Promise<void> | void;
    dispatchTerminalState: (state: HostedLifecycleTerminalState) => Promise<void> | void;
    resolveTerminalState: (input: {
        isAborted: boolean;
        hasIncompleteToolParts: boolean;
    }) => HostedLifecycleTerminalState;
    cleanup: () => Promise<void> | void;
    streamError?: unknown | null;
}
/** Options accepted by finalize hosted detached. */
export interface FinalizeHostedDetachedOptions<TChunk> {
    isAborted: boolean;
    mirroredDurableOutput: boolean;
    getFinalStep: () => Promise<unknown>;
    buildState: (finalStep: unknown) => Promise<HostedDetachedFinalizationState<TChunk>> | HostedDetachedFinalizationState<TChunk>;
    resolveEmptyTerminalError: (input: {
        finalStep: unknown;
        streamError?: unknown | null;
    }) => HostedTerminalError | Promise<HostedTerminalError>;
    appendFallbackChunk: (chunk: TChunk) => Promise<void> | void;
    flushMirror: () => Promise<void> | void;
    dispatchTerminalState: (state: HostedLifecycleTerminalState) => Promise<void> | void;
    resolveTerminalState: (input: {
        isAborted: boolean;
        hasIncompleteToolParts: boolean;
    }) => HostedLifecycleTerminalState;
    cleanup: () => Promise<void> | void;
    streamError?: unknown | null;
}
/**
 * Read a known step finish reason from a hosted final step, or null.
 *
 * Returns every finish reason that marks a completed provider step,
 * including "tool-calls", which signals a tool handoff rather than run
 * completion. Unknown reasons and malformed steps read as null.
 */
export declare function readHostedFinishReason(finalStep: unknown): StreamSnapshot["finishReason"];
/** Response payload for finalize hosted. */
export declare function finalizeHostedResponse<TMessage, TChunk>(options: FinalizeHostedResponseOptions<TMessage, TChunk>): Promise<void>;
/** Finalize hosted detached helper. */
export declare function finalizeHostedDetached<TChunk>(options: FinalizeHostedDetachedOptions<TChunk>): Promise<void>;
//# sourceMappingURL=stream-finalization.d.ts.map