@andorra-labs/code 0.0.0-stage → 0.1.5

package/dist/vendor/engine/runtime/ai/api/openai-responses-shared.js

@@ -0,0 +1,688 @@
+import { andorraCalculateCost } from "../models.js";
+import { andorraShortHash } from "../utils/hash.js";
+import { andorraParseStreamingJson } from "../utils/json-parse.js";
+import { andorraSanitizeSurrogates } from "../utils/sanitize-unicode.js";
+import { andorraGetSystemMessageText, andorraRenderSystemMessageUpdate } from "../utils/text.js";
+import { andorraResolveTranscript, andorraResolveTranscriptTools } from "../utils/transcript.js";
+import { andorraAppendGrammarToolInputJsonDelta, andorraGetGrammarToolInput, andorraGetJsonSchemaToolParameters, andorraResolveGrammarConstrainedSampling, andorraResolveJsonSchemaStrictSampling, } from "./constrained-sampling.js";
+import { andorraTransformMessages } from "./transform-messages.js";
+// =============================================================================
+// Utilities
+// =============================================================================
+function andorraEncodeTextSignatureV1(id, phase) {
+    const payload = { v: 1, id };
+    if (phase)
+        payload.phase = phase;
+    return JSON.stringify(payload);
+}
+function andorraParseTextSignature(signature) {
+    if (!signature)
+        return undefined;
+    if (signature.startsWith("{")) {
+        try {
+            const parsed = JSON.parse(signature);
+            if (parsed.v === 1 && typeof parsed.id === "string") {
+                if (parsed.phase === "commentary" || parsed.phase === "final_answer") {
+                    return { id: parsed.id, phase: parsed.phase };
+                }
+                return { id: parsed.id };
+            }
+        }
+        catch {
+            // Fall through to legacy plain-string handling.
+        }
+    }
+    return { id: signature };
+}
+function andorraConvertToolResultOutput(model, content) {
+    const textResult = content
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("\n");
+    const images = content.filter((c) => c.type === "image");
+    const hasText = textResult.length > 0;
+    if (images.length === 0 || !model.input.includes("image")) {
+        return andorraSanitizeSurrogates(hasText ? textResult : images.length > 0 ? "(see attached image)" : "(no tool output)");
+    }
+    const output = [];
+    if (hasText) {
+        output.push({ type: "input_text", text: andorraSanitizeSurrogates(textResult) });
+    }
+    for (const image of images) {
+        output.push({
+            type: "input_image",
+            detail: "auto",
+            image_url: `data:${image.mimeType};base64,${image.data}`,
+        });
+    }
+    return output;
+}
+// =============================================================================
+// Message conversion
+// =============================================================================
+export function andorraConvertResponsesMessages(model, context, allowedToolCallProviders, options) {
+    const normalizedContext = andorraResolveTranscript(context, options?.supportsMidConvoSystemMessages);
+    const messages = [];
+    const andorraNormalizeIdPart = (part) => {
+        const sanitized = part.replace(/[^a-zA-Z0-9_-]/g, "_");
+        const normalized = sanitized.length > 64 ? sanitized.slice(0, 64) : sanitized;
+        return normalized.replace(/_+$/, "");
+    };
+    const andorraBuildForeignResponsesItemId = (itemId) => {
+        const normalized = `fc_${andorraShortHash(itemId)}`;
+        return normalized.length > 64 ? normalized.slice(0, 64) : normalized;
+    };
+    const andorraNormalizeToolCallId = (id, _targetModel, source) => {
+        if (!allowedToolCallProviders.has(model.provider))
+            return andorraNormalizeIdPart(id);
+        if (!id.includes("|"))
+            return andorraNormalizeIdPart(id);
+        const [callId, itemId] = id.split("|");
+        const normalizedCallId = andorraNormalizeIdPart(callId);
+        const isForeignToolCall = source.provider !== model.provider || source.api !== model.api;
+        let normalizedItemId = isForeignToolCall ? andorraBuildForeignResponsesItemId(itemId) : andorraNormalizeIdPart(itemId);
+        // OpenAI Responses API requires item id to start with "fc"
+        if (!normalizedItemId.startsWith("fc_")) {
+            normalizedItemId = andorraNormalizeIdPart(`fc_${normalizedItemId}`);
+        }
+        return `${normalizedCallId}|${normalizedItemId}`;
+    };
+    const transformedMessages = andorraTransformMessages(normalizedContext.messages, model, andorraNormalizeToolCallId);
+    const transcriptTools = andorraResolveTranscriptTools(normalizedContext.messages, (options?.supportsAdditionalTools ?? false) || (options?.supportsToolSearch ?? false));
+    const andorraAppendSystemToolAdditions = (message, seed) => {
+        const tools = transcriptTools.anchorsAdditions ? (message.toolsAdded ?? []) : [];
+        if (tools.length === 0)
+            return;
+        if (options?.supportsAdditionalTools) {
+            messages.push({
+                type: "additional_tools",
+                role: "developer",
+                tools: andorraConvertResponsesTools(tools, options.toolOptions),
+            });
+            return;
+        }
+        if (!options?.supportsToolSearch)
+            return;
+        const names = tools.map((tool) => tool.name);
+        const callId = `pi_tool_load_${andorraShortHash(`${seed}:${names.join(",")}`)}`;
+        messages.push({
+            type: "tool_search_call",
+            call_id: callId,
+            execution: "client",
+            status: "completed",
+            arguments: { query: names.join(" "), limit: names.length },
+        });
+        messages.push({
+            type: "tool_search_output",
+            call_id: callId,
+            execution: "client",
+            status: "completed",
+            tools: andorraConvertResponsesTools(tools, { ...options.toolOptions, toolSearchResult: true }),
+        });
+    };
+    const includeInitialSystemMessage = options?.includeSystemPrompt ?? true;
+    const compat = model.compat;
+    const instructionRole = model.reasoning && compat?.supportsDeveloperRole !== false ? "developer" : "system";
+    let msgIndex = 0;
+    let sourceIndex = 0;
+    for (const msg of transformedMessages) {
+        const isLeadingSystemMessage = sourceIndex++ === 0 && msg.role === "system";
+        if (msg.role === "system") {
+            if (!isLeadingSystemMessage)
+                andorraAppendSystemToolAdditions(msg, `system:${msgIndex}`);
+            if (!isLeadingSystemMessage || includeInitialSystemMessage) {
+                const text = isLeadingSystemMessage ? andorraGetSystemMessageText(msg) : andorraRenderSystemMessageUpdate(msg);
+                if (text.length > 0) {
+                    messages.push({ role: instructionRole, content: andorraSanitizeSurrogates(text) });
+                }
+            }
+        }
+        else if (msg.role === "user") {
+            if (typeof msg.content === "string") {
+                messages.push({
+                    role: "user",
+                    content: [{ type: "input_text", text: andorraSanitizeSurrogates(msg.content) }],
+                });
+            }
+            else {
+                const content = msg.content.map((item) => {
+                    if (item.type === "text") {
+                        return {
+                            type: "input_text",
+                            text: andorraSanitizeSurrogates(item.text),
+                        };
+                    }
+                    return {
+                        type: "input_image",
+                        detail: "auto",
+                        image_url: `data:${item.mimeType};base64,${item.data}`,
+                    };
+                });
+                if (content.length === 0)
+                    continue;
+                messages.push({
+                    role: "user",
+                    content,
+                });
+            }
+        }
+        else if (msg.role === "assistant") {
+            const output = [];
+            const assistantMsg = msg;
+            const isSameProviderAndApi = assistantMsg.provider === model.provider && assistantMsg.api === model.api;
+            const isSameModel = isSameProviderAndApi && assistantMsg.model === model.id;
+            const isDifferentModel = isSameProviderAndApi && assistantMsg.model !== model.id;
+            let textBlockIndex = 0;
+            for (const block of msg.content) {
+                if (block.type === "thinking") {
+                    if (block.thinkingSignature) {
+                        const reasoningItem = JSON.parse(block.thinkingSignature);
+                        output.push(reasoningItem);
+                    }
+                }
+                else if (block.type === "text") {
+                    const textBlock = block;
+                    const parsedSignature = andorraParseTextSignature(textBlock.textSignature);
+                    const fallbackMessageId = textBlockIndex === 0 ? `msg_pi_${msgIndex}` : `msg_pi_${msgIndex}_${textBlockIndex}`;
+                    textBlockIndex++;
+                    // OpenAI requires id to be max 64 characters
+                    let msgId = parsedSignature?.id;
+                    if (!msgId) {
+                        msgId = fallbackMessageId;
+                    }
+                    else if (msgId.length > 64) {
+                        msgId = `msg_${andorraShortHash(msgId)}`;
+                    }
+                    output.push({
+                        type: "message",
+                        role: "assistant",
+                        content: [{ type: "output_text", text: andorraSanitizeSurrogates(textBlock.text), annotations: [] }],
+                        status: "completed",
+                        id: msgId,
+                        phase: parsedSignature?.phase,
+                    });
+                }
+                else if (block.type === "toolCall") {
+                    const toolCall = block;
+                    const [callId, itemIdRaw] = toolCall.id.split("|");
+                    const customInputProperty = options?.grammarToolInputProperties?.get(toolCall.name);
+                    let itemId = itemIdRaw;
+                    // For different-model messages, set id to undefined to avoid pairing validation.
+                    // OpenAI tracks which fc_xxx IDs were paired with rs_xxx reasoning items.
+                    // By omitting the id, we avoid triggering that validation (like cross-provider does).
+                    // When replaying custom-tool calls as a function_call, also drop non-fc_* ids such as
+                    // ctc_* custom-tool ids because function_call item ids must be fc_*.
+                    if ((isDifferentModel && itemId?.startsWith("fc_")) ||
+                        (customInputProperty === undefined && !itemId?.startsWith("fc_"))) {
+                        itemId = undefined;
+                    }
+                    if (customInputProperty !== undefined) {
+                        output.push({
+                            type: "custom_tool_call",
+                            id: itemId,
+                            call_id: callId,
+                            name: toolCall.name,
+                            input: andorraSanitizeSurrogates(andorraGetGrammarToolInput(toolCall.name, toolCall.arguments, customInputProperty)),
+                            ...(isSameModel && toolCall.namespace !== undefined ? { namespace: toolCall.namespace } : {}),
+                        });
+                    }
+                    else {
+                        output.push({
+                            type: "function_call",
+                            id: itemId,
+                            call_id: callId,
+                            name: toolCall.name,
+                            arguments: JSON.stringify(toolCall.arguments),
+                            ...(isSameModel && toolCall.namespace !== undefined ? { namespace: toolCall.namespace } : {}),
+                        });
+                    }
+                }
+            }
+            if (output.length === 0)
+                continue;
+            messages.push(...output);
+        }
+        else if (msg.role === "toolResult") {
+            const [callId] = msg.toolCallId.split("|");
+            const output = andorraConvertToolResultOutput(model, msg.content);
+            if (options?.grammarToolInputProperties?.has(msg.toolName)) {
+                messages.push({
+                    type: "custom_tool_call_output",
+                    call_id: callId,
+                    output,
+                });
+            }
+            else {
+                messages.push({
+                    type: "function_call_output",
+                    call_id: callId,
+                    output,
+                });
+            }
+        }
+        if (!isLeadingSystemMessage)
+            msgIndex++;
+    }
+    return messages;
+}
+// =============================================================================
+// Tool conversion
+// =============================================================================
+export function andorraConvertResponsesTools(tools, options) {
+    const defaultStrict = options?.strict === undefined ? false : options.strict;
+    const supportsStrictMode = options?.supportsStrictMode ?? true;
+    const supportsOpenAIGrammarTools = options?.supportsOpenAIGrammarTools ?? false;
+    return tools.map((tool) => {
+        const grammar = andorraResolveGrammarConstrainedSampling(tool, supportsOpenAIGrammarTools);
+        if (grammar) {
+            return {
+                type: "custom",
+                name: tool.name,
+                description: tool.description,
+                format: {
+                    type: "grammar",
+                    syntax: grammar.format,
+                    definition: grammar.definition,
+                },
+                ...(options?.toolSearchResult ? { defer_loading: true } : {}),
+            };
+        }
+        const constrainedStrict = andorraResolveJsonSchemaStrictSampling(tool, supportsStrictMode);
+        const strict = constrainedStrict ?? defaultStrict;
+        const functionTool = {
+            type: "function",
+            name: tool.name,
+            description: tool.description,
+            parameters: andorraGetJsonSchemaToolParameters(tool, strict === true),
+            ...(options?.toolSearchResult ? { defer_loading: true } : {}),
+        };
+        if (supportsStrictMode) {
+            functionTool.strict = strict;
+        }
+        return functionTool;
+    });
+}
+function andorraGetCustomToolCallInput(block) {
+    const property = block.customInput?.property;
+    if (property === undefined)
+        return "";
+    const value = block.arguments[property];
+    return typeof value === "string" ? value : "";
+}
+function andorraAppendCustomToolCallInput(block, nextInput, close) {
+    const customInput = block.customInput;
+    if (!customInput)
+        return undefined;
+    const delta = andorraAppendGrammarToolInputJsonDelta(customInput.jsonBuffer, customInput.property, nextInput, close);
+    block.arguments = { [customInput.property]: nextInput };
+    return delta;
+}
+export async function andorraProcessResponsesStream(openaiStream, output, stream, model, options) {
+    let sawTerminalResponseEvent = false;
+    const outputSlots = new Map();
+    const reasoningBlocksById = new Map();
+    const andorraApplyMessagePhaseStopReason = (item) => {
+        if (item.type === "message" && item.phase === "final_answer") {
+            output.stopReason = "stop";
+        }
+    };
+    const andorraGetSlot = (outputIndex, type) => {
+        const slot = outputSlots.get(outputIndex);
+        return slot?.type === type ? slot : undefined;
+    };
+    const andorraPushToolCallDelta = (slot, delta) => {
+        if (delta === undefined)
+            return;
+        stream.push({
+            type: "toolcall_delta",
+            contentIndex: slot.contentIndex,
+            delta,
+            partial: output,
+        });
+    };
+    const andorraCreateSlot = (outputIndex, item) => {
+        if (item.type === "reasoning") {
+            const block = { type: "thinking", thinking: "" };
+            output.content.push(block);
+            const slot = {
+                type: "thinking",
+                block,
+                contentIndex: output.content.length - 1,
+            };
+            outputSlots.set(outputIndex, slot);
+            stream.push({ type: "thinking_start", contentIndex: slot.contentIndex, partial: output });
+            return slot;
+        }
+        if (item.type === "message") {
+            andorraApplyMessagePhaseStopReason(item);
+            const block = { type: "text", text: "" };
+            output.content.push(block);
+            const slot = { type: "text", block, contentIndex: output.content.length - 1 };
+            outputSlots.set(outputIndex, slot);
+            stream.push({ type: "text_start", contentIndex: slot.contentIndex, partial: output });
+            return slot;
+        }
+        if (item.type === "function_call") {
+            const block = {
+                type: "toolCall",
+                id: `${item.call_id}|${item.id}`,
+                name: item.name,
+                arguments: {},
+                ...(item.namespace !== undefined ? { namespace: item.namespace } : {}),
+                partialJson: item.arguments || "",
+            };
+            output.content.push(block);
+            const slot = {
+                type: "toolCall",
+                block,
+                contentIndex: output.content.length - 1,
+            };
+            outputSlots.set(outputIndex, slot);
+            stream.push({ type: "toolcall_start", contentIndex: slot.contentIndex, partial: output });
+            return slot;
+        }
+        if (item.type === "custom_tool_call") {
+            const inputProperty = options?.grammarToolInputProperties?.get(item.name) ?? "input";
+            const input = item.input || "";
+            const block = {
+                type: "toolCall",
+                id: `${item.call_id}|${item.id}`,
+                name: item.name,
+                arguments: { [inputProperty]: input },
+                ...(item.namespace !== undefined ? { namespace: item.namespace } : {}),
+                customInput: {
+                    property: inputProperty,
+                    jsonBuffer: { input: "", started: false, closed: false },
+                },
+            };
+            output.content.push(block);
+            const slot = {
+                type: "toolCall",
+                block,
+                contentIndex: output.content.length - 1,
+            };
+            outputSlots.set(outputIndex, slot);
+            stream.push({ type: "toolcall_start", contentIndex: slot.contentIndex, partial: output });
+            return slot;
+        }
+        return undefined;
+    };
+    const andorraGetOrCreateSlot = (outputIndex, item) => {
+        return outputSlots.get(outputIndex) ?? andorraCreateSlot(outputIndex, item);
+    };
+    // Azure OpenAI can omit reasoning.encrypted_content from response.output_item.done
+    // and provide it only in response.completed.response.output. Backfill the
+    // persisted reasoning signature from the terminal response to keep store:false
+    // multi-turn replay stateless. See https://github.com/earendil-works/pi/issues/6409.
+    const andorraBackfillReasoningSignatures = (responseOutput) => {
+        for (const item of responseOutput) {
+            if (item.type !== "reasoning" || !item.encrypted_content)
+                continue;
+            const block = reasoningBlocksById.get(item.id);
+            if (!block?.thinkingSignature)
+                continue;
+            const storedItem = JSON.parse(block.thinkingSignature);
+            if (storedItem.encrypted_content)
+                continue;
+            block.thinkingSignature = JSON.stringify({
+                ...storedItem,
+                encrypted_content: item.encrypted_content,
+            });
+        }
+    };
+    const andorraFinalizeResponse = (response) => {
+        sawTerminalResponseEvent = true;
+        andorraBackfillReasoningSignatures(response.output ?? []);
+        if (response?.id) {
+            output.responseId = response.id;
+        }
+        if (response?.usage) {
+            const inputDetails = response.usage.input_tokens_details;
+            const cachedTokens = inputDetails?.cached_tokens || 0;
+            const cacheWriteTokens = inputDetails?.cache_write_tokens || 0;
+            output.usage = {
+                // OpenAI includes cached and cache-write tokens in input_tokens, so subtract both.
+                input: Math.max(0, (response.usage.input_tokens || 0) - cachedTokens - cacheWriteTokens),
+                output: response.usage.output_tokens || 0,
+                cacheRead: cachedTokens,
+                cacheWrite: cacheWriteTokens,
+                reasoning: response.usage.output_tokens_details?.reasoning_tokens || 0,
+                totalTokens: response.usage.total_tokens || 0,
+                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+            };
+        }
+        andorraCalculateCost(model, output.usage);
+        if (options?.applyServiceTierPricing) {
+            const serviceTier = options.resolveServiceTier
+                ? options.resolveServiceTier(response?.service_tier, options.serviceTier)
+                : (response?.service_tier ?? options.serviceTier);
+            options.applyServiceTierPricing(output.usage, serviceTier);
+        }
+        // Map status to stop reason. For incomplete responses, retain the provider's
+        // specific reason so max-output truncation and content filtering stay distinct.
+        const status = response?.status;
+        const incompleteDetails = response?.incomplete_details;
+        const incompleteReason = typeof incompleteDetails?.reason === "string" ? incompleteDetails.reason : undefined;
+        output.rawStopReason = incompleteReason ? `${status}.${incompleteReason}` : status;
+        const mappedStop = andorraMapStopReason(status, incompleteReason);
+        output.stopReason = mappedStop.stopReason;
+        if (mappedStop.errorMessage === undefined)
+            delete output.errorMessage;
+        else
+            output.errorMessage = mappedStop.errorMessage;
+        if (output.content.some((b) => b.type === "toolCall") && output.stopReason === "stop") {
+            output.stopReason = "toolUse";
+        }
+    };
+    for await (const event of openaiStream) {
+        if (event.type === "response.created") {
+            output.responseId = event.response.id;
+        }
+        else if (event.type === "response.output_item.added") {
+            andorraCreateSlot(event.output_index, event.item);
+        }
+        else if (event.type === "response.reasoning_summary_text.delta") {
+            const slot = andorraGetSlot(event.output_index, "thinking");
+            if (!slot)
+                continue;
+            slot.block.thinking += event.delta;
+            stream.push({
+                type: "thinking_delta",
+                contentIndex: slot.contentIndex,
+                delta: event.delta,
+                partial: output,
+            });
+        }
+        else if (event.type === "response.reasoning_summary_part.done") {
+            const slot = andorraGetSlot(event.output_index, "thinking");
+            if (!slot)
+                continue;
+            slot.block.thinking += "\n\n";
+            stream.push({
+                type: "thinking_delta",
+                contentIndex: slot.contentIndex,
+                delta: "\n\n",
+                partial: output,
+            });
+        }
+        else if (event.type === "response.reasoning_text.delta") {
+            const slot = andorraGetSlot(event.output_index, "thinking");
+            if (!slot)
+                continue;
+            slot.block.thinking += event.delta;
+            stream.push({
+                type: "thinking_delta",
+                contentIndex: slot.contentIndex,
+                delta: event.delta,
+                partial: output,
+            });
+        }
+        else if (event.type === "response.output_text.delta") {
+            const slot = andorraGetSlot(event.output_index, "text");
+            if (!slot)
+                continue;
+            slot.block.text += event.delta;
+            stream.push({
+                type: "text_delta",
+                contentIndex: slot.contentIndex,
+                delta: event.delta,
+                partial: output,
+            });
+        }
+        else if (event.type === "response.refusal.delta") {
+            const slot = andorraGetSlot(event.output_index, "text");
+            if (!slot)
+                continue;
+            slot.block.text += event.delta;
+            stream.push({
+                type: "text_delta",
+                contentIndex: slot.contentIndex,
+                delta: event.delta,
+                partial: output,
+            });
+        }
+        else if (event.type === "response.function_call_arguments.delta") {
+            const slot = andorraGetSlot(event.output_index, "toolCall");
+            if (!slot || slot.block.partialJson === undefined)
+                continue;
+            slot.block.partialJson += event.delta;
+            slot.block.arguments = andorraParseStreamingJson(slot.block.partialJson);
+            andorraPushToolCallDelta(slot, event.delta);
+        }
+        else if (event.type === "response.function_call_arguments.done") {
+            const slot = andorraGetSlot(event.output_index, "toolCall");
+            if (!slot || slot.block.partialJson === undefined)
+                continue;
+            const previousPartialJson = slot.block.partialJson;
+            slot.block.partialJson = event.arguments;
+            slot.block.arguments = andorraParseStreamingJson(slot.block.partialJson);
+            if (event.arguments.startsWith(previousPartialJson)) {
+                const delta = event.arguments.slice(previousPartialJson.length);
+                if (delta.length > 0)
+                    andorraPushToolCallDelta(slot, delta);
+            }
+        }
+        else if (event.type === "response.custom_tool_call_input.delta") {
+            const slot = andorraGetSlot(event.output_index, "toolCall");
+            if (!slot || !slot.block.customInput)
+                continue;
+            andorraPushToolCallDelta(slot, andorraAppendCustomToolCallInput(slot.block, andorraGetCustomToolCallInput(slot.block) + event.delta, false));
+        }
+        else if (event.type === "response.custom_tool_call_input.done") {
+            const slot = andorraGetSlot(event.output_index, "toolCall");
+            if (!slot || !slot.block.customInput)
+                continue;
+            andorraPushToolCallDelta(slot, andorraAppendCustomToolCallInput(slot.block, event.input, true));
+        }
+        else if (event.type === "response.output_item.done") {
+            const item = event.item;
+            andorraApplyMessagePhaseStopReason(item);
+            const slot = andorraGetOrCreateSlot(event.output_index, item);
+            if (item.type === "reasoning" && slot?.type === "thinking") {
+                const summaryText = item.summary?.map((s) => s.text).join("\n\n") || "";
+                const contentText = item.content?.map((c) => c.text).join("\n\n") || "";
+                slot.block.thinking = summaryText || contentText || slot.block.thinking;
+                slot.block.thinkingSignature = JSON.stringify(item);
+                reasoningBlocksById.set(item.id, slot.block);
+                stream.push({
+                    type: "thinking_end",
+                    contentIndex: slot.contentIndex,
+                    content: slot.block.thinking,
+                    partial: output,
+                });
+                outputSlots.delete(event.output_index);
+            }
+            else if (item.type === "message" && slot?.type === "text") {
+                slot.block.text = item.content?.map((c) => (c.type === "output_text" ? c.text : c.refusal)).join("") || "";
+                slot.block.textSignature = andorraEncodeTextSignatureV1(item.id, item.phase ?? undefined);
+                stream.push({
+                    type: "text_end",
+                    contentIndex: slot.contentIndex,
+                    content: slot.block.text,
+                    partial: output,
+                });
+                outputSlots.delete(event.output_index);
+            }
+            else if (item.type === "function_call" &&
+                slot?.type === "toolCall" &&
+                slot.block.partialJson !== undefined) {
+                slot.block.arguments = andorraParseStreamingJson(item.arguments || slot.block.partialJson || "{}");
+                if (item.namespace !== undefined)
+                    slot.block.namespace = item.namespace;
+                // Finalize in-place and strip the scratch buffer so replay only
+                // carries parsed arguments.
+                delete slot.block.partialJson;
+                stream.push({
+                    type: "toolcall_end",
+                    contentIndex: slot.contentIndex,
+                    toolCall: slot.block,
+                    partial: output,
+                });
+                outputSlots.delete(event.output_index);
+            }
+            else if (item.type === "custom_tool_call" && slot?.type === "toolCall" && slot.block.customInput) {
+                andorraPushToolCallDelta(slot, andorraAppendCustomToolCallInput(slot.block, item.input ?? andorraGetCustomToolCallInput(slot.block), true));
+                if (item.namespace !== undefined)
+                    slot.block.namespace = item.namespace;
+                delete slot.block.customInput;
+                stream.push({
+                    type: "toolcall_end",
+                    contentIndex: slot.contentIndex,
+                    toolCall: slot.block,
+                    partial: output,
+                });
+                outputSlots.delete(event.output_index);
+            }
+        }
+        else if (event.type === "response.completed" || event.type === "response.incomplete") {
+            andorraFinalizeResponse(event.response);
+        }
+        else if (event.type === "error") {
+            throw new Error(`Error Code ${event.code}: ${event.message}` || "Unknown error");
+        }
+        else if (event.type === "response.failed") {
+            sawTerminalResponseEvent = true;
+            output.rawStopReason = event.response?.status;
+            const error = event.response?.error;
+            const details = event.response?.incomplete_details;
+            const msg = error
+                ? `${error.code || "unknown"}: ${error.message || "no message"}`
+                : details?.reason
+                    ? `incomplete: ${details.reason}`
+                    : "Unknown error (no error details in response)";
+            throw new Error(msg);
+        }
+    }
+    if (!sawTerminalResponseEvent) {
+        throw new Error("OpenAI Responses stream ended before a terminal response event");
+    }
+}
+function andorraMapStopReason(status, incompleteReason) {
+    if (!status)
+        return { stopReason: "stop" };
+    switch (status) {
+        case "completed":
+            return { stopReason: "stop" };
+        case "incomplete":
+            if (incompleteReason === "max_output_tokens") {
+                return { stopReason: "length" };
+            }
+            return {
+                stopReason: "error",
+                errorMessage: incompleteReason
+                    ? `Response incomplete: ${incompleteReason}`
+                    : "Response incomplete without a provider reason",
+            };
+        case "failed":
+        case "cancelled":
+            return { stopReason: "error" };
+        // These two are wonky ...
+        case "in_progress":
+        case "queued":
+            return { stopReason: "stop" };
+        default: {
+            const _exhaustive = status;
+            throw new Error(`Unhandled stop reason: ${_exhaustive}`);
+        }
+    }
+}