tn-elections-mcp 0.5.0

package/README.md

@@ -0,0 +1,87 @@
+# tn-elections-mcp
+
+MCP server for Tennessee elections: county campaign finance (EasyVote), state campaign finance (tncamp), Sumner County PDF-based disclosures, and Secretary of State candidate filings.
+
+## Data Sources
+
+### EasyVote Campaign Finance (14 counties)
+JSON API at `ecf-api.easyvoteapp.com`. Covers county-level races (mayor, county commission, school board, municipal offices) in: Anderson, Davidson, Greene, Hamblen, Hamilton, Knox, Madison, Marion, Maury, Rutherford, Shelby, Sullivan, Washington, Williamson.
+
+### tncamp (State-level)
+HTML scraping of `apps.tn.gov/tncamp`. Covers Governor, state Senate, state House, judges, DAs, and statewide PACs across all Tennessee counties.
+
+### Sumner County
+HTML scraping of `votesumnertn.org` for candidate metadata + Gemini Flash for PDF financial data extraction.
+
+### TN Secretary of State (Candidate Filings)
+Excel files from `sos.tn.gov/elections`. Official candidate filing lists for state and federal races: Governor, US Senate, US House, TN Senate, TN House, and party executive committees. This is the authoritative "who has filed to run" source, distinct from campaign finance data.
+
+## Tools (22)
+
+| Tool | Source | Description |
+|------|--------|-------------|
+| `list_easyvote_counties` | EasyVote | List 14 counties with portals |
+| `search_county_filers` | EasyVote | Search candidates/PACs in a county |
+| `list_county_offices` | EasyVote | List offices in a county |
+| `search_county_contributions` | EasyVote | Search contributions by donor/recipient |
+| `search_county_expenditures` | EasyVote | Search expenditures by vendor/candidate |
+| `get_county_election_documents` | EasyVote | Get election documents |
+| `search_all_counties_contributions` | EasyVote | Cross-county donor search |
+| `search_all_counties_expenditures` | EasyVote | Cross-county vendor search |
+| `search_state_candidates` | tncamp | Search by name or by office/district |
+| `list_tncamp_offices` | tncamp | List available offices (courts, DA, etc.) |
+| `list_tncamp_districts` | tncamp | List districts for an office |
+| `get_candidate_reports` | tncamp | Get filed report list |
+| `get_report_detail` | tncamp | Full financial breakdown |
+| `search_state_contributions` | tncamp | Cross-candidate contribution search |
+| `search_state_expenditures` | tncamp | Cross-candidate expenditure search |
+| `get_candidate_financials` | tncamp | Quick candidate financial summary |
+| `list_sumner_election_cycles` | Sumner | List election cycles |
+| `search_sumner_candidates` | Sumner | Search candidates + PDF links |
+| `get_sumner_report` | Sumner | Extract financials from PDF via Gemini |
+| `search_filed_candidates` | TN SOS | Search officially filed candidates |
+| `list_filed_offices` | TN SOS | List office categories with candidate counts |
+| `get_filing_summary` | TN SOS | Aggregated filing stats by office/party |
+
+## Installation
+
+```bash
+npm install -g tn-elections-mcp
+```
+
+Or use with Claude Code:
+```bash
+claude mcp add tn-elections -- npx tn-elections-mcp
+```
+
+For Sumner County PDF extraction, add the Gemini API key:
+```bash
+claude mcp add tn-elections --env GEMINI_API_KEY=your_key -- npx tn-elections-mcp
+```
+
+Or in `.claude.json`:
+```json
+{
+  "tn-elections": {
+    "command": "npx",
+    "args": ["tn-elections-mcp"],
+    "env": {
+      "GEMINI_API_KEY": "your-key-here"
+    }
+  }
+}
+```
+
+Without the Gemini key, `get_sumner_report` falls back to returning PDF page images for Claude to read directly.
+
+## Development
+
+```bash
+npm run dev    # Hot-reload via tsx
+npm test       # Run tests
+npm run build  # Compile TypeScript
+```
+
+## License
+
+MIT

package/dist/api/easyvote-client.d.ts

@@ -0,0 +1,51 @@
+/**
+ * EasyVote Campaign Finance API client.
+ *
+ * Multi-tenant JSON API at ecf-api.easyvoteapp.com. Each Tennessee county
+ * gets its own tenant ID. All endpoints are public (no login required).
+ *
+ * Critical: every request needs Origin header matching the county subdomain,
+ * plus zumo-api-version header. Data endpoints also need the auth header
+ * containing UserId and CustomerId (tenant ID).
+ */
+import type { EasyVoteAuthContext, EasyVoteFiler, EasyVoteContribution, EasyVoteDistribution } from '../types.js';
+import type { EasyVoteCountyConfig } from '../data/tn-counties.js';
+export declare function bootstrapCounty(slug: string): Promise<EasyVoteAuthContext | null>;
+/** Get all filers and their documents for a county */
+export declare function getFilers(county: EasyVoteCountyConfig): Promise<EasyVoteFiler[]>;
+/** Get offices for a county */
+export declare function getOffices(county: EasyVoteCountyConfig): Promise<unknown[]>;
+/** Search contribution parameters */
+export interface ContributionSearchParams {
+    donorLastName?: string;
+    donorFirstName?: string;
+    recipientLastName?: string;
+    recipientFirstName?: string;
+}
+/**
+ * Get ALL contributions for a county (cached 10 min).
+ *
+ * The EasyVote API ignores all query parameters on the contributions endpoint —
+ * it always returns the full dataset. All filtering is done client-side.
+ * Large counties (Shelby: ~29MB, Davidson: ~25K records) will be cached after
+ * the first fetch to avoid repeated large downloads.
+ */
+export declare function getAllContributions(county: EasyVoteCountyConfig): Promise<EasyVoteContribution[]>;
+/** Search contributions with client-side filtering (API ignores query params) */
+export declare function searchContributions(county: EasyVoteCountyConfig, params: ContributionSearchParams): Promise<EasyVoteContribution[]>;
+/** Distribution/expenditure search parameters */
+export interface DistributionSearchParams {
+    payeeLastName?: string;
+    payeeFirstName?: string;
+    candidateLastName?: string;
+    candidateFirstName?: string;
+}
+/**
+ * Get ALL distributions/expenditures for a county (cached 10 min).
+ * Same pattern as contributions — API likely ignores query params.
+ */
+export declare function getAllDistributions(county: EasyVoteCountyConfig): Promise<EasyVoteDistribution[]>;
+/** Search distributions with client-side filtering */
+export declare function searchDistributions(county: EasyVoteCountyConfig, params: DistributionSearchParams): Promise<EasyVoteDistribution[]>;
+/** Get election documents for a county */
+export declare function getElectionDocuments(county: EasyVoteCountyConfig): Promise<unknown[]>;

package/dist/api/easyvote-client.js

@@ -0,0 +1,254 @@
+/**
+ * EasyVote Campaign Finance API client.
+ *
+ * Multi-tenant JSON API at ecf-api.easyvoteapp.com. Each Tennessee county
+ * gets its own tenant ID. All endpoints are public (no login required).
+ *
+ * Critical: every request needs Origin header matching the county subdomain,
+ * plus zumo-api-version header. Data endpoints also need the auth header
+ * containing UserId and CustomerId (tenant ID).
+ */
+const ECF_BASE = 'https://ecf-api.easyvoteapp.com';
+const TIMEOUT_MS = 10_000;
+const CACHE_TTL_MS = 10 * 60 * 1000; // 10 minutes
+// ============================================================
+// Auth context cache (bootstrapped per county, TTL 30 min)
+// ============================================================
+const AUTH_CACHE_TTL_MS = 30 * 60 * 1000;
+const authCache = new Map();
+function originUrl(slug) {
+    return `https://${slug}.easyvotecampaignfinance.com`;
+}
+function buildAuthHeader(ctx) {
+    return `UserId:${ctx.UserId}|CustomerId:${ctx.CustomerId}|ZumoToken:null`;
+}
+function buildHeaders(county, ctx) {
+    return {
+        'Origin': originUrl(county.slug),
+        'easy-vote-authenticated-user': buildAuthHeader(ctx),
+        'zumo-api-version': '2.0.0',
+        'Accept': 'application/json',
+    };
+}
+// ============================================================
+// Fetch with timeout and JSON sanitization
+// ============================================================
+async function fetchWithTimeout(url, headers) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+        return await fetch(url, { headers, signal: controller.signal });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/** Strip control characters that break JSON.parse (observed in Knox County responses) */
+function sanitizeJson(raw) {
+    return raw.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, '');
+}
+async function fetchJson(url, headers) {
+    const response = await fetchWithTimeout(url, headers);
+    if (!response.ok) {
+        return { data: null, status: response.status };
+    }
+    const raw = await response.text();
+    return { data: JSON.parse(sanitizeJson(raw)), status: response.status };
+}
+// ============================================================
+// Bootstrap: get auth context for a county
+// ============================================================
+export async function bootstrapCounty(slug) {
+    const cached = authCache.get(slug);
+    if (cached && Date.now() - cached.timestamp < AUTH_CACHE_TTL_MS) {
+        return cached.data;
+    }
+    const url = `${ECF_BASE}/authentication/getwebsiteuser/${slug}`;
+    const headers = {
+        'Origin': originUrl(slug),
+        'Accept': 'application/json',
+    };
+    const { data: ctx } = await fetchJson(url, headers);
+    if (ctx) {
+        authCache.set(slug, { data: ctx, timestamp: Date.now() });
+    }
+    return ctx;
+}
+/** Clear cached auth and re-bootstrap (for retry-on-401) */
+async function rebootstrap(slug) {
+    authCache.delete(slug);
+    return bootstrapCounty(slug);
+}
+/** Get auth context, retrying bootstrap on failure */
+async function getAuth(county) {
+    const ctx = await bootstrapCounty(county.slug);
+    if (!ctx) {
+        throw new Error(`Failed to bootstrap EasyVote auth for ${county.name} County (${county.slug})`);
+    }
+    return ctx;
+}
+/** Fetch with retry-on-401 (re-bootstraps auth once) */
+async function fetchJsonWithRetry(county, buildUrl) {
+    let ctx = await getAuth(county);
+    let headers = buildHeaders(county, ctx);
+    const url = buildUrl(ctx.CustomerId);
+    const { data, status } = await fetchJson(url, headers);
+    if (data !== null)
+        return data;
+    // Only re-bootstrap on auth errors (401/403), not other failures
+    if (status === 401 || status === 403) {
+        const freshCtx = await rebootstrap(county.slug);
+        if (!freshCtx)
+            return null;
+        ctx = freshCtx;
+        headers = buildHeaders(county, ctx);
+        const retry = await fetchJson(buildUrl(ctx.CustomerId), headers);
+        return retry.data;
+    }
+    return null;
+}
+// ============================================================
+// Data caches with size limits (filers + contributions + distributions)
+// ============================================================
+const MAX_CACHE_ENTRIES = 8; // Prevent unbounded memory growth (~250MB max with large counties)
+function cachedGet(cache, key) {
+    const entry = cache.get(key);
+    if (entry && Date.now() - entry.timestamp < CACHE_TTL_MS)
+        return entry.data;
+    if (entry)
+        cache.delete(key);
+    return null;
+}
+function cachedSet(cache, key, data) {
+    // Evict oldest entry if at capacity
+    if (cache.size >= MAX_CACHE_ENTRIES) {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [k, v] of cache) {
+            if (v.timestamp < oldestTime) {
+                oldestKey = k;
+                oldestTime = v.timestamp;
+            }
+        }
+        if (oldestKey)
+            cache.delete(oldestKey);
+    }
+    cache.set(key, { data, timestamp: Date.now() });
+}
+const filerCache = new Map();
+const contributionCache = new Map();
+const distributionCache = new Map();
+// ============================================================
+// Public API functions
+// ============================================================
+/** Get all filers and their documents for a county */
+export async function getFilers(county) {
+    const cached = cachedGet(filerCache, county.slug);
+    if (cached)
+        return cached;
+    const data = await fetchJsonWithRetry(county, (tenantId) => `${ECF_BASE}/filer/documentsearch/${tenantId}`);
+    const filers = data || [];
+    cachedSet(filerCache, county.slug, filers);
+    return filers;
+}
+/** Get offices for a county */
+export async function getOffices(county) {
+    const data = await fetchJsonWithRetry(county, (tenantId) => `${ECF_BASE}/filer/offices/${tenantId}`);
+    return data || [];
+}
+/**
+ * Get ALL contributions for a county (cached 10 min).
+ *
+ * The EasyVote API ignores all query parameters on the contributions endpoint —
+ * it always returns the full dataset. All filtering is done client-side.
+ * Large counties (Shelby: ~29MB, Davidson: ~25K records) will be cached after
+ * the first fetch to avoid repeated large downloads.
+ */
+export async function getAllContributions(county) {
+    const cached = cachedGet(contributionCache, county.slug);
+    if (cached)
+        return cached;
+    const data = await fetchJsonWithRetry(county, (tenantId) => `${ECF_BASE}/advancedsearch/contributions/${tenantId}`);
+    const contributions = data || [];
+    cachedSet(contributionCache, county.slug, contributions);
+    return contributions;
+}
+/** Search contributions with client-side filtering (API ignores query params) */
+export async function searchContributions(county, params) {
+    const all = await getAllContributions(county);
+    return all.filter(c => {
+        if (params.donorLastName) {
+            const donor = (c.ContributorLastName || '').toLowerCase();
+            if (!donor.includes(params.donorLastName.toLowerCase()))
+                return false;
+        }
+        if (params.donorFirstName) {
+            const donor = (c.ContributorFirstName || '').toLowerCase();
+            if (!donor.includes(params.donorFirstName.toLowerCase()))
+                return false;
+        }
+        if (params.recipientLastName) {
+            const recip = (c.RecipientLastName || '').toLowerCase();
+            const committee = (c.RecipientCommitteeName || '').toLowerCase();
+            if (!recip.includes(params.recipientLastName.toLowerCase()) &&
+                !committee.includes(params.recipientLastName.toLowerCase()))
+                return false;
+        }
+        if (params.recipientFirstName) {
+            const recip = (c.RecipientFirstName || '').toLowerCase();
+            if (!recip.includes(params.recipientFirstName.toLowerCase()))
+                return false;
+        }
+        return true;
+    });
+}
+/**
+ * Get ALL distributions/expenditures for a county (cached 10 min).
+ * Same pattern as contributions — API likely ignores query params.
+ */
+export async function getAllDistributions(county) {
+    const cached = cachedGet(distributionCache, county.slug);
+    if (cached)
+        return cached;
+    const data = await fetchJsonWithRetry(county, (tenantId) => `${ECF_BASE}/advancedsearch/distributions/${tenantId}`);
+    const distributions = data || [];
+    cachedSet(distributionCache, county.slug, distributions);
+    return distributions;
+}
+/** Search distributions with client-side filtering */
+export async function searchDistributions(county, params) {
+    const all = await getAllDistributions(county);
+    return all.filter(d => {
+        if (params.payeeLastName) {
+            const payee = (d.PayeeLastName || '').toLowerCase();
+            const org = (d.PayeeOrganizationName || '').toLowerCase();
+            if (!payee.includes(params.payeeLastName.toLowerCase()) &&
+                !org.includes(params.payeeLastName.toLowerCase()))
+                return false;
+        }
+        if (params.payeeFirstName) {
+            const payee = (d.PayeeFirstName || '').toLowerCase();
+            if (!payee.includes(params.payeeFirstName.toLowerCase()))
+                return false;
+        }
+        if (params.candidateLastName) {
+            const cand = (d.CandidateLastName || '').toLowerCase();
+            const committee = (d.CandidateCommitteeName || '').toLowerCase();
+            if (!cand.includes(params.candidateLastName.toLowerCase()) &&
+                !committee.includes(params.candidateLastName.toLowerCase()))
+                return false;
+        }
+        if (params.candidateFirstName) {
+            const cand = (d.CandidateFirstName || '').toLowerCase();
+            if (!cand.includes(params.candidateFirstName.toLowerCase()))
+                return false;
+        }
+        return true;
+    });
+}
+/** Get election documents for a county */
+export async function getElectionDocuments(county) {
+    const data = await fetchJsonWithRetry(county, (tenantId) => `${ECF_BASE}/documents/elections/${tenantId}`);
+    return data || [];
+}
+//# sourceMappingURL=easyvote-client.js.map

package/dist/api/easyvote-client.js.map

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

package/dist/api/easyvote-client.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/api/easyvote-client.test.js

@@ -0,0 +1,47 @@
+import { describe, it, expect } from 'vitest';
+// Test the sanitizeJson logic directly (replicated here since it's private)
+function sanitizeJson(raw) {
+    return raw.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, '');
+}
+describe('sanitizeJson', () => {
+    it('passes through clean JSON unchanged', () => {
+        const clean = '{"name": "John Smith", "amount": 100}';
+        expect(sanitizeJson(clean)).toBe(clean);
+    });
+    it('strips null bytes', () => {
+        const dirty = '{"name": "John\x00Smith"}';
+        expect(sanitizeJson(dirty)).toBe('{"name": "JohnSmith"}');
+    });
+    it('strips control characters but preserves tabs and newlines', () => {
+        const input = '{"a":\t"b",\n"c":\r\n"d\x01\x02\x03"}';
+        const expected = '{"a":\t"b",\n"c":\r\n"d"}';
+        expect(sanitizeJson(input)).toBe(expected);
+    });
+    it('handles Knox County control char pattern', () => {
+        // Knox County responses have been observed with embedded control chars
+        const input = '{"filerid":"abc\x05def","name":"Test"}';
+        const result = sanitizeJson(input);
+        expect(() => JSON.parse(result)).not.toThrow();
+        expect(JSON.parse(result).filerid).toBe('abcdef');
+    });
+    it('handles empty string', () => {
+        expect(sanitizeJson('')).toBe('');
+    });
+});
+describe('header construction', () => {
+    it('origin URL follows expected pattern', () => {
+        const slug = 'knoxcountytn';
+        const origin = `https://${slug}.easyvotecampaignfinance.com`;
+        expect(origin).toBe('https://knoxcountytn.easyvotecampaignfinance.com');
+    });
+    it('auth header follows pipe-delimited format', () => {
+        const userId = 'B7E5F78C-AB24-4799-A754-39FD501306DD';
+        const customerId = '4BB07902-FDCA-4D3B-BF6F-EA8F3A3E99A4';
+        const header = `UserId:${userId}|CustomerId:${customerId}|ZumoToken:null`;
+        expect(header).toContain('UserId:');
+        expect(header).toContain('|CustomerId:');
+        expect(header).toContain('|ZumoToken:null');
+        expect(header.split('|')).toHaveLength(3);
+    });
+});
+//# sourceMappingURL=easyvote-client.test.js.map

package/dist/api/easyvote-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"easyvote-client.test.js","sourceRoot":"","sources":["../../src/api/easyvote-client.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE7C,4EAA4E;AAC5E,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAA;AACzD,CAAC;AAED,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,KAAK,GAAG,uCAAuC,CAAA;QACrD,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,KAAK,GAAG,2BAA2B,CAAA;QACzC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,KAAK,GAAG,uCAAuC,CAAA;QACrD,MAAM,QAAQ,GAAG,2BAA2B,CAAA;QAC5C,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,uEAAuE;QACvE,MAAM,KAAK,GAAG,wCAAwC,CAAA;QACtD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;QAClC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;QAC9C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACnD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACnC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,IAAI,GAAG,cAAc,CAAA;QAC3B,MAAM,MAAM,GAAG,WAAW,IAAI,8BAA8B,CAAA;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,sCAAsC,CAAA;QACrD,MAAM,UAAU,GAAG,sCAAsC,CAAA;QACzD,MAAM,MAAM,GAAG,UAAU,MAAM,eAAe,UAAU,iBAAiB,CAAA;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;QACxC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAA;QAC3C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/api/gemini-pdf.d.ts

@@ -0,0 +1,23 @@
+/**
+ * PDF financial data extraction.
+ *
+ * Primary: Gemini Flash (cheap, fast, handles PDFs natively)
+ * Fallback: Download PDF → pdftoppm → JPEG images → return as base64
+ *           for Claude to read directly via MCP image content.
+ *
+ * The fallback works because these are scanned PDFs (pdftotext returns empty).
+ */
+import type { SumnerReportData } from '../types.js';
+export interface PdfImageFallback {
+    type: 'image_fallback';
+    pageCount: number;
+    images: Array<{
+        page: number;
+        base64: string;
+        mimeType: string;
+    }>;
+    message: string;
+}
+export declare function extractReportFromPdf(pdfUrl: string, reportName: string): Promise<SumnerReportData | PdfImageFallback>;
+/** Check if a result is the image fallback (not structured data) */
+export declare function isImageFallback(result: SumnerReportData | PdfImageFallback): result is PdfImageFallback;