@geotechcli/core 0.4.22 → 0.4.23

package/dist/ingest/document-inputs.js

@@ -0,0 +1,197 @@
+import { readFileSync } from 'node:fs';
+import { extname } from 'node:path';
+import { PDFDocument } from 'pdf-lib';
+import { extractPrimaryPdfPageImages, renderPdfPageImage, } from './pdf.js';
+const MIME_TYPES = {
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    png: 'image/png',
+    gif: 'image/gif',
+    webp: 'image/webp',
+    pdf: 'application/pdf',
+};
+const PROVIDER_SAFE_IMAGE_MIME_TYPES = new Set([
+    'image/jpeg',
+    'image/png',
+    'image/gif',
+    'image/webp',
+]);
+export function readDocumentVisionInput(filePath) {
+    const buffer = readFileSync(filePath);
+    const ext = extname(filePath).slice(1).toLowerCase();
+    const kind = ext === 'pdf' ? 'pdf' : MIME_TYPES[ext] ? 'image' : 'unknown';
+    return {
+        base64: buffer.toString('base64'),
+        mimeType: MIME_TYPES[ext] ?? 'image/png',
+        fileBytes: buffer.length,
+        filePath,
+        ext,
+        kind,
+    };
+}
+export async function countDocumentPdfPages(filePath) {
+    const buffer = readFileSync(filePath);
+    const quickCount = buffer
+        .toString('latin1')
+        .match(/\/Type\s*\/Page(?!s)\b/g)?.length ?? 0;
+    if (quickCount > 0) {
+        return quickCount;
+    }
+    const source = await PDFDocument.load(buffer, { ignoreEncryption: true });
+    return source.getPageCount();
+}
+function extFromMimeType(mimeType) {
+    switch (mimeType) {
+        case 'image/jpeg':
+            return 'jpg';
+        case 'image/png':
+            return 'png';
+        case 'image/gif':
+            return 'gif';
+        case 'image/webp':
+            return 'webp';
+        default:
+            return 'bin';
+    }
+}
+function imageBufferMatchesMimeType(buffer, mimeType) {
+    const bytes = Buffer.from(buffer);
+    if (bytes.length < 12) {
+        return false;
+    }
+    switch (mimeType) {
+        case 'image/png':
+            return bytes.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A]));
+        case 'image/jpeg':
+            return bytes[0] === 0xFF && bytes[1] === 0xD8;
+        case 'image/gif':
+            return bytes.subarray(0, 6).toString('ascii') === 'GIF87a'
+                || bytes.subarray(0, 6).toString('ascii') === 'GIF89a';
+        case 'image/webp':
+            return bytes.subarray(0, 4).toString('ascii') === 'RIFF'
+                && bytes.subarray(8, 12).toString('ascii') === 'WEBP';
+        default:
+            return false;
+    }
+}
+function isProviderSafeRasterImage(image) {
+    return PROVIDER_SAFE_IMAGE_MIME_TYPES.has(image.mimeType)
+        && imageBufferMatchesMimeType(image.data, image.mimeType);
+}
+function createDocumentPdfPageNormalizedArtifact(input) {
+    return {
+        kind: input.kind,
+        source: input.source,
+        mimeType: input.mimeType,
+        fileBytes: input.fileBytes,
+        textSource: input.inspectionArtifact?.textSource ?? 'none',
+        textQuality: input.inspectionArtifact?.textQuality ?? null,
+        warnings: [
+            ...new Set([
+                ...(input.inspectionArtifact?.warnings ?? []),
+                ...(input.warnings ?? []),
+            ]),
+        ],
+    };
+}
+export async function readDocumentPdfPageInputs(filePath, options) {
+    const buffer = readFileSync(filePath);
+    const source = await PDFDocument.load(buffer, { ignoreEncryption: true });
+    const totalPages = source.getPageCount();
+    const extractPageImages = options?.dependencies?.extractPageImages ?? extractPrimaryPdfPageImages;
+    const renderPageImage = options?.dependencies?.renderPageImage ?? renderPdfPageImage;
+    const shouldAttemptRasterExtraction = options?.preferExtractedPageImages !== false
+        && options?.inspection != null;
+    const extractedImages = !shouldAttemptRasterExtraction
+        ? []
+        : await extractPageImages(buffer);
+    const extractedImageByPage = new Map(extractedImages.map((image) => [image.pageNumber, image]));
+    const pageInputs = [];
+    for (let index = 0; index < totalPages; index++) {
+        const pageNumber = index + 1;
+        const inspectionPage = options?.inspection?.pages[index];
+        const extractedImage = extractedImageByPage.get(pageNumber);
+        const shouldPreferRasterImage = inspectionPage?.classification === 'image-only'
+            || inspectionPage?.classification === 'text-unreadable'
+            || inspectionPage?.normalizedArtifact?.textSource === 'native-text-low-quality';
+        if (shouldPreferRasterImage) {
+            const rasterWarnings = [];
+            if (extractedImage) {
+                if (isProviderSafeRasterImage(extractedImage)) {
+                    pageInputs.push({
+                        base64: Buffer.from(extractedImage.data).toString('base64'),
+                        mimeType: extractedImage.mimeType,
+                        fileBytes: extractedImage.byteLength,
+                        filePath,
+                        ext: extFromMimeType(extractedImage.mimeType),
+                        kind: 'image',
+                        pageNumber,
+                        totalPages,
+                        sourceKind: 'raster-image',
+                        normalizedArtifact: createDocumentPdfPageNormalizedArtifact({
+                            kind: 'image',
+                            source: 'xobject-raster',
+                            mimeType: extractedImage.mimeType,
+                            fileBytes: extractedImage.byteLength,
+                            inspectionArtifact: inspectionPage?.normalizedArtifact,
+                            warnings: extractedImage.warnings,
+                        }),
+                    });
+                    continue;
+                }
+                rasterWarnings.push(`Extracted raster image for page ${pageNumber} was not a provider-safe ${extractedImage.mimeType} payload, so the full page was rerendered to PNG.`);
+            }
+            const renderedPage = await renderPageImage(buffer, pageNumber);
+            if (renderedPage) {
+                pageInputs.push({
+                    base64: Buffer.from(renderedPage.data).toString('base64'),
+                    mimeType: renderedPage.mimeType,
+                    fileBytes: renderedPage.byteLength,
+                    filePath,
+                    ext: extFromMimeType(renderedPage.mimeType),
+                    kind: 'image',
+                    pageNumber,
+                    totalPages,
+                    sourceKind: 'raster-image',
+                    normalizedArtifact: createDocumentPdfPageNormalizedArtifact({
+                        kind: 'image',
+                        source: 'full-page-raster',
+                        mimeType: renderedPage.mimeType,
+                        fileBytes: renderedPage.byteLength,
+                        inspectionArtifact: inspectionPage?.normalizedArtifact,
+                        warnings: [...rasterWarnings, ...renderedPage.warnings],
+                    }),
+                });
+                continue;
+            }
+        }
+        const pageDoc = await PDFDocument.create();
+        const [copiedPage] = await pageDoc.copyPages(source, [index]);
+        pageDoc.addPage(copiedPage);
+        const pageBytes = await pageDoc.save();
+        const pageBuffer = Buffer.from(pageBytes);
+        pageInputs.push({
+            base64: pageBuffer.toString('base64'),
+            mimeType: 'application/pdf',
+            fileBytes: pageBuffer.length,
+            filePath,
+            ext: 'pdf',
+            kind: 'pdf',
+            pageNumber,
+            totalPages,
+            sourceKind: 'pdf-page',
+            normalizedArtifact: createDocumentPdfPageNormalizedArtifact({
+                kind: 'pdf',
+                source: 'native-pdf-page',
+                mimeType: 'application/pdf',
+                fileBytes: pageBuffer.length,
+                inspectionArtifact: inspectionPage?.normalizedArtifact,
+                warnings: shouldPreferRasterImage && extractedImage && !isProviderSafeRasterImage(extractedImage)
+                    ? [`Extracted raster image for page ${pageNumber} could not be normalized into a provider-safe image payload, so the job fell back to a native PDF page.`]
+                    : [],
+            }),
+        });
+    }
+    return pageInputs;
+}
+//# sourceMappingURL=document-inputs.js.map

package/dist/ingest/document-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-inputs.js","sourceRoot":"","sources":["../../src/ingest/document-inputs.ts"],"names":[],"mappings":"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"}

package/dist/ingest/geotech-document.d.ts

@@ -0,0 +1,118 @@
+import type { LLMConfig } from '../llm/types.js';
+import { extractGeotechDocumentFactsFromText, interpretGeotechDocumentPage, type GeotechDocumentClassification, type GeotechDocumentInsight, type GeotechMaterialObservation, type GeotechParameterObservation, type ParseStatus } from '../vision/geotech-document.js';
+import { transcribeDocumentImageText } from '../vision/index.js';
+import { type DocumentTextHintSource } from '../vision/ocr.js';
+import type { PdfDocumentInspection, PdfPageClassification } from './pdf.js';
+export interface GeotechDocumentVisionInput {
+    base64: string;
+    mimeType: string;
+    fileBytes?: number;
+}
+export interface GeotechDocumentPageInput extends GeotechDocumentVisionInput {
+    pageNumber: number;
+    totalPages: number;
+    sourceKind?: 'pdf-page' | 'raster-image';
+    filePath?: string;
+}
+export interface GeotechDocumentSource {
+    filePath?: string;
+    fileName?: string;
+    inputKind: 'image' | 'pdf';
+}
+export interface GeotechDocumentPageAudit {
+    pageNumber: number;
+    classification: PdfPageClassification | null;
+    textHintSource: DocumentTextHintSource;
+    parseStatus: ParseStatus;
+    confidence: number;
+    materialCount: number;
+    classificationCount: number;
+    parameterCount: number;
+    warnings: string[];
+}
+export type GeotechDocumentFindingSeverity = 'advisory' | 'review' | 'blocking';
+export type GeotechDocumentFindingScope = 'document' | 'page' | 'material';
+export interface GeotechDocumentFinding {
+    code: string;
+    severity: GeotechDocumentFindingSeverity;
+    scope: GeotechDocumentFindingScope;
+    message: string;
+    pageNumber?: number;
+    materialDescription?: string;
+}
+export interface GeotechDocumentInspectionSummary {
+    pageClassificationCounts: Partial<Record<PdfPageClassification, number>>;
+    imageHeavyPageCount: number;
+    nativeTextPageCount: number;
+    degradedPageCount: number;
+    ocrRecoveredPageCount: number;
+}
+export interface GeotechDocumentIngestResult {
+    kind: 'geotech-ingest-result';
+    schemaVersion: 1;
+    documentType: 'geotech-document';
+    generatedAt: string;
+    source: GeotechDocumentSource & {
+        totalPages: number;
+        successfulPages: number;
+        failedPages: number;
+    };
+    inspection: PdfDocumentInspection | null;
+    inspectionSummary: GeotechDocumentInspectionSummary | null;
+    documentClass: string | null;
+    title: string | null;
+    summary: string | null;
+    materials: GeotechMaterialObservation[];
+    classifications: GeotechDocumentClassification[];
+    parameters: GeotechParameterObservation[];
+    risks: string[];
+    recommendations: string[];
+    contentChunks?: GeotechDocumentContentChunk[];
+    pageAudits: GeotechDocumentPageAudit[];
+    pageFailures: string[];
+    warnings: string[];
+    reviewFindings: GeotechDocumentFinding[];
+    reviewReasons: string[];
+    parseStatus: ParseStatus;
+    confidence: number;
+    reviewRequired: boolean;
+    canAutoProceed: boolean;
+}
+export interface GeotechDocumentContentChunk {
+    chunkId: string;
+    pageRange: [number, number];
+    headingAncestry: string[];
+    scope: 'page' | 'table' | 'figure' | 'section';
+    sectionType?: GeotechDocumentSectionType;
+    significance?: number;
+    text: string;
+    sourcePages: number[];
+}
+export type GeotechDocumentSectionType = 'administrative' | 'summary' | 'ground-model' | 'laboratory' | 'classification' | 'groundwater' | 'recommendation' | 'visual-appendix' | 'general';
+export interface IngestGeotechDocumentOptions {
+    config: LLMConfig;
+    source: GeotechDocumentSource;
+    inspection?: PdfDocumentInspection | null;
+    image?: GeotechDocumentVisionInput;
+    pages?: GeotechDocumentPageInput[];
+    interpretPage?: typeof interpretGeotechDocumentPage;
+    extractTextFacts?: typeof extractGeotechDocumentFactsFromText;
+    transcribePageImageText?: typeof transcribeDocumentImageText;
+    pageConcurrency?: number;
+    now?: () => Date;
+}
+export declare function inferPreflightLowYieldPageRole(input: {
+    inspectionPage: PdfDocumentInspection['pages'][number] | undefined;
+    previousInspectionPage?: PdfDocumentInspection['pages'][number] | undefined;
+    pageNumber?: number | null;
+    totalPages?: number | null;
+    sourceKind?: GeotechDocumentPageInput['sourceKind'];
+}): GeotechDocumentSectionType | null;
+export declare function buildPreflightLowYieldInsight(input: {
+    role: GeotechDocumentSectionType;
+    inspectionPage: PdfDocumentInspection['pages'][number];
+    pageNumber: number;
+    totalPages: number;
+}): GeotechDocumentInsight;
+export declare function ingestGeotechDocument(options: IngestGeotechDocumentOptions): Promise<GeotechDocumentIngestResult>;
+//# sourceMappingURL=geotech-document.d.ts.map

package/dist/ingest/geotech-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geotech-document.d.ts","sourceRoot":"","sources":["../../src/ingest/geotech-document.ts"],"names":[],"mappings":"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"}