@jsonstudio/rcc 0.90.352 → 0.90.367

package/vendor/llmswitch-core/dist/servertool/handlers/web-search.js

@@ -0,0 +1,926 @@
+import { buildOpenAIChatFromGeminiResponse } from '../../conversion/codecs/gemini-openai-codec.js';
+import { registerServerToolHandler } from '../registry.js';
+import { cloneJson, extractTextFromChatLike } from '../server-side-tools.js';
+import { extractCapturedChatSeed } from './followup-request-builder.js';
+import { reenterServerToolBackend } from '../reenter-backend.js';
+import { readRuntimeMetadata } from '../../conversion/runtime-metadata.js';
+const FLOW_ID = 'web_search_flow';
+const handler = async (ctx) => {
+    const toolCall = ctx.toolCall;
+    if (!toolCall) {
+        return null;
+    }
+    if (!ctx.capabilities.providerInvoker && !ctx.capabilities.reenterPipeline) {
+        return null;
+    }
+    const webSearchConfig = getWebSearchConfig(ctx.adapterContext);
+    const hasConfig = !!webSearchConfig && Array.isArray(webSearchConfig.engines) && webSearchConfig.engines.length > 0;
+    const forceMode = webSearchConfig?.force === true;
+    const envEnabled = resolveEnvServerSideToolsEnabled();
+    if (!hasConfig && !forceMode && !envEnabled) {
+        return null;
+    }
+    const parsedArgs = parseToolArguments(toolCall);
+    const query = typeof parsedArgs.query === 'string' && parsedArgs.query.trim() ? parsedArgs.query.trim() : undefined;
+    if (!query) {
+        return null;
+    }
+    const engines = webSearchConfig ? buildEnginePriorityList(webSearchConfig, parsedArgs.engine) : [];
+    if (!engines.length) {
+        return null;
+    }
+    const resultCount = normalizeResultCount(parsedArgs.count);
+    const recency = typeof parsedArgs.recency === 'string' && parsedArgs.recency.trim() ? parsedArgs.recency.trim() : undefined;
+    const backend = {
+        kind: 'web_search',
+        requestIdSuffix: ':web_search',
+        query,
+        ...(recency ? { recency } : {}),
+        resultCount,
+        engines
+    };
+    return {
+        flowId: FLOW_ID,
+        backend,
+        finalize: async ({ backendResult }) => {
+            if (!backendResult || backendResult.kind !== 'web_search') {
+                return null;
+            }
+            const chosen = backendResult.chosenEngine;
+            if (!chosen || !chosen.id || !chosen.providerKey) {
+                return null;
+            }
+            const patched = injectWebSearchToolResult(ctx.base, toolCall, { id: chosen.id, providerKey: chosen.providerKey }, query, backendResult.result);
+            const seed = extractCapturedChatSeed(ctx.adapterContext?.capturedChatRequest);
+            const assistantMessage = seed ? extractAssistantMessage(patched) : null;
+            const toolMessages = seed ? buildToolMessages(patched) : [];
+            const canFollowup = Boolean(seed && assistantMessage && toolMessages.length > 0);
+            return {
+                chatResponse: patched,
+                execution: {
+                    flowId: FLOW_ID,
+                    ...(canFollowup
+                        ? {
+                            followup: {
+                                requestIdSuffix: ':web_search_followup',
+                                entryEndpoint: ctx.entryEndpoint,
+                                injection: {
+                                    ops: [
+                                        { op: 'append_assistant_message' },
+                                        { op: 'append_tool_messages_from_tool_outputs' },
+                                        { op: 'drop_tool_by_name', name: 'web_search' }
+                                    ]
+                                }
+                            }
+                        }
+                        : {}),
+                    context: {
+                        web_search: {
+                            engineId: chosen.id,
+                            providerKey: chosen.providerKey,
+                            summary: backendResult.result.summary
+                        }
+                    }
+                }
+            };
+        }
+    };
+};
+registerServerToolHandler('web_search', handler);
+function parseToolArguments(toolCall) {
+    if (!toolCall.arguments || typeof toolCall.arguments !== 'string') {
+        return {};
+    }
+    try {
+        return JSON.parse(toolCall.arguments);
+    }
+    catch {
+        return {};
+    }
+}
+function getWebSearchConfig(ctx) {
+    const rt = readRuntimeMetadata(ctx);
+    const raw = rt ? rt.webSearch : undefined;
+    const record = raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : null;
+    if (!record)
+        return undefined;
+    const enginesRaw = Array.isArray(record.engines) ? record.engines : [];
+    const engines = [];
+    for (const entry of enginesRaw) {
+        const obj = entry && typeof entry === 'object' && !Array.isArray(entry)
+            ? entry
+            : null;
+        if (!obj)
+            continue;
+        const id = typeof obj.id === 'string' && obj.id.trim() ? obj.id.trim() : undefined;
+        const providerKey = typeof obj.providerKey === 'string' && obj.providerKey.trim()
+            ? obj.providerKey.trim()
+            : undefined;
+        if (!id || !providerKey)
+            continue;
+        const rawExecutionMode = typeof obj.executionMode === 'string'
+            ? obj.executionMode.trim().toLowerCase()
+            : typeof obj.mode === 'string'
+                ? obj.mode.trim().toLowerCase()
+                : '';
+        const executionMode = rawExecutionMode === 'direct' ? 'direct' : 'servertool';
+        const rawDirectActivation = typeof obj.directActivation === 'string'
+            ? obj.directActivation.trim().toLowerCase()
+            : typeof obj.activation === 'string'
+                ? obj.activation.trim().toLowerCase()
+                : '';
+        const directActivation = rawDirectActivation === 'builtin'
+            ? 'builtin'
+            : rawDirectActivation === 'route'
+                ? 'route'
+                : executionMode === 'direct'
+                    ? 'route'
+                    : undefined;
+        const modelId = typeof obj.modelId === 'string' && obj.modelId.trim() ? obj.modelId.trim() : undefined;
+        const rawMaxUses = typeof obj.maxUses === 'number' ? obj.maxUses : Number(obj.maxUses);
+        const maxUses = Number.isFinite(rawMaxUses) && rawMaxUses > 0 ? Math.floor(rawMaxUses) : undefined;
+        const serverToolsDisabled = obj.serverToolsDisabled === true ||
+            (typeof obj.serverToolsDisabled === 'string' &&
+                obj.serverToolsDisabled.trim().toLowerCase() === 'true') ||
+            (obj.serverTools &&
+                typeof obj.serverTools === 'object' &&
+                obj.serverTools.enabled === false);
+        let searchEngineList;
+        const rawSearchList = obj.searchEngineList;
+        if (Array.isArray(rawSearchList)) {
+            const normalizedList = [];
+            for (const item of rawSearchList) {
+                if (typeof item === 'string' && item.trim().length) {
+                    normalizedList.push(item.trim());
+                }
+            }
+            if (normalizedList.length) {
+                searchEngineList = normalizedList;
+            }
+        }
+        engines.push({
+            id,
+            providerKey,
+            description: typeof obj.description === 'string' && obj.description.trim() ? obj.description.trim() : undefined,
+            default: obj.default === true,
+            executionMode,
+            ...(directActivation ? { directActivation } : {}),
+            ...(modelId ? { modelId } : {}),
+            ...(maxUses ? { maxUses } : {}),
+            ...(serverToolsDisabled ? { serverToolsDisabled: true } : {}),
+            ...(searchEngineList ? { searchEngineList } : {})
+        });
+    }
+    if (!engines.length) {
+        return undefined;
+    }
+    const config = { engines };
+    if (typeof record.injectPolicy === 'string') {
+        const val = String(record.injectPolicy).trim().toLowerCase();
+        if (val === 'always' || val === 'selective') {
+            config.injectPolicy = val;
+        }
+    }
+    if (record.force === true ||
+        (typeof record.force === 'string' && String(record.force).trim().toLowerCase() === 'true')) {
+        config.force = true;
+    }
+    return config;
+}
+function resolveWebSearchEngine(config, engineId) {
+    const trimmedId = typeof engineId === 'string' && engineId.trim() ? engineId.trim() : undefined;
+    if (trimmedId) {
+        const byId = config.engines.find((e) => e.id === trimmedId);
+        if (byId && !byId.serverToolsDisabled) {
+            return byId;
+        }
+    }
+    const byDefault = config.engines.find((e) => e.default && !e.serverToolsDisabled);
+    if (byDefault && !byDefault.serverToolsDisabled) {
+        return byDefault;
+    }
+    if (config.engines.length === 1) {
+        const single = config.engines[0];
+        return single.serverToolsDisabled ? undefined : single;
+    }
+    return undefined;
+}
+function buildEnginePriorityList(config, engineId) {
+    const engines = (Array.isArray(config.engines) ? config.engines : []).filter((engine) => !engine.serverToolsDisabled && (engine.executionMode ?? 'servertool') === 'servertool');
+    if (!engines.length) {
+        return [];
+    }
+    const primary = resolveWebSearchEngine(config, engineId);
+    if (!primary) {
+        return [...engines];
+    }
+    const ordered = [primary];
+    for (const engine of engines) {
+        if (engine !== primary) {
+            ordered.push(engine);
+        }
+    }
+    return ordered;
+}
+function resolveEnvServerSideToolsEnabled() {
+    const raw = (process.env.ROUTECODEX_SERVER_SIDE_TOOLS || process.env.RCC_SERVER_SIDE_TOOLS || '').trim().toLowerCase();
+    if (!raw)
+        return false;
+    if (raw === '1' || raw === 'true' || raw === 'yes')
+        return true;
+    if (raw === 'web_search')
+        return true;
+    return false;
+}
+function isGeminiWebSearchEngine(engine) {
+    const key = engine.providerKey.toLowerCase();
+    return (key.startsWith('gemini-cli.') ||
+        key.startsWith('antigravity.') ||
+        key.startsWith('gemini.'));
+}
+function isIflowWebSearchEngine(engine) {
+    const key = engine.providerKey.toLowerCase();
+    return key.startsWith('iflow.');
+}
+function isQwenWebSearchEngine(engine) {
+    const key = engine.providerKey.toLowerCase();
+    return key.startsWith('qwen.');
+}
+function normalizeResultCount(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        const normalized = Math.trunc(value);
+        if (normalized >= 5 && normalized <= 15) {
+            return normalized;
+        }
+    }
+    return 10;
+}
+async function executeWebSearchBackend(args) {
+    const { options, engine, query } = args;
+    const recency = typeof args.recency === 'string' && args.recency.trim() ? args.recency.trim() : undefined;
+    let summary = '';
+    let hits = [];
+    let ok = true;
+    try {
+        logServerToolWebSearch(engine, options.requestId, query);
+        const requestSuffix = args.requestSuffix;
+        // 对于 iFlow，直接通过 providerInvoker 调用 /chat/retrieve，
+        // 即使 reenterPipeline 可用，也不走 Chat 模型 + tools。
+        if (isIflowWebSearchEngine(engine) && options.providerInvoker) {
+            const backendResult = await executeIflowWebSearchViaProvider({
+                options,
+                engine,
+                query,
+                recency,
+                count: args.resultCount,
+                requestSuffix
+            });
+            summary = backendResult.summary;
+            hits = backendResult.hits;
+            ok = backendResult.ok;
+        }
+        else if (isQwenWebSearchEngine(engine) && options.providerInvoker) {
+            const backendResult = await executeQwenWebSearchViaProvider({
+                options,
+                engine,
+                query,
+                count: args.resultCount,
+                requestSuffix
+            });
+            summary = backendResult.summary;
+            hits = backendResult.hits;
+            ok = backendResult.ok;
+        }
+        else if (options.reenterPipeline) {
+            const payload = buildWebSearchReenterPayload(engine, query, recency, args.resultCount);
+            const followup = await reenterServerToolBackend({
+                reenterPipeline: options.reenterPipeline,
+                entryEndpoint: '/v1/chat/completions',
+                requestId: `${options.requestId}${requestSuffix}`,
+                body: payload,
+                providerProtocol: 'openai-chat',
+                routeHint: 'web_search'
+            });
+            const body = followup.body && typeof followup.body === 'object' ? followup.body : null;
+            if (body) {
+                summary = extractTextFromChatLike(body);
+                hits = collectWebSearchHits(body);
+                if (!summary && process.env.ROUTECODEX_DEBUG_GLM_WEB_SEARCH === '1') {
+                    try {
+                        // eslint-disable-next-line no-console
+                        console.log('\x1b[38;5;27m[server-tool][web_search][backend_debug]' +
+                            ` requestId=${options.requestId}${requestSuffix} payload=${JSON.stringify(body).slice(0, 2000)}\x1b[0m`);
+                    }
+                    catch {
+                        /* logging best-effort */
+                    }
+                }
+            }
+        }
+        else if (options.providerInvoker) {
+            summary = await executeWebSearchViaProvider({
+                options,
+                engine,
+                query,
+                recency,
+                count: args.resultCount,
+                requestSuffix
+            });
+            hits = [];
+        }
+    }
+    catch (error) {
+        ok = false;
+        const message = error instanceof Error && typeof error.message === 'string' && error.message.trim()
+            ? sanitizeBackendError(error.message.trim())
+            : 'web_search backend failed';
+        summary =
+            `web_search failed: ${message}. ` +
+                '请调整搜索关键词（例如减少敏感描述或换一种说法）后重试，这只是当前查询被阻止。';
+    }
+    if (!summary) {
+        if (hits.length) {
+            summary = formatHitsSummary(hits);
+        }
+        else {
+            summary =
+                'web_search completed but returned no textual summary. ' +
+                    '可以尝试修改搜索词、增加时间范围或换一个更具体的描述后再次搜索。';
+        }
+    }
+    try {
+        const preview = summary.length > 120 ? `${summary.slice(0, 117)}...` : summary;
+        // eslint-disable-next-line no-console
+        console.log(`\x1b[38;5;27m[server-tool][web_search][result] requestId=${options.requestId} ` +
+            `engine=${engine.id} chars=${summary.length} preview=${JSON.stringify(preview)}\x1b[0m`);
+    }
+    catch {
+        /* logging best-effort */
+    }
+    const finalHits = limitHits(hits);
+    if (!summary) {
+        summary = formatHitsSummary(finalHits);
+    }
+    if (finalHits.length > 0 && finalHits.length < 5) {
+        summary = `${summary}\n（当前仅返回${finalHits.length}条可用结果，可尝试调整关键词或时间范围以获取更多。）`;
+    }
+    return { summary, hits: finalHits, ok };
+}
+export async function executeWebSearchBackendPlan(args) {
+    const plan = args.plan;
+    const options = args.options;
+    const engines = Array.isArray(plan.engines) ? plan.engines : [];
+    if (!engines.length) {
+        return { kind: 'web_search', result: { ok: false, summary: '', hits: [] } };
+    }
+    let chosenEngine;
+    let chosenResult;
+    let lastFailure;
+    for (const engine of engines) {
+        const requestSuffix = `${plan.requestIdSuffix}:${engine.id}`;
+        const backendResult = await executeWebSearchBackend({
+            options,
+            engine,
+            query: plan.query,
+            recency: plan.recency,
+            resultCount: plan.resultCount,
+            requestSuffix
+        });
+        if (backendResult.ok) {
+            chosenEngine = engine;
+            chosenResult = backendResult;
+            break;
+        }
+        lastFailure = { engine, result: backendResult };
+    }
+    if (!chosenEngine || !chosenResult) {
+        if (!lastFailure) {
+            return { kind: 'web_search', result: { ok: false, summary: '', hits: [] } };
+        }
+        chosenEngine = lastFailure.engine;
+        chosenResult = lastFailure.result;
+    }
+    return {
+        kind: 'web_search',
+        chosenEngine: { id: chosenEngine.id, providerKey: chosenEngine.providerKey },
+        result: { ok: chosenResult.ok, summary: chosenResult.summary, hits: chosenResult.hits }
+    };
+}
+function buildWebSearchReenterPayload(engine, query, recency, resultCount) {
+    const systemPrompt = buildWebSearchSystemPrompt(resultCount);
+    const basePayload = {
+        model: engine.id,
+        messages: [
+            {
+                role: 'system',
+                content: systemPrompt
+            },
+            {
+                role: 'user',
+                content: query
+            }
+        ],
+        stream: false
+    };
+    if (isGeminiWebSearchEngine(engine)) {
+        return basePayload;
+    }
+    return {
+        ...basePayload,
+        web_search: {
+            query,
+            ...(recency ? { recency } : {}),
+            count: resultCount,
+            engine: engine.id
+        }
+    };
+}
+async function executeWebSearchViaProvider(args) {
+    const { options, engine, query, recency, count, requestSuffix } = args;
+    if (!options.providerInvoker) {
+        return '';
+    }
+    if (isGeminiWebSearchEngine(engine)) {
+        const geminiPayload = {
+            model: engine.id,
+            contents: [
+                {
+                    role: 'user',
+                    parts: [
+                        {
+                            text: query
+                        }
+                    ]
+                }
+            ],
+            tools: [
+                {
+                    googleSearch: {}
+                }
+            ]
+        };
+        const backend = await options.providerInvoker({
+            providerKey: engine.providerKey,
+            providerType: undefined,
+            modelId: engine.id,
+            providerProtocol: 'gemini-chat',
+            payload: geminiPayload,
+            entryEndpoint: '/v1/models/gemini:generateContent',
+            requestId: `${options.requestId}${requestSuffix}`,
+            routeHint: 'web_search'
+        });
+        const providerResponse = backend.providerResponse && typeof backend.providerResponse === 'object'
+            ? backend.providerResponse
+            : null;
+        if (!providerResponse) {
+            return '';
+        }
+        const chatLike = buildOpenAIChatFromGeminiResponse(providerResponse);
+        return chatLike ? extractTextFromChatLike(chatLike) : '';
+    }
+    const backendPayload = {
+        model: engine.id,
+        messages: [
+            {
+                role: 'system',
+                content: 'You are a web search engine. Answer with up-to-date information based on the open internet.'
+            },
+            {
+                role: 'user',
+                content: query
+            }
+        ],
+        stream: false,
+        web_search: {
+            query,
+            ...(recency ? { recency } : {}),
+            count: args.count,
+            engine: engine.id
+        }
+    };
+    const backend = await options.providerInvoker({
+        providerKey: engine.providerKey,
+        providerType: undefined,
+        modelId: undefined,
+        providerProtocol: options.providerProtocol,
+        payload: backendPayload,
+        entryEndpoint: '/v1/chat/completions',
+        requestId: `${options.requestId}${requestSuffix}`,
+        routeHint: 'web_search'
+    });
+    const providerResponse = backend.providerResponse && typeof backend.providerResponse === 'object'
+        ? backend.providerResponse
+        : null;
+    if (!providerResponse) {
+        return '';
+    }
+    return extractTextFromChatLike(providerResponse);
+}
+async function executeIflowWebSearchViaProvider(args) {
+    const { options, engine, query, count, requestSuffix } = args;
+    if (!options.providerInvoker) {
+        return {
+            summary: '',
+            hits: [],
+            ok: false
+        };
+    }
+    const searchEngineList = Array.isArray(engine.searchEngineList) && engine.searchEngineList.length
+        ? engine.searchEngineList
+        : ['GOOGLE', 'BING', 'SCHOLAR', 'AIPGC', 'PDF'];
+    const searchBody = {
+        query,
+        history: {},
+        userId: 2,
+        userIp: '42.120.74.197',
+        appCode: 'SEARCH_CHATBOT',
+        chatId: Date.now(),
+        phase: 'UNIFY',
+        enableQueryRewrite: false,
+        enableRetrievalSecurity: false,
+        enableIntention: false,
+        searchEngineList
+    };
+    let providerKey = engine.providerKey;
+    try {
+        const adapter = options.adapterContext && typeof options.adapterContext === 'object'
+            ? options.adapterContext
+            : null;
+        const target = adapter && adapter.target && typeof adapter.target === 'object'
+            ? adapter.target
+            : null;
+        const targetProviderKey = target && typeof target.providerKey === 'string' && target.providerKey.trim()
+            ? target.providerKey.trim()
+            : undefined;
+        if (targetProviderKey) {
+            providerKey = targetProviderKey;
+        }
+    }
+    catch {
+        // best-effort: fallback to engine.providerKey
+    }
+    const payload = {
+        data: searchBody,
+        metadata: {
+            entryEndpoint: '/chat/retrieve',
+            iflowWebSearch: true,
+            routeName: 'web_search'
+        }
+    };
+    const backend = await options.providerInvoker({
+        providerKey,
+        providerType: undefined,
+        modelId: undefined,
+        providerProtocol: options.providerProtocol,
+        payload,
+        entryEndpoint: '/v1/chat/retrieve',
+        requestId: `${options.requestId}${requestSuffix}`,
+        routeHint: 'web_search'
+    });
+    const providerResponse = backend.providerResponse && typeof backend.providerResponse === 'object'
+        ? backend.providerResponse
+        : null;
+    if (!providerResponse) {
+        return {
+            summary: '',
+            hits: [],
+            ok: false
+        };
+    }
+    const container = providerResponse;
+    const rawHits = Array.isArray(container.data) ? container.data : [];
+    const hits = [];
+    for (const item of rawHits) {
+        if (!item || typeof item !== 'object' || Array.isArray(item))
+            continue;
+        const record = item;
+        const link = typeof record.url === 'string' && record.url.trim() ? record.url.trim() : '';
+        if (!link)
+            continue;
+        const title = typeof record.title === 'string' && record.title.trim() ? record.title.trim() : undefined;
+        const publishDate = typeof record.time === 'string' && record.time.trim() ? record.time.trim() : undefined;
+        const content = typeof record.abstractInfo === 'string' && record.abstractInfo.trim()
+            ? record.abstractInfo.trim()
+            : undefined;
+        hits.push({
+            title,
+            link,
+            publish_date: publishDate,
+            content
+        });
+        if (hits.length >= count) {
+            break;
+        }
+    }
+    let summary = '';
+    if (typeof container.message === 'string' && container.message.trim()) {
+        summary = container.message.trim();
+    }
+    if (!summary && hits.length) {
+        summary = formatHitsSummary(hits);
+    }
+    const successField = container.success;
+    const ok = typeof successField === 'boolean' ? successField : hits.length > 0;
+    return {
+        summary,
+        hits,
+        ok
+    };
+}
+async function executeQwenWebSearchViaProvider(args) {
+    const { options, engine, query, count, requestSuffix } = args;
+    if (!options.providerInvoker) {
+        return {
+            summary: '',
+            hits: [],
+            ok: false
+        };
+    }
+    const payload = {
+        data: {
+            model: engine.id,
+            uq: query,
+            page: 1,
+            rows: count
+        },
+        metadata: {
+            entryEndpoint: '/api/v1/indices/plugin/web_search',
+            qwenWebSearch: true,
+            routeName: 'web_search'
+        }
+    };
+    const backend = await options.providerInvoker({
+        providerKey: engine.providerKey,
+        providerType: undefined,
+        modelId: undefined,
+        providerProtocol: options.providerProtocol,
+        payload,
+        entryEndpoint: '/api/v1/indices/plugin/web_search',
+        requestId: `${options.requestId}${requestSuffix}`,
+        routeHint: 'web_search'
+    });
+    const providerResponse = backend.providerResponse && typeof backend.providerResponse === 'object'
+        ? backend.providerResponse
+        : null;
+    if (!providerResponse) {
+        return {
+            summary: '',
+            hits: [],
+            ok: false
+        };
+    }
+    const container = providerResponse;
+    const status = typeof container.status === 'number' ? container.status : undefined;
+    const message = typeof container.message === 'string' && container.message.trim()
+        ? container.message.trim()
+        : typeof container.msg === 'string' && container.msg.trim()
+            ? container.msg.trim()
+            : '';
+    if (status !== undefined && status !== 0) {
+        throw new Error(message || `qwen web_search failed with status=${status}`);
+    }
+    const dataNode = container.data && typeof container.data === 'object' && !Array.isArray(container.data)
+        ? container.data
+        : undefined;
+    const rawDocs = Array.isArray(dataNode?.docs) ? dataNode?.docs : [];
+    const hits = [];
+    for (const item of rawDocs) {
+        if (!item || typeof item !== 'object' || Array.isArray(item))
+            continue;
+        const record = item;
+        const linkCandidate = typeof record.url === 'string' && record.url.trim()
+            ? record.url.trim()
+            : typeof record.link === 'string' && record.link.trim()
+                ? record.link.trim()
+                : '';
+        if (!linkCandidate)
+            continue;
+        const title = typeof record.title === 'string' && record.title.trim() ? record.title.trim() : undefined;
+        const content = typeof record.snippet === 'string' && record.snippet.trim()
+            ? record.snippet.trim()
+            : typeof record.content === 'string' && record.content.trim()
+                ? record.content.trim()
+                : undefined;
+        const publishDate = typeof record.timestamp_format === 'string' && record.timestamp_format.trim()
+            ? record.timestamp_format.trim()
+            : typeof record.timestamp === 'string' && record.timestamp.trim()
+                ? record.timestamp.trim()
+                : typeof record.time === 'string' && record.time.trim()
+                    ? record.time.trim()
+                    : undefined;
+        const media = typeof record.source === 'string' && record.source.trim() ? record.source.trim() : undefined;
+        hits.push({
+            title,
+            link: linkCandidate,
+            content,
+            publish_date: publishDate,
+            media
+        });
+        if (hits.length >= count) {
+            break;
+        }
+    }
+    const summary = message || (hits.length ? formatHitsSummary(hits) : '');
+    const ok = status === 0 || hits.length > 0;
+    return {
+        summary,
+        hits,
+        ok
+    };
+}
+function injectWebSearchToolResult(base, toolCall, engine, query, backendResult) {
+    const cloned = cloneJson(base);
+    const existingOutputs = Array.isArray(cloned.tool_outputs)
+        ? cloned.tool_outputs
+        : [];
+    const resultsPayload = backendResult.hits.map((hit, index) => ({
+        index: index + 1,
+        title: hit.title ?? '',
+        link: hit.link,
+        snippet: hit.content ?? '',
+        source: hit.media ?? '',
+        publish_date: hit.publish_date ?? ''
+    }));
+    cloned.tool_outputs = [
+        ...existingOutputs,
+        {
+            tool_call_id: toolCall.id,
+            name: 'web_search',
+            content: JSON.stringify({
+                engine: engine.id,
+                query,
+                summary: backendResult.summary,
+                results: resultsPayload
+            })
+        }
+    ];
+    return cloned;
+}
+function extractAssistantMessage(chatResponse) {
+    const choices = Array.isArray(chatResponse.choices)
+        ? chatResponse.choices
+        : [];
+    if (!choices.length)
+        return null;
+    const firstChoice = choices[0] && typeof choices[0] === 'object' && !Array.isArray(choices[0])
+        ? choices[0]
+        : null;
+    if (!firstChoice)
+        return null;
+    const assistantMessage = firstChoice.message && typeof firstChoice.message === 'object'
+        ? firstChoice.message
+        : null;
+    return assistantMessage;
+}
+function buildToolMessages(chatResponse) {
+    const toolOutputs = Array.isArray(chatResponse.tool_outputs)
+        ? chatResponse.tool_outputs
+        : [];
+    const messages = [];
+    for (const entry of toolOutputs) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const toolCallId = typeof entry.tool_call_id === 'string'
+            ? entry.tool_call_id
+            : undefined;
+        if (!toolCallId)
+            continue;
+        const name = typeof entry.name === 'string'
+            ? entry.name
+            : 'web_search';
+        const rawContent = entry.content;
+        let contentText;
+        if (typeof rawContent === 'string') {
+            contentText = rawContent;
+        }
+        else {
+            try {
+                contentText = JSON.stringify(rawContent ?? {});
+            }
+            catch {
+                contentText = String(rawContent ?? '');
+            }
+        }
+        messages.push({
+            role: 'tool',
+            tool_call_id: toolCallId,
+            name,
+            content: contentText
+        });
+    }
+    return messages;
+}
+function logServerToolWebSearch(engine, requestId, query) {
+    const providerAlias = engine.providerKey.split('.')[0] || engine.providerKey;
+    const backendLabel = `${providerAlias}:${engine.id}`;
+    const prefix = `[server-tool][web_search][${backendLabel}]`;
+    const line = `${prefix} requestId=${requestId} query=${JSON.stringify(query)}`;
+    // eslint-disable-next-line no-console
+    console.log(`\x1b[38;5;27m${line}\x1b[0m`);
+    const vrPrefix = `[virtual-router][servertool][web_search]`;
+    const vrBackend = `${engine.providerKey}:${engine.id}`;
+    const vrLine = `${vrPrefix} requestId=${requestId} backend=${vrBackend}`;
+    // eslint-disable-next-line no-console
+    console.log(`\x1b[31m${vrLine}\x1b[0m`);
+}
+function findWebSearchArray(payload) {
+    let current = payload;
+    const visited = new Set();
+    while (current && !visited.has(current)) {
+        visited.add(current);
+        const hits = getArray(current.web_search);
+        if (hits.length) {
+            return hits;
+        }
+        const nextData = current.data;
+        if (nextData && typeof nextData === 'object' && !Array.isArray(nextData)) {
+            current = nextData;
+            continue;
+        }
+        const nextResponse = current.response;
+        if (nextResponse && typeof nextResponse === 'object' && !Array.isArray(nextResponse)) {
+            current = nextResponse;
+            continue;
+        }
+        break;
+    }
+    return undefined;
+}
+function collectWebSearchHits(payload) {
+    const array = findWebSearchArray(payload);
+    if (!array) {
+        return [];
+    }
+    const hits = [];
+    for (const entry of array) {
+        if (!entry || typeof entry !== 'object' || Array.isArray(entry))
+            continue;
+        const record = entry;
+        const link = typeof record.link === 'string' && record.link.trim() ? record.link.trim() : '';
+        if (!link)
+            continue;
+        hits.push({
+            title: typeof record.title === 'string' ? record.title : undefined,
+            link,
+            media: typeof record.media === 'string' ? record.media : undefined,
+            publish_date: typeof record.publish_date === 'string' ? record.publish_date : undefined,
+            content: typeof record.content === 'string' ? record.content : undefined,
+            refer: typeof record.refer === 'string' ? record.refer : undefined
+        });
+    }
+    return hits;
+}
+function limitHits(hits) {
+    if (!hits.length)
+        return [];
+    const filtered = hits.slice(0, 15);
+    if (filtered.length >= 5) {
+        return filtered;
+    }
+    return filtered;
+}
+function formatHitsSummary(hits) {
+    if (!hits.length) {
+        return '';
+    }
+    const segments = [];
+    hits.forEach((hit, index) => {
+        const idx = hit.refer && hit.refer.trim() ? hit.refer.trim() : String(index + 1);
+        const headerParts = [];
+        if (hit.title)
+            headerParts.push(hit.title);
+        if (hit.media)
+            headerParts.push(hit.media);
+        if (hit.publish_date)
+            headerParts.push(hit.publish_date);
+        const header = headerParts.length ? headerParts.join(' · ') : '搜索结果';
+        const details = [hit.content, hit.link].filter(Boolean).join('\n');
+        segments.push(`【${idx}】${header}\n${details}`);
+    });
+    return segments.join('\n\n');
+}
+function getArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function sanitizeBackendError(message) {
+    const lowered = message.toLowerCase();
+    if (lowered.includes('contentfilter')) {
+        return '搜索请求被后端暂时拒绝';
+    }
+    if (lowered.includes('instructions are not valid')) {
+        return '搜索指令格式未被后端接受';
+    }
+    return message;
+}
+function buildWebSearchSystemPrompt(targetCount) {
+    const normalizedTarget = Math.max(5, Math.min(15, targetCount));
+    const instructions = [
+        'You are an up-to-date web search engine that aggregates public internet results.',
+        `Return between 5 and 15 high-quality search results (aim for about ${normalizedTarget} when available).`,
+        'Each result must include: title, source/media, publish date if available, a concise summary (<=200 characters), and a direct URL that users can click for verification.',
+        'Prefer de-duplicated sources and include diverse outlets. If fewer than 5 results exist, return what you can find and explain the limitation.',
+        'Only mention that the query was blocked when the backend explicitly rejects it, and encourage the user to adjust their keywords before retrying.',
+        'Structure the answer so downstream systems can extract each result cleanly.'
+    ];
+    return instructions.join('\n');
+}