@jsonstudio/llms 0.6.2172 → 0.6.2979

package/dist/conversion/hub/process/chat-process.js

@@ -1,35 +1,18 @@
-import { runChatRequestToolFilters } from '../../shared/tool-filter-pipeline.js';
-import { ToolGovernanceEngine } from '../tool-governance/index.js';
-import { readRuntimeMetadata } from '../../shared/runtime-metadata.js';
-import { ensureApplyPatchSchema } from '../../shared/tool-mapping.js';
-import { normalizeApplyPatchToolCallsOnRequest } from '../../shared/tool-governor.js';
-import { buildAnthropicToolAliasMap } from '../../shared/anthropic-message-utils.js';
-import { clearClockSession, parseDueAtMs, resolveClockConfig, reserveDueTasksForRequest, scheduleClockTasks, startClockDaemonIfNeeded } from '../../../servertool/clock/task-store.js';
-import { logClock } from '../../../servertool/clock/log.js';
-import { logContinueExecution } from '../../../servertool/continue-execution/log.js';
-import { buildTimeTagLine, getClockTimeSnapshot } from '../../../servertool/clock/ntp.js';
-import { resolveClockSessionScope } from '../../../servertool/clock/session-scope.js';
-import { clearPendingServerToolInjection, loadPendingServerToolInjection } from '../../../servertool/pending-session.js';
-import { loadRoutingInstructionStateSync } from '../../../router/virtual-router/sticky-session-store.js';
-import { isJsonObject } from '../types/json.js';
-import { applyHubOperations } from '../ops/operations.js';
-const toolGovernanceEngine = new ToolGovernanceEngine();
-const CONTINUE_EXECUTION_SYSTEM_DIRECTIVE_MARKER = '[routecodex:continue_execution_directive]';
-const CONTINUE_EXECUTION_SYSTEM_DIRECTIVE = [
-    CONTINUE_EXECUTION_SYSTEM_DIRECTIVE_MARKER,
-    'Execution policy (must follow):',
-    '- Do not output status-talk placeholders such as \"继续执行中\" / \"I will continue\" before real work.',
-    '- Perform at least one real action first (prefer tool calls), then report concise results when needed.',
-    '- If you are about to return finish_reason=stop (or protocol-equivalent end_turn), do not end directly; emit a continue_execution tool call first.'
-].join('\n');
+import { buildErrorResult, buildProcessedRequest, buildSuccessResult } from './chat-process-node-result.js';
+import { applyRequestToolGovernance } from './chat-process-governance-orchestration.js';
+import { shouldRunHubChatProcessWithNative } from '../../../router/virtual-router/engine-selection/native-hub-pipeline-req-inbound-semantics.js';
 export async function runHubChatProcess(options) {
     const startTime = Date.now();
     try {
-        const governed = await applyRequestToolGovernance(options.request, {
-            entryEndpoint: options.entryEndpoint,
-            requestId: options.requestId,
-            metadata: options.metadata
-        });
+        const shouldRunGovernance = shouldRunHubChatProcessWithNative(options.requestId, options.entryEndpoint);
+        const governed = shouldRunGovernance
+            ? await applyRequestToolGovernance(options.request, {
+                entryEndpoint: options.entryEndpoint,
+                requestId: options.requestId,
+                metadata: options.metadata,
+                rawPayload: options.rawPayload
+            })
+            : options.request;
         const processedRequest = buildProcessedRequest(governed);
         return {
             processedRequest,
@@ -42,1675 +25,3 @@ export async function runHubChatProcess(options) {
         };
     }
 }
-async function applyRequestToolGovernance(request, context) {
-    const entryEndpoint = context.entryEndpoint && context.entryEndpoint.trim()
-        ? context.entryEndpoint
-        : '/v1/chat/completions';
-    const metadata = normalizeRecord(context.metadata);
-    const providerProtocol = readString(metadata.providerProtocol) ?? readString(metadata.provider) ?? 'openai-chat';
-    const metadataToolHints = metadata.toolFilterHints;
-    const metadataStreamFlag = metadata.stream;
-    const inboundStreamIntent = typeof metadataStreamFlag === 'boolean' ? metadataStreamFlag : request.parameters?.stream === true;
-    // /v1/messages: preserve the caller's tool naming (Bash/Glob/Read, etc.) so we can
-    // remap tool calls back to the client protocol shape after routing through providers
-    // that canonicalize tool names (e.g. OpenAI function names lowercased).
-    //
-    // NOTE: This is mappable semantics and must live in request.semantics (never metadata).
-    try {
-        if (entryEndpoint.toLowerCase().includes('/v1/messages')) {
-            request.semantics = request.semantics && typeof request.semantics === 'object' && !Array.isArray(request.semantics)
-                ? request.semantics
-                : {};
-            const semanticsTools = request.semantics.tools && typeof request.semantics.tools === 'object' && !Array.isArray(request.semantics.tools)
-                ? request.semantics.tools
-                : (request.semantics.tools = {});
-            const hasAlias = isJsonObject(semanticsTools.toolNameAliasMap) ||
-                isJsonObject(semanticsTools.toolAliasMap);
-            if (!hasAlias) {
-                const sourceTools = Array.isArray(semanticsTools.clientToolsRaw) && semanticsTools.clientToolsRaw.length
-                    ? semanticsTools.clientToolsRaw
-                    : request.tools;
-                const aliasMap = buildAnthropicToolAliasMap(sourceTools);
-                if (aliasMap) {
-                    semanticsTools.toolNameAliasMap = aliasMap;
-                }
-            }
-        }
-    }
-    catch {
-        // best-effort: never block request handling due to alias map propagation failures
-    }
-    const shaped = {
-        model: request.model,
-        messages: deepClone(request.messages),
-        tools: request.tools ? deepClone(request.tools) : undefined,
-        tool_choice: request.parameters?.tool_choice,
-        stream: request.parameters?.stream === true,
-        parameters: { ...request.parameters }
-    };
-    const governedPayload = await runChatRequestToolFilters(shaped, {
-        entryEndpoint,
-        requestId: context.requestId,
-        model: request.model,
-        profile: providerProtocol,
-        stream: inboundStreamIntent,
-        toolFilterHints: metadataToolHints,
-        rawPayload: context.metadata?.__raw_request_body && typeof context.metadata.__raw_request_body === 'object'
-            ? context.metadata.__raw_request_body
-            : undefined
-    });
-    const governed = normalizeRecord(governedPayload);
-    const providerStreamIntent = typeof governed.stream === 'boolean' ? governed.stream : undefined;
-    let merged = {
-        ...request,
-        messages: Array.isArray(governed.messages)
-            ? governed.messages
-            : request.messages,
-        tools: governed.tools !== undefined ? castGovernedTools(governed.tools) : request.tools,
-        parameters: {
-            ...request.parameters,
-            ...(isRecord(governed.parameters) ? governed.parameters : {})
-        },
-        metadata: {
-            ...request.metadata,
-            toolChoice: readToolChoice(governed.tool_choice),
-            originalStream: inboundStreamIntent,
-            stream: inboundStreamIntent,
-            providerStream: providerStreamIntent,
-            governedTools: governed.tools !== undefined,
-            governanceTimestamp: Date.now()
-        }
-    };
-    // 清理历史图片：仅保留「最新一条 user 消息」中的图片分段，
-    // 避免历史对话中的图片在后续多轮工具 / 普通对话中继续作为多模态负载发给不支持图片的模型。
-    merged = {
-        ...merged,
-        messages: stripHistoricalImageAttachments(merged.messages)
-    };
-    merged = normalizeApplyPatchToolCallsOnRequest(merged);
-    // Mixed-tools support: if previous response executed servertools alongside client tools,
-    // inject servertool tool_call + tool_result messages after the client's tool results on next request.
-    merged = await maybeInjectPendingServerToolResultsAfterClientTools(merged, metadata);
-    if (containsImageAttachment(merged.messages)) {
-        if (!merged.metadata) {
-            merged.metadata = {
-                originalEndpoint: request.metadata?.originalEndpoint ?? '/v1/chat/completions'
-            };
-        }
-        merged.metadata.hasImageAttachment = true;
-    }
-    if (typeof inboundStreamIntent === 'boolean') {
-        merged = applyHubOperations(merged, buildInboundStreamingOperations(inboundStreamIntent));
-    }
-    if (typeof governed.stream === 'boolean') {
-        merged = applyHubOperations(merged, buildOutboundStreamingOperations(governed.stream));
-    }
-    if (governed.tool_choice !== undefined) {
-        merged = applyHubOperations(merged, buildToolChoiceOperations(governed.tool_choice));
-    }
-    if (typeof governed.model === 'string' && governed.model.trim()) {
-        merged.model = governed.model.trim();
-    }
-    // Server-side web_search tool injection (config-driven, best-effort).
-    merged = applyHubOperations(merged, buildWebSearchOperations(merged, metadata));
-    // Server-side clock tool + scheduled reminders injection (config-driven, best-effort).
-    merged = applyHubOperations(merged, buildClockOperations(metadata));
-    // Server-side no-op continue tool injection (always-on, lightweight).
-    merged = applyHubOperations(merged, buildContinueExecutionOperations(metadata));
-    merged = injectContinueExecutionDirectiveIntoUserMessage(merged, metadata);
-    merged = await maybeInjectClockRemindersAndApplyDirectives(merged, metadata, context.requestId);
-    const { request: sanitized, summary } = toolGovernanceEngine.governRequest(merged, providerProtocol);
-    if (summary.applied) {
-        sanitized.metadata = {
-            ...sanitized.metadata,
-            toolGovernance: {
-                ...sanitized.metadata?.toolGovernance,
-                request: summary
-            }
-        };
-    }
-    return sanitized;
-}
-function resolveSessionIdForPending(metadata, request) {
-    const candidate = readString(metadata.sessionId) ?? readString(request.metadata?.sessionId);
-    return candidate && candidate.trim() ? candidate.trim() : null;
-}
-function extractToolCallIdsFromToolMessages(messages) {
-    const ids = new Set();
-    for (const msg of messages) {
-        if (!msg || typeof msg !== 'object')
-            continue;
-        if (msg.role !== 'tool')
-            continue;
-        const toolCallId = typeof msg.tool_call_id === 'string'
-            ? String(msg.tool_call_id).trim()
-            : typeof msg.toolCallId === 'string'
-                ? String(msg.toolCallId).trim()
-                : '';
-        if (toolCallId)
-            ids.add(toolCallId);
-    }
-    return ids;
-}
-function findLastToolMessageIndex(messages) {
-    for (let i = messages.length - 1; i >= 0; i -= 1) {
-        const msg = messages[i];
-        if (msg && typeof msg === 'object' && msg.role === 'tool') {
-            return i;
-        }
-    }
-    return -1;
-}
-async function maybeInjectPendingServerToolResultsAfterClientTools(request, metadata) {
-    const sessionId = resolveSessionIdForPending(metadata, request);
-    if (!sessionId) {
-        return request;
-    }
-    const pending = await loadPendingServerToolInjection(sessionId);
-    if (!pending) {
-        return request;
-    }
-    const afterIds = Array.isArray(pending.afterToolCallIds) ? pending.afterToolCallIds : [];
-    if (!afterIds.length) {
-        return request;
-    }
-    const messages = Array.isArray(request.messages) ? request.messages : [];
-    const toolIds = extractToolCallIdsFromToolMessages(messages);
-    const ready = afterIds.every((id) => toolIds.has(id));
-    if (!ready) {
-        return request;
-    }
-    const insertAt = findLastToolMessageIndex(messages);
-    if (insertAt < 0) {
-        return request;
-    }
-    const inject = Array.isArray(pending.messages) ? pending.messages : [];
-    if (!inject.length) {
-        return request;
-    }
-    const nextMessages = messages.slice();
-    nextMessages.splice(insertAt + 1, 0, ...inject);
-    try {
-        await clearPendingServerToolInjection(sessionId);
-    }
-    catch {
-        // best-effort
-    }
-    return { ...request, messages: nextMessages };
-}
-function buildProcessedRequest(request) {
-    const timestamp = Date.now();
-    const streamingEnabled = request.parameters?.stream === true;
-    return {
-        ...request,
-        processed: {
-            timestamp,
-            appliedRules: ['tool-governance'],
-            status: 'success'
-        },
-        processingMetadata: {
-            streaming: {
-                enabled: streamingEnabled,
-                chunkCount: 0
-            },
-            context: buildContextMetadata(request.metadata)
-        }
-    };
-}
-function buildContextMetadata(metadata) {
-    if (!metadata?.capturedContext || typeof metadata.capturedContext !== 'object') {
-        return undefined;
-    }
-    return { ...metadata.capturedContext };
-}
-function buildSuccessResult(startTime, processedRequest) {
-    const endTime = Date.now();
-    return {
-        success: true,
-        metadata: {
-            node: 'hub-chat-process',
-            executionTime: endTime - startTime,
-            startTime,
-            endTime,
-            dataProcessed: {
-                messages: processedRequest.messages.length,
-                tools: processedRequest.tools?.length ?? 0
-            }
-        }
-    };
-}
-function buildErrorResult(startTime, error) {
-    const endTime = Date.now();
-    return {
-        success: false,
-        metadata: {
-            node: 'hub-chat-process',
-            executionTime: endTime - startTime,
-            startTime,
-            endTime
-        },
-        error: {
-            message: error instanceof Error ? error.message : String(error)
-        }
-    };
-}
-function castGovernedTools(tools) {
-    if (!Array.isArray(tools)) {
-        return undefined;
-    }
-    const normalized = [];
-    for (const tool of tools) {
-        const converted = castSingleTool(tool) ?? castCustomTool(tool);
-        if (converted) {
-            normalized.push(converted);
-        }
-    }
-    return normalized.length ? normalized : [];
-}
-function castSingleTool(tool) {
-    if (!isRecord(tool)) {
-        return null;
-    }
-    const fn = tool.function;
-    if (!isRecord(fn) || typeof fn.name !== 'string') {
-        return null;
-    }
-    const parameters = castToolParameters(fn.parameters);
-    const description = typeof fn.description === 'string' ? fn.description : undefined;
-    const strictFlag = fn.strict === true || tool.strict === true;
-    return {
-        type: 'function',
-        function: {
-            name: fn.name,
-            description,
-            parameters,
-            strict: strictFlag ? true : undefined
-        }
-    };
-}
-function stripHistoricalImageAttachments(messages) {
-    if (!Array.isArray(messages) || !messages.length) {
-        return messages;
-    }
-    const placeholderText = '[Image omitted]';
-    const last = messages[messages.length - 1];
-    const lastRole = typeof last?.role === 'string' ? String(last.role) : '';
-    const isNewUserTurn = lastRole === 'user';
-    // 找到最新一条 user 消息：
-    // - 若本轮是 user 输入（最后一条消息 role=user），则仅允许这一条保留图片分段；
-    // - 若本轮是 followup（最后一条消息非 user，例如 tool/assistant），则所有 user 消息的图片都应替换为占位符，
-    //   避免在工具循环/多次 followup 中反复透传大体积图片数据。
-    let latestUserIndex = -1;
-    if (isNewUserTurn) {
-        for (let idx = messages.length - 1; idx >= 0; idx -= 1) {
-            const candidate = messages[idx];
-            if (candidate && typeof candidate === 'object' && candidate.role === 'user') {
-                latestUserIndex = idx;
-                break;
-            }
-        }
-        if (latestUserIndex < 0) {
-            return messages;
-        }
-    }
-    let changed = false;
-    const next = messages.slice();
-    for (let idx = 0; idx < messages.length; idx += 1) {
-        if (isNewUserTurn && idx === latestUserIndex) {
-            continue;
-        }
-        const message = messages[idx];
-        if (!message || typeof message !== 'object') {
-            continue;
-        }
-        if (message.role !== 'user') {
-            continue;
-        }
-        const content = message.content;
-        if (!Array.isArray(content) || !content.length) {
-            continue;
-        }
-        const filtered = [];
-        let removed = false;
-        for (const part of content) {
-            if (part && typeof part === 'object' && !Array.isArray(part)) {
-                const typeValue = part.type;
-                if (typeof typeValue === 'string' && typeValue.toLowerCase().includes('image')) {
-                    removed = true;
-                    filtered.push({ type: 'text', text: placeholderText });
-                    continue;
-                }
-            }
-            filtered.push(part);
-        }
-        if (removed) {
-            const cloned = {
-                ...message,
-                content: filtered
-            };
-            next[idx] = cloned;
-            changed = true;
-        }
-    }
-    return changed ? next : messages;
-}
-function containsImageAttachment(messages) {
-    if (!Array.isArray(messages) || !messages.length) {
-        return false;
-    }
-    // 仅检查“当前这一轮用户输入”（messages 最后一条必须是 user）是否携带图片。
-    // 避免在 tool/assistant followup 请求中，因为历史 user 消息含图片而反复触发 image 标记。
-    const last = messages[messages.length - 1];
-    if (!last || typeof last !== 'object' || Array.isArray(last) || last.role !== 'user') {
-        return false;
-    }
-    const content = last.content;
-    if (!Array.isArray(content)) {
-        return false;
-    }
-    for (const part of content) {
-        if (!part || typeof part !== 'object') {
-            continue;
-        }
-        const typeValue = part.type;
-        if (typeof typeValue !== 'string') {
-            continue;
-        }
-        const normalized = typeValue.toLowerCase();
-        if (!normalized.includes('image')) {
-            continue;
-        }
-        const record = part;
-        let imageCandidate = '';
-        if (typeof record.image_url === 'string') {
-            imageCandidate = record.image_url;
-        }
-        else if (record.image_url && typeof record.image_url.url === 'string') {
-            imageCandidate = record.image_url.url ?? '';
-        }
-        else if (typeof record.url === 'string') {
-            imageCandidate = record.url;
-        }
-        else if (typeof record.uri === 'string') {
-            imageCandidate = record.uri;
-        }
-        else if (typeof record.data === 'string') {
-            imageCandidate = record.data;
-        }
-        if (imageCandidate.trim().length > 0) {
-            return true;
-        }
-    }
-    return false;
-}
-function castCustomTool(tool) {
-    if (!isRecord(tool)) {
-        return null;
-    }
-    const type = typeof tool.type === 'string' ? tool.type.toLowerCase() : '';
-    const name = typeof tool.name === 'string' ? tool.name : '';
-    if (type !== 'custom' || !name) {
-        return null;
-    }
-    if (name.trim() !== 'apply_patch') {
-        return null;
-    }
-    const description = typeof tool.description === 'string' ? tool.description : undefined;
-    return {
-        type: 'function',
-        function: {
-            name: 'apply_patch',
-            description,
-            parameters: ensureApplyPatchSchema(),
-            strict: true
-        }
-    };
-}
-function castToolParameters(value) {
-    if (isRecord(value)) {
-        const cloned = deepClone(value);
-        if (cloned && typeof cloned === 'object' && !Array.isArray(cloned)) {
-            const schema = cloned;
-            if (!('type' in schema)) {
-                schema.type = 'object';
-            }
-            if (!isRecord(schema.properties)) {
-                schema.properties = {};
-            }
-            return schema;
-        }
-    }
-    return {
-        type: 'object',
-        properties: {},
-        additionalProperties: true
-    };
-}
-function normalizeRecord(value) {
-    if (value && typeof value === 'object' && !Array.isArray(value)) {
-        return value;
-    }
-    return {};
-}
-function deepClone(value) {
-    return JSON.parse(JSON.stringify(value));
-}
-function readString(value) {
-    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
-}
-function readToolChoice(value) {
-    if (!value) {
-        return undefined;
-    }
-    if (typeof value === 'string') {
-        return value;
-    }
-    if (typeof value === 'object') {
-        return value;
-    }
-    return undefined;
-}
-function isRecord(value) {
-    return !!value && typeof value === 'object' && !Array.isArray(value);
-}
-function maybeInjectWebSearchTool(request, metadata) {
-    const ops = buildWebSearchOperations(request, metadata);
-    if (!ops.length) {
-        return request;
-    }
-    return applyHubOperations(request, ops);
-}
-function buildInboundStreamingOperations(intent) {
-    return [
-        {
-            op: 'set_request_metadata_fields',
-            fields: { inboundStream: intent }
-        }
-    ];
-}
-function buildOutboundStreamingOperations(stream) {
-    return [
-        {
-            op: 'set_request_parameter_fields',
-            fields: { stream }
-        }
-    ];
-}
-function buildToolChoiceOperations(toolChoice) {
-    return [
-        {
-            op: 'set_request_parameter_fields',
-            fields: { tool_choice: toolChoice }
-        }
-    ];
-}
-function buildWebSearchOperations(request, metadata) {
-    const rt = readRuntimeMetadata(metadata);
-    // ServerTool 二/三跳（serverToolFollowup=true）不再注入 web_search 工具，
-    // 以避免在 web_search 流程内部形成循环命中。
-    if (rt?.serverToolFollowup === true) {
-        return [];
-    }
-    const rawConfig = rt?.webSearch;
-    if (!rawConfig || !Array.isArray(rawConfig.engines) || rawConfig.engines.length === 0) {
-        return [];
-    }
-    const semanticsWebSearch = extractWebSearchSemantics(request.semantics);
-    if (semanticsWebSearch?.disable === true) {
-        return [];
-    }
-    const injectPolicy = semanticsWebSearch?.force === true
-        ? 'always'
-        : rawConfig.injectPolicy === 'always' || rawConfig.injectPolicy === 'selective'
-            ? rawConfig.injectPolicy
-            : 'selective';
-    const intent = detectWebSearchIntent(request);
-    if (injectPolicy === 'selective') {
-        // 仅当当前这一轮用户输入明确表达“联网搜索”意图时才注入 web_search。
-        // 不再依赖上一轮工具分类（read/search/websearch），避免形成隐式续写语义。
-        if (!intent.hasIntent) {
-            return [];
-        }
-    }
-    const existingTools = Array.isArray(request.tools) ? request.tools : [];
-    let engines = rawConfig.engines.filter((engine) => typeof engine?.id === 'string' && !!engine.id.trim() && !engine.serverToolsDisabled);
-    // 当用户明确要求「谷歌搜索」时，只暴露 Gemini / Antigravity 类搜索后端：
-    // - providerKey 以 gemini-cli. 或 antigravity. 开头；
-    // - 或 engine id 中包含 "google"（向前兼容配置中用 id 标识 google 引擎的场景）。
-    if (intent.googlePreferred) {
-        const preferred = engines.filter((engine) => {
-            const id = engine.id.trim().toLowerCase();
-            const providerKey = (engine.providerKey || '').toLowerCase();
-            if (providerKey.startsWith('gemini-cli.') || providerKey.startsWith('antigravity.')) {
-                return true;
-            }
-            if (id.includes('google')) {
-                return true;
-            }
-            return false;
-        });
-        if (preferred.length > 0) {
-            engines = preferred;
-        }
-    }
-    // DeepSeek native search path:
-    // when deepseek web_search engine is configured as top priority,
-    // route directly to deepseek-search model instead of servertool tool injection.
-    if (shouldBypassServerToolWebSearch(intent, engines, semanticsWebSearch)) {
-        return [];
-    }
-    if (!engines.length) {
-        return [];
-    }
-    const engineIds = engines.map((engine) => engine.id.trim());
-    const engineDescriptions = engines
-        .map((engine) => {
-        const id = engine.id.trim();
-        const desc = typeof engine.description === 'string' && engine.description.trim()
-            ? engine.description.trim()
-            : '';
-        return desc ? `${id}: ${desc}` : id;
-    })
-        .join('; ');
-    const parameters = {
-        type: 'object',
-        properties: {
-            engine: {
-                type: 'string',
-                enum: engineIds,
-                description: engineDescriptions
-            },
-            query: {
-                type: 'string',
-                description: 'Search query or user question.'
-            },
-            recency: {
-                type: 'string',
-                enum: ['oneDay', 'oneWeek', 'oneMonth', 'oneYear', 'noLimit'],
-                description: 'Optional recency filter for web search results.'
-            },
-            count: {
-                type: 'integer',
-                minimum: 1,
-                maximum: 50,
-                description: 'Number of results to retrieve.'
-            }
-        },
-        // 对于 Responses 内建 web_search，required 需要覆盖 properties 中的所有字段，
-        // 否则上游会报 "required is required to be supplied and to be an array including every key in properties"。
-        required: ['engine', 'query', 'recency', 'count'],
-        additionalProperties: false
-    };
-    const webSearchTool = {
-        type: 'function',
-        function: {
-            name: 'web_search',
-            description: 'Perform web search using configured search engines. Use this when the user asks for up-to-date information or news.',
-            parameters,
-            strict: true
-        }
-    };
-    const ops = [
-        {
-            op: 'set_request_metadata_fields',
-            fields: { webSearchEnabled: true }
-        }
-    ];
-    ops.push({
-        op: 'append_tool_if_missing',
-        toolName: 'web_search',
-        tool: webSearchTool
-    });
-    return ops;
-}
-function shouldBypassServerToolWebSearch(intent, engines, semanticsWebSearch) {
-    if (!intent.hasIntent || intent.googlePreferred) {
-        return false;
-    }
-    // Explicit semantic force should keep servertool orchestration.
-    if (semanticsWebSearch?.force === true) {
-        return false;
-    }
-    const deepseekIndex = engines.findIndex(isDeepSeekNativeWebSearchEngine);
-    if (deepseekIndex < 0) {
-        return false;
-    }
-    const deepseekEngine = engines[deepseekIndex];
-    // Treat explicit default as highest priority; otherwise require first position.
-    if (deepseekEngine.default !== true && deepseekIndex !== 0) {
-        return false;
-    }
-    return true;
-}
-function isDeepSeekNativeWebSearchEngine(engine) {
-    const id = typeof engine.id === 'string' ? engine.id.trim().toLowerCase() : '';
-    const providerKey = typeof engine.providerKey === 'string' ? engine.providerKey.trim().toLowerCase() : '';
-    if (id === 'deepseek:web_search') {
-        return true;
-    }
-    if (!providerKey.startsWith('deepseek-web.')) {
-        return false;
-    }
-    return providerKey.endsWith('.deepseek-chat-search') || providerKey.endsWith('.deepseek-reasoner-search');
-}
-function buildClockOperations(metadata) {
-    const rt = readRuntimeMetadata(metadata);
-    // Do not inject clock tool into internal servertool followup hops.
-    const allowClockFollowupToolInjection = rt?.clockFollowupInjectTool === true;
-    if (rt?.serverToolFollowup === true && !allowClockFollowupToolInjection) {
-        return [];
-    }
-    const rawConfig = rt?.clock;
-    const clockConfig = resolveClockConfig(rawConfig);
-    if (!clockConfig) {
-        return [];
-    }
-    const sessionId = readString(metadata.sessionId);
-    const hasSessionId = Boolean(sessionId && sessionId.trim());
-    logClock('inject_schema', { hasSessionId });
-    const parameters = {
-        type: 'object',
-        properties: {
-            action: {
-                type: 'string',
-                enum: ['get', 'schedule', 'update', 'list', 'cancel', 'clear'],
-                description: 'Get current time, or schedule/update/list/cancel/clear session-scoped reminders. For any wait/later requirement, schedule immediately.'
-            },
-            items: {
-                type: 'array',
-                description: 'For schedule/update: list of reminder payloads. update uses items[0] as patch source.',
-                items: {
-                    type: 'object',
-                    properties: {
-                        dueAt: {
-                            type: 'string',
-                            description: 'ISO8601 datetime with timezone (e.g. 2026-01-21T20:30:00-08:00).'
-                        },
-                        task: {
-                            type: 'string',
-                            description: 'Reminder text that states the exact action to execute on wake-up (no vague placeholders).'
-                        },
-                        tool: {
-                            type: 'string',
-                            description: 'Optional suggested tool name (hint only).'
-                        },
-                        arguments: {
-                            type: 'string',
-                            description: 'Optional suggested tool arguments as a JSON string (hint only). Use "{}" when unsure.'
-                        }
-                    },
-                    // For strict tool schemas (OpenAI Responses), required must include every key in properties.
-                    // We keep tool/arguments as hints but allow empty string when not used.
-                    required: ['dueAt', 'task', 'tool', 'arguments'],
-                    additionalProperties: false
-                }
-            },
-            taskId: {
-                type: 'string',
-                description: 'For cancel/update: target taskId.'
-            }
-        },
-        // For strict tool schemas (OpenAI Responses), required must include every key in properties.
-        // Fields unused for certain actions can be set to empty string / empty list.
-        required: ['action', 'items', 'taskId'],
-        additionalProperties: false
-    };
-    const clockTool = {
-        type: 'function',
-        function: {
-            name: 'clock',
-            description: 'Time + Alarm for this session. MUST use clock.schedule whenever waiting/delay is required. Never promise to wait without scheduling. Use get/schedule/update/list/cancel/clear. Scheduled reminders are injected into future requests.',
-            parameters,
-            strict: true
-        }
-    };
-    return [
-        {
-            op: 'set_request_metadata_fields',
-            fields: { clockEnabled: true, ...(hasSessionId ? { serverToolRequired: true } : {}) }
-        },
-        { op: 'append_tool_if_missing', toolName: 'clock', tool: clockTool }
-    ];
-}
-function hasActiveStopMessageStateForContinueExecution(metadata) {
-    const rt = readRuntimeMetadata(metadata);
-    if (isStopMessageStateActive(rt?.stopMessageState)) {
-        return true;
-    }
-    return hasPersistedActiveStopMessageState(metadata);
-}
-function hasPersistedActiveStopMessageState(metadata) {
-    const sessionScope = resolveStopMessageSessionScope(metadata);
-    if (!sessionScope) {
-        return false;
-    }
-    try {
-        const persisted = loadRoutingInstructionStateSync(sessionScope);
-        return isStopMessageStateActive(persisted);
-    }
-    catch {
-        return false;
-    }
-}
-function resolveStopMessageSessionScope(metadata) {
-    const sessionId = readString(metadata.sessionId);
-    if (sessionId) {
-        return 'session:' + sessionId;
-    }
-    const conversationId = readString(metadata.conversationId);
-    if (conversationId) {
-        return 'conversation:' + conversationId;
-    }
-    return undefined;
-}
-function isStopMessageStateActive(raw) {
-    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
-        return false;
-    }
-    const record = raw;
-    const text = typeof record.stopMessageText === 'string' ? record.stopMessageText.trim() : '';
-    const maxRepeats = typeof record.stopMessageMaxRepeats === 'number' && Number.isFinite(record.stopMessageMaxRepeats)
-        ? Math.max(1, Math.floor(record.stopMessageMaxRepeats))
-        : 0;
-    const stageMode = typeof record.stopMessageStageMode === 'string' ? record.stopMessageStageMode.trim().toLowerCase() : '';
-    if (stageMode === 'off') {
-        return false;
-    }
-    if (text && maxRepeats > 0) {
-        return true;
-    }
-    return stageMode === 'on' || stageMode === 'auto';
-}
-function buildContinueExecutionOperations(metadata) {
-    const rt = readRuntimeMetadata(metadata);
-    if (rt?.serverToolFollowup === true) {
-        return [];
-    }
-    const sessionId = readString(metadata.sessionId);
-    const hasSessionId = Boolean(sessionId && sessionId.trim());
-    if (hasActiveStopMessageStateForContinueExecution(metadata)) {
-        logContinueExecution('skip_schema_due_stopmessage', { hasSessionId });
-        return [];
-    }
-    logContinueExecution('inject_schema', { hasSessionId });
-    const parameters = {
-        type: 'object',
-        properties: {},
-        required: [],
-        additionalProperties: false
-    };
-    const continueTool = {
-        type: 'function',
-        function: {
-            name: 'continue_execution',
-            description: 'No-op control tool. Use this before status summaries or before ending the turn. If you are about to send finish_reason=stop (or protocol-equivalent end_turn), do not end directly; emit a continue_execution tool call instead. Keep it lightweight. The server will auto-followup so execution continues, avoiding interruption and improving execution efficiency.',
-            parameters,
-            strict: true
-        }
-    };
-    return [
-        {
-            op: 'set_request_metadata_fields',
-            fields: { continueExecutionEnabled: true }
-        },
-        { op: 'append_tool_if_missing', toolName: 'continue_execution', tool: continueTool }
-    ];
-}
-function injectContinueExecutionDirectiveIntoUserMessage(request, metadata) {
-    const rt = readRuntimeMetadata(metadata);
-    if (rt?.serverToolFollowup === true) {
-        return request;
-    }
-    if (hasActiveStopMessageStateForContinueExecution(metadata)) {
-        const sessionId = readString(metadata.sessionId);
-        const hasSessionId = Boolean(sessionId && sessionId.trim());
-        logContinueExecution('skip_user_directive_due_stopmessage', { hasSessionId });
-        return request;
-    }
-    const messages = Array.isArray(request.messages) ? request.messages : [];
-    if (messages.length === 0) {
-        return request;
-    }
-    const hasDirective = messages.some((message) => {
-        if (!message || typeof message !== 'object' || message.role !== 'user') {
-            return false;
-        }
-        return messageContentContainsDirectiveMarker(message.content);
-    });
-    if (hasDirective) {
-        return request;
-    }
-    const lastUserIdx = findLastUserMessageIndex(messages);
-    if (lastUserIdx < 0) {
-        return request;
-    }
-    const nextMessages = messages.slice();
-    const target = nextMessages[lastUserIdx];
-    const nextContent = appendDirectiveToUserContent(target.content, CONTINUE_EXECUTION_SYSTEM_DIRECTIVE);
-    nextMessages[lastUserIdx] = {
-        ...target,
-        content: nextContent
-    };
-    const sessionId = readString(metadata.sessionId);
-    const hasSessionId = Boolean(sessionId && sessionId.trim());
-    logContinueExecution('inject_user_directive', { hasSessionId });
-    return {
-        ...request,
-        messages: nextMessages
-    };
-}
-function messageContentContainsDirectiveMarker(content) {
-    if (typeof content === 'string') {
-        return content.includes(CONTINUE_EXECUTION_SYSTEM_DIRECTIVE_MARKER);
-    }
-    if (!Array.isArray(content)) {
-        return false;
-    }
-    for (const part of content) {
-        if (!part || typeof part !== 'object') {
-            continue;
-        }
-        const text = typeof part.text === 'string' ? String(part.text) : '';
-        if (text.includes(CONTINUE_EXECUTION_SYSTEM_DIRECTIVE_MARKER)) {
-            return true;
-        }
-    }
-    return false;
-}
-function appendDirectiveToUserContent(content, directive) {
-    if (typeof content === 'string') {
-        const base = content.trimEnd();
-        return base.length ? `${base}\n\n${directive}` : directive;
-    }
-    if (!Array.isArray(content)) {
-        return directive;
-    }
-    const next = content.slice();
-    for (let idx = next.length - 1; idx >= 0; idx -= 1) {
-        const part = next[idx];
-        if (!part || typeof part !== 'object' || typeof part.text !== 'string') {
-            continue;
-        }
-        const base = String(part.text).trimEnd();
-        next[idx] = {
-            ...part,
-            text: base.length ? `${base}\n\n${directive}` : directive
-        };
-        return next;
-    }
-    next.push({ type: 'input_text', text: directive });
-    return next;
-}
-function resolveSessionIdForClock(metadata, request) {
-    const requestMetadata = request.metadata && typeof request.metadata === 'object' && !Array.isArray(request.metadata)
-        ? request.metadata
-        : null;
-    return resolveClockSessionScope(metadata, requestMetadata);
-}
-function stripClockClearDirectiveFromText(text) {
-    const pattern = /<\*\*\s*clock\s*:\s*clear\s*\*\*>/gi;
-    const hadClear = pattern.test(text);
-    if (!hadClear) {
-        return { hadClear: false, next: text };
-    }
-    const replaced = text.replace(pattern, '');
-    // Clean up leftover excessive blank lines to keep prompts tidy.
-    const next = replaced.replace(/\n{3,}/g, '\n\n').trim();
-    return { hadClear: true, next };
-}
-function unquoteMarkerToken(value) {
-    const trimmed = String(value || '').trim();
-    if (!trimmed) {
-        return '';
-    }
-    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
-        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
-        return trimmed.slice(1, -1).trim();
-    }
-    return trimmed;
-}
-function parseMarkerRecurrenceKind(raw) {
-    const value = typeof raw === 'string' ? raw.trim().toLowerCase() : '';
-    if (!value) {
-        return undefined;
-    }
-    if (value === 'daily' || value === 'day') {
-        return 'daily';
-    }
-    if (value === 'weekly' || value === 'week') {
-        return 'weekly';
-    }
-    if (value === 'interval' || value === 'every_minutes' || value === 'every-minutes' || value === 'everyminutes') {
-        return 'interval';
-    }
-    return undefined;
-}
-function parseMarkerRecurrence(record) {
-    const recurrenceRaw = record.recurrence ?? record.repeat ?? record.cycle;
-    if (recurrenceRaw === undefined || recurrenceRaw === null || recurrenceRaw === false) {
-        return undefined;
-    }
-    let kind;
-    let everyMinutesRaw;
-    let maxRunsRaw;
-    if (typeof recurrenceRaw === 'string') {
-        kind = parseMarkerRecurrenceKind(recurrenceRaw);
-        everyMinutesRaw = record.everyMinutes;
-        maxRunsRaw = record.maxRuns;
-    }
-    else if (recurrenceRaw && typeof recurrenceRaw === 'object' && !Array.isArray(recurrenceRaw)) {
-        const recurrenceRecord = recurrenceRaw;
-        kind = parseMarkerRecurrenceKind(recurrenceRecord.kind ?? recurrenceRecord.type ?? recurrenceRecord.mode ?? recurrenceRecord.every);
-        everyMinutesRaw = recurrenceRecord.everyMinutes ?? recurrenceRecord.minutes ?? record.everyMinutes;
-        maxRunsRaw = recurrenceRecord.maxRuns ?? record.maxRuns;
-    }
-    if (!kind) {
-        return undefined;
-    }
-    const maxRuns = Number(maxRunsRaw);
-    if (!Number.isFinite(maxRuns) || Math.floor(maxRuns) <= 0) {
-        return undefined;
-    }
-    if (kind === 'interval') {
-        const everyMinutes = Number(everyMinutesRaw);
-        if (!Number.isFinite(everyMinutes) || Math.floor(everyMinutes) <= 0) {
-            return undefined;
-        }
-        return { kind: 'interval', maxRuns: Math.floor(maxRuns), everyMinutes: Math.floor(everyMinutes) };
-    }
-    return { kind, maxRuns: Math.floor(maxRuns) };
-}
-function parseClockScheduleDirectivePayload(payload) {
-    const raw = String(payload || '').trim();
-    if (!raw || /^clear$/i.test(raw)) {
-        return null;
-    }
-    const parseFromRecord = (record) => {
-        const timeRaw = typeof record.time === 'string' ? record.time :
-            typeof record.dueAt === 'string' ? record.dueAt :
-                typeof record.due_at === 'string' ? record.due_at :
-                    '';
-        const messageRaw = typeof record.message === 'string' ? record.message :
-            typeof record.task === 'string' ? record.task :
-                '';
-        const dueAt = String(timeRaw || '').trim();
-        const task = String(messageRaw || '').trim();
-        const dueAtMs = parseDueAtMs(dueAt);
-        if (!dueAtMs || !task) {
-            return null;
-        }
-        const hasRecurrenceRaw = Object.prototype.hasOwnProperty.call(record, 'recurrence')
-            || Object.prototype.hasOwnProperty.call(record, 'repeat')
-            || Object.prototype.hasOwnProperty.call(record, 'cycle');
-        const recurrence = parseMarkerRecurrence(record);
-        if (hasRecurrenceRaw && !recurrence) {
-            return null;
-        }
-        return {
-            dueAtMs,
-            dueAt: new Date(dueAtMs).toISOString(),
-            task,
-            ...(recurrence ? { recurrence } : {})
-        };
-    };
-    try {
-        const parsed = JSON.parse(raw);
-        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-            const fromJson = parseFromRecord(parsed);
-            if (fromJson) {
-                return fromJson;
-            }
-        }
-    }
-    catch {
-        // fall through to loose parser
-    }
-    const loose = /^\{\s*time\s*:\s*([^,}]+)\s*,\s*message\s*:\s*([^}]+)\s*\}$/i.exec(raw);
-    if (!loose) {
-        return null;
-    }
-    const dueAt = unquoteMarkerToken(loose[1]);
-    const task = unquoteMarkerToken(loose[2]);
-    const dueAtMs = parseDueAtMs(dueAt);
-    if (!dueAtMs || !task) {
-        return null;
-    }
-    return {
-        dueAtMs,
-        dueAt: new Date(dueAtMs).toISOString(),
-        task
-    };
-}
-function extractClockScheduleDirectivesFromText(text) {
-    const pattern = /<\*\*\s*clock\s*:\s*([\s\S]*?)\s*\*\*>/gi;
-    const directives = [];
-    const next = String(text || '').replace(pattern, (full, payload) => {
-        const parsed = parseClockScheduleDirectivePayload(String(payload || ''));
-        if (!parsed) {
-            return full;
-        }
-        directives.push(parsed);
-        return '';
-    });
-    return {
-        directives,
-        next: next.replace(/\n{3,}/g, '\n\n').trim()
-    };
-}
-function extractClockScheduleDirectivesFromContent(content) {
-    if (typeof content === 'string') {
-        const result = extractClockScheduleDirectivesFromText(content);
-        return { directives: result.directives, next: result.next };
-    }
-    if (Array.isArray(content)) {
-        const directives = [];
-        const next = content.map((part) => {
-            if (typeof part === 'string') {
-                const result = extractClockScheduleDirectivesFromText(part);
-                if (result.directives.length) {
-                    directives.push(...result.directives);
-                }
-                return result.next;
-            }
-            if (part && typeof part === 'object' && !Array.isArray(part)) {
-                const block = part;
-                const text = typeof block.text === 'string' ? block.text : undefined;
-                if (!text) {
-                    return part;
-                }
-                const result = extractClockScheduleDirectivesFromText(text);
-                if (result.directives.length) {
-                    directives.push(...result.directives);
-                }
-                return { ...block, text: result.next };
-            }
-            return part;
-        });
-        return { directives, next };
-    }
-    return { directives: [], next: content };
-}
-let clockMarkerCallSeq = 0;
-function buildClockMarkerCallId(requestId, index) {
-    clockMarkerCallSeq += 1;
-    const token = String(requestId || 'req').replace(/[^a-zA-Z0-9_-]+/g, '_') || 'req';
-    return `call_clock_marker_${token}_${index + 1}_${clockMarkerCallSeq}`;
-}
-function buildClockMarkerScheduleMessages(requestId, markerIndex, marker, payload) {
-    const callId = buildClockMarkerCallId(requestId, markerIndex);
-    const args = {
-        action: 'schedule',
-        items: [
-            {
-                dueAt: marker.dueAt,
-                task: marker.task,
-                ...(marker.recurrence ? { recurrence: marker.recurrence } : {})
-            }
-        ]
-    };
-    return [
-        {
-            role: 'assistant',
-            content: null,
-            tool_calls: [
-                {
-                    id: callId,
-                    type: 'function',
-                    function: {
-                        name: 'clock',
-                        arguments: JSON.stringify(args)
-                    }
-                }
-            ]
-        },
-        {
-            role: 'tool',
-            tool_call_id: callId,
-            name: 'clock',
-            content: JSON.stringify(payload)
-        }
-    ];
-}
-function stripClockClearDirectiveFromContent(content) {
-    if (typeof content === 'string') {
-        const { hadClear, next } = stripClockClearDirectiveFromText(content);
-        return { hadClear, next };
-    }
-    if (Array.isArray(content)) {
-        let hadClear = false;
-        const next = content.map((part) => {
-            if (typeof part === 'string') {
-                const stripped = stripClockClearDirectiveFromText(part);
-                if (stripped.hadClear)
-                    hadClear = true;
-                return stripped.next;
-            }
-            if (part && typeof part === 'object' && !Array.isArray(part)) {
-                const block = part;
-                const text = typeof block.text === 'string' ? block.text : undefined;
-                if (!text)
-                    return part;
-                const stripped = stripClockClearDirectiveFromText(text);
-                if (stripped.hadClear)
-                    hadClear = true;
-                return { ...block, text: stripped.next };
-            }
-            return part;
-        });
-        return { hadClear, next };
-    }
-    return { hadClear: false, next: content };
-}
-function findLastUserMessageIndex(messages) {
-    if (!Array.isArray(messages) || messages.length === 0) {
-        return -1;
-    }
-    for (let idx = messages.length - 1; idx >= 0; idx -= 1) {
-        const candidate = messages[idx];
-        if (candidate && candidate.role === 'user') {
-            return idx;
-        }
-    }
-    return -1;
-}
-async function maybeInjectClockRemindersAndApplyDirectives(request, metadata, requestId) {
-    const rt = readRuntimeMetadata(metadata);
-    // Do not inject reminders or apply clock directives during internal servertool followup hops.
-    const allowClockFollowupReminderInjection = rt?.clockFollowupInjectReminders === true;
-    if (rt?.serverToolFollowup === true && !allowClockFollowupReminderInjection) {
-        return request;
-    }
-    const rawConfig = rt?.clock;
-    const clockConfig = resolveClockConfig(rawConfig);
-    if (!clockConfig) {
-        return request;
-    }
-    try {
-        await startClockDaemonIfNeeded(clockConfig);
-    }
-    catch {
-        // best-effort
-    }
-    const sessionId = resolveSessionIdForClock(metadata, request);
-    const messages = Array.isArray(request.messages) ? request.messages : [];
-    const lastUserIdx = findLastUserMessageIndex(messages);
-    // 1) Apply <**clock:clear**> directive (latest user message only).
-    let hadClear = false;
-    let clockScheduleDirectives = [];
-    let baseMessages = messages;
-    if (lastUserIdx >= 0) {
-        const lastUser = messages[lastUserIdx];
-        const stripped = stripClockClearDirectiveFromContent(lastUser.content);
-        hadClear = stripped.hadClear;
-        const extracted = extractClockScheduleDirectivesFromContent(stripped.next);
-        clockScheduleDirectives = extracted.directives;
-        if (hadClear || clockScheduleDirectives.length > 0) {
-            baseMessages = messages.slice();
-            baseMessages[lastUserIdx] = { ...lastUser, content: extracted.next };
-        }
-    }
-    if (hadClear) {
-        if (sessionId) {
-            try {
-                await clearClockSession(sessionId);
-                logClock('cleared', { sessionId });
-            }
-            catch {
-                // best-effort: user directive should not crash request
-            }
-        }
-        // Continue: still inject per-request time tag (but skip due reminders).
-    }
-    // 2) Apply private schedule directives: <**clock:{time,message}**>
-    // Convert to actual clock scheduling and append synthetic tool_call/tool_result messages
-    // so downstream model sees canonical tool semantics.
-    let markerToolMessages = [];
-    if (clockScheduleDirectives.length > 0) {
-        for (let index = 0; index < clockScheduleDirectives.length; index += 1) {
-            const marker = clockScheduleDirectives[index];
-            const itemBase = {
-                dueAtMs: marker.dueAtMs,
-                setBy: 'user',
-                task: marker.task,
-                ...(marker.recurrence ? { recurrence: marker.recurrence } : {})
-            };
-            const now = Date.now();
-            const guardedItem = marker.dueAtMs <= now + clockConfig.dueWindowMs
-                ? { ...itemBase, notBeforeRequestId: requestId }
-                : itemBase;
-            if (!sessionId) {
-                markerToolMessages = markerToolMessages.concat(buildClockMarkerScheduleMessages(requestId, index, marker, {
-                    ok: false,
-                    action: 'schedule',
-                    message: 'clock requires session scope (sessionId/conversationId or clockDaemonId).'
-                }));
-                continue;
-            }
-            try {
-                const scheduled = await scheduleClockTasks(sessionId, [guardedItem], clockConfig);
-                markerToolMessages = markerToolMessages.concat(buildClockMarkerScheduleMessages(requestId, index, marker, {
-                    ok: true,
-                    action: 'schedule',
-                    scheduled: scheduled.map((entry) => ({
-                        taskId: entry.taskId,
-                        dueAt: new Date(entry.dueAtMs).toISOString(),
-                        task: entry.task,
-                        deliveryCount: entry.deliveryCount
-                    }))
-                }));
-                logClock('schedule', { sessionId, count: scheduled.length, source: 'marker' });
-            }
-            catch (error) {
-                markerToolMessages = markerToolMessages.concat(buildClockMarkerScheduleMessages(requestId, index, marker, {
-                    ok: false,
-                    action: 'schedule',
-                    message: `clock.schedule failed: ${error instanceof Error ? error.message : String(error ?? 'unknown')}`
-                }));
-            }
-        }
-    }
-    // 3) Inject due reminders as a user message + attach reservation for response-side commit.
-    let reservation = null;
-    let dueInjectText = '';
-    if (!hadClear && sessionId) {
-        try {
-            const reserved = await reserveDueTasksForRequest({
-                reservationId: `${requestId}:clock`,
-                sessionId,
-                config: clockConfig,
-                requestId
-            });
-            reservation = reserved.reservation;
-            dueInjectText = typeof reserved.injectText === 'string' ? reserved.injectText.trim() : '';
-        }
-        catch {
-            // best-effort
-            reservation = null;
-            dueInjectText = '';
-        }
-    }
-    const dueUserMessage = (() => {
-        if (!reservation || !dueInjectText)
-            return null;
-        return {
-            role: 'user',
-            content: [
-                '[Clock Reminder]: scheduled tasks are due.',
-                dueInjectText,
-                'You may call tools to complete these tasks. If the tool list is incomplete, standard tools have been injected. MANDATORY: if waiting is needed, use the clock tool to schedule wake-up (clock.schedule) now; do not only promise to wait.'
-            ].join('\n')
-        };
-    })();
-    // 4) When we have due tasks, ensure a standard tool set is present (best-effort).
-    let nextRequest = request;
-    if (dueUserMessage) {
-        const ensureToolsOps = buildClockStandardToolsOperations();
-        nextRequest = applyHubOperations(nextRequest, ensureToolsOps);
-    }
-    // 5) Per-request time injection (user time tag or paired clock.get tool result).
-    let snapshot = null;
-    try {
-        snapshot = await getClockTimeSnapshot();
-    }
-    catch {
-        snapshot = null;
-    }
-    const timeTagLine = snapshot
-        ? buildTimeTagLine(snapshot)
-        : '[Time/Date]: utc=`1970-01-01T00:00:00.000Z` local=`1970-01-01 00:00:00.000 +00:00` tz=`unknown` nowMs=`0` ntpOffsetMs=`0`';
-    const baseMetadata = nextRequest.metadata && typeof nextRequest.metadata === 'object'
-        ? nextRequest.metadata
-        : {
-            originalEndpoint: readString(metadata.originalEndpoint) ?? '/v1/chat/completions'
-        };
-    const withReservationMetadata = dueUserMessage && reservation
-        ? {
-            ...baseMetadata,
-            __clockReservation: reservation
-        }
-        : baseMetadata;
-    const messagesWithMarkers = markerToolMessages.length > 0
-        ? [...baseMessages, ...markerToolMessages]
-        : baseMessages.slice();
-    const messagesWithDue = dueUserMessage ? [...messagesWithMarkers, dueUserMessage] : messagesWithMarkers;
-    // Always inject time via user-role content to keep the tag visible without adding
-    // extra tool-call semantics that may distract the model.
-    //
-    // IMPORTANT: do not append an extra trailing user message, otherwise the Virtual Router
-    // sees `latestMessageFromUser=true` and will force "thinking:user-input" even during
-    // tool followups (last message role=tool), which breaks `coding/search/tools` routing.
-    const timeInjectedMessages = (() => {
-        const idx = findLastUserMessageIndex(messagesWithDue);
-        if (idx < 0) {
-            return [...messagesWithDue, { role: 'user', content: timeTagLine }];
-        }
-        const msg = messagesWithDue[idx];
-        const content = msg.content;
-        const nextContent = (() => {
-            if (typeof content === 'string') {
-                const base = content.trimEnd();
-                return base ? `${base}\n${timeTagLine}` : timeTagLine;
-            }
-            if (Array.isArray(content)) {
-                return [...content, timeTagLine];
-            }
-            return timeTagLine;
-        })();
-        const cloned = messagesWithDue.slice();
-        cloned[idx] = { ...msg, content: nextContent };
-        return cloned;
-    })();
-    return {
-        ...nextRequest,
-        messages: timeInjectedMessages,
-        metadata: withReservationMetadata
-    };
-}
-function buildClockStandardToolsOperations() {
-    const tools = [
-        {
-            type: 'function',
-            function: {
-                name: 'clock',
-                description: 'Time + Alarm for this session. Use schedule/update/list/cancel/clear. For any wait requirement, call clock.schedule now.',
-                parameters: {
-                    type: 'object',
-                    properties: {
-                        action: {
-                            type: 'string',
-                            enum: ['get', 'schedule', 'update', 'list', 'cancel', 'clear']
-                        },
-                        items: {
-                            type: 'array',
-                            items: {
-                                type: 'object',
-                                properties: {
-                                    dueAt: { type: 'string' },
-                                    task: { type: 'string' },
-                                    tool: { type: 'string' },
-                                    arguments: { type: 'string' }
-                                },
-                                required: ['dueAt', 'task', 'tool', 'arguments'],
-                                additionalProperties: false
-                            }
-                        },
-                        taskId: { type: 'string' }
-                    },
-                    required: ['action', 'items', 'taskId'],
-                    additionalProperties: false
-                }
-            }
-        },
-        {
-            type: 'function',
-            function: {
-                name: 'shell',
-                description: 'Runs a shell command and returns its output.',
-                parameters: {
-                    type: 'object',
-                    properties: {
-                        command: { oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }] },
-                        workdir: { type: 'string' }
-                    },
-                    required: ['command'],
-                    additionalProperties: false
-                }
-            }
-        },
-        {
-            type: 'function',
-            function: {
-                name: 'exec_command',
-                description: 'Execute a command in a PTY and return output.',
-                parameters: {
-                    type: 'object',
-                    properties: {
-                        cmd: { type: 'string' },
-                        workdir: { type: 'string' },
-                        timeout_ms: { type: 'number' },
-                        max_output_tokens: { type: 'number' },
-                        yield_time_ms: { type: 'number' }
-                    },
-                    required: ['cmd'],
-                    additionalProperties: false
-                }
-            }
-        },
-        {
-            type: 'function',
-            function: {
-                name: 'apply_patch',
-                description: 'Apply a patch to repository files.',
-                parameters: {
-                    type: 'object',
-                    properties: {
-                        patch: { type: 'string' }
-                    },
-                    required: ['patch'],
-                    additionalProperties: false
-                }
-            }
-        },
-        {
-            type: 'function',
-            function: {
-                name: 'update_plan',
-                description: 'Update the task plan.',
-                parameters: {
-                    type: 'object',
-                    properties: {
-                        explanation: { type: 'string' },
-                        plan: {
-                            type: 'array',
-                            items: {
-                                type: 'object',
-                                properties: {
-                                    step: { type: 'string' },
-                                    status: { type: 'string' }
-                                },
-                                required: ['step', 'status'],
-                                additionalProperties: false
-                            }
-                        }
-                    },
-                    required: ['plan'],
-                    additionalProperties: false
-                }
-            }
-        },
-        {
-            type: 'function',
-            function: {
-                name: 'view_image',
-                description: 'View a local image by file path.',
-                parameters: {
-                    type: 'object',
-                    properties: {
-                        path: { type: 'string' }
-                    },
-                    required: ['path'],
-                    additionalProperties: false
-                }
-            }
-        },
-        {
-            type: 'function',
-            function: {
-                name: 'list_mcp_resources',
-                description: 'List resources exposed by MCP servers.',
-                parameters: {
-                    type: 'object',
-                    properties: {
-                        server: { type: 'string' },
-                        filter: { type: 'string' },
-                        root: { type: 'string' }
-                    },
-                    additionalProperties: false
-                }
-            }
-        },
-        {
-            type: 'function',
-            function: {
-                name: 'list_mcp_resource_templates',
-                description: 'List resource templates exposed by MCP servers.',
-                parameters: {
-                    type: 'object',
-                    properties: {
-                        server: { type: 'string' },
-                        cursor: { type: 'string' }
-                    },
-                    additionalProperties: false
-                }
-            }
-        },
-        {
-            type: 'function',
-            function: {
-                name: 'read_mcp_resource',
-                description: 'Read a specific MCP resource by { server, uri }.',
-                parameters: {
-                    type: 'object',
-                    properties: {
-                        server: { type: 'string' },
-                        uri: { type: 'string' }
-                    },
-                    required: ['server', 'uri'],
-                    additionalProperties: false
-                }
-            }
-        }
-    ];
-    return tools.map((tool) => ({
-        op: 'append_tool_if_missing',
-        toolName: tool.function.name,
-        tool
-    }));
-}
-function extractWebSearchSemantics(semantics) {
-    if (!semantics || typeof semantics !== 'object') {
-        return undefined;
-    }
-    const extras = semantics.providerExtras;
-    if (!extras || !isJsonObject(extras)) {
-        return undefined;
-    }
-    const hint = extras.webSearch;
-    if (typeof hint === 'boolean') {
-        return hint ? { force: true } : { disable: true };
-    }
-    if (isJsonObject(hint)) {
-        const normalized = {};
-        if (hint.force === true) {
-            normalized.force = true;
-        }
-        if (hint.disable === true) {
-            normalized.disable = true;
-        }
-        return Object.keys(normalized).length ? normalized : undefined;
-    }
-    return undefined;
-}
-function detectWebSearchIntent(request) {
-    const messages = Array.isArray(request.messages) ? request.messages : [];
-    if (!messages.length) {
-        return { hasIntent: false, googlePreferred: false };
-    }
-    // 仅使用“当前请求最后一条消息且角色为 user”的文本判断 web_search 意图：
-    // - 不读取系统提示词（system/developer）。
-    // - 不读取历史 user 消息（避免历史上下文误触发）。
-    const lastMessage = messages[messages.length - 1];
-    if (!lastMessage || lastMessage.role !== 'user') {
-        return { hasIntent: false, googlePreferred: false };
-    }
-    // 支持多模态 content：既可能是纯文本字符串，也可能是带 image_url 的分段数组。
-    let content = '';
-    if (typeof lastMessage.content === 'string') {
-        content = lastMessage.content;
-    }
-    else if (Array.isArray(lastMessage.content)) {
-        const parts = lastMessage.content;
-        const texts = [];
-        for (const part of parts) {
-            if (typeof part === 'string') {
-                texts.push(part);
-            }
-            else if (part && typeof part === 'object') {
-                const maybeText = part.text;
-                if (typeof maybeText === 'string' && maybeText.trim()) {
-                    texts.push(maybeText);
-                }
-            }
-        }
-        content = texts.join('\n');
-    }
-    if (!content) {
-        return { hasIntent: false, googlePreferred: false };
-    }
-    // Hard 100% keywords (中文)：明确说明“谷歌搜索 / 谷歌一下 / 百度一下”均视为搜索意图。
-    // 其中“谷歌搜索 / 谷歌一下”会偏向 Google/Gemini 搜索后端。
-    const zh = content;
-    const hasGoogleExplicit = zh.includes('谷歌搜索') ||
-        zh.includes('谷歌一下');
-    const hasBaiduExplicit = zh.includes('百度一下');
-    if (hasGoogleExplicit || hasBaiduExplicit) {
-        // 谷歌 / 百度关键字都会优先尝试走“谷歌搜索”引擎；
-        // 只有在 Virtual Router 未配置任何谷歌相关 engine 时，才回退为普通联网搜索。
-        return {
-            hasIntent: true,
-            googlePreferred: true
-        };
-    }
-    // English intent: simple substring match on lowercased text.
-    const text = content.toLowerCase();
-    // 1) Direct patterns like "web search" / "internet search" / "/search".
-    const englishDirect = [
-        'web search',
-        'web_search',
-        'websearch',
-        'internet search',
-        'search the web',
-        'web-search',
-        'internet-search',
-        '/search'
-    ];
-    if (englishDirect.some((keyword) => text.includes(keyword))) {
-        return { hasIntent: true, googlePreferred: text.includes('google') };
-    }
-    // 2) Verb + noun combinations, similar to the Chinese rule:
-    //    - verb: search / find / look up / look for / google
-    //    - noun: web / internet / online / news / information / info / report / reports / article / articles
-    const verbTokensEn = ['search', 'find', 'look up', 'look for', 'google'];
-    const nounTokensEn = [
-        'web',
-        'internet',
-        'online',
-        'news',
-        'information',
-        'info',
-        'report',
-        'reports',
-        'article',
-        'articles'
-    ];
-    const hasVerbEn = verbTokensEn.some((token) => text.includes(token));
-    const hasNounEn = nounTokensEn.some((token) => text.includes(token));
-    if (hasVerbEn && hasNounEn) {
-        return { hasIntent: true, googlePreferred: text.includes('google') };
-    }
-    // 中文规则：
-    // 1. 只要文本中包含“上网”，直接命中（例如“帮我上网看看今天的新闻”）。
-    // 2. 否则，如果同时包含「搜索/查找/搜」中的任意一个动词 + 「网络/联网/新闻/信息/报道」中的任意一个名词，也判定为联网搜索意图。
-    const chineseText = content; // 中文大小写不敏感，这里直接用原文。
-    if (chineseText.includes('上网')) {
-        return { hasIntent: true, googlePreferred: false };
-    }
-    const verbTokens = ['搜索', '查找', '搜'];
-    const nounTokens = ['网络', '联网', '新闻', '信息', '报道'];
-    const hasVerb = verbTokens.some((token) => chineseText.includes(token));
-    const hasNoun = nounTokens.some((token) => chineseText.includes(token));
-    if (hasVerb && hasNoun) {
-        return { hasIntent: true, googlePreferred: false };
-    }
-    return { hasIntent: false, googlePreferred: false };
-}