Distillation

Date: Sep 16, 2026

• 🔴 (12:58) User specified that failed output is never authoritative and must not reach accounting hooks.
• 🔴 (12:58) User specified that failed usage/accounting never depends on client demand.
• 🟡 (12:58) Diff for packages/gateway/src/stream/openai-responses.ts extends ResponsesAccState with created: boolean, optional createdAt?: number, and optional lastAcceptedSequenceNumber?: number; initial state sets created: false.
• 🟡 (12:58) Diff adds cloneResponsesAccState(state) using structuredClone(state) and restoreResponsesAccState(state, snapshot), which deletes keys absent from the snapshot and restores values with Object.assign(state, snapshot).
• 🟡 (12:58) Diff defines private public-facing error text PUBLIC_GATEWAY_ERROR = "Gateway request failed" and exports RESPONSES_PROVIDER_FAILURE_LOG = "openai-responses provider failure".
• 🟡 (12:58) Provider-failure payload design in packages/gateway/src/stream/openai-responses.ts: only the fixed provider-failure payload may cross the gateway boundary; provider diagnostics and failed output remain private, while stable protocol fields remain available so clients can close the existing response lifecycle.
• 🟡 (12:58) Visible failure settlement in opts.validation === "codex" calls finish(false, finalizeUnsuccessfulResponsesAcc(state)), ensuring failed usage/accounting is finalized independently of downstream client demand.