@jsonstudio/llms 0.6.938 → 0.6.1164

package/dist/conversion/hub/operation-table/semantic-mappers/gemini-mapper.js

@@ -0,0 +1,841 @@
+import { isJsonObject, jsonClone } from '../../types/json.js';
+import { buildOpenAIChatFromGeminiRequest } from '../../../codecs/gemini-openai-codec.js';
+import { encodeMetadataPassthrough, extractMetadataPassthrough } from '../../../shared/metadata-passthrough.js';
+import { mapBridgeToolsToChat, mapChatToolsToBridge } from '../../../shared/tool-mapping.js';
+import { prepareGeminiToolsForBridge, buildGeminiToolsFromBridge } from '../../../shared/gemini-tool-utils.js';
+import { ensureProtocolState, getProtocolState } from '../../../shared/protocol-state.js';
+import { applyClaudeThinkingToolSchemaCompat } from '../../../compat/actions/claude-thinking-tools.js';
+const GENERATION_CONFIG_KEYS = [
+    { source: 'temperature', target: 'temperature' },
+    { source: 'topP', target: 'top_p' },
+    { source: 'topK', target: 'top_k' },
+    { source: 'maxOutputTokens', target: 'max_output_tokens' },
+    { source: 'candidateCount', target: 'candidate_count' },
+    { source: 'responseMimeType', target: 'response_mime_type' },
+    { source: 'stopSequences', target: 'stop_sequences' }
+];
+const PASSTHROUGH_METADATA_PREFIX = 'rcc_passthrough_';
+const PASSTHROUGH_PARAMETERS = ['tool_choice'];
+const DUMMY_THOUGHT_SIGNATURE = 'skip_thought_signature_validator';
+function coerceThoughtSignature(value) {
+    if (typeof value === 'string' && value.trim().length) {
+        return value.trim();
+    }
+    return undefined;
+}
+function ensureGeminiSemanticsNode(chat) {
+    if (!chat.semantics || typeof chat.semantics !== 'object') {
+        chat.semantics = {};
+    }
+    if (!chat.semantics.gemini || !isJsonObject(chat.semantics.gemini)) {
+        chat.semantics.gemini = {};
+    }
+    return chat.semantics.gemini;
+}
+function ensureSystemSemantics(chat) {
+    if (!chat.semantics || typeof chat.semantics !== 'object') {
+        chat.semantics = {};
+    }
+    if (!chat.semantics.system || !isJsonObject(chat.semantics.system)) {
+        chat.semantics.system = {};
+    }
+    return chat.semantics.system;
+}
+function markGeminiExplicitEmptyTools(chat) {
+    if (!chat.semantics || typeof chat.semantics !== 'object') {
+        chat.semantics = {};
+    }
+    if (!chat.semantics.tools || !isJsonObject(chat.semantics.tools)) {
+        chat.semantics.tools = {};
+    }
+    chat.semantics.tools.explicitEmpty = true;
+}
+function readGeminiSemantics(chat) {
+    if (!chat.semantics || typeof chat.semantics !== 'object') {
+        return undefined;
+    }
+    const node = chat.semantics.gemini;
+    return node && isJsonObject(node) ? node : undefined;
+}
+function hasExplicitEmptyToolsSemantics(chat) {
+    if (!chat.semantics || typeof chat.semantics !== 'object') {
+        return false;
+    }
+    const toolsNode = chat.semantics.tools;
+    if (!toolsNode || !isJsonObject(toolsNode)) {
+        return false;
+    }
+    return Boolean(toolsNode.explicitEmpty);
+}
+function readSystemTextBlocksFromSemantics(chat) {
+    if (!chat.semantics || typeof chat.semantics !== 'object') {
+        return undefined;
+    }
+    const systemNode = chat.semantics.system;
+    if (!systemNode || !isJsonObject(systemNode)) {
+        return undefined;
+    }
+    const rawBlocks = systemNode.textBlocks;
+    if (!Array.isArray(rawBlocks)) {
+        return undefined;
+    }
+    const normalized = rawBlocks
+        .map((entry) => (typeof entry === 'string' ? entry : undefined))
+        .filter((value) => typeof value === 'string' && value.trim().length > 0);
+    return normalized.length ? normalized : undefined;
+}
+function extractThoughtSignatureFromToolCall(tc) {
+    if (!tc || typeof tc !== 'object') {
+        return undefined;
+    }
+    const node = tc;
+    const direct = coerceThoughtSignature(node.thought_signature ?? node.thoughtSignature);
+    if (direct) {
+        return direct;
+    }
+    const extra = node.extra_content ?? node.extraContent;
+    if (extra && typeof extra === 'object') {
+        const googleNode = extra.google ?? extra.Google;
+        if (googleNode && typeof googleNode === 'object') {
+            return coerceThoughtSignature(googleNode.thought_signature ?? googleNode.thoughtSignature);
+        }
+    }
+    return undefined;
+}
+function normalizeToolOutputs(messages, missing) {
+    const outputs = [];
+    messages.forEach((msg, index) => {
+        if (msg.role !== 'tool')
+            return;
+        const callId = msg.tool_call_id || msg.id;
+        if (typeof callId !== 'string' || !callId.trim()) {
+            missing.push({ path: `messages[${index}].tool_call_id`, reason: 'missing_tool_call_id' });
+            return;
+        }
+        outputs.push({
+            tool_call_id: callId.trim(),
+            content: normalizeToolContent(msg.content),
+            name: typeof msg.name === 'string' ? msg.name : undefined
+        });
+    });
+    return outputs.length ? outputs : undefined;
+}
+function synthesizeToolOutputsFromMessages(messages) {
+    if (!Array.isArray(messages)) {
+        return [];
+    }
+    const outputs = [];
+    for (const message of messages) {
+        if (!message || typeof message !== 'object')
+            continue;
+        if (message.role !== 'assistant')
+            continue;
+        const toolCalls = Array.isArray(message.tool_calls)
+            ? message.tool_calls
+            : [];
+        for (const call of toolCalls) {
+            const callId = typeof call.id === 'string' ? call.id : undefined;
+            if (!callId) {
+                continue;
+            }
+            const existing = outputs.find((entry) => entry.tool_call_id === callId);
+            if (existing) {
+                continue;
+            }
+            outputs.push({
+                tool_call_id: callId,
+                content: '',
+                name: (call.function && call.function.name) || undefined
+            });
+        }
+    }
+    return outputs;
+}
+function normalizeToolContent(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value == null)
+        return '';
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value ?? '');
+    }
+}
+function convertToolMessageToOutput(message, allowedIds) {
+    const rawId = (message.tool_call_id ?? message.id);
+    const callId = typeof rawId === 'string' && rawId.trim().length ? rawId.trim() : undefined;
+    if (!callId) {
+        return null;
+    }
+    if (allowedIds && !allowedIds.has(callId)) {
+        return null;
+    }
+    return {
+        tool_call_id: callId,
+        content: normalizeToolContent(message.content),
+        name: typeof message.name === 'string' ? message.name : undefined
+    };
+}
+function selectAntigravityClaudeThinkingMessages(messages) {
+    if (!Array.isArray(messages) || messages.length === 0) {
+        return messages ?? [];
+    }
+    // 为了与 Responses 入口对齐，Claude-thinking 在发往 Antigravity 时仅保留
+    // 当前这一轮的 user 消息，丢弃历史 model/assistant 片段（例如错误日志中的「{」）。
+    let lastUserIndex = -1;
+    for (let i = messages.length - 1; i >= 0; i -= 1) {
+        const msg = messages[i];
+        if (!msg || typeof msg !== 'object')
+            continue;
+        if (msg.role === 'user') {
+            lastUserIndex = i;
+            break;
+        }
+    }
+    if (lastUserIndex === -1) {
+        return messages;
+    }
+    return [messages[lastUserIndex]];
+}
+function buildFunctionResponseEntry(output) {
+    const parsedPayload = safeParseJson(output.content);
+    const normalizedPayload = ensureFunctionResponsePayload(cloneAsJsonValue(parsedPayload));
+    const part = {
+        functionResponse: {
+            name: output.name || 'tool',
+            id: output.tool_call_id,
+            response: normalizedPayload
+        }
+    };
+    return { role: 'user', parts: [part] };
+}
+function collectSystemSegments(systemInstruction) {
+    if (!systemInstruction)
+        return [];
+    const flatten = (val) => {
+        if (typeof val === 'string')
+            return val;
+        if (Array.isArray(val))
+            return val.map((entry) => flatten(entry)).filter(Boolean).join('\n');
+        if (val && typeof val === 'object') {
+            const text = val.text;
+            if (typeof text === 'string')
+                return text;
+            const parts = val.parts;
+            if (Array.isArray(parts))
+                return parts.map((entry) => flatten(entry)).filter(Boolean).join('\n');
+        }
+        return '';
+    };
+    const text = flatten(systemInstruction).trim();
+    return text ? [text] : [];
+}
+function collectParameters(payload) {
+    const params = {};
+    if (typeof payload.model === 'string') {
+        params.model = payload.model;
+    }
+    const gen = payload.generationConfig;
+    if (gen && typeof gen === 'object') {
+        for (const { source, target } of GENERATION_CONFIG_KEYS) {
+            const value = gen[source];
+            if (value !== undefined) {
+                params[target] = value;
+            }
+        }
+    }
+    if (payload.toolConfig !== undefined) {
+        params.tool_config = jsonClone(payload.toolConfig);
+    }
+    const meta = payload.metadata;
+    if (meta && typeof meta === 'object' && Object.prototype.hasOwnProperty.call(meta, '__rcc_stream')) {
+        params.stream = Boolean(meta.__rcc_stream);
+    }
+    return Object.keys(params).length ? params : undefined;
+}
+function appendChatContentToGeminiParts(message, targetParts) {
+    const content = message.content;
+    if (typeof content === 'string') {
+        const text = content.trim();
+        if (text.length) {
+            targetParts.push({ text });
+        }
+        return;
+    }
+    if (!Array.isArray(content)) {
+        return;
+    }
+    const items = content;
+    for (const block of items) {
+        if (block == null)
+            continue;
+        if (typeof block === 'string') {
+            const text = block.trim();
+            if (text.length) {
+                targetParts.push({ text });
+            }
+            continue;
+        }
+        if (typeof block !== 'object') {
+            const text = String(block);
+            if (text.trim().length) {
+                targetParts.push({ text: text.trim() });
+            }
+            continue;
+        }
+        const record = block;
+        const rawType = record.type;
+        const type = typeof rawType === 'string' ? rawType.toLowerCase() : '';
+        // Text-style blocks
+        if (!type || type === 'text') {
+            const textValue = typeof record.text === 'string'
+                ? record.text
+                : typeof record.content === 'string'
+                    ? record.content
+                    : '';
+            const text = textValue.trim();
+            if (text.length) {
+                targetParts.push({ text });
+            }
+            continue;
+        }
+        // Image-style blocks -> Gemini inlineData
+        if (type === 'image' || type === 'image_url') {
+            // Prefer OpenAI-style image_url.url, but also accept uri/url/data.
+            let url;
+            const imageUrlRaw = record.image_url;
+            if (typeof imageUrlRaw === 'string') {
+                url = imageUrlRaw;
+            }
+            else if (imageUrlRaw && typeof imageUrlRaw === 'object' && typeof imageUrlRaw.url === 'string') {
+                url = imageUrlRaw.url;
+            }
+            else if (typeof record.uri === 'string') {
+                url = record.uri;
+            }
+            else if (typeof record.url === 'string') {
+                url = record.url;
+            }
+            else if (typeof record.data === 'string') {
+                url = record.data;
+            }
+            const trimmed = (url ?? '').trim();
+            if (!trimmed.length) {
+                // Fallback: at least emit a textual marker so内容不会完全丢失
+                targetParts.push({ text: '[image]' });
+                continue;
+            }
+            let mimeType;
+            let data;
+            // data:URL → inlineData { mimeType, data }
+            if (trimmed.startsWith('data:')) {
+                const match = /^data:([^;,]+)?(?:;base64)?,(.*)$/s.exec(trimmed);
+                if (match) {
+                    mimeType = (match[1] || '').trim() || undefined;
+                    data = match[2] || '';
+                }
+            }
+            if (data && data.trim().length) {
+                const inline = {
+                    inlineData: {
+                        data: data.trim()
+                    }
+                };
+                if (mimeType && mimeType.length) {
+                    inline.inlineData.mimeType = mimeType;
+                }
+                targetParts.push(inline);
+            }
+            else {
+                // 非 data: URL 暂时作为文本 URL 传递，保持语义可见
+                targetParts.push({ text: trimmed });
+            }
+            continue;
+        }
+        // 默认：回退为文本 JSON 表示，避免静默丢失内容
+        try {
+            const jsonText = JSON.stringify(record);
+            if (jsonText.trim().length) {
+                targetParts.push({ text: jsonText });
+            }
+        }
+        catch {
+            // ignore malformed block
+        }
+    }
+}
+function buildGeminiRequestFromChat(chat, metadata) {
+    const contents = [];
+    const emittedToolOutputs = new Set();
+    const adapterContext = metadata?.context;
+    const rawProviderId = adapterContext?.providerId;
+    const entryEndpointRaw = adapterContext?.entryEndpoint;
+    const entryEndpoint = typeof entryEndpointRaw === 'string' ? entryEndpointRaw.trim().toLowerCase() : '';
+    const isAnthropicEntry = entryEndpoint === '/v1/messages';
+    const normalizedProviderId = typeof rawProviderId === 'string' ? rawProviderId.toLowerCase() : '';
+    const providerIdPrefix = normalizedProviderId.split('.')[0];
+    const isAntigravityClaudeThinking = providerIdPrefix === 'antigravity' &&
+        typeof chat.parameters?.model === 'string' &&
+        chat.parameters.model.includes('claude-sonnet-4-5-thinking');
+    // 保持对通用 gemini-cli 的保护（避免上游直接执行 functionCall），
+    // 但对于 antigravity.* 明确允许通过 Gemini functionCall 协议执行工具，
+    // 以便完整打通 tools → functionCall → functionResponse 链路。
+    const omitFunctionCallPartsForCli = providerIdPrefix === 'gemini-cli';
+    const semanticsNode = readGeminiSemantics(chat);
+    const systemTextBlocksFromSemantics = readSystemTextBlocksFromSemantics(chat);
+    const bridgeDefs = chat.tools && chat.tools.length ? mapChatToolsToBridge(chat.tools) : undefined;
+    const toolSchemaKeys = bridgeDefs ? buildToolSchemaKeyMap(bridgeDefs) : new Map();
+    const sourceMessages = chat.messages;
+    // 收集当前 ChatEnvelope 中 assistant/tool_calls 的 id，用于过滤孤立的 tool_result：
+    // 只有在本轮对话中存在对应 tool_call 的 tool_result 才允许映射为 Gemini functionResponse。
+    const assistantToolCallIds = new Set();
+    for (const msg of sourceMessages) {
+        if (!msg || typeof msg !== 'object')
+            continue;
+        if (msg.role !== 'assistant')
+            continue;
+        const tcs = Array.isArray(msg.tool_calls)
+            ? msg.tool_calls
+            : [];
+        for (const tc of tcs) {
+            const id = typeof tc.id === 'string' ? tc.id.trim() : '';
+            if (id) {
+                assistantToolCallIds.add(id);
+            }
+        }
+    }
+    for (const message of sourceMessages) {
+        if (!message || typeof message !== 'object')
+            continue;
+        if (message.role === 'system')
+            continue;
+        if (message.role === 'tool') {
+            const toolOutput = convertToolMessageToOutput(message, assistantToolCallIds);
+            if (toolOutput) {
+                contents.push(buildFunctionResponseEntry(toolOutput));
+                emittedToolOutputs.add(toolOutput.tool_call_id);
+            }
+            continue;
+        }
+        const entry = {
+            role: mapChatRoleToGemini(message.role),
+            parts: []
+        };
+        appendChatContentToGeminiParts(message, entry.parts);
+        const toolCalls = Array.isArray(message.tool_calls)
+            ? message.tool_calls
+            : [];
+        for (const tc of toolCalls) {
+            if (!tc || typeof tc !== 'object')
+                continue;
+            if (omitFunctionCallPartsForCli) {
+                continue;
+            }
+            const fn = tc.function || {};
+            const name = typeof fn.name === 'string' ? fn.name : undefined;
+            if (!name)
+                continue;
+            let argsStruct;
+            if (typeof fn.arguments === 'string') {
+                try {
+                    argsStruct = JSON.parse(fn.arguments);
+                }
+                catch {
+                    argsStruct = { _raw: fn.arguments };
+                }
+            }
+            else {
+                argsStruct = fn.arguments ?? {};
+            }
+            argsStruct = alignToolCallArgsToSchema({ toolName: name, args: argsStruct, schemaKeys: toolSchemaKeys });
+            let argsJson = cloneAsJsonValue(argsStruct);
+            // Gemini / Antigravity 期望 functionCall.args 为对象（Struct），
+            // 若顶层为数组或原始类型，则包装到 value 字段下，避免产生非法的 list 形状。
+            if (!argsJson || typeof argsJson !== 'object' || Array.isArray(argsJson)) {
+                argsJson = { value: argsJson };
+            }
+            const functionCall = { name, args: argsJson };
+            const part = { functionCall };
+            if (typeof tc.id === 'string') {
+                part.functionCall.id = tc.id;
+            }
+            const thoughtSignature = extractThoughtSignatureFromToolCall(tc) ?? DUMMY_THOUGHT_SIGNATURE;
+            if (thoughtSignature) {
+                part.thoughtSignature = thoughtSignature;
+            }
+            entry.parts.push(part);
+        }
+        if (entry.parts.length) {
+            contents.push(entry);
+        }
+    }
+    const toolOutputMap = new Map();
+    if (Array.isArray(chat.toolOutputs)) {
+        for (const entry of chat.toolOutputs) {
+            if (entry && typeof entry.tool_call_id === 'string' && entry.tool_call_id.trim().length) {
+                toolOutputMap.set(entry.tool_call_id.trim(), entry);
+            }
+        }
+    }
+    if (toolOutputMap.size === 0) {
+        const syntheticOutputs = synthesizeToolOutputsFromMessages(chat.messages);
+        for (const output of syntheticOutputs) {
+            toolOutputMap.set(output.tool_call_id, output);
+        }
+    }
+    for (const output of toolOutputMap.values()) {
+        if (emittedToolOutputs.has(output.tool_call_id)) {
+            continue;
+        }
+        contents.push(buildFunctionResponseEntry(output));
+        emittedToolOutputs.add(output.tool_call_id);
+    }
+    const request = {
+        model: chat.parameters?.model || 'models/gemini-pro',
+        contents
+    };
+    const geminiState = getProtocolState(metadata, 'gemini');
+    if (semanticsNode?.systemInstruction !== undefined) {
+        request.systemInstruction = jsonClone(semanticsNode.systemInstruction);
+    }
+    else if (geminiState?.systemInstruction !== undefined) {
+        request.systemInstruction = jsonClone(geminiState.systemInstruction);
+    }
+    else {
+        const fallbackSystemInstructions = systemTextBlocksFromSemantics;
+        if (fallbackSystemInstructions && fallbackSystemInstructions.length) {
+            const sysBlocks = fallbackSystemInstructions
+                .filter((value) => typeof value === 'string' && value.trim().length > 0)
+                .map((value) => ({ text: value }));
+            if (sysBlocks.length) {
+                request.systemInstruction = { role: 'system', parts: sysBlocks };
+            }
+        }
+    }
+    if (chat.tools && chat.tools.length) {
+        const geminiTools = buildGeminiToolsFromBridge(bridgeDefs);
+        if (geminiTools) {
+            request.tools = geminiTools;
+        }
+    }
+    const generationConfig = buildGenerationConfigFromParameters(chat.parameters || {});
+    if (semanticsNode?.generationConfig && isJsonObject(semanticsNode.generationConfig)) {
+        for (const [key, value] of Object.entries(semanticsNode.generationConfig)) {
+            if (generationConfig[key] !== undefined) {
+                continue;
+            }
+            generationConfig[key] = jsonClone(value);
+        }
+    }
+    if (Object.keys(generationConfig).length) {
+        request.generationConfig = generationConfig;
+    }
+    if (semanticsNode?.safetySettings !== undefined) {
+        request.safetySettings = jsonClone(semanticsNode.safetySettings);
+    }
+    if (chat.parameters?.tool_config && isJsonObject(chat.parameters.tool_config)) {
+        request.toolConfig = jsonClone(chat.parameters.tool_config);
+    }
+    else if (semanticsNode?.toolConfig && isJsonObject(semanticsNode.toolConfig)) {
+        request.toolConfig = jsonClone(semanticsNode.toolConfig);
+    }
+    // 为了保持协议解耦，只在 Gemini 自身或开放式 Chat 入口下透传 providerMetadata；
+    // 对于 Anthropic (/v1/messages) 等其它协议的入口，不再将其 metadata 整块转发给 Gemini，
+    // 避免跨协议泄漏上游专有字段。
+    if (!isAnthropicEntry) {
+        if (semanticsNode?.providerMetadata && isJsonObject(semanticsNode.providerMetadata)) {
+            request.metadata = jsonClone(semanticsNode.providerMetadata);
+        }
+        else if (metadata?.providerMetadata && isJsonObject(metadata.providerMetadata)) {
+            request.metadata = jsonClone(metadata.providerMetadata);
+        }
+    }
+    if (chat.parameters && chat.parameters.stream !== undefined) {
+        request.metadata = request.metadata ?? {};
+        request.metadata.__rcc_stream = chat.parameters.stream;
+    }
+    if ((chat.metadata?.toolsFieldPresent || hasExplicitEmptyToolsSemantics(chat)) &&
+        (!Array.isArray(chat.tools) || chat.tools.length === 0)) {
+        request.metadata = request.metadata ?? {};
+        request.metadata.__rcc_tools_field_present = '1';
+    }
+    const passthrough = encodeMetadataPassthrough(chat.parameters, {
+        prefix: PASSTHROUGH_METADATA_PREFIX,
+        keys: PASSTHROUGH_PARAMETERS
+    });
+    if (passthrough) {
+        request.metadata = request.metadata ?? {};
+        for (const [key, value] of Object.entries(passthrough)) {
+            request.metadata[key] = value;
+        }
+    }
+    // Apply claude-thinking compat at Gemini mapping time to ensure it is always active
+    // for Claude models, regardless of compatibilityProfile wiring. Provider层负责进一步的
+    // 传输层收紧（如 session_id / generationConfig），这里不做非标裁剪。
+    const compatRequest = applyClaudeThinkingToolSchemaCompat(request, adapterContext);
+    return compatRequest;
+}
+function isPlainRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function buildToolSchemaKeyMap(defs) {
+    const map = new Map();
+    for (const def of defs) {
+        const fnNode = def && typeof def === 'object' && def.function && typeof def.function === 'object'
+            ? def.function
+            : undefined;
+        const name = typeof fnNode?.name === 'string'
+            ? fnNode.name
+            : typeof def?.name === 'string'
+                ? String(def.name)
+                : '';
+        if (!name || !name.trim())
+            continue;
+        const parameters = (fnNode && fnNode.parameters) ??
+            (def.parameters);
+        if (!isPlainRecord(parameters))
+            continue;
+        const props = parameters.properties;
+        if (!isPlainRecord(props))
+            continue;
+        const keys = Object.keys(props).filter((k) => typeof k === 'string' && k.trim().length > 0);
+        if (!keys.length)
+            continue;
+        map.set(name, new Set(keys));
+    }
+    return map;
+}
+function alignToolCallArgsToSchema(options) {
+    const name = typeof options.toolName === 'string' ? options.toolName.trim() : '';
+    if (!name)
+        return options.args;
+    const schema = options.schemaKeys.get(name);
+    if (!schema || schema.size === 0) {
+        return options.args;
+    }
+    if (!isPlainRecord(options.args)) {
+        return options.args;
+    }
+    const lowered = name.toLowerCase();
+    const next = { ...options.args };
+    // Align historical Codex tool args to the *declared schema* for Gemini.
+    // Gemini validates historical functionCall.args against tool declarations, so mismatches like:
+    // - exec_command: { cmd } vs schema { command } (or vice-versa)
+    // - apply_patch: { patch/input } vs schema { instructions } (or vice-versa)
+    // can cause MALFORMED_FUNCTION_CALL and empty responses.
+    if (lowered === 'exec_command') {
+        // Prefer the declared schema key; do not delete keys blindly.
+        if (schema.has('cmd') && !Object.prototype.hasOwnProperty.call(next, 'cmd') && Object.prototype.hasOwnProperty.call(next, 'command')) {
+            next.cmd = next.command;
+        }
+        if (schema.has('command') && !Object.prototype.hasOwnProperty.call(next, 'command') && Object.prototype.hasOwnProperty.call(next, 'cmd')) {
+            next.command = next.cmd;
+        }
+    }
+    else if (lowered === 'write_stdin') {
+        if (schema.has('chars') && !Object.prototype.hasOwnProperty.call(next, 'chars') && Object.prototype.hasOwnProperty.call(next, 'text')) {
+            next.chars = next.text;
+        }
+        if (schema.has('text') && !Object.prototype.hasOwnProperty.call(next, 'text') && Object.prototype.hasOwnProperty.call(next, 'chars')) {
+            next.text = next.chars;
+        }
+    }
+    else if (lowered === 'apply_patch') {
+        if (schema.has('instructions') && !Object.prototype.hasOwnProperty.call(next, 'instructions')) {
+            const patch = typeof next.patch === 'string' ? next.patch : undefined;
+            const input = typeof next.input === 'string' ? next.input : undefined;
+            const candidate = patch && patch.trim().length ? patch : input && input.trim().length ? input : undefined;
+            if (candidate) {
+                next.instructions = candidate;
+            }
+        }
+        if (schema.has('patch') && !Object.prototype.hasOwnProperty.call(next, 'patch')) {
+            const input = typeof next.input === 'string' ? next.input : undefined;
+            if (input && input.trim().length) {
+                next.patch = input;
+            }
+        }
+    }
+    // Prune to schema keys for known Codex tools to reduce strict upstream validation failures.
+    if (lowered === 'exec_command' || lowered === 'write_stdin' || lowered === 'apply_patch') {
+        const pruned = {};
+        for (const key of schema) {
+            if (Object.prototype.hasOwnProperty.call(next, key)) {
+                pruned[key] = next[key];
+            }
+        }
+        return pruned;
+    }
+    return next;
+}
+function buildGenerationConfigFromParameters(parameters) {
+    const config = {};
+    for (const { source, target } of GENERATION_CONFIG_KEYS) {
+        const value = parameters[target] ?? (target === 'max_output_tokens' ? parameters.max_tokens : undefined);
+        if (value !== undefined) {
+            config[source] = value;
+        }
+    }
+    return config;
+}
+function mapChatRoleToGemini(role) {
+    const r = role.toLowerCase();
+    if (r === 'assistant')
+        return 'model';
+    if (r === 'system')
+        return 'system';
+    if (r === 'tool')
+        return 'tool';
+    return 'user';
+}
+function safeParseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+function ensureFunctionResponsePayload(value) {
+    // Gemini function_response.response 字段在 CloudCode/Gemini CLI 协议里对应的是
+    // protobuf Struct（JSON object），而不是顶层数组。
+    // 这里做一层规范化：
+    // - 对象：直接透传；
+    // - 数组：包一层 { result: [...] } 避免把数组作为 Struct 根节点；
+    // - 原始值：包一层 { result: value }，并把 undefined 映射为 null。
+    if (value && typeof value === 'object') {
+        if (Array.isArray(value)) {
+            return {
+                result: value
+            };
+        }
+        return value;
+    }
+    return {
+        result: value === undefined ? null : value
+    };
+}
+function cloneAsJsonValue(value) {
+    try {
+        return JSON.parse(JSON.stringify(value ?? null));
+    }
+    catch {
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean' || value === null) {
+            return value;
+        }
+        if (Array.isArray(value)) {
+            return value.map((entry) => cloneAsJsonValue(entry));
+        }
+        if (value && typeof value === 'object') {
+            const out = {};
+            for (const [key, entry] of Object.entries(value)) {
+                out[key] = cloneAsJsonValue(entry);
+            }
+            return out;
+        }
+        return String(value ?? '');
+    }
+}
+export class GeminiSemanticMapper {
+    async toChat(format, ctx) {
+        const payload = (format.payload ?? {});
+        const missing = [];
+        const { messages: builtMessages } = buildOpenAIChatFromGeminiRequest(payload);
+        let messages = Array.isArray(builtMessages) ? builtMessages : [];
+        if (!Array.isArray(payload.contents)) {
+            missing.push({ path: 'contents', reason: 'absent' });
+        }
+        const bridgeTools = prepareGeminiToolsForBridge(payload.tools, missing);
+        const tools = bridgeTools ? mapBridgeToolsToChat(bridgeTools) : undefined;
+        let parameters = collectParameters(payload);
+        const metadata = { context: ctx };
+        const systemSegments = collectSystemSegments(payload.systemInstruction);
+        if (payload.systemInstruction !== undefined) {
+            const rawSystem = jsonClone(payload.systemInstruction);
+            ensureProtocolState(metadata, 'gemini').systemInstruction = rawSystem;
+        }
+        if (missing.length) {
+            metadata.missingFields = missing;
+        }
+        const toolOutputs = normalizeToolOutputs(messages, missing);
+        const passthrough = extractMetadataPassthrough(payload.metadata, {
+            prefix: PASSTHROUGH_METADATA_PREFIX,
+            keys: PASSTHROUGH_PARAMETERS
+        });
+        if (passthrough.passthrough) {
+            parameters = { ...(parameters || {}), ...passthrough.passthrough };
+        }
+        const providerMetadataSource = passthrough.metadata ?? payload.metadata;
+        let providerMetadata;
+        let explicitEmptyTools = Array.isArray(payload.tools) && payload.tools.length === 0;
+        if (providerMetadataSource) {
+            const cloned = jsonClone(providerMetadataSource);
+            let toolsFieldPresent = false;
+            if (isJsonObject(cloned)) {
+                delete cloned.__rcc_stream;
+                if (Object.prototype.hasOwnProperty.call(cloned, '__rcc_tools_field_present')) {
+                    const sentinel = cloned.__rcc_tools_field_present;
+                    toolsFieldPresent = sentinel === '1' || sentinel === true;
+                    delete cloned.__rcc_tools_field_present;
+                }
+                if (Object.prototype.hasOwnProperty.call(cloned, '__rcc_raw_system')) {
+                    delete cloned.__rcc_raw_system;
+                }
+            }
+            if (toolsFieldPresent) {
+                metadata.toolsFieldPresent = true;
+                explicitEmptyTools = true;
+            }
+            providerMetadata = cloned;
+            metadata.providerMetadata = providerMetadata;
+        }
+        const chatEnvelope = {
+            messages,
+            tools,
+            toolOutputs,
+            parameters,
+            metadata
+        };
+        if (systemSegments.length) {
+            const systemNode = ensureSystemSemantics(chatEnvelope);
+            systemNode.textBlocks = systemSegments.map((segment) => segment);
+        }
+        let semanticsNode;
+        const ensureSemanticsNode = () => {
+            semanticsNode = semanticsNode ?? ensureGeminiSemanticsNode(chatEnvelope);
+            return semanticsNode;
+        };
+        if (payload.systemInstruction !== undefined) {
+            ensureSemanticsNode().systemInstruction = jsonClone(payload.systemInstruction);
+        }
+        if (payload.safetySettings) {
+            ensureSemanticsNode().safetySettings = jsonClone(payload.safetySettings);
+        }
+        if (payload.generationConfig && isJsonObject(payload.generationConfig)) {
+            ensureSemanticsNode().generationConfig = jsonClone(payload.generationConfig);
+        }
+        if (payload.toolConfig && isJsonObject(payload.toolConfig)) {
+            ensureSemanticsNode().toolConfig = jsonClone(payload.toolConfig);
+        }
+        if (providerMetadata) {
+            ensureSemanticsNode().providerMetadata = jsonClone(providerMetadata);
+        }
+        if (explicitEmptyTools) {
+            markGeminiExplicitEmptyTools(chatEnvelope);
+        }
+        return chatEnvelope;
+    }
+    async fromChat(chat, ctx) {
+        const envelopePayload = buildGeminiRequestFromChat(chat, chat.metadata);
+        return {
+            protocol: 'gemini-chat',
+            direction: 'response',
+            payload: envelopePayload,
+            meta: {
+                context: ctx
+            }
+        };
+    }
+}