@smartledger.technology/openai-claw 0.1.0

package/dist/tools/semantic.js

@@ -0,0 +1,40 @@
+import { ok, err } from "./types.js";
+import { semanticSearch } from "../rag/index.js";
+export const semanticTool = {
+    name: "Semantic",
+    description: "Search the project by semantic meaning, not literal pattern. Returns the top-K most relevant code chunks ranked by embedding similarity. Use this when the user describes what they want by intent (e.g. \"where is auth checked?\") rather than by exact string. Falls back to a helpful error if the index hasn't been built — run /index first.",
+    needsPermission: false,
+    mutates: false,
+    parameters: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Natural-language query — describe what you're looking for" },
+            k: { type: "number", description: "Top-K hits to return (default 8)" },
+            snippets: {
+                type: "boolean",
+                description: "Include the chunk text in the output (default false: file paths + scores only)",
+            },
+        },
+        required: ["query"],
+    },
+    async run(input, ctx) {
+        try {
+            const k = Math.max(1, Math.min(50, input.k ?? 8));
+            const hits = await semanticSearch(ctx.config, input.query, k);
+            if (hits.length === 0)
+                return ok("(no hits)");
+            const lines = hits.map((h, i) => {
+                const head = `${i + 1}. ${h.file}#${h.chunkIndex} (score=${h.score.toFixed(3)})`;
+                if (!input.snippets)
+                    return head;
+                return `${head}\n${h.text.slice(0, 800)}${h.text.length > 800 ? "\n…" : ""}`;
+            });
+            return ok(lines.join("\n\n"));
+        }
+        catch (e) {
+            return err(e?.message ?? String(e));
+        }
+    },
+    preview: (input) => `Semantic ${JSON.stringify(input.query).slice(0, 60)}`,
+};
+//# sourceMappingURL=semantic.js.map

package/dist/tools/semantic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.js","sourceRoot":"","sources":["../../src/tools/semantic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,EAAE,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,YAAY,GAA4D;IACnF,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,oVAAoV;IACtV,eAAe,EAAE,KAAK;IACtB,OAAO,EAAE,KAAK;IACd,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;YACnG,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;YACtE,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,gFAAgF;aAC9F;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG;QAClB,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC9D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;gBACjF,IAAI,CAAC,KAAK,CAAC,QAAQ;oBAAE,OAAO,IAAI,CAAC;gBACjC,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC/E,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,GAAG,CAAC,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;CAC3E,CAAC"}

package/dist/tools/shell.js

@@ -0,0 +1,131 @@
+import fs from "node:fs";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { ok, err } from "./types.js";
+const shells = new Map();
+function shellsDir(config) {
+    const dir = path.join(config.projectDir, "shells");
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    return dir;
+}
+function nextShellId() {
+    return `sh_${Date.now().toString(36)}_${Math.floor(Math.random() * 0xfff).toString(16)}`;
+}
+/** Spawn a background shell. Caller is responsible for messaging the agent. */
+export function spawnBackgroundShell(config, command) {
+    const dir = shellsDir(config);
+    const id = nextShellId();
+    const logFile = path.join(dir, `${id}.log`);
+    const out = fs.openSync(logFile, "w");
+    const child = spawn("bash", ["-c", command], {
+        cwd: config.workdir,
+        env: process.env,
+        stdio: ["ignore", out, out],
+        detached: true,
+    });
+    child.unref();
+    const shell = {
+        id,
+        pid: child.pid ?? -1,
+        command,
+        startedAt: Date.now(),
+        logFile,
+        child,
+        status: "running",
+        exitCode: null,
+        cursor: 0,
+    };
+    child.on("exit", (code, signal) => {
+        shell.status = signal === "SIGKILL" || signal === "SIGTERM" ? "killed" : "exited";
+        shell.exitCode = code;
+        try {
+            fs.closeSync(out);
+        }
+        catch { }
+    });
+    shells.set(id, shell);
+    return shell;
+}
+function readLogTail(shell, fromCursor) {
+    if (!fs.existsSync(shell.logFile))
+        return { chunk: "", newCursor: shell.cursor };
+    const stat = fs.statSync(shell.logFile);
+    const start = fromCursor ? shell.cursor : 0;
+    if (start >= stat.size)
+        return { chunk: "", newCursor: stat.size };
+    const fd = fs.openSync(shell.logFile, "r");
+    const len = stat.size - start;
+    const buf = Buffer.alloc(len);
+    fs.readSync(fd, buf, 0, len, start);
+    fs.closeSync(fd);
+    return { chunk: buf.toString("utf8"), newCursor: stat.size };
+}
+export const bashOutputTool = {
+    name: "BashOutput",
+    description: "Retrieve new output from a background Bash shell since the last poll. Returns the shell's status (running/exited/killed) and the new stdout+stderr bytes. Use this to monitor long-running jobs you launched with Bash(run_in_background: true).",
+    needsPermission: false,
+    mutates: false,
+    parameters: {
+        type: "object",
+        properties: {
+            shell_id: { type: "string", description: "Shell id returned by Bash(run_in_background: true)" },
+            from_start: { type: "boolean", description: "Re-read all output from the beginning (default false: resume from cursor)" },
+        },
+        required: ["shell_id"],
+    },
+    async run(input) {
+        const shell = shells.get(input.shell_id);
+        if (!shell)
+            return err(`Unknown shell_id: ${input.shell_id}`);
+        const { chunk, newCursor } = readLogTail(shell, !input.from_start);
+        if (!input.from_start)
+            shell.cursor = newCursor;
+        const header = `[shell ${shell.id} status=${shell.status}${shell.exitCode !== null ? ` exit=${shell.exitCode}` : ""}]`;
+        return ok(`${header}\n${chunk || "(no new output)"}`);
+    },
+    preview: (input) => `BashOutput ${input.shell_id}`,
+};
+export const killShellTool = {
+    name: "KillShell",
+    description: "Terminate a background Bash shell by id. Sends SIGTERM, then SIGKILL after 2s.",
+    needsPermission: true,
+    mutates: true,
+    parameters: {
+        type: "object",
+        properties: {
+            shell_id: { type: "string", description: "Shell id to kill" },
+        },
+        required: ["shell_id"],
+    },
+    async run(input) {
+        const shell = shells.get(input.shell_id);
+        if (!shell)
+            return err(`Unknown shell_id: ${input.shell_id}`);
+        if (shell.status !== "running")
+            return ok(`Shell ${shell.id} already ${shell.status}.`);
+        try {
+            shell.child.kill("SIGTERM");
+            setTimeout(() => {
+                if (shell.status === "running")
+                    shell.child.kill("SIGKILL");
+            }, 2000);
+            return ok(`Sent SIGTERM to shell ${shell.id}.`);
+        }
+        catch (e) {
+            return err(`KillShell failed: ${e?.message ?? String(e)}`);
+        }
+    },
+    preview: (input) => `KillShell ${input.shell_id}`,
+};
+/** For /agents-style introspection. */
+export function listShells() {
+    return Array.from(shells.values()).map((s) => ({
+        id: s.id,
+        pid: s.pid,
+        command: s.command,
+        status: s.status,
+        exitCode: s.exitCode,
+    }));
+}
+//# sourceMappingURL=shell.js.map

package/dist/tools/shell.js.map

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

package/dist/tools/task.js

@@ -0,0 +1,91 @@
+import { ok, err } from "./types.js";
+import { listSubagents } from "../subagents/index.js";
+/** Built lazily so registered agents in .claw/agents/ surface at runtime. */
+export function buildTaskTool(config) {
+    const agents = listSubagents(config);
+    const enumNames = agents.map((a) => a.name);
+    const catalog = agents
+        .map((a) => `- ${a.name}${a.tools ? ` (tools: ${a.tools.join(",")})` : ""}: ${a.description}`)
+        .join("\n");
+    return {
+        name: "Task",
+        description: `Launch a subagent to handle complex multi-step work in an isolated context. Use for: open-ended research, parallel investigations, or tasks whose tool output would crowd the parent's context. Brief the subagent thoroughly — it sees none of this conversation. Set isolation="worktree" to run the subagent in a temporary git worktree; the returned text will include the diff.\nAvailable subagent types:\n${catalog}`,
+        needsPermission: false,
+        mutates: false,
+        parameters: {
+            type: "object",
+            properties: {
+                description: { type: "string", description: "Short (3-5 word) description of the task" },
+                prompt: { type: "string", description: "Self-contained instructions for the subagent" },
+                subagent_type: {
+                    type: "string",
+                    enum: enumNames,
+                    description: "Which subagent type to use (default 'general-purpose')",
+                },
+                isolation: {
+                    type: "string",
+                    enum: ["worktree"],
+                    description: "If 'worktree', the subagent runs in a fresh git worktree and its diff is returned.",
+                },
+            },
+            required: ["description", "prompt"],
+        },
+        async run(input, ctx) {
+            if (!ctx.spawnSubagent)
+                return err("Subagent spawning is not available in this context.");
+            if (input.subagent_type && !enumNames.includes(input.subagent_type)) {
+                return err(`Unknown subagent_type: ${input.subagent_type}. Available: ${enumNames.join(", ")}`);
+            }
+            try {
+                const result = await ctx.spawnSubagent({
+                    description: input.description,
+                    prompt: input.prompt,
+                    subagent_type: input.subagent_type,
+                    isolation: input.isolation,
+                });
+                return ok(result);
+            }
+            catch (e) {
+                return err(`Subagent failed: ${e?.message ?? String(e)}`);
+            }
+        },
+        preview: (input) => `Task: ${input.description}${input.isolation ? " [worktree]" : ""}`,
+    };
+}
+/** Static fallback (kept for backwards compat with the existing exports). */
+export const taskTool = {
+    name: "Task",
+    description: "Launch a subagent to handle complex multi-step work in an isolated context. Use for: open-ended research, parallel investigations, or tasks whose tool output would crowd the parent's context. Brief the subagent thoroughly — it sees none of this conversation. Available subagent types: 'general-purpose', 'explore' (read-only search).",
+    needsPermission: false,
+    mutates: false,
+    parameters: {
+        type: "object",
+        properties: {
+            description: { type: "string", description: "Short (3-5 word) description of the task" },
+            prompt: { type: "string", description: "Self-contained instructions for the subagent" },
+            subagent_type: {
+                type: "string",
+                enum: ["general-purpose", "explore"],
+                description: "Which subagent type to use (default 'general-purpose')",
+            },
+        },
+        required: ["description", "prompt"],
+    },
+    async run(input, ctx) {
+        if (!ctx.spawnSubagent)
+            return err("Subagent spawning is not available in this context.");
+        try {
+            const result = await ctx.spawnSubagent({
+                description: input.description,
+                prompt: input.prompt,
+                subagent_type: input.subagent_type,
+            });
+            return ok(result);
+        }
+        catch (e) {
+            return err(`Subagent failed: ${e?.message ?? String(e)}`);
+        }
+    },
+    preview: (input) => `Task: ${input.description}`,
+};
+//# 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":"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"}

package/dist/tools/todo.js

@@ -0,0 +1,64 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ok } from "./types.js";
+let todoList = [];
+export function getTodos() {
+    return todoList;
+}
+function todosFile(memoryDir) {
+    return path.join(memoryDir, "todos.json");
+}
+export function loadTodos(memoryDir) {
+    try {
+        const f = todosFile(memoryDir);
+        if (!fs.existsSync(f))
+            return;
+        const raw = JSON.parse(fs.readFileSync(f, "utf8"));
+        if (Array.isArray(raw))
+            todoList = raw;
+    }
+    catch {
+        // ignore — start fresh
+    }
+}
+export const todoWriteTool = {
+    name: "TodoWrite",
+    description: "Create and manage a structured todo list for the current session. Use for tasks that span 3+ steps. Replace the whole list each call. Mark exactly one item in_progress at a time. The list is persisted to disk and survives /resume.",
+    needsPermission: false,
+    mutates: false,
+    parameters: {
+        type: "object",
+        properties: {
+            todos: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        content: { type: "string", description: "Imperative form, e.g. 'Run the tests'" },
+                        status: { type: "string", enum: ["pending", "in_progress", "completed"] },
+                        activeForm: { type: "string", description: "Present continuous, e.g. 'Running the tests'" },
+                    },
+                    required: ["content", "status"],
+                },
+            },
+        },
+        required: ["todos"],
+    },
+    async run(input, ctx) {
+        todoList = input.todos;
+        try {
+            fs.writeFileSync(todosFile(ctx.config.memoryDir), JSON.stringify(todoList, null, 2));
+        }
+        catch {
+            // persistence failure is non-fatal — the in-memory list still works for this turn
+        }
+        const formatted = todoList
+            .map((t, i) => {
+            const icon = t.status === "completed" ? "[x]" : t.status === "in_progress" ? "[~]" : "[ ]";
+            return `${icon} ${i + 1}. ${t.content}`;
+        })
+            .join("\n");
+        return ok(`Todos updated:\n${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":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAa,EAAE,EAAE,MAAM,YAAY,CAAC;AAQ3C,IAAI,QAAQ,GAAe,EAAE,CAAC;AAE9B,MAAM,UAAU,QAAQ;IACtB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,QAAQ,GAAG,GAAG,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAgC;IACxD,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,wOAAwO;IAC1O,eAAe,EAAE,KAAK;IACtB,OAAO,EAAE,KAAK;IACd,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;wBACjF,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE;wBACzE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;qBAC5F;oBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;iBAChC;aACF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG;QAClB,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC;QACvB,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACvF,CAAC;QAAC,MAAM,CAAC;YACP,kFAAkF;QACpF,CAAC;QACD,MAAM,SAAS,GAAG,QAAQ;aACvB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACZ,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YAC3F,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1C,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,EAAE,CAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC"}

package/dist/tools/types.js

@@ -0,0 +1,7 @@
+export function ok(content, display) {
+    return { content, display };
+}
+export function err(message) {
+    return { content: message, isError: true };
+}
+//# 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":"AAyDA,MAAM,UAAU,EAAE,CAAC,OAAe,EAAE,OAAgB;IAClD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAe;IACjC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC7C,CAAC"}

package/dist/tools/webfetch.js

@@ -0,0 +1,62 @@
+import { convert as htmlToTextConvert } from "html-to-text";
+import { ok, err } from "./types.js";
+const CACHE_TTL_MS = 15 * 60 * 1000;
+const cache = new Map();
+export const webFetchTool = {
+    name: "WebFetch",
+    description: "Fetch a URL and extract its content as plain text. The `prompt` argument is a question or instruction; the page text is included in the returned content so the calling model can answer it. Responses are cached per-URL for 15 minutes.",
+    needsPermission: true,
+    mutates: false,
+    parameters: {
+        type: "object",
+        properties: {
+            url: { type: "string", description: "Fully-qualified URL to fetch" },
+            prompt: { type: "string", description: "What you're trying to learn from the page" },
+        },
+        required: ["url", "prompt"],
+    },
+    async run(input) {
+        let url;
+        try {
+            url = new URL(input.url);
+        }
+        catch {
+            return err(`Invalid URL: ${input.url}`);
+        }
+        if (url.protocol !== "http:" && url.protocol !== "https:") {
+            return err(`Only http(s) URLs are supported: ${input.url}`);
+        }
+        const key = url.toString();
+        const now = Date.now();
+        const cached = cache.get(key);
+        if (cached && now - cached.fetchedAt < CACHE_TTL_MS) {
+            return ok(`URL: ${key}\nPrompt: ${input.prompt}\nCache: hit (age ${Math.round((now - cached.fetchedAt) / 1000)}s)\n\n--- BEGIN CONTENT ---\n${cached.content}\n--- END CONTENT ---`);
+        }
+        try {
+            const res = await fetch(url, {
+                redirect: "follow",
+                headers: { "User-Agent": "openai-claw/0.1" },
+            });
+            if (!res.ok)
+                return err(`HTTP ${res.status} ${res.statusText} for ${url}`);
+            const text = await res.text();
+            const stripped = htmlToTextConvert(text, {
+                wordwrap: false,
+                selectors: [
+                    { selector: "script", format: "skip" },
+                    { selector: "style", format: "skip" },
+                    { selector: "noscript", format: "skip" },
+                    { selector: "a", options: { ignoreHref: true } },
+                    { selector: "img", format: "skip" },
+                ],
+            }).slice(0, 100_000);
+            cache.set(key, { content: stripped, fetchedAt: now });
+            return ok(`URL: ${key}\nPrompt: ${input.prompt}\nCache: miss\n\n--- BEGIN CONTENT ---\n${stripped}\n--- END CONTENT ---`);
+        }
+        catch (e) {
+            return err(`Fetch failed: ${e?.message ?? String(e)}`);
+        }
+    },
+    preview: (input) => `WebFetch ${input.url}`,
+};
+//# 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":"AAAA,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAa,EAAE,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACpC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkD,CAAC;AAExE,MAAM,CAAC,MAAM,YAAY,GAA0C;IACjE,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,2OAA2O;IAC7O,eAAe,EAAE,IAAI;IACrB,OAAO,EAAE,KAAK;IACd,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACpE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;SACrF;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;KAC5B;IACD,KAAK,CAAC,GAAG,CAAC,KAAK;QACb,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC,gBAAgB,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1D,OAAO,GAAG,CAAC,oCAAoC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;YACpD,OAAO,EAAE,CACP,QAAQ,GAAG,aAAa,KAAK,CAAC,MAAM,qBAAqB,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,gCAAgC,MAAM,CAAC,OAAO,uBAAuB,CAC1K,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC3B,QAAQ,EAAE,QAAQ;gBAClB,OAAO,EAAE,EAAE,YAAY,EAAE,iBAAiB,EAAE;aAC7C,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO,GAAG,CAAC,QAAQ,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,QAAQ,GAAG,EAAE,CAAC,CAAC;YAC3E,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,EAAE;gBACvC,QAAQ,EAAE,KAAK;gBACf,SAAS,EAAE;oBACT,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;oBACtC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;oBACrC,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE;oBACxC,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE;oBAChD,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;iBACpC;aACF,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAErB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;YAEtD,OAAO,EAAE,CACP,QAAQ,GAAG,aAAa,KAAK,CAAC,MAAM,2CAA2C,QAAQ,uBAAuB,CAC/G,CAAC;QACJ,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,GAAG,CAAC,iBAAiB,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,KAAK,CAAC,GAAG,EAAE;CAC5C,CAAC"}

package/dist/tools/websearch.js

@@ -0,0 +1,82 @@
+import { ok, err } from "./types.js";
+/**
+ * WebSearch uses DuckDuckGo's HTML endpoint as a zero-key provider.
+ * Configure OPENAI_CLAW_SEARCH_PROVIDER=tavily and TAVILY_API_KEY to use Tavily instead.
+ */
+export const webSearchTool = {
+    name: "WebSearch",
+    description: "Search the web for a query. Returns a list of result titles, URLs, and snippets. Useful for current events or recent docs the model wouldn't know.",
+    needsPermission: true,
+    mutates: false,
+    parameters: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Search query" },
+            max_results: { type: "number", description: "Max results to return (default 10)" },
+        },
+        required: ["query"],
+    },
+    async run(input) {
+        const max = input.max_results ?? 10;
+        const provider = process.env.OPENAI_CLAW_SEARCH_PROVIDER ?? "duckduckgo";
+        try {
+            if (provider === "tavily")
+                return ok(await tavilySearch(input.query, max));
+            return ok(await duckSearch(input.query, max));
+        }
+        catch (e) {
+            return err(`Web search failed: ${e?.message ?? String(e)}`);
+        }
+    },
+    preview: (input) => `WebSearch "${input.query}"`,
+};
+async function tavilySearch(query, max) {
+    const key = process.env.TAVILY_API_KEY;
+    if (!key)
+        throw new Error("TAVILY_API_KEY not set");
+    const res = await fetch("https://api.tavily.com/search", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ api_key: key, query, max_results: max }),
+    });
+    if (!res.ok)
+        throw new Error(`Tavily HTTP ${res.status}`);
+    const data = await res.json();
+    return (data.results ?? [])
+        .map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}\n   ${r.content}`)
+        .join("\n\n");
+}
+async function duckSearch(query, max) {
+    const res = await fetch(`https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`, { headers: { "User-Agent": "Mozilla/5.0 openai-claw/0.1" } });
+    if (!res.ok)
+        throw new Error(`DDG HTTP ${res.status}`);
+    const html = await res.text();
+    const results = [];
+    const linkRe = /<a [^>]*class="result__a"[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/g;
+    const snippetRe = /<a [^>]*class="result__snippet"[^>]*>([\s\S]*?)<\/a>/g;
+    const links = [];
+    let m;
+    while ((m = linkRe.exec(html))) {
+        const url = decodeURIComponent(m[1].replace(/^\/\/duckduckgo\.com\/l\/\?uddg=/, "").replace(/&.*$/, ""));
+        links.push({ title: strip(m[2]), url });
+    }
+    const snippets = [];
+    while ((m = snippetRe.exec(html)))
+        snippets.push(strip(m[1]));
+    for (let i = 0; i < Math.min(links.length, max); i++) {
+        results.push({ ...links[i], snippet: snippets[i] ?? "" });
+    }
+    return results.map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}\n   ${r.snippet}`).join("\n\n");
+}
+function strip(s) {
+    return s
+        .replace(/<[^>]+>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#x27;/g, "'")
+        .trim();
+}
+//# 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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"}

package/dist/tools/write.js

@@ -0,0 +1,39 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createPatch } from "diff";
+import { err } from "./types.js";
+export const writeTool = {
+    name: "Write",
+    description: "Write contents to a file. Creates the file if missing, overwrites if it exists. Use absolute paths. For modifying existing files, prefer the Edit tool instead — it only sends the diff.",
+    needsPermission: true,
+    mutates: true,
+    parameters: {
+        type: "object",
+        properties: {
+            file_path: { type: "string", description: "Absolute path to the file" },
+            content: { type: "string", description: "Full contents to write" },
+        },
+        required: ["file_path", "content"],
+    },
+    async run(input) {
+        const fp = path.resolve(input.file_path);
+        const dir = path.dirname(fp);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        try {
+            const existed = fs.existsSync(fp);
+            const before = existed ? fs.readFileSync(fp, "utf8") : "";
+            fs.writeFileSync(fp, input.content, "utf8");
+            const summary = existed
+                ? `Overwrote ${fp} (${input.content.length} bytes)`
+                : `Created ${fp} (${input.content.length} bytes)`;
+            const patch = createPatch(path.relative(process.cwd(), fp), before, input.content, "", "");
+            return { content: summary, display: patch };
+        }
+        catch (e) {
+            return err(`Failed to write ${fp}: ${e?.message ?? String(e)}`);
+        }
+    },
+    preview: (input) => `Write ${input.file_path} (${input.content.length} bytes)`,
+};
+//# sourceMappingURL=write.js.map

package/dist/tools/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAiB,GAAG,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,CAAC,MAAM,SAAS,GAAiD;IACrE,IAAI,EAAE,OAAO;IACb,WAAW,EACT,0LAA0L;IAC5L,eAAe,EAAE,IAAI;IACrB,OAAO,EAAE,IAAI;IACb,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACvE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;SACnE;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;KACnC;IACD,KAAK,CAAC,GAAG,CAAC,KAAK;QACb,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,OAAO;gBACrB,CAAC,CAAC,aAAa,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,MAAM,SAAS;gBACnD,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,OAAO,CAAC,MAAM,SAAS,CAAC;YACpD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3F,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9C,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,OAAO,CAAC,MAAM,SAAS;CAC/E,CAAC"}