import type { StreamingStatus, TurnOutputBlock, TurnOutputBlockKind, TurnOutputBlockStatus } from './types.js';
export type TurnOutputMode = 'delta' | 'block' | 'snapshot' | 'status';
export interface TurnOutputSnapshot {
    turnId: string;
    messageId: string;
    text: string;
    status: StreamingStatus;
    blocks?: TurnOutputBlock[];
}
export interface TurnOutputBlockInput {
    id: string;
    kind: TurnOutputBlockKind;
    status?: TurnOutputBlockStatus;
    sequence?: number;
    title?: string;
    text?: string;
    summary?: string;
    detail?: string;
}
export interface BuildBoundedTurnTrailOptions {
    maxBlocks?: number;
    maxMetadataBytes?: number;
}
export interface TurnOutputControllerOptions {
    turnId: string;
    mode?: TurnOutputMode;
    throttleMs?: number;
    blockSeparator?: string;
    writeSnapshot: (snapshot: TurnOutputSnapshot) => void | Promise<void>;
    clearSnapshot: () => void | Promise<void>;
    schedule?: typeof setTimeout;
    cancel?: typeof clearTimeout;
}
export interface TurnOutputController {
    readonly turnId: string;
    readonly mode: TurnOutputMode;
    getText(): string;
    getStatus(): StreamingStatus;
    getBlocks(): TurnOutputBlock[];
    getFinalTrail(): TurnOutputBlock[];
    startThinking(text?: string): Promise<void>;
    startStreaming(text?: string): Promise<void>;
    appendDelta(delta: string): void;
    appendBlock(block: string): void;
    appendTextSegmentDelta(id: string, delta: string, patch?: Partial<Omit<TurnOutputBlockInput, 'id' | 'kind' | 'sequence' | 'text'>>): void;
    replaceTextSegmentSnapshot(id: string, text: string, patch?: Partial<Omit<TurnOutputBlockInput, 'id' | 'kind' | 'sequence' | 'text'>>): void;
    replaceSnapshot(text: string, status?: StreamingStatus): Promise<void>;
    setStatus(status: StreamingStatus, text?: string): Promise<void>;
    addBlock(block: TurnOutputBlockInput): Promise<TurnOutputBlock>;
    updateBlock(id: string, patch: Partial<Omit<TurnOutputBlockInput, 'id' | 'sequence'>>): Promise<TurnOutputBlock | null>;
    completeBlock(id: string, patch?: Partial<Omit<TurnOutputBlockInput, 'id' | 'sequence' | 'status'>>): Promise<TurnOutputBlock | null>;
    failBlock(id: string, patch?: Partial<Omit<TurnOutputBlockInput, 'id' | 'sequence' | 'status'>>): Promise<TurnOutputBlock | null>;
    flush(status?: StreamingStatus): Promise<void>;
    waitingInput(): Promise<void>;
    interrupt(): Promise<void>;
    clear(): Promise<void>;
    /**
     * Deliberate silence: blank the node (text '' and an EXPLICIT empty blocks
     * array) and then delete it, so onStreamingCleared sees empty content and
     * skips the salvage fallback. The empty array is load-bearing: merge writers
     * (POST /streaming, OpenClaw PATCH) leave stale blocks behind when the key
     * is absent, and the trigger then synthesizes salvage text from block titles.
     */
    blankAndClear(): Promise<void>;
}
export declare const DEFAULT_TURN_TRAIL_MAX_BLOCKS = 20;
export declare const DEFAULT_TURN_TRAIL_METADATA_BUDGET_BYTES = 2500;
export declare function buildBoundedTurnTrail(blocks: readonly TurnOutputBlock[], options?: BuildBoundedTurnTrailOptions): TurnOutputBlock[];
export declare function createTurnOutputController(options: TurnOutputControllerOptions): TurnOutputController;