@yfwu2020/dsh-selection-explain 0.12.0 → 0.13.1

package/lib/host/analyze-tools.js

@@ -0,0 +1,79 @@
+import { MATERIAL_TOOL } from './chat-materials.js';
+import { name } from './constants.js';
+import { sessionIdOf } from './context.js';
+import { FS_TOOL_NAMES, resolveToolNames, webFetchUsable } from './tools.js';
+/** Resolve session scope, allowed tools, fetch availability and filesystem boundary. */
+export async function planAnalyzeTools(deps, request) {
+    const { ctx, config, sessions } = deps;
+    const { body, isChat, history } = request;
+    // 可用工具（白名单，默认只有联网搜索/抓取）：交给模型自己决定要不要用。
+    // 注意工具是「按会话作用域」注册的（全局视图里看不到 web_search 等），
+    // 所以要拿该会话的 agent 当 scope 去查，并把同一个 agent 传给 execute。
+    const agents = ctx.get('agents');
+    const sessionId = sessionIdOf(body);
+    let agent = sessionId ? agents?.get?.(sessionId) : undefined;
+    let agentScope = agent ? 'session' : '';
+    if (!agent) {
+        // 回退：本会话还没起 agent（刚开的新会话／agent 已释放）时，用任一活跃 agent 当作用域。
+        // 不这么做的话，session-scoped 的 web_search/web_fetch 在全局视图里根本不可见 →
+        // 工具静默为空，模型还会把工具调用当正文吐出来（实测见过 <ds_safety_tool_call>）。
+        const live = agents?.list?.() ?? [];
+        if (live.length > 0) {
+            agent = live[0];
+            agentScope = 'fallback';
+        }
+    }
+    const toolSchemas = [];
+    /** 诊断：这一轮是不是走了"备用联网工具"（首选联网工具一个都不在）。 */
+    let toolFallbackUsed = false;
+    if (config.tools && config.maxToolRounds > 0) {
+        const registry = ctx.get('tools');
+        const split = (value) => value.split(',').map((item) => item.trim()).filter((item) => item.length > 0);
+        let visible = [];
+        try {
+            visible = registry?.schemas?.(agent) ?? [];
+        }
+        catch (error) {
+            ctx.logger?.warn?.(`[${name}] 读取工具表失败：${String(error?.message ?? error)}`);
+        }
+        const allowed = resolveToolNames(split(config.toolNames), split(config.fallbackToolNames), visible.map((schema) => schema.name));
+        toolFallbackUsed = !allowed.includes('advanced_search') && !allowed.includes('platform_search');
+        for (const schema of visible) {
+            if (allowed.includes(schema.name))
+                toolSchemas.push(schema);
+        }
+    }
+    // 本机抓不了网页（fake-IP 代理 / SSRF 防护）时，把 web_fetch 摘掉：
+    // 否则模型每次都要白跑一轮（5~15s）才拿到"resolves to a non-public IP address"。
+    let fetchBlockedSample = '';
+    if (toolSchemas.some((schema) => schema.name === 'web_fetch')) {
+        const probe = await webFetchUsable();
+        if (!probe.usable) {
+            fetchBlockedSample = probe.sample;
+            for (let i = toolSchemas.length - 1; i >= 0; i -= 1) {
+                if (toolSchemas[i]?.name === 'web_fetch')
+                    toolSchemas.splice(i, 1);
+            }
+            ctx.logger?.warn?.(`[${name}] 网页抓取不可用（域名解析到 ${probe.sample}，属保留地址段），已从工具表移除 web_fetch`);
+        }
+    }
+    if (isChat && config.tools && config.maxToolRounds > 0 && (history.rawHistory.length > 0 || history.catalog.length > 0 || history.contextState.through > 0)) {
+        toolSchemas.push(MATERIAL_TOOL);
+    }
+    // 文件类工具的边界：默认只允许会话工作目录；'*' = 不限制；配置了具体目录就用它。
+    // 拿不到工作目录时**不设限**（否则新会话里 read 直接全废），但会打日志说明。
+    const wantsFsTools = toolSchemas.some((schema) => FS_TOOL_NAMES.includes(schema.name));
+    let readRoot = '';
+    if (wantsFsTools) {
+        if (config.toolReadRoot === '*') {
+            readRoot = '';
+        }
+        else {
+            readRoot = config.toolReadRoot || (await sessions.resolveSessionCwd(sessionIdOf(body))) || '';
+            if (!readRoot)
+                ctx.logger?.warn?.(`[${name}] 拿不到会话工作目录，文件工具本次不设边界`);
+        }
+    }
+    return { agent, agentScope, sessionId, toolSchemas, toolFallbackUsed, fetchBlockedSample, wantsFsTools, readRoot };
+}
+//# sourceMappingURL=analyze-tools.js.map

package/lib/host/analyze-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-tools.js","sourceRoot":"","sources":["../../src/host/analyze-tools.ts"],"names":[],"mappings":"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"}

package/lib/host/analyze-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analyze-types.js.map

package/lib/host/analyze-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-types.js","sourceRoot":"","sources":["../../src/host/analyze-types.ts"],"names":[],"mappings":""}