minimal-agent 0.2.0 → 0.3.1

package/src/tools/shared/fileState.js

@@ -0,0 +1,61 @@
+/**
+ * ============================================================
+ *  src/tools/shared/fileState.ts —— Pre-read Guard 状态表
+ * ------------------------------------------------------------
+ *  对应上游 D:\code\kakadeai\utils\fileStateCache.ts:4-14
+ *  + D:\code\kakadeai\tools\FileWriteTool\FileWriteTool.ts:198-219 的"先读后写"约束。
+ *
+ *  纯 module-level Map，记录每个文件最近一次被 Read 时的 (mtime, size)。
+ *  Write/Edit 在落盘前调用 assertFresh：
+ *    1. 没有记录 + 文件已存在 → 报错"请先 Read"
+ *    2. 没有记录 + 文件不存在 → 放行（新建场景）
+ *    3. 当前 mtime > 记录的 mtime → 报错"文件被外部修改"
+ *
+ *  /new 调用 clearContext 时连带调 clearFileState() 防残留。
+ * ============================================================
+ */
+import { existsSync, statSync } from 'node:fs';
+const fileState = new Map();
+export function recordRead(absPath) {
+    try {
+        const st = statSync(absPath);
+        fileState.set(absPath, { timestamp: st.mtimeMs, size: st.size });
+    }
+    catch {
+        // 文件不存在或无权访问 —— 不记录，让 Read 自己处理错误
+    }
+}
+export function assertFresh(absPath) {
+    const entry = fileState.get(absPath);
+    if (!entry) {
+        if (existsSync(absPath)) {
+            return {
+                ok: false,
+                error: `文件 ${absPath} 已存在但未在本会话 Read 过。请先用 Read 工具读取，确认内容后再修改。`,
+            };
+        }
+        // 文件不存在 → 新建场景，放行
+        return { ok: true };
+    }
+    try {
+        const st = statSync(absPath);
+        if (st.mtimeMs > entry.timestamp) {
+            return {
+                ok: false,
+                error: `${absPath} 在 Read 后被外部修改（mtime 漂移）。请重新用 Read 工具读取最新内容。`,
+            };
+        }
+    }
+    catch {
+        // 记录存在但文件没了 —— 不阻拦，允许重新创建
+        return { ok: true };
+    }
+    return { ok: true };
+}
+export function clearFileState() {
+    fileState.clear();
+}
+// 测试辅助：只在测试里用，业务代码不要碰
+export function _getFileStateSize() {
+    return fileState.size;
+}

package/src/tools/shared/fileUtils.js

@@ -0,0 +1,281 @@
+/**
+ * ============================================================
+ *  src/tools/shared/fileUtils.ts —— Read/Edit/Write 共享工具函数
+ * ------------------------------------------------------------
+ *  从 kakadeai 主仓库提炼的核心能力，剥离 UI/LSP/权限等高级层：
+ *    1. 设备文件路径拦截（防止 /dev/zero 等阻塞）
+ *    2. 路径安全校验 + 规范化（null byte / UNC / ~ 展开）
+ *    3. 行尾符检测与保持（CRLF vs LF）
+ *    4. 引号风格保留（弯引号 ↔ 直引号归一化）
+ * ============================================================
+ */
+import { open, readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { extname, resolve } from 'node:path';
+import { getWorkingDir } from '../../bootstrap/workingDir.js';
+// -------------------- 1. 设备文件路径拦截 --------------------
+const BLOCKED_DEVICE_PATHS = new Set([
+    '/dev/zero',
+    '/dev/random',
+    '/dev/urandom',
+    '/dev/full',
+    '/dev/stdin',
+    '/dev/tty',
+    '/dev/console',
+    '/dev/stdout',
+    '/dev/stderr',
+    '/dev/fd/0',
+    '/dev/fd/1',
+    '/dev/fd/2',
+]);
+const WINDOWS_BLOCKED_NAMES = new Set(['NUL', 'CON', 'PRN', 'AUX', 'COM1', 'COM2', 'LPT1']);
+export function isBlockedDevicePath(filePath) {
+    // 用 forward-slash 归一化：path.normalize 在 Windows 上会把 / 转成 \，
+    // 黑名单是 POSIX 字面量永远对不上，所以直接做反斜杠 → 正斜杠的归一化
+    const slashed = filePath.replaceAll('\\', '/');
+    if (BLOCKED_DEVICE_PATHS.has(slashed))
+        return true;
+    if (slashed.startsWith('/proc/') &&
+        (slashed.endsWith('/fd/0') || slashed.endsWith('/fd/1') || slashed.endsWith('/fd/2'))) {
+        return true;
+    }
+    const baseName = slashed.split('/').pop() ?? '';
+    if (WINDOWS_BLOCKED_NAMES.has(baseName.toUpperCase())) {
+        return true;
+    }
+    return false;
+}
+export function validateAndResolvePath(rawPath, workingDir) {
+    if (rawPath.includes('\0')) {
+        return { ok: false, error: '路径包含非法字符（null byte）' };
+    }
+    // 在 resolve 之前先按原始路径检查设备文件：
+    // Windows 上 resolve('D:\\workdir', '/dev/zero') → 'D:\\dev\\zero'，已丢失 POSIX 语义
+    if (isBlockedDevicePath(rawPath)) {
+        return { ok: false, error: `不允许读取设备文件：${rawPath}。该路径可能产生无限输出或阻塞进程。` };
+    }
+    const expanded = expandPath(rawPath);
+    const resolved = resolve(workingDir, expanded);
+    // resolve 后再查一次（兜底 Windows 设备名如 NUL/CON 经 resolve 后仍能 baseName 命中）
+    if (isBlockedDevicePath(resolved)) {
+        return { ok: false, error: `不允许读取设备文件：${resolved}。该路径可能产生无限输出或阻塞进程。` };
+    }
+    if (process.platform === 'win32' && /^\\\\/.test(resolved)) {
+        return { ok: false, error: '不支持 UNC 路径（\\\\server\\share 格式），请使用本地路径' };
+    }
+    return { ok: true, resolvedPath: resolved };
+}
+function expandPath(p) {
+    if (p.startsWith('~/') || p === '~') {
+        return resolve(homedir(), p.slice(2));
+    }
+    return p;
+}
+/**
+ * 工具入口便捷封装：自动以 getWorkingDir() 为锚点做路径规范化 + 安全校验。
+ * 等价于 `validateAndResolvePath(rawPath, getWorkingDir())`。
+ * 让 Read / Write / Edit / MultiEdit 不必各自 import getWorkingDir。
+ */
+export function resolveToolPath(rawPath) {
+    return validateAndResolvePath(rawPath, getWorkingDir());
+}
+export function detectLineEndingsForString(content) {
+    let crlfCount = 0;
+    let lfCount = 0;
+    for (let i = 0; i < content.length; i++) {
+        if (content[i] === '\n') {
+            if (i > 0 && content[i - 1] === '\r') {
+                crlfCount++;
+            }
+            else {
+                lfCount++;
+            }
+        }
+    }
+    return crlfCount > lfCount ? 'CRLF' : 'LF';
+}
+export async function detectFileLineEndings(filePath) {
+    try {
+        const handle = await readFile(filePath, { encoding: 'utf8' });
+        const head = handle.slice(0, 4096);
+        return detectLineEndingsForString(head);
+    }
+    catch {
+        return 'LF';
+    }
+}
+export function applyLineEnding(content, ending) {
+    if (ending === 'CRLF') {
+        return content.replaceAll('\r\n', '\n').split('\n').join('\r\n');
+    }
+    return content;
+}
+// -------------------- 3.5 二进制扩展名拦截 --------------------
+// 上游 D:\code\kakadeai\constants\files.ts:5-112 BINARY_EXTENSIONS Set 的裁剪版：
+// 故意剔除 .log / .csv / .tsv / .dat / .data / .lock —— 这些经常被人当文本读。
+// 保留纯二进制：图片 / 文档 / 可执行 / 编译产物 / 压缩包 / 多媒体 / 字体 / 数据库 / wasm。
+export const BINARY_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.bmp', '.ico', '.tiff', '.tif',
+    '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx',
+    '.exe', '.dll', '.so', '.dylib', '.o', '.a',
+    '.pyc', '.pyo', '.class', '.jar',
+    '.zip', '.tar', '.gz', '.bz2', '.7z', '.rar', '.iso',
+    '.mp3', '.mp4', '.mov', '.avi', '.mkv', '.wav', '.flac', '.ogg',
+    '.ttf', '.otf', '.woff', '.woff2',
+    '.sqlite', '.sqlite3', '.db',
+    '.psd', '.ai', '.bin', '.wasm',
+]);
+export function hasBinaryExtension(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return BINARY_EXTENSIONS.has(ext);
+}
+/**
+ * 读文件前 3 字节，返回 BOM 类型。
+ * - EF BB BF → utf8-bom
+ * - FF FE    → utf16le
+ * - 其它 / 空 / 出错 → utf8（默认）
+ */
+export async function detectFileBomEncoding(filePath) {
+    let fh = null;
+    try {
+        fh = await open(filePath, 'r');
+        const buf = Buffer.alloc(3);
+        const { bytesRead } = await fh.read(buf, 0, 3, 0);
+        if (bytesRead >= 3 && buf[0] === 0xef && buf[1] === 0xbb && buf[2] === 0xbf) {
+            return 'utf8-bom';
+        }
+        if (bytesRead >= 2 && buf[0] === 0xff && buf[1] === 0xfe) {
+            return 'utf16le';
+        }
+        return 'utf8';
+    }
+    catch {
+        return 'utf8';
+    }
+    finally {
+        if (fh) {
+            try {
+                await fh.close();
+            }
+            catch { }
+        }
+    }
+}
+// -------------------- 4. 引号风格保留 --------------------
+export const LEFT_SINGLE_CURLY_QUOTE = '\u2018';
+export const RIGHT_SINGLE_CURLY_QUOTE = '\u2019';
+export const LEFT_DOUBLE_CURLY_QUOTE = '\u201C';
+export const RIGHT_DOUBLE_CURLY_QUOTE = '\u201D';
+export function normalizeQuotes(str) {
+    return str
+        .replaceAll(LEFT_SINGLE_CURLY_QUOTE, "'")
+        .replaceAll(RIGHT_SINGLE_CURLY_QUOTE, "'")
+        .replaceAll(LEFT_DOUBLE_CURLY_QUOTE, '"')
+        .replaceAll(RIGHT_DOUBLE_CURLY_QUOTE, '"');
+}
+export function findActualString(fileContent, searchString) {
+    if (fileContent.includes(searchString)) {
+        return searchString;
+    }
+    const normalizedSearch = normalizeQuotes(searchString);
+    const normalizedFile = normalizeQuotes(fileContent);
+    const searchIndex = normalizedFile.indexOf(normalizedSearch);
+    if (searchIndex !== -1) {
+        return fileContent.substring(searchIndex, searchIndex + searchString.length);
+    }
+    return null;
+}
+export function preserveQuoteStyle(oldString, actualOldString, newString) {
+    if (oldString === actualOldString) {
+        return newString;
+    }
+    const hasDoubleQuotes = actualOldString.includes(LEFT_DOUBLE_CURLY_QUOTE) ||
+        actualOldString.includes(RIGHT_DOUBLE_CURLY_QUOTE);
+    const hasSingleQuotes = actualOldString.includes(LEFT_SINGLE_CURLY_QUOTE) ||
+        actualOldString.includes(RIGHT_SINGLE_CURLY_QUOTE);
+    if (!hasDoubleQuotes && !hasSingleQuotes) {
+        return newString;
+    }
+    let result = newString;
+    if (hasDoubleQuotes) {
+        result = applyCurlyDoubleQuotes(result);
+    }
+    if (hasSingleQuotes) {
+        result = applyCurlySingleQuotes(result);
+    }
+    return result;
+}
+function isOpeningContext(chars, index) {
+    if (index === 0)
+        return true;
+    const prev = chars[index - 1];
+    return (prev === ' ' ||
+        prev === '\t' ||
+        prev === '\n' ||
+        prev === '\r' ||
+        prev === '(' ||
+        prev === '[' ||
+        prev === '{' ||
+        prev === '\u2014' ||
+        prev === '\u2013');
+}
+function applyCurlyDoubleQuotes(str) {
+    const chars = [...str];
+    const result = [];
+    for (let i = 0; i < chars.length; i++) {
+        if (chars[i] === '"') {
+            result.push(isOpeningContext(chars, i)
+                ? LEFT_DOUBLE_CURLY_QUOTE
+                : RIGHT_DOUBLE_CURLY_QUOTE);
+        }
+        else {
+            result.push(chars[i]);
+        }
+    }
+    return result.join('');
+}
+function applyCurlySingleQuotes(str) {
+    const chars = [...str];
+    const result = [];
+    for (let i = 0; i < chars.length; i++) {
+        if (chars[i] === "'") {
+            const prev = i > 0 ? chars[i - 1] : undefined;
+            const next = i < chars.length - 1 ? chars[i + 1] : undefined;
+            const prevIsLetter = prev !== undefined && /\p{L}/u.test(prev);
+            const nextIsLetter = next !== undefined && /\p{L}/u.test(next);
+            if (prevIsLetter && nextIsLetter) {
+                result.push(RIGHT_SINGLE_CURLY_QUOTE);
+            }
+            else {
+                result.push(isOpeningContext(chars, i)
+                    ? LEFT_SINGLE_CURLY_QUOTE
+                    : RIGHT_SINGLE_CURLY_QUOTE);
+            }
+        }
+        else {
+            result.push(chars[i]);
+        }
+    }
+    return result.join('');
+}
+// -------------------- 5. 字符串搜索/替换共享工具 --------------------
+/** 统计 needle 在 haystack 中出现多少次（不重叠）。 */
+export function countOccurrences(haystack, needle) {
+    if (needle.length === 0)
+        return 0;
+    let count = 0;
+    let pos = 0;
+    while ((pos = haystack.indexOf(needle, pos)) !== -1) {
+        count++;
+        pos += needle.length;
+    }
+    return count;
+}
+/**
+ * 全部替换。
+ * 不用 String.prototype.replaceAll(string, string) 与 String.prototype.replace 是
+ * 为了规避 replacement 字符串中 `$&` / `$1` 等被当作回填模式解释的问题。
+ */
+export function splitReplaceAll(haystack, needle, replacement) {
+    return haystack.split(needle).join(replacement);
+}

package/src/tools/shared/schemas.js

@@ -0,0 +1,16 @@
+/**
+ * ============================================================
+ *  src/tools/shared/schemas.ts —— 工具 Zod 输入 schema 公共片段
+ * ------------------------------------------------------------
+ *  抽出 Read / Write / Edit / MultiEdit 共享的 file_path 字段，
+ *  统一 min length 校验与 describe 文案。
+ *  动作动词通过参数注入（读取 / 写入 / 编辑）。
+ * ============================================================
+ */
+import { z } from 'zod';
+export function filePathField(action) {
+    return z
+        .string()
+        .min(1, '必须提供 file_path')
+        .describe(`要${action}的文件路径（绝对路径优先，相对路径基于 working dir 解析）`);
+}

package/src/tools/types.js

@@ -0,0 +1,21 @@
+/**
+ * ============================================================
+ *  src/tools/types.ts —— 工具相关的辅助类型与默认值
+ * ------------------------------------------------------------
+ *  Tool 接口本身在 src/types.ts 里定义（对外类型）。
+ *  这里只放工具子系统内部用的辅助类型 / 常量。
+ * ============================================================
+ */
+/** 默认输出截断阈值（30K 字符 ≈ 7.5K token） */
+export const DEFAULT_MAX_RESULT_SIZE_CHARS = 30_000;
+/** Read 工具默认行数上限（与 kakadeai 主仓库一致） */
+export const MAX_LINES_TO_READ = 2000;
+/**
+ * Read 工具默认字节上限（防止超大文件灌进上下文）。
+ * 基于 200K 上下文窗口设计：
+ * - system prompt + 工具定义 ≈ 30KB
+ * - 对话历史 ≈ 100KB
+ * - 单次读取安全上限 ≈ 256KB（~64K tokens）
+ * 超过此限制请用 offset/limit 分段读。
+ */
+export const MAX_FILE_SIZE_BYTES = 256 * 1024; // 256 KB

package/src/tools/webbrowser/browser.js

@@ -0,0 +1,55 @@
+/**
+ * ============================================================
+ *  src/tools/browser.ts —— Playwright Browser 单例
+ * ------------------------------------------------------------
+ *  整个 session 复用同一个 headless Chromium page。
+ *  动态 import playwright-core，按需加载，避免未安装时拖累主程序。
+ * ============================================================
+ */
+import os from 'node:os';
+import path from 'node:path';
+let browserInstance = null;
+let pageInstance = null;
+/**
+ * 获取或创建 browser page 单例。
+ * 每次导航后手动更新 pageInstance.url()。
+ */
+export async function getBrowserPage() {
+    if (!browserInstance) {
+        // 动态 import，按需加载
+        const { chromium } = await import('playwright-core');
+        try {
+            browserInstance = await chromium.launch({
+                headless: true,
+                args: ['--no-sandbox', '--disable-setuid-sandbox'],
+            });
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            throw new Error(`Failed to launch browser: ${message}\n` +
+                `请先安装 playwright 及浏览器：\n` +
+                `  npm install playwright-core\n` +
+                `  npx playwright install chromium`);
+        }
+    }
+    if (!pageInstance) {
+        pageInstance = await browserInstance.newPage();
+        await pageInstance.setViewportSize({ width: 1280, height: 720 });
+    }
+    return pageInstance;
+}
+/** 关闭浏览器（session 结束时调用） */
+export async function closeBrowser() {
+    if (pageInstance) {
+        await pageInstance.close();
+        pageInstance = null;
+    }
+    if (browserInstance) {
+        await browserInstance.close();
+        browserInstance = null;
+    }
+}
+/** 生成截图路径 */
+export function screenshotPath(prefix = 'browser') {
+    return path.join(os.tmpdir(), `${prefix}-${Date.now()}.png`);
+}

package/src/tools/webbrowser/webbrowser.js

@@ -0,0 +1,194 @@
+/**
+ * ============================================================
+ *  src/tools/webbrowser.ts —— WebBrowser 工具
+ * ------------------------------------------------------------
+ *  用 Playwright 控制 headless 浏览器：导航、截图、内容提取、表单交互。
+ *
+ *  依赖：playwright-core（需要额外安装浏览器：npx playwright install chromium）
+ *
+ *  输入：
+ *    action    必填，'navigate'|'screenshot'|'getContent'|'click'|'fill'|'submit'
+ *    url       可选，navigate 时必需
+ *    selector  可选，click/fill/submit 时必需
+ *    value     可选，fill 时必需
+ *    timeout   可选，默认 30000ms
+ *
+ *  输出：
+ *    { ok: true, content: string } | { ok: false, error: string }
+ * ============================================================
+ */
+import { z } from 'zod';
+import { DEFAULT_MAX_RESULT_SIZE_CHARS } from '../types.js';
+import { toToolParameters } from '../../utils/zodToJson.js';
+import { getBrowserPage, screenshotPath } from './browser.js';
+// ---------------- 1. Zod 输入 schema ----------------
+const inputSchema = z.object({
+    action: z
+        .enum(['navigate', 'screenshot', 'getContent', 'click', 'fill', 'submit'])
+        .describe('Browser action to perform'),
+    url: z
+        .string()
+        .url()
+        .optional()
+        .describe('URL to navigate to (required for navigate action)'),
+    selector: z
+        .string()
+        .optional()
+        .describe('CSS selector for click/fill/submit actions'),
+    value: z.string().optional().describe('Value to fill in input fields'),
+    timeout: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Timeout in milliseconds (default: 30000)'),
+});
+// ---------------- 2. JSON Schema（由 Zod 自动派生） ----------------
+const parameters = toToolParameters(inputSchema);
+// ---------------- 3. Description ----------------
+const description = `Control a headless web browser. Navigate to URLs, take screenshots, and interact with web pages.
+
+When to use WebBrowser vs WebSearch:
+- WebSearch: When you need to find information or discover URLs through search
+- WebBrowser: When you need to interact with a specific web page (navigate, click, fill forms, get content, take screenshots)
+
+Input parameters:
+  - action (required): The browser action. One of:
+    - navigate: Go to a URL (requires url parameter)
+    - screenshot: Take a screenshot of the current page
+    - getContent: Extract text content from the current page
+    - click: Click an element (requires selector parameter)
+    - fill: Fill an input field (requires selector and value parameters)
+    - submit: Submit a form (requires selector parameter)
+  - url (optional): URL to navigate to (required for navigate action, must be a valid URL)
+  - selector (optional): CSS selector for click/fill/submit actions
+  - value (optional): Value to fill in input fields
+  - timeout (optional): Timeout in milliseconds for actions (default: 30000)
+
+Usage notes:
+  - The browser runs headless (no visible window)
+  - Screenshots are saved to temporary files (/tmp/browser-*.png)
+  - Content is truncated to 50000 characters max
+  - Only one browser instance is maintained per session
+  - Requires: npm install playwright-core && npx playwright install chromium
+
+Example actions:
+  - Navigate and get content: { action: "navigate", url: "https://example.com" }
+  - Take screenshot: { action: "screenshot" }
+  - Click element: { action: "click", selector: "#submit-btn" }
+  - Fill form field: { action: "fill", selector: "input[name='email']", value: "user@example.com" }`;
+// ---------------- 4. call() 实现 ----------------
+async function call(input, signal) {
+    const { action, url, selector, value, timeout = 30000 } = input;
+    let page;
+    try {
+        page = await getBrowserPage();
+    }
+    catch (e) {
+        return {
+            ok: false,
+            error: `无法启动浏览器：${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+    try {
+        switch (action) {
+            case 'navigate': {
+                if (!url) {
+                    return { ok: false, error: 'navigate action requires url parameter' };
+                }
+                await page.goto(url, { timeout, waitUntil: 'domcontentloaded' });
+                const content = await page.evaluate(() => document.body.innerText);
+                const screenshot = screenshotPath('browser-nav');
+                await page.screenshot({ path: screenshot });
+                const truncatedContent = content.substring(0, 50_000);
+                return {
+                    ok: true,
+                    content: [
+                        `[Navigate] ${page.url()}`,
+                        `Screenshot: ${screenshot}`,
+                        '',
+                        '--- Page Content (first 50000 chars) ---',
+                        truncatedContent,
+                        content.length > 50_000 ? '\n... (truncated)' : '',
+                    ].join('\n'),
+                };
+            }
+            case 'screenshot': {
+                const screenshot = screenshotPath('browser-screenshot');
+                await page.screenshot({ path: screenshot });
+                return {
+                    ok: true,
+                    content: `[Screenshot] ${page.url()}\nSaved: ${screenshot}`,
+                };
+            }
+            case 'getContent': {
+                const content = await page.evaluate(() => document.body.innerText);
+                const truncated = content.substring(0, 50_000);
+                return {
+                    ok: true,
+                    content: [
+                        `[Page Content] ${page.url()}`,
+                        '',
+                        truncated,
+                        content.length > 50_000 ? '\n... (truncated at 50000 chars)' : '',
+                    ].join('\n'),
+                };
+            }
+            case 'click': {
+                if (!selector) {
+                    return { ok: false, error: 'click action requires selector parameter' };
+                }
+                await page.click(selector, { timeout });
+                return {
+                    ok: true,
+                    content: `[Click] ${selector}\nCurrent URL: ${page.url()}`,
+                };
+            }
+            case 'fill': {
+                if (!selector || value === undefined) {
+                    return { ok: false, error: 'fill action requires selector and value parameters' };
+                }
+                await page.fill(selector, value);
+                return {
+                    ok: true,
+                    content: `[Fill] ${selector} = "${value}"\nCurrent URL: ${page.url()}`,
+                };
+            }
+            case 'submit': {
+                if (!selector) {
+                    return { ok: false, error: 'submit action requires selector parameter' };
+                }
+                // Click and wait for navigation if it triggers one
+                await Promise.all([
+                    page.waitForNavigation({ timeout }).catch(() => { }),
+                    page.click(selector, { timeout }),
+                ]);
+                return {
+                    ok: true,
+                    content: `[Submit] ${selector}\nCurrent URL: ${page.url()}`,
+                };
+            }
+            default:
+                return { ok: false, error: `Unknown action: ${action}` };
+        }
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        // 截断超长错误信息
+        const truncated = message.length > DEFAULT_MAX_RESULT_SIZE_CHARS
+            ? message.substring(0, DEFAULT_MAX_RESULT_SIZE_CHARS) + '\n... (truncated)'
+            : message;
+        return { ok: false, error: `[${action}] Error: ${truncated}` };
+    }
+}
+// ---------------- 5. 导出 ----------------
+export const webbrowserTool = {
+    name: 'WebBrowser',
+    description,
+    inputSchema,
+    parameters,
+    isReadOnly: false,
+    isConcurrencySafe: false,
+    maxResultSizeChars: DEFAULT_MAX_RESULT_SIZE_CHARS,
+    call,
+};