document-mcp 1.5.100 → 1.5.102

package/dist/bin.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import { serveStdio } from "@modelcontextprotocol/server/stdio";
 import { McpServer } from "@modelcontextprotocol/server";
-import { DocumentFormatSchema, OdbReportNotSpecifiedError, OdmUnresolvedSectionError, UnrecognizedDocumentSchemaError, base64ToBytes, buildDocumentBytes, bytesToBase64, createLocalDocumentConverter, decodeOdbPackage, decodePackage, describeFontFace, documentFromJson, evaluateSelect, extractSourceFontsForFormat, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
+import { DocumentFormatSchema, OdbReportNotSpecifiedError, OdmUnresolvedSectionError, UnrecognizedDocumentSchemaError, base64ToBytes, buildDocumentBytes, bytesToBase64, createLocalDocumentConverter, decodeOdbPackage, decodePackage, describeFontFace, documentFromJson, documentSchemaKindOf, evaluateSelect, extractSourceFontsForFormat, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
 import { z } from "zod";
 import { readFile, writeFile } from "node:fs/promises";
 import { existsSync, readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 //#region package.json
-var version = "1.5.100";
+var version = "1.5.102";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -319,6 +319,13 @@ function errorResult(message) {
 		isError: true
 	};
 }
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isLegacyPackageDump(value) {
+	if (!isRecord(value) || documentSchemaKindOf(value) !== "DocumentPackage") return false;
+	return value.formatVersion === 1 || "layout" in value && value.formatVersion !== 2;
+}
 function registerFromPackageTools(server) {
 	server.registerTool("from_package", {
 		title: "Build document from package",
@@ -329,10 +336,10 @@ function registerFromPackageTools(server) {
 			output: DocumentOutputSchema.optional().describe("Where to write the resulting document. Omit entirely (or omit outputPath within it) to receive the bytes inline instead.")
 		})
 	}, async ({ source, targetFormat, output }) => {
+		let parsed;
 		try {
 			const bytes = await readSourceBytes(source);
 			const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-			let parsed;
 			try {
 				parsed = JSON.parse(text);
 			} catch (error) {
@@ -350,6 +357,8 @@ function registerFromPackageTools(server) {
 			};
 		} catch (error) {
 			if (error instanceof UnrecognizedDocumentSchemaError) return errorResult("'source' has no recognised $schema -- only a file carrying a real DocumentPackage (e.g. written by a caller's own --dump-package-equivalent step) can be read back by this tool");
+			if (error instanceof z.ZodError && isLegacyPackageDump(parsed)) return errorResult("'source' is a DocumentPackage dump in the old formatVersion 1 shape: a 'layout' half beside 'content'. documents.js 2.0.0 fused the two into formatVersion 2 ('content' + 'pages', with per-node 'frames' carrying the layout positions) and no longer parses the old shape -- regenerate the dump with a current documents.js (e.g. re-run the conversion whose package dump produced it) and read that back instead");
+			if (error instanceof z.ZodError) return errorResult(`'source' failed ${documentSchemaKindOf(parsed) ?? "document schema"} validation: ${error.message}`);
 			return errorResult(error instanceof Error ? error.message : String(error));
 		}
 	});

package/dist/index.cjs

@@ -6,7 +6,7 @@ let node_fs_promises = require("node:fs/promises");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 //#region package.json
-var version = "1.5.100";
+var version = "1.5.102";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -318,6 +318,13 @@ function errorResult(message) {
 		isError: true
 	};
 }
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isLegacyPackageDump(value) {
+	if (!isRecord(value) || (0, documents_js.documentSchemaKindOf)(value) !== "DocumentPackage") return false;
+	return value.formatVersion === 1 || "layout" in value && value.formatVersion !== 2;
+}
 function registerFromPackageTools(server) {
 	server.registerTool("from_package", {
 		title: "Build document from package",
@@ -328,10 +335,10 @@ function registerFromPackageTools(server) {
 			output: DocumentOutputSchema.optional().describe("Where to write the resulting document. Omit entirely (or omit outputPath within it) to receive the bytes inline instead.")
 		})
 	}, async ({ source, targetFormat, output }) => {
+		let parsed;
 		try {
 			const bytes = await readSourceBytes(source);
 			const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-			let parsed;
 			try {
 				parsed = JSON.parse(text);
 			} catch (error) {
@@ -349,6 +356,8 @@ function registerFromPackageTools(server) {
 			};
 		} catch (error) {
 			if (error instanceof documents_js.UnrecognizedDocumentSchemaError) return errorResult("'source' has no recognised $schema -- only a file carrying a real DocumentPackage (e.g. written by a caller's own --dump-package-equivalent step) can be read back by this tool");
+			if (error instanceof zod.z.ZodError && isLegacyPackageDump(parsed)) return errorResult("'source' is a DocumentPackage dump in the old formatVersion 1 shape: a 'layout' half beside 'content'. documents.js 2.0.0 fused the two into formatVersion 2 ('content' + 'pages', with per-node 'frames' carrying the layout positions) and no longer parses the old shape -- regenerate the dump with a current documents.js (e.g. re-run the conversion whose package dump produced it) and read that back instead");
+			if (error instanceof zod.z.ZodError) return errorResult(`'source' failed ${(0, documents_js.documentSchemaKindOf)(parsed) ?? "document schema"} validation: ${error.message}`);
 			return errorResult(error instanceof Error ? error.message : String(error));
 		}
 	});

package/dist/index.js

@@ -1,11 +1,11 @@
 import { McpServer } from "@modelcontextprotocol/server";
-import { DocumentFormatSchema, OdbReportNotSpecifiedError, OdmUnresolvedSectionError, UnrecognizedDocumentSchemaError, base64ToBytes, buildDocumentBytes, bytesToBase64, createLocalDocumentConverter, decodeOdbPackage, decodePackage, describeFontFace, documentFromJson, evaluateSelect, extractSourceFontsForFormat, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
+import { DocumentFormatSchema, OdbReportNotSpecifiedError, OdmUnresolvedSectionError, UnrecognizedDocumentSchemaError, base64ToBytes, buildDocumentBytes, bytesToBase64, createLocalDocumentConverter, decodeOdbPackage, decodePackage, describeFontFace, documentFromJson, documentSchemaKindOf, evaluateSelect, extractSourceFontsForFormat, layoutDocumentWithSchema, odbReportToDocx, odbReportToOdt, odbReportToPdf, odbToCsv, odbToXlsx, odmToPdf, parseSelect, readDocumentMetadata, readDocxExtras, readOdbForms, readOdbInventory, readOdbReportContent, readOdbReports, readOdbTables, readPdf, setDocumentMetadata } from "documents.js";
 import { z } from "zod";
 import { readFile, writeFile } from "node:fs/promises";
 import { existsSync, readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 //#region package.json
-var version = "1.5.100";
+var version = "1.5.102";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -317,6 +317,13 @@ function errorResult(message) {
 		isError: true
 	};
 }
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isLegacyPackageDump(value) {
+	if (!isRecord(value) || documentSchemaKindOf(value) !== "DocumentPackage") return false;
+	return value.formatVersion === 1 || "layout" in value && value.formatVersion !== 2;
+}
 function registerFromPackageTools(server) {
 	server.registerTool("from_package", {
 		title: "Build document from package",
@@ -327,10 +334,10 @@ function registerFromPackageTools(server) {
 			output: DocumentOutputSchema.optional().describe("Where to write the resulting document. Omit entirely (or omit outputPath within it) to receive the bytes inline instead.")
 		})
 	}, async ({ source, targetFormat, output }) => {
+		let parsed;
 		try {
 			const bytes = await readSourceBytes(source);
 			const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-			let parsed;
 			try {
 				parsed = JSON.parse(text);
 			} catch (error) {
@@ -348,6 +355,8 @@ function registerFromPackageTools(server) {
 			};
 		} catch (error) {
 			if (error instanceof UnrecognizedDocumentSchemaError) return errorResult("'source' has no recognised $schema -- only a file carrying a real DocumentPackage (e.g. written by a caller's own --dump-package-equivalent step) can be read back by this tool");
+			if (error instanceof z.ZodError && isLegacyPackageDump(parsed)) return errorResult("'source' is a DocumentPackage dump in the old formatVersion 1 shape: a 'layout' half beside 'content'. documents.js 2.0.0 fused the two into formatVersion 2 ('content' + 'pages', with per-node 'frames' carrying the layout positions) and no longer parses the old shape -- regenerate the dump with a current documents.js (e.g. re-run the conversion whose package dump produced it) and read that back instead");
+			if (error instanceof z.ZodError) return errorResult(`'source' failed ${documentSchemaKindOf(parsed) ?? "document schema"} validation: ${error.message}`);
 			return errorResult(error instanceof Error ? error.message : String(error));
 		}
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-mcp",
-  "version": "1.5.100",
+  "version": "1.5.102",
   "description": "MCP (Model Context Protocol) server exposing documents.js's document-conversion, .odb, metadata, and font tooling as MCP tools.",
   "type": "module",
   "repository": {
@@ -85,7 +85,7 @@
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
     "@modelcontextprotocol/server": "^2.0.0",
-    "documents.js": "^2.0.0",
+    "documents.js": "^2.1.0",
     "zod": "^4.2.0"
   },
   "devDependencies": {