@shuji-bonji/pdf-reader-mcp 0.2.0

package/dist/tools/tier1/summarize.js

@@ -0,0 +1,70 @@
+/**
+ * summarize - Quick overview report of a PDF document.
+ */
+import { ResponseFormat } from '../../constants.js';
+import { SummarizeSchema } from '../../schemas/tier1.js';
+import { countImagesFromDoc, extractTextFromDoc, getMetadataFromDoc, loadDocument, } from '../../services/pdfjs-service.js';
+import { handleError } from '../../utils/error-handler.js';
+import { formatSummaryMarkdown } from '../../utils/formatter.js';
+export function registerSummarize(server) {
+    server.registerTool('summarize', {
+        title: 'Summarize PDF',
+        description: `Generate a quick overview report of a PDF document.
+
+Combines metadata, text presence check, image count, and a text preview from the first page into a single summary. Useful as a first step before deciding which detailed tools to use.
+
+Args:
+  - file_path (string): Absolute path to a local PDF file
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Summary including: page count, PDF version, file size, tagged/encrypted/signature flags, text presence, image count, and a text preview from page 1.
+
+Examples:
+  - Quick overview: { file_path: "/path/to/doc.pdf" }
+  - Machine-readable: { file_path: "/path/to/doc.pdf", response_format: "json" }`,
+        inputSchema: SummarizeSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            // Load the PDF document once and reuse for all operations
+            const doc = await loadDocument(params.file_path);
+            try {
+                const [metadata, firstPageTexts, imageCount] = await Promise.all([
+                    getMetadataFromDoc(doc, params.file_path),
+                    extractTextFromDoc(doc, '1'),
+                    countImagesFromDoc(doc),
+                ]);
+                const textPreview = firstPageTexts[0]?.text?.slice(0, 500) ?? '';
+                const hasText = textPreview.trim().length > 0;
+                const summary = {
+                    filePath: params.file_path,
+                    metadata,
+                    textPreview,
+                    imageCount,
+                    hasText,
+                };
+                const text = params.response_format === ResponseFormat.JSON
+                    ? JSON.stringify(summary, null, 2)
+                    : formatSummaryMarkdown(summary);
+                return {
+                    content: [{ type: 'text', text }],
+                };
+            }
+            finally {
+                await doc.destroy();
+            }
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: handleError(error) }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=summarize.js.map

package/dist/tools/tier1/summarize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../../src/tools/tier1/summarize.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAuB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE;;;;;;;;;;;;;iFAa8D;QAC3E,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAAsB,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,0DAA0D;YAC1D,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAEjD,IAAI,CAAC;gBACH,MAAM,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBAC/D,kBAAkB,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC;oBACzC,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC;oBAC5B,kBAAkB,CAAC,GAAG,CAAC;iBACxB,CAAC,CAAC;gBAEH,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;gBACjE,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;gBAE9C,MAAM,OAAO,GAAe;oBAC1B,QAAQ,EAAE,MAAM,CAAC,SAAS;oBAC1B,QAAQ;oBACR,WAAW;oBACX,UAAU;oBACV,OAAO;iBACR,CAAC;gBAEF,MAAM,IAAI,GACR,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,IAAI;oBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;oBAClC,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;gBAErC,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;iBAC3C,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;aAC/D,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tier2/inspect-annotations.d.ts

@@ -0,0 +1,6 @@
+/**
+ * inspect_annotations - PDF annotation analysis.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerInspectAnnotations(server: McpServer): void;
+//# sourceMappingURL=inspect-annotations.d.ts.map

package/dist/tools/tier2/inspect-annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-annotations.d.ts","sourceRoot":"","sources":["../../../src/tools/tier2/inspect-annotations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2ClE"}

package/dist/tools/tier2/inspect-annotations.js

@@ -0,0 +1,47 @@
+/**
+ * inspect_annotations - PDF annotation analysis.
+ */
+import { ResponseFormat } from '../../constants.js';
+import { InspectAnnotationsSchema } from '../../schemas/tier2.js';
+import { analyzeAnnotations } from '../../services/pdfjs-service.js';
+import { handleError } from '../../utils/error-handler.js';
+import { formatAnnotationsMarkdown, truncateIfNeeded } from '../../utils/formatter.js';
+export function registerInspectAnnotations(server) {
+    server.registerTool('inspect_annotations', {
+        title: 'Inspect PDF Annotations',
+        description: `Extract and categorize all annotations in a PDF document.
+
+Args:
+  - file_path (string): Absolute path to a local PDF file
+  - pages (string, optional): Page range. Format: "1-5", "3", or "1,3,5-7". Omit for all pages.
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Total annotation count, breakdown by subtype (Link, Widget, Highlight, Text, etc.) and by page, flags for links/forms/markup presence, and individual annotation details.
+
+Examples:
+  - Check for form fields (Widget annotations)
+  - Find all links in a document
+  - Inventory markup annotations (highlights, comments)`,
+        inputSchema: InspectAnnotationsSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const analysis = await analyzeAnnotations(params.file_path, params.pages);
+            const raw = params.response_format === ResponseFormat.JSON
+                ? JSON.stringify(analysis, null, 2)
+                : formatAnnotationsMarkdown(analysis);
+            const { text } = truncateIfNeeded(raw);
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: handleError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=inspect-annotations.js.map

package/dist/tools/tier2/inspect-annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-annotations.js","sourceRoot":"","sources":["../../../src/tools/tier2/inspect-annotations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAgC,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE;;;;;;;;;;;;;wDAaqC;QAClD,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAA+B,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAE1E,MAAM,GAAG,GACP,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,IAAI;gBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnC,CAAC,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;YAE1C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tier2/inspect-fonts.d.ts

@@ -0,0 +1,6 @@
+/**
+ * inspect_fonts - PDF font analysis.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerInspectFonts(server: McpServer): void;
+//# sourceMappingURL=inspect-fonts.d.ts.map

package/dist/tools/tier2/inspect-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-fonts.d.ts","sourceRoot":"","sources":["../../../src/tools/tier2/inspect-fonts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmD5D"}

package/dist/tools/tier2/inspect-fonts.js

@@ -0,0 +1,54 @@
+/**
+ * inspect_fonts - PDF font analysis.
+ */
+import { ResponseFormat } from '../../constants.js';
+import { InspectFontsSchema } from '../../schemas/tier2.js';
+import { analyzeFontsWithPdfLib } from '../../services/pdflib-service.js';
+import { handleError } from '../../utils/error-handler.js';
+import { formatFontsMarkdown, truncateIfNeeded } from '../../utils/formatter.js';
+export function registerInspectFonts(server) {
+    server.registerTool('inspect_fonts', {
+        title: 'Inspect PDF Fonts',
+        description: `List all fonts used in a PDF document with their properties.
+
+Args:
+  - file_path (string): Absolute path to a local PDF file
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Font name, type (TrueType, Type1, CIDFont, etc.), encoding, embedded/subset status, and pages where each font is used.
+
+Examples:
+  - Check if all fonts are embedded (required for PDF/A, PDF/X)
+  - Identify font types and encodings
+  - Find which pages use specific fonts`,
+        inputSchema: InspectFontsSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const result = await analyzeFontsWithPdfLib(params.file_path);
+            const fonts = Array.from(result.fontMap.values());
+            const analysis = {
+                fonts,
+                totalFontCount: fonts.length,
+                embeddedCount: fonts.filter((f) => f.isEmbedded).length,
+                subsetCount: fonts.filter((f) => f.isSubset).length,
+                pagesScanned: result.pagesScanned,
+            };
+            const raw = params.response_format === ResponseFormat.JSON
+                ? JSON.stringify(analysis, null, 2)
+                : formatFontsMarkdown(analysis);
+            const { text } = truncateIfNeeded(raw);
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: handleError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=inspect-fonts.js.map

package/dist/tools/tier2/inspect-fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-fonts.js","sourceRoot":"","sources":["../../../src/tools/tier2/inspect-fonts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA0B,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjF,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE;;;;;;;;;;;;wCAYqB;QAClC,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAAyB,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAElD,MAAM,QAAQ,GAAkB;gBAC9B,KAAK;gBACL,cAAc,EAAE,KAAK,CAAC,MAAM;gBAC5B,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM;gBACvD,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM;gBACnD,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC,CAAC;YAEF,MAAM,GAAG,GACP,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,IAAI;gBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnC,CAAC,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAEpC,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tier2/inspect-signatures.d.ts

@@ -0,0 +1,6 @@
+/**
+ * inspect_signatures - PDF digital signature analysis.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerInspectSignatures(server: McpServer): void;
+//# sourceMappingURL=inspect-signatures.d.ts.map

package/dist/tools/tier2/inspect-signatures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-signatures.d.ts","sourceRoot":"","sources":["../../../src/tools/tier2/inspect-signatures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4CjE"}

package/dist/tools/tier2/inspect-signatures.js

@@ -0,0 +1,48 @@
+/**
+ * inspect_signatures - PDF digital signature analysis.
+ */
+import { ResponseFormat } from '../../constants.js';
+import { InspectSignaturesSchema } from '../../schemas/tier2.js';
+import { analyzeSignatures } from '../../services/pdflib-service.js';
+import { handleError } from '../../utils/error-handler.js';
+import { formatSignaturesMarkdown, truncateIfNeeded } from '../../utils/formatter.js';
+export function registerInspectSignatures(server) {
+    server.registerTool('inspect_signatures', {
+        title: 'Inspect PDF Digital Signatures',
+        description: `Examine digital signature fields in a PDF document.
+
+Args:
+  - file_path (string): Absolute path to a local PDF file
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Total signature field count, signed/unsigned breakdown, and details for each field (signer name, reason, location, signing time, filter/subFilter).
+
+Note: This tool inspects signature field structure only. Cryptographic signature verification is not performed.
+
+Examples:
+  - Check if a PDF has been digitally signed
+  - Inspect signer information and signing dates
+  - Verify signature field structure`,
+        inputSchema: InspectSignaturesSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const analysis = await analyzeSignatures(params.file_path);
+            const raw = params.response_format === ResponseFormat.JSON
+                ? JSON.stringify(analysis, null, 2)
+                : formatSignaturesMarkdown(analysis);
+            const { text } = truncateIfNeeded(raw);
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: handleError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=inspect-signatures.js.map

package/dist/tools/tier2/inspect-signatures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-signatures.js","sourceRoot":"","sources":["../../../src/tools/tier2/inspect-signatures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA+B,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EAAE;;;;;;;;;;;;;;qCAckB;QAC/B,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAA8B,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAE3D,MAAM,GAAG,GACP,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,IAAI;gBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnC,CAAC,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC;YAEzC,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tier2/inspect-structure.d.ts

@@ -0,0 +1,6 @@
+/**
+ * inspect_structure - PDF internal structure analysis.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerInspectStructure(server: McpServer): void;
+//# sourceMappingURL=inspect-structure.d.ts.map

package/dist/tools/tier2/inspect-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-structure.d.ts","sourceRoot":"","sources":["../../../src/tools/tier2/inspect-structure.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0ChE"}

package/dist/tools/tier2/inspect-structure.js

@@ -0,0 +1,46 @@
+/**
+ * inspect_structure - PDF internal structure analysis.
+ */
+import { ResponseFormat } from '../../constants.js';
+import { InspectStructureSchema } from '../../schemas/tier2.js';
+import { analyzeStructure } from '../../services/pdflib-service.js';
+import { handleError } from '../../utils/error-handler.js';
+import { formatStructureMarkdown, truncateIfNeeded } from '../../utils/formatter.js';
+export function registerInspectStructure(server) {
+    server.registerTool('inspect_structure', {
+        title: 'Inspect PDF Structure',
+        description: `Examine PDF internal object structure including catalog entries, page tree, and object statistics.
+
+Args:
+  - file_path (string): Absolute path to a local PDF file
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Catalog entries (keys and types), page tree info (page count, MediaBox samples), object statistics (total count, stream count, type distribution), and encryption status.
+
+Examples:
+  - Examine document catalog for structural features
+  - Count PDF objects and streams
+  - Check page dimensions across the document`,
+        inputSchema: InspectStructureSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const analysis = await analyzeStructure(params.file_path);
+            const raw = params.response_format === ResponseFormat.JSON
+                ? JSON.stringify(analysis, null, 2)
+                : formatStructureMarkdown(analysis);
+            const { text } = truncateIfNeeded(raw);
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: handleError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=inspect-structure.js.map

package/dist/tools/tier2/inspect-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-structure.js","sourceRoot":"","sources":["../../../src/tools/tier2/inspect-structure.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA8B,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAErF,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE;;;;;;;;;;;;8CAY2B;QACxC,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAA6B,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAE1D,MAAM,GAAG,GACP,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,IAAI;gBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnC,CAAC,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;YAExC,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tier2/inspect-tags.d.ts

@@ -0,0 +1,6 @@
+/**
+ * inspect_tags - Tagged PDF structure tree analysis.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerInspectTags(server: McpServer): void;
+//# sourceMappingURL=inspect-tags.d.ts.map

package/dist/tools/tier2/inspect-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-tags.d.ts","sourceRoot":"","sources":["../../../src/tools/tier2/inspect-tags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0C3D"}

package/dist/tools/tier2/inspect-tags.js

@@ -0,0 +1,46 @@
+/**
+ * inspect_tags - Tagged PDF structure tree analysis.
+ */
+import { ResponseFormat } from '../../constants.js';
+import { InspectTagsSchema } from '../../schemas/tier2.js';
+import { analyzeTags } from '../../services/pdfjs-service.js';
+import { handleError } from '../../utils/error-handler.js';
+import { formatTagsMarkdown, truncateIfNeeded } from '../../utils/formatter.js';
+export function registerInspectTags(server) {
+    server.registerTool('inspect_tags', {
+        title: 'Inspect Tagged PDF Structure',
+        description: `Analyze the Tagged PDF structure tree for accessibility assessment.
+
+Args:
+  - file_path (string): Absolute path to a local PDF file
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Whether the PDF is tagged, the structure tree hierarchy with roles, max nesting depth, total element count, and role distribution (e.g., Document, P, H1, Table, Figure).
+
+Examples:
+  - Check if a PDF is tagged for accessibility (PDF/UA)
+  - Inspect the tag hierarchy and role distribution
+  - Assess document structure quality`,
+        inputSchema: InspectTagsSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const analysis = await analyzeTags(params.file_path);
+            const raw = params.response_format === ResponseFormat.JSON
+                ? JSON.stringify(analysis, null, 2)
+                : formatTagsMarkdown(analysis);
+            const { text } = truncateIfNeeded(raw);
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: handleError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=inspect-tags.js.map

package/dist/tools/tier2/inspect-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-tags.js","sourceRoot":"","sources":["../../../src/tools/tier2/inspect-tags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAyB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE;;;;;;;;;;;;sCAYmB;QAChC,WAAW,EAAE,iBAAiB;QAC9B,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAAwB,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAErD,MAAM,GAAG,GACP,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,IAAI;gBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAEnC,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tier3/compare-structure.d.ts

@@ -0,0 +1,6 @@
+/**
+ * compare_structure - Compare structures of two PDF documents.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCompareStructure(server: McpServer): void;
+//# sourceMappingURL=compare-structure.d.ts.map

package/dist/tools/tier3/compare-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-structure.d.ts","sourceRoot":"","sources":["../../../src/tools/tier3/compare-structure.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2ChE"}

package/dist/tools/tier3/compare-structure.js

@@ -0,0 +1,47 @@
+/**
+ * compare_structure - Compare structures of two PDF documents.
+ */
+import { ResponseFormat } from '../../constants.js';
+import { CompareStructureSchema } from '../../schemas/tier3.js';
+import { compareStructure } from '../../services/validation-service.js';
+import { handleError } from '../../utils/error-handler.js';
+import { formatCompareStructureMarkdown, truncateIfNeeded } from '../../utils/formatter.js';
+export function registerCompareStructure(server) {
+    server.registerTool('compare_structure', {
+        title: 'Compare PDF Structures',
+        description: `Compare the internal structures of two PDF documents and identify differences.
+
+Args:
+  - file_path_1 (string): Absolute path to the first PDF file
+  - file_path_2 (string): Absolute path to the second PDF file
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Structural comparison including: property-by-property diff (page count, PDF version, encryption, tagged status, object counts, page dimensions, file size, catalog entries, signatures), font comparison (fonts unique to each file and shared fonts), and a summary.
+
+Examples:
+  - Compare two versions of the same document
+  - Verify structural consistency across PDF exports
+  - Identify differences in PDF generation pipelines`,
+        inputSchema: CompareStructureSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const result = await compareStructure(params.file_path_1, params.file_path_2);
+            const raw = params.response_format === ResponseFormat.JSON
+                ? JSON.stringify(result, null, 2)
+                : formatCompareStructureMarkdown(result);
+            const { text } = truncateIfNeeded(raw);
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: handleError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=compare-structure.js.map

package/dist/tools/tier3/compare-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-structure.js","sourceRoot":"","sources":["../../../src/tools/tier3/compare-structure.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA8B,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE;;;;;;;;;;;;;qDAakC;QAC/C,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAA6B,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YAE9E,MAAM,GAAG,GACP,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,IAAI;gBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjC,CAAC,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC;YAE7C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tier3/validate-metadata.d.ts

@@ -0,0 +1,6 @@
+/**
+ * validate_metadata - PDF metadata conformance validation.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerValidateMetadata(server: McpServer): void;
+//# sourceMappingURL=validate-metadata.d.ts.map

package/dist/tools/tier3/validate-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-metadata.d.ts","sourceRoot":"","sources":["../../../src/tools/tier3/validate-metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqDhE"}

package/dist/tools/tier3/validate-metadata.js

@@ -0,0 +1,57 @@
+/**
+ * validate_metadata - PDF metadata conformance validation.
+ */
+import { ResponseFormat } from '../../constants.js';
+import { ValidateMetadataSchema } from '../../schemas/tier3.js';
+import { validateMetadata } from '../../services/validation-service.js';
+import { handleError } from '../../utils/error-handler.js';
+import { formatMetadataValidationMarkdown, truncateIfNeeded } from '../../utils/formatter.js';
+export function registerValidateMetadata(server) {
+    server.registerTool('validate_metadata', {
+        title: 'Validate PDF Metadata',
+        description: `Validate PDF metadata conformance against best practices and specification requirements.
+
+Args:
+  - file_path (string): Absolute path to a local PDF file
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Validation results including: total checks, pass/fail counts, detailed issues with severity, metadata field presence summary, and an overall summary.
+
+Checks performed:
+  - Title presence (required for PDF/UA, PDF/A)
+  - Author presence
+  - Creation date format validation
+  - Modification date presence
+  - Producer identification
+  - PDF version detection
+  - Tagged flag status
+  - Subject and Keywords presence
+  - Encryption and accessibility impact
+
+Examples:
+  - Verify PDF metadata completeness for PDF/A archival
+  - Check metadata requirements for PDF/UA compliance
+  - Audit document metadata for publishing standards`,
+        inputSchema: ValidateMetadataSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const result = await validateMetadata(params.file_path);
+            const raw = params.response_format === ResponseFormat.JSON
+                ? JSON.stringify(result, null, 2)
+                : formatMetadataValidationMarkdown(result);
+            const { text } = truncateIfNeeded(raw);
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: handleError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=validate-metadata.js.map

package/dist/tools/tier3/validate-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-metadata.js","sourceRoot":"","sources":["../../../src/tools/tier3/validate-metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA8B,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,gCAAgC,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE9F,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;qDAuBkC;QAC/C,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAA6B,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAExD,MAAM,GAAG,GACP,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,IAAI;gBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjC,CAAC,CAAC,gCAAgC,CAAC,MAAM,CAAC,CAAC;YAE/C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tier3/validate-tagged.d.ts

@@ -0,0 +1,6 @@
+/**
+ * validate_tagged - PDF/UA tagged structure validation.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerValidateTagged(server: McpServer): void;
+//# sourceMappingURL=validate-tagged.d.ts.map

package/dist/tools/tier3/validate-tagged.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-tagged.d.ts","sourceRoot":"","sources":["../../../src/tools/tier3/validate-tagged.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoD9D"}

package/dist/tools/tier3/validate-tagged.js

@@ -0,0 +1,56 @@
+/**
+ * validate_tagged - PDF/UA tagged structure validation.
+ */
+import { ResponseFormat } from '../../constants.js';
+import { ValidateTaggedSchema } from '../../schemas/tier3.js';
+import { validateTagged } from '../../services/validation-service.js';
+import { handleError } from '../../utils/error-handler.js';
+import { formatTaggedValidationMarkdown, truncateIfNeeded } from '../../utils/formatter.js';
+export function registerValidateTagged(server) {
+    server.registerTool('validate_tagged', {
+        title: 'Validate Tagged PDF',
+        description: `Validate PDF/UA tagged structure requirements.
+
+Args:
+  - file_path (string): Absolute path to a local PDF file
+  - response_format ('markdown' | 'json'): Output format (default: 'markdown')
+
+Returns:
+  Validation results including: whether the PDF is tagged, total checks performed, pass/fail counts, detailed issues with severity levels (error/warning/info), and a summary.
+
+Checks performed:
+  - Document marked as tagged
+  - Structure tree root existence
+  - Document root tag presence
+  - Heading hierarchy (H1-H6) sequential order
+  - Figure tags for images
+  - Paragraph tag presence
+  - Structure element count
+  - Table tag structure (TR/TH/TD)
+
+Examples:
+  - Check if a PDF meets PDF/UA accessibility requirements
+  - Identify missing or incorrect tag structure
+  - Assess document accessibility quality`,
+        inputSchema: ValidateTaggedSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            const result = await validateTagged(params.file_path);
+            const raw = params.response_format === ResponseFormat.JSON
+                ? JSON.stringify(result, null, 2)
+                : formatTaggedValidationMarkdown(result);
+            const { text } = truncateIfNeeded(raw);
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: handleError(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=validate-tagged.js.map

package/dist/tools/tier3/validate-tagged.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-tagged.js","sourceRoot":"","sources":["../../../src/tools/tier3/validate-tagged.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA4B,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,8BAA8B,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5F,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;0CAsBuB;QACpC,WAAW,EAAE,oBAAoB;QACjC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,MAA2B,EAAE,EAAE;QACpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAEtD,MAAM,GAAG,GACP,MAAM,CAAC,eAAe,KAAK,cAAc,CAAC,IAAI;gBAC5C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjC,CAAC,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC;YAE7C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5E,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}