vaan-ai 0.1.0

package/dist/src/tools/files.js

@@ -0,0 +1,162 @@
+// read_file, list_dir, write_file, edit_file.
+//
+// Every one of them goes through two gates, and they answer different
+// questions. `jail` answers *where*: the path is resolved against the workspace
+// and rejected if it lands outside, symlinks included. The permission gate
+// answers *whether*: reading inside the workspace is free, changing anything
+// asks. Only after both does the user see the diff and decide.
+import { mkdirSync } from "node:fs";
+import { dirname, relative } from "node:path";
+import { jail, listEntries, readText, writeText } from "../sandbox/filesystem.js";
+import { readIfExists } from "./shared.js";
+const MAX_DIFF_LINES = 40;
+const show = (workspace, path) => relative(workspace, path) || ".";
+export const readFile = {
+    name: "read_file",
+    description: "Read a UTF-8 text file inside the workspace. Paths are relative to it. " +
+        "Large files are truncated.",
+    group: "files",
+    parameters: {
+        type: "object",
+        properties: { path: { type: "string", description: "Path relative to the workspace." } },
+        required: ["path"],
+    },
+    async run(input, ctx) {
+        const path = String(input.path ?? "");
+        await ctx.gate.require(ctx.policy.forPath("read_file", path, "read"));
+        const result = readText(ctx.workspace, path);
+        ctx.trace.record({ kind: "sandbox", op: "read", target: path, ok: true });
+        return result.truncated
+            ? `${result.text}\n\n[truncated — ${result.bytes} bytes total]`
+            : result.text;
+    },
+};
+export const listDir = {
+    name: "list_dir",
+    description: "List the entries of a directory inside the workspace. " +
+        "Directories are shown with a trailing slash.",
+    group: "files",
+    parameters: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "Directory path. Defaults to the workspace root." },
+        },
+    },
+    async run(input, ctx) {
+        const path = String(input.path ?? ".");
+        await ctx.gate.require(ctx.policy.forPath("list_dir", path, "read"));
+        const target = jail(ctx.workspace, path);
+        const { entries, more } = listEntries(ctx.workspace, path);
+        ctx.trace.record({ kind: "sandbox", op: "list", target: path, ok: true });
+        if (entries.length === 0)
+            return `${show(ctx.workspace, target)} is empty.`;
+        return entries.join("\n") + (more > 0 ? `\n[${more} more entries]` : "");
+    },
+};
+export const writeFile = {
+    name: "write_file",
+    description: "Write a UTF-8 text file inside the workspace, replacing it if it exists. " +
+        "The user is shown a diff and asked to approve before anything is written. " +
+        "Prefer edit_file when you are changing part of an existing file.",
+    group: "files",
+    parameters: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "Path relative to the workspace." },
+            content: { type: "string", description: "The complete new contents of the file." },
+        },
+        required: ["path", "content"],
+    },
+    async run(input, ctx) {
+        const path = String(input.path ?? "");
+        const content = String(input.content ?? "");
+        return commit(ctx, path, content, "write_file");
+    },
+};
+export const editFile = {
+    name: "edit_file",
+    description: "Replace an exact string in a file inside the workspace. Use this rather than write_file " +
+        "for changes to an existing file: it doesn't require restating the parts you aren't " +
+        "changing, so the diff shows only what moved. The old text must appear exactly once " +
+        "unless replace_all is true.",
+    group: "files",
+    parameters: {
+        type: "object",
+        properties: {
+            path: { type: "string", description: "Path relative to the workspace." },
+            old_text: { type: "string", description: "The exact text to replace, including indentation." },
+            new_text: { type: "string", description: "What to put in its place." },
+            replace_all: { type: "boolean", description: "Replace every occurrence. Default false." },
+        },
+        required: ["path", "old_text", "new_text"],
+    },
+    async run(input, ctx) {
+        const path = String(input.path ?? "");
+        const oldText = String(input.old_text ?? "");
+        const newText = String(input.new_text ?? "");
+        const all = input.replace_all === true;
+        if (!oldText)
+            return "old_text was empty. Use write_file to create a file.";
+        // Read through the jail so a path outside the workspace fails here rather
+        // than after the user has been asked to approve something.
+        await ctx.gate.require(ctx.policy.forPath("edit_file", path, "read"));
+        const before = readText(ctx.workspace, path).text;
+        const occurrences = before.split(oldText).length - 1;
+        if (occurrences === 0) {
+            return `That exact text isn't in ${path}. Read the file again — whitespace and indentation have to match.`;
+        }
+        if (occurrences > 1 && !all) {
+            return (`That text appears ${occurrences} times in ${path}. Include enough surrounding lines to ` +
+                `make it unique, or pass replace_all.`);
+        }
+        const after = all ? before.split(oldText).join(newText) : before.replace(oldText, newText);
+        return commit(ctx, path, after, "edit_file");
+    },
+};
+/** The shared tail of every write: permission, then a diff, then the bytes. */
+async function commit(ctx, path, content, tool) {
+    await ctx.gate.require(ctx.policy.forPath(tool, path, "write"));
+    const target = jail(ctx.workspace, path);
+    const label = show(ctx.workspace, target);
+    const before = readIfExists(target);
+    if (before === content)
+        return `${label} already has exactly that content. Nothing written.`;
+    const approved = await ctx.confirm(`${before === undefined ? "Create" : "Modify"} ${label}\n\n${diff(before ?? "", content)}`);
+    if (!approved) {
+        ctx.trace.record({ kind: "sandbox", op: "write", target: label, ok: false, detail: "declined" });
+        return `The user declined the write to ${label}. The file is unchanged.`;
+    }
+    mkdirSync(dirname(target), { recursive: true });
+    writeText(ctx.workspace, path, content);
+    const lines = content === "" ? 0 : content.split("\n").length;
+    ctx.trace.record({ kind: "sandbox", op: "write", target: label, ok: true, detail: `${lines} lines` });
+    return `Wrote ${label} (${lines} lines).`;
+}
+/**
+ * A diff good enough to decide by. Trims the common head and tail and shows
+ * what's left. That covers the shape of a normal edit without dragging in a
+ * real LCS implementation for a confirmation prompt.
+ */
+export function diff(before, after) {
+    const a = before === "" ? [] : before.split("\n");
+    const b = after === "" ? [] : after.split("\n");
+    let head = 0;
+    while (head < a.length && head < b.length && a[head] === b[head])
+        head++;
+    let endA = a.length;
+    let endB = b.length;
+    while (endA > head && endB > head && a[endA - 1] === b[endB - 1]) {
+        endA--;
+        endB--;
+    }
+    const removed = a.slice(head, endA).map((line) => `- ${line}`);
+    const added = b.slice(head, endB).map((line) => `+ ${line}`);
+    const body = [...removed, ...added];
+    if (body.length === 0)
+        return "(no textual change)";
+    const shown = body.slice(0, MAX_DIFF_LINES);
+    const hidden = body.length - shown.length;
+    const context = head > 0 ? [`  … ${head} unchanged line${head === 1 ? "" : "s"} above`] : [];
+    return [...context, ...shown, ...(hidden > 0 ? [`  … ${hidden} more changed lines`] : [])].join("\n");
+}
+//# sourceMappingURL=files.js.map

package/dist/src/tools/files.js.map

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

package/dist/src/tools/git.js

@@ -0,0 +1,91 @@
+// git_status, git_diff, git_log — read-only, and that is the whole design.
+//
+// These three answer "what has changed and why", which is what an agent needs
+// before touching a repository. Committing, pushing and branching are not here:
+// they go through run_command, where the exact command is shown and approved.
+// A tool called `git_commit` would be a second, quieter path to the same effect
+// with a friendlier name, and the friendlier name is exactly the problem.
+import { runCommand, summarise } from "../sandbox/process.js";
+const MAX_LINES = 400;
+async function git(ctx, args, label) {
+    // Reading a repository is reading the workspace, so it asks for `read` rather
+    // than `execute`: no side effects, nothing to approve.
+    await ctx.gate.require(ctx.policy.forPath(label, ".", "read"));
+    const result = await runCommand({
+        command: `git ${args}`,
+        workspace: ctx.workspace,
+        env: ctx.env,
+        timeoutMs: 30_000,
+        ...(ctx.signal ? { signal: ctx.signal } : {}),
+    });
+    ctx.trace.record({
+        kind: "sandbox",
+        op: "git",
+        target: args,
+        ok: result.code === 0,
+        detail: summarise(result),
+    });
+    if (result.code !== 0) {
+        const detail = (result.stderr || result.stdout).trim();
+        if (/not a git repository/i.test(detail))
+            return "This workspace isn't a git repository.";
+        if (/command not found|ENOENT/i.test(detail))
+            return "git isn't installed on this machine.";
+        return `git ${args} failed: ${detail || `exit ${result.code}`}`;
+    }
+    const output = result.stdout.trim();
+    if (!output)
+        return "(nothing to report)";
+    const lines = output.split("\n");
+    return lines.length <= MAX_LINES
+        ? output
+        : `${lines.slice(0, MAX_LINES).join("\n")}\n[${lines.length - MAX_LINES} more lines]`;
+}
+export const gitStatus = {
+    name: "git_status",
+    description: "Show which files in the workspace have been modified, staged or left untracked. " +
+        "Read-only. Use it before changing anything, to see what was already in flight.",
+    group: "git",
+    parameters: { type: "object", properties: {} },
+    run: (_input, ctx) => git(ctx, "status --short --branch", "git_status"),
+};
+export const gitDiff = {
+    name: "git_diff",
+    description: "Show the diff of uncommitted changes in the workspace. Read-only. " +
+        "Pass staged to see what is already staged instead.",
+    group: "git",
+    parameters: {
+        type: "object",
+        properties: {
+            staged: { type: "boolean", description: "Show staged changes instead of unstaged ones." },
+            path: { type: "string", description: "Limit the diff to one path." },
+        },
+    },
+    run(input, ctx) {
+        const staged = input.staged === true ? " --staged" : "";
+        // Quoted so a path with a space stays one argument; there is no shell to
+        // re-split it, so this is the only escaping that has to happen.
+        const path = input.path === undefined ? "" : ` -- "${String(input.path).replace(/"/g, "")}"`;
+        return git(ctx, `diff${staged}${path}`, "git_diff");
+    },
+};
+export const gitLog = {
+    name: "git_log",
+    description: "Show recent commits in the workspace, newest first. Read-only. " +
+        "Use it to find out why something is the way it is.",
+    group: "git",
+    parameters: {
+        type: "object",
+        properties: {
+            count: { type: "number", description: "How many commits. Default 15, maximum 100." },
+            path: { type: "string", description: "Only commits touching this path." },
+        },
+    },
+    run(input, ctx) {
+        const asked = Number(input.count);
+        const count = Number.isFinite(asked) ? Math.min(Math.max(Math.trunc(asked), 1), 100) : 15;
+        const path = input.path === undefined ? "" : ` -- "${String(input.path).replace(/"/g, "")}"`;
+        return git(ctx, `log --oneline --no-decorate -n ${count}${path}`, "git_log");
+    },
+};
+//# sourceMappingURL=git.js.map

package/dist/src/tools/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/tools/git.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,gFAAgF;AAChF,0EAA0E;AAE1E,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAG9D,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB,KAAK,UAAU,GAAG,CAAC,GAAgB,EAAE,IAAY,EAAE,KAAa;IAC9D,8EAA8E;IAC9E,uDAAuD;IACvD,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,OAAO,EAAE,OAAO,IAAI,EAAE;QACtB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,SAAS,EAAE,MAAM;QACjB,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC,CAAC;IAEH,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC;QACrB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC;KAC1B,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,wCAAwC,CAAC;QAC1F,IAAI,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,sCAAsC,CAAC;QAC5F,OAAO,OAAO,IAAI,YAAY,MAAM,IAAI,QAAQ,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,MAAM;QAAE,OAAO,qBAAqB,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,MAAM,IAAI,SAAS;QAC9B,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,MAAM,GAAG,SAAS,cAAc,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,kFAAkF;QAClF,gFAAgF;IAClF,KAAK,EAAE,KAAK;IACZ,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;IAC9C,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,yBAAyB,EAAE,YAAY,CAAC;CACxE,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAS;IAC3B,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,oEAAoE;QACpE,oDAAoD;IACtD,KAAK,EAAE,KAAK;IACZ,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,+CAA+C,EAAE;YACzF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;SACrE;KACF;IACD,GAAG,CAAC,KAAK,EAAE,GAAG;QACZ,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,yEAAyE;QACzE,gEAAgE;QAChE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC;QAC7F,OAAO,GAAG,CAAC,GAAG,EAAE,OAAO,MAAM,GAAG,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;IACtD,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAS;IAC1B,IAAI,EAAE,SAAS;IACf,WAAW,EACT,iEAAiE;QACjE,oDAAoD;IACtD,KAAK,EAAE,KAAK;IACZ,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4CAA4C,EAAE;YACpF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;SAC1E;KACF;IACD,GAAG,CAAC,KAAK,EAAE,GAAG;QACZ,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC;QAC7F,OAAO,GAAG,CAAC,GAAG,EAAE,kCAAkC,KAAK,GAAG,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;IAC/E,CAAC;CACF,CAAC"}

package/dist/src/tools/grep.js

@@ -0,0 +1,92 @@
+// search. The tool the trace in the README shows first, because it is what an
+// agent reaches for before it knows which files matter.
+//
+// It walks the workspace rather than shelling out to grep or ripgrep: those
+// aren't installed everywhere, their flags differ between platforms, and
+// spawning one would put an ordinary lookup behind the execute permission for
+// no gain. Reading files inside the workspace is already allowed.
+import { search, walk } from "../sandbox/filesystem.js";
+const MAX_MATCHES = 60;
+const MAX_FILES_LISTED = 100;
+export const searchWorkspace = {
+    name: "search",
+    description: "Search the workspace for text and get back matching file paths with line numbers. " +
+        "Use this to find where something lives before reading files. Skips node_modules, " +
+        ".git, build output and other generated directories.",
+    group: "search",
+    parameters: {
+        type: "object",
+        properties: {
+            query: { type: "string", description: "Text to look for." },
+            regex: {
+                type: "boolean",
+                description: "Treat the query as a regular expression. Default false.",
+            },
+            path_contains: {
+                type: "string",
+                description: "Only search files whose path contains this, e.g. \"src/\" or \".ts\".",
+            },
+        },
+        required: ["query"],
+    },
+    async run(input, ctx) {
+        const query = String(input.query ?? "").trim();
+        if (!query)
+            return "No query given.";
+        await ctx.gate.require(ctx.policy.forPath("search", ".", "read"));
+        const glob = input.path_contains === undefined ? undefined : String(input.path_contains);
+        const matches = search(ctx.workspace, query, {
+            regex: input.regex === true,
+            limit: MAX_MATCHES,
+            ...(glob ? { glob } : {}),
+        });
+        ctx.trace.record({
+            kind: "sandbox",
+            op: "search",
+            target: query,
+            ok: true,
+            detail: `${matches.length} matches`,
+        });
+        if (matches.length === 0) {
+            return `No matches for "${query}". Generated directories are skipped, so try list_files if you expected one there.`;
+        }
+        const body = matches.map((match) => `${match.path}:${match.line}  ${match.text}`).join("\n");
+        return matches.length >= MAX_MATCHES ? `${body}\n[stopped at ${MAX_MATCHES} matches]` : body;
+    },
+};
+export const listFiles = {
+    name: "list_files",
+    description: "List every file in the workspace, skipping generated directories. Use it to get the " +
+        "shape of a project in one call rather than walking it with list_dir.",
+    group: "search",
+    parameters: {
+        type: "object",
+        properties: {
+            path_contains: { type: "string", description: "Only list paths containing this." },
+        },
+    },
+    async run(input, ctx) {
+        await ctx.gate.require(ctx.policy.forPath("list_files", ".", "read"));
+        const filter = input.path_contains === undefined ? "" : String(input.path_contains);
+        const all = [];
+        for (const path of walk(ctx.workspace)) {
+            if (!filter || path.includes(filter))
+                all.push(path);
+            if (all.length > MAX_FILES_LISTED)
+                break;
+        }
+        ctx.trace.record({
+            kind: "sandbox",
+            op: "walk",
+            target: filter || ".",
+            ok: true,
+            detail: `${all.length} files`,
+        });
+        if (all.length === 0)
+            return filter ? `No files match "${filter}".` : "The workspace is empty.";
+        const shown = all.slice(0, MAX_FILES_LISTED);
+        return (shown.sort().join("\n") +
+            (all.length > MAX_FILES_LISTED ? `\n[stopped at ${MAX_FILES_LISTED} — narrow with path_contains]` : ""));
+    },
+};
+//# sourceMappingURL=grep.js.map

package/dist/src/tools/grep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.js","sourceRoot":"","sources":["../../../src/tools/grep.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wDAAwD;AACxD,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,8EAA8E;AAC9E,kEAAkE;AAElE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAGxD,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,oFAAoF;QACpF,mFAAmF;QACnF,qDAAqD;IACvD,KAAK,EAAE,QAAQ;IACf,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;YAC3D,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,yDAAyD;aACvE;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG;QAClB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,iBAAiB,CAAC;QAErC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QAElE,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACzF,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE;YAC3C,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI;YAC3B,KAAK,EAAE,WAAW;YAClB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1B,CAAC,CAAC;QAEH,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;YACf,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,QAAQ;YACZ,MAAM,EAAE,KAAK;YACb,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,UAAU;SACpC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,mBAAmB,KAAK,oFAAoF,CAAC;QACtH,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7F,OAAO,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,iBAAiB,WAAW,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/F,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAS;IAC7B,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,sFAAsF;QACtF,sEAAsE;IACxE,KAAK,EAAE,QAAQ;IACf,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;SACnF;KACF;IACD,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG;QAClB,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QAEtE,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACpF,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,GAAG,CAAC,MAAM,GAAG,gBAAgB;gBAAE,MAAM;QAC3C,CAAC;QAED,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;YACf,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,MAAM;YACV,MAAM,EAAE,MAAM,IAAI,GAAG;YACrB,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,QAAQ;SAC9B,CAAC,CAAC;QAEH,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,mBAAmB,MAAM,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC;QAChG,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAC7C,OAAO,CACL,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;YACvB,CAAC,GAAG,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,iBAAiB,gBAAgB,+BAA+B,CAAC,CAAC,CAAC,EAAE,CAAC,CACxG,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/tools/index.js

@@ -0,0 +1,66 @@
+// The tool registry, grouped the way the onboarding checkboxes group them.
+//
+// Groups are the unit the user turns on and off, so they are the unit the
+// registry is built from. Turning off `code` removes run_command entirely — the
+// model isn't told about a tool it may not use and then refused, it simply
+// doesn't have one. A capability that is absent can't be talked into existing.
+//
+// Two groups ship declared but empty. `browser` would need a real engine, and
+// `integrations` would need connectors; both are listed here so the onboarding,
+// `/status` and `vaan doctor` can say plainly that they are not configured
+// rather than pretending. An empty group is an honest answer; a tool that
+// fetches a page and calls itself a browser is not.
+import { now, remember } from "./basics.js";
+import { runCommandTool } from "./code.js";
+import { editFile, listDir, readFile, writeFile } from "./files.js";
+import { gitDiff, gitLog, gitStatus } from "./git.js";
+import { listFiles, searchWorkspace } from "./grep.js";
+import { defaultSearchProvider, webFetch, webSearch } from "./web.js";
+export const GROUPS = [
+    { group: "files", label: "Files", note: "read, write and edit inside the workspace", available: true },
+    { group: "search", label: "Search", note: "find text and files in the workspace", available: true },
+    { group: "git", label: "Git", note: "status, diff and log — read-only", available: true },
+    { group: "web", label: "Web", note: "search and fetch public pages", available: true },
+    { group: "code", label: "Code execution", note: "run commands in the sandbox", available: true },
+    { group: "memory", label: "Memory", note: "remember durable facts about you", available: true },
+    { group: "browser", label: "Browser", note: "not configured in this build", available: false },
+    {
+        group: "integrations",
+        label: "External integrations",
+        note: "not configured in this build",
+        available: false,
+    },
+];
+export const DEFAULT_GROUPS = GROUPS.filter((entry) => entry.available).map((entry) => entry.group);
+export function builtinTools(opts = {}) {
+    const enabled = new Set(opts.groups ?? DEFAULT_GROUPS);
+    const all = [
+        now,
+        readFile,
+        listDir,
+        writeFile,
+        editFile,
+        searchWorkspace,
+        listFiles,
+        gitStatus,
+        gitDiff,
+        gitLog,
+        webSearch(opts.search ?? defaultSearchProvider()),
+        webFetch,
+        runCommandTool,
+        remember,
+    ];
+    return all.filter((tool) => enabled.has(tool.group));
+}
+/** Which groups actually produced tools, for `/status` and the startup lines. */
+export function activeGroups(tools) {
+    return [...new Set(tools.map((tool) => tool.group))];
+}
+export { now, remember } from "./basics.js";
+export { runCommandTool } from "./code.js";
+export { diff, editFile, listDir, readFile, writeFile } from "./files.js";
+export { gitDiff, gitLog, gitStatus } from "./git.js";
+export { listFiles, searchWorkspace } from "./grep.js";
+export { jail, JailError } from "../sandbox/filesystem.js";
+export { braveSearch, duckDuckGo, parseDuckDuckGo, webFetch, webSearch, } from "./web.js";
+//# sourceMappingURL=index.js.map

package/dist/src/tools/index.js.map

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

package/dist/src/tools/shared.js

@@ -0,0 +1,11 @@
+import { readFileSync } from "node:fs";
+export function readIfExists(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+export const clip = (text, max) => text.length <= max ? text : `${text.slice(0, max)}…`;
+//# sourceMappingURL=shared.js.map

package/dist/src/tools/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,GAAW,EAAU,EAAE,CACxD,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC"}