@jsonstudio/rcc 0.89.168 → 0.89.524

package/node_modules/@jsonstudio/llms/dist/conversion/shared/anthropic-message-utils.js

@@ -266,6 +266,7 @@ export function buildOpenAIChatFromAnthropic(payload) {
             continue;
         }
         const textParts = [];
+        const imageBlocks = [];
         const toolCalls = [];
         const reasoningParts = [];
         const toolResults = [];
@@ -284,6 +285,29 @@ export function buildOpenAIChatFromAnthropic(payload) {
                     reasoningParts.push(thinkingText);
                 }
             }
+            else if (t === 'image') {
+                const source = block.source;
+                if (source && typeof source === 'object') {
+                    const s = source;
+                    const srcType = typeof s.type === 'string' ? s.type.toLowerCase() : '';
+                    let url;
+                    if (srcType === 'url' && typeof s.url === 'string') {
+                        url = s.url;
+                    }
+                    else if (srcType === 'base64' && typeof s.data === 'string') {
+                        const mediaType = typeof s.media_type === 'string' && s.media_type.trim().length
+                            ? s.media_type.trim()
+                            : 'image/png';
+                        url = `data:${mediaType};base64,${s.data}`;
+                    }
+                    if (url && url.trim().length) {
+                        imageBlocks.push({
+                            type: 'image_url',
+                            image_url: { url: url.trim() }
+                        });
+                    }
+                }
+            }
             else if (t === 'tool_use') {
                 const name = requireTrimmedString(block.name, 'tool_use.name');
                 const id = requireTrimmedString(block.id, 'tool_use.id');
@@ -310,10 +334,22 @@ export function buildOpenAIChatFromAnthropic(payload) {
         }
         const hasText = typeof normalized.contentText === 'string' && normalized.contentText.length > 0;
         const hasReasoning = mergedReasoning.length > 0;
-        if (hasText || hasRawText || toolCalls.length > 0 || hasReasoning) {
+        if (hasText || hasRawText || toolCalls.length > 0 || hasReasoning || imageBlocks.length > 0) {
+            let contentNode = (hasText ? normalized.contentText : undefined) ?? combinedText ?? '';
+            if (imageBlocks.length > 0) {
+                const blocks = [];
+                const textPayload = (hasText ? normalized.contentText : undefined) ?? combinedText ?? '';
+                if (typeof textPayload === 'string' && textPayload.trim().length) {
+                    blocks.push({ type: 'text', text: textPayload.trim() });
+                }
+                for (const img of imageBlocks) {
+                    blocks.push(jsonClone(img));
+                }
+                contentNode = blocks;
+            }
             const msg = {
                 role,
-                content: (hasText ? normalized.contentText : undefined) ?? combinedText ?? ''
+                content: contentNode
             };
             if (toolCalls.length)
                 msg.tool_calls = toolCalls;
@@ -336,6 +372,12 @@ export function buildOpenAIChatFromAnthropic(payload) {
         request.top_p = body.top_p;
     if (typeof body.stream === 'boolean')
         request.stream = body.stream;
+    if (typeof body.id === 'string') {
+        request.request_id = body.id;
+    }
+    else if (typeof body.request_id === 'string') {
+        request.request_id = body.request_id;
+    }
     if ('tool_choice' in body)
         request.tool_choice = body.tool_choice;
     const normalizedTools = mapAnthropicToolsToChat(body.tools);
@@ -684,7 +726,8 @@ export function buildAnthropicRequestFromOpenAIChat(chatReq) {
             targetShape = mirrorShapes[mirrorIndex];
             mirrorIndex += 1;
         }
-        const text = collectText(m.content).trim();
+        const contentNode = m.content;
+        const text = collectText(contentNode).trim();
         if (role === 'system') {
             if (!text) {
                 throw new Error('Anthropic bridge constraint violated: Chat system message must contain text');
@@ -709,6 +752,58 @@ export function buildAnthropicRequestFromOpenAIChat(chatReq) {
             continue;
         }
         const blocks = [];
+        if (Array.isArray(contentNode)) {
+            // Preserve or synthesize image blocks where possible, and fall back to text for the rest.
+            for (const entry of contentNode) {
+                if (!entry || typeof entry !== 'object')
+                    continue;
+                const node = entry;
+                const t = typeof node.type === 'string' ? node.type.toLowerCase() : '';
+                if (t === 'image' && node.source && typeof node.source === 'object') {
+                    // Pass-through Anthropic image block as-is.
+                    blocks.push({
+                        type: 'image',
+                        source: jsonClone(node.source)
+                    });
+                    continue;
+                }
+                if (t === 'image_url') {
+                    let url = '';
+                    const imageUrl = node.image_url;
+                    if (typeof imageUrl === 'string') {
+                        url = imageUrl;
+                    }
+                    else if (imageUrl && typeof imageUrl === 'object' && typeof imageUrl.url === 'string') {
+                        url = imageUrl.url;
+                    }
+                    const trimmed = url.trim();
+                    if (!trimmed.length)
+                        continue;
+                    const source = {};
+                    if (trimmed.startsWith('data:')) {
+                        const match = /^data:([^;,]+)?(?:;base64)?,(.*)$/s.exec(trimmed);
+                        if (match) {
+                            const mediaType = (match[1] || '').trim() || 'image/png';
+                            source.type = 'base64';
+                            source.media_type = mediaType;
+                            source.data = match[2] || '';
+                        }
+                        else {
+                            source.type = 'url';
+                            source.url = trimmed;
+                        }
+                    }
+                    else {
+                        source.type = 'url';
+                        source.url = trimmed;
+                    }
+                    blocks.push({
+                        type: 'image',
+                        source
+                    });
+                }
+            }
+        }
         if (text) {
             blocks.push({ type: 'text', text });
         }

package/node_modules/@jsonstudio/llms/dist/conversion/shared/bridge-message-utils.js

@@ -66,6 +66,59 @@ function collectText(value) {
     }
     return '';
 }
+function extractImageBlocksFromContent(content) {
+    const images = [];
+    const visit = (value) => {
+        if (!value)
+            return;
+        if (Array.isArray(value)) {
+            for (const entry of value)
+                visit(entry);
+            return;
+        }
+        if (typeof value !== 'object') {
+            return;
+        }
+        const record = value;
+        const typeValue = typeof record.type === 'string' ? record.type.toLowerCase() : '';
+        if (typeValue === 'image' || typeValue === 'image_url' || typeValue === 'input_image') {
+            let url = '';
+            const imageUrl = record.image_url;
+            if (typeof imageUrl === 'string') {
+                url = imageUrl;
+            }
+            else if (imageUrl && typeof imageUrl === 'object' && typeof imageUrl.url === 'string') {
+                url = imageUrl.url;
+            }
+            else if (typeof record.url === 'string') {
+                url = record.url;
+            }
+            else if (typeof record.uri === 'string') {
+                url = record.uri;
+            }
+            else if (typeof record.data === 'string') {
+                url = record.data;
+            }
+            const trimmed = url.trim();
+            if (trimmed.length) {
+                let detail;
+                if (imageUrl && typeof imageUrl === 'object' && typeof imageUrl.detail === 'string') {
+                    detail = imageUrl.detail.trim() || undefined;
+                }
+                else if (typeof record.detail === 'string') {
+                    detail = record.detail.trim() || undefined;
+                }
+                images.push({ url: trimmed, detail });
+            }
+            return;
+        }
+        if (Array.isArray(record.content)) {
+            visit(record.content);
+        }
+    };
+    visit(content);
+    return images;
+}
 function extractUserTextFromEntry(entry) {
     if (!entry || typeof entry !== 'object')
         return '';
@@ -94,6 +147,7 @@ export function convertMessagesToBridgeInput(options) {
         const role = coerceBridgeRole(m.role || 'user');
         const content = m.content;
         const collectedText = collectText(content);
+        const imageBlocks = extractImageBlocksFromContent(content);
         const text = role === 'system' ? collectedText : collectedText.trim();
         if (role === 'system') {
             if (collectedText && collectedText.length) {
@@ -170,13 +224,29 @@ export function convertMessagesToBridgeInput(options) {
             }
             continue;
         }
-        if (typeof text === 'string') {
+        if (typeof text === 'string' || imageBlocks.length) {
             const tRole = role === 'assistant' ? 'output_text' : 'input_text';
-            const entry = {
-                role,
-                content: [{ type: tRole, text }]
-            };
-            input.push(entry);
+            const blocks = [];
+            if (typeof text === 'string' && text.length) {
+                blocks.push({ type: tRole, text });
+            }
+            for (const img of imageBlocks) {
+                const block = {
+                    type: 'input_image',
+                    image_url: img.url
+                };
+                if (img.detail) {
+                    block.detail = img.detail;
+                }
+                blocks.push(block);
+            }
+            if (blocks.length) {
+                const entry = {
+                    role,
+                    content: blocks
+                };
+                input.push(entry);
+            }
             if (role === 'user') {
                 const trimmed = typeof text === 'string' ? text.trim() : '';
                 if (trimmed.length) {
@@ -260,6 +330,7 @@ function processMessageBlocks(blocks, normalizeFunctionName, tools, toolNameById
     const toolMessages = [];
     let currentLastCall = lastToolCallId;
     const reasoningSegments = [];
+    const images = [];
     for (const block of blocks) {
         if (!block || typeof block !== 'object')
             continue;
@@ -282,6 +353,18 @@ function processMessageBlocks(blocks, normalizeFunctionName, tools, toolNameById
                 toolMessages.push(tm);
             currentLastCall = nested.lastCallId;
             reasoningSegments.push(...nested.reasoningSegments);
+            if (nested.images.length)
+                images.push(...nested.images);
+            continue;
+        }
+        if (type === 'input_image') {
+            const url = typeof block.image_url === 'string' ? block.image_url.trim() : '';
+            if (url) {
+                const detail = typeof block.detail === 'string' && block.detail.trim()
+                    ? block.detail.trim()
+                    : undefined;
+                images.push({ url, detail });
+            }
             continue;
         }
         if (type === 'function_call') {
@@ -344,7 +427,7 @@ function processMessageBlocks(blocks, normalizeFunctionName, tools, toolNameById
         }
     }
     const text = textParts.length ? textParts.join('\n').trim() : null;
-    return { text, toolCalls, toolMessages, lastCallId: currentLastCall, reasoningSegments };
+    return { text, images, toolCalls, toolMessages, lastCallId: currentLastCall, reasoningSegments };
 }
 export function convertBridgeInputToChatMessages(options) {
     const { input, tools, normalizeFunctionName, toolResultFallbackText } = options;
@@ -470,7 +553,29 @@ export function convertBridgeInputToChatMessages(options) {
             for (const msg of nested.toolMessages)
                 messages.push(msg);
             const normalizedRole = coerceBridgeRole((explicit.role ?? entry.role) || 'user');
-            if (typeof nested.text === 'string') {
+            if (nested.images.length) {
+                const contentBlocks = [];
+                if (typeof nested.text === 'string' && nested.text.trim().length) {
+                    contentBlocks.push({ type: 'text', text: nested.text });
+                }
+                for (const img of nested.images) {
+                    const imgBlock = { type: 'image_url', image_url: { url: img.url } };
+                    if (img.detail) {
+                        imgBlock.image_url.detail = img.detail;
+                    }
+                    contentBlocks.push(imgBlock);
+                }
+                const msg = {
+                    role: normalizedRole,
+                    content: contentBlocks
+                };
+                const combinedReasoning = combineReasoningSegments(consumeEntryReasoning(), nested.reasoningSegments);
+                if (combinedReasoning.length) {
+                    msg.reasoning_content = combinedReasoning.join('\n');
+                }
+                messages.push(msg);
+            }
+            else if (typeof nested.text === 'string') {
                 pushNormalizedChatMessage(messages, normalizedRole, nested.text, {
                     reasoningSegments: combineReasoningSegments(consumeEntryReasoning(), nested.reasoningSegments)
                 });
@@ -491,9 +596,31 @@ export function convertBridgeInputToChatMessages(options) {
             for (const msg of nested.toolMessages)
                 messages.push(msg);
             const normalizedRole = coerceBridgeRole(entry.role || 'user');
-            if (typeof nested.text === 'string') {
+            if (nested.images.length) {
+                const contentBlocks = [];
+                if (typeof nested.text === 'string' && nested.text.trim().length) {
+                    contentBlocks.push({ type: 'text', text: nested.text });
+                }
+                for (const img of nested.images) {
+                    const imgBlock = { type: 'image_url', image_url: { url: img.url } };
+                    if (img.detail) {
+                        imgBlock.image_url.detail = img.detail;
+                    }
+                    contentBlocks.push(imgBlock);
+                }
+                const msg = {
+                    role: normalizedRole,
+                    content: contentBlocks
+                };
+                const combinedReasoning = combineReasoningSegments(consumeEntryReasoning(), nested.reasoningSegments);
+                if (combinedReasoning.length) {
+                    msg.reasoning_content = combinedReasoning.join('\n');
+                }
+                messages.push(msg);
+            }
+            else if (typeof nested.text === 'string') {
                 pushNormalizedChatMessage(messages, normalizedRole, nested.text, {
-                    reasoningSegments: combineReasoningSegments(consumeEntryReasoning(), nested.reasoningSegments)
+                    reasoningSegments: consumeEntryReasoning()
                 });
             }
             lastToolCallId = nested.lastCallId;

package/node_modules/@jsonstudio/llms/dist/conversion/shared/responses-output-builder.js

@@ -1,6 +1,41 @@
 import { normalizeFunctionCallId } from './bridge-id-utils.js';
 import { normalizeContentPart } from './output-content-normalizer.js';
 import { expandResponsesMessageItem } from '../../sse/shared/responses-output-normalizer.js';
+function buildToolOutputIndex(response) {
+    const ids = new Set();
+    try {
+        const primary = Array.isArray(response.tool_outputs)
+            ? response.tool_outputs
+            : [];
+        for (const entry of primary) {
+            if (!entry || typeof entry !== 'object')
+                continue;
+            const raw = entry.tool_call_id ||
+                entry.call_id ||
+                entry.id;
+            if (typeof raw === 'string' && raw.trim().length) {
+                const trimmed = raw.trim();
+                // 记录原始 ID（例如 OpenAI 的 toolu_ 前缀），以兼容直接使用
+                // tool_call_id 的客户端；同时记录归一化后的 fc_ 形式，保证与
+                // buildFunctionCallOutput 中 normalizeFunctionCallId 的结果对齐。
+                ids.add(trimmed);
+                try {
+                    const normalized = normalizeFunctionCallId({ callId: trimmed, fallback: trimmed });
+                    if (normalized && normalized !== trimmed) {
+                        ids.add(normalized);
+                    }
+                }
+                catch {
+                    // 归一化失败不应影响主流程
+                }
+            }
+        }
+    }
+    catch {
+        // best-effort: 不因索引构建失败影响主流程
+    }
+    return ids;
+}
 function appendReasoningSegments(target, raw) {
     if (typeof raw !== 'string' || !raw.length) {
         return;
@@ -91,7 +126,13 @@ export function buildResponsesOutputFromChat(options) {
     const usage = normalizeUsage(response.usage);
     const outputTextMeta = response?.__responses_output_text_meta;
     const outputText = resolveOutputText(convertedContent, outputTextMeta);
-    const hasNormalizedToolCalls = normalizedToolCalls.length > 0;
+    // 如果顶层 tool_outputs 已经为所有 tool_calls 提供了结果，说明这些函数调用
+    // 已在服务端（例如 server-side web_search）完成，不应再对客户端暴露
+    // required_action/submit_tool_outputs。此时只需返回 completed 状态即可，避免
+    // 再触发一轮工具回合。
+    const executedIds = buildToolOutputIndex(response);
+    const pendingToolCalls = normalizedToolCalls.filter((entry) => !executedIds.has(entry.id));
+    const hasNormalizedToolCalls = pendingToolCalls.length > 0;
     if (hasNormalizedToolCalls) {
         for (const item of outputItems) {
             if (item.type === 'message') {
@@ -100,7 +141,7 @@ export function buildResponsesOutputFromChat(options) {
         }
     }
     const requiredAction = hasNormalizedToolCalls
-        ? buildRequiredActionFromNormalized(normalizedToolCalls)
+        ? buildRequiredActionFromNormalized(pendingToolCalls)
         : undefined;
     const status = hasNormalizedToolCalls ? 'requires_action' : 'completed';
     return {

package/node_modules/@jsonstudio/llms/dist/conversion/shared/responses-reasoning-registry.d.ts

@@ -6,3 +6,7 @@ export declare function registerResponsesReasoning(id: unknown, segments: string
 export declare function consumeResponsesReasoning(id: unknown): string[] | undefined;
 export declare function registerResponsesOutputTextMeta(id: unknown, meta: ResponsesOutputTextMeta | undefined): void;
 export declare function consumeResponsesOutputTextMeta(id: unknown): ResponsesOutputTextMeta | undefined;
+export declare function registerResponsesPayloadSnapshot(id: unknown, snapshot: Record<string, unknown> | undefined): void;
+export declare function consumeResponsesPayloadSnapshot(id: unknown): Record<string, unknown> | undefined;
+export declare function registerResponsesPassthrough(id: unknown, payload: Record<string, unknown> | undefined): void;
+export declare function consumeResponsesPassthrough(id: unknown): Record<string, unknown> | undefined;

package/node_modules/@jsonstudio/llms/dist/conversion/shared/responses-reasoning-registry.js

@@ -11,10 +11,27 @@ function pruneEntry(id) {
     const entry = registry.get(id);
     if (!entry)
         return;
-    if (!entry.reasoning && !entry.outputText) {
+    if (!entry.reasoning && !entry.outputText && !entry.payloadSnapshot && !entry.passthroughPayload) {
         registry.delete(id);
     }
 }
+function cloneSnapshot(snapshot) {
+    try {
+        const structuredCloneImpl = globalThis.structuredClone;
+        if (typeof structuredCloneImpl === 'function') {
+            return structuredCloneImpl(snapshot);
+        }
+    }
+    catch {
+        /* ignore structuredClone failures */
+    }
+    try {
+        return JSON.parse(JSON.stringify(snapshot));
+    }
+    catch {
+        return undefined;
+    }
+}
 export function registerResponsesReasoning(id, segments) {
     if (typeof id !== 'string')
         return;
@@ -59,3 +76,47 @@ export function consumeResponsesOutputTextMeta(id) {
     pruneEntry(id);
     return value;
 }
+export function registerResponsesPayloadSnapshot(id, snapshot) {
+    if (typeof id !== 'string')
+        return;
+    if (!snapshot || typeof snapshot !== 'object')
+        return;
+    const clone = cloneSnapshot(snapshot);
+    if (!clone)
+        return;
+    const entry = ensureEntry(id);
+    entry.payloadSnapshot = clone;
+}
+export function consumeResponsesPayloadSnapshot(id) {
+    if (typeof id !== 'string')
+        return undefined;
+    const entry = registry.get(id);
+    if (!entry?.payloadSnapshot)
+        return undefined;
+    const clone = cloneSnapshot(entry.payloadSnapshot) ?? entry.payloadSnapshot;
+    entry.payloadSnapshot = undefined;
+    pruneEntry(id);
+    return clone;
+}
+export function registerResponsesPassthrough(id, payload) {
+    if (typeof id !== 'string')
+        return;
+    if (!payload || typeof payload !== 'object')
+        return;
+    const clone = cloneSnapshot(payload);
+    if (!clone)
+        return;
+    const entry = ensureEntry(id);
+    entry.passthroughPayload = clone;
+}
+export function consumeResponsesPassthrough(id) {
+    if (typeof id !== 'string')
+        return undefined;
+    const entry = registry.get(id);
+    if (!entry?.passthroughPayload)
+        return undefined;
+    const clone = cloneSnapshot(entry.passthroughPayload) ?? entry.passthroughPayload;
+    entry.passthroughPayload = undefined;
+    pruneEntry(id);
+    return clone;
+}

package/node_modules/@jsonstudio/llms/dist/conversion/shared/responses-response-utils.js

@@ -4,6 +4,7 @@ import { extractOutputSegments } from './output-content-normalizer.js';
 import { sanitizeReasoningTaggedText } from './reasoning-utils.js';
 import { createBridgeActionState, runBridgeActionPipeline } from './bridge-actions.js';
 import { resolveBridgePolicy, resolvePolicyActions } from './bridge-policies.js';
+import { registerResponsesPayloadSnapshot, registerResponsesPassthrough } from './responses-reasoning-registry.js';
 function selectCallId(entry) {
     const candidates = [
         entry?.call_id,
@@ -153,13 +154,27 @@ function collectRawReasoningSegments(response) {
     }
     return segments;
 }
+function registerPassthroughSnapshot(payload) {
+    const ids = new Set();
+    const requestId = typeof payload?.request_id === 'string' ? payload.request_id.trim() : '';
+    const id = typeof payload?.id === 'string' ? payload.id.trim() : '';
+    if (requestId.length)
+        ids.add(requestId);
+    if (id.length)
+        ids.add(id);
+    for (const candidate of ids) {
+        registerResponsesPassthrough(candidate, payload);
+    }
+}
 export function buildChatResponseFromResponses(payload) {
     if (!payload || typeof payload !== 'object')
         return payload;
     const response = unwrapResponsesResponse(payload);
     if (!response) {
-        if (Array.isArray(payload.choices))
+        if (Array.isArray(payload.choices)) {
+            registerPassthroughSnapshot(payload);
             return payload;
+        }
         return payload;
     }
     const id = typeof response.id === 'string' ? response.id : `resp_${Date.now()}`;
@@ -235,5 +250,12 @@ export function buildChatResponseFromResponses(payload) {
     if (usage !== undefined) {
         chat.usage = usage;
     }
+    const requestId = typeof response.request_id === 'string'
+        ? response.request_id
+        : (typeof response.id === 'string' ? response.id : undefined);
+    if (requestId) {
+        chat.request_id = requestId;
+    }
+    registerResponsesPayloadSnapshot(id, response);
     return chat;
 }

package/node_modules/@jsonstudio/llms/dist/conversion/shared/snapshot-utils.js

@@ -1,35 +1,25 @@
-import os from 'node:os';
-import path from 'node:path';
-import fs from 'node:fs/promises';
 import { writeSnapshotViaHooks } from './snapshot-hooks.js';
-const SNAPSHOT_BASE = path.join(os.homedir(), '.routecodex', 'golden_samples');
-function mapEndpointToFolder(endpoint, hint) {
-    if (hint)
-        return hint;
-    const ep = String(endpoint || '').toLowerCase();
-    if (ep.includes('/responses'))
-        return 'openai-responses';
-    if (ep.includes('/messages'))
-        return 'anthropic-messages';
-    if (ep.includes('/gemini'))
-        return 'gemini-chat';
-    return 'openai-chat';
-}
-async function ensureDir(dir) {
-    try {
-        await fs.mkdir(dir, { recursive: true });
+function resolveBoolFromEnv(value, fallback) {
+    if (!value) {
+        return fallback;
     }
-    catch {
-        // ignore fs errors
+    const normalized = value.trim().toLowerCase();
+    if (['1', 'true', 'yes', 'on'].includes(normalized)) {
+        return true;
     }
-}
-function sanitize(value) {
-    return value.replace(/[^\w.-]/g, '_');
+    if (['0', 'false', 'no', 'off'].includes(normalized)) {
+        return false;
+    }
+    return fallback;
 }
 export function shouldRecordSnapshots() {
-    const flag = process.env.ROUTECODEX_HUB_SNAPSHOTS;
-    if (flag && flag.trim() === '0') {
-        return false;
+    const hubFlag = process.env.ROUTECODEX_HUB_SNAPSHOTS;
+    if (hubFlag && hubFlag.trim().length) {
+        return resolveBoolFromEnv(hubFlag, true);
+    }
+    const sharedFlag = process.env.ROUTECODEX_SNAPSHOT ?? process.env.ROUTECODEX_SNAPSHOTS;
+    if (sharedFlag && sharedFlag.trim().length) {
+        return resolveBoolFromEnv(sharedFlag, true);
     }
     return true;
 }
@@ -37,26 +27,6 @@ export async function recordSnapshot(options) {
     if (!shouldRecordSnapshots())
         return;
     const endpoint = options.endpoint || '/v1/chat/completions';
-    const folder = mapEndpointToFolder(endpoint, options.folderHint);
-    const dir = path.join(SNAPSHOT_BASE, folder);
-    try {
-        await ensureDir(dir);
-        const safeStage = sanitize(options.stage);
-        const safeRequestId = sanitize(options.requestId);
-        const file = path.join(dir, `${safeRequestId}_${safeStage}.json`);
-        const payload = {
-            meta: {
-                stage: options.stage,
-                timestamp: Date.now(),
-                endpoint
-            },
-            body: options.data
-        };
-        await fs.writeFile(file, JSON.stringify(payload, null, 2), 'utf-8');
-    }
-    catch (error) {
-        console.warn('[snapshot-utils] failed to write snapshot', error);
-    }
     void writeSnapshotViaHooks({
         endpoint,
         stage: options.stage,

package/node_modules/@jsonstudio/llms/dist/conversion/shared/tool-canonicalizer.d.ts

@@ -0,0 +1,2 @@
+export declare function canonicalizeChatResponseTools(payload: unknown): unknown;
+export default canonicalizeChatResponseTools;

package/node_modules/@jsonstudio/llms/dist/conversion/shared/tool-filter-pipeline.js

@@ -1,5 +1,6 @@
 import { FilterEngine } from '../../filters/index.js';
 import { loadFieldMapConfig } from '../../filters/utils/fieldmap-loader.js';
+import { normalizeChatResponseReasoningTools } from './reasoning-tool-normalizer.js';
 import { createSnapshotWriter } from './snapshot-utils.js';
 const REQUEST_FILTER_STAGES = [
     'request_pre',
@@ -110,6 +111,7 @@ function applyLocalToolGovernance(chatRequest, rawPayload) {
     }
     const hasImageHint = detectImageHint(messages, rawPayload);
     if (hasImageHint) {
+        // 有图片线索时不干预工具列表，保持由上游（Codex 等）决定 view_image 的暴露与使用。
         return chatRequest;
     }
     const filteredTools = tools.filter((tool) => {
@@ -191,6 +193,16 @@ export async function runChatResponseToolFilters(chatJson, options = {}) {
         snapshot(stage, payload);
     };
     recordStage('resp_process_tool_filters_input', chatJson);
+    try {
+        if (chatJson && typeof chatJson === 'object') {
+            normalizeChatResponseReasoningTools(chatJson, {
+                idPrefixBase: 'reasoning_choice'
+            });
+        }
+    }
+    catch {
+        // best-effort; do not block response flow on reasoning parsing issues
+    }
     const engine = new FilterEngine();
     const registeredStages = new Set();
     const register = (filter) => {