document-mcp 1.5.109 → 2.0.0

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, documentSchemaKindOf, 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, 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.109";
+var version = "2.0.0";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -319,12 +319,8 @@ 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 isNamedError(error, name) {
+	return error instanceof Error && error.name === name;
 }
 function registerFromPackageTools(server) {
 	server.registerTool("from_package", {
@@ -357,7 +353,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 (isNamedError(error, "SchemaVersionMismatchError")) return errorResult(error.message);
+			if (isNamedError(error, "LayoutSchemaDemotedError")) return errorResult(error.message);
 			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));
 		}
@@ -790,7 +787,7 @@ function countImagesByFormat(images) {
 function registerPdfInspectTools(server) {
 	server.registerTool("pdf_inspect", {
 		title: "Inspect PDF",
-		description: "Parses a PDF (documents.js's readPdf) and reports a summary: page count, each page's own size and item-kind histogram, document metadata, and embedded image formats. Pass full: true to return the entire parsed LayoutDocument (tagged with its own $schema) instead of a summary.",
+		description: "Parses a PDF (documents.js's readPdf) and reports a summary: page count, each page's own size and item-kind histogram, document metadata, and embedded image formats. Pass full: true to return the entire parsed LayoutDocument instead of a summary.",
 		inputSchema: z.object({
 			source: DocumentInputSchema.describe("The PDF document to inspect."),
 			full: z.boolean().optional().describe("When true, return the entire parsed LayoutDocument instead of a summary. Defaults to false.")
@@ -800,16 +797,13 @@ function registerPdfInspectTools(server) {
 		const { bytes, format } = await resolveDocumentInput(source, { signal });
 		if (format !== "pdf") throw new Error(`pdf_inspect requires a PDF document, received a "${format}" document instead.`);
 		const layout = readPdf(bytes, { signal });
-		if (full === true) {
-			const tagged = layoutDocumentWithSchema(layout);
-			return {
-				content: [{
-					type: "text",
-					text: JSON.stringify(tagged)
-				}],
-				structuredContent: tagged
-			};
-		}
+		if (full === true) return {
+			content: [{
+				type: "text",
+				text: JSON.stringify(layout)
+			}],
+			structuredContent: layout
+		};
 		const summary = {
 			pageCount: layout.pages.length,
 			pages: layout.pages.map((page) => ({

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.109";
+var version = "2.0.0";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -318,12 +318,8 @@ 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 isNamedError(error, name) {
+	return error instanceof Error && error.name === name;
 }
 function registerFromPackageTools(server) {
 	server.registerTool("from_package", {
@@ -356,7 +352,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 (isNamedError(error, "SchemaVersionMismatchError")) return errorResult(error.message);
+			if (isNamedError(error, "LayoutSchemaDemotedError")) return errorResult(error.message);
 			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));
 		}
@@ -789,7 +786,7 @@ function countImagesByFormat(images) {
 function registerPdfInspectTools(server) {
 	server.registerTool("pdf_inspect", {
 		title: "Inspect PDF",
-		description: "Parses a PDF (documents.js's readPdf) and reports a summary: page count, each page's own size and item-kind histogram, document metadata, and embedded image formats. Pass full: true to return the entire parsed LayoutDocument (tagged with its own $schema) instead of a summary.",
+		description: "Parses a PDF (documents.js's readPdf) and reports a summary: page count, each page's own size and item-kind histogram, document metadata, and embedded image formats. Pass full: true to return the entire parsed LayoutDocument instead of a summary.",
 		inputSchema: zod.z.object({
 			source: DocumentInputSchema.describe("The PDF document to inspect."),
 			full: zod.z.boolean().optional().describe("When true, return the entire parsed LayoutDocument instead of a summary. Defaults to false.")
@@ -799,16 +796,13 @@ function registerPdfInspectTools(server) {
 		const { bytes, format } = await resolveDocumentInput(source, { signal });
 		if (format !== "pdf") throw new Error(`pdf_inspect requires a PDF document, received a "${format}" document instead.`);
 		const layout = (0, documents_js.readPdf)(bytes, { signal });
-		if (full === true) {
-			const tagged = (0, documents_js.layoutDocumentWithSchema)(layout);
-			return {
-				content: [{
-					type: "text",
-					text: JSON.stringify(tagged)
-				}],
-				structuredContent: tagged
-			};
-		}
+		if (full === true) return {
+			content: [{
+				type: "text",
+				text: JSON.stringify(layout)
+			}],
+			structuredContent: layout
+		};
 		const summary = {
 			pageCount: layout.pages.length,
 			pages: layout.pages.map((page) => ({

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, documentSchemaKindOf, 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, 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.109";
+var version = "2.0.0";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -317,12 +317,8 @@ 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 isNamedError(error, name) {
+	return error instanceof Error && error.name === name;
 }
 function registerFromPackageTools(server) {
 	server.registerTool("from_package", {
@@ -355,7 +351,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 (isNamedError(error, "SchemaVersionMismatchError")) return errorResult(error.message);
+			if (isNamedError(error, "LayoutSchemaDemotedError")) return errorResult(error.message);
 			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));
 		}
@@ -788,7 +785,7 @@ function countImagesByFormat(images) {
 function registerPdfInspectTools(server) {
 	server.registerTool("pdf_inspect", {
 		title: "Inspect PDF",
-		description: "Parses a PDF (documents.js's readPdf) and reports a summary: page count, each page's own size and item-kind histogram, document metadata, and embedded image formats. Pass full: true to return the entire parsed LayoutDocument (tagged with its own $schema) instead of a summary.",
+		description: "Parses a PDF (documents.js's readPdf) and reports a summary: page count, each page's own size and item-kind histogram, document metadata, and embedded image formats. Pass full: true to return the entire parsed LayoutDocument instead of a summary.",
 		inputSchema: z.object({
 			source: DocumentInputSchema.describe("The PDF document to inspect."),
 			full: z.boolean().optional().describe("When true, return the entire parsed LayoutDocument instead of a summary. Defaults to false.")
@@ -798,16 +795,13 @@ function registerPdfInspectTools(server) {
 		const { bytes, format } = await resolveDocumentInput(source, { signal });
 		if (format !== "pdf") throw new Error(`pdf_inspect requires a PDF document, received a "${format}" document instead.`);
 		const layout = readPdf(bytes, { signal });
-		if (full === true) {
-			const tagged = layoutDocumentWithSchema(layout);
-			return {
-				content: [{
-					type: "text",
-					text: JSON.stringify(tagged)
-				}],
-				structuredContent: tagged
-			};
-		}
+		if (full === true) return {
+			content: [{
+				type: "text",
+				text: JSON.stringify(layout)
+			}],
+			structuredContent: layout
+		};
 		const summary = {
 			pageCount: layout.pages.length,
 			pages: layout.pages.map((page) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-mcp",
-  "version": "1.5.109",
+  "version": "2.0.0",
   "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.3.3",
+    "documents.js": "^3.0.1",
     "zod": "^4.2.0"
   },
   "devDependencies": {