import type { MonotonicClock, StreamLifecyclePolicy, StreamProviderDeadlineKind, StreamSnapshot } from "./types.js";
export interface TrackedProviderRead<T> {
    readonly promise: Promise<IteratorResult<T>>;
    readonly settled: boolean;
    readonly settledAtMs: number | null;
    readonly result: IteratorResult<T> | null;
    readonly error: unknown;
}
export type StreamReadRace<T> = {
    kind: "part";
    result: IteratorResult<T>;
} | {
    kind: "read_error";
    error: unknown;
} | {
    kind: "status";
    toolCallIds: readonly string[];
} | {
    kind: "provider_deadline";
    deadline: StreamProviderDeadlineKind;
} | {
    kind: "attempt_timeout";
} | {
    kind: "cancelled";
};
export interface StreamDeadlineController {
    readonly attemptDeadlineMs: number;
    resumeProviderWait(snapshot: Readonly<StreamSnapshot>): void;
    pauseProviderWait(): void;
    noteSemanticProgress(snapshot: Readonly<StreamSnapshot>): void;
    raceProviderRead<T>(read: TrackedProviderRead<T>, signal: AbortSignal): Promise<StreamReadRace<T>>;
    dispose(): void;
}
export declare function trackProviderRead<T>(promise: Promise<IteratorResult<T>>, clock: MonotonicClock): TrackedProviderRead<T>;
export declare function createStreamDeadlineController(input: {
    clock: MonotonicClock;
    policy: StreamLifecyclePolicy;
    attemptDeadlineMs: number;
    disposeSignal: AbortSignal;
}): StreamDeadlineController;
/**
 * One absolute timer primitive shared by the lifecycle runner and the
 * compatibility watchdog. The callback fires when the schedule elapses;
 * dispose() releases it without firing.
 */
export interface AbsoluteDeadlineTimer {
    schedule(callback: () => void, delayMs: number): unknown;
    cancel(handle: unknown): void;
}
export declare function createClockDeadlineTimer(clock: MonotonicClock): AbsoluteDeadlineTimer;
export declare function createAbsoluteDeadline(input: {
    timer: AbsoluteDeadlineTimer;
    delayMs: number;
    onDeadline: () => void;
}): {
    dispose(): void;
};
//# sourceMappingURL=deadlines.d.ts.map