@oharness/engine 0.1.0

package/dist/tools/builtin/fs.js

@@ -0,0 +1,280 @@
+import { constants } from "node:fs";
+import { access, mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { expandHome, within } from "../../paths.js";
+import { defineTool } from "../define.js";
+import { toolError, toolText } from "../types.js";
+const MAX_READ_BYTES = 400_000;
+const DEFAULT_READ_LINES = 2_000;
+const IMAGE_TYPES = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+};
+/**
+ * Records the mtime each file had when the agent last read it. `edit` and
+ * `write` refuse to touch a file whose mtime has moved since — the cheapest
+ * guard against an agent clobbering work it never saw.
+ *
+ * We store the file's own mtime rather than a wall-clock timestamp: mtimes
+ * carry sub-millisecond precision on modern filesystems, so comparing them
+ * against `Date.now()` reports a file written and read in the same
+ * millisecond as stale.
+ */
+const READ_TIMES = "fs:readMtimes";
+function readMtimes(ctx) {
+    let map = ctx.host.state.get(READ_TIMES);
+    if (!map) {
+        map = new Map();
+        ctx.host.state.set(READ_TIMES, map);
+    }
+    return map;
+}
+/** Remember the file's current mtime as the agent's last-seen version. */
+async function markSeen(ctx, target) {
+    try {
+        const info = await stat(target);
+        readMtimes(ctx).set(target, info.mtimeMs);
+    }
+    catch {
+        readMtimes(ctx).delete(target);
+    }
+}
+/**
+ * Resolve a model-supplied path and keep it inside the roots the agent is
+ * allowed to touch.
+ *
+ * Defers to the host, which owns the workspace policy and therefore knows
+ * about roots beyond the working directory — the user-level skills directory
+ * the skill registry loads from, for one, which this used to refuse to read or
+ * write while the harness happily loaded skills out of it.
+ *
+ * The fallback is for a host without a policy: confine to the working
+ * directory, which is what this did unconditionally before.
+ */
+export function resolvePath(ctx, input, access = "read") {
+    if (ctx.host.resolvePath)
+        return ctx.host.resolvePath(input, access);
+    const resolved = path.resolve(ctx.cwd, expandHome(input));
+    if (!within([path.resolve(ctx.cwd)], resolved)) {
+        throw new Error(`path escapes the working directory: ${input} (resolved to ${resolved})`);
+    }
+    return resolved;
+}
+export const readTool = defineTool({
+    name: "read",
+    description: "Read a file from the filesystem. Returns line-numbered content. Use `offset` and `limit` for large files; images are returned as image content. You must read a file before editing it.",
+    readOnly: true,
+    parameters: z.object({
+        path: z.string().describe("Path to the file, absolute or relative to the working directory"),
+        offset: z.number().int().min(1).optional().describe("1-based line to start from"),
+        limit: z.number().int().min(1).optional().describe("Maximum number of lines to return"),
+    }),
+    renderTitle: (input) => `Read(${input.path})`,
+    async execute(input, ctx) {
+        let target;
+        try {
+            target = resolvePath(ctx, input.path);
+        }
+        catch (err) {
+            return toolError(String(err instanceof Error ? err.message : err));
+        }
+        let info;
+        try {
+            info = await stat(target);
+        }
+        catch {
+            return toolError(`file not found: ${input.path}`);
+        }
+        if (info.isDirectory()) {
+            const entries = await readdir(target, { withFileTypes: true });
+            const listing = entries
+                .map((e) => (e.isDirectory() ? `${e.name}/` : e.name))
+                .sort()
+                .join("\n");
+            return toolText(`${input.path} is a directory:\n${listing}`);
+        }
+        const ext = path.extname(target).toLowerCase();
+        const mime = IMAGE_TYPES[ext];
+        if (mime) {
+            const data = await readFile(target);
+            readMtimes(ctx).set(target, info.mtimeMs);
+            return {
+                content: [
+                    { type: "text", text: `Image ${input.path} (${info.size} bytes)` },
+                    { type: "image", mimeType: mime, data: data.toString("base64") },
+                ],
+            };
+        }
+        if (info.size > MAX_READ_BYTES && !input.limit) {
+            return toolError(`file is ${info.size} bytes, which is too large to read at once. Re-read with \`offset\`/\`limit\`, or use grep to find the relevant section.`);
+        }
+        const raw = await readFile(target, "utf8");
+        readMtimes(ctx).set(target, info.mtimeMs);
+        const lines = raw.split("\n");
+        const start = (input.offset ?? 1) - 1;
+        const end = Math.min(lines.length, start + (input.limit ?? DEFAULT_READ_LINES));
+        if (start >= lines.length && lines.length > 0) {
+            return toolError(`offset ${input.offset} is past the end of the file (${lines.length} lines)`);
+        }
+        const width = String(end).length;
+        const body = lines
+            .slice(start, end)
+            .map((line, i) => `${String(start + i + 1).padStart(width)}\t${line}`)
+            .join("\n");
+        const truncated = end < lines.length;
+        const footer = truncated
+            ? `\n\n… ${lines.length - end} more lines. Continue with offset ${end + 1}.`
+            : "";
+        return toolText(body === "" ? "(empty file)" : body + footer, {
+            lines: lines.length,
+            truncated,
+        });
+    },
+});
+export const writeTool = defineTool({
+    name: "write",
+    description: "Write a file, creating parent directories as needed. Overwrites existing content — read the file first if it already exists.",
+    parameters: z.object({
+        path: z.string().describe("Path to write"),
+        content: z.string().describe("Full file content"),
+    }),
+    renderTitle: (input) => `Write(${input.path})`,
+    async execute(input, ctx) {
+        let target;
+        try {
+            target = resolvePath(ctx, input.path, "write");
+        }
+        catch (err) {
+            return toolError(String(err instanceof Error ? err.message : err));
+        }
+        const exists = await pathExists(target);
+        if (exists) {
+            const stale = await staleness(target, readMtimes(ctx).get(target));
+            if (stale)
+                return toolError(stale);
+        }
+        await mkdir(path.dirname(target), { recursive: true });
+        await writeFile(target, input.content, "utf8");
+        await markSeen(ctx, target);
+        const lines = input.content.split("\n").length;
+        return toolText(`${exists ? "Updated" : "Created"} ${input.path} (${lines} lines)`);
+    },
+});
+export const editTool = defineTool({
+    name: "edit",
+    description: "Replace an exact string in a file. `oldString` must appear exactly once unless `replaceAll` is set. Read the file first — the edit is rejected if the file changed since your last read.",
+    parameters: z.object({
+        path: z.string().describe("File to edit"),
+        oldString: z.string().describe("Exact text to replace, including indentation"),
+        newString: z.string().describe("Replacement text"),
+        replaceAll: z.boolean().optional().describe("Replace every occurrence instead of requiring uniqueness"),
+    }),
+    renderTitle: (input) => `Edit(${input.path})`,
+    async execute(input, ctx) {
+        let target;
+        try {
+            target = resolvePath(ctx, input.path, "write");
+        }
+        catch (err) {
+            return toolError(String(err instanceof Error ? err.message : err));
+        }
+        if (!(await pathExists(target)))
+            return toolError(`file not found: ${input.path}`);
+        const lastRead = readMtimes(ctx).get(target);
+        if (lastRead === undefined) {
+            return toolError(`read ${input.path} before editing it`);
+        }
+        const stale = await staleness(target, lastRead);
+        if (stale)
+            return toolError(stale);
+        if (input.oldString === input.newString) {
+            return toolError("oldString and newString are identical");
+        }
+        const original = await readFile(target, "utf8");
+        const occurrences = countOccurrences(original, input.oldString);
+        if (occurrences === 0) {
+            return toolError(`oldString not found in ${input.path}. Whitespace and indentation must match exactly.`);
+        }
+        if (occurrences > 1 && !input.replaceAll) {
+            return toolError(`oldString appears ${occurrences} times in ${input.path}. Add more surrounding context, or set replaceAll.`);
+        }
+        const updated = input.replaceAll
+            ? original.split(input.oldString).join(input.newString)
+            : original.replace(input.oldString, input.newString);
+        await writeFile(target, updated, "utf8");
+        await markSeen(ctx, target);
+        return toolText(`Edited ${input.path} (${occurrences} replacement${occurrences === 1 ? "" : "s"})`);
+    },
+});
+export const listTool = defineTool({
+    name: "list",
+    description: "List the entries of a directory. Directories are suffixed with '/'.",
+    readOnly: true,
+    parameters: z.object({
+        path: z.string().optional().describe("Directory to list; defaults to the working directory"),
+    }),
+    renderTitle: (input) => `List(${input.path ?? "."})`,
+    async execute(input, ctx) {
+        let target;
+        try {
+            target = resolvePath(ctx, input.path ?? ".");
+        }
+        catch (err) {
+            return toolError(String(err instanceof Error ? err.message : err));
+        }
+        try {
+            const entries = await readdir(target, { withFileTypes: true });
+            if (entries.length === 0)
+                return toolText("(empty directory)");
+            const lines = entries
+                .map((e) => (e.isDirectory() ? `${e.name}/` : e.name))
+                .sort((a, b) => a.localeCompare(b));
+            return toolText(lines.join("\n"), { count: entries.length });
+        }
+        catch {
+            return toolError(`not a directory: ${input.path ?? "."}`);
+        }
+    },
+});
+// ---------------------------------------------------------------------------
+async function pathExists(target) {
+    try {
+        await access(target, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Returns an error message if the file changed since the agent last saw it. */
+async function staleness(target, seenMtime) {
+    if (seenMtime === undefined)
+        return null;
+    try {
+        const info = await stat(target);
+        if (info.mtimeMs > seenMtime) {
+            return `${path.basename(target)} changed on disk since you read it. Read it again before writing.`;
+        }
+    }
+    catch {
+        // A file that vanished is handled by the caller's existence check.
+    }
+    return null;
+}
+function countOccurrences(haystack, needle) {
+    if (needle === "")
+        return 0;
+    let count = 0;
+    let index = haystack.indexOf(needle);
+    while (index !== -1) {
+        count++;
+        index = haystack.indexOf(needle, index + needle.length);
+    }
+    return count;
+}
+export const fileTools = [readTool, writeTool, editTool, listTool];
+//# sourceMappingURL=fs.js.map

package/dist/tools/builtin/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/tools/builtin/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,cAAc,GAAG,OAAO,CAAC;AAC/B,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACjC,MAAM,WAAW,GAA2B;IAC1C,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG,eAAe,CAAC;AAEnC,SAAS,UAAU,CAAC,GAAgB;IAClC,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAoC,CAAC;IAC5E,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,KAAK,UAAU,QAAQ,CAAC,GAAgB,EAAE,MAAc;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,GAAgB,EAChB,KAAa,EACb,SAA2B,MAAM;IAEjC,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAErE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,iBAAiB,QAAQ,GAAG,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,yLAAyL;IAC3L,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;QAC5F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;KACxF,CAAC;IACF,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,KAAK,CAAC,IAAI,GAAG;IAC7C,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC,mBAAmB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,MAAM,OAAO,GAAG,OAAO;iBACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;iBACrD,IAAI,EAAE;iBACN,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,qBAAqB,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;YACpC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,SAAS,EAAE;oBAClE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;iBACjE;aACF,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,GAAG,cAAc,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/C,OAAO,SAAS,CACd,WAAW,IAAI,CAAC,IAAI,0HAA0H,CAC/I,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAE1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,kBAAkB,CAAC,CAAC,CAAC;QAChF,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,OAAO,SAAS,CAAC,UAAU,KAAK,CAAC,MAAM,iCAAiC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;QACjG,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACjC,MAAM,IAAI,GAAG,KAAK;aACf,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;aACjB,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;aACrE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,SAAS,GAAG,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;QACrC,MAAM,MAAM,GAAG,SAAS;YACtB,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,GAAG,GAAG,qCAAqC,GAAG,GAAG,CAAC,GAAG;YAC5E,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,EAAE;YAC5D,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,SAAS;SACV,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;IAClC,IAAI,EAAE,OAAO;IACb,WAAW,EACT,8HAA8H;IAChI,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;KAClD,CAAC;IACF,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,KAAK,CAAC,IAAI,GAAG;IAC9C,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YACnE,IAAI,KAAK;gBAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC/C,OAAO,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC;IACtF,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,0LAA0L;IAC5L,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC9E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAClD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;KACxG,CAAC;IACF,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,KAAK,CAAC,IAAI,GAAG;IAC7C,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC,mBAAmB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAEnF,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC,QAAQ,KAAK,CAAC,IAAI,oBAAoB,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAI,KAAK;YAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC,uCAAuC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CACd,0BAA0B,KAAK,CAAC,IAAI,kDAAkD,CACvF,CAAC;QACJ,CAAC;QACD,IAAI,WAAW,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YACzC,OAAO,SAAS,CACd,qBAAqB,WAAW,aAAa,KAAK,CAAC,IAAI,oDAAoD,CAC5G,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU;YAC9B,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;YACvD,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAEvD,MAAM,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,QAAQ,CACb,UAAU,KAAK,CAAC,IAAI,KAAK,WAAW,eAAe,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CACnF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,qEAAqE;IAClF,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;KAC7F,CAAC;IACF,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,KAAK,CAAC,IAAI,IAAI,GAAG,GAAG;IACpD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC,mBAAmB,CAAC,CAAC;YAC/D,MAAM,KAAK,GAAG,OAAO;iBAClB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;iBACrD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC,oBAAoB,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH,8EAA8E;AAE9E,KAAK,UAAU,UAAU,CAAC,MAAc;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,SAA6B;IACpE,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,OAAO,GAAG,SAAS,EAAE,CAAC;YAC7B,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,mEAAmE,CAAC;QACrG,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB,EAAE,MAAc;IACxD,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,CAAC,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,KAAK,EAAE,CAAC;QACR,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC"}

package/dist/tools/builtin/index.d.ts

@@ -0,0 +1,22 @@
+import type { Tool } from "../types.ts";
+export { bashTool } from "./bash.ts";
+export { artifactTool, artifactReadTool, artifactTools, ARTIFACT_METADATA_KEY } from "./artifact.ts";
+export { readTool, writeTool, editTool, listTool, fileTools, resolvePath } from "./fs.ts";
+export { globTool, grepTool, searchTools } from "./search.ts";
+export { todoTool, getTodos, renderTodos } from "./todo.ts";
+export { recallTool, ARCHIVE_READER } from "./recall.ts";
+export type { ArchiveReader } from "./recall.ts";
+export type { TodoItem } from "./todo.ts";
+export { createTaskTool } from "./task.ts";
+/**
+ * The default tool set. `task` is not here because it must be constructed
+ * against a live host to describe the configured subagent types.
+ */
+export declare const builtinTools: Tool[];
+/**
+ * Read-only subset, suitable for exploration-only subagents.
+ *
+ * `artifact_read` is here but `artifact_write` is not: reading back what the
+ * parent made is exploration, creating a surface the user sees is not.
+ */
+export declare const readOnlyTools: Tool[];

package/dist/tools/builtin/index.js

@@ -0,0 +1,42 @@
+import { bashTool } from "./bash.js";
+import { editTool, fileTools, listTool, readTool, writeTool } from "./fs.js";
+import { globTool, grepTool, searchTools } from "./search.js";
+import { recallTool } from "./recall.js";
+import { todoTool } from "./todo.js";
+import { artifactReadTool, artifactTool, artifactTools } from "./artifact.js";
+export { bashTool } from "./bash.js";
+export { artifactTool, artifactReadTool, artifactTools, ARTIFACT_METADATA_KEY } from "./artifact.js";
+export { readTool, writeTool, editTool, listTool, fileTools, resolvePath } from "./fs.js";
+export { globTool, grepTool, searchTools } from "./search.js";
+export { todoTool, getTodos, renderTodos } from "./todo.js";
+export { recallTool, ARCHIVE_READER } from "./recall.js";
+export { createTaskTool } from "./task.js";
+/**
+ * The default tool set. `task` is not here because it must be constructed
+ * against a live host to describe the configured subagent types.
+ */
+export const builtinTools = [
+    ...fileTools,
+    ...searchTools,
+    bashTool,
+    recallTool,
+    todoTool,
+    ...artifactTools,
+];
+/**
+ * Read-only subset, suitable for exploration-only subagents.
+ *
+ * `artifact_read` is here but `artifact_write` is not: reading back what the
+ * parent made is exploration, creating a surface the user sees is not.
+ */
+export const readOnlyTools = [
+    readTool,
+    listTool,
+    globTool,
+    grepTool,
+    recallTool,
+    artifactReadTool,
+];
+void writeTool;
+void editTool;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,GAAG,SAAS;IACZ,GAAG,WAAW;IACd,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,GAAG,aAAa;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,gBAAgB;CACjB,CAAC;AAEF,KAAK,SAAS,CAAC;AACf,KAAK,QAAQ,CAAC"}

package/dist/tools/builtin/mcp-resource.d.ts

@@ -0,0 +1,3 @@
+import type { McpManager } from "../../mcp/manager.ts";
+import type { Tool } from "../types.ts";
+export declare function createMcpResourceTools(mcp: McpManager): Tool[];

package/dist/tools/builtin/mcp-resource.js

@@ -0,0 +1,220 @@
+import { z } from "zod";
+import { defineTool } from "../define.js";
+import { toolError, toolText } from "../types.js";
+/**
+ * MCP servers expose two things beyond tools: **resources** (documents the
+ * server can hand over — files, schemas, dashboards) and **prompts** (canned
+ * instruction templates).
+ *
+ * The client could already speak both, but nothing surfaced them, so the agent
+ * had no way to read an MCP resource at all. These tools close that gap.
+ */
+const MAX_CHARS = 30_000;
+/** URIs are namespaced `server:uri` so two servers can serve the same path. */
+function splitRef(ref) {
+    // Resource URIs are themselves schemed (`file://`, `https://`), so only a
+    // prefix that is not part of a scheme counts as a server name.
+    const match = /^([A-Za-z0-9_-]+):(?!\/\/)(.+)$/.exec(ref);
+    return match ? { server: match[1], uri: match[2] } : { uri: ref };
+}
+export function createMcpResourceTools(mcp) {
+    const listTool = defineTool({
+        name: "mcp_list_resources",
+        readOnly: true,
+        description: "List the documents exposed by connected MCP servers — files, schemas, records the " +
+            "server can provide. Returns URIs to pass to `mcp_read_resource`. Use this before " +
+            "guessing at a URI.",
+        parameters: z.object({
+            server: z.string().optional().describe("Limit to one server; omit to list all"),
+        }),
+        renderTitle: (input) => `McpResources(${input.server ?? "all"})`,
+        async execute(input) {
+            const servers = mcp
+                .status()
+                .filter((s) => s.connected && (!input.server || s.name === input.server));
+            if (servers.length === 0) {
+                return toolText(input.server
+                    ? `No connected MCP server named "${input.server}".`
+                    : "No MCP servers are connected.");
+            }
+            const lines = [];
+            for (const status of servers) {
+                const client = mcp.client(status.name);
+                if (!client)
+                    continue;
+                let resources;
+                try {
+                    resources = await client.listResources();
+                }
+                catch (err) {
+                    // One broken server should not hide the others' resources.
+                    lines.push(`${status.name}: (listing failed — ${String(err)})`);
+                    continue;
+                }
+                if (resources.length === 0)
+                    continue;
+                lines.push(`${status.name}:`);
+                for (const resource of resources) {
+                    const label = resource.name ?? resource.title ?? "";
+                    const mime = resource.mimeType ? ` [${resource.mimeType}]` : "";
+                    lines.push(`  ${status.name}:${resource.uri}${mime}${label ? ` — ${label}` : ""}`);
+                    if (resource.description)
+                        lines.push(`    ${resource.description}`);
+                }
+            }
+            return lines.length === 0
+                ? toolText("No MCP server exposes any resources.")
+                : toolText(lines.join("\n"), { servers: servers.length });
+        },
+    });
+    const readTool = defineTool({
+        name: "mcp_read_resource",
+        readOnly: true,
+        description: "Read a document from an MCP server. Pass a URI from `mcp_list_resources`, " +
+            "optionally prefixed with the server name (`docs:file:///spec.md`).",
+        parameters: z.object({
+            uri: z.string().describe("Resource URI, optionally prefixed `server:`"),
+            server: z.string().optional().describe("Server name, if not in the URI"),
+        }),
+        renderTitle: (input) => `McpRead(${input.uri})`,
+        async execute(input) {
+            const parsed = splitRef(input.uri);
+            const serverName = input.server ?? parsed.server;
+            // Without a server name we would have to guess which server owns the
+            // URI; asking is better than reading the wrong document.
+            const candidates = serverName
+                ? [serverName]
+                : mcp.status().filter((s) => s.connected).map((s) => s.name);
+            if (candidates.length === 0)
+                return toolError("No MCP servers are connected.");
+            if (!serverName && candidates.length > 1) {
+                return toolError(`Several servers are connected (${candidates.join(", ")}). ` +
+                    `Prefix the URI with a server name, e.g. "${candidates[0]}:${parsed.uri}".`);
+            }
+            const name = candidates[0];
+            const client = mcp.client(name);
+            if (!client)
+                return toolError(`No connected MCP server named "${name}".`);
+            let contents;
+            try {
+                contents = await client.readResource(parsed.uri);
+            }
+            catch (err) {
+                return toolError(`Could not read ${parsed.uri} from ${name}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            const parts = [];
+            let budget = MAX_CHARS;
+            let truncated = false;
+            for (const item of contents.contents ?? []) {
+                if (typeof item.text === "string") {
+                    const slice = item.text.slice(0, budget);
+                    if (slice.length < item.text.length)
+                        truncated = true;
+                    parts.push(slice);
+                    budget -= slice.length;
+                }
+                else if (item.blob) {
+                    // Binary payloads are base64; dumping them into the transcript is
+                    // never what the caller wanted.
+                    parts.push(`[binary ${item.mimeType ?? "content"}, ${item.blob.length} base64 chars]`);
+                }
+                if (budget <= 0) {
+                    truncated = true;
+                    break;
+                }
+            }
+            if (parts.length === 0)
+                return toolText(`${parsed.uri} is empty.`);
+            return toolText(parts.join("\n\n") + (truncated ? "\n\n… truncated." : ""), { server: name, uri: parsed.uri, truncated });
+        },
+    });
+    const promptTool = defineTool({
+        name: "mcp_prompt",
+        readOnly: true,
+        description: "List or fetch the prompt templates an MCP server provides. Call with no arguments " +
+            "to see what exists, then with a name to get the template text.",
+        parameters: z.object({
+            name: z.string().optional().describe("Prompt to fetch; omit to list"),
+            server: z.string().optional().describe("Limit to one server"),
+            arguments: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe("Arguments to fill the template with"),
+        }),
+        renderTitle: (input) => (input.name ? `McpPrompt(${input.name})` : "McpPrompt(list)"),
+        async execute(input) {
+            const servers = mcp
+                .status()
+                .filter((s) => s.connected && (!input.server || s.name === input.server));
+            if (servers.length === 0)
+                return toolText("No MCP servers are connected.");
+            if (!input.name) {
+                const lines = [];
+                for (const status of servers) {
+                    const client = mcp.client(status.name);
+                    if (!client)
+                        continue;
+                    const prompts = await client.listPrompts().catch(() => []);
+                    if (prompts.length === 0)
+                        continue;
+                    lines.push(`${status.name}:`);
+                    for (const prompt of prompts) {
+                        const args = prompt.arguments?.length
+                            ? ` (${prompt.arguments.map((a) => (a.required ? a.name : `${a.name}?`)).join(", ")})`
+                            : "";
+                        lines.push(`  ${prompt.name}${args}`);
+                        if (prompt.description)
+                            lines.push(`    ${prompt.description}`);
+                    }
+                }
+                return lines.length === 0
+                    ? toolText("No MCP server exposes any prompts.")
+                    : toolText(lines.join("\n"));
+            }
+            for (const status of servers) {
+                const client = mcp.client(status.name);
+                if (!client)
+                    continue;
+                const prompts = await client.listPrompts().catch(() => []);
+                if (!prompts.some((prompt) => prompt.name === input.name))
+                    continue;
+                try {
+                    const result = await client.getPrompt(input.name, input.arguments ?? {});
+                    return toolText(renderPrompt(result), { server: status.name, prompt: input.name });
+                }
+                catch (err) {
+                    return toolError(`Could not fetch prompt "${input.name}" from ${status.name}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            return toolError(`No MCP server provides a prompt named "${input.name}".`);
+        },
+    });
+    return [listTool, readTool, promptTool];
+}
+/** Flatten an MCP prompt result into text the model can act on. */
+function renderPrompt(result) {
+    const lines = [];
+    if (result.description)
+        lines.push(result.description, "");
+    for (const message of result.messages ?? []) {
+        const role = message.role ?? "user";
+        const content = message.content;
+        if (typeof content === "string") {
+            lines.push(`[${role}] ${content}`);
+            continue;
+        }
+        if (Array.isArray(content)) {
+            for (const block of content) {
+                const text = block?.text;
+                if (typeof text === "string")
+                    lines.push(`[${role}] ${text}`);
+            }
+            continue;
+        }
+        const text = content?.text;
+        if (typeof text === "string")
+            lines.push(`[${role}] ${text}`);
+    }
+    return lines.join("\n").trim() || "(the prompt returned no content)";
+}
+//# sourceMappingURL=mcp-resource.js.map

package/dist/tools/builtin/mcp-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-resource.js","sourceRoot":"","sources":["../../../src/tools/builtin/mcp-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGlD;;;;;;;GAOG;AAEH,MAAM,SAAS,GAAG,MAAM,CAAC;AAEzB,+EAA+E;AAC/E,SAAS,QAAQ,CAAC,GAAW;IAC3B,0EAA0E;IAC1E,+DAA+D;IAC/D,MAAM,KAAK,GAAG,iCAAiC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAe;IACpD,MAAM,QAAQ,GAAG,UAAU,CAAC;QAC1B,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,oFAAoF;YACpF,mFAAmF;YACnF,oBAAoB;QACtB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SAChF,CAAC;QACF,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,KAAK,CAAC,MAAM,IAAI,KAAK,GAAG;QAEhE,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,OAAO,GAAG,GAAG;iBAChB,MAAM,EAAE;iBACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAE5E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,QAAQ,CACb,KAAK,CAAC,MAAM;oBACV,CAAC,CAAC,kCAAkC,KAAK,CAAC,MAAM,IAAI;oBACpD,CAAC,CAAC,+BAA+B,CACpC,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC,MAAM;oBAAE,SAAS;gBAEtB,IAAI,SAAS,CAAC;gBACd,IAAI,CAAC;oBACH,SAAS,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;gBAC3C,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,2DAA2D;oBAC3D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,uBAAuB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBAChE,SAAS;gBACX,CAAC;gBACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBAErC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;gBAC9B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;oBACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;oBACpD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChE,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,IAAI,QAAQ,CAAC,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACnF,IAAI,QAAQ,CAAC,WAAW;wBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;YAED,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;gBACvB,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;gBAClD,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,UAAU,CAAC;QAC1B,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,4EAA4E;YAC5E,oEAAoE;QACtE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YACvE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;SACzE,CAAC;QACF,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,KAAK,CAAC,GAAG,GAAG;QAE/C,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC;YAEjD,qEAAqE;YACrE,yDAAyD;YACzD,MAAM,UAAU,GAAG,UAAU;gBAC3B,CAAC,CAAC,CAAC,UAAU,CAAC;gBACd,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAE/D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC,+BAA+B,CAAC,CAAC;YAC/E,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzC,OAAO,SAAS,CACd,kCAAkC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;oBAC1D,4CAA4C,UAAU,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,IAAI,CAC9E,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAC,kCAAkC,IAAI,IAAI,CAAC,CAAC;YAE1E,IAAI,QAAQ,CAAC;YACb,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,SAAS,CACd,kBAAkB,MAAM,CAAC,GAAG,SAAS,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACjG,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,MAAM,GAAG,SAAS,CAAC;YACvB,IAAI,SAAS,GAAG,KAAK,CAAC;YAEtB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;gBAC3C,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAClC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;oBACzC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM;wBAAE,SAAS,GAAG,IAAI,CAAC;oBACtD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;gBACzB,CAAC;qBAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACrB,kEAAkE;oBAClE,gCAAgC;oBAChC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,IAAI,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,CAAC;gBACzF,CAAC;gBACD,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;oBAChB,SAAS,GAAG,IAAI,CAAC;oBACjB,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC,GAAG,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC;YACnE,OAAO,QAAQ,CACb,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,EAC1D,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,CAC7C,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,UAAU,CAAC;QAC5B,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,oFAAoF;YACpF,gEAAgE;QAClE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YACrE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YAC7D,SAAS,EAAE,CAAC;iBACT,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;iBAC9B,QAAQ,EAAE;iBACV,QAAQ,CAAC,qCAAqC,CAAC;SACnD,CAAC;QACF,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAErF,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,OAAO,GAAG,GAAG;iBAChB,MAAM,EAAE;iBACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAC,+BAA+B,CAAC,CAAC;YAE3E,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACvC,IAAI,CAAC,MAAM;wBAAE,SAAS;oBACtB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;wBAAE,SAAS;oBAEnC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;oBAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;wBAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM;4BACnC,CAAC,CAAC,KAAK,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;4BACtF,CAAC,CAAC,EAAE,CAAC;wBACP,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;wBACtC,IAAI,MAAM,CAAC,WAAW;4BAAE,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;oBAClE,CAAC;gBACH,CAAC;gBACD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;oBACvB,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;oBAChD,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACjC,CAAC;YAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC,MAAM;oBAAE,SAAS;gBACtB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC3D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAEpE,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;oBACzE,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrF,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,SAAS,CACd,2BAA2B,KAAK,CAAC,IAAI,UAAU,MAAM,CAAC,IAAI,KACxD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,OAAO,SAAS,CAAC,0CAA0C,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;QAC7E,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED,mEAAmE;AACnE,SAAS,YAAY,CAAC,MAGrB;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAE3D,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC;QACpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAEhC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAI,KAA2B,EAAE,IAAI,CAAC;gBAChD,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;YAChE,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAI,OAA6B,EAAE,IAAI,CAAC;QAClD,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,kCAAkC,CAAC;AACvE,CAAC"}

package/dist/tools/builtin/memory.d.ts

@@ -0,0 +1,10 @@
+import type { MemoryStore } from "../../agent/memory.ts";
+import type { Tool } from "../types.ts";
+/**
+ * Read and write the agent's durable notes.
+ *
+ * Split into two tools rather than one with a `mode` argument: writing a note
+ * is a decision the model should make deliberately, and a single tool whose
+ * behaviour flips on a string is one the model gets wrong under pressure.
+ */
+export declare function createMemoryTools(memory: MemoryStore): Tool[];