@documonster/mcp 0.10.0 → 0.11.0

package/README.md

@@ -2,12 +2,13 @@
 
 [Model Context Protocol](https://modelcontextprotocol.io) server for
 [documonster](https://github.com/documonster/documonster). Gives an AI assistant
-the ability to read, write and convert Excel, Word, PDF, CSV and ZIP documents
-on the local filesystem.
+the ability to read, write and convert Excel, Word, PDF, CSV and ZIP documents —
+and to draw Mermaid diagrams — on the local filesystem.
 
-> **Status: usable.** Nineteen tools cover spreadsheets, Word, PDF, templates and
-> archives — reading, writing, editing, searching and converting. See
-> [Roadmap](#roadmap) for what is deliberately absent.
+> **Status: usable.** Twenty-one tools cover spreadsheets, Word, PDF, templates,
+> archives and diagrams — reading, writing, editing, searching, converting and
+> drawing. See [Deliberately absent](#deliberately-absent) for the intentional
+> scope boundaries.
 
 ## Install
 
@@ -61,15 +62,15 @@ No install needed — point your MCP client at `npx`.
 
 ## Options
 
-| Flag                      | Default      | Meaning                                                                                               |
-| ------------------------- | ------------ | ----------------------------------------------------------------------------------------------------- |
-| `--root <dir>`            | cwd          | Sandbox root. Every path a tool touches must resolve inside it.                                       |
-| `--output-root <dir>`     | private temp | Separate writable root. Outputs are returned as `@output/<path>` for later calls.                     |
-| `--allow-in-place`        | off          | Permit edits below `--root`; disabled by default because it weakens isolation.                        |
-| `--readonly`              | off          | Withhold every mutating tool from the model's tool list.                                              |
-| `--enable <groups>`       | all          | Comma-separated tool groups: `core`, `excel`, `word`, `pdf`, `forms`, `archive`. `core` is always on. |
-| `--max-file-size <bytes>` | 67108864     | Reject larger input documents.                                                                        |
-| `--max-output-chars <n>`  | 40000        | Truncate tool output — a token budget in disguise.                                                    |
+| Flag                      | Default      | Meaning                                                                                                          |
+| ------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------- |
+| `--root <dir>`            | cwd          | Sandbox root. Every path a tool touches must resolve inside it.                                                  |
+| `--output-root <dir>`     | private temp | Separate writable root. Outputs are returned as `@output/<path>` for later calls.                                |
+| `--allow-in-place`        | off          | Permit edits below `--root`; disabled by default because it weakens isolation.                                   |
+| `--readonly`              | off          | Withhold every mutating tool from the model's tool list.                                                         |
+| `--enable <groups>`       | all          | Comma-separated tool groups: `core`, `excel`, `word`, `pdf`, `forms`, `archive`, `diagram`. `core` is always on. |
+| `--max-file-size <bytes>` | 67108864     | Reject larger input documents.                                                                                   |
+| `--max-output-chars <n>`  | 40000        | Truncate tool output — a token budget in disguise.                                                               |
 
 ## Security
 
@@ -114,31 +115,34 @@ server root with an untrusted local account or process while the server runs.
 
 ## Tools
 
-| Tool                    | Purpose                                                                                                                      |
-| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| **Orientation**         |                                                                                                                              |
-| `documonster_help`      | Conventions, path rules, and formula/document/editing notes kept out of tool schemas to save context.                        |
-| `doc_inspect`           | Identify a file (type, size, sheet list, CSV dialect, extension mismatches) or list a directory. Always first.               |
-| **Spreadsheets**        |                                                                                                                              |
-| `sheet_read`            | Read a bounded window as a Markdown table with column letters and row numbers. Paginates; reports what it omitted.           |
-| `sheet_write`           | Create an `.xlsx` from a declarative spec. `fromCsv` pulls source data in server-side.                                       |
-| `sheet_edit`            | Patch an existing `.xlsx` — cells, ranges, formulas, rows, styles, sheets. Atomic, backed up, `dryRun` available.            |
-| `formula_evaluate`      | Evaluate a formula against supplied values using the real engine (~450 functions). Touches no files.                         |
-| **Documents**           |                                                                                                                              |
-| `doc_read`              | Read `.docx` / `.pdf` / `.md` / `.txt`. Word returns Markdown; PDFs are reported page by page.                               |
-| `doc_write`             | Create a `.docx` or `.pdf` from Markdown.                                                                                    |
-| `doc_edit`              | Find and replace text in a `.docx`, including matches Word split across runs. Formatting preserved.                          |
-| `doc_search`            | Find text, or find text **by its formatting** — "which text is red", "what is highlighted".                                  |
-| `doc_paginate`          | Real page count and per-heading page numbers without Word installed; optionally refresh fields and the TOC.                  |
-| `doc_convert`           | `docx`→`md`/`html`/`pdf`/`txt`, `md`→`docx`/`pdf`, `xlsx`→`csv`/`pdf`, `csv`→`xlsx`. Lossy conversions state their loss.     |
-| `pdf_edit`              | Watermark, page numbers, stamps, rotate, delete/keep pages, append another PDF. Overlays never rewrite the original content. |
-| **Forms and templates** |                                                                                                                              |
-| `template_inspect`      | List a template's placeholders and print the JSON shape needed to fill it.                                                   |
-| `template_fill`         | Fill a Word template from JSON. A missing field fails loudly rather than shipping a blank.                                   |
-| `form_fill`             | List or fill Word form fields and PDF AcroForms. PDF values are verified by re-reading the saved file.                       |
-| **Archives**            |                                                                                                                              |
-| `archive_read`          | List or extract a `.zip`/`.tar`. Guards traversal, decompression bombs and symlink entries.                                  |
-| `archive_write`         | Package files and directories into a `.zip`/`.tar`, verified by reading it back.                                             |
+| Tool                    | Purpose                                                                                                                                                          |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Orientation**         |                                                                                                                                                                  |
+| `documonster_help`      | Conventions, path rules, and formula/document/editing notes kept out of tool schemas to save context.                                                            |
+| `doc_inspect`           | Identify a file (type, size, sheet list, CSV dialect, extension mismatches) or list a directory. Always first.                                                   |
+| **Spreadsheets**        |                                                                                                                                                                  |
+| `sheet_read`            | Read a bounded window as a Markdown table with column letters and row numbers. Paginates; reports what it omitted.                                               |
+| `sheet_write`           | Create an `.xlsx` from a declarative spec. `fromCsv` pulls source data in server-side; `images` places pictures.                                                 |
+| `sheet_edit`            | Patch an existing `.xlsx` — cells, ranges, formulas, rows, styles, sheets, images. Atomic, backed up, `dryRun` available.                                        |
+| `formula_evaluate`      | Evaluate a formula against supplied values using the real engine (~450 functions). Touches no files.                                                             |
+| **Documents**           |                                                                                                                                                                  |
+| `doc_read`              | Read `.docx` / `.pdf` / `.md` / `.txt` / `.mmd`. Word returns Markdown; PDFs page by page; a Markdown file's mermaid fences are indexed.                         |
+| `doc_write`             | Create a `.docx` or `.pdf` from Markdown.                                                                                                                        |
+| `doc_edit`              | Find and replace text in a `.docx`, including matches Word split across runs. Formatting preserved.                                                              |
+| `doc_search`            | Find text, or find text **by its formatting** — "which text is red", "what is highlighted".                                                                      |
+| `doc_paginate`          | Real page count and per-heading page numbers without Word installed; optionally refresh fields and the TOC.                                                      |
+| `doc_convert`           | `docx`→`md`/`html`/`pdf`/`txt`, `md`→`docx`/`pdf`, `xlsx`→`csv`/`pdf`, `csv`→`xlsx`. Lossy conversions state their loss.                                         |
+| `pdf_edit`              | Watermark, page numbers, stamps, a Mermaid diagram drawn as vectors, rotate, delete/keep pages, append another PDF. Overlays never rewrite the original content. |
+| **Forms and templates** |                                                                                                                                                                  |
+| `template_inspect`      | List a template's placeholders and print the JSON shape needed to fill it.                                                                                       |
+| `template_fill`         | Fill a Word template from JSON, plus `{{%name}}` image placeholders. A missing field fails loudly rather than shipping a blank.                                  |
+| `form_fill`             | List or fill Word form fields and PDF AcroForms. PDF values are verified by re-reading the saved file.                                                           |
+| **Diagrams**            |                                                                                                                                                                  |
+| `diagram_inspect`       | Parse Mermaid text and report what it means — every node, edge, participant, task or slice recognised. Writes nothing.                                           |
+| `diagram_render`        | Draw it as `.svg` / `.png` / `.pdf`. Twenty-one diagram types, themed, from one display list.                                                                    |
+| **Archives**            |                                                                                                                                                                  |
+| `archive_read`          | List or extract a `.zip`/`.tar`. Guards traversal, decompression bombs and symlink entries.                                                                      |
+| `archive_write`         | Package files and directories into a `.zip`/`.tar`, verified by reading it back.                                                                                 |
 
 ### Two worked examples
 
@@ -172,13 +176,124 @@ Note what does **not** happen in either: no document bytes and no bulk rows pass
 through the model's context. `fromCsv`, the `entries` filter and template data
 keep the payload on the server.
 
+### Diagrams
+
+`diagram_render` takes Mermaid text and draws `flowchart`, `sequenceDiagram`,
+`classDiagram`, `stateDiagram`, `erDiagram`, `gantt`, `gitGraph`, `mindmap`,
+`timeline`, `journey`, `kanban`, `quadrantChart`, `xychart`, `radar`, `sankey`,
+`packet`, `block`, `pie`, `C4`, `requirementDiagram` and `architecture` — the same
+twenty-one the core library draws, since this is a thin consumer of its public API.
+
+```jsonc
+diagram_inspect { "source": "flowchart TD\n  A[Read] --> B{Valid?}\n  B -->|no| A" }
+diagram_render  { "source": "…", "to": "arch.svg", "theme": "dark" }
+```
+
+**The result reports the parsed structure, and that is the point.** This is the one
+place in the server where reading the output back is impossible — nothing can look
+at a picture. So both tools answer with what the parser recognised: `3 node(s),
+3 edge(s)`, `A (Read)`, `B -[no]-> A`. The parser implements a subset of Mermaid and
+a subset fails by _silently dropping_ what it did not understand, so a missing edge
+in that list is the only symptom there will ever be.
+
+SVG, PNG and PDF come from the **same display list** rather than three renderers, so
+they are the same picture and not three that might disagree. `theme` picks a colour
+set (`default` is Mermaid's own base theme token for token; `dark` and `neutral` are
+this server's), `themeOverrides` sets individual tokens, and `background` defaults to
+white — a transparent PNG is invisible in a dark viewer, which is a failure the model
+would never see.
+
+A ` ```mermaid ` fence in the Markdown you give `doc_write` (or in a `.md` file you
+pass to `doc_convert`) becomes a real embedded image, scaled to fit the text column:
+Word does not shrink an oversized inline image, it runs it off the page. A fence that
+fails to parse is left as a code block and reported, so one bad diagram never costs
+you the document. `diagrams: false` opts out.
+
+**Onto a PDF that already exists**, `pdf_edit` takes `{ op: "diagram", source, pages }`
+and draws **vectors** onto the page — sharp at any zoom, saved as an incremental
+update so bookmarks, form fields and signature bytes survive. Two defaults invert
+because it draws _over_ existing content: `background` is transparent, and omitting
+the position centres the diagram at its natural size shrunk to fit, so the simplest
+call lands on the page rather than off the edge of it.
+
+**Reading** is the one direction that stays textual, deliberately: `doc_read` cannot
+show you a picture, so it returns a `.mmd` file's source and _indexes_ a Markdown
+file's fences instead. The footer names `diagram_render({ from, index, to })` — the
+point being that the model never has to copy a diagram's source out through its own
+reply in order to draw it.
+
+### Images
+
+A diagram is not a separate kind of thing from a picture, so it is not a separate
+argument. Four destinations take an image, and all four take the **same source
+shape**, routed by extension rather than by a format flag:
+
+````jsonc
+{ "from": "logo.png" }                  // .png / .jpg / .gif — embedded as-is
+{ "from": "flow.mmd" }                  // a diagram file — drawn server-side
+{ "from": "design.md", "index": 2 }     // a ```mermaid fence out of Markdown
+{ "source": "flowchart LR\n A --> B" }  // Mermaid text
+````
+
+| Destination                   | How                                                          |
+| ----------------------------- | ------------------------------------------------------------ |
+| a worksheet                   | `images` in `sheet_write`, `op: "add_image"` in `sheet_edit` |
+| a Word template's `{{%name}}` | `images` in `template_fill`                                  |
+| a page of an existing PDF     | `op: "diagram"` in `pdf_edit`                                |
+| a document you write          | a ` ```mermaid ` fence in `doc_write`'s Markdown             |
+
+```jsonc
+sheet_write   { "path": "out/report.xlsx", "sheets": [{ "name": "June",
+                  "images": [{ "at": "F2", "from": "logo.png" },
+                             { "at": "A10:H30", "source": "flowchart LR\n A --> B" }] }] }
+template_fill { "template": "invoice.docx", "out": "out/INV.docx",
+                "data": { "client": "Acme" },
+                "images": { "logo": { "from": "logo.png" } } }
+```
+
+Four details are worth knowing, because each was a real defect before it was a rule.
+**A worksheet anchor means two different things**: a single cell (`"F2"`) hangs the
+picture at its own size, a range (`"A10:H30"`) binds it to those cells so it moves
+_and resizes_ with them — offering only one silently answers half the requests
+wrongly. **One dimension implies the other**, keeping the aspect ratio, because an
+image squashed to a ratio nobody asked for is a defect the model cannot see. **A
+declared resolution is honoured** — a PNG's `pHYs`, a JPEG's JFIF density — because
+Word and Excel honour it, so ignoring it placed a 300-dpi photograph at three times
+its intended size. And **a header that will not parse is an error**, not a 1×1
+placement: the library's own reader answers 1×1 for an unreadable file, which is right
+for a renderer that must draw something and wrong here, where the result would be
+invisible and unreportable.
+
+Sizes are in points. A single call may place 20 pictures, 64 MiB of source and 80
+million decoded pixels; the budget is aggregate, because twenty images each just under
+a per-file limit cost the same memory as one enormous one.
+
 ### Deliberately absent
 
 Not implemented, and the server tells the model to say so rather than improvise:
 password-protected files, PDF→Word (no faithful conversion exists), OCR, legacy
-binary `.doc`/`.xls`, and image/pivot-table insertion — the library supports
-those, no tool does yet. Spreadsheet charts are supported by `sheet_write` and
-`sheet_edit`.
+binary `.doc`/`.xls`, and pivot tables — the library supports that last one, no
+tool does yet.
+
+A Word template's `{{%name}}` must sit in **a paragraph of its own** — in the body, a
+table cell, or a header or footer, nesting included. One placement is genuinely
+impossible: scoped to a `{{#each}}` item, because images are substituted before loops
+expand, so one picture per row is not expressible. `template_fill` refuses that up
+front and `template_inspect` marks it rather than inventing a key for it.
+
+Every image is also checked for **integrity**, not just for a readable header: PNG
+chunk CRCs and an inflate that yields exactly the declared scanlines, a JPEG's
+end-of-image marker, a GIF's trailer. Truncation is how images really arrive broken,
+and a header check cannot see it — the first bytes of a cut-off PNG are identical to a
+whole one's.
+
+Because that same pass runs before conditionals are evaluated, a picture inside a
+`{{#if}}` that turns out false is substituted and then removed with its block. The
+fill still succeeds, so `template_fill` reports it as **not in the output** and drops
+its bytes from the package — a document that withholds a picture must not leak it to
+anyone who unzips the file. Every placed picture is then verified by re-opening the
+written `.docx`, because the document handed to the writer is not evidence about the
+file it produced.
 
 ### Editing existing files
 
@@ -206,10 +321,10 @@ Besides tools, the server publishes:
 
 - **Resources** — every help topic at `documonster://help/{topic}`, so a client can
   display them and a model can read one without spending a tool call.
-- **Prompts** — five workflow templates (`summarise-spreadsheet`, `build-report`,
-  `fill-document`, `review-changes`, `convert-document`). Each encodes the working
-  order that matters — inspect, read narrowly, verify — and tells the model never
-  to invent a value it was not given.
+- **Prompts** — six workflow templates (`summarise-spreadsheet`, `build-report`,
+  `fill-document`, `review-changes`, `convert-document`, `draw-diagram`). Each
+  encodes the working order that matters — inspect, read narrowly, verify — and
+  tells the model never to invent a value it was not given.
 
 ## Programmatic use
 
@@ -239,11 +354,15 @@ ever imports `@excel/*`, `@utils/*` or reaches into `../../src`.
 
 ### Testing layers
 
-| Layer      | File                                                    | Catches                                                                                                                |
-| ---------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
-| Unit       | `config` / `sandbox` / `result` / `errors` / `registry` | Argument parsing, path containment, output budget, error text, tool filtering                                          |
-| Protocol   | `server.test.ts`                                        | Handshake, `tools/list`, JSON Schema generation, `tools/call`, in-memory transport                                     |
-| Executable | `stdio.e2e.test.ts`                                     | Real spawned process: `bin` entry, shebang, exit codes, manifest version, and that stdout carries nothing but JSON-RPC |
+| Layer      | File                                                    | Catches                                                                                                                      |
+| ---------- | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| Unit       | `config` / `sandbox` / `result` / `errors` / `registry` | Argument parsing, path containment, output budget, error text, tool filtering                                                |
+| Per-kind   | `diagram.test.ts`                                       | All 21 diagram types through inspect + SVG + PNG + PDF — a structural summary reading a field one kind spells differently    |
+| Units      | `image.test.ts`                                         | px-at-96 / pt-at-72 / EMU-at-914400 confusions, by asserting a known pixel size survives into a worksheet anchor             |
+| Package    | `image.test.ts`                                         | Media integrity in the produced OOXML: unique parts, resolvable relationships, and no bytes left behind by a false `{{#if}}` |
+| Budget     | `schema-budget.test.ts`                                 | The permanent context cost of `tools/list`, which nothing else makes visible as it grows                                     |
+| Protocol   | `server.test.ts`                                        | Handshake, `tools/list`, JSON Schema generation, `tools/call`, in-memory transport                                           |
+| Executable | `stdio.e2e.test.ts`                                     | Real spawned process: `bin` entry, shebang, exit codes, manifest version, and that stdout carries nothing but JSON-RPC       |
 
 The e2e suite compiles the package itself in `beforeAll`, so it never
 silently skips when `dist/` is absent.

package/dist/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAezD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAgL7E"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAezD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAiN7E"}

package/dist/capabilities.js

@@ -160,6 +160,34 @@ Work in this order:
             ]
         }));
     }
+    if (has("diagram") && !config.readonly) {
+        server.registerPrompt("draw-diagram", {
+            title: "Draw a diagram",
+            description: "Turn a description of a system or process into a rendered Mermaid diagram.",
+            argsSchema: {
+                subject: z.string().describe("What the diagram should show."),
+                out: z.string().describe("Output path; the extension picks .svg, .png or .pdf.")
+            }
+        }, ({ subject, out }) => ({
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Draw ${out} showing: ${subject}
+
+Work in this order:
+1. Choose the diagram type that matches the *relationship*, not the one you know best — a flow is a flowchart, an interaction over time is a sequenceDiagram, a lifecycle is a stateDiagram, a data model is an erDiagram, a schedule is a gantt.
+2. Call diagram_inspect with the Mermaid source before rendering. Read the structure it reports back and check every node and edge you intended is there — the parser drops what it does not recognise **silently**, and this is the only place that shows.
+3. Then diagram_render to ${out}.
+4. Tell me the diagram's type and its node/edge counts. You cannot see the picture, so do not claim it "looks good" — report what the parser found.
+
+If a label is long, prefer shortening it over widening the diagram. If ${out} is a page inside an existing PDF instead of a new file, use pdf_edit with op: "diagram".`
+                    }
+                }
+            ]
+        }));
+    }
     if ((has("word") || has("pdf") || has("excel")) && !config.readonly) {
         server.registerPrompt("convert-document", {
             title: "Convert a document",

package/dist/capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,kCAAkC;AAClC,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAE9C,4CAA4C;AAC5C,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,gBAAgB,CACrB,QAAQ,IAAI,EAAE,EACd,GAAG,eAAe,GAAG,IAAI,EAAE,EAC3B;YACE,KAAK,EAAE,gBAAgB,IAAI,EAAE;YAC7B,WAAW,EAAE,KAAK,CAAC,OAAO;YAC1B,QAAQ,EAAE,eAAe;SAC1B,EACD,GAAG,CAAC,EAAE,CAAC,CAAC;YACN,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC3E,CAAC,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,MAAoB;IACrE,MAAM,GAAG,GAAG,CAAC,KAAqD,EAAW,EAAE,CAC7E,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAE3B,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACjB,MAAM,CAAC,cAAc,CACnB,uBAAuB,EACvB;YACE,KAAK,EAAE,yBAAyB;YAChC,WAAW,EAAE,2EAA2E;YACxF,UAAU,EAAE;gBACV,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;gBACxE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;aACjE;SACF,EACD,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YACvB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,8BAA8B,IAAI,KAAK,QAAQ;;;yBAG1C,IAAI;;;;;wHAK2F;qBAC3G;iBACF;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,CAAC,cAAc,CACnB,cAAc,EACd;YACE,KAAK,EAAE,gCAAgC;YACvC,WAAW,EAAE,6DAA6D;YAC1E,UAAU,EAAE;gBACV,OAAO,EAAE,CAAC;qBACP,MAAM,EAAE;qBACR,QAAQ,CAAC,8DAA8D,CAAC;gBAC3E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;aAC1D;SACF,EACD,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3B,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,SAAS,GAAG,SAAS,OAAO,qBAAqB,IAAI;;;;;;;mJAO0E;qBACtI;iBACF;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,CAAC,cAAc,CACnB,eAAe,EACf;YACE,KAAK,EAAE,yBAAyB;YAChC,WAAW,EAAE,kEAAkE;YAC/E,UAAU,EAAE;gBACV,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;gBACnD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;gBAC3E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;aACjE;SACF,EACD,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;YACxB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,QAAQ,IAAI;;EAE9B,IAAI;;;iBAGW,IAAI;;;wGAIL,GAAG,KAAK,SAAS;4BACf,CAAC,CAAC,EAAE;4BACJ,CAAC,CAAC,qCAAqC,GAAG,oBAC9C,EAAE;qBACH;iBACF;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAChB,MAAM,CAAC,cAAc,CACnB,gBAAgB,EAChB;YACE,KAAK,EAAE,yBAAyB;YAChC,WAAW,EAAE,oEAAoE;YACjF,UAAU,EAAE;gBACV,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;gBAC/D,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;aAChF;SACF,EACD,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACb,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,CAAC,KAAK,SAAS;4BACb,CAAC,CAAC,iCAAiC,CAAC;;;;;kDAKJ;4BAChC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC;;;;;2GAKiE;qBAC9F;iBACF;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpE,MAAM,CAAC,cAAc,CACnB,kBAAkB,EAClB;YACE,KAAK,EAAE,oBAAoB;YAC3B,WAAW,EAAE,gEAAgE;YAC7E,UAAU,EAAE;gBACV,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;gBACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;aAC7E;SACF,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACjB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,WAAW,IAAI,OAAO,EAAE;;;;2DAIe;qBAC9C;iBACF;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -14,7 +14,7 @@
  * `core` (`documonster_help`, `doc_inspect`) is always enabled — it is how a
  * model orients itself before doing anything else.
  */
-export declare const TOOL_GROUPS: readonly ["core", "excel", "word", "pdf", "forms", "archive"];
+export declare const TOOL_GROUPS: readonly ["core", "excel", "word", "pdf", "forms", "archive", "diagram"];
 export type ToolGroup = (typeof TOOL_GROUPS)[number];
 export interface ServerConfig {
     /**

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,YAAI,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAEzF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAerD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAkB,IAAI,iBAAiB;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,oBAAyB,GACjC,YAAY,CAuEd;AAUD,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAK1F;AA2CD,+BAA+B;AAC/B,wBAAgB,KAAK,IAAI,MAAM,CAkC9B"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,YAAI,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAEpG,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAuBrD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAkB,IAAI,iBAAiB;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,oBAAyB,GACjC,YAAY,CAuEd;AAUD,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAK1F;AA2CD,+BAA+B;AAC/B,wBAAgB,KAAK,IAAI,MAAM,CAkC9B"}

package/dist/config.js

@@ -18,9 +18,17 @@ import { parseArgs } from "node:util";
  * `core` (`documonster_help`, `doc_inspect`) is always enabled — it is how a
  * model orients itself before doing anything else.
  */
-export const TOOL_GROUPS = ["core", "excel", "word", "pdf", "forms", "archive"];
+export const TOOL_GROUPS = ["core", "excel", "word", "pdf", "forms", "archive", "diagram"];
 /** Groups enabled when `--enable` is omitted. */
-const DEFAULT_GROUPS = ["core", "excel", "word", "pdf", "forms", "archive"];
+const DEFAULT_GROUPS = [
+    "core",
+    "excel",
+    "word",
+    "pdf",
+    "forms",
+    "archive",
+    "diagram"
+];
 /** Default ceiling for a single input document, in bytes (64 MiB). */
 const DEFAULT_MAX_FILE_SIZE = 64 * 1024 * 1024;
 /**

package/dist/config.js.map

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

package/dist/tools/diagram-inspect.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `diagram_inspect` — parse a Mermaid diagram and report what it says, without
+ * writing anything.
+ *
+ * Exists because of an asymmetry the rest of this server does not have: for a
+ * spreadsheet the model can read back the cells it wrote, but a diagram's output
+ * is a picture it cannot look at. So the read-back has to happen on the *input*
+ * side — parse the source, and say which nodes, edges, participants, tasks or
+ * slices the parser actually recognised.
+ *
+ * That matters more than a syntax check. The parser implements a subset of
+ * Mermaid, and a subset fails by silently omitting what it did not understand: a
+ * mistyped arrow produces one fewer edge rather than an error. Counting them is
+ * the only way that is visible.
+ *
+ * Read-only, so it stays available under `--readonly` — where `diagram_render` is
+ * withheld and this is the only diagram capability left.
+ */
+export declare const diagramInspectTool: import("./types.js").AnyToolDefinition;
+//# sourceMappingURL=diagram-inspect.d.ts.map

package/dist/tools/diagram-inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-inspect.d.ts","sourceRoot":"","sources":["../../src/tools/diagram-inspect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,eAAO,MAAM,kBAAkB,wCA2E7B,CAAC"}

package/dist/tools/diagram-inspect.js

@@ -0,0 +1,91 @@
+/**
+ * `diagram_inspect` — parse a Mermaid diagram and report what it says, without
+ * writing anything.
+ *
+ * Exists because of an asymmetry the rest of this server does not have: for a
+ * spreadsheet the model can read back the cells it wrote, but a diagram's output
+ * is a picture it cannot look at. So the read-back has to happen on the *input*
+ * side — parse the source, and say which nodes, edges, participants, tasks or
+ * slices the parser actually recognised.
+ *
+ * That matters more than a syntax check. The parser implements a subset of
+ * Mermaid, and a subset fails by silently omitting what it did not understand: a
+ * mistyped arrow produces one fewer edge rather than an error. Counting them is
+ * the only way that is visible.
+ *
+ * Read-only, so it stays available under `--readonly` — where `diagram_render` is
+ * withheld and this is the only diagram capability left.
+ */
+import { z } from "zod";
+import { buildDrawList, describeDiagram, parseDiagram, resolveDiagramSource, toRenderOptions } from "./diagram.js";
+import { textResult } from "./result.js";
+import { defineTool } from "./types.js";
+export const diagramInspectTool = defineTool({
+    name: "diagram_inspect",
+    group: "diagram",
+    title: "Inspect a Mermaid diagram",
+    description: "Parse Mermaid text and report what it means: diagram type, and every node/edge/participant/task/slice the parser recognised, plus the size it would render at. Writes nothing. Call this to check a diagram before rendering it, or to find out why a rendered diagram is missing something — an unrecognised statement is dropped silently, and its absence here is the only sign.",
+    inputSchema: {
+        source: z
+            .string()
+            .optional()
+            .describe("Mermaid diagram text. Use this or `from`, not both. A ```mermaid wrapper is stripped for you."),
+        from: z
+            .string()
+            .optional()
+            .describe("Inspect a file instead: a .mmd/.mermaid file, or a .md file — in which case every ```mermaid fence is listed and one is described."),
+        index: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Which fence to describe when `from` is a Markdown file with several. 1-based, defaults to 1.")
+    },
+    annotations: { readOnlyHint: true, openWorldHint: false },
+    mutates: false,
+    handler: async (args, context) => {
+        const { config } = context;
+        const resolved = await resolveDiagramSource(config, args);
+        const diagram = parseDiagram(resolved.source);
+        // Laid out at the defaults, because the size is the one fact a caller cannot
+        // work out from the source and it decides whether a diagram is page-shaped.
+        const list = buildDrawList(resolved.source, toRenderOptions({}));
+        const lines = [
+            resolved.origin === "inline"
+                ? "Parsed the diagram you supplied."
+                : `Parsed **${resolved.origin}**.`
+        ];
+        if (resolved.fences.length > 1) {
+            lines.push("", `## ${resolved.fences.length} mermaid fences`, "", "| index | line | type | first line |", "| --- | --- | --- | --- |", ...resolved.fences.map(fence => {
+                const kind = fenceKind(fence.source);
+                const first = fence.source.split("\n")[0]?.trim() ?? "";
+                return `| ${fence.ordinal}${fence.ordinal === resolved.selected ? " ←" : ""} | ${fence.line} | ${kind} | \`${first.slice(0, 40)}\` |`;
+            }), "", `Fence ${resolved.selected} is described below; pass \`index\` to describe another.`);
+        }
+        lines.push("", "## Structure", "", ...describeDiagram(diagram), `- renders at ${round(list.width)}×${round(list.height)} points at the default font and spacing`, "", "Compare that against what you intended before rendering. Anything the parser did", "not recognise is simply absent from the list above — it is not reported as an error.");
+        return textResult(config, lines.join("\n"));
+    }
+});
+/**
+ * Name a fence's diagram type without failing the whole call on a broken one.
+ *
+ * The listing exists to help a caller choose an index, and one malformed fence in
+ * a long document must not stop the other nine from being nameable.
+ */
+function fenceKind(source) {
+    try {
+        return parseDiagram(source).kind;
+    }
+    catch {
+        const first = source
+            .split("\n")
+            .find(line => line.trim().length > 0)
+            ?.trim() ?? "";
+        const named = first.split(/\s+/)[0] ?? "";
+        return named.length === 0 ? "**empty**" : `**unsupported** (${named})`;
+    }
+}
+function round(value) {
+    return Math.round(value * 10) / 10;
+}
+//# sourceMappingURL=diagram-inspect.js.map

package/dist/tools/diagram-inspect.js.map

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

package/dist/tools/diagram-markdown.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Mermaid fences inside Markdown, for `doc_write` and `doc_convert`.
+ *
+ * A ` ```mermaid ` fence carried into a Word document as monospace text is
+ * useless — the whole point of the fence is that it is a picture. So each one is
+ * rendered to a PNG and spliced in as an inline image before the Markdown reaches
+ * the converter.
+ *
+ * The seam is `markdownToDocx`'s `resolveImage` callback: the fence is rewritten
+ * to `![alt](documonster-diagram:N)` and the callback answers that one URL scheme
+ * and nothing else. Rewriting to a *file* path instead would need a writable
+ * scratch directory and would leak the diagrams as loose files beside the
+ * document; going through the callback keeps them in memory and inside the
+ * package.
+ *
+ * The width cap is not cosmetic. A flowchart is routinely wider than a page's text
+ * column, and Word does not shrink an oversized inline image — it runs off the
+ * edge of the paper. Fitting to the text width is the difference between a
+ * document and a broken one.
+ */
+import type { MarkdownImportOptions } from "documonster/word/markdown";
+import { type DiagramStyleArgs } from "./diagram.js";
+export interface PreparedMarkdown {
+    /** The Markdown with every mermaid fence replaced by an image reference. */
+    readonly markdown: string;
+    /**
+     * Pass as `markdownToDocx`'s `resolveImage`. Present only when at least one
+     * fence was rendered, so the no-diagram path behaves exactly as before.
+     */
+    readonly resolveImage?: MarkdownImportOptions["resolveImage"];
+    /** How many diagrams were rendered. */
+    readonly count: number;
+    /** Lines worth reporting to the caller. */
+    readonly notes: readonly string[];
+}
+/**
+ * Render every mermaid fence in `markdown` and rewrite it as an inline image.
+ *
+ * A fence that does not parse is left exactly as it was — a code block — and
+ * reported. Failing the whole document because one diagram is malformed would
+ * throw away the nine paragraphs that were fine, and the note names the line to
+ * fix.
+ */
+export declare function prepareMarkdownDiagrams(markdown: string, style?: DiagramStyleArgs): Promise<PreparedMarkdown>;
+//# sourceMappingURL=diagram-markdown.d.ts.map

package/dist/tools/diagram-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-markdown.d.ts","sourceRoot":"","sources":["../../src/tools/diagram-markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAqB,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG1F,OAAO,EAOL,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAwBtB,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAC;IAC9D,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,gBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CA2E3B"}