@documonster/mcp 0.10.0 → 0.11.0

package/dist/tools/template.js

@@ -16,11 +16,21 @@
 import path from "node:path";
 import { Io, Template } from "documonster/word";
 import { z } from "zod";
-import { toolError } from "../errors.js";
+import { McpToolError, toolError } from "../errors.js";
 import { assertWritable, outputDisplay, resolveInRoot, resolveOutputPath } from "../sandbox.js";
+import { summariseDiagram } from "./diagram.js";
 import { assertReadableSize, writeWithPolicy } from "./fs-helpers.js";
+import { imageSourceShape, newImageBudget, resolveImageSource, toEmu } from "./image.js";
 import { textResult } from "./result.js";
 import { defineTool } from "./types.js";
+/**
+ * Widest an image may be inside a template, in points.
+ *
+ * US Letter less one-inch margins. A template author's page may differ, but Word
+ * does not shrink an oversized inline image — it runs it off the paper — so a cap
+ * that is occasionally conservative beats one that is occasionally broken.
+ */
+const MAX_TEMPLATE_IMAGE_WIDTH = 468;
 /** Tags listed in one call. */
 const MAX_TAGS = 200;
 export const templateInspectTool = defineTool({
@@ -52,6 +62,7 @@ export const templateInspectTool = defineTool({
         const variables = tags.filter(tag => tag.type === "variable");
         const loops = tags.filter(tag => tag.type === "eachOpen");
         const conditionals = tags.filter(tag => tag.type === "ifOpen");
+        const imageTags = tags.filter(tag => tag.type === "image");
         const lines = [
             `# ${args.path} — template placeholders`,
             "",
@@ -59,6 +70,7 @@ export const templateInspectTool = defineTool({
             `- variables: ${variables.length}`,
             `- loops: ${loops.length}`,
             `- conditionals: ${conditionals.length}`,
+            ...(imageTags.length === 0 ? [] : [`- image placeholders: ${imageTags.length}`]),
             "",
             "| tag | kind | location |",
             "| --- | --- | --- |",
@@ -73,6 +85,18 @@ export const templateInspectTool = defineTool({
         // onto the JSON template_fill wants, so the model can build it in one step.
         lines.push("", "## Data shape", "", "```json", buildShape(tags), "```");
         lines.push("", "Loop variables written `.name` refer to a property of the current item.", "Pass this structure as `data` to template_fill.");
+        if (imageTags.length > 0) {
+            // These do NOT belong in `data`: a picture cannot travel through JSON, so
+            // they take a separate argument naming a file or a diagram. Listing them
+            // under the data shape — which is what this tool used to do by omitting
+            // them entirely — sends the model to fill them with a string.
+            lines.push("", "## Image placeholders", "", ...imageTags.map(tag => {
+                const blocker = imageBlocker(tag);
+                return blocker === undefined
+                    ? `- \`{{${tag.expression}}}\` → \`images.${imageKey(tag)}\` (${tag.location})`
+                    : `- \`{{${tag.expression}}}\` (${tag.location}) — **cannot be filled**: ${blocker}.`;
+            }), "", "Pass the fillable ones in `images`, **not** in `data` — a picture cannot go through", 'JSON. Each takes a file (`from: "logo.png"`) or a Mermaid diagram', '(`source: "flowchart LR…"`), e.g. `images: { logo: { from: "logo.png" } }`.');
+        }
         return textResult(config, lines.join("\n"));
     }
 });
@@ -80,7 +104,7 @@ export const templateFillTool = defineTool({
     name: "template_fill",
     group: "word",
     title: "Fill a Word template",
-    description: "Fill a .docx template's placeholders from JSON and save the result. Supports variables with dotted paths, {{#each}} loops (including table rows) and {{#if}} conditionals. Call template_inspect first to learn the exact field names. The template's own styling is preserved — you supply only data.",
+    description: "Fill a .docx template's placeholders from JSON and save the result. Supports variables with dotted paths, {{#each}} loops (including table rows), {{#if}} conditionals, and {{%name}} image placeholders filled from the `images` argument (a file or a Mermaid diagram). Call template_inspect first to learn the exact field names. The template's own styling is preserved — you supply only data.",
     inputSchema: {
         template: z.string().min(1).describe("Template path (.docx), relative to the server root."),
         out: z
@@ -90,6 +114,10 @@ export const templateFillTool = defineTool({
         data: z
             .record(z.string(), z.unknown())
             .describe('Values keyed by placeholder name, e.g. { "client": { "name": "Acme" }, "items": [{ "name": "X", "amount": 10 }], "overdue": true }.'),
+        images: z
+            .record(z.string(), z.object(imageSourceShape))
+            .optional()
+            .describe('Pictures for the template\'s `{{%name}}` placeholders, keyed without the %. Each takes a .png/.jpg/.gif file or a Mermaid diagram, e.g. { "logo": { "from": "logo.png" }, "flow": { "source": "flowchart LR\\n A --> B" } }. Images go here rather than in `data` because a picture cannot travel through JSON.'),
         allowMissing: z
             .boolean()
             .optional()
@@ -115,34 +143,68 @@ export const templateFillTool = defineTool({
         if (path.extname(args.out).toLowerCase() !== ".docx") {
             throw toolError.invalidInput(`template_fill writes .docx, not ${JSON.stringify(path.extname(args.out))}`, "Fill to a .docx, then use doc_convert if you need a PDF.");
         }
-        // Read fresh: fillTemplate mutates the document in place (verified), so a
-        // cached or reused instance would be filled twice.
+        // Read fresh: a fill may mutate the document in place, so a cached or reused
+        // instance would be filled twice.
         const doc = await readTemplate(templatePath, args.template);
         const before = Template.listTemplateTags(doc);
         if (before.length === 0) {
             throw toolError.invalidInput(`${args.template} contains no placeholders`, "Run template_inspect to confirm; this may not be a template at all.");
         }
+        // Resolved before the fill, so an unreadable picture fails without having
+        // half-filled the document. Names are checked against the template's own tags,
+        // and the media names against what the template already carries.
+        const images = await resolveTemplateImages(config, args.images);
+        assertImagePlaceholdersExist(before, [...images.keys()]);
+        const media = assignMediaNames(images, doc);
+        // Merged *before* the try, so a name collision is reported as itself rather
+        // than being caught below and re-labelled "filling the template failed" with
+        // the wrong hint attached.
+        const templateData = mergeTemplateData(args.data, images, media);
+        // Typed explicitly: a bare `let` is implicitly `any`, which would silently
+        // erase the tag types read off the result below.
+        let filled;
         try {
             // strict is the engine's default and the right one here: it names the
             // first unresolved placeholder and produces no file, rather than saving a
             // document with a blank where a client's name should be.
-            Template.fillTemplate(doc, args.data, { strict: args.allowMissing !== true });
+            //
+            // `fillTemplateEnhanced` rather than `fillTemplate`: it is the same engine
+            // plus a pass that understands `{{%image}}`, so this is a superset of the
+            // previous behaviour. With the basic fill an image placeholder could only
+            // ever end up unresolved, which is why the tool could not fill one at all.
+            //
+            // **Use the return value.** Unlike `fillTemplate`, the enhanced form is not
+            // in-place: substituting an image replaces the whole paragraph, so it builds
+            // a new body and deliberately leaves the caller's document untouched — it
+            // even clones the headers to stop edits leaking back. Ignoring the result
+            // writes the *unfilled* template out, and because the fill itself succeeded
+            // nothing reports a failure.
+            filled = Template.fillTemplateEnhanced(doc, templateData, {
+                strict: args.allowMissing !== true
+            });
         }
         catch (cause) {
             const message = cause instanceof Error ? cause.message : String(cause);
-            throw toolError.invalidInput(`filling the template failed: ${message}`, /unresolved/i.test(message)
-                ? "The message names the placeholder that had no data. Add it to `data` — template_inspect lists every field the template needs — or pass allowMissing: true if it is genuinely optional. No file was written."
-                : "Check that every loop name in the template maps to an array in `data`. No file was written.", { cause });
+            throw toolError.invalidInput(`filling the template failed: ${message}`, unresolvedHint(message, before), { cause });
         }
-        const remaining = Template.listTemplateTags(doc);
-        await writeWithPolicy(target, args.overwrite === true, temporary => Io.writeFile(doc, temporary));
+        // Prune before writing: the engine registers a picture's bytes when it
+        // substitutes the placeholder, and a paragraph removed afterwards by a false
+        // {{#if}} leaves those bytes in the package with nothing pointing at them.
+        const dropped = pruneUnreferencedMedia(filled, media);
+        await writeWithPolicy(target, args.overwrite === true, temporary => Io.writeFile(filled, temporary));
+        // Verified against the file on disk, not against the in-memory document the
+        // writer was handed: a media part that failed to serialise, or a run pointing
+        // at a relationship that does not exist, is invisible until it is read back.
+        const verified = await verifyWrittenImages(target, media);
+        const remaining = Template.listTemplateTags(filled);
         const lines = [
             `Filled **${args.template}** → **${outputDisplay(args.out)}**`,
             `- placeholders in template: ${before.length}`,
             `- placeholders remaining: ${remaining.length}`,
             ...(args.allowMissing === true
                 ? ["- `allowMissing` was set, so any field absent from `data` rendered as empty"]
-                : [])
+                : []),
+            ...describeFilledImages(images, media, dropped, verified)
         ];
         if (remaining.length > 0) {
             // Left-over tags mean a key was missing — the document still saved, but
@@ -156,6 +218,369 @@ export const templateFillTool = defineTool({
         return textResult(config, lines.join("\n"));
     }
 });
+/**
+ * Read every image the caller supplied, keyed by its placeholder name.
+ *
+ * @throws {McpToolError} from `resolveImageSource` for a missing file, an
+ *   unsupported extension or a header that will not parse.
+ */
+async function resolveTemplateImages(config, images) {
+    const resolved = new Map();
+    const budget = newImageBudget();
+    for (const [name, spec] of Object.entries(images ?? {})) {
+        resolved.set(name, await resolveImageSource(config, spec, {
+            maxWidthPoints: MAX_TEMPLATE_IMAGE_WIDTH,
+            budget
+        }));
+    }
+    return resolved;
+}
+/**
+ * Advice for a failed fill, chosen by *what kind* of placeholder was unresolved.
+ *
+ * The generic "add it to `data`" is actively wrong for an image tag — the caller may
+ * have already put it in `images` and be told to move it to the one place it cannot
+ * go. For a placeholder the engine cannot reach at all it is wrong twice, because no
+ * argument fills that one. An error that sends the model somewhere useless costs a
+ * retry loop, so the branch is worth having.
+ */
+function unresolvedHint(message, tags) {
+    if (!/unresolved/i.test(message)) {
+        return "Check that every loop name in the template maps to an array in `data`. No file was written.";
+    }
+    const named = tags.find(tag => tag.type === "image" && message.includes(`{{${tag.expression}}}`));
+    if (named !== undefined) {
+        const blocker = imageBlocker(named);
+        return blocker === undefined
+            ? `\`{{${named.expression}}}\` is an **image** placeholder — pass it in \`images\` (keyed \`${imageKey(named)}\`, without the %), not in \`data\`. A picture cannot travel through JSON. No file was written.`
+            : `\`{{${named.expression}}}\` is an image placeholder that nothing can fill: ${blocker}. It needs moving to a paragraph of its own in the document body. No file was written.`;
+    }
+    return "The message names the placeholder that had no data. Add it to `data` — template_inspect lists every field the template needs — or pass allowMissing: true if it is genuinely optional. No file was written.";
+}
+/** An image tag's `images` key — the expression without its `%` marker. */
+function imageKey(tag) {
+    return tag.expression.replace(/^%/, "");
+}
+/**
+ * Why an image placeholder cannot be filled, or `undefined` when it can.
+ *
+ * One case is left, and it is architectural rather than an omission: the engine
+ * substitutes images in a pass that runs *before* loops are expanded, so a
+ * `{{%.photo}}` inside a `{{#each}}` has no current item to read from. One picture
+ * per row would need the substitution to happen during expansion, which is a
+ * different arrangement of the two passes rather than a missing branch.
+ *
+ * Table cells and headers/footers used to be here too. Both were fixed in the engine
+ * instead — a logo in a header or a letterhead table is what a template author
+ * reaches for first, and refusing the commonest layouts was the wrong answer to
+ * "the pass does not go there".
+ */
+function imageBlocker(tag) {
+    if (imageKey(tag).startsWith(".")) {
+        return "it is scoped to a {{#each}} item, and images are substituted before loops are expanded — one picture per row is not expressible";
+    }
+    return undefined;
+}
+/**
+ * Refuse an `images` key the template cannot use, naming which and why.
+ *
+ * Two kinds of mistake, and silence would be expensive for both. A **misspelled
+ * key** leaves the document saved and looking fine with the picture simply absent
+ * behind a plausible success message, so the error lists the placeholders that do
+ * exist. An **unfillable placeholder** is worse, because the caller did everything
+ * right and the limitation is the engine's: without this the failure arrives two
+ * passes deeper as "Unresolved variable", advising the model to move the image into
+ * `data` — the one place it can never go.
+ */
+export function assertImagePlaceholdersExist(tags, imageKeys) {
+    if (imageKeys.length === 0) {
+        return;
+    }
+    const imageTags = tags.filter(tag => tag.type === "image");
+    const available = imageTags.map(imageKey);
+    const unknown = imageKeys.filter(name => !available.includes(name));
+    if (unknown.length > 0) {
+        throw toolError.invalidInput(`the template has no image placeholder for ${unknown.map(name => JSON.stringify(name)).join(", ")}`, available.length === 0
+            ? "This template contains no `{{%name}}` image placeholder at all. Run template_inspect to see what it does have; an ordinary `{{name}}` cannot hold a picture."
+            : `Available image placeholders: ${available.map(name => `{{%${name}}}`).join(", ")}. Key \`images\` without the %.`);
+    }
+    const blocked = imageTags
+        .filter(tag => imageKeys.includes(imageKey(tag)))
+        .map(tag => ({ tag, reason: imageBlocker(tag) }))
+        .filter((entry) => entry.reason !== undefined);
+    if (blocked.length > 0) {
+        throw toolError.unsupported(`image placeholder(s) ${blocked.map(entry => `{{${entry.tag.expression}}}`).join(", ")} cannot be filled`, `${blocked
+            .map(entry => `{{${entry.tag.expression}}} (${entry.tag.location}): ${entry.reason}`)
+            .join(". ")}. Move the placeholder to a paragraph of its own in the document body, or have the template author place the picture directly — it does not need to be a placeholder to be there. No file was written.`);
+    }
+}
+/**
+ * Give every supplied picture a media name nothing else in the package uses.
+ *
+ * Derived from the placeholder key, which is unique by construction, rather than
+ * from the source file or the diagram kind, which are not.
+ */
+function assignMediaNames(images, template) {
+    const takenFiles = new Set((template.images ?? []).map(entry => entry.fileName));
+    const takenIds = new Set((template.images ?? []).map(entry => entry.rId).filter((id) => id !== undefined));
+    const assigned = new Map();
+    for (const [name, image] of images) {
+        const stem = `mcpimg-${name.replace(/[^A-Za-z0-9._-]+/g, "_")}`;
+        const fileName = firstFree(`${stem}.${image.mediaType}`, candidate => takenFiles.has(candidate));
+        takenFiles.add(fileName);
+        const rId = firstFree(`rId_${stem}`, candidate => takenIds.has(candidate));
+        takenIds.add(rId);
+        assigned.set(name, { fileName, rId });
+    }
+    return assigned;
+}
+/** `name`, or `name-2`, `name-3`… until one is free. */
+function firstFree(preferred, taken) {
+    if (!taken(preferred)) {
+        return preferred;
+    }
+    const dot = preferred.lastIndexOf(".");
+    const stem = dot === -1 ? preferred : preferred.slice(0, dot);
+    const extension = dot === -1 ? "" : preferred.slice(dot);
+    for (let index = 2; index < 1000; index += 1) {
+        const candidate = `${stem}-${index}${extension}`;
+        if (!taken(candidate)) {
+            return candidate;
+        }
+    }
+    throw toolError.invalidInput(`could not find a free media name for ${preferred}`);
+}
+/**
+ * Merge the pictures into the template data without colliding with it.
+ *
+ * The engine reads an image from the same namespace as everything else — `{{%logo}}`
+ * looks up `logo` — so the values have to be merged in. Two consequences, both of
+ * which were wrong before:
+ *
+ * 1. **A dotted key is a path, not a name.** `{{%client.logo}}` resolves `client`
+ *    then `logo`, so a flat `data["client.logo"]` is never found. The value is
+ *    assigned down the path instead.
+ * 2. **A collision must be refused, not silently won.** With `{{logo}}` and
+ *    `{{%logo}}` in one template, a flat spread overwrote the text value with the
+ *    image object — and the plain placeholder rendered the whole `TemplateImage` as
+ *    JSON, pixel bytes included, into the document. Nine hundred characters of
+ *    `{"0":137,"1":80,…}` where a client's name belonged.
+ */
+function mergeTemplateData(data, images, media) {
+    // Cloned so the caller's arguments are never mutated; the fill is retried by
+    // nothing today, but a mutated `data` would be a trap for whoever adds a retry.
+    const merged = structuredCloneSafe(data);
+    for (const [name, value] of imageValues(images, media)) {
+        const existing = readPath(merged, name);
+        if (existing !== undefined) {
+            throw toolError.invalidInput(`\`images.${name}\` collides with \`data.${name}\``, `The template engine reads images from the same namespace as text, so one name cannot be both. Remove ${JSON.stringify(name)} from \`data\`, or rename the image placeholder. No file was written.`);
+        }
+        assignPath(merged, name, value);
+    }
+    return merged;
+}
+/** The `TemplateImage` values, keyed by placeholder path. */
+function imageValues(images, media) {
+    const values = new Map();
+    for (const [name, entry] of media) {
+        const image = images.get(name);
+        if (image === undefined) {
+            continue;
+        }
+        values.set(name, {
+            image: {
+                data: image.bytes,
+                mediaType: image.mediaType,
+                fileName: entry.fileName,
+                rId: entry.rId
+            },
+            // EMU, which is the only unit the engine accepts here.
+            width: toEmu(image.width),
+            height: toEmu(image.height),
+            altText: image.altText
+        });
+    }
+    return values;
+}
+/** Read a dotted path, or `undefined` when any step is absent. */
+function readPath(target, dotted) {
+    let cursor = target;
+    for (const part of dotted.split(".").filter(step => step.length > 0)) {
+        if (typeof cursor !== "object" || cursor === null) {
+            return undefined;
+        }
+        cursor = cursor[part];
+    }
+    return cursor;
+}
+/** A shallow-safe clone of the caller's data, preserving arrays and plain objects. */
+function structuredCloneSafe(data) {
+    const clone = {};
+    for (const [key, value] of Object.entries(data)) {
+        clone[key] =
+            typeof value === "object" && value !== null && !Array.isArray(value)
+                ? structuredCloneSafe(value)
+                : value;
+    }
+    return clone;
+}
+/**
+ * Remove media the finished document does not reference, and say which.
+ *
+ * Images are substituted *before* conditionals are evaluated, so a `{{%logo}}`
+ * inside a `{{#if}}` that turns out false is registered and then removed along with
+ * its paragraph. Reporting that is not enough: the bytes stay in the package, and
+ * anyone who unzips the `.docx` can recover a picture the document was supposed to
+ * withhold. For a signature or an ID photo behind a conditional that is a data leak,
+ * not file bloat — so the part is dropped rather than merely mentioned.
+ *
+ * Only pictures this tool added are considered. The template author's own media may
+ * be referenced from parts this walk does not cover, and deleting one because it was
+ * not found would be a far worse bug than leaving it.
+ */
+function pruneUnreferencedMedia(filled, media) {
+    const referenced = collectDocumentImageRefs(filled);
+    const dropped = [];
+    const ours = new Set();
+    for (const [name, entry] of media) {
+        if (!referenced.has(entry.rId)) {
+            dropped.push(name);
+            ours.add(entry.rId);
+        }
+    }
+    if (ours.size > 0) {
+        // Reassigned rather than mutated in place: `images` is a readonly array on the
+        // document type, and the writer reads whatever is on the object.
+        filled.images = (filled.images ?? []).filter(entry => entry.rId === undefined || !ours.has(entry.rId));
+    }
+    return dropped;
+}
+/**
+ * Every inline-image relationship the whole document references.
+ *
+ * Not just the body. Once the engine learned to substitute images in headers and
+ * footers, a body-only walk reported a header logo as unreferenced — and the pruning
+ * below then deleted the picture it had just correctly placed. A check that only
+ * looks where it used to be correct is worse than no check, because it destroys
+ * output while reporting a problem that does not exist.
+ */
+function collectDocumentImageRefs(doc) {
+    const referenced = new Set();
+    collectImageRefs(doc.body, referenced);
+    for (const part of [...(doc.headers?.values() ?? []), ...(doc.footers?.values() ?? [])]) {
+        collectImageRefs(part.content.children, referenced);
+    }
+    for (const note of [...(doc.footnotes ?? []), ...(doc.endnotes ?? [])]) {
+        collectImageRefs(note.content, referenced);
+    }
+    return referenced;
+}
+/**
+ * Every media file name the whole document references.
+ *
+ * Names rather than relationship ids, because a relationship is **per part**: an
+ * image referenced from a header has an rId in that header's own space, so `rId5` in
+ * `word/_rels/document.xml.rels` and `rId_x` in `word/_rels/header1.xml.rels` are
+ * unrelated numbers that happen to look comparable. Matching them across parts
+ * reported a correctly placed header logo as unverifiable. The engine writes each
+ * image run's `name` as its media file name, and those *are* global.
+ */
+function collectDocumentImageNames(doc) {
+    const names = new Set();
+    const walk = (blocks) => collectImageRefs(blocks, names, "name");
+    walk(doc.body);
+    for (const part of [...(doc.headers?.values() ?? []), ...(doc.footers?.values() ?? [])]) {
+        walk(part.content.children);
+    }
+    for (const note of [...(doc.footnotes ?? []), ...(doc.endnotes ?? [])]) {
+        walk(note.content);
+    }
+    return names;
+}
+/** Gather every inline-image relationship id, or file name, reachable in a block list. */
+function collectImageRefs(blocks, into, key = "rId") {
+    for (const block of blocks) {
+        if (block.type === "table") {
+            for (const row of block.rows) {
+                for (const cell of row.cells) {
+                    // A cell holds paragraphs and further tables, so the walk recurses.
+                    collectImageRefs(cell.content, into, key);
+                }
+            }
+            continue;
+        }
+        if (!("children" in block)) {
+            continue;
+        }
+        for (const run of block.children) {
+            if (!("content" in run)) {
+                continue;
+            }
+            for (const entry of run.content) {
+                if (entry.type === "image") {
+                    const value = key === "rId" ? entry.rId : entry.name;
+                    if (value !== undefined) {
+                        into.add(value);
+                    }
+                }
+            }
+        }
+    }
+}
+/**
+ * Re-open the written file and confirm each picture really arrived.
+ *
+ * The in-memory document is what the writer was *handed*, not what it produced. A
+ * relationship that failed to serialise, or a run pointing at a part that is not
+ * there, looks perfect from the document object and is broken in the file — and the
+ * file is the only artefact anyone else will open. Since nothing downstream can look
+ * at a picture, this is the last place a false claim can be caught.
+ *
+ * @returns The placeholder names whose picture is present and resolvable on disk.
+ */
+async function verifyWrittenImages(target, media) {
+    if (media.size === 0) {
+        return new Set();
+    }
+    const reopened = await Io.readFile(target).catch((cause) => {
+        throw new McpToolError("internal", `the document was written but could not be re-opened for verification: ${cause instanceof Error ? cause.message : String(cause)}`, {
+            hint: "The file exists but may be malformed. Read it with doc_read before relying on it.",
+            cause
+        });
+    });
+    // Re-reading renumbers relationships, so a picture is matched by its media file
+    // name — which `assignMediaNames` made unique for exactly this purpose.
+    const byFileName = new Map((reopened.images ?? []).map(entry => [entry.fileName, entry]));
+    const referenced = collectDocumentImageNames(reopened);
+    const present = new Set();
+    for (const [name, entry] of media) {
+        const definition = byFileName.get(entry.fileName);
+        // Both halves are needed: bytes in the package that nothing points at are dead
+        // weight, and a run pointing at a part that is not there is a broken picture.
+        if (definition !== undefined && definition.data.length > 0 && referenced.has(entry.fileName)) {
+            present.add(name);
+        }
+    }
+    return present;
+}
+/** Report each picture: where it came from, and whether it is really in the file. */
+function describeFilledImages(images, media, dropped, verified) {
+    const lines = [...images].map(([name, image]) => {
+        const drawn = image.diagram === undefined ? "" : ` — ${summariseDiagram(image.diagram)}`;
+        const size = `${Math.round(image.width)}×${Math.round(image.height)} pt`;
+        if (dropped.includes(name)) {
+            return `- \`{{%${name}}}\` ← ${image.origin} — **not in the output**: its paragraph was removed, most likely by a {{#if}} whose condition was false. Its bytes were dropped from the package too, so nothing is recoverable from the file.`;
+        }
+        const state = verified.has(name)
+            ? ""
+            : " — **could not be verified in the written file**; read it with doc_read before relying on it";
+        return `- \`{{%${name}}}\` ← ${image.origin} (${size}, \`${media.get(name)?.fileName ?? "?"}\`)${drawn}${state}`;
+    });
+    if (dropped.length > 0) {
+        lines.push(`- **${dropped.length} supplied picture(s) are not in the document.** Images are substituted before conditionals are evaluated, so one inside a false {{#if}} is dropped with its block. Do not report it as added.`);
+    }
+    return lines;
+}
 /** Build an example JSON shape from the tag list. */
 function buildShape(tags) {
     const shape = {};

package/dist/tools/template.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@documonster/mcp",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Model Context Protocol server for documonster — lets AI assistants read, write and convert Excel, Word, PDF, CSV and ZIP documents.",
   "keywords": [
     "ai",
@@ -50,7 +50,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.4.3",
-    "documonster": "0.10.0"
+    "documonster": "0.11.0"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
@@ -59,7 +59,7 @@
     "vitest": "^4.1.10"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.13.0"
   },
   "scripts": {
     "build": "rimraf dist && tsc --project tsconfig.build.json",