prefix-safe-json 0.4.4 → 0.4.5

package/dist/providers/gemini.js

@@ -1,11 +1,211 @@
-import { PROJECTION_ONLY_ARGUMENTS_DIAGNOSTIC_CODE } from "../coordinator/diagnostic-codes.js";
+import { PROJECTION_ONLY_ARGUMENTS_DIAGNOSTIC_CODE, TOOL_ARGUMENTS_AFTER_END_DIAGNOSTIC_CODE, DUPLICATE_TOOL_END_DIAGNOSTIC_CODE, INVALID_CHOICE_INDEX_DIAGNOSTIC_CODE, DUPLICATE_CHOICE_INDEX_DIAGNOSTIC_CODE, } from "../coordinator/diagnostic-codes.js";
+// Reason priority for aggregating candidate-local terminal reasons into the
+// ONE stream-wide reason, at adapter.finish() time. Same values/order/
+// "worst wins" semantics as every other adapter's own REASON_PRIORITY in
+// this codebase (see openai-compatible.ts's own doc comment for the full
+// rationale) - duplicated locally rather than cross-imported, matching this
+// project's established convention for self-contained provider files.
+const REASON_PRIORITY = [
+    "provider_error",
+    "unknown",
+    "network_error",
+    "length",
+    "cancelled",
+    "complete",
+];
+// Phase B.7: re-checked against the installed @google/genai@2.21.0 SDK's
+// own `FinishReason` enum, which is considerably larger than the four
+// values previously handled: FINISH_REASON_UNSPECIFIED, STOP, MAX_TOKENS,
+// SAFETY, RECITATION, LANGUAGE, OTHER, BLOCKLIST, PROHIBITED_CONTENT,
+// SPII, MALFORMED_FUNCTION_CALL, IMAGE_SAFETY, UNEXPECTED_TOOL_CALL,
+// TOO_MANY_TOOL_CALLS, IMAGE_PROHIBITED_CONTENT, NO_IMAGE,
+// IMAGE_RECITATION, IMAGE_OTHER. Every value not explicitly recognized
+// below - including every one of those newer/rarer values - intentionally
+// falls through to "unknown", not "complete": unknown is non-executable
+// (parser.ts's isExecutable() requires reason === "complete" exactly), so
+// this is a safe, deliberate default, not a gap - see the regression
+// coverage proving MALFORMED_FUNCTION_CALL/UNEXPECTED_TOOL_CALL/
+// PROHIBITED_CONTENT/BLOCKLIST specifically cannot aggregate to "complete".
+function mapFinishReason(finishReason) {
+    if (finishReason === "STOP")
+        return "complete";
+    if (finishReason === "MAX_TOKENS")
+        return "length";
+    if (finishReason === "SAFETY" || finishReason === "RECITATION" || finishReason === "OTHER")
+        return "cancelled";
+    return "unknown";
+}
+/**
+ * Gemini `generateContentStream`-shaped streaming adapter.
+ *
+ * Terminal-ownership fix (Phase B hardening sweep, corrected in Phase B.1-
+ * B.7 after an identity-premise error was found in raw review):
+ * `candidate.finishReason` is candidate-LOCAL evidence only - a genuine
+ * multi-candidate (n>1) stream has one finishReason per candidate, each
+ * reporting only that candidate's own completion, never the whole provider
+ * stream's. Pre-fix, ANY candidate's finishReason directly emitted
+ * `provider_stream_end` and set this adapter's own global `finished` flag -
+ * the same "first choice to finish wrongly ends every choice" defect
+ * already found and fixed for OpenAI (Chat Completions plural and legacy
+ * singular) and Anthropic this session.
+ *
+ * Candidate IDENTITY correction (Phase B.1/B.2, the raw-review finding):
+ * this adapter used to key all candidate-local state by array POSITION
+ * within each chunk's own `candidates` list. The real wire field
+ * `candidate.index` ("Output only. The 0-based index of this candidate...
+ * useful for distinguishing between multiple candidates when
+ * candidate_count > 1" - confirmed against the installed
+ * `@google/genai@2.21.0` SDK's own types AND its real SSE parser, see
+ * test/integration/gemini-official-sdk-lifecycle.test.ts) is the
+ * authoritative identity instead. Array position silently breaks the
+ * moment a chunk omits an already-finished candidate (entirely normal - a
+ * provider has no reason to keep re-sending a candidate with nothing new
+ * to say) or reorders candidates within one chunk: real candidate 1's
+ * evidence arriving alone, at array position 0, was silently misattributed
+ * to candidate 0's own (already-terminal) identity - captured as genuine
+ * RED against real SDK-parsed chunks before this fix, not merely inferred.
+ *
+ * Fixed the same way as OpenAI's legacy path (P4.3) and Anthropic (P4.2):
+ *   candidate.finishReason
+ *     -> records that candidate's own terminal StreamEndReason
+ *     -> does NOT emit provider_stream_end
+ *     -> does NOT set this adapter's global `finished` flag
+ *   finish(meta?)
+ *     -> the ONE provider_stream_end for this adapter's whole lifetime,
+ *        aggregating every recorded candidate-local reason (worst wins -
+ *        see REASON_PRIORITY above) with meta.reason.
+ *
+ * Post-provider-terminal handling (Phase B.6): the top-of-push()
+ * `if (this.finished) return [];` guard, previously the only adapter in
+ * this codebase deliberately retaining the pre-P0 silent-drop pattern, is
+ * REMOVED here too - normalization continues after adapter.finish(), and
+ * coordinator.ts's own `isFinished` gate provides the canonical
+ * post-provider-terminal handling, exactly like every other adapter. This
+ * is future-proofing / architectural consistency, NOT the closing of a
+ * demonstrated execution-authority gap: independently re-verified, not
+ * merely trusted, that no Gemini call can ever reach `execute` -
+ * PROJECTION_ONLY_ARGUMENTS_DIAGNOSTIC_CODE is unconditional on every
+ * functionCall and checked by decide.ts before status is even considered;
+ * gate.ts's takeDecision() re-derives fresh and only ever returns
+ * something for action==="execute". See the two-part epistemic
+ * distinction in this program's own final report: CORRECTNESS/
+ * architecture-consistency, never claimed as an execution-integrity fix.
+ *
+ * Call IDENTITY correction (P4.5, a genuine RED confirmed against real
+ * @google/genai@2.21.0-parsed chunks, not merely inferred): within one
+ * candidate, this adapter used to key each functionCall's own sourceKey by
+ * PART ARRAY POSITION (`candidate:{i}/part:{j}`). Each Gemini functionCall
+ * is object-level final delivery, never incrementally streamed (no
+ * position needs to stay stable WITHIN one call's own lifetime) - but
+ * array position is NOT stable ACROSS separate, unrelated calls delivered
+ * in separate chunks: two genuinely independent functionCalls (confirmed
+ * via the real SDK parser to carry distinct `id`s, distinct names, and
+ * distinct args) that happen to land at the same part-array-position in
+ * their own respective chunks were silently treated as the SAME call - the
+ * second's evidence colliding with and corrupting the first's
+ * already-closed identity (coordinator.ts's own E_DUPLICATE_TOOL_CALL_START
+ * plus a parser E_TRAILING_DATA), with the second call never surfacing as
+ * its own decision at all. This is the same class of identity-loss defect
+ * already found and fixed for candidate identity itself (P4.4) and for
+ * every other provider's own call/item/block identity this session - now
+ * closed at the function-call level too.
+ *
+ * Fixed by preferring the official wire field `functionCall.id` ("Optional.
+ * The unique id of the function call...") as the call identity when a
+ * valid non-empty string is present:
+ *   `candidate:{candidateIndex}/function-call-id:{id}`
+ * `id` is explicitly OPTIONAL per its own doc comment, and confirmed
+ * empirically (real SDK-parsed evidence) that the SDK passes through a
+ * functionCall with no `id` at all without complaint - never assumed
+ * present, never required, never a fail-closed precondition. When absent
+ * (or an empty string, treated identically to absent), this adapter falls
+ * back to a per-candidate, per-adapter-instance MONOTONIC OCCURRENCE
+ * COUNTER (`candidate:{candidateIndex}/function-call:{n}`) - deliberately
+ * NOT part array position: the counter is advanced by THIS adapter's own
+ * processing order, never by anything the provider could reorder or omit
+ * across chunks, so it remains genuinely unique for the adapter's whole
+ * lifetime regardless of where in a `parts[]` array a later, unrelated
+ * no-id call happens to land. This is real, forensically-traceable
+ * identity - never a claim of continuity between separate observations,
+ * and never a byte-level/positional reconstruction.
+ *
+ * A REPEATED identical `functionCall.id` under the same candidate (or a
+ * no-id counter value, which can never repeat by construction) is treated
+ * as late/duplicate evidence for the one already-delivered call that
+ * sourceKey names - exactly TOOL_ARGUMENTS_AFTER_END_DIAGNOSTIC_CODE's own
+ * existing meaning, reusing `candidateSourceKeys`'s own existing
+ * "every sourceKey ever started, never cleared" tracking rather than a new
+ * mechanism (see push()). Official Gemini semantics document no supported
+ * continuation/streaming mechanism for a single function call at all
+ * (`partialArgs`, `willContinue`, `FunctionCallingConfig.
+ * streamFunctionCallArguments` are all explicitly "not supported in Gemini
+ * API" per the installed SDK's own doc comments) - so a repeated id is
+ * never treated as a legitimate multi-chunk continuation of the same call,
+ * only as suspect duplicate evidence disqualifying the real call it names.
+ * A different `id` under a DIFFERENT candidate is never merged with this
+ * one: identity is candidate-scoped first, exactly as P4.4 already
+ * established - official semantics document `id` only as a response-
+ * correlation mechanism (implying uniqueness where populated) and never
+ * claim a cross-candidate-global uniqueness scope, so candidate-scoping
+ * remains the conservative, evidence-supported default.
+ */
 export class GeminiStreamAdapter {
     provider = "gemini";
     sequence = 0;
     finished = false;
+    // candidateIndex (the real wire `candidate.index`, never array position)
+    // -> that candidate's own first-recorded terminal StreamEndReason. Never
+    // overwritten once set for a given candidate - a second/conflicting
+    // finishReason for the same candidate is reported as candidate-local
+    // post-terminal evidence (see push()), not silently applied over the
+    // first. Read by finish() to aggregate one stream-wide reason.
+    candidateTerminalReasons = new Map();
+    // The same candidates' own RAW (pre-normalization) finishReason strings,
+    // keyed identically - observability only, mirrored onto the aggregated
+    // provider_stream_end's own providerReason.
+    candidateTerminalProviderReasons = new Map();
+    // Phase B.5: every sourceKey EVER started under a real candidate index,
+    // never cleared. Read only when late/duplicate evidence arrives for an
+    // already-terminal candidate, so the disqualifying diagnostic can be
+    // attributed to every REAL, already-tracked call under that candidate
+    // (exact attribution) rather than a synthetic, never-resolvable
+    // "candidate:{i}" identity alone - mirrors
+    // OpenAICompatibleStreamAdapter's own allSourceKeysByChoice exactly, for
+    // the identical reason (a brand-new call is never created under an
+    // already-terminal candidate, so a diagnostic attached only to ITS OWN
+    // sourceKey could sit forever unresolved and disqualify nothing real).
+    candidateSourceKeys = new Map();
+    // P4.5: candidateIndex -> how many no-`functionCall.id` calls have been
+    // observed under that candidate so far, in THIS adapter's own processing
+    // order. Never reset, only ever incremented immediately before use - the
+    // fallback call identity when `functionCall.id` is absent/empty. Advanced
+    // by local processing order, never by provider-controlled array
+    // position, so it cannot collide across chunks the way raw part index
+    // could (see the class-level doc comment).
+    noIdFunctionCallCounters = new Map();
+    // P4.5: the real call identity for one functionCall observation under a
+    // known-valid candidateIndex. Prefers the official `functionCall.id`
+    // when it is a valid, non-empty string; otherwise advances and uses this
+    // candidate's own no-id occurrence counter. The two key shapes
+    // (`function-call-id:` vs `function-call:`) are deliberately distinct so
+    // an id-bearing call and a no-id call can never collide with each other
+    // even if a numeric id happened to look like a counter value.
+    callSourceKey(candidateIndex, fc) {
+        if (typeof fc.id === "string" && fc.id.length > 0) {
+            return `candidate:${candidateIndex}/function-call-id:${fc.id}`;
+        }
+        const next = (this.noIdFunctionCallCounters.get(candidateIndex) ?? 0) + 1;
+        this.noIdFunctionCallCounters.set(candidateIndex, next);
+        return `candidate:${candidateIndex}/function-call:${next - 1}`;
+    }
     push(rawEvent) {
-        if (this.finished)
-            return [];
+        // No `finished` early return here (Phase B.6) - see the identical fix
+        // and rationale in every other adapter's push()
+        // (GHSA-3xpw-9694-2xxp-class invariant). Gemini has no live execution
+        // authority for this to protect today (see the class-level doc comment
+        // above), but the coordinator's own isFinished gate is still the
+        // canonical place post-provider-terminal handling belongs, not a
+        // second, adapter-local silent-drop mechanism.
         const events = [];
         if (!rawEvent || typeof rawEvent !== "object") {
             events.push({
@@ -20,12 +220,170 @@ export class GeminiStreamAdapter {
         }
         const chunk = rawEvent;
         if (Array.isArray(chunk.candidates)) {
-            for (const [candidateIndex, candidate] of chunk.candidates.entries()) {
+            // Duplicate-index detection within one chunk - mirrors
+            // OpenAICompatibleStreamAdapter's/OpenAIStreamAdapter's own
+            // choiceCounts pre-pass exactly (Phase B.3).
+            const candidateCounts = new Map();
+            for (const candidate of chunk.candidates) {
+                if (Number.isInteger(candidate.index) && candidate.index >= 0) {
+                    candidateCounts.set(candidate.index, (candidateCounts.get(candidate.index) ?? 0) + 1);
+                }
+            }
+            for (const candidate of chunk.candidates) {
+                // Choice-index validity (Phase B.3): a candidate with no
+                // trustworthy explicit index must never be silently assumed to be
+                // candidate 0 via array position - global, unattributable, fails
+                // the whole stream closed rather than guessing (same fail-closed
+                // posture INVALID_CHOICE_INDEX_DIAGNOSTIC_CODE already has for the
+                // OpenAI paths - reused rather than inventing a new code, since
+                // the identity ambiguity it represents is identical here). A
+                // finishReason-only candidate (no functionCall evidence at all)
+                // with an invalid index carries no tracked identity to protect
+                // and is simply skipped, not diagnosed - matches the identical,
+                // already-established design for OpenAI's legacy path.
+                const hasFunctionCall = !!(candidate.content && Array.isArray(candidate.content.parts) && candidate.content.parts.some((p) => p.functionCall));
+                if (!Number.isInteger(candidate.index) || candidate.index < 0) {
+                    if (hasFunctionCall) {
+                        events.push({
+                            type: "provider_diagnostic",
+                            sequence: ++this.sequence,
+                            provider: this.provider,
+                            code: INVALID_CHOICE_INDEX_DIAGNOSTIC_CODE,
+                            severity: "error",
+                            message: "Gemini candidate.index is missing, non-integer, or negative; candidate identity is ambiguous",
+                        });
+                    }
+                    continue;
+                }
+                const candidateIndex = candidate.index;
+                if ((candidateCounts.get(candidateIndex) ?? 0) > 1) {
+                    if (hasFunctionCall) {
+                        // Phase B.5's own "exact attribution when real calls exist"
+                        // principle applied consistently here too: a candidate-level
+                        // synthetic "candidate:{i}" identity can never resolve to a
+                        // real "candidate:{i}/part:{j}" sourceKey (this candidate may
+                        // have multiple real parts, unlike OpenAI's legacy path,
+                        // which has exactly one call per choice so the two happen to
+                        // coincide there) - if this candidate already has real,
+                        // already-tracked calls from earlier, legitimate evidence,
+                        // attribute to every one of them so the violation actually
+                        // disqualifies something real, not a permanently-unresolvable
+                        // pending diagnostic.
+                        const known = this.candidateSourceKeys.get(candidateIndex);
+                        if (known && known.size > 0) {
+                            for (const knownSourceKey of known) {
+                                events.push({
+                                    type: "provider_diagnostic",
+                                    sequence: ++this.sequence,
+                                    provider: this.provider,
+                                    callRef: { sourceKey: knownSourceKey },
+                                    code: DUPLICATE_CHOICE_INDEX_DIAGNOSTIC_CODE,
+                                    severity: "error",
+                                    message: `candidate.index ${candidateIndex} is duplicated in one provider event; call ${knownSourceKey} is disqualified`,
+                                });
+                            }
+                        }
+                        else {
+                            events.push({
+                                type: "provider_diagnostic",
+                                sequence: ++this.sequence,
+                                provider: this.provider,
+                                callRef: { sourceKey: `candidate:${candidateIndex}` },
+                                code: DUPLICATE_CHOICE_INDEX_DIAGNOSTIC_CODE,
+                                severity: "error",
+                                message: `candidate.index ${candidateIndex} is duplicated in one provider event`,
+                            });
+                        }
+                    }
+                    continue;
+                }
+                const candidateAlreadyTerminal = this.candidateTerminalReasons.has(candidateIndex);
                 if (candidate.content && Array.isArray(candidate.content.parts)) {
-                    for (const [partIndex, part] of candidate.content.parts.entries()) {
+                    for (const part of candidate.content.parts) {
                         if (part.functionCall) {
                             const fc = part.functionCall;
-                            const sourceKey = `candidate:${candidateIndex}/part:${partIndex}`;
+                            // P4.5: real functionCall.id when present, never part array
+                            // position - see the class-level doc comment and
+                            // callSourceKey()'s own doc comment for the full rationale
+                            // and evidence.
+                            const sourceKey = this.callSourceKey(candidateIndex, fc);
+                            if (candidateAlreadyTerminal) {
+                                // Phase B.5: exact attribution. Each Gemini part is
+                                // object-level final delivery (never incrementally
+                                // streamed - see the class doc), so there is no
+                                // in-progress call of this candidate's own to disqualify
+                                // via THIS specific sourceKey - but if this candidate
+                                // already has other REAL, tracked calls (earlier parts),
+                                // late evidence disqualifies every one of them, not just
+                                // a forensic record against its own never-resolvable
+                                // identity - mirrors OpenAICompatibleStreamAdapter's own
+                                // choiceAlreadyTerminal branch exactly.
+                                const known = this.candidateSourceKeys.get(candidateIndex);
+                                if (known && known.size > 0) {
+                                    for (const knownSourceKey of known) {
+                                        events.push({
+                                            type: "provider_diagnostic",
+                                            sequence: ++this.sequence,
+                                            provider: this.provider,
+                                            callRef: { sourceKey: knownSourceKey },
+                                            code: TOOL_ARGUMENTS_AFTER_END_DIAGNOSTIC_CODE,
+                                            severity: "error",
+                                            message: `Tool call evidence for candidate ${candidateIndex} arrived after that candidate's own finishReason; call ${knownSourceKey} is disqualified`,
+                                        });
+                                    }
+                                }
+                                else {
+                                    // No call was ever tracked for this candidate at all -
+                                    // nothing exists yet to disqualify, but the attempt
+                                    // itself is still worth a forensic record against its
+                                    // own (never-resolvable) sourceKey.
+                                    events.push({
+                                        type: "provider_diagnostic",
+                                        sequence: ++this.sequence,
+                                        provider: this.provider,
+                                        callRef: { sourceKey },
+                                        code: TOOL_ARGUMENTS_AFTER_END_DIAGNOSTIC_CODE,
+                                        severity: "error",
+                                        message: `Tool call evidence for candidate ${candidateIndex} arrived after that candidate's own finishReason`,
+                                    });
+                                }
+                                continue;
+                            }
+                            // P4.5: this EXACT call (its own functionCall.id, or - for a
+                            // no-id call - its own already-assigned counter value, which
+                            // can never repeat by construction) was already delivered
+                            // once before under this still-active candidate. Every real
+                            // Gemini functionCall is object-level final delivery (see
+                            // the class-level doc comment - no supported continuation
+                            // mechanism exists), so a repeat of the SAME identity is
+                            // late/duplicate evidence for that one already-closed call,
+                            // never a legitimate multi-chunk continuation and never
+                            // silently merged into it. Exact attribution: this reuses
+                            // candidateSourceKeys's own existing "every sourceKey ever
+                            // started, never cleared" tracking rather than a new
+                            // mechanism - the disqualified call IS this sourceKey
+                            // itself, so no "known vs forensic-only" split is needed
+                            // here (unlike the candidate-already-terminal branch above,
+                            // where the late evidence's own identity is never the thing
+                            // being disqualified).
+                            if (this.candidateSourceKeys.get(candidateIndex)?.has(sourceKey)) {
+                                events.push({
+                                    type: "provider_diagnostic",
+                                    sequence: ++this.sequence,
+                                    provider: this.provider,
+                                    callRef: { sourceKey },
+                                    code: TOOL_ARGUMENTS_AFTER_END_DIAGNOSTIC_CODE,
+                                    severity: "error",
+                                    message: `Tool call evidence for candidate ${candidateIndex} repeats an already-delivered function call (${sourceKey}); call ${sourceKey} is disqualified`,
+                                });
+                                continue;
+                            }
+                            let known = this.candidateSourceKeys.get(candidateIndex);
+                            if (!known) {
+                                known = new Set();
+                                this.candidateSourceKeys.set(candidateIndex, known);
+                            }
+                            known.add(sourceKey);
                             events.push({
                                 type: "tool_call_start",
                                 sequence: ++this.sequence,
@@ -44,7 +402,7 @@ export class GeminiStreamAdapter {
                             });
                             if (fc.args !== undefined) {
                                 // Gemini currently emits structured objects.
-                                // We serialize it to emulate a text delta, BUT it is documented in docs/providers/gemini.md 
+                                // We serialize it to emulate a text delta, BUT it is documented in docs/providers/gemini.md
                                 // that this is NOT byte-level streaming. It is object-level final delivery.
                                 try {
                                     const projected = JSON.stringify(fc.args);
@@ -82,24 +440,52 @@ export class GeminiStreamAdapter {
                     }
                 }
                 if (candidate.finishReason) {
-                    let reason = "unknown";
-                    if (candidate.finishReason === "STOP") {
-                        reason = "complete";
-                    }
-                    else if (candidate.finishReason === "MAX_TOKENS") {
-                        reason = "length";
+                    if (candidateAlreadyTerminal) {
+                        // Duplicate/conflicting terminal for the SAME candidate
+                        // (Phase B.5): never silently overwrite the first-recorded
+                        // reason. Exact attribution, same as the late-functionCall
+                        // case above: every REAL, already-tracked call under this
+                        // candidate is disqualified, not merely a synthetic
+                        // "candidate:{i}" identity that was never a real call.
+                        const known = this.candidateSourceKeys.get(candidateIndex);
+                        if (known && known.size > 0) {
+                            for (const knownSourceKey of known) {
+                                events.push({
+                                    type: "provider_diagnostic",
+                                    sequence: ++this.sequence,
+                                    provider: this.provider,
+                                    callRef: { sourceKey: knownSourceKey },
+                                    code: DUPLICATE_TOOL_END_DIAGNOSTIC_CODE,
+                                    severity: "error",
+                                    message: `candidate ${candidateIndex} received a second finishReason ("${candidate.finishReason}") after already terminating; call ${knownSourceKey} is disqualified`,
+                                });
+                            }
+                        }
+                        else {
+                            // No tool call ever existed under this candidate - the
+                            // diagnostic is recorded for forensic visibility only and
+                            // disqualifies nothing, because there is nothing to
+                            // disqualify.
+                            events.push({
+                                type: "provider_diagnostic",
+                                sequence: ++this.sequence,
+                                provider: this.provider,
+                                callRef: { sourceKey: `candidate:${candidateIndex}` },
+                                code: DUPLICATE_TOOL_END_DIAGNOSTIC_CODE,
+                                severity: "error",
+                                message: `candidate ${candidateIndex} received a second finishReason ("${candidate.finishReason}") after already terminating`,
+                            });
+                        }
                     }
-                    else if (candidate.finishReason === "SAFETY" || candidate.finishReason === "RECITATION" || candidate.finishReason === "OTHER") {
-                        reason = "cancelled";
+                    else {
+                        const reason = mapFinishReason(candidate.finishReason);
+                        this.candidateTerminalReasons.set(candidateIndex, reason);
+                        this.candidateTerminalProviderReasons.set(candidateIndex, candidate.finishReason);
+                        // No provider_stream_end here, and `this.finished` stays
+                        // false: this candidate finishing is not, by itself, proof
+                        // the whole provider stream (which may still have other
+                        // candidates actively generating) has ended. See finish().
                     }
-                    events.push({
-                        type: "provider_stream_end",
-                        sequence: ++this.sequence,
-                        provider: this.provider,
-                        reason,
-                        providerReason: candidate.finishReason,
-                    });
-                    this.finished = true;
                 }
             }
         }
@@ -109,13 +495,44 @@ export class GeminiStreamAdapter {
         if (this.finished)
             return [];
         this.finished = true;
+        const { reason, providerReason } = this.aggregateTermination(meta?.reason, meta?.providerReason);
         return [{
                 type: "provider_stream_end",
                 sequence: ++this.sequence,
                 provider: this.provider,
-                reason: meta?.reason ?? "unknown",
-                providerReason: meta?.providerReason,
+                reason,
+                providerReason,
             }];
     }
+    // One stream-wide StreamEndReason from every candidate-local reason
+    // recorded so far, plus any caller-supplied override - "complete" only
+    // if every single one of them was "complete". Mirrors every other
+    // adapter's own aggregateTermination()/aggregateLegacyTermination()
+    // exactly (see REASON_PRIORITY above for why it is duplicated locally
+    // rather than cross-imported).
+    aggregateTermination(callerReason, callerProviderReason) {
+        let worst;
+        let worstRank = Infinity;
+        let worstProviderReason;
+        for (const [candidateIndex, candidate] of this.candidateTerminalReasons.entries()) {
+            const rank = REASON_PRIORITY.indexOf(candidate);
+            if (rank !== -1 && rank < worstRank) {
+                worst = candidate;
+                worstRank = rank;
+                worstProviderReason = this.candidateTerminalProviderReasons.get(candidateIndex);
+            }
+        }
+        if (callerReason !== undefined) {
+            const rank = REASON_PRIORITY.indexOf(callerReason);
+            if (rank !== -1 && rank < worstRank) {
+                worst = callerReason;
+                worstRank = rank;
+                worstProviderReason = callerProviderReason;
+            }
+        }
+        if (worst === undefined)
+            return { reason: "unknown", providerReason: callerProviderReason };
+        return { reason: worst, providerReason: worstProviderReason };
+    }
 }
 //# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

@@ -1 +1 @@
-{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"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"}

package/dist/providers/openai-compatible.d.ts

@@ -18,17 +18,63 @@ interface OpenAIChoice {
 export interface OpenAICompatibleEvent {
     choices?: OpenAIChoice[];
 }
+/**
+ * Chat-Completions-shaped ("OpenAI-compatible") streaming adapter.
+ *
+ * Lifecycle contract (`@public (Experimental)` - see docs/COMPATIBILITY.md;
+ * this is a deliberate, disclosed lifecycle correction, not an accidental
+ * behavior change):
+ *
+ *   choice.finish_reason
+ *     -> closes ONLY the tool calls belonging to that exact choice index
+ *        (tool_call_end per open call)
+ *     -> records that choice's own terminal StreamEndReason
+ *     -> does NOT emit provider_stream_end
+ *     -> does NOT set this adapter's global `finished` state
+ *
+ *   finish(meta?)
+ *     -> the ONE provider_stream_end for this adapter's whole lifetime,
+ *        closing any call whose own choice never reported a finish_reason
+ *        at all, with a reason aggregated from every choice-local reason
+ *        recorded so far plus `meta.reason` (see REASON_PRIORITY above) -
+ *        call this once the caller has drained the raw provider iterator.
+ *
+ * Why: a single choice's finish_reason is call-local evidence only. For an
+ * ordinary single-choice (the overwhelmingly common, n=1) stream this was
+ * previously indistinguishable from the whole provider stream ending, so
+ * treating it as such was harmless. For a genuine multi-choice (n>1)
+ * stream it is not: this adapter has no visibility into the request's own
+ * `n`, and no wire-level signal available to `push()` proves no further,
+ * unseen choice can still appear - only the caller's own raw-iterator
+ * exhaustion (driving an explicit `finish()` call) can. Previously, the
+ * first choice to finish was wrongly treated as ending the entire stream:
+ * every OTHER choice's still-tracked calls were force-closed by a single,
+ * shared `knownSourceKeys` Set and the stream was declared over via a real
+ * `provider_stream_end` - which could make a call belonging to a
+ * completely different, still-generating choice genuinely, immediately
+ * executable (a real, empirically-confirmed `takeDecision()`-able
+ * authority window) purely because an unrelated choice finished first, and
+ * separately made a second finishing choice's own, entirely real
+ * termination look like corrupt/duplicate post-terminal evidence,
+ * poisoning every call in the stream via the coordinator's own
+ * EVENT_AFTER_STREAM_END/TERMINAL_REASON_CONFLICT protocol.
+ */
 export declare class OpenAICompatibleStreamAdapter implements ProviderStreamAdapter<unknown> {
     readonly provider: ProviderName;
     private sequence;
     private startedSourceKeys;
-    private knownSourceKeys;
+    private openSourceKeysByChoice;
+    private choiceTerminalReasons;
+    private choiceTerminalProviderReasons;
+    private allSourceKeysByChoice;
+    private choiceTerminalProtocolViolation;
     private finished;
     push(rawEvent: unknown): readonly NormalizedToolStreamEvent[];
     finish(meta?: {
         reason?: StreamEndReason;
         providerReason?: string;
     }): readonly NormalizedToolStreamEvent[];
+    private aggregateTermination;
 }
 export {};
 //# sourceMappingURL=openai-compatible.d.ts.map

package/dist/providers/openai-compatible.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openai-compatible.d.ts","sourceRoot":"","sources":["../../src/providers/openai-compatible.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAMrD,UAAU,iBAAiB;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE;YACT,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC,CAAC;CACJ;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,qBAAa,6BAA8B,YAAW,qBAAqB,CAAC,OAAO,CAAC;IAClF,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAuB;IACtD,OAAO,CAAC,QAAQ,CAAK;IAGrB,OAAO,CAAC,iBAAiB,CAA0B;IAEnD,OAAO,CAAC,eAAe,CAA0B;IAEjD,OAAO,CAAC,QAAQ,CAAS;IAEzB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,yBAAyB,EAAE;IAwL7D,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,eAAe,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,yBAAyB,EAAE;CAyB3G"}
+{"version":3,"file":"openai-compatible.d.ts","sourceRoot":"","sources":["../../src/providers/openai-compatible.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAOrD,UAAU,iBAAiB;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE;YACT,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC,CAAC;CACJ;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAgCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,6BAA8B,YAAW,qBAAqB,CAAC,OAAO,CAAC;IAClF,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAuB;IACtD,OAAO,CAAC,QAAQ,CAAK;IAGrB,OAAO,CAAC,iBAAiB,CAA0B;IAKnD,OAAO,CAAC,sBAAsB,CAAuC;IAOrE,OAAO,CAAC,qBAAqB,CAA2C;IAUxE,OAAO,CAAC,6BAA6B,CAAkC;IAWvE,OAAO,CAAC,qBAAqB,CAAuC;IAWpE,OAAO,CAAC,+BAA+B,CAAS;IAEhD,OAAO,CAAC,QAAQ,CAAS;IAEzB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,yBAAyB,EAAE;IA8S7D,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,eAAe,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,yBAAyB,EAAE;IAoD1G,OAAO,CAAC,oBAAoB;CA+C7B"}