@claritylabs/cl-sdk 4.2.0 → 4.3.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { L as LogFn, M as ModelTaskKind, a as ModelBudgetResolution, b as ModelCallTrace, G as GenerateObject, T as TokenUsage, O as OperationalCoverageLine, S as SourceSpanLocation, c as SourceSpan, D as DocumentSourceNode, d as SourceKind, e as SourceSpanUnit, f as SourceSpanTableLocation, g as SourceChunk, h as SourceSpanBBox, U as UnifiedQualityReport, B as BaseQualityIssue, Q as QualityGateStatus, P as PdfInput, I as InsuranceDocument, i as DocumentChunk, j as PolicyOperationalProfile, k as PerformanceReport, l as QualityGateMode, m as ModelCapabilities, n as ModelBudgetConstraint, A as AgentContext, o as GenerateText, p as DocumentStore, q as MemoryStore, r as Platform } 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, ai as AuxiliaryFact, aj as AuxiliaryFactSchema, ak as BackfillProvider, al as BuildApplicationPacketInput, am as BuildApplicationPacketResult, an as ChunkFilter, ao as CommunicationIntent, ap as CommunicationIntentSchema, aq as ContextProposalResult, ar as ConversationTurn, as as ConvertPdfToImagesFn, at as CoveredReason, au as CoveredReasonSchema, av as CreateApplicationRunInput, aw as Definition, ax as DefinitionSchema, ay as DocumentAgentGuidance, az as DocumentAgentGuidanceSchema, aA as DocumentFilters, aB as DocumentMetadata, aC as DocumentMetadataSchema, aD as DocumentNode, aE as DocumentNodeSchema, aF as DocumentPageMapEntry, aG as DocumentPageMapEntrySchema, aH as DocumentSourceNodeKind, aI as DocumentSourceNodeKindSchema, aJ as DocumentSourceNodeSchema, aK as DocumentTableOfContentsEntry, aL as DocumentTableOfContentsEntrySchema, aM as EmbedText, aN as FieldExtractionResult, aO as FieldExtractionResultSchema, aP as FieldType, aQ as FieldTypeSchema, aR as FlatPdfPlacement, aS as FlatPdfPlacementSchema, aT as InsuranceDocumentSchema, aU as LookupFill, aV as LookupFillResult, aW as LookupFillResultSchema, aX as LookupFillSchema, aY as LookupRequest, aZ as LookupRequestSchema, a_ as ModelCallReport, a$ as OperationalAddress, b0 as OperationalAddressSchema, b1 as OperationalCoverageLineSchema, b2 as OperationalCoverageTerm, b3 as OperationalCoverageTermSchema, b4 as OperationalDeclarationFact, b5 as OperationalDeclarationFactSchema, b6 as OperationalEndorsementSupport, b7 as OperationalEndorsementSupportSchema, b8 as OperationalParty, b9 as OperationalPartySchema, ba as PLATFORM_CONFIGS, bb as ParsedAnswer, bc as ParsedAnswerSchema, bd as PlatformConfig, be as PlatformSchema, bf as PolicyDocument, bg as PolicyDocumentSchema, bh as PolicyOperationalProfileSchema, bi as PremiumLine, bj as PremiumLineSchema, bk as PriorAnswer, bl as ProcessApplicationInput, bm as ProcessApplicationResult, bn as ProcessReplyInput, bo as ProcessReplyResult, bp as QuestionBatchResult, bq as QuestionBatchResultSchema, br as QuoteDocument, bs as QuoteDocumentSchema, bt as ReplyIntent, bu as ReplyIntentSchema, bv as ResolveModelBudgetParams, bw as Section, bx as SectionSchema, by as SourceBackedValue, bz as SourceBackedValueSchema, bA as SourceChunkSchema, bB as SourceKindSchema, bC as SourceSpanBBoxSchema, bD as SourceSpanKind, bE as SourceSpanKindSchema, bF as SourceSpanLocationSchema, bG as SourceSpanRef, bH as SourceSpanRefSchema, bI as SourceSpanSchema, bJ as SourceSpanTableLocationSchema, bK as SourceSpanUnitSchema, bL as Subjectivity, bM as SubjectivitySchema, bN as Subsection, bO as SubsectionSchema, bP as UnderwritingCondition, bQ as UnderwritingConditionSchema, 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, c1 as resolveModelBudget, c2 as validateApplicationPacket } from './index-C9XfOdmx.js';
+import { L as LogFn, M as ModelTaskKind, a as ModelBudgetResolution, b as ModelCallTrace, G as GenerateObject, T as TokenUsage, O as OperationalCoverageLine, S as SourceSpanLocation, c as SourceSpan, D as DocumentSourceNode, d as SourceKind, e as SourceSpanUnit, f as SourceSpanTableLocation, g as SourceChunk, h as SourceSpanBBox, U as UnifiedQualityReport, B as BaseQualityIssue, Q as QualityGateStatus, P as PdfInput, I as InsuranceDocument, i as DocumentChunk, j as PolicyOperationalProfile, k as PerformanceReport, l as QualityGateMode, m as ModelCapabilities, n as ModelBudgetConstraint, A as AgentContext, o as GenerateText, p as DocumentStore, q as MemoryStore, r as Platform } from './index-DhA-5jZy.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, ai as AuxiliaryFact, aj as AuxiliaryFactSchema, ak as BackfillProvider, al as BuildApplicationPacketInput, am as BuildApplicationPacketResult, an as ChunkFilter, ao as CommunicationIntent, ap as CommunicationIntentSchema, aq as ContextProposalResult, ar as ConversationTurn, as as ConvertPdfToImagesFn, at as CoveredReason, au as CoveredReasonSchema, av as CreateApplicationRunInput, aw as Definition, ax as DefinitionSchema, ay as DocumentAgentGuidance, az as DocumentAgentGuidanceSchema, aA as DocumentFilters, aB as DocumentMetadata, aC as DocumentMetadataSchema, aD as DocumentNode, aE as DocumentNodeSchema, aF as DocumentPageMapEntry, aG as DocumentPageMapEntrySchema, aH as DocumentSourceNodeKind, aI as DocumentSourceNodeKindSchema, aJ as DocumentSourceNodeSchema, aK as DocumentTableOfContentsEntry, aL as DocumentTableOfContentsEntrySchema, aM as EmbedText, aN as FieldExtractionResult, aO as FieldExtractionResultSchema, aP as FieldType, aQ as FieldTypeSchema, aR as FlatPdfPlacement, aS as FlatPdfPlacementSchema, aT as InsuranceDocumentSchema, aU as LookupFill, aV as LookupFillResult, aW as LookupFillResultSchema, aX as LookupFillSchema, aY as LookupRequest, aZ as LookupRequestSchema, a_ as ModelCallReport, a$ as OperationalAddress, b0 as OperationalAddressSchema, b1 as OperationalCoverageLineSchema, b2 as OperationalCoverageTerm, b3 as OperationalCoverageTermSchema, b4 as OperationalDeclarationFact, b5 as OperationalDeclarationFactSchema, b6 as OperationalEndorsementSupport, b7 as OperationalEndorsementSupportSchema, b8 as OperationalParty, b9 as OperationalPartySchema, ba as PLATFORM_CONFIGS, bb as ParsedAnswer, bc as ParsedAnswerSchema, bd as PlatformConfig, be as PlatformSchema, bf as PolicyDocument, bg as PolicyDocumentSchema, bh as PolicyOperationalProfileSchema, bi as PremiumLine, bj as PremiumLineSchema, bk as PriorAnswer, bl as ProcessApplicationInput, bm as ProcessApplicationResult, bn as ProcessReplyInput, bo as ProcessReplyResult, bp as QuestionBatchResult, bq as QuestionBatchResultSchema, br as QuoteDocument, bs as QuoteDocumentSchema, bt as ReplyIntent, bu as ReplyIntentSchema, bv as ResolveModelBudgetParams, bw as Section, bx as SectionSchema, by as SourceBackedValue, bz as SourceBackedValueSchema, bA as SourceChunkSchema, bB as SourceKindSchema, bC as SourceSpanBBoxSchema, bD as SourceSpanKind, bE as SourceSpanKindSchema, bF as SourceSpanLocationSchema, bG as SourceSpanRef, bH as SourceSpanRefSchema, bI as SourceSpanSchema, bJ as SourceSpanTableLocationSchema, bK as SourceSpanUnitSchema, bL as Subjectivity, bM as SubjectivitySchema, bN as Subsection, bO as SubsectionSchema, bP as UnderwritingCondition, bQ as UnderwritingConditionSchema, 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, c1 as resolveModelBudget, c2 as validateApplicationPacket } from './index-DhA-5jZy.js';
 import * as zod from 'zod';
 import { ZodTypeAny, z, ZodSchema } from 'zod';
 import { PDFDocument } from 'pdf-lib';
@@ -1080,6 +1080,28 @@ declare const InsurerInfoSchema: z.ZodObject<{
     amBestNumber: z.ZodOptional<z.ZodString>;
     admittedStatus: z.ZodOptional<z.ZodEnum<["admitted", "non_admitted", "surplus_lines"]>>;
     stateOfDomicile: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodObject<{
+        street1: z.ZodString;
+        street2: z.ZodOptional<z.ZodString>;
+        city: z.ZodString;
+        state: z.ZodString;
+        zip: z.ZodString;
+        country: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        street1: string;
+        city: string;
+        state: string;
+        zip: string;
+        street2?: string | undefined;
+        country?: string | undefined;
+    }, {
+        street1: string;
+        city: string;
+        state: string;
+        zip: string;
+        street2?: string | undefined;
+        country?: string | undefined;
+    }>>;
 } & {
     sourceSpanIds: z.ZodArray<z.ZodString, "many">;
     documentNodeId: z.ZodOptional<z.ZodString>;
@@ -1093,6 +1115,14 @@ declare const InsurerInfoSchema: z.ZodObject<{
     sourceTextHash?: string | undefined;
     pageStart?: number | undefined;
     pageEnd?: number | undefined;
+    address?: {
+        street1: string;
+        city: string;
+        state: string;
+        zip: string;
+        street2?: string | undefined;
+        country?: string | undefined;
+    } | undefined;
     naicNumber?: string | undefined;
     amBestRating?: string | undefined;
     amBestNumber?: string | undefined;
@@ -1105,6 +1135,14 @@ declare const InsurerInfoSchema: z.ZodObject<{
     sourceTextHash?: string | undefined;
     pageStart?: number | undefined;
     pageEnd?: number | undefined;
+    address?: {
+        street1: string;
+        city: string;
+        state: string;
+        zip: string;
+        street2?: string | undefined;
+        country?: string | undefined;
+    } | undefined;
     naicNumber?: string | undefined;
     amBestRating?: string | undefined;
     amBestNumber?: string | undefined;

package/dist/index.js

@@ -1451,7 +1451,8 @@ var InsurerInfoSchema = import_zod9.z.object({
   amBestRating: import_zod9.z.string().optional(),
   amBestNumber: import_zod9.z.string().optional(),
   admittedStatus: AdmittedStatusSchema.optional(),
-  stateOfDomicile: import_zod9.z.string().optional()
+  stateOfDomicile: import_zod9.z.string().optional(),
+  address: AddressSchema.optional()
 }).merge(SourceProvenanceSchema);
 var ProducerInfoSchema = import_zod9.z.object({
   agencyName: import_zod9.z.string(),
@@ -2823,6 +2824,7 @@ var OperationalCoverageLineSchema = import_zod21.z.object({
 var OperationalPartySchema = import_zod21.z.object({
   role: import_zod21.z.string(),
   name: import_zod21.z.string(),
+  address: OperationalAddressSchema.optional(),
   sourceNodeIds: import_zod21.z.array(import_zod21.z.string().min(1)).default([]),
   sourceSpanIds: import_zod21.z.array(import_zod21.z.string().min(1)).default([])
 });
@@ -2860,6 +2862,7 @@ var PolicyOperationalProfileSchema = import_zod21.z.preprocess(
     expirationDate: SourceBackedValueSchema.optional(),
     retroactiveDate: SourceBackedValueSchema.optional(),
     premium: SourceBackedValueSchema.optional(),
+    operationsDescription: SourceBackedValueSchema.optional(),
     declarationFacts: import_zod21.z.array(OperationalDeclarationFactSchema).default([]),
     coverages: import_zod21.z.array(OperationalCoverageLineSchema).default([]),
     parties: import_zod21.z.array(OperationalPartySchema).default([]),
@@ -4238,6 +4241,34 @@ function cleanCoverageLineOfBusiness(value) {
 function normalizedFactValue(value) {
   return value.toLowerCase().replace(/&/g, " and ").replace(/[.,#]/g, " ").replace(/\s+/g, " ").trim();
 }
+var OPERATIONAL_ADDRESS_FIELDS = [
+  "street1",
+  "street2",
+  "city",
+  "state",
+  "zip",
+  "country",
+  "formatted"
+];
+function normalizeOperationalAddress(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const record = value;
+  const address = Object.fromEntries(
+    OPERATIONAL_ADDRESS_FIELDS.flatMap((field) => {
+      const cleaned = typeof record[field] === "string" ? cleanValue(record[field]) : void 0;
+      return cleaned ? [[field, cleaned]] : [];
+    })
+  );
+  return Object.keys(address).length > 0 ? address : void 0;
+}
+function normalizeOperationalPartyRole(value) {
+  const normalized = value.toLowerCase().replace(/[\s-]+/g, "_");
+  if (normalized === "namedinsured" || normalized === "insured") return "named_insured";
+  if (normalized === "managing_general_agent") return "mga";
+  if (normalized === "managing_general_underwriter") return "mga";
+  if (normalized === "third_party_administrator") return "administrator";
+  return normalized;
+}
 var OPERATIONAL_COVERAGE_TERM_KINDS = /* @__PURE__ */ new Set([
   "each_claim_limit",
   "each_occurrence_limit",
@@ -4336,6 +4367,7 @@ function mergeOperationalProfile(base, candidate, validNodeIds, validSpanIds) {
   const expirationDate = mergeValue(base.expirationDate, candidate.expirationDate);
   const retroactiveDate = mergeValue(base.retroactiveDate, candidate.retroactiveDate);
   const premium = mergeValue(base.premium, candidate.premium);
+  const operationsDescription = mergeValue(base.operationsDescription, candidate.operationsDescription);
   const candidateDeclarationFacts = Array.isArray(candidate.declarationFacts) ? candidate.declarationFacts.map(mergeDeclarationFact).filter((fact) => Boolean(fact)) : [];
   const declarationFacts = [
     ...base.declarationFacts,
@@ -4360,7 +4392,8 @@ function mergeOperationalProfile(base, candidate, validNodeIds, validSpanIds) {
     effectiveDate,
     expirationDate,
     retroactiveDate,
-    premium
+    premium,
+    operationsDescription
   ].filter((value) => Boolean(value));
   const coverages = base.coverages.length > 0 ? base.coverages : Array.isArray(candidate.coverages) ? candidate.coverages.map((coverage) => {
     const record = coverage;
@@ -4419,14 +4452,21 @@ function mergeOperationalProfile(base, candidate, validNodeIds, validSpanIds) {
     const record = party;
     const role = typeof record.role === "string" ? cleanValue(record.role) : void 0;
     const name = typeof record.name === "string" ? cleanValue(record.name) : void 0;
+    const address = normalizeOperationalAddress(record.address);
     const sourceNodeIds2 = keepIds(record.sourceNodeIds, validNodeIds);
     const sourceSpanIds2 = keepIds(record.sourceSpanIds, validSpanIds);
     if (!role || !name || sourceNodeIds2.length === 0 && sourceSpanIds2.length === 0) return [];
-    return [{ role, name, sourceNodeIds: sourceNodeIds2, sourceSpanIds: sourceSpanIds2 }];
+    return [{
+      role: normalizeOperationalPartyRole(role),
+      name,
+      address,
+      sourceNodeIds: sourceNodeIds2,
+      sourceSpanIds: sourceSpanIds2
+    }];
   }) : [];
   const parties = [
-    ...base.parties,
     ...candidateParties,
+    ...base.parties,
     sourceBackedParty("named_insured", namedInsured),
     sourceBackedParty("insurer", insurer),
     sourceBackedParty("broker", broker)
@@ -4500,6 +4540,7 @@ function mergeOperationalProfile(base, candidate, validNodeIds, validSpanIds) {
     expirationDate,
     retroactiveDate,
     premium,
+    operationsDescription,
     declarationFacts,
     coverages: annotatedCoverages,
     parties,
@@ -4973,7 +5014,8 @@ function sourceIdsFromOperationalProfile(profile) {
     profile.effectiveDate,
     profile.expirationDate,
     profile.retroactiveDate,
-    profile.premium
+    profile.premium,
+    profile.operationsDescription
   ].filter(Boolean);
   return {
     sourceNodeIds: uniqueStrings([
@@ -5057,6 +5099,21 @@ var OperationalDeclarationFactForPromptSchema = import_zod23.z.object({
   sourceNodeIds: import_zod23.z.array(import_zod23.z.string()),
   sourceSpanIds: import_zod23.z.array(import_zod23.z.string())
 });
+var OperationalPartyForPromptSchema = import_zod23.z.object({
+  role: import_zod23.z.enum([
+    "named_insured",
+    "producer",
+    "broker",
+    "insurer",
+    "carrier",
+    "mga",
+    "administrator"
+  ]),
+  name: import_zod23.z.string(),
+  address: OperationalAddressForPromptSchema.optional(),
+  sourceNodeIds: import_zod23.z.array(import_zod23.z.string()),
+  sourceSpanIds: import_zod23.z.array(import_zod23.z.string())
+});
 var OperationalProfilePromptSchema = import_zod23.z.object({
   documentType: import_zod23.z.enum(["policy", "quote"]).optional(),
   linesOfBusiness: import_zod23.z.array(import_zod23.z.string()).optional(),
@@ -5068,7 +5125,9 @@ var OperationalProfilePromptSchema = import_zod23.z.object({
   expirationDate: SourceBackedValueForPromptSchema.optional(),
   retroactiveDate: SourceBackedValueForPromptSchema.optional(),
   premium: SourceBackedValueForPromptSchema.optional(),
+  operationsDescription: SourceBackedValueForPromptSchema.optional(),
   declarationFacts: import_zod23.z.array(OperationalDeclarationFactForPromptSchema).optional(),
+  parties: import_zod23.z.array(OperationalPartyForPromptSchema).optional(),
   coverages: import_zod23.z.array(import_zod23.z.object({
     name: import_zod23.z.string(),
     lineOfBusiness: import_zod23.z.string().optional(),
@@ -5980,6 +6039,9 @@ function operationalEvidenceScore(span) {
   if (span.metadata?.elementType === "title") score += 4;
   if (span.sourceUnit === "page") score -= 3;
   if (/\b(policy\s*(number|period|term)|effective date|expiration date|expiry date|named insured|insurer|carrier|security|broker|producer|premium|total due)\b/i.test(text)) score += 12;
+  if (/\b(mailing address|business address|address|managing general (?:agent|underwriter)|mga|administrator|description of operations|operations description|nature of business|business description)\b/i.test(text)) score += 12;
+  if (/\b\d{1,6}\s+[A-Z0-9][^\n,]{1,80}\b(?:street|st|avenue|ave|road|rd|boulevard|blvd|drive|dr|lane|ln|way|court|ct|highway|hwy)\b/i.test(text)) score += 10;
+  if (/\b[A-Za-z][A-Za-z .'-]+,\s*[A-Z]{2}\s+\d{5}(?:-\d{4})?\b/.test(text)) score += 10;
   if (/\b(coverage part|limit(?:s)? of liability|deductible|retention|retroactive date|aggregate|sublimit|sub-limit|each claim|each loss|each occurrence|coinsurance)\b/i.test(text)) score += 14;
   if (/\bendorsement\s+(?:no\.?|number|#)?\s*[A-Z0-9]|forms? and endorsements?|attached at inception|schedule\b/i.test(text)) score += 8;
   if (/\bitem\s+\d+\.?\s*(?:named insured|policy number|policy period|renewal|form of business|coverage parts?|premium|extended reporting|producer|forms? and endorsements?)\b/i.test(text)) score += 10;
@@ -5999,10 +6061,13 @@ function isOperationalEvidenceAnchor(span) {
   const text = cleanText([span.text, span.formNumber].filter(Boolean).join(" "), "");
   if (!text) return false;
   if (sourceUnit3 === "page") {
-    return hasSubstantiveDeclarationsScheduleText(text) || /\b(declarations?|named insured|policy number|policy period|effective date|expiration date|premium|total due|producer)\b/i.test(text);
+    return hasSubstantiveDeclarationsScheduleText(text) || /\b(declarations?|named insured|policy number|policy period|effective date|expiration date|premium|total due|producer|mailing address|mga|administrator|description of operations|nature of business|business description)\b/i.test(text);
   }
   if (/\bitem\s+\d+\.?\s*(?:named insured|policy number|policy period|renewal|form of business|coverage parts?|premium|extended reporting|producer|forms? and endorsements?)\b/i.test(text)) return true;
   if (/\b(policy\s*(number|period)|effective date|expiration date|expiry date|named insured|insurer|carrier|broker|producer|premium|total due)\b/i.test(text)) return true;
+  if (/\b(mailing address|business address|address|managing general (?:agent|underwriter)|mga|administrator|description of operations|operations description|nature of business|business description)\b/i.test(text)) return true;
+  if (/\b\d{1,6}\s+[A-Z0-9][^\n,]{1,80}\b(?:street|st|avenue|ave|road|rd|boulevard|blvd|drive|dr|lane|ln|way|court|ct|highway|hwy)\b/i.test(text)) return true;
+  if (/\b[A-Za-z][A-Za-z .'-]+,\s*[A-Z]{2}\s+\d{5}(?:-\d{4})?\b/.test(text)) return true;
   if (/\b(coverage part|forms? and endorsements?|attached at inception|endorsement\s+(?:no\.?|number|#)?\s*[A-Z0-9])\b/i.test(text)) return true;
   if (/\$[\d,.]+|[0-9]{1,2}\/[0-9]{1,2}\/[0-9]{2,4}|[0-9]{1,2}\s+[A-Za-z]{3,9}\s+[0-9]{4}/.test(text)) return true;
   return false;
@@ -6020,6 +6085,7 @@ function operationalEvidencePages(sourceSpans) {
     if (/\bcoverage parts?,?\s+limits? of liability,?\s+deductibles?,?\s+and retroactive dates\b/i.test(text)) score += 24;
     if (/\b(policy\s*(number|period|term)|effective date|expiration date|expiry date|named insured|insurer|carrier|security)\b/i.test(text)) score += 12;
     if (/\b(premium|total due|tax|fee|producer|broker)\b/i.test(text)) score += 10;
+    if (/\b(mailing address|business address|managing general (?:agent|underwriter)|mga|administrator|description of operations|operations description|nature of business|business description)\b/i.test(text)) score += 16;
     if (/\b(endorsement\s+(?:no\.?|number|#)?\s*[A-Z0-9]|attached at inception|forms? and endorsements?)\b/i.test(text)) score += 8;
     if (/\b(definitions?|exclusions?|conditions?|duties in the event|action against|cancellation by)\b/i.test(text)) score -= 12;
     if (score > 0) scores.set(page, (scores.get(page) ?? 0) + score);
@@ -6094,7 +6160,7 @@ function operationalProfilePromptNodes(sourceTree) {
       return true;
     }
     const text = [node.title, node.path, node.description, node.textExcerpt].filter(Boolean).join(" ");
-    return /\b(policy\s*(number|period)|named insured|insurer|carrier|broker|producer|premium|coverage|limit|liability|deductible|retention|retroactive|aggregate|sublimit|sub-limit|endorsement)\b/i.test(text);
+    return /\b(policy\s*(number|period)|named insured|insurer|carrier|broker|producer|managing general (?:agent|underwriter)|mga|administrator|mailing address|description of operations|operations description|nature of business|business description|premium|coverage|limit|liability|deductible|retention|retroactive|aggregate|sublimit|sub-limit|endorsement)\b/i.test(text);
   }).slice(0, 420);
 }
 function emptyOperationalProfile() {
@@ -6118,7 +6184,8 @@ function buildOperationalProfilePrompt(sourceTree, sourceSpans) {
   return `Extract a source-backed operational profile for an insurance policy.
 
 Return only high-value operational facts needed for policy lists, Q&A, compliance, and certificate generation:
-- policy number, named insured, insurer/carrier/security, broker/producer, policy period, retroactive date, premium
+- policy number, named insured, insurer/carrier/security, broker/producer, policy period, retroactive date, premium, and the insured's description of operations
+- parties[] rows for named insured, producer/broker, insurer/carrier, and MGA/administrator identities and their mailing addresses
 - source-backed declarationFacts for named-insured identity details: named insured, mailing address, DBA, entity type, tax ID/FEIN, additional named insureds, and other durable declaration-page identity facts
 - coverage units with their own nested limit terms, deductibles/retentions, retroactive dates, premiums, and form references
 - coverage type labels
@@ -6130,6 +6197,9 @@ Rules:
 - If a value is not directly supported, omit it.
 - Prefer declarations, schedules, premium tables, and endorsement schedules over generic policy wording.
 - Put named-insured mailing address in declarationFacts[] with field "mailingAddress", valueKind "address", a user-facing value string, and structured address fields when present. Do not put producer, broker, insurer, mortgagee, loss-payee, or certificate-holder addresses in mailingAddress.
+- Put every source-backed policy party in parties[] using only these canonical roles: "named_insured", "producer", "broker", "insurer", "carrier", "mga", or "administrator". Keep producer/broker, insurer/carrier, and MGA/administrator addresses policy-scoped in parties[]; never represent them as the named-insured mailingAddress declaration fact.
+- When a party's address is present, return its available street1, street2, city, state, zip, country, and formatted parts under parties[].address. Partial addresses are allowed in parties[], but never guess a missing component. The party row must cite the source node or source span that supports both the identity and address.
+- Put the insured's directly stated business or operations description in operationsDescription. Do not synthesize it from coverages, industry inference, website research, or generic policy wording.
 - Put DBA or trade name in declarationFacts[] with field "dba"; entity/legal form in field "entityType"; FEIN/tax ID in field "taxId"; each additional named insured in field "additionalNamedInsured".
 - For effective, expiration, retroactive, and other date fields, return a normalized YYYY-MM-DD value when the source date is unambiguous, including month-name dates such as "20 Feb 2026". Do not emit fragmented date text such as "20 2 2026".
 - For broker/producer, extract the agency or company legal name, not the license role, credential, or type. In a block like "Bayshore Insurance Brokers, LLC" followed by "Surplus Lines Broker - CA License No. ...", broker.value must be "Bayshore Insurance Brokers, LLC"; the surplus-lines role and license number are not the broker name.
@@ -6199,13 +6269,6 @@ function valueOf(profile, key) {
   }
   return String(value.value);
 }
-function provenanceOf(value) {
-  if (!value?.sourceSpanIds.length) return void 0;
-  return {
-    sourceSpanIds: value.sourceSpanIds,
-    ...value.sourceNodeIds[0] ? { documentNodeId: value.sourceNodeIds[0] } : {}
-  };
-}
 function provenanceFromIds(sourceSpanIds, sourceNodeIds) {
   if (sourceSpanIds.length === 0) return void 0;
   return {
@@ -6213,6 +6276,33 @@ function provenanceFromIds(sourceSpanIds, sourceNodeIds) {
     ...sourceNodeIds[0] ? { documentNodeId: sourceNodeIds[0] } : {}
   };
 }
+function combinedProvenance(...values) {
+  const sourceSpanIds = [...new Set(values.flatMap((value) => value?.sourceSpanIds ?? []))];
+  const sourceNodeIds = [...new Set(values.flatMap((value) => value?.sourceNodeIds ?? []))];
+  return provenanceFromIds(sourceSpanIds, sourceNodeIds);
+}
+function firstOperationalParty(profile, roles) {
+  const candidates = roles.flatMap(
+    (role) => profile.parties.filter((candidate) => candidate.role === role && candidate.name.trim())
+  );
+  return candidates.find((candidate) => candidate.address) ?? candidates[0];
+}
+function completeOperationalAddress(address) {
+  if (!address?.street1 || !address.city || !address.state || !address.zip) return void 0;
+  return {
+    street1: address.street1,
+    street2: address.street2,
+    city: address.city,
+    state: address.state,
+    zip: address.zip,
+    country: address.country
+  };
+}
+function sourceBackedAddressFromParty(party) {
+  const address = completeOperationalAddress(party?.address);
+  const provenance = party ? provenanceFromIds(party.sourceSpanIds, party.sourceNodeIds) : void 0;
+  return address && provenance ? { ...address, ...provenance } : void 0;
+}
 function declarationFactsByField(profile, field) {
   return profile.declarationFacts.filter((fact) => fact.field === field && fact.value.trim());
 }
@@ -6263,16 +6353,21 @@ function declarationFieldName(fact) {
 function materializeDocument(params) {
   const profile = params.operationalProfile;
   const policyNumber = valueOf(profile, "policyNumber") ?? "Unknown";
-  const insuredName = valueOf(profile, "namedInsured") ?? "Unknown";
-  const carrier = valueOf(profile, "insurer") ?? "Unknown";
+  const namedInsuredParty = firstOperationalParty(profile, ["named_insured"]);
+  const insurerParty = firstOperationalParty(profile, ["insurer", "carrier"]);
+  const producerParty = firstOperationalParty(profile, ["producer", "broker"]);
+  const insuredName = valueOf(profile, "namedInsured") ?? namedInsuredParty?.name ?? "Unknown";
+  const carrier = valueOf(profile, "insurer") ?? insurerParty?.name ?? "Unknown";
   const effectiveDate = valueOf(profile, "effectiveDate") ?? "Unknown";
   const expirationDate = valueOf(profile, "expirationDate") ?? "Unknown";
   const premium = valueOf(profile, "premium");
-  const insurerProvenance = provenanceOf(profile.insurer);
-  const broker = valueOf(profile, "broker");
-  const brokerProvenance = provenanceOf(profile.broker);
+  const insurerProvenance = combinedProvenance(profile.insurer, insurerParty);
+  const insurerAddress = completeOperationalAddress(insurerParty?.address);
+  const broker = valueOf(profile, "broker") ?? producerParty?.name;
+  const brokerProvenance = combinedProvenance(profile.broker, producerParty);
+  const producerAddress = completeOperationalAddress(producerParty?.address);
   const mailingAddressFact = firstDeclarationFact(profile, "mailingAddress");
-  const insuredAddress = sourceBackedAddressFromFact(mailingAddressFact);
+  const insuredAddress = sourceBackedAddressFromParty(namedInsuredParty) ?? sourceBackedAddressFromFact(mailingAddressFact);
   const insuredDba = firstDeclarationFact(profile, "dba")?.value;
   const insuredEntityType = normalizedEntityType(firstDeclarationFact(profile, "entityType")?.value);
   const insuredFein = firstDeclarationFact(profile, "taxId")?.value;
@@ -6336,10 +6431,20 @@ function materializeDocument(params) {
     insuredEntityType,
     insuredFein,
     ...additionalNamedInsureds.length > 0 ? { additionalNamedInsureds } : {},
-    ...insurerProvenance ? { insurer: { legalName: carrier, ...insurerProvenance } } : {},
+    ...insurerProvenance ? {
+      insurer: {
+        legalName: carrier,
+        ...insurerAddress ? { address: insurerAddress } : {},
+        ...insurerProvenance
+      }
+    } : {},
     ...broker && brokerProvenance ? {
       brokerAgency: broker,
-      producer: { agencyName: broker, ...brokerProvenance }
+      producer: {
+        agencyName: broker,
+        ...producerAddress ? { address: producerAddress } : {},
+        ...brokerProvenance
+      }
     } : {},
     linesOfBusiness: profile.linesOfBusiness,
     formInventory: params.formInventory.filter((form) => typeof form.formNumber === "string" && form.formNumber.trim().length > 0).map((form) => ({