@chances-ai/engine 24.0.0

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

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

package/dist/tools/builtins/ask-user-question.d.ts

@@ -0,0 +1,27 @@
+import type { JSONValue } from "@chances-ai/runtime";
+import { type QuestionSpec, type Tool } from "../types.js";
+/**
+ * (5.10b) Pure validation of the model's args into typed {@link QuestionSpec}[].
+ * Schema-locked (counts + types) with uniqueness refines on question texts and
+ * per-question option labels. Returns a typed result so the engine path AND a
+ * unit test both assert it without a TTY (the `reduceModelPicker` convention).
+ * NB: `packages/tools` intentionally has NO zod dependency — every builtin
+ * hand-rolls its arg validation, so the asker does too.
+ */
+export declare function parseQuestions(args: JSONValue): {
+    ok: true;
+    questions: QuestionSpec[];
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * (5.10b) `ask_user_question` — let the model ask the user a structured,
+ * select-don't-type question and wait for the answer. Read-only (`search`): it
+ * has no side effect beyond presenting a chooser, so it is the ONE tool allowed
+ * on the question permission channel (the engine fail-closes any other tool that
+ * emits a `question` request). Headless / `-p` / RPC have no UI → the resolver
+ * declines and we return a deterministic message.
+ */
+export declare const askUserQuestionTool: Tool;
+//# sourceMappingURL=ask-user-question.d.ts.map

package/dist/tools/builtins/ask-user-question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-question.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/ask-user-question.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,IAAI,EAGV,MAAM,aAAa,CAAC;AAiBrB;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,GACd;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,YAAY,EAAE,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA6DxE;AAkBD;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,IA6EjC,CAAC"}

package/dist/tools/builtins/ask-user-question.js

@@ -0,0 +1,191 @@
+import { ASK_USER_QUESTION_TOOL_NAME, } from "../types.js";
+// (5.10b) Schema-locked bounds — mirror claude-code's AskUserQuestion (1–4
+// questions, 2–4 options, short header). The model declares the options; the UI
+// injects the "Other" free-text row itself (the model never declares it).
+const MIN_QUESTIONS = 1;
+const MAX_QUESTIONS = 4;
+const MIN_OPTIONS = 2;
+const MAX_OPTIONS = 4;
+const MAX_HEADER = 16;
+// (codex R2 SHOULD-FIX #2) Upper bound on an option label. The schema asks for
+// 1–5 words; we enforce a length cap (UI safety — a runaway label breaks the tab
+// / list layout) but deliberately NOT word count or a trailing "?" on questions:
+// those are prose guidelines, not correctness constraints (rejecting "Choose an
+// approach:" would be over-strict and would silently drop a valid question).
+const MAX_LABEL = 60;
+/**
+ * (5.10b) Pure validation of the model's args into typed {@link QuestionSpec}[].
+ * Schema-locked (counts + types) with uniqueness refines on question texts and
+ * per-question option labels. Returns a typed result so the engine path AND a
+ * unit test both assert it without a TTY (the `reduceModelPicker` convention).
+ * NB: `packages/tools` intentionally has NO zod dependency — every builtin
+ * hand-rolls its arg validation, so the asker does too.
+ */
+export function parseQuestions(args) {
+    if (typeof args !== "object" || args === null || Array.isArray(args)) {
+        return { ok: false, error: "args must be an object" };
+    }
+    const raw = args.questions;
+    if (!Array.isArray(raw))
+        return { ok: false, error: "`questions` must be an array" };
+    if (raw.length < MIN_QUESTIONS || raw.length > MAX_QUESTIONS) {
+        return { ok: false, error: `\`questions\` must have ${MIN_QUESTIONS}–${MAX_QUESTIONS} items` };
+    }
+    const questions = [];
+    const seenQuestions = new Set();
+    for (const q of raw) {
+        if (typeof q !== "object" || q === null)
+            return { ok: false, error: "each question must be an object" };
+        const obj = q;
+        const question = obj.question;
+        const header = obj.header;
+        if (typeof question !== "string" || question.trim() === "") {
+            return { ok: false, error: "`question` must be a non-empty string" };
+        }
+        if (typeof header !== "string" || header.trim() === "" || header.length > MAX_HEADER) {
+            return { ok: false, error: `\`header\` must be a non-empty string ≤${MAX_HEADER} chars` };
+        }
+        if (seenQuestions.has(question))
+            return { ok: false, error: `duplicate question: "${question}"` };
+        seenQuestions.add(question);
+        const options = obj.options;
+        if (!Array.isArray(options) || options.length < MIN_OPTIONS || options.length > MAX_OPTIONS) {
+            return { ok: false, error: `each question needs ${MIN_OPTIONS}–${MAX_OPTIONS} options` };
+        }
+        const parsedOptions = [];
+        const seenLabels = new Set();
+        for (const o of options) {
+            if (typeof o !== "object" || o === null)
+                return { ok: false, error: "each option must be an object" };
+            const oo = o;
+            const label = oo.label;
+            if (typeof label !== "string" || label.trim() === "") {
+                return { ok: false, error: "option `label` must be a non-empty string" };
+            }
+            if (label.length > MAX_LABEL) {
+                return { ok: false, error: `option \`label\` must be ≤${MAX_LABEL} chars (keep choices concise)` };
+            }
+            if (seenLabels.has(label)) {
+                return { ok: false, error: `duplicate option label "${label}" in question "${question}"` };
+            }
+            seenLabels.add(label);
+            const description = typeof oo.description === "string" ? oo.description : undefined;
+            const preview = typeof oo.preview === "string" ? oo.preview : undefined;
+            parsedOptions.push({
+                label,
+                ...(description ? { description } : {}),
+                ...(preview ? { preview } : {}),
+            });
+        }
+        const multiSelect = typeof obj.multiSelect === "boolean" ? obj.multiSelect : undefined;
+        questions.push({
+            question,
+            header,
+            options: parsedOptions,
+            ...(multiSelect !== undefined ? { multiSelect } : {}),
+        });
+    }
+    return { ok: true, questions };
+}
+/** (5.10b) Render the user's answers as a single model-facing string. The TOOL
+ *  owns this wording (the engine never serializes answers) — mirrors claude-code's
+ *  `mapToolResultToToolResultBlockParam`. */
+function formatAnswers(questions, decision) {
+    const lines = questions.map((q) => {
+        const picked = decision.answers[q.question];
+        const joined = picked && picked.length > 0 ? picked.map((a) => `"${a}"`).join(", ") : "(no answer)";
+        return `- "${q.question}" → ${joined}`;
+    });
+    const notes = questions
+        .map((q) => decision.annotations?.[q.question]?.notes)
+        .filter((n) => typeof n === "string" && n.trim() !== "");
+    const noteBlock = notes.length > 0 ? `\n\nNotes: ${notes.join(" | ")}` : "";
+    return `User has answered the question(s):\n${lines.join("\n")}${noteBlock}`;
+}
+/**
+ * (5.10b) `ask_user_question` — let the model ask the user a structured,
+ * select-don't-type question and wait for the answer. Read-only (`search`): it
+ * has no side effect beyond presenting a chooser, so it is the ONE tool allowed
+ * on the question permission channel (the engine fail-closes any other tool that
+ * emits a `question` request). Headless / `-p` / RPC have no UI → the resolver
+ * declines and we return a deterministic message.
+ */
+export const askUserQuestionTool = {
+    name: ASK_USER_QUESTION_TOOL_NAME,
+    description: "Ask the user one or more multiple-choice questions and wait for their answer. " +
+        "Use when a decision is genuinely the user's to make and you can't resolve it from " +
+        "the request, the code, or sensible defaults — e.g. choosing between approaches, or " +
+        "clarifying ambiguous requirements. Each question has 2–4 mutually-exclusive options; " +
+        "set multiSelect to allow several. Do NOT add an 'Other' option — the UI adds it. " +
+        "Prefer proceeding with a sensible default over asking when the choice is obvious.",
+    category: "search",
+    parameters: {
+        type: "object",
+        properties: {
+            questions: {
+                type: "array",
+                minItems: MIN_QUESTIONS,
+                maxItems: MAX_QUESTIONS,
+                description: "1–4 questions to ask the user.",
+                items: {
+                    type: "object",
+                    properties: {
+                        question: { type: "string", description: "The complete question, ending with '?'." },
+                        header: { type: "string", description: `Short tab/chip label (≤${MAX_HEADER} chars).` },
+                        multiSelect: { type: "boolean", description: "Allow selecting multiple options (default false)." },
+                        options: {
+                            type: "array",
+                            minItems: MIN_OPTIONS,
+                            maxItems: MAX_OPTIONS,
+                            description: "2–4 mutually-exclusive choices. Do not include an 'Other' option.",
+                            items: {
+                                type: "object",
+                                properties: {
+                                    label: { type: "string", description: "Concise choice (1–5 words)." },
+                                    description: { type: "string", description: "What this option means / its trade-offs." },
+                                    preview: { type: "string", description: "Optional Markdown preview shown beside the list." },
+                                },
+                                required: ["label"],
+                            },
+                        },
+                    },
+                    required: ["question", "header", "options"],
+                },
+            },
+        },
+        required: ["questions"],
+    },
+    summarize(args) {
+        const parsed = parseQuestions(args);
+        return parsed.ok ? `ask: ${parsed.questions[0].header}` : "ask: (invalid args)";
+    },
+    permission(args) {
+        const parsed = parseQuestions(args);
+        // Invalid args: return null so the engine bypasses the question channel and
+        // runs execute(), which surfaces the validation error to the model (rather
+        // than presenting an empty/garbage chooser).
+        if (!parsed.ok)
+            return null;
+        return {
+            kind: "question",
+            name: ASK_USER_QUESTION_TOOL_NAME,
+            category: "search",
+            questions: parsed.questions,
+        };
+    },
+    async execute(args, ctx) {
+        const parsed = parseQuestions(args);
+        if (!parsed.ok) {
+            return { ok: false, output: `Invalid ask_user_question args: ${parsed.error}` };
+        }
+        const decision = ctx.questionDecision;
+        // No decision (only reachable via the invalid-args null-bypass, defensive) OR
+        // an explicit decline (user cancelled, or a non-interactive resolver) ⇒ a
+        // deterministic "declined" result.
+        if (!decision || decision.declined) {
+            return { ok: true, output: "User declined to answer the question(s)." };
+        }
+        return { ok: true, output: formatAnswers(parsed.questions, decision) };
+    },
+};
+//# sourceMappingURL=ask-user-question.js.map

package/dist/tools/builtins/ask-user-question.js.map

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

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

@@ -0,0 +1,3 @@
+import type { Tool } from "../types.js";
+export declare const bashTool: Tool;
+//# sourceMappingURL=bash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/bash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,aAAa,CAAC;AA4GpD,eAAO,MAAM,QAAQ,EAAE,IAiEtB,CAAC"}

package/dist/tools/builtins/bash.js

@@ -0,0 +1,158 @@
+import { native } from "@chances-ai/native";
+import { cleanOutput, optNum, persistFullOutput, str } from "./_shared.js";
+/**
+ * `bash` runs a shell command in a real PTY when the native addon is
+ * loaded — programs see `isatty(stdout) === true`, signals propagate to
+ * the process group with a 100 ms grace before SIGKILL. When the addon is
+ * missing (binary not staged for the host platform yet) the facade falls
+ * back to `child_process.spawn`; the user-visible contract is the same,
+ * minus the PTY semantics.
+ *
+ * Output handling is modelled on claude-code's bash tool: ANSI codes are
+ * stripped before the model sees the body (they're tokens of noise for an
+ * LLM); when the stripped body would exceed `INLINE_OUTPUT_BYTES`, the
+ * full payload is persisted to a per-call file under
+ * `.chances/tool-results/` and the inline preview points at it. Per-call
+ * `timeout` defaults to 2 min and caps at 10 min (also claude-code
+ * defaults — long enough for builds and tests, short enough to fail loud
+ * on a hung command).
+ */
+/** Default 2 min, max 10 min — claude-code's `BASH_DEFAULT_TIMEOUT_MS` /
+ * `BASH_MAX_TIMEOUT_MS` (timeouts.ts:2-39). The model can override per
+ * call via the `timeout` arg (in seconds). */
+const DEFAULT_TIMEOUT_MS = 120_000;
+const MAX_TIMEOUT_MS = 600_000;
+/** Inline payload cap. Larger outputs get persisted; matches claude-code's
+ * `BASH_MAX_OUTPUT_LENGTH` default of 30 000 chars. */
+const INLINE_OUTPUT_BYTES = 30_000;
+/** ANSI / OSC / DCS stripper + line-ending normaliser moved to
+ * `_shared.ts` in 5.1 so the new `pty` registry can apply the same
+ * scrubber before bus emit. Original family-of-escape-codes design
+ * notes live there. */
+function clampTimeoutMs(timeoutSec) {
+    if (timeoutSec === undefined)
+        return DEFAULT_TIMEOUT_MS;
+    const ms = Math.floor(timeoutSec * 1000);
+    if (!Number.isFinite(ms) || ms <= 0)
+        return DEFAULT_TIMEOUT_MS;
+    return Math.min(ms, MAX_TIMEOUT_MS);
+}
+/** Persistence helper extracted to `_shared.ts` in 5.1. Same 0o700 dir
+ * + 0o600 file POSIX permissions, same Windows caveat (Node `mode`
+ * only affects the read-only bit there — explicit DACL hardening is a
+ * follow-up). */
+/** Format the final tool body. Layout when oversized:
+ *   `<status prefix line, if any>`
+ *   `[output truncated: showing first 30 KB of 123 KB; full output saved to <path>]`
+ *   `<inline preview>`
+ *
+ * The truncation banner is the first thing after any status prefix so
+ * the model can tell at a glance whether it's looking at the full
+ * payload or a head.
+ *
+ * **`runtimeDropped` is the Rust layer's `outputTruncatedBytes`** —
+ * bytes dropped at the 64 MiB Rust ceiling BEFORE the JS layer ever
+ * sees them. The banner has to surface this honestly: if we said
+ * "full output saved to <path>" while the runtime already silently
+ * dropped 10 GB, the model would assume the persisted file is the
+ * whole story. Round 3 codex SHOULD-FIX. */
+function formatBody(cleaned, workspaceRoot, runtimeDropped, callId) {
+    if (cleaned.length <= INLINE_OUTPUT_BYTES && runtimeDropped === 0) {
+        return { body: cleaned, persistedPath: null, persistedSize: null };
+    }
+    const inlineBytes = INLINE_OUTPUT_BYTES;
+    const totalBytes = cleaned.length;
+    const head = cleaned.length > inlineBytes ? cleaned.slice(0, inlineBytes) : cleaned;
+    const headStr = (Math.min(inlineBytes, cleaned.length) / 1024).toFixed(0);
+    const totalStr = (totalBytes / 1024).toFixed(0);
+    // Caveat for the model if the runtime layer ALREADY dropped bytes —
+    // the persisted file isn't actually the full story in that case.
+    const runtimeNote = runtimeDropped > 0
+        ? `; runtime also dropped ${(runtimeDropped / (1024 * 1024)).toFixed(1)} MiB past the 64 MiB cap (NOT included in the persisted file)`
+        : "";
+    // If the cleaned body fits inline AND the only signal is runtime
+    // drop, we can return the inline body with just a one-line warning
+    // (no persistence needed — the cleaned body IS the full visible
+    // story, we just want the model to know it's incomplete).
+    if (cleaned.length <= inlineBytes) {
+        return {
+            body: `[runtime dropped ${(runtimeDropped / (1024 * 1024)).toFixed(1)} MiB past the 64 MiB cap]\n${cleaned}`,
+            persistedPath: null,
+            persistedSize: null,
+        };
+    }
+    const persistedPath = persistFullOutput(workspaceRoot, cleaned, "bash", "output.txt", callId);
+    const banner = persistedPath
+        ? `[output truncated: showing first ${headStr} KB of ${totalStr} KB; full output saved to ${persistedPath}${runtimeNote}]`
+        : `[output truncated: showing first ${headStr} KB of ${totalStr} KB; persistence failed, remainder dropped${runtimeNote}]`;
+    return {
+        body: `${banner}\n${head}`,
+        persistedPath,
+        persistedSize: totalBytes,
+    };
+}
+export const bashTool = {
+    name: "bash",
+    description: "Run a shell command via a real PTY (ANSI passthrough at the runtime layer; output is stripped of escape codes before being returned to you to save tokens). Output is capped at 30 KB inline; longer outputs are persisted to .chances/tool-results/<id>/output.txt and the inline preview includes the path. Default timeout 120 s, max 600 s. Cancelled / timed-out runs return ok:false with a status prefix.",
+    category: "shell",
+    parameters: {
+        type: "object",
+        properties: {
+            command: { type: "string", description: "Shell command to execute" },
+            timeout: {
+                type: "number",
+                description: "Optional per-call timeout in seconds (default 120, max 600).",
+            },
+        },
+        required: ["command"],
+    },
+    summarize: (args) => `bash: ${str(args, "command")}`,
+    async execute(args, ctx) {
+        const command = str(args, "command");
+        const timeoutMs = clampTimeoutMs(optNum(args, "timeout"));
+        const result = await native.ptyRun({
+            command,
+            cwd: ctx.cwd,
+            signal: ctx.signal,
+            timeoutMs,
+        });
+        // A bash command can mutate anything (mv/rm/build/codegen) and we can't
+        // tell what, so drop the WHOLE shared fs-scan cache — a path-scoped
+        // invalidate would miss files the command created elsewhere ([10.4] /
+        // design §8: bash = full-clear).
+        native.invalidateFsScanCache();
+        const cleaned = cleanOutput(result.output);
+        // (4.1 Round-2 SHOULD-FIX #4) Persist oversized output to the
+        // PARENT workspace's `.chances/tool-results/...` when we're inside
+        // an isolated subagent — the worktree may be removed after the
+        // task finishes (clean exit), which would invalidate any path
+        // surfaced to the model. Outside isolation, `parentWorkspaceRoot`
+        // equals `workspaceRoot`, so this is a no-op.
+        const persistRoot = ctx.parentWorkspaceRoot ?? ctx.workspaceRoot;
+        const { body } = formatBody(cleaned, persistRoot, result.outputTruncatedBytes, ctx.callId);
+        // Status prefix is what the model reads first — must be unambiguous.
+        // Order matters: cancel beats timeout beats non-zero exit, because a
+        // user-initiated cancel might race with a timeout and the user
+        // intent is the more informative attribution.
+        if (result.cancelled) {
+            return { ok: false, output: prefix("(cancelled)", body) };
+        }
+        if (result.timedOut) {
+            return {
+                ok: false,
+                output: prefix(`(timed out after ${(timeoutMs / 1000).toFixed(0)}s)`, body),
+            };
+        }
+        if (result.exitCode === 0) {
+            return { ok: true, output: body || "(no output)" };
+        }
+        return {
+            ok: false,
+            output: prefix(`(exit ${result.exitCode ?? "unknown"})`, body),
+        };
+    },
+};
+function prefix(status, body) {
+    return body.length === 0 ? status : `${status}\n${body}`;
+}
+//# sourceMappingURL=bash.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { Tool } from "../types.js";
+export declare const diffTool: Tool;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/diff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,aAAa,CAAC;AAKpD,eAAO,MAAM,QAAQ,EAAE,IA6EtB,CAAC"}

package/dist/tools/builtins/diff.js

@@ -0,0 +1,83 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { diffStats, linesDiff } from "../diff.js";
+import { PREVIEW_BYTE_CAP, optNum, optStr, safePath, str } from "./_shared.js";
+const DIFF_DEFAULT_MAX_LINES = 60;
+export const diffTool = {
+    name: "diff",
+    description: "Compare two workspace files, or a workspace file vs inline content, and return a unified-style preview. Use this to see what a proposed change would look like before calling 'write' or 'edit'. Exactly one of 'pathB' or 'content' must be provided.",
+    category: "file-read",
+    parameters: {
+        type: "object",
+        properties: {
+            pathA: { type: "string", description: "Path to the baseline file (workspace-relative or absolute under the workspace root)." },
+            pathB: { type: "string", description: "Path to the comparison file. Mutually exclusive with 'content'." },
+            content: { type: "string", description: "Inline content to compare against pathA. Mutually exclusive with 'pathB'." },
+            maxLines: { type: "number", description: `Cap on diff rows in the preview. Default ${DIFF_DEFAULT_MAX_LINES}.` },
+        },
+        required: ["pathA"],
+    },
+    summarize: (args) => {
+        const pathA = str(args, "pathA");
+        const pathB = optStr(args, "pathB");
+        const content = optStr(args, "content");
+        if (pathB)
+            return `diff ${pathA} vs ${pathB}`;
+        if (content !== undefined)
+            return `diff ${pathA} vs ⟨${content.length}-byte input⟩`;
+        return `diff ${pathA}`;
+    },
+    async execute(args, ctx) {
+        const pathARaw = str(args, "pathA");
+        const pathBRaw = optStr(args, "pathB");
+        const inlineRaw = optStr(args, "content");
+        const maxLines = optNum(args, "maxLines") ?? DIFF_DEFAULT_MAX_LINES;
+        if (pathBRaw === undefined && inlineRaw === undefined) {
+            return { ok: false, output: "diff requires either 'pathB' or 'content'" };
+        }
+        if (pathBRaw !== undefined && inlineRaw !== undefined) {
+            return { ok: false, output: "diff cannot accept both 'pathB' and 'content'" };
+        }
+        const pathA = safePath(ctx, pathARaw);
+        if (!existsSync(pathA))
+            return { ok: false, output: `No such file: ${pathARaw}` };
+        const sizeA = statSync(pathA).size;
+        let after;
+        let afterLabel;
+        let afterSize;
+        if (pathBRaw !== undefined) {
+            const pathB = safePath(ctx, pathBRaw);
+            if (!existsSync(pathB))
+                return { ok: false, output: `No such file: ${pathBRaw}` };
+            afterSize = statSync(pathB).size;
+            if (sizeA > PREVIEW_BYTE_CAP || afterSize > PREVIEW_BYTE_CAP) {
+                return {
+                    ok: true,
+                    output: `${pathARaw} (${sizeA} bytes) vs ${pathBRaw} (${afterSize} bytes) — diff preview skipped (one side over ${PREVIEW_BYTE_CAP} bytes).`,
+                };
+            }
+            after = readFileSync(pathB, "utf8");
+            afterLabel = pathBRaw;
+        }
+        else {
+            afterSize = inlineRaw.length;
+            if (sizeA > PREVIEW_BYTE_CAP || afterSize > PREVIEW_BYTE_CAP) {
+                return {
+                    ok: true,
+                    output: `${pathARaw} (${sizeA} bytes) vs ⟨inline⟩ (${afterSize} bytes) — diff preview skipped (one side over ${PREVIEW_BYTE_CAP} bytes).`,
+                };
+            }
+            after = inlineRaw;
+            afterLabel = "⟨inline⟩";
+        }
+        const before = readFileSync(pathA, "utf8");
+        if (before === after)
+            return { ok: true, output: `${pathARaw} and ${afterLabel} are identical` };
+        const { removed, added } = diffStats(before, after);
+        const hunk = linesDiff(before, after, maxLines);
+        return {
+            ok: true,
+            output: `--- ${pathARaw}\n+++ ${afterLabel}\n${hunk}\n(${removed} removed, ${added} added)`,
+        };
+    },
+};
+//# sourceMappingURL=diff.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { Tool } from "../types.js";
+export declare const editTool: Tool;
+//# sourceMappingURL=edit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/edit.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,aAAa,CAAC;AAGpD,eAAO,MAAM,QAAQ,EAAE,IA8BtB,CAAC"}

package/dist/tools/builtins/edit.js

@@ -0,0 +1,40 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { native } from "@chances-ai/native";
+import { linesDiff } from "../diff.js";
+import { preview, safePath, str } from "./_shared.js";
+export const editTool = {
+    name: "edit",
+    description: "Replace an exact, unique substring in a workspace file.",
+    category: "file-write",
+    parameters: {
+        type: "object",
+        properties: { path: { type: "string" }, find: { type: "string" }, replace: { type: "string" } },
+        required: ["path", "find", "replace"],
+    },
+    summarize: (args) => {
+        const path = str(args, "path");
+        const find = str(args, "find");
+        const replace = str(args, "replace");
+        if (!find.includes("\n") && !replace.includes("\n")) {
+            return `edit ${path}: replace ${preview(find)} → ${preview(replace)}`;
+        }
+        return `edit ${path}\n${linesDiff(find, replace)}`;
+    },
+    async execute(args, ctx) {
+        const path = safePath(ctx, str(args, "path"), { resolveSymlinks: true });
+        if (!existsSync(path))
+            return { ok: false, output: `No such file: ${str(args, "path")}` };
+        const find = str(args, "find");
+        const content = readFileSync(path, "utf8");
+        const count = content.split(find).length - 1;
+        if (count === 0)
+            return { ok: false, output: `Substring not found in ${str(args, "path")}` };
+        if (count > 1)
+            return { ok: false, output: `Substring not unique (${count} matches)` };
+        writeFileSync(path, content.replace(find, str(args, "replace")));
+        native.invalidateFsScanCache(dirname(path));
+        return { ok: true, output: `Edited ${str(args, "path")}` };
+    },
+};
+//# sourceMappingURL=edit.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { Tool } from "../types.js";
+export declare const globTool: Tool;
+//# sourceMappingURL=glob.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/glob.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,aAAa,CAAC;AAKpD,eAAO,MAAM,QAAQ,EAAE,IAgCtB,CAAC"}

package/dist/tools/builtins/glob.js

@@ -0,0 +1,37 @@
+import { existsSync } from "node:fs";
+import { native } from "@chances-ai/native";
+import { optNum, optStr, safePath, str } from "./_shared.js";
+const GLOB_DEFAULT_LIMIT = 100;
+export const globTool = {
+    name: "glob",
+    description: "List workspace files matching a glob pattern (e.g. '**/*.ts', 'src/**/*.tsx'). Honors common ignore directories (node_modules, .git, dist, target, .turbo).",
+    category: "search",
+    parameters: {
+        type: "object",
+        properties: {
+            pattern: { type: "string", description: "Glob pattern to match against relative file paths." },
+            path: { type: "string", description: "Sub-path within the workspace to search. Defaults to the workspace root." },
+            limit: { type: "number", description: `Max paths returned. Default ${GLOB_DEFAULT_LIMIT}.` },
+        },
+        required: ["pattern"],
+    },
+    summarize: (args) => {
+        const where = optStr(args, "path");
+        return `glob ${str(args, "pattern")}${where ? ` in ${where}` : ""}`;
+    },
+    async execute(args, ctx) {
+        const pattern = str(args, "pattern");
+        const subPath = optStr(args, "path");
+        const limit = optNum(args, "limit") ?? GLOB_DEFAULT_LIMIT;
+        const searchRoot = subPath ? safePath(ctx, subPath) : ctx.workspaceRoot;
+        if (!existsSync(searchRoot))
+            return { ok: false, output: `No such path: ${subPath}` };
+        const files = await native.glob(pattern, searchRoot, { maxResults: limit + 1, signal: ctx.signal });
+        if (files.length === 0)
+            return { ok: true, output: "No files matched" };
+        const shown = files.slice(0, limit);
+        const more = files.length > limit ? `\n…(more results, raise limit to see them)` : "";
+        return { ok: true, output: shown.join("\n") + more };
+    },
+};
+//# sourceMappingURL=glob.js.map