@geotechcli/core 0.4.44 → 0.4.45

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/dist/agents/brain.d.ts.map +1 -1
  2. package/dist/agents/brain.js +2 -3
  3. package/dist/agents/brain.js.map +1 -1
  4. package/dist/agents/data-tools.js +44 -5
  5. package/dist/agents/data-tools.js.map +1 -1
  6. package/dist/agents/safety.d.ts +1 -0
  7. package/dist/agents/safety.d.ts.map +1 -1
  8. package/dist/agents/safety.js +26 -0
  9. package/dist/agents/safety.js.map +1 -1
  10. package/dist/agents/swarm.d.ts.map +1 -1
  11. package/dist/agents/swarm.js +2 -3
  12. package/dist/agents/swarm.js.map +1 -1
  13. package/dist/ingest/document-evidence-packet.d.ts +777 -0
  14. package/dist/ingest/document-evidence-packet.d.ts.map +1 -0
  15. package/dist/ingest/document-evidence-packet.js +542 -0
  16. package/dist/ingest/document-evidence-packet.js.map +1 -0
  17. package/dist/ingest/geotech-document-benchmark.d.ts +15 -0
  18. package/dist/ingest/geotech-document-benchmark.d.ts.map +1 -1
  19. package/dist/ingest/geotech-document-benchmark.js +18 -0
  20. package/dist/ingest/geotech-document-benchmark.js.map +1 -1
  21. package/dist/ingest/geotech-document.d.ts +2 -0
  22. package/dist/ingest/geotech-document.d.ts.map +1 -1
  23. package/dist/ingest/geotech-document.js +3 -1
  24. package/dist/ingest/geotech-document.js.map +1 -1
  25. package/dist/ingest/index.d.ts +1 -0
  26. package/dist/ingest/index.d.ts.map +1 -1
  27. package/dist/ingest/index.js +1 -0
  28. package/dist/ingest/index.js.map +1 -1
  29. package/dist/ingest/job-worker.d.ts.map +1 -1
  30. package/dist/ingest/job-worker.js +4 -2
  31. package/dist/ingest/job-worker.js.map +1 -1
  32. package/dist/meta/metadata.json +1 -1
  33. package/package.json +1 -1
@@ -0,0 +1,777 @@
1
+ import { z } from 'zod';
2
+ import type { GeotechDocumentIngestResult } from './geotech-document.js';
3
+ export declare const DOCUMENT_EVIDENCE_PACKET_SCHEMA_VERSION = 1;
4
+ export declare const DocumentEvidenceMethodSchema: z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>;
5
+ export declare const DocumentEvidenceReviewStatusSchema: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
6
+ export declare const DocumentEvidenceObservationTypeSchema: z.ZodEnum<["material", "classification", "parameter"]>;
7
+ export declare const DocumentEvidencePacketSchema: z.ZodObject<{
8
+ kind: z.ZodLiteral<"document-evidence-packet">;
9
+ schemaVersion: z.ZodLiteral<1>;
10
+ generatedAt: z.ZodString;
11
+ providerContract: z.ZodObject<{
12
+ providerNeutral: z.ZodLiteral<true>;
13
+ purpose: z.ZodLiteral<"byok-document-understanding">;
14
+ normalizedMethods: z.ZodArray<z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>, "many">;
15
+ reviewGates: z.ZodArray<z.ZodString, "many">;
16
+ }, "strip", z.ZodTypeAny, {
17
+ providerNeutral: true;
18
+ purpose: "byok-document-understanding";
19
+ normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
20
+ reviewGates: string[];
21
+ }, {
22
+ providerNeutral: true;
23
+ purpose: "byok-document-understanding";
24
+ normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
25
+ reviewGates: string[];
26
+ }>;
27
+ source: z.ZodObject<{
28
+ fileName: z.ZodOptional<z.ZodString>;
29
+ filePath: z.ZodOptional<z.ZodString>;
30
+ inputKind: z.ZodEnum<["image", "pdf"]>;
31
+ pageRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
32
+ totalPages: z.ZodNumber;
33
+ successfulPages: z.ZodNumber;
34
+ failedPages: z.ZodNumber;
35
+ }, "strip", z.ZodTypeAny, {
36
+ totalPages: number;
37
+ successfulPages: number;
38
+ failedPages: number;
39
+ inputKind: "image" | "pdf";
40
+ fileName?: string | undefined;
41
+ filePath?: string | undefined;
42
+ pageRange?: [number, number] | undefined;
43
+ }, {
44
+ totalPages: number;
45
+ successfulPages: number;
46
+ failedPages: number;
47
+ inputKind: "image" | "pdf";
48
+ fileName?: string | undefined;
49
+ filePath?: string | undefined;
50
+ pageRange?: [number, number] | undefined;
51
+ }>;
52
+ document: z.ZodObject<{
53
+ title: z.ZodNullable<z.ZodString>;
54
+ documentClass: z.ZodNullable<z.ZodString>;
55
+ parseStatus: z.ZodEnum<["parsed", "partial", "failed"]>;
56
+ confidence: z.ZodNumber;
57
+ reviewRequired: z.ZodBoolean;
58
+ canAutoProceed: z.ZodBoolean;
59
+ }, "strip", z.ZodTypeAny, {
60
+ confidence: number;
61
+ parseStatus: "partial" | "parsed" | "failed";
62
+ canAutoProceed: boolean;
63
+ reviewRequired: boolean;
64
+ documentClass: string | null;
65
+ title: string | null;
66
+ }, {
67
+ confidence: number;
68
+ parseStatus: "partial" | "parsed" | "failed";
69
+ canAutoProceed: boolean;
70
+ reviewRequired: boolean;
71
+ documentClass: string | null;
72
+ title: string | null;
73
+ }>;
74
+ pages: z.ZodArray<z.ZodObject<{
75
+ pageNumber: z.ZodNumber;
76
+ classification: z.ZodNullable<z.ZodString>;
77
+ parseStatus: z.ZodEnum<["parsed", "partial", "failed"]>;
78
+ confidence: z.ZodNumber;
79
+ method: z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>;
80
+ rawSource: z.ZodString;
81
+ sourceCategory: z.ZodEnum<["native-text", "layout-ocr", "vision", "none"]>;
82
+ cacheStatus: z.ZodEnum<["hit", "miss", "stored", "skipped", "unavailable"]>;
83
+ cacheEntryId: z.ZodOptional<z.ZodString>;
84
+ counts: z.ZodObject<{
85
+ materials: z.ZodNumber;
86
+ classifications: z.ZodNumber;
87
+ parameters: z.ZodNumber;
88
+ }, "strip", z.ZodTypeAny, {
89
+ materials: number;
90
+ classifications: number;
91
+ parameters: number;
92
+ }, {
93
+ materials: number;
94
+ classifications: number;
95
+ parameters: number;
96
+ }>;
97
+ warnings: z.ZodArray<z.ZodString, "many">;
98
+ }, "strip", z.ZodTypeAny, {
99
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
100
+ confidence: number;
101
+ warnings: string[];
102
+ classification: string | null;
103
+ pageNumber: number;
104
+ parseStatus: "partial" | "parsed" | "failed";
105
+ rawSource: string;
106
+ sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
107
+ cacheStatus: "unavailable" | "hit" | "miss" | "stored" | "skipped";
108
+ counts: {
109
+ materials: number;
110
+ classifications: number;
111
+ parameters: number;
112
+ };
113
+ cacheEntryId?: string | undefined;
114
+ }, {
115
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
116
+ confidence: number;
117
+ warnings: string[];
118
+ classification: string | null;
119
+ pageNumber: number;
120
+ parseStatus: "partial" | "parsed" | "failed";
121
+ rawSource: string;
122
+ sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
123
+ cacheStatus: "unavailable" | "hit" | "miss" | "stored" | "skipped";
124
+ counts: {
125
+ materials: number;
126
+ classifications: number;
127
+ parameters: number;
128
+ };
129
+ cacheEntryId?: string | undefined;
130
+ }>, "many">;
131
+ observations: z.ZodObject<{
132
+ materials: z.ZodArray<z.ZodObject<{
133
+ id: z.ZodString;
134
+ type: z.ZodEnum<["material", "classification", "parameter"]>;
135
+ label: z.ZodString;
136
+ value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
137
+ numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
138
+ unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
139
+ material: z.ZodOptional<z.ZodNullable<z.ZodString>>;
140
+ context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
141
+ sourcePages: z.ZodArray<z.ZodNumber, "many">;
142
+ method: z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>;
143
+ confidence: z.ZodNumber;
144
+ reviewStatus: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
145
+ warnings: z.ZodArray<z.ZodString, "many">;
146
+ }, "strip", z.ZodTypeAny, {
147
+ type: "classification" | "parameter" | "material";
148
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
149
+ value: string | number | boolean | null;
150
+ confidence: number;
151
+ warnings: string[];
152
+ label: string;
153
+ sourcePages: number[];
154
+ id: string;
155
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
156
+ unit?: string | null | undefined;
157
+ context?: string | null | undefined;
158
+ numericValue?: number | null | undefined;
159
+ material?: string | null | undefined;
160
+ }, {
161
+ type: "classification" | "parameter" | "material";
162
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
163
+ value: string | number | boolean | null;
164
+ confidence: number;
165
+ warnings: string[];
166
+ label: string;
167
+ sourcePages: number[];
168
+ id: string;
169
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
170
+ unit?: string | null | undefined;
171
+ context?: string | null | undefined;
172
+ numericValue?: number | null | undefined;
173
+ material?: string | null | undefined;
174
+ }>, "many">;
175
+ classifications: z.ZodArray<z.ZodObject<{
176
+ id: z.ZodString;
177
+ type: z.ZodEnum<["material", "classification", "parameter"]>;
178
+ label: z.ZodString;
179
+ value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
180
+ numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
181
+ unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
182
+ material: z.ZodOptional<z.ZodNullable<z.ZodString>>;
183
+ context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
184
+ sourcePages: z.ZodArray<z.ZodNumber, "many">;
185
+ method: z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>;
186
+ confidence: z.ZodNumber;
187
+ reviewStatus: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
188
+ warnings: z.ZodArray<z.ZodString, "many">;
189
+ }, "strip", z.ZodTypeAny, {
190
+ type: "classification" | "parameter" | "material";
191
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
192
+ value: string | number | boolean | null;
193
+ confidence: number;
194
+ warnings: string[];
195
+ label: string;
196
+ sourcePages: number[];
197
+ id: string;
198
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
199
+ unit?: string | null | undefined;
200
+ context?: string | null | undefined;
201
+ numericValue?: number | null | undefined;
202
+ material?: string | null | undefined;
203
+ }, {
204
+ type: "classification" | "parameter" | "material";
205
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
206
+ value: string | number | boolean | null;
207
+ confidence: number;
208
+ warnings: string[];
209
+ label: string;
210
+ sourcePages: number[];
211
+ id: string;
212
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
213
+ unit?: string | null | undefined;
214
+ context?: string | null | undefined;
215
+ numericValue?: number | null | undefined;
216
+ material?: string | null | undefined;
217
+ }>, "many">;
218
+ parameters: z.ZodArray<z.ZodObject<{
219
+ id: z.ZodString;
220
+ type: z.ZodEnum<["material", "classification", "parameter"]>;
221
+ label: z.ZodString;
222
+ value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
223
+ numericValue: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
224
+ unit: z.ZodOptional<z.ZodNullable<z.ZodString>>;
225
+ material: z.ZodOptional<z.ZodNullable<z.ZodString>>;
226
+ context: z.ZodOptional<z.ZodNullable<z.ZodString>>;
227
+ sourcePages: z.ZodArray<z.ZodNumber, "many">;
228
+ method: z.ZodEnum<["native-pdf-text", "layout-ocr", "visual-reasoning", "hybrid", "none"]>;
229
+ confidence: z.ZodNumber;
230
+ reviewStatus: z.ZodEnum<["verified", "needs_review", "missing", "uncertain"]>;
231
+ warnings: z.ZodArray<z.ZodString, "many">;
232
+ }, "strip", z.ZodTypeAny, {
233
+ type: "classification" | "parameter" | "material";
234
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
235
+ value: string | number | boolean | null;
236
+ confidence: number;
237
+ warnings: string[];
238
+ label: string;
239
+ sourcePages: number[];
240
+ id: string;
241
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
242
+ unit?: string | null | undefined;
243
+ context?: string | null | undefined;
244
+ numericValue?: number | null | undefined;
245
+ material?: string | null | undefined;
246
+ }, {
247
+ type: "classification" | "parameter" | "material";
248
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
249
+ value: string | number | boolean | null;
250
+ confidence: number;
251
+ warnings: string[];
252
+ label: string;
253
+ sourcePages: number[];
254
+ id: string;
255
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
256
+ unit?: string | null | undefined;
257
+ context?: string | null | undefined;
258
+ numericValue?: number | null | undefined;
259
+ material?: string | null | undefined;
260
+ }>, "many">;
261
+ }, "strip", z.ZodTypeAny, {
262
+ materials: {
263
+ type: "classification" | "parameter" | "material";
264
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
265
+ value: string | number | boolean | null;
266
+ confidence: number;
267
+ warnings: string[];
268
+ label: string;
269
+ sourcePages: number[];
270
+ id: string;
271
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
272
+ unit?: string | null | undefined;
273
+ context?: string | null | undefined;
274
+ numericValue?: number | null | undefined;
275
+ material?: string | null | undefined;
276
+ }[];
277
+ classifications: {
278
+ type: "classification" | "parameter" | "material";
279
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
280
+ value: string | number | boolean | null;
281
+ confidence: number;
282
+ warnings: string[];
283
+ label: string;
284
+ sourcePages: number[];
285
+ id: string;
286
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
287
+ unit?: string | null | undefined;
288
+ context?: string | null | undefined;
289
+ numericValue?: number | null | undefined;
290
+ material?: string | null | undefined;
291
+ }[];
292
+ parameters: {
293
+ type: "classification" | "parameter" | "material";
294
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
295
+ value: string | number | boolean | null;
296
+ confidence: number;
297
+ warnings: string[];
298
+ label: string;
299
+ sourcePages: number[];
300
+ id: string;
301
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
302
+ unit?: string | null | undefined;
303
+ context?: string | null | undefined;
304
+ numericValue?: number | null | undefined;
305
+ material?: string | null | undefined;
306
+ }[];
307
+ }, {
308
+ materials: {
309
+ type: "classification" | "parameter" | "material";
310
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
311
+ value: string | number | boolean | null;
312
+ confidence: number;
313
+ warnings: string[];
314
+ label: string;
315
+ sourcePages: number[];
316
+ id: string;
317
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
318
+ unit?: string | null | undefined;
319
+ context?: string | null | undefined;
320
+ numericValue?: number | null | undefined;
321
+ material?: string | null | undefined;
322
+ }[];
323
+ classifications: {
324
+ type: "classification" | "parameter" | "material";
325
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
326
+ value: string | number | boolean | null;
327
+ confidence: number;
328
+ warnings: string[];
329
+ label: string;
330
+ sourcePages: number[];
331
+ id: string;
332
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
333
+ unit?: string | null | undefined;
334
+ context?: string | null | undefined;
335
+ numericValue?: number | null | undefined;
336
+ material?: string | null | undefined;
337
+ }[];
338
+ parameters: {
339
+ type: "classification" | "parameter" | "material";
340
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
341
+ value: string | number | boolean | null;
342
+ confidence: number;
343
+ warnings: string[];
344
+ label: string;
345
+ sourcePages: number[];
346
+ id: string;
347
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
348
+ unit?: string | null | undefined;
349
+ context?: string | null | undefined;
350
+ numericValue?: number | null | undefined;
351
+ material?: string | null | undefined;
352
+ }[];
353
+ }>;
354
+ contentChunks: z.ZodArray<z.ZodObject<{
355
+ chunkId: z.ZodString;
356
+ pageRange: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
357
+ headingAncestry: z.ZodArray<z.ZodString, "many">;
358
+ scope: z.ZodEnum<["page", "table", "figure", "section"]>;
359
+ sectionType: z.ZodOptional<z.ZodString>;
360
+ significance: z.ZodOptional<z.ZodNumber>;
361
+ sourcePages: z.ZodArray<z.ZodNumber, "many">;
362
+ text: z.ZodString;
363
+ }, "strip", z.ZodTypeAny, {
364
+ text: string;
365
+ sourcePages: number[];
366
+ pageRange: [number, number];
367
+ chunkId: string;
368
+ headingAncestry: string[];
369
+ scope: "table" | "page" | "figure" | "section";
370
+ sectionType?: string | undefined;
371
+ significance?: number | undefined;
372
+ }, {
373
+ text: string;
374
+ sourcePages: number[];
375
+ pageRange: [number, number];
376
+ chunkId: string;
377
+ headingAncestry: string[];
378
+ scope: "table" | "page" | "figure" | "section";
379
+ sectionType?: string | undefined;
380
+ significance?: number | undefined;
381
+ }>, "many">;
382
+ synthesis: z.ZodNullable<z.ZodObject<{
383
+ takeaways: z.ZodArray<z.ZodString, "many">;
384
+ groundModel: z.ZodArray<z.ZodString, "many">;
385
+ keyParameters: z.ZodArray<z.ZodString, "many">;
386
+ interpretation: z.ZodArray<z.ZodString, "many">;
387
+ limitations: z.ZodArray<z.ZodString, "many">;
388
+ sourcePages: z.ZodArray<z.ZodNumber, "many">;
389
+ latencyMs: z.ZodOptional<z.ZodNumber>;
390
+ }, "strip", z.ZodTypeAny, {
391
+ interpretation: string[];
392
+ sourcePages: number[];
393
+ takeaways: string[];
394
+ groundModel: string[];
395
+ keyParameters: string[];
396
+ limitations: string[];
397
+ latencyMs?: number | undefined;
398
+ }, {
399
+ interpretation: string[];
400
+ sourcePages: number[];
401
+ takeaways: string[];
402
+ groundModel: string[];
403
+ keyParameters: string[];
404
+ limitations: string[];
405
+ latencyMs?: number | undefined;
406
+ }>>;
407
+ review: z.ZodObject<{
408
+ warnings: z.ZodArray<z.ZodString, "many">;
409
+ reviewReasons: z.ZodArray<z.ZodString, "many">;
410
+ findings: z.ZodArray<z.ZodObject<{
411
+ code: z.ZodString;
412
+ severity: z.ZodEnum<["advisory", "review", "blocking"]>;
413
+ scope: z.ZodEnum<["document", "page", "material"]>;
414
+ message: z.ZodString;
415
+ pageNumber: z.ZodOptional<z.ZodNumber>;
416
+ materialDescription: z.ZodOptional<z.ZodString>;
417
+ }, "strip", z.ZodTypeAny, {
418
+ message: string;
419
+ code: string;
420
+ severity: "advisory" | "review" | "blocking";
421
+ scope: "document" | "page" | "material";
422
+ pageNumber?: number | undefined;
423
+ materialDescription?: string | undefined;
424
+ }, {
425
+ message: string;
426
+ code: string;
427
+ severity: "advisory" | "review" | "blocking";
428
+ scope: "document" | "page" | "material";
429
+ pageNumber?: number | undefined;
430
+ materialDescription?: string | undefined;
431
+ }>, "many">;
432
+ }, "strip", z.ZodTypeAny, {
433
+ warnings: string[];
434
+ reviewReasons: string[];
435
+ findings: {
436
+ message: string;
437
+ code: string;
438
+ severity: "advisory" | "review" | "blocking";
439
+ scope: "document" | "page" | "material";
440
+ pageNumber?: number | undefined;
441
+ materialDescription?: string | undefined;
442
+ }[];
443
+ }, {
444
+ warnings: string[];
445
+ reviewReasons: string[];
446
+ findings: {
447
+ message: string;
448
+ code: string;
449
+ severity: "advisory" | "review" | "blocking";
450
+ scope: "document" | "page" | "material";
451
+ pageNumber?: number | undefined;
452
+ materialDescription?: string | undefined;
453
+ }[];
454
+ }>;
455
+ traceability: z.ZodObject<{
456
+ sourcePages: z.ZodArray<z.ZodNumber, "many">;
457
+ pagesWithEvidence: z.ZodArray<z.ZodNumber, "many">;
458
+ directVisualPages: z.ZodArray<z.ZodNumber, "many">;
459
+ layoutOcrPages: z.ZodArray<z.ZodNumber, "many">;
460
+ nativeTextPages: z.ZodArray<z.ZodNumber, "many">;
461
+ boreholeIds: z.ZodArray<z.ZodString, "many">;
462
+ maxDepthMeters: z.ZodNullable<z.ZodNumber>;
463
+ parametersWithSourcePage: z.ZodNumber;
464
+ parametersWithoutSourcePage: z.ZodNumber;
465
+ parameterTraceabilityRate: z.ZodNumber;
466
+ methodCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
467
+ }, "strip", z.ZodTypeAny, {
468
+ sourcePages: number[];
469
+ pagesWithEvidence: number[];
470
+ directVisualPages: number[];
471
+ layoutOcrPages: number[];
472
+ nativeTextPages: number[];
473
+ boreholeIds: string[];
474
+ maxDepthMeters: number | null;
475
+ parametersWithSourcePage: number;
476
+ parametersWithoutSourcePage: number;
477
+ parameterTraceabilityRate: number;
478
+ methodCounts: Record<string, number>;
479
+ }, {
480
+ sourcePages: number[];
481
+ pagesWithEvidence: number[];
482
+ directVisualPages: number[];
483
+ layoutOcrPages: number[];
484
+ nativeTextPages: number[];
485
+ boreholeIds: string[];
486
+ maxDepthMeters: number | null;
487
+ parametersWithSourcePage: number;
488
+ parametersWithoutSourcePage: number;
489
+ parameterTraceabilityRate: number;
490
+ methodCounts: Record<string, number>;
491
+ }>;
492
+ }, "strip", z.ZodTypeAny, {
493
+ kind: "document-evidence-packet";
494
+ source: {
495
+ totalPages: number;
496
+ successfulPages: number;
497
+ failedPages: number;
498
+ inputKind: "image" | "pdf";
499
+ fileName?: string | undefined;
500
+ filePath?: string | undefined;
501
+ pageRange?: [number, number] | undefined;
502
+ };
503
+ pages: {
504
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
505
+ confidence: number;
506
+ warnings: string[];
507
+ classification: string | null;
508
+ pageNumber: number;
509
+ parseStatus: "partial" | "parsed" | "failed";
510
+ rawSource: string;
511
+ sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
512
+ cacheStatus: "unavailable" | "hit" | "miss" | "stored" | "skipped";
513
+ counts: {
514
+ materials: number;
515
+ classifications: number;
516
+ parameters: number;
517
+ };
518
+ cacheEntryId?: string | undefined;
519
+ }[];
520
+ review: {
521
+ warnings: string[];
522
+ reviewReasons: string[];
523
+ findings: {
524
+ message: string;
525
+ code: string;
526
+ severity: "advisory" | "review" | "blocking";
527
+ scope: "document" | "page" | "material";
528
+ pageNumber?: number | undefined;
529
+ materialDescription?: string | undefined;
530
+ }[];
531
+ };
532
+ document: {
533
+ confidence: number;
534
+ parseStatus: "partial" | "parsed" | "failed";
535
+ canAutoProceed: boolean;
536
+ reviewRequired: boolean;
537
+ documentClass: string | null;
538
+ title: string | null;
539
+ };
540
+ schemaVersion: 1;
541
+ generatedAt: string;
542
+ providerContract: {
543
+ providerNeutral: true;
544
+ purpose: "byok-document-understanding";
545
+ normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
546
+ reviewGates: string[];
547
+ };
548
+ observations: {
549
+ materials: {
550
+ type: "classification" | "parameter" | "material";
551
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
552
+ value: string | number | boolean | null;
553
+ confidence: number;
554
+ warnings: string[];
555
+ label: string;
556
+ sourcePages: number[];
557
+ id: string;
558
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
559
+ unit?: string | null | undefined;
560
+ context?: string | null | undefined;
561
+ numericValue?: number | null | undefined;
562
+ material?: string | null | undefined;
563
+ }[];
564
+ classifications: {
565
+ type: "classification" | "parameter" | "material";
566
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
567
+ value: string | number | boolean | null;
568
+ confidence: number;
569
+ warnings: string[];
570
+ label: string;
571
+ sourcePages: number[];
572
+ id: string;
573
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
574
+ unit?: string | null | undefined;
575
+ context?: string | null | undefined;
576
+ numericValue?: number | null | undefined;
577
+ material?: string | null | undefined;
578
+ }[];
579
+ parameters: {
580
+ type: "classification" | "parameter" | "material";
581
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
582
+ value: string | number | boolean | null;
583
+ confidence: number;
584
+ warnings: string[];
585
+ label: string;
586
+ sourcePages: number[];
587
+ id: string;
588
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
589
+ unit?: string | null | undefined;
590
+ context?: string | null | undefined;
591
+ numericValue?: number | null | undefined;
592
+ material?: string | null | undefined;
593
+ }[];
594
+ };
595
+ contentChunks: {
596
+ text: string;
597
+ sourcePages: number[];
598
+ pageRange: [number, number];
599
+ chunkId: string;
600
+ headingAncestry: string[];
601
+ scope: "table" | "page" | "figure" | "section";
602
+ sectionType?: string | undefined;
603
+ significance?: number | undefined;
604
+ }[];
605
+ synthesis: {
606
+ interpretation: string[];
607
+ sourcePages: number[];
608
+ takeaways: string[];
609
+ groundModel: string[];
610
+ keyParameters: string[];
611
+ limitations: string[];
612
+ latencyMs?: number | undefined;
613
+ } | null;
614
+ traceability: {
615
+ sourcePages: number[];
616
+ pagesWithEvidence: number[];
617
+ directVisualPages: number[];
618
+ layoutOcrPages: number[];
619
+ nativeTextPages: number[];
620
+ boreholeIds: string[];
621
+ maxDepthMeters: number | null;
622
+ parametersWithSourcePage: number;
623
+ parametersWithoutSourcePage: number;
624
+ parameterTraceabilityRate: number;
625
+ methodCounts: Record<string, number>;
626
+ };
627
+ }, {
628
+ kind: "document-evidence-packet";
629
+ source: {
630
+ totalPages: number;
631
+ successfulPages: number;
632
+ failedPages: number;
633
+ inputKind: "image" | "pdf";
634
+ fileName?: string | undefined;
635
+ filePath?: string | undefined;
636
+ pageRange?: [number, number] | undefined;
637
+ };
638
+ pages: {
639
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
640
+ confidence: number;
641
+ warnings: string[];
642
+ classification: string | null;
643
+ pageNumber: number;
644
+ parseStatus: "partial" | "parsed" | "failed";
645
+ rawSource: string;
646
+ sourceCategory: "vision" | "none" | "native-text" | "layout-ocr";
647
+ cacheStatus: "unavailable" | "hit" | "miss" | "stored" | "skipped";
648
+ counts: {
649
+ materials: number;
650
+ classifications: number;
651
+ parameters: number;
652
+ };
653
+ cacheEntryId?: string | undefined;
654
+ }[];
655
+ review: {
656
+ warnings: string[];
657
+ reviewReasons: string[];
658
+ findings: {
659
+ message: string;
660
+ code: string;
661
+ severity: "advisory" | "review" | "blocking";
662
+ scope: "document" | "page" | "material";
663
+ pageNumber?: number | undefined;
664
+ materialDescription?: string | undefined;
665
+ }[];
666
+ };
667
+ document: {
668
+ confidence: number;
669
+ parseStatus: "partial" | "parsed" | "failed";
670
+ canAutoProceed: boolean;
671
+ reviewRequired: boolean;
672
+ documentClass: string | null;
673
+ title: string | null;
674
+ };
675
+ schemaVersion: 1;
676
+ generatedAt: string;
677
+ providerContract: {
678
+ providerNeutral: true;
679
+ purpose: "byok-document-understanding";
680
+ normalizedMethods: ("none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid")[];
681
+ reviewGates: string[];
682
+ };
683
+ observations: {
684
+ materials: {
685
+ type: "classification" | "parameter" | "material";
686
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
687
+ value: string | number | boolean | null;
688
+ confidence: number;
689
+ warnings: string[];
690
+ label: string;
691
+ sourcePages: number[];
692
+ id: string;
693
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
694
+ unit?: string | null | undefined;
695
+ context?: string | null | undefined;
696
+ numericValue?: number | null | undefined;
697
+ material?: string | null | undefined;
698
+ }[];
699
+ classifications: {
700
+ type: "classification" | "parameter" | "material";
701
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
702
+ value: string | number | boolean | null;
703
+ confidence: number;
704
+ warnings: string[];
705
+ label: string;
706
+ sourcePages: number[];
707
+ id: string;
708
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
709
+ unit?: string | null | undefined;
710
+ context?: string | null | undefined;
711
+ numericValue?: number | null | undefined;
712
+ material?: string | null | undefined;
713
+ }[];
714
+ parameters: {
715
+ type: "classification" | "parameter" | "material";
716
+ method: "none" | "native-pdf-text" | "layout-ocr" | "visual-reasoning" | "hybrid";
717
+ value: string | number | boolean | null;
718
+ confidence: number;
719
+ warnings: string[];
720
+ label: string;
721
+ sourcePages: number[];
722
+ id: string;
723
+ reviewStatus: "verified" | "needs_review" | "missing" | "uncertain";
724
+ unit?: string | null | undefined;
725
+ context?: string | null | undefined;
726
+ numericValue?: number | null | undefined;
727
+ material?: string | null | undefined;
728
+ }[];
729
+ };
730
+ contentChunks: {
731
+ text: string;
732
+ sourcePages: number[];
733
+ pageRange: [number, number];
734
+ chunkId: string;
735
+ headingAncestry: string[];
736
+ scope: "table" | "page" | "figure" | "section";
737
+ sectionType?: string | undefined;
738
+ significance?: number | undefined;
739
+ }[];
740
+ synthesis: {
741
+ interpretation: string[];
742
+ sourcePages: number[];
743
+ takeaways: string[];
744
+ groundModel: string[];
745
+ keyParameters: string[];
746
+ limitations: string[];
747
+ latencyMs?: number | undefined;
748
+ } | null;
749
+ traceability: {
750
+ sourcePages: number[];
751
+ pagesWithEvidence: number[];
752
+ directVisualPages: number[];
753
+ layoutOcrPages: number[];
754
+ nativeTextPages: number[];
755
+ boreholeIds: string[];
756
+ maxDepthMeters: number | null;
757
+ parametersWithSourcePage: number;
758
+ parametersWithoutSourcePage: number;
759
+ parameterTraceabilityRate: number;
760
+ methodCounts: Record<string, number>;
761
+ };
762
+ }>;
763
+ export type DocumentEvidenceMethod = z.infer<typeof DocumentEvidenceMethodSchema>;
764
+ export type DocumentEvidencePacket = z.infer<typeof DocumentEvidencePacketSchema>;
765
+ export type DocumentEvidenceReviewStatus = z.infer<typeof DocumentEvidenceReviewStatusSchema>;
766
+ export interface SummarizeDocumentEvidencePacketForAgentOptions {
767
+ maxObservationsPerGroup?: number;
768
+ maxReviewGates?: number;
769
+ maxContentChars?: number;
770
+ }
771
+ export declare function buildDocumentEvidencePacket(result: GeotechDocumentIngestResult): DocumentEvidencePacket;
772
+ export declare function attachDocumentEvidencePacket<T extends GeotechDocumentIngestResult>(result: T): T & {
773
+ evidencePacket: DocumentEvidencePacket;
774
+ };
775
+ export declare function summarizeDocumentEvidencePacketForAgent(packet: DocumentEvidencePacket, options?: SummarizeDocumentEvidencePacketForAgentOptions): string;
776
+ export declare function summarizeGeotechDocumentResultForAgent(result: GeotechDocumentIngestResult, options?: SummarizeDocumentEvidencePacketForAgentOptions): string;
777
+ //# sourceMappingURL=document-evidence-packet.d.ts.map