@jsonstudio/llms 0.6.954 → 0.6.1172

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

@@ -1,903 +1 @@
-import { isJsonObject, jsonClone } from '../types/json.js';
-import { buildOpenAIChatFromGeminiRequest } from '../../codecs/gemini-openai-codec.js';
-import { createBridgeActionState, runBridgeActionPipeline } from '../../shared/bridge-actions.js';
-import { resolveBridgePolicy, resolvePolicyActions } from '../../shared/bridge-policies.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;
-        }
-        try {
-            const bridgePolicy = resolveBridgePolicy({ protocol: 'gemini-chat' });
-            const actions = resolvePolicyActions(bridgePolicy, 'request_inbound');
-            if (actions?.length) {
-                const actionState = createBridgeActionState({
-                    messages: messages,
-                    rawRequest: payload,
-                    metadata: metadata
-                });
-                runBridgeActionPipeline({
-                    stage: 'request_inbound',
-                    actions,
-                    protocol: bridgePolicy?.protocol ?? 'gemini-chat',
-                    moduleType: bridgePolicy?.moduleType ?? 'gemini-chat',
-                    requestId: ctx.requestId,
-                    state: actionState
-                });
-                messages = actionState.messages;
-            }
-        }
-        catch {
-            // best-effort policy execution
-        }
-        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) {
-        try {
-            const { applyToolSessionCompat } = await import('../tool-session-compat.js');
-            await applyToolSessionCompat(chat, ctx);
-        }
-        catch {
-            // best-effort compat; do not block outbound mapping
-        }
-        const envelopePayload = buildGeminiRequestFromChat(chat, chat.metadata);
-        try {
-            const bridgePolicy = resolveBridgePolicy({ protocol: 'gemini-chat' });
-            const actions = resolvePolicyActions(bridgePolicy, 'request_outbound');
-            if (actions?.length) {
-                const capturedToolResults = Array.isArray(chat.toolOutputs)
-                    ? chat.toolOutputs.map((entry) => ({
-                        tool_call_id: entry.tool_call_id,
-                        output: entry.content,
-                        name: entry.name
-                    }))
-                    : undefined;
-                const actionState = createBridgeActionState({
-                    messages: Array.isArray(chat.messages) ? chat.messages : [],
-                    rawRequest: envelopePayload,
-                    metadata: chat.metadata,
-                    capturedToolResults
-                });
-                runBridgeActionPipeline({
-                    stage: 'request_outbound',
-                    actions,
-                    protocol: bridgePolicy?.protocol ?? 'gemini-chat',
-                    moduleType: bridgePolicy?.moduleType ?? 'gemini-chat',
-                    requestId: ctx.requestId,
-                    state: actionState
-                });
-            }
-        }
-        catch {
-            // ignore policy failures
-        }
-        return {
-            protocol: 'gemini-chat',
-            direction: 'response',
-            payload: envelopePayload,
-            meta: {
-                context: ctx
-            }
-        };
-    }
-}
+export { GeminiSemanticMapper } from '../operation-table/semantic-mappers/gemini-mapper.js';