@kaenova/document-intelligence-mcp 0.0.0-20260520.h0940

package/README.md

@@ -0,0 +1,254 @@
+# document-intelligence-mcp
+
+MCP server for Azure AI Document Intelligence. Exposes a single `analyze_document` tool that lets agents choose between:
+
+- **`read`** — OCR-only text extraction (fast, lightweight)
+- **`layout`** — Rich document understanding with tables, selection marks, and structure (recommended for complex documents)
+
+Results are automatically cached using SQLite (via `better-sqlite3`) for fast repeated analysis of the same document.
+
+---
+
+## Quick Start
+
+### 1. Prerequisites
+
+- Bun runtime
+- Azure Document Intelligence resource (create one in Azure Portal if you don't have it)
+
+### 2. Install Dependencies
+
+```bash
+bun install
+```
+
+### 3. Configure Environment
+
+Copy the example env file and fill in your Azure credentials:
+
+```bash
+cp .env.example .env
+```
+
+Edit `.env` with your Azure endpoint and key:
+
+```env
+AZURE_DOCUMENT_INTELLIGENCE_ENDPOINT=https://your-resource.cognitiveservices.azure.com/
+AZURE_DOCUMENT_INTELLIGENCE_KEY=your-api-key-here
+```
+
+### 4. Run the Server
+
+```bash
+bun run dev
+```
+
+The server runs in stdio mode and is ready to be used by any MCP-compatible client.
+
+---
+
+## Configuration in Agent Harness (Pi)
+
+Add this MCP server to your Pi agent by editing the configuration file:
+
+```bash
+~/.pi/agent/mcp.json
+```
+
+### Option 1: Using the Published Package (Recommended)
+
+```json
+{
+  "mcpServers": {
+    "document-intelligence": {
+      "command": "bunx",
+      "args": ["@kaenova/document-intelligence-mcp"],
+      "env": {
+        "AZURE_DOCUMENT_INTELLIGENCE_ENDPOINT": "https://your-resource.cognitiveservices.azure.com/",
+        "AZURE_DOCUMENT_INTELLIGENCE_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Option 2: Local Development (Cloned Repository)
+
+```json
+{
+  "mcpServers": {
+    "document-intelligence": {
+      "command": "bun",
+      "args": ["run", "src/index.ts"],
+      "cwd": "/absolute/path/to/your/document-intelligence-mcp",
+      "env": {
+        "AZURE_DOCUMENT_INTELLIGENCE_ENDPOINT": "https://your-resource.cognitiveservices.azure.com/",
+        "AZURE_DOCUMENT_INTELLIGENCE_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Option 3: Using npx
+
+```json
+{
+  "mcpServers": {
+    "document-intelligence": {
+      "command": "npx",
+      "args": ["-y", "@kaenova/document-intelligence-mcp"],
+      "env": {
+        "AZURE_DOCUMENT_INTELLIGENCE_ENDPOINT": "https://your-resource.cognitiveservices.azure.com/",
+        "AZURE_DOCUMENT_INTELLIGENCE_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+### Notes
+
+- After editing `mcp.json`, restart your Pi agent or reload the MCP configuration.
+- For local development, make sure to replace the `cwd` path with the actual location of your cloned repository.
+- You can also load credentials from a `.env` file instead of hardcoding them in `mcp.json`.
+
+---
+
+## Installation via npm (Recommended for most users)
+
+Once published, you can use the package **without cloning** the repository.
+
+> **Note:** npm requires semver, so published versions use a semver-compatible date stamp in GMT+7, for example: `0.0.0-20260520.h1530`
+
+### Using with `bunx` (recommended if you have Bun)
+
+```json
+{
+  "mcpServers": {
+    "document-intelligence": {
+      "command": "bunx",
+      "args": ["@kaenova/document-intelligence-mcp"],
+      "env": {
+        "AZURE_DOCUMENT_INTELLIGENCE_ENDPOINT": "https://your-resource.cognitiveservices.azure.com/",
+        "AZURE_DOCUMENT_INTELLIGENCE_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Using with `npx`
+
+```json
+{
+  "mcpServers": {
+    "document-intelligence": {
+      "command": "npx",
+      "args": ["-y", "@kaenova/document-intelligence-mcp"],
+      "env": {
+        "AZURE_DOCUMENT_INTELLIGENCE_ENDPOINT": "https://your-resource.cognitiveservices.azure.com/",
+        "AZURE_DOCUMENT_INTELLIGENCE_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Usage
+
+### The `analyze_document` Tool
+
+This MCP server exposes a single powerful tool:
+
+```json
+analyze_document(model, source)
+```
+
+#### Parameters
+
+| Parameter | Type                    | Description                                                                 |
+|-----------|-------------------------|-----------------------------------------------------------------------------|
+| `model`   | `"read"` \| `"layout"` | The analysis model to use                                                   |
+| `source`  | `string`                | Local file path **or** public HTTPS URL (automatically detected)            |
+
+#### Choosing the Right Model
+
+| Model    | Best For                                      | Output Highlights                     | Speed     |
+|----------|-----------------------------------------------|---------------------------------------|-----------|
+| `read`   | Simple text extraction, language detection    | Raw text, pages, detected languages   | Fast      |
+| `layout` | Documents with tables, forms, structure       | Tables, selection marks, rich layout  | Slightly slower |
+
+**Recommendation:** Use `layout` unless you specifically only need raw OCR text.
+
+#### Examples
+
+**Local PDF file with layout analysis:**
+
+```json
+{
+  "model": "layout",
+  "source": "/Users/me/invoices/Q2-report.pdf"
+}
+```
+
+**Public URL with read-only OCR:**
+
+```json
+{
+  "model": "read",
+  "source": "https://example.com/annual-report-2025.pdf"
+}
+```
+
+**Image file:**
+
+```json
+{
+  "model": "layout",
+  "source": "./screenshots/contract-page1.png"
+}
+```
+
+### Caching
+
+- Results are automatically cached based on the **file content hash** + model.
+- If you analyze the same file again with the same model, you get the cached result instantly.
+- Cache is stored in SQLite (`DI_CACHE_PATH`, default: `.cache/di-cache.sqlite`).
+
+### Supported File Types
+
+- **PDF**
+- **Images**: JPG, JPEG, PNG, BMP, TIFF, HEIF
+- **Office Documents**: DOCX, PPTX, XLSX
+
+---
+
+The tool returns a well-formatted Markdown document with extracted content, tables (when using `layout`), pages, and language information. Results are cached based on file content hash + model.
+
+---
+
+## Development
+
+```bash
+# Watch mode
+bun run dev
+
+# Type checking
+bun run typecheck
+
+# Build for production
+bun run build
+```
+
+---
+
+## License
+
+MIT
+
+---
+
+*Built with FastMCP and the official Azure AI Form Recognizer SDK.*

package/dist/formatters/layout-formatter.d.ts

@@ -0,0 +1,3 @@
+import type { AnalyzeResult } from "@azure/ai-form-recognizer";
+export declare function formatLayoutResult(result: AnalyzeResult, source: string): string;
+//# sourceMappingURL=layout-formatter.d.ts.map

package/dist/formatters/layout-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-formatter.d.ts","sourceRoot":"","sources":["../../src/formatters/layout-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAwC,MAAM,2BAA2B,CAAC;AAErG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAkDhF"}

package/dist/formatters/layout-formatter.js

@@ -0,0 +1,89 @@
+export function formatLayoutResult(result, source) {
+    const lines = [];
+    lines.push(`# Document Analysis — Layout Model`);
+    lines.push(`**Source:** \`${source}\``);
+    lines.push("");
+    // Content
+    lines.push("## Content");
+    if (result.content) {
+        lines.push(result.content);
+    }
+    else {
+        lines.push("_No text content extracted._");
+    }
+    lines.push("");
+    // Pages
+    lines.push("## Pages");
+    if (result.pages && result.pages.length > 0) {
+        for (const page of result.pages) {
+            const pageNum = page.pageNumber ?? "?";
+            const width = page.width ?? "?";
+            const height = page.height ?? "?";
+            const unit = page.unit ?? "pixel";
+            lines.push(`- Page ${pageNum}: ${width}×${height} ${unit}`);
+        }
+    }
+    else {
+        lines.push("- No page information available.");
+    }
+    lines.push("");
+    // Tables
+    if (result.tables && result.tables.length > 0) {
+        lines.push("## Tables");
+        result.tables.forEach((table, idx) => {
+            lines.push(formatTable(table, idx + 1));
+            lines.push("");
+        });
+    }
+    // Selection Marks
+    if (result.selectionMarks && result.selectionMarks.length > 0) {
+        lines.push("## Selection Marks");
+        result.selectionMarks.forEach((mark, idx) => {
+            lines.push(formatSelectionMark(mark, idx + 1));
+        });
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function formatTable(table, tableNum) {
+    const lines = [];
+    const rowCount = table.rowCount ?? 0;
+    const colCount = table.columnCount ?? 0;
+    lines.push(`### Table ${tableNum} (${colCount} columns × ${rowCount} rows)`);
+    // Build markdown table
+    const cells = Array.from({ length: rowCount }, () => Array(colCount).fill(""));
+    if (table.cells) {
+        for (const cell of table.cells) {
+            const rowIdx = cell.rowIndex ?? 0;
+            const colIdx = cell.columnIndex ?? 0;
+            const content = cell.content ?? "";
+            if (cells[rowIdx]) {
+                cells[rowIdx][colIdx] = content.replace(/\n/g, " ").trim();
+            }
+        }
+    }
+    if (cells.length > 0 && cells[0]) {
+        // Header row
+        lines.push("| " + cells[0].join(" | ") + " |");
+        lines.push("| " + cells[0].map(() => "---").join(" | ") + " |");
+        // Data rows
+        for (let i = 1; i < cells.length; i++) {
+            const row = cells[i];
+            if (row) {
+                lines.push("| " + row.join(" | ") + " |");
+            }
+        }
+    }
+    else {
+        lines.push("_Empty table_");
+    }
+    return lines.join("\n");
+}
+function formatSelectionMark(mark, markNum) {
+    const state = mark.state === "selected" ? "[x]" : "[ ]";
+    const confidence = mark.confidence !== undefined
+        ? ` (confidence: ${(mark.confidence * 100).toFixed(1)}%)`
+        : "";
+    return `- ${state} Selection mark ${markNum}${confidence}`;
+}
+//# sourceMappingURL=layout-formatter.js.map

package/dist/formatters/layout-formatter.js.map

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

package/dist/formatters/read-formatter.d.ts

@@ -0,0 +1,3 @@
+import type { AnalyzeResult } from "@azure/ai-form-recognizer";
+export declare function formatReadResult(result: AnalyzeResult, source: string): string;
+//# sourceMappingURL=read-formatter.d.ts.map

package/dist/formatters/read-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-formatter.d.ts","sourceRoot":"","sources":["../../src/formatters/read-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAmD9E"}

package/dist/formatters/read-formatter.js

@@ -0,0 +1,48 @@
+export function formatReadResult(result, source) {
+    const lines = [];
+    lines.push(`# Document Analysis — Read Model`);
+    lines.push(`**Source:** \`${source}\``);
+    lines.push("");
+    // Content
+    lines.push("## Content");
+    if (result.content) {
+        lines.push(result.content);
+    }
+    else {
+        lines.push("_No text content extracted._");
+    }
+    lines.push("");
+    // Pages
+    lines.push("## Pages");
+    if (result.pages && result.pages.length > 0) {
+        for (const page of result.pages) {
+            const pageNum = page.pageNumber ?? "?";
+            const width = page.width ?? "?";
+            const height = page.height ?? "?";
+            const unit = page.unit ?? "pixel";
+            const wordCount = page.words?.length ?? 0;
+            const lineCount = page.lines?.length ?? 0;
+            lines.push(`- Page ${pageNum}: ${width}×${height} ${unit}, ${wordCount} words, ${lineCount} lines`);
+        }
+    }
+    else {
+        lines.push("- No page information available.");
+    }
+    lines.push("");
+    // Languages
+    lines.push("## Languages");
+    if (result.languages && result.languages.length > 0) {
+        for (const lang of result.languages) {
+            const locale = lang.locale ?? "unknown";
+            const confidence = lang.confidence !== undefined
+                ? `${(lang.confidence * 100).toFixed(1)}%`
+                : "N/A";
+            lines.push(`- ${locale} (confidence: ${confidence})`);
+        }
+    }
+    else {
+        lines.push("- No language information detected.");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=read-formatter.js.map

package/dist/formatters/read-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-formatter.js","sourceRoot":"","sources":["../../src/formatters/read-formatter.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,MAAqB,EAAE,MAAc;IACpE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,UAAU;IACV,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC7C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,QAAQ;IACR,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC;YAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;YAE1C,KAAK,CAAC,IAAI,CACR,UAAU,OAAO,KAAK,KAAK,IAAI,MAAM,IAAI,IAAI,KAAK,SAAS,WAAW,SAAS,QAAQ,CACxF,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,YAAY;IACZ,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,SAAS,CAAC;YACxC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,KAAK,SAAS;gBAC9C,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;gBAC1C,CAAC,CAAC,KAAK,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,iBAAiB,UAAU,GAAG,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env bun
+import { FastMCP } from "fastmcp";
+import { z } from "zod";
+import { AnalyzeDocumentSchema } from "./tools/schemas.js";
+import { analyzeDocument } from "./tools/analyze-document.js";
+const server = new FastMCP({
+    name: "document-intelligence",
+    version: "0.1.0",
+});
+server.addTool({
+    name: "analyze_document",
+    description: "Analyze a document using Azure AI Document Intelligence. " +
+        "Choose 'read' for OCR-only text extraction or 'layout' for rich structure including tables and selection marks. " +
+        "The 'source' parameter accepts either a local file path or a public URL (auto-detected). " +
+        "Results are cached for faster subsequent calls on unchanged documents.",
+    parameters: AnalyzeDocumentSchema,
+    execute: async (args, { log }) => {
+        log.info("Starting document analysis", { model: args.model, source: args.source });
+        const result = await analyzeDocument(args);
+        log.info("Document analysis completed", {
+            model: args.model,
+            source: args.source,
+            resultLength: result.length
+        });
+        return result;
+    },
+});
+server.start({
+    transportType: "stdio",
+});
+console.error("Document Intelligence MCP Server started (stdio mode)");
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC;IACzB,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,OAAO,CAAC;IACb,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,2DAA2D;QAC3D,kHAAkH;QAClH,2FAA2F;QAC3F,wEAAwE;IAC1E,UAAU,EAAE,qBAAqB;IACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAC/B,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAEnF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;QAE3C,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE;YACtC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,YAAY,EAAE,MAAM,CAAC,MAAM;SAC5B,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,CAAC;IACX,aAAa,EAAE,OAAO;CACvB,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC"}

package/dist/services/cache.d.ts

@@ -0,0 +1,35 @@
+import type { AnalysisModel } from "../types.js";
+export declare class AnalysisCache {
+    private db;
+    constructor(cachePath?: string);
+    private initSchema;
+    /**
+     * Compute SHA-256 hash of the input string.
+     */
+    private hash;
+    /**
+     * Compute cache key from model + content hash.
+     */
+    computeCacheKey(model: AnalysisModel, contentHash: string): string;
+    /**
+     * Compute SHA-256 hash of file content (for local files).
+     */
+    computeFileHash(filePath: string): Promise<string>;
+    /**
+     * Compute hash for URL source (hash of the URL string itself).
+     */
+    computeUrlHash(url: string): string;
+    /**
+     * Retrieve cached result if exists.
+     */
+    get(cacheKey: string): string | null;
+    /**
+     * Store result in cache.
+     */
+    set(cacheKey: string, model: AnalysisModel, sourceType: "file" | "url", contentHash: string, result: string): void;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/services/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAoB;gBAElB,SAAS,GAAE,MAA2B;IAWlD,OAAO,CAAC,UAAU;IAgBlB;;OAEG;IACH,OAAO,CAAC,IAAI;IAIZ;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAIlE;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKxD;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAInC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAiBpC;;OAEG;IACH,GAAG,CACD,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,GAAG,KAAK,EAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,IAAI;IASP;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/services/cache.js

@@ -0,0 +1,93 @@
+import Database from "better-sqlite3";
+import { createHash } from "crypto";
+import * as fs from "fs";
+import * as path from "path";
+const DEFAULT_CACHE_PATH = "./.cache/di-cache.sqlite";
+export class AnalysisCache {
+    db;
+    constructor(cachePath = DEFAULT_CACHE_PATH) {
+        // Ensure cache directory exists
+        const dir = path.dirname(cachePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        this.db = new Database(cachePath);
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS analysis_cache (
+        cache_key TEXT PRIMARY KEY,
+        model TEXT NOT NULL,
+        source_type TEXT NOT NULL,
+        content_hash TEXT NOT NULL,
+        result TEXT NOT NULL,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        accessed_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_accessed_at ON analysis_cache(accessed_at);
+    `);
+    }
+    /**
+     * Compute SHA-256 hash of the input string.
+     */
+    hash(input) {
+        return createHash("sha256").update(input).digest("hex");
+    }
+    /**
+     * Compute cache key from model + content hash.
+     */
+    computeCacheKey(model, contentHash) {
+        return this.hash(`${model}|${contentHash}`);
+    }
+    /**
+     * Compute SHA-256 hash of file content (for local files).
+     */
+    async computeFileHash(filePath) {
+        const fileBuffer = await fs.promises.readFile(filePath);
+        return this.hash(fileBuffer.toString("binary")); // binary to handle any file type
+    }
+    /**
+     * Compute hash for URL source (hash of the URL string itself).
+     */
+    computeUrlHash(url) {
+        return this.hash(url);
+    }
+    /**
+     * Retrieve cached result if exists.
+     */
+    get(cacheKey) {
+        const stmt = this.db.prepare(`
+      SELECT result FROM analysis_cache WHERE cache_key = ?
+    `);
+        const row = stmt.get(cacheKey);
+        if (row) {
+            // Update accessed_at
+            const updateStmt = this.db.prepare(`
+        UPDATE analysis_cache SET accessed_at = datetime('now') WHERE cache_key = ?
+      `);
+            updateStmt.run(cacheKey);
+            return row.result;
+        }
+        return null;
+    }
+    /**
+     * Store result in cache.
+     */
+    set(cacheKey, model, sourceType, contentHash, result) {
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO analysis_cache 
+      (cache_key, model, source_type, content_hash, result, created_at, accessed_at)
+      VALUES (?, ?, ?, ?, ?, datetime('now'), datetime('now'))
+    `);
+        stmt.run(cacheKey, model, sourceType, contentHash, result);
+    }
+    /**
+     * Close the database connection.
+     */
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/services/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/services/cache.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAEtD,MAAM,OAAO,aAAa;IAChB,EAAE,CAAoB;IAE9B,YAAY,YAAoB,kBAAkB;QAChD,gCAAgC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;KAYZ,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,IAAI,CAAC,KAAa;QACxB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,KAAoB,EAAE,WAAmB;QACvD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,WAAW,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,QAAgB;QACpC,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,iCAAiC;IACpF,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,GAAW;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,QAAgB;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;KAE5B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAmC,CAAC;QAEjE,IAAI,GAAG,EAAE,CAAC;YACR,qBAAqB;YACrB,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;OAElC,CAAC,CAAC;YACH,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACzB,OAAO,GAAG,CAAC,MAAM,CAAC;QACpB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,GAAG,CACD,QAAgB,EAChB,KAAoB,EACpB,UAA0B,EAC1B,WAAmB,EACnB,MAAc;QAEd,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;KAI5B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/services/document-intelligence.d.ts

@@ -0,0 +1,14 @@
+import type { AnalyzeResult } from "@azure/ai-form-recognizer";
+import type { AnalysisModel } from "../types.js";
+export declare class DocumentIntelligenceService {
+    private client;
+    constructor();
+    /**
+     * Analyze a document using the specified model.
+     * Supports both local file paths and public URLs.
+     */
+    analyzeDocument(source: string, model: AnalysisModel): Promise<AnalyzeResult>;
+    private getModelId;
+    private getContentType;
+}
+//# sourceMappingURL=document-intelligence.d.ts.map

package/dist/services/document-intelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-intelligence.d.ts","sourceRoot":"","sources":["../../src/services/document-intelligence.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,qBAAa,2BAA2B;IACtC,OAAO,CAAC,MAAM,CAAyB;;IAoBvC;;;OAGG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,aAAa,CAAC;IAgBzB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,cAAc;CA2BvB"}

package/dist/services/document-intelligence.js

@@ -0,0 +1,74 @@
+import { DocumentAnalysisClient, AzureKeyCredential, } from "@azure/ai-form-recognizer";
+import { readFile } from "fs/promises";
+import { Readable } from "stream";
+const DEFAULT_API_VERSION = "2024-11-30";
+export class DocumentIntelligenceService {
+    client;
+    constructor() {
+        const endpoint = process.env.AZURE_DOCUMENT_INTELLIGENCE_ENDPOINT;
+        const key = process.env.AZURE_DOCUMENT_INTELLIGENCE_KEY;
+        const apiVersion = process.env.AZURE_DOCUMENT_INTELLIGENCE_API_VERSION || DEFAULT_API_VERSION;
+        if (!endpoint || !key) {
+            throw new Error("Missing Azure Document Intelligence credentials. " +
+                "Please set AZURE_DOCUMENT_INTELLIGENCE_ENDPOINT and AZURE_DOCUMENT_INTELLIGENCE_KEY environment variables.");
+        }
+        this.client = new DocumentAnalysisClient(endpoint, new AzureKeyCredential(key));
+    }
+    /**
+     * Analyze a document using the specified model.
+     * Supports both local file paths and public URLs.
+     */
+    async analyzeDocument(source, model) {
+        const modelId = this.getModelId(model);
+        if (/^https?:\/\//i.test(source)) {
+            // URL source
+            const poller = await this.client.beginAnalyzeDocumentFromUrl(modelId, source);
+            return await poller.pollUntilDone();
+        }
+        else {
+            // Local file source
+            const fileBuffer = await readFile(source);
+            const stream = Readable.from(fileBuffer);
+            const poller = await this.client.beginAnalyzeDocument(modelId, stream);
+            return await poller.pollUntilDone();
+        }
+    }
+    getModelId(model) {
+        switch (model) {
+            case "read":
+                return "prebuilt-read";
+            case "layout":
+                return "prebuilt-layout";
+            default:
+                throw new Error(`Unknown model: ${model}`);
+        }
+    }
+    getContentType(filePath) {
+        const ext = filePath.toLowerCase().split(".").pop() || "";
+        switch (ext) {
+            case "pdf":
+                return "application/pdf";
+            case "jpg":
+            case "jpeg":
+                return "image/jpeg";
+            case "png":
+                return "image/png";
+            case "bmp":
+                return "image/bmp";
+            case "tiff":
+            case "tif":
+                return "image/tiff";
+            case "heif":
+                return "image/heif";
+            case "docx":
+                return "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+            case "pptx":
+                return "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+            case "xlsx":
+                return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+            default:
+                return "application/octet-stream";
+        }
+    }
+}
+//# sourceMappingURL=document-intelligence.js.map

package/dist/services/document-intelligence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-intelligence.js","sourceRoot":"","sources":["../../src/services/document-intelligence.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEzC,MAAM,OAAO,2BAA2B;IAC9B,MAAM,CAAyB;IAEvC;QACE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC;QAClE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC;QACxD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,uCAAuC,IAAI,mBAAmB,CAAC;QAE9F,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,mDAAmD;gBACjD,4GAA4G,CAC/G,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,sBAAsB,CACtC,QAAQ,EACR,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAC5B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,MAAc,EACd,KAAoB;QAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAEvC,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,aAAa;YACb,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9E,OAAO,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,oBAAoB;YACpB,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvE,OAAO,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,KAAoB;QACrC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,OAAO,eAAe,CAAC;YACzB,KAAK,QAAQ;gBACX,OAAO,iBAAiB,CAAC;YAC3B;gBACE,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,QAAgB;QACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAC1D,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,KAAK;gBACR,OAAO,iBAAiB,CAAC;YAC3B,KAAK,KAAK,CAAC;YACX,KAAK,MAAM;gBACT,OAAO,YAAY,CAAC;YACtB,KAAK,KAAK;gBACR,OAAO,WAAW,CAAC;YACrB,KAAK,KAAK;gBACR,OAAO,WAAW,CAAC;YACrB,KAAK,MAAM,CAAC;YACZ,KAAK,KAAK;gBACR,OAAO,YAAY,CAAC;YACtB,KAAK,MAAM;gBACT,OAAO,YAAY,CAAC;YACtB,KAAK,MAAM;gBACT,OAAO,yEAAyE,CAAC;YACnF,KAAK,MAAM;gBACT,OAAO,2EAA2E,CAAC;YACrF,KAAK,MAAM;gBACT,OAAO,mEAAmE,CAAC;YAC7E;gBACE,OAAO,0BAA0B,CAAC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/tools/analyze-document.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import { AnalyzeDocumentSchema } from "./schemas.js";
+/**
+ * Main tool handler for analyze_document.
+ */
+export declare function analyzeDocument(params: z.infer<typeof AnalyzeDocumentSchema>): Promise<string>;
+//# sourceMappingURL=analyze-document.d.ts.map

package/dist/tools/analyze-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-document.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-document.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AA0BrD;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAgEpG"}

package/dist/tools/analyze-document.js

@@ -0,0 +1,82 @@
+import { UserError } from "fastmcp";
+import { z } from "zod";
+import { AnalyzeDocumentSchema } from "./schemas.js";
+import { DocumentIntelligenceService } from "../services/document-intelligence.js";
+import { AnalysisCache } from "../services/cache.js";
+import { formatReadResult } from "../formatters/read-formatter.js";
+import { formatLayoutResult } from "../formatters/layout-formatter.js";
+import * as fs from "fs";
+let diService = null;
+let cache = null;
+function getDIService() {
+    if (!diService) {
+        diService = new DocumentIntelligenceService();
+    }
+    return diService;
+}
+function getCache() {
+    if (!cache) {
+        const cachePath = process.env.DI_CACHE_PATH;
+        cache = new AnalysisCache(cachePath);
+    }
+    return cache;
+}
+/**
+ * Main tool handler for analyze_document.
+ */
+export async function analyzeDocument(params) {
+    const { model, source } = params;
+    const cacheService = getCache();
+    const diService = getDIService();
+    // Determine source type
+    const isUrl = /^https?:\/\//i.test(source);
+    const sourceType = isUrl ? "url" : "file";
+    // Validate local file exists
+    if (!isUrl) {
+        if (!fs.existsSync(source)) {
+            throw new UserError(`File not found: ${source}`);
+        }
+        // Basic extension check
+        const ext = source.toLowerCase().split(".").pop();
+        const supported = ["pdf", "jpg", "jpeg", "png", "bmp", "tiff", "tif", "heif", "docx", "pptx", "xlsx"];
+        if (ext && !supported.includes(ext)) {
+            throw new UserError(`Unsupported file type: .${ext}. Supported: PDF, images (JPG, PNG, BMP, TIFF, HEIF), DOCX, PPTX, XLSX`);
+        }
+    }
+    // Compute content hash / cache key
+    let contentHash;
+    if (isUrl) {
+        contentHash = cacheService.computeUrlHash(source);
+    }
+    else {
+        contentHash = await cacheService.computeFileHash(source);
+    }
+    const cacheKey = cacheService.computeCacheKey(model, contentHash);
+    // Check cache
+    const cachedResult = cacheService.get(cacheKey);
+    if (cachedResult) {
+        return cachedResult;
+    }
+    // Cache miss — call Azure
+    try {
+        const analysisResult = await diService.analyzeDocument(source, model);
+        // Format based on model
+        let markdown;
+        if (model === "read") {
+            markdown = formatReadResult(analysisResult, source);
+        }
+        else {
+            markdown = formatLayoutResult(analysisResult, source);
+        }
+        // Store in cache
+        cacheService.set(cacheKey, model, sourceType, contentHash, markdown);
+        return markdown;
+    }
+    catch (error) {
+        if (error instanceof UserError)
+            throw error;
+        console.error("Azure Document Intelligence error:", error);
+        throw new UserError(`Failed to analyze document: ${error.message || "Unknown error"}`);
+    }
+}
+//# sourceMappingURL=analyze-document.js.map

package/dist/tools/analyze-document.js.map

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

package/dist/tools/schemas.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const AnalyzeDocumentSchema: z.ZodObject<{
+    model: z.ZodEnum<{
+        read: "read";
+        layout: "layout";
+    }>;
+    source: z.ZodString;
+}, z.core.$strip>;
+export type AnalyzeDocumentInput = z.infer<typeof AnalyzeDocumentSchema>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;iBAqBjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/tools/schemas.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+export const AnalyzeDocumentSchema = z.object({
+    model: z.enum(["read", "layout"]).describe("Analysis model: 'read' for OCR-only text extraction, " +
+        "'layout' for rich structure including tables and selection marks. " +
+        "Use 'read' for simple text content, 'layout' for documents with tables or complex structure."),
+    source: z.string().min(1).describe("Document source: a local file path (e.g., '/path/to/doc.pdf') " +
+        "or a publicly accessible URL (e.g., 'https://example.com/doc.pdf'). " +
+        "The server auto-detects whether it's a file path or URL."),
+}).refine((data) => {
+    const isUrl = /^https?:\/\//i.test(data.source);
+    if (isUrl)
+        return true;
+    // For local paths, we will validate existence at runtime in the tool handler
+    return true;
+}, {
+    message: "Source must be a valid URL (starting with http:// or https://) or a local file path.",
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CACxC,uDAAuD;QACrD,oEAAoE;QACpE,8FAA8F,CACjG;IACD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAChC,gEAAgE;QAC9D,sEAAsE;QACtE,0DAA0D,CAC7D;CACF,CAAC,CAAC,MAAM,CACP,CAAC,IAAI,EAAE,EAAE;IACP,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IACvB,6EAA6E;IAC7E,OAAO,IAAI,CAAC;AACd,CAAC,EACD;IACE,OAAO,EAAE,sFAAsF;CAChG,CACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared TypeScript types for the Document Intelligence MCP server.
+ */
+export type AnalysisModel = "read" | "layout";
+export interface AnalyzeDocumentParams {
+    model: AnalysisModel;
+    source: string;
+}
+export interface AnalysisResult {
+    model: AnalysisModel;
+    source: string;
+    sourceType: "file" | "url";
+    contentHash: string;
+    markdown: string;
+    cached: boolean;
+}
+export interface CacheEntry {
+    cacheKey: string;
+    model: AnalysisModel;
+    sourceType: "file" | "url";
+    contentHash: string;
+    result: string;
+    createdAt: string;
+    accessedAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared TypeScript types for the Document Intelligence MCP server.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@kaenova/document-intelligence-mcp",
+  "version": "0.0.0-20260520.h0940",
+  "description": "MCP server for Azure AI Document Intelligence with Read and Layout models",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kaenova/document-intelligence-mcp"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "document-intelligence-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "bun run --watch src/index.ts",
+    "start": "bun run src/index.ts",
+    "build": "bunx tsc -p tsconfig.build.json",
+    "typecheck": "bunx tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "bun run build && bun run typecheck"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/bun": "latest",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@azure/ai-form-recognizer": "^5.1.0",
+    "better-sqlite3": "^12.10.0",
+    "fastmcp": "^4.0.1",
+    "zod": "^4.4.3"
+  }
+}