@kavienw/deepseek-cli 0.1.0

package/dist/tools/index.js

@@ -0,0 +1,60 @@
+import { readTool } from "./read.js";
+import { writeTool } from "./write.js";
+import { editTool } from "./edit.js";
+import { bashTool } from "./bash.js";
+import { grepTool } from "./grep.js";
+import { globTool } from "./glob.js";
+import { webSearchTool } from "./webSearch.js";
+import { webFetchTool } from "./webFetch.js";
+import { setThinkingTool } from "./setThinking.js";
+import { todoReadTool, todoWriteTool } from "./todo.js";
+import { taskTool } from "./task.js";
+const BASE_TOOLS = [
+    readTool,
+    writeTool,
+    editTool,
+    bashTool,
+    grepTool,
+    globTool,
+    webSearchTool,
+    webFetchTool,
+    setThinkingTool,
+    todoReadTool,
+    todoWriteTool,
+    taskTool,
+];
+export const ALL_TOOLS = [...BASE_TOOLS];
+const TOOL_MAP = new Map(ALL_TOOLS.map((t) => [t.name, t]));
+export function registerExternalTools(tools) {
+    for (const tool of tools) {
+        const existingIndex = ALL_TOOLS.findIndex((candidate) => candidate.name === tool.name);
+        if (existingIndex === -1)
+            ALL_TOOLS.push(tool);
+        else
+            ALL_TOOLS[existingIndex] = tool;
+        TOOL_MAP.set(tool.name, tool);
+    }
+}
+export function clearExternalTools(prefix = "mcp__") {
+    for (let index = ALL_TOOLS.length - 1; index >= 0; index--) {
+        if (ALL_TOOLS[index].name.startsWith(prefix)) {
+            TOOL_MAP.delete(ALL_TOOLS[index].name);
+            ALL_TOOLS.splice(index, 1);
+        }
+    }
+}
+export function getTool(name) {
+    return TOOL_MAP.get(name);
+}
+/** Convert our tool definitions into the OpenAI function-calling schema. */
+export function toOpenAITools() {
+    return ALL_TOOLS.map((tool) => ({
+        type: "function",
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.parameters,
+        },
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC,MAAM,UAAU,GAAW;IACzB,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,aAAa;IACb,YAAY;IACZ,eAAe;IACf,YAAY;IACZ,aAAa;IACb,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAW,CAAC,GAAG,UAAU,CAAC,CAAC;AACjD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5D,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,aAAa,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QACvF,IAAI,aAAa,KAAK,CAAC,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YAC1C,SAAS,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;QACrC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAM,GAAG,OAAO;IACjD,KAAK,IAAI,KAAK,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3D,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;YACvC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/tools/read.js

@@ -0,0 +1,62 @@
+import fs from "node:fs";
+import path from "node:path";
+const MAX_LINES = 2000;
+const MAX_LINE_LEN = 2000;
+export const readTool = {
+    name: "read_file",
+    description: "Read a file from the local filesystem. Returns the contents with line numbers. " +
+        "Use this before editing a file. Long files are truncated.",
+    needsApproval: false,
+    parameters: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "Path to the file (absolute, or relative to the working directory).",
+            },
+            offset: {
+                type: "number",
+                description: "1-based line number to start reading from (optional).",
+            },
+            limit: {
+                type: "number",
+                description: `Maximum number of lines to read (optional, default ${MAX_LINES}).`,
+            },
+        },
+        required: ["path"],
+    },
+    preview(args) {
+        return `read ${String(args.path)}`;
+    },
+    async run(args, ctx) {
+        const rel = String(args.path);
+        const abs = path.isAbsolute(rel) ? rel : path.join(ctx.cwd, rel);
+        if (!fs.existsSync(abs)) {
+            return { content: `Error: file not found: ${rel}`, isError: true };
+        }
+        const stat = fs.statSync(abs);
+        if (stat.isDirectory()) {
+            return { content: `Error: ${rel} is a directory, not a file.`, isError: true };
+        }
+        const raw = fs.readFileSync(abs, "utf8");
+        const allLines = raw.split("\n");
+        const offset = args.offset ? Math.max(1, Number(args.offset)) : 1;
+        const limit = args.limit ? Number(args.limit) : MAX_LINES;
+        const slice = allLines.slice(offset - 1, offset - 1 + limit);
+        const numbered = slice
+            .map((line, i) => {
+            const n = offset + i;
+            const truncated = line.length > MAX_LINE_LEN ? line.slice(0, MAX_LINE_LEN) + " …[truncated]" : line;
+            return `${String(n).padStart(6)}\t${truncated}`;
+        })
+            .join("\n");
+        const more = offset - 1 + limit < allLines.length
+            ? `\n\n[file has ${allLines.length} lines total; showing ${offset}-${offset + slice.length - 1}]`
+            : "";
+        return {
+            content: numbered + more || "[empty file]",
+            summary: `Read ${rel} (${slice.length} lines)`,
+        };
+    },
+};
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/setThinking.js

@@ -0,0 +1,46 @@
+function normalize(raw) {
+    const v = raw.trim().toLowerCase();
+    if (["off", "hide", "none", "disable", "false"].includes(v))
+        return "off";
+    if (["collapsed", "short", "fold"].includes(v))
+        return "collapsed";
+    if (["full", "on", "show", "all", "enable", "true"].includes(v))
+        return "full";
+    return null;
+}
+export const setThinkingTool = {
+    name: "set_thinking",
+    description: "Show or hide your own reasoning/thinking trace in the terminal. Call this ONLY when the user " +
+        "explicitly asks to turn the thinking/reasoning display on or off (e.g. \"关闭思考\", \"显示你的思考\", " +
+        "\"hide your thinking\", \"show reasoning\"). mode: off = hide, full = show everything, collapsed = show first lines.",
+    needsApproval: false,
+    parameters: {
+        type: "object",
+        properties: {
+            mode: {
+                type: "string",
+                description: "off (hide), full/on (show all), or collapsed (show first lines).",
+            },
+        },
+        required: ["mode"],
+    },
+    preview(args) {
+        return `set thinking display: ${String(args.mode)}`;
+    },
+    async run(args, ctx) {
+        const mode = normalize(String(args.mode ?? ""));
+        if (!mode) {
+            return { content: `Invalid mode '${String(args.mode)}'. Use off, collapsed, or full.`, isError: true };
+        }
+        if (!ctx.setThinkingMode) {
+            return { content: "Thinking display cannot be changed in this context.", isError: true };
+        }
+        ctx.setThinkingMode(mode);
+        const label = mode === "off" ? "hidden" : mode === "collapsed" ? "collapsed (first lines)" : "full";
+        return {
+            content: `Thinking display is now ${label}. This takes effect on the next reply.`,
+            summary: `thinking display → ${mode}`,
+        };
+    },
+};
+//# sourceMappingURL=setThinking.js.map

package/dist/tools/setThinking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setThinking.js","sourceRoot":"","sources":["../../src/tools/setThinking.ts"],"names":[],"mappings":"AAGA,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC;IACnE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IAC/E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,+FAA+F;QAC/F,+FAA+F;QAC/F,sHAAsH;IACxH,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kEAAkE;aAChF;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,CAAC,IAAI;QACV,OAAO,yBAAyB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACtD,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;QACjB,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,OAAO,EAAE,iBAAiB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,iCAAiC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACzG,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,qDAAqD,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3F,CAAC;QACD,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,MAAM,CAAC;QACpG,OAAO;YACL,OAAO,EAAE,2BAA2B,KAAK,wCAAwC;YACjF,OAAO,EAAE,sBAAsB,IAAI,EAAE;SACtC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/task.js

@@ -0,0 +1,40 @@
+export const taskTool = {
+    name: "task",
+    description: "Delegate a self-contained sub-task to an isolated sub-agent that has its own fresh context and the " +
+        "standard tools (read_file, search_text, list_files, edit_file, bash, etc.). Returns the sub-agent's " +
+        "final answer. Use it for focused research or multi-step work you want handled separately so it does " +
+        "not clutter the main conversation. Provide a complete, standalone prompt — the sub-agent cannot see " +
+        "this conversation.",
+    needsApproval: false,
+    parameters: {
+        type: "object",
+        properties: {
+            prompt: {
+                type: "string",
+                description: "The complete, standalone task for the sub-agent (it has no other context).",
+            },
+            tools: {
+                type: "array",
+                items: { type: "string" },
+                description: "Optional allowlist of tool names the sub-agent may use (defaults to all except 'task').",
+            },
+        },
+        required: ["prompt"],
+    },
+    preview(args) {
+        return `task: ${String(args.prompt ?? "").slice(0, 80)}`;
+    },
+    async run(args, ctx) {
+        if (!ctx.runSubagent) {
+            return { content: "Sub-agent execution is not available in this context.", isError: true };
+        }
+        const prompt = String(args.prompt ?? "").trim();
+        if (!prompt) {
+            return { content: "task requires a non-empty 'prompt'.", isError: true };
+        }
+        const tools = Array.isArray(args.tools) ? args.tools.map(String) : undefined;
+        const answer = await ctx.runSubagent(prompt, tools ? { tools } : undefined);
+        return { content: answer, summary: "task complete" };
+    },
+};
+//# sourceMappingURL=task.js.map

package/dist/tools/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/tools/task.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,qGAAqG;QACrG,sGAAsG;QACtG,sGAAsG;QACtG,sGAAsG;QACtG,oBAAoB;IACtB,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4EAA4E;aAC1F;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,yFAAyF;aACvG;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;IACD,OAAO,CAAC,IAAI;QACV,OAAO,SAAS,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC3D,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;QACjB,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,EAAE,OAAO,EAAE,uDAAuD,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7F,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,qCAAqC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3E,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IACvD,CAAC;CACF,CAAC"}

package/dist/tools/todo.js

@@ -0,0 +1,73 @@
+import { formatTodoList, validateTodos } from "../todo.js";
+export const todoReadTool = {
+    name: "todo_read",
+    description: "Read the current task list. Use this before updating todos when you are not sure what is already tracked.",
+    needsApproval: false,
+    parameters: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+    },
+    async run(_args, ctx) {
+        const todos = ctx.todoStore?.list() ?? [];
+        const formatted = formatTodoList(todos);
+        return {
+            content: formatted,
+            summary: todos.length === 0 ? "todos: none" : `todos: ${todos.length} item${todos.length === 1 ? "" : "s"}`,
+            display: formatted,
+        };
+    },
+};
+export const todoWriteTool = {
+    name: "todo_write",
+    description: "Create or update the session task list for multi-step work. Use this for non-trivial coding tasks, keeping exactly one item in_progress at a time. " +
+        "Replace the whole list each time with concise pending/in_progress/completed items.",
+    needsApproval: false,
+    parameters: {
+        type: "object",
+        properties: {
+            todos: {
+                type: "array",
+                description: "The complete replacement todo list.",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string", description: "Stable short id, e.g. inspect, implement, verify." },
+                        content: { type: "string", description: "Concise task text." },
+                        status: {
+                            type: "string",
+                            enum: ["pending", "in_progress", "completed"],
+                            description: "Current task status. Only one item may be in_progress.",
+                        },
+                    },
+                    required: ["content", "status"],
+                    additionalProperties: false,
+                },
+            },
+        },
+        required: ["todos"],
+        additionalProperties: false,
+    },
+    preview(args) {
+        const count = Array.isArray(args.todos) ? args.todos.length : 0;
+        return `update todo list (${count} item${count === 1 ? "" : "s"})`;
+    },
+    async run(args, ctx) {
+        if (!ctx.todoStore) {
+            return { content: "Error: todo store is unavailable.", isError: true };
+        }
+        const result = validateTodos(args.todos);
+        if (result.error) {
+            return { content: `Error: ${result.error}`, isError: true };
+        }
+        const todos = result.todos ?? [];
+        ctx.todoStore.replace(todos);
+        const formatted = formatTodoList(todos);
+        return {
+            content: `Todo list updated.\n${formatted}`,
+            summary: todos.length === 0 ? "todos cleared" : `todos updated (${todos.length})`,
+            display: formatted,
+        };
+    },
+};
+//# sourceMappingURL=todo.js.map

package/dist/tools/todo.js.map

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

package/dist/tools/types.js

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

package/dist/tools/types.js.map

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

package/dist/tools/webFetch.js

@@ -0,0 +1,64 @@
+const MAX_CHARS = 20_000;
+export function htmlToText(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style[\s\S]*?<\/style>/gi, " ")
+        .replace(/<noscript[\s\S]*?<\/noscript>/gi, " ")
+        .replace(/<!--[\s\S]*?-->/g, " ")
+        .replace(/<\/(p|div|h[1-6]|li|tr|br|section|article)>/gi, "\n")
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/[ \t]+/g, " ")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+export const webFetchTool = {
+    name: "web_fetch",
+    description: "Fetch a URL and return its text content (HTML is stripped to readable text). " +
+        "Use for reading documentation or pages the user links to.",
+    needsApproval: false,
+    parameters: {
+        type: "object",
+        properties: {
+            url: { type: "string", description: "The absolute URL to fetch (http/https)." },
+        },
+        required: ["url"],
+    },
+    preview(args) {
+        return `fetch ${String(args.url)}`;
+    },
+    async run(args) {
+        const url = String(args.url);
+        if (!/^https?:\/\//i.test(url)) {
+            return { content: "Error: url must start with http:// or https://", isError: true };
+        }
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 30_000);
+            const res = await fetch(url, {
+                signal: controller.signal,
+                headers: { "User-Agent": "deepseek-cli/0.1 (+https://github.com)" },
+            });
+            clearTimeout(timer);
+            if (!res.ok) {
+                return { content: `Error: HTTP ${res.status} ${res.statusText} for ${url}`, isError: true };
+            }
+            const contentType = res.headers.get("content-type") || "";
+            const body = await res.text();
+            const text = contentType.includes("html") ? htmlToText(body) : body;
+            const clipped = text.length > MAX_CHARS ? text.slice(0, MAX_CHARS) + "\n…[content truncated]" : text;
+            return { content: clipped || "(empty response)", summary: `Fetched ${url}` };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { content: `Error fetching ${url}: ${msg}`, isError: true };
+        }
+    },
+};
+//# sourceMappingURL=webFetch.js.map

package/dist/tools/webFetch.js.map

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

package/dist/tools/webSearch.js

@@ -0,0 +1,200 @@
+const TIMEOUT_MS = 20_000;
+function decodeEntities(s) {
+    return s
+        .replace(/<[^>]+>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#x27;|&#39;/g, "'")
+        .trim();
+}
+async function fetchWithTimeout(url, init) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+        return await fetch(url, { ...init, signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Decide which provider to use based on env configuration. */
+function selectProvider() {
+    const explicit = (process.env.WEB_SEARCH_PROVIDER || "").trim().toLowerCase();
+    if (explicit === "bocha")
+        return "bocha";
+    if (explicit === "tavily")
+        return "tavily";
+    if (explicit === "duckduckgo" || explicit === "ddg")
+        return "duckduckgo";
+    if (process.env.BOCHA_API_KEY)
+        return "bocha";
+    if (process.env.TAVILY_API_KEY)
+        return "tavily";
+    return "duckduckgo";
+}
+// ---------------------------------------------------------------------------
+// Bocha (博查) — https://open.bochaai.com  | China-friendly, AI search API.
+// ---------------------------------------------------------------------------
+async function searchBocha(query, limit) {
+    const key = process.env.BOCHA_API_KEY;
+    if (!key)
+        throw new Error("BOCHA_API_KEY is not set");
+    const res = await fetchWithTimeout("https://api.bochaai.com/v1/web-search", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${key}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ query, summary: true, count: limit, page: 1 }),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Bocha HTTP ${res.status} ${res.statusText} ${body.slice(0, 200)}`.trim());
+    }
+    const data = (await res.json());
+    if (data.code !== undefined && data.code !== 200) {
+        throw new Error(`Bocha error ${data.code}: ${data.msg ?? "unknown"}`);
+    }
+    const value = data.data?.webPages?.value ?? [];
+    const hits = value.slice(0, limit).map((item) => ({
+        title: item.name ?? "(untitled)",
+        url: item.url ?? "",
+        snippet: (item.summary || item.snippet || "").trim(),
+    }));
+    return { hits };
+}
+// ---------------------------------------------------------------------------
+// Tavily — https://tavily.com  | reliable international AI search API.
+// ---------------------------------------------------------------------------
+async function searchTavily(query, limit) {
+    const key = process.env.TAVILY_API_KEY;
+    if (!key)
+        throw new Error("TAVILY_API_KEY is not set");
+    const res = await fetchWithTimeout("https://api.tavily.com/search", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${key}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ query, max_results: limit, search_depth: "basic" }),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Tavily HTTP ${res.status} ${res.statusText} ${body.slice(0, 200)}`.trim());
+    }
+    const data = (await res.json());
+    const hits = (data.results ?? []).slice(0, limit).map((item) => ({
+        title: item.title ?? "(untitled)",
+        url: item.url ?? "",
+        snippet: (item.content ?? "").trim(),
+    }));
+    return { hits, answer: data.answer?.trim() || undefined };
+}
+// ---------------------------------------------------------------------------
+// DuckDuckGo HTML — no key, but often blocked/unreliable (e.g. mainland China).
+// ---------------------------------------------------------------------------
+function unwrapDuckUrl(href) {
+    try {
+        const u = href.startsWith("//") ? "https:" + href : href;
+        const parsed = new URL(u, "https://duckduckgo.com");
+        const uddg = parsed.searchParams.get("uddg");
+        return uddg ? decodeURIComponent(uddg) : href;
+    }
+    catch {
+        return href;
+    }
+}
+function parseDuckResults(html, limit) {
+    const hits = [];
+    const linkRe = /<a[^>]*class="result__a"[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/gi;
+    const snippetRe = /<a[^>]*class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi;
+    const snippets = [];
+    let sm;
+    while ((sm = snippetRe.exec(html)) !== null)
+        snippets.push(decodeEntities(sm[1]));
+    let m;
+    let i = 0;
+    while ((m = linkRe.exec(html)) !== null && hits.length < limit) {
+        hits.push({
+            url: unwrapDuckUrl(m[1]),
+            title: decodeEntities(m[2]),
+            snippet: snippets[i] ?? "",
+        });
+        i++;
+    }
+    return hits;
+}
+async function searchDuckDuckGo(query, limit) {
+    const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
+    const res = await fetchWithTimeout(url, {
+        headers: {
+            "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120 Safari/537.36",
+        },
+    });
+    if (!res.ok)
+        throw new Error(`DuckDuckGo HTTP ${res.status}`);
+    const html = await res.text();
+    return { hits: parseDuckResults(html, limit) };
+}
+const PROVIDERS = {
+    bocha: searchBocha,
+    tavily: searchTavily,
+    duckduckgo: searchDuckDuckGo,
+};
+export const webSearchTool = {
+    name: "web_search",
+    description: "Search the web and return a list of result titles, URLs, and snippets. " +
+        "Uses the configured provider (Bocha or Tavily via API key; DuckDuckGo otherwise). " +
+        "Follow up with web_fetch to read a specific result.",
+    needsApproval: false,
+    parameters: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "The search query." },
+            limit: { type: "number", description: "Max results to return (optional, default 8)." },
+        },
+        required: ["query"],
+    },
+    preview(args) {
+        return `search "${String(args.query)}"`;
+    },
+    async run(args) {
+        const query = String(args.query);
+        const limit = Math.min(Number(args.limit) || 8, 15);
+        const provider = selectProvider();
+        try {
+            const { hits, answer } = await PROVIDERS[provider](query, limit);
+            if (hits.length === 0 && !answer) {
+                return {
+                    content: `No results for "${query}" (provider: ${provider}).`,
+                    summary: `search "${query}" via ${provider}: 0 results`,
+                };
+            }
+            const sections = [];
+            if (answer)
+                sections.push(`Answer: ${answer}`);
+            sections.push(hits
+                .map((h, i) => `${i + 1}. ${h.title}\n   ${h.url}\n   ${h.snippet}`.trimEnd())
+                .join("\n\n"));
+            return {
+                content: sections.filter(Boolean).join("\n\n"),
+                summary: `search "${query}" via ${provider}: ${hits.length} results`,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            const hint = provider === "duckduckgo"
+                ? " DuckDuckGo may be blocked on this network — set BOCHA_API_KEY (recommended in China) or TAVILY_API_KEY to use a reliable provider."
+                : "";
+            return {
+                content: `Error searching via ${provider}: ${msg}.${hint}`,
+                summary: `search "${query}" via ${provider}: failed`,
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=webSearch.js.map

package/dist/tools/webSearch.js.map

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