Skip to main content

Module responses_ws

Module responses_ws 

Source
Expand description

Native Responses WebSocket turns over a single host-authenticated connection.

Only connect constructs a session. Its destination/authentication remains bound to the host connection; this module never reconnects, reroutes, retries a generation, or substitutes a previous_response_id. The host enforces wall-clock/idle deadlines and WebSocket wire framing. No native clock is read.

A turn exclusively borrows its session. Dropping it before a validated terminal closes the owned socket handles and poisons reuse, including when cancellation happens before polling, during send readiness/flush, or receive. The host transport owns the concrete cleanup caused by dropping its handles; an asynchronous close handshake cannot be promised from Drop.

All 53 declared event shapes decode, but validated turns follow the native collector’s policy: four orphaned audio/transcript shapes are Unsupported because the canonical response DTO has no audio item. There is no implicit audio consumer, transcript substitution, or fabricated terminal response.

Structs§

ResponsesWsConnectError
Failed preflight/transport, or contradictory connected-handshake metadata. A normal HTTP rejection is the untouched ResponsesWsConnect::Rejected.
ResponsesWsLimits
ResponsesWsSession
ResponsesWsTurn

Enums§

ResponsesWsConnect

Functions§

connect
The host supplies the actual upgrade, including authentication and deadlines. HTTP/1.1 101 and a successful HTTP/2 CONNECT status remain unmodified.