@claritylabs/cl-sdk 1.0.0

package/dist/index.d.mts

@@ -0,0 +1,536 @@
+import { LanguageModel } from 'ai';
+import { ProviderOptions } from '@ai-sdk/provider-utils';
+import { PDFDocument } from 'pdf-lib';
+
+interface Coverage {
+    name: string;
+    limit: string;
+    deductible?: string;
+    pageNumber?: number;
+    sectionRef?: string;
+}
+interface Subsection {
+    title: string;
+    sectionNumber?: string;
+    pageNumber?: number;
+    content: string;
+}
+interface Section {
+    title: string;
+    sectionNumber?: string;
+    pageStart: number;
+    pageEnd?: number;
+    type: string;
+    coverageType?: string;
+    content: string;
+    subsections?: Subsection[];
+}
+interface Subjectivity {
+    description: string;
+    category?: string;
+}
+interface UnderwritingCondition {
+    description: string;
+}
+interface PremiumLine {
+    line: string;
+    amount: string;
+}
+interface BaseDocument {
+    id: string;
+    type: "policy" | "quote";
+    carrier: string;
+    security?: string;
+    insuredName: string;
+    premium?: string;
+    summary?: string;
+    policyTypes?: string[];
+    coverages: Coverage[];
+    sections?: Section[];
+}
+interface PolicyDocument extends BaseDocument {
+    type: "policy";
+    policyNumber: string;
+    effectiveDate: string;
+    expirationDate: string;
+}
+interface QuoteDocument extends BaseDocument {
+    type: "quote";
+    quoteNumber: string;
+    proposedEffectiveDate?: string;
+    proposedExpirationDate?: string;
+    quoteExpirationDate?: string;
+    subjectivities?: Subjectivity[];
+    underwritingConditions?: UnderwritingCondition[];
+    premiumBreakdown?: PremiumLine[];
+}
+type InsuranceDocument = PolicyDocument | QuoteDocument;
+
+type Platform = "email" | "chat" | "sms" | "slack" | "discord";
+type CommunicationIntent = "direct" | "mediated" | "observed";
+interface PlatformConfig {
+    supportsMarkdown: boolean;
+    supportsLinks: boolean;
+    supportsRichFormatting: boolean;
+    maxResponseLength?: number;
+    signOff?: boolean;
+}
+declare const PLATFORM_CONFIGS: Record<Platform, PlatformConfig>;
+interface AgentContext {
+    platform: Platform;
+    intent: CommunicationIntent;
+    platformConfig?: PlatformConfig;
+    companyName?: string;
+    companyContext?: string;
+    siteUrl: string;
+    userName?: string;
+    coiHandling?: "broker" | "user" | "member" | "ignore";
+    brokerName?: string;
+    brokerContactName?: string;
+    brokerContactEmail?: string;
+    /** Display name for the AI agent. Defaults to "CL-0 Agent" if not set. */
+    agentName?: string;
+    /** Custom link guidance for the AI. Replaces the default policy/quote link examples.
+     *  Should include markdown link examples showing the AI how to format document links.
+     *  Only used when the platform supports links and intent is "direct". */
+    linkGuidance?: string;
+}
+
+interface ModelConfig {
+    /** Pass 0: document type classification (fast, cheap model) */
+    classification: LanguageModel;
+    /** Pass 1: metadata extraction (capable model) */
+    metadata: LanguageModel;
+    /** Pass 2: chunked section extraction (fast, cheap model) */
+    sections: LanguageModel;
+    /** Pass 2 fallback when sections model truncates */
+    sectionsFallback: LanguageModel;
+    /** Pass 3: supplementary field enrichment (fast, cheap model) */
+    enrichment: LanguageModel;
+}
+/** Create a ModelConfig where every role uses the same model. */
+declare function createUniformModelConfig(model: LanguageModel): ModelConfig;
+/** Token limits per role — determined by the task, not the provider. */
+declare const MODEL_TOKEN_LIMITS: {
+    readonly classification: 512;
+    readonly metadata: 4096;
+    readonly sections: 8192;
+    readonly sectionsFallback: 16384;
+    readonly enrichment: 4096;
+};
+/**
+ * Create a ModelConfig using the default Anthropic models.
+ *
+ * Requires `@ai-sdk/anthropic` to be installed — lazy-imported so consumers
+ * who bring their own provider never need it.
+ */
+declare function createDefaultModelConfig(): ModelConfig;
+
+/**
+ * Extraction prompt for insurance policy documents.
+ * Single source of truth — used by extractPolicy, retryExtraction, and reExtractFromFile.
+ */
+/**
+ * @deprecated No longer used for new extractions. Kept for backward compatibility
+ * with rawExtractionResponse reparse (older extractions may have used this format).
+ * New extractions use two-pass flow: METADATA_PROMPT (Sonnet) + buildSectionsPrompt (Haiku).
+ */
+declare const EXTRACTION_PROMPT = "You are an expert insurance document analyst. Extract comprehensive structured data from this insurance document. Preserve original language verbatim \u2014 do not summarize or paraphrase section content.\n\nRespond with JSON only. The JSON must follow this exact structure:\n\n{\n  \"metadata\": {\n    \"carrier\": \"primary insurance company name (for display purposes)\",\n    \"security\": \"insurer or underwriter entity providing coverage, e.g. 'Lloyd's Underwriters' \u2014 the legal entity on risk\",\n    \"underwriter\": \"named individual underwriter if listed, or null\",\n    \"mga\": \"Managing General Agent or Program Administrator name if applicable (e.g. 'CFC Underwriting'), or null\",\n    \"broker\": \"insurance broker name if identifiable, or null\",\n    \"policyNumber\": \"policy or quote reference number\",\n    \"documentType\": \"policy\" or \"quote\",\n    \"policyTypes\": [\"general_liability\", \"workers_comp\", \"commercial_auto\", \"non_owned_auto\", \"property\", \"umbrella\", \"professional_liability\", \"cyber\", \"epli\", \"directors_officers\", \"other\"],\n    \"policyYear\": number,\n    \"effectiveDate\": \"MM/DD/YYYY\",\n    \"expirationDate\": \"MM/DD/YYYY\",\n    \"isRenewal\": boolean,\n    \"premium\": \"$X,XXX\",\n    \"insuredName\": \"name of insured party\",\n    \"summary\": \"1-2 sentence summary of the document\"\n  },\n  \"metadataSource\": {\n    \"carrierPage\": number or null,\n    \"policyNumberPage\": number or null,\n    \"premiumPage\": number or null,\n    \"effectiveDatePage\": number or null\n  },\n  \"coverages\": [\n    {\n      \"name\": \"coverage name\",\n      \"limit\": \"$X,XXX,XXX\",\n      \"deductible\": \"$X,XXX or null\",\n      \"pageNumber\": number,\n      \"sectionRef\": \"section number reference or null\"\n    }\n  ],\n  \"document\": {\n    \"sections\": [\n      {\n        \"title\": \"section title\",\n        \"sectionNumber\": \"e.g. 'I', '1.1', 'A' \u2014 or null if unnumbered\",\n        \"pageStart\": number,\n        \"pageEnd\": number or null,\n        \"type\": \"one of: declarations, insuring_agreement, exclusion, condition, definition, endorsement, schedule, subjectivity, warranty, notice, regulatory, other\",\n        \"coverageType\": \"links to policyTypes value if section is coverage-specific, or null\",\n        \"content\": \"full verbatim text of the section\",\n        \"subsections\": [\n          {\n            \"title\": \"subsection title\",\n            \"sectionNumber\": \"subsection number or null\",\n            \"pageNumber\": number or null,\n            \"content\": \"full verbatim text\"\n          }\n        ]\n      }\n    ],\n    \"regulatoryContext\": {\n      \"content\": \"all regulatory context, governing law, jurisdiction clauses \u2014 verbatim\",\n      \"pageNumber\": number\n    },\n    \"complaintContact\": {\n      \"content\": \"complaint contact information and instructions \u2014 verbatim\",\n      \"pageNumber\": number\n    },\n    \"costsAndFees\": {\n      \"content\": \"other costs, fees, surcharges, and charges \u2014 verbatim\",\n      \"pageNumber\": number\n    }\n  },\n  \"totalPages\": number\n}\n\nIMPORTANT INSTRUCTIONS:\n- policyTypes should include ALL coverage types found in the document\n- documentType should be \"quote\" if this is a quote/proposal, \"policy\" if it is a bound policy\n- For carrier, use the primary company name. For security, use the full legal entity providing coverage\n- Extract EVERY section, clause, endorsement, and schedule from the document as a separate entry in document.sections\n- Preserve the original language exactly as written in the document \u2014 do not summarize\n- Include accurate page numbers for every section and data point\n- Classify each section by type (declarations, insuring_agreement, exclusion, condition, etc.)\n- If a section relates to a specific coverage type, set coverageType to match the policyTypes value\n- For regulatoryContext, complaintContact, and costsAndFees: set to null if not found in the document\n- subsections within a section are optional \u2014 only include if the section has clearly defined subsections";
+/**
+ * Pass 0: Document classification prompt (Haiku).
+ * Quick classification to determine if a document is a policy or a quote.
+ */
+declare const CLASSIFY_DOCUMENT_PROMPT = "You are an expert insurance document analyst. Classify this document as either a bound insurance POLICY or a QUOTE/PROPOSAL.\n\nRespond with JSON only:\n\n{\n  \"documentType\": \"policy\" or \"quote\",\n  \"confidence\": number between 0 and 1,\n  \"signals\": [\"signal 1\", \"signal 2\"]\n}\n\nCLASSIFICATION SIGNALS:\n- POLICY signals: declarations page, ISO form numbers (e.g. CG 00 01), binding language (\"This policy is issued to\"), endorsement schedules, \"Certificate of Insurance\"\n- QUOTE signals: \"quote\", \"proposal\", \"indication\" wording, subjectivities, \"subject to\" conditions, quote expiration date, \"proposed premium\", \"terms and conditions may vary\"\n\nIf uncertain, lean toward \"policy\" for documents with declarations pages and binding language, \"quote\" for everything else.";
+/**
+ * Chunked extraction: metadata-only prompt for the first pass on long documents.
+ * Used for both policy and quote extractions (documentType already known from pass 0).
+ */
+declare const METADATA_PROMPT = "You are an expert insurance document analyst. Extract ONLY the high-level metadata from this insurance document. Do NOT extract full section content \u2014 that will be done in a separate pass.\n\nRespond with JSON only:\n\n{\n  \"metadata\": {\n    \"carrier\": \"primary insurance company name\",\n    \"security\": \"insurer or underwriter entity providing coverage, or null\",\n    \"underwriter\": \"named individual underwriter, or null\",\n    \"mga\": \"MGA or Program Administrator, or null\",\n    \"broker\": \"insurance broker, or null\",\n    \"policyNumber\": \"policy number\",\n    \"documentType\": \"policy\" or \"quote\",\n    \"policyTypes\": [\"general_liability\", ...],\n    \"policyYear\": number,\n    \"effectiveDate\": \"MM/DD/YYYY\",\n    \"expirationDate\": \"MM/DD/YYYY\",\n    \"isRenewal\": boolean,\n    \"premium\": \"$X,XXX\",\n    \"insuredName\": \"name of insured party\",\n    \"summary\": \"1-2 sentence summary\"\n  },\n  \"metadataSource\": {\n    \"carrierPage\": number or null,\n    \"policyNumberPage\": number or null,\n    \"premiumPage\": number or null,\n    \"effectiveDatePage\": number or null\n  },\n  \"coverages\": [\n    { \"name\": \"coverage name\", \"limit\": \"$X,XXX,XXX\", \"deductible\": \"$X,XXX or null\", \"pageNumber\": number, \"sectionRef\": \"section ref or null\" }\n  ],\n  \"totalPages\": number,\n  \"tableOfContents\": [\n    { \"title\": \"section title\", \"pageStart\": number, \"pageEnd\": number }\n  ]\n}";
+/**
+ * Quote-specific metadata prompt (Sonnet).
+ * Extracts quote-specific fields like subjectivities, underwriting conditions, premium breakdown.
+ */
+declare const QUOTE_METADATA_PROMPT = "You are an expert insurance document analyst. Extract ONLY the high-level metadata from this insurance QUOTE or PROPOSAL document. Do NOT extract full section content \u2014 that will be done in a separate pass.\n\nRespond with JSON only:\n\n{\n  \"metadata\": {\n    \"carrier\": \"primary insurance company name\",\n    \"security\": \"insurer or underwriter entity providing coverage, or null\",\n    \"underwriter\": \"named individual underwriter, or null\",\n    \"mga\": \"MGA or Program Administrator, or null\",\n    \"broker\": \"insurance broker, or null\",\n    \"quoteNumber\": \"quote or proposal reference number\",\n    \"policyTypes\": [\"general_liability\", ...],\n    \"quoteYear\": number,\n    \"proposedEffectiveDate\": \"MM/DD/YYYY or null\",\n    \"proposedExpirationDate\": \"MM/DD/YYYY or null\",\n    \"quoteExpirationDate\": \"MM/DD/YYYY \u2014 when this quote offer expires, or null\",\n    \"isRenewal\": boolean,\n    \"premium\": \"$X,XXX \u2014 total proposed premium\",\n    \"insuredName\": \"name of insured party\",\n    \"summary\": \"1-2 sentence summary of the quote\"\n  },\n  \"metadataSource\": {\n    \"carrierPage\": number or null,\n    \"quoteNumberPage\": number or null,\n    \"premiumPage\": number or null,\n    \"effectiveDatePage\": number or null\n  },\n  \"coverages\": [\n    { \"name\": \"coverage name\", \"proposedLimit\": \"$X,XXX,XXX\", \"proposedDeductible\": \"$X,XXX or null\", \"pageNumber\": number, \"sectionRef\": \"section ref or null\" }\n  ],\n  \"premiumBreakdown\": [\n    { \"line\": \"coverage line name\", \"amount\": \"$X,XXX\" }\n  ],\n  \"subjectivities\": [\n    { \"description\": \"subjectivity description\", \"category\": \"pre_binding\" or \"post_binding\" or \"information\" or null, \"pageNumber\": number or null }\n  ],\n  \"underwritingConditions\": [\n    { \"description\": \"condition description\", \"pageNumber\": number or null }\n  ],\n  \"totalPages\": number,\n  \"tableOfContents\": [\n    { \"title\": \"section title\", \"pageStart\": number, \"pageEnd\": number }\n  ]\n}\n\nIMPORTANT:\n- quoteExpirationDate is when the quote offer itself expires (not the proposed policy period)\n- subjectivities are conditions that must be met before or after binding (look for \"subject to\", \"subjectivities\", \"conditions precedent\")\n- premiumBreakdown should list each coverage line's individual premium if available";
+/**
+ * Chunked extraction: sections prompt for a specific page range (policies).
+ */
+declare function buildSectionsPrompt(pageStart: number, pageEnd: number): string;
+/** Alias for backward compatibility */
+declare const buildPolicySectionsPrompt: typeof buildSectionsPrompt;
+/**
+ * Chunked extraction: sections prompt for quote documents.
+ */
+declare function buildQuoteSectionsPrompt(pageStart: number, pageEnd: number): string;
+/**
+ * Pass 3: Supplementary field enrichment prompt.
+ * Text-only (no PDF) — parses raw text blobs into structured data.
+ */
+declare function buildSupplementaryEnrichmentPrompt(fields: {
+    regulatoryContext?: string;
+    complaintContact?: string;
+    costsAndFees?: string;
+    claimsContact?: string;
+}): string;
+
+declare const APPLICATION_CLASSIFY_PROMPT = "You are classifying a PDF document. Determine if this is an insurance APPLICATION FORM (a form to be filled out to apply for insurance) versus a policy document, quote, certificate, or other document.\n\nInsurance applications typically:\n- Have blank fields, checkboxes, or spaces to fill in\n- Ask for company information, coverage limits, loss history\n- Include ACORD form numbers or \"Application for\" in the title\n- Request signatures and dates\n\nRespond with JSON only:\n{\n  \"isApplication\": boolean,\n  \"confidence\": number (0-1),\n  \"applicationType\": string | null  // e.g. \"General Liability\", \"Professional Liability\", \"Commercial Property\", \"Workers Compensation\", \"ACORD 125\", etc.\n}";
+declare function buildFieldExtractionPrompt(): string;
+declare function buildAutoFillPrompt(fields: {
+    id: string;
+    label: string;
+    fieldType: string;
+    section: string;
+}[], orgContext: {
+    key: string;
+    value: string;
+    category: string;
+}[]): string;
+declare function buildQuestionBatchPrompt(unfilledFields: {
+    id: string;
+    label?: string;
+    text?: string;
+    fieldType: string;
+    section: string;
+    required: boolean;
+    condition?: {
+        dependsOn: string;
+        whenValue: string;
+    };
+}[]): string;
+declare function buildAnswerParsingPrompt(questions: {
+    id: string;
+    label?: string;
+    text?: string;
+    fieldType: string;
+}[], emailBody: string): string;
+declare function buildConfirmationSummaryPrompt(fields: {
+    id: string;
+    label?: string;
+    text?: string;
+    section: string;
+    fieldType: string;
+    value?: string;
+}[], applicationTitle: string): string;
+declare function buildBatchEmailGenerationPrompt(batchFields: {
+    id: string;
+    label: string;
+    fieldType: string;
+    options?: string[];
+    condition?: {
+        dependsOn: string;
+        whenValue: string;
+    };
+}[], batchIndex: number, totalBatches: number, appTitle: string | undefined, totalFieldCount: number, filledFieldCount: number, previousBatchSummary?: string, companyName?: string): string;
+declare function buildReplyIntentClassificationPrompt(questions: {
+    id: string;
+    label: string;
+}[], emailBody: string): string;
+declare function buildFieldExplanationPrompt(field: {
+    id: string;
+    label: string;
+    fieldType: string;
+    options?: string[];
+}, question: string, policyContext?: string): string;
+declare function buildFlatPdfMappingPrompt(extractedFields: {
+    id: string;
+    label: string;
+    value: string;
+    fieldType: string;
+}[]): string;
+declare function buildAcroFormMappingPrompt(extractedFields: {
+    id: string;
+    label: string;
+    value?: string;
+}[], acroFormFields: {
+    name: string;
+    type: string;
+    options?: string[];
+}[]): string;
+declare function buildLookupFillPrompt(requests: {
+    type: string;
+    description: string;
+    targetFieldIds: string[];
+}[], targetFields: {
+    id: string;
+    label: string;
+    fieldType: string;
+}[], availableData: string): string;
+
+declare function buildIdentityPrompt(ctx: AgentContext): string;
+
+declare function buildSafetyPrompt(ctx: AgentContext): string;
+
+declare function buildFormattingPrompt(ctx: AgentContext): string;
+
+declare function buildCoverageGapPrompt(ctx: AgentContext): string | null;
+
+declare function buildCoiRoutingPrompt(ctx: AgentContext): string | null;
+
+declare function buildQuotesPoliciesPrompt(): string;
+
+declare function buildConversationMemoryGuidance(): string;
+
+declare function buildIntentPrompt(ctx: AgentContext): string;
+
+/**
+ * Build a complete agent system prompt from composable modules.
+ *
+ * Composes: identity -> company context -> intent -> formatting -> safety
+ *   -> coverage gaps -> COI routing -> quotes/policies -> memory guidance.
+ *
+ * Modules that return null (e.g. coverage gaps in direct mode) are filtered out.
+ */
+declare function buildAgentSystemPrompt(ctx: AgentContext): string;
+
+/**
+ * @deprecated Use `buildAgentSystemPrompt` from `prompts/agent/index` instead.
+ * Maps legacy mode strings to the new platform/intent API.
+ */
+declare function buildSystemPrompt(mode: "direct" | "cc" | "forward", companyContext: string | undefined, siteUrl: string, companyName?: string, userName?: string, coiHandling?: "broker" | "user" | "member" | "ignore", brokerName?: string, brokerContactName?: string, brokerContactEmail?: string): string;
+/** @deprecated Use buildDocumentContext instead */
+declare function buildPolicyContext(policies: PolicyDocument[], queryText: string): {
+    context: string;
+    relevantPolicyIds: string[];
+};
+declare function buildDocumentContext(policies: PolicyDocument[], quotes: QuoteDocument[], queryText: string): {
+    context: string;
+    relevantPolicyIds: string[];
+    relevantQuoteIds: string[];
+};
+interface PastConversation {
+    fromName?: string;
+    fromEmail: string;
+    subject: string;
+    body: string;
+    responseBody: string;
+    _creationTime: number;
+    threadId?: string;
+}
+declare function buildConversationMemoryContext(conversations: PastConversation[]): string;
+
+/**
+ * Build a platform-agnostic message classification prompt.
+ *
+ * The prompt instructs Claude to classify an incoming message and suggest
+ * an intent, with platform-specific context fields included in the schema.
+ */
+declare function buildClassifyMessagePrompt(platform: Platform): string;
+
+/**
+ * @deprecated Use `buildClassifyMessagePrompt("email")` from `prompts/intent` instead.
+ */
+declare const CLASSIFY_EMAIL_PROMPT = "You are an AI assistant that classifies emails. Determine if this email is related to insurance policies (new policies, renewals, certificates of insurance, policy documents, endorsements, binders, premium notices, etc).\n\nRespond with JSON only:\n{\n  \"isInsurance\": boolean,\n  \"reason\": \"brief explanation\",\n  \"confidence\": number between 0 and 1\n}\n\nEmail subject: {{subject}}\nFrom: {{from}}\nDate: {{date}}";
+
+interface ToolDefinition {
+    name: string;
+    description: string;
+    input_schema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+declare const DOCUMENT_LOOKUP_TOOL: ToolDefinition;
+declare const COI_GENERATION_TOOL: ToolDefinition;
+declare const COVERAGE_COMPARISON_TOOL: ToolDefinition;
+declare const AGENT_TOOLS: ToolDefinition[];
+
+/**
+ * Multi-pass extraction pipeline for insurance PDFs.
+ *
+ * Processes documents in up to 4 passes with adaptive fallback:
+ *
+ * - **Pass 0 (Classification)**: Classification model classifies document as policy or quote.
+ * - **Pass 1 (Metadata)**: Metadata model extracts high-level metadata (carrier, dates,
+ *   premium, coverages). Supports `onMetadata?()` callback for early persistence
+ *   so metadata survives pass 2 failures.
+ * - **Pass 2 (Sections)**: Chunked extraction with sections model. Documents are split into
+ *   15-page chunks; on JSON parse failure (usually output truncation), re-splits
+ *   to 10 -> 5 pages, then falls back to sectionsFallback model. `mergeChunkedSections()` combines.
+ * - **Pass 3 (Enrichment)**: Enrichment model enriches supplementary fields (regulatory context,
+ *   contacts) from raw text. Non-fatal on failure.
+ *
+ * Separate entry points exist for policies (`extractFromPdf`) vs quotes
+ * (`extractQuoteFromPdf`). `extractSectionsOnly()` retries pass 2 using
+ * saved metadata from a prior pass 1.
+ *
+ * Provider-agnostic: accepts `ModelConfig` with Vercel AI SDK `LanguageModel` instances.
+ * Defaults to Anthropic models via `createDefaultModelConfig()`.
+ */
+
+declare const SONNET_MODEL = "claude-sonnet-4-6";
+declare const HAIKU_MODEL = "claude-haiku-4-5-20251001";
+type LogFn = (message: string) => Promise<void>;
+/** Strip markdown code fences from AI response text. */
+declare function stripFences(text: string): string;
+/**
+ * Recursively convert null values to undefined.
+ *
+ * Required because Convex rejects `null` for optional fields, but Claude
+ * routinely returns `null` for missing values in JSON output. Applied to
+ * all extraction results before persistence.
+ */
+declare function sanitizeNulls<T>(obj: T): T;
+/** Map raw Claude extraction JSON to mutation-compatible fields. */
+declare function applyExtracted(extracted: any): {
+    carrier: any;
+    security: any;
+    underwriter: any;
+    mga: any;
+    broker: any;
+    policyNumber: any;
+    policyTypes: any;
+    documentType: "policy" | "quote";
+    policyYear: any;
+    effectiveDate: any;
+    expirationDate: any;
+    isRenewal: any;
+    coverages: any;
+    premium: any;
+    insuredName: any;
+    summary: any;
+    metadataSource: any;
+    document: any;
+    extractionStatus: "complete";
+    extractionError: string;
+};
+/**
+ * Merge document sections from chunked extraction passes.
+ *
+ * Combines sections from all chunks into a single array and takes the last
+ * non-null value for supplementary fields (regulatoryContext, complaintContact,
+ * costsAndFees, claimsContact) since these typically appear only once.
+ */
+declare function mergeChunkedSections(metadataResult: any, sectionChunks: any[]): any;
+/** Determine page ranges for chunked extraction. */
+declare function getPageChunks(totalPages: number, chunkSize?: number): Array<[number, number]>;
+/**
+ * Pass 3: Enrich supplementary fields with structured data.
+ * Text-only enrichment call — non-fatal on failure (returns document unchanged).
+ */
+declare function enrichSupplementaryFields(document: any, models?: ModelConfig, log?: LogFn): Promise<any>;
+interface ClassifyOptions {
+    log?: LogFn;
+    models?: ModelConfig;
+}
+/**
+ * Pass 0: Classify document as policy or quote.
+ */
+declare function classifyDocumentType(pdfBase64: string, options?: ClassifyOptions): Promise<{
+    documentType: "policy" | "quote";
+    confidence: number;
+    signals: string[];
+}>;
+/** Map raw Claude quote extraction JSON to mutation-compatible fields. */
+declare function applyExtractedQuote(extracted: any): {
+    carrier: any;
+    security: any;
+    underwriter: any;
+    mga: any;
+    broker: any;
+    quoteNumber: any;
+    policyTypes: any;
+    quoteYear: any;
+    proposedEffectiveDate: any;
+    proposedExpirationDate: any;
+    quoteExpirationDate: any;
+    isRenewal: any;
+    coverages: any;
+    premium: any;
+    premiumBreakdown: any;
+    insuredName: any;
+    summary: any;
+    subjectivities: any;
+    underwritingConditions: any;
+    metadataSource: any;
+    document: any;
+    extractionStatus: "complete";
+    extractionError: string;
+};
+/**
+ * Merge document sections from chunked quote extraction passes.
+ *
+ * Similar to `mergeChunkedSections` but also accumulates quote-specific
+ * fields: subjectivities and underwriting conditions from all chunks.
+ */
+declare function mergeChunkedQuoteSections(metadataResult: any, sectionChunks: any[]): any;
+type PromptBuilder = (pageStart: number, pageEnd: number) => string;
+interface ExtractOptions {
+    log?: LogFn;
+    onMetadata?: (raw: string) => Promise<void>;
+    models?: ModelConfig;
+    /** Provider-specific options for metadata calls (e.g. Anthropic thinking). Defaults to Anthropic thinking enabled. */
+    metadataProviderOptions?: ProviderOptions;
+    /** Provider-specific options for fallback calls. Defaults to Anthropic thinking enabled. */
+    fallbackProviderOptions?: ProviderOptions;
+}
+/**
+ * Full extraction pipeline for policy documents (passes 1-3).
+ *
+ * - **Pass 1**: Metadata model extracts metadata, coverages, and page count.
+ * - **Pass 2**: Sections model extracts sections in chunks (with adaptive retry and fallback).
+ * - **Pass 3**: Enrichment model enriches supplementary fields (non-fatal).
+ *
+ * @param pdfBase64 - Base64-encoded PDF document.
+ * @param options - Extraction options (models, logging, callbacks, provider options).
+ */
+declare function extractFromPdf(pdfBase64: string, options?: ExtractOptions): Promise<{
+    rawText: string;
+    extracted: any;
+}>;
+interface ExtractSectionsOptions {
+    log?: LogFn;
+    promptBuilder?: PromptBuilder;
+    models?: ModelConfig;
+    /** Provider-specific options for fallback calls. */
+    fallbackProviderOptions?: ProviderOptions;
+}
+/**
+ * Sections-only extraction: skip pass 1, use saved metadata.
+ * For retrying when metadata succeeded but sections failed.
+ */
+declare function extractSectionsOnly(pdfBase64: string, metadataRaw: string, options?: ExtractSectionsOptions): Promise<{
+    rawText: string;
+    extracted: any;
+}>;
+/**
+ * Full extraction pipeline for quote documents (passes 1-2).
+ *
+ * - **Pass 1**: Metadata model extracts quote-specific metadata (proposed dates,
+ *   subjectivities, premium breakdown).
+ * - **Pass 2**: Sections model extracts sections in chunks (with adaptive retry).
+ *
+ * Does not run pass 3 enrichment (quotes rarely have supplementary fields).
+ *
+ * @param pdfBase64 - Base64-encoded PDF document.
+ * @param options - Extraction options (models, logging, callbacks, provider options).
+ */
+declare function extractQuoteFromPdf(pdfBase64: string, options?: ExtractOptions): Promise<{
+    rawText: string;
+    extracted: any;
+}>;
+
+interface AcroFormFieldInfo {
+    name: string;
+    type: "text" | "checkbox" | "dropdown" | "radio";
+    options?: string[];
+}
+/** Enumerate all AcroForm fields from a PDF. Returns empty array if no form. */
+declare function getAcroFormFields(pdfDoc: PDFDocument): AcroFormFieldInfo[];
+interface FieldMapping {
+    acroFormName: string;
+    value: string;
+}
+/** Fill AcroForm fields by mapping, flatten, and return bytes. */
+declare function fillAcroForm(pdfBytes: Uint8Array, mappings: FieldMapping[]): Promise<Uint8Array>;
+interface TextOverlay {
+    page: number;
+    x: number;
+    y: number;
+    text: string;
+    fontSize?: number;
+    isCheckmark?: boolean;
+}
+/** Overlay text on a flat PDF at specified coordinates. */
+declare function overlayTextOnPdf(pdfBytes: Uint8Array, overlays: TextOverlay[]): Promise<Uint8Array>;
+
+export { AGENT_TOOLS, APPLICATION_CLASSIFY_PROMPT, type AcroFormFieldInfo, type AgentContext, type BaseDocument, CLASSIFY_DOCUMENT_PROMPT, CLASSIFY_EMAIL_PROMPT, COI_GENERATION_TOOL, COVERAGE_COMPARISON_TOOL, type ClassifyOptions, type CommunicationIntent, type Coverage, DOCUMENT_LOOKUP_TOOL, EXTRACTION_PROMPT, type ExtractOptions, type ExtractSectionsOptions, type FieldMapping, HAIKU_MODEL, type InsuranceDocument, type LogFn, METADATA_PROMPT, MODEL_TOKEN_LIMITS, type ModelConfig, PLATFORM_CONFIGS, type Platform, type PlatformConfig, type PolicyDocument, type PremiumLine, type PromptBuilder, QUOTE_METADATA_PROMPT, type QuoteDocument, SONNET_MODEL, type Section, type Subjectivity, type Subsection, type TextOverlay, type ToolDefinition, type UnderwritingCondition, applyExtracted, applyExtractedQuote, buildAcroFormMappingPrompt, buildAgentSystemPrompt, buildAnswerParsingPrompt, buildAutoFillPrompt, buildBatchEmailGenerationPrompt, buildClassifyMessagePrompt, buildCoiRoutingPrompt, buildConfirmationSummaryPrompt, buildConversationMemoryContext, buildConversationMemoryGuidance, buildCoverageGapPrompt, buildDocumentContext, buildFieldExplanationPrompt, buildFieldExtractionPrompt, buildFlatPdfMappingPrompt, buildFormattingPrompt, buildIdentityPrompt, buildIntentPrompt, buildLookupFillPrompt, buildPolicyContext, buildPolicySectionsPrompt, buildQuestionBatchPrompt, buildQuoteSectionsPrompt, buildQuotesPoliciesPrompt, buildReplyIntentClassificationPrompt, buildSafetyPrompt, buildSectionsPrompt, buildSupplementaryEnrichmentPrompt, buildSystemPrompt, classifyDocumentType, createDefaultModelConfig, createUniformModelConfig, enrichSupplementaryFields, extractFromPdf, extractQuoteFromPdf, extractSectionsOnly, fillAcroForm, getAcroFormFields, getPageChunks, mergeChunkedQuoteSections, mergeChunkedSections, overlayTextOnPdf, sanitizeNulls, stripFences };