@geotechcli/core 0.4.77 → 0.4.79

package/dist/ingest/document-evidence-packet.d.ts

@@ -10,18 +10,18 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
     generatedAt: z.ZodString;
     providerContract: z.ZodObject<{
         providerNeutral: z.ZodLiteral<true>;
-        purpose: z.ZodLiteral<"byok-document-understanding">;
+        purpose: z.ZodLiteral<"document-evidence-contract">;
         normalizedMethods: z.ZodArray<z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>, "many">;
         reviewGates: z.ZodArray<z.ZodString, "many">;
     }, "strip", z.ZodTypeAny, {
         reviewGates: string[];
         providerNeutral: true;
-        purpose: "byok-document-understanding";
+        purpose: "document-evidence-contract";
         normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
     }, {
         reviewGates: string[];
         providerNeutral: true;
-        purpose: "byok-document-understanding";
+        purpose: "document-evidence-contract";
         normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
     }>;
     source: z.ZodObject<{
@@ -123,10 +123,10 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
         canAutoProceed: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
         confidence: number;
+        reviewRequired: boolean;
         title: string | null;
         parseStatus: "failed" | "partial" | "parsed";
         canAutoProceed: boolean;
-        reviewRequired: boolean;
         documentClass: string | null;
         confidenceBreakdown?: {
             schemaVersion: 1;
@@ -149,10 +149,10 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
         } | undefined;
     }, {
         confidence: number;
+        reviewRequired: boolean;
         title: string | null;
         parseStatus: "failed" | "partial" | "parsed";
         canAutoProceed: boolean;
-        reviewRequired: boolean;
         documentClass: string | null;
         confidenceBreakdown?: {
             schemaVersion: 1;
@@ -184,6 +184,292 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
         sourceCategory: z.ZodEnum<["native-text", "layout-ocr", "vision", "none"]>;
         cacheStatus: z.ZodEnum<["hit", "miss", "stored", "skipped", "unavailable"]>;
         cacheEntryId: z.ZodOptional<z.ZodString>;
+        preprocessing: z.ZodOptional<z.ZodObject<{
+            sourceCategory: z.ZodEnum<["native-text", "layout-ocr", "vision", "none"]>;
+            cacheStatus: z.ZodEnum<["hit", "miss", "stored", "skipped", "unavailable"]>;
+            cacheKey: z.ZodOptional<z.ZodString>;
+            fileHash: z.ZodOptional<z.ZodString>;
+            pageHash: z.ZodOptional<z.ZodString>;
+            modelVersion: z.ZodOptional<z.ZodString>;
+            preprocessingVersion: z.ZodOptional<z.ZodString>;
+            schemaVersion: z.ZodOptional<z.ZodNumber>;
+            pipelineVersion: z.ZodOptional<z.ZodString>;
+            policy: z.ZodOptional<z.ZodEnum<["none", "ocr-optimized", "region-v2"]>>;
+            transformed: z.ZodOptional<z.ZodBoolean>;
+            operations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            input: z.ZodOptional<z.ZodObject<{
+                mimeType: z.ZodString;
+                byteLength: z.ZodNumber;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            }, {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            }>>;
+            output: z.ZodOptional<z.ZodObject<{
+                mimeType: z.ZodString;
+                byteLength: z.ZodNumber;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            }, {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            }>>;
+            quality: z.ZodOptional<z.ZodObject<{
+                score: z.ZodNumber;
+                contentCoverageRatio: z.ZodNumber;
+                darkPixelRatio: z.ZodNumber;
+                regionCoverageRatio: z.ZodNumber;
+                regionCount: z.ZodNumber;
+                cropAssetCount: z.ZodNumber;
+                deskew: z.ZodObject<{
+                    method: z.ZodEnum<["projection-profile", "projection-profile-fine"]>;
+                    angleDeg: z.ZodNumber;
+                    confidence: z.ZodNumber;
+                    applied: z.ZodBoolean;
+                }, "strip", z.ZodTypeAny, {
+                    method: "projection-profile" | "projection-profile-fine";
+                    confidence: number;
+                    applied: boolean;
+                    angleDeg: number;
+                }, {
+                    method: "projection-profile" | "projection-profile-fine";
+                    confidence: number;
+                    applied: boolean;
+                    angleDeg: number;
+                }>;
+                warnings: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                warnings: string[];
+                score: number;
+                contentCoverageRatio: number;
+                darkPixelRatio: number;
+                regionCoverageRatio: number;
+                regionCount: number;
+                cropAssetCount: number;
+                deskew: {
+                    method: "projection-profile" | "projection-profile-fine";
+                    confidence: number;
+                    applied: boolean;
+                    angleDeg: number;
+                };
+            }, {
+                warnings: string[];
+                score: number;
+                contentCoverageRatio: number;
+                darkPixelRatio: number;
+                regionCoverageRatio: number;
+                regionCount: number;
+                cropAssetCount: number;
+                deskew: {
+                    method: "projection-profile" | "projection-profile-fine";
+                    confidence: number;
+                    applied: boolean;
+                    angleDeg: number;
+                };
+            }>>;
+            regionCount: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
+            cacheStatus: "skipped" | "unavailable" | "hit" | "miss" | "stored";
+            output?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            schemaVersion?: number | undefined;
+            quality?: {
+                warnings: string[];
+                score: number;
+                contentCoverageRatio: number;
+                darkPixelRatio: number;
+                regionCoverageRatio: number;
+                regionCount: number;
+                cropAssetCount: number;
+                deskew: {
+                    method: "projection-profile" | "projection-profile-fine";
+                    confidence: number;
+                    applied: boolean;
+                    angleDeg: number;
+                };
+            } | undefined;
+            regionCount?: number | undefined;
+            transformed?: boolean | undefined;
+            fileHash?: string | undefined;
+            pageHash?: string | undefined;
+            modelVersion?: string | undefined;
+            preprocessingVersion?: string | undefined;
+            pipelineVersion?: string | undefined;
+            policy?: "none" | "ocr-optimized" | "region-v2" | undefined;
+            input?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            operations?: string[] | undefined;
+            cacheKey?: string | undefined;
+        }, {
+            sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
+            cacheStatus: "skipped" | "unavailable" | "hit" | "miss" | "stored";
+            output?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            schemaVersion?: number | undefined;
+            quality?: {
+                warnings: string[];
+                score: number;
+                contentCoverageRatio: number;
+                darkPixelRatio: number;
+                regionCoverageRatio: number;
+                regionCount: number;
+                cropAssetCount: number;
+                deskew: {
+                    method: "projection-profile" | "projection-profile-fine";
+                    confidence: number;
+                    applied: boolean;
+                    angleDeg: number;
+                };
+            } | undefined;
+            regionCount?: number | undefined;
+            transformed?: boolean | undefined;
+            fileHash?: string | undefined;
+            pageHash?: string | undefined;
+            modelVersion?: string | undefined;
+            preprocessingVersion?: string | undefined;
+            pipelineVersion?: string | undefined;
+            policy?: "none" | "ocr-optimized" | "region-v2" | undefined;
+            input?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            operations?: string[] | undefined;
+            cacheKey?: string | undefined;
+        }>>;
+        regions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            source: z.ZodEnum<["layout-ocr", "preprocessing"]>;
+            label: z.ZodString;
+            pageNumber: z.ZodNumber;
+            bbox2d: z.ZodOptional<z.ZodNullable<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>>;
+            coverageRatio: z.ZodOptional<z.ZodNumber>;
+            quality: z.ZodOptional<z.ZodObject<{
+                score: z.ZodNumber;
+                darkPixelRatio: z.ZodNumber;
+                lineDensity: z.ZodNumber;
+                coverageRatio: z.ZodNumber;
+                warnings: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                warnings: string[];
+                score: number;
+                darkPixelRatio: number;
+                coverageRatio: number;
+                lineDensity: number;
+            }, {
+                warnings: string[];
+                score: number;
+                darkPixelRatio: number;
+                coverageRatio: number;
+                lineDensity: number;
+            }>>;
+            textLength: z.ZodNumber;
+            hasText: z.ZodBoolean;
+            asset: z.ZodOptional<z.ZodObject<{
+                mimeType: z.ZodString;
+                byteLength: z.ZodNumber;
+                sha256: z.ZodString;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                normalized: z.ZodOptional<z.ZodBoolean>;
+                cacheRelativePath: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                mimeType: string;
+                byteLength: number;
+                sha256: string;
+                width?: number | undefined;
+                height?: number | undefined;
+                normalized?: boolean | undefined;
+                cacheRelativePath?: string | undefined;
+            }, {
+                mimeType: string;
+                byteLength: number;
+                sha256: string;
+                width?: number | undefined;
+                height?: number | undefined;
+                normalized?: boolean | undefined;
+                cacheRelativePath?: string | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            source: "preprocessing" | "layout-ocr";
+            label: string;
+            id: string;
+            pageNumber: number;
+            textLength: number;
+            hasText: boolean;
+            quality?: {
+                warnings: string[];
+                score: number;
+                darkPixelRatio: number;
+                coverageRatio: number;
+                lineDensity: number;
+            } | undefined;
+            asset?: {
+                mimeType: string;
+                byteLength: number;
+                sha256: string;
+                width?: number | undefined;
+                height?: number | undefined;
+                normalized?: boolean | undefined;
+                cacheRelativePath?: string | undefined;
+            } | undefined;
+            bbox2d?: [number, number, number, number] | null | undefined;
+            coverageRatio?: number | undefined;
+        }, {
+            source: "preprocessing" | "layout-ocr";
+            label: string;
+            id: string;
+            pageNumber: number;
+            textLength: number;
+            hasText: boolean;
+            quality?: {
+                warnings: string[];
+                score: number;
+                darkPixelRatio: number;
+                coverageRatio: number;
+                lineDensity: number;
+            } | undefined;
+            asset?: {
+                mimeType: string;
+                byteLength: number;
+                sha256: string;
+                width?: number | undefined;
+                height?: number | undefined;
+                normalized?: boolean | undefined;
+                cacheRelativePath?: string | undefined;
+            } | undefined;
+            bbox2d?: [number, number, number, number] | null | undefined;
+            coverageRatio?: number | undefined;
+        }>, "many">>;
         counts: z.ZodObject<{
             materials: z.ZodNumber;
             classifications: z.ZodNumber;
@@ -213,6 +499,74 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             parameters: number;
             classifications: number;
         };
+        preprocessing?: {
+            sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
+            cacheStatus: "skipped" | "unavailable" | "hit" | "miss" | "stored";
+            output?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            schemaVersion?: number | undefined;
+            quality?: {
+                warnings: string[];
+                score: number;
+                contentCoverageRatio: number;
+                darkPixelRatio: number;
+                regionCoverageRatio: number;
+                regionCount: number;
+                cropAssetCount: number;
+                deskew: {
+                    method: "projection-profile" | "projection-profile-fine";
+                    confidence: number;
+                    applied: boolean;
+                    angleDeg: number;
+                };
+            } | undefined;
+            regionCount?: number | undefined;
+            transformed?: boolean | undefined;
+            fileHash?: string | undefined;
+            pageHash?: string | undefined;
+            modelVersion?: string | undefined;
+            preprocessingVersion?: string | undefined;
+            pipelineVersion?: string | undefined;
+            policy?: "none" | "ocr-optimized" | "region-v2" | undefined;
+            input?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            operations?: string[] | undefined;
+            cacheKey?: string | undefined;
+        } | undefined;
+        regions?: {
+            source: "preprocessing" | "layout-ocr";
+            label: string;
+            id: string;
+            pageNumber: number;
+            textLength: number;
+            hasText: boolean;
+            quality?: {
+                warnings: string[];
+                score: number;
+                darkPixelRatio: number;
+                coverageRatio: number;
+                lineDensity: number;
+            } | undefined;
+            asset?: {
+                mimeType: string;
+                byteLength: number;
+                sha256: string;
+                width?: number | undefined;
+                height?: number | undefined;
+                normalized?: boolean | undefined;
+                cacheRelativePath?: string | undefined;
+            } | undefined;
+            bbox2d?: [number, number, number, number] | null | undefined;
+            coverageRatio?: number | undefined;
+        }[] | undefined;
         cacheEntryId?: string | undefined;
     }, {
         method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
@@ -229,6 +583,74 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             parameters: number;
             classifications: number;
         };
+        preprocessing?: {
+            sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
+            cacheStatus: "skipped" | "unavailable" | "hit" | "miss" | "stored";
+            output?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            schemaVersion?: number | undefined;
+            quality?: {
+                warnings: string[];
+                score: number;
+                contentCoverageRatio: number;
+                darkPixelRatio: number;
+                regionCoverageRatio: number;
+                regionCount: number;
+                cropAssetCount: number;
+                deskew: {
+                    method: "projection-profile" | "projection-profile-fine";
+                    confidence: number;
+                    applied: boolean;
+                    angleDeg: number;
+                };
+            } | undefined;
+            regionCount?: number | undefined;
+            transformed?: boolean | undefined;
+            fileHash?: string | undefined;
+            pageHash?: string | undefined;
+            modelVersion?: string | undefined;
+            preprocessingVersion?: string | undefined;
+            pipelineVersion?: string | undefined;
+            policy?: "none" | "ocr-optimized" | "region-v2" | undefined;
+            input?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            operations?: string[] | undefined;
+            cacheKey?: string | undefined;
+        } | undefined;
+        regions?: {
+            source: "preprocessing" | "layout-ocr";
+            label: string;
+            id: string;
+            pageNumber: number;
+            textLength: number;
+            hasText: boolean;
+            quality?: {
+                warnings: string[];
+                score: number;
+                darkPixelRatio: number;
+                coverageRatio: number;
+                lineDensity: number;
+            } | undefined;
+            asset?: {
+                mimeType: string;
+                byteLength: number;
+                sha256: string;
+                width?: number | undefined;
+                height?: number | undefined;
+                normalized?: boolean | undefined;
+                cacheRelativePath?: string | undefined;
+            } | undefined;
+            bbox2d?: [number, number, number, number] | null | undefined;
+            coverageRatio?: number | undefined;
+        }[] | undefined;
         cacheEntryId?: string | undefined;
     }>, "many">;
     observations: z.ZodObject<{
@@ -247,13 +669,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             reviewStatus: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
             warnings: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -261,13 +683,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             context?: string | null | undefined;
             numericValue?: number | null | undefined;
         }, {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -290,13 +712,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             reviewStatus: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
             warnings: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -304,13 +726,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             context?: string | null | undefined;
             numericValue?: number | null | undefined;
         }, {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -333,13 +755,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             reviewStatus: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
             warnings: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -347,13 +769,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             context?: string | null | undefined;
             numericValue?: number | null | undefined;
         }, {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -363,13 +785,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         materials: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -378,13 +800,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             numericValue?: number | null | undefined;
         }[];
         parameters: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -393,13 +815,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             numericValue?: number | null | undefined;
         }[];
         classifications: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -409,13 +831,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
         }[];
     }, {
         materials: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -424,13 +846,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             numericValue?: number | null | undefined;
         }[];
         parameters: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -439,13 +861,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             numericValue?: number | null | undefined;
         }[];
         classifications: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -642,14 +1064,82 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             parameters: number;
             classifications: number;
         };
+        preprocessing?: {
+            sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
+            cacheStatus: "skipped" | "unavailable" | "hit" | "miss" | "stored";
+            output?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            schemaVersion?: number | undefined;
+            quality?: {
+                warnings: string[];
+                score: number;
+                contentCoverageRatio: number;
+                darkPixelRatio: number;
+                regionCoverageRatio: number;
+                regionCount: number;
+                cropAssetCount: number;
+                deskew: {
+                    method: "projection-profile" | "projection-profile-fine";
+                    confidence: number;
+                    applied: boolean;
+                    angleDeg: number;
+                };
+            } | undefined;
+            regionCount?: number | undefined;
+            transformed?: boolean | undefined;
+            fileHash?: string | undefined;
+            pageHash?: string | undefined;
+            modelVersion?: string | undefined;
+            preprocessingVersion?: string | undefined;
+            pipelineVersion?: string | undefined;
+            policy?: "none" | "ocr-optimized" | "region-v2" | undefined;
+            input?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            operations?: string[] | undefined;
+            cacheKey?: string | undefined;
+        } | undefined;
+        regions?: {
+            source: "preprocessing" | "layout-ocr";
+            label: string;
+            id: string;
+            pageNumber: number;
+            textLength: number;
+            hasText: boolean;
+            quality?: {
+                warnings: string[];
+                score: number;
+                darkPixelRatio: number;
+                coverageRatio: number;
+                lineDensity: number;
+            } | undefined;
+            asset?: {
+                mimeType: string;
+                byteLength: number;
+                sha256: string;
+                width?: number | undefined;
+                height?: number | undefined;
+                normalized?: boolean | undefined;
+                cacheRelativePath?: string | undefined;
+            } | undefined;
+            bbox2d?: [number, number, number, number] | null | undefined;
+            coverageRatio?: number | undefined;
+        }[] | undefined;
         cacheEntryId?: string | undefined;
     }[];
     document: {
         confidence: number;
+        reviewRequired: boolean;
         title: string | null;
         parseStatus: "failed" | "partial" | "parsed";
         canAutoProceed: boolean;
-        reviewRequired: boolean;
         documentClass: string | null;
         confidenceBreakdown?: {
             schemaVersion: 1;
@@ -674,18 +1164,18 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
     providerContract: {
         reviewGates: string[];
         providerNeutral: true;
-        purpose: "byok-document-understanding";
+        purpose: "document-evidence-contract";
         normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
     };
     observations: {
         materials: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -694,13 +1184,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             numericValue?: number | null | undefined;
         }[];
         parameters: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -709,13 +1199,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             numericValue?: number | null | undefined;
         }[];
         classifications: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -800,14 +1290,82 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             parameters: number;
             classifications: number;
         };
+        preprocessing?: {
+            sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
+            cacheStatus: "skipped" | "unavailable" | "hit" | "miss" | "stored";
+            output?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            schemaVersion?: number | undefined;
+            quality?: {
+                warnings: string[];
+                score: number;
+                contentCoverageRatio: number;
+                darkPixelRatio: number;
+                regionCoverageRatio: number;
+                regionCount: number;
+                cropAssetCount: number;
+                deskew: {
+                    method: "projection-profile" | "projection-profile-fine";
+                    confidence: number;
+                    applied: boolean;
+                    angleDeg: number;
+                };
+            } | undefined;
+            regionCount?: number | undefined;
+            transformed?: boolean | undefined;
+            fileHash?: string | undefined;
+            pageHash?: string | undefined;
+            modelVersion?: string | undefined;
+            preprocessingVersion?: string | undefined;
+            pipelineVersion?: string | undefined;
+            policy?: "none" | "ocr-optimized" | "region-v2" | undefined;
+            input?: {
+                mimeType: string;
+                byteLength: number;
+                width?: number | undefined;
+                height?: number | undefined;
+            } | undefined;
+            operations?: string[] | undefined;
+            cacheKey?: string | undefined;
+        } | undefined;
+        regions?: {
+            source: "preprocessing" | "layout-ocr";
+            label: string;
+            id: string;
+            pageNumber: number;
+            textLength: number;
+            hasText: boolean;
+            quality?: {
+                warnings: string[];
+                score: number;
+                darkPixelRatio: number;
+                coverageRatio: number;
+                lineDensity: number;
+            } | undefined;
+            asset?: {
+                mimeType: string;
+                byteLength: number;
+                sha256: string;
+                width?: number | undefined;
+                height?: number | undefined;
+                normalized?: boolean | undefined;
+                cacheRelativePath?: string | undefined;
+            } | undefined;
+            bbox2d?: [number, number, number, number] | null | undefined;
+            coverageRatio?: number | undefined;
+        }[] | undefined;
         cacheEntryId?: string | undefined;
     }[];
     document: {
         confidence: number;
+        reviewRequired: boolean;
         title: string | null;
         parseStatus: "failed" | "partial" | "parsed";
         canAutoProceed: boolean;
-        reviewRequired: boolean;
         documentClass: string | null;
         confidenceBreakdown?: {
             schemaVersion: 1;
@@ -832,18 +1390,18 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
     providerContract: {
         reviewGates: string[];
         providerNeutral: true;
-        purpose: "byok-document-understanding";
+        purpose: "document-evidence-contract";
         normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
     };
     observations: {
         materials: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -852,13 +1410,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             numericValue?: number | null | undefined;
         }[];
         parameters: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;
@@ -867,13 +1425,13 @@ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
             numericValue?: number | null | undefined;
         }[];
         classifications: {
-            type: "classification" | "parameter" | "material";
+            type: "parameter" | "material" | "classification";
             method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
             value: string | number | boolean | null;
             confidence: number;
+            label: string;
             id: string;
             warnings: string[];
-            label: string;
             sourcePages: number[];
             reviewStatus: "missing" | "verified" | "needs_review" | "uncertain";
             unit?: string | null | undefined;