fix(openai): recover stale Responses WebSocket connections

[rosetta-livekit-bot]

Summary

• recover a cached stale OpenAI Responses WebSocket by evicting it and reconnecting before one bounded resend
• restore ConnectionPoolOptions.connectionError source compatibility and add atomic reuse metadata
• make pool prewarming and Responses connection attempts observable, idempotent, cancellable, and awaited during shutdown
• preserve request/response IDs, metrics, typed upgrade errors, and post-open WebSocket error handling
• add deterministic local WebSocket/TCP coverage for stale recovery, fresh failures, 401 classification, cancellation, retry bounds, and socket/listener cleanup
• retain an OpenAI plugin patch changeset

Python parity

Compared with the Python stale-Responses-WebSocket recovery implementation and current JS behavior. Recovery remains restricted to known stale failures on reused sockets; fresh websocket_closed, ordinary authentication 401s, and fresh send failures are not hidden or retried. The reconnect happens before resend, retries are bounded, and failures preserve normal provider classification.

JS additionally tracks and cancels eager/background connection work through the generic ConnectionPool lifecycle.

Tests

• strict red-green API compatibility coverage for optional connectionError callbacks and omitted rejection values
• ConnectionPool/type tests — 22 passed
• Responses WebSocket tests — all focused local-boundary tests passed, credentialed cases skipped
• full agents suite — 110 files, 1,467 passed and 5 skipped
• full OpenAI plugin suite — 81 passed and 7 skipped
• pnpm typecheck — 33/33 tasks passed
• exact-head pnpm build — 40/40 tasks passed
• changed-file lint, Prettier, IDE diagnostics, and git diff --check — clean
• independent final gates — Spec compliance: APPROVED and Code quality: APPROVED, no findings

API Extractor remains blocked only by documented base-branch namespace-export/missing-config issues; declaration generation passes.

Deterministic transport verification

Credential-free loopback fixtures prove the actual transport predicates:

• cached stale socket request indices [0, 0, 1], showing reuse then reconnect before resend
• fresh websocket_closed, ordinary auth 401, and fresh send failures make one attempt and remain visible
• stale reused-send retries remain bounded
• hanging upgrade cancellation leaves zero live sockets
• keep-alive unauthorized upgrade is explicitly terminated and preserves x-request-id
• malformed post-open frame reaches one typed request failure with no uncaught EventEmitter error or listener leak
• pending response cancellation closes its socket

Cue voice is inapplicable: a voice turn cannot create or observe the stale provider WebSocket/401 condition. The local transport boundaries are the behavior-level evidence for this port.

---

Ported from livekit/agents#6583

[changeset-bot]

🦋 Changeset detected

Latest commit: 9459222

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 39 packages

Name	Type
@livekit/agents	Patch
@livekit/agents-plugin-openai	Patch
@livekit/agents-plugin-anam	Patch
@livekit/agents-plugin-anthropic	Patch
@livekit/agents-plugin-assemblyai	Patch
@livekit/agents-plugin-azure	Patch
@livekit/agents-plugin-baseten	Patch
@livekit/agents-plugin-bey	Patch
@livekit/agents-plugin-cartesia	Patch
@livekit/agents-plugin-cerebras	Patch
@livekit/agents-plugin-deepgram	Patch
@livekit/agents-plugin-did	Patch
@livekit/agents-plugin-elevenlabs	Patch
@livekit/agents-plugin-fishaudio	Patch
@livekit/agents-plugin-google	Patch
@livekit/agents-plugin-hedra	Patch
@livekit/agents-plugin-hume	Patch
@livekit/agents-plugin-inworld	Patch
@livekit/agents-plugin-krisp	Patch
@livekit/agents-plugin-lemonslice	Patch
@livekit/agents-plugin-liveavatar	Patch
@livekit/agents-plugin-livekit	Patch
@livekit/agents-plugin-minimax	Patch
@livekit/agents-plugin-mistral	Patch
@livekit/agents-plugin-mistralai	Patch
@livekit/agents-plugin-neuphonic	Patch
@livekit/agents-plugin-perplexity	Patch
@livekit/agents-plugin-phonic	Patch
@livekit/agents-plugin-protoface	Patch
@livekit/agents-plugin-resemble	Patch
@livekit/agents-plugin-rime	Patch
@livekit/agents-plugin-runway	Patch
@livekit/agents-plugin-sarvam	Patch
@livekit/agents-plugin-silero	Patch
@livekit/agents-plugin-soniox	Patch
@livekit/agents-plugin-tavus	Patch
@livekit/agents-plugins-test	Patch
@livekit/agents-plugin-trugen	Patch
@livekit/agents-plugin-xai	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[toubatbrian]

Completed Rosetta repair and verification at exact head 7a6727c421c7dd5249162d1b6f03bd7b4451ab22.

The branch restores ConnectionPool API compatibility; makes connect/prewarm lifecycle cancellable and shutdown-safe; restricts recovery to stale reused sockets; preserves IDs/metrics/errors; and closes upgrade/post-open socket and listener leaks. Deterministic real local TCP/WebSocket fixtures, focused/full tests, typecheck, 40-task build, independent spec/quality review, and exact-head CI are green. Zero unresolved threads; mergeable. Cue is inapplicable because voice cannot create or observe the stale provider WebSocket condition.