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

package/dist/tools/chart.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Chart and data-source helpers shared by the spreadsheet write tools.
+ *
+ * The chart schema exposed to a model is deliberately much smaller than the
+ * library's. Two reasons:
+ *
+ * 1. **Reference construction is where a model fails.** A series wants
+ *    `'My Sheet'!$B$2:$B$4`; asked for that, a model produces `B2:B4`,
+ *    `Sheet1!B2:B4`, or a quoted name it forgot to escape. So the tool takes
+ *    plain `A2:A4` ranges and builds the qualified form itself.
+ * 2. **Schema is context.** `AddChartOptions` has scores of fields —
+ *    trendlines, error bars, 3-D scenes, manual layout. Exposing them would
+ *    cost thousands of tokens on every request to serve a rare case. What
+ *    actually changes whether a report is useful is type, data, title, legend.
+ */
+import { z } from "zod";
+import { type SheetHandle } from "./spreadsheet.js";
+/** Chart kinds worth offering. Deliberately not all 24 the library supports. */
+export declare const CHART_TYPES: readonly ["column", "bar", "line", "area", "pie", "doughnut", "scatter", "radar"];
+export declare const chartSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        area: "area";
+        bar: "bar";
+        column: "column";
+        doughnut: "doughnut";
+        line: "line";
+        pie: "pie";
+        radar: "radar";
+        scatter: "scatter";
+    }>;
+    title: z.ZodOptional<z.ZodString>;
+    categories: z.ZodString;
+    values: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    seriesNames: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    anchor: z.ZodOptional<z.ZodString>;
+    legend: z.ZodOptional<z.ZodEnum<{
+        bottom: "bottom";
+        left: "left";
+        none: "none";
+        right: "right";
+        top: "top";
+    }>>;
+}, z.core.$strip>;
+export type ChartSpec = z.infer<typeof chartSchema>;
+/**
+ * Add one chart to a worksheet.
+ *
+ * @returns A human description of what was added.
+ */
+export declare function addChart(ws: SheetHandle, spec: ChartSpec): string;
+/**
+ * Synthetic-data generation.
+ *
+ * A genuinely high-leverage capability: a few dozen tokens of column definitions
+ * produce megabytes of plausible rows. A model asked for 5 000 test rows would
+ * otherwise have to emit them itself, which is both ruinously expensive and
+ * worse data.
+ */
+export declare const generateSchema: z.ZodObject<{
+    rows: z.ZodNumber;
+    columns: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            bool: "bool";
+            date: "date";
+            datetime: "datetime";
+            email: "email";
+            firstName: "firstName";
+            float: "float";
+            hex: "hex";
+            index: "index";
+            int: "int";
+            ip: "ip";
+            lastName: "lastName";
+            name: "name";
+            phone: "phone";
+            sentence: "sentence";
+            string: "string";
+            url: "url";
+            uuid: "uuid";
+            word: "word";
+        }>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        length: z.ZodOptional<z.ZodNumber>;
+        values: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        nullable: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type GenerateSpec = z.infer<typeof generateSchema>;
+/** Generate rows and write them into a worksheet, header included. */
+export declare function writeGenerated(ws: SheetHandle, spec: GenerateSpec): string;
+//# sourceMappingURL=chart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../src/tools/chart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAE1B,gFAAgF;AAChF,eAAO,MAAM,WAAW,YACtB,QAAQ,EACR,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,UAAU,EACV,SAAS,EACT,OAAO,CACC,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;iBA2BtB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAoFjE;AAwED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqDzB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE1D,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAwB1E"}

package/dist/tools/chart.js

@@ -0,0 +1,263 @@
+/**
+ * Chart and data-source helpers shared by the spreadsheet write tools.
+ *
+ * The chart schema exposed to a model is deliberately much smaller than the
+ * library's. Two reasons:
+ *
+ * 1. **Reference construction is where a model fails.** A series wants
+ *    `'My Sheet'!$B$2:$B$4`; asked for that, a model produces `B2:B4`,
+ *    `Sheet1!B2:B4`, or a quoted name it forgot to escape. So the tool takes
+ *    plain `A2:A4` ranges and builds the qualified form itself.
+ * 2. **Schema is context.** `AddChartOptions` has scores of fields —
+ *    trendlines, error bars, 3-D scenes, manual layout. Exposing them would
+ *    cost thousands of tokens on every request to serve a rare case. What
+ *    actually changes whether a report is useful is type, data, title, legend.
+ */
+import { Csv } from "documonster/csv";
+import { Address, Chart, Worksheet } from "documonster/excel";
+import { z } from "zod";
+import { toolError } from "../errors.js";
+import { MAX_EXCEL_COLUMNS, MAX_EXCEL_ROWS, parseRange, sheetName } from "./spreadsheet.js";
+/** Chart kinds worth offering. Deliberately not all 24 the library supports. */
+export const CHART_TYPES = [
+    "column",
+    "bar",
+    "line",
+    "area",
+    "pie",
+    "doughnut",
+    "scatter",
+    "radar"
+];
+export const chartSchema = z.object({
+    type: z.enum(CHART_TYPES).describe("Chart kind."),
+    title: z.string().optional().describe("Chart title."),
+    categories: z
+        .string()
+        .describe('Range holding the axis labels, e.g. "A2:A13". Plain A1 notation — no sheet name. For a scatter chart this is the numeric X range instead of labels.'),
+    values: z
+        .union([z.string(), z.array(z.string()).min(1)])
+        .describe('Range(s) holding the numbers, e.g. "B2:B13" or ["B2:B13","C2:C13"] for two series.'),
+    seriesNames: z
+        .array(z.string())
+        .optional()
+        .describe('Header cell for each series, e.g. ["B1","C1"], so the legend reads properly.'),
+    anchor: z
+        .string()
+        .optional()
+        .describe('Where to place it, as a range, e.g. "E2:L20". Defaults to a block right of the data.'),
+    legend: z
+        .enum(["right", "bottom", "top", "left", "none"])
+        .optional()
+        .describe("Legend position. Defaults to right when there is more than one series, otherwise none.")
+});
+/**
+ * Add one chart to a worksheet.
+ *
+ * @returns A human description of what was added.
+ */
+export function addChart(ws, spec) {
+    const name = sheetName(ws);
+    const valueRanges = typeof spec.values === "string" ? [spec.values] : spec.values;
+    if (spec.seriesNames !== undefined && spec.seriesNames.length !== valueRanges.length) {
+        throw toolError.invalidInput(`seriesNames has ${spec.seriesNames.length} entr(y/ies) but there are ${valueRanges.length} value range(s)`, "Give one name cell per series, or omit seriesNames entirely.");
+    }
+    const axis = qualify(name, spec.categories, "categories");
+    const axisCount = rangeLength(spec.categories);
+    const series = valueRanges.map((range, index) => {
+        if (rangeLength(range) !== axisCount) {
+            throw toolError.invalidInput(`values range ${JSON.stringify(range)} has ${rangeLength(range)} cells but categories has ${axisCount}`, "Every series and the category/X range must cover the same number of cells.");
+        }
+        const nameCell = spec.seriesNames?.[index];
+        return {
+            // `{ formula }`, not a bare string: the chart API treats a string as the
+            // literal legend text, so passing the reference would put
+            // `'Sales'!$B$1` in the legend instead of the header cell's value.
+            ...(nameCell === undefined
+                ? {}
+                : { name: { formula: qualify(name, nameCell, "seriesNames") } }),
+            values: qualify(name, range, "values"),
+            // A scatter series plots numbers against numbers, so the same range is
+            // its X values rather than category labels. The engine rejects
+            // `categories` there, so the distinction cannot be papered over.
+            ...(spec.type === "scatter" ? { xValues: axis } : { categories: axis })
+        };
+    });
+    const anchor = spec.anchor ?? defaultAnchor(ws, valueRanges.length);
+    const legend = spec.legend ?? (series.length > 1 ? "right" : "none");
+    const options = {
+        ...(spec.title === undefined ? {} : { title: spec.title }),
+        series,
+        // The API takes `showLegend` + `legendPosition`. A `legend: { position }`
+        // object is silently ignored, so "none" would still render a legend and a
+        // requested position would fall back to the default.
+        showLegend: legend !== "none",
+        ...(legend === "none" ? {} : { legendPosition: legendCode(legend) })
+    };
+    try {
+        switch (spec.type) {
+            case "column":
+                Chart.addColumn(ws, options, anchor);
+                break;
+            case "bar":
+                Chart.addBar(ws, options, anchor);
+                break;
+            case "line":
+                Chart.addLine(ws, options, anchor);
+                break;
+            case "area":
+                Chart.addArea(ws, options, anchor);
+                break;
+            case "pie":
+                Chart.addPie(ws, options, anchor);
+                break;
+            case "doughnut":
+                Chart.addDoughnut(ws, options, anchor);
+                break;
+            case "scatter":
+                Chart.addScatter(ws, options, anchor);
+                break;
+            case "radar":
+                Chart.addRadar(ws, options, anchor);
+                break;
+        }
+    }
+    catch (cause) {
+        throw toolError.invalidInput(`could not add the ${spec.type} chart: ${cause instanceof Error ? cause.message : String(cause)}`, "Check that `categories` and each `values` range cover the same number of cells.", { cause });
+    }
+    return `added a ${spec.type} chart${spec.title === undefined ? "" : ` titled ${JSON.stringify(spec.title)}`} with ${series.length} series at ${anchor}`;
+}
+/**
+ * Turn `B2:B13` into `'Sheet name'!$B$2:$B$13`.
+ *
+ * Quoting and absolute markers are added here rather than asked of the model,
+ * because a wrong reference produces a chart that renders empty — which looks
+ * like a library failure rather than a bad argument.
+ */
+function qualify(sheet, range, field) {
+    const trimmed = range.trim().toUpperCase().replace(/\$/g, "");
+    if (!/^[A-Z]{1,3}[1-9][0-9]*(?::[A-Z]{1,3}[1-9][0-9]*)?$/.test(trimmed)) {
+        throw toolError.invalidInput(`${field} value ${JSON.stringify(range)} is not a plain A1 range`, 'Use A1 notation without a sheet name, e.g. "B2:B13".');
+    }
+    // Validates Excel's row/column limits and rejects a backwards rectangle.
+    parseRange(trimmed);
+    const absolute = trimmed
+        .split(":")
+        .map(part => part.replace(/^([A-Z]+)([0-9]+)$/, "$$$1$$$2"))
+        .join(":");
+    return `${Address.quoteSheetName(sheet)}!${absolute}`;
+}
+/** Place a chart clear of the data when the caller does not choose. */
+function defaultAnchor(ws, seriesCount) {
+    const dimensions = Worksheet.dimensions(ws);
+    const height = Math.max(15, seriesCount * 6);
+    const roomOnRight = dimensions.right + 8 <= MAX_EXCEL_COLUMNS;
+    const left = roomOnRight ? Math.max(1, dimensions.right + 2) : 1;
+    const top = roomOnRight ? 2 : Math.max(2, dimensions.bottom + 2);
+    if (top + height > MAX_EXCEL_ROWS) {
+        throw toolError.invalidInput("there is no room to place a chart beside or below the used range", "Pass an explicit `anchor` inside the worksheet, or put the chart on a separate sheet.");
+    }
+    return `${Address.encodeCell({ r: top - 1, c: left - 1 })}:${Address.encodeCell({ r: top + height - 1, c: left + 6 })}`;
+}
+/** Number of cells in a one-dimensional category/series range. */
+function rangeLength(range) {
+    const window = parseRange(range);
+    const rows = window.bottom - window.top + 1;
+    const columns = window.right - window.left + 1;
+    if (rows > 1 && columns > 1) {
+        throw toolError.invalidInput(`chart range ${JSON.stringify(range)} is two-dimensional`, "Categories and series values must each be one row or one column.");
+    }
+    return rows * columns;
+}
+function legendCode(position) {
+    switch (position) {
+        case "right":
+            return "r";
+        case "bottom":
+            return "b";
+        case "top":
+            return "t";
+        case "left":
+            return "l";
+    }
+}
+/**
+ * Synthetic-data generation.
+ *
+ * A genuinely high-leverage capability: a few dozen tokens of column definitions
+ * produce megabytes of plausible rows. A model asked for 5 000 test rows would
+ * otherwise have to emit them itself, which is both ruinously expensive and
+ * worse data.
+ */
+export const generateSchema = z.object({
+    rows: z
+        .number()
+        .int()
+        .positive()
+        .max(20_000)
+        .describe("How many data rows to generate (maximum 20,000)."),
+    columns: z
+        .array(z.object({
+        name: z.string().min(1).describe("Column header."),
+        type: z
+            .enum([
+            "string",
+            "int",
+            "float",
+            "bool",
+            "date",
+            "datetime",
+            "uuid",
+            "email",
+            "name",
+            "firstName",
+            "lastName",
+            "word",
+            "sentence",
+            "phone",
+            "url",
+            "ip",
+            "hex",
+            "index"
+        ])
+            .describe("What kind of value to generate."),
+        min: z.number().optional().describe("For int/float."),
+        max: z.number().optional().describe("For int/float."),
+        length: z.number().int().positive().optional().describe("For string/hex."),
+        values: z
+            .array(z.union([z.string(), z.number(), z.boolean()]))
+            .optional()
+            .describe("Pick from this set instead of generating — use it for categories like regions."),
+        nullable: z
+            .number()
+            .min(0)
+            .max(1)
+            .optional()
+            .describe("Probability of a blank, 0–1. Useful for testing how code handles gaps.")
+    }))
+        .min(1)
+        .max(100)
+        .describe("Column definitions, left to right.")
+});
+/** Generate rows and write them into a worksheet, header included. */
+export function writeGenerated(ws, spec) {
+    const cells = spec.rows * spec.columns.length;
+    if (cells > 2_000_000) {
+        throw toolError.tooLarge(`generation would create ${cells.toLocaleString()} cells, over the 2,000,000 limit`, "Reduce the rows or columns. Synthetic data is materialised in memory before the workbook is written.");
+    }
+    const generated = Csv.generate({
+        rows: spec.rows,
+        columns: spec.columns.map(column => ({
+            type: column.type,
+            name: column.name,
+            ...(column.min === undefined ? {} : { min: column.min }),
+            ...(column.max === undefined ? {} : { max: column.max }),
+            ...(column.length === undefined ? {} : { length: column.length }),
+            ...(column.values === undefined ? {} : { values: [...column.values] }),
+            ...(column.nullable === undefined ? {} : { nullable: column.nullable })
+        }))
+    });
+    Worksheet.addAoa(ws, [generated.headers, ...generated.data]);
+    return `generated ${spec.rows} row(s) × ${spec.columns.length} column(s) server-side`;
+}
+//# sourceMappingURL=chart.js.map

package/dist/tools/chart.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * `doc_convert` — convert a document between formats.
+ *
+ * The highest-leverage tool per line of code: "this is the wrong format" is the
+ * most common friction a user hits, and one call with two paths solves it. The
+ * routing table below is the whole tool.
+ *
+ * Deliberately excluded: anything lossy in a way the caller cannot see. PDF is
+ * a terminal format here — there is no PDF-to-Word, because a faithful one does
+ * not exist and a bad one silently destroys the document.
+ */
+export declare const docConvertTool: import("./types.js").AnyToolDefinition;
+//# sourceMappingURL=doc-convert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc-convert.d.ts","sourceRoot":"","sources":["../../src/tools/doc-convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyCH,eAAO,MAAM,cAAc,wCAqEzB,CAAC"}

package/dist/tools/doc-convert.js

@@ -0,0 +1,209 @@
+/**
+ * `doc_convert` — convert a document between formats.
+ *
+ * The highest-leverage tool per line of code: "this is the wrong format" is the
+ * most common friction a user hits, and one call with two paths solves it. The
+ * routing table below is the whole tool.
+ *
+ * Deliberately excluded: anything lossy in a way the caller cannot see. PDF is
+ * a terminal format here — there is no PDF-to-Word, because a faithful one does
+ * not exist and a bad one silently destroys the document.
+ */
+import { readFile, stat } from "node:fs/promises";
+import { Workbook, Worksheet } from "documonster/excel";
+import { readCsvFile, writeCsvFile } from "documonster/excel/csv";
+import { calculateFormulas } from "documonster/excel/formula";
+import { Pdf } from "documonster/pdf";
+import { Convert, Io } from "documonster/word";
+import { renderToHtml } from "documonster/word/html";
+import { markdownToDocx, renderToMarkdown } from "documonster/word/markdown";
+import { z } from "zod";
+import { toolError } from "../errors.js";
+import { assertWritable, outputDisplay, resolveInRoot, resolveOutputPath } from "../sandbox.js";
+import { assertNonMacroOutput, requireFormat } from "./document.js";
+import { assertReadableSize, replaceAtomically, writeFileAtomic, writeWithPolicy } from "./fs-helpers.js";
+import { formatBytes, textResult } from "./result.js";
+import { requireSheet, sheetName } from "./spreadsheet.js";
+import { defineTool } from "./types.js";
+/**
+ * Supported conversions, as `from -> to[]`.
+ *
+ * Published to the model in the tool description and used to reject the rest
+ * with a message that lists what *is* possible — so an unsupported request
+ * costs one turn, not a retry loop.
+ */
+const ROUTES = {
+    docx: ["md", "html", "pdf", "txt", "odt"],
+    odt: ["docx", "md", "pdf"],
+    md: ["docx", "pdf"],
+    xlsx: ["csv", "pdf"],
+    csv: ["xlsx"]
+};
+export const docConvertTool = defineTool({
+    name: "doc_convert",
+    group: ["word", "pdf", "excel"],
+    title: "Convert a document",
+    description: "Convert a document between formats: docx→md/html/pdf/txt/odt, odt→docx/md/pdf, md→docx/pdf, xlsx→csv/pdf, csv→xlsx. The output extension chooses the target. PDF is a terminal format — there is no PDF→Word, because no faithful conversion exists.",
+    inputSchema: {
+        from: z.string().min(1).describe("Source path, relative to the server root."),
+        to: z
+            .string()
+            .min(1)
+            .describe("Destination path below --output-root. Its extension selects the target format; the result is returned as @output/<path>."),
+        sheet: z
+            .union([z.string(), z.number().int().positive()])
+            .optional()
+            .describe("xlsx→csv only: which sheet to export. Defaults to the first."),
+        overwrite: z
+            .boolean()
+            .optional()
+            .describe("Replace the destination if it exists. Defaults to false.")
+    },
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+    },
+    mutates: true,
+    handler: async (args, context) => {
+        const { config } = context;
+        assertWritable(config);
+        const source = await resolveInRoot(config, args.from, { mustExist: true });
+        await assertReadableSize(config, source, args.from);
+        const target = await resolveOutputPath(config, args.to);
+        const fromFormat = requireFormat(args.from, "from");
+        const toFormat = requireFormat(args.to, "to");
+        assertNonMacroOutput(args.to);
+        const allowed = ROUTES[fromFormat];
+        if (allowed === undefined || !allowed.includes(toFormat)) {
+            throw toolError.unsupported(`cannot convert ${fromFormat} to ${toFormat}`, allowed === undefined
+                ? `Nothing converts from ${fromFormat}. Supported sources: ${Object.keys(ROUTES).join(", ")}.`
+                : `From ${fromFormat} you can produce: ${allowed.join(", ")}.`);
+        }
+        let note = [];
+        await writeWithPolicy(target, args.overwrite === true, async (temporary) => {
+            note = await convert(fromFormat, toFormat, source, temporary, args);
+        });
+        const size = (await stat(target)).size;
+        return textResult(config, [
+            `Converted **${args.from}** → **${outputDisplay(args.to)}** (${fromFormat} → ${toFormat}, ${formatBytes(size)}).`,
+            ...note,
+            "",
+            toFormat === "pdf" || toFormat === "html"
+                ? "Verify by opening it, or read the source back — this tool cannot read its own PDF output structurally."
+                : "Read it back with doc_read or sheet_read to verify."
+        ].join("\n"));
+    }
+});
+/** Perform one conversion, returning notes worth telling the caller. */
+async function convert(from, to, source, target, args) {
+    if (from === "docx") {
+        const doc = await readWord(source);
+        switch (to) {
+            case "md":
+                await writeFileAtomic(target, renderToMarkdown(doc));
+                return ["- headings, lists and tables preserved as Markdown"];
+            case "html": {
+                // renderToHtml returns { html, warnings, images } — not a string.
+                const rendered = renderToHtml(doc);
+                await writeFileAtomic(target, rendered.html);
+                return rendered.warnings.length > 0
+                    ? [
+                        `- ${rendered.warnings.length} rendering warning(s): ${rendered.warnings.slice(0, 3).join("; ")}`
+                    ]
+                    : ["- semantic HTML5 with inline styles"];
+            }
+            case "txt": {
+                const { Query } = await import("documonster/word");
+                await writeFileAtomic(target, Query.extractText(doc));
+                return ["- **formatting discarded** — plain text only"];
+            }
+            case "pdf": {
+                await writeFileAtomic(target, await Pdf.fromDocx(doc));
+                return ["- paginated by the Word layout engine, so page breaks are real"];
+            }
+            case "odt": {
+                await writeFileAtomic(target, await Convert.writeOdt(doc));
+                return ["- OpenDocument Text, readable by LibreOffice and Word"];
+            }
+            default:
+                throw unreachable(from, to);
+        }
+    }
+    if (from === "odt") {
+        const doc = await Convert.readOdt(new Uint8Array(await readFile(source))).catch((cause) => {
+            throw toolError.unsupported("could not read the source as an OpenDocument Text file", "Run doc_inspect to confirm the file type.", { cause });
+        });
+        if (to === "docx") {
+            await replaceAtomically(target, temporary => Io.writeFile(doc, temporary));
+            return ["- OpenDocument mapped to WordprocessingML"];
+        }
+        if (to === "md") {
+            await writeFileAtomic(target, renderToMarkdown(doc));
+            return ["- structure preserved as Markdown"];
+        }
+        if (to === "pdf") {
+            await writeFileAtomic(target, await Pdf.fromDocx(doc));
+            return ["- rendered via the Word layout engine"];
+        }
+        throw unreachable(from, to);
+    }
+    if (from === "md") {
+        const markdown = await readFile(source, "utf8");
+        const doc = await markdownToDocx(markdown);
+        if (to === "docx") {
+            await replaceAtomically(target, temporary => Io.writeFile(doc, temporary));
+            return ["- Markdown structure mapped to Word styles"];
+        }
+        if (to === "pdf") {
+            await writeFileAtomic(target, await Pdf.fromDocx(doc));
+            return ["- rendered via Word layout, so pagination is real"];
+        }
+        throw unreachable(from, to);
+    }
+    if (from === "xlsx") {
+        const wb = Workbook.create();
+        await Workbook.readFile(wb, source).catch((cause) => {
+            throw toolError.unsupported(`could not read the source as a workbook`, "Run doc_inspect to confirm the file type.", { cause });
+        });
+        if (to === "csv") {
+            // writeCsvFile takes the workbook and selects the sheet by name — passing
+            // a worksheet handle does not type-check and would not work.
+            const ws = requireSheet(wb, args.sheet);
+            await replaceAtomically(target, temporary => writeCsvFile(wb, temporary, { sheetName: sheetName(ws) }));
+            return [
+                `- exported sheet ${JSON.stringify(sheetName(ws))} of ${Workbook.getWorksheets(wb).length}`,
+                "- **only one sheet** — CSV has no concept of multiple sheets",
+                "- formulas exported as their cached values"
+            ];
+        }
+        if (to === "pdf") {
+            // Inject the calculation engine so stale cached values are not printed.
+            await writeFileAtomic(target, await Pdf.fromExcel(wb, { recalculate: calculateFormulas }));
+            return [
+                `- all ${Workbook.getWorksheets(wb).length} sheet(s) rendered, honouring each sheet's print setup`,
+                "- formulas recalculated before rendering"
+            ];
+        }
+        throw unreachable(from, to);
+    }
+    if (from === "csv" && to === "xlsx") {
+        const wb = Workbook.create();
+        const ws = await readCsvFile(wb, source);
+        Worksheet.setModel(ws, { ...Worksheet.getModel(ws), name: "Sheet1" });
+        await replaceAtomically(target, temporary => Workbook.writeFile(wb, temporary));
+        return [`- ${Worksheet.actualRowCount(ws)} row(s) imported into sheet "Sheet1"`];
+    }
+    throw unreachable(from, to);
+}
+async function readWord(source) {
+    return await Io.readFile(source).catch((cause) => {
+        throw toolError.unsupported("could not read the source as a Word document", "A CFB container is either a legacy .doc or an encrypted .docx; neither is supported here. Run doc_inspect.", { cause });
+    });
+}
+/** The route table and the switch cannot disagree, but say so if they do. */
+function unreachable(from, to) {
+    return toolError.unsupported(`conversion ${from} → ${to} is listed as supported but not implemented`, "This is a server bug; report it.");
+}
+//# sourceMappingURL=doc-convert.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * `doc_paginate` — compute a Word document's real page layout.
+ *
+ * The capability nothing else here can substitute for. "How many pages is this?"
+ * and "which page is that heading on?" normally require Microsoft Word: the
+ * answer depends on line breaking, font metrics, widow/orphan control and table
+ * cell heights. This runs the layout engine and answers without Office
+ * installed, and without a rasteriser.
+ *
+ * It also updates computed field values — PAGE, NUMPAGES, PAGEREF, TOC entries —
+ * which otherwise only refresh when a human presses F9 in Word.
+ */
+export declare const docPaginateTool: import("./types.js").AnyToolDefinition;
+//# sourceMappingURL=doc-paginate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doc-paginate.d.ts","sourceRoot":"","sources":["../../src/tools/doc-paginate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuBH,eAAO,MAAM,eAAe,wCAkI1B,CAAC"}