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

package/dist/tools/inspect.js

@@ -0,0 +1,463 @@
+/**
+ * `doc_inspect` — the cheap first call.
+ *
+ * Every other tool is expensive in context: reading a sheet or a document body
+ * spends thousands of tokens. This one spends a few dozen and answers the
+ * questions that stop the model guessing — what kind of file is this, how big,
+ * and for CSV, which delimiter and line ending is it actually using.
+ *
+ * The CSV dialect fields are why this tool imports from the core package: a
+ * model has no way to know that a "csv" is semicolon-separated with a BOM,
+ * and getting it wrong silently produces a one-column table.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { ArchiveFile } from "documonster/archive";
+import { Csv } from "documonster/csv";
+import { Workbook } from "documonster/excel";
+import { Pdf } from "documonster/pdf";
+import { Io, Layout, Query, Template } from "documonster/word";
+import { z } from "zod";
+import { toolError } from "../errors.js";
+import { resolveInRoot } from "../sandbox.js";
+import { formatBytes, textResult } from "./result.js";
+import { describeWindow, sheetName, usedWindow } from "./spreadsheet.js";
+import { defineTool } from "./types.js";
+/** Bytes read from the head of a text file for dialect detection. */
+const HEAD_SAMPLE_BYTES = 64 * 1024;
+/** Maximum directory entries listed in one call. */
+const MAX_DIR_ENTRIES = 200;
+export const inspectTool = defineTool({
+    name: "doc_inspect",
+    group: "core",
+    title: "Inspect a document or directory",
+    description: "Identify a file (type, size, and for CSV its delimiter/line-ending/BOM) or list a directory. Always call this before reading a document: it is cheap and prevents guessing the wrong format, sheet or column.",
+    inputSchema: {
+        path: z
+            .string()
+            .min(1)
+            .describe("File or directory path, relative to the server root. Use '.' for the root itself.")
+    },
+    annotations: { readOnlyHint: true, openWorldHint: false },
+    mutates: false,
+    handler: async (args, context) => {
+        const { config } = context;
+        const resolved = await resolveInRoot(config, args.path, { mustExist: true });
+        const stats = await fs.stat(resolved);
+        const displayPath = toDisplayPath(config.root, resolved);
+        if (stats.isDirectory()) {
+            return textResult(config, await describeDirectory(resolved, displayPath));
+        }
+        if (!stats.isFile()) {
+            throw toolError.unsupported(`not a regular file or directory: ${args.path}`, "Only files and directories can be inspected.");
+        }
+        return textResult(config, await describeFile(config, resolved, displayPath, stats.size, stats.mtime));
+    }
+});
+async function describeDirectory(resolved, displayPath) {
+    const entries = await fs.readdir(resolved, { withFileTypes: true });
+    const sorted = entries.toSorted((a, b) => a.name.localeCompare(b.name));
+    const shown = sorted.slice(0, MAX_DIR_ENTRIES);
+    // stat every shown entry so the model can judge what is worth reading, in
+    // parallel — serial awaits would cost up to MAX_DIR_ENTRIES round trips. A
+    // failure on one entry (broken symlink, concurrent delete) must not fail the
+    // whole listing, so each result is settled independently.
+    const sizes = await Promise.all(shown.map(async (entry) => {
+        if (entry.isDirectory()) {
+            return undefined;
+        }
+        try {
+            const stats = await fs.stat(path.join(resolved, entry.name));
+            return formatBytes(stats.size);
+        }
+        catch {
+            return "(unreadable)";
+        }
+    }));
+    const lines = [`# Directory: ${displayPath}`, "", `${entries.length} entries`, ""];
+    for (const [index, entry] of shown.entries()) {
+        if (entry.isDirectory()) {
+            lines.push(`- \`${entry.name}/\``);
+            continue;
+        }
+        const size = sizes[index];
+        lines.push(`- \`${entry.name}\`${size === undefined ? "" : ` — ${size}`}`);
+    }
+    if (sorted.length > shown.length) {
+        lines.push("", `[${sorted.length - shown.length} more entries not listed]`);
+    }
+    return lines.join("\n");
+}
+async function describeFile(config, resolved, displayPath, size, modified) {
+    const head = await readHead(resolved, HEAD_SAMPLE_BYTES);
+    const kind = await detectKind(resolved, head);
+    const lines = [
+        `# File: ${displayPath}`,
+        "",
+        `- kind: **${kind}**`,
+        `- size: ${formatBytes(size)} (${size} bytes)`,
+        `- modified: ${modified.toISOString()}`
+    ];
+    if (size > config.maxFileSize) {
+        lines.push(`- **over the server's ${formatBytes(config.maxFileSize)} size limit** — reading it will be rejected`);
+    }
+    const detail = await describeKind(kind, head, resolved, config);
+    if (detail.length > 0) {
+        lines.push("", ...detail);
+    }
+    const mismatch = describeExtensionMismatch(resolved, kind);
+    if (mismatch.length > 0) {
+        lines.push("", ...mismatch);
+    }
+    return lines.join("\n");
+}
+/**
+ * Warn when the extension claims a format the bytes contradict.
+ *
+ * This is the payoff for checking magic bytes first. A `.xlsx` that is really a
+ * CSV is routine in exported data, and left unflagged the model would confidently
+ * hand it to a spreadsheet reader and misread the resulting failure.
+ */
+function describeExtensionMismatch(filePath, kind) {
+    const claimed = CLAIMED_BY_EXTENSION[path.extname(filePath).toLowerCase()];
+    if (claimed === undefined || claimed === kind) {
+        return [];
+    }
+    return [
+        `**Extension mismatch**: the name claims \`${claimed}\` but the content is not that format (detected: \`${kind}\`).`,
+        "Trust the detected kind, not the extension, and tell the user about the discrepancy."
+    ];
+}
+/** Formats an extension asserts, for cross-checking against detected content. */
+const CLAIMED_BY_EXTENSION = {
+    ".xlsx": "excel",
+    ".xlsm": "excel",
+    ".xltx": "excel",
+    ".docx": "word",
+    ".docm": "word",
+    ".dotx": "word",
+    ".pptx": "powerpoint",
+    ".pdf": "pdf",
+    ".zip": "zip"
+};
+/** Per-kind extra facts worth knowing before reading. */
+async function describeKind(kind, head, resolved, config) {
+    switch (kind) {
+        case "csv":
+            return describeCsv(head);
+        case "excel":
+            return await describeWorkbook(resolved, config);
+        case "word":
+            return await describeWordDocument(resolved, config);
+        case "pdf":
+            return await describePdf(resolved, config);
+        case "powerpoint":
+            return [
+                "This is a PowerPoint package. No tool reads .pptx — say so rather than guessing at its",
+                "contents."
+            ];
+        case "cfb":
+            return [
+                "This is a CFB/OLE2 container. That means either a legacy binary Office file (.doc/.xls,",
+                "which this toolkit does not read) or a password-encrypted OOXML document (which it does,",
+                "given the password). Ask the user which, rather than guessing."
+            ];
+        default:
+            return [];
+    }
+}
+/**
+ * List a workbook's sheets with their used ranges.
+ *
+ * This is what makes "always inspect first" pay for itself: the model learns
+ * the sheet names and roughly how much data each holds, so its next call names a
+ * real sheet and a sensible range instead of guessing and retrying.
+ *
+ * Opening the package costs the same parse a `sheet_read` would pay, so it is
+ * skipped for files over the configured size limit — where reading is refused
+ * anyway.
+ */
+async function describeWorkbook(resolved, config) {
+    const stats = await fs.stat(resolved);
+    if (stats.size > config.maxFileSize) {
+        return [
+            "This is an Excel workbook, but it is over the size limit, so its sheets were not listed."
+        ];
+    }
+    const wb = Workbook.create();
+    try {
+        await Workbook.readFile(wb, resolved);
+    }
+    catch (cause) {
+        return [
+            `This looks like an Excel workbook but could not be parsed: ${cause instanceof Error ? cause.message : String(cause)}`,
+            "It may be corrupt, or password-protected."
+        ];
+    }
+    const sheets = Workbook.getWorksheets(wb);
+    if (sheets.length === 0) {
+        // A valid .xlsx always has at least one sheet, and a ZIP that merely looks
+        // like one parses without error into an empty workbook — so report the
+        // likely cause rather than the literal finding.
+        return [
+            "No worksheets were found. A valid Excel workbook always has at least one, so this is most",
+            "likely a ZIP file that is not really an .xlsx. Treat the extension as unreliable."
+        ];
+    }
+    const lines = [
+        "## Sheets",
+        "",
+        "| sheet | used range | rows | cols |",
+        "| --- | --- | --- | --- |"
+    ];
+    for (const ws of sheets) {
+        const window = usedWindow(ws);
+        lines.push(window === undefined
+            ? `| \`${sheetName(ws)}\` | (empty) | 0 | 0 |`
+            : `| \`${sheetName(ws)}\` | ${describeWindow(window)} | ${window.bottom - window.top + 1} | ${window.right - window.left + 1} |`);
+    }
+    lines.push("", "Read one with `sheet_read`, naming the sheet and a range.");
+    return lines;
+}
+/**
+ * Describe a Word document, and point at the right tool for it.
+ *
+ * The routing matters more than the statistics. A `.docx` may be prose, a
+ * `{{placeholder}}` template, or a form with legacy fields, and each wants a
+ * different tool — `doc_edit`, `template_fill`, `form_fill`. A model that cannot
+ * tell them apart reaches for the wrong one and then thrashes, so the answer is
+ * given here, in the call the model already makes first.
+ */
+async function describeWordDocument(resolved, config) {
+    const stats = await fs.stat(resolved);
+    if (stats.size > config.maxFileSize) {
+        return ["This is a Word document, but it is over the size limit, so it was not opened."];
+    }
+    let doc;
+    try {
+        doc = await Io.readFile(resolved);
+    }
+    catch (cause) {
+        return [
+            `This looks like a Word document but could not be parsed: ${cause instanceof Error ? cause.message : String(cause)}`,
+            "It may be corrupt, or password-protected — neither can be read here."
+        ];
+    }
+    const headings = Query.getHeadings(doc);
+    const templateTags = Template.listTemplateTags(doc);
+    const formFields = Query.extractFormFields(doc);
+    const revisions = Query.listRevisions(doc);
+    const lines = [
+        "## Word document",
+        "",
+        `- pages: ${Layout.document(doc).pageCount} (computed, no Word needed)`,
+        `- paragraphs: ${Query.paragraphCount(doc)} · words: ${Query.countWords(doc)}`,
+        `- tables: ${Query.tableCount(doc)} · images: ${Query.listImages(doc).length}`,
+        `- headings: ${headings.length}`
+    ];
+    if (headings.length > 0) {
+        lines.push("", "Outline:", ...headings
+            .slice(0, 20)
+            .map(heading => `${"  ".repeat(Math.max(0, heading.level - 1))}- H${heading.level}: ${heading.text}`), ...(headings.length > 20 ? [`  … ${headings.length - 20} more`] : []));
+    }
+    // The routing advice. Each branch names one tool, because naming two invites
+    // the model to try both.
+    const routes = [];
+    if (templateTags.length > 0) {
+        routes.push(`- **This is a template**: ${templateTags.length} \`{{placeholder}}\` tag(s). Use \`template_inspect\` then \`template_fill\` — not doc_edit.`);
+    }
+    if (formFields.length > 0) {
+        routes.push(`- **This is a form**: ${formFields.length} fillable field(s). Use \`form_fill\` — not doc_edit.`);
+    }
+    if (revisions.length > 0) {
+        routes.push(`- **Contains ${revisions.length} tracked change(s).** Use \`doc_review\` to list, accept or reject them.`);
+    }
+    if (routes.length === 0) {
+        routes.push("- Ordinary prose. Read it with `doc_read`, change text with `doc_edit`.");
+    }
+    return [...lines, "", ...routes];
+}
+/**
+ * Describe a PDF, including whether there is any text to read at all.
+ *
+ * The scanned-document case is the one worth catching early: there is no OCR
+ * here, so a page image yields nothing, and a model told only "this is a PDF"
+ * will read it, get an empty result, and start inventing.
+ */
+async function describePdf(resolved, config) {
+    const stats = await fs.stat(resolved);
+    if (stats.size > config.maxFileSize) {
+        return ["This is a PDF, but it is over the size limit, so it was not opened."];
+    }
+    const bytes = await fs.readFile(resolved);
+    let result;
+    try {
+        result = await Pdf.read(new Uint8Array(bytes), {
+            extractText: true,
+            extractImages: false,
+            extractTables: false,
+            extractAnnotations: false,
+            extractFormFields: true,
+            extractBookmarks: true
+        });
+    }
+    catch (cause) {
+        return [
+            `This looks like a PDF but could not be parsed: ${cause instanceof Error ? cause.message : String(cause)}`,
+            "It may be corrupt, or password-protected — a password cannot be supplied here."
+        ];
+    }
+    const pageCount = result.metadata?.pageCount ?? result.pages.length;
+    const emptyPages = result.pages.filter(page => page.text.trim().length === 0).length;
+    const formFields = result.formFields ?? [];
+    const lines = [
+        "## PDF",
+        "",
+        `- pages: ${pageCount}`,
+        `- PDF version: ${result.metadata?.pdfVersion ?? "unknown"}${result.metadata?.encrypted ? " · **encrypted**" : ""}`
+    ];
+    if (result.metadata?.title !== undefined && result.metadata.title.length > 0) {
+        lines.push(`- title: ${result.metadata.title}`);
+    }
+    if ((result.bookmarks?.length ?? 0) > 0) {
+        lines.push(`- bookmarks: ${result.bookmarks?.length}`);
+    }
+    if (formFields.length > 0) {
+        lines.push("", `- **This is a fillable form**: ${formFields.length} AcroForm field(s). Use \`form_fill\`.`);
+    }
+    if (emptyPages === pageCount) {
+        lines.push("", "- **No page yields any extractable text.** This is almost certainly a scan. There is no OCR", "  here, so its contents cannot be read — say so rather than inferring them.", "  You can still watermark, reorder or split it with `pdf_edit`.");
+    }
+    else if (emptyPages > 0) {
+        lines.push("", `- ${emptyPages} of ${pageCount} page(s) yield no text — probably scanned pages.`);
+    }
+    else {
+        lines.push("", "- Text is extractable on every page. Read it with `doc_read`.");
+    }
+    return lines;
+}
+/** Report the CSV dialect so the model does not have to guess it. */
+function describeCsv(head) {
+    // `ignoreBOM: true` is required, despite reading backwards: it means "treat a
+    // leading U+FEFF as an ordinary character" rather than silently consuming it.
+    // Without it the BOM never reaches the string and we would always report
+    // "no BOM" — which is the one thing a caller most needs to know, because a
+    // stray BOM corrupts the first column's header.
+    const raw = new TextDecoder("utf-8", { fatal: false, ignoreBOM: true }).decode(head);
+    const hasBom = raw.charCodeAt(0) === 0xfeff;
+    const text = Csv.stripBom(raw);
+    const delimiter = Csv.detectDelimiter(text);
+    const linebreak = Csv.detectLinebreak(text);
+    const firstLine = text.split(/\r\n|\r|\n/, 1)[0] ?? "";
+    const columns = firstLine.length > 0 ? firstLine.split(delimiter).length : 0;
+    return [
+        "## CSV dialect (detected from the first 64 KiB)",
+        "",
+        `- delimiter: \`${describeChar(delimiter)}\``,
+        `- line ending: \`${describeChar(linebreak)}\``,
+        `- UTF-8 BOM: ${hasBom ? "yes" : "no"}`,
+        `- columns in first line: ${columns}`,
+        "",
+        "Note: character-set detection is not implemented yet. A non-UTF-8 file (for example GBK from",
+        "a Chinese Windows export) will decode incorrectly — if the text below looks like mojibake, say",
+        "so instead of interpreting it.",
+        "",
+        "First line:",
+        "",
+        "```",
+        firstLine.slice(0, 500),
+        "```"
+    ];
+}
+function describeChar(value) {
+    return value.replace(/\t/g, "\\t").replace(/\r/g, "\\r").replace(/\n/g, "\\n");
+}
+/**
+ * Identify the file from its magic bytes, falling back to its extension.
+ *
+ * Magic bytes come first because extensions lie — a `.xlsx` that is really a
+ * CSV is a routine occurrence in exported data.
+ */
+async function detectKind(filePath, head) {
+    if (startsWith(head, [0x50, 0x4b, 0x03, 0x04]) || startsWith(head, [0x50, 0x4b, 0x05, 0x06])) {
+        return await zipContentKind(filePath);
+    }
+    if (startsWith(head, [0x25, 0x50, 0x44, 0x46, 0x2d])) {
+        return "pdf";
+    }
+    if (startsWith(head, [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1])) {
+        return "cfb";
+    }
+    if (startsWith(head, [0x1f, 0x8b])) {
+        return "tar";
+    }
+    return textKindFromExtension(filePath);
+}
+/** Identify OOXML by the parts in the ZIP, never by the filename. */
+async function zipContentKind(filePath) {
+    try {
+        const archive = await ArchiveFile.fromFile(filePath);
+        const names = new Set((await archive.getEntries()).map(entry => entry.path));
+        if (names.has("xl/workbook.xml")) {
+            return "excel";
+        }
+        if (names.has("word/document.xml")) {
+            return "word";
+        }
+        if (names.has("ppt/presentation.xml")) {
+            return "powerpoint";
+        }
+    }
+    catch {
+        // A malformed ZIP is still best described as ZIP; the archive tool will
+        // provide the parse failure if the caller tries to open it.
+    }
+    return "zip";
+}
+function textKindFromExtension(filePath) {
+    switch (path.extname(filePath).toLowerCase()) {
+        case ".csv":
+        case ".tsv":
+            return "csv";
+        case ".md":
+        case ".markdown":
+            return "markdown";
+        case ".xml":
+            return "xml";
+        case ".tar":
+            return "tar";
+        case ".txt":
+        case ".json":
+        case ".log":
+            return "text";
+        default:
+            return "unknown";
+    }
+}
+function startsWith(bytes, prefix) {
+    if (bytes.length < prefix.length) {
+        return false;
+    }
+    return prefix.every((byte, index) => bytes[index] === byte);
+}
+/** Read at most `limit` bytes from the head of a file. */
+async function readHead(filePath, limit) {
+    const handle = await fs.open(filePath, "r");
+    try {
+        const buffer = new Uint8Array(limit);
+        const { bytesRead } = await handle.read(buffer, 0, limit, 0);
+        // A fixed byte count can split a multi-byte UTF-8 sequence at the tail;
+        // decoding is non-fatal, so that becomes one replacement character at the
+        // very end of a 64 KiB sample and cannot affect dialect detection.
+        return buffer.subarray(0, bytesRead);
+    }
+    finally {
+        await handle.close();
+    }
+}
+/** Render a path relative to the sandbox root, so the root itself never leaks. */
+function toDisplayPath(root, resolved) {
+    const relative = path.relative(root, resolved);
+    return relative.length === 0 ? "." : relative;
+}
+//# sourceMappingURL=inspect.js.map

package/dist/tools/inspect.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * `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.
+ */
+export declare const pdfEditTool: import("./types.js").AnyToolDefinition;
+//# sourceMappingURL=pdf-edit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-edit.d.ts","sourceRoot":"","sources":["../../src/tools/pdf-edit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAwGH,eAAO,MAAM,WAAW,wCAsJtB,CAAC"}