@claritylabs/cl-sdk 0.10.2 → 0.11.0

package/dist/index.mjs

@@ -540,6 +540,7 @@ var CoverageValueTypeSchema = z4.enum([
 var CoverageSchema = z4.object({
   name: z4.string(),
   limit: z4.string(),
+  limitType: LimitTypeSchema.optional(),
   limitValueType: CoverageValueTypeSchema.optional(),
   deductible: z4.string().optional(),
   deductibleValueType: CoverageValueTypeSchema.optional(),
@@ -1574,6 +1575,358 @@ async function runExtractor(params) {
   };
 }
 
+// src/extraction/promote.ts
+function getDeclarationFields(doc) {
+  const decl = doc.declarations;
+  return Array.isArray(decl?.fields) ? decl.fields : [];
+}
+function fieldMatches(fieldName, patterns) {
+  const lower = fieldName.toLowerCase().replace(/[\s_-]/g, "");
+  return patterns.some((p) => lower === p.toLowerCase().replace(/[\s_-]/g, ""));
+}
+function findFieldValue(fields, patterns) {
+  const match = fields.find((f) => fieldMatches(f.field, patterns));
+  return match?.value;
+}
+function promoteCarrierFields(doc) {
+  const raw = doc;
+  if (!raw.carrierNaicNumber && raw.naicNumber) {
+    raw.carrierNaicNumber = raw.naicNumber;
+  }
+  if (!raw.carrierAmBestRating && raw.amBestRating) {
+    raw.carrierAmBestRating = raw.amBestRating;
+  }
+  if (!raw.carrierAdmittedStatus && raw.admittedStatus) {
+    raw.carrierAdmittedStatus = raw.admittedStatus;
+  }
+  delete raw.naicNumber;
+  delete raw.amBestRating;
+  delete raw.admittedStatus;
+  if (!raw.insurer && raw.carrierLegalName) {
+    raw.insurer = {
+      legalName: raw.carrierLegalName,
+      ...raw.carrierNaicNumber ? { naicNumber: raw.carrierNaicNumber } : {},
+      ...raw.carrierAmBestRating ? { amBestRating: raw.carrierAmBestRating } : {},
+      ...raw.carrierAdmittedStatus ? { admittedStatus: raw.carrierAdmittedStatus } : {}
+    };
+  }
+}
+var BROKER_NAME_PATTERNS = [
+  "brokerName",
+  "broker",
+  "agentName",
+  "agent",
+  "producerName",
+  "producerAgency",
+  "agencyName",
+  "brokerAgency"
+];
+var BROKER_CONTACT_PATTERNS = [
+  "brokerContactName",
+  "brokerContact",
+  "agentContactName",
+  "producerContactName",
+  "producerContact"
+];
+var BROKER_LICENSE_PATTERNS = [
+  "brokerLicenseNumber",
+  "brokerNumber",
+  "agentLicenseNumber",
+  "producerLicenseNumber",
+  "producerNumber",
+  "agentNumber"
+];
+var BROKER_PHONE_PATTERNS = ["brokerPhone", "agentPhone", "producerPhone"];
+var BROKER_EMAIL_PATTERNS = ["brokerEmail", "agentEmail", "producerEmail"];
+var BROKER_ADDRESS_PATTERNS = ["brokerAddress", "agentAddress", "producerAddress"];
+function promoteBroker(doc) {
+  const raw = doc;
+  const fields = getDeclarationFields(doc);
+  const brokerAgency = raw.brokerAgency || findFieldValue(fields, BROKER_NAME_PATTERNS);
+  const brokerContact = raw.brokerContactName || findFieldValue(fields, BROKER_CONTACT_PATTERNS);
+  const brokerLicense = raw.brokerLicenseNumber || findFieldValue(fields, BROKER_LICENSE_PATTERNS);
+  const brokerPhone = findFieldValue(fields, BROKER_PHONE_PATTERNS);
+  const brokerEmail = findFieldValue(fields, BROKER_EMAIL_PATTERNS);
+  const brokerAddress = findFieldValue(fields, BROKER_ADDRESS_PATTERNS);
+  if (brokerAgency) raw.brokerAgency = brokerAgency;
+  if (brokerContact) raw.brokerContactName = brokerContact;
+  if (brokerLicense) raw.brokerLicenseNumber = brokerLicense;
+  if (!raw.producer && brokerAgency) {
+    raw.producer = {
+      agencyName: brokerAgency,
+      ...brokerContact ? { contactName: brokerContact } : {},
+      ...brokerLicense ? { licenseNumber: brokerLicense } : {},
+      ...brokerPhone ? { phone: brokerPhone } : {},
+      ...brokerEmail ? { email: brokerEmail } : {},
+      ...brokerAddress ? { address: { street1: brokerAddress } } : {}
+    };
+  }
+}
+var LOSS_PAYEE_NAME_PATTERNS = [
+  "lossPayeeName",
+  "lossPayee",
+  "lossPayeeHolder"
+];
+var LOSS_PAYEE_ADDRESS_PATTERNS = ["lossPayeeAddress"];
+var MORTGAGE_HOLDER_NAME_PATTERNS = [
+  "mortgagee",
+  "mortgageHolder",
+  "mortgageHolderName",
+  "mortgageeName",
+  "lienholder",
+  "lienholderName"
+];
+var MORTGAGE_HOLDER_ADDRESS_PATTERNS = [
+  "mortgageeAddress",
+  "mortgageHolderAddress",
+  "lienholderAddress"
+];
+function promoteLossPayees(doc) {
+  const raw = doc;
+  const fields = getDeclarationFields(doc);
+  if (!raw.lossPayees || Array.isArray(raw.lossPayees) && raw.lossPayees.length === 0) {
+    const name = findFieldValue(fields, LOSS_PAYEE_NAME_PATTERNS);
+    if (name) {
+      const address = findFieldValue(fields, LOSS_PAYEE_ADDRESS_PATTERNS);
+      raw.lossPayees = [{
+        name,
+        role: "loss_payee",
+        ...address ? { address: { street1: address } } : {}
+      }];
+    }
+  }
+  if (!raw.mortgageHolders || Array.isArray(raw.mortgageHolders) && raw.mortgageHolders.length === 0) {
+    const name = findFieldValue(fields, MORTGAGE_HOLDER_NAME_PATTERNS);
+    if (name) {
+      const address = findFieldValue(fields, MORTGAGE_HOLDER_ADDRESS_PATTERNS);
+      raw.mortgageHolders = [{
+        name,
+        role: "mortgage_holder",
+        ...address ? { address: { street1: address } } : {}
+      }];
+    }
+  }
+}
+function promoteLocations(doc) {
+  const raw = doc;
+  if (Array.isArray(raw.locations) && raw.locations.length > 0) return;
+  const fields = getDeclarationFields(doc);
+  if (fields.length === 0) return;
+  const locationGroups = /* @__PURE__ */ new Map();
+  for (const f of fields) {
+    const lower = f.field.toLowerCase().replace(/[\s_-]/g, "");
+    if (lower.includes("locationnumber") || lower.includes("locnumber") || lower.includes("locno")) {
+      const key = f.value;
+      if (!locationGroups.has(key)) locationGroups.set(key, /* @__PURE__ */ new Map());
+      locationGroups.get(key).set("number", f.value);
+      continue;
+    }
+    if (lower.includes("buildingnumber") || lower.includes("bldgnumber") || lower.includes("bldgno")) {
+      const lastKey2 = [...locationGroups.keys()].pop();
+      if (lastKey2) locationGroups.get(lastKey2).set("buildingNumber", f.value);
+      continue;
+    }
+    const section = (f.section ?? "").toLowerCase();
+    const isLocationField = section.includes("location") || section.includes("building") || section.includes("premises") || section.includes("schedule of locations");
+    if (!isLocationField) continue;
+    if (locationGroups.size === 0) {
+      locationGroups.set("1", /* @__PURE__ */ new Map([["number", "1"]]));
+    }
+    const lastKey = [...locationGroups.keys()].pop();
+    const group = locationGroups.get(lastKey);
+    if (lower.includes("construction") || lower.includes("constructiontype")) {
+      group.set("constructionType", f.value);
+    } else if (lower.includes("occupancy") || lower.includes("occupancytype")) {
+      group.set("occupancy", f.value);
+    } else if (lower.includes("yearbuilt")) {
+      group.set("yearBuilt", f.value);
+    } else if (lower.includes("squarefootage") || lower.includes("sqft") || lower.includes("area")) {
+      group.set("squareFootage", f.value);
+    } else if (lower.includes("protectionclass") || lower.includes("fireprotection")) {
+      group.set("protectionClass", f.value);
+    } else if (lower.includes("sprinkler")) {
+      group.set("sprinklered", f.value);
+    } else if (lower.includes("buildingvalue") || lower.includes("buildingamt") || lower.includes("buildingcoverage")) {
+      group.set("buildingValue", f.value);
+    } else if (lower.includes("contentsvalue") || lower.includes("contentsamt") || lower.includes("contentscoverage")) {
+      group.set("contentsValue", f.value);
+    } else if (lower.includes("businessincome") || lower.includes("bivalue") || lower.includes("businessincomevalue")) {
+      group.set("businessIncomeValue", f.value);
+    } else if (lower.includes("description") || lower.includes("buildingdescription") || lower.includes("locationdescription")) {
+      group.set("description", f.value);
+    } else if (lower.includes("address") || lower.includes("industryaddress") || lower.includes("locationaddress") || lower.includes("premisesaddress")) {
+      group.set("address", f.value);
+    } else if (lower.includes("alarm") || lower.includes("alarmtype")) {
+      group.set("alarmType", f.value);
+    }
+  }
+  if (locationGroups.size === 0) return;
+  const locations = [];
+  for (const [, group] of locationGroups) {
+    const num = parseInt(group.get("number") ?? "0", 10) || locations.length + 1;
+    const addressStr = group.get("address");
+    locations.push({
+      number: num,
+      address: addressStr ? { street1: addressStr } : { street1: "See declarations" },
+      ...group.get("description") ? { description: group.get("description") } : {},
+      ...group.get("constructionType") ? { constructionType: group.get("constructionType") } : {},
+      ...group.get("occupancy") ? { occupancy: group.get("occupancy") } : {},
+      ...group.get("yearBuilt") ? { yearBuilt: parseInt(group.get("yearBuilt"), 10) || void 0 } : {},
+      ...group.get("squareFootage") ? { squareFootage: parseInt(group.get("squareFootage").replace(/[^0-9]/g, ""), 10) || void 0 } : {},
+      ...group.get("protectionClass") ? { protectionClass: group.get("protectionClass") } : {},
+      ...group.get("sprinklered") ? { sprinklered: /yes|true/i.test(group.get("sprinklered")) } : {},
+      ...group.get("buildingValue") ? { buildingValue: group.get("buildingValue") } : {},
+      ...group.get("contentsValue") ? { contentsValue: group.get("contentsValue") } : {},
+      ...group.get("businessIncomeValue") ? { businessIncomeValue: group.get("businessIncomeValue") } : {},
+      ...group.get("alarmType") ? { alarmType: group.get("alarmType") } : {}
+    });
+  }
+  if (locations.length > 0) {
+    raw.locations = locations;
+  }
+}
+function normalizeName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+var LIMIT_COVERAGE_MAP = [
+  // GL standard
+  [["eachoccurrence", "peroccurrence", "occurrencecombined"], "perOccurrence"],
+  [["generalaggregate"], "generalAggregate"],
+  [["productscompletedoperationsaggregate", "productscompletedopsaggregate", "prodcompopsagg"], "productsCompletedOpsAggregate"],
+  [["personaladvertisinginjury", "personaladvinjury", "pai"], "personalAdvertisingInjury"],
+  [["firedamage", "firedamagelegalliability", "damagetorentedpremises", "damagetopremisesrentedtoyou"], "fireDamage"],
+  [["medicalexpense", "medexp", "medicalexpenseanypersonanyperson", "medicalexpenseanyone"], "medicalExpense"],
+  // Auto
+  [["combinedsingle", "combinedsinglelimit", "csl"], "combinedSingleLimit"],
+  [["bodilyinjuryperperson", "biperperson"], "bodilyInjuryPerPerson"],
+  [["bodilyinjuryperaccident", "biperaccident"], "bodilyInjuryPerAccident"],
+  [["propertydamage", "pdperaccident"], "propertyDamage"],
+  // Umbrella/Excess
+  [["umbrellaoccurrence", "eachoccurrenceumbrella", "excessoccurrence", "excesseachoccurrence"], "eachOccurrenceUmbrella"],
+  [["umbrellaaggregate", "excessaggregate"], "umbrellaAggregate"],
+  [["umbrella retention", "selfinsuredretention", "sir", "excessretention"], "umbrellaRetention"]
+];
+function synthesizeLimits(doc) {
+  const raw = doc;
+  if (raw.limits && typeof raw.limits === "object" && Object.keys(raw.limits).length > 0) return;
+  const coverages = doc.coverages;
+  if (!coverages || coverages.length === 0) return;
+  const limits = {};
+  for (const cov of coverages) {
+    if (!cov.name || !cov.limit) continue;
+    const normalized = normalizeName(cov.name);
+    for (const [patterns, fieldName] of LIMIT_COVERAGE_MAP) {
+      if (patterns.some((p) => normalized.includes(p) || p.includes(normalized))) {
+        if (fieldName.includes("Aggregate") || fieldName.includes("aggregate")) {
+          if (!cov.limitType || cov.limitType === "aggregate") {
+            limits[fieldName] = cov.limit;
+          }
+        } else {
+          if (!limits[fieldName]) {
+            limits[fieldName] = cov.limit;
+          }
+        }
+        break;
+      }
+    }
+  }
+  const hasStatutory = coverages.some(
+    (c) => c.limitType === "statutory" || normalizeName(c.name ?? "").includes("statutory")
+  );
+  if (hasStatutory) {
+    limits.statutory = "true";
+  }
+  const elCoverages = coverages.filter(
+    (c) => normalizeName(c.name ?? "").includes("employersliability")
+  );
+  if (elCoverages.length > 0) {
+    const el = {};
+    for (const c of elCoverages) {
+      if (!c.limit) continue;
+      const n = normalizeName(c.name ?? "");
+      if (n.includes("accident") || n.includes("eachaccident")) el.eachAccident = c.limit;
+      else if (n.includes("diseasepolicy") || n.includes("diseasepolicylimit")) el.diseasePolicyLimit = c.limit;
+      else if (n.includes("diseaseemployee") || n.includes("diseaseeachemployee")) el.diseaseEachEmployee = c.limit;
+      else if (!el.eachAccident) el.eachAccident = c.limit;
+    }
+    if (Object.keys(el).length > 0) {
+      limits.employersLiability = el;
+    }
+  }
+  if (Object.keys(limits).length > 0) {
+    const result = { ...limits };
+    if (result.statutory === "true") result.statutory = true;
+    raw.limits = result;
+  }
+}
+function synthesizeDeductibles(doc) {
+  const raw = doc;
+  if (raw.deductibles && typeof raw.deductibles === "object" && Object.keys(raw.deductibles).length > 0) return;
+  const coverages = doc.coverages;
+  if (!coverages || coverages.length === 0) return;
+  const deductibleValues = coverages.filter((c) => c.deductible && c.deductible.trim() !== "" && c.deductible !== "N/A" && c.deductible !== "None").map((c) => c.deductible);
+  if (deductibleValues.length === 0) return;
+  const freq = /* @__PURE__ */ new Map();
+  for (const d of deductibleValues) {
+    freq.set(d, (freq.get(d) ?? 0) + 1);
+  }
+  let mostCommon = deductibleValues[0];
+  let maxFreq = 0;
+  for (const [val, count] of freq) {
+    if (count > maxFreq) {
+      mostCommon = val;
+      maxFreq = count;
+    }
+  }
+  const deductibles = {};
+  const hasPerClaim = coverages.some(
+    (c) => c.deductible && normalizeName(c.name ?? "").includes("perclaim")
+  );
+  if (hasPerClaim) {
+    deductibles.perClaim = mostCommon;
+  } else {
+    deductibles.perOccurrence = mostCommon;
+  }
+  const sirCoverage = coverages.find(
+    (c) => c.deductible && (normalizeName(c.name ?? "").includes("selfinsuredretention") || normalizeName(c.name ?? "").includes("sir"))
+  );
+  if (sirCoverage?.deductible) {
+    deductibles.selfInsuredRetention = sirCoverage.deductible;
+  }
+  const aggDed = coverages.find(
+    (c) => c.deductible && normalizeName(c.name ?? "").includes("aggregatedeductible")
+  );
+  if (aggDed?.deductible) {
+    deductibles.aggregateDeductible = aggDed.deductible;
+  }
+  if (Object.keys(deductibles).length > 0) {
+    raw.deductibles = deductibles;
+  }
+}
+var PREMIUM_PATTERNS = ["premium", "totalPremium", "annualPremium", "policyPremium", "basePremium"];
+var TOTAL_COST_PATTERNS = ["totalCost", "totalDue", "totalAmount", "totalPolicyPremium"];
+function promotePremium(doc) {
+  const raw = doc;
+  const fields = getDeclarationFields(doc);
+  if (!raw.premium) {
+    const premium = findFieldValue(fields, PREMIUM_PATTERNS);
+    if (premium) raw.premium = premium;
+  }
+  if (!raw.totalCost) {
+    const totalCost = findFieldValue(fields, TOTAL_COST_PATTERNS);
+    if (totalCost) raw.totalCost = totalCost;
+  }
+}
+function promoteExtractedFields(doc) {
+  promoteCarrierFields(doc);
+  promoteBroker(doc);
+  promoteLossPayees(doc);
+  promoteLocations(doc);
+  synthesizeLimits(doc);
+  synthesizeDeductibles(doc);
+  promotePremium(doc);
+}
+
 // src/extraction/assembler.ts
 function assembleDocument(documentId, documentType, memory) {
   const carrier = memory.get("carrier_info");
@@ -1597,6 +1950,9 @@ function assembleDocument(documentId, documentType, memory) {
     policyTypes: classify?.policyTypes,
     ...sanitizeNulls(carrier ?? {}),
     ...sanitizeNulls(insured ?? {}),
+    // Map named_insured extractor's loss payees/mortgage holders to EndorsementParty shape
+    ...Array.isArray(insured?.lossPayees) && insured.lossPayees.length > 0 ? { lossPayees: insured.lossPayees.map((lp) => ({ ...lp, role: "loss_payee" })) } : {},
+    ...Array.isArray(insured?.mortgageHolders) && insured.mortgageHolders.length > 0 ? { mortgageHolders: insured.mortgageHolders.map((mh) => ({ ...mh, role: "mortgage_holder" })) } : {},
     ...sanitizeNulls(coverages ?? {}),
     ...sanitizeNulls(premium ?? {}),
     ...sanitizeNulls(supplementary ?? {}),
@@ -1608,8 +1964,9 @@ function assembleDocument(documentId, documentType, memory) {
     declarations: declarations ? sanitizeNulls(declarations) : void 0,
     ...sanitizeNulls(lossHistory ?? {})
   };
+  let doc;
   if (documentType === "policy") {
-    return {
+    doc = {
       ...base,
       type: "policy",
       policyNumber: carrier?.policyNumber ?? insured?.policyNumber ?? "Unknown",
@@ -1617,17 +1974,20 @@ function assembleDocument(documentId, documentType, memory) {
       expirationDate: carrier?.expirationDate,
       policyTermType: carrier?.policyTermType
     };
+  } else {
+    doc = {
+      ...base,
+      type: "quote",
+      quoteNumber: carrier?.quoteNumber ?? "Unknown",
+      proposedEffectiveDate: carrier?.proposedEffectiveDate,
+      proposedExpirationDate: carrier?.proposedExpirationDate,
+      subjectivities: coverages?.subjectivities,
+      underwritingConditions: coverages?.underwritingConditions,
+      premiumBreakdown: premium?.premiumBreakdown
+    };
   }
-  return {
-    ...base,
-    type: "quote",
-    quoteNumber: carrier?.quoteNumber ?? "Unknown",
-    proposedEffectiveDate: carrier?.proposedEffectiveDate,
-    proposedExpirationDate: carrier?.proposedExpirationDate,
-    subjectivities: coverages?.subjectivities,
-    underwritingConditions: coverages?.underwritingConditions,
-    premiumBreakdown: premium?.premiumBreakdown
-  };
+  promoteExtractedFields(doc);
+  return doc;
 }
 
 // src/prompts/coordinator/format.ts
@@ -1999,6 +2359,7 @@ function mergeCoverageLimits(existing, incoming) {
   const incomingCoverages = Array.isArray(incoming.coverages) ? incoming.coverages : [];
   const coverageKey = (coverage) => [
     String(coverage.name ?? "").toLowerCase(),
+    String(coverage.limitType ?? "").toLowerCase(),
     String(coverage.limit ?? "").toLowerCase(),
     String(coverage.deductible ?? "").toLowerCase(),
     String(coverage.formNumber ?? "").toLowerCase()
@@ -2964,6 +3325,7 @@ Available extractors:
 - supplementary
 
 Rules:
+- Identify the broad section or form context first, then assign focused extractors within that context.
 - Use specific extractors for declarations, schedules, endorsements, exclusions, conditions, premium pages, and loss runs.
 - Use "sections" for pages that contain substantive policy text or mixed content that should still be preserved as raw sections.
 - Avoid assigning broad ranges mentally; decide page by page.
@@ -2974,6 +3336,8 @@ Rules:
 - Headings like "Limits of Insurance", "Deductible", "Coinsurance", "Loss Conditions", or "Definitions" inside a policy form usually indicate form language, not declarations or schedules.
 - Continuation pages near the end of a form should stay mapped to "sections" plus "conditions"/"exclusions" when applicable, even if they mention limits or deductibles.
 - When a form inventory entry identifies a page range as a specific form type (e.g., endorsement, coverage, application), use that classification to guide your extractor choice. Do not assign "coverage_limits" to pages the inventory identifies as endorsement or condition/exclusion forms unless the page contains actual schedule values.
+- Do not tag a page with "exclusions" or "conditions" if it only contains a table of contents, page-number reference, running header/footer, or a heading that points to another page without substantive wording.
+- If a page appears to be part of a larger exclusion, conditions, or endorsement section within the same form, keep the assignment consistent across nearby pages in that section rather than isolating a single page fragment.
 - Return every page in the supplied chunk exactly once.
 
 Return JSON:
@@ -3057,21 +3421,69 @@ Use the page map to target follow-up extraction pages precisely. Prefer narrow,
 Respond with JSON only.`;
 }
 
-// src/prompts/extractors/carrier-info.ts
+// src/prompts/coordinator/summarize.ts
 import { z as z22 } from "zod";
-var CarrierInfoSchema = z22.object({
-  carrierName: z22.string().describe("Primary insurance company name for display"),
-  carrierLegalName: z22.string().optional().describe("Legal entity name of insurer"),
-  naicNumber: z22.string().optional().describe("NAIC company code"),
-  amBestRating: z22.string().optional().describe("AM Best rating, e.g. 'A+ XV'"),
-  admittedStatus: z22.enum(["admitted", "non_admitted", "surplus_lines"]).optional().describe("Admitted status of the carrier"),
-  mga: z22.string().optional().describe("Managing General Agent or Program Administrator name"),
-  underwriter: z22.string().optional().describe("Named individual underwriter"),
-  policyNumber: z22.string().optional().describe("Policy or quote reference number"),
-  effectiveDate: z22.string().optional().describe("Policy effective date (MM/DD/YYYY)"),
-  expirationDate: z22.string().optional().describe("Policy expiration date (MM/DD/YYYY)"),
-  quoteNumber: z22.string().optional().describe("Quote or proposal reference number"),
-  proposedEffectiveDate: z22.string().optional().describe("Proposed effective date for quotes (MM/DD/YYYY)")
+var SummaryResultSchema = z22.object({
+  summary: z22.string().describe("A 1-3 sentence overview of this insurance document")
+});
+function buildSummaryPrompt(doc) {
+  const snapshot = {
+    type: doc.type,
+    carrier: doc.carrier,
+    insuredName: doc.insuredName,
+    policyTypes: doc.policyTypes,
+    premium: doc.premium,
+    coverageCount: doc.coverages?.length ?? 0
+  };
+  if (doc.type === "policy") {
+    snapshot.policyNumber = doc.policyNumber;
+    snapshot.effectiveDate = doc.effectiveDate;
+    snapshot.expirationDate = doc.expirationDate;
+  } else {
+    snapshot.quoteNumber = doc.quoteNumber;
+    snapshot.proposedEffectiveDate = doc.proposedEffectiveDate;
+  }
+  const raw = doc;
+  if (raw.limits) snapshot.limits = raw.limits;
+  if (raw.deductibles) snapshot.deductibles = raw.deductibles;
+  if (raw.brokerAgency) snapshot.brokerAgency = raw.brokerAgency;
+  if (doc.endorsements?.length) snapshot.endorsementCount = doc.endorsements.length;
+  if (doc.exclusions?.length) snapshot.exclusionCount = doc.exclusions.length;
+  if (doc.coverages?.length) {
+    snapshot.topCoverages = doc.coverages.slice(0, 5).map((c) => c.name);
+  }
+  return `You are an expert insurance document analyst. Generate a brief summary of this insurance document.
+
+Write 1-3 sentences that capture the essential facts a broker or underwriter would want at a glance:
+- Who is insured and by whom
+- What type of policy/quote and the key coverages
+- Policy period and premium if available
+- Any notable features (high limits, unusual exclusions, etc.)
+
+Document data:
+${JSON.stringify(snapshot, null, 2)}
+
+Return JSON only with a "summary" field.`;
+}
+
+// src/prompts/extractors/carrier-info.ts
+import { z as z23 } from "zod";
+var CarrierInfoSchema = z23.object({
+  carrierName: z23.string().describe("Primary insurance company name for display"),
+  carrierLegalName: z23.string().optional().describe("Legal entity name of insurer"),
+  naicNumber: z23.string().optional().describe("NAIC company code"),
+  amBestRating: z23.string().optional().describe("AM Best rating, e.g. 'A+ XV'"),
+  admittedStatus: z23.enum(["admitted", "non_admitted", "surplus_lines"]).optional().describe("Admitted status of the carrier"),
+  mga: z23.string().optional().describe("Managing General Agent or Program Administrator name"),
+  underwriter: z23.string().optional().describe("Named individual underwriter"),
+  brokerAgency: z23.string().optional().describe("Broker or producer agency name"),
+  brokerContactName: z23.string().optional().describe("Broker or producer contact person name"),
+  brokerLicenseNumber: z23.string().optional().describe("Broker or producer license number"),
+  policyNumber: z23.string().optional().describe("Policy or quote reference number"),
+  effectiveDate: z23.string().optional().describe("Policy effective date (MM/DD/YYYY)"),
+  expirationDate: z23.string().optional().describe("Policy expiration date (MM/DD/YYYY)"),
+  quoteNumber: z23.string().optional().describe("Quote or proposal reference number"),
+  proposedEffectiveDate: z23.string().optional().describe("Proposed effective date for quotes (MM/DD/YYYY)")
 });
 function buildCarrierInfoPrompt() {
   return `You are an expert insurance document analyst. Extract carrier and policy identification information from this document.
@@ -3082,27 +3494,30 @@ Focus on:
 - Whether the carrier is admitted, non-admitted, or surplus lines
 - Managing General Agent (MGA) or Program Administrator if applicable
 - Named individual underwriter if listed
+- Broker/producer/agent: agency name, contact person name, and license number
 - Policy number and effective/expiration dates
 - For quotes: quote number and proposed effective date
 
 For carrier vs. security distinction: "carrier" is the primary company name; the legal entity on risk (e.g. "Lloyd's Underwriters") may differ from the display name.
 
+Look for broker/producer/agent information near the carrier or on the declarations page. This may be labeled "Producer", "Agent", "Broker", or similar.
+
 Return JSON only.`;
 }
 
 // src/prompts/extractors/named-insured.ts
-import { z as z23 } from "zod";
-var AddressSchema2 = z23.object({
-  street1: z23.string(),
-  city: z23.string(),
-  state: z23.string(),
-  zip: z23.string()
+import { z as z24 } from "zod";
+var AddressSchema2 = z24.object({
+  street1: z24.string(),
+  city: z24.string(),
+  state: z24.string(),
+  zip: z24.string()
 });
-var NamedInsuredSchema2 = z23.object({
-  insuredName: z23.string().describe("Name of primary named insured"),
-  insuredDba: z23.string().optional().describe("Doing-business-as name"),
+var NamedInsuredSchema2 = z24.object({
+  insuredName: z24.string().describe("Name of primary named insured"),
+  insuredDba: z24.string().optional().describe("Doing-business-as name"),
   insuredAddress: AddressSchema2.optional().describe("Primary insured mailing address"),
-  insuredEntityType: z23.enum([
+  insuredEntityType: z24.enum([
     "corporation",
     "llc",
     "partnership",
@@ -3115,16 +3530,28 @@ var NamedInsuredSchema2 = z23.object({
     "married_couple",
     "other"
   ]).optional().describe("Legal entity type of the insured"),
-  insuredFein: z23.string().optional().describe("Federal Employer Identification Number"),
-  insuredSicCode: z23.string().optional().describe("SIC code"),
-  insuredNaicsCode: z23.string().optional().describe("NAICS code"),
-  additionalNamedInsureds: z23.array(
-    z23.object({
-      name: z23.string(),
-      relationship: z23.string().optional().describe("e.g. subsidiary, affiliate"),
+  insuredFein: z24.string().optional().describe("Federal Employer Identification Number"),
+  insuredSicCode: z24.string().optional().describe("SIC code"),
+  insuredNaicsCode: z24.string().optional().describe("NAICS code"),
+  additionalNamedInsureds: z24.array(
+    z24.object({
+      name: z24.string(),
+      relationship: z24.string().optional().describe("e.g. subsidiary, affiliate"),
       address: AddressSchema2.optional()
     })
-  ).optional().describe("Additional named insureds listed on the policy")
+  ).optional().describe("Additional named insureds listed on the policy"),
+  lossPayees: z24.array(
+    z24.object({
+      name: z24.string(),
+      address: AddressSchema2.optional()
+    })
+  ).optional().describe("Loss payees listed on the policy"),
+  mortgageHolders: z24.array(
+    z24.object({
+      name: z24.string(),
+      address: AddressSchema2.optional()
+    })
+  ).optional().describe("Mortgage holders / lienholders listed on the policy")
 });
 function buildNamedInsuredPrompt() {
   return `You are an expert insurance document analyst. Extract all named insured information from this document.
@@ -3135,21 +3562,23 @@ Focus on:
 - FEIN (Federal Employer Identification Number) if listed
 - SIC code and NAICS code if listed
 - ALL additional named insureds with their relationship (subsidiary, affiliate, etc.) and address if provided
+- ALL loss payees with name and address (e.g. "Loss Payee: BMO Bank of Montreal")
+- ALL mortgage holders / lienholders / mortgagees with name and address
 
-Look on the declarations page, named insured schedule, and any endorsements that add or modify named insureds.
+Look on the declarations page, named insured schedule, loss payee schedule, mortgagee schedule, and any endorsements that add or modify named insureds, loss payees, or mortgage holders.
 
 Return JSON only.`;
 }
 
 // src/prompts/extractors/coverage-limits.ts
-import { z as z24 } from "zod";
+import { z as z25 } from "zod";
 var ExtractorCoverageSchema = CoverageSchema.extend({
-  coverageCode: z24.string().optional().describe("Coverage code or class code")
+  coverageCode: z25.string().optional().describe("Coverage code or class code")
 });
-var CoverageLimitsSchema = z24.object({
-  coverages: z24.array(ExtractorCoverageSchema).describe("All coverages with their limits"),
-  coverageForm: z24.enum(["occurrence", "claims_made", "accident"]).optional().describe("Primary coverage trigger type"),
-  retroactiveDate: z24.string().optional().describe("Retroactive date for claims-made policies (MM/DD/YYYY)")
+var CoverageLimitsSchema = z25.object({
+  coverages: z25.array(ExtractorCoverageSchema).describe("All coverages with their limits"),
+  coverageForm: z25.enum(["occurrence", "claims_made", "accident"]).optional().describe("Primary coverage trigger type"),
+  retroactiveDate: z25.string().optional().describe("Retroactive date for claims-made policies (MM/DD/YYYY)")
 });
 function buildCoverageLimitsPrompt() {
   return `You are an expert insurance document analyst. Extract all coverage limits and deductibles from this document.
@@ -3158,7 +3587,7 @@ Extract only insured-specific declaration, schedule, or endorsement entries that
 
 Focus on:
 - Every coverage listed on the declarations page or coverage schedule
-- Per-occurrence, aggregate, and sub-limits for each coverage
+- Per-occurrence, individual/occurrence, aggregate, and sub-limits for each coverage
 - Deductible or self-insured retention for each coverage
 - Coverage form type: occurrence-based, claims-made, or accident
 - Retroactive date for claims-made policies
@@ -3170,6 +3599,7 @@ For EACH coverage, also extract:
 - pageNumber: the original page number where the coverage row/value appears
 - sectionRef: the declarations/schedule/endorsement section heading where it appears
 - originalContent: the verbatim row or short source snippet used for this coverage
+- limitType: when applicable, classify the limit as per_occurrence, per_claim, aggregate, per_person, per_accident, statutory, blanket, or scheduled
 - limitValueType: classify the limit as numeric, included, not_included, as_stated, waiting_period, referential, or other
 - deductibleValueType: classify the deductible/value term similarly when deductible is present
 
@@ -3181,19 +3611,20 @@ Critical rules:
 - If a waiting period or hour deductible is shown as part of a specific declarations/schedule row, it may be captured in deductible. Otherwise omit it.
 - Use limitValueType or deductibleValueType to preserve non-numeric terms precisely instead of forcing them into numeric semantics.
 - Preserve one row per real coverage entry. Do not merge adjacent schedule rows into malformed names.
+- Keep individual/per-occurrence limits separate from aggregate limits even when they have the same coverage name, limit amount, deductible, and form number. Use limitType to distinguish them.
 
 Return JSON only.`;
 }
 
 // src/prompts/extractors/endorsements.ts
-import { z as z25 } from "zod";
-var EndorsementsSchema = z25.object({
-  endorsements: z25.array(
-    z25.object({
-      formNumber: z25.string().describe("Form number, e.g. 'CG 21 47'"),
-      editionDate: z25.string().optional().describe("Edition date, e.g. '12 07'"),
-      title: z25.string().describe("Endorsement title"),
-      endorsementType: z25.enum([
+import { z as z26 } from "zod";
+var EndorsementsSchema = z26.object({
+  endorsements: z26.array(
+    z26.object({
+      formNumber: z26.string().describe("Form number, e.g. 'CG 21 47'"),
+      editionDate: z26.string().optional().describe("Edition date, e.g. '12 07'"),
+      title: z26.string().describe("Endorsement title"),
+      endorsementType: z26.enum([
         "additional_insured",
         "waiver_of_subrogation",
         "primary_noncontributory",
@@ -3213,12 +3644,12 @@ var EndorsementsSchema = z25.object({
         "territorial_extension",
         "other"
       ]).describe("Endorsement type classification"),
-      effectiveDate: z25.string().optional().describe("Endorsement effective date"),
-      affectedCoverageParts: z25.array(z25.string()).optional().describe("Coverage parts affected by this endorsement"),
-      namedParties: z25.array(
-        z25.object({
-          name: z25.string().describe("Party name"),
-          role: z25.enum([
+      effectiveDate: z26.string().optional().describe("Endorsement effective date"),
+      affectedCoverageParts: z26.array(z26.string()).optional().describe("Coverage parts affected by this endorsement"),
+      namedParties: z26.array(
+        z26.object({
+          name: z26.string().describe("Party name"),
+          role: z26.enum([
             "additional_insured",
             "loss_payee",
             "mortgage_holder",
@@ -3227,15 +3658,15 @@ var EndorsementsSchema = z25.object({
             "designated_person",
             "other"
           ]).describe("Party role"),
-          relationship: z25.string().optional().describe("Relationship to insured"),
-          scope: z25.string().optional().describe("Scope of coverage for this party")
+          relationship: z26.string().optional().describe("Relationship to insured"),
+          scope: z26.string().optional().describe("Scope of coverage for this party")
         })
       ).optional().describe("Named parties (additional insureds, loss payees, etc.)"),
-      keyTerms: z25.array(z25.string()).optional().describe("Key terms or notable provisions in the endorsement"),
-      premiumImpact: z25.string().optional().describe("Additional premium or credit"),
-      content: z25.string().describe("Full verbatim text of the endorsement"),
-      pageStart: z25.number().describe("Starting page number of this endorsement"),
-      pageEnd: z25.number().optional().describe("Ending page number of this endorsement")
+      keyTerms: z26.array(z26.string()).optional().describe("Key terms or notable provisions in the endorsement"),
+      premiumImpact: z26.string().optional().describe("Additional premium or credit"),
+      content: z26.string().describe("Full verbatim text of the endorsement"),
+      pageStart: z26.number().describe("Starting page number of this endorsement"),
+      pageEnd: z26.number().optional().describe("Ending page number of this endorsement")
     })
   ).describe("All endorsements found in the document")
 });
@@ -3266,20 +3697,20 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/exclusions.ts
-import { z as z26 } from "zod";
-var ExclusionsSchema = z26.object({
-  exclusions: z26.array(
-    z26.object({
-      name: z26.string().describe("Exclusion title or short description"),
-      formNumber: z26.string().optional().describe("Form number if part of a named endorsement"),
-      excludedPerils: z26.array(z26.string()).optional().describe("Specific perils excluded"),
-      isAbsolute: z26.boolean().optional().describe("Whether the exclusion is absolute (no exceptions)"),
-      exceptions: z26.array(z26.string()).optional().describe("Exceptions to the exclusion, if any"),
-      buybackAvailable: z26.boolean().optional().describe("Whether coverage can be bought back via endorsement"),
-      buybackEndorsement: z26.string().optional().describe("Form number of the buyback endorsement if available"),
-      appliesTo: z26.array(z26.string()).optional().describe("Coverage types this exclusion applies to"),
-      content: z26.string().describe("Full verbatim exclusion text"),
-      pageNumber: z26.number().optional().describe("Page number where exclusion appears")
+import { z as z27 } from "zod";
+var ExclusionsSchema = z27.object({
+  exclusions: z27.array(
+    z27.object({
+      name: z27.string().describe("Exclusion title or short description"),
+      formNumber: z27.string().optional().describe("Form number if part of a named endorsement"),
+      excludedPerils: z27.array(z27.string()).optional().describe("Specific perils excluded"),
+      isAbsolute: z27.boolean().optional().describe("Whether the exclusion is absolute (no exceptions)"),
+      exceptions: z27.array(z27.string()).optional().describe("Exceptions to the exclusion, if any"),
+      buybackAvailable: z27.boolean().optional().describe("Whether coverage can be bought back via endorsement"),
+      buybackEndorsement: z27.string().optional().describe("Form number of the buyback endorsement if available"),
+      appliesTo: z27.array(z27.string()).optional().describe("Coverage types this exclusion applies to"),
+      content: z27.string().describe("Full verbatim exclusion text"),
+      pageNumber: z27.number().optional().describe("Page number where exclusion appears")
     })
   ).describe("All exclusions found in the document")
 });
@@ -3315,12 +3746,12 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/conditions.ts
-import { z as z27 } from "zod";
-var ConditionsSchema = z27.object({
-  conditions: z27.array(
-    z27.object({
-      name: z27.string().describe("Condition title"),
-      conditionType: z27.enum([
+import { z as z28 } from "zod";
+var ConditionsSchema = z28.object({
+  conditions: z28.array(
+    z28.object({
+      name: z28.string().describe("Condition title"),
+      conditionType: z28.enum([
         "duties_after_loss",
         "notice_requirements",
         "other_insurance",
@@ -3339,14 +3770,14 @@ var ConditionsSchema = z27.object({
         "separation_of_insureds",
         "other"
       ]).describe("Condition category"),
-      content: z27.string().describe("Full verbatim condition text"),
-      keyValues: z27.array(
-        z27.object({
-          key: z27.string().describe("Key name (e.g. 'noticePeriod', 'suitDeadline')"),
-          value: z27.string().describe("Value (e.g. '30 days', '2 years')")
+      content: z28.string().describe("Full verbatim condition text"),
+      keyValues: z28.array(
+        z28.object({
+          key: z28.string().describe("Key name (e.g. 'noticePeriod', 'suitDeadline')"),
+          value: z28.string().describe("Value (e.g. '30 days', '2 years')")
         })
       ).optional().describe("Key values extracted from the condition (notice periods, deadlines, etc.)"),
-      pageNumber: z27.number().optional().describe("Page number where condition appears")
+      pageNumber: z28.number().optional().describe("Page number where condition appears")
     })
   ).describe("All policy conditions found in the document")
 });
@@ -3384,28 +3815,28 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/premium-breakdown.ts
-import { z as z28 } from "zod";
-var PremiumBreakdownSchema = z28.object({
-  premium: z28.string().optional().describe("Total premium amount, e.g. '$5,000'"),
-  totalCost: z28.string().optional().describe("Total cost including taxes and fees, e.g. '$5,250'"),
-  premiumBreakdown: z28.array(
-    z28.object({
-      line: z28.string().describe("Coverage line name"),
-      amount: z28.string().describe("Premium amount for this line")
+import { z as z29 } from "zod";
+var PremiumBreakdownSchema = z29.object({
+  premium: z29.string().optional().describe("Total premium amount, e.g. '$5,000'"),
+  totalCost: z29.string().optional().describe("Total cost including taxes and fees, e.g. '$5,250'"),
+  premiumBreakdown: z29.array(
+    z29.object({
+      line: z29.string().describe("Coverage line name"),
+      amount: z29.string().describe("Premium amount for this line")
     })
   ).optional().describe("Per-coverage-line premium breakdown"),
-  taxesAndFees: z28.array(
-    z28.object({
-      name: z28.string().describe("Fee or tax name"),
-      amount: z28.string().describe("Dollar amount"),
-      type: z28.enum(["tax", "fee", "surcharge", "assessment"]).optional().describe("Fee category")
+  taxesAndFees: z29.array(
+    z29.object({
+      name: z29.string().describe("Fee or tax name"),
+      amount: z29.string().describe("Dollar amount"),
+      type: z29.enum(["tax", "fee", "surcharge", "assessment"]).optional().describe("Fee category")
     })
   ).optional().describe("Taxes, fees, surcharges, and assessments"),
-  minimumPremium: z28.string().optional().describe("Minimum premium if stated"),
-  depositPremium: z28.string().optional().describe("Deposit premium if stated"),
-  paymentPlan: z28.string().optional().describe("Payment plan description"),
-  auditType: z28.enum(["annual", "semi_annual", "quarterly", "monthly", "final", "self"]).optional().describe("Premium audit type"),
-  ratingBasis: z28.string().optional().describe("Rating basis, e.g. payroll, revenue, area, units")
+  minimumPremium: z29.string().optional().describe("Minimum premium if stated"),
+  depositPremium: z29.string().optional().describe("Deposit premium if stated"),
+  paymentPlan: z29.string().optional().describe("Payment plan description"),
+  auditType: z29.enum(["annual", "semi_annual", "quarterly", "monthly", "final", "self"]).optional().describe("Premium audit type"),
+  ratingBasis: z29.string().optional().describe("Rating basis, e.g. payroll, revenue, area, units")
 });
 function buildPremiumBreakdownPrompt() {
   return `You are an expert insurance document analyst. Extract all premium and cost information from this document.
@@ -3425,14 +3856,14 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/declarations.ts
-import { z as z29 } from "zod";
-var DeclarationsFieldSchema = z29.object({
-  field: z29.string().describe("Descriptive field name (e.g. 'policyNumber', 'effectiveDate', 'coverageALimit')"),
-  value: z29.string().describe("Extracted value exactly as it appears in the document"),
-  section: z29.string().optional().describe("Section or grouping this field belongs to (e.g. 'Coverage Limits', 'Vehicle Schedule')")
+import { z as z30 } from "zod";
+var DeclarationsFieldSchema = z30.object({
+  field: z30.string().describe("Descriptive field name (e.g. 'policyNumber', 'effectiveDate', 'coverageALimit')"),
+  value: z30.string().describe("Extracted value exactly as it appears in the document"),
+  section: z30.string().optional().describe("Section or grouping this field belongs to (e.g. 'Coverage Limits', 'Vehicle Schedule')")
 });
-var DeclarationsExtractSchema = z29.object({
-  fields: z29.array(DeclarationsFieldSchema).describe("All declarations page fields extracted as key-value pairs. Structure varies by line of business.")
+var DeclarationsExtractSchema = z30.object({
+  fields: z30.array(DeclarationsFieldSchema).describe("All declarations page fields extracted as key-value pairs. Structure varies by line of business.")
 });
 function buildDeclarationsPrompt() {
   return `You are an expert insurance document analyst. Extract all declarations page data from this document into a flexible key-value structure.
@@ -3472,21 +3903,21 @@ Preserve original values exactly as they appear. Return JSON only.`;
 }
 
 // src/prompts/extractors/loss-history.ts
-import { z as z30 } from "zod";
-var LossHistorySchema = z30.object({
-  lossSummary: z30.string().optional().describe("Summary of loss history, e.g. '3 claims in past 5 years totaling $125,000'"),
-  individualClaims: z30.array(
-    z30.object({
-      date: z30.string().optional().describe("Date of loss or claim"),
-      type: z30.string().optional().describe("Type of claim, e.g. 'property damage', 'bodily injury'"),
-      description: z30.string().optional().describe("Brief description of the claim"),
-      amountPaid: z30.string().optional().describe("Amount paid"),
-      amountReserved: z30.string().optional().describe("Amount reserved"),
-      status: z30.enum(["open", "closed", "reopened"]).optional().describe("Claim status"),
-      claimNumber: z30.string().optional().describe("Claim reference number")
+import { z as z31 } from "zod";
+var LossHistorySchema = z31.object({
+  lossSummary: z31.string().optional().describe("Summary of loss history, e.g. '3 claims in past 5 years totaling $125,000'"),
+  individualClaims: z31.array(
+    z31.object({
+      date: z31.string().optional().describe("Date of loss or claim"),
+      type: z31.string().optional().describe("Type of claim, e.g. 'property damage', 'bodily injury'"),
+      description: z31.string().optional().describe("Brief description of the claim"),
+      amountPaid: z31.string().optional().describe("Amount paid"),
+      amountReserved: z31.string().optional().describe("Amount reserved"),
+      status: z31.enum(["open", "closed", "reopened"]).optional().describe("Claim status"),
+      claimNumber: z31.string().optional().describe("Claim reference number")
     })
   ).optional().describe("Individual claim records"),
-  experienceMod: z30.string().optional().describe("Experience modification factor for workers comp, e.g. '0.85'")
+  experienceMod: z31.string().optional().describe("Experience modification factor for workers comp, e.g. '0.85'")
 });
 function buildLossHistoryPrompt() {
   return `You are an expert insurance document analyst. Extract all loss history and claims information from this document.
@@ -3503,18 +3934,18 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/sections.ts
-import { z as z31 } from "zod";
-var SubsectionSchema2 = z31.object({
-  title: z31.string().describe("Subsection title"),
-  sectionNumber: z31.string().optional().describe("Subsection number"),
-  pageNumber: z31.number().optional().describe("Page number"),
-  content: z31.string().describe("Full verbatim text")
+import { z as z32 } from "zod";
+var SubsectionSchema2 = z32.object({
+  title: z32.string().describe("Subsection title"),
+  sectionNumber: z32.string().optional().describe("Subsection number"),
+  pageNumber: z32.number().optional().describe("Page number"),
+  content: z32.string().describe("Full verbatim text")
 });
-var SectionsSchema = z31.object({
-  sections: z31.array(
-    z31.object({
-      title: z31.string().describe("Section title"),
-      type: z31.enum([
+var SectionsSchema = z32.object({
+  sections: z32.array(
+    z32.object({
+      title: z32.string().describe("Section title"),
+      type: z32.enum([
         "declarations",
         "insuring_agreement",
         "policy_form",
@@ -3528,10 +3959,10 @@ var SectionsSchema = z31.object({
         "regulatory",
         "other"
       ]).describe("Section type classification"),
-      content: z31.string().describe("Full verbatim text of the section"),
-      pageStart: z31.number().describe("Starting page number"),
-      pageEnd: z31.number().optional().describe("Ending page number"),
-      subsections: z31.array(SubsectionSchema2).optional().describe("Subsections within this section")
+      content: z32.string().describe("Full verbatim text of the section"),
+      pageStart: z32.number().describe("Starting page number"),
+      pageEnd: z32.number().optional().describe("Ending page number"),
+      subsections: z32.array(SubsectionSchema2).optional().describe("Subsections within this section")
     })
   ).describe("All document sections")
 });
@@ -3561,20 +3992,20 @@ Return JSON only.`;
 }
 
 // src/prompts/extractors/supplementary.ts
-import { z as z32 } from "zod";
-var ContactSchema2 = z32.object({
-  name: z32.string().optional().describe("Organization or person name"),
-  phone: z32.string().optional().describe("Phone number"),
-  email: z32.string().optional().describe("Email address"),
-  address: z32.string().optional().describe("Mailing address"),
-  type: z32.string().optional().describe("Contact type, e.g. 'State Department of Insurance'")
+import { z as z33 } from "zod";
+var ContactSchema2 = z33.object({
+  name: z33.string().optional().describe("Organization or person name"),
+  phone: z33.string().optional().describe("Phone number"),
+  email: z33.string().optional().describe("Email address"),
+  address: z33.string().optional().describe("Mailing address"),
+  type: z33.string().optional().describe("Contact type, e.g. 'State Department of Insurance'")
 });
-var SupplementarySchema = z32.object({
-  regulatoryContacts: z32.array(ContactSchema2).optional().describe("Regulatory body contacts (state department of insurance, ombudsman)"),
-  claimsContacts: z32.array(ContactSchema2).optional().describe("Claims reporting contacts and instructions"),
-  thirdPartyAdministrators: z32.array(ContactSchema2).optional().describe("Third-party administrators for claims handling"),
-  cancellationNoticeDays: z32.number().optional().describe("Required notice period for cancellation in days"),
-  nonrenewalNoticeDays: z32.number().optional().describe("Required notice period for nonrenewal in days")
+var SupplementarySchema = z33.object({
+  regulatoryContacts: z33.array(ContactSchema2).optional().describe("Regulatory body contacts (state department of insurance, ombudsman)"),
+  claimsContacts: z33.array(ContactSchema2).optional().describe("Claims reporting contacts and instructions"),
+  thirdPartyAdministrators: z33.array(ContactSchema2).optional().describe("Third-party administrators for claims handling"),
+  cancellationNoticeDays: z33.number().optional().describe("Required notice period for cancellation in days"),
+  nonrenewalNoticeDays: z33.number().optional().describe("Required notice period for nonrenewal in days")
 });
 function buildSupplementaryPrompt() {
   return `You are an expert insurance document analyst. Extract supplementary and regulatory information from this document.
@@ -4058,7 +4489,7 @@ function createExtractor(config) {
     ranges.push({ startPage: start, endPage: previous });
     return ranges;
   }
-  function buildPlanFromPageAssignments(pageAssignments, pageCount) {
+  function buildPlanFromPageAssignments(pageAssignments, pageCount, formInventory) {
     const extractorPages = /* @__PURE__ */ new Map();
     for (const assignment of pageAssignments) {
       const extractors = assignment.extractorNames.length > 0 ? assignment.extractorNames : ["sections"];
@@ -4075,8 +4506,30 @@ function createExtractor(config) {
         extractorPages.set("sections", [...extractorPages.get("sections") ?? [], page]);
       }
     }
+    const contextualExtractors = /* @__PURE__ */ new Set(["conditions", "exclusions", "endorsements"]);
+    const contextualForms = (formInventory?.forms ?? []).filter(
+      (form) => form.pageStart != null && (form.pageEnd ?? form.pageStart) != null
+    );
+    const expandPagesToFormRanges = (extractorName, pages) => {
+      if (!contextualExtractors.has(extractorName)) return pages;
+      const expanded = new Set(pages);
+      for (const page of pages) {
+        for (const form of contextualForms) {
+          const pageStart = form.pageStart;
+          const pageEnd = form.pageEnd ?? form.pageStart;
+          const formType = form.formType;
+          const supportsContextualExpansion = extractorName === "endorsements" ? formType === "endorsement" : formType === "coverage" || formType === "endorsement";
+          if (!supportsContextualExpansion) continue;
+          if (page < pageStart || page > pageEnd) continue;
+          for (let current = pageStart; current <= pageEnd; current += 1) {
+            expanded.add(current);
+          }
+        }
+      }
+      return [...expanded].sort((a, b) => a - b);
+    };
     const tasks = [...extractorPages.entries()].flatMap(
-      ([extractorName, pages]) => groupContiguousPages(pages).map(({ startPage, endPage }) => ({
+      ([extractorName, pages]) => groupContiguousPages(expandPagesToFormRanges(extractorName, pages)).map(({ startPage, endPage }) => ({
         extractorName,
         startPage,
         endPage,
@@ -4244,7 +4697,7 @@ function createExtractor(config) {
       onProgress?.("Resuming from checkpoint (plan complete)...");
     } else {
       onProgress?.(`Building extraction plan from page map for ${primaryType} ${documentType}...`);
-      plan = buildPlanFromPageAssignments(pageAssignments, pageCount);
+      plan = buildPlanFromPageAssignments(pageAssignments, pageCount, formInventory);
       await pipelineCtx.save("plan", {
         id,
         pageCount,
@@ -4411,6 +4864,31 @@ function createExtractor(config) {
       memory: Object.fromEntries(memory),
       document
     });
+    if (!document.summary) {
+      onProgress?.("Generating document summary...");
+      try {
+        const summaryResponse = await safeGenerateObject(
+          generateObject,
+          {
+            prompt: buildSummaryPrompt(document),
+            schema: SummaryResultSchema,
+            maxTokens: 512,
+            providerOptions
+          },
+          {
+            fallback: { summary: "" },
+            log,
+            onError: (err, attempt) => log?.(`Summary attempt ${attempt + 1} failed: ${err instanceof Error ? err.message : String(err)}`)
+          }
+        );
+        trackUsage(summaryResponse.usage);
+        if (summaryResponse.object.summary) {
+          document.summary = summaryResponse.object.summary;
+        }
+      } catch (error) {
+        await log?.(`Summary generation failed, skipping: ${error instanceof Error ? error.message : String(error)}`);
+      }
+    }
     onProgress?.("Formatting extracted content...");
     const formatResult = await formatDocumentContent(document, generateText, {
       providerOptions,
@@ -4654,8 +5132,8 @@ Respond with JSON only:
 }`;
 
 // src/schemas/application.ts
-import { z as z33 } from "zod";
-var FieldTypeSchema = z33.enum([
+import { z as z34 } from "zod";
+var FieldTypeSchema = z34.enum([
   "text",
   "numeric",
   "currency",
@@ -4664,131 +5142,131 @@ var FieldTypeSchema = z33.enum([
   "table",
   "declaration"
 ]);
-var ApplicationFieldSchema = z33.object({
-  id: z33.string(),
-  label: z33.string(),
-  section: z33.string(),
+var ApplicationFieldSchema = z34.object({
+  id: z34.string(),
+  label: z34.string(),
+  section: z34.string(),
   fieldType: FieldTypeSchema,
-  required: z33.boolean(),
-  options: z33.array(z33.string()).optional(),
-  columns: z33.array(z33.string()).optional(),
-  requiresExplanationIfYes: z33.boolean().optional(),
-  condition: z33.object({
-    dependsOn: z33.string(),
-    whenValue: z33.string()
+  required: z34.boolean(),
+  options: z34.array(z34.string()).optional(),
+  columns: z34.array(z34.string()).optional(),
+  requiresExplanationIfYes: z34.boolean().optional(),
+  condition: z34.object({
+    dependsOn: z34.string(),
+    whenValue: z34.string()
   }).optional(),
-  value: z33.string().optional(),
-  source: z33.string().optional().describe("Where the value came from: auto-fill, user, lookup"),
-  confidence: z33.enum(["confirmed", "high", "medium", "low"]).optional()
+  value: z34.string().optional(),
+  source: z34.string().optional().describe("Where the value came from: auto-fill, user, lookup"),
+  confidence: z34.enum(["confirmed", "high", "medium", "low"]).optional()
 });
-var ApplicationClassifyResultSchema = z33.object({
-  isApplication: z33.boolean(),
-  confidence: z33.number().min(0).max(1),
-  applicationType: z33.string().nullable()
+var ApplicationClassifyResultSchema = z34.object({
+  isApplication: z34.boolean(),
+  confidence: z34.number().min(0).max(1),
+  applicationType: z34.string().nullable()
 });
-var FieldExtractionResultSchema = z33.object({
-  fields: z33.array(ApplicationFieldSchema)
+var FieldExtractionResultSchema = z34.object({
+  fields: z34.array(ApplicationFieldSchema)
 });
-var AutoFillMatchSchema = z33.object({
-  fieldId: z33.string(),
-  value: z33.string(),
-  confidence: z33.enum(["confirmed"]),
-  contextKey: z33.string()
+var AutoFillMatchSchema = z34.object({
+  fieldId: z34.string(),
+  value: z34.string(),
+  confidence: z34.enum(["confirmed"]),
+  contextKey: z34.string()
 });
-var AutoFillResultSchema = z33.object({
-  matches: z33.array(AutoFillMatchSchema)
+var AutoFillResultSchema = z34.object({
+  matches: z34.array(AutoFillMatchSchema)
 });
-var QuestionBatchResultSchema = z33.object({
-  batches: z33.array(z33.array(z33.string()).describe("Array of field IDs in this batch"))
+var QuestionBatchResultSchema = z34.object({
+  batches: z34.array(z34.array(z34.string()).describe("Array of field IDs in this batch"))
 });
-var LookupRequestSchema = z33.object({
-  type: z33.string().describe("Type of lookup: 'records', 'website', 'policy'"),
-  description: z33.string(),
-  url: z33.string().optional(),
-  targetFieldIds: z33.array(z33.string())
+var LookupRequestSchema = z34.object({
+  type: z34.string().describe("Type of lookup: 'records', 'website', 'policy'"),
+  description: z34.string(),
+  url: z34.string().optional(),
+  targetFieldIds: z34.array(z34.string())
 });
-var ReplyIntentSchema = z33.object({
-  primaryIntent: z33.enum(["answers_only", "question", "lookup_request", "mixed"]),
-  hasAnswers: z33.boolean(),
-  questionText: z33.string().optional(),
-  questionFieldIds: z33.array(z33.string()).optional(),
-  lookupRequests: z33.array(LookupRequestSchema).optional()
+var ReplyIntentSchema = z34.object({
+  primaryIntent: z34.enum(["answers_only", "question", "lookup_request", "mixed"]),
+  hasAnswers: z34.boolean(),
+  questionText: z34.string().optional(),
+  questionFieldIds: z34.array(z34.string()).optional(),
+  lookupRequests: z34.array(LookupRequestSchema).optional()
 });
-var ParsedAnswerSchema = z33.object({
-  fieldId: z33.string(),
-  value: z33.string(),
-  explanation: z33.string().optional()
+var ParsedAnswerSchema = z34.object({
+  fieldId: z34.string(),
+  value: z34.string(),
+  explanation: z34.string().optional()
 });
-var AnswerParsingResultSchema = z33.object({
-  answers: z33.array(ParsedAnswerSchema),
-  unanswered: z33.array(z33.string()).describe("Field IDs that were not answered")
+var AnswerParsingResultSchema = z34.object({
+  answers: z34.array(ParsedAnswerSchema),
+  unanswered: z34.array(z34.string()).describe("Field IDs that were not answered")
 });
-var LookupFillSchema = z33.object({
-  fieldId: z33.string(),
-  value: z33.string(),
-  source: z33.string().describe("Specific citable reference, e.g. 'GL Policy #POL-12345 (Hartford)'")
+var LookupFillSchema = z34.object({
+  fieldId: z34.string(),
+  value: z34.string(),
+  source: z34.string().describe("Specific citable reference, e.g. 'GL Policy #POL-12345 (Hartford)'")
 });
-var LookupFillResultSchema = z33.object({
-  fills: z33.array(LookupFillSchema),
-  unfillable: z33.array(z33.string()),
-  explanation: z33.string().optional()
+var LookupFillResultSchema = z34.object({
+  fills: z34.array(LookupFillSchema),
+  unfillable: z34.array(z34.string()),
+  explanation: z34.string().optional()
 });
-var FlatPdfPlacementSchema = z33.object({
-  fieldId: z33.string(),
-  page: z33.number(),
-  x: z33.number().describe("Percentage from left edge (0-100)"),
-  y: z33.number().describe("Percentage from top edge (0-100)"),
-  text: z33.string(),
-  fontSize: z33.number().optional(),
-  isCheckmark: z33.boolean().optional()
+var FlatPdfPlacementSchema = z34.object({
+  fieldId: z34.string(),
+  page: z34.number(),
+  x: z34.number().describe("Percentage from left edge (0-100)"),
+  y: z34.number().describe("Percentage from top edge (0-100)"),
+  text: z34.string(),
+  fontSize: z34.number().optional(),
+  isCheckmark: z34.boolean().optional()
 });
-var AcroFormMappingSchema = z33.object({
-  fieldId: z33.string(),
-  acroFormName: z33.string(),
-  value: z33.string()
+var AcroFormMappingSchema = z34.object({
+  fieldId: z34.string(),
+  acroFormName: z34.string(),
+  value: z34.string()
 });
-var QualityGateStatusSchema = z33.enum(["passed", "warning", "failed"]);
-var QualitySeveritySchema = z33.enum(["info", "warning", "blocking"]);
-var ApplicationQualityIssueSchema = z33.object({
-  code: z33.string(),
+var QualityGateStatusSchema = z34.enum(["passed", "warning", "failed"]);
+var QualitySeveritySchema = z34.enum(["info", "warning", "blocking"]);
+var ApplicationQualityIssueSchema = z34.object({
+  code: z34.string(),
   severity: QualitySeveritySchema,
-  message: z33.string(),
-  fieldId: z33.string().optional()
+  message: z34.string(),
+  fieldId: z34.string().optional()
 });
-var ApplicationQualityRoundSchema = z33.object({
-  round: z33.number(),
-  kind: z33.string(),
+var ApplicationQualityRoundSchema = z34.object({
+  round: z34.number(),
+  kind: z34.string(),
   status: QualityGateStatusSchema,
-  summary: z33.string().optional()
+  summary: z34.string().optional()
 });
-var ApplicationQualityArtifactSchema = z33.object({
-  kind: z33.string(),
-  label: z33.string().optional(),
-  itemCount: z33.number().optional()
+var ApplicationQualityArtifactSchema = z34.object({
+  kind: z34.string(),
+  label: z34.string().optional(),
+  itemCount: z34.number().optional()
 });
-var ApplicationEmailReviewSchema = z33.object({
-  issues: z33.array(ApplicationQualityIssueSchema),
+var ApplicationEmailReviewSchema = z34.object({
+  issues: z34.array(ApplicationQualityIssueSchema),
   qualityGateStatus: QualityGateStatusSchema
 });
-var ApplicationQualityReportSchema = z33.object({
-  issues: z33.array(ApplicationQualityIssueSchema),
-  rounds: z33.array(ApplicationQualityRoundSchema).optional(),
-  artifacts: z33.array(ApplicationQualityArtifactSchema).optional(),
+var ApplicationQualityReportSchema = z34.object({
+  issues: z34.array(ApplicationQualityIssueSchema),
+  rounds: z34.array(ApplicationQualityRoundSchema).optional(),
+  artifacts: z34.array(ApplicationQualityArtifactSchema).optional(),
   emailReview: ApplicationEmailReviewSchema.optional(),
   qualityGateStatus: QualityGateStatusSchema
 });
-var ApplicationStateSchema = z33.object({
-  id: z33.string(),
-  pdfBase64: z33.string().optional().describe("Original PDF, omitted after extraction"),
-  title: z33.string().optional(),
-  applicationType: z33.string().nullable().optional(),
-  fields: z33.array(ApplicationFieldSchema),
-  batches: z33.array(z33.array(z33.string())).optional(),
-  currentBatchIndex: z33.number().default(0),
+var ApplicationStateSchema = z34.object({
+  id: z34.string(),
+  pdfBase64: z34.string().optional().describe("Original PDF, omitted after extraction"),
+  title: z34.string().optional(),
+  applicationType: z34.string().nullable().optional(),
+  fields: z34.array(ApplicationFieldSchema),
+  batches: z34.array(z34.array(z34.string())).optional(),
+  currentBatchIndex: z34.number().default(0),
   qualityReport: ApplicationQualityReportSchema.optional(),
-  status: z33.enum(["classifying", "extracting", "auto_filling", "batching", "collecting", "confirming", "mapping", "complete"]),
-  createdAt: z33.number(),
-  updatedAt: z33.number()
+  status: z34.enum(["classifying", "extracting", "auto_filling", "batching", "collecting", "confirming", "mapping", "complete"]),
+  createdAt: z34.number(),
+  updatedAt: z34.number()
 });
 
 // src/application/agents/classifier.ts
@@ -5921,73 +6399,73 @@ Respond with the final answer, deduplicated citations array, overall confidence
 }
 
 // src/schemas/query.ts
-import { z as z34 } from "zod";
-var QueryIntentSchema = z34.enum([
+import { z as z35 } from "zod";
+var QueryIntentSchema = z35.enum([
   "policy_question",
   "coverage_comparison",
   "document_search",
   "claims_inquiry",
   "general_knowledge"
 ]);
-var SubQuestionSchema = z34.object({
-  question: z34.string().describe("Atomic sub-question to retrieve and answer independently"),
+var SubQuestionSchema = z35.object({
+  question: z35.string().describe("Atomic sub-question to retrieve and answer independently"),
   intent: QueryIntentSchema,
-  chunkTypes: z34.array(z34.string()).optional().describe("Chunk types to filter retrieval (e.g. coverage, endorsement, declaration)"),
-  documentFilters: z34.object({
-    type: z34.enum(["policy", "quote"]).optional(),
-    carrier: z34.string().optional(),
-    insuredName: z34.string().optional(),
-    policyNumber: z34.string().optional(),
-    quoteNumber: z34.string().optional()
+  chunkTypes: z35.array(z35.string()).optional().describe("Chunk types to filter retrieval (e.g. coverage, endorsement, declaration)"),
+  documentFilters: z35.object({
+    type: z35.enum(["policy", "quote"]).optional(),
+    carrier: z35.string().optional(),
+    insuredName: z35.string().optional(),
+    policyNumber: z35.string().optional(),
+    quoteNumber: z35.string().optional()
   }).optional().describe("Structured filters to narrow document lookup")
 });
-var QueryClassifyResultSchema = z34.object({
+var QueryClassifyResultSchema = z35.object({
   intent: QueryIntentSchema,
-  subQuestions: z34.array(SubQuestionSchema).min(1).describe("Decomposed atomic sub-questions"),
-  requiresDocumentLookup: z34.boolean().describe("Whether structured document lookup is needed"),
-  requiresChunkSearch: z34.boolean().describe("Whether semantic chunk search is needed"),
-  requiresConversationHistory: z34.boolean().describe("Whether conversation history is relevant")
+  subQuestions: z35.array(SubQuestionSchema).min(1).describe("Decomposed atomic sub-questions"),
+  requiresDocumentLookup: z35.boolean().describe("Whether structured document lookup is needed"),
+  requiresChunkSearch: z35.boolean().describe("Whether semantic chunk search is needed"),
+  requiresConversationHistory: z35.boolean().describe("Whether conversation history is relevant")
 });
-var EvidenceItemSchema = z34.object({
-  source: z34.enum(["chunk", "document", "conversation"]),
-  chunkId: z34.string().optional(),
-  documentId: z34.string().optional(),
-  turnId: z34.string().optional(),
-  text: z34.string().describe("Text excerpt from the source"),
-  relevance: z34.number().min(0).max(1),
-  metadata: z34.array(z34.object({ key: z34.string(), value: z34.string() })).optional()
+var EvidenceItemSchema = z35.object({
+  source: z35.enum(["chunk", "document", "conversation"]),
+  chunkId: z35.string().optional(),
+  documentId: z35.string().optional(),
+  turnId: z35.string().optional(),
+  text: z35.string().describe("Text excerpt from the source"),
+  relevance: z35.number().min(0).max(1),
+  metadata: z35.array(z35.object({ key: z35.string(), value: z35.string() })).optional()
 });
-var RetrievalResultSchema = z34.object({
-  subQuestion: z34.string(),
-  evidence: z34.array(EvidenceItemSchema)
+var RetrievalResultSchema = z35.object({
+  subQuestion: z35.string(),
+  evidence: z35.array(EvidenceItemSchema)
 });
-var CitationSchema = z34.object({
-  index: z34.number().describe("Citation number [1], [2], etc."),
-  chunkId: z34.string().describe("Source chunk ID, e.g. doc-123:coverage:2"),
-  documentId: z34.string(),
-  documentType: z34.enum(["policy", "quote"]).optional(),
-  field: z34.string().optional().describe("Specific field path, e.g. coverages[0].deductible"),
-  quote: z34.string().describe("Exact text from source that supports the claim"),
-  relevance: z34.number().min(0).max(1)
+var CitationSchema = z35.object({
+  index: z35.number().describe("Citation number [1], [2], etc."),
+  chunkId: z35.string().describe("Source chunk ID, e.g. doc-123:coverage:2"),
+  documentId: z35.string(),
+  documentType: z35.enum(["policy", "quote"]).optional(),
+  field: z35.string().optional().describe("Specific field path, e.g. coverages[0].deductible"),
+  quote: z35.string().describe("Exact text from source that supports the claim"),
+  relevance: z35.number().min(0).max(1)
 });
-var SubAnswerSchema = z34.object({
-  subQuestion: z34.string(),
-  answer: z34.string(),
-  citations: z34.array(CitationSchema),
-  confidence: z34.number().min(0).max(1),
-  needsMoreContext: z34.boolean().describe("True if evidence was insufficient to answer fully")
+var SubAnswerSchema = z35.object({
+  subQuestion: z35.string(),
+  answer: z35.string(),
+  citations: z35.array(CitationSchema),
+  confidence: z35.number().min(0).max(1),
+  needsMoreContext: z35.boolean().describe("True if evidence was insufficient to answer fully")
 });
-var VerifyResultSchema = z34.object({
-  approved: z34.boolean().describe("Whether all sub-answers are adequately grounded"),
-  issues: z34.array(z34.string()).describe("Specific grounding or consistency issues found"),
-  retrySubQuestions: z34.array(z34.string()).optional().describe("Sub-questions that need additional retrieval or re-reasoning")
+var VerifyResultSchema = z35.object({
+  approved: z35.boolean().describe("Whether all sub-answers are adequately grounded"),
+  issues: z35.array(z35.string()).describe("Specific grounding or consistency issues found"),
+  retrySubQuestions: z35.array(z35.string()).optional().describe("Sub-questions that need additional retrieval or re-reasoning")
 });
-var QueryResultSchema = z34.object({
-  answer: z34.string(),
-  citations: z34.array(CitationSchema),
+var QueryResultSchema = z35.object({
+  answer: z35.string(),
+  citations: z35.array(CitationSchema),
   intent: QueryIntentSchema,
-  confidence: z34.number().min(0).max(1),
-  followUp: z34.string().optional().describe("Suggested follow-up question if applicable")
+  confidence: z35.number().min(0).max(1),
+  followUp: z35.string().optional().describe("Suggested follow-up question if applicable")
 });
 
 // src/query/retriever.ts