ocr-provenance-mcp 1.0.0

package/dist/services/provenance/verifier.js

@@ -0,0 +1,536 @@
+/**
+ * ProvenanceVerifier - Hash integrity and chain verification
+ *
+ * Constitution Compliance:
+ * - CP-003: Immutable Hash Verification
+ * - CP-001: Complete Provenance Chain
+ *
+ * FAIL FAST: All errors throw immediately
+ * NO MOCKS: Tests use real DatabaseService
+ */
+import fs from 'fs';
+import { ProvenanceErrorCode } from './tracker.js';
+import { ProvenanceType } from '../../models/provenance.js';
+import { computeHash, hashFile, isValidHashFormat } from '../../utils/hash.js';
+import { rowToDocument, rowToOCRResult, rowToChunk, rowToEmbedding, rowToProvenance, rowToImage, } from '../storage/database/converters.js';
+/** Error codes for verifier operations */
+export const VerifierErrorCode = {
+    ...ProvenanceErrorCode,
+    INTEGRITY_FAILED: 'INTEGRITY_VERIFICATION_FAILED',
+    CONTENT_NOT_FOUND: 'CONTENT_NOT_FOUND',
+    FILE_NOT_FOUND: 'SOURCE_FILE_NOT_FOUND',
+    HASH_FORMAT_INVALID: 'HASH_FORMAT_INVALID',
+};
+/**
+ * VerifierError - Typed error for verification operations
+ * FAIL FAST: Always throw with detailed error information
+ */
+export class VerifierError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'VerifierError';
+        Object.setPrototypeOf(this, VerifierError.prototype);
+    }
+}
+/**
+ * ProvenanceVerifier - Hash integrity and chain verification
+ *
+ * Provides verification for:
+ * 1. Single provenance record content hash
+ * 2. Complete provenance chain integrity
+ * 3. Database-wide verification
+ * 4. Source file integrity
+ */
+export class ProvenanceVerifier {
+    db;
+    tracker;
+    rawDb;
+    constructor(db, tracker) {
+        this.db = db;
+        this.tracker = tracker;
+        this.rawDb = db.getConnection();
+    }
+    /**
+     * Verify content hash for a single provenance record
+     *
+     * @param provenanceId - Provenance record ID to verify
+     * @returns Verification result with computed and expected hashes
+     * @throws VerifierError if provenance not found, content not found, or file not accessible
+     */
+    async verifyContentHash(provenanceId) {
+        // Get provenance record - throws if not found
+        const record = this.tracker.getProvenanceById(provenanceId);
+        // Get content and expected hash based on type
+        const { content, expectedHash, isFile } = this.getContentForVerification(record);
+        // Validate expected hash format
+        const formatValid = isValidHashFormat(expectedHash);
+        // Compute hash of content
+        let computedHash;
+        if (isFile && typeof content === 'string') {
+            // For files, content is the file path - hash the file
+            computedHash = await hashFile(content);
+        }
+        else {
+            // For text content, compute hash directly
+            computedHash = computeHash(content);
+        }
+        const valid = formatValid && computedHash === expectedHash;
+        return {
+            valid,
+            item_id: provenanceId,
+            item_type: record.type,
+            expected_hash: expectedHash,
+            computed_hash: computedHash,
+            format_valid: formatValid,
+            verified_at: new Date().toISOString(),
+        };
+    }
+    /**
+     * Verify complete provenance chain from item to root
+     *
+     * @param provenanceId - Starting provenance record ID
+     * @returns Chain verification result with all failing items
+     * @throws VerifierError if chain broken or item not found
+     */
+    async verifyChain(provenanceId) {
+        // Get chain using tracker - throws if not found
+        const chain = this.tracker.getProvenanceChain(provenanceId);
+        const failedItems = [];
+        let hashesVerified = 0;
+        let hashesFailed = 0;
+        // Verify each record in the chain: current + ancestors
+        const allRecords = [chain.current, ...chain.ancestors];
+        for (const record of allRecords) {
+            try {
+                const result = await this.verifyContentHash(record.id);
+                if (result.valid) {
+                    hashesVerified++;
+                }
+                else {
+                    hashesFailed++;
+                    failedItems.push({
+                        id: record.id,
+                        expected_hash: result.expected_hash,
+                        computed_hash: result.computed_hash,
+                        type: record.type,
+                    });
+                }
+            }
+            catch (error) {
+                // Content not found or file not accessible - count as failure
+                hashesFailed++;
+                failedItems.push({
+                    id: record.id,
+                    expected_hash: record.content_hash,
+                    computed_hash: 'ERROR: ' + (error instanceof Error ? error.message : 'Unknown error'),
+                    type: record.type,
+                });
+            }
+        }
+        const valid = hashesFailed === 0 && chain.isComplete;
+        return {
+            valid,
+            chain_intact: chain.isComplete,
+            hashes_verified: hashesVerified,
+            hashes_failed: hashesFailed,
+            failed_items: failedItems,
+            verified_at: new Date().toISOString(),
+            start_id: provenanceId,
+            chain_depth: chain.depth,
+            root_document_id: chain.root.root_document_id,
+            chain_length: allRecords.length,
+        };
+    }
+    /**
+     * Verify all provenance records in database
+     *
+     * @returns Database verification result with counts by type
+     */
+    async verifyDatabase() {
+        const startTime = Date.now();
+        const allProvenance = this.getAllProvenance();
+        // H-6: Cap failedItems to prevent unbounded memory growth
+        const MAX_FAILED_ITEMS = 1000;
+        const failedItems = [];
+        let failedOverflow = 0;
+        let hashesVerified = 0;
+        let hashesFailed = 0;
+        let documentsVerified = 0;
+        let ocrResultsVerified = 0;
+        let chunksVerified = 0;
+        let embeddingsVerified = 0;
+        let imagesVerified = 0;
+        let vlmDescriptionsVerified = 0;
+        for (const record of allProvenance) {
+            try {
+                const result = await this.verifyContentHash(record.id);
+                // Count by type
+                switch (record.type) {
+                    case ProvenanceType.DOCUMENT:
+                        documentsVerified++;
+                        break;
+                    case ProvenanceType.OCR_RESULT:
+                        ocrResultsVerified++;
+                        break;
+                    case ProvenanceType.CHUNK:
+                        chunksVerified++;
+                        break;
+                    case ProvenanceType.EMBEDDING:
+                        embeddingsVerified++;
+                        break;
+                    case ProvenanceType.IMAGE:
+                        imagesVerified++;
+                        break;
+                    case ProvenanceType.VLM_DESCRIPTION:
+                        vlmDescriptionsVerified++;
+                        break;
+                }
+                if (result.valid) {
+                    hashesVerified++;
+                }
+                else {
+                    hashesFailed++;
+                    if (failedItems.length < MAX_FAILED_ITEMS) {
+                        failedItems.push({
+                            id: record.id,
+                            expected_hash: result.expected_hash,
+                            computed_hash: result.computed_hash,
+                            type: record.type,
+                        });
+                    }
+                    else {
+                        failedOverflow++;
+                    }
+                }
+            }
+            catch (error) {
+                hashesFailed++;
+                if (failedItems.length < MAX_FAILED_ITEMS) {
+                    failedItems.push({
+                        id: record.id,
+                        expected_hash: record.content_hash,
+                        computed_hash: 'ERROR: ' + (error instanceof Error ? error.message : 'Unknown error'),
+                        type: record.type,
+                    });
+                }
+                else {
+                    failedOverflow++;
+                }
+            }
+        }
+        const durationMs = Date.now() - startTime;
+        // Chain integrity check: verify all parent_id references exist and depths are correct
+        let chainIntact = true;
+        const chainErrors = [];
+        const parentedRecords = this.rawDb
+            .prepare(`SELECT id, parent_id, type, chain_depth FROM provenance WHERE parent_id IS NOT NULL`)
+            .all();
+        for (const record of parentedRecords) {
+            const parent = this.rawDb
+                .prepare('SELECT id, chain_depth FROM provenance WHERE id = ?')
+                .get(record.parent_id);
+            if (!parent) {
+                chainIntact = false;
+                if (chainErrors.length < 10) {
+                    chainErrors.push(`${record.id} (${record.type}): parent ${record.parent_id} not found`);
+                }
+            }
+            else if (parent.chain_depth !== record.chain_depth - 1) {
+                chainIntact = false;
+                if (chainErrors.length < 10) {
+                    chainErrors.push(`${record.id} (${record.type}): depth ${record.chain_depth} but parent depth ${parent.chain_depth} (expected ${record.chain_depth - 1})`);
+                }
+            }
+        }
+        return {
+            valid: hashesFailed === 0 && chainIntact,
+            chain_intact: chainIntact,
+            chain_errors: chainErrors.length > 0 ? chainErrors : undefined,
+            hashes_verified: hashesVerified,
+            hashes_failed: hashesFailed,
+            failed_items: failedItems,
+            verified_at: new Date().toISOString(),
+            database_name: this.getDatabaseName(),
+            documents_verified: documentsVerified,
+            ocr_results_verified: ocrResultsVerified,
+            chunks_verified: chunksVerified,
+            embeddings_verified: embeddingsVerified,
+            images_verified: imagesVerified,
+            vlm_descriptions_verified: vlmDescriptionsVerified,
+            duration_ms: durationMs,
+            failed_overflow: failedOverflow,
+        };
+    }
+    /**
+     * Verify source file still matches stored hash
+     *
+     * @param documentId - Document ID to verify
+     * @returns Verification result for the file
+     * @throws VerifierError if document not found or file not accessible
+     */
+    async verifyFileIntegrity(documentId) {
+        // Get document
+        const doc = this.db.getDocument(documentId);
+        if (!doc) {
+            throw new VerifierError(`Document not found: ${documentId}`, VerifierErrorCode.NOT_FOUND, {
+                documentId,
+            });
+        }
+        // Check file exists
+        if (!fs.existsSync(doc.file_path)) {
+            throw new VerifierError(`Source file not found: ${doc.file_path}`, VerifierErrorCode.FILE_NOT_FOUND, { documentId, filePath: doc.file_path });
+        }
+        // Hash the file
+        const computedHash = await hashFile(doc.file_path);
+        const expectedHash = doc.file_hash;
+        const formatValid = isValidHashFormat(expectedHash);
+        const valid = formatValid && computedHash === expectedHash;
+        return {
+            valid,
+            item_id: documentId,
+            item_type: ProvenanceType.DOCUMENT,
+            expected_hash: expectedHash,
+            computed_hash: computedHash,
+            format_valid: formatValid,
+            verified_at: new Date().toISOString(),
+        };
+    }
+    // ════════════════════════════════════════════════════════════════
+    // PRIVATE HELPER METHODS
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * Get content and expected hash for a provenance record
+     * Returns { content, expectedHash, isFile } or throws if content not found
+     *
+     * CRITICAL MAPPING:
+     * - DOCUMENT: file_path → file_hash (via hashFile)
+     * - OCR_RESULT: extracted_text → content_hash
+     * - CHUNK: text → text_hash
+     * - EMBEDDING: original_text → content_hash
+     */
+    getContentForVerification(record) {
+        switch (record.type) {
+            case ProvenanceType.DOCUMENT: {
+                // For DOCUMENT, we verify the file on disk using file_hash
+                // Query document by provenance_id since record.id IS the document's provenance_id
+                const doc = this.getDocumentByProvenanceId(record.id);
+                if (!doc) {
+                    throw new VerifierError(`Document not found for provenance ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, type: record.type });
+                }
+                // Check file exists
+                if (!fs.existsSync(doc.file_path)) {
+                    throw new VerifierError(`Source file not found: ${doc.file_path}`, VerifierErrorCode.FILE_NOT_FOUND, { provenanceId: record.id, filePath: doc.file_path });
+                }
+                // Return file path - caller will hash the file
+                return { content: doc.file_path, expectedHash: doc.file_hash, isFile: true };
+            }
+            case ProvenanceType.OCR_RESULT: {
+                const ocr = this.getOCRResultByProvenanceId(record.id);
+                if (!ocr) {
+                    throw new VerifierError(`OCR result not found for provenance ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, type: record.type });
+                }
+                return { content: ocr.extracted_text, expectedHash: ocr.content_hash, isFile: false };
+            }
+            case ProvenanceType.CHUNK: {
+                const chunk = this.getChunkByProvenanceId(record.id);
+                if (!chunk) {
+                    throw new VerifierError(`Chunk not found for provenance ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, type: record.type });
+                }
+                // CRITICAL: CHUNK uses text_hash, not content_hash
+                return { content: chunk.text, expectedHash: chunk.text_hash, isFile: false };
+            }
+            case ProvenanceType.EMBEDDING: {
+                const emb = this.getEmbeddingByProvenanceId(record.id);
+                if (!emb) {
+                    throw new VerifierError(`Embedding not found for provenance ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, type: record.type });
+                }
+                return { content: emb.original_text, expectedHash: emb.content_hash, isFile: false };
+            }
+            case ProvenanceType.IMAGE: {
+                // IMAGE verification: hash the extracted image file
+                const image = this.getImageByProvenanceId(record.id);
+                if (!image) {
+                    throw new VerifierError(`Image not found for provenance ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, type: record.type });
+                }
+                // Check extracted file exists
+                if (!image.extracted_path || !fs.existsSync(image.extracted_path)) {
+                    throw new VerifierError(`Extracted image file not found: ${image.extracted_path}`, VerifierErrorCode.FILE_NOT_FOUND, { provenanceId: record.id, imagePath: image.extracted_path });
+                }
+                // Return file path - caller will hash the file
+                return { content: image.extracted_path, expectedHash: record.content_hash, isFile: true };
+            }
+            case ProvenanceType.VLM_DESCRIPTION: {
+                // VLM_DESCRIPTION verification: hash the VLM description text
+                // The description is stored in images.vlm_description, but we need to find it
+                // via the provenance chain - the parent should be an IMAGE
+                // Get the parent IMAGE to find the VLM description
+                if (!record.parent_id) {
+                    throw new VerifierError(`VLM_DESCRIPTION has no parent_id: ${record.id}`, VerifierErrorCode.CHAIN_BROKEN, { provenanceId: record.id });
+                }
+                const image = this.getImageByProvenanceId(record.parent_id);
+                if (!image) {
+                    throw new VerifierError(`Parent image not found for VLM_DESCRIPTION ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, parentId: record.parent_id });
+                }
+                if (!image.vlm_description) {
+                    throw new VerifierError(`VLM description is empty for image ${image.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, imageId: image.id });
+                }
+                return { content: image.vlm_description, expectedHash: record.content_hash, isFile: false };
+            }
+            case ProvenanceType.COMPARISON: {
+                const comparison = this.rawDb
+                    .prepare('SELECT text_diff_json, structural_diff_json FROM comparisons WHERE provenance_id = ?')
+                    .get(record.id);
+                if (!comparison) {
+                    throw new VerifierError(`Comparison not found for provenance ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id });
+                }
+                const parseDiffField = (json, field) => {
+                    try {
+                        return JSON.parse(json);
+                    }
+                    catch (error) {
+                        console.error(`[ProvenanceVerifier] Failed to parse ${field} JSON for provenance ${record.id}:`, error instanceof Error ? error.message : String(error));
+                        throw new VerifierError(`Corrupt ${field} in comparison for provenance ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, field });
+                    }
+                };
+                const diffContent = JSON.stringify({
+                    text_diff: parseDiffField(comparison.text_diff_json, 'text_diff_json'),
+                    structural_diff: parseDiffField(comparison.structural_diff_json, 'structural_diff_json'),
+                });
+                return { content: diffContent, expectedHash: record.content_hash, isFile: false };
+            }
+            case ProvenanceType.EXTRACTION: {
+                // EXTRACTION: content_hash = computeHash(JSON.stringify(extractionJson))
+                // Re-derive: Load extraction record and hash its extraction_json field
+                const extraction = this.rawDb
+                    .prepare('SELECT extraction_json FROM extractions WHERE provenance_id = ?')
+                    .get(record.id);
+                if (!extraction) {
+                    throw new VerifierError(`Extraction not found for provenance ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, type: record.type });
+                }
+                // The hash was computed over JSON.stringify(response.extractionJson) which was
+                // stored as extraction_json. Re-hash the stored string directly.
+                return {
+                    content: extraction.extraction_json,
+                    expectedHash: record.content_hash,
+                    isFile: false,
+                };
+            }
+            case ProvenanceType.FORM_FILL: {
+                // FORM_FILL: content_hash = computeHash(JSON.stringify({ fields_filled, fields_not_found }))
+                // Re-derive: Load from form_fills table, reconstruct the same object
+                const formFill = this.rawDb
+                    .prepare('SELECT fields_filled, fields_not_found FROM form_fills WHERE provenance_id = ?')
+                    .get(record.id);
+                if (!formFill) {
+                    throw new VerifierError(`Form fill not found for provenance ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, type: record.type });
+                }
+                // Reconstruct the exact object that was hashed: { fields_filled, fields_not_found }
+                // The original code hashes: computeHash(JSON.stringify({ fields_filled: result.fieldsFilled, fields_not_found: result.fieldsNotFound }))
+                // form_fills stores these as JSON strings, so parse them back to arrays
+                const formFillContent = JSON.stringify({
+                    fields_filled: JSON.parse(formFill.fields_filled),
+                    fields_not_found: JSON.parse(formFill.fields_not_found),
+                });
+                return { content: formFillContent, expectedHash: record.content_hash, isFile: false };
+            }
+            case ProvenanceType.CLUSTERING: {
+                // CLUSTERING: content_hash = computeHash(JSON.stringify(centroid) + ':' + runId)
+                // Re-derive: Load cluster record and reconstruct the same input
+                const cluster = this.rawDb
+                    .prepare('SELECT centroid_json, run_id FROM clusters WHERE provenance_id = ?')
+                    .get(record.id);
+                if (!cluster) {
+                    throw new VerifierError(`Cluster not found for provenance ${record.id}`, VerifierErrorCode.CONTENT_NOT_FOUND, { provenanceId: record.id, type: record.type });
+                }
+                // The original hash: computeHash(JSON.stringify(centroid) + ':' + runId)
+                // centroid_json is already JSON.stringify(centroid), so use it directly
+                const clusterContent = cluster.centroid_json + ':' + cluster.run_id;
+                return { content: clusterContent, expectedHash: record.content_hash, isFile: false };
+            }
+            default: {
+                const unknownType = record.type;
+                throw new VerifierError(`Unknown provenance type: ${unknownType}`, VerifierErrorCode.INVALID_TYPE, { type: unknownType });
+            }
+        }
+    }
+    // ════════════════════════════════════════════════════════════════
+    // RAW SQL HELPERS (methods not in DatabaseService)
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * Get document by its provenance_id
+     */
+    getDocumentByProvenanceId(provenanceId) {
+        const row = this.rawDb
+            .prepare('SELECT * FROM documents WHERE provenance_id = ?')
+            .get(provenanceId);
+        return row ? rowToDocument(row) : null;
+    }
+    /**
+     * Get OCR result by its provenance_id
+     */
+    getOCRResultByProvenanceId(provenanceId) {
+        const row = this.rawDb
+            .prepare('SELECT * FROM ocr_results WHERE provenance_id = ?')
+            .get(provenanceId);
+        return row ? rowToOCRResult(row) : null;
+    }
+    /**
+     * Get chunk by its provenance_id
+     */
+    getChunkByProvenanceId(provenanceId) {
+        const row = this.rawDb
+            .prepare('SELECT * FROM chunks WHERE provenance_id = ?')
+            .get(provenanceId);
+        return row ? rowToChunk(row) : null;
+    }
+    /**
+     * Get embedding by its provenance_id (without vector)
+     */
+    getEmbeddingByProvenanceId(provenanceId) {
+        const row = this.rawDb
+            .prepare('SELECT * FROM embeddings WHERE provenance_id = ?')
+            .get(provenanceId);
+        return row ? rowToEmbedding(row) : null;
+    }
+    /**
+     * Get image by its provenance_id
+     */
+    getImageByProvenanceId(provenanceId) {
+        const row = this.rawDb
+            .prepare('SELECT * FROM images WHERE provenance_id = ?')
+            .get(provenanceId);
+        return row ? rowToImage(row) : null;
+    }
+    /**
+     * Get all provenance records ordered by chain_depth
+     */
+    getAllProvenance() {
+        // H-6: Use iterate() to avoid double-allocation (.all() + .map())
+        const records = [];
+        const stmt = this.rawDb.prepare('SELECT * FROM provenance ORDER BY chain_depth ASC');
+        for (const row of stmt.iterate()) {
+            records.push(rowToProvenance(row));
+        }
+        return records;
+    }
+    /**
+     * Get database name from metadata
+     */
+    getDatabaseName() {
+        try {
+            const row = this.rawDb
+                .prepare('SELECT database_name FROM database_metadata LIMIT 1')
+                .get();
+            return row?.database_name ?? 'unknown';
+        }
+        catch (error) {
+            console.error(`[Verifier] Failed to get database name from metadata: ${String(error)}`);
+            return 'unknown';
+        }
+    }
+}
+//# sourceMappingURL=verifier.js.map

package/dist/services/provenance/verifier.js.map

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

package/dist/services/python-pool.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Python Worker Process Pool
+ *
+ * Maintains warm Python processes to amortize import costs (torch, transformers).
+ * Workers accept JSON commands on stdin, return JSON on stdout.
+ * Auto-restart on crash, health checks via heartbeat.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is JSON-RPC protocol.
+ *
+ * @module services/python-pool
+ */
+import { EventEmitter } from 'events';
+export interface PoolConfig {
+    /** Number of worker processes to maintain (default: 3) */
+    poolSize: number;
+    /** Restart worker after this many tasks (default: 100) */
+    maxTasksPerWorker: number;
+    /** Health check interval in ms (default: 30000) */
+    healthCheckIntervalMs: number;
+    /** Task timeout in ms (default: 120000) */
+    taskTimeoutMs: number;
+}
+export interface PoolStatus {
+    total: number;
+    busy: number;
+    idle: number;
+    queued: number;
+}
+export declare class PythonPool extends EventEmitter {
+    private workers;
+    private taskQueue;
+    private readonly config;
+    private healthCheckTimer;
+    private nextWorkerId;
+    private shuttingDown;
+    private readonly pythonCommand;
+    constructor(config?: Partial<PoolConfig>);
+    /**
+     * Start the pool with the given Python script.
+     *
+     * @param scriptPath - Path to the Python worker script
+     * @throws Error if pool is shutting down
+     */
+    start(scriptPath: string): void;
+    /**
+     * Execute a command on the next available worker.
+     *
+     * If all workers are busy, the task is queued and dispatched when
+     * a worker becomes available.
+     *
+     * @param command - JSON-serializable command object
+     * @returns Promise resolving with the worker's JSON response
+     * @throws Error if pool is shutting down or task times out
+     */
+    execute(command: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Shut down all workers and reject queued tasks.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get pool status for diagnostics.
+     */
+    getStatus(): PoolStatus;
+    private spawnWorker;
+    private getAvailableWorker;
+    private dispatchTask;
+    private processQueue;
+    private healthCheck;
+}
+//# sourceMappingURL=python-pool.d.ts.map

package/dist/services/python-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-pool.d.ts","sourceRoot":"","sources":["../../src/services/python-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;CACvB;AAiBD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;IAWxC;;;;;OAKG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAe/B;;;;;;;;;OASG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBjE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC/B;;OAEG;IACH,SAAS,IAAI,UAAU;IAmBvB,OAAO,CAAC,WAAW;IA2CnB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,YAAY;IA+EpB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;CAcpB"}