import type { RawSseEvent } from "../types.js"; export type ResponsesWebSocketTransportErrorReason = "closed" | "socket-error" | "timeout" | "ping-failed" | "pong-timeout" | "unavailable" | "aborted" | "busy" | "send" | "queue-overflow" | "protocol" | "upgrade"; export type ResponsesWebSocketTransportErrorPhase = "connect" | "stream" | "before-terminal" | "first-event" | "idle"; /** A physical-channel failure; providers retain ownership of recovery policy. */ export declare class ResponsesWebSocketTransportError extends Error { readonly reason: ResponsesWebSocketTransportErrorReason; readonly phase: ResponsesWebSocketTransportErrorPhase; readonly status?: number; readonly headers?: Headers; constructor(reason: ResponsesWebSocketTransportErrorReason, phase: ResponsesWebSocketTransportErrorPhase, detail: string, options?: ErrorOptions & { status?: number; headers?: Headers; }); } export interface ResponsesWebSocketTimeouts { firstEventTimeoutMs?: number; idleTimeoutMs?: number; } export type ResponsesWebSocketExchange = { send: Record; } | { receive: true; }; export interface ResponsesWebSocketControlFrames { consume(frame: Record): boolean | Error; closed(error: Error): void; } export interface ResponsesWebSocketConnectionOptions { url: string; headers: Record; proxy?: string; connectTimeoutMs: number; maxIdleReuseMs: number; messageQueueCapacity: number; heartbeat?: { intervalMs: number; pongTimeoutMs: number; }; inspectUpgradeResponse?: boolean; onHandshakeHeaders?: (headers: Headers) => void; controlFrames?: ResponsesWebSocketControlFrames; } export declare function isResponsesWebSocketProgressEvent(event: unknown): boolean; /** One physical socket, one reader, and no generation replay or provider policy. */ export declare class ResponsesWebSocketConnection { #private; constructor(options: ResponsesWebSocketConnectionOptions); get handshakeHeaders(): Headers | undefined; get closedError(): ResponsesWebSocketTransportError | undefined; isOpen(): boolean; isConnecting(): boolean; hasActiveRequest(): boolean; isBusy(): boolean; isHealthyForReuse(): boolean; close(reason?: string): void; connect(signal?: AbortSignal): Promise; streamRequest(exchange: ResponsesWebSocketExchange, timeouts: ResponsesWebSocketTimeouts, signal?: AbortSignal, observer?: (event: RawSseEvent) => void, onOwned?: () => void): AsyncGenerator>; sendControl(frame: Record): void; }