@dsh-libing/knowledge-base 0.1.0

package/lib/jobs.d.ts

@@ -0,0 +1,2806 @@
+import type { Job, JobRecord, JobState, Overlay, ModelRoute } from './data.ts';
+import type { Store } from './store.ts';
+import type { Models } from './models.ts';
+import type { Settings } from './config.ts';
+import type { BuildArgs, JobOptions } from './shared.ts';
+export declare const ACTIVE: ReadonlySet<JobState>;
+export type Execution = {
+    sessionId?: string | undefined;
+    route?: ModelRoute | undefined;
+};
+export type ReviewOptions = {
+    visionProvider?: string | undefined;
+    visionModel?: string | undefined;
+    restore?: boolean | undefined;
+};
+export declare class Jobs {
+    readonly store: Store;
+    readonly models: Models;
+    readonly config: Settings;
+    readonly jobs: Map<string, Job>;
+    readonly controllers: Map<string, AbortController>;
+    readonly work: Map<string, Promise<void>>;
+    private stopped;
+    private mutationTail;
+    private releaseOwner;
+    constructor(store: Store, models: Models, config: Settings);
+    mutate<T>(fn: () => Promise<T>): Promise<T>;
+    init(): Promise<void>;
+    attach(record: JobRecord, directory: string): Job;
+    public(job: Job): {
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    };
+    list(kbId?: string): {
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    }[];
+    get(jobId: string): Job;
+    submit(args: BuildArgs, execution?: Execution): Promise<{
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    } | {
+        reused: boolean;
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    }>;
+    submitUnlocked(args: BuildArgs, execution?: Execution): Promise<{
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    } | {
+        reused: boolean;
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    }>;
+    pump(): void;
+    phase(job: Job, state: JobState): Promise<void>;
+    preview(jobId: string): Promise<{
+        root: string;
+        manifest: {
+            formatVersion: 1;
+            revision: string;
+            buildKey: string;
+            createdAt: string;
+            documents: {
+                docId: string;
+                title: string;
+                filename: string;
+                sourceHash: string;
+                sourceVersion: string;
+                nodes: {
+                    nodeId: string;
+                    title: string;
+                    level: number;
+                    parentId: string | null;
+                    headingPath: string[];
+                    children: string[];
+                    anchor?: string | null | undefined;
+                    indexPath?: string | undefined;
+                }[];
+                chunks: {
+                    chunkId: string;
+                    docId: string;
+                    sourceHash: string;
+                    sourceVersion: string;
+                    title: string;
+                    nodeId: string;
+                    headingPath: string[];
+                    blockRange: [string, string];
+                    assetRefs: string[];
+                    tableRefs: string[];
+                    relatedChunks: string[];
+                    reviewStatus: "source" | "generated" | "needs-review";
+                    path: string;
+                    segments: {
+                        text: string;
+                        blockIds: string[];
+                        type: "code" | "caption" | "table" | "heading" | "paragraph" | "figure" | "list" | "note" | "formula";
+                        sourceLocations?: import("./data.ts").Source[] | undefined;
+                        startLine?: number | undefined;
+                        endLine?: number | undefined;
+                    }[];
+                    anchors: string[];
+                    fullChars: number;
+                    bodyChars: number;
+                    contentHash: string;
+                    summary: string;
+                    keywords: string[];
+                    sourceFormat?: "docx" | "pdf" | undefined;
+                    sourceLocations?: import("./data.ts").Source[] | undefined;
+                    pageRange?: [number, number] | undefined;
+                    selectedPages?: {
+                        start: number;
+                        end: number;
+                        count: number;
+                        total: number;
+                        partial: boolean;
+                    } | undefined;
+                    oversizedReason?: string | undefined;
+                    summaryFallback?: boolean | undefined;
+                }[];
+                assets: {
+                    assetId: string;
+                    mime: string;
+                    path: string;
+                    bytes: number;
+                    origin: string;
+                    source?: import("./data.ts").Source | undefined;
+                }[];
+                figures: {
+                    status: "decoration" | "generated" | "failed" | "skipped" | "ignored" | "reviewed";
+                    assetId: string;
+                    occurrenceId: string;
+                    caption: string;
+                    cacheKey: string;
+                    overlayKey: string;
+                    overlayHash: string;
+                    humanReviewed: boolean;
+                    needsReview: boolean;
+                    types?: ("architecture" | "pinout" | "schematic" | "timing" | "flowchart" | "table" | "curve" | "other" | "decoration")[] | undefined;
+                    visibleLabels?: string[] | undefined;
+                    description?: string | undefined;
+                    relations?: {
+                        from: string;
+                        to: string;
+                        label: string;
+                    }[] | undefined;
+                    uncertainties?: string[] | undefined;
+                    contextNotes?: string | undefined;
+                    pins?: import("zod").JSONType[] | undefined;
+                    timingConstraints?: import("zod").JSONType[] | undefined;
+                    tableRows?: import("zod").JSONType[] | undefined;
+                    error?: string | undefined;
+                    classification?: {
+                        types: ("architecture" | "pinout" | "schematic" | "timing" | "flowchart" | "table" | "curve" | "other" | "decoration")[];
+                        reason: string;
+                    } | undefined;
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    model?: {
+                        provider: string;
+                        model: string;
+                    } | undefined;
+                    promptVersion?: string | undefined;
+                    context?: {
+                        headingPath: string[];
+                        nearby: string[];
+                        caption?: string | undefined;
+                    } | undefined;
+                    source?: import("./data.ts").Source | undefined;
+                    nativeLabels?: string[] | undefined;
+                    refreshToken?: string | undefined;
+                    ignore?: boolean | undefined;
+                    skip?: boolean | undefined;
+                    previous?: Overlay | null | undefined;
+                    updatedAt?: string | undefined;
+                }[];
+                sourceFormat?: "docx" | "pdf" | undefined;
+                pageCount?: number | undefined;
+                selectedPages?: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                } | undefined;
+                parserVersion?: string | undefined;
+                audit?: {
+                    pages: {
+                        page: number;
+                        status: "failed" | "needs-review" | "navigation" | "parsed";
+                        ocr: boolean;
+                        tables: number;
+                        figures: number;
+                        headings: {
+                            text: string;
+                            level: number;
+                            basis?: string | undefined;
+                        }[];
+                        width?: number | undefined;
+                        height?: number | undefined;
+                        pageLabel?: string | null | undefined;
+                        spanCount?: number | undefined;
+                        artifactCount?: number | undefined;
+                        excluded?: {
+                            kind: string;
+                            bbox: [number, number, number, number] | null;
+                            text?: string | undefined;
+                        }[] | undefined;
+                        previewAssetId?: string | null | undefined;
+                        error?: string | undefined;
+                    }[];
+                    outlineCount: number;
+                    matchedBookmarks: number;
+                    convertedFigures: number;
+                    convertedTables: number;
+                    warnings?: {
+                        code: string;
+                        message: string;
+                        blocking: boolean;
+                        page?: number | undefined;
+                        kind?: string | undefined;
+                        snippet?: string | undefined;
+                        reason?: string | undefined;
+                    }[] | undefined;
+                    styleLevels?: Record<string, number> | undefined;
+                    headingLevels?: Record<string, number> | undefined;
+                    outlineLevels?: Record<string, number> | undefined;
+                    expectedFigures?: number | undefined;
+                    expectedTables?: number | undefined;
+                    expectedHeadings?: string[] | undefined;
+                    textBoxes?: number | undefined;
+                    footnoteRefs?: number | undefined;
+                    anchors?: string[] | undefined;
+                    rawMediaCount?: number | undefined;
+                } | undefined;
+                chunkTargetChars?: number | undefined;
+                coverageIncomplete?: boolean | undefined;
+                warnings?: {
+                    code: string;
+                    message: string;
+                    blocking: boolean;
+                    page?: number | undefined;
+                    kind?: string | undefined;
+                    snippet?: string | undefined;
+                    reason?: string | undefined;
+                }[] | undefined;
+            }[];
+            catalogs: Record<string, {
+                catalogId: string;
+                path: string;
+                title: string;
+                pages: {
+                    path: string;
+                    content: string;
+                    entries: {
+                        title?: string | undefined;
+                        path?: string | undefined;
+                        docId?: string | undefined;
+                        nodeId?: string | undefined;
+                        chunkId?: string | undefined;
+                        summary?: string | undefined;
+                        fullChars?: number | undefined;
+                        keywords?: string[] | undefined;
+                        reviewStatus?: string | undefined;
+                        pdfScope?: string | undefined;
+                        pageRange?: [number, number] | undefined;
+                    }[];
+                    next: string | null;
+                }[];
+            }>;
+            entities: Record<string, {
+                label: string;
+                docId: string;
+                chunkId: string;
+                path: string;
+                headingPath: string[];
+            }[]>;
+            coverageIncomplete: boolean;
+            config: {
+                chunkTargetChars: number;
+            };
+            report: {
+                revision: string;
+                sourceHash: string;
+                issues: {
+                    code: string;
+                    message: string;
+                    blocking: boolean;
+                    page?: number | undefined;
+                    kind?: string | undefined;
+                    snippet?: string | undefined;
+                    reason?: string | undefined;
+                }[];
+                documents: number;
+                blocks: number;
+                figures: number;
+                ignoredFigures: number;
+                unreviewedFigures: number;
+                chunks: number;
+                withinTarget: number;
+                oversized: {
+                    chunkId: string;
+                    chars: number;
+                    reason: string;
+                }[];
+                usage: {
+                    calls: number;
+                    tokens: number;
+                    reportedCalls: number;
+                    records: import("zod").JSONType[];
+                };
+                targetChars: number;
+                pdf?: {
+                    pageCount: number;
+                    selectedPages: {
+                        start: number;
+                        end: number;
+                        count: number;
+                        total: number;
+                        partial: boolean;
+                    };
+                    outlineCount: number;
+                    matchedBookmarks: number;
+                    ocrPages: number;
+                    pages: {
+                        page: number;
+                        status: "failed" | "needs-review" | "navigation" | "parsed";
+                        ocr: boolean;
+                        tables: number;
+                        figures: number;
+                        headings: {
+                            text: string;
+                            level: number;
+                            basis?: string | undefined;
+                        }[];
+                        width?: number | undefined;
+                        height?: number | undefined;
+                        pageLabel?: string | null | undefined;
+                        spanCount?: number | undefined;
+                        artifactCount?: number | undefined;
+                        excluded?: {
+                            kind: string;
+                            bbox: [number, number, number, number] | null;
+                            text?: string | undefined;
+                        }[] | undefined;
+                        previewAssetId?: string | null | undefined;
+                        error?: string | undefined;
+                    }[];
+                } | undefined;
+            };
+        };
+        revision: string;
+        kbId: string;
+        jobId: string;
+    }>;
+    run(job: Job, signal: AbortSignal): Promise<void>;
+    action(jobId: string, action: 'status' | 'retry' | 'cancel', options?: JobOptions): Promise<{
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    }>;
+    actionUnlocked(jobId: string, action: 'status' | 'retry' | 'cancel', options?: JobOptions): Promise<{
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    }>;
+    review(kbId: string, revision: string, docId: string, occurrenceId: string, value: Overlay | null, expectedHash: string, options?: ReviewOptions): Promise<{
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    } | {
+        reused: boolean;
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    }>;
+    reviewUnlocked(kbId: string, revision: string, docId: string, occurrenceId: string, value: Overlay | null, expectedHash: string, options?: ReviewOptions): Promise<{
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    } | {
+        reused: boolean;
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    }>;
+    trash(kbId: string, expectedName: string): Promise<{
+        kbId: string;
+        name: string;
+        createdAt: string;
+        deletedAt?: string | undefined;
+        purge?: {
+            startedAt: string;
+            jobIds: string[];
+            error?: string | undefined;
+        } | undefined;
+    }>;
+    restore(kbId: string): Promise<{
+        kbId: string;
+        name: string;
+        createdAt: string;
+        deletedAt?: string | undefined;
+        purge?: {
+            startedAt: string;
+            jobIds: string[];
+            error?: string | undefined;
+        } | undefined;
+    }>;
+    purge(kbId: string, expectedName: string, confirmed: boolean): Promise<{
+        kbId: string;
+        name: string;
+        purged: boolean;
+    }>;
+    wait(jobId: string): Promise<{
+        outputPath: string | null;
+        jobId: string;
+        kbId: string;
+        docId: string;
+        title: string;
+        sourceVersion: string;
+        filename: string;
+        sourceFormat: "docx" | "pdf";
+        sourceOriginalHash: string;
+        buildKey: string;
+        config: {
+            dataRoot: string;
+            chunkTargetChars: number;
+            evidenceMaxChars: number;
+            catalogMaxChars: number;
+            candidateLimit: number;
+            maxInputBytes: number;
+            maxUncompressedBytes: number;
+            maxArchiveEntries: number;
+            modelTimeoutMs: number;
+            modelAttempts: number;
+            visionConcurrency: number;
+            maxModelCalls: number;
+            maxModelTokens: number;
+            visionMaxEdge: number;
+            visionTileSize: number;
+            visionMaxTiles: number;
+            modelMaxOutputTokens: number;
+            summaryMaxChars: number;
+            figureMaxChars: number;
+            pdfMaxPages: number;
+            pdfMaxPagePixels: number;
+            pdfPageTimeoutMs: number;
+            libreOfficePath: string;
+            visionProvider: string;
+            visionModel: string;
+            summaryProvider: string;
+            summaryModel: string;
+            skipImages: boolean;
+            acceptPartial: boolean;
+        };
+        routes: {
+            vision: {
+                provider: string;
+                model: string;
+            } | null;
+            summary: {
+                provider: string;
+                model: string;
+            } | null;
+        };
+        schemaHash: string;
+        sessionId: string | null;
+        state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        createdAt: string;
+        progress: {
+            totalPages?: number | undefined;
+            parsedPages?: number | undefined;
+            ocrPages?: number | undefined;
+            tables?: number | undefined;
+            blocks?: number | undefined;
+            currentPage?: number | undefined;
+            totalFigures?: number | undefined;
+            completedFigures?: number | undefined;
+            inflightFigures?: {
+                occurrenceId: string;
+                caption: string;
+            }[] | undefined;
+            totalChunks?: number | undefined;
+            indexedChunks?: number | undefined;
+            currentChunk?: {
+                title: string;
+                headingPath: string[];
+                chunkId: string;
+            } | undefined;
+        };
+        usage: {
+            calls: number;
+            tokens: number;
+            reportedCalls: number;
+            records: import("zod").JSONType[];
+        };
+        failures: {
+            at: string;
+            stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            error: string;
+        }[];
+        sourceHash?: string | undefined;
+        updatedAt?: string | undefined;
+        events?: {
+            at: string;
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+        }[] | undefined;
+        figureRefresh?: {
+            occurrenceId: string;
+            token: string;
+        } | null | undefined;
+        visionCapability?: string | undefined;
+        parserVersion?: string | undefined;
+        pageStart?: number | undefined;
+        pageEnd?: number | undefined;
+        pdf?: {
+            pageCount: number;
+            selectedPages: {
+                start: number;
+                end: number;
+                count: number;
+                total: number;
+                partial: boolean;
+            };
+            outlineCount?: number | undefined;
+        } | undefined;
+        revision?: string | undefined;
+        report?: {
+            revision: string;
+            sourceHash: string;
+            issues: {
+                code: string;
+                message: string;
+                blocking: boolean;
+                page?: number | undefined;
+                kind?: string | undefined;
+                snippet?: string | undefined;
+                reason?: string | undefined;
+            }[];
+            documents: number;
+            blocks: number;
+            figures: number;
+            ignoredFigures: number;
+            unreviewedFigures: number;
+            chunks: number;
+            withinTarget: number;
+            oversized: {
+                chunkId: string;
+                chars: number;
+                reason: string;
+            }[];
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            targetChars: number;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount: number;
+                matchedBookmarks: number;
+                ocrPages: number;
+                pages: {
+                    page: number;
+                    status: "failed" | "needs-review" | "navigation" | "parsed";
+                    ocr: boolean;
+                    tables: number;
+                    figures: number;
+                    headings: {
+                        text: string;
+                        level: number;
+                        basis?: string | undefined;
+                    }[];
+                    width?: number | undefined;
+                    height?: number | undefined;
+                    pageLabel?: string | null | undefined;
+                    spanCount?: number | undefined;
+                    artifactCount?: number | undefined;
+                    excluded?: {
+                        kind: string;
+                        bbox: [number, number, number, number] | null;
+                        text?: string | undefined;
+                    }[] | undefined;
+                    previewAssetId?: string | null | undefined;
+                    error?: string | undefined;
+                }[];
+            } | undefined;
+        } | undefined;
+        error?: string | null | undefined;
+        recoveredAt?: string | undefined;
+        finishedAt?: string | undefined;
+        cancelRequested?: boolean | undefined;
+    }>;
+    stop(): void;
+    close(): Promise<void>;
+}