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

package/dist/tools/doc-review.js.map

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

package/dist/tools/doc-search.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `doc_search` and `doc_edit` — find and change text in a Word document.
+ *
+ * `doc_search` covers two questions that look similar and are not:
+ *
+ *   "where does this phrase appear"   — text search
+ *   "which text is red and bold"      — format search
+ *
+ * The second is the interesting one. A model cannot answer it from a Markdown
+ * rendering, because colour and highlight do not survive into Markdown at all,
+ * and it is a routine document-review request ("find everything marked urgent").
+ *
+ * `doc_edit` replaces text across run boundaries. Word habitually splits a
+ * phrase across several `w:r` elements, so a naive replacement misses matches or
+ * destroys formatting; the underlying engine rebuilds the runs and preserves
+ * each surviving run's properties.
+ */
+export declare const docSearchTool: import("./types.js").AnyToolDefinition;
+export declare const docEditTool: import("./types.js").AnyToolDefinition;
+//# sourceMappingURL=doc-search.d.ts.map

package/dist/tools/doc-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-search.d.ts","sourceRoot":"","sources":["../../src/tools/doc-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAqCH,eAAO,MAAM,aAAa,wCAwExB,CAAC;AA2EH,eAAO,MAAM,WAAW,wCA6GtB,CAAC"}

package/dist/tools/doc-search.js

@@ -0,0 +1,268 @@
+/**
+ * `doc_search` and `doc_edit` — find and change text in a Word document.
+ *
+ * `doc_search` covers two questions that look similar and are not:
+ *
+ *   "where does this phrase appear"   — text search
+ *   "which text is red and bold"      — format search
+ *
+ * The second is the interesting one. A model cannot answer it from a Markdown
+ * rendering, because colour and highlight do not survive into Markdown at all,
+ * and it is a routine document-review request ("find everything marked urgent").
+ *
+ * `doc_edit` replaces text across run boundaries. Word habitually splits a
+ * phrase across several `w:r` elements, so a naive replacement misses matches or
+ * destroys formatting; the underlying engine rebuilds the runs and preserves
+ * each surviving run's properties.
+ */
+import { Io, Query } from "documonster/word";
+import { z } from "zod";
+import { toolError } from "../errors.js";
+import { assertWritable, resolveEditTarget, resolveInRoot } from "../sandbox.js";
+import { assertReadableSize, assertUnchanged, backupOnce, describeBackup, fingerprint, isSameFile, replaceAtomically, writeWithPolicy } from "./fs-helpers.js";
+import { textResult } from "./result.js";
+import { defineTool } from "./types.js";
+/** Matches reported in one call. */
+const MAX_MATCHES = 100;
+const formatCriteria = {
+    bold: z.boolean().optional(),
+    italic: z.boolean().optional(),
+    underline: z.boolean().optional(),
+    strike: z.boolean().optional(),
+    font: z.string().optional().describe('Font name, e.g. "Calibri".'),
+    color: z
+        .string()
+        .optional()
+        .describe('Text colour as hex RGB without "#", e.g. "C00000" for red.'),
+    highlight: z.string().optional().describe('Highlight colour name, e.g. "yellow".'),
+    paragraphStyle: z.string().optional().describe('Paragraph style id, e.g. "Heading1" or "Quote".')
+};
+export const docSearchTool = defineTool({
+    name: "doc_search",
+    group: "word",
+    title: "Search a Word document",
+    description: "Search a .docx by text or by formatting. Formatting search answers questions that reading the document cannot — 'which text is red', 'what is highlighted', 'everything styled as Heading2' — because colour and highlighting do not survive into text. Give `text` for a phrase search, `format` for an appearance search, or both to narrow.",
+    inputSchema: {
+        path: z.string().min(1).describe("Document path (.docx), relative to the server root."),
+        text: z
+            .string()
+            .optional()
+            .describe("Phrase to find. Combine with `regex` to treat it as a pattern."),
+        regex: z
+            .boolean()
+            .optional()
+            .describe("Treat `text` as a JavaScript regular expression. Defaults to false."),
+        format: z
+            .object(formatCriteria)
+            .optional()
+            .describe("Appearance to match. Any combination; all given properties must hold."),
+        listFormats: z
+            .boolean()
+            .optional()
+            .describe("Instead of searching, list every distinct run format used in the document — useful when you do not yet know what to look for.")
+    },
+    annotations: { readOnlyHint: true, openWorldHint: false },
+    mutates: false,
+    handler: async (args, context) => {
+        const { config } = context;
+        const resolved = await resolveInRoot(config, args.path, { mustExist: true });
+        await assertReadableSize(config, resolved, args.path);
+        const doc = await readWord(resolved, args.path);
+        if (args.listFormats === true) {
+            const formats = Query.getUsedFormats(doc);
+            if (formats.length === 0) {
+                return textResult(config, `# ${args.path}\n\nNo run carries direct formatting — every run inherits from its paragraph style.\n\nSearch by \`format: { paragraphStyle: "…" }\` instead, or read the document with doc_read.`);
+            }
+            return textResult(config, [
+                `# ${args.path} — formats in use`,
+                "",
+                `${formats.length} distinct run format(s):`,
+                "",
+                ...formats.map(format => `- \`${JSON.stringify(format)}\``),
+                "",
+                "Search for one with `format: { … }`."
+            ].join("\n"));
+        }
+        if (args.text === undefined && args.format === undefined) {
+            throw toolError.invalidInput("doc_search needs `text`, `format`, or listFormats: true", 'To find a phrase pass text; to find an appearance pass format, e.g. { "color": "C00000" }.');
+        }
+        // Format search first when given, because it is the narrower axis and can
+        // additionally filter on text via textMatch.
+        if (args.format !== undefined) {
+            return textResult(config, searchByFormat(doc, args));
+        }
+        return textResult(config, searchByText(doc, args));
+    }
+});
+function searchByText(doc, args) {
+    const query = buildQuery(args);
+    const results = Query.searchText(doc, query);
+    if (results.length === 0) {
+        return [
+            `# ${args.path} — no match`,
+            "",
+            `Nothing matched ${describeQuery(args)}.`,
+            "",
+            "The search covers the body, tables, headers, footers and footnotes. If you expected a match, check spelling and case — text search is case-sensitive."
+        ].join("\n");
+    }
+    return [
+        `# ${args.path} — ${results.length} match(es) for ${describeQuery(args)}`,
+        "",
+        "| # | paragraph | offset | match |",
+        "| --- | --- | --- | --- |",
+        ...results
+            .slice(0, MAX_MATCHES)
+            .map((result, index) => `| ${index + 1} | ${result.paragraphIndex} | ${result.offset} | ${escapeCell(result.match)} |`),
+        ...(results.length > MAX_MATCHES
+            ? ["", `[${results.length - MAX_MATCHES} more not listed]`]
+            : []),
+        "",
+        "`paragraph` is a document-wide ordinal in reading order, not an index into the body — use it for ordering, not addressing.",
+        "",
+        "Replace these with doc_edit."
+    ].join("\n");
+}
+function searchByFormat(doc, args) {
+    const criteria = {
+        ...args.format,
+        ...(args.text === undefined ? {} : { textMatch: buildRegex(args) })
+    };
+    const results = Query.searchByFormat(doc, criteria);
+    const described = JSON.stringify(args.format);
+    if (results.length === 0) {
+        return [
+            `# ${args.path} — no match`,
+            "",
+            `No text matched the formatting ${described}.`,
+            "",
+            "Call again with `listFormats: true` to see which formats the document actually uses — a colour may differ from the one you assumed, and text styled by a paragraph style carries no direct run formatting."
+        ].join("\n");
+    }
+    return [
+        `# ${args.path} — ${results.length} run(s) matching ${described}`,
+        "",
+        "| # | location | paragraph | style | text |",
+        "| --- | --- | --- | --- | --- |",
+        ...results
+            .slice(0, MAX_MATCHES)
+            .map((result, index) => `| ${index + 1} | ${result.location} | ${result.paragraphIndex} | ${result.paragraphStyle ?? "—"} | ${escapeCell(result.text)} |`),
+        ...(results.length > MAX_MATCHES
+            ? ["", `[${results.length - MAX_MATCHES} more not listed]`]
+            : []),
+        "",
+        "Matches are individual runs, so one visually continuous phrase may appear as several rows."
+    ].join("\n");
+}
+export const docEditTool = defineTool({
+    name: "doc_edit",
+    group: "word",
+    title: "Replace text in a Word document",
+    description: "Find and replace text throughout a .docx, preserving all formatting. Handles matches that Word has split across several runs, which a naive replacement would miss. Use dryRun first to see how many matches there are. Everything else in the document is untouched.",
+    inputSchema: {
+        path: z.string().min(1).describe("Document to edit (.docx), relative to the server root."),
+        find: z.string().min(1).describe("Text to replace."),
+        replace: z
+            .string()
+            .describe("Replacement text. With regex: true, $1 refers to the first capture group."),
+        regex: z
+            .boolean()
+            .optional()
+            .describe("Treat `find` as a JavaScript regular expression, applied globally. Defaults to false."),
+        out: z
+            .string()
+            .optional()
+            .describe("Write below @output/. Required for input files unless --allow-in-place is enabled."),
+        dryRun: z
+            .boolean()
+            .optional()
+            .describe("Report the match count without writing anything. Do this first on a document the user cares about."),
+        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 doc = await readWord(resolved, args.path);
+        const query = buildQuery(args);
+        // Count first, so dryRun and the real run report the same number and a
+        // zero-match edit can be reported as a no-op instead of silently rewriting
+        // the file.
+        const found = Query.searchText(doc, query).length;
+        if (found === 0) {
+            return textResult(config, [
+                `No occurrence of ${describeQuery(args)} in **${args.path}** — nothing was written.`,
+                "",
+                "Text search is case-sensitive. Use doc_search to confirm what the document actually contains."
+            ].join("\n"));
+        }
+        if (args.dryRun === true) {
+            return textResult(config, [
+                `**Dry run** — nothing was written.`,
+                `- ${found} occurrence(s) of ${describeQuery(args)} in ${args.path}`,
+                `- would be replaced with ${JSON.stringify(args.replace)}`,
+                "",
+                "Re-run without dryRun to apply."
+            ].join("\n"));
+        }
+        const replaced = Query.replaceText(doc, query, args.replace);
+        await assertUnchanged(resolved, inputVersion);
+        const writeTarget = await resolveEditTarget(config, args.path, args.out);
+        const inPlace = isSameFile(writeTarget.path, resolved);
+        const backupPath = inPlace && (args.backup ?? true) ? await backupOnce(writeTarget) : undefined;
+        if (inPlace) {
+            await replaceAtomically(writeTarget.path, temporary => Io.writeFile(doc, temporary));
+        }
+        else {
+            await writeWithPolicy(writeTarget.path, args.overwrite === true, temporary => Io.writeFile(doc, temporary));
+        }
+        return textResult(config, [
+            `Replaced **${replaced}** occurrence(s) of ${describeQuery(args)} with ${JSON.stringify(args.replace)}.`,
+            `- written to ${writeTarget.display}${inPlace ? " (in place)" : ""}`,
+            ...describeBackup(writeTarget.display, backupPath),
+            "- all other formatting preserved",
+            "",
+            "Read it back with doc_read to verify before reporting success to the user."
+        ].join("\n"));
+    }
+});
+/** A string query, or a global regex when `regex` is set. */
+function buildQuery(args) {
+    const source = args.find ?? args.text ?? "";
+    return args.regex === true ? buildRegex({ text: source, regex: true }) : source;
+}
+function buildRegex(args) {
+    const source = args.text ?? "";
+    try {
+        return new RegExp(source, "g");
+    }
+    catch (cause) {
+        throw toolError.invalidInput(`${JSON.stringify(source)} is not a valid regular expression`, "Escape any special characters, or drop regex: true for a literal search.", { cause });
+    }
+}
+function describeQuery(args) {
+    const source = args.find ?? args.text ?? "";
+    return args.regex === true ? `pattern \`/${source}/g\`` : JSON.stringify(source);
+}
+function escapeCell(text) {
+    return text.replace(/\|/g, "\\|").replace(/\r?\n/g, " ").slice(0, 200);
+}
+async function readWord(resolved, displayPath) {
+    return await Io.readFile(resolved).catch((cause) => {
+        throw toolError.unsupported(`could not read ${displayPath} as a Word document`, "Run doc_inspect to check the real file type; a CFB container is either a legacy .doc or an encrypted .docx.", { cause });
+    });
+}
+//# sourceMappingURL=doc-search.js.map

package/dist/tools/doc-search.js.map

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

package/dist/tools/doc-write.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `doc_write` — create a Word or PDF document from Markdown.
+ *
+ * Markdown as the input language is a deliberate choice: a model already writes
+ * it fluently and correctly, whereas a JSON description of runs and paragraph
+ * properties is something it has to be taught, gets wrong, and which would cost
+ * a large schema in every request. Headings, lists, tables, emphasis, code
+ * blocks and links all survive the conversion.
+ */
+export declare const docWriteTool: import("./types.js").AnyToolDefinition;
+//# sourceMappingURL=doc-write.d.ts.map

package/dist/tools/doc-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-write.d.ts","sourceRoot":"","sources":["../../src/tools/doc-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,eAAO,MAAM,YAAY,wCAiFvB,CAAC"}

package/dist/tools/doc-write.js

@@ -0,0 +1,81 @@
+/**
+ * `doc_write` — create a Word or PDF document from Markdown.
+ *
+ * Markdown as the input language is a deliberate choice: a model already writes
+ * it fluently and correctly, whereas a JSON description of runs and paragraph
+ * properties is something it has to be taught, gets wrong, and which would cost
+ * a large schema in every request. Headings, lists, tables, emphasis, code
+ * blocks and links all survive the conversion.
+ */
+import { stat, writeFile } from "node:fs/promises";
+import { Pdf } from "documonster/pdf";
+import { Io } from "documonster/word";
+import { markdownToDocx } from "documonster/word/markdown";
+import { z } from "zod";
+import { toolError } from "../errors.js";
+import { assertWritable, outputDisplay, resolveOutputPath } from "../sandbox.js";
+import { assertNonMacroOutput, requireFormat } from "./document.js";
+import { writeWithPolicy } from "./fs-helpers.js";
+import { formatBytes, textResult } from "./result.js";
+import { defineTool } from "./types.js";
+export const docWriteTool = defineTool({
+    name: "doc_write",
+    group: "word",
+    title: "Write a Word or PDF document",
+    description: "Create a .docx or .pdf from Markdown. Headings, lists, tables, bold/italic, code blocks and links are all converted. Write the content as Markdown — that is the input language for this tool.",
+    inputSchema: {
+        path: z
+            .string()
+            .min(1)
+            .describe("Output path below --output-root. The extension chooses .docx or .pdf; the result is returned as @output/<path>."),
+        markdown: z
+            .string()
+            .min(1)
+            .describe("Document content as Markdown. Use # for headings, - for lists, | for tables."),
+        overwrite: z
+            .boolean()
+            .optional()
+            .describe("Replace the file if it exists. Defaults to false so existing work is never lost silently.")
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false
+    },
+    mutates: true,
+    handler: async (args, context) => {
+        const { config } = context;
+        assertWritable(config);
+        const format = requireFormat(args.path, "path");
+        assertNonMacroOutput(args.path);
+        if (format !== "docx" && format !== "pdf") {
+            throw toolError.invalidInput(`doc_write cannot produce a ${format} file`, "Use .docx or .pdf. For spreadsheets use sheet_write; to change an existing document's format use doc_convert.");
+        }
+        const target = await resolveOutputPath(config, args.path);
+        // markdownToDocx is async — verified; treating it as synchronous yields an
+        // empty object that fails much later inside the packager.
+        const doc = await markdownToDocx(args.markdown).catch((cause) => {
+            throw toolError.invalidInput(`the Markdown could not be converted: ${cause instanceof Error ? cause.message : String(cause)}`, "Check for an unclosed code fence or a malformed table.", { cause });
+        });
+        let size;
+        if (format === "docx") {
+            await writeWithPolicy(target, args.overwrite === true, temporary => Io.writeFile(doc, temporary));
+            size = (await stat(target)).size;
+        }
+        else {
+            const bytes = await Pdf.fromDocx(doc);
+            await writeWithPolicy(target, args.overwrite === true, temporary => writeFile(temporary, bytes));
+            size = bytes.byteLength;
+        }
+        return textResult(config, [
+            `Wrote **${outputDisplay(args.path)}** (${format}, ${formatBytes(size)}).`,
+            format === "pdf"
+                ? "- rendered through the Word layout engine, so pagination and line breaking are real"
+                : "- Markdown structure preserved as Word styles",
+            "",
+            "Read the returned @output path with doc_read to verify before reporting success."
+        ].join("\n"));
+    }
+});
+//# sourceMappingURL=doc-write.js.map

package/dist/tools/doc-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-write.js","sourceRoot":"","sources":["../../src/tools/doc-write.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;IACrC,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,8BAA8B;IACrC,WAAW,EACT,gMAAgM;IAClM,WAAW,EAAE;QACX,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,iHAAiH,CAClH;QACH,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,8EAA8E,CAAC;QAC3F,SAAS,EAAE,CAAC;aACT,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CACP,2FAA2F,CAC5F;KACJ;IACD,WAAW,EAAE;QACX,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,KAAK;QACrB,aAAa,EAAE,KAAK;KACrB;IACD,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAC3B,cAAc,CAAC,MAAM,CAAC,CAAC;QAEvB,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC1C,MAAM,SAAS,CAAC,YAAY,CAC1B,8BAA8B,MAAM,OAAO,EAC3C,+GAA+G,CAChH,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,2EAA2E;QAC3E,0DAA0D;QAC1D,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACvE,MAAM,SAAS,CAAC,YAAY,CAC1B,wCAAwC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAChG,wDAAwD,EACxD,EAAE,KAAK,EAAE,CACV,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,IAAY,CAAC;QACjB,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,MAAM,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,SAAS,CAAC,EAAE,CACjE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAC7B,CAAC;YACF,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,SAAS,CAAC,EAAE,CACjE,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAC5B,CAAC;YACF,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;QAC1B,CAAC;QAED,OAAO,UAAU,CACf,MAAM,EACN;YACE,WAAW,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,IAAI,CAAC,IAAI;YAC1E,MAAM,KAAK,KAAK;gBACd,CAAC,CAAC,qFAAqF;gBACvF,CAAC,CAAC,+CAA+C;YACnD,EAAE;YACF,kFAAkF;SACnF,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/document.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Shared document helpers for the Word / PDF tools.
+ *
+ * Concentrates three things the document tools must not each re-derive: which
+ * format a path denotes, the awkward corners of the underlying API that were
+ * verified empirically, and paginating long text so a tool result never blows
+ * the caller's context.
+ */
+/**
+ * Document formats the tools can name.
+ *
+ * Kept separate from `doc_inspect`'s content sniffing: that answers "what is
+ * this file really", while this answers "what has the caller asked for", which
+ * for a write target is a question about the extension alone.
+ */
+export type DocFormat = "docx" | "pdf" | "md" | "html" | "txt" | "xlsx" | "csv" | "odt";
+/**
+ * Format implied by a path, or a tool error naming what is supported.
+ *
+ * Listing the accepted extensions in the error matters: a model that guessed
+ * `.doc` can correct itself in one step instead of retrying variations.
+ */
+export declare function requireFormat(filePath: string, field: string): DocFormat;
+/**
+ * Reject macro-enabled extensions for newly generated output.
+ *
+ * The writer produces ordinary DOCX/XLSX content. Naming that package `.docm`
+ * or `.xlsm` does not make it macro-enabled; worse, rewriting an existing macro
+ * file through a path that cannot prove VBA preservation risks silent macro
+ * loss. Read operations may still inspect such files.
+ */
+export declare function assertNonMacroOutput(filePath: string): void;
+/** A slice of a long text, with enough metadata for the caller to continue. */
+export interface TextWindow {
+    readonly text: string;
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly totalLines: number;
+    readonly truncated: boolean;
+}
+/**
+ * Take a line-bounded window of text.
+ *
+ * Line-based rather than character-based so the cursor a caller passes back is
+ * stable and meaningful: "continue from line 240" survives, whereas a character
+ * offset into re-extracted text does not.
+ */
+export declare function takeLines(text: string, startLine: number, maxLines: number): TextWindow;
+/**
+ * Render the standard "here is what I left out" footer.
+ *
+ * Always emitted when content was cut, because a model given a silent partial
+ * read will reason over it as though it were complete.
+ */
+export declare function continuationNote(window: TextWindow, cursorField?: string): string[];
+/**
+ * Normalize a page selection into 1-based page numbers.
+ *
+ * Accepts `[1,2,5]` or `"1-3,7"`, because a model reaches for both.
+ */
+export declare function parsePages(pages: readonly number[] | string | undefined): number[] | undefined;
+/**
+ * Whether a PDF can receive a genuine incremental update.
+ *
+ * `PdfEditor.saveIncremental()` silently falls back to a full rebuild for
+ * xref-stream files (PDF 1.5+ without a `trailer` keyword). A full rebuild
+ * renumbers objects and invalidates any existing signature, so a tool must not
+ * claim "signature preserved" without checking — and callers deserve to know
+ * when structure may be reorganised.
+ */
+export declare function supportsIncrementalUpdate(bytes: Uint8Array): boolean;
+/** Cap on how many pages a selector may name, before it is expanded. */
+export declare const MAX_SELECTABLE_PAGES = 10000;
+//# sourceMappingURL=document.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/tools/document.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAsBxF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CASxE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQ3D;AAED,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAYvF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,SAAc,GAAG,MAAM,EAAE,CAOxF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAoD9F;AASD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAGpE;AAED,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,QAAS,CAAC"}