@andorra-labs/code 0.0.0-stage → 0.1.4

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

@@ -0,0 +1,1339 @@
+import OpenAI from "openai";
+import { andorraCalculateCost, andorraClampThinkingLevel } from "../models.js";
+import { andorraFormatProviderError, andorraNormalizeProviderError } from "../utils/error-body.js";
+import { AndorraAssistantMessageEventStream } from "../utils/event-stream.js";
+import { andorraShortHash } from "../utils/hash.js";
+import { andorraHeadersToRecord } from "../utils/headers.js";
+import { andorraParseStreamingJson } from "../utils/json-parse.js";
+import { andorraGetAndorraUserAgent } from "../utils/pi-user-agent.js";
+import { andorraGetProviderEnvValue } from "../utils/provider-env.js";
+import { andorraRetryProviderRequest } from "../utils/provider-retry.js";
+import { andorraSanitizeSurrogates } from "../utils/sanitize-unicode.js";
+import { andorraGetSystemMessageText, andorraRenderSystemMessageUpdate } from "../utils/text.js";
+import { andorraGetDeclaredTools, andorraResolveTranscript, andorraResolveTranscriptTools, } from "../utils/transcript.js";
+import { andorraAppendGrammarToolInputJsonDelta, andorraCreateGrammarToolInputProperties, andorraGetGrammarToolInput, andorraGetJsonSchemaToolParameters, andorraResolveGrammarConstrainedSampling, andorraResolveJsonSchemaStrictSampling, } from "./constrained-sampling.js";
+import { andorraBuildCopilotDynamicHeaders, andorraHasCopilotVisionInput } from "./github-copilot-headers.js";
+import { andorraClampOpenAIPromptCacheKey } from "./openai-prompt-cache.js";
+import { andorraBuildBaseOptions, andorraClampThinkingBudgetToAnswerRoom, andorraThinkingBudgetForLevel } from "./simple-options.js";
+import { andorraTransformMessages } from "./transform-messages.js";
+/**
+ * Check if conversation messages contain tool calls or tool results.
+ * This is needed because Anthropic (via proxy) requires the tools param
+ * to be present when messages include tool_calls or tool role messages.
+ */
+function andorraHasHeader(headers, name) {
+    if (!headers)
+        return false;
+    const expected = name.toLowerCase();
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === expected && value !== null && value.trim().length > 0)
+            return true;
+    }
+    return false;
+}
+function andorraGetClientApiKey(provider, apiKey, headers) {
+    if (apiKey)
+        return apiKey;
+    if (andorraHasHeader(headers, "authorization") || andorraHasHeader(headers, "cf-aig-authorization"))
+        return "unused";
+    throw new Error(`No API key for provider: ${provider}`);
+}
+function andorraHasToolHistory(messages) {
+    for (const msg of messages) {
+        if (msg.role === "toolResult") {
+            return true;
+        }
+        if (msg.role === "assistant") {
+            if (msg.content.some((block) => block.type === "toolCall")) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function andorraIsTextContentBlock(block) {
+    return block.type === "text";
+}
+function andorraIsThinkingContentBlock(block) {
+    return block.type === "thinking";
+}
+function andorraIsToolCallBlock(block) {
+    return block.type === "toolCall";
+}
+function andorraIsImageContentBlock(block) {
+    return block.type === "image";
+}
+function andorraIsReasoningDetailObject(detail) {
+    return typeof detail === "object" && detail !== null && !Array.isArray(detail);
+}
+function andorraHasValidCommonReasoningDetailFields(candidate) {
+    return ((candidate.id === undefined || candidate.id === null || typeof candidate.id === "string") &&
+        (candidate.format === undefined || typeof candidate.format === "string") &&
+        (candidate.index === undefined || typeof candidate.index === "number"));
+}
+function andorraIsOpenAIReasoningDetail(detail) {
+    if (!andorraIsReasoningDetailObject(detail) || !andorraHasValidCommonReasoningDetailFields(detail)) {
+        return false;
+    }
+    switch (detail.type) {
+        case "reasoning.summary":
+            return typeof detail.summary === "string";
+        case "reasoning.encrypted":
+            return typeof detail.data === "string";
+        case "reasoning.text":
+            return (typeof detail.text === "string" &&
+                (detail.signature === undefined || detail.signature === null || typeof detail.signature === "string"));
+        default:
+            return false;
+    }
+}
+function andorraParseOpenAIReasoningDetails(signature) {
+    if (!signature)
+        return undefined;
+    try {
+        const parsed = JSON.parse(signature);
+        return Array.isArray(parsed) && parsed.length > 0 && parsed.every(andorraIsOpenAIReasoningDetail) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function andorraParseLegacyEncryptedReasoningDetail(signature) {
+    if (!signature)
+        return undefined;
+    try {
+        const parsed = JSON.parse(signature);
+        return andorraIsOpenAIReasoningDetail(parsed) &&
+            parsed.type === "reasoning.encrypted" &&
+            typeof parsed.id === "string" &&
+            parsed.id.length > 0 &&
+            parsed.data.length > 0
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function andorraFillMissingCommonReasoningDetailFields(target, source) {
+    target.id ??= source.id;
+    target.format ||= source.format;
+    target.index ??= source.index;
+}
+function andorraAppendOpenAIReasoningDetail(details, detail) {
+    const lastDetail = details[details.length - 1];
+    if (detail.type === "reasoning.text" && lastDetail?.type === "reasoning.text") {
+        lastDetail.text += detail.text;
+        lastDetail.signature ||= detail.signature;
+        andorraFillMissingCommonReasoningDetailFields(lastDetail, detail);
+        return;
+    }
+    if (detail.type === "reasoning.summary" && lastDetail?.type === "reasoning.summary") {
+        lastDetail.summary += detail.summary;
+        andorraFillMissingCommonReasoningDetailFields(lastDetail, detail);
+        return;
+    }
+    details.push({ ...detail });
+}
+const OPENAI_COMPLETIONS_REASONING_FIELDS = ["reasoning", "reasoning_content", "reasoning_text"];
+function andorraIsOpenAICompletionsReasoningField(field) {
+    return OPENAI_COMPLETIONS_REASONING_FIELDS.includes(field);
+}
+function andorraResolveCacheRetention(cacheRetention, env) {
+    if (cacheRetention) {
+        return cacheRetention;
+    }
+    if (andorraGetProviderEnvValue("ANDORRA_ENGINE_CACHE_RETENTION", env) === "long") {
+        return "long";
+    }
+    return "short";
+}
+export const andorraStream = (model, context, options) => {
+    const stream = new AndorraAssistantMessageEventStream();
+    const normalizedContext = andorraResolveTranscript(context, andorraGetCompat(model).supportsMidConvoSystemMessages);
+    (async () => {
+        const output = {
+            role: "assistant",
+            content: [],
+            api: model.api,
+            provider: model.provider,
+            model: model.id,
+            usage: {
+                input: 0,
+                output: 0,
+                cacheRead: 0,
+                cacheWrite: 0,
+                totalTokens: 0,
+                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+            },
+            stopReason: "pending",
+            timestamp: Date.now(),
+        };
+        // `reasoning_details` are replay metadata, not user-visible stream deltas.
+        // Keep them in memory during streaming and serialize once when the block is finalized.
+        let streamedReasoningDetails;
+        const andorraApplyStreamedReasoningDetails = (block) => {
+            if (streamedReasoningDetails !== undefined) {
+                block.thinkingSignature = JSON.stringify(streamedReasoningDetails);
+            }
+        };
+        try {
+            const apiKey = andorraGetClientApiKey(model.provider, options?.apiKey, options?.headers);
+            const compat = andorraGetCompat(model);
+            const grammarToolInputProperties = andorraCreateGrammarToolInputProperties(andorraGetDeclaredTools(normalizedContext.messages), compat.supportsOpenAIGrammarTools);
+            const cacheRetention = andorraResolveCacheRetention(options?.cacheRetention, options?.env);
+            const cacheSessionId = cacheRetention === "none" ? undefined : options?.sessionId;
+            const client = andorraCreateClient(model, normalizedContext, apiKey, options?.headers, options?.fetch, cacheSessionId, compat);
+            let params = andorraBuildParams(model, normalizedContext, options, compat, cacheRetention, grammarToolInputProperties);
+            const nextParams = await options?.onPayload?.(params, model);
+            if (nextParams !== undefined) {
+                params = nextParams;
+            }
+            const requestOptions = {
+                ...(options?.signal ? { signal: options.signal } : {}),
+                ...(options?.timeoutMs !== undefined ? { timeout: options.timeoutMs } : {}),
+                maxRetries: 0,
+            };
+            const { data: openaiStream, response } = await andorraRetryProviderRequest(() => client.chat.completions.create(params, requestOptions).withResponse(), {
+                maxRetries: options?.maxRetries,
+                maxRetryDelayMs: options?.maxRetryDelayMs,
+                signal: options?.signal,
+            });
+            await options?.onResponse?.({ status: response.status, headers: andorraHeadersToRecord(response.headers) }, model);
+            stream.push({ type: "start", partial: output });
+            let textBlock = null;
+            let thinkingBlock = null;
+            let hasFinishReason = false;
+            const toolCallBlocksByIndex = new Map();
+            const toolCallBlocksById = new Map();
+            const blocks = output.content;
+            const andorraGetContentIndex = (block) => blocks.indexOf(block);
+            const andorraGetCustomToolCallInput = (block) => {
+                const property = block.customInput?.property;
+                if (property === undefined)
+                    return "";
+                const value = block.arguments[property];
+                return typeof value === "string" ? value : "";
+            };
+            const 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;
+            };
+            const andorraFinishBlock = (block) => {
+                const contentIndex = andorraGetContentIndex(block);
+                if (contentIndex === -1) {
+                    return;
+                }
+                if (block.type === "text") {
+                    stream.push({
+                        type: "text_end",
+                        contentIndex,
+                        content: block.text,
+                        partial: output,
+                    });
+                }
+                else if (block.type === "thinking") {
+                    andorraApplyStreamedReasoningDetails(block);
+                    stream.push({
+                        type: "thinking_end",
+                        contentIndex,
+                        content: block.thinking,
+                        partial: output,
+                    });
+                }
+                else if (block.type === "toolCall") {
+                    if (block.customInput) {
+                        const delta = andorraAppendCustomToolCallInput(block, andorraGetCustomToolCallInput(block), true);
+                        if (delta !== undefined) {
+                            stream.push({
+                                type: "toolcall_delta",
+                                contentIndex,
+                                delta,
+                                partial: output,
+                            });
+                        }
+                    }
+                    else {
+                        block.arguments = andorraParseStreamingJson(block.partialArgs);
+                    }
+                    // Finalize in-place and strip the scratch buffers so replay only
+                    // carries parsed arguments.
+                    delete block.partialArgs;
+                    delete block.customInput;
+                    delete block.streamIndex;
+                    stream.push({
+                        type: "toolcall_end",
+                        contentIndex,
+                        toolCall: block,
+                        partial: output,
+                    });
+                }
+            };
+            const andorraEnsureTextBlock = () => {
+                if (!textBlock) {
+                    textBlock = { type: "text", text: "" };
+                    blocks.push(textBlock);
+                    stream.push({ type: "text_start", contentIndex: andorraGetContentIndex(textBlock), partial: output });
+                }
+                return textBlock;
+            };
+            const andorraEnsureThinkingBlock = (thinkingSignature) => {
+                if (!thinkingBlock) {
+                    thinkingBlock = {
+                        type: "thinking",
+                        thinking: "",
+                        thinkingSignature,
+                    };
+                    blocks.push(thinkingBlock);
+                    stream.push({ type: "thinking_start", contentIndex: andorraGetContentIndex(thinkingBlock), partial: output });
+                }
+                return thinkingBlock;
+            };
+            const andorraEnsureToolCallBlock = (toolCall) => {
+                const streamIndex = typeof toolCall.index === "number" ? toolCall.index : undefined;
+                const name = toolCall.function?.name ?? toolCall.custom?.name ?? "";
+                let block = streamIndex !== undefined ? toolCallBlocksByIndex.get(streamIndex) : undefined;
+                if (!block && toolCall.id) {
+                    block = toolCallBlocksById.get(toolCall.id);
+                }
+                if (!block) {
+                    // Note: the "input" fallback here should/must not be taken.  in case the LLM makes up
+                    // a tool we don't knwo about, we at least have a place to stash our stuff.
+                    const customInputProperty = toolCall.custom && !toolCall.function ? (grammarToolInputProperties.get(name) ?? "input") : undefined;
+                    const hasCustomInput = customInputProperty !== undefined;
+                    block = {
+                        type: "toolCall",
+                        id: toolCall.id || "",
+                        name,
+                        arguments: hasCustomInput ? { [customInputProperty]: "" } : {},
+                        partialArgs: hasCustomInput ? undefined : "",
+                        customInput: hasCustomInput
+                            ? { property: customInputProperty, jsonBuffer: { input: "", started: false, closed: false } }
+                            : undefined,
+                        streamIndex,
+                    };
+                    if (streamIndex !== undefined) {
+                        toolCallBlocksByIndex.set(streamIndex, block);
+                    }
+                    if (toolCall.id) {
+                        toolCallBlocksById.set(toolCall.id, block);
+                    }
+                    blocks.push(block);
+                    stream.push({
+                        type: "toolcall_start",
+                        contentIndex: andorraGetContentIndex(block),
+                        partial: output,
+                    });
+                }
+                if (streamIndex !== undefined && block.streamIndex === undefined) {
+                    block.streamIndex = streamIndex;
+                    toolCallBlocksByIndex.set(streamIndex, block);
+                }
+                if (toolCall.id) {
+                    toolCallBlocksById.set(toolCall.id, block);
+                }
+                if (!block.name && name) {
+                    block.name = name;
+                }
+                if (toolCall.custom && !toolCall.function && !block.customInput) {
+                    const customInputProperty = grammarToolInputProperties.get(block.name) ?? "input";
+                    block.arguments = { [customInputProperty]: "" };
+                    block.customInput = {
+                        property: customInputProperty,
+                        jsonBuffer: { input: "", started: false, closed: false },
+                    };
+                    delete block.partialArgs;
+                }
+                return block;
+            };
+            for await (const chunk of openaiStream) {
+                if (!chunk || typeof chunk !== "object")
+                    continue;
+                // OpenAI documents ChatCompletionChunk.id as the unique chat completion identifier,
+                // and each chunk in a streamed completion carries the same id.
+                output.responseId ||= chunk.id;
+                if (typeof chunk.model === "string" && chunk.model.length > 0 && chunk.model !== model.id) {
+                    output.responseModel ||= chunk.model;
+                }
+                if (chunk.usage) {
+                    output.usage = andorraParseChunkUsage(chunk.usage, model);
+                }
+                const choice = Array.isArray(chunk.choices) ? chunk.choices[0] : undefined;
+                if (!choice)
+                    continue;
+                // Fallback: some providers (e.g., Moonshot) return usage
+                // in choice.usage instead of the standard chunk.usage
+                if (!chunk.usage && choice.usage) {
+                    output.usage = andorraParseChunkUsage(choice.usage, model);
+                }
+                if (choice.finish_reason) {
+                    output.rawStopReason = choice.finish_reason;
+                    const finishReasonResult = andorraMapStopReason(choice.finish_reason);
+                    output.stopReason = finishReasonResult.stopReason;
+                    if (finishReasonResult.errorMessage) {
+                        output.errorMessage = finishReasonResult.errorMessage;
+                    }
+                    hasFinishReason = true;
+                }
+                if (choice.delta) {
+                    if (choice.delta.content !== null &&
+                        choice.delta.content !== undefined &&
+                        choice.delta.content.length > 0) {
+                        const block = andorraEnsureTextBlock();
+                        block.text += choice.delta.content;
+                        stream.push({
+                            type: "text_delta",
+                            contentIndex: andorraGetContentIndex(block),
+                            delta: choice.delta.content,
+                            partial: output,
+                        });
+                    }
+                    // Some endpoints return reasoning in reasoning_content (llama.cpp),
+                    // or reasoning (other openai compatible endpoints)
+                    // Use the first non-empty reasoning field to avoid duplication
+                    // (e.g., chutes.ai returns both reasoning_content and reasoning with same content)
+                    const reasoningFields = ["reasoning_content", "reasoning", "reasoning_text"];
+                    const deltaFields = choice.delta;
+                    let foundReasoningField = null;
+                    for (const field of reasoningFields) {
+                        const value = deltaFields[field];
+                        if (typeof value === "string" && value.length > 0) {
+                            foundReasoningField = field;
+                            break;
+                        }
+                    }
+                    if (foundReasoningField) {
+                        const delta = deltaFields[foundReasoningField];
+                        if (typeof delta === "string" && delta.length > 0) {
+                            const thinkingSignature = model.provider === "opencode-go" && foundReasoningField === "reasoning"
+                                ? "reasoning_content"
+                                : foundReasoningField;
+                            const block = andorraEnsureThinkingBlock(thinkingSignature);
+                            block.thinking += delta;
+                            stream.push({
+                                type: "thinking_delta",
+                                contentIndex: andorraGetContentIndex(block),
+                                delta,
+                                partial: output,
+                            });
+                        }
+                    }
+                    if (choice?.delta?.tool_calls) {
+                        for (const toolCall of choice.delta.tool_calls) {
+                            const block = andorraEnsureToolCallBlock(toolCall);
+                            if (!block.id && toolCall.id) {
+                                block.id = toolCall.id;
+                                toolCallBlocksById.set(toolCall.id, block);
+                            }
+                            const name = toolCall.function?.name ?? toolCall.custom?.name;
+                            if (!block.name && name) {
+                                block.name = name;
+                            }
+                            let delta = "";
+                            if (toolCall.function?.arguments) {
+                                delta = toolCall.function.arguments;
+                                block.partialArgs = (block.partialArgs ?? "") + toolCall.function.arguments;
+                                block.arguments = andorraParseStreamingJson(block.partialArgs);
+                            }
+                            else if (toolCall.custom?.input) {
+                                const nextInput = andorraGetCustomToolCallInput(block) + toolCall.custom.input;
+                                delta = andorraAppendCustomToolCallInput(block, nextInput, false) ?? "";
+                            }
+                            stream.push({
+                                type: "toolcall_delta",
+                                contentIndex: andorraGetContentIndex(block),
+                                delta,
+                                partial: output,
+                            });
+                        }
+                    }
+                    const reasoningDetails = choice.delta.reasoning_details;
+                    if (Array.isArray(reasoningDetails)) {
+                        for (const detail of reasoningDetails) {
+                            if (!andorraIsOpenAIReasoningDetail(detail))
+                                continue;
+                            andorraEnsureThinkingBlock("");
+                            streamedReasoningDetails ??= [];
+                            // Keep provider replay data in the existing signature slot. OpenRouter streams
+                            // reasoning_details as deltas: consecutive text/summary deltas are merged into
+                            // logical entries, while encrypted entries remain opaque and discrete.
+                            andorraAppendOpenAIReasoningDetail(streamedReasoningDetails, detail);
+                        }
+                    }
+                }
+            }
+            for (const block of blocks) {
+                andorraFinishBlock(block);
+            }
+            if (options?.signal?.aborted) {
+                throw new Error("Request was aborted");
+            }
+            if (output.stopReason === "aborted") {
+                throw new Error("Request was aborted");
+            }
+            if (!hasFinishReason && !compat.supportsFinishReason) {
+                output.stopReason = output.content.some((block) => block.type === "toolCall") ? "toolUse" : "stop";
+            }
+            if (output.stopReason === "error") {
+                throw new Error(output.errorMessage || "Provider returned an error stop reason");
+            }
+            if ((compat.supportsFinishReason && !hasFinishReason) || output.stopReason === "pending") {
+                throw new Error("Stream ended without finish_reason");
+            }
+            stream.push({ type: "done", reason: output.stopReason, message: output });
+            stream.end();
+        }
+        catch (error) {
+            for (const block of output.content) {
+                if (block.type === "thinking") {
+                    andorraApplyStreamedReasoningDetails(block);
+                }
+                delete block.index;
+                // Streaming scratch buffers are only used during parsing; never persist them.
+                delete block.partialArgs;
+                delete block.customInput;
+                delete block.streamIndex;
+            }
+            output.stopReason = options?.signal?.aborted ? "aborted" : "error";
+            output.errorMessage = andorraFormatProviderError(andorraNormalizeProviderError(error));
+            // Some providers via OpenRouter give additional information in this field.
+            // normalizeProviderError already stringifies the parsed body (error.error)
+            // into errorMessage, so only append the raw metadata when it is not already
+            // present to avoid double-printing it.
+            const rawMetadata = error?.error?.metadata?.raw;
+            if (rawMetadata && !output.errorMessage.includes(String(rawMetadata))) {
+                output.errorMessage += `\n${rawMetadata}`;
+            }
+            stream.push({ type: "error", reason: output.stopReason, error: output });
+            stream.end();
+        }
+    })();
+    return stream;
+};
+export const andorraStreamSimple = (model, context, options) => {
+    andorraGetClientApiKey(model.provider, options?.apiKey, options?.headers);
+    const base = {
+        ...andorraBuildBaseOptions(model, context, options, options?.apiKey),
+        toolChoice: options?.toolChoice,
+    };
+    const clampedReasoning = options?.reasoning ? andorraClampThinkingLevel(model, options.reasoning) : undefined;
+    const reasoningEffort = clampedReasoning === "off" ? undefined : clampedReasoning;
+    return andorraStream(model, context, {
+        ...base,
+        reasoningEffort,
+        thinkingBudgets: options?.thinkingBudgets,
+    });
+};
+function andorraCreateClient(model, context, apiKey, optionsHeaders, fetch, sessionId, compat = andorraGetCompat(model)) {
+    const headers = { "User-Agent": andorraGetAndorraUserAgent(), ...model.headers };
+    if (model.provider === "github-copilot") {
+        const hasImages = andorraHasCopilotVisionInput(context.messages);
+        const copilotHeaders = andorraBuildCopilotDynamicHeaders({
+            messages: context.messages,
+            hasImages,
+        });
+        Object.assign(headers, copilotHeaders);
+    }
+    if (sessionId && compat.sendSessionAffinityHeaders) {
+        if (compat.sessionAffinityFormat === "openrouter") {
+            headers["x-session-id"] = sessionId;
+        }
+        else {
+            if (compat.sessionAffinityFormat === "openai") {
+                headers.session_id = sessionId;
+            }
+            headers["x-client-request-id"] = sessionId;
+            headers["x-session-affinity"] = sessionId;
+        }
+    }
+    // Merge options headers last so they can override defaults
+    if (optionsHeaders) {
+        Object.assign(headers, optionsHeaders);
+    }
+    return new OpenAI({
+        apiKey,
+        baseURL: model.baseUrl,
+        dangerouslyAllowBrowser: true,
+        fetch,
+        defaultHeaders: headers,
+    });
+}
+function andorraBuildParams(model, context, options, compat = andorraGetCompat(model), cacheRetention = andorraResolveCacheRetention(options?.cacheRetention, options?.env), grammarToolInputProperties = andorraCreateGrammarToolInputProperties(andorraGetDeclaredTools(context.messages), compat.supportsOpenAIGrammarTools)) {
+    const transcriptTools = andorraResolveTranscriptTools(context.messages, compat.supportsMidConvoSystemMessages === true && compat.supportsMidConvoToolAdditions === true);
+    const messages = andorraConvertMessages(model, context, compat, {
+        grammarToolInputProperties,
+    });
+    const cacheControl = andorraGetCompatCacheControl(compat, cacheRetention);
+    const params = {
+        model: model.id,
+        messages,
+        stream: true,
+        prompt_cache_key: (model.baseUrl.includes("api.openai.com") && cacheRetention !== "none") ||
+            (cacheRetention === "long" && compat.supportsLongCacheRetention)
+            ? andorraClampOpenAIPromptCacheKey(options?.sessionId)
+            : undefined,
+        prompt_cache_retention: cacheRetention === "long" && compat.supportsLongCacheRetention ? "24h" : undefined,
+    };
+    if (compat.supportsUsageInStreaming !== false) {
+        params.stream_options = { include_usage: true };
+    }
+    if (compat.supportsStore) {
+        params.store = false;
+    }
+    if (options?.maxTokens) {
+        if (compat.maxTokensField === "max_tokens") {
+            params.max_tokens = options.maxTokens;
+        }
+        else {
+            params.max_completion_tokens = options.maxTokens;
+        }
+    }
+    if (options?.temperature !== undefined) {
+        params.temperature = options.temperature;
+    }
+    if (transcriptTools.requestTools.length > 0) {
+        params.tools = andorraConvertTools(transcriptTools.requestTools, compat);
+        if (compat.zaiToolStream) {
+            params.tool_stream = true;
+        }
+    }
+    else if (andorraHasToolHistory(context.messages)) {
+        // Anthropic (via LiteLLM/proxy) requires tools param when conversation has tool_calls/tool_results
+        params.tools = [];
+    }
+    if (cacheControl) {
+        andorraApplyAnthropicCacheControl(messages, params.tools, cacheControl);
+    }
+    if (options?.toolChoice) {
+        params.tool_choice = options.toolChoice;
+    }
+    if (compat.vllmPriority !== undefined) {
+        params.priority = compat.vllmPriority;
+    }
+    const thinkingTokenBudgetField = andorraResolveThinkingTokenBudgetField(compat);
+    const thinkingBudget = andorraResolveClampedThinkingBudget(model, options, params);
+    if (compat.thinkingFormat === "zai" && model.reasoning) {
+        const zaiParams = params;
+        zaiParams.thinking = options?.reasoningEffort ? { type: "enabled", clear_thinking: false } : { type: "disabled" };
+        if (options?.reasoningEffort && compat.supportsReasoningEffort) {
+            const mappedEffort = model.thinkingLevelMap?.[options.reasoningEffort];
+            const effort = mappedEffort === undefined ? options.reasoningEffort : mappedEffort;
+            if (typeof effort === "string") {
+                zaiParams.reasoning_effort = effort;
+            }
+        }
+    }
+    else if (compat.thinkingFormat === "qwen" && model.reasoning) {
+        params.enable_thinking = !!options?.reasoningEffort;
+        if (options?.reasoningEffort && compat.supportsReasoningEffort) {
+            const effort = model.thinkingLevelMap?.[options.reasoningEffort] ?? options.reasoningEffort;
+            if (typeof effort === "string") {
+                params.reasoning_effort = effort;
+            }
+        }
+    }
+    else if (compat.thinkingFormat === "qwen-chat-template" && model.reasoning) {
+        params.chat_template_kwargs = {
+            enable_thinking: !!options?.reasoningEffort,
+            preserve_thinking: true,
+        };
+    }
+    else if (compat.thinkingFormat === "chat-template" && model.reasoning) {
+        const chatTemplateKwargs = andorraBuildChatTemplateValues(model, options, compat.chatTemplateKwargs, thinkingBudget);
+        if (chatTemplateKwargs) {
+            params.chat_template_kwargs = chatTemplateKwargs;
+        }
+    }
+    else if (compat.thinkingFormat === "baseten" && model.reasoning) {
+        const basetenParams = params;
+        const chatTemplateArgs = andorraBuildChatTemplateValues(model, options, compat.chatTemplateArgs, thinkingBudget);
+        if (chatTemplateArgs) {
+            basetenParams.chat_template_args = chatTemplateArgs;
+        }
+        if (compat.supportsReasoningEffort) {
+            const requestedEffort = options?.reasoningEffort;
+            const mappedEffort = requestedEffort ? model.thinkingLevelMap?.[requestedEffort] : model.thinkingLevelMap?.off;
+            const effort = mappedEffort === undefined ? requestedEffort : mappedEffort;
+            if (typeof effort === "string") {
+                basetenParams.reasoning_effort = effort;
+            }
+        }
+    }
+    else if (compat.thinkingFormat === "deepseek" && model.reasoning) {
+        if (options?.reasoningEffort) {
+            params.thinking = { type: "enabled" };
+        }
+        else if (model.thinkingLevelMap?.off !== null) {
+            params.thinking = { type: "disabled" };
+        }
+        if (options?.reasoningEffort && compat.supportsReasoningEffort) {
+            params.reasoning_effort =
+                model.thinkingLevelMap?.[options.reasoningEffort] ?? options.reasoningEffort;
+        }
+    }
+    else if (compat.thinkingFormat === "openrouter" && model.reasoning) {
+        // OpenRouter normalizes reasoning across providers via a nested reasoning object.
+        const openRouterParams = params;
+        if (options?.reasoningEffort) {
+            openRouterParams.reasoning = {
+                effort: model.thinkingLevelMap?.[options.reasoningEffort] ?? options.reasoningEffort,
+            };
+        }
+        else if (model.thinkingLevelMap?.off !== null) {
+            openRouterParams.reasoning = { effort: model.thinkingLevelMap?.off ?? "none" };
+        }
+    }
+    else if (compat.thinkingFormat === "ant-ling" && model.reasoning && options?.reasoningEffort) {
+        const effort = model.thinkingLevelMap?.[options.reasoningEffort];
+        if (typeof effort === "string") {
+            params.reasoning = { effort };
+        }
+    }
+    else if (compat.thinkingFormat === "together" && model.reasoning) {
+        const togetherParams = params;
+        togetherParams.reasoning = { enabled: !!options?.reasoningEffort };
+        if (options?.reasoningEffort && compat.supportsReasoningEffort) {
+            togetherParams.reasoning_effort = model.thinkingLevelMap?.[options.reasoningEffort] ?? options.reasoningEffort;
+        }
+    }
+    else if (compat.thinkingFormat === "string-thinking" && model.reasoning) {
+        const stringThinkingParams = params;
+        if (options?.reasoningEffort) {
+            stringThinkingParams.thinking = model.thinkingLevelMap?.[options.reasoningEffort] ?? options.reasoningEffort;
+        }
+        else if (model.thinkingLevelMap?.off !== null) {
+            stringThinkingParams.thinking = model.thinkingLevelMap?.off ?? "none";
+        }
+    }
+    else if (options?.reasoningEffort && model.reasoning && compat.supportsReasoningEffort) {
+        // OpenAI-style reasoning_effort
+        params.reasoning_effort = model.thinkingLevelMap?.[options.reasoningEffort] ?? options.reasoningEffort;
+    }
+    else if (!options?.reasoningEffort && model.reasoning && compat.supportsReasoningEffort) {
+        const offValue = model.thinkingLevelMap?.off;
+        if (typeof offValue === "string") {
+            params.reasoning_effort = offValue;
+        }
+    }
+    // Cap reasoning with a top-level budget field. Independent of thinkingFormat: the
+    // same server can serve zai, qwen or chat-template models. Reasoning and the answer
+    // share max_tokens here, so an uncapped reasoning phase can consume the whole
+    // response and leave no answer and no tool call.
+    if (thinkingTokenBudgetField && thinkingBudget !== undefined) {
+        Object.assign(params, { [thinkingTokenBudgetField]: thinkingBudget });
+    }
+    // OpenRouter provider routing preferences
+    if (model.compat?.openRouterRouting) {
+        params.provider = model.compat.openRouterRouting;
+    }
+    // Vercel AI Gateway provider routing preferences
+    if (model.compat?.vercelGatewayRouting) {
+        const routing = model.compat.vercelGatewayRouting;
+        if (routing.only || routing.order) {
+            const gatewayOptions = {};
+            if (routing.only)
+                gatewayOptions.only = routing.only;
+            if (routing.order)
+                gatewayOptions.order = routing.order;
+            params.providerOptions = { gateway: gatewayOptions };
+        }
+    }
+    // Last so custom keys override the named request fields.
+    if (options?.samplingParams) {
+        Object.assign(params, options.samplingParams);
+    }
+    return params;
+}
+function andorraResolveThinkingTokenBudgetField(compat) {
+    if (compat.thinkingTokenBudgetField)
+        return compat.thinkingTokenBudgetField;
+    if (compat.supportsThinkingTokenBudget)
+        return "thinking_token_budget";
+    return undefined;
+}
+function andorraResolveClampedThinkingBudget(model, options, params) {
+    if (!options?.reasoningEffort || !model.reasoning)
+        return undefined;
+    const ceiling = params.max_tokens ?? params.max_completion_tokens ?? model.maxTokens;
+    const budget = andorraClampThinkingBudgetToAnswerRoom(andorraThinkingBudgetForLevel(options.reasoningEffort, options.thinkingBudgets), ceiling);
+    return budget > 0 ? budget : undefined;
+}
+function andorraBuildChatTemplateValues(model, options, values, thinkingBudget) {
+    const resolvedValues = {};
+    for (const [key, value] of Object.entries(values)) {
+        const resolved = andorraResolveChatTemplateKwargValue(model, options, value, thinkingBudget);
+        if (resolved !== undefined) {
+            resolvedValues[key] = resolved;
+        }
+    }
+    return Object.keys(resolvedValues).length > 0 ? resolvedValues : undefined;
+}
+function andorraResolveChatTemplateKwargValue(model, options, value, thinkingBudget) {
+    if (typeof value !== "object" || value === null) {
+        return value;
+    }
+    const reasoningEffort = options?.reasoningEffort;
+    if (!reasoningEffort && value.omitWhenOff) {
+        return undefined;
+    }
+    if (value.$var === "thinking.enabled") {
+        return !!reasoningEffort;
+    }
+    if (value.$var === "thinking.budget") {
+        return thinkingBudget;
+    }
+    const mappedValue = reasoningEffort ? model.thinkingLevelMap?.[reasoningEffort] : model.thinkingLevelMap?.off;
+    return mappedValue === undefined ? reasoningEffort : typeof mappedValue === "string" ? mappedValue : undefined;
+}
+function andorraGetCompatCacheControl(compat, cacheRetention) {
+    if (compat.cacheControlFormat !== "anthropic" || cacheRetention === "none") {
+        return undefined;
+    }
+    const ttl = cacheRetention === "long" && compat.supportsLongCacheRetention ? "1h" : undefined;
+    return { type: "ephemeral", ...(ttl ? { ttl } : {}) };
+}
+function andorraApplyAnthropicCacheControl(messages, tools, cacheControl) {
+    andorraAddCacheControlToSystemPrompt(messages, cacheControl);
+    andorraAddCacheControlToLastTool(tools, cacheControl);
+    andorraAddCacheControlToLastConversationMessage(messages, cacheControl);
+}
+function andorraAddCacheControlToSystemPrompt(messages, cacheControl) {
+    for (const message of messages) {
+        if (message.role === "system" || message.role === "developer") {
+            andorraAddCacheControlToInstructionMessage(message, cacheControl);
+            return;
+        }
+    }
+}
+function andorraAddCacheControlToLastConversationMessage(messages, cacheControl) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const message = messages[i];
+        if (message.role === "user" || message.role === "assistant" || message.role === "tool") {
+            if (andorraAddCacheControlToMessage(message, cacheControl)) {
+                return;
+            }
+        }
+    }
+}
+function andorraAddCacheControlToLastTool(tools, cacheControl) {
+    if (!tools || tools.length === 0) {
+        return;
+    }
+    const lastTool = tools[tools.length - 1];
+    lastTool.cache_control = cacheControl;
+}
+function andorraAddCacheControlToInstructionMessage(message, cacheControl) {
+    return andorraAddCacheControlToTextContent(message, cacheControl);
+}
+function andorraAddCacheControlToMessage(message, cacheControl) {
+    if (message.role === "user" || message.role === "assistant" || message.role === "tool") {
+        return andorraAddCacheControlToTextContent(message, cacheControl);
+    }
+    return false;
+}
+function andorraAddCacheControlToTextContent(message, cacheControl) {
+    const content = message.content;
+    if (typeof content === "string") {
+        if (content.length === 0) {
+            return false;
+        }
+        message.content = [
+            {
+                type: "text",
+                text: content,
+                cache_control: cacheControl,
+            },
+        ];
+        return true;
+    }
+    if (!Array.isArray(content)) {
+        return false;
+    }
+    for (let i = content.length - 1; i >= 0; i--) {
+        const part = content[i];
+        if (part?.type === "text") {
+            const textPart = part;
+            textPart.cache_control = cacheControl;
+            return true;
+        }
+    }
+    return false;
+}
+export function andorraConvertMessages(model, context, compat, options) {
+    const normalizedContext = andorraResolveTranscript(context, compat.supportsMidConvoSystemMessages);
+    const params = [];
+    const andorraNormalizeToolCallId = (id) => {
+        // Handle pipe-separated IDs from OpenAI Responses API
+        // Format: {call_id}|{id} where {id} can be 400+ chars with special chars (+, /, =)
+        // These come from providers like github-copilot, openai-codex, opencode
+        // Extract just the call_id part and normalize it
+        // Multiple tool calls in the same turn can share call_id but differ by item_id.
+        // Preserve item-level uniqueness when replaying into Chat Completions, which
+        // requires distinct tool call ids.
+        if (id.includes("|")) {
+            // Sanitize to allowed chars and truncate to 40 chars (OpenAI limit)
+            const separatorIndex = id.indexOf("|");
+            const callId = id.slice(0, separatorIndex).replace(/[^a-zA-Z0-9_-]/g, "_");
+            const itemId = id.slice(separatorIndex + 1).replace(/[^a-zA-Z0-9_-]/g, "_");
+            const combinedId = itemId.length > 0 ? `${callId}_${itemId}` : callId;
+            if (combinedId.length <= 40) {
+                return combinedId;
+            }
+            const hash = andorraShortHash(id).slice(0, 8);
+            const prefix = callId.slice(0, Math.max(1, 40 - hash.length - 1));
+            return `${prefix}_${hash}`;
+        }
+        if (model.provider === "openai")
+            return id.length > 40 ? id.slice(0, 40) : id;
+        return id;
+    };
+    const transformedMessages = andorraTransformMessages(normalizedContext.messages, model, (id) => andorraNormalizeToolCallId(id));
+    const transcriptTools = andorraResolveTranscriptTools(normalizedContext.messages, compat.supportsMidConvoSystemMessages === true && compat.supportsMidConvoToolAdditions === true);
+    const instructionRole = model.reasoning && compat.supportsDeveloperRole ? "developer" : "system";
+    let lastRole = null;
+    for (let i = 0; i < transformedMessages.length; i++) {
+        const msg = transformedMessages[i];
+        // Some providers don't allow user messages directly after tool results
+        // Insert a synthetic assistant message to bridge the gap
+        if (compat.requiresAssistantAfterToolResult && lastRole === "toolResult" && msg.role === "user") {
+            params.push({
+                role: "assistant",
+                content: "I have processed the tool results.",
+            });
+        }
+        if (msg.role === "system") {
+            const addedTools = i > 0 && transcriptTools.anchorsAdditions ? (msg.toolsAdded ?? []) : [];
+            if (addedTools.length > 0) {
+                const kimiToolMessage = {
+                    role: "system",
+                    tools: andorraConvertTools(addedTools, compat),
+                };
+                params.push(kimiToolMessage);
+            }
+            const text = i === 0 ? andorraGetSystemMessageText(msg) : andorraRenderSystemMessageUpdate(msg);
+            if (text.length > 0) {
+                params.push({ role: instructionRole, content: andorraSanitizeSurrogates(text) });
+            }
+        }
+        else if (msg.role === "user") {
+            if (typeof msg.content === "string") {
+                params.push({
+                    role: "user",
+                    content: andorraSanitizeSurrogates(msg.content),
+                });
+            }
+            else {
+                const content = msg.content.map((item) => {
+                    if (item.type === "text") {
+                        return {
+                            type: "text",
+                            text: andorraSanitizeSurrogates(item.text),
+                        };
+                    }
+                    else {
+                        return {
+                            type: "image_url",
+                            image_url: {
+                                url: `data:${item.mimeType};base64,${item.data}`,
+                            },
+                        };
+                    }
+                });
+                if (content.length === 0)
+                    continue;
+                params.push({
+                    role: "user",
+                    content,
+                });
+            }
+        }
+        else if (msg.role === "assistant") {
+            // Some providers don't accept null content, use empty string instead
+            const assistantMsg = {
+                role: "assistant",
+                content: compat.requiresAssistantAfterToolResult ? "" : null,
+            };
+            const assistantTextParts = msg.content
+                .filter(andorraIsTextContentBlock)
+                .filter((block) => block.text.trim().length > 0)
+                .map((block) => ({
+                type: "text",
+                text: andorraSanitizeSurrogates(block.text),
+            }));
+            const assistantText = assistantTextParts.map((part) => part.text).join("");
+            const thinkingBlocks = msg.content.filter(andorraIsThinkingContentBlock);
+            const toolCalls = msg.content.filter(andorraIsToolCallBlock);
+            const signedReasoningDetails = thinkingBlocks
+                .map((block) => andorraParseOpenAIReasoningDetails(block.thinkingSignature))
+                .find((details) => details !== undefined);
+            const legacyReasoningDetails = toolCalls
+                .map((toolCall) => andorraParseLegacyEncryptedReasoningDetail(toolCall.thoughtSignature))
+                .filter((detail) => detail !== undefined);
+            const preservedReasoningDetails = signedReasoningDetails ?? (legacyReasoningDetails.length > 0 ? legacyReasoningDetails : undefined);
+            const nonEmptyThinkingBlocks = thinkingBlocks.filter((block) => block.thinking.trim().length > 0);
+            if (nonEmptyThinkingBlocks.length > 0) {
+                if (compat.requiresThinkingAsText) {
+                    // Convert thinking blocks to plain text (no tags to avoid model mimicking them)
+                    const thinkingText = nonEmptyThinkingBlocks
+                        .map((block) => andorraSanitizeSurrogates(block.thinking))
+                        .join("\n\n");
+                    assistantMsg.content = [{ type: "text", text: thinkingText }, ...assistantTextParts];
+                }
+                else {
+                    // Always send assistant content as a plain string (OpenAI Chat Completions
+                    // API standard format). Sending as an array of {type:"text", text:"..."}
+                    // objects is non-standard and causes some models (e.g. DeepSeek V3.2 via
+                    // NVIDIA NIM) to mirror the content-block structure literally in their
+                    // output, producing recursive nesting like [{'type':'text','text':'[{...}]'}].
+                    if (assistantText.length > 0) {
+                        assistantMsg.content = assistantText;
+                    }
+                    // reasoning_details is the structured alternative to a raw reasoning field.
+                    if (!preservedReasoningDetails) {
+                        // Use the signature from the first thinking block if available (for llama.cpp server + gpt-oss)
+                        let signature = nonEmptyThinkingBlocks[0].thinkingSignature;
+                        if (model.provider === "opencode-go" && signature === "reasoning") {
+                            signature = "reasoning_content";
+                        }
+                        if (signature && andorraIsOpenAICompletionsReasoningField(signature)) {
+                            assistantMsg[signature] = nonEmptyThinkingBlocks.map((block) => block.thinking).join("\n");
+                        }
+                    }
+                }
+            }
+            else if (assistantText.length > 0) {
+                // Always send assistant content as a plain string (OpenAI Chat Completions
+                // API standard format). Sending as an array of {type:"text", text:"..."}
+                // objects is non-standard and causes some models (e.g. DeepSeek V3.2 via
+                // NVIDIA NIM) to mirror the content-block structure literally in their
+                // output, producing recursive nesting like [{'type':'text','text':'[{...}]'}].
+                assistantMsg.content = assistantText;
+            }
+            if (toolCalls.length > 0) {
+                assistantMsg.tool_calls = toolCalls.map((tc) => {
+                    const customInputProperty = options?.grammarToolInputProperties?.get(tc.name);
+                    if (customInputProperty !== undefined) {
+                        return {
+                            id: tc.id,
+                            type: "custom",
+                            custom: {
+                                name: tc.name,
+                                input: andorraSanitizeSurrogates(andorraGetGrammarToolInput(tc.name, tc.arguments, customInputProperty)),
+                            },
+                        };
+                    }
+                    return {
+                        id: tc.id,
+                        type: "function",
+                        function: {
+                            name: tc.name,
+                            arguments: JSON.stringify(tc.arguments),
+                        },
+                    };
+                });
+            }
+            if (preservedReasoningDetails) {
+                assistantMsg.reasoning_details = preservedReasoningDetails;
+            }
+            if (compat.requiresReasoningContentOnAssistantMessages &&
+                model.reasoning &&
+                assistantMsg.reasoning_content === undefined) {
+                assistantMsg.reasoning_content = "";
+            }
+            // Skip assistant messages that have no content and no tool calls.
+            // Some providers require "either content or tool_calls, but not none".
+            // Other providers also don't accept empty assistant messages.
+            // This handles aborted assistant responses that got no content.
+            const content = assistantMsg.content;
+            const hasContent = content !== null &&
+                content !== undefined &&
+                (typeof content === "string" ? content.length > 0 : content.length > 0);
+            if (!hasContent && !assistantMsg.tool_calls) {
+                continue;
+            }
+            params.push(assistantMsg);
+        }
+        else if (msg.role === "toolResult") {
+            const imageBlocks = [];
+            let j = i;
+            for (; j < transformedMessages.length && transformedMessages[j].role === "toolResult"; j++) {
+                const toolMsg = transformedMessages[j];
+                // Extract text and image content
+                const textResult = toolMsg.content
+                    .filter(andorraIsTextContentBlock)
+                    .map((block) => block.text)
+                    .join("\n");
+                const hasImages = toolMsg.content.some((c) => c.type === "image");
+                // Always send tool result with text (or placeholder if only images)
+                const hasText = textResult.length > 0;
+                const toolResultText = hasText ? textResult : hasImages ? "(see attached image)" : "(no tool output)";
+                // Some providers require the 'name' field in tool results
+                const toolResultMsg = {
+                    role: "tool",
+                    content: andorraSanitizeSurrogates(toolResultText),
+                    tool_call_id: toolMsg.toolCallId,
+                };
+                if (compat.requiresToolResultName && toolMsg.toolName) {
+                    toolResultMsg.name = toolMsg.toolName;
+                }
+                params.push(toolResultMsg);
+                if (hasImages && model.input.includes("image")) {
+                    for (const block of toolMsg.content) {
+                        if (andorraIsImageContentBlock(block)) {
+                            imageBlocks.push({
+                                type: "image_url",
+                                image_url: {
+                                    url: `data:${block.mimeType};base64,${block.data}`,
+                                },
+                            });
+                        }
+                    }
+                }
+            }
+            i = j - 1;
+            if (imageBlocks.length > 0) {
+                if (compat.requiresAssistantAfterToolResult) {
+                    params.push({
+                        role: "assistant",
+                        content: "I have processed the tool results.",
+                    });
+                }
+                params.push({
+                    role: "user",
+                    content: [
+                        {
+                            type: "text",
+                            text: "Attached image(s) from tool result:",
+                        },
+                        ...imageBlocks,
+                    ],
+                });
+                lastRole = "user";
+            }
+            else {
+                lastRole = "toolResult";
+            }
+            continue;
+        }
+        lastRole = msg.role;
+    }
+    return params;
+}
+function andorraConvertTools(tools, compat) {
+    return tools.map((tool) => {
+        const grammar = andorraResolveGrammarConstrainedSampling(tool, compat.supportsOpenAIGrammarTools);
+        if (grammar) {
+            return {
+                type: "custom",
+                custom: {
+                    name: tool.name,
+                    description: tool.description,
+                    format: {
+                        type: "grammar",
+                        grammar: {
+                            syntax: grammar.format,
+                            definition: grammar.definition,
+                        },
+                    },
+                },
+            };
+        }
+        const strict = andorraResolveJsonSchemaStrictSampling(tool, compat.supportsStrictMode !== false);
+        return {
+            type: "function",
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: andorraGetJsonSchemaToolParameters(tool, strict),
+                // Only include strict if provider supports it. Some reject unknown fields.
+                ...(compat.supportsStrictMode !== false && { strict: strict ?? false }),
+            },
+        };
+    });
+}
+function andorraParseChunkUsage(rawUsage, model) {
+    const promptTokens = rawUsage.prompt_tokens || 0;
+    const cacheReadTokens = rawUsage.prompt_tokens_details?.cached_tokens ?? rawUsage.prompt_cache_hit_tokens ?? rawUsage.cached_tokens ?? 0;
+    const cacheWriteTokens = rawUsage.prompt_tokens_details?.cache_write_tokens || 0;
+    // Follow documented OpenAI/OpenRouter semantics: cached_tokens is cache-read
+    // tokens (hits). Providers disagree on placement: OpenAI/OpenRouter use
+    // prompt_tokens_details.cached_tokens, DeepSeek uses prompt_cache_hit_tokens,
+    // and Kimi documents top-level usage.cached_tokens on the final usage chunk.
+    // OpenAI does not document or emit cache_write_tokens, but
+    // OpenRouter-compatible providers can include it as a separate write count.
+    // OpenRouter's own provider/tests affirm the separate mapping:
+    // https://github.com/OpenRouterTeam/ai-sdk-provider/pull/409
+    // Do not subtract writes from cached_tokens, otherwise spec-compliant
+    // providers are under-reported. DS4 mirrors this contract too:
+    // https://github.com/antirez/ds4/pull/29
+    const input = Math.max(0, promptTokens - cacheReadTokens - cacheWriteTokens);
+    // OpenAI completion_tokens already includes reasoning_tokens.
+    const outputTokens = rawUsage.completion_tokens || 0;
+    const usage = {
+        input,
+        output: outputTokens,
+        cacheRead: cacheReadTokens,
+        cacheWrite: cacheWriteTokens,
+        reasoning: rawUsage.completion_tokens_details?.reasoning_tokens || 0,
+        totalTokens: input + outputTokens + cacheReadTokens + cacheWriteTokens,
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+    };
+    andorraCalculateCost(model, usage);
+    return usage;
+}
+function andorraMapStopReason(reason) {
+    if (reason === null)
+        return { stopReason: "stop" };
+    switch (reason) {
+        case "stop":
+        case "end":
+            return { stopReason: "stop" };
+        case "length":
+            return { stopReason: "length" };
+        case "function_call":
+        case "tool_calls":
+            return { stopReason: "toolUse" };
+        case "content_filter":
+            return { stopReason: "error", errorMessage: "Provider finish_reason: content_filter" };
+        case "network_error":
+            return { stopReason: "error", errorMessage: "Provider finish_reason: network_error" };
+        default:
+            return {
+                stopReason: "error",
+                errorMessage: `Provider finish_reason: ${reason}`,
+            };
+    }
+}
+/**
+ * Auto-detect compatibility settings from provider name and baseUrl.
+ * Used as the base when model.compat is not set; explicit model.compat
+ * entries override these detected values.
+ */
+function andorraDetectCompat(model) {
+    const provider = model.provider;
+    const baseUrl = model.baseUrl;
+    const isZai = provider === "zai" ||
+        provider === "zai-coding-cn" ||
+        baseUrl.includes("api.z.ai") ||
+        baseUrl.includes("open.bigmodel.cn");
+    const isTogether = provider === "together" || baseUrl.includes("api.together.ai") || baseUrl.includes("api.together.xyz");
+    const isMoonshot = provider === "moonshotai" || provider === "moonshotai-cn" || baseUrl.includes("api.moonshot.");
+    const isOpenRouter = provider === "openrouter" || baseUrl.includes("openrouter.ai");
+    const isCloudflareWorkersAI = provider === "cloudflare-workers-ai" || baseUrl.includes("api.cloudflare.com");
+    const isCloudflareAiGateway = provider === "cloudflare-ai-gateway" || baseUrl.includes("gateway.ai.cloudflare.com");
+    const isNvidia = provider === "nvidia" || baseUrl.includes("integrate.api.nvidia.com");
+    const isAntLing = provider === "ant-ling" || baseUrl.includes("api.ant-ling.com");
+    const isCerebras = provider === "cerebras" || baseUrl.includes("cerebras.ai");
+    const isDeepSeek = provider === "deepseek" || baseUrl.toLowerCase().includes("deepseek.com");
+    const isNonStandard = isNvidia ||
+        isCerebras ||
+        provider === "xai" ||
+        baseUrl.includes("api.x.ai") ||
+        isTogether ||
+        baseUrl.includes("chutes.ai") ||
+        isDeepSeek ||
+        isZai ||
+        isMoonshot ||
+        provider === "opencode" ||
+        baseUrl.includes("opencode.ai") ||
+        isCloudflareWorkersAI ||
+        isCloudflareAiGateway ||
+        isAntLing;
+    const useMaxTokens = baseUrl.includes("chutes.ai") ||
+        isDeepSeek ||
+        isMoonshot ||
+        isCloudflareAiGateway ||
+        isTogether ||
+        isNvidia ||
+        isAntLing ||
+        isZai;
+    const isGrok = provider === "xai" || baseUrl.includes("api.x.ai");
+    const isOpenRouterDeveloperRoleModel = isOpenRouter && (model.id.startsWith("anthropic/") || model.id.startsWith("openai/"));
+    const cacheControlFormat = provider === "openrouter" && model.id.startsWith("anthropic/") ? "anthropic" : undefined;
+    return {
+        supportsStore: !isNonStandard,
+        supportsDeveloperRole: isOpenRouterDeveloperRoleModel || (!isNonStandard && !isOpenRouter),
+        supportsReasoningEffort: !isGrok && !isZai && !isMoonshot && !isTogether && !isCloudflareAiGateway && !isNvidia && !isAntLing,
+        supportsUsageInStreaming: true,
+        supportsFinishReason: true,
+        maxTokensField: useMaxTokens ? "max_tokens" : "max_completion_tokens",
+        requiresToolResultName: false,
+        requiresAssistantAfterToolResult: false,
+        requiresThinkingAsText: false,
+        requiresReasoningContentOnAssistantMessages: isDeepSeek,
+        thinkingFormat: isDeepSeek
+            ? "deepseek"
+            : isZai
+                ? "zai"
+                : isTogether
+                    ? "together"
+                    : isAntLing
+                        ? "ant-ling"
+                        : isOpenRouter
+                            ? "openrouter"
+                            : "openai",
+        openRouterRouting: {},
+        vercelGatewayRouting: {},
+        chatTemplateKwargs: {},
+        chatTemplateArgs: {},
+        zaiToolStream: false,
+        supportsThinkingTokenBudget: false,
+        thinkingTokenBudgetField: undefined,
+        // OpenAI compatibility alone does not imply strict JSON-schema tool support.
+        supportsStrictMode: false,
+        supportsOpenAIGrammarTools: false,
+        supportsMidConvoSystemMessages: false,
+        supportsMidConvoToolAdditions: false,
+        cacheControlFormat,
+        sendSessionAffinityHeaders: isOpenRouter,
+        sessionAffinityFormat: isOpenRouter ? "openrouter" : "openai",
+        supportsLongCacheRetention: !(isTogether ||
+            isCloudflareWorkersAI ||
+            isCloudflareAiGateway ||
+            isNvidia ||
+            isAntLing),
+    };
+}
+/**
+ * Get resolved compatibility settings for a model.
+ * Auto-detects from provider/URL then overrides with explicit model.compat.
+ */
+function andorraGetCompat(model) {
+    const detected = andorraDetectCompat(model);
+    if (!model.compat)
+        return detected;
+    return {
+        supportsStore: model.compat.supportsStore ?? detected.supportsStore,
+        supportsDeveloperRole: model.compat.supportsDeveloperRole ?? detected.supportsDeveloperRole,
+        supportsReasoningEffort: model.compat.supportsReasoningEffort ?? detected.supportsReasoningEffort,
+        supportsUsageInStreaming: model.compat.supportsUsageInStreaming ?? detected.supportsUsageInStreaming,
+        supportsFinishReason: model.compat.supportsFinishReason ?? detected.supportsFinishReason,
+        maxTokensField: model.compat.maxTokensField ?? detected.maxTokensField,
+        requiresToolResultName: model.compat.requiresToolResultName ?? detected.requiresToolResultName,
+        requiresAssistantAfterToolResult: model.compat.requiresAssistantAfterToolResult ?? detected.requiresAssistantAfterToolResult,
+        requiresThinkingAsText: model.compat.requiresThinkingAsText ?? detected.requiresThinkingAsText,
+        requiresReasoningContentOnAssistantMessages: model.compat.requiresReasoningContentOnAssistantMessages ??
+            detected.requiresReasoningContentOnAssistantMessages,
+        thinkingFormat: model.compat.thinkingFormat ?? detected.thinkingFormat,
+        openRouterRouting: model.compat.openRouterRouting ?? {},
+        vercelGatewayRouting: model.compat.vercelGatewayRouting ?? detected.vercelGatewayRouting,
+        chatTemplateKwargs: model.compat.chatTemplateKwargs ?? detected.chatTemplateKwargs,
+        chatTemplateArgs: model.compat.chatTemplateArgs ?? detected.chatTemplateArgs,
+        zaiToolStream: model.compat.zaiToolStream ?? detected.zaiToolStream,
+        supportsThinkingTokenBudget: model.compat.supportsThinkingTokenBudget ?? detected.supportsThinkingTokenBudget,
+        thinkingTokenBudgetField: model.compat.thinkingTokenBudgetField ?? detected.thinkingTokenBudgetField,
+        supportsStrictMode: model.compat.supportsStrictMode ?? detected.supportsStrictMode,
+        supportsOpenAIGrammarTools: model.compat.supportsOpenAIGrammarTools ?? detected.supportsOpenAIGrammarTools,
+        supportsMidConvoSystemMessages: model.compat.supportsMidConvoSystemMessages ?? detected.supportsMidConvoSystemMessages,
+        supportsMidConvoToolAdditions: model.compat.supportsMidConvoToolAdditions ?? detected.supportsMidConvoToolAdditions,
+        cacheControlFormat: model.compat.cacheControlFormat ?? detected.cacheControlFormat,
+        sendSessionAffinityHeaders: model.compat.sendSessionAffinityHeaders ?? detected.sendSessionAffinityHeaders,
+        sessionAffinityFormat: model.compat.sessionAffinityFormat ?? detected.sessionAffinityFormat,
+        supportsLongCacheRetention: model.compat.supportsLongCacheRetention ?? detected.supportsLongCacheRetention,
+        vllmPriority: model.compat.vllmPriority,
+    };
+}