Distillation

Date: Sep 16, 2026

• 🔴 (22:41) User stated sparse numeric identities never need more address space than the number of frames the accumulator is willing to process.
• 🔴 (22:41) User stated the caller-supplied frame override must be capped at the production ceiling so arithmetic remains practical and index + 1 always changes the value.
• 🟡 (22:41) In packages/gateway/src/stream/openai-responses.ts:1912-1915, maxSparseIndex is calculated as Math.min(opts.maxFrames ?? DEFAULT_MAX_SSE_FRAMES, DEFAULT_MAX_SSE_FRAMES), preventing a caller-supplied maxFrames from exceeding DEFAULT_MAX_SSE_FRAMES.
• 🟡 (22:41) accumulateResponsesSSEStream() in packages/gateway/src/stream/openai-responses.ts:1873-1933 accepts validation, stopAtTerminal, signal, inactivityMs, maxFrames, onSemanticContent, onValidatedEvent, allowFailureTerminal, requireCompletedTerminal, injected state, and onReader; strict validation configures parseSSEStream() with requireEventTerminator: true, maxTotalBytes: 4 * 1024 * 1024, and fatalUtf8: true.
• 🟡 (22:41) normalizeCodexResponsesEvent() in packages/gateway/src/stream/openai-responses.ts:1750-1789 rejects function-call argument deltas or done events after an item is in argumentDoneItems; records response.function_call_arguments.done, response.output_text.done, and response.refusal.done; binds effective tool identity on response.output_item.added; and removes completed output indexes from activeTextItems, activeToolItems, unboundTextItems, and unboundToolItems on response.output_item.done.
• 🟡 (22:41) validatedTerminalStatus() in packages/gateway/src/stream/openai-responses.ts:1791-1851 rejects terminal statuses failed and cancelled; validates event/status compatibility for response.completed, response.done, and response.incomplete; and permits known incomplete reasons max_output_tokens and content_filter.