port(omniroute): #7093 - bound relay SSE stream lifetime past response headers

[bloodf]

Summary

• What changed: Port of fix(relay): bound Bifrost stream lifetime diegosouzapw/OmniRoute#7093 — bound relay SSE stream lifetime so relay streams are torn down deterministically past response headers / terminal events (abort, timeout, malformed terminal) instead of leaking listeners and hanging sockets. Adds open-sse/utils/relayStreamLifecycle.js (lifecycle helper) and open-sse/utils/quotaTerminalReason.js (terminal-reason classification), wired into open-sse/executors/base.js, open-sse/handlers/chatCore.js, open-sse/services/providerAttemptContext.js, open-sse/utils/proxyFetch.js.
• Why it changed: upstream OmniRoute #7093 fixed relay SSE streams whose lifetime was unbounded past response headers, leaking resources and stalling cleanup on abort/timeout paths; durindoor shares the relay subsystem and had the same unbounded lifetime.

Type

• fix: — bug fix (resource-leak / cleanup correctness)

Breaking changes

• No

Testing

• What was tested: the 3 new unit suites covering the ported behavior — tests/unit/relay-stream-lifecycle.test.js, tests/unit/relay-terminal-reason.test.js, tests/unit/base-executor-relay-sse.test.js — plus lint and production build.
• Commands run: npm run lint; npm run build; vitest run unit/relay-stream-lifecycle.test.js unit/relay-terminal-reason.test.js unit/base-executor-relay-sse.test.js; bash .omc/gate.sh <worktree> (all under pinned Node 20.20.2).
• Evidence: lint 0 errors (168 pre-existing warnings); Next.js build completed; targeted suites 3 files / 23 tests all pass. Full local gate run hit fleet-wide host load contention (load avg 130+/16) causing mass timeouts in 86 unrelated suites — signature matches the flake confirmed by sibling merge agents; CI required checks on this PR are the authoritative full-suite run.

Checklist

• Tests added or updated for behavioral changes (3 new suites, 23 tests)
• No new dependencies without explicit justification (none added)
• Conventional commit used (port(omniroute): #7093 - bound relay SSE stream lifetime past response headers)
• CHANGELOG updated if this change is user-facing (internal relay robustness fix; doc artifact = JSDoc module comments at the new change sites relayStreamLifecycle.js and quotaTerminalReason.js, per AGENTS §1 doc-artifact options)
• No secrets, keys, credentials, or tokens committed

Existing PRs

Searched open + closed PRs for 7093 / relay SSE stream lifetime: no duplicates — only this PR (#267). Related relay work merged earlier (#46 provider batch, #145 CI-gate stabilization) does not cover relay stream lifetime bounding.

Provenance

Agent-generated port. Model: durindoor/kimi/kimi-k2.7 via Oh My Pi harness; implemented by a wave-G port subagent, verified and merged via the upstream-pr-import orchestration (worktree .omc/wt-port-om-7093, branch port/omniroute-7093, head 1ed9203). No plugins beyond the harness.

Ported-By: port(omniroute) wave-G

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1ed92036d8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1fc4eadba3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".