document-mcp 1.1.6 → 1.2.0

package/README.md

@@ -4,7 +4,7 @@
 
 > An MCP (Model Context Protocol) server exposing [`documents.js`](https://github.com/ExaDev/documents.js)'s document-conversion, `.odb`, metadata, and font tooling as MCP tools, so an MCP-speaking agent can convert, inspect, and edit docx/pptx/odt/odp/ods/odg/odf/pdf/odb/xlsx/markdown documents without writing TypeScript against `documents.js` directly.
 
-`document-mcp` adds no conversion or editing logic of its own — it is a dispatch layer over `documents.js`'s existing conversion functions, `DocumentConverter` port, and `.odb`/PDF readers, wired up as MCP tools served over stdio. [`document-cli`](https://github.com/ExaDev/document-cli) is the sibling frontend over the identical `documents.js` library — a terminal CLI/TUI rather than an MCP server — so the two are independent consumers of one shared implementation and can expose different subsets of it.
+`document-mcp` adds no conversion or editing logic of its own — it is a dispatch layer over `documents.js`'s existing conversion functions, `DocumentConverter` port, and `.odb`/PDF readers, wired up as MCP tools served over stdio. [`document-cli`](https://github.com/ExaDev/document-cli) is the sibling frontend over the identical `documents.js` library — a terminal CLI/TUI rather than an MCP server — so the two are independent consumers of one shared implementation and can expose different subsets of it. A `convert_document` call's fidelity — which `(source, targetFormat)` pairs round-trip losslessly, which are a best-effort reconstruction, and why — is exactly what [`documents.js`'s own Fidelity section](https://github.com/ExaDev/documents.js#fidelity) documents, table included; it is not restated here.
 
 ```mermaid
 graph TD
@@ -91,7 +91,7 @@ Or, for local development against a checkout of this repository rather than the
 
 Every tool that takes or produces document bytes goes through the same two hybrid shapes, documented once here rather than repeated per tool below.
 
-**Input** (`DocumentInput`) is a union: either a filesystem `path` (the format is inferred from the file extension — `docx`, `pptx`, `xlsx`, `odt`, `odp`, `ods`, `odg`, `odf`, `md`/`markdown`, `pdf`), or inline `bytesBase64` plus an explicit `format` (required, since inline bytes carry no filename to infer one from). `.odb` tools are the one exception: a `.odb` has no single `DocumentFormat` of its own (it is a database front end, not a document — tables, saved queries, and reports are three unrelated output shapes), so their `source.path`/`source.bytesBase64` bytes are read directly with no format inference at all.
+**Input** (`DocumentInput`) is a union: either a filesystem `path` (the format is inferred from the file extension — `docx`, `pptx`, `xlsx`, `odt`, `odp`, `ods`, `odg`, `odf`, `md`/`markdown`, `pdf`), or inline `bytesBase64` plus an explicit `format` (required, since inline bytes carry no filename to infer one from). Each ODF/OOXML template and macro-enabled variant also reads as its base format: `.ott`/`.ots`/`.otp`/`.otg`/`.otf` as `odt`/`ods`/`odp`/`odg`/`odf`, and `.dotx`/`.potx`/`.xltx` (templates) or `.docm`/`.xlsm`/`.pptm` (macro-enabled) as their OOXML base — a template is the same package with a `-template` mimetype, and a macro-enabled file carries a `vbaProject` part this library reads past without executing or re-emitting. `.odb` tools are the one exception: a `.odb` has no single `DocumentFormat` of its own (it is a database front end, not a document — tables, saved queries, and reports are three unrelated output shapes), so their `source.path`/`source.bytesBase64` bytes are read directly with no format inference at all.
 
 **Output** (`DocumentOutput`), on every tool that produces a document, is a single optional `outputPath`: supply it to have the tool write the result to that filesystem path (the response then reports `{ path, byteLength }`); omit it to receive the bytes inline instead (`{ bytesBase64, byteLength }`, flagged `large: true` above 5 MB — advisory only, the bytes are never truncated or refused).
 
@@ -102,7 +102,7 @@ Every tool that takes or produces document bytes goes through the same two hybri
 | `convert_document` | Converts a document from one supported format to another via `documents.js`'s `DocumentConverter` port — docx, pptx, xlsx, odt, odp, ods, odg, odf, markdown, and pdf. Not every `(source, targetFormat)` pair is direct; call `list_document_conversions` first. |
 | `list_document_conversions` | Lists every `(source, target)` format pair `convert_document` actually supports. |
 | `metadata_read` | Reads a document's title/author/subject/keywords/creator/producer/created-and-modified timestamps. Works across every supported format, including xlsx and odf. |
-| `metadata_write` | Patches a document's title/author/subject/keywords in place. Does not convert format — source and target format must match (or both be `pdf`); xlsx and odf are rejected as either. |
+| `metadata_write` | Patches a document's title/author/subject/keywords in place. Does not convert format — source and target format must match (or both be `pdf`); odf (a standalone formula document) is rejected as either, since it has no write path back out at all. |
 | `fonts` | Lists every source-embedded font face a docx/pptx/odt/odp/ods/odg document carries (family, weight/style, byte length). |
 | `describe_font_file` | Reads a standalone `.ttf`/`.otf` font file and reports the family/bold/italic triple it declares about itself. |
 | `docx_extras` | Reads a docx's own comments, footnotes, headers, footers, and numbering definitions — data the `ContentDocument` pivot cannot carry, so no other tool sees it. |

package/dist/bin.js

@@ -8,18 +8,29 @@ import { readFontFace } from "pdf-codec";
 import { existsSync, readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 //#region package.json
-var version = "1.1.6";
+var version = "1.2.0";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
 	docx: "docx",
+	dotx: "docx",
+	docm: "docx",
 	pptx: "pptx",
+	potx: "pptx",
+	pptm: "pptx",
 	xlsx: "xlsx",
+	xltx: "xlsx",
+	xlsm: "xlsx",
 	odt: "odt",
+	ott: "odt",
 	odp: "odp",
+	otp: "odp",
 	ods: "ods",
+	ots: "ods",
 	odg: "odg",
+	otg: "odg",
 	odf: "odf",
+	otf: "odf",
 	markdown: "markdown",
 	md: "markdown",
 	pdf: "pdf"
@@ -372,7 +383,7 @@ function registerMetadataTools(server) {
 	});
 	server.registerTool("metadata_write", {
 		title: "Write document metadata",
-		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); xlsx and odf are rejected outright as either a source or a target, in both directions. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
+		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); odf (a standalone formula document) is rejected outright as either a source or a target, since it has no write path back out at all. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
 		inputSchema: z.object({
 			source: DocumentInputSchema.describe("The document to patch metadata on."),
 			targetFormat: DocumentFormatSchema.describe("The format to write the patched document back out as -- must match the source document's own format (or both be 'pdf'). metadata_write never converts format."),

package/dist/index.cjs

@@ -7,18 +7,29 @@ let pdf_codec = require("pdf-codec");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 //#region package.json
-var version = "1.1.6";
+var version = "1.2.0";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
 	docx: "docx",
+	dotx: "docx",
+	docm: "docx",
 	pptx: "pptx",
+	potx: "pptx",
+	pptm: "pptx",
 	xlsx: "xlsx",
+	xltx: "xlsx",
+	xlsm: "xlsx",
 	odt: "odt",
+	ott: "odt",
 	odp: "odp",
+	otp: "odp",
 	ods: "ods",
+	ots: "ods",
 	odg: "odg",
+	otg: "odg",
 	odf: "odf",
+	otf: "odf",
 	markdown: "markdown",
 	md: "markdown",
 	pdf: "pdf"
@@ -371,7 +382,7 @@ function registerMetadataTools(server) {
 	});
 	server.registerTool("metadata_write", {
 		title: "Write document metadata",
-		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); xlsx and odf are rejected outright as either a source or a target, in both directions. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
+		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); odf (a standalone formula document) is rejected outright as either a source or a target, since it has no write path back out at all. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
 		inputSchema: zod.z.object({
 			source: DocumentInputSchema.describe("The document to patch metadata on."),
 			targetFormat: documents_js.DocumentFormatSchema.describe("The format to write the patched document back out as -- must match the source document's own format (or both be 'pdf'). metadata_write never converts format."),

package/dist/index.js

@@ -6,18 +6,29 @@ import { readFontFace } from "pdf-codec";
 import { existsSync, readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 //#region package.json
-var version = "1.1.6";
+var version = "1.2.0";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
 	docx: "docx",
+	dotx: "docx",
+	docm: "docx",
 	pptx: "pptx",
+	potx: "pptx",
+	pptm: "pptx",
 	xlsx: "xlsx",
+	xltx: "xlsx",
+	xlsm: "xlsx",
 	odt: "odt",
+	ott: "odt",
 	odp: "odp",
+	otp: "odp",
 	ods: "ods",
+	ots: "ods",
 	odg: "odg",
+	otg: "odg",
 	odf: "odf",
+	otf: "odf",
 	markdown: "markdown",
 	md: "markdown",
 	pdf: "pdf"
@@ -370,7 +381,7 @@ function registerMetadataTools(server) {
 	});
 	server.registerTool("metadata_write", {
 		title: "Write document metadata",
-		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); xlsx and odf are rejected outright as either a source or a target, in both directions. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
+		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); odf (a standalone formula document) is rejected outright as either a source or a target, since it has no write path back out at all. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
 		inputSchema: z.object({
 			source: DocumentInputSchema.describe("The document to patch metadata on."),
 			targetFormat: DocumentFormatSchema.describe("The format to write the patched document back out as -- must match the source document's own format (or both be 'pdf'). metadata_write never converts format."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-mcp",
-  "version": "1.1.6",
+  "version": "1.2.0",
   "description": "MCP (Model Context Protocol) server exposing documents.js's document-conversion, .odb, metadata, and font tooling as MCP tools.",
   "type": "module",
   "repository": {
@@ -69,7 +69,7 @@
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
     "@modelcontextprotocol/server": "^2.0.0",
-    "documents.js": "^1.79.0",
+    "documents.js": "^1.81.8",
     "pdf-codec": "^1.11.0",
     "zod": "^4.2.0"
   },