import { type HostedLifecycleExecution } from "./lifecycle.js";
/** Public API contract for hosted response stream writer. */
export interface HostedResponseStreamWriter<TChunk> {
    write: (chunk: TChunk) => void;
}
/** State for hosted response stream heartbeat. */
export interface HostedResponseStreamHeartbeatState {
    heartbeatCount: number;
    elapsedSeconds: number;
}
/** Public API contract for hosted response stream heartbeat. */
export interface HostedResponseStreamHeartbeat<TChunk> {
    intervalMs?: number;
    buildChunk: () => TChunk;
    onBeat?: (state: HostedResponseStreamHeartbeatState) => void;
    onStop?: (state: HostedResponseStreamHeartbeatState) => void;
}
export interface RunHostedResponseStreamWithHeartbeatOptions<TChunk> {
    execution: HostedLifecycleExecution<TChunk>;
    writer: HostedResponseStreamWriter<TChunk>;
    heartbeat?: HostedResponseStreamHeartbeat<TChunk>;
    runId?: string;
    /** Optional abort signal for external cancellation of the hosted lifecycle. */
    abortSignal?: AbortSignal;
}
/** Run hosted response stream with heartbeat. */
export declare function runHostedResponseStreamWithHeartbeat<TChunk>(options: RunHostedResponseStreamWithHeartbeatOptions<TChunk>): Promise<void>;
//# sourceMappingURL=response-stream.d.ts.map