@claritylabs/cl-sdk 4.0.1 → 4.1.0

package/dist/index.mjs

@@ -2360,6 +2360,40 @@ var SourceBackedValueSchema = z21.object({
   sourceNodeIds: z21.array(z21.string().min(1)).default([]),
   sourceSpanIds: z21.array(z21.string().min(1)).default([])
 });
+var OperationalAddressSchema = z21.object({
+  street1: z21.string().optional(),
+  street2: z21.string().optional(),
+  city: z21.string().optional(),
+  state: z21.string().optional(),
+  zip: z21.string().optional(),
+  country: z21.string().optional(),
+  formatted: z21.string().optional()
+});
+var OperationalDeclarationFactSchema = z21.object({
+  field: z21.enum([
+    "namedInsured",
+    "mailingAddress",
+    "dba",
+    "entityType",
+    "taxId",
+    "additionalNamedInsured",
+    "policyNumber",
+    "insurer",
+    "broker",
+    "effectiveDate",
+    "expirationDate",
+    "premium",
+    "other"
+  ]),
+  label: z21.string().optional(),
+  value: z21.string(),
+  normalizedValue: z21.string().optional(),
+  valueKind: z21.enum(["string", "number", "date", "money", "address", "list", "unknown"]).default("string"),
+  address: OperationalAddressSchema.optional(),
+  confidence: z21.enum(["low", "medium", "high"]).default("medium"),
+  sourceNodeIds: z21.array(z21.string().min(1)).default([]),
+  sourceSpanIds: z21.array(z21.string().min(1)).default([])
+});
 var OperationalCoverageTermSchema = z21.object({
   kind: z21.enum([
     "each_claim_limit",
@@ -2434,6 +2468,7 @@ var PolicyOperationalProfileSchema = z21.preprocess(
     expirationDate: SourceBackedValueSchema.optional(),
     retroactiveDate: SourceBackedValueSchema.optional(),
     premium: SourceBackedValueSchema.optional(),
+    declarationFacts: z21.array(OperationalDeclarationFactSchema).default([]),
     coverages: z21.array(OperationalCoverageLineSchema).default([]),
     parties: z21.array(OperationalPartySchema).default([]),
     endorsementSupport: z21.array(OperationalEndorsementSupportSchema).default([]),
@@ -3767,6 +3802,9 @@ function cleanValue(value) {
   if (!value) return void 0;
   return normalizeWhitespace4(value.replace(/^[\s:;#-]+|[\s;,.]+$/g, ""));
 }
+function normalizedFactValue(value) {
+  return value.toLowerCase().replace(/&/g, " and ").replace(/[.,#]/g, " ").replace(/\s+/g, " ").trim();
+}
 var OPERATIONAL_COVERAGE_TERM_KINDS = /* @__PURE__ */ new Set([
   "each_claim_limit",
   "each_occurrence_limit",
@@ -3800,6 +3838,63 @@ function mergeOperationalProfile(base, candidate, validNodeIds, validSpanIds) {
       sourceSpanIds: sourceSpanIds2
     };
   };
+  const mergeDeclarationFact = (fact) => {
+    if (!fact || typeof fact !== "object" || Array.isArray(fact)) return void 0;
+    const record = fact;
+    const field = typeof record.field === "string" ? cleanValue(record.field) : void 0;
+    const value = typeof record.value === "string" ? cleanValue(record.value) : void 0;
+    const sourceNodeIds2 = keepIds(record.sourceNodeIds, validNodeIds);
+    const sourceSpanIds2 = keepIds(record.sourceSpanIds, validSpanIds);
+    if (!field || !value || sourceNodeIds2.length === 0 && sourceSpanIds2.length === 0) return void 0;
+    const address = record.address && typeof record.address === "object" && !Array.isArray(record.address) ? Object.fromEntries(
+      Object.entries(record.address).flatMap(([key, item]) => {
+        const text = typeof item === "string" ? cleanValue(item) : void 0;
+        return text ? [[key, text]] : [];
+      })
+    ) : void 0;
+    return {
+      field: [
+        "namedInsured",
+        "mailingAddress",
+        "dba",
+        "entityType",
+        "taxId",
+        "additionalNamedInsured",
+        "policyNumber",
+        "insurer",
+        "broker",
+        "effectiveDate",
+        "expirationDate",
+        "premium",
+        "other"
+      ].includes(field) ? field : "other",
+      label: typeof record.label === "string" ? cleanValue(record.label) : void 0,
+      value,
+      normalizedValue: typeof record.normalizedValue === "string" ? cleanValue(record.normalizedValue) : normalizedFactValue(value),
+      valueKind: [
+        "string",
+        "number",
+        "date",
+        "money",
+        "address",
+        "list",
+        "unknown"
+      ].includes(String(record.valueKind)) ? record.valueKind : "string",
+      address,
+      confidence: record.confidence === "high" || record.confidence === "low" || record.confidence === "medium" ? record.confidence : "medium",
+      sourceNodeIds: sourceNodeIds2,
+      sourceSpanIds: sourceSpanIds2
+    };
+  };
+  const sourceBackedDeclarationFact = (field, value, valueKind = "string") => value ? {
+    field,
+    value: value.value,
+    normalizedValue: value.normalizedValue ?? normalizedFactValue(value.value),
+    valueKind,
+    confidence: value.confidence,
+    sourceNodeIds: value.sourceNodeIds,
+    sourceSpanIds: value.sourceSpanIds
+  } : void 0;
   const policyNumber = mergeValue(base.policyNumber, candidate.policyNumber);
   const namedInsured = mergeValue(base.namedInsured, candidate.namedInsured);
   const insurer = mergeValue(base.insurer, candidate.insurer);
@@ -3808,6 +3903,22 @@ 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 candidateDeclarationFacts = Array.isArray(candidate.declarationFacts) ? candidate.declarationFacts.map(mergeDeclarationFact).filter((fact) => Boolean(fact)) : [];
+  const declarationFacts = [
+    ...base.declarationFacts,
+    sourceBackedDeclarationFact("policyNumber", policyNumber),
+    sourceBackedDeclarationFact("namedInsured", namedInsured),
+    sourceBackedDeclarationFact("insurer", insurer),
+    sourceBackedDeclarationFact("broker", broker),
+    sourceBackedDeclarationFact("effectiveDate", effectiveDate, "date"),
+    sourceBackedDeclarationFact("expirationDate", expirationDate, "date"),
+    sourceBackedDeclarationFact("premium", premium, "money"),
+    ...candidateDeclarationFacts
+  ].filter((fact) => Boolean(fact)).filter(
+    (fact, index, rows) => rows.findIndex(
+      (other) => other.field === fact.field && other.normalizedValue === fact.normalizedValue && other.sourceNodeIds.join(",") === fact.sourceNodeIds.join(",") && other.sourceSpanIds.join(",") === fact.sourceSpanIds.join(",")
+    ) === index
+  );
   const sourceValues = [
     policyNumber,
     namedInsured,
@@ -3912,6 +4023,7 @@ function mergeOperationalProfile(base, candidate, validNodeIds, validSpanIds) {
     ...base.sourceNodeIds,
     ...keepIds(candidate.sourceNodeIds, validNodeIds),
     ...sourceValues.flatMap((value) => value.sourceNodeIds),
+    ...declarationFacts.flatMap((fact) => fact.sourceNodeIds),
     ...coverages.flatMap((coverage) => coverage.sourceNodeIds),
     ...coverages.flatMap((coverage) => coverage.limits.flatMap((term) => term.sourceNodeIds)),
     ...parties.flatMap((party) => party.sourceNodeIds),
@@ -3921,6 +4033,7 @@ function mergeOperationalProfile(base, candidate, validNodeIds, validSpanIds) {
     ...base.sourceSpanIds,
     ...keepIds(candidate.sourceSpanIds, validSpanIds),
     ...sourceValues.flatMap((value) => value.sourceSpanIds),
+    ...declarationFacts.flatMap((fact) => fact.sourceSpanIds),
     ...coverages.flatMap((coverage) => coverage.sourceSpanIds),
     ...coverages.flatMap((coverage) => coverage.limits.flatMap((term) => term.sourceSpanIds)),
     ...parties.flatMap((party) => party.sourceSpanIds),
@@ -3949,6 +4062,7 @@ function mergeOperationalProfile(base, candidate, validNodeIds, validSpanIds) {
     expirationDate,
     retroactiveDate,
     premium,
+    declarationFacts,
     coverages,
     parties,
     endorsementSupport,
@@ -4459,6 +4573,40 @@ var SourceBackedValueForPromptSchema = z23.object({
   sourceNodeIds: z23.array(z23.string()),
   sourceSpanIds: z23.array(z23.string())
 });
+var OperationalAddressForPromptSchema = z23.object({
+  street1: z23.string().optional(),
+  street2: z23.string().optional(),
+  city: z23.string().optional(),
+  state: z23.string().optional(),
+  zip: z23.string().optional(),
+  country: z23.string().optional(),
+  formatted: z23.string().optional()
+});
+var OperationalDeclarationFactForPromptSchema = z23.object({
+  field: z23.enum([
+    "namedInsured",
+    "mailingAddress",
+    "dba",
+    "entityType",
+    "taxId",
+    "additionalNamedInsured",
+    "policyNumber",
+    "insurer",
+    "broker",
+    "effectiveDate",
+    "expirationDate",
+    "premium",
+    "other"
+  ]),
+  label: z23.string().optional(),
+  value: z23.string(),
+  normalizedValue: z23.string().optional(),
+  valueKind: z23.enum(["string", "number", "date", "money", "address", "list", "unknown"]).optional(),
+  address: OperationalAddressForPromptSchema.optional(),
+  confidence: z23.enum(["low", "medium", "high"]).optional(),
+  sourceNodeIds: z23.array(z23.string()),
+  sourceSpanIds: z23.array(z23.string())
+});
 var OperationalProfilePromptSchema = z23.object({
   documentType: z23.enum(["policy", "quote"]).optional(),
   linesOfBusiness: z23.array(z23.string()).optional(),
@@ -4470,6 +4618,7 @@ var OperationalProfilePromptSchema = z23.object({
   expirationDate: SourceBackedValueForPromptSchema.optional(),
   retroactiveDate: SourceBackedValueForPromptSchema.optional(),
   premium: SourceBackedValueForPromptSchema.optional(),
+  declarationFacts: z23.array(OperationalDeclarationFactForPromptSchema).optional(),
   coverages: z23.array(z23.object({
     name: z23.string(),
     coverageCode: z23.string().optional(),
@@ -5501,6 +5650,7 @@ function emptyOperationalProfile() {
   return {
     documentType: "policy",
     linesOfBusiness: ["UN"],
+    declarationFacts: [],
     coverages: [],
     parties: [],
     endorsementSupport: [],
@@ -5518,6 +5668,7 @@ function buildOperationalProfilePrompt(sourceTree, sourceSpans) {
 
 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
+- 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
 
@@ -5526,6 +5677,8 @@ Rules:
 - When citing an evidence entry, copy its sourceSpanId into the returned sourceSpanIds array.
 - 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 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.
 - On declarations pages, treat "Item N" labels as section boundaries. Use Item 6 or equivalent coverage-schedule rows for coverage limits, deductibles, aggregate terms, and retroactive dates; do not merge Item 7 premium, Item 8 ERP, Item 9 producer, or Item 10 forms into Item 6 coverage facts.
@@ -5599,6 +5752,60 @@ function provenanceOf(value) {
     ...value.sourceNodeIds[0] ? { documentNodeId: value.sourceNodeIds[0] } : {}
   };
 }
+function provenanceFromIds(sourceSpanIds, sourceNodeIds) {
+  if (sourceSpanIds.length === 0) return void 0;
+  return {
+    sourceSpanIds,
+    ...sourceNodeIds[0] ? { documentNodeId: sourceNodeIds[0] } : {}
+  };
+}
+function declarationFactsByField(profile, field) {
+  return profile.declarationFacts.filter((fact) => fact.field === field && fact.value.trim());
+}
+function firstDeclarationFact(profile, field) {
+  return declarationFactsByField(profile, field)[0];
+}
+function sourceBackedAddressFromFact(fact) {
+  if (!fact?.address || fact.sourceSpanIds.length === 0) return void 0;
+  const address = fact.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,
+    ...provenanceFromIds(fact.sourceSpanIds, fact.sourceNodeIds)
+  };
+}
+function normalizedEntityType(value) {
+  const normalized = cleanText(value, "").toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  if (normalized === "inc" || normalized === "incorporated" || normalized === "c_corporation" || normalized === "s_corporation") {
+    return "corporation";
+  }
+  if (normalized === "limited_liability_company") return "llc";
+  if (normalized === "non_profit") return "nonprofit";
+  return [
+    "corporation",
+    "llc",
+    "partnership",
+    "sole_proprietor",
+    "joint_venture",
+    "trust",
+    "nonprofit",
+    "municipality",
+    "individual",
+    "married_couple",
+    "other"
+  ].includes(normalized) ? normalized : void 0;
+}
+function declarationFieldName(fact) {
+  if (fact.field === "mailingAddress") return "mailingAddress";
+  if (fact.field === "taxId") return "fein";
+  if (fact.field === "additionalNamedInsured") return "additionalNamedInsured";
+  return fact.field;
+}
 function materializeDocument(params) {
   const profile = params.operationalProfile;
   const policyNumber = valueOf(profile, "policyNumber") ?? "Unknown";
@@ -5610,6 +5817,15 @@ function materializeDocument(params) {
   const insurerProvenance = provenanceOf(profile.insurer);
   const broker = valueOf(profile, "broker");
   const brokerProvenance = provenanceOf(profile.broker);
+  const mailingAddressFact = firstDeclarationFact(profile, "mailingAddress");
+  const insuredAddress = sourceBackedAddressFromFact(mailingAddressFact);
+  const insuredDba = firstDeclarationFact(profile, "dba")?.value;
+  const insuredEntityType = normalizedEntityType(firstDeclarationFact(profile, "entityType")?.value);
+  const insuredFein = firstDeclarationFact(profile, "taxId")?.value;
+  const additionalNamedInsureds = declarationFactsByField(profile, "additionalNamedInsured").flatMap((fact) => {
+    const provenance = provenanceFromIds(fact.sourceSpanIds, fact.sourceNodeIds);
+    return provenance ? [{ name: fact.value, ...provenance }] : [];
+  });
   const coverages = profile.coverages.map((coverage) => ({
     name: coverage.name,
     coverageCode: coverage.coverageCode,
@@ -5660,6 +5876,11 @@ function materializeDocument(params) {
     security: carrier,
     insuredName,
     premium,
+    insuredDba,
+    insuredAddress,
+    insuredEntityType,
+    insuredFein,
+    ...additionalNamedInsureds.length > 0 ? { additionalNamedInsureds } : {},
     ...insurerProvenance ? { insurer: { legalName: carrier, ...insurerProvenance } } : {},
     ...broker && brokerProvenance ? {
       brokerAgency: broker,
@@ -5683,7 +5904,12 @@ function materializeDocument(params) {
         profile.namedInsured ? { field: "namedInsured", value: profile.namedInsured.value, sourceSpanIds: profile.namedInsured.sourceSpanIds } : void 0,
         profile.insurer ? { field: "insurer", value: profile.insurer.value, sourceSpanIds: profile.insurer.sourceSpanIds } : void 0,
         profile.effectiveDate ? { field: "policyPeriodStart", value: profile.effectiveDate.value, sourceSpanIds: profile.effectiveDate.sourceSpanIds } : void 0,
-        profile.expirationDate ? { field: "policyPeriodEnd", value: profile.expirationDate.value, sourceSpanIds: profile.expirationDate.sourceSpanIds } : void 0
+        profile.expirationDate ? { field: "policyPeriodEnd", value: profile.expirationDate.value, sourceSpanIds: profile.expirationDate.sourceSpanIds } : void 0,
+        ...profile.declarationFacts.map((fact) => ({
+          field: declarationFieldName(fact),
+          value: fact.value,
+          sourceSpanIds: fact.sourceSpanIds
+        }))
       ].filter(Boolean)
     },
     supplementaryFacts: profile.endorsementSupport.map((item) => ({
@@ -13012,8 +13238,10 @@ export {
   MemorySourceStore,
   MissingInfoQuestionSchema,
   NamedInsuredSchema,
+  OperationalAddressSchema,
   OperationalCoverageLineSchema,
   OperationalCoverageTermSchema,
+  OperationalDeclarationFactSchema,
   OperationalEndorsementSupportSchema,
   OperationalPartySchema,
   PERSONAL_AUTO_USAGES,