@geotechcli/core 0.4.44 → 0.4.46

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

@@ -0,0 +1,814 @@
+import { z } from 'zod';
+import type { GeotechDocumentIngestResult } from './geotech-document.js';
+export declare const DOCUMENT_EVIDENCE_PACKET_SCHEMA_VERSION = 2;
+export declare const DocumentEvidenceMethodSchema: z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>;
+export declare const DocumentEvidenceReviewStatusSchema: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
+export declare const DocumentEvidenceObservationTypeSchema: z.ZodEnum<["material", "classification", "parameter"]>;
+export declare const DocumentEvidencePacketSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"document-evidence-packet">;
+    schemaVersion: z.ZodLiteral<2>;
+    generatedAt: z.ZodString;
+    providerContract: z.ZodObject<{
+        providerNeutral: z.ZodLiteral<true>;
+        purpose: z.ZodLiteral<"byok-document-understanding">;
+        normalizedMethods: z.ZodArray<z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>, "many">;
+        reviewGates: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        providerNeutral: true;
+        purpose: "byok-document-understanding";
+        normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
+        reviewGates: string[];
+    }, {
+        providerNeutral: true;
+        purpose: "byok-document-understanding";
+        normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
+        reviewGates: string[];
+    }>;
+    source: z.ZodObject<{
+        fileName: z.ZodOptional<z.ZodString>;
+        filePath: z.ZodOptional<z.ZodString>;
+        inputKind: z.ZodEnum<["image", "pdf"]>;
+        pageRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        totalPages: z.ZodNumber;
+        successfulPages: z.ZodNumber;
+        failedPages: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        totalPages: number;
+        successfulPages: number;
+        failedPages: number;
+        inputKind: "image" | "pdf";
+        fileName?: string | undefined;
+        filePath?: string | undefined;
+        pageRange?: [number, number] | undefined;
+    }, {
+        totalPages: number;
+        successfulPages: number;
+        failedPages: number;
+        inputKind: "image" | "pdf";
+        fileName?: string | undefined;
+        filePath?: string | undefined;
+        pageRange?: [number, number] | undefined;
+    }>;
+    document: z.ZodObject<{
+        title: z.ZodNullable<z.ZodString>;
+        documentClass: z.ZodNullable<z.ZodString>;
+        parseStatus: z.ZodEnum<["parsed", "partial", "failed"]>;
+        confidence: z.ZodNumber;
+        reviewRequired: z.ZodBoolean;
+        canAutoProceed: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        confidence: number;
+        parseStatus: "partial" | "parsed" | "failed";
+        canAutoProceed: boolean;
+        reviewRequired: boolean;
+        documentClass: string | null;
+        title: string | null;
+    }, {
+        confidence: number;
+        parseStatus: "partial" | "parsed" | "failed";
+        canAutoProceed: boolean;
+        reviewRequired: boolean;
+        documentClass: string | null;
+        title: string | null;
+    }>;
+    pages: z.ZodArray<z.ZodObject<{
+        pageNumber: z.ZodNumber;
+        classification: z.ZodNullable<z.ZodString>;
+        parseStatus: z.ZodEnum<["parsed", "partial", "failed"]>;
+        confidence: z.ZodNumber;
+        method: z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>;
+        rawSource: z.ZodString;
+        sourceCategory: z.ZodEnum<["native-text", "layout-ocr", "vision", "none"]>;
+        cacheStatus: z.ZodEnum<["hit", "miss", "stored", "skipped", "unavailable"]>;
+        cacheEntryId: z.ZodOptional<z.ZodString>;
+        counts: z.ZodObject<{
+            materials: z.ZodNumber;
+            classifications: z.ZodNumber;
+            parameters: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            materials: number;
+            classifications: number;
+            parameters: number;
+        }, {
+            materials: number;
+            classifications: number;
+            parameters: number;
+        }>;
+        warnings: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+        confidence: number;
+        warnings: string[];
+        classification: string | null;
+        pageNumber: number;
+        parseStatus: "partial" | "parsed" | "failed";
+        rawSource: string;
+        sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
+        cacheStatus: "unavailable" | "hit" | "miss" | "stored" | "skipped";
+        counts: {
+            materials: number;
+            classifications: number;
+            parameters: number;
+        };
+        cacheEntryId?: string | undefined;
+    }, {
+        method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+        confidence: number;
+        warnings: string[];
+        classification: string | null;
+        pageNumber: number;
+        parseStatus: "partial" | "parsed" | "failed";
+        rawSource: string;
+        sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
+        cacheStatus: "unavailable" | "hit" | "miss" | "stored" | "skipped";
+        counts: {
+            materials: number;
+            classifications: number;
+            parameters: number;
+        };
+        cacheEntryId?: string | undefined;
+    }>, "many">;
+    observations: z.ZodObject<{
+        materials: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<["material", "classification", "parameter"]>;
+            label: z.ZodString;
+            value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            material: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            sourcePages: z.ZodArray<z.ZodNumber, "many">;
+            method: z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>;
+            confidence: z.ZodNumber;
+            reviewStatus: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
+            warnings: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }, {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }>, "many">;
+        classifications: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<["material", "classification", "parameter"]>;
+            label: z.ZodString;
+            value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            material: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            sourcePages: z.ZodArray<z.ZodNumber, "many">;
+            method: z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>;
+            confidence: z.ZodNumber;
+            reviewStatus: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
+            warnings: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }, {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }>, "many">;
+        parameters: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<["material", "classification", "parameter"]>;
+            label: z.ZodString;
+            value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+            numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            material: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            sourcePages: z.ZodArray<z.ZodNumber, "many">;
+            method: z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>;
+            confidence: z.ZodNumber;
+            reviewStatus: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
+            warnings: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }, {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        materials: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+        classifications: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+        parameters: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+    }, {
+        materials: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+        classifications: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+        parameters: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+    }>;
+    contentChunks: z.ZodArray<z.ZodObject<{
+        chunkId: z.ZodString;
+        pageRange: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        headingAncestry: z.ZodArray<z.ZodString, "many">;
+        scope: z.ZodEnum<["page", "table", "figure", "section"]>;
+        sectionType: z.ZodOptional<z.ZodString>;
+        significance: z.ZodOptional<z.ZodNumber>;
+        sourcePages: z.ZodArray<z.ZodNumber, "many">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        sourcePages: number[];
+        pageRange: [number, number];
+        chunkId: string;
+        headingAncestry: string[];
+        scope: "table" | "page" | "figure" | "section";
+        sectionType?: string | undefined;
+        significance?: number | undefined;
+    }, {
+        text: string;
+        sourcePages: number[];
+        pageRange: [number, number];
+        chunkId: string;
+        headingAncestry: string[];
+        scope: "table" | "page" | "figure" | "section";
+        sectionType?: string | undefined;
+        significance?: number | undefined;
+    }>, "many">;
+    engineeringSignals: z.ZodObject<{
+        risks: z.ZodArray<z.ZodString, "many">;
+        recommendations: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        recommendations: string[];
+        risks: string[];
+    }, {
+        recommendations: string[];
+        risks: string[];
+    }>;
+    synthesis: z.ZodNullable<z.ZodObject<{
+        takeaways: z.ZodArray<z.ZodString, "many">;
+        groundModel: z.ZodArray<z.ZodString, "many">;
+        keyParameters: z.ZodArray<z.ZodString, "many">;
+        interpretation: z.ZodArray<z.ZodString, "many">;
+        limitations: z.ZodArray<z.ZodString, "many">;
+        sourcePages: z.ZodArray<z.ZodNumber, "many">;
+        latencyMs: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        interpretation: string[];
+        sourcePages: number[];
+        takeaways: string[];
+        groundModel: string[];
+        keyParameters: string[];
+        limitations: string[];
+        latencyMs?: number | undefined;
+    }, {
+        interpretation: string[];
+        sourcePages: number[];
+        takeaways: string[];
+        groundModel: string[];
+        keyParameters: string[];
+        limitations: string[];
+        latencyMs?: number | undefined;
+    }>>;
+    review: z.ZodObject<{
+        warnings: z.ZodArray<z.ZodString, "many">;
+        reviewReasons: z.ZodArray<z.ZodString, "many">;
+        findings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            severity: z.ZodEnum<["advisory", "review", "blocking"]>;
+            scope: z.ZodEnum<["document", "page", "material"]>;
+            message: z.ZodString;
+            pageNumber: z.ZodOptional<z.ZodNumber>;
+            materialDescription: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            code: string;
+            severity: "advisory" | "review" | "blocking";
+            scope: "document" | "page" | "material";
+            pageNumber?: number | undefined;
+            materialDescription?: string | undefined;
+        }, {
+            message: string;
+            code: string;
+            severity: "advisory" | "review" | "blocking";
+            scope: "document" | "page" | "material";
+            pageNumber?: number | undefined;
+            materialDescription?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        warnings: string[];
+        reviewReasons: string[];
+        findings: {
+            message: string;
+            code: string;
+            severity: "advisory" | "review" | "blocking";
+            scope: "document" | "page" | "material";
+            pageNumber?: number | undefined;
+            materialDescription?: string | undefined;
+        }[];
+    }, {
+        warnings: string[];
+        reviewReasons: string[];
+        findings: {
+            message: string;
+            code: string;
+            severity: "advisory" | "review" | "blocking";
+            scope: "document" | "page" | "material";
+            pageNumber?: number | undefined;
+            materialDescription?: string | undefined;
+        }[];
+    }>;
+    traceability: z.ZodObject<{
+        sourcePages: z.ZodArray<z.ZodNumber, "many">;
+        pagesWithEvidence: z.ZodArray<z.ZodNumber, "many">;
+        directVisualPages: z.ZodArray<z.ZodNumber, "many">;
+        layoutOcrPages: z.ZodArray<z.ZodNumber, "many">;
+        nativeTextPages: z.ZodArray<z.ZodNumber, "many">;
+        boreholeIds: z.ZodArray<z.ZodString, "many">;
+        maxDepthMeters: z.ZodNullable<z.ZodNumber>;
+        parametersWithSourcePage: z.ZodNumber;
+        parametersWithoutSourcePage: z.ZodNumber;
+        parameterTraceabilityRate: z.ZodNumber;
+        methodCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        sourcePages: number[];
+        pagesWithEvidence: number[];
+        directVisualPages: number[];
+        layoutOcrPages: number[];
+        nativeTextPages: number[];
+        boreholeIds: string[];
+        maxDepthMeters: number | null;
+        parametersWithSourcePage: number;
+        parametersWithoutSourcePage: number;
+        parameterTraceabilityRate: number;
+        methodCounts: Record<string, number>;
+    }, {
+        sourcePages: number[];
+        pagesWithEvidence: number[];
+        directVisualPages: number[];
+        layoutOcrPages: number[];
+        nativeTextPages: number[];
+        boreholeIds: string[];
+        maxDepthMeters: number | null;
+        parametersWithSourcePage: number;
+        parametersWithoutSourcePage: number;
+        parameterTraceabilityRate: number;
+        methodCounts: Record<string, number>;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    kind: "document-evidence-packet";
+    source: {
+        totalPages: number;
+        successfulPages: number;
+        failedPages: number;
+        inputKind: "image" | "pdf";
+        fileName?: string | undefined;
+        filePath?: string | undefined;
+        pageRange?: [number, number] | undefined;
+    };
+    pages: {
+        method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+        confidence: number;
+        warnings: string[];
+        classification: string | null;
+        pageNumber: number;
+        parseStatus: "partial" | "parsed" | "failed";
+        rawSource: string;
+        sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
+        cacheStatus: "unavailable" | "hit" | "miss" | "stored" | "skipped";
+        counts: {
+            materials: number;
+            classifications: number;
+            parameters: number;
+        };
+        cacheEntryId?: string | undefined;
+    }[];
+    review: {
+        warnings: string[];
+        reviewReasons: string[];
+        findings: {
+            message: string;
+            code: string;
+            severity: "advisory" | "review" | "blocking";
+            scope: "document" | "page" | "material";
+            pageNumber?: number | undefined;
+            materialDescription?: string | undefined;
+        }[];
+    };
+    document: {
+        confidence: number;
+        parseStatus: "partial" | "parsed" | "failed";
+        canAutoProceed: boolean;
+        reviewRequired: boolean;
+        documentClass: string | null;
+        title: string | null;
+    };
+    schemaVersion: 2;
+    generatedAt: string;
+    providerContract: {
+        providerNeutral: true;
+        purpose: "byok-document-understanding";
+        normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
+        reviewGates: string[];
+    };
+    observations: {
+        materials: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+        classifications: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+        parameters: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+    };
+    contentChunks: {
+        text: string;
+        sourcePages: number[];
+        pageRange: [number, number];
+        chunkId: string;
+        headingAncestry: string[];
+        scope: "table" | "page" | "figure" | "section";
+        sectionType?: string | undefined;
+        significance?: number | undefined;
+    }[];
+    engineeringSignals: {
+        recommendations: string[];
+        risks: string[];
+    };
+    synthesis: {
+        interpretation: string[];
+        sourcePages: number[];
+        takeaways: string[];
+        groundModel: string[];
+        keyParameters: string[];
+        limitations: string[];
+        latencyMs?: number | undefined;
+    } | null;
+    traceability: {
+        sourcePages: number[];
+        pagesWithEvidence: number[];
+        directVisualPages: number[];
+        layoutOcrPages: number[];
+        nativeTextPages: number[];
+        boreholeIds: string[];
+        maxDepthMeters: number | null;
+        parametersWithSourcePage: number;
+        parametersWithoutSourcePage: number;
+        parameterTraceabilityRate: number;
+        methodCounts: Record<string, number>;
+    };
+}, {
+    kind: "document-evidence-packet";
+    source: {
+        totalPages: number;
+        successfulPages: number;
+        failedPages: number;
+        inputKind: "image" | "pdf";
+        fileName?: string | undefined;
+        filePath?: string | undefined;
+        pageRange?: [number, number] | undefined;
+    };
+    pages: {
+        method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+        confidence: number;
+        warnings: string[];
+        classification: string | null;
+        pageNumber: number;
+        parseStatus: "partial" | "parsed" | "failed";
+        rawSource: string;
+        sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
+        cacheStatus: "unavailable" | "hit" | "miss" | "stored" | "skipped";
+        counts: {
+            materials: number;
+            classifications: number;
+            parameters: number;
+        };
+        cacheEntryId?: string | undefined;
+    }[];
+    review: {
+        warnings: string[];
+        reviewReasons: string[];
+        findings: {
+            message: string;
+            code: string;
+            severity: "advisory" | "review" | "blocking";
+            scope: "document" | "page" | "material";
+            pageNumber?: number | undefined;
+            materialDescription?: string | undefined;
+        }[];
+    };
+    document: {
+        confidence: number;
+        parseStatus: "partial" | "parsed" | "failed";
+        canAutoProceed: boolean;
+        reviewRequired: boolean;
+        documentClass: string | null;
+        title: string | null;
+    };
+    schemaVersion: 2;
+    generatedAt: string;
+    providerContract: {
+        providerNeutral: true;
+        purpose: "byok-document-understanding";
+        normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
+        reviewGates: string[];
+    };
+    observations: {
+        materials: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+        classifications: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+        parameters: {
+            type: "classification" | "parameter" | "material";
+            method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
+            value: string | number | boolean | null;
+            confidence: number;
+            warnings: string[];
+            label: string;
+            sourcePages: number[];
+            id: string;
+            reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
+            unit?: string | null | undefined;
+            context?: string | null | undefined;
+            numericValue?: number | null | undefined;
+            material?: string | null | undefined;
+        }[];
+    };
+    contentChunks: {
+        text: string;
+        sourcePages: number[];
+        pageRange: [number, number];
+        chunkId: string;
+        headingAncestry: string[];
+        scope: "table" | "page" | "figure" | "section";
+        sectionType?: string | undefined;
+        significance?: number | undefined;
+    }[];
+    engineeringSignals: {
+        recommendations: string[];
+        risks: string[];
+    };
+    synthesis: {
+        interpretation: string[];
+        sourcePages: number[];
+        takeaways: string[];
+        groundModel: string[];
+        keyParameters: string[];
+        limitations: string[];
+        latencyMs?: number | undefined;
+    } | null;
+    traceability: {
+        sourcePages: number[];
+        pagesWithEvidence: number[];
+        directVisualPages: number[];
+        layoutOcrPages: number[];
+        nativeTextPages: number[];
+        boreholeIds: string[];
+        maxDepthMeters: number | null;
+        parametersWithSourcePage: number;
+        parametersWithoutSourcePage: number;
+        parameterTraceabilityRate: number;
+        methodCounts: Record<string, number>;
+    };
+}>;
+export type DocumentEvidenceMethod = z.infer<typeof DocumentEvidenceMethodSchema>;
+export type DocumentEvidencePacket = z.infer<typeof DocumentEvidencePacketSchema>;
+export type DocumentEvidenceReviewStatus = z.infer<typeof DocumentEvidenceReviewStatusSchema>;
+export interface SummarizeDocumentEvidencePacketForAgentOptions {
+    maxObservationsPerGroup?: number;
+    maxReviewGates?: number;
+    maxContentChars?: number;
+}
+export interface CompileDocumentEvidenceSynthesisPromptOptions {
+    maxEvidenceChars?: number;
+    maxOutlineChunks?: number;
+    maxHighSignalChunks?: number;
+    maxParameters?: number;
+    maxMaterials?: number;
+    maxClassifications?: number;
+}
+export interface CompiledDocumentEvidenceSynthesisPrompt {
+    systemPrompt: string;
+    prompt: string;
+    evidence: string;
+    hasEngineeringSignal: boolean;
+    sourcePages: number[];
+    reviewGates: string[];
+    schemaVersion: number;
+}
+export declare function buildDocumentEvidencePacket(result: GeotechDocumentIngestResult): DocumentEvidencePacket;
+export declare function attachDocumentEvidencePacket<T extends GeotechDocumentIngestResult>(result: T): T & {
+    evidencePacket: DocumentEvidencePacket;
+};
+export declare function documentEvidencePacketHasEngineeringSignal(packet: DocumentEvidencePacket): boolean;
+export declare function compileDocumentEvidenceSynthesisPrompt(packet: DocumentEvidencePacket, options?: CompileDocumentEvidenceSynthesisPromptOptions): CompiledDocumentEvidenceSynthesisPrompt;
+export declare function summarizeDocumentEvidencePacketForAgent(packet: DocumentEvidencePacket, options?: SummarizeDocumentEvidencePacketForAgentOptions): string;
+export declare function summarizeGeotechDocumentResultForAgent(result: GeotechDocumentIngestResult, options?: SummarizeDocumentEvidencePacketForAgentOptions): string;
+//# sourceMappingURL=document-evidence-packet.d.ts.map