@intelligentelectron/pdf-analyzer 0.2.0 → 1.0.0

package/dist/providers/openai.js

@@ -0,0 +1,70 @@
+/**
+ * OpenAI provider.
+ *
+ * Sends PDFs inline as bytes content parts.
+ * No File API, no caching.
+ */
+import { createOpenAI } from "@ai-sdk/openai";
+import { fetchPdfFromUrl, readPdfBytes } from "../pdf-utils.js";
+const MODELS = [
+    {
+        id: "gpt-5.4-mini",
+        displayName: "GPT-5.4 Mini",
+        hint: "Fast and cost-effective",
+    },
+    { id: "gpt-5.4", displayName: "GPT-5.4", hint: "Best and most expensive" },
+];
+const DEFAULT_MODEL = "gpt-5.4";
+/**
+ * Prepare a PDF source for OpenAI by reading bytes inline.
+ */
+async function preparePdf(source) {
+    if (source.kind === "cachedUri") {
+        throw new Error("Cached URIs are only supported with the Google provider.");
+    }
+    let bytes;
+    if (source.kind === "bytes") {
+        bytes = source.bytes;
+    }
+    else if (source.kind === "url") {
+        bytes = new Uint8Array(await fetchPdfFromUrl(source.url));
+    }
+    else {
+        bytes = new Uint8Array(await readPdfBytes(source.path));
+    }
+    const part = {
+        type: "file",
+        data: bytes,
+        mediaType: "application/pdf",
+    };
+    return { fileParts: [part], cachedUri: null };
+}
+/**
+ * Check if an error is an OpenAI token limit error.
+ */
+function isTokenLimitError(error) {
+    if (!(error instanceof Error))
+        return false;
+    const msg = error.message.toLowerCase();
+    return (msg.includes("maximum context length") ||
+        msg.includes("exceeds the context window") ||
+        msg.includes("too many tokens") ||
+        msg.includes("request too large"));
+}
+export const openaiProvider = {
+    id: "openai",
+    displayName: "OpenAI GPT",
+    models: MODELS,
+    defaultModel: DEFAULT_MODEL,
+    apiKeyUrl: "https://platform.openai.com/api-keys",
+    createModel: (apiKey, modelId) => {
+        const openai = createOpenAI({ apiKey });
+        return openai(modelId);
+    },
+    providerOptions: {
+        openai: { reasoningEffort: "low" },
+    },
+    preparePdf,
+    isTokenLimitError,
+};
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,MAAM,GAAkB;IAC5B;QACE,EAAE,EAAE,cAAc;QAClB,WAAW,EAAE,cAAc;QAC3B,IAAI,EAAE,yBAAyB;KAChC;IACD,EAAE,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,yBAAyB,EAAE;CAC3E,CAAC;AAEF,MAAM,aAAa,GAAG,SAAS,CAAC;AAEhC;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,MAAiB;IACzC,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,KAAiB,CAAC;IAEtB,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IACvB,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACjC,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,GAAgB;QACxB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,KAAK;QACX,SAAS,EAAE,iBAAiB;KAC7B,CAAC;IACF,OAAO,EAAE,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,CACL,GAAG,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QACtC,GAAG,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QAC1C,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,EAAE,EAAE,QAAQ;IACZ,WAAW,EAAE,YAAY;IACzB,MAAM,EAAE,MAAM;IACd,YAAY,EAAE,aAAa;IAC3B,SAAS,EAAE,sCAAsC;IACjD,WAAW,EAAE,CAAC,MAAc,EAAE,OAAe,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IACD,eAAe,EAAE;QACf,MAAM,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;KACnC;IACD,UAAU;IACV,iBAAiB;CAClB,CAAC"}

package/dist/providers/registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Provider registry.
+ *
+ * Maps provider IDs to their configurations and resolves
+ * the active provider from the OS credential store.
+ */
+import type { ProviderConfig } from "./types.js";
+/** All supported providers, keyed by ID. */
+export declare const providers: Record<string, ProviderConfig>;
+/** Ordered list for display in the setup menu. */
+export declare const providerList: ProviderConfig[];
+/**
+ * Resolve the active provider and API key from the credential store.
+ * Returns the provider config and the API key.
+ *
+ * Throws if no provider is configured or the API key is missing.
+ */
+export declare function resolveActiveProvider(): {
+    provider: ProviderConfig;
+    apiKey: string;
+    modelId: string;
+};
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,4CAA4C;AAC5C,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAIpD,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,YAAY,EAAE,cAAc,EAAwD,CAAC;AAElG;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI;IACvC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CA+BA"}

package/dist/providers/registry.js

@@ -0,0 +1,44 @@
+/**
+ * Provider registry.
+ *
+ * Maps provider IDs to their configurations and resolves
+ * the active provider from the OS credential store.
+ */
+import { googleProvider } from "./google.js";
+import { anthropicProvider } from "./anthropic.js";
+import { openaiProvider } from "./openai.js";
+import { getActiveProvider as getStoredProvider, getApiKey, getModel } from "../keychain.js";
+/** All supported providers, keyed by ID. */
+export const providers = {
+    google: googleProvider,
+    anthropic: anthropicProvider,
+    openai: openaiProvider,
+};
+/** Ordered list for display in the setup menu. */
+export const providerList = [googleProvider, anthropicProvider, openaiProvider];
+/**
+ * Resolve the active provider and API key from the credential store.
+ * Returns the provider config and the API key.
+ *
+ * Throws if no provider is configured or the API key is missing.
+ */
+export function resolveActiveProvider() {
+    const providerId = getStoredProvider();
+    const apiKey = getApiKey();
+    if (!providerId) {
+        throw new Error("No provider configured. Run `pdf-analyzer --setup` to choose a provider and set your API key.");
+    }
+    const provider = providers[providerId];
+    if (!provider) {
+        throw new Error(`Unknown provider "${providerId}". Run \`pdf-analyzer --setup\` to reconfigure.`);
+    }
+    if (!apiKey) {
+        throw new Error(`API key not found for ${provider.displayName}. Run \`pdf-analyzer --setup\` to set your API key.`);
+    }
+    const storedModel = getModel();
+    const modelId = storedModel && provider.models.some((m) => m.id === storedModel)
+        ? storedModel
+        : provider.defaultModel;
+    return { provider, apiKey, modelId };
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE7F,4CAA4C;AAC5C,MAAM,CAAC,MAAM,SAAS,GAAmC;IACvD,MAAM,EAAE,cAAc;IACtB,SAAS,EAAE,iBAAiB;IAC5B,MAAM,EAAE,cAAc;CACvB,CAAC;AAEF,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAqB,CAAC,cAAc,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC;AAElG;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IAKnC,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAEvC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,qBAAqB,UAAU,iDAAiD,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,yBAAyB,QAAQ,CAAC,WAAW,qDAAqD,CACnG,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,EAAE,CAAC;IAC/B,MAAM,OAAO,GACX,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC;QAC9D,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;IAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC"}

package/dist/providers/types.d.ts

@@ -0,0 +1,70 @@
+import type { LanguageModel } from "ai";
+/**
+ * A file content part compatible with the AI SDK message format.
+ */
+export interface PdfFilePart {
+    type: "file";
+    data: Uint8Array | URL;
+    mediaType: "application/pdf";
+}
+/**
+ * A prepared PDF ready for inclusion in an AI SDK message.
+ */
+export interface PreparedPdf {
+    /** Content parts to include in the AI SDK user message. */
+    fileParts: PdfFilePart[];
+    /** Gemini File API URI for caching (Google only; null for others). */
+    cachedUri: string | null;
+}
+/**
+ * Source of a PDF to analyze. Discriminated union by `kind`.
+ */
+export type PdfSource = {
+    kind: "path";
+    path: string;
+} | {
+    kind: "url";
+    url: string;
+} | {
+    kind: "bytes";
+    bytes: Uint8Array;
+} | {
+    kind: "cachedUri";
+    uri: string;
+};
+/**
+ * A model option available for selection during setup.
+ */
+export interface ModelOption {
+    /** Model ID passed to the AI SDK, e.g. "gemini-3.1-pro-preview". */
+    id: string;
+    /** Display name shown in the setup TUI. */
+    displayName: string;
+    /** Short hint shown next to the model name. */
+    hint: string;
+}
+/**
+ * Configuration for an LLM provider.
+ * Each provider exports a plain object satisfying this interface.
+ */
+export interface ProviderConfig {
+    /** Provider identifier, e.g. "google", "anthropic", "openai". */
+    id: string;
+    /** Display name shown during setup. */
+    displayName: string;
+    /** Available models for this provider. */
+    models: ModelOption[];
+    /** Default (flagship) model ID, used as fallback. */
+    defaultModel: string;
+    /** URL where the user obtains an API key. */
+    apiKeyUrl: string;
+    /** Create an AI SDK LanguageModel instance for the given model ID. */
+    createModel: (apiKey: string, modelId: string) => LanguageModel;
+    /** Provider-specific options for generateText (e.g. thinking/reasoning config). */
+    providerOptions: Record<string, any>;
+    /** Prepare a PDF source for inclusion in an LLM call. */
+    preparePdf: (source: PdfSource, apiKey: string) => Promise<PreparedPdf>;
+    /** Check if an error indicates input token limit exceeded (triggers chunking). */
+    isTokenLimitError: (error: unknown) => boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,GAAG,CAAC;IACvB,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,sEAAsE;IACtE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,aAAa,CAAC;IAChE,mFAAmF;IAEnF,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,yDAAyD;IACzD,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACxE,kFAAkF;IAClF,iBAAiB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAChD"}

package/dist/providers/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

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

package/dist/server.d.ts

@@ -1,7 +1,8 @@
 /**
  * PDF Analyzer MCP Server
  *
- * Model Context Protocol server for analyzing PDF documents using Gemini API.
+ * Model Context Protocol server for analyzing PDF documents using
+ * a configurable LLM provider (Google Gemini, Anthropic Claude, or OpenAI).
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 /**

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmGpE;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,SAsE/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,QAAa,OAAO,CAAC,IAAI,CAI9C,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoGpE;;GAEG;AACH,eAAO,MAAM,YAAY,QAAO,SA+D/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,QAAa,OAAO,CAAC,IAAI,CAI9C,CAAC"}

package/dist/server.js

@@ -1,51 +1,53 @@
 /**
  * PDF Analyzer MCP Server
  *
- * Model Context Protocol server for analyzing PDF documents using Gemini API.
+ * Model Context Protocol server for analyzing PDF documents using
+ * a configurable LLM provider (Google Gemini, Anthropic Claude, or OpenAI).
  */
 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";
+import { analyzePdf } from "./service.js";
+import { resolveActiveProvider } from "./providers/registry.js";
 // =============================================================================
 // Server Instructions
 // =============================================================================
 const SERVER_INSTRUCTIONS = `
 # PDF Analyzer MCP Server
 
-Analyzes PDF documents using Gemini's vision capabilities.
+Analyzes PDF documents using AI vision capabilities. Supports multiple LLM providers
+(Google Gemini, Anthropic Claude, OpenAI).
 
 ## Tool: analyze_pdf
 
-Pass an absolute file path, URL, or Gemini file URI(s) and a list of queries. The server reads the PDF,
-sends it to Gemini with your queries, and returns structured responses.
+Pass an absolute file path, URL, or cached file URI(s) and a list of queries. The server reads the PDF,
+sends it to the configured LLM with your queries, and returns structured responses.
 
-Large PDFs that exceed Gemini's token limit are automatically split into chunks and processed
+Large PDFs that exceed the model's token limit are automatically split into chunks and processed
 sequentially with rolling context. No user intervention is needed.
 
-## Caching Strategy
+## Caching Strategy (Google provider only)
 
-The response includes a \`cached_uris\` array (Gemini File API URIs) that you should reuse for subsequent
-queries on the same document. This avoids re-uploading and is cached by Gemini for 48 hours.
+When using Google Gemini, the response includes a \`cached_uris\` array (Gemini File API URIs)
+that you should reuse for subsequent queries on the same document. This avoids re-uploading
+and is cached by Gemini for 48 hours. Other providers return an empty \`cached_uris\` array.
 
 **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)
-- Array of Gemini file URIs: for re-analyzing a previously chunked document
+- Gemini file URI: \`https://generativelanguage.googleapis.com/v1beta/files/abc123\` (Google only, from previous response)
+- Array of Gemini file URIs: for re-analyzing a previously chunked document (Google only)
 
-**Workflow for multiple queries on same document:**
-1. First call: pass local path or URL → receive \`cached_uris\` in response
-2. Subsequent calls: pass the \`cached_uris\` value as \`pdf_source\` → no re-upload, faster response
-   - If \`cached_uris\` has one element, pass the single URI string
-   - If \`cached_uris\` has multiple elements (chunked PDF), pass the full array
+**Workflow for multiple queries on same document (Google provider):**
+1. First call: pass local path or URL -> receive \`cached_uris\` in response
+2. Subsequent calls: pass the \`cached_uris\` value 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 \`cached_uris\` for follow-up questions on the same document
+- With Google provider, reuse the returned \`cached_uris\` for follow-up questions
 
 ## Example
 
@@ -63,7 +65,7 @@ queries on the same document. This avoids re-uploading and is cached by Gemini f
 ## Error Handling
 
 Common errors and solutions:
-- Missing GEMINI_API_KEY: Run \`pdf-analyzer --set-key\` to store your API key
+- Missing provider/API key: Run \`pdf-analyzer --setup\` to choose a provider and store 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
 `.trim();
@@ -109,11 +111,11 @@ export const createServer = () => {
     // Tool: analyze_pdf
     // -------------------------------------------------------------------------
     server.registerTool("analyze_pdf", {
-        description: "Analyze a PDF document using Gemini AI. Provide an absolute file path, URL, Gemini file URI (from a previous response), or array of Gemini file URIs (from a previous chunked response) and a list of questions to ask about the PDF content. Returns a cached_uris array that can be reused for subsequent queries on the same document (cached by Gemini for 48 hours).",
+        description: "Analyze a PDF document using AI. Provide an absolute file path, URL, cached file URI (from a previous response, Google only), or array of cached file URIs (from a previous chunked response, Google only) and a list of questions to ask about the PDF content. With the Google provider, returns a cached_uris array that can be reused for subsequent queries on the same document.",
         inputSchema: {
             pdf_source: z
                 .union([z.string(), z.array(z.string().min(1)).min(1)])
-                .describe("PDF source: absolute local file path (e.g., /Users/name/docs/report.pdf), URL (e.g., https://example.com/doc.pdf), Gemini file URI from a previous response (e.g., https://generativelanguage.googleapis.com/v1beta/files/abc123), or array of Gemini file URIs from a previous chunked response"),
+                .describe("PDF source: absolute local file path, URL, cached file URI from a previous response (Google only), or array of cached file URIs from a previous chunked response (Google only)"),
             queries: z
                 .array(z.string().min(1))
                 .min(1)
@@ -121,25 +123,19 @@ export const createServer = () => {
         },
     }, async ({ pdf_source, queries }) => {
         try {
-            const client = createGeminiClient();
-            const result = await analyzePdf(client, { pdf_source, queries });
+            const { provider, apiKey, modelId } = resolveActiveProvider();
+            const result = await analyzePdf(provider, apiKey, modelId, { 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, "Run `pdf-analyzer --set-key` to store your Gemini API key.");
+            if (message.includes("No provider configured") || message.includes("API key not found")) {
+                return formatError(message);
             }
             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")) {
+            if (message.includes("Failed to fetch")) {
                 return formatError(message, "Check that the URL is accessible and points to a valid PDF file.");
             }
             return formatError(message);

package/dist/server.js.map

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

package/dist/service.d.ts

@@ -1,43 +1,15 @@
-import { GoogleGenAI, ApiError } from "@google/genai";
 import type { AnalyzePdfInput, AnalyzePdfResponse } from "./types.js";
+import type { ProviderConfig } from "./providers/types.js";
 /**
- * Creates and returns a configured GoogleGenAI client.
- * Reads GEMINI_API_KEY from the OS credential store.
- */
-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.
+ * Analyzes a PDF document using the configured provider.
  *
  * Routing:
- * - string[] → cached chunk URIs, sequential processing with rolling findings
- * - Gemini URI string → direct single-file analysis (no bytes to split)
- * - path/URL → read bytes, try full PDF first, split on token limit error
- */
-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.
+ * - string[] -> cached chunk URIs, sequential processing with rolling findings (Google only)
+ * - Gemini URI string -> direct single-file analysis via cached URI (Google only)
+ * - path/URL -> prepare via provider, try full PDF first, split on token limit error
  */
-export declare function getApiErrorMessage(error: ApiError): {
-    message: string;
-    details?: string;
-};
+export declare function analyzePdf(provider: ProviderConfig, apiKey: string, modelId: string, input: AnalyzePdfInput): Promise<AnalyzePdfResponse>;
 export type { AnalyzePdfInput, AnalyzePdfResponse, QueryResponse } from "./types.js";
 export { AnalyzePdfInputSchema } from "./types.js";
+export { isGeminiFileUri, isUrl, validateLocalPath } from "./pdf-utils.js";
 //# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AAgBpB;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,CAShD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAU7C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAmBvD;AAyYD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAwB7B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAKzF;AAGD,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AAIpB,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,sBAAsB,CAAC;AAqRtE;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAoC7B;AAGD,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}