@intelligentelectron/pdf-analyzer 0.0.3

package/dist/cli/updater.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Auto-updater for pdf-analyzer server.
+ *
+ * Checks GitHub Releases for newer versions and self-updates on startup.
+ * Can be disabled via PDF_MCP_NO_UPDATE=1 environment variable.
+ */
+/** Result of an update check. */
+export interface UpdateCheckResult {
+    updateAvailable: boolean;
+    currentVersion: string;
+    latestVersion: string | null;
+    downloadUrl: string | null;
+    error?: string;
+}
+/** Result of an update operation. */
+export interface UpdateResult {
+    success: boolean;
+    previousVersion: string;
+    newVersion: string | null;
+    error?: string;
+}
+/**
+ * Check if an update is available.
+ */
+export declare const checkForUpdate: () => Promise<UpdateCheckResult>;
+/**
+ * Perform the update by downloading and replacing the current binary.
+ */
+export declare const performUpdate: (downloadUrl: string, newVersion: string) => Promise<UpdateResult>;
+/**
+ * Re-execute the current process with the same arguments.
+ */
+export declare const reexec: () => never;
+/**
+ * Check for updates and apply if available.
+ * This is the main entry point for auto-updates on startup.
+ */
+export declare const autoUpdate: () => Promise<boolean>;

package/dist/cli/updater.js

@@ -0,0 +1,301 @@
+/**
+ * Auto-updater for pdf-analyzer server.
+ *
+ * Checks GitHub Releases for newer versions and self-updates on startup.
+ * Can be disabled via PDF_MCP_NO_UPDATE=1 environment variable.
+ */
+import { createWriteStream, chmodSync, renameSync, unlinkSync, existsSync, readdirSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, dirname, basename } from "node:path";
+import { spawn } from "node:child_process";
+import { VERSION, GITHUB_REPO, BINARY_NAME } from "../version.js";
+/**
+ * Get the platform-specific binary name.
+ */
+const getPlatformBinaryName = () => {
+    const platform = process.platform;
+    const arch = process.arch;
+    if (platform === "darwin") {
+        return arch === "arm64" ? `${BINARY_NAME}-darwin-arm64` : `${BINARY_NAME}-darwin-x64`;
+    }
+    else if (platform === "linux") {
+        return arch === "arm64" ? `${BINARY_NAME}-linux-arm64` : `${BINARY_NAME}-linux-x64`;
+    }
+    else if (platform === "win32") {
+        return `${BINARY_NAME}-windows-x64.exe`;
+    }
+    throw new Error(`Unsupported platform: ${platform}-${arch}`);
+};
+/**
+ * Parse a version string into comparable parts.
+ */
+const parseVersion = (version) => {
+    const cleaned = version.replace(/^v/, "");
+    return cleaned.split(".").map((part) => parseInt(part, 10) || 0);
+};
+/**
+ * Compare two version strings. Returns:
+ * - Negative if a < b
+ * - Zero if a === b
+ * - Positive if a > b
+ */
+const compareVersions = (a, b) => {
+    const partsA = parseVersion(a);
+    const partsB = parseVersion(b);
+    const maxLen = Math.max(partsA.length, partsB.length);
+    for (let i = 0; i < maxLen; i++) {
+        const numA = partsA[i] || 0;
+        const numB = partsB[i] || 0;
+        if (numA !== numB) {
+            return numA - numB;
+        }
+    }
+    return 0;
+};
+/**
+ * Fetch the latest release from GitHub.
+ */
+const fetchLatestRelease = async () => {
+    const url = `https://api.github.com/repos/${GITHUB_REPO}/releases/latest`;
+    const response = await fetch(url, {
+        headers: {
+            Accept: "application/vnd.github.v3+json",
+            "User-Agent": `${BINARY_NAME}/${VERSION}`,
+        },
+    });
+    if (!response.ok) {
+        if (response.status === 404) {
+            throw new Error("No releases found");
+        }
+        throw new Error(`GitHub API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+};
+/**
+ * Check if an update is available.
+ */
+export const checkForUpdate = async () => {
+    try {
+        const release = await fetchLatestRelease();
+        const latestVersion = release.tag_name.replace(/^v/, "");
+        const updateAvailable = compareVersions(latestVersion, VERSION) > 0;
+        let downloadUrl = null;
+        if (updateAvailable) {
+            const binaryName = getPlatformBinaryName();
+            const asset = release.assets.find((a) => a.name === binaryName);
+            if (asset) {
+                downloadUrl = asset.browser_download_url;
+            }
+        }
+        return {
+            updateAvailable,
+            currentVersion: VERSION,
+            latestVersion,
+            downloadUrl,
+        };
+    }
+    catch (error) {
+        return {
+            updateAvailable: false,
+            currentVersion: VERSION,
+            latestVersion: null,
+            downloadUrl: null,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+};
+/**
+ * Download a file from a URL to a local path.
+ */
+const downloadFile = async (url, destPath) => {
+    const response = await fetch(url, {
+        headers: {
+            "User-Agent": `${BINARY_NAME}/${VERSION}`,
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Download failed: ${response.status} ${response.statusText}`);
+    }
+    const fileStream = createWriteStream(destPath);
+    return new Promise((resolve, reject) => {
+        if (!response.body) {
+            reject(new Error("No response body"));
+            return;
+        }
+        const reader = response.body.getReader();
+        const pump = async () => {
+            const { done, value } = await reader.read();
+            if (done) {
+                fileStream.end();
+                return;
+            }
+            fileStream.write(Buffer.from(value));
+            return pump();
+        };
+        fileStream.on("finish", resolve);
+        fileStream.on("error", reject);
+        pump().catch(reject);
+    });
+};
+/**
+ * Get the path to the current executable.
+ */
+const getCurrentExecutablePath = () => {
+    // For Bun-compiled binaries, process.execPath points to the binary itself
+    // For Node.js, process.argv[1] is the script path
+    if (process.execPath.includes("node") || process.execPath.includes("bun")) {
+        // Running via node/bun interpreter - use argv[1]
+        return process.argv[1];
+    }
+    // Compiled binary - use execPath
+    return process.execPath;
+};
+/**
+ * Generate a unique backup path with timestamp to avoid conflicts with locked files.
+ * On Windows, previous backup files may still be locked by the old process.
+ */
+const getBackupPath = (currentPath) => {
+    return `${currentPath}.backup.${Date.now()}`;
+};
+/**
+ * Clean up old backup files from previous updates (best effort).
+ * On Windows, backup files may remain if the old process was still running.
+ * This is non-fatal - if files are locked, they'll be cleaned up next time.
+ */
+const cleanupOldBackups = (currentPath) => {
+    const dir = dirname(currentPath);
+    const base = basename(currentPath);
+    try {
+        const files = readdirSync(dir);
+        for (const file of files) {
+            if (file.startsWith(`${base}.backup.`)) {
+                try {
+                    unlinkSync(join(dir, file));
+                }
+                catch {
+                    // Ignore - file may still be locked
+                }
+            }
+        }
+    }
+    catch {
+        // Ignore directory read errors
+    }
+};
+/**
+ * Perform the update by downloading and replacing the current binary.
+ */
+export const performUpdate = async (downloadUrl, newVersion) => {
+    const currentPath = getCurrentExecutablePath();
+    const tempPath = join(tmpdir(), `${BINARY_NAME}-update-${Date.now()}`);
+    // Use timestamped backup to avoid conflicts with locked files from previous updates
+    const backupPath = getBackupPath(currentPath);
+    // Clean up old backups from previous updates (best effort, non-fatal)
+    cleanupOldBackups(currentPath);
+    try {
+        // Download new binary to temp location
+        await downloadFile(downloadUrl, tempPath);
+        // Make executable
+        if (process.platform !== "win32") {
+            chmodSync(tempPath, 0o755);
+        }
+        // Backup current binary
+        if (existsSync(currentPath)) {
+            renameSync(currentPath, backupPath);
+        }
+        // Move new binary into place
+        renameSync(tempPath, currentPath);
+        // Remove backup (non-fatal on Windows due to file locking)
+        if (existsSync(backupPath)) {
+            try {
+                unlinkSync(backupPath);
+            }
+            catch {
+                // On Windows, the old executable may still be locked.
+                // This is fine - it will be cleaned up on next update.
+            }
+        }
+        return {
+            success: true,
+            previousVersion: VERSION,
+            newVersion,
+        };
+    }
+    catch (error) {
+        // Attempt to restore backup
+        if (existsSync(backupPath) && !existsSync(currentPath)) {
+            try {
+                renameSync(backupPath, currentPath);
+            }
+            catch {
+                // Ignore restore errors
+            }
+        }
+        // Clean up temp file
+        if (existsSync(tempPath)) {
+            try {
+                unlinkSync(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+        return {
+            success: false,
+            previousVersion: VERSION,
+            newVersion: null,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+};
+/**
+ * Re-execute the current process with the same arguments.
+ */
+export const reexec = () => {
+    const execPath = getCurrentExecutablePath();
+    const args = process.argv.slice(2);
+    // Spawn the new process
+    const child = spawn(execPath, args, {
+        stdio: "inherit",
+        detached: false,
+    });
+    // Exit this process when child exits
+    child.on("exit", (code) => {
+        process.exit(code ?? 0);
+    });
+    child.on("error", (err) => {
+        console.error("Failed to restart:", err.message);
+        process.exit(1);
+    });
+    // This line is reached but we've set up handlers to exit
+    // TypeScript needs the never return type satisfied
+    throw new Error("Process should have been replaced");
+};
+/**
+ * Check for updates and apply if available.
+ * This is the main entry point for auto-updates on startup.
+ */
+export const autoUpdate = async () => {
+    // Check if updates are disabled
+    if (process.env.PDF_MCP_NO_UPDATE === "1") {
+        return false;
+    }
+    const check = await checkForUpdate();
+    if (check.error) {
+        // Silently continue if update check fails
+        return false;
+    }
+    if (!check.updateAvailable || !check.downloadUrl || !check.latestVersion) {
+        return false;
+    }
+    // Log update to stderr (MCP uses stdio, so stdout is reserved)
+    console.error(`[pdf-analyzer] Updating from ${VERSION} to ${check.latestVersion}...`);
+    const result = await performUpdate(check.downloadUrl, check.latestVersion);
+    if (!result.success) {
+        console.error(`[pdf-analyzer] Update failed: ${result.error}`);
+        return false;
+    }
+    console.error(`[pdf-analyzer] Update complete. Restarting...`);
+    return true;
+};
+//# sourceMappingURL=updater.js.map

package/dist/cli/updater.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * PDF Analyzer MCP Server Entry Point
+ *
+ * Run with: npx tsx src/index.ts
+ * Or after build: node dist/index.js
+ *
+ * CLI flags:
+ *   --version, -v    Print version and exit
+ *   --update         Check for updates and apply if available
+ *   --uninstall      Remove pdf-analyzer from the system
+ *   --no-update      Skip auto-update check on startup
+ *   --help, -h       Show help
+ *
+ * Environment variables:
+ *   GEMINI_API_KEY        Required. Your Gemini API key.
+ *   PDF_MCP_NO_UPDATE=1   Disable auto-updates
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+/**
+ * PDF Analyzer MCP Server Entry Point
+ *
+ * Run with: npx tsx src/index.ts
+ * Or after build: node dist/index.js
+ *
+ * CLI flags:
+ *   --version, -v    Print version and exit
+ *   --update         Check for updates and apply if available
+ *   --uninstall      Remove pdf-analyzer from the system
+ *   --no-update      Skip auto-update check on startup
+ *   --help, -h       Show help
+ *
+ * Environment variables:
+ *   GEMINI_API_KEY        Required. Your Gemini API key.
+ *   PDF_MCP_NO_UPDATE=1   Disable auto-updates
+ */
+import { autoUpdate, reexec } from "./cli/updater.js";
+import { printVersion, printHelp, handleUpdateCommand, handleUninstallCommand, } from "./cli/commands.js";
+import { runServer } from "./server.js";
+/**
+ * Main entry point for the PDF Analyzer MCP server.
+ */
+const main = async () => {
+    const args = process.argv.slice(2);
+    // Handle --version / -v
+    if (args.includes("--version") || args.includes("-v")) {
+        printVersion();
+        return;
+    }
+    // Handle --help / -h
+    if (args.includes("--help") || args.includes("-h")) {
+        printHelp();
+        return;
+    }
+    // Handle --update
+    if (args.includes("--update")) {
+        await handleUpdateCommand();
+        return;
+    }
+    // Handle --uninstall
+    if (args.includes("--uninstall")) {
+        await handleUninstallCommand();
+        return;
+    }
+    // Auto-update check on startup (unless --no-update or env var)
+    const skipUpdate = args.includes("--no-update") || process.env.PDF_MCP_NO_UPDATE === "1";
+    if (!skipUpdate) {
+        const updated = await autoUpdate();
+        if (updated) {
+            reexec();
+        }
+    }
+    await runServer();
+};
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;GAEG;AACH,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,wBAAwB;IACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,YAAY,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,SAAS,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IAED,kBAAkB;IAClB,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,MAAM,mBAAmB,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,MAAM,sBAAsB,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,+DAA+D;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,CAAC;IAEzF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;QACnC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IAED,MAAM,SAAS,EAAE,CAAC;AACpB,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+/**
+ * PDF Analyzer MCP Server
+ *
+ * Model Context Protocol server for analyzing PDF documents using Gemini API.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Create and configure the MCP server.
+ */
+export declare const createServer: () => McpServer;
+/**
+ * Run the MCP server with stdio transport.
+ */
+export declare const runServer: () => Promise<void>;

package/dist/server.js

@@ -0,0 +1,154 @@
+/**
+ * PDF Analyzer MCP Server
+ *
+ * Model Context Protocol server for analyzing PDF documents using Gemini API.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { VERSION } from "./version.js";
+import { createGeminiClient, analyzePdf, isApiError, getApiErrorMessage } from "./service.js";
+// =============================================================================
+// Server Instructions
+// =============================================================================
+const SERVER_INSTRUCTIONS = `
+# PDF Analyzer MCP Server
+
+Analyzes PDF documents using Gemini's vision capabilities.
+
+## Tool: analyze_pdf
+
+Pass an absolute file path or URL and a list of queries. The server reads the PDF,
+sends it to Gemini with your queries, and returns structured responses.
+
+## Caching Strategy
+
+The response includes a \`file_uri\` (Gemini File API URI) that you should reuse for subsequent
+queries on the same document. This avoids re-uploading and is cached by Gemini for 48 hours.
+
+**Input types accepted:**
+- Local file path: \`/Users/name/docs/report.pdf\`
+- Web URL: \`https://example.com/doc.pdf\`
+- Gemini file URI: \`https://generativelanguage.googleapis.com/v1beta/files/abc123\` (from previous response)
+
+**Workflow for multiple queries on same document:**
+1. First call: pass local path or URL → receive \`file_uri\` in response
+2. Subsequent calls: pass the \`file_uri\` as \`pdf_source\` → no re-upload, faster response
+
+## Usage Tips
+
+- Ask specific, focused queries for best results
+- For multi-page PDFs, reference page numbers in queries when relevant
+- Reuse the returned \`file_uri\` for follow-up questions on the same document
+
+## Example
+
+\`\`\`json
+{
+  "pdf_source": "/path/to/document.pdf",
+  "queries": [
+    "What is the main topic of this document?",
+    "List all the key findings mentioned",
+    "What recommendations are made in the conclusion?"
+  ]
+}
+\`\`\`
+
+## Error Handling
+
+Common errors and solutions:
+- Missing GEMINI_API_KEY: Set the environment variable with your API key
+- PDF not found: Verify the path is absolute and file exists
+- URL fetch failed: Check that the URL is accessible and points to a valid PDF
+
+## Environment Variables
+
+- GEMINI_API_KEY: Required. Get your key from https://aistudio.google.com/apikey
+- PDF_MCP_NO_UPDATE: Set to "1" to disable auto-updates
+`.trim();
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Format a result as MCP tool response content.
+ */
+const formatResult = (result) => {
+    const text = JSON.stringify(result, null, 2);
+    return {
+        content: [{ type: "text", text }],
+    };
+};
+/**
+ * Format an error as MCP tool response content.
+ */
+const formatError = (error, details) => {
+    const result = details ? { error, details } : { error };
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        isError: true,
+    };
+};
+// =============================================================================
+// Server Setup
+// =============================================================================
+/**
+ * Create and configure the MCP server.
+ */
+export const createServer = () => {
+    const server = new McpServer({
+        name: "pdf-analyzer",
+        version: VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+        instructions: SERVER_INSTRUCTIONS,
+    });
+    // -------------------------------------------------------------------------
+    // Tool: analyze_pdf
+    // -------------------------------------------------------------------------
+    server.registerTool("analyze_pdf", {
+        description: "Analyze a PDF document using Gemini AI. Provide an absolute file path, URL, or Gemini file URI (from a previous response) and a list of questions to ask about the PDF content. Returns a file_uri that can be reused for subsequent queries on the same document (cached by Gemini for 48 hours).",
+        inputSchema: {
+            pdf_source: z
+                .string()
+                .describe("PDF source: absolute local file path (e.g., /Users/name/docs/report.pdf), URL (e.g., https://example.com/doc.pdf), or Gemini file URI from a previous response (e.g., https://generativelanguage.googleapis.com/v1beta/files/abc123)"),
+            queries: z.array(z.string().min(1)).min(1).describe("Array of questions to ask about the PDF"),
+        },
+    }, async ({ pdf_source, queries }) => {
+        try {
+            const client = createGeminiClient();
+            const result = await analyzePdf(client, { pdf_source, queries });
+            return formatResult(result);
+        }
+        catch (error) {
+            // Handle typed Gemini API errors
+            if (isApiError(error)) {
+                const { message, details } = getApiErrorMessage(error);
+                return formatError(message, details);
+            }
+            const message = error instanceof Error ? error.message : "Unknown error occurred";
+            // Provide helpful context for common errors
+            if (message.includes("GEMINI_API_KEY")) {
+                return formatError(message, "Set the GEMINI_API_KEY environment variable in your MCP client configuration.");
+            }
+            if (message.includes("not found")) {
+                return formatError(message, "Ensure the path is absolute and the file exists.");
+            }
+            if (message.includes("Failed to fetch PDF from URL")) {
+                return formatError(message, "Check that the URL is accessible and points to a valid PDF file.");
+            }
+            return formatError(message);
+        }
+    });
+    return server;
+};
+/**
+ * Run the MCP server with stdio transport.
+ */
+export const runServer = async () => {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE9F,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsD3B,CAAC,IAAI,EAAE,CAAC;AAET,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,YAAY,GAAG,CAAC,MAAe,EAAiD,EAAE;IACtF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,GAAG,CAClB,KAAa,EACb,OAAgB,EAC8C,EAAE;IAChE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;IACxD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC,CAAC;AAEF,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAc,EAAE;IAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;QACD,YAAY,EAAE,mBAAmB;KAClC,CACF,CAAC;IAEF,4EAA4E;IAC5E,oBAAoB;IACpB,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,oSAAoS;QACtS,WAAW,EAAE;YACX,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,CACP,sOAAsO,CACvO;YACH,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;SAC/F;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;YACjE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iCAAiC;YACjC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBACvD,OAAO,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvC,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YAElF,4CAA4C;YAC5C,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACvC,OAAO,WAAW,CAChB,OAAO,EACP,+EAA+E,CAChF,CAAC;YACJ,CAAC;YAED,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,OAAO,WAAW,CAAC,OAAO,EAAE,kDAAkD,CAAC,CAAC;YAClF,CAAC;YAED,IAAI,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC;gBACrD,OAAO,WAAW,CAChB,OAAO,EACP,kEAAkE,CACnE,CAAC;YACJ,CAAC;YAED,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,IAAmB,EAAE;IACjD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC,CAAC"}

package/dist/service.d.ts

@@ -0,0 +1,37 @@
+import { GoogleGenAI, ApiError } from "@google/genai";
+import type { AnalyzePdfInput, AnalyzePdfResponse } from "./types.js";
+/**
+ * Creates and returns a configured GoogleGenAI client.
+ * Loads GEMINI_API_KEY from .env file if not already set in environment.
+ */
+export declare function createGeminiClient(): GoogleGenAI;
+/**
+ * Check if a string is a Gemini File API URI.
+ */
+export declare function isGeminiFileUri(source: string): boolean;
+/**
+ * Check if a string is a URL (excluding Gemini File API URIs).
+ */
+export declare function isUrl(source: string): boolean;
+/**
+ * Validates a local PDF file path.
+ * Throws descriptive errors for common issues.
+ */
+export declare function validateLocalPath(pdfPath: string): void;
+/**
+ * Analyzes a PDF document using Gemini and returns responses to the provided queries.
+ * Uses the File API for uploads and structured output for reliable JSON responses.
+ * Returns the Gemini file_uri so calling agents can reuse it for subsequent queries.
+ */
+export declare function analyzePdf(client: GoogleGenAI, input: AnalyzePdfInput): Promise<AnalyzePdfResponse>;
+/**
+ * Check if an error is an ApiError and return typed error info.
+ */
+export declare function isApiError(error: unknown): error is ApiError;
+/**
+ * Get error message from ApiError, preserving the actual API response.
+ */
+export declare function getApiErrorMessage(error: ApiError): {
+    message: string;
+    details?: string;
+};