@claritylabs/cl-sdk 0.10.3 → 0.12.0

package/dist/index.mjs

@@ -1575,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");
@@ -1598,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 ?? {}),
@@ -1609,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",
@@ -1618,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
@@ -3062,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.
@@ -3087,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",
@@ -3120,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"),
+  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("Additional named insureds listed on the policy")
+  ).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.
@@ -3140,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.
@@ -3193,14 +3617,14 @@ 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",
@@ -3220,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",
@@ -3234,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")
 });
@@ -3273,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")
 });
@@ -3322,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",
@@ -3346,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")
 });
@@ -3391,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.
@@ -3432,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.
@@ -3479,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.
@@ -3510,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",
@@ -3535,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")
 });
@@ -3568,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.
@@ -4440,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,
@@ -4683,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",
@@ -4693,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
@@ -5887,7 +6336,7 @@ Respond with the explanation text only \u2014 no JSON, no field ID, no extra for
 }
 
 // src/prompts/query/classify.ts
-function buildQueryClassifyPrompt(question, conversationContext) {
+function buildQueryClassifyPrompt(question, conversationContext, attachmentContext) {
   return `You are a query classifier for an insurance document intelligence system.
 
 Analyze the user's question and produce a structured classification.
@@ -5897,6 +6346,9 @@ ${question}
 ${conversationContext ? `
 CONVERSATION CONTEXT:
 ${conversationContext}` : ""}
+${attachmentContext ? `
+ATTACHMENT CONTEXT:
+${attachmentContext}` : ""}
 
 INSTRUCTIONS:
 
@@ -5917,6 +6369,7 @@ INSTRUCTIONS:
    - requiresDocumentLookup: true if a specific document needs to be fetched by ID/number/carrier
    - requiresChunkSearch: true if semantic search over document chunks is needed
    - requiresConversationHistory: true if the question references prior conversation
+   - If the user's attachment already contains critical facts, still request chunk/document lookup when policy or quote details should be cross-checked against stored records
 
 CHUNK TYPES (for chunkTypes filter):
 carrier_info, named_insured, coverage, endorsement, exclusion, condition, section, declaration, loss_history, premium, supplementary
@@ -5950,73 +6403,90 @@ 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 QueryAttachmentKindSchema = z35.enum(["image", "pdf", "text"]);
+var QueryAttachmentSchema = z35.object({
+  id: z35.string().optional().describe("Optional stable attachment ID from the caller"),
+  kind: QueryAttachmentKindSchema,
+  name: z35.string().optional().describe("Original filename or user-facing label"),
+  mimeType: z35.string().optional().describe("MIME type such as image/jpeg or application/pdf"),
+  base64: z35.string().optional().describe("Base64-encoded file content for image/pdf attachments"),
+  text: z35.string().optional().describe("Plain-text attachment content when available"),
+  description: z35.string().optional().describe("Caller-provided description of the attachment")
+});
+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", "attachment"]),
+  chunkId: z35.string().optional(),
+  documentId: z35.string().optional(),
+  turnId: z35.string().optional(),
+  attachmentId: 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 AttachmentInterpretationSchema = z35.object({
+  summary: z35.string().describe("Concise summary of what the attachment shows or contains"),
+  extractedFacts: z35.array(z35.string()).describe("Specific observable or document facts grounded in the attachment"),
+  recommendedFocus: z35.array(z35.string()).describe("Important details to incorporate when answering follow-up questions"),
+  confidence: z35.number().min(0).max(1)
 });
-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 RetrievalResultSchema = z35.object({
+  subQuestion: z35.string(),
+  evidence: z35.array(EvidenceItemSchema)
 });
-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 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 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 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 QueryResultSchema = z34.object({
-  answer: z34.string(),
-  citations: z34.array(CitationSchema),
+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 = 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
@@ -6306,7 +6776,7 @@ async function verify(originalQuestion, subAnswers, allEvidence, config) {
 
 // src/query/quality.ts
 function sourceIdForEvidence(evidence) {
-  return evidence.chunkId ?? evidence.documentId ?? evidence.turnId;
+  return evidence.chunkId ?? evidence.documentId ?? evidence.turnId ?? evidence.attachmentId;
 }
 function citationSourceId(citation) {
   return citation.chunkId || citation.documentId;
@@ -6410,6 +6880,152 @@ function buildQueryReviewReport(params) {
   };
 }
 
+// src/prompts/query/interpret-attachment.ts
+function buildInterpretAttachmentPrompt(question, attachment) {
+  const attachmentLabel = attachment.name ?? attachment.id ?? "attachment";
+  const descriptor = [
+    `Attachment: ${attachmentLabel}`,
+    `Kind: ${attachment.kind}`,
+    attachment.mimeType ? `MIME type: ${attachment.mimeType}` : null,
+    attachment.description ? `Caller description: ${attachment.description}` : null
+  ].filter(Boolean).join("\n");
+  return `You are interpreting a user-supplied attachment for an insurance-support question.
+
+USER QUESTION:
+${question}
+
+ATTACHMENT METADATA:
+${descriptor}
+
+${attachment.kind === "text" && attachment.text ? `ATTACHMENT TEXT:
+${attachment.text}
+` : "The attachment content is provided separately as a file or image input.\n"}
+INSTRUCTIONS:
+1. Describe what the attachment appears to show or contain in a concise summary.
+2. Extract concrete facts that may matter when answering the user's question.
+3. Note the most important details to carry forward into follow-up questions.
+4. If the attachment is a document, identify the key business or insurance details visible.
+5. If the attachment is a photo of damage or a real-world issue, describe the observable issue without guessing beyond what is visible.
+6. Do not invent unreadable text. If something is unclear, say so in the summary or extracted facts.
+
+Respond with the structured interpretation.`;
+}
+
+// src/query/multimodal.ts
+function attachmentSourceId(attachment, index) {
+  return attachment.id ?? `attachment-${index + 1}`;
+}
+function buildAttachmentProviderOptions(attachment, providerOptions) {
+  const merged = {
+    ...providerOptions,
+    attachments: [
+      {
+        kind: attachment.kind,
+        name: attachment.name,
+        mimeType: attachment.mimeType,
+        base64: attachment.base64,
+        text: attachment.text,
+        description: attachment.description
+      }
+    ]
+  };
+  if (attachment.kind === "pdf" && attachment.base64) {
+    merged.pdfBase64 = attachment.base64;
+  }
+  if (attachment.kind === "image" && attachment.base64) {
+    merged.images = [
+      {
+        imageBase64: attachment.base64,
+        mimeType: attachment.mimeType ?? "image/jpeg"
+      }
+    ];
+  }
+  return merged;
+}
+function buildAttachmentEvidenceText(attachment, interpretation) {
+  const lines = [
+    `Attachment kind: ${attachment.kind}`,
+    attachment.name ? `Attachment name: ${attachment.name}` : null,
+    attachment.mimeType ? `MIME type: ${attachment.mimeType}` : null,
+    attachment.description ? `Caller description: ${attachment.description}` : null,
+    `Summary: ${interpretation.summary}`,
+    interpretation.extractedFacts.length > 0 ? `Extracted facts:
+${interpretation.extractedFacts.map((fact) => `- ${fact}`).join("\n")}` : null,
+    interpretation.recommendedFocus.length > 0 ? `Important follow-up details:
+${interpretation.recommendedFocus.map((item) => `- ${item}`).join("\n")}` : null,
+    attachment.kind === "text" && attachment.text ? `Original text:
+${attachment.text}` : null
+  ];
+  return lines.filter(Boolean).join("\n");
+}
+async function interpretAttachments(params) {
+  const { attachments = [], question, generateObject, providerOptions, log, onUsage } = params;
+  if (attachments.length === 0) {
+    return { evidence: [] };
+  }
+  const evidence = [];
+  for (const [index, attachment] of attachments.entries()) {
+    const id = attachmentSourceId(attachment, index);
+    if (attachment.kind === "text" && attachment.text) {
+      const textEvidence = buildAttachmentEvidenceText(attachment, {
+        summary: attachment.description ?? "User supplied text context.",
+        extractedFacts: [attachment.text],
+        recommendedFocus: [],
+        confidence: 1
+      });
+      evidence.push({
+        source: "attachment",
+        attachmentId: id,
+        chunkId: id,
+        documentId: id,
+        text: textEvidence,
+        relevance: 0.95,
+        metadata: [
+          { key: "kind", value: attachment.kind },
+          ...attachment.name ? [{ key: "name", value: attachment.name }] : []
+        ]
+      });
+      continue;
+    }
+    const prompt = buildInterpretAttachmentPrompt(question, attachment);
+    const { object, usage } = await safeGenerateObject(
+      generateObject,
+      {
+        prompt,
+        schema: AttachmentInterpretationSchema,
+        maxTokens: 2048,
+        providerOptions: buildAttachmentProviderOptions(attachment, providerOptions)
+      },
+      {
+        fallback: {
+          summary: attachment.description ?? `User supplied ${attachment.kind} attachment.`,
+          extractedFacts: [],
+          recommendedFocus: [],
+          confidence: 0.2
+        },
+        log,
+        onError: (error, attempt) => log?.(`Attachment interpretation attempt ${attempt + 1} failed for "${attachment.name ?? id}": ${error}`)
+      }
+    );
+    onUsage?.(usage);
+    evidence.push({
+      source: "attachment",
+      attachmentId: id,
+      chunkId: id,
+      documentId: id,
+      text: buildAttachmentEvidenceText(attachment, object),
+      relevance: Math.max(0.7, object.confidence),
+      metadata: [
+        { key: "kind", value: attachment.kind },
+        ...attachment.name ? [{ key: "name", value: attachment.name }] : []
+      ]
+    });
+  }
+  const contextSummary = evidence.map((item, index) => `Attachment ${index + 1}:
+${item.text}`).join("\n\n");
+  return { evidence, contextSummary };
+}
+
 // src/query/coordinator.ts
 function createQueryAgent(config) {
   const {
@@ -6437,13 +7053,23 @@ function createQueryAgent(config) {
   }
   async function query(input) {
     totalUsage = { inputTokens: 0, outputTokens: 0 };
-    const { question, conversationId, context } = input;
+    const { question, conversationId, context, attachments } = input;
     const pipelineCtx = createPipelineContext({
       id: `query-${Date.now()}`
     });
+    onProgress?.("Interpreting attachments...");
+    const { evidence: attachmentEvidence, contextSummary: attachmentContext } = await interpretAttachments({
+      attachments,
+      question,
+      generateObject,
+      providerOptions,
+      log,
+      onUsage: trackUsage
+    });
+    await pipelineCtx.save("attachments", { attachmentEvidence });
     onProgress?.("Classifying query...");
-    const classification = await classify(question, conversationId);
-    await pipelineCtx.save("classify", { classification });
+    const classification = await classify(question, conversationId, attachmentContext);
+    await pipelineCtx.save("classify", { classification, attachmentEvidence });
     onProgress?.(`Retrieving evidence for ${classification.subQuestions.length} sub-question(s)...`);
     const retrieverConfig = {
       documentStore,
@@ -6456,8 +7082,8 @@ function createQueryAgent(config) {
         (sq) => limit(() => retrieve(sq, conversationId, retrieverConfig))
       )
     );
-    const allEvidence = retrievalResults.flatMap((r) => r.evidence);
-    await pipelineCtx.save("retrieve", { classification, evidence: allEvidence });
+    const allEvidence = [...attachmentEvidence, ...retrievalResults.flatMap((r) => r.evidence)];
+    await pipelineCtx.save("retrieve", { classification, attachmentEvidence, evidence: allEvidence });
     onProgress?.("Reasoning over evidence...");
     const reasonerConfig = { generateObject, providerOptions };
     const reasonResults = await Promise.allSettled(
@@ -6466,7 +7092,7 @@ function createQueryAgent(config) {
           const { subAnswer, usage } = await reason(
             sq.question,
             sq.intent,
-            retrievalResults[i].evidence,
+            [...attachmentEvidence, ...retrievalResults[i].evidence],
             reasonerConfig
           );
           trackUsage(usage);
@@ -6490,7 +7116,7 @@ function createQueryAgent(config) {
         });
       }
     }
-    await pipelineCtx.save("reason", { classification, evidence: allEvidence, subAnswers });
+    await pipelineCtx.save("reason", { classification, attachmentEvidence, evidence: allEvidence, subAnswers });
     onProgress?.("Verifying answer grounding...");
     const verifierConfig = { generateObject, providerOptions };
     const verifyRounds = [];
@@ -6538,7 +7164,7 @@ function createQueryAgent(config) {
                 const { subAnswer, usage: u } = await reason(
                   sq.question,
                   sq.intent,
-                  retryRetrievals[i].evidence,
+                  [...attachmentEvidence, ...retryRetrievals[i].evidence],
                   reasonerConfig
                 );
                 trackUsage(u);
@@ -6573,6 +7199,7 @@ function createQueryAgent(config) {
     });
     await pipelineCtx.save("review", {
       classification,
+      attachmentEvidence,
       evidence: allEvidence,
       subAnswers,
       reviewReport
@@ -6605,7 +7232,7 @@ function createQueryAgent(config) {
     }
     return { ...queryResult, tokenUsage: totalUsage, reviewReport };
   }
-  async function classify(question, conversationId) {
+  async function classify(question, conversationId, attachmentContext) {
     let conversationContext;
     if (conversationId) {
       try {
@@ -6616,7 +7243,7 @@ function createQueryAgent(config) {
       } catch {
       }
     }
-    const prompt = buildQueryClassifyPrompt(question, conversationContext);
+    const prompt = buildQueryClassifyPrompt(question, conversationContext, attachmentContext);
     const { object, usage } = await safeGenerateObject(
       generateObject,
       {
@@ -6831,6 +7458,7 @@ export {
   ApplicationQualityReportSchema,
   ApplicationQualityRoundSchema,
   ApplicationStateSchema,
+  AttachmentInterpretationSchema,
   AuditTypeSchema,
   AutoFillMatchSchema,
   AutoFillResultSchema,
@@ -6952,6 +7580,8 @@ export {
   ProducerInfoSchema,
   ProfessionalLiabilityDeclarationsSchema,
   QUOTE_SECTION_TYPES,
+  QueryAttachmentKindSchema,
+  QueryAttachmentSchema,
   QueryClassifyResultSchema,
   QueryIntentSchema,
   QueryResultSchema,
@@ -7010,6 +7640,7 @@ export {
   buildFormattingPrompt,
   buildIdentityPrompt,
   buildIntentPrompt,
+  buildInterpretAttachmentPrompt,
   buildLookupFillPrompt,
   buildQueryClassifyPrompt,
   buildQuestionBatchPrompt,