@claritylabs/cl-sdk 4.2.0 → 4.4.0

package/README.md

@@ -75,7 +75,7 @@ const extractor = createExtractor({ generateObject, sourceStore });
 const result = await extractor.extract(pdfBase64, "policy-123", { sourceSpans });
 ```
 
-When source spans are available, extraction returns `sourceTree`, `sourceSpans`, `operationalProfile`, `warnings`, `tokenUsage`, and `performanceReport`. The source tree is canonical for policy wording and hierarchy. The extractor groups parser-provided page, title, table, row, and text spans into declarations, policy forms, endorsements, sections, and schedules without running a separate form-inventory, page-map, or source-tree-organizer model call. The operational profile model receives a bounded packet of high-value declaration, schedule, premium, producer, endorsement, and coverage evidence rather than the full document wording. The operational profile contains model-extracted policy metadata, ACORD `linesOfBusiness`, parties, coverage units, nested coverage limit terms, deductibles/retentions, premiums, key dates, endorsement-support facts, and source-backed `declarationFacts` for named-insured identity details such as mailing address, DBA, entity type, tax ID, and additional named insured rows. Each fact keeps `sourceNodeIds` and `sourceSpanIds`. Source-backed identity records such as insurer, producer, contacts, named insured rows, endorsement parties, standalone insured addresses, and declaration facts must include non-empty `sourceSpanIds`. After extraction, a bounded model cleanup pass may keep, drop, or update existing coverage rows and terms by index; the SDK enforces the schema and rejects source IDs that are not present in the current source tree/spans. Endorsement schedules are modeled as whole endorsement coverage units with their own `limits[]` terms instead of unrelated flat rows like `Aggregate Limit`.
+When source spans are available, extraction returns `sourceTree`, `sourceSpans`, `operationalProfile`, `warnings`, `tokenUsage`, and `performanceReport`. The source tree is canonical for policy wording and hierarchy. The extractor groups parser-provided page, title, table, row, and text spans into declarations, policy forms, endorsements, sections, and schedules without running a separate form-inventory, page-map, or source-tree-organizer model call. The operational profile model receives a bounded packet of high-value declaration, schedule, premium, policy-party, operations-description, endorsement, and coverage evidence rather than the full document wording. The operational profile contains model-extracted policy metadata, ACORD `linesOfBusiness`, a source-backed insured operations description, policy-scoped parties and their available structured addresses, coverage units, nested coverage limit terms, deductibles/retentions, premiums, key dates, endorsement-support facts, and source-backed `declarationFacts` for named-insured identity details such as mailing address, DBA, entity type, tax ID, and additional named insured rows. Each fact keeps `sourceNodeIds` and `sourceSpanIds`. The compatibility document projection materializes complete named-insured, producer, and insurer addresses while partial and MGA/administrator addresses remain available in `operationalProfile.parties`. Source-backed identity records such as insurer, producer, contacts, named insured rows, endorsement parties, standalone insured addresses, and declaration facts must include non-empty `sourceSpanIds`. After extraction, a bounded model cleanup pass may keep, drop, or update existing coverage rows and terms by index; the SDK enforces the schema and rejects source IDs that are not present in the current source tree/spans. Endorsement schedules are modeled as whole endorsement coverage units with their own `limits[]` terms instead of unrelated flat rows like `Aggregate Limit`.
 
 CL SDK 4.0 replaces the old `PolicyType` enum and operational-profile `policyTypes` field with ACORD line of business codes. Use `AcordLobCode`, `AcordLobCodeSchema`, `ACORD_LOB_CODES`, `ACORD_LOB_LABELS`, `LEGACY_POLICY_TYPE_TO_LOB`, `PERSONAL_LOB_CODES`, `normalizeOperationalLinesOfBusiness`, and `resolveOperationalProfileLinesOfBusiness`. Serialized legacy profiles with `policyTypes` are still accepted by `PolicyOperationalProfileSchema` and normalize to `linesOfBusiness`.
 
@@ -143,7 +143,7 @@ Every SDK model callback may receive `taskKind`, `budgetDiagnostics`, and `trace
 CL-SDK uses deterministic scaffolding with agentic decision points rather than fixed all-tools-all-the-time chains:
 
 - Policy extraction requires caller-provided source spans and does not run the older form-inventory, page-map, focused-extractor, or source-tree-organizer model calls.
-- Source-tree construction stays deterministic from parser spans; the model is used for the operational profile and optional coverage cleanup because those are end-user facts.
+- Source-tree construction stays deterministic from parser spans; models are used for the operational profile, opt-in document-wide coverage recovery, and coverage cleanup because those are end-user facts. Recovery uses compact sketches for every page and bounded source-cited region batches.
 - Referential coverage resolution and application/query workflows still use bounded target-specific actions when those workflows need lookup or explanation steps.
 - Formatting skips the LLM cleanup pass for plain prose and formats long or noisy markdown/table/list content in parallel batches outside the v3 source-span extraction path.
 - Application processing plans optional backfill, context auto-fill, document search, batching, reply parsing, lookup, explanations, and next-batch email generation based on current active question state. Conditional fields that are not active are skipped until their parent answers trigger them.

package/dist/application.d.mts

@@ -1,2 +1,2 @@
-export { s as AcroFormMapping, t as AcroFormMappingSchema, u as AnswerParsingResult, v as AnswerParsingResultSchema, w as ApplicationClassifyResult, x as ApplicationClassifyResultSchema, y as ApplicationContextProposal, z as ApplicationContextProposalSchema, C as ApplicationEmailReviewSchema, E as ApplicationField, F as ApplicationFieldSchema, H as ApplicationListFilters, J as ApplicationNextQuestions, K as ApplicationPacket, N as ApplicationPacketAnswer, R as ApplicationPacketAnswerSchema, V as ApplicationPacketSchema, W as ApplicationPipelineConfig, X as ApplicationQualityArtifactSchema, Y as ApplicationQualityIssueSchema, Z as ApplicationQualityReportSchema, _ as ApplicationQualityRoundSchema, $ as ApplicationQuestionCondition, a0 as ApplicationQuestionConditionSchema, a1 as ApplicationQuestionGraph, a2 as ApplicationQuestionGraphSchema, a3 as ApplicationQuestionNode, a4 as ApplicationQuestionNodeSchema, a5 as ApplicationRepeat, a6 as ApplicationRepeatSchema, a7 as ApplicationState, a8 as ApplicationStateSchema, a9 as ApplicationStore, aa as ApplicationTemplate, ab as ApplicationTemplateListFilters, ac as ApplicationTemplateSchema, ad as ApplicationTemplateStore, ae as AutoFillMatch, af as AutoFillMatchSchema, ag as AutoFillResult, ah as AutoFillResultSchema, ak as BackfillProvider, al as BuildApplicationPacketInput, am as BuildApplicationPacketResult, aq as ContextProposalResult, av as CreateApplicationRunInput, aN as FieldExtractionResult, aO as FieldExtractionResultSchema, aP as FieldType, aQ as FieldTypeSchema, aR as FlatPdfPlacement, aS as FlatPdfPlacementSchema, aU as LookupFill, aV as LookupFillResult, aW as LookupFillResultSchema, aX as LookupFillSchema, aY as LookupRequest, aZ as LookupRequestSchema, bb as ParsedAnswer, bc as ParsedAnswerSchema, bk as PriorAnswer, bl as ProcessApplicationInput, bm as ProcessApplicationResult, bn as ProcessReplyInput, bo as ProcessReplyResult, bp as QuestionBatchResult, bq as QuestionBatchResultSchema, bt as ReplyIntent, bu as ReplyIntentSchema, bR as applyApplicationAnswers, bS as buildApplicationPacket, bT as buildQuestionGraphFromFields, bU as createApplicationPipeline, bV as createApplicationRun, bW as extractQuestionGraphFromFields, bX as flattenQuestionGraph, bY as getActiveApplicationFields, bZ as getNextApplicationQuestions, b_ as normalizeApplicationQuestionGraph, b$ as planNextApplicationQuestions, c0 as proposeContextWrites, c2 as validateApplicationPacket } from './index-C9XfOdmx.mjs';
+export { s as AcroFormMapping, t as AcroFormMappingSchema, u as AnswerParsingResult, v as AnswerParsingResultSchema, w as ApplicationClassifyResult, x as ApplicationClassifyResultSchema, y as ApplicationContextProposal, z as ApplicationContextProposalSchema, C as ApplicationEmailReviewSchema, E as ApplicationField, F as ApplicationFieldSchema, H as ApplicationListFilters, J as ApplicationNextQuestions, K as ApplicationPacket, N as ApplicationPacketAnswer, R as ApplicationPacketAnswerSchema, V as ApplicationPacketSchema, W as ApplicationPipelineConfig, X as ApplicationQualityArtifactSchema, Y as ApplicationQualityIssueSchema, Z as ApplicationQualityReportSchema, _ as ApplicationQualityRoundSchema, $ as ApplicationQuestionCondition, a0 as ApplicationQuestionConditionSchema, a1 as ApplicationQuestionGraph, a2 as ApplicationQuestionGraphSchema, a3 as ApplicationQuestionNode, a4 as ApplicationQuestionNodeSchema, a5 as ApplicationRepeat, a6 as ApplicationRepeatSchema, a7 as ApplicationState, a8 as ApplicationStateSchema, a9 as ApplicationStore, aa as ApplicationTemplate, ab as ApplicationTemplateListFilters, ac as ApplicationTemplateSchema, ad as ApplicationTemplateStore, ae as AutoFillMatch, af as AutoFillMatchSchema, ag as AutoFillResult, ah as AutoFillResultSchema, ak as BackfillProvider, al as BuildApplicationPacketInput, am as BuildApplicationPacketResult, aq as ContextProposalResult, av as CreateApplicationRunInput, aN as FieldExtractionResult, aO as FieldExtractionResultSchema, aP as FieldType, aQ as FieldTypeSchema, aR as FlatPdfPlacement, aS as FlatPdfPlacementSchema, aU as LookupFill, aV as LookupFillResult, aW as LookupFillResultSchema, aX as LookupFillSchema, aY as LookupRequest, aZ as LookupRequestSchema, bl as ParsedAnswer, bm as ParsedAnswerSchema, bu as PriorAnswer, bv as ProcessApplicationInput, bw as ProcessApplicationResult, bx as ProcessReplyInput, by as ProcessReplyResult, bz as QuestionBatchResult, bA as QuestionBatchResultSchema, bD as ReplyIntent, bE as ReplyIntentSchema, b$ as applyApplicationAnswers, c0 as buildApplicationPacket, c1 as buildQuestionGraphFromFields, c2 as createApplicationPipeline, c3 as createApplicationRun, c4 as extractQuestionGraphFromFields, c5 as flattenQuestionGraph, c6 as getActiveApplicationFields, c7 as getNextApplicationQuestions, c8 as normalizeApplicationQuestionGraph, c9 as planNextApplicationQuestions, ca as proposeContextWrites, cc as validateApplicationPacket } from './index-CReSzyKJ.mjs';
 import 'zod';

package/dist/application.d.ts

@@ -1,2 +1,2 @@
-export { s as AcroFormMapping, t as AcroFormMappingSchema, u as AnswerParsingResult, v as AnswerParsingResultSchema, w as ApplicationClassifyResult, x as ApplicationClassifyResultSchema, y as ApplicationContextProposal, z as ApplicationContextProposalSchema, C as ApplicationEmailReviewSchema, E as ApplicationField, F as ApplicationFieldSchema, H as ApplicationListFilters, J as ApplicationNextQuestions, K as ApplicationPacket, N as ApplicationPacketAnswer, R as ApplicationPacketAnswerSchema, V as ApplicationPacketSchema, W as ApplicationPipelineConfig, X as ApplicationQualityArtifactSchema, Y as ApplicationQualityIssueSchema, Z as ApplicationQualityReportSchema, _ as ApplicationQualityRoundSchema, $ as ApplicationQuestionCondition, a0 as ApplicationQuestionConditionSchema, a1 as ApplicationQuestionGraph, a2 as ApplicationQuestionGraphSchema, a3 as ApplicationQuestionNode, a4 as ApplicationQuestionNodeSchema, a5 as ApplicationRepeat, a6 as ApplicationRepeatSchema, a7 as ApplicationState, a8 as ApplicationStateSchema, a9 as ApplicationStore, aa as ApplicationTemplate, ab as ApplicationTemplateListFilters, ac as ApplicationTemplateSchema, ad as ApplicationTemplateStore, ae as AutoFillMatch, af as AutoFillMatchSchema, ag as AutoFillResult, ah as AutoFillResultSchema, ak as BackfillProvider, al as BuildApplicationPacketInput, am as BuildApplicationPacketResult, aq as ContextProposalResult, av as CreateApplicationRunInput, aN as FieldExtractionResult, aO as FieldExtractionResultSchema, aP as FieldType, aQ as FieldTypeSchema, aR as FlatPdfPlacement, aS as FlatPdfPlacementSchema, aU as LookupFill, aV as LookupFillResult, aW as LookupFillResultSchema, aX as LookupFillSchema, aY as LookupRequest, aZ as LookupRequestSchema, bb as ParsedAnswer, bc as ParsedAnswerSchema, bk as PriorAnswer, bl as ProcessApplicationInput, bm as ProcessApplicationResult, bn as ProcessReplyInput, bo as ProcessReplyResult, bp as QuestionBatchResult, bq as QuestionBatchResultSchema, bt as ReplyIntent, bu as ReplyIntentSchema, bR as applyApplicationAnswers, bS as buildApplicationPacket, bT as buildQuestionGraphFromFields, bU as createApplicationPipeline, bV as createApplicationRun, bW as extractQuestionGraphFromFields, bX as flattenQuestionGraph, bY as getActiveApplicationFields, bZ as getNextApplicationQuestions, b_ as normalizeApplicationQuestionGraph, b$ as planNextApplicationQuestions, c0 as proposeContextWrites, c2 as validateApplicationPacket } from './index-C9XfOdmx.js';
+export { s as AcroFormMapping, t as AcroFormMappingSchema, u as AnswerParsingResult, v as AnswerParsingResultSchema, w as ApplicationClassifyResult, x as ApplicationClassifyResultSchema, y as ApplicationContextProposal, z as ApplicationContextProposalSchema, C as ApplicationEmailReviewSchema, E as ApplicationField, F as ApplicationFieldSchema, H as ApplicationListFilters, J as ApplicationNextQuestions, K as ApplicationPacket, N as ApplicationPacketAnswer, R as ApplicationPacketAnswerSchema, V as ApplicationPacketSchema, W as ApplicationPipelineConfig, X as ApplicationQualityArtifactSchema, Y as ApplicationQualityIssueSchema, Z as ApplicationQualityReportSchema, _ as ApplicationQualityRoundSchema, $ as ApplicationQuestionCondition, a0 as ApplicationQuestionConditionSchema, a1 as ApplicationQuestionGraph, a2 as ApplicationQuestionGraphSchema, a3 as ApplicationQuestionNode, a4 as ApplicationQuestionNodeSchema, a5 as ApplicationRepeat, a6 as ApplicationRepeatSchema, a7 as ApplicationState, a8 as ApplicationStateSchema, a9 as ApplicationStore, aa as ApplicationTemplate, ab as ApplicationTemplateListFilters, ac as ApplicationTemplateSchema, ad as ApplicationTemplateStore, ae as AutoFillMatch, af as AutoFillMatchSchema, ag as AutoFillResult, ah as AutoFillResultSchema, ak as BackfillProvider, al as BuildApplicationPacketInput, am as BuildApplicationPacketResult, aq as ContextProposalResult, av as CreateApplicationRunInput, aN as FieldExtractionResult, aO as FieldExtractionResultSchema, aP as FieldType, aQ as FieldTypeSchema, aR as FlatPdfPlacement, aS as FlatPdfPlacementSchema, aU as LookupFill, aV as LookupFillResult, aW as LookupFillResultSchema, aX as LookupFillSchema, aY as LookupRequest, aZ as LookupRequestSchema, bl as ParsedAnswer, bm as ParsedAnswerSchema, bu as PriorAnswer, bv as ProcessApplicationInput, bw as ProcessApplicationResult, bx as ProcessReplyInput, by as ProcessReplyResult, bz as QuestionBatchResult, bA as QuestionBatchResultSchema, bD as ReplyIntent, bE as ReplyIntentSchema, b$ as applyApplicationAnswers, c0 as buildApplicationPacket, c1 as buildQuestionGraphFromFields, c2 as createApplicationPipeline, c3 as createApplicationRun, c4 as extractQuestionGraphFromFields, c5 as flattenQuestionGraph, c6 as getActiveApplicationFields, c7 as getNextApplicationQuestions, c8 as normalizeApplicationQuestionGraph, c9 as planNextApplicationQuestions, ca as proposeContextWrites, cc as validateApplicationPacket } from './index-CReSzyKJ.js';
 import 'zod';

package/dist/application.js

@@ -1610,9 +1610,45 @@ var OperationalCoverageLineSchema = import_zod3.z.object({
   sourceNodeIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([]),
   sourceSpanIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([])
 });
+var OperationalCoverageScheduleValueSchema = import_zod3.z.object({
+  label: import_zod3.z.string(),
+  value: import_zod3.z.string()
+});
+var OperationalCoverageScheduleItemSchema = import_zod3.z.object({
+  label: import_zod3.z.string(),
+  description: import_zod3.z.string().optional(),
+  values: import_zod3.z.array(OperationalCoverageScheduleValueSchema).default([]),
+  sourceSpanIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([])
+});
+var OperationalCoverageScheduleSchema = import_zod3.z.object({
+  name: import_zod3.z.string(),
+  kind: import_zod3.z.enum(["vehicle", "property", "location", "other"]),
+  description: import_zod3.z.string().optional(),
+  items: import_zod3.z.array(OperationalCoverageScheduleItemSchema).default([]),
+  sourceSpanIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([]),
+  pageStart: import_zod3.z.number().int().positive().optional(),
+  pageEnd: import_zod3.z.number().int().positive().optional()
+});
+var OperationalPremiumLineSchema = import_zod3.z.object({
+  line: import_zod3.z.string(),
+  amount: import_zod3.z.string(),
+  amountValue: import_zod3.z.number().optional(),
+  sourceNodeIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([]),
+  sourceSpanIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([])
+});
+var OperationalTaxFeeItemSchema = import_zod3.z.object({
+  name: import_zod3.z.string(),
+  amount: import_zod3.z.string(),
+  amountValue: import_zod3.z.number().optional(),
+  type: import_zod3.z.string().optional(),
+  description: import_zod3.z.string().optional(),
+  sourceNodeIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([]),
+  sourceSpanIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([])
+});
 var OperationalPartySchema = import_zod3.z.object({
   role: import_zod3.z.string(),
   name: import_zod3.z.string(),
+  address: OperationalAddressSchema.optional(),
   sourceNodeIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([]),
   sourceSpanIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([])
 });
@@ -1650,8 +1686,13 @@ var PolicyOperationalProfileSchema = import_zod3.z.preprocess(
     expirationDate: SourceBackedValueSchema.optional(),
     retroactiveDate: SourceBackedValueSchema.optional(),
     premium: SourceBackedValueSchema.optional(),
+    operationsDescription: SourceBackedValueSchema.optional(),
     declarationFacts: import_zod3.z.array(OperationalDeclarationFactSchema).default([]),
     coverages: import_zod3.z.array(OperationalCoverageLineSchema).default([]),
+    coverageSchedules: import_zod3.z.array(OperationalCoverageScheduleSchema).optional(),
+    premiumBreakdown: import_zod3.z.array(OperationalPremiumLineSchema).optional(),
+    taxesAndFees: import_zod3.z.array(OperationalTaxFeeItemSchema).optional(),
+    totalCost: SourceBackedValueSchema.optional(),
     parties: import_zod3.z.array(OperationalPartySchema).default([]),
     endorsementSupport: import_zod3.z.array(OperationalEndorsementSupportSchema).default([]),
     sourceNodeIds: import_zod3.z.array(import_zod3.z.string().min(1)).default([]),