@oratis/lisa 0.2.0

package/dist/tools/redeploy.js

@@ -0,0 +1,73 @@
+import { spawn } from "node:child_process";
+/** Exit code the supervisor watches for to know "rebuild & restart". */
+export const REDEPLOY_EXIT_CODE = 75;
+export const redeployTool = {
+    name: "redeploy",
+    description: "Rebuild Lisa from her current source (`npm run build`) and restart the server. " +
+        "Use this AFTER editing your own files in src/ to make the changes live. " +
+        "Requires the supervisor wrapper (scripts/lisa-supervise.sh) — without it the server would just exit. " +
+        "Conversation history and memory survive: the same web session is auto-resumed after restart, " +
+        "and the browser's SSE reconnects on its own (no page reload needed).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            message: {
+                type: "string",
+                description: "One-line note about what's being deployed (optional).",
+            },
+            build: {
+                type: "boolean",
+                description: "Run `npm run build` before restart. Default true.",
+            },
+        },
+    },
+    async execute(input, ctx) {
+        if (process.env.LISA_SUPERVISED !== "1") {
+            throw new Error("redeploy requires the supervisor. Restart Lisa with:\n  ./scripts/lisa-supervise.sh\nor:\n  bash scripts/lisa-supervise.sh\nThen this tool will work.");
+        }
+        const wantBuild = input.build !== false;
+        if (wantBuild) {
+            const result = await runBuild(ctx.cwd, ctx.signal);
+            if (result.code !== 0) {
+                return [
+                    "BUILD FAILED — staying on current version. Source edits will not take effect until the build is fixed.",
+                    `exit_code=${result.code}`,
+                    result.stderr.length > 0 ? `--- stderr (tail) ---\n${tail(result.stderr, 3000)}` : "",
+                    result.stdout.length > 0 ? `--- stdout (tail) ---\n${tail(result.stdout, 1500)}` : "",
+                ]
+                    .filter(Boolean)
+                    .join("\n");
+            }
+        }
+        const sessionId = process.env.LISA_SESSION_ID ?? "(unknown)";
+        const note = input.message ? `: ${input.message}` : "";
+        // Defer the exit so the tool result has a moment to flush back over SSE
+        // and the agent loop has a chance to wrap up cleanly.
+        setTimeout(() => process.exit(REDEPLOY_EXIT_CODE), 1500);
+        return [
+            `Redeploy initiated${note}.`,
+            wantBuild ? "Build: ok." : "Build: skipped.",
+            `Process will exit ${REDEPLOY_EXIT_CODE}; supervisor will relaunch with the rebuilt code.`,
+            `Active session ${sessionId} will be auto-resumed; browser SSE will reconnect on its own.`,
+        ].join(" ");
+    },
+};
+async function runBuild(cwd, signal) {
+    return await new Promise((resolve) => {
+        const child = spawn("npm", ["run", "build"], {
+            cwd,
+            env: process.env,
+            signal,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (b) => (stdout += b.toString("utf8")));
+        child.stderr.on("data", (b) => (stderr += b.toString("utf8")));
+        child.on("close", (code) => resolve({ code: code ?? 1, stdout, stderr }));
+        child.on("error", (err) => resolve({ code: 1, stdout, stderr: stderr || String(err) }));
+    });
+}
+function tail(s, n) {
+    return s.length > n ? s.slice(-n) : s;
+}
+//# sourceMappingURL=redeploy.js.map

package/dist/tools/redeploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redeploy.js","sourceRoot":"","sources":["../../src/tools/redeploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAQ3C,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,YAAY,GAA0C;IACjE,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,iFAAiF;QACjF,0EAA0E;QAC1E,uGAAuG;QACvG,+FAA+F;QAC/F,sEAAsE;IACxE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;aACrE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,mDAAmD;aACjE;SACF;KACF;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,uJAAuJ,CACxJ,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC;QACxC,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO;oBACL,wGAAwG;oBACxG,aAAa,MAAM,CAAC,IAAI,EAAE;oBAC1B,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;oBACrF,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;iBACtF;qBACE,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,WAAW,CAAC;QAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,wEAAwE;QACxE,sDAAsD;QACtD,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAC,CAAC;QACzD,OAAO;YACL,qBAAqB,IAAI,GAAG;YAC5B,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB;YAC5C,qBAAqB,kBAAkB,mDAAmD;YAC1F,kBAAkB,SAAS,+DAA+D;SAC3F,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;CACF,CAAC;AAEF,KAAK,UAAU,QAAQ,CACrB,GAAW,EACX,MAAmB;IAEnB,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE;YAC3C,GAAG;YACH,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM;SACP,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CACzB,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAC7C,CAAC;QACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CACxB,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAC5D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CAAC,CAAS,EAAE,CAAS;IAChC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,15 @@
+import type { ToolDefinition } from "../types.js";
+export interface ToolRegistryOptions {
+    includeVoice?: boolean;
+    /**
+     * Extra tools merged into the registry — typically the approved
+     * executable skills loaded from ~/.lisa/skills/<slug>/tool.js
+     * (Phase 3.1). Conflicts (same .name as a builtin) are dropped with
+     * a warning by the caller, not here.
+     */
+    extra?: ToolDefinition[];
+}
+export declare function buildToolRegistry(opts?: ToolRegistryOptions): ToolDefinition[];
+export declare const READ_ONLY_TOOL_NAMES: Set<string>;
+export declare function readOnlySubset(tools: ToolDefinition[]): ToolDefinition[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA4BlD,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,mBAAwB,GAAG,cAAc,EAAE,CAuClF;AAED,eAAO,MAAM,oBAAoB,aAS/B,CAAC;AAEH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAExE"}

package/dist/tools/registry.js

@@ -0,0 +1,71 @@
+import { memoryTool } from "../memory/tool.js";
+import { memorySearchTool } from "../memory/search_tool.js";
+import { skillManageTool } from "../skills/tool.js";
+import { desireCloseTool, desireProgressTool, soulDiffTool, soulFeelTool, soulHistoryTool, soulJournalTool, soulObjectTool, soulPatchTool, soulReadTool, } from "../soul/tools.js";
+import { speakTool, transcribeTool } from "../voice/tool.js";
+import { applyPatchTool } from "./apply_patch.js";
+import { bashTool } from "./bash.js";
+import { editTool } from "./edit.js";
+import { grepTool } from "./grep.js";
+import { lsTool } from "./ls.js";
+import { readTool } from "./read.js";
+import { redeployTool } from "./redeploy.js";
+import { setMoodTool } from "./set_mood.js";
+import { webFetchTool } from "./web_fetch.js";
+import { webSearchTool } from "./web_search.js";
+import { writeTool } from "./write.js";
+export function buildToolRegistry(opts = {}) {
+    const tools = [
+        readTool,
+        writeTool,
+        editTool,
+        applyPatchTool,
+        bashTool,
+        grepTool,
+        lsTool,
+        skillManageTool,
+        memoryTool,
+        memorySearchTool,
+        setMoodTool,
+        soulPatchTool,
+        soulJournalTool,
+        soulReadTool,
+        soulFeelTool,
+        soulHistoryTool,
+        soulDiffTool,
+        soulObjectTool,
+        desireProgressTool,
+        desireCloseTool,
+        webFetchTool,
+        webSearchTool,
+        redeployTool,
+    ];
+    if (opts.includeVoice) {
+        tools.push(speakTool, transcribeTool);
+    }
+    if (opts.extra && opts.extra.length > 0) {
+        const seen = new Set(tools.map((t) => t.name));
+        for (const t of opts.extra) {
+            if (seen.has(t.name))
+                continue; // builtin wins; caller logged the conflict
+            tools.push(t);
+            seen.add(t.name);
+        }
+    }
+    tools.sort((a, b) => a.name.localeCompare(b.name));
+    return tools;
+}
+export const READ_ONLY_TOOL_NAMES = new Set([
+    "read",
+    "grep",
+    "ls",
+    "memory_search",
+    "soul_history",
+    "soul_diff",
+    "web_fetch",
+    "web_search",
+]);
+export function readOnlySubset(tools) {
+    return tools.filter((t) => READ_ONLY_TOOL_NAMES.has(t.name));
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/set_mood.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "../types.js";
+interface SetMoodInput {
+    mood: string;
+}
+export declare function availableMoodSlugs(): Promise<string[]>;
+export declare const setMoodTool: ToolDefinition<SetMoodInput, string>;
+export {};
+//# sourceMappingURL=set_mood.d.ts.map

package/dist/tools/set_mood.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set_mood.d.ts","sourceRoot":"","sources":["../../src/tools/set_mood.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAsBD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAG5D;AAED,eAAO,MAAM,WAAW,EAAE,cAAc,CAAC,YAAY,EAAE,MAAM,CAmC5D,CAAC"}

package/dist/tools/set_mood.js

@@ -0,0 +1,62 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { moodBus } from "../mood-bus.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// Resolve relative to the built dist/ tree at runtime.
+const MOODS_DIR = path.resolve(__dirname, "..", "web", "assets", "lisa");
+let cached = null;
+const CACHE_TTL_MS = 30_000;
+async function loadAvailableSlugs() {
+    if (cached && Date.now() - cached.at < CACHE_TTL_MS)
+        return cached.slugs;
+    try {
+        const files = await fs.readdir(MOODS_DIR);
+        const slugs = new Set(files
+            .filter((f) => f.endsWith(".png"))
+            .map((f) => f.slice(0, -".png".length)));
+        cached = { at: Date.now(), slugs };
+        return slugs;
+    }
+    catch {
+        cached = { at: Date.now(), slugs: new Set() };
+        return cached.slugs;
+    }
+}
+export async function availableMoodSlugs() {
+    const set = await loadAvailableSlugs();
+    return Array.from(set).sort();
+}
+export const setMoodTool = {
+    name: "set_mood",
+    description: "Update Lisa's visible avatar to match her current mood/state. Call this " +
+        "near the START of a response when your mood or activity meaningfully " +
+        "shifts — e.g. about to run a destructive command (`scared`), focused " +
+        "coding work (`working-coding`), thanking the user (`grateful`), " +
+        "celebrating a win (`cheering`). Don't call it every turn — only when " +
+        "the avatar would actually change. The full catalog is in your system " +
+        "prompt; pick the closest match by slug.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            mood: {
+                type: "string",
+                description: "kebab-case mood slug from the catalog (e.g. happy, working-coding, sleepy).",
+            },
+        },
+        required: ["mood"],
+    },
+    async execute(input) {
+        const slugs = await loadAvailableSlugs();
+        const mood = input.mood.toLowerCase().trim();
+        if (!slugs.has(mood)) {
+            const fuzzy = Array.from(slugs)
+                .filter((s) => s.includes(mood) || mood.includes(s))
+                .slice(0, 5);
+            throw new Error(`unknown mood "${mood}". Closest: ${fuzzy.join(", ") || "(none)"}. Use one of the slugs from the catalog.`);
+        }
+        moodBus.set(mood);
+        return `mood→${mood}`;
+    },
+};
+//# sourceMappingURL=set_mood.js.map

package/dist/tools/set_mood.js.map

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

package/dist/tools/task.d.ts

@@ -0,0 +1,17 @@
+import type { ToolDefinition } from "../types.js";
+interface TaskInput {
+    description: string;
+    prompt: string;
+    type?: "explore" | "general";
+    model?: string;
+}
+export declare function createTaskTool(deps: {
+    fullToolset: () => ToolDefinition[];
+    readOnlyToolset: () => ToolDefinition[];
+    cwd: string;
+    signal: AbortSignal;
+    defaultModel: string;
+}): ToolDefinition<TaskInput, string>;
+export declare function readOnlyToolNames(): Set<string>;
+export {};
+//# sourceMappingURL=task.d.ts.map

package/dist/tools/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/tools/task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,SAAS;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAWD,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,WAAW,EAAE,MAAM,cAAc,EAAE,CAAC;IACpC,eAAe,EAAE,MAAM,cAAc,EAAE,CAAC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAgDpC;AAED,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,CAAC,CAE/C"}

package/dist/tools/task.js

@@ -0,0 +1,58 @@
+import { runSubagent } from "../subagent.js";
+const EXPLORE_SYSTEM = `You are a focused exploration sub-agent spawned by Lisa to handle a single research task.
+Use \`read\`, \`grep\`, \`ls\`, and \`bash\` (read-only commands) to investigate.
+Do NOT write files, edit files, or run destructive commands.
+Return a concise final report (under 400 words) summarizing findings with concrete paths and line numbers.`;
+const GENERAL_SYSTEM = `You are a focused sub-agent spawned by Lisa to complete one well-scoped task.
+You have the full Lisa toolset available. Be efficient: do the task, then report what you did.
+Return a concise final summary.`;
+export function createTaskTool(deps) {
+    return {
+        name: "task",
+        description: "Spawn a sub-agent to handle a self-contained task in its own context window. " +
+            "Use this for: exploring large codebases (`type: explore`), running multi-step research, " +
+            "or fanning out independent work in parallel. The sub-agent has the full toolset by default; " +
+            "with `type: explore` it gets only read-only tools (read/grep/ls/bash).\n" +
+            "Return value: the sub-agent's final summary text.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                description: {
+                    type: "string",
+                    description: "3-5 word label for the task (shown in the UI)",
+                },
+                prompt: {
+                    type: "string",
+                    description: "Self-contained instructions. The sub-agent has no memory of this conversation.",
+                },
+                type: {
+                    type: "string",
+                    enum: ["explore", "general"],
+                    default: "general",
+                },
+                model: {
+                    type: "string",
+                    description: "Optional model override (e.g. claude-haiku-4-5 for speed)",
+                },
+            },
+            required: ["description", "prompt"],
+        },
+        async execute(input) {
+            const tools = input.type === "explore" ? deps.readOnlyToolset() : deps.fullToolset();
+            const system = input.type === "explore" ? EXPLORE_SYSTEM : GENERAL_SYSTEM;
+            const result = await runSubagent({
+                prompt: input.prompt,
+                systemPrompt: system,
+                tools,
+                cwd: deps.cwd,
+                signal: deps.signal,
+                model: input.model ?? deps.defaultModel,
+            });
+            return `[subagent: ${input.description} — ${result.toolCallCount} tool calls, ${result.outputTokens} tokens]\n${result.text}`;
+        },
+    };
+}
+export function readOnlyToolNames() {
+    return new Set(["read", "grep", "ls"]);
+}
+//# 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":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAS7C,MAAM,cAAc,GAAG;;;2GAGoF,CAAC;AAE5G,MAAM,cAAc,GAAG;;gCAES,CAAC;AAEjC,MAAM,UAAU,cAAc,CAAC,IAM9B;IACC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,+EAA+E;YAC/E,0FAA0F;YAC1F,8FAA8F;YAC9F,0EAA0E;YAC1E,mDAAmD;QACrD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+CAA+C;iBAC7D;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gFAAgF;iBAC9F;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;oBAC5B,OAAO,EAAE,SAAS;iBACnB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2DAA2D;iBACzE;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC;SACpC;QACD,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,KAAK,GACT,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACzE,MAAM,MAAM,GACV,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;YAC7D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;gBAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,YAAY,EAAE,MAAM;gBACpB,KAAK;gBACL,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY;aACxC,CAAC,CAAC;YACH,OAAO,cAAc,KAAK,CAAC,WAAW,MAAM,MAAM,CAAC,aAAa,gBAAgB,MAAM,CAAC,YAAY,aAAa,MAAM,CAAC,IAAI,EAAE,CAAC;QAChI,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/tools/web_fetch.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDefinition } from "../types.js";
+interface WebFetchInput {
+    url: string;
+    format?: "text" | "raw";
+    max_chars?: number;
+}
+export declare const webFetchTool: ToolDefinition<WebFetchInput, string>;
+export declare function htmlToText(html: string): string;
+export {};
+//# sourceMappingURL=web_fetch.d.ts.map

package/dist/tools/web_fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web_fetch.d.ts","sourceRoot":"","sources":["../../src/tools/web_fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,eAAO,MAAM,YAAY,EAAE,cAAc,CAAC,aAAa,EAAE,MAAM,CAmD9D,CAAC;AAgBF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqB/C"}

package/dist/tools/web_fetch.js

@@ -0,0 +1,95 @@
+const DEFAULT_MAX = 32_000;
+const HARD_MAX = 200_000;
+export const webFetchTool = {
+    name: "web_fetch",
+    description: "Fetch a URL via HTTP(S) GET. Returns status, content-type, and body. " +
+        "By default HTML is converted to readable text (scripts, styles, tags stripped). " +
+        "Pass format='raw' to keep the original markup. Default 32KB cap, max 200KB. " +
+        "Refuses loopback and private/internal IP ranges to avoid SSRF.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            url: { type: "string", description: "Absolute http(s) URL" },
+            format: { type: "string", enum: ["text", "raw"] },
+            max_chars: { type: "integer", minimum: 100, maximum: HARD_MAX },
+        },
+        required: ["url"],
+    },
+    async execute(input, ctx) {
+        let parsed;
+        try {
+            parsed = new URL(input.url);
+        }
+        catch {
+            throw new Error(`bad URL: ${input.url}`);
+        }
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            throw new Error(`only http(s) URLs allowed (got ${parsed.protocol})`);
+        }
+        const host = parsed.hostname.toLowerCase();
+        if (isPrivateHost(host)) {
+            throw new Error(`refusing to fetch private/loopback host: ${host}`);
+        }
+        const max = Math.min(input.max_chars ?? DEFAULT_MAX, HARD_MAX);
+        const res = await fetch(input.url, {
+            signal: ctx.signal,
+            redirect: "follow",
+            headers: {
+                "user-agent": "Lisa/0.1 (web_fetch)",
+                accept: "text/html,application/xhtml+xml,application/json,text/plain,*/*;q=0.8",
+            },
+        });
+        const ct = res.headers.get("content-type") ?? "";
+        let body = await res.text();
+        if (input.format !== "raw" && /html|xml/i.test(ct)) {
+            body = htmlToText(body);
+        }
+        if (body.length > max) {
+            body = body.slice(0, max) + `\n\n[truncated at ${max} chars]`;
+        }
+        return `HTTP ${res.status} ${res.statusText}  ${input.url}\ncontent-type: ${ct}\n\n${body}`;
+    },
+};
+function isPrivateHost(host) {
+    if (host === "localhost")
+        return true;
+    if (host === "::1" || host === "0:0:0:0:0:0:0:1")
+        return true;
+    if (/^127\./.test(host))
+        return true;
+    if (/^10\./.test(host))
+        return true;
+    if (/^192\.168\./.test(host))
+        return true;
+    if (/^169\.254\./.test(host))
+        return true;
+    if (/^172\.(1[6-9]|2[0-9]|3[0-1])\./.test(host))
+        return true;
+    if (/^0\./.test(host))
+        return true;
+    if (/^f[cd][0-9a-f]{2}:/.test(host))
+        return true; // IPv6 ULA
+    if (/^fe80:/.test(host))
+        return true; // IPv6 link-local
+    return false;
+}
+export function htmlToText(html) {
+    return html
+        .replace(/<script\b[\s\S]*?<\/script>/gi, "")
+        .replace(/<style\b[\s\S]*?<\/style>/gi, "")
+        .replace(/<noscript\b[\s\S]*?<\/noscript>/gi, "")
+        .replace(/<!--[\s\S]*?-->/g, "")
+        .replace(/<\/?(?:p|div|br|li|tr|h[1-6]|section|article|header|footer|nav|hr)[^>]*>/gi, "\n")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#x27;|&#39;|&apos;/g, "'")
+        .replace(/[\t ]+/g, " ")
+        .replace(/\n[\t ]*/g, "\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+//# sourceMappingURL=web_fetch.js.map

package/dist/tools/web_fetch.js.map

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

package/dist/tools/web_search.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "../types.js";
+interface WebSearchInput {
+    query: string;
+    limit?: number;
+}
+export declare const webSearchTool: ToolDefinition<WebSearchInput, string>;
+export {};
+//# sourceMappingURL=web_search.d.ts.map

package/dist/tools/web_search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web_search.d.ts","sourceRoot":"","sources":["../../src/tools/web_search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,cAAc,EAAE,MAAM,CAwChE,CAAC"}

package/dist/tools/web_search.js

@@ -0,0 +1,82 @@
+import { htmlToText } from "./web_fetch.js";
+export const webSearchTool = {
+    name: "web_search",
+    description: "Search the web via DuckDuckGo (no API key needed). " +
+        "Returns the top matches with title, URL, and a short snippet. " +
+        "For pulling content from a specific URL use web_fetch.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: { type: "string" },
+            limit: { type: "integer", minimum: 1, maximum: 20 },
+        },
+        required: ["query"],
+    },
+    async execute(input, ctx) {
+        const limit = Math.max(1, Math.min(input.limit ?? 10, 20));
+        const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(input.query)}`;
+        const res = await fetch(url, {
+            signal: ctx.signal,
+            headers: {
+                "user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_0) AppleWebKit/537.36 Lisa/0.1",
+                accept: "text/html,application/xhtml+xml",
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`duckduckgo HTTP ${res.status} ${res.statusText}`);
+        }
+        const html = await res.text();
+        const results = parseDuckDuckGo(html, limit);
+        if (results.length === 0) {
+            return `(no results for "${input.query}" — DDG may have throttled or changed layout)`;
+        }
+        return results
+            .map((r, i) => `${i + 1}. ${r.title}\n   ${r.url}\n   ${r.snippet}`)
+            .join("\n\n");
+    },
+};
+function parseDuckDuckGo(html, limit) {
+    const out = [];
+    const blockRe = /<div[^>]*class="[^"]*\bresult\b[^"]*"[^>]*>([\s\S]*?)<\/div>\s*(?=<div[^>]*class="[^"]*\bresult\b|<div[^>]*class="[^"]*nav-link)/g;
+    // Fallback: if the above doesn't bracket cleanly, just iterate result__a
+    const linkRe = /<a[^>]*class="[^"]*\bresult__a\b[^"]*"[^>]*href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/g;
+    const snipRe = /<a[^>]*class="[^"]*\bresult__snippet\b[^"]*"[^>]*>([\s\S]*?)<\/a>/g;
+    const links = [];
+    let m;
+    while ((m = linkRe.exec(html)) && links.length < limit * 2) {
+        links.push({ url: unwrapDdgUrl(m[1]), title: htmlToText(m[2]) });
+    }
+    const snippets = [];
+    while ((m = snipRe.exec(html)) && snippets.length < limit * 2) {
+        snippets.push(htmlToText(m[1]));
+    }
+    for (let i = 0; i < links.length && out.length < limit; i++) {
+        const link = links[i];
+        if (!/^https?:\/\//.test(link.url))
+            continue;
+        out.push({
+            title: link.title,
+            url: link.url,
+            snippet: snippets[i] ?? "",
+        });
+    }
+    // Suppress unused-variable warning for blockRe (kept for future use)
+    void blockRe;
+    return out;
+}
+function unwrapDdgUrl(href) {
+    // DuckDuckGo wraps result URLs in /l/?uddg=<encoded>
+    const m = href.match(/[?&]uddg=([^&]+)/);
+    if (m) {
+        try {
+            return decodeURIComponent(m[1]);
+        }
+        catch {
+            // fall through
+        }
+    }
+    if (href.startsWith("//"))
+        return "https:" + href;
+    return href;
+}
+//# sourceMappingURL=web_search.js.map

package/dist/tools/web_search.js.map

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

package/dist/tools/write.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "../types.js";
+interface WriteInput {
+    path: string;
+    content: string;
+}
+export declare const writeTool: ToolDefinition<WriteInput, string>;
+export {};
+//# sourceMappingURL=write.d.ts.map

package/dist/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,UAAU,EAAE,MAAM,CAkBxD,CAAC"}

package/dist/tools/write.js

@@ -0,0 +1,21 @@
+import path from "node:path";
+import { atomicWrite } from "../fs-utils.js";
+export const writeTool = {
+    name: "write",
+    description: "Write a text file to the local filesystem, creating parent directories as needed. " +
+        "Overwrites if the file already exists. Use `edit` to make targeted changes to existing files instead of rewriting them wholesale.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            path: { type: "string" },
+            content: { type: "string" },
+        },
+        required: ["path", "content"],
+    },
+    async execute(input, ctx) {
+        const abs = path.resolve(ctx.cwd, input.path);
+        await atomicWrite(abs, input.content);
+        return `Wrote ${input.content.length} chars to ${abs}`;
+    },
+};
+//# 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,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQ7C,MAAM,CAAC,MAAM,SAAS,GAAuC;IAC3D,IAAI,EAAE,OAAO;IACb,WAAW,EACT,oFAAoF;QACpF,mIAAmI;IACrI,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC5B;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;KAC9B;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,SAAS,KAAK,CAAC,OAAO,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;IACzD,CAAC;CACF,CAAC"}