@agentick/sandbox 0.2.1

package/dist/edit.js

@@ -0,0 +1,270 @@
+/**
+ * Surgical Code Editing
+ *
+ * LLM-driven code editing with layered matching that recovers from
+ * trailing whitespace, indentation mismatch, and CRLF/LF differences.
+ *
+ * Pure transform (`applyEdits`) + file wrapper (`editFile`) with atomic writes.
+ */
+import { readFile, writeFile, rename, unlink } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { randomBytes } from "node:crypto";
+export class EditError extends Error {
+    editIndex;
+    detail;
+    constructor(message, editIndex, detail) {
+        super(message);
+        this.editIndex = editIndex;
+        this.detail = detail;
+        this.name = "EditError";
+    }
+}
+/** Precompute byte offset of each line start. */
+function lineStarts(source) {
+    const starts = [0];
+    for (let i = 0; i < source.length; i++) {
+        if (source[i] === "\n")
+            starts.push(i + 1);
+    }
+    return starts;
+}
+/** 1-based line number at byte offset. */
+function lineAtOffset(starts, offset) {
+    let lo = 0, hi = starts.length - 1;
+    while (lo < hi) {
+        const mid = (lo + hi + 1) >> 1;
+        if (starts[mid] <= offset)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    return lo + 1; // 1-based
+}
+/** Byte range covering lines [startLine, endLine] (0-indexed, inclusive). */
+function lineRange(source, starts, sourceLines, startLine, endLine) {
+    const start = starts[startLine];
+    // End = start of endLine + its length (excludes trailing \n)
+    const end = starts[endLine] + sourceLines[endLine].length;
+    return { start, end };
+}
+function countNewlines(s) {
+    let n = 0;
+    for (let i = 0; i < s.length; i++) {
+        if (s[i] === "\n")
+            n++;
+    }
+    return n;
+}
+/** Minimum leading whitespace of non-empty lines. */
+function minIndent(lines) {
+    let min = Infinity;
+    for (const line of lines) {
+        if (line.trim() === "")
+            continue;
+        const indent = line.length - line.trimStart().length;
+        if (indent < min)
+            min = indent;
+    }
+    return min === Infinity ? 0 : min;
+}
+/** Find all non-overlapping occurrences. */
+function findAll(source, needle) {
+    if (needle.length === 0)
+        return [];
+    const positions = [];
+    let pos = 0;
+    while ((pos = source.indexOf(needle, pos)) !== -1) {
+        positions.push(pos);
+        pos += needle.length;
+    }
+    return positions;
+}
+/** Slide `needle` lines over `haystack` lines, comparing with `cmp`. */
+function slideMatch(haystackLines, needleLines, cmp) {
+    const windowSize = needleLines.length;
+    for (let i = 0; i <= haystackLines.length - windowSize; i++) {
+        let match = true;
+        for (let j = 0; j < windowSize; j++) {
+            if (!cmp(haystackLines[i + j], needleLines[j])) {
+                match = false;
+                break;
+            }
+        }
+        if (match)
+            return i; // 0-indexed line
+    }
+    return null;
+}
+/**
+ * Adjust `replacement` indentation to match the delta between
+ * the `old` string and the actual matched source block.
+ */
+function adjustIndent(oldStr, matchedStr, newStr) {
+    const oldLines = oldStr.split("\n");
+    const matchedLines = matchedStr.split("\n");
+    const delta = minIndent(matchedLines) - minIndent(oldLines);
+    if (delta === 0)
+        return newStr;
+    const pad = " ".repeat(Math.abs(delta));
+    return newStr
+        .split("\n")
+        .map((line) => {
+        if (line.trim() === "")
+            return line;
+        if (delta > 0)
+            return pad + line;
+        return line.startsWith(pad) ? line.slice(pad.length) : line.trimStart();
+    })
+        .join("\n");
+}
+// ── Core: Pure Transform ─────────────────────────────────────────────────────
+/**
+ * Apply edits to a source string. Pure function, no I/O.
+ *
+ * Matching strategy per edit (in order):
+ * 1. Exact byte match
+ * 2. Line-normalized (trailing whitespace stripped)
+ * 3. Indent-adjusted (leading whitespace baseline stripped, new indentation adjusted)
+ *
+ * Multi-edit: all matches resolved against original source,
+ * validated for overlap, applied bottom-to-top.
+ *
+ * @throws EditError on match failure or overlapping edits
+ */
+export function applyEdits(source, edits) {
+    if (edits.length === 0)
+        return { content: source, applied: 0, changes: [] };
+    // Normalize CRLF once. Code files should use LF.
+    source = source.replace(/\r\n/g, "\n");
+    const starts = lineStarts(source);
+    const sourceLines = source.split("\n");
+    const replacements = [];
+    for (let i = 0; i < edits.length; i++) {
+        const edit = edits[i];
+        if (edit.old.length === 0) {
+            throw new EditError(`Edit ${i}: old string cannot be empty.`, i);
+        }
+        const old = edit.old.replace(/\r\n/g, "\n");
+        const neu = edit.new.replace(/\r\n/g, "\n");
+        // ── Strategy 1: Exact match ──────────────────────────────────────────
+        const positions = findAll(source, old);
+        if (positions.length > 0) {
+            if (edit.all) {
+                for (const pos of positions) {
+                    replacements.push({ start: pos, end: pos + old.length, content: neu, editIndex: i });
+                }
+            }
+            else if (positions.length === 1) {
+                replacements.push({
+                    start: positions[0],
+                    end: positions[0] + old.length,
+                    content: neu,
+                    editIndex: i,
+                });
+            }
+            else {
+                const lines = positions.map((p) => lineAtOffset(starts, p));
+                throw new EditError(`Edit ${i}: ${positions.length} matches found (lines ${lines.join(", ")}). ` +
+                    `Include more surrounding context to disambiguate, or use all: true.`, i);
+            }
+            continue;
+        }
+        // all: true edits only use exact match — skip fallbacks
+        if (edit.all) {
+            // Zero matches with all: true is a no-op, not an error
+            continue;
+        }
+        const oldLines = old.split("\n");
+        // ── Strategy 2: Line-normalized (strip trailing WS) ──────────────────
+        const normSourceLines = sourceLines.map((l) => l.trimEnd());
+        const normOldLines = oldLines.map((l) => l.trimEnd());
+        const normHit = slideMatch(normSourceLines, normOldLines, (a, b) => a === b);
+        if (normHit !== null) {
+            const { start, end } = lineRange(source, starts, sourceLines, normHit, normHit + oldLines.length - 1);
+            replacements.push({ start, end, content: neu, editIndex: i });
+            continue;
+        }
+        // ── Strategy 3: Indent-adjusted (strip indent baseline, compare shapes)
+        const indentHit = (() => {
+            const baseIndent = minIndent(oldLines);
+            const strippedNeedle = oldLines.map((l) => (l.trim() === "" ? "" : l.slice(baseIndent)));
+            for (let si = 0; si <= sourceLines.length - oldLines.length; si++) {
+                const window = sourceLines.slice(si, si + oldLines.length);
+                const windowIndent = minIndent(window);
+                const strippedWindow = window.map((l) => (l.trim() === "" ? "" : l.slice(windowIndent)));
+                if (strippedNeedle.every((line, j) => line === strippedWindow[j])) {
+                    return si;
+                }
+            }
+            return null;
+        })();
+        if (indentHit !== null) {
+            const { start, end } = lineRange(source, starts, sourceLines, indentHit, indentHit + oldLines.length - 1);
+            const matched = source.slice(start, end);
+            const adjusted = adjustIndent(old, matched, neu);
+            replacements.push({ start, end, content: adjusted, editIndex: i });
+            continue;
+        }
+        // ── No match — diagnostic error ──────────────────────────────────────
+        const firstLine = oldLines[0].trim();
+        let closestLine = -1;
+        for (let j = 0; j < sourceLines.length; j++) {
+            if (sourceLines[j].includes(firstLine)) {
+                closestLine = j + 1;
+                break;
+            }
+        }
+        throw new EditError(`Edit ${i}: no match found` +
+            (closestLine > 0 ? ` (first line appears near line ${closestLine})` : "") +
+            `. First line: "${firstLine.slice(0, 80)}"`, i, closestLine > 0 ? { closest: sourceLines[closestLine - 1], line: closestLine } : undefined);
+    }
+    // ── Validate no overlaps ───────────────────────────────────────────────
+    const sorted = [...replacements].sort((a, b) => a.start - b.start);
+    for (let i = 1; i < sorted.length; i++) {
+        if (sorted[i].start < sorted[i - 1].end) {
+            throw new EditError(`Edits ${sorted[i - 1].editIndex} and ${sorted[i].editIndex} overlap at offset ${sorted[i].start}.`, sorted[i].editIndex);
+        }
+    }
+    // ── Apply bottom-to-top ────────────────────────────────────────────────
+    sorted.sort((a, b) => b.start - a.start);
+    let result = source;
+    const changes = [];
+    for (const rep of sorted) {
+        const before = result.slice(rep.start, rep.end);
+        result = result.slice(0, rep.start) + rep.content + result.slice(rep.end);
+        changes.push({
+            line: lineAtOffset(starts, rep.start),
+            removed: countNewlines(before) + 1,
+            added: countNewlines(rep.content) + 1,
+        });
+    }
+    changes.reverse(); // document order
+    return { content: result, applied: replacements.length, changes };
+}
+// ── File Wrapper ─────────────────────────────────────────────────────────────
+/**
+ * Edit a file on disk. Reads, applies edits, writes atomically (temp + rename).
+ */
+export async function editFile(path, edits) {
+    const source = await readFile(path, "utf-8");
+    const result = applyEdits(source, edits);
+    if (result.applied === 0)
+        return result;
+    // Atomic write: temp in same dir (same filesystem), then rename
+    const tmp = join(dirname(path), `.edit-${randomBytes(6).toString("hex")}.tmp`);
+    try {
+        await writeFile(tmp, result.content, "utf-8");
+        await rename(tmp, path);
+    }
+    catch (err) {
+        try {
+            await unlink(tmp);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw err;
+    }
+    return result;
+}
+//# sourceMappingURL=edit.js.map

package/dist/edit.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @agentick/sandbox - Sandbox primitive layer
+ *
+ * Types, context, component, and pre-built tools for sandboxed execution.
+ */
+export type { Sandbox as SandboxHandle, SandboxProvider, SandboxCreateOptions, SandboxConfig, SandboxSnapshot, ExecOptions, ExecResult, OutputChunk, Mount, Permissions, ResourceLimits, NetworkRule, ProxiedRequest, } from "./types";
+export { applyEdits, editFile, EditError } from "./edit";
+export type { Edit, EditResult, EditChange } from "./edit";
+export { SandboxContext, useSandbox } from "./context";
+export { Sandbox } from "./component";
+export type { SandboxProps } from "./component";
+export { Shell, ReadFile, WriteFile, EditFile } from "./tools";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,OAAO,IAAI,aAAa,EACxB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,KAAK,EACL,WAAW,EACX,cAAc,EACd,WAAW,EACX,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzD,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @agentick/sandbox - Sandbox primitive layer
+ *
+ * Types, context, component, and pre-built tools for sandboxed execution.
+ */
+// ── Edit Types & Utilities ───────────────────────────────────────────────────
+export { applyEdits, editFile, EditError } from "./edit";
+// ── Context & Hook ───────────────────────────────────────────────────────────
+export { SandboxContext, useSandbox } from "./context";
+// ── Component ────────────────────────────────────────────────────────────────
+export { Sandbox } from "./component";
+// ── Tools ────────────────────────────────────────────────────────────────────
+export { Shell, ReadFile, WriteFile, EditFile } from "./tools";
+// ── Testing ──────────────────────────────────────────────────────────────────
+// Import from "@agentick/sandbox/testing" — not re-exported here to avoid
+// pulling vitest into production bundles.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGzD,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvD,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,gFAAgF;AAChF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,gFAAgF;AAChF,0EAA0E;AAC1E,0CAA0C"}

package/dist/testing.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Sandbox Testing Utilities
+ *
+ * Mock implementations for testing sandbox consumers and provider adapters.
+ */
+import type { Sandbox, SandboxProvider } from "./types";
+/**
+ * Create a mock Sandbox with vi.fn() stubs and sensible defaults.
+ *
+ * @example
+ * ```typescript
+ * const sandbox = createMockSandbox({
+ *   exec: vi.fn().mockResolvedValue({ stdout: "hello", stderr: "", exitCode: 0 }),
+ * });
+ * ```
+ */
+export declare function createMockSandbox(overrides?: Partial<Sandbox>): Sandbox;
+/**
+ * Create a mock SandboxProvider whose create() returns a mock sandbox.
+ *
+ * @example
+ * ```typescript
+ * const provider = createMockProvider();
+ * const sandbox = await provider.create({});
+ * expect(sandbox.id).toBe("mock-sandbox-1");
+ * ```
+ */
+export declare function createMockProvider(overrides?: Partial<SandboxProvider>): SandboxProvider;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAc,MAAM,SAAS,CAAC;AAGpE;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAcvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAQxF"}

package/dist/testing.js

@@ -0,0 +1,49 @@
+/**
+ * Sandbox Testing Utilities
+ *
+ * Mock implementations for testing sandbox consumers and provider adapters.
+ */
+import { vi } from "vitest";
+/**
+ * Create a mock Sandbox with vi.fn() stubs and sensible defaults.
+ *
+ * @example
+ * ```typescript
+ * const sandbox = createMockSandbox({
+ *   exec: vi.fn().mockResolvedValue({ stdout: "hello", stderr: "", exitCode: 0 }),
+ * });
+ * ```
+ */
+export function createMockSandbox(overrides) {
+    const defaultExecResult = { stdout: "", stderr: "", exitCode: 0 };
+    const defaultEditResult = { content: "", applied: 0, changes: [] };
+    return {
+        id: "mock-sandbox-1",
+        workspacePath: "/tmp/mock-sandbox",
+        exec: vi.fn().mockResolvedValue(defaultExecResult),
+        readFile: vi.fn().mockResolvedValue(""),
+        writeFile: vi.fn().mockResolvedValue(undefined),
+        editFile: vi.fn().mockResolvedValue(defaultEditResult),
+        destroy: vi.fn().mockResolvedValue(undefined),
+        ...overrides,
+    };
+}
+/**
+ * Create a mock SandboxProvider whose create() returns a mock sandbox.
+ *
+ * @example
+ * ```typescript
+ * const provider = createMockProvider();
+ * const sandbox = await provider.create({});
+ * expect(sandbox.id).toBe("mock-sandbox-1");
+ * ```
+ */
+export function createMockProvider(overrides) {
+    const mockSandbox = createMockSandbox();
+    return {
+        name: "mock",
+        create: vi.fn().mockResolvedValue(mockSandbox),
+        ...overrides,
+    };
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAI5B;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAA4B;IAC5D,MAAM,iBAAiB,GAAe,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC9E,MAAM,iBAAiB,GAAe,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAE/E,OAAO;QACL,EAAE,EAAE,gBAAgB;QACpB,aAAa,EAAE,mBAAmB;QAClC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,iBAAiB,CAAC;QAClD,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACvC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC/C,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,iBAAiB,CAAC;QACtD,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC7C,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAoC;IACrE,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;IAExC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,WAAW,CAAC;QAC9C,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Pre-built Sandbox Tools
+ *
+ * Tools that access the sandbox from the component tree via useSandbox().
+ * Tree-scoped — multiple sandboxes just work, each tool accesses its nearest provider.
+ */
+/**
+ * Execute a shell command in the sandbox.
+ */
+export declare const Shell: import("@agentick/core/tool").RunnableToolClass<{
+    command: string;
+}>;
+/**
+ * Read a file from the sandbox filesystem.
+ */
+export declare const ReadFile: import("@agentick/core/tool").RunnableToolClass<{
+    path: string;
+}>;
+/**
+ * Write a file to the sandbox filesystem.
+ */
+export declare const WriteFile: import("@agentick/core/tool").RunnableToolClass<{
+    path: string;
+    content: string;
+}>;
+/**
+ * Apply surgical edits to a file in the sandbox.
+ */
+export declare const EditFile: import("@agentick/core/tool").RunnableToolClass<{
+    path: string;
+    edits: {
+        old: string;
+        new: string;
+        all?: boolean | undefined;
+    }[];
+}>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,eAAO,MAAM,KAAK;;EAehB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ;;EAWnB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;EAYpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;EA6BnB,CAAC"}

package/dist/tools.js

@@ -0,0 +1,93 @@
+/**
+ * Pre-built Sandbox Tools
+ *
+ * Tools that access the sandbox from the component tree via useSandbox().
+ * Tree-scoped — multiple sandboxes just work, each tool accesses its nearest provider.
+ */
+import { createTool } from "@agentick/core";
+import { z } from "zod";
+import { useSandbox } from "./context";
+/**
+ * Execute a shell command in the sandbox.
+ */
+export const Shell = createTool({
+    name: "shell",
+    description: "Execute a shell command in the sandbox environment.",
+    input: z.object({
+        command: z.string().describe("The shell command to execute."),
+    }),
+    use: () => ({ sandbox: useSandbox() }),
+    handler: async ({ command }, deps) => {
+        const result = await deps.sandbox.exec(command);
+        const parts = [];
+        if (result.stdout)
+            parts.push(result.stdout);
+        if (result.stderr)
+            parts.push(`[stderr]\n${result.stderr}`);
+        if (result.exitCode !== 0)
+            parts.push(`[exit code: ${result.exitCode}]`);
+        return [{ type: "text", text: parts.join("\n") || "(no output)" }];
+    },
+});
+/**
+ * Read a file from the sandbox filesystem.
+ */
+export const ReadFile = createTool({
+    name: "read_file",
+    description: "Read the contents of a file in the sandbox.",
+    input: z.object({
+        path: z.string().describe("Path to the file to read."),
+    }),
+    use: () => ({ sandbox: useSandbox() }),
+    handler: async ({ path }, deps) => {
+        const content = await deps.sandbox.readFile(path);
+        return [{ type: "text", text: content }];
+    },
+});
+/**
+ * Write a file to the sandbox filesystem.
+ */
+export const WriteFile = createTool({
+    name: "write_file",
+    description: "Write content to a file in the sandbox. Creates the file if it doesn't exist.",
+    input: z.object({
+        path: z.string().describe("Path to the file to write."),
+        content: z.string().describe("Content to write to the file."),
+    }),
+    use: () => ({ sandbox: useSandbox() }),
+    handler: async ({ path, content }, deps) => {
+        await deps.sandbox.writeFile(path, content);
+        return [{ type: "text", text: `Wrote ${content.length} bytes to ${path}` }];
+    },
+});
+/**
+ * Apply surgical edits to a file in the sandbox.
+ */
+export const EditFile = createTool({
+    name: "edit_file",
+    description: "Apply surgical edits to a file. Each edit specifies an old string to find and a new string to replace it with.",
+    input: z.object({
+        path: z.string().describe("Path to the file to edit."),
+        edits: z
+            .array(z.object({
+            old: z.string().describe("Exact string to find in the file."),
+            new: z.string().describe("Replacement string. Empty string deletes the match."),
+            all: z
+                .boolean()
+                .optional()
+                .describe("Replace all occurrences. Default: false (requires unique match)."),
+        }))
+            .describe("Array of edits to apply."),
+    }),
+    use: () => ({ sandbox: useSandbox() }),
+    handler: async ({ path, edits }, deps) => {
+        const result = await deps.sandbox.editFile(path, edits);
+        return [
+            {
+                type: "text",
+                text: `Applied ${result.applied} edit(s) to ${path}. Changes: ${result.changes.map((c) => `line ${c.line}: -${c.removed}/+${c.added}`).join(", ")}`,
+            },
+        ];
+    },
+});
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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