@claritylabs/cl-sdk 0.7.3 → 0.7.4

package/dist/index.js

@@ -333,29 +333,40 @@ function toStrictSchema(schema) {
       const fieldType = fieldDef?.type ?? field.type;
       if (fieldType === "optional") {
         const innerType = fieldDef?.innerType;
+        const description = field.description ?? fieldDef?.description ?? field._zod?.def?.description;
         if (innerType) {
           const transformed = toStrictSchema(innerType);
-          newShape[key] = import_zod.z.nullable(transformed);
+          let nullable = import_zod.z.nullable(transformed);
+          if (description) nullable = nullable.describe(description);
+          newShape[key] = nullable;
         } else {
-          newShape[key] = import_zod.z.nullable(field);
+          let nullable = import_zod.z.nullable(field);
+          if (description) nullable = nullable.describe(description);
+          newShape[key] = nullable;
         }
       } else {
         newShape[key] = toStrictSchema(field);
       }
     }
-    return import_zod.z.object(newShape);
+    const objDesc = schema.description ?? def?.description ?? schema._zod?.def?.description;
+    const result = import_zod.z.object(newShape);
+    return objDesc ? result.describe(objDesc) : result;
   }
   if (typeName === "array") {
     const element = def?.element ?? schema.element;
     if (element) {
-      return import_zod.z.array(toStrictSchema(element));
+      const arrDesc = schema.description ?? def?.description ?? schema._zod?.def?.description;
+      const result = import_zod.z.array(toStrictSchema(element));
+      return arrDesc ? result.describe(arrDesc) : result;
     }
     return schema;
   }
   if (typeName === "nullable") {
     const innerType = def?.innerType;
     if (innerType) {
-      return import_zod.z.nullable(toStrictSchema(innerType));
+      const nullDesc = schema.description ?? def?.description ?? schema._zod?.def?.description;
+      const result = import_zod.z.nullable(toStrictSchema(innerType));
+      return nullDesc ? result.describe(nullDesc) : result;
     }
     return schema;
   }
@@ -3079,27 +3090,71 @@ var import_zod24 = require("zod");
 var EndorsementsSchema = import_zod24.z.object({
   endorsements: import_zod24.z.array(
     import_zod24.z.object({
-      formNumber: import_zod24.z.string().optional().describe("Form number, e.g. 'CG 21 47'"),
-      title: import_zod24.z.string().optional().describe("Endorsement title"),
-      type: import_zod24.z.enum(["broadening", "restrictive", "informational"]).optional().describe("Effect type: broadening adds coverage, restrictive limits it"),
-      content: import_zod24.z.string().optional().describe("Full verbatim text of the endorsement"),
+      formNumber: import_zod24.z.string().describe("Form number, e.g. 'CG 21 47'"),
+      editionDate: import_zod24.z.string().optional().describe("Edition date, e.g. '12 07'"),
+      title: import_zod24.z.string().describe("Endorsement title"),
+      endorsementType: import_zod24.z.enum([
+        "additional_insured",
+        "waiver_of_subrogation",
+        "primary_noncontributory",
+        "blanket_additional_insured",
+        "loss_payee",
+        "mortgage_holder",
+        "broadening",
+        "restriction",
+        "exclusion",
+        "amendatory",
+        "notice_of_cancellation",
+        "designated_premises",
+        "classification_change",
+        "schedule_update",
+        "deductible_change",
+        "limit_change",
+        "territorial_extension",
+        "other"
+      ]).describe("Endorsement type classification"),
       effectiveDate: import_zod24.z.string().optional().describe("Endorsement effective date"),
-      premium: import_zod24.z.string().optional().describe("Additional premium or credit"),
-      parties: import_zod24.z.array(import_zod24.z.string()).optional().describe("Named parties (additional insureds, loss payees, etc.)")
+      affectedCoverageParts: import_zod24.z.array(import_zod24.z.string()).optional().describe("Coverage parts affected by this endorsement"),
+      namedParties: import_zod24.z.array(
+        import_zod24.z.object({
+          name: import_zod24.z.string().describe("Party name"),
+          role: import_zod24.z.enum([
+            "additional_insured",
+            "loss_payee",
+            "mortgage_holder",
+            "certificate_holder",
+            "waiver_beneficiary",
+            "designated_person",
+            "other"
+          ]).describe("Party role"),
+          relationship: import_zod24.z.string().optional().describe("Relationship to insured"),
+          scope: import_zod24.z.string().optional().describe("Scope of coverage for this party")
+        })
+      ).optional().describe("Named parties (additional insureds, loss payees, etc.)"),
+      keyTerms: import_zod24.z.array(import_zod24.z.string()).optional().describe("Key terms or notable provisions in the endorsement"),
+      premiumImpact: import_zod24.z.string().optional().describe("Additional premium or credit"),
+      content: import_zod24.z.string().describe("Full verbatim text of the endorsement"),
+      pageStart: import_zod24.z.number().describe("Starting page number of this endorsement"),
+      pageEnd: import_zod24.z.number().optional().describe("Ending page number of this endorsement")
     })
   ).describe("All endorsements found in the document")
 });
 function buildEndorsementsPrompt() {
   return `You are an expert insurance document analyst. Extract ALL endorsements from this document. Preserve original language verbatim.
 
-Focus on:
-- Every endorsement listed in the forms schedule or endorsement schedule
-- Standalone endorsements modifying the base policy
-- Form number and edition date (e.g. "CG 21 47 12 07")
-- Endorsement title and full verbatim content
-- Effect type: "broadening" if it adds or expands coverage, "restrictive" if it limits or excludes coverage, "informational" if it changes administrative terms only
-- Additional premium or credit shown on the endorsement
-- Named parties: additional insureds, loss payees, certificate holders, mortgagees
+For EACH endorsement, extract:
+- formNumber: the form identifier (e.g. "CG 21 47") \u2014 REQUIRED
+- editionDate: the edition date if present (e.g. "12 07")
+- title: endorsement title \u2014 REQUIRED
+- endorsementType: classify as one of: additional_insured, waiver_of_subrogation, primary_noncontributory, blanket_additional_insured, loss_payee, mortgage_holder, broadening, restriction, exclusion, amendatory, notice_of_cancellation, designated_premises, classification_change, schedule_update, deductible_change, limit_change, territorial_extension, other
+- effectiveDate: endorsement effective date if shown
+- affectedCoverageParts: which coverage parts are modified
+- namedParties: for each party, extract name, role (additional_insured, loss_payee, mortgage_holder, certificate_holder, waiver_beneficiary, designated_person, other), relationship, and scope
+- keyTerms: notable provisions or key terms
+- premiumImpact: additional premium or credit if shown
+- content: full verbatim text \u2014 REQUIRED
+- pageStart: page number where endorsement begins \u2014 REQUIRED
+- pageEnd: page number where endorsement ends
 
 PERSONAL LINES ENDORSEMENT RECOGNITION:
 - HO 04 XX series: homeowners endorsements
@@ -3115,23 +3170,39 @@ var import_zod25 = require("zod");
 var ExclusionsSchema = import_zod25.z.object({
   exclusions: import_zod25.z.array(
     import_zod25.z.object({
-      title: import_zod25.z.string().describe("Exclusion title or short description"),
-      content: import_zod25.z.string().optional().describe("Full verbatim exclusion text"),
+      name: import_zod25.z.string().describe("Exclusion title or short description"),
       formNumber: import_zod25.z.string().optional().describe("Form number if part of a named endorsement"),
-      appliesTo: import_zod25.z.string().optional().describe("Coverage type this exclusion applies to")
+      excludedPerils: import_zod25.z.array(import_zod25.z.string()).optional().describe("Specific perils excluded"),
+      isAbsolute: import_zod25.z.boolean().optional().describe("Whether the exclusion is absolute (no exceptions)"),
+      exceptions: import_zod25.z.array(import_zod25.z.string()).optional().describe("Exceptions to the exclusion, if any"),
+      buybackAvailable: import_zod25.z.boolean().optional().describe("Whether coverage can be bought back via endorsement"),
+      buybackEndorsement: import_zod25.z.string().optional().describe("Form number of the buyback endorsement if available"),
+      appliesTo: import_zod25.z.array(import_zod25.z.string()).optional().describe("Coverage types this exclusion applies to"),
+      content: import_zod25.z.string().describe("Full verbatim exclusion text"),
+      pageNumber: import_zod25.z.number().optional().describe("Page number where exclusion appears")
     })
   ).describe("All exclusions found in the document")
 });
 function buildExclusionsPrompt() {
   return `You are an expert insurance document analyst. Extract ALL exclusions from this document. Preserve original language verbatim.
 
+For EACH exclusion, extract:
+- name: exclusion title or short description \u2014 REQUIRED
+- formNumber: form number if the exclusion is part of a named endorsement
+- excludedPerils: specific perils being excluded
+- isAbsolute: true if the exclusion has no exceptions, false if exceptions exist
+- exceptions: any exceptions to the exclusion (things still covered despite the exclusion)
+- buybackAvailable: whether coverage can be purchased back via endorsement
+- buybackEndorsement: the form number of the buyback endorsement if known
+- appliesTo: which coverage types or lines this exclusion applies to (as an array)
+- content: full verbatim exclusion text \u2014 REQUIRED
+- pageNumber: page number where the exclusion appears
+
 Focus on:
 - Named exclusions from exclusion schedules
 - Exclusions embedded within endorsements
 - Exclusions within insuring agreements or conditions if clearly labeled
 - Full verbatim exclusion text \u2014 do not summarize
-- Form number if the exclusion is part of a named endorsement
-- Which coverage line the exclusion applies to, if specific
 
 Common personal lines exclusion patterns: animal liability, business pursuits, home daycare, watercraft, aircraft.
 
@@ -3143,43 +3214,62 @@ var import_zod26 = require("zod");
 var ConditionsSchema = import_zod26.z.object({
   conditions: import_zod26.z.array(
     import_zod26.z.object({
-      type: import_zod26.z.enum([
+      name: import_zod26.z.string().describe("Condition title"),
+      conditionType: import_zod26.z.enum([
         "duties_after_loss",
-        "cooperation",
+        "notice_requirements",
+        "other_insurance",
         "cancellation",
         "nonrenewal",
-        "subrogation",
-        "other_insurance",
         "transfer_of_rights",
-        "examination_under_oath",
-        "arbitration",
-        "suit_against_us",
         "liberalization",
+        "arbitration",
+        "concealment_fraud",
+        "examination_under_oath",
+        "legal_action",
+        "loss_payment",
+        "appraisal",
+        "mortgage_holders",
+        "policy_territory",
+        "separation_of_insureds",
         "other"
-      ]).optional().describe("Condition category"),
-      title: import_zod26.z.string().describe("Condition title"),
-      content: import_zod26.z.string().optional().describe("Full verbatim condition text"),
-      noticeDays: import_zod26.z.number().optional().describe("Notice period in days if specified (e.g. cancellation notice)")
+      ]).describe("Condition category"),
+      content: import_zod26.z.string().describe("Full verbatim condition text"),
+      keyValues: import_zod26.z.array(
+        import_zod26.z.object({
+          key: import_zod26.z.string().describe("Key name (e.g. 'noticePeriod', 'suitDeadline')"),
+          value: import_zod26.z.string().describe("Value (e.g. '30 days', '2 years')")
+        })
+      ).optional().describe("Key values extracted from the condition (notice periods, deadlines, etc.)"),
+      pageNumber: import_zod26.z.number().optional().describe("Page number where condition appears")
     })
   ).describe("All policy conditions found in the document")
 });
 function buildConditionsPrompt() {
   return `You are an expert insurance document analyst. Extract ALL policy conditions from this document. Preserve original language verbatim.
 
+For EACH condition, extract:
+- name: condition title \u2014 REQUIRED
+- conditionType: classify as one of: duties_after_loss, notice_requirements, other_insurance, cancellation, nonrenewal, transfer_of_rights, liberalization, arbitration, concealment_fraud, examination_under_oath, legal_action, loss_payment, appraisal, mortgage_holders, policy_territory, separation_of_insureds, other \u2014 REQUIRED
+- content: full verbatim condition text \u2014 REQUIRED
+- keyValues: extract specific values as key-value pairs (e.g. noticePeriod: "30 days", suitDeadline: "2 years")
+- pageNumber: page number where the condition appears
+
 Focus on:
 - Duties after loss / notice of occurrence conditions
-- Cooperation clause
-- Cancellation and nonrenewal conditions (extract notice period in days)
-- Subrogation / transfer of rights
+- Notice requirements (extract notice period as keyValue)
+- Cancellation and nonrenewal conditions (extract notice period in days as keyValue)
 - Other insurance clause
+- Subrogation / transfer of rights
 - Examination under oath
 - Arbitration or appraisal provisions
 - Suit against us / legal action conditions
 - Liberalization clause
+- Concealment or fraud clause
+- Loss payment conditions
+- Mortgage holders clause
 - Any other named conditions
 
-For cancellation and nonrenewal conditions, extract the specific notice period in days if stated.
-
 Return JSON only.`;
 }