@claritylabs/cl-sdk 2.0.1 → 3.0.1

package/dist/storage-sqlite.d.mts

@@ -98,6 +98,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
         recordId?: string | undefined;
     }>, "many">;
     documentMetadata: z.ZodObject<{
+        sourceTreeVersion: z.ZodOptional<z.ZodString>;
+        sourceTreeCanonical: z.ZodOptional<z.ZodBoolean>;
         formInventory: z.ZodOptional<z.ZodArray<z.ZodObject<{
             formNumber: z.ZodString;
             editionDate: z.ZodOptional<z.ZodString>;
@@ -193,6 +195,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
             sourceSpanIds?: string[] | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -228,6 +232,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
             sourceSpanIds?: string[] | undefined;
         }[] | undefined;
     }, {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -3994,6 +4000,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
     id: string;
     insuredName: string;
     documentMetadata: {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -5043,6 +5051,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
     id: string;
     insuredName: string;
     documentMetadata: {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -6226,6 +6236,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
         recordId?: string | undefined;
     }>, "many">;
     documentMetadata: z.ZodObject<{
+        sourceTreeVersion: z.ZodOptional<z.ZodString>;
+        sourceTreeCanonical: z.ZodOptional<z.ZodBoolean>;
         formInventory: z.ZodOptional<z.ZodArray<z.ZodObject<{
             formNumber: z.ZodString;
             editionDate: z.ZodOptional<z.ZodString>;
@@ -6321,6 +6333,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
             sourceSpanIds?: string[] | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -6356,6 +6370,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
             sourceSpanIds?: string[] | undefined;
         }[] | undefined;
     }, {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -10120,6 +10136,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
     id: string;
     insuredName: string;
     documentMetadata: {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -11202,6 +11220,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
     id: string;
     insuredName: string;
     documentMetadata: {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -12517,6 +12537,83 @@ declare const SourceChunkSchema: z.ZodObject<{
     metadata?: Record<string, string> | undefined;
 }>;
 type SourceChunk = z.infer<typeof SourceChunkSchema>;
+declare const DocumentSourceNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    documentId: z.ZodString;
+    parentId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<["document", "page_group", "page", "form", "endorsement", "section", "schedule", "clause", "table", "table_row", "table_cell", "text"]>;
+    title: z.ZodString;
+    description: z.ZodString;
+    textExcerpt: z.ZodOptional<z.ZodString>;
+    sourceSpanIds: z.ZodArray<z.ZodString, "many">;
+    pageStart: z.ZodOptional<z.ZodNumber>;
+    pageEnd: z.ZodOptional<z.ZodNumber>;
+    bbox: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        page: z.ZodNumber;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        page: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }, {
+        page: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>, "many">>;
+    order: z.ZodNumber;
+    path: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    path: string;
+    sourceSpanIds: string[];
+    description: string;
+    kind: "endorsement" | "schedule" | "page" | "section" | "table" | "table_row" | "table_cell" | "text" | "document" | "page_group" | "form" | "clause";
+    id: string;
+    documentId: string;
+    order: number;
+    pageStart?: number | undefined;
+    pageEnd?: number | undefined;
+    bbox?: {
+        page: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    parentId?: string | undefined;
+    textExcerpt?: string | undefined;
+}, {
+    title: string;
+    path: string;
+    sourceSpanIds: string[];
+    description: string;
+    kind: "endorsement" | "schedule" | "page" | "section" | "table" | "table_row" | "table_cell" | "text" | "document" | "page_group" | "form" | "clause";
+    id: string;
+    documentId: string;
+    order: number;
+    pageStart?: number | undefined;
+    pageEnd?: number | undefined;
+    bbox?: {
+        page: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    parentId?: string | undefined;
+    textExcerpt?: string | undefined;
+}>;
+type DocumentSourceNode = z.infer<typeof DocumentSourceNodeSchema>;
 
 type SourceRetrievalMode = "graph_only" | "source_rag" | "long_context" | "hybrid";
 interface SourceRetrievalQuery {
@@ -12531,8 +12628,15 @@ interface SourceRetrievalResult {
     span: SourceSpan;
     relevance: number;
 }
+interface SourceNodeRetrievalResult {
+    node: DocumentSourceNode;
+    relevance: number;
+    hierarchy: DocumentSourceNode[];
+    spans: SourceSpan[];
+}
 interface SourceRetriever {
     searchSourceSpans(query: SourceRetrievalQuery): Promise<SourceRetrievalResult[]>;
+    searchSourceNodes?(query: SourceRetrievalQuery): Promise<SourceNodeRetrievalResult[]>;
 }
 
 interface SourceStore extends SourceRetriever {

package/dist/storage-sqlite.d.ts

@@ -98,6 +98,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
         recordId?: string | undefined;
     }>, "many">;
     documentMetadata: z.ZodObject<{
+        sourceTreeVersion: z.ZodOptional<z.ZodString>;
+        sourceTreeCanonical: z.ZodOptional<z.ZodBoolean>;
         formInventory: z.ZodOptional<z.ZodArray<z.ZodObject<{
             formNumber: z.ZodString;
             editionDate: z.ZodOptional<z.ZodString>;
@@ -193,6 +195,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
             sourceSpanIds?: string[] | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -228,6 +232,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
             sourceSpanIds?: string[] | undefined;
         }[] | undefined;
     }, {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -3994,6 +4000,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
     id: string;
     insuredName: string;
     documentMetadata: {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -5043,6 +5051,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
     id: string;
     insuredName: string;
     documentMetadata: {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -6226,6 +6236,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
         recordId?: string | undefined;
     }>, "many">;
     documentMetadata: z.ZodObject<{
+        sourceTreeVersion: z.ZodOptional<z.ZodString>;
+        sourceTreeCanonical: z.ZodOptional<z.ZodBoolean>;
         formInventory: z.ZodOptional<z.ZodArray<z.ZodObject<{
             formNumber: z.ZodString;
             editionDate: z.ZodOptional<z.ZodString>;
@@ -6321,6 +6333,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
             sourceSpanIds?: string[] | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -6356,6 +6370,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
             sourceSpanIds?: string[] | undefined;
         }[] | undefined;
     }, {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -10120,6 +10136,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
     id: string;
     insuredName: string;
     documentMetadata: {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -11202,6 +11220,8 @@ declare const InsuranceDocumentSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
     id: string;
     insuredName: string;
     documentMetadata: {
+        sourceTreeVersion?: string | undefined;
+        sourceTreeCanonical?: boolean | undefined;
         formInventory?: {
             formNumber: string;
             formType: "other" | "declarations" | "endorsement" | "application" | "notice" | "coverage";
@@ -12517,6 +12537,83 @@ declare const SourceChunkSchema: z.ZodObject<{
     metadata?: Record<string, string> | undefined;
 }>;
 type SourceChunk = z.infer<typeof SourceChunkSchema>;
+declare const DocumentSourceNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    documentId: z.ZodString;
+    parentId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<["document", "page_group", "page", "form", "endorsement", "section", "schedule", "clause", "table", "table_row", "table_cell", "text"]>;
+    title: z.ZodString;
+    description: z.ZodString;
+    textExcerpt: z.ZodOptional<z.ZodString>;
+    sourceSpanIds: z.ZodArray<z.ZodString, "many">;
+    pageStart: z.ZodOptional<z.ZodNumber>;
+    pageEnd: z.ZodOptional<z.ZodNumber>;
+    bbox: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        page: z.ZodNumber;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        page: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }, {
+        page: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>, "many">>;
+    order: z.ZodNumber;
+    path: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    path: string;
+    sourceSpanIds: string[];
+    description: string;
+    kind: "endorsement" | "schedule" | "page" | "section" | "table" | "table_row" | "table_cell" | "text" | "document" | "page_group" | "form" | "clause";
+    id: string;
+    documentId: string;
+    order: number;
+    pageStart?: number | undefined;
+    pageEnd?: number | undefined;
+    bbox?: {
+        page: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    parentId?: string | undefined;
+    textExcerpt?: string | undefined;
+}, {
+    title: string;
+    path: string;
+    sourceSpanIds: string[];
+    description: string;
+    kind: "endorsement" | "schedule" | "page" | "section" | "table" | "table_row" | "table_cell" | "text" | "document" | "page_group" | "form" | "clause";
+    id: string;
+    documentId: string;
+    order: number;
+    pageStart?: number | undefined;
+    pageEnd?: number | undefined;
+    bbox?: {
+        page: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    parentId?: string | undefined;
+    textExcerpt?: string | undefined;
+}>;
+type DocumentSourceNode = z.infer<typeof DocumentSourceNodeSchema>;
 
 type SourceRetrievalMode = "graph_only" | "source_rag" | "long_context" | "hybrid";
 interface SourceRetrievalQuery {
@@ -12531,8 +12628,15 @@ interface SourceRetrievalResult {
     span: SourceSpan;
     relevance: number;
 }
+interface SourceNodeRetrievalResult {
+    node: DocumentSourceNode;
+    relevance: number;
+    hierarchy: DocumentSourceNode[];
+    spans: SourceSpan[];
+}
 interface SourceRetriever {
     searchSourceSpans(query: SourceRetrievalQuery): Promise<SourceRetrievalResult[]>;
+    searchSourceNodes?(query: SourceRetrievalQuery): Promise<SourceNodeRetrievalResult[]>;
 }
 
 interface SourceStore extends SourceRetriever {

package/dist/storage-sqlite.js

@@ -373,6 +373,86 @@ var SourceChunkSchema = import_zod.z.object({
   pageEnd: import_zod.z.number().int().positive().optional(),
   metadata: import_zod.z.record(import_zod.z.string(), import_zod.z.string()).default({})
 });
+var DocumentSourceNodeKindSchema = import_zod.z.enum([
+  "document",
+  "page_group",
+  "page",
+  "form",
+  "endorsement",
+  "section",
+  "schedule",
+  "clause",
+  "table",
+  "table_row",
+  "table_cell",
+  "text"
+]);
+var DocumentSourceNodeSchema = import_zod.z.object({
+  id: import_zod.z.string().min(1),
+  documentId: import_zod.z.string().min(1),
+  parentId: import_zod.z.string().optional(),
+  kind: DocumentSourceNodeKindSchema,
+  title: import_zod.z.string(),
+  description: import_zod.z.string(),
+  textExcerpt: import_zod.z.string().optional(),
+  sourceSpanIds: import_zod.z.array(import_zod.z.string().min(1)),
+  pageStart: import_zod.z.number().int().positive().optional(),
+  pageEnd: import_zod.z.number().int().positive().optional(),
+  bbox: import_zod.z.array(SourceSpanBBoxSchema).optional(),
+  order: import_zod.z.number().int().nonnegative(),
+  path: import_zod.z.string(),
+  metadata: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).optional()
+});
+var SourceBackedValueSchema = import_zod.z.object({
+  value: import_zod.z.string(),
+  normalizedValue: import_zod.z.string().optional(),
+  confidence: import_zod.z.enum(["low", "medium", "high"]).default("medium"),
+  sourceNodeIds: import_zod.z.array(import_zod.z.string().min(1)).default([]),
+  sourceSpanIds: import_zod.z.array(import_zod.z.string().min(1)).default([])
+});
+var OperationalCoverageLineSchema = import_zod.z.object({
+  name: import_zod.z.string(),
+  coverageCode: import_zod.z.string().optional(),
+  limit: import_zod.z.string().optional(),
+  deductible: import_zod.z.string().optional(),
+  premium: import_zod.z.string().optional(),
+  formNumber: import_zod.z.string().optional(),
+  sectionRef: import_zod.z.string().optional(),
+  sourceNodeIds: import_zod.z.array(import_zod.z.string().min(1)).default([]),
+  sourceSpanIds: import_zod.z.array(import_zod.z.string().min(1)).default([])
+});
+var OperationalPartySchema = import_zod.z.object({
+  role: import_zod.z.string(),
+  name: import_zod.z.string(),
+  sourceNodeIds: import_zod.z.array(import_zod.z.string().min(1)).default([]),
+  sourceSpanIds: import_zod.z.array(import_zod.z.string().min(1)).default([])
+});
+var OperationalEndorsementSupportSchema = import_zod.z.object({
+  kind: import_zod.z.string(),
+  status: import_zod.z.enum(["supported", "excluded", "requires_review"]),
+  summary: import_zod.z.string(),
+  sourceNodeIds: import_zod.z.array(import_zod.z.string().min(1)).default([]),
+  sourceSpanIds: import_zod.z.array(import_zod.z.string().min(1)).default([])
+});
+var PolicyOperationalProfileSchema = import_zod.z.object({
+  documentType: import_zod.z.enum(["policy", "quote"]).default("policy"),
+  policyTypes: import_zod.z.array(import_zod.z.string()).default(["other"]),
+  policyNumber: SourceBackedValueSchema.optional(),
+  namedInsured: SourceBackedValueSchema.optional(),
+  insurer: SourceBackedValueSchema.optional(),
+  broker: SourceBackedValueSchema.optional(),
+  effectiveDate: SourceBackedValueSchema.optional(),
+  expirationDate: SourceBackedValueSchema.optional(),
+  retroactiveDate: SourceBackedValueSchema.optional(),
+  premium: SourceBackedValueSchema.optional(),
+  coverageTypes: import_zod.z.array(import_zod.z.string()).default([]),
+  coverages: import_zod.z.array(OperationalCoverageLineSchema).default([]),
+  parties: import_zod.z.array(OperationalPartySchema).default([]),
+  endorsementSupport: import_zod.z.array(OperationalEndorsementSupportSchema).default([]),
+  sourceNodeIds: import_zod.z.array(import_zod.z.string().min(1)).default([]),
+  sourceSpanIds: import_zod.z.array(import_zod.z.string().min(1)).default([]),
+  warnings: import_zod.z.array(import_zod.z.string()).default([])
+});
 
 // src/source/retrieval.ts
 function evidenceTieBreakId(evidence) {