@zmzai/agent-framework 0.1.0 → 0.2.1

package/dist/core/tools/terminal.js

@@ -0,0 +1,265 @@
+import { resolve, sep } from "node:path";
+import { z } from "zod";
+const RING_CAP_DEFAULT = 192 * 1024;
+function ringAppend(ring, chunk, capBytes) {
+    const merged = ring.chunks.length === 0 ? chunk : Buffer.concat([ring.chunks, chunk]);
+    if (merged.length <= capBytes) {
+        ring.chunks = merged;
+        return;
+    }
+    const removed = merged.length - capBytes;
+    ring.chunks = merged.subarray(removed);
+    ring.dropped += removed;
+    ring.droppedEvents += 1;
+}
+export class TerminalManager {
+    #backend;
+    #ringCapBytes;
+    #maxSessions;
+    #nextId = 1;
+    #sessions = new Map();
+    constructor(backend, opts = {}) {
+        this.#backend = backend;
+        this.#ringCapBytes = opts.ringCapBytes ?? RING_CAP_DEFAULT;
+        this.#maxSessions = opts.maxSessions ?? 16;
+    }
+    get backendKind() {
+        return this.#backend.kind;
+    }
+    async start(input) {
+        // 上限含已退出的会话——一并清理最老的退出会话，还满则拒绝新会话
+        if (this.#sessions.size >= this.#maxSessions) {
+            const exitedId = [...this.#sessions.entries()].find(([, s]) => s.info.status !== "running")?.[0];
+            if (exitedId)
+                this.#sessions.delete(exitedId);
+            else
+                throw new Error(`终端会话已达上限 ${this.#maxSessions}：先 terminal_kill 或等现有进程退出`);
+        }
+        const id = `tty_${String(this.#nextId).padStart(4, "0")}`;
+        this.#nextId += 1;
+        const session = {
+            info: {
+                id,
+                ...(input.name ? { name: input.name } : {}),
+                status: "running",
+                backend: this.#backend.kind,
+                startedAt: new Date().toISOString(),
+                bytesTotal: 0,
+            },
+            ring: { chunks: Buffer.alloc(0), dropped: 0, droppedEvents: 0 },
+            handle: null,
+            waiters: [],
+        };
+        this.#sessions.set(id, session);
+        const handle = await this.#backend.start({ command: input.command, cwd: input.cwd, ...(input.env ? { env: input.env } : {}), ...(input.cols ? { cols: input.cols } : {}), ...(input.rows ? { rows: input.rows } : {}) }, {
+            onData: (chunk) => {
+                const buf = Buffer.from(chunk, "utf8");
+                session.info.bytesTotal += buf.length;
+                ringAppend(session.ring, buf, this.#ringCapBytes);
+                for (const wake of session.waiters.splice(0))
+                    wake();
+            },
+            onExit: ({ exitCode, signal }) => {
+                session.info.status = signal && signal !== "" ? "killed" : "exited";
+                session.info.exitCode = exitCode;
+                if (signal)
+                    session.info.signal = signal;
+                for (const wake of session.waiters.splice(0))
+                    wake();
+            },
+        });
+        session.handle = handle;
+        if (handle.pid != null)
+            session.info.pid = handle.pid;
+        return { ...session.info };
+    }
+    list() {
+        return [...this.#sessions.values()].map((s) => ({ ...s.info }));
+    }
+    getSession(id) {
+        const s = this.#sessions.get(id);
+        return s ? { ...s.info } : null;
+    }
+    read(id, sinceBytes) {
+        const s = this.#sessions.get(id);
+        if (!s)
+            return null;
+        const origin = s.ring.dropped;
+        const from = Math.max(sinceBytes ?? origin, origin); // 早于已被裁剪的头部 → 从现存的最早字节开始并标记截断
+        const slice = s.ring.chunks.subarray(from - origin);
+        return {
+            output: slice.toString("utf8"),
+            cursor: origin + s.ring.chunks.length,
+            totalDropped: s.ring.dropped,
+            truncatedHead: from > (sinceBytes ?? from) || s.ring.dropped > (sinceBytes ?? 0),
+            session: { ...s.info },
+        };
+    }
+    write(id, text) {
+        const s = this.#sessions.get(id);
+        if (!s?.handle || s.info.status !== "running")
+            return false;
+        s.handle.write(text);
+        return true;
+    }
+    resize(id, cols, rows) {
+        const s = this.#sessions.get(id);
+        if (!s?.handle?.resize || s.info.status !== "running")
+            return false;
+        s.handle.resize(cols, rows);
+        return true;
+    }
+    kill(id, signal = "SIGTERM") {
+        const s = this.#sessions.get(id);
+        if (!s?.handle || s.info.status !== "running")
+            return false;
+        s.handle.kill(signal);
+        return true;
+    }
+    disposeAll(signal = "SIGKILL") {
+        for (const [, s] of this.#sessions) {
+            if (s.info.status === "running") {
+                try {
+                    s.handle?.kill(signal);
+                }
+                catch {
+                    /* already gone */
+                }
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// 工具集
+export function createTerminalTools(manager, opts) {
+    const requireSession = (id) => manager.getSession(id) ?? (() => { throw new Error(`终端会话不存在：${id}（用 terminal_start 创建，或 terminal_list 查看）`); })();
+    const formatInfo = (s) => `[${s.id}]${s.name ? `「${s.name}」` : ""} ${s.status}${s.exitCode != null ? `(exit ${s.exitCode})` : ""}${s.signal ? `(sig ${s.signal})` : ""} · ${s.backend} · 输出累计 ${s.bytesTotal}B`;
+    const startTool = {
+        id: "terminal_start",
+        label: "启动交互式终端",
+        description: "在本机启动一个长驻/交互式命令（dev server、watch、交互安装器等），立即返回 sessionId 不阻塞对话。输出用 terminal_read 增量读取；交互应答用 terminal_write；结束用 terminal_kill。",
+        parameters: z.object({
+            command: z.string().min(1).max(2048),
+            name: z.string().min(1).max(64).optional(),
+            cwd: z.string().max(512).optional(),
+            cols: z.number().int().min(20).max(500).optional(),
+            rows: z.number().int().min(5).max(200).optional(),
+        }),
+        permission: (args) => ({
+            permission: "terminal",
+            patterns: [args.command],
+            always: [args.command, `${args.command.trim().split(/\s+/)[0] ?? "*"} *`],
+            metadata: { command: args.command, ...(args.name ? { name: args.name } : {}) },
+        }),
+        executionMode: "sequential",
+        async execute(args) {
+            const resolvedCwd = args.cwd ? resolveWithin(opts.workspaceRoot(), args.cwd) : opts.workspaceRoot();
+            if (!resolvedCwd)
+                throw new Error(`cwd 必须位于工作区内：${args.cwd}`);
+            const info = await manager.start({ command: args.command, cwd: resolvedCwd, name: args.name, cols: args.cols, rows: args.rows });
+            const initial = manager.read(info.id);
+            return {
+                title: `终端 ${info.id} 已启动${info.backend === "pipe" ? "（管道模式）" : ""}`,
+                output: `${formatInfo(info)}\n$ ${args.command}\n${initial.output ? `--- 初始输出 ---\n${initial.output}` : "（暂无输出，稍后用 terminal_read 轮询）"}`,
+                metadata: { sessionId: info.id, backend: info.backend, pid: info.pid ?? null },
+            };
+        },
+    };
+    const readTool = {
+        id: "terminal_read",
+        label: "读取终端输出",
+        description: "增量读取指定终端自 since 字节游标以来的输出；返回新的游标（下次传回即可续读）。输出的末尾包含会话状态；进程已退出时会注明退出码，无需继续轮询。",
+        parameters: z.object({
+            sessionId: z.string().min(1).max(32),
+            since: z.number().int().min(0).optional(),
+        }),
+        permission: () => null,
+        async execute(args) {
+            const result = manager.read(args.sessionId, args.since);
+            if (!result)
+                throw new Error(`终端会话不存在：${args.sessionId}`);
+            const tailNote = result.session.status === "running"
+                ? "\n（仍在运行，可继续等待后带新游标 terminal_read）"
+                : `\n（已结束：exit=${result.session.exitCode ?? "-"}${result.session.signal ? ` sig=${result.session.signal}` : ""}，不会再有新输出）`;
+            const headWarning = result.truncatedHead ? `…[头部 ${result.totalDropped} B 已被滚动丢弃]…\n` : "";
+            return {
+                title: `读 ${args.sessionId}（+${Buffer.byteLength(result.output)}B）`,
+                output: `${headWarning}${result.output || "（无新输出）"}\ncursor=${result.cursor}\n${formatInfo(result.session)}${tailNote}`,
+                metadata: { sessionId: args.sessionId, cursor: result.cursor, status: result.session.status, exitCode: result.session.exitCode ?? undefined, backend: result.session.backend },
+            };
+        },
+    };
+    const writeTool = {
+        id: "terminal_write",
+        label: "向终端写入",
+        description: "向运行中的终端发送输入（如回答 y/n 提示）。默认自动补换行；newline=false 可发送裸按键序列（Ctrl+C 用 \"\\u0003\"）。",
+        parameters: z.object({
+            sessionId: z.string().min(1).max(32),
+            text: z.string().min(1).max(8192),
+            newline: z.boolean().optional(),
+        }),
+        permission: () => null,
+        executionMode: "sequential",
+        async execute(args) {
+            const ok = manager.write(args.sessionId, args.newline === false ? args.text : `${args.text}\n`);
+            if (!ok)
+                throw new Error(`无法写入：${args.sessionId} 不是运行中的会话`);
+            await new Promise((r) => setTimeout(r, 250)); // 给目标进程一点回显时间
+            const after = manager.read(args.sessionId);
+            return {
+                title: `写入 ${args.sessionId}`,
+                output: `已写入${args.newline === false ? "（未补换行）" : ""}。\ncursor=${after.cursor}\n${after.output.slice(-2000) || "（暂无响应）"}`,
+                metadata: { sessionId: args.sessionId, cursor: after.cursor },
+            };
+        },
+    };
+    const killTool = {
+        id: "terminal_kill",
+        label: "终止终端会话",
+        description: "结束一个运行中的终端会话（先 SIGTERM，必要时 SIGKILL 兜底）。已退出的会话会被清理回收。",
+        parameters: z.object({ sessionId: z.string().min(1).max(32) }),
+        permission: () => null,
+        executionMode: "sequential",
+        async execute(args) {
+            requireSession(args.sessionId);
+            const ok = manager.kill(args.sessionId, "SIGTERM");
+            await new Promise((r) => setTimeout(r, 300));
+            let final = manager.read(args.sessionId)?.session ?? manager.getSession(args.sessionId);
+            if (final?.status === "running") {
+                manager.kill(args.sessionId, "SIGKILL");
+                await new Promise((r) => setTimeout(r, 300));
+                final = manager.read(args.sessionId)?.session ?? final;
+            }
+            if (!ok && final?.status === "running")
+                throw new Error(`终止失败：${args.sessionId} 仍在运行`);
+            return {
+                title: `终止 ${args.sessionId}`,
+                output: final ? formatInfo(final) : `${args.sessionId} 已不存在`,
+                metadata: { sessionId: args.sessionId, status: final?.status ?? "gone", exitCode: final?.exitCode ?? undefined },
+            };
+        },
+    };
+    const listTool = {
+        id: "terminal_list",
+        label: "列出终端会话",
+        description: "列出全部终端会话及其状态（含 id/name/backend/pid），用于找回上下文丢失的会话。",
+        parameters: z.object({}),
+        permission: () => null,
+        async execute() {
+            const all = manager.list();
+            return {
+                title: `共 ${all.length} 个终端会话`,
+                output: all.length ? all.map(formatInfo).join("\n") : "（无终端会话）",
+                metadata: { count: all.length, sessions: all },
+            };
+        },
+    };
+    return [startTool, readTool, writeTool, killTool, listTool];
+}
+function resolveWithin(root, rel) {
+    const abs = resolve(root, rel);
+    if (abs !== root && !abs.startsWith(root + sep))
+        return null;
+    return abs;
+}
+//# sourceMappingURL=terminal.js.map

package/dist/core/tools/terminal.js.map

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

package/dist/core/tools/trim.d.ts

@@ -0,0 +1,31 @@
+/** 失败日志按行剪裁（tutorial-advanced 01-trim retrofit）：
+ *
+ *  head+tail 对成功输出够用，但失败日志有更狠的裁法——构建/测试日志的
+ *  价值高度集中：几千行 pass 噪音里只有错误声明、断言详情和调用栈值钱。
+ *
+ *  策略分流（trimToolOutput）：
+ *  - failed=true → 只保留命中错误特征的行 + 前后 N 行上下文，区间合并，
+ *    区间之间插省略标记；错误行太多撑爆上限时最后一道闸仍是 head+tail。
+ *  - failed=false → head+tail（复用 adapter 的 pruneOutput，字节预算）。
+ *
+ *  两个上限不一样的理由：失败剪裁后信息密度极高（全是错误），8000 字符
+ *  ≈ 2000 tokens 足够模型定位问题；成功输出往往是结构化数据，多给配额。
+ */
+export type FailureTrimResult = {
+    text: string;
+    trimmed: boolean;
+    keptLines: number;
+    totalLines: number;
+    omittedBytes: number;
+};
+/**
+ * 失败日志剪裁：只留错误行 + 上下文。
+ * 没找到任何错误行时降级为 head+tail 字符裁剪。
+ */
+export declare function pruneFailureLog(text: string, opts: {
+    contextLines?: number;
+    maxChars: number;
+}): FailureTrimResult;
+/** 工具失败输出裁剪入口：超预算才裁（小失败输出保持原样），失败但没超预算不动。 */
+export declare function trimFailureOutput(text: string): FailureTrimResult;
+//# sourceMappingURL=trim.d.ts.map

package/dist/core/tools/trim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim.d.ts","sourceRoot":"","sources":["../../../src/core/tools/trim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhI;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CA+ClH;AAgBD,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAMjE"}

package/dist/core/tools/trim.js

@@ -0,0 +1,98 @@
+/** 失败日志按行剪裁（tutorial-advanced 01-trim retrofit）：
+ *
+ *  head+tail 对成功输出够用，但失败日志有更狠的裁法——构建/测试日志的
+ *  价值高度集中：几千行 pass 噪音里只有错误声明、断言详情和调用栈值钱。
+ *
+ *  策略分流（trimToolOutput）：
+ *  - failed=true → 只保留命中错误特征的行 + 前后 N 行上下文，区间合并，
+ *    区间之间插省略标记；错误行太多撑爆上限时最后一道闸仍是 head+tail。
+ *  - failed=false → head+tail（复用 adapter 的 pruneOutput，字节预算）。
+ *
+ *  两个上限不一样的理由：失败剪裁后信息密度极高（全是错误），8000 字符
+ *  ≈ 2000 tokens 足够模型定位问题；成功输出往往是结构化数据，多给配额。
+ */
+/** 错误行特征：命中任意一条就视为"值钱行"。 */
+const ERROR_MARKS = [
+    /\berror\b/i,
+    /\bfail(?:ed|ure)?\b/i,
+    /\bpanic\b/i,
+    /\bexception\b/i,
+    /\bassert/i,
+    /\btraceback\b/i,
+    /\bexit code [^0]/i,
+    /[✗✘×]/,
+];
+/**
+ * 失败日志剪裁：只留错误行 + 上下文。
+ * 没找到任何错误行时降级为 head+tail 字符裁剪。
+ */
+export function pruneFailureLog(text, opts) {
+    const contextLines = opts.contextLines ?? 2;
+    const lines = text.split("\n");
+    // 1. 标记所有值钱行（错误行 + 前后上下文）
+    const keep = new Set();
+    lines.forEach((line, i) => {
+        if (ERROR_MARKS.some((re) => re.test(line))) {
+            for (let j = Math.max(0, i - contextLines); j <= Math.min(lines.length - 1, i + contextLines); j += 1) {
+                keep.add(j);
+            }
+        }
+    });
+    // 2. 一个错误行都没命中——这份输出不像错误日志，降级 head+tail
+    const totalLines = lines.length;
+    const totalBytes = Buffer.byteLength(text, "utf8");
+    if (keep.size === 0) {
+        return { ...headTailChars(text, opts.maxChars), keptLines: totalLines, totalLines };
+    }
+    // 3. 保留行压成连续区间，区间之间插省略标记（runStart/skipped 双指针 O(n)）。
+    //    尾部攒下的 skipped 不输出——尾部噪音本来就不要。
+    const parts = [];
+    let runStart = -1;
+    let skipped = 0;
+    for (let i = 0; i <= lines.length; i += 1) {
+        const keeping = i < lines.length && keep.has(i);
+        if (keeping) {
+            if (runStart < 0) {
+                if (skipped > 0)
+                    parts.push(`…[省略 ${skipped} 行非错误输出]…`);
+                runStart = i;
+                skipped = 0;
+            }
+        }
+        else if (runStart >= 0) {
+            parts.push(lines.slice(runStart, i).join("\n"));
+            runStart = -1;
+        }
+        if (!keeping)
+            skipped += 1;
+    }
+    const joined = parts.join("\n");
+    if (joined.length <= opts.maxChars) {
+        return { text: joined, trimmed: true, keptLines: keep.size, totalLines, omittedBytes: totalBytes - Buffer.byteLength(joined, "utf8") };
+    }
+    // 4. 错误行太多把结果撑爆上限——最后一道闸仍是 head+tail
+    return { ...headTailChars(joined, opts.maxChars), keptLines: keep.size, totalLines };
+}
+/** 按字符预算做 head+tail（失败路径专用轻量版；成功路径走 adapter 的字节版）。 */
+function headTailChars(text, maxChars) {
+    if (text.length <= maxChars)
+        return { text, trimmed: false, omittedBytes: 0 };
+    const headBudget = Math.floor(maxChars * 0.7);
+    const tailBudget = Math.floor(maxChars * 0.25);
+    const omitted = text.length - headBudget - tailBudget;
+    const result = `${text.slice(0, headBudget)}\n…[省略 ${omitted} 字符，保留头尾]…\n${text.slice(text.length - tailBudget)}`;
+    return {
+        text: result,
+        trimmed: true,
+        omittedBytes: Buffer.byteLength(text, "utf8") - Buffer.byteLength(result, "utf8"),
+    };
+}
+/** 工具失败输出裁剪入口：超预算才裁（小失败输出保持原样），失败但没超预算不动。 */
+export function trimFailureOutput(text) {
+    if (text.length <= 8_000) {
+        const lines = text.split("\n").length;
+        return { text, trimmed: false, keptLines: lines, totalLines: lines, omittedBytes: 0 };
+    }
+    return pruneFailureLog(text, { contextLines: 2, maxChars: 8_000 });
+}
+//# sourceMappingURL=trim.js.map

package/dist/core/tools/trim.js.map

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

package/dist/core/tools/webfetch.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDef } from "../tools/def.js";
+export declare function isPrivateHost(hostname: string): boolean;
+/** 把 HTML 粗略转成纯文本：去 script/style、块级标签换行、超链接保留目标。
+ *  不追求精确——webfetch 的目标是让模型拿到可读内容，不是渲染网页。 */
+export declare function htmlToText(html: string): string;
+/** webfetch（spec §7.2）：抓取公网 URL 并转为文本。v0 experimental：
+ *  白名单域可后续在工具参数或产品配置层收紧，目前只有 SSRF 防护 +
+ *  大小/超时上限。 */
+export declare const webfetchTool: ToolDef;
+//# sourceMappingURL=webfetch.d.ts.map

package/dist/core/tools/webfetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webfetch.d.ts","sourceRoot":"","sources":["../../../src/core/tools/webfetch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAmB/C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAevD;AAED;4CAC4C;AAC5C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmB/C;AAKD;;eAEe;AACf,eAAO,MAAM,YAAY,EAAE,OAwC1B,CAAC"}

package/dist/core/tools/webfetch.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+/** 私网/回环/链路本地地址段（防 SSRF）：webfetch 只允许公网目标。 */
+const BLOCKED_CIDRS = [
+    [0x00000000, 8], // 0.0.0.0/8
+    [0x0a000000, 8], // 10.0.0.0/8
+    [0x7f000000, 8], // 127.0.0.0/8
+    [0xac100000, 12], // 172.16.0.0/12
+    [0xc0a80000, 16], // 192.168.0.0/16
+    [0xa9fe0000, 16], // 169.254.0.0/16
+    [0xc0000200, 24], // 192.0.2.0/24
+];
+function ipv4ToNumber(ip) {
+    const parts = ip.split(".").map((part) => Number.parseInt(part, 10));
+    if (parts.length !== 4 || parts.some((part) => Number.isNaN(part) || part < 0 || part > 255))
+        return null;
+    return ((parts[0] << 24) | (parts[1] << 16) | (parts[2] << 8) | parts[3]) >>> 0;
+}
+export function isPrivateHost(hostname) {
+    const host = hostname.toLowerCase().replace(/\.$/, "");
+    if (host === "localhost" || host.endsWith(".localhost"))
+        return true;
+    if (host.includes(":")) {
+        // IPv6：URL.hostname 会带方括号（如 [::1]），先去括号；只拦截回环与链路本地
+        // （v0 不做完整 IPv6 私网段判定，标记已知简化）
+        const ipv6 = host.startsWith("[") && host.endsWith("]") ? host.slice(1, -1) : host;
+        return ipv6 === "::1" || ipv6 === "::" || ipv6.startsWith("fe80:");
+    }
+    const number = ipv4ToNumber(host);
+    if (number === null)
+        return false; // 域名按公网放行（DNS 解析层面不做二次校验，标记已知简化）
+    return BLOCKED_CIDRS.some(([base, prefix]) => {
+        const mask = prefix === 0 ? 0 : (0xffffffff << (32 - prefix)) >>> 0;
+        return (number & mask) === (base & mask);
+    });
+}
+/** 把 HTML 粗略转成纯文本：去 script/style、块级标签换行、超链接保留目标。
+ *  不追求精确——webfetch 的目标是让模型拿到可读内容，不是渲染网页。 */
+export function htmlToText(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[\s\S]*?<\/style>/gi, "")
+        .replace(/<head[\s\S]*?<\/head>/gi, "")
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/(p|div|li|h[1-6]|tr|blockquote|pre|section|article)>/gi, "\n")
+        .replace(/<li[^>]*>/gi, "\n- ")
+        .replace(/<a[^>]+href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi, "$2 ($1)")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&nbsp;/gi, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\n{2,}/g, "\n")
+        .replace(/[ \t]+\n/g, "\n")
+        .trim();
+}
+const MAX_RESPONSE_BYTES = 256 * 1024;
+const FETCH_TIMEOUT_MS = 15_000;
+/** webfetch（spec §7.2）：抓取公网 URL 并转为文本。v0 experimental：
+ *  白名单域可后续在工具参数或产品配置层收紧，目前只有 SSRF 防护 +
+ *  大小/超时上限。 */
+export const webfetchTool = {
+    id: "webfetch",
+    label: "抓取网页",
+    description: "（experimental）抓取一个公网网页并返回文本内容，供分析文档、查阅资料使用。只允许 http(s) 公网地址，私网/本机地址会被拒绝。响应超过 256KB 会被截断。",
+    parameters: z.object({
+        url: z.string().url().max(2048).refine((value) => /^https?:\/\//i.test(value), { message: "只支持 http/https URL" }),
+    }),
+    permission: (args) => ({ permission: "webfetch", patterns: [args.url] }),
+    async execute(args) {
+        const target = new URL(args.url);
+        if (isPrivateHost(target.hostname)) {
+            throw new Error(`拒绝访问非公网地址：${target.hostname}（webfetch 只允许公网目标）`);
+        }
+        let response;
+        try {
+            response = await fetch(target, { redirect: "follow", signal: AbortSignal.timeout(FETCH_TIMEOUT_MS), headers: { "user-agent": "zmzai-agent/0.1 (webfetch)" } });
+        }
+        catch (error) {
+            throw new Error(`抓取失败：${error instanceof Error ? error.message : "网络错误"}`);
+        }
+        if (!response.ok)
+            throw new Error(`抓取失败：HTTP ${response.status} ${response.statusText}`);
+        const contentType = response.headers.get("content-type") ?? "";
+        const raw = await response.text();
+        const bytes = Buffer.byteLength(raw, "utf8");
+        const truncated = bytes > MAX_RESPONSE_BYTES;
+        const text = truncated ? raw.slice(0, Math.floor(MAX_RESPONSE_BYTES / 2)) : raw;
+        let output;
+        if (/text\/html|application\/xhtml/i.test(contentType))
+            output = htmlToText(text);
+        else
+            output = text.trim();
+        if (truncated)
+            output += `\n\n…[内容超过 ${MAX_RESPONSE_BYTES} 字节已截断]…`;
+        return {
+            title: `抓取 ${target.hostname}`,
+            output: output || "（页面无文本内容）",
+            metadata: { url: args.url, contentType, bytes, truncated },
+        };
+    },
+};
+//# sourceMappingURL=webfetch.js.map

package/dist/core/tools/webfetch.js.map

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

package/dist/core/tools/websearch.d.ts

@@ -0,0 +1,19 @@
+import type { ToolDef } from "../tools/def.js";
+/** websearch（P0 补齐）：联网搜索工具。后端策略按可用凭据自动选择：
+ *  TAVILY_API_KEY / SERPER_API_KEY 配置时走对应 API，否则回退
+ *  DuckDuckGo Lite HTML 抓取（零依赖、无 key）。fetchImpl/envLoader 可注入，
+ *  便于测试与产品侧统一代理。 */
+export type WebSearchResult = {
+    title: string;
+    url: string;
+    snippet: string;
+};
+export type WebSearchOptions = {
+    fetchImpl?: typeof fetch;
+    /** 注入点：默认读 process.env。返回任意 provider key 时优先对应 API。 */
+    envLoader?: () => Record<string, string | undefined>;
+};
+/** 解析 DuckDuckGo Lite 结果页。href 常为 /l/?uddg=<encoded> 重定向，需还原真实 URL。 */
+export declare function parseDuckDuckGoHtml(html: string): WebSearchResult[];
+export declare function createWebSearchTool(opts?: WebSearchOptions): ToolDef;
+//# sourceMappingURL=websearch.d.ts.map

package/dist/core/tools/websearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websearch.d.ts","sourceRoot":"","sources":["../../../src/core/tools/websearch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;oBAGoB;AAEpB,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAK9E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACtD,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAenE;AAoED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CA4CxE"}