ocr-provenance-mcp 1.0.0

package/dist/services/ocr/datalab.js

@@ -0,0 +1,425 @@
+/**
+ * Datalab OCR Bridge
+ *
+ * Invokes python/ocr_worker.py via python-shell.
+ * NO MOCKS, NO FALLBACKS - real API calls only.
+ */
+import { PythonShell } from 'python-shell';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { OCRError, mapPythonError } from './errors.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Max stderr accumulation: 10KB (matches nomic.ts pattern) */
+const MAX_STDERR_LENGTH = 10_240;
+export class DatalabClient {
+    pythonPath;
+    workerPath;
+    timeout;
+    constructor(config = {}) {
+        this.pythonPath = config.pythonPath;
+        this.workerPath = resolve(__dirname, '../../../python/ocr_worker.py');
+        const parsedTimeout = parseInt(process.env.DATALAB_TIMEOUT || '330000');
+        this.timeout = config.timeout ?? (Number.isNaN(parsedTimeout) ? 330000 : parsedTimeout); // 5.5 min (FIX-P3-1)
+    }
+    /**
+     * Process document through Datalab OCR
+     *
+     * FAIL-FAST: Throws on any error, no fallbacks
+     */
+    async processDocument(filePath, documentId, provenanceId, mode = 'accurate', ocrOptions) {
+        const args = [
+            '--file',
+            filePath,
+            '--mode',
+            mode,
+            '--doc-id',
+            documentId,
+            '--prov-id',
+            provenanceId,
+            '--json',
+        ];
+        if (ocrOptions?.maxPages)
+            args.push('--max-pages', String(ocrOptions.maxPages));
+        if (ocrOptions?.pageRange)
+            args.push('--page-range', ocrOptions.pageRange);
+        if (ocrOptions?.skipCache)
+            args.push('--skip-cache');
+        if (ocrOptions?.disableImageExtraction)
+            args.push('--disable-image-extraction');
+        if (ocrOptions?.extras?.length)
+            args.push('--extras', ocrOptions.extras.join(','));
+        if (ocrOptions?.pageSchema)
+            args.push('--page-schema', ocrOptions.pageSchema);
+        if (ocrOptions?.additionalConfig)
+            args.push('--additional-config', JSON.stringify(ocrOptions.additionalConfig));
+        if (ocrOptions?.fileUrl)
+            args.push('--file-url', ocrOptions.fileUrl);
+        const options = {
+            mode: 'text',
+            pythonPath: this.pythonPath,
+            pythonOptions: ['-u'],
+            args,
+        };
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const shell = new PythonShell(this.workerPath, options);
+            const outputChunks = [];
+            let stderr = '';
+            let sigkillTimer = null;
+            const cleanup = () => {
+                if (sigkillTimer) {
+                    clearTimeout(sigkillTimer);
+                    sigkillTimer = null;
+                }
+            };
+            const timer = setTimeout(() => {
+                if (settled)
+                    return;
+                // Kill the Python process to prevent orphans (SIGTERM)
+                try {
+                    shell.kill();
+                }
+                catch (error) {
+                    console.error('[DatalabOCR] Failed to kill shell on timeout:', error instanceof Error ? error.message : String(error));
+                    /* ignore */
+                }
+                // M-6: SIGKILL escalation if SIGTERM doesn't exit within 5s
+                sigkillTimer = setTimeout(() => {
+                    if (!settled) {
+                        console.error(`[DatalabOCR] Process did not exit after SIGTERM, sending SIGKILL (pid: ${shell.childProcess?.pid})`);
+                        try {
+                            shell.childProcess?.kill('SIGKILL');
+                        }
+                        catch (error) {
+                            console.error('[DatalabOCR] Failed to SIGKILL process (may already be gone):', error instanceof Error ? error.message : String(error));
+                        }
+                    }
+                    // Settle the promise if close event hasn't fired yet (zombie prevention)
+                    if (!settled) {
+                        settled = true;
+                        reject(new OCRError(`OCR timeout after ${this.timeout}ms (SIGKILL after 5s grace)`, 'OCR_TIMEOUT'));
+                    }
+                }, 5000);
+            }, this.timeout);
+            shell.on('message', (msg) => {
+                outputChunks.push(msg);
+            });
+            shell.on('stderr', (err) => {
+                if (stderr.length < MAX_STDERR_LENGTH) {
+                    stderr += err + '\n';
+                }
+            });
+            shell.end((err) => {
+                clearTimeout(timer);
+                cleanup();
+                if (settled)
+                    return;
+                settled = true;
+                // Capture exit code/signal for diagnostics
+                const exitCode = shell.exitCode ?? null;
+                const exitSignal = shell.exitSignal ?? null;
+                // H-3: Join chunks once instead of repeated string concatenation
+                const output = outputChunks.join('\n');
+                // M-12: Allow early GC of chunk array
+                outputChunks.length = 0;
+                // python-shell bug: when process is killed by signal (SIGTERM/SIGKILL),
+                // exitCode is null and exitSignal is set, but err is NOT provided.
+                // Detect this and treat signal-killed processes as errors.
+                if (!err && exitSignal) {
+                    const signalDetail = stderr.trim()
+                        ? `Process killed by ${exitSignal}. Python stderr:\n${stderr.trim()}`
+                        : `Process killed by ${exitSignal} with no stderr output.`;
+                    reject(new OCRError(`OCR worker killed by signal ${exitSignal} (file: ${filePath}). ${signalDetail}`, exitSignal === 'SIGTERM' || exitSignal === 'SIGALRM' ? 'OCR_TIMEOUT' : 'OCR_API_ERROR'));
+                    return;
+                }
+                if (err) {
+                    // Try to parse JSON from output for structured error
+                    const lines = output
+                        .trim()
+                        .split('\n')
+                        .filter((l) => l.trim());
+                    for (let i = lines.length - 1; i >= 0; i--) {
+                        try {
+                            const parsed = JSON.parse(lines[i].trim());
+                            if (this.isErrorResponse(parsed)) {
+                                reject(mapPythonError(parsed.category, parsed.error, parsed.details));
+                                return;
+                            }
+                        }
+                        catch (error) {
+                            console.error('[DatalabOCR] JSON parse failed for error output line, skipping:', error instanceof Error ? error.message : String(error));
+                            /* not JSON, skip */
+                        }
+                    }
+                    const detail = stderr ? `${err.message}\nPython stderr:\n${stderr}` : err.message;
+                    reject(new OCRError(`Python worker failed: ${detail}`, 'OCR_API_ERROR'));
+                    return;
+                }
+                // Parse the last JSON line from stdout (Python may output non-JSON logging)
+                const lines = output
+                    .trim()
+                    .split('\n')
+                    .filter((l) => l.trim());
+                if (lines.length === 0) {
+                    const diagnostics = [
+                        'No output from OCR worker.',
+                        `Exit code: ${exitCode}, signal: ${exitSignal}.`,
+                        `File: ${filePath}.`,
+                    ];
+                    if (stderr.trim()) {
+                        diagnostics.push(`Python stderr: ${stderr.trim().substring(0, 500)}`);
+                    }
+                    else {
+                        diagnostics.push('Python stderr was empty (logging suppressed in --json mode).');
+                    }
+                    reject(new OCRError(diagnostics.join(' '), 'OCR_API_ERROR'));
+                    return;
+                }
+                let response;
+                for (let i = lines.length - 1; i >= 0; i--) {
+                    try {
+                        response = JSON.parse(lines[i].trim());
+                        break;
+                    }
+                    catch (error) {
+                        console.error('[DatalabOCR] JSON parse failed for output line, trying previous:', error instanceof Error ? error.message : String(error));
+                        /* not JSON, try previous line */
+                    }
+                }
+                if (!response) {
+                    reject(new OCRError(`Failed to parse OCR worker output as JSON. Last line: ${lines[lines.length - 1]?.substring(0, 200)}`, 'OCR_API_ERROR'));
+                    return;
+                }
+                // Check for error response
+                if (this.isErrorResponse(response)) {
+                    reject(mapPythonError(response.category, response.error, response.details));
+                    return;
+                }
+                const ocrResponse = response;
+                // Verify required fields exist
+                if (!ocrResponse.id || !ocrResponse.content_hash || !ocrResponse.extracted_text) {
+                    reject(new OCRError(`Invalid OCR response: missing required fields. Got: ${JSON.stringify(Object.keys(ocrResponse))}`, 'OCR_API_ERROR'));
+                    return;
+                }
+                resolve({
+                    result: this.toOCRResult(ocrResponse),
+                    pageOffsets: this.toPageOffsets(ocrResponse.page_offsets),
+                    images: ocrResponse.images ?? {},
+                    jsonBlocks: ocrResponse.json_blocks ?? null,
+                    metadata: ocrResponse.metadata ?? null,
+                    extractionJson: ocrResponse.extraction_json ?? null,
+                    docTitle: ocrResponse.doc_title ?? null,
+                    docAuthor: ocrResponse.doc_author ?? null,
+                    docSubject: ocrResponse.doc_subject ?? null,
+                });
+            });
+        });
+    }
+    /**
+     * Process a file through Datalab OCR and return raw results without storing in DB.
+     * Used by ocr_convert_raw tool for quick one-off conversions.
+     *
+     * FAIL-FAST: Throws on any error, no fallbacks
+     */
+    async processRaw(filePath, mode = 'balanced', ocrOptions) {
+        // Use dummy IDs since we are not storing in DB
+        const dummyDocId = 'raw-convert-' + Date.now();
+        const dummyProvId = 'raw-convert-prov-' + Date.now();
+        const args = [];
+        if (ocrOptions?.fileUrl) {
+            args.push('--file-url', ocrOptions.fileUrl);
+        }
+        else {
+            args.push('--file', filePath);
+        }
+        args.push('--mode', mode, '--doc-id', dummyDocId, '--prov-id', dummyProvId, '--json');
+        if (ocrOptions?.maxPages)
+            args.push('--max-pages', String(ocrOptions.maxPages));
+        if (ocrOptions?.pageRange)
+            args.push('--page-range', ocrOptions.pageRange);
+        const options = {
+            mode: 'text',
+            pythonPath: this.pythonPath,
+            pythonOptions: ['-u'],
+            args,
+        };
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const shell = new PythonShell(this.workerPath, options);
+            const outputChunks = [];
+            let stderr = '';
+            let sigkillTimer = null;
+            const cleanup = () => {
+                if (sigkillTimer) {
+                    clearTimeout(sigkillTimer);
+                    sigkillTimer = null;
+                }
+            };
+            const timer = setTimeout(() => {
+                if (settled)
+                    return;
+                try {
+                    shell.kill();
+                }
+                catch (error) {
+                    console.error('[DatalabOCR] Failed to kill shell on processRaw timeout:', error instanceof Error ? error.message : String(error));
+                    /* ignore */
+                }
+                // M-6: SIGKILL escalation if SIGTERM doesn't exit within 5s
+                sigkillTimer = setTimeout(() => {
+                    if (!settled) {
+                        console.error(`[DatalabOCR] processRaw process did not exit after SIGTERM, sending SIGKILL (pid: ${shell.childProcess?.pid})`);
+                        try {
+                            shell.childProcess?.kill('SIGKILL');
+                        }
+                        catch (error) {
+                            console.error('[DatalabOCR] Failed to SIGKILL processRaw process (may already be gone):', error instanceof Error ? error.message : String(error));
+                        }
+                    }
+                    if (!settled) {
+                        settled = true;
+                        reject(new OCRError(`OCR timeout after ${this.timeout}ms (SIGKILL after 5s grace)`, 'OCR_TIMEOUT'));
+                    }
+                }, 5000);
+            }, this.timeout);
+            shell.on('message', (msg) => {
+                outputChunks.push(msg);
+            });
+            shell.on('stderr', (err) => {
+                if (stderr.length < MAX_STDERR_LENGTH) {
+                    stderr += err + '\n';
+                }
+            });
+            shell.end((err) => {
+                clearTimeout(timer);
+                cleanup();
+                if (settled)
+                    return;
+                settled = true;
+                // Capture exit code/signal for diagnostics
+                const exitCode = shell.exitCode ?? null;
+                const exitSignal = shell.exitSignal ?? null;
+                const output = outputChunks.join('\n');
+                outputChunks.length = 0;
+                // python-shell bug: when process is killed by signal (SIGTERM/SIGKILL),
+                // exitCode is null and exitSignal is set, but err is NOT provided.
+                // Detect this and treat signal-killed processes as errors.
+                const rawFilePath = ocrOptions?.fileUrl || filePath;
+                if (!err && exitSignal) {
+                    const signalDetail = stderr.trim()
+                        ? `Process killed by ${exitSignal}. Python stderr:\n${stderr.trim()}`
+                        : `Process killed by ${exitSignal} with no stderr output.`;
+                    reject(new OCRError(`OCR worker killed by signal ${exitSignal} (file: ${rawFilePath}). ${signalDetail}`, exitSignal === 'SIGTERM' || exitSignal === 'SIGALRM' ? 'OCR_TIMEOUT' : 'OCR_API_ERROR'));
+                    return;
+                }
+                if (err) {
+                    const lines = output
+                        .trim()
+                        .split('\n')
+                        .filter((l) => l.trim());
+                    for (let i = lines.length - 1; i >= 0; i--) {
+                        try {
+                            const parsed = JSON.parse(lines[i].trim());
+                            if (this.isErrorResponse(parsed)) {
+                                reject(mapPythonError(parsed.category, parsed.error, parsed.details));
+                                return;
+                            }
+                        }
+                        catch (error) {
+                            console.error('[DatalabOCR] JSON parse failed for processRaw error output line, skipping:', error instanceof Error ? error.message : String(error));
+                            /* not JSON, skip */
+                        }
+                    }
+                    const detail = stderr ? `${err.message}\nPython stderr:\n${stderr}` : err.message;
+                    reject(new OCRError(`Python worker failed: ${detail}`, 'OCR_API_ERROR'));
+                    return;
+                }
+                const lines = output
+                    .trim()
+                    .split('\n')
+                    .filter((l) => l.trim());
+                if (lines.length === 0) {
+                    const diagnostics = [
+                        'No output from OCR worker.',
+                        `Exit code: ${exitCode}, signal: ${exitSignal}.`,
+                        `File: ${rawFilePath}.`,
+                    ];
+                    if (stderr.trim()) {
+                        diagnostics.push(`Python stderr: ${stderr.trim().substring(0, 500)}`);
+                    }
+                    else {
+                        diagnostics.push('Python stderr was empty (logging suppressed in --json mode).');
+                    }
+                    reject(new OCRError(diagnostics.join(' '), 'OCR_API_ERROR'));
+                    return;
+                }
+                let response;
+                for (let i = lines.length - 1; i >= 0; i--) {
+                    try {
+                        response = JSON.parse(lines[i].trim());
+                        break;
+                    }
+                    catch (error) {
+                        console.error('[DatalabOCR] JSON parse failed for processRaw output line, trying previous:', error instanceof Error ? error.message : String(error));
+                        /* not JSON, try previous line */
+                    }
+                }
+                if (!response) {
+                    reject(new OCRError(`Failed to parse OCR worker output as JSON. Last line: ${lines[lines.length - 1]?.substring(0, 200)}`, 'OCR_API_ERROR'));
+                    return;
+                }
+                if (this.isErrorResponse(response)) {
+                    reject(mapPythonError(response.category, response.error, response.details));
+                    return;
+                }
+                const ocrResponse = response;
+                resolve({
+                    markdown: ocrResponse.extracted_text ?? '',
+                    pageCount: ocrResponse.page_count ?? 0,
+                    qualityScore: ocrResponse.parse_quality_score ?? null,
+                    costCents: ocrResponse.cost_cents ?? null,
+                    durationMs: ocrResponse.processing_duration_ms ?? 0,
+                    metadata: ocrResponse.metadata ?? null,
+                });
+            });
+        });
+    }
+    isErrorResponse(response) {
+        return (typeof response === 'object' &&
+            response !== null &&
+            'error' in response &&
+            'category' in response);
+    }
+    toOCRResult(r) {
+        // Direct field mapping - Python snake_case matches TS interface
+        // Build extras_json from metadata + cost_breakdown
+        const extras = {};
+        if (r.metadata)
+            extras.metadata = r.metadata;
+        if (r.cost_breakdown_full)
+            extras.cost_breakdown = r.cost_breakdown_full;
+        return {
+            id: r.id,
+            provenance_id: r.provenance_id,
+            document_id: r.document_id,
+            extracted_text: r.extracted_text,
+            text_length: r.text_length,
+            datalab_request_id: r.datalab_request_id,
+            datalab_mode: r.datalab_mode,
+            parse_quality_score: r.parse_quality_score,
+            page_count: r.page_count,
+            cost_cents: r.cost_cents,
+            content_hash: r.content_hash,
+            processing_started_at: r.processing_started_at,
+            processing_completed_at: r.processing_completed_at,
+            processing_duration_ms: r.processing_duration_ms,
+            json_blocks: r.json_blocks ? JSON.stringify(r.json_blocks) : null,
+            extras_json: Object.keys(extras).length > 0 ? JSON.stringify(extras) : null,
+        };
+    }
+    toPageOffsets(offsets) {
+        // Convert Python snake_case to TS camelCase
+        return offsets.map((o) => ({ page: o.page, charStart: o.char_start, charEnd: o.char_end }));
+    }
+}
+//# sourceMappingURL=datalab.js.map

package/dist/services/ocr/datalab.js.map

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

package/dist/services/ocr/errors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * OCR Error Classes
+ *
+ * FAIL-FAST: These errors propagate immediately, no fallbacks.
+ * Must match Python error categories in python/ocr_worker.py lines 34-94.
+ */
+type OCRErrorCategory = 'OCR_API_ERROR' | 'OCR_SERVER_ERROR' | 'OCR_RATE_LIMIT' | 'OCR_TIMEOUT' | 'OCR_FILE_ERROR' | 'OCR_AUTHENTICATION_ERROR' | 'FORM_FILL_API_ERROR' | 'FORM_FILL_SERVER_ERROR' | 'FORM_FILL_FILE_ERROR' | 'FORM_FILL_TIMEOUT' | 'FILE_MANAGER_API_ERROR' | 'FILE_MANAGER_SERVER_ERROR' | 'FILE_MANAGER_FILE_ERROR';
+export declare class OCRError extends Error {
+    readonly category: OCRErrorCategory;
+    readonly requestId?: string | undefined;
+    constructor(message: string, category: OCRErrorCategory, requestId?: string | undefined);
+}
+export declare class OCRAPIError extends OCRError {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number, requestId?: string);
+}
+export declare class OCRRateLimitError extends OCRError {
+    readonly retryAfter: number;
+    constructor(message?: string, retryAfter?: number);
+}
+export declare class OCRTimeoutError extends OCRError {
+    constructor(message: string, requestId?: string);
+}
+export declare class OCRFileError extends OCRError {
+    readonly filePath: string;
+    constructor(message: string, filePath: string);
+}
+export declare class OCRAuthenticationError extends OCRError {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+/**
+ * Map Python error JSON to TypeScript error class
+ * FAIL-FAST: Unknown categories throw OCRError
+ */
+export declare function mapPythonError(category: string, message: string, details: Record<string, unknown>): OCRError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/services/ocr/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/services/ocr/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,gBAAgB,GACjB,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAChB,aAAa,GACb,gBAAgB,GAChB,0BAA0B,GAC1B,qBAAqB,GACrB,wBAAwB,GACxB,sBAAsB,GACtB,mBAAmB,GACnB,wBAAwB,GACxB,2BAA2B,GAC3B,yBAAyB,CAAC;AAE9B,qBAAa,QAAS,SAAQ,KAAK;aAGf,QAAQ,EAAE,gBAAgB;aAC1B,SAAS,CAAC,EAAE,MAAM;gBAFlC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,CAAC,EAAE,MAAM,YAAA;CAKrC;AAED,qBAAa,WAAY,SAAQ,QAAQ;aAGrB,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClC,SAAS,CAAC,EAAE,MAAM;CAKrB;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;aAG3B,UAAU,EAAE,MAAM;gBADlC,OAAO,GAAE,MAA8B,EACvB,UAAU,GAAE,MAAW;CAK1C;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAIhD;AAED,qBAAa,YAAa,SAAQ,QAAQ;aAGtB,QAAQ,EAAE,MAAM;gBADhC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM;CAKnC;AAED,qBAAa,sBAAuB,SAAQ,QAAQ;aAGhC,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKrC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,QAAQ,CA8BV"}

package/dist/services/ocr/errors.js

@@ -0,0 +1,83 @@
+/**
+ * OCR Error Classes
+ *
+ * FAIL-FAST: These errors propagate immediately, no fallbacks.
+ * Must match Python error categories in python/ocr_worker.py lines 34-94.
+ */
+export class OCRError extends Error {
+    category;
+    requestId;
+    constructor(message, category, requestId) {
+        super(message);
+        this.category = category;
+        this.requestId = requestId;
+        this.name = 'OCRError';
+    }
+}
+export class OCRAPIError extends OCRError {
+    statusCode;
+    constructor(message, statusCode, requestId) {
+        super(message, statusCode >= 500 ? 'OCR_SERVER_ERROR' : 'OCR_API_ERROR', requestId);
+        this.statusCode = statusCode;
+        this.name = 'OCRAPIError';
+    }
+}
+export class OCRRateLimitError extends OCRError {
+    retryAfter;
+    constructor(message = 'Rate limit exceeded', retryAfter = 60) {
+        super(message, 'OCR_RATE_LIMIT');
+        this.retryAfter = retryAfter;
+        this.name = 'OCRRateLimitError';
+    }
+}
+export class OCRTimeoutError extends OCRError {
+    constructor(message, requestId) {
+        super(message, 'OCR_TIMEOUT', requestId);
+        this.name = 'OCRTimeoutError';
+    }
+}
+export class OCRFileError extends OCRError {
+    filePath;
+    constructor(message, filePath) {
+        super(message, 'OCR_FILE_ERROR');
+        this.filePath = filePath;
+        this.name = 'OCRFileError';
+    }
+}
+export class OCRAuthenticationError extends OCRError {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message, 'OCR_AUTHENTICATION_ERROR');
+        this.statusCode = statusCode;
+        this.name = 'OCRAuthenticationError';
+    }
+}
+/**
+ * Map Python error JSON to TypeScript error class
+ * FAIL-FAST: Unknown categories throw OCRError
+ */
+export function mapPythonError(category, message, details) {
+    switch (category) {
+        case 'OCR_API_ERROR':
+        case 'OCR_SERVER_ERROR':
+        case 'FORM_FILL_API_ERROR':
+        case 'FORM_FILL_SERVER_ERROR':
+        case 'FILE_MANAGER_API_ERROR':
+        case 'FILE_MANAGER_SERVER_ERROR':
+            return new OCRAPIError(message, details.status_code ?? 500, details.request_id);
+        case 'OCR_RATE_LIMIT':
+            return new OCRRateLimitError(message, details.retry_after ?? 60);
+        case 'OCR_TIMEOUT':
+        case 'FORM_FILL_TIMEOUT':
+            return new OCRTimeoutError(message, details.request_id);
+        case 'OCR_FILE_ERROR':
+        case 'FORM_FILL_FILE_ERROR':
+        case 'FILE_MANAGER_FILE_ERROR':
+            return new OCRFileError(message, details.file_path ?? 'unknown');
+        case 'OCR_AUTHENTICATION_ERROR':
+            return new OCRAuthenticationError(message, details.status_code ?? 401);
+        default:
+            throw new OCRError(`Unknown error category: ${category}. Message: ${message}`, 'OCR_API_ERROR');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/services/ocr/errors.js.map

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

package/dist/services/ocr/file-manager.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Datalab File Manager Bridge
+ *
+ * Invokes python/file_manager_worker.py via python-shell.
+ * NO MOCKS, NO FALLBACKS - real API calls only.
+ */
+interface FileUploadResult {
+    fileId: string;
+    reference: string | null;
+    fileName: string;
+    fileHash: string;
+    fileSize: number;
+    contentType: string;
+    status: 'complete' | 'failed';
+    error: string | null;
+    processingDurationMs: number;
+}
+interface FileInfo {
+    fileId: string;
+    fileName: string | null;
+    fileSize: number | null;
+    contentType: string | null;
+    createdAt: string | null;
+    reference: string | null;
+    status: string | null;
+}
+interface FileListResult {
+    files: Record<string, unknown>[];
+    total: number;
+}
+interface FileManagerClientConfig {
+    pythonPath?: string;
+    timeout?: number;
+}
+export declare class FileManagerClient {
+    private readonly pythonPath;
+    private readonly workerPath;
+    private readonly timeout;
+    constructor(config?: FileManagerClientConfig);
+    /**
+     * Upload a file to Datalab cloud storage
+     *
+     * FAIL-FAST: Throws on any error, no fallbacks
+     */
+    uploadFile(filePath: string): Promise<FileUploadResult>;
+    /**
+     * List files in Datalab cloud storage
+     */
+    listFiles(limit?: number, offset?: number): Promise<FileListResult>;
+    /**
+     * Get file metadata by ID
+     */
+    getFile(fileId: string): Promise<FileInfo>;
+    /**
+     * Get download URL for a file
+     *
+     * @param fileId - Datalab file ID
+     * @param expiresIn - URL expiry time in seconds (default: 3600, min: 60, max: 86400)
+     */
+    getDownloadUrl(fileId: string, expiresIn?: number): Promise<{
+        downloadUrl: string;
+        expiresIn: number;
+        fileId: string;
+    }>;
+    /**
+     * Delete a file from Datalab cloud storage
+     */
+    deleteFile(fileId: string): Promise<boolean>;
+    /**
+     * Run the Python worker with given args and parse JSON output
+     */
+    private runWorker;
+    private isErrorResponse;
+}
+export {};
+//# sourceMappingURL=file-manager.d.ts.map