@chances-ai/engine 28.0.0 → 30.0.0

package/dist/tools/builtins/_image.js

@@ -0,0 +1,76 @@
+/** Long-edge cap (px) — matches Anthropic's vision guidance; keeps the encoded
+ * image well under a sane per-image token budget. */
+const MAX_EDGE = 1568;
+/** Magic-byte → MIME sniffer for the formats we support. Returns null for non-images. */
+export function sniffImageMime(buf) {
+    if (buf.length >= 8 && buf[0] === 0x89 && buf[1] === 0x50 && buf[2] === 0x4e && buf[3] === 0x47)
+        return "image/png";
+    if (buf.length >= 3 && buf[0] === 0xff && buf[1] === 0xd8 && buf[2] === 0xff)
+        return "image/jpeg";
+    if (buf.length >= 6 && buf[0] === 0x47 && buf[1] === 0x49 && buf[2] === 0x46 && buf[3] === 0x38)
+        return "image/gif";
+    if (buf.length >= 12 &&
+        buf[0] === 0x52 && buf[1] === 0x49 && buf[2] === 0x46 && buf[3] === 0x46 && // RIFF
+        buf[8] === 0x57 && buf[9] === 0x45 && buf[10] === 0x42 && buf[11] === 0x50 // WEBP
+    ) {
+        return "image/webp";
+    }
+    return null;
+}
+/** Map a sharp output format to a MIME type. */
+function formatToMime(format, fallback) {
+    switch (format) {
+        case "png":
+            return "image/png";
+        case "jpeg":
+        case "jpg":
+            return "image/jpeg";
+        case "gif":
+            return "image/gif";
+        case "webp":
+            return "image/webp";
+        default:
+            return fallback;
+    }
+}
+/**
+ * Read `buf` (already sniffed as `mime`) into a vision-ready {@link ToolImagePart}.
+ * Resizes the long edge to {@link MAX_EDGE} (never enlarges) so the encoded image
+ * fits a sane token budget; returns base64 bytes + MIME. Without the `sharp`
+ * peer, returns an actionable `ok:false` instead of shipping a multi-MB original.
+ */
+export async function readImageAsParts(buf, displayPath, mime) {
+    // Lazy optional peer: a non-literal specifier keeps it out of the type graph
+    // (sharp isn't a declared dependency), so a missing peer is a runtime null.
+    const specifier = "sharp";
+    const mod = (await import(specifier).catch(() => null));
+    const sharp = mod?.default;
+    if (typeof sharp !== "function") {
+        return {
+            ok: false,
+            output: `Cannot read image ${displayPath}: the optional 'sharp' peer is not installed. Run \`bun add sharp\` to enable image reading.`,
+        };
+    }
+    try {
+        const pipeline = sharp(buf);
+        const meta = await pipeline.metadata();
+        const w = meta.width ?? 0;
+        const h = meta.height ?? 0;
+        const needsResize = w > MAX_EDGE || h > MAX_EDGE;
+        const out = needsResize
+            ? await pipeline.resize({ width: MAX_EDGE, height: MAX_EDGE, fit: "inside", withoutEnlargement: true }).toBuffer()
+            : buf;
+        const outMime = formatToMime(meta.format, mime);
+        const dims = w && h ? ` ${w}×${h}` : "";
+        const resizedNote = needsResize ? ` (resized to fit ${MAX_EDGE}px for the model)` : "";
+        return {
+            ok: true,
+            output: `[image: ${displayPath}${dims}, ${outMime}${resizedNote}]`,
+            images: [{ data: out.toString("base64"), mimeType: outMime }],
+        };
+    }
+    catch (err) {
+        return { ok: false, output: `Failed to decode image ${displayPath}: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+//# sourceMappingURL=_image.js.map

package/dist/tools/builtins/_image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_image.js","sourceRoot":"","sources":["../../../src/tools/builtins/_image.ts"],"names":[],"mappings":"AASA;qDACqD;AACrD,MAAM,QAAQ,GAAG,IAAI,CAAC;AAYtB,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IACpH,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAClG,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IACpH,IACE,GAAG,CAAC,MAAM,IAAI,EAAE;QAChB,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO;QACnF,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,OAAO;MAClF,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gDAAgD;AAChD,SAAS,YAAY,CAAC,MAA0B,EAAE,QAAgB;IAChE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAMD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,WAAmB,EAAE,IAAY;IACnF,6EAA6E;IAC7E,4EAA4E;IAC5E,MAAM,SAAS,GAAG,OAAO,CAAC;IAC1B,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAuB,CAAC;IAC9E,MAAM,KAAK,GAAG,GAAG,EAAE,OAAO,CAAC;IAC3B,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,qBAAqB,WAAW,8FAA8F;SACvI,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QAC3B,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,IAAI,CAAC,GAAG,QAAQ,CAAC;QACjD,MAAM,GAAG,GAAG,WAAW;YACrB,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;YAClH,CAAC,CAAC,GAAG,CAAC;QACR,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,oBAAoB,QAAQ,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,WAAW,WAAW,GAAG,IAAI,KAAK,OAAO,GAAG,WAAW,GAAG;YAClE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;SAC9D,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,WAAW,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IAC7H,CAAC;AACH,CAAC"}

package/dist/tools/builtins/_login-shell.d.ts

@@ -0,0 +1,17 @@
+/** Merge `login` PATH entries into `current`, appending only entries not already
+ * present (current dirs keep priority). Pure — the unit-testable core. */
+export declare function mergePath(current: string, login: string): string;
+/** Ask the login shell for its PATH (`$SHELL -lc 'printf %s "$PATH"'`). Returns
+ * the trimmed PATH, or null on any failure. Injectable for tests. */
+export declare function resolveLoginPath(run?: (shell: string, args: string[]) => {
+    status: number | null;
+    stdout: string;
+}): string | null;
+/**
+ * Resolve + merge the login-shell PATH into `process.env.PATH` once per process.
+ * Best-effort and idempotent; safe to call before every bash run.
+ */
+export declare function ensureLoginShellPath(): void;
+/** Test-only: re-arm the one-shot guard. */
+export declare function __resetLoginShellPath(): void;
+//# sourceMappingURL=_login-shell.d.ts.map

package/dist/tools/builtins/_login-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_login-shell.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/_login-shell.ts"],"names":[],"mappings":"AAeA;0EAC0E;AAC1E,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUhE;AAED;qEACqE;AACrE,wBAAgB,gBAAgB,CAC9B,GAAG,GAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAG9E,GACA,MAAM,GAAG,IAAI,CAUf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAQ3C;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/tools/builtins/_login-shell.js

@@ -0,0 +1,66 @@
+/**
+ * (7.9 [5.9], goose) Login-shell PATH pre-resolution. A GUI-launched process
+ * (the Electron desktop, a double-clicked app) inherits a minimal `PATH` that
+ * omits the user's real toolchain dirs (`/opt/homebrew/bin`, nvm, cargo, …), so
+ * `bash` can't find `node`/`cargo`/`rg`. goose fixes this by asking the user's
+ * login shell for its `PATH` once and merging the missing entries into
+ * `process.env.PATH`, which every child process then inherits.
+ *
+ * One-shot + idempotent. No-op on Windows, when opted out
+ * (`CHANCES_NO_LOGIN_PATH=1`), or when the login shell can't be queried.
+ */
+import { spawnSync } from "node:child_process";
+let resolved = false;
+/** Merge `login` PATH entries into `current`, appending only entries not already
+ * present (current dirs keep priority). Pure — the unit-testable core. */
+export function mergePath(current, login) {
+    const out = current.split(":").filter(Boolean);
+    const seen = new Set(out);
+    for (const entry of login.split(":").filter(Boolean)) {
+        if (!seen.has(entry)) {
+            out.push(entry);
+            seen.add(entry);
+        }
+    }
+    return out.join(":");
+}
+/** Ask the login shell for its PATH (`$SHELL -lc 'printf %s "$PATH"'`). Returns
+ * the trimmed PATH, or null on any failure. Injectable for tests. */
+export function resolveLoginPath(run = (shell, args) => {
+    const r = spawnSync(shell, args, { encoding: "utf8", timeout: 3000 });
+    return { status: r.status, stdout: r.stdout ?? "" };
+}) {
+    const shell = process.env.SHELL || "/bin/bash";
+    try {
+        const r = run(shell, ["-lc", 'printf %s "$PATH"']);
+        if (r.status !== 0)
+            return null;
+        const path = r.stdout.trim();
+        return path.length > 0 ? path : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve + merge the login-shell PATH into `process.env.PATH` once per process.
+ * Best-effort and idempotent; safe to call before every bash run.
+ */
+export function ensureLoginShellPath() {
+    if (resolved)
+        return;
+    resolved = true;
+    if (process.platform === "win32")
+        return;
+    if (process.env.CHANCES_NO_LOGIN_PATH === "1")
+        return;
+    const login = resolveLoginPath();
+    if (!login)
+        return;
+    process.env.PATH = mergePath(process.env.PATH ?? "", login);
+}
+/** Test-only: re-arm the one-shot guard. */
+export function __resetLoginShellPath() {
+    resolved = false;
+}
+//# sourceMappingURL=_login-shell.js.map

package/dist/tools/builtins/_login-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_login-shell.js","sourceRoot":"","sources":["../../../src/tools/builtins/_login-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB;0EAC0E;AAC1E,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAa;IACtD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;qEACqE;AACrE,MAAM,UAAU,gBAAgB,CAC9B,MAAoF,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IAClG,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AACtD,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,QAAQ;QAAE,OAAO;IACrB,QAAQ,GAAG,IAAI,CAAC;IAChB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO;IACzC,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG;QAAE,OAAO;IACtD,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,qBAAqB;IACnC,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC"}

package/dist/tools/builtins/_notebook.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Jupyter notebook (`.ipynb`) rendering for the `read` tool (7.9 [5.5], the
+ * "notebooks last" stage of the staged multimodal decision — delivered this
+ * task, no longer deferred). A notebook is JSON, so reading the raw file would
+ * dump unreadable escaped source + base64 output blobs at the model. Instead we
+ * parse `cells[]` and render a compact, legible cell view (source + text
+ * outputs). This is a READ-ONLY view: it carries no `¶path#tag` hashline header
+ * because the model must not line-edit a rendered notebook — to change a
+ * notebook, edit the raw `.ipynb` JSON (a future NotebookEdit tool). No external
+ * dependency: pure `JSON.parse`.
+ */
+import type { ToolResult } from "../types.js";
+/** Render an `.ipynb` JSON document as a compact, read-only cell view. */
+export declare function renderNotebook(raw: string, displayPath: string): ToolResult;
+//# sourceMappingURL=_notebook.d.ts.map

package/dist/tools/builtins/_notebook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_notebook.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/_notebook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA6D9C,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CA+B3E"}

package/dist/tools/builtins/_notebook.js

@@ -0,0 +1,81 @@
+/** Char budget for the rendered notebook before truncation (≈ read token cap). */
+const MAX_RENDER_CHARS = 200_000;
+/** Per-cell output char cap so one chatty cell can't dominate the render. */
+const MAX_OUTPUT_CHARS = 4_000;
+/** `.ipynb` source/text fields are either a string or an array of line strings. */
+function joinSource(src) {
+    if (Array.isArray(src))
+        return src.join("");
+    return typeof src === "string" ? src : "";
+}
+function stripAnsi(text) {
+    // Strip terminal control sequences that show up in stream/traceback output.
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: stripping ANSI by design.
+    return text.replace(/\[[0-9;]*m/g, "");
+}
+function renderOutputs(outputs) {
+    const blocks = [];
+    for (const out of outputs) {
+        switch (out.output_type) {
+            case "stream":
+                blocks.push(stripAnsi(joinSource(out.text)));
+                break;
+            case "execute_result":
+            case "display_data": {
+                const plain = out.data?.["text/plain"];
+                if (plain !== undefined)
+                    blocks.push(joinSource(plain));
+                else if (out.data)
+                    blocks.push(`[${Object.keys(out.data).join(", ")} output]`);
+                break;
+            }
+            case "error":
+                blocks.push(stripAnsi([`${out.ename ?? "Error"}: ${out.evalue ?? ""}`, ...(out.traceback ?? [])].join("\n")));
+                break;
+            default:
+                break;
+        }
+    }
+    let text = blocks.join("\n").replace(/\n+$/, "");
+    if (text.length > MAX_OUTPUT_CHARS)
+        text = `${text.slice(0, MAX_OUTPUT_CHARS)}\n… [output truncated]`;
+    return text;
+}
+/** Render an `.ipynb` JSON document as a compact, read-only cell view. */
+export function renderNotebook(raw, displayPath) {
+    let nb;
+    try {
+        nb = JSON.parse(raw);
+    }
+    catch (err) {
+        return { ok: false, output: `Not a valid .ipynb (JSON parse failed) ${displayPath}: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    const cells = Array.isArray(nb.cells) ? nb.cells : null;
+    if (!cells)
+        return { ok: false, output: `No cells[] found in ${displayPath} — not a Jupyter notebook.` };
+    const parts = [
+        `[notebook: ${displayPath}, ${cells.length} cell(s) — read-only rendering; edit the raw .ipynb JSON to change it]`,
+    ];
+    let truncated = false;
+    for (let i = 0; i < cells.length; i++) {
+        if (parts.join("\n").length > MAX_RENDER_CHARS) {
+            truncated = true;
+            break;
+        }
+        const cell = cells[i];
+        const type = cell.cell_type ?? "unknown";
+        const src = joinSource(cell.source).replace(/\n$/, "");
+        parts.push(`\n# Cell ${i + 1} · ${type}`);
+        if (src.length > 0)
+            parts.push(src);
+        if (type === "code" && Array.isArray(cell.outputs) && cell.outputs.length > 0) {
+            const outText = renderOutputs(cell.outputs);
+            if (outText.length > 0)
+                parts.push(`## Output:\n${outText}`);
+        }
+    }
+    if (truncated)
+        parts.push(`\n… [notebook truncated at ${MAX_RENDER_CHARS} chars — open the raw file for the rest]`);
+    return { ok: true, output: parts.join("\n") };
+}
+//# sourceMappingURL=_notebook.js.map

package/dist/tools/builtins/_notebook.js.map

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

package/dist/tools/builtins/_pdf.d.ts

@@ -0,0 +1,19 @@
+/**
+ * PDF text extraction for the `read` tool (7.9 [5.5], the "PDF after image"
+ * stage — delivered this task, no longer deferred). PDFs are binary, so they
+ * route here before the binary reject (like images). Text is extracted via
+ * `unpdf` — a LAZY optional peer (absent ⇒ a clear `bun add unpdf` hint; the
+ * tool degrades, nothing else breaks), mirroring the `sharp` image peer. The
+ * extracted text is a READ-ONLY view (no `¶path#tag`): the model cannot
+ * line-edit a PDF.
+ */
+import type { ToolResult } from "../types.js";
+/** Magic-byte sniff: a PDF starts with `%PDF`. */
+export declare function sniffPdf(buf: Buffer): boolean;
+/**
+ * Extract text from a PDF `buf` into a read-only tool result. Without the
+ * `unpdf` peer, returns an actionable `ok:false` instead of refusing as a
+ * generic binary file.
+ */
+export declare function readPdfAsText(buf: Buffer, displayPath: string): Promise<ToolResult>;
+//# sourceMappingURL=_pdf.d.ts.map

package/dist/tools/builtins/_pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_pdf.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/_pdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAUD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BzF"}

package/dist/tools/builtins/_pdf.js

@@ -0,0 +1,42 @@
+/** Char budget for extracted PDF text before truncation (≈ read token cap). */
+const MAX_TEXT_CHARS = 200_000;
+/** Magic-byte sniff: a PDF starts with `%PDF`. */
+export function sniffPdf(buf) {
+    return buf.length >= 5 && buf[0] === 0x25 && buf[1] === 0x50 && buf[2] === 0x44 && buf[3] === 0x46;
+}
+/**
+ * Extract text from a PDF `buf` into a read-only tool result. Without the
+ * `unpdf` peer, returns an actionable `ok:false` instead of refusing as a
+ * generic binary file.
+ */
+export async function readPdfAsText(buf, displayPath) {
+    // Lazy optional peer: a non-literal specifier keeps it out of the type graph
+    // (unpdf isn't a declared dependency), so a missing peer is a runtime null.
+    const specifier = "unpdf";
+    const mod = (await import(specifier).catch(() => null));
+    if (!mod || typeof mod.getDocumentProxy !== "function" || typeof mod.extractText !== "function") {
+        return {
+            ok: false,
+            output: `Cannot read PDF ${displayPath}: the optional 'unpdf' peer is not installed. Run \`bun add unpdf\` to enable PDF reading.`,
+        };
+    }
+    try {
+        const doc = await mod.getDocumentProxy(new Uint8Array(buf));
+        const { totalPages, text } = await mod.extractText(doc, { mergePages: true });
+        let body = Array.isArray(text) ? text.join("\n\n") : String(text);
+        let truncated = false;
+        if (body.length > MAX_TEXT_CHARS) {
+            body = body.slice(0, MAX_TEXT_CHARS);
+            truncated = true;
+        }
+        const note = truncated ? `\n\n… [PDF text truncated at ${MAX_TEXT_CHARS} chars]` : "";
+        return {
+            ok: true,
+            output: `[pdf: ${displayPath}, ${totalPages} page(s), text extracted — read-only]\n\n${body}${note}`,
+        };
+    }
+    catch (err) {
+        return { ok: false, output: `Failed to extract PDF text from ${displayPath}: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+//# sourceMappingURL=_pdf.js.map

package/dist/tools/builtins/_pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_pdf.js","sourceRoot":"","sources":["../../../src/tools/builtins/_pdf.ts"],"names":[],"mappings":"AAWA,+EAA+E;AAC/E,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,kDAAkD;AAClD,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AACrG,CAAC;AAUD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,WAAmB;IAClE,6EAA6E;IAC7E,4EAA4E;IAC5E,MAAM,SAAS,GAAG,OAAO,CAAC;IAC1B,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAuB,CAAC;IAC9E,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,gBAAgB,KAAK,UAAU,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAChG,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,mBAAmB,WAAW,4FAA4F;SACnI,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9E,IAAI,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;YACjC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;YACrC,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,gCAAgC,cAAc,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,SAAS,WAAW,KAAK,UAAU,4CAA4C,IAAI,GAAG,IAAI,EAAE;SACrG,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mCAAmC,WAAW,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IACtI,CAAC;AACH,CAAC"}

package/dist/tools/builtins/_shared.d.ts

@@ -45,6 +45,12 @@ export declare function guardWrite(ctx: ToolContext, p: string): string;
 export declare function safePath(ctx: ToolContext, p: string, opts?: {
     resolveSymlinks?: boolean;
 }): string;
+/** **Hashline snapshot key.** The canonical absolute path under which `read`
+ * records a file's full-text snapshot and `edit`'s patcher resolves the section
+ * tag — both MUST agree or every edit would re-read. Lexical `resolve(cwd, p)`
+ * (NOT realpath): it must match how the model re-states the path in a patch
+ * header, and the realpath jail already runs at write time. (7.9) */
+export declare function hashlineSnapshotKey(ctx: ToolContext, p: string): string;
 /** Atomically write `body` to `path`: write a sibling temp file then `rename`
  * over the target (rename is atomic within a filesystem), so a crash mid-write
  * never leaves a half-written file. Creates parent dirs. The temp lives in the
@@ -82,5 +88,10 @@ export declare function safeArtifactId(raw: string): string;
  * bit on Windows; ACL-based access control is not enforced via this
  * argument. POSIX-first audience; explicit DACL hardening is a follow-up.
  */
+/** (7.9 [5.10]) Bound the `.chances/tool-results/` ring: keep the `max`
+ * most-recently-modified artifact dirs, delete the rest. Best-effort — a prune
+ * failure never affects the tool result. Called after a bash persist so a long
+ * session's persisted outputs can't grow unbounded. */
+export declare function pruneToolResultsRing(workspaceRoot: string, max?: number): void;
 export declare function persistFullOutput(workspaceRoot: string, body: string, prefix?: string, filename?: string, id?: string): string | null;
 //# sourceMappingURL=_shared.d.ts.map

package/dist/tools/builtins/_shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/_shared.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;sDAEsD;AACtD,eAAO,MAAM,gBAAgB,QAAa,CAAC;AAE3C,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOvE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAKzE;AAED;;;;;;;yCAOyC;AACzC,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED;;;;;;;;;;;;mCAYmC;AACnC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED;;;;;wEAKwE;AACxE,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED;;;eAGe;AACf,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAGlG;AAED;;;kEAGkE;AAClE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAahE;AAED,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzC;AAaD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEnF;;;;;;;;;;;mFAWmF;AACnF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,SAAS,EACf,QAAQ,SAAe,EACvB,EAAE,CAAC,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAef"}
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/_shared.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;sDAEsD;AACtD,eAAO,MAAM,gBAAgB,QAAa,CAAC;AAE3C,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOvE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAKzE;AAED;;;;;;;yCAOyC;AACzC,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED;;;;;;;;;;;;mCAYmC;AACnC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED;;;;;wEAKwE;AACxE,wBAAgB,UAAU,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED;;;eAGe;AACf,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAGlG;AAED;;;;qEAIqE;AACrE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;kEAGkE;AAClE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAahE;AAED,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzC;AAaD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEnF;;;;;;;;;;;mFAWmF;AACnF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;;;;;;;;;;;GAeG;AACH;;;uDAGuD;AACvD,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,IAAI,CAuB3E;AAED,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,SAAS,EACf,QAAQ,SAAe,EACvB,EAAE,CAAC,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAef"}

package/dist/tools/builtins/_shared.js

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-import { chmodSync, mkdirSync, renameSync, statSync, writeFileSync } from "node:fs";
+import { chmodSync, mkdirSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { native } from "@chances-ai/native";
 import { AppError, ErrorCode, createId, currentCwdOverride } from "@chances-ai/runtime";
@@ -98,6 +98,14 @@ export function safePath(ctx, p, opts) {
     const isolated = currentCwdOverride() !== undefined;
     return isolated || opts?.resolveSymlinks ? containWritePath(ctx, p) : containReadPath(ctx, p);
 }
+/** **Hashline snapshot key.** The canonical absolute path under which `read`
+ * records a file's full-text snapshot and `edit`'s patcher resolves the section
+ * tag — both MUST agree or every edit would re-read. Lexical `resolve(cwd, p)`
+ * (NOT realpath): it must match how the model re-states the path in a patch
+ * header, and the realpath jail already runs at write time. (7.9) */
+export function hashlineSnapshotKey(ctx, p) {
+    return isAbsolute(p) ? p : resolve(ctx.cwd, p);
+}
 /** Atomically write `body` to `path`: write a sibling temp file then `rename`
  * over the target (rename is atomic within a filesystem), so a crash mid-write
  * never leaves a half-written file. Creates parent dirs. The temp lives in the
@@ -167,6 +175,37 @@ export function safeArtifactId(raw) {
  * bit on Windows; ACL-based access control is not enforced via this
  * argument. POSIX-first audience; explicit DACL hardening is a follow-up.
  */
+/** (7.9 [5.10]) Bound the `.chances/tool-results/` ring: keep the `max`
+ * most-recently-modified artifact dirs, delete the rest. Best-effort — a prune
+ * failure never affects the tool result. Called after a bash persist so a long
+ * session's persisted outputs can't grow unbounded. */
+export function pruneToolResultsRing(workspaceRoot, max = 100) {
+    try {
+        const dir = join(workspaceRoot, ".chances", "tool-results");
+        const entries = readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory());
+        if (entries.length <= max)
+            return;
+        const byMtime = entries
+            .map((e) => {
+            const full = join(dir, e.name);
+            let mtimeMs = 0;
+            try {
+                mtimeMs = statSync(full).mtimeMs;
+            }
+            catch {
+                /* racing removal — treat as oldest */
+            }
+            return { full, mtimeMs };
+        })
+            .sort((a, b) => a.mtimeMs - b.mtimeMs);
+        for (const victim of byMtime.slice(0, byMtime.length - max)) {
+            rmSync(victim.full, { recursive: true, force: true });
+        }
+    }
+    catch {
+        /* best-effort */
+    }
+}
 export function persistFullOutput(workspaceRoot, body, prefix = "tool", filename = "output.txt", id) {
     try {
         // `id !== undefined` (not truthiness) so an empty-string call id still

package/dist/tools/builtins/_shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/tools/builtins/_shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGxF;;sDAEsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC;AAE3C,MAAM,UAAU,GAAG,CAAC,IAAe,EAAE,GAAW;IAC9C,MAAM,CAAC,GAAI,IAAkC,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,wBAAwB,GAAG,GAAG,CAAC,CAAC;IAC9F,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAe,EAAE,GAAW;IACjD,MAAM,CAAC,GAAI,IAAkC,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,wBAAwB,GAAG,GAAG,CAAC,CAAC;IAC9F,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAe,EAAE,GAAW;IACjD,MAAM,CAAC,GAAI,IAAkC,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,wBAAwB,GAAG,GAAG,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAe,EAAE,GAAW;IAClD,MAAM,CAAC,GAAI,IAAkC,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,yBAAyB,GAAG,GAAG,CAAC,CAAC;IAChG,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;;yCAOyC;AACzC,MAAM,UAAU,eAAe,CAAC,GAAgB,EAAE,CAAS;IACzD,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,2BAA2B,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;mCAYmC;AACnC,MAAM,UAAU,gBAAgB,CAAC,GAAgB,EAAE,CAAS;IAC1D,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,2BAA2B,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED;;;;;wEAKwE;AACxE,MAAM,UAAU,UAAU,CAAC,GAAgB,EAAE,CAAS;IACpD,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,UAAU,EACpB,8CAA8C,MAAM,MAAM,CAAC,EAAE,CAC9D,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;eAGe;AACf,MAAM,UAAU,QAAQ,CAAC,GAAgB,EAAE,CAAS,EAAE,IAAoC;IACxF,MAAM,QAAQ,GAAG,kBAAkB,EAAE,KAAK,SAAS,CAAC;IACpD,OAAO,QAAQ,IAAI,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAChG,CAAC;AAED;;;kEAGkE;AAClE,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY;IACxD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;IAC1D,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzB,+EAA+E;IAC/E,iFAAiF;IACjF,sDAAsD;IACtD,IAAI,CAAC;QACH,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;IACD,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACxE,CAAC;AAED,8EAA8E;AAC9E,wEAAwE;AACxE,uEAAuE;AACvE,sDAAsD;AACtD,qEAAqE;AACrE,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,sEAAsE;AACtE,+DAA+D;AAC/D,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEnF;;;;;;;;;;;mFAWmF;AACnF,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnD,OAAO,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC/B,aAAqB,EACrB,IAAY,EACZ,MAAM,GAAG,MAAM,EACf,QAAQ,GAAG,YAAY,EACvB,EAAW;IAEX,IAAI,CAAC;QACH,uEAAuE;QACvE,qEAAqE;QACrE,qEAAqE;QACrE,kDAAkD;QAClD,MAAM,OAAO,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QACrE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACjC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/tools/builtins/_shared.ts"],"names":[],"mappings":"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"}

package/dist/tools/builtins/ast-edit.d.ts

@@ -0,0 +1,18 @@
+import type { Tool } from "../types.js";
+/**
+ * Structural rewrite across files (ast-grep `pattern` → `rewrite`). High-risk:
+ * the native pass walks a directory and rewrites every match, so the TS wrapper
+ * (R1-M2) enforces the workspace's write safety the native layer can't:
+ *
+ *  1. realpath-jail the search root;
+ *  2. dry-run to learn the affected file set;
+ *  3. `guardWrite` EVERY affected file (jail + protected-path floor) — any
+ *     failure aborts the whole pass with zero writes;
+ *  4. hold all affected files' mutation locks (sorted, deadlock-free);
+ *  5. only then run the real (write) pass; invalidate fs-scan caches.
+ *
+ * The `permission()` hook scopes the approval cache to `ctx.callId`, so every
+ * invocation re-prompts — ast_edit is never auto-approved (R1-OQ6).
+ */
+export declare const astEditTool: Tool;
+//# sourceMappingURL=ast-edit.d.ts.map

package/dist/tools/builtins/ast-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-edit.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/ast-edit.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAwB,IAAI,EAA2B,MAAM,aAAa,CAAC;AAIvF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW,EAAE,IAuFzB,CAAC"}

package/dist/tools/builtins/ast-edit.js

@@ -0,0 +1,109 @@
+import { dirname, join } from "node:path";
+import { native } from "@chances-ai/native";
+import { withSortedFileLocks } from "../file-lock.js";
+import { astErr } from "./ast-grep.js";
+import { containWritePath, guardWrite, optStr, preview, str } from "./_shared.js";
+/**
+ * Structural rewrite across files (ast-grep `pattern` → `rewrite`). High-risk:
+ * the native pass walks a directory and rewrites every match, so the TS wrapper
+ * (R1-M2) enforces the workspace's write safety the native layer can't:
+ *
+ *  1. realpath-jail the search root;
+ *  2. dry-run to learn the affected file set;
+ *  3. `guardWrite` EVERY affected file (jail + protected-path floor) — any
+ *     failure aborts the whole pass with zero writes;
+ *  4. hold all affected files' mutation locks (sorted, deadlock-free);
+ *  5. only then run the real (write) pass; invalidate fs-scan caches.
+ *
+ * The `permission()` hook scopes the approval cache to `ctx.callId`, so every
+ * invocation re-prompts — ast_edit is never auto-approved (R1-OQ6).
+ */
+export const astEditTool = {
+    name: "ast_edit",
+    category: "file-write",
+    description: "Structural find-and-replace across files with an ast-grep pattern → rewrite (e.g. `console.log($A)` → " +
+        "`logger.info($A)`). Matches by SYNTAX and rewrites every occurrence under `path` (a file or directory, " +
+        "default: workspace root), so it is the right tool for a global rename/refactor that `edit` would need many " +
+        "hunks for. Each run is previewed (dry-run) and requires explicit approval — it can touch many files. " +
+        "`$A`/`$$$` metavariables captured by the pattern can be referenced in the rewrite.",
+    parameters: {
+        type: "object",
+        properties: {
+            pattern: { type: "string" },
+            rewrite: { type: "string", description: "Replacement template; may reference $A/$$$ metavars from the pattern." },
+            path: { type: "string", description: "File or directory to rewrite (default: workspace root)." },
+            lang: { type: "string" },
+            glob: { type: "string", description: "Glob filter for relative paths in a directory walk." },
+        },
+        required: ["pattern", "rewrite"],
+    },
+    // Never auto-approve: a per-call cacheKey means the gate prompts every time.
+    permission(args, ctx) {
+        return {
+            name: "ast_edit",
+            category: "file-write",
+            summary: `ast_edit (structural rewrite, may touch multiple files): ${preview(str(args, "pattern"))} → ${preview(str(args, "rewrite"))}${optStr(args, "path") ? ` under ${optStr(args, "path")}` : ""}`,
+            args,
+            cacheKey: `ast_edit:${ctx.callId ?? "no-call"}`,
+        };
+    },
+    summarize: (args) => {
+        const where = optStr(args, "path");
+        return `ast_edit ${preview(str(args, "pattern"))} → ${preview(str(args, "rewrite"))}${where ? ` under ${where}` : ""}`;
+    },
+    async execute(args, ctx) {
+        const pattern = str(args, "pattern");
+        const rewrite = str(args, "rewrite");
+        const lang = optStr(args, "lang");
+        const glob = optStr(args, "glob");
+        // (R1-M2 step 1) realpath-jail the search root within the workspace.
+        let root;
+        try {
+            root = containWritePath(ctx, optStr(args, "path") ?? ".");
+        }
+        catch (err) {
+            return { ok: false, output: err instanceof Error ? err.message : String(err) };
+        }
+        // (R1-M2 step 2) dry-run to learn the affected file set.
+        let dry;
+        try {
+            dry = await native.astEdit({ pattern, rewrite, path: root, lang, glob, dryRun: true });
+        }
+        catch (err) {
+            return { ok: false, output: astErr(err, "ast_edit") };
+        }
+        if (dry.replacements === 0) {
+            return { ok: true, output: `No matches for ${JSON.stringify(pattern)} — nothing rewritten.` };
+        }
+        // (R1-M2 step 3) guardWrite EVERY affected file (jail + protected floor).
+        // Any rejection aborts before a single byte is written.
+        const affected = dry.files.map((f) => join(root, f.path));
+        try {
+            for (const abs of affected)
+                guardWrite(ctx, abs);
+        }
+        catch (err) {
+            return { ok: false, output: `ast_edit refused: ${err instanceof Error ? err.message : String(err)}` };
+        }
+        // (R1-M2 steps 4-5) hold all locks, run the real pass, invalidate caches.
+        return withSortedFileLocks(affected, async () => {
+            let result;
+            try {
+                result = await native.astEdit({ pattern, rewrite, path: root, lang, glob, dryRun: false });
+            }
+            catch (err) {
+                return { ok: false, output: astErr(err, "ast_edit") };
+            }
+            for (const dir of new Set(affected.map((p) => dirname(p)))) {
+                native.invalidateFsScanCache(dir);
+            }
+            const fileList = result.files.map((f) => `  ${f.path} (${f.count})`).join("\n");
+            return {
+                ok: true,
+                output: `Rewrote ${result.replacements} occurrence(s) across ${result.files.length} file(s). ` +
+                    `Re-read any file before a follow-up hashline edit (its tag changed):\n${fileList}`,
+            };
+        });
+    },
+};
+//# sourceMappingURL=ast-edit.js.map

package/dist/tools/builtins/ast-edit.js.map

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