@zhin.js/agent 0.1.14 → 0.1.16

package/lib/builtin/todo-read-tool.js

@@ -0,0 +1,56 @@
+/**
+ * todo_read — 读取当前任务计划列表（BuiltinBaseTool）
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { errMsg } from '../discovery/utils.js';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+export const TODO_READ_PARAMETERS = {
+    type: 'object',
+    properties: {
+        chat_id: {
+            type: 'string',
+            description: '聊天范围（传 "global" 表示全局，或传具体聊天 ID）',
+        },
+    },
+    required: ['chat_id'],
+};
+export class TodoReadBuiltinTool extends BuiltinBaseTool {
+    dataDir;
+    name = 'todo_read';
+    description = '读取当前任务计划列表，用于查看进度和待办事项';
+    parameters = TODO_READ_PARAMETERS;
+    kind = 'plan';
+    constructor(dataDir) {
+        super();
+        this.dataDir = dataDir;
+        this.tags.push('plan', 'todo');
+        this.keywords.push('任务', '计划', '进度', 'todo', '待办');
+    }
+    async run(args, _context) {
+        try {
+            const chatId = args.chat_id;
+            const dir = chatId && chatId !== 'global'
+                ? path.join(this.dataDir, 'groups', chatId)
+                : this.dataDir;
+            const todoPath = path.join(dir, 'TODO.json');
+            if (!fs.existsSync(todoPath))
+                return 'No tasks found. Use todo_write to create a plan.';
+            const data = JSON.parse(await fs.promises.readFile(todoPath, 'utf-8'));
+            if (!data.items || data.items.length === 0)
+                return 'Task list is empty.';
+            const lines = data.items.map((item, i) => {
+                const status = item.status === 'done' ? '✅' : item.status === 'in-progress' ? '🔄' : '⬜';
+                return `${status} ${i + 1}. ${item.title}${item.detail ? ' — ' + item.detail : ''}`;
+            });
+            return `📋 Tasks (${data.items.filter((i) => i.status === 'done').length}/${data.items.length} done):\n${lines.join('\n')}`;
+        }
+        catch (e) {
+            return `Error: ${errMsg(e)}`;
+        }
+    }
+}
+export function createTodoReadTool(dataDir) {
+    return new TodoReadBuiltinTool(dataDir).toTool();
+}
+//# sourceMappingURL=todo-read-tool.js.map

package/lib/builtin/todo-read-tool.js.map

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

package/lib/builtin/todo-write-tool.d.ts

@@ -0,0 +1,14 @@
+import type { Tool, ToolContext, ToolParametersSchema, ToolResult } from '@zhin.js/core';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+export declare const TODO_WRITE_PARAMETERS: ToolParametersSchema;
+export declare class TodoWriteBuiltinTool extends BuiltinBaseTool {
+    private readonly dataDir;
+    readonly name = "todo_write";
+    readonly description = "\u521B\u5EFA\u6216\u66F4\u65B0\u4EFB\u52A1\u8BA1\u5212\uFF0C\u7528\u4E8E\u5206\u89E3\u590D\u6742\u4EFB\u52A1\u5E76\u8DDF\u8E2A\u8FDB\u5EA6";
+    readonly parameters: ToolParametersSchema<Record<string, any>>;
+    readonly kind = "plan";
+    constructor(dataDir: string);
+    run(args: Record<string, unknown>, _context?: ToolContext): Promise<ToolResult>;
+}
+export declare function createTodoWriteTool(dataDir: string): Tool;
+//# sourceMappingURL=todo-write-tool.d.ts.map

package/lib/builtin/todo-write-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-write-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/todo-write-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,qBAAqB,EAAE,oBAanC,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,eAAe;IAM3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,gJAA6B;IACjD,QAAQ,CAAC,UAAU,4CAAyB;IAC5C,QAAQ,CAAC,IAAI,UAAU;gBAEM,OAAO,EAAE,MAAM;IAMtC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAetF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzD"}

package/lib/builtin/todo-write-tool.js

@@ -0,0 +1,54 @@
+/**
+ * todo_write — 创建或更新任务计划（BuiltinBaseTool）
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { errMsg } from '../discovery/utils.js';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+export const TODO_WRITE_PARAMETERS = {
+    type: 'object',
+    properties: {
+        items: {
+            type: 'array',
+            description: '任务列表 [{title, detail?, status: pending|in-progress|done}]',
+        },
+        chat_id: {
+            type: 'string',
+            description: '聊天范围（可选）',
+        },
+    },
+    required: ['items'],
+};
+export class TodoWriteBuiltinTool extends BuiltinBaseTool {
+    dataDir;
+    name = 'todo_write';
+    description = '创建或更新任务计划，用于分解复杂任务并跟踪进度';
+    parameters = TODO_WRITE_PARAMETERS;
+    kind = 'plan';
+    constructor(dataDir) {
+        super();
+        this.dataDir = dataDir;
+        this.tags.push('plan', 'todo');
+        this.keywords.push('创建计划', '更新任务', '标记完成', 'todo');
+    }
+    async run(args, _context) {
+        try {
+            const chatId = args.chat_id;
+            const dir = chatId ? path.join(this.dataDir, 'groups', chatId) : this.dataDir;
+            const todoPath = path.join(dir, 'TODO.json');
+            await fs.mkdir(path.dirname(todoPath), { recursive: true });
+            const items = args.items;
+            const data = { updated_at: new Date().toISOString(), items };
+            await fs.writeFile(todoPath, JSON.stringify(data, null, 2), 'utf-8');
+            const done = items.filter((i) => i.status === 'done').length;
+            return `✅ Tasks updated (${done}/${items.length} done)`;
+        }
+        catch (e) {
+            return `Error: ${errMsg(e)}`;
+        }
+    }
+}
+export function createTodoWriteTool(dataDir) {
+    return new TodoWriteBuiltinTool(dataDir).toTool();
+}
+//# sourceMappingURL=todo-write-tool.js.map

package/lib/builtin/todo-write-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-write-tool.js","sourceRoot":"","sources":["../../src/builtin/todo-write-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,CAAC,MAAM,qBAAqB,GAAyB;IACzD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,2DAA2D;SACzE;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,UAAU;SACxB;KACF;IACD,QAAQ,EAAE,CAAC,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAM1B;IALpB,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,yBAAyB,CAAC;IACxC,UAAU,GAAG,qBAAqB,CAAC;IACnC,IAAI,GAAG,MAAM,CAAC;IAEvB,YAA6B,OAAe;QAC1C,KAAK,EAAE,CAAC;QADmB,YAAO,GAAP,OAAO,CAAQ;QAE1C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,QAAsB;QAC7D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;YAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;YACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAC7C,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAc,CAAC;YAClC,MAAM,IAAI,GAAG,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC;YAC7D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;YAClE,OAAO,oBAAoB,IAAI,IAAI,KAAK,CAAC,MAAM,QAAQ,CAAC;QAC1D,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,UAAU,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;AACpD,CAAC"}

package/lib/builtin/web-fetch-tool.d.ts

@@ -0,0 +1,19 @@
+/**
+ * web_fetch — HTTP(S) 抓取、SSRF 防护、HTML 去标签与长度截断
+ */
+import type { Tool, ToolContext, ToolParametersSchema, ToolResult } from '@zhin.js/core';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+export declare const WEB_FETCH_DEFAULT_MAX_LENGTH: number;
+export declare const WEB_FETCH_PARAMETERS: ToolParametersSchema;
+/** 与原先 builtin-tools 中 web_fetch 一致的正文提取链 */
+export declare function stripFetchedHtmlToText(html: string): string;
+export declare class WebFetchBuiltinTool extends BuiltinBaseTool {
+    readonly name = "web_fetch";
+    readonly description = "\u6293\u53D6\u6307\u5B9A URL \u7684\u7F51\u9875\u5185\u5BB9\u5E76\u63D0\u53D6\u6B63\u6587\uFF08\u53BB\u9664\u5E7F\u544A\u3001\u811A\u672C\u7B49\uFF09\uFF0C\u8FD4\u56DE\u53EF\u8BFB\u6587\u672C\u3002\u4EC5\u652F\u6301 http/https \u534F\u8BAE\u3002";
+    readonly parameters: ToolParametersSchema<Record<string, any>>;
+    readonly kind = "web";
+    constructor();
+    run(args: Record<string, unknown>, _context?: ToolContext): Promise<ToolResult>;
+}
+export declare function createWebFetchTool(): Tool;
+//# sourceMappingURL=web-fetch-tool.d.ts.map

package/lib/builtin/web-fetch-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/web-fetch-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,eAAO,MAAM,4BAA4B,QAAY,CAAC;AAEtD,eAAO,MAAM,oBAAoB,EAAE,oBAOlC,CAAC;AAEF,6CAA6C;AAC7C,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiB3D;AAgBD,qBAAa,mBAAoB,SAAQ,eAAe;IACtD,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,2PACwC;IAC5D,QAAQ,CAAC,UAAU,4CAAwB;IAC3C,QAAQ,CAAC,IAAI,SAAS;;IAiBhB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA8BtF;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/lib/builtin/web-fetch-tool.js

@@ -0,0 +1,89 @@
+import { errMsg } from '../discovery/utils.js';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+import { WEB_TOOL_FETCH_TIMEOUT_MS, ZHIN_WEB_USER_AGENT } from './web-tool-utils.js';
+export const WEB_FETCH_DEFAULT_MAX_LENGTH = 20 * 1024;
+export const WEB_FETCH_PARAMETERS = {
+    type: 'object',
+    properties: {
+        url: { type: 'string', description: '要抓取的完整 URL（需 http 或 https）' },
+        max_length: { type: 'number', description: '最大返回字符数（默认 20480）' },
+    },
+    required: ['url'],
+};
+/** 与原先 builtin-tools 中 web_fetch 一致的正文提取链 */
+export function stripFetchedHtmlToText(html) {
+    return html
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
+        .replace(/<nav[^>]*>[\s\S]*?<\/nav>/gi, '')
+        .replace(/<footer[^>]*>[\s\S]*?<\/footer>/gi, '')
+        .replace(/<header[^>]*>[\s\S]*?<\/header>/gi, ' ')
+        .replace(/<form[^>]*>[\s\S]*?<\/form>/gi, '')
+        .replace(/<!--[\s\S]*?-->/g, '')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;/gi, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function isBlockedSsrfHostname(hostname) {
+    const h = hostname.toLowerCase();
+    return (h === 'localhost' ||
+        h === '127.0.0.1' ||
+        h === '::1' ||
+        h === '0.0.0.0' ||
+        h.endsWith('.local') ||
+        h.startsWith('10.') ||
+        h.startsWith('192.168.') ||
+        /^172\.(1[6-9]|2\d|3[01])\./.test(h));
+}
+export class WebFetchBuiltinTool extends BuiltinBaseTool {
+    name = 'web_fetch';
+    description = '抓取指定 URL 的网页内容并提取正文（去除广告、脚本等），返回可读文本。仅支持 http/https 协议。';
+    parameters = WEB_FETCH_PARAMETERS;
+    kind = 'web';
+    constructor() {
+        super();
+        this.tags.push('web', 'fetch');
+        this.keywords.push('抓取网页', '打开链接', '获取网页', '读网页', 'fetch', 'url', '链接内容', '网页内容');
+    }
+    async run(args, _context) {
+        try {
+            let parsedUrl;
+            try {
+                parsedUrl = new URL(String(args.url ?? ''));
+            }
+            catch {
+                return `Error: 无效的 URL 格式`;
+            }
+            if (parsedUrl.protocol !== 'http:' && parsedUrl.protocol !== 'https:') {
+                return `Error: 仅支持 http/https 协议，拒绝 ${parsedUrl.protocol}`;
+            }
+            const hostname = parsedUrl.hostname.toLowerCase();
+            if (isBlockedSsrfHostname(hostname)) {
+                return `Error: 禁止访问内网地址 ${hostname}（SSRF 防护）`;
+            }
+            const response = await fetch(String(args.url ?? ''), {
+                headers: { 'User-Agent': ZHIN_WEB_USER_AGENT },
+                signal: AbortSignal.timeout(WEB_TOOL_FETCH_TIMEOUT_MS),
+                redirect: 'follow',
+            });
+            if (!response.ok)
+                return `HTTP ${response.status}: ${response.statusText}`;
+            const html = await response.text();
+            const text = stripFetchedHtmlToText(html);
+            const maxLen = typeof args.max_length === 'number' ? args.max_length : WEB_FETCH_DEFAULT_MAX_LENGTH;
+            return text.length > maxLen ? text.slice(0, maxLen) + '\n...(truncated)' : text;
+        }
+        catch (e) {
+            return `Error: ${errMsg(e)}`;
+        }
+    }
+}
+export function createWebFetchTool() {
+    return new WebFetchBuiltinTool().toTool();
+}
+//# sourceMappingURL=web-fetch-tool.js.map

package/lib/builtin/web-fetch-tool.js.map

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

package/lib/builtin/web-search-locale.d.ts

@@ -0,0 +1,16 @@
+/**
+ * web_search 的 Bing 市场/语言：优先 ToolContext.extra，其次用户档案，默认中文。
+ */
+import type { ToolContext } from '@zhin.js/core';
+/** 写入 ToolContext.extra 的键（集成方也可直接设置以覆盖档案） */
+export declare const WEB_SEARCH_LOCALE_EXTRA_KEY: "web_search_locale";
+/** 无用户设置时的 Bing setmkt / 界面语言 */
+export declare const DEFAULT_WEB_SEARCH_MARKET = "zh-CN";
+/**
+ * 将 user_profile 中的自然语言或简写规范为 `xx-YY`（Bing setmkt 常用形式）。
+ */
+export declare function normalizeWebSearchLocaleHint(raw: string): string;
+/** 随 Bing 市场生成 Accept-Language，与 setmkt 一致 */
+export declare function acceptLanguageForMarket(market: string): string;
+export declare function resolveWebSearchMarketFromContext(context?: ToolContext): string;
+//# sourceMappingURL=web-search-locale.d.ts.map

package/lib/builtin/web-search-locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search-locale.d.ts","sourceRoot":"","sources":["../../src/builtin/web-search-locale.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,8CAA8C;AAC9C,eAAO,MAAM,2BAA2B,EAAG,mBAA4B,CAAC;AAExE,iCAAiC;AACjC,eAAO,MAAM,yBAAyB,UAAU,CAAC;AAEjD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgDhE;AAED,8CAA8C;AAC9C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAED,wBAAgB,iCAAiC,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAM/E"}

package/lib/builtin/web-search-locale.js

@@ -0,0 +1,73 @@
+/** 写入 ToolContext.extra 的键（集成方也可直接设置以覆盖档案） */
+export const WEB_SEARCH_LOCALE_EXTRA_KEY = 'web_search_locale';
+/** 无用户设置时的 Bing setmkt / 界面语言 */
+export const DEFAULT_WEB_SEARCH_MARKET = 'zh-CN';
+/**
+ * 将 user_profile 中的自然语言或简写规范为 `xx-YY`（Bing setmkt 常用形式）。
+ */
+export function normalizeWebSearchLocaleHint(raw) {
+    const s = raw.trim().replace(/_/g, '-');
+    if (!s)
+        return DEFAULT_WEB_SEARCH_MARKET;
+    const lower = s.toLowerCase();
+    const aliases = {
+        中文: 'zh-CN',
+        简体: 'zh-CN',
+        简体中文: 'zh-CN',
+        繁体: 'zh-TW',
+        繁中: 'zh-TW',
+        繁體中文: 'zh-TW',
+        english: 'en-US',
+        英文: 'en-US',
+        英語: 'en-US',
+        ja: 'ja-JP',
+        日语: 'ja-JP',
+        日本語: 'ja-JP',
+        ko: 'ko-KR',
+        韩语: 'ko-KR',
+        한국어: 'ko-KR',
+        de: 'de-DE',
+        fr: 'fr-FR',
+        es: 'es-ES',
+        zh: 'zh-CN',
+        en: 'en-US',
+    };
+    if (aliases[lower])
+        return aliases[lower];
+    if (/^[a-z]{2}-[a-z]{2}$/i.test(s)) {
+        const [a, b] = s.split('-');
+        return `${a.toLowerCase()}-${b.toUpperCase()}`;
+    }
+    if (/^[a-z]{2}$/i.test(s)) {
+        const two = lower;
+        const byTwo = {
+            zh: 'zh-CN',
+            en: 'en-US',
+            ja: 'ja-JP',
+            ko: 'ko-KR',
+            de: 'de-DE',
+            fr: 'fr-FR',
+            es: 'es-ES',
+        };
+        return byTwo[two] ?? `${two}-${two.toUpperCase()}`;
+    }
+    return DEFAULT_WEB_SEARCH_MARKET;
+}
+/** 随 Bing 市场生成 Accept-Language，与 setmkt 一致 */
+export function acceptLanguageForMarket(market) {
+    const m = market.trim();
+    const parts = m.split('-');
+    if (parts.length >= 2) {
+        const lang = parts[0].toLowerCase();
+        return `${m},${lang};q=0.9,en;q=0.8`;
+    }
+    return `${m},${m};q=0.9,en;q=0.8`;
+}
+export function resolveWebSearchMarketFromContext(context) {
+    const raw = context?.extra?.[WEB_SEARCH_LOCALE_EXTRA_KEY];
+    if (typeof raw === 'string' && raw.trim()) {
+        return normalizeWebSearchLocaleHint(raw);
+    }
+    return DEFAULT_WEB_SEARCH_MARKET;
+}
+//# sourceMappingURL=web-search-locale.js.map

package/lib/builtin/web-search-locale.js.map

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

package/lib/builtin/web-search-tool.d.ts

@@ -0,0 +1,20 @@
+/**
+ * web_search — Bing HTML 搜索、域名过滤、会话内次数上限
+ * （DuckDuckGo HTML 接口已易触发人机验证，故改用 Bing；解析逻辑对齐
+ * claude-code bingAdapter）
+ */
+import type { Tool, ToolContext, ToolParametersSchema, ToolResult } from '@zhin.js/core';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+export declare const MAX_WEB_SEARCH_COUNT = 20;
+export declare const WEB_SEARCH_PARAMETERS: ToolParametersSchema;
+export declare class WebSearchBuiltinTool extends BuiltinBaseTool {
+    readonly name = "web_search";
+    readonly description = "\u5728\u4E92\u8054\u7F51\u4E0A\u641C\u7D22\uFF08Bing\uFF09\uFF0C\u8FD4\u56DE\u5339\u914D\u7684\u6807\u9898\u3001URL \u548C\u6458\u8981\u7247\u6BB5\u3002\u7528\u4E8E\u67E5\u8D44\u6599\u3001\u627E\u7F51\u9875\u3002\u652F\u6301\u57DF\u540D\u8FC7\u6EE4\u3002\u9ED8\u8BA4\u4E2D\u6587\u7ED3\u679C\uFF1B\u7528\u6237\u53EF\u5728 user_profile \u4E2D\u8BBE\u7F6E language \u6216 preferred_language \u8986\u76D6\uFF1B\u4E5F\u53EF\u7531\u96C6\u6210\u65B9\u8BBE\u7F6E ToolContext.extra.web_search_locale\u3002";
+    readonly parameters: ToolParametersSchema<Record<string, any>>;
+    readonly kind = "web";
+    private searchCount;
+    constructor();
+    run(args: Record<string, unknown>, _context?: ToolContext): Promise<ToolResult>;
+}
+export declare function createWebSearchTool(): Tool;
+//# sourceMappingURL=web-search-tool.d.ts.map

package/lib/builtin/web-search-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/web-search-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAWzD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,eAAO,MAAM,qBAAqB,EAAE,oBAiBnC,CAAC;AAqCF,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,sfAC6I;IACjK,QAAQ,CAAC,UAAU,4CAAyB;IAC5C,QAAQ,CAAC,IAAI,SAAS;IAEtB,OAAO,CAAC,WAAW,CAAK;;IAmBlB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA6CtF;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/lib/builtin/web-search-tool.js

@@ -0,0 +1,105 @@
+import { errMsg } from '../discovery/utils.js';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+import { BING_SEARCH_FETCH_TIMEOUT_MS, bingSearchFetchHeaders, buildBingSearchUrl, extractBingResults, hostnameMatchesList, } from './bing-search-html.js';
+import { resolveWebSearchMarketFromContext } from './web-search-locale.js';
+export const MAX_WEB_SEARCH_COUNT = 20;
+export const WEB_SEARCH_PARAMETERS = {
+    type: 'object',
+    properties: {
+        query: { type: 'string', description: '搜索关键词或完整查询语句' },
+        limit: { type: 'number', description: '返回结果数量（默认 5，建议 1–10）' },
+        allowed_domains: {
+            type: 'array',
+            description: '仅保留这些域名的结果（可选，如 ["github.com", "stackoverflow.com"]）；含子域',
+            items: { type: 'string' },
+        },
+        blocked_domains: {
+            type: 'array',
+            description: '排除这些域名的结果（可选）；含子域',
+            items: { type: 'string' },
+        },
+    },
+    required: ['query'],
+};
+function filterByDomains(rows, allowedDomains, blockedDomains) {
+    let filtered = rows;
+    if (Array.isArray(allowedDomains) && allowedDomains.length) {
+        const allowed = allowedDomains.filter((d) => typeof d === 'string' && d.trim().length > 0);
+        filtered = filtered.filter(r => {
+            try {
+                const hostname = new URL(r.url).hostname;
+                return allowed.some(d => hostnameMatchesList(hostname, d));
+            }
+            catch {
+                return false;
+            }
+        });
+    }
+    if (Array.isArray(blockedDomains) && blockedDomains.length) {
+        const blocked = blockedDomains.filter((d) => typeof d === 'string' && d.trim().length > 0);
+        filtered = filtered.filter(r => {
+            try {
+                const hostname = new URL(r.url).hostname;
+                return !blocked.some(d => hostnameMatchesList(hostname, d));
+            }
+            catch {
+                return true;
+            }
+        });
+    }
+    return filtered;
+}
+export class WebSearchBuiltinTool extends BuiltinBaseTool {
+    name = 'web_search';
+    description = '在互联网上搜索（Bing），返回匹配的标题、URL 和摘要片段。用于查资料、找网页。支持域名过滤。默认中文结果；用户可在 user_profile 中设置 language 或 preferred_language 覆盖；也可由集成方设置 ToolContext.extra.web_search_locale。';
+    parameters = WEB_SEARCH_PARAMETERS;
+    kind = 'web';
+    searchCount = 0;
+    constructor() {
+        super();
+        this.tags.push('web', 'search');
+        this.keywords.push('搜索', '网上搜', '网页搜索', '搜索引擎', 'search', 'google', '百度', 'bing', '查询', '搜一下');
+    }
+    async run(args, _context) {
+        try {
+            this.searchCount++;
+            if (this.searchCount > MAX_WEB_SEARCH_COUNT) {
+                return `Error: 搜索次数已达上限 (${MAX_WEB_SEARCH_COUNT})。请使用已获取的信息回答。`;
+            }
+            const limitRaw = typeof args.limit === 'number' && Number.isFinite(args.limit) ? args.limit : 5;
+            const limit = Math.max(1, Math.min(20, limitRaw));
+            const query = String(args.query ?? '').trim();
+            if (!query)
+                return 'Error: query is required';
+            const market = resolveWebSearchMarketFromContext(_context);
+            const url = buildBingSearchUrl(query, market);
+            const res = await fetch(url, {
+                headers: bingSearchFetchHeaders(market),
+                redirect: 'follow',
+                signal: AbortSignal.timeout(BING_SEARCH_FETCH_TIMEOUT_MS),
+            });
+            if (!res.ok)
+                return `HTTP ${res.status}: ${res.statusText}`;
+            const html = await res.text();
+            const rawRows = extractBingResults(html);
+            const filtered = filterByDomains(rawRows, args.allowed_domains, args.blocked_domains).slice(0, limit);
+            if (filtered.length === 0) {
+                if (rawRows.length === 0) {
+                    return 'No results found.（若页面为人机验证或结构变化，可稍后重试或改用 web_fetch 打开已知 URL）';
+                }
+                return 'No results found.';
+            }
+            return (`(${this.searchCount}/${MAX_WEB_SEARCH_COUNT} searches)\n` +
+                filtered
+                    .map((r, i) => `${i + 1}. ${r.title}\n   URL: ${r.url}\n   ${r.snippet ?? ''}`.trimEnd())
+                    .join('\n\n'));
+        }
+        catch (e) {
+            return `Error: ${errMsg(e)}`;
+        }
+    }
+}
+export function createWebSearchTool() {
+    return new WebSearchBuiltinTool().toTool();
+}
+//# sourceMappingURL=web-search-tool.js.map

package/lib/builtin/web-search-tool.js.map

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

package/lib/builtin/web-tool-utils.d.ts

@@ -0,0 +1,4 @@
+/** Shared constants for built-in web tools (web_search / web_fetch). */
+export declare const ZHIN_WEB_USER_AGENT = "Mozilla/5.0 (compatible; ZhinBot/1.0)";
+export declare const WEB_TOOL_FETCH_TIMEOUT_MS = 15000;
+//# sourceMappingURL=web-tool-utils.d.ts.map

package/lib/builtin/web-tool-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-tool-utils.d.ts","sourceRoot":"","sources":["../../src/builtin/web-tool-utils.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,0CAA0C,CAAC;AAC3E,eAAO,MAAM,yBAAyB,QAAS,CAAC"}

package/lib/builtin/web-tool-utils.js

@@ -0,0 +1,4 @@
+/** Shared constants for built-in web tools (web_search / web_fetch). */
+export const ZHIN_WEB_USER_AGENT = 'Mozilla/5.0 (compatible; ZhinBot/1.0)';
+export const WEB_TOOL_FETCH_TIMEOUT_MS = 15_000;
+//# sourceMappingURL=web-tool-utils.js.map

package/lib/builtin/web-tool-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-tool-utils.js","sourceRoot":"","sources":["../../src/builtin/web-tool-utils.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,uCAAuC,CAAC;AAC3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC"}

package/lib/builtin/write-file-tool.d.ts

@@ -0,0 +1,13 @@
+import type { Tool, ToolContext, ToolParametersSchema, ToolResult } from '@zhin.js/core';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+export declare const WRITE_FILE_PARAMETERS: ToolParametersSchema;
+export declare class WriteFileBuiltinTool extends BuiltinBaseTool {
+    readonly name = "write_file";
+    readonly description = "\u5411\u6307\u5B9A\u8DEF\u5F84\u5199\u5165\u5185\u5BB9\uFF0C\u521B\u5EFA\u6216\u8986\u76D6\u6587\u4EF6\uFF1B\u82E5\u76EE\u5F55\u4E0D\u5B58\u5728\u4F1A\u81EA\u52A8\u521B\u5EFA\u3002";
+    readonly parameters: ToolParametersSchema<Record<string, any>>;
+    readonly kind = "file";
+    constructor();
+    run(args: Record<string, unknown>, _context?: ToolContext): Promise<ToolResult>;
+}
+export declare function createWriteFileTool(): Tool;
+//# sourceMappingURL=write-file-tool.d.ts.map

package/lib/builtin/write-file-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/write-file-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGzF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,qBAAqB,EAAE,oBAOnC,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,0LACe;IACnC,QAAQ,CAAC,UAAU,4CAAyB;IAC5C,QAAQ,CAAC,IAAI,UAAU;;IAiBjB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAmBtF;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/lib/builtin/write-file-tool.js

@@ -0,0 +1,51 @@
+/**
+ * write_file — 内置文件写入
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { assertFileAccess } from '../security/file-policy.js';
+import { expandHome, nodeErrToFileMessage } from '../discovery/utils.js';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+export const WRITE_FILE_PARAMETERS = {
+    type: 'object',
+    properties: {
+        file_path: { type: 'string', description: '要写入的文件路径' },
+        content: { type: 'string', description: '要写入的完整内容' },
+    },
+    required: ['file_path', 'content'],
+};
+export class WriteFileBuiltinTool extends BuiltinBaseTool {
+    name = 'write_file';
+    description = '向指定路径写入内容，创建或覆盖文件；若目录不存在会自动创建。';
+    parameters = WRITE_FILE_PARAMETERS;
+    kind = 'file';
+    constructor() {
+        super();
+        this.tags.push('file', 'write');
+        this.keywords.push('写文件', '写入文件', '创建文件', '保存文件', 'write file', 'write', '保存', '创建');
+    }
+    async run(args, _context) {
+        const filePathArg = args.file_path;
+        const contentArg = args.content;
+        if (typeof filePathArg !== 'string' || !filePathArg.trim()) {
+            return 'Error: file_path is required';
+        }
+        if (typeof contentArg !== 'string') {
+            return 'Error: content is required';
+        }
+        try {
+            const fp = expandHome(filePathArg);
+            assertFileAccess(fp);
+            await fs.mkdir(path.dirname(fp), { recursive: true });
+            await fs.writeFile(fp, contentArg, 'utf-8');
+            return `✅ Wrote ${Buffer.byteLength(contentArg)} bytes to ${fp}`;
+        }
+        catch (e) {
+            return nodeErrToFileMessage(e, String(filePathArg), 'write');
+        }
+    }
+}
+export function createWriteFileTool() {
+    return new WriteFileBuiltinTool().toTool();
+}
+//# sourceMappingURL=write-file-tool.js.map

package/lib/builtin/write-file-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file-tool.js","sourceRoot":"","sources":["../../src/builtin/write-file-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,CAAC,MAAM,qBAAqB,GAAyB;IACzD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;QACtD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;KACrD;IACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAC9C,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAClB,gCAAgC,CAAC;IAC1B,UAAU,GAAG,qBAAqB,CAAC;IACnC,IAAI,GAAG,MAAM,CAAC;IAEvB;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,KAAK,EACL,MAAM,EACN,MAAM,EACN,MAAM,EACN,YAAY,EACZ,OAAO,EACP,IAAI,EACJ,IAAI,CACL,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,QAAsB;QAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC;QAChC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3D,OAAO,8BAA8B,CAAC;QACxC,CAAC;QACD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,4BAA4B,CAAC;QACtC,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;YACnC,gBAAgB,CAAC,EAAE,CAAC,CAAC;YACrB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,WAAW,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,CAAC;QACnE,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,oBAAoB,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,oBAAoB,EAAE,CAAC,MAAM,EAAE,CAAC;AAC7C,CAAC"}

package/lib/builtin/write-memory-tool.d.ts

@@ -0,0 +1,14 @@
+import type { Tool, ToolContext, ToolParametersSchema, ToolResult } from '@zhin.js/core';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+export declare const WRITE_MEMORY_PARAMETERS: ToolParametersSchema;
+export declare class WriteMemoryBuiltinTool extends BuiltinBaseTool {
+    private readonly dataDir;
+    readonly name = "write_memory";
+    readonly description = "\u5199\u5165\u6301\u4E45\u5316\u8BB0\u5FC6\u3002\u5F53\u7528\u6237\u8BF4\"\u8BB0\u4F4F\u2026\"\u3001\"\u8BB0\u5F55\u2026\"\u65F6\u4F7F\u7528\u6B64\u5DE5\u5177";
+    readonly parameters: ToolParametersSchema<Record<string, any>>;
+    readonly kind = "memory";
+    constructor(dataDir: string);
+    run(args: Record<string, unknown>, _context?: ToolContext): Promise<ToolResult>;
+}
+export declare function createWriteMemoryTool(dataDir: string): Tool;
+//# sourceMappingURL=write-memory-tool.d.ts.map

package/lib/builtin/write-memory-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-memory-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/write-memory-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,uBAAuB,EAAE,oBAYrC,CAAC;AAEF,qBAAa,sBAAuB,SAAQ,eAAe;IAM7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,oKAAmC;IACvD,QAAQ,CAAC,UAAU,4CAA2B;IAC9C,QAAQ,CAAC,IAAI,YAAY;gBAEI,OAAO,EAAE,MAAM;IAMtC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAYtF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3D"}