@documonster/mcp 0.8.0-canary.sha.09791dab

package/dist/tools/pdf-edit.js

@@ -0,0 +1,390 @@
+/**
+ * `pdf_edit` — structural and overlay edits to an existing PDF.
+ *
+ * The operations here are the ones that need no understanding of the content:
+ * stamp a watermark, add page numbers, drop or keep pages, rotate, append
+ * another PDF. That is exactly the set a model can drive safely, because
+ * getting them wrong is visible rather than subtle.
+ *
+ * Overlays are drawn on a separate content stream layered over the original, so
+ * existing page content is never redrawn.
+ *
+ * How the file is saved depends on what was asked for, and it matters:
+ *
+ * - **Overlay-only** edits (watermark, page numbers, stamp) are saved as an
+ *   incremental update where the format allows it, which appends to the original
+ *   bytes and therefore keeps bookmarks, form fields and any signature intact.
+ * - **Structural** edits (delete/keep pages, rotate, append) require a full
+ *   rebuild. That renumbers objects, invalidates signatures and may drop
+ *   document-level structures the rebuilder does not carry over. The result says
+ *   so rather than leaving the caller to discover it.
+ *
+ * Deliberately absent: extracting or reflowing text into a new PDF, which no
+ * faithful implementation exists for.
+ */
+import { readFile } from "node:fs/promises";
+import { Pdf } from "documonster/pdf";
+import { z } from "zod";
+import { toolError } from "../errors.js";
+import { assertWritable, resolveEditTarget, resolveInRoot } from "../sandbox.js";
+import { parsePages, supportsIncrementalUpdate } from "./document.js";
+import { assertReadableSize, assertUnchanged, backupOnce, describeBackup, fingerprint, isSameFile, writeBytesWithPolicy, writeFileAtomic } from "./fs-helpers.js";
+import { formatBytes, textResult } from "./result.js";
+import { defineTool } from "./types.js";
+/** Operations that cannot be expressed as an appended incremental update. */
+const STRUCTURAL_OPS = new Set(["delete_pages", "keep_pages", "rotate", "append"]);
+/** Pages a single call may touch. */
+const MAX_PAGES = 2_000;
+const opSchema = z.discriminatedUnion("op", [
+    z.object({
+        op: z.literal("watermark"),
+        text: z.string().min(1).describe('Watermark text, e.g. "DRAFT" or "CONFIDENTIAL".'),
+        pages: z
+            .union([z.array(z.number().int().positive()), z.string()])
+            .optional()
+            .describe('Pages to stamp, as [1,2] or "1-3,7". Omit for every page.'),
+        fontSize: z.number().positive().max(200).optional().describe("Defaults to 48."),
+        color: z.string().optional().describe('Hex RGB without "#". Defaults to "FF0000".'),
+        opacity: z.number().min(0.05).max(1).optional().describe("Defaults to 0.25."),
+        rotation: z.number().optional().describe("Degrees. Defaults to 45.")
+    }),
+    z.object({
+        op: z.literal("page_numbers"),
+        format: z
+            .string()
+            .optional()
+            .describe('Template using {page} and {total}, e.g. "Page {page} of {total}". Defaults to that.'),
+        startAt: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Number to give the first page. Defaults to 1."),
+        fontSize: z.number().positive().max(72).optional().describe("Defaults to 9."),
+        position: z
+            .enum(["bottom-right", "bottom-center", "bottom-left"])
+            .optional()
+            .describe("Defaults to bottom-center.")
+    }),
+    z.object({
+        op: z.literal("stamp"),
+        text: z.string().min(1).describe("Text to place at a fixed position."),
+        x: z.number().describe("Points from the left edge."),
+        y: z.number().describe("Points from the BOTTOM edge — PDF coordinates start bottom-left."),
+        pages: z.union([z.array(z.number().int().positive()), z.string()]).optional(),
+        fontSize: z.number().positive().max(200).optional().describe("Defaults to 12."),
+        color: z.string().optional().describe('Hex RGB without "#". Defaults to "000000".')
+    }),
+    z.object({
+        op: z.literal("delete_pages"),
+        pages: z
+            .union([z.array(z.number().int().positive()), z.string()])
+            .describe('Pages to remove, e.g. "2,5-7".')
+    }),
+    z.object({
+        op: z.literal("keep_pages"),
+        pages: z
+            .union([z.array(z.number().int().positive()), z.string()])
+            .describe("Pages to keep; all others are removed.")
+    }),
+    z.object({
+        op: z.literal("rotate"),
+        degrees: z.union([z.literal(90), z.literal(180), z.literal(270)]),
+        pages: z
+            .union([z.array(z.number().int().positive()), z.string()])
+            .optional()
+            .describe("Set these pages' absolute rotation to 90, 180 or 270 degrees; it is not relative to their current rotation.")
+    }),
+    z.object({
+        op: z.literal("append"),
+        path: z.string().min(1).describe("Another PDF to append, relative to the server root."),
+        pages: z
+            .union([z.array(z.number().int().positive()), z.string()])
+            .optional()
+            .describe("Pages of that PDF to append. Omit for all of them.")
+    })
+]);
+export const pdfEditTool = defineTool({
+    name: "pdf_edit",
+    group: "pdf",
+    title: "Edit an existing PDF",
+    description: "Apply operations to a PDF: watermark, page numbers, a positioned stamp, delete or keep pages, rotate, or append another PDF. Overlays are drawn over the original content, which is never rewritten. Use dryRun to see the effect described before writing. There is no text extraction into a new PDF and no PDF→Word.",
+    inputSchema: {
+        path: z.string().min(1).describe("PDF to edit, relative to the server root."),
+        ops: z.array(opSchema).min(1).describe("Operations, applied in order."),
+        out: z
+            .string()
+            .optional()
+            .describe("Write below @output/. Required for input files unless --allow-in-place is enabled."),
+        dryRun: z.boolean().optional().describe("Describe what would change without writing."),
+        backup: z
+            .boolean()
+            .optional()
+            .describe("When editing in place, copy the original to <name>.bak first. Defaults to true."),
+        overwrite: z.boolean().optional().describe("Replace an existing `out` file. Defaults to false.")
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: false
+    },
+    mutates: true,
+    handler: async (args, context) => {
+        const { config } = context;
+        assertWritable(config);
+        const resolved = await resolveInRoot(config, args.path, { mustExist: true });
+        await assertReadableSize(config, resolved, args.path);
+        const inputVersion = await fingerprint(resolved);
+        const bytes = new Uint8Array(await readFile(resolved));
+        const info = await Pdf.read(bytes, { extractText: false, extractImages: false }).catch((cause) => {
+            throw toolError.unsupported(`could not read ${args.path} as a PDF`, "A password-protected PDF cannot be edited here. Run doc_inspect to check the file type.", { cause });
+        });
+        const pageCount = info.metadata?.pageCount ?? 0;
+        if (pageCount === 0) {
+            throw toolError.unsupported(`${args.path} reports no pages`, "The file may be corrupt.");
+        }
+        if (pageCount > MAX_PAGES) {
+            throw toolError.tooLarge(`${args.path} has ${pageCount} pages, over the ${MAX_PAGES} limit`, "Split it first with a keep_pages operation on a copy.");
+        }
+        // Editor.load is synchronous despite the async surroundings.
+        let editor;
+        try {
+            editor = Pdf.Editor.load(bytes);
+        }
+        catch (cause) {
+            throw toolError.unsupported(`could not open ${args.path} for editing`, undefined, { cause });
+        }
+        // Page count changes as pages are removed, so it is tracked through the
+        // operation list rather than read once.
+        const pageMap = Array.from({ length: pageCount }, (_, index) => index);
+        const applied = [];
+        // Structural operations force a full rebuild; overlay-only edits do not.
+        const structural = args.ops.some(op => STRUCTURAL_OPS.has(op.op));
+        for (const [index, op] of args.ops.entries()) {
+            try {
+                const result = await applyOp(editor, op, pageMap, config);
+                applied.push(result.description);
+            }
+            catch (cause) {
+                if (cause instanceof Error && cause.name === "McpToolError") {
+                    throw cause;
+                }
+                throw toolError.invalidInput(`op ${index + 1} (${op.op}) failed: ${cause instanceof Error ? cause.message : String(cause)}`, "Nothing was written.", { cause });
+            }
+        }
+        if (args.dryRun === true) {
+            return textResult(config, [
+                `**Dry run** — nothing was written to ${args.path}.`,
+                `- pages: ${pageCount} → ${pageMap.length}`,
+                "",
+                "Would apply:",
+                ...applied.map((line, index) => `${index + 1}. ${line}`),
+                "",
+                "Re-run without dryRun to write these changes."
+            ].join("\n"));
+        }
+        // `out` may name the very file being edited (`a.pdf` vs `./a.pdf`), so the
+        // decision is made on the resolved paths, not on whether `out` was given.
+        await assertUnchanged(resolved, inputVersion);
+        const writeTarget = await resolveEditTarget(config, args.path, args.out);
+        const target = writeTarget.path;
+        const inPlace = isSameFile(target, resolved);
+        const backupPath = inPlace && (args.backup ?? true) ? await backupOnce(writeTarget) : undefined;
+        // Overlay-only: prefer the incremental path so bookmarks, form fields and
+        // signatures survive. `saveIncremental` itself falls back to a rebuild for
+        // xref-stream files, so the report is based on what was actually possible.
+        const incrementalPossible = !structural && supportsIncrementalUpdate(bytes);
+        const out = incrementalPossible ? await editor.saveIncremental() : await editor.save();
+        if (inPlace) {
+            await writeFileAtomic(target, out);
+        }
+        else {
+            await writeBytesWithPolicy(target, args.overwrite === true, out);
+        }
+        // Re-read so the reported page count is the file's, not the editor's idea.
+        const verified = await Pdf.read(new Uint8Array(out), {
+            extractText: false,
+            extractImages: false
+        });
+        return textResult(config, [
+            `Edited **${args.path}** — ${applied.length} operation(s) applied.`,
+            `- written to ${writeTarget.display}${inPlace ? " (in place)" : ""} (${formatBytes(out.byteLength)})`,
+            `- pages: ${pageCount} → ${verified.metadata?.pageCount ?? pageMap.length}`,
+            incrementalPossible
+                ? "- saved as an incremental update: bookmarks, form fields and original signature bytes are preserved; a certified signature may still report the document as modified if its DocMDP permissions forbid this edit"
+                : structural
+                    ? "- **structural change, so the file was rebuilt**: any signature is now invalid, and document-level extras such as bookmarks may not survive"
+                    : "- rebuilt rather than appended (this PDF uses a cross-reference stream), so any signature is now invalid",
+            ...describeBackup(writeTarget.display, backupPath),
+            "",
+            ...applied.map((line, index) => `${index + 1}. ${line}`),
+            "",
+            "Read it back with doc_read to verify any text you added."
+        ].join("\n"));
+    }
+});
+async function applyOp(editor, op, pageMap, config) {
+    const pageCount = pageMap.length;
+    switch (op.op) {
+        case "watermark": {
+            const pages = resolvePages(op.pages, pageCount);
+            for (const page of pages) {
+                editor.getPage(requireOriginalPage(pageMap, page)).drawText(op.text, {
+                    x: 120,
+                    y: 360,
+                    fontSize: op.fontSize ?? 48,
+                    rotation: op.rotation ?? 45,
+                    // Transparency is the colour's alpha channel; drawText has no
+                    // separate opacity option.
+                    color: toColor(op.color ?? "FF0000", op.opacity ?? 0.25)
+                });
+            }
+            return {
+                description: `watermarked ${pages.length} page(s) with ${JSON.stringify(op.text)}`
+            };
+        }
+        case "page_numbers": {
+            const template = op.format ?? "Page {page} of {total}";
+            const startAt = op.startAt ?? 1;
+            const fontSize = op.fontSize ?? 9;
+            const position = op.position ?? "bottom-center";
+            for (let index = 0; index < pageCount; index += 1) {
+                const label = template
+                    .replace(/\{page\}/g, String(index + startAt))
+                    .replace(/\{total\}/g, String(pageCount + startAt - 1));
+                editor.getPage(requireOriginalPage(pageMap, index + 1)).drawText(label, {
+                    x: position === "bottom-left" ? 60 : position === "bottom-center" ? 260 : 460,
+                    y: 28,
+                    fontSize
+                });
+            }
+            return {
+                description: `numbered ${pageCount} page(s) as ${JSON.stringify(template)}`
+            };
+        }
+        case "stamp": {
+            const pages = resolvePages(op.pages, pageCount);
+            for (const page of pages) {
+                editor.getPage(requireOriginalPage(pageMap, page)).drawText(op.text, {
+                    x: op.x,
+                    y: op.y,
+                    fontSize: op.fontSize ?? 12,
+                    color: toColor(op.color ?? "000000")
+                });
+            }
+            return { description: `stamped ${pages.length} page(s) at (${op.x}, ${op.y})` };
+        }
+        case "delete_pages": {
+            const pages = resolvePages(op.pages, pageCount);
+            if (pages.length >= pageCount) {
+                throw toolError.invalidInput("that would delete every page", "A PDF must keep at least one page.");
+            }
+            // Descending, so each removal cannot shift the index of the next.
+            for (const page of [...pages].sort((a, b) => b - a)) {
+                const [original] = pageMap.splice(page - 1, 1);
+                if (original === undefined || original < 0) {
+                    throw toolError.invalidInput("an appended page cannot be removed in the same call");
+                }
+                editor.removePage(original);
+            }
+            return {
+                description: `deleted page(s) ${pages.join(", ")}`
+            };
+        }
+        case "keep_pages": {
+            const keep = new Set(resolvePages(op.pages, pageCount));
+            if (keep.size === 0) {
+                throw toolError.invalidInput("keep_pages must keep at least one page");
+            }
+            const remove = [];
+            for (let page = 1; page <= pageCount; page += 1) {
+                if (!keep.has(page)) {
+                    remove.push(page);
+                }
+            }
+            for (const page of remove.toSorted((a, b) => b - a)) {
+                const [original] = pageMap.splice(page - 1, 1);
+                if (original === undefined || original < 0) {
+                    throw toolError.invalidInput("an appended page cannot be removed in the same call");
+                }
+                editor.removePage(original);
+            }
+            return {
+                description: `kept page(s) ${[...keep].toSorted((a, b) => a - b).join(", ")}, removed ${remove.length}`
+            };
+        }
+        case "rotate": {
+            const pages = resolvePages(op.pages, pageCount);
+            for (const page of pages) {
+                editor.rotatePage(requireOriginalPage(pageMap, page), op.degrees);
+            }
+            return { description: `set ${pages.length} page(s) to ${op.degrees}° rotation` };
+        }
+        case "append": {
+            const source = await resolveInRoot(config, op.path, { mustExist: true });
+            const sourceBytes = new Uint8Array(await readFile(source));
+            const sourceInfo = await Pdf.read(sourceBytes, {
+                extractText: false,
+                extractImages: false
+            }).catch((cause) => {
+                throw toolError.unsupported(`could not read ${op.path} as a PDF`, undefined, { cause });
+            });
+            const sourcePageCount = sourceInfo.metadata?.pageCount ?? 0;
+            const wanted = op.pages === undefined ? undefined : resolvePages(op.pages, sourcePageCount);
+            editor.copyPagesFrom(sourceBytes, wanted === undefined ? undefined : wanted.map(page => page - 1));
+            const added = wanted === undefined ? sourcePageCount : wanted.length;
+            // Copied pages are not addressable through getPage/removePage until the
+            // rebuilt document is loaded again. Keep sentinels so a later operation
+            // gets an honest error instead of silently touching an original page.
+            pageMap.push(...Array.from({ length: added }, () => -1));
+            return {
+                description: `appended ${added} page(s) from ${op.path}`
+            };
+        }
+    }
+}
+/** Original editor index corresponding to a current 1-based page number. */
+function requireOriginalPage(pageMap, page) {
+    const original = pageMap[page - 1];
+    if (original === undefined) {
+        throw toolError.invalidInput(`page ${page} does not exist`);
+    }
+    if (original < 0) {
+        throw toolError.invalidInput(`page ${page} was appended earlier in this call and cannot be edited until the PDF is saved and reopened`, "Put append last, or make a second pdf_edit call for the appended pages.");
+    }
+    return original;
+}
+/** Resolve a page selector against the live page count, or every page. */
+function resolvePages(selector, pageCount) {
+    const parsed = parsePages(selector);
+    if (parsed === undefined) {
+        return Array.from({ length: pageCount }, (_, index) => index + 1);
+    }
+    const outOfRange = parsed.filter(page => page > pageCount);
+    if (outOfRange.length > 0) {
+        throw toolError.invalidInput(`page(s) ${outOfRange.join(", ")} do not exist — the document has ${pageCount}`, "Check the page count with doc_read or doc_inspect first.");
+    }
+    return [...new Set(parsed)].toSorted((a, b) => a - b);
+}
+/**
+ * Convert `RRGGBB` to the engine's normalised colour.
+ *
+ * `PdfColor` components run 0–1, not 0–255, and its `a` channel is how
+ * transparency is expressed — passing a hex string type-checks nowhere and
+ * would be silently ignored.
+ */
+function toColor(color, alpha) {
+    const hex = color.replace(/^#/, "").toUpperCase();
+    if (!/^[0-9A-F]{6}$/.test(hex)) {
+        throw toolError.invalidInput(`${JSON.stringify(color)} is not a hex colour`, 'Use RRGGBB, e.g. "FF0000".');
+    }
+    const channel = (offset) => Number.parseInt(hex.slice(offset, offset + 2), 16) / 255;
+    return {
+        r: channel(0),
+        g: channel(2),
+        b: channel(4),
+        ...(alpha === undefined ? {} : { a: alpha })
+    };
+}
+//# sourceMappingURL=pdf-edit.js.map

package/dist/tools/pdf-edit.js.map

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

package/dist/tools/result.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tool result helpers.
+ *
+ * Every tool returns text, not binary — a model cannot see an image and this
+ * toolkit has no PDF rasterizer, so a structured textual description is the
+ * only channel that exists. These helpers keep truncation honest: a silently
+ * cut-off table is worse than no table, because the model will reason over it
+ * as if it were complete.
+ */
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { ServerConfig } from "../config.js";
+/** A successful text result, truncated to the configured output budget. */
+export declare function textResult(config: ServerConfig, text: string): CallToolResult;
+/** An error result. The model reads this and decides whether to retry. */
+export declare function errorResult(text: string): CallToolResult;
+/**
+ * Cut `text` to the output budget, appending an explicit marker.
+ *
+ * The marker matters: it tells the model the data is incomplete so it asks for
+ * a narrower range instead of drawing conclusions from a partial document.
+ */
+export declare function truncate(config: ServerConfig, text: string): string;
+/** Render a byte count for humans, e.g. `1.4 MiB`. */
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=result.d.ts.map

package/dist/tools/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAE7E;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUjD"}

package/dist/tools/result.js

@@ -0,0 +1,43 @@
+/**
+ * Tool result helpers.
+ *
+ * Every tool returns text, not binary — a model cannot see an image and this
+ * toolkit has no PDF rasterizer, so a structured textual description is the
+ * only channel that exists. These helpers keep truncation honest: a silently
+ * cut-off table is worse than no table, because the model will reason over it
+ * as if it were complete.
+ */
+/** A successful text result, truncated to the configured output budget. */
+export function textResult(config, text) {
+    return { content: [{ type: "text", text: truncate(config, text) }] };
+}
+/** An error result. The model reads this and decides whether to retry. */
+export function errorResult(text) {
+    return { isError: true, content: [{ type: "text", text }] };
+}
+/**
+ * Cut `text` to the output budget, appending an explicit marker.
+ *
+ * The marker matters: it tells the model the data is incomplete so it asks for
+ * a narrower range instead of drawing conclusions from a partial document.
+ */
+export function truncate(config, text) {
+    if (text.length <= config.maxOutputChars) {
+        return text;
+    }
+    const omitted = text.length - config.maxOutputChars;
+    return `${text.slice(0, config.maxOutputChars)}\n\n[truncated: ${omitted} more characters. Request a narrower range or use pagination to see the rest.]`;
+}
+/** Render a byte count for humans, e.g. `1.4 MiB`. */
+export function formatBytes(bytes) {
+    const units = ["B", "KiB", "MiB", "GiB"];
+    let value = bytes;
+    let unitIndex = 0;
+    while (value >= 1024 && unitIndex < units.length - 1) {
+        value /= 1024;
+        unitIndex += 1;
+    }
+    const unit = units[unitIndex] ?? "B";
+    return unitIndex === 0 ? `${bytes} ${unit}` : `${value.toFixed(1)} ${unit}`;
+}
+//# sourceMappingURL=result.js.map

package/dist/tools/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CAAC,MAAoB,EAAE,IAAY;IAC3D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAoB,EAAE,IAAY;IACzD,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC;IACpD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,mBAAmB,OAAO,gFAAgF,CAAC;AAC3J,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;IAClD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,OAAO,KAAK,IAAI,IAAI,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,KAAK,IAAI,IAAI,CAAC;QACd,SAAS,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC;IACrC,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AAC9E,CAAC"}

package/dist/tools/sheet-edit.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `sheet_edit` — patch an existing workbook in place.
+ *
+ * The counterpart to `sheet_write`: that one builds a file, this one changes a
+ * file someone already has. The distinction matters because the risky operation
+ * is the second — a user's real spreadsheet, whose other sheets, formatting and
+ * formulas must survive untouched.
+ *
+ * Two safeguards follow from that. Operations are applied to an in-memory copy
+ * and only written once every one of them has succeeded, so a bad op cannot
+ * leave a half-edited file. And `dryRun` reports what *would* change without
+ * writing, because a model's decision to edit is far likelier to be wrong than
+ * its ability to execute the edit.
+ */
+export declare const sheetEditTool: import("./types.js").AnyToolDefinition;
+//# sourceMappingURL=sheet-edit.d.ts.map

package/dist/tools/sheet-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-edit.d.ts","sourceRoot":"","sources":["../../src/tools/sheet-edit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmGH,eAAO,MAAM,aAAa,wCA2IxB,CAAC"}