@dsh-libing/knowledge-base 0.1.0

package/lib/client-types/contract.d.ts

@@ -0,0 +1,1197 @@
+/** JSON responses shared with the browser; imports stay free of Host and filesystem modules. */
+import { z } from 'zod';
+export declare const publicJobSchema: z.ZodObject<{
+    error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    kbId: z.ZodString;
+    title: z.ZodString;
+    sourceVersion: z.ZodString;
+    docId: z.ZodString;
+    pageStart: z.ZodOptional<z.ZodNumber>;
+    pageEnd: z.ZodOptional<z.ZodNumber>;
+    jobId: z.ZodString;
+    revision: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    pdf: z.ZodOptional<z.ZodObject<{
+        pageCount: z.ZodNumber;
+        selectedPages: z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            count: z.ZodNumber;
+            total: z.ZodNumber;
+            partial: z.ZodBoolean;
+        }, z.core.$strip>;
+        outlineCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    sourceFormat: z.ZodDefault<z.ZodEnum<{
+        docx: "docx";
+        pdf: "pdf";
+    }>>;
+    parserVersion: z.ZodOptional<z.ZodString>;
+    sourceHash: z.ZodOptional<z.ZodString>;
+    filename: z.ZodString;
+    usage: z.ZodObject<{
+        calls: z.ZodNumber;
+        tokens: z.ZodNumber;
+        reportedCalls: z.ZodNumber;
+        records: z.ZodArray<z.ZodJSONSchema>;
+    }, z.core.$strip>;
+    report: z.ZodOptional<z.ZodObject<{
+        revision: z.ZodString;
+        sourceHash: z.ZodString;
+        issues: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            blocking: z.ZodBoolean;
+            page: z.ZodOptional<z.ZodNumber>;
+            kind: z.ZodOptional<z.ZodString>;
+            snippet: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        documents: z.ZodNumber;
+        blocks: z.ZodNumber;
+        figures: z.ZodNumber;
+        ignoredFigures: z.ZodNumber;
+        unreviewedFigures: z.ZodNumber;
+        chunks: z.ZodNumber;
+        withinTarget: z.ZodNumber;
+        oversized: z.ZodArray<z.ZodObject<{
+            chunkId: z.ZodString;
+            chars: z.ZodNumber;
+            reason: z.ZodString;
+        }, z.core.$strip>>;
+        usage: z.ZodObject<{
+            calls: z.ZodNumber;
+            tokens: z.ZodNumber;
+            reportedCalls: z.ZodNumber;
+            records: z.ZodArray<z.ZodJSONSchema>;
+        }, z.core.$strip>;
+        targetChars: z.ZodNumber;
+        pdf: z.ZodOptional<z.ZodObject<{
+            pageCount: z.ZodNumber;
+            selectedPages: z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+                count: z.ZodNumber;
+                total: z.ZodNumber;
+                partial: z.ZodBoolean;
+            }, z.core.$strip>;
+            outlineCount: z.ZodNumber;
+            matchedBookmarks: z.ZodNumber;
+            ocrPages: z.ZodNumber;
+            pages: z.ZodArray<z.ZodObject<{
+                page: z.ZodNumber;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                pageLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    "needs-review": "needs-review";
+                    navigation: "navigation";
+                    parsed: "parsed";
+                }>;
+                ocr: z.ZodBoolean;
+                spanCount: z.ZodOptional<z.ZodNumber>;
+                artifactCount: z.ZodOptional<z.ZodNumber>;
+                excluded: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    kind: z.ZodString;
+                    text: z.ZodOptional<z.ZodString>;
+                    bbox: z.ZodNullable<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                }, z.core.$strip>>>;
+                tables: z.ZodNumber;
+                figures: z.ZodNumber;
+                headings: z.ZodArray<z.ZodObject<{
+                    text: z.ZodString;
+                    basis: z.ZodOptional<z.ZodString>;
+                    level: z.ZodNumber;
+                }, z.core.$strip>>;
+                previewAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                error: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    buildKey: z.ZodString;
+    createdAt: z.ZodString;
+    config: z.ZodObject<{
+        dataRoot: z.ZodString;
+        chunkTargetChars: z.ZodDefault<z.ZodNumber>;
+        evidenceMaxChars: z.ZodDefault<z.ZodNumber>;
+        catalogMaxChars: z.ZodDefault<z.ZodNumber>;
+        candidateLimit: z.ZodDefault<z.ZodNumber>;
+        maxInputBytes: z.ZodDefault<z.ZodNumber>;
+        maxUncompressedBytes: z.ZodDefault<z.ZodNumber>;
+        maxArchiveEntries: z.ZodDefault<z.ZodNumber>;
+        modelTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        modelAttempts: z.ZodDefault<z.ZodNumber>;
+        visionConcurrency: z.ZodDefault<z.ZodNumber>;
+        maxModelCalls: z.ZodDefault<z.ZodNumber>;
+        maxModelTokens: z.ZodDefault<z.ZodNumber>;
+        visionMaxEdge: z.ZodDefault<z.ZodNumber>;
+        visionTileSize: z.ZodDefault<z.ZodNumber>;
+        visionMaxTiles: z.ZodDefault<z.ZodNumber>;
+        modelMaxOutputTokens: z.ZodDefault<z.ZodNumber>;
+        summaryMaxChars: z.ZodDefault<z.ZodNumber>;
+        figureMaxChars: z.ZodDefault<z.ZodNumber>;
+        pdfMaxPages: z.ZodDefault<z.ZodNumber>;
+        pdfMaxPagePixels: z.ZodDefault<z.ZodNumber>;
+        pdfPageTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        libreOfficePath: z.ZodDefault<z.ZodString>;
+        visionProvider: z.ZodDefault<z.ZodString>;
+        visionModel: z.ZodDefault<z.ZodString>;
+        summaryProvider: z.ZodDefault<z.ZodString>;
+        summaryModel: z.ZodDefault<z.ZodString>;
+        skipImages: z.ZodDefault<z.ZodBoolean>;
+        acceptPartial: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>;
+    state: z.ZodEnum<{
+        failed: "failed";
+        "needs-review": "needs-review";
+        queued: "queued";
+        preflight: "preflight";
+        converting: "converting";
+        describing: "describing";
+        splitting: "splitting";
+        indexing: "indexing";
+        validating: "validating";
+        publishing: "publishing";
+        "paused-budget": "paused-budget";
+        cancelled: "cancelled";
+        ready: "ready";
+    }>;
+    sourceOriginalHash: z.ZodString;
+    routes: z.ZodObject<{
+        vision: z.ZodNullable<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>>;
+        summary: z.ZodNullable<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    schemaHash: z.ZodString;
+    sessionId: z.ZodNullable<z.ZodString>;
+    progress: z.ZodObject<{
+        totalPages: z.ZodOptional<z.ZodNumber>;
+        parsedPages: z.ZodOptional<z.ZodNumber>;
+        ocrPages: z.ZodOptional<z.ZodNumber>;
+        tables: z.ZodOptional<z.ZodNumber>;
+        blocks: z.ZodOptional<z.ZodNumber>;
+        currentPage: z.ZodOptional<z.ZodNumber>;
+        totalFigures: z.ZodOptional<z.ZodNumber>;
+        completedFigures: z.ZodOptional<z.ZodNumber>;
+        inflightFigures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            occurrenceId: z.ZodString;
+            caption: z.ZodString;
+        }, z.core.$strip>>>;
+        totalChunks: z.ZodOptional<z.ZodNumber>;
+        indexedChunks: z.ZodOptional<z.ZodNumber>;
+        currentChunk: z.ZodOptional<z.ZodObject<{
+            title: z.ZodString;
+            headingPath: z.ZodArray<z.ZodString>;
+            chunkId: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    failures: z.ZodArray<z.ZodObject<{
+        at: z.ZodString;
+        stage: z.ZodEnum<{
+            failed: "failed";
+            "needs-review": "needs-review";
+            queued: "queued";
+            preflight: "preflight";
+            converting: "converting";
+            describing: "describing";
+            splitting: "splitting";
+            indexing: "indexing";
+            validating: "validating";
+            publishing: "publishing";
+            "paused-budget": "paused-budget";
+            cancelled: "cancelled";
+            ready: "ready";
+        }>;
+        error: z.ZodString;
+    }, z.core.$strip>>;
+    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        at: z.ZodString;
+        state: z.ZodEnum<{
+            failed: "failed";
+            "needs-review": "needs-review";
+            queued: "queued";
+            preflight: "preflight";
+            converting: "converting";
+            describing: "describing";
+            splitting: "splitting";
+            indexing: "indexing";
+            validating: "validating";
+            publishing: "publishing";
+            "paused-budget": "paused-budget";
+            cancelled: "cancelled";
+            ready: "ready";
+        }>;
+    }, z.core.$strip>>>;
+    figureRefresh: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        occurrenceId: z.ZodString;
+        token: z.ZodString;
+    }, z.core.$strip>>>;
+    visionCapability: z.ZodOptional<z.ZodString>;
+    recoveredAt: z.ZodOptional<z.ZodString>;
+    finishedAt: z.ZodOptional<z.ZodString>;
+    cancelRequested: z.ZodOptional<z.ZodBoolean>;
+    outputPath: z.ZodNullable<z.ZodString>;
+    reused: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PublicJob = z.infer<typeof publicJobSchema>;
+export declare const locationSchema: z.ZodObject<{
+    kbPath: z.ZodString;
+    revision: z.ZodNullable<z.ZodString>;
+    wikiPath: z.ZodNullable<z.ZodString>;
+    indexPath: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const libraryViewSchema: z.ZodObject<{
+    kbId: z.ZodString;
+    name: z.ZodString;
+    createdAt: z.ZodString;
+    deletedAt: z.ZodOptional<z.ZodString>;
+    purge: z.ZodOptional<z.ZodObject<{
+        startedAt: z.ZodString;
+        jobIds: z.ZodArray<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    location: z.ZodObject<{
+        kbPath: z.ZodString;
+        revision: z.ZodNullable<z.ZodString>;
+        wikiPath: z.ZodNullable<z.ZodString>;
+        indexPath: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    summary: z.ZodObject<{
+        revision: z.ZodNullable<z.ZodString>;
+        documentCount: z.ZodNumber;
+        chunkCount: z.ZodNumber;
+        coverageIncomplete: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type LibraryView = z.infer<typeof libraryViewSchema>;
+export declare const stateSchema: z.ZodObject<{
+    hostVersion: z.ZodString;
+    kbs: z.ZodArray<z.ZodObject<{
+        kbId: z.ZodString;
+        name: z.ZodString;
+        createdAt: z.ZodString;
+        deletedAt: z.ZodOptional<z.ZodString>;
+        purge: z.ZodOptional<z.ZodObject<{
+            startedAt: z.ZodString;
+            jobIds: z.ZodArray<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        location: z.ZodObject<{
+            kbPath: z.ZodString;
+            revision: z.ZodNullable<z.ZodString>;
+            wikiPath: z.ZodNullable<z.ZodString>;
+            indexPath: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        summary: z.ZodObject<{
+            revision: z.ZodNullable<z.ZodString>;
+            documentCount: z.ZodNumber;
+            chunkCount: z.ZodNumber;
+            coverageIncomplete: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    deletedKbs: z.ZodArray<z.ZodObject<{
+        kbId: z.ZodString;
+        name: z.ZodString;
+        createdAt: z.ZodString;
+        deletedAt: z.ZodOptional<z.ZodString>;
+        purge: z.ZodOptional<z.ZodObject<{
+            startedAt: z.ZodString;
+            jobIds: z.ZodArray<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    activities: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        eventId: z.ZodString;
+        at: z.ZodString;
+        action: z.ZodEnum<{
+            purge: "purge";
+            create: "create";
+            trash: "trash";
+            restore: "restore";
+        }>;
+        kbId: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>>;
+    jobs: z.ZodArray<z.ZodObject<{
+        error: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kbId: z.ZodString;
+        title: z.ZodString;
+        sourceVersion: z.ZodString;
+        docId: z.ZodString;
+        pageStart: z.ZodOptional<z.ZodNumber>;
+        pageEnd: z.ZodOptional<z.ZodNumber>;
+        jobId: z.ZodString;
+        revision: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        pdf: z.ZodOptional<z.ZodObject<{
+            pageCount: z.ZodNumber;
+            selectedPages: z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+                count: z.ZodNumber;
+                total: z.ZodNumber;
+                partial: z.ZodBoolean;
+            }, z.core.$strip>;
+            outlineCount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        sourceFormat: z.ZodDefault<z.ZodEnum<{
+            docx: "docx";
+            pdf: "pdf";
+        }>>;
+        parserVersion: z.ZodOptional<z.ZodString>;
+        sourceHash: z.ZodOptional<z.ZodString>;
+        filename: z.ZodString;
+        usage: z.ZodObject<{
+            calls: z.ZodNumber;
+            tokens: z.ZodNumber;
+            reportedCalls: z.ZodNumber;
+            records: z.ZodArray<z.ZodJSONSchema>;
+        }, z.core.$strip>;
+        report: z.ZodOptional<z.ZodObject<{
+            revision: z.ZodString;
+            sourceHash: z.ZodString;
+            issues: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+                blocking: z.ZodBoolean;
+                page: z.ZodOptional<z.ZodNumber>;
+                kind: z.ZodOptional<z.ZodString>;
+                snippet: z.ZodOptional<z.ZodString>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            documents: z.ZodNumber;
+            blocks: z.ZodNumber;
+            figures: z.ZodNumber;
+            ignoredFigures: z.ZodNumber;
+            unreviewedFigures: z.ZodNumber;
+            chunks: z.ZodNumber;
+            withinTarget: z.ZodNumber;
+            oversized: z.ZodArray<z.ZodObject<{
+                chunkId: z.ZodString;
+                chars: z.ZodNumber;
+                reason: z.ZodString;
+            }, z.core.$strip>>;
+            usage: z.ZodObject<{
+                calls: z.ZodNumber;
+                tokens: z.ZodNumber;
+                reportedCalls: z.ZodNumber;
+                records: z.ZodArray<z.ZodJSONSchema>;
+            }, z.core.$strip>;
+            targetChars: z.ZodNumber;
+            pdf: z.ZodOptional<z.ZodObject<{
+                pageCount: z.ZodNumber;
+                selectedPages: z.ZodObject<{
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                    count: z.ZodNumber;
+                    total: z.ZodNumber;
+                    partial: z.ZodBoolean;
+                }, z.core.$strip>;
+                outlineCount: z.ZodNumber;
+                matchedBookmarks: z.ZodNumber;
+                ocrPages: z.ZodNumber;
+                pages: z.ZodArray<z.ZodObject<{
+                    page: z.ZodNumber;
+                    width: z.ZodOptional<z.ZodNumber>;
+                    height: z.ZodOptional<z.ZodNumber>;
+                    pageLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    status: z.ZodEnum<{
+                        failed: "failed";
+                        "needs-review": "needs-review";
+                        navigation: "navigation";
+                        parsed: "parsed";
+                    }>;
+                    ocr: z.ZodBoolean;
+                    spanCount: z.ZodOptional<z.ZodNumber>;
+                    artifactCount: z.ZodOptional<z.ZodNumber>;
+                    excluded: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        kind: z.ZodString;
+                        text: z.ZodOptional<z.ZodString>;
+                        bbox: z.ZodNullable<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                    }, z.core.$strip>>>;
+                    tables: z.ZodNumber;
+                    figures: z.ZodNumber;
+                    headings: z.ZodArray<z.ZodObject<{
+                        text: z.ZodString;
+                        basis: z.ZodOptional<z.ZodString>;
+                        level: z.ZodNumber;
+                    }, z.core.$strip>>;
+                    previewAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    error: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        buildKey: z.ZodString;
+        createdAt: z.ZodString;
+        config: z.ZodObject<{
+            dataRoot: z.ZodString;
+            chunkTargetChars: z.ZodDefault<z.ZodNumber>;
+            evidenceMaxChars: z.ZodDefault<z.ZodNumber>;
+            catalogMaxChars: z.ZodDefault<z.ZodNumber>;
+            candidateLimit: z.ZodDefault<z.ZodNumber>;
+            maxInputBytes: z.ZodDefault<z.ZodNumber>;
+            maxUncompressedBytes: z.ZodDefault<z.ZodNumber>;
+            maxArchiveEntries: z.ZodDefault<z.ZodNumber>;
+            modelTimeoutMs: z.ZodDefault<z.ZodNumber>;
+            modelAttempts: z.ZodDefault<z.ZodNumber>;
+            visionConcurrency: z.ZodDefault<z.ZodNumber>;
+            maxModelCalls: z.ZodDefault<z.ZodNumber>;
+            maxModelTokens: z.ZodDefault<z.ZodNumber>;
+            visionMaxEdge: z.ZodDefault<z.ZodNumber>;
+            visionTileSize: z.ZodDefault<z.ZodNumber>;
+            visionMaxTiles: z.ZodDefault<z.ZodNumber>;
+            modelMaxOutputTokens: z.ZodDefault<z.ZodNumber>;
+            summaryMaxChars: z.ZodDefault<z.ZodNumber>;
+            figureMaxChars: z.ZodDefault<z.ZodNumber>;
+            pdfMaxPages: z.ZodDefault<z.ZodNumber>;
+            pdfMaxPagePixels: z.ZodDefault<z.ZodNumber>;
+            pdfPageTimeoutMs: z.ZodDefault<z.ZodNumber>;
+            libreOfficePath: z.ZodDefault<z.ZodString>;
+            visionProvider: z.ZodDefault<z.ZodString>;
+            visionModel: z.ZodDefault<z.ZodString>;
+            summaryProvider: z.ZodDefault<z.ZodString>;
+            summaryModel: z.ZodDefault<z.ZodString>;
+            skipImages: z.ZodDefault<z.ZodBoolean>;
+            acceptPartial: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>;
+        state: z.ZodEnum<{
+            failed: "failed";
+            "needs-review": "needs-review";
+            queued: "queued";
+            preflight: "preflight";
+            converting: "converting";
+            describing: "describing";
+            splitting: "splitting";
+            indexing: "indexing";
+            validating: "validating";
+            publishing: "publishing";
+            "paused-budget": "paused-budget";
+            cancelled: "cancelled";
+            ready: "ready";
+        }>;
+        sourceOriginalHash: z.ZodString;
+        routes: z.ZodObject<{
+            vision: z.ZodNullable<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+            }, z.core.$strip>>;
+            summary: z.ZodNullable<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        schemaHash: z.ZodString;
+        sessionId: z.ZodNullable<z.ZodString>;
+        progress: z.ZodObject<{
+            totalPages: z.ZodOptional<z.ZodNumber>;
+            parsedPages: z.ZodOptional<z.ZodNumber>;
+            ocrPages: z.ZodOptional<z.ZodNumber>;
+            tables: z.ZodOptional<z.ZodNumber>;
+            blocks: z.ZodOptional<z.ZodNumber>;
+            currentPage: z.ZodOptional<z.ZodNumber>;
+            totalFigures: z.ZodOptional<z.ZodNumber>;
+            completedFigures: z.ZodOptional<z.ZodNumber>;
+            inflightFigures: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                occurrenceId: z.ZodString;
+                caption: z.ZodString;
+            }, z.core.$strip>>>;
+            totalChunks: z.ZodOptional<z.ZodNumber>;
+            indexedChunks: z.ZodOptional<z.ZodNumber>;
+            currentChunk: z.ZodOptional<z.ZodObject<{
+                title: z.ZodString;
+                headingPath: z.ZodArray<z.ZodString>;
+                chunkId: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        failures: z.ZodArray<z.ZodObject<{
+            at: z.ZodString;
+            stage: z.ZodEnum<{
+                failed: "failed";
+                "needs-review": "needs-review";
+                queued: "queued";
+                preflight: "preflight";
+                converting: "converting";
+                describing: "describing";
+                splitting: "splitting";
+                indexing: "indexing";
+                validating: "validating";
+                publishing: "publishing";
+                "paused-budget": "paused-budget";
+                cancelled: "cancelled";
+                ready: "ready";
+            }>;
+            error: z.ZodString;
+        }, z.core.$strip>>;
+        events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            at: z.ZodString;
+            state: z.ZodEnum<{
+                failed: "failed";
+                "needs-review": "needs-review";
+                queued: "queued";
+                preflight: "preflight";
+                converting: "converting";
+                describing: "describing";
+                splitting: "splitting";
+                indexing: "indexing";
+                validating: "validating";
+                publishing: "publishing";
+                "paused-budget": "paused-budget";
+                cancelled: "cancelled";
+                ready: "ready";
+            }>;
+        }, z.core.$strip>>>;
+        figureRefresh: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            occurrenceId: z.ZodString;
+            token: z.ZodString;
+        }, z.core.$strip>>>;
+        visionCapability: z.ZodOptional<z.ZodString>;
+        recoveredAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodString>;
+        cancelRequested: z.ZodOptional<z.ZodBoolean>;
+        outputPath: z.ZodNullable<z.ZodString>;
+        reused: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    dataRoot: z.ZodString;
+    config: z.ZodObject<{
+        chunkTargetChars: z.ZodNumber;
+        visionProvider: z.ZodString;
+        visionModel: z.ZodString;
+        maxInputBytes: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type State = z.infer<typeof stateSchema>;
+export declare const treeDocumentSchema: z.ZodObject<{
+    docId: z.ZodString;
+    title: z.ZodString;
+    filename: z.ZodString;
+    sourceHash: z.ZodString;
+    sourceVersion: z.ZodString;
+    sourceFormat: z.ZodOptional<z.ZodEnum<{
+        docx: "docx";
+        pdf: "pdf";
+    }>>;
+    pageCount: z.ZodOptional<z.ZodNumber>;
+    selectedPages: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        count: z.ZodNumber;
+        total: z.ZodNumber;
+        partial: z.ZodBoolean;
+    }, z.core.$strip>>;
+    parserVersion: z.ZodOptional<z.ZodString>;
+    audit: z.ZodOptional<z.ZodObject<{
+        pages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            page: z.ZodNumber;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            pageLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            status: z.ZodEnum<{
+                failed: "failed";
+                "needs-review": "needs-review";
+                navigation: "navigation";
+                parsed: "parsed";
+            }>;
+            ocr: z.ZodBoolean;
+            spanCount: z.ZodOptional<z.ZodNumber>;
+            artifactCount: z.ZodOptional<z.ZodNumber>;
+            excluded: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                kind: z.ZodString;
+                text: z.ZodOptional<z.ZodString>;
+                bbox: z.ZodNullable<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            }, z.core.$strip>>>;
+            tables: z.ZodNumber;
+            figures: z.ZodNumber;
+            headings: z.ZodArray<z.ZodObject<{
+                text: z.ZodString;
+                basis: z.ZodOptional<z.ZodString>;
+                level: z.ZodNumber;
+            }, z.core.$strip>>;
+            previewAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        outlineCount: z.ZodDefault<z.ZodNumber>;
+        matchedBookmarks: z.ZodDefault<z.ZodNumber>;
+        convertedFigures: z.ZodNumber;
+        convertedTables: z.ZodNumber;
+        warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            blocking: z.ZodBoolean;
+            page: z.ZodOptional<z.ZodNumber>;
+            kind: z.ZodOptional<z.ZodString>;
+            snippet: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        styleLevels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        headingLevels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        outlineLevels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        expectedFigures: z.ZodOptional<z.ZodNumber>;
+        expectedTables: z.ZodOptional<z.ZodNumber>;
+        expectedHeadings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        textBoxes: z.ZodOptional<z.ZodNumber>;
+        footnoteRefs: z.ZodOptional<z.ZodNumber>;
+        anchors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        rawMediaCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    chunkTargetChars: z.ZodOptional<z.ZodNumber>;
+    nodes: z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        title: z.ZodString;
+        level: z.ZodNumber;
+        parentId: z.ZodNullable<z.ZodString>;
+        headingPath: z.ZodArray<z.ZodString>;
+        children: z.ZodArray<z.ZodString>;
+        anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        indexPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    assets: z.ZodArray<z.ZodObject<{
+        assetId: z.ZodString;
+        mime: z.ZodString;
+        path: z.ZodString;
+        bytes: z.ZodNumber;
+        origin: z.ZodString;
+        source: z.ZodOptional<z.ZodType<import("./data.ts").Source, unknown, z.core.$ZodTypeInternals<import("./data.ts").Source, unknown>>>;
+    }, z.core.$strip>>;
+    coverageIncomplete: z.ZodOptional<z.ZodBoolean>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        blocking: z.ZodBoolean;
+        page: z.ZodOptional<z.ZodNumber>;
+        kind: z.ZodOptional<z.ZodString>;
+        snippet: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    chunks: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        sourceVersion: z.ZodString;
+        docId: z.ZodString;
+        nodeId: z.ZodString;
+        keywords: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        chunkId: z.ZodString;
+        summary: z.ZodDefault<z.ZodString>;
+        path: z.ZodString;
+        headingPath: z.ZodArray<z.ZodString>;
+        oversizedReason: z.ZodOptional<z.ZodString>;
+        sourceFormat: z.ZodOptional<z.ZodEnum<{
+            docx: "docx";
+            pdf: "pdf";
+        }>>;
+        selectedPages: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            count: z.ZodNumber;
+            total: z.ZodNumber;
+            partial: z.ZodBoolean;
+        }, z.core.$strip>>;
+        sourceHash: z.ZodString;
+        sourceLocations: z.ZodOptional<z.ZodArray<z.ZodType<import("./data.ts").Source, unknown, z.core.$ZodTypeInternals<import("./data.ts").Source, unknown>>>>;
+        blockRange: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+        assetRefs: z.ZodArray<z.ZodString>;
+        tableRefs: z.ZodArray<z.ZodString>;
+        relatedChunks: z.ZodArray<z.ZodString>;
+        reviewStatus: z.ZodEnum<{
+            source: "source";
+            generated: "generated";
+            "needs-review": "needs-review";
+        }>;
+        pageRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        fullChars: z.ZodNumber;
+        bodyChars: z.ZodNumber;
+        contentHash: z.ZodString;
+        summaryFallback: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    figures: z.ZodArray<z.ZodObject<{
+        types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            architecture: "architecture";
+            pinout: "pinout";
+            schematic: "schematic";
+            timing: "timing";
+            flowchart: "flowchart";
+            table: "table";
+            curve: "curve";
+            other: "other";
+            decoration: "decoration";
+        }>>>;
+        visibleLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        description: z.ZodOptional<z.ZodString>;
+        relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        uncertainties: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        contextNotes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        pins: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>>;
+        timingConstraints: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>>;
+        tableRows: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>>;
+        status: z.ZodEnum<{
+            decoration: "decoration";
+            generated: "generated";
+            failed: "failed";
+            skipped: "skipped";
+            ignored: "ignored";
+            reviewed: "reviewed";
+        }>;
+        assetId: z.ZodString;
+        occurrenceId: z.ZodString;
+        caption: z.ZodDefault<z.ZodString>;
+        cacheKey: z.ZodString;
+        overlayKey: z.ZodString;
+        overlayHash: z.ZodString;
+        humanReviewed: z.ZodDefault<z.ZodBoolean>;
+        needsReview: z.ZodDefault<z.ZodBoolean>;
+        error: z.ZodOptional<z.ZodString>;
+        classification: z.ZodOptional<z.ZodObject<{
+            types: z.ZodArray<z.ZodEnum<{
+                architecture: "architecture";
+                pinout: "pinout";
+                schematic: "schematic";
+                timing: "timing";
+                flowchart: "flowchart";
+                table: "table";
+                curve: "curve";
+                other: "other";
+                decoration: "decoration";
+            }>>;
+            reason: z.ZodString;
+        }, z.core.$strip>>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        model: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>>;
+        promptVersion: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodObject<{
+            headingPath: z.ZodArray<z.ZodString>;
+            caption: z.ZodOptional<z.ZodString>;
+            nearby: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+        source: z.ZodOptional<z.ZodType<import("./data.ts").Source, unknown, z.core.$ZodTypeInternals<import("./data.ts").Source, unknown>>>;
+        nativeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        refreshToken: z.ZodOptional<z.ZodString>;
+        ignore: z.ZodOptional<z.ZodBoolean>;
+        skip: z.ZodOptional<z.ZodBoolean>;
+        previous: z.ZodOptional<z.ZodNullable<z.ZodType<import("./data.ts").Overlay, unknown, z.core.$ZodTypeInternals<import("./data.ts").Overlay, unknown>>>>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        expectedHash: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const treeSchema: z.ZodObject<{
+    kbId: z.ZodString;
+    revision: z.ZodString;
+    location: z.ZodOptional<z.ZodObject<{
+        kbPath: z.ZodString;
+        revision: z.ZodNullable<z.ZodString>;
+        wikiPath: z.ZodNullable<z.ZodString>;
+        indexPath: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    previewJobId: z.ZodOptional<z.ZodString>;
+    coverageIncomplete: z.ZodBoolean;
+    report: z.ZodObject<{
+        revision: z.ZodString;
+        sourceHash: z.ZodString;
+        issues: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            blocking: z.ZodBoolean;
+            page: z.ZodOptional<z.ZodNumber>;
+            kind: z.ZodOptional<z.ZodString>;
+            snippet: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        documents: z.ZodNumber;
+        blocks: z.ZodNumber;
+        figures: z.ZodNumber;
+        ignoredFigures: z.ZodNumber;
+        unreviewedFigures: z.ZodNumber;
+        chunks: z.ZodNumber;
+        withinTarget: z.ZodNumber;
+        oversized: z.ZodArray<z.ZodObject<{
+            chunkId: z.ZodString;
+            chars: z.ZodNumber;
+            reason: z.ZodString;
+        }, z.core.$strip>>;
+        usage: z.ZodObject<{
+            calls: z.ZodNumber;
+            tokens: z.ZodNumber;
+            reportedCalls: z.ZodNumber;
+            records: z.ZodArray<z.ZodJSONSchema>;
+        }, z.core.$strip>;
+        targetChars: z.ZodNumber;
+        pdf: z.ZodOptional<z.ZodObject<{
+            pageCount: z.ZodNumber;
+            selectedPages: z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+                count: z.ZodNumber;
+                total: z.ZodNumber;
+                partial: z.ZodBoolean;
+            }, z.core.$strip>;
+            outlineCount: z.ZodNumber;
+            matchedBookmarks: z.ZodNumber;
+            ocrPages: z.ZodNumber;
+            pages: z.ZodArray<z.ZodObject<{
+                page: z.ZodNumber;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                pageLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    "needs-review": "needs-review";
+                    navigation: "navigation";
+                    parsed: "parsed";
+                }>;
+                ocr: z.ZodBoolean;
+                spanCount: z.ZodOptional<z.ZodNumber>;
+                artifactCount: z.ZodOptional<z.ZodNumber>;
+                excluded: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    kind: z.ZodString;
+                    text: z.ZodOptional<z.ZodString>;
+                    bbox: z.ZodNullable<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                }, z.core.$strip>>>;
+                tables: z.ZodNumber;
+                figures: z.ZodNumber;
+                headings: z.ZodArray<z.ZodObject<{
+                    text: z.ZodString;
+                    basis: z.ZodOptional<z.ZodString>;
+                    level: z.ZodNumber;
+                }, z.core.$strip>>;
+                previewAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                error: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    documents: z.ZodArray<z.ZodObject<{
+        docId: z.ZodString;
+        title: z.ZodString;
+        filename: z.ZodString;
+        sourceHash: z.ZodString;
+        sourceVersion: z.ZodString;
+        sourceFormat: z.ZodOptional<z.ZodEnum<{
+            docx: "docx";
+            pdf: "pdf";
+        }>>;
+        pageCount: z.ZodOptional<z.ZodNumber>;
+        selectedPages: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            count: z.ZodNumber;
+            total: z.ZodNumber;
+            partial: z.ZodBoolean;
+        }, z.core.$strip>>;
+        parserVersion: z.ZodOptional<z.ZodString>;
+        audit: z.ZodOptional<z.ZodObject<{
+            pages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                page: z.ZodNumber;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                pageLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    "needs-review": "needs-review";
+                    navigation: "navigation";
+                    parsed: "parsed";
+                }>;
+                ocr: z.ZodBoolean;
+                spanCount: z.ZodOptional<z.ZodNumber>;
+                artifactCount: z.ZodOptional<z.ZodNumber>;
+                excluded: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    kind: z.ZodString;
+                    text: z.ZodOptional<z.ZodString>;
+                    bbox: z.ZodNullable<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                }, z.core.$strip>>>;
+                tables: z.ZodNumber;
+                figures: z.ZodNumber;
+                headings: z.ZodArray<z.ZodObject<{
+                    text: z.ZodString;
+                    basis: z.ZodOptional<z.ZodString>;
+                    level: z.ZodNumber;
+                }, z.core.$strip>>;
+                previewAssetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                error: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            outlineCount: z.ZodDefault<z.ZodNumber>;
+            matchedBookmarks: z.ZodDefault<z.ZodNumber>;
+            convertedFigures: z.ZodNumber;
+            convertedTables: z.ZodNumber;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+                blocking: z.ZodBoolean;
+                page: z.ZodOptional<z.ZodNumber>;
+                kind: z.ZodOptional<z.ZodString>;
+                snippet: z.ZodOptional<z.ZodString>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            styleLevels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            headingLevels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            outlineLevels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            expectedFigures: z.ZodOptional<z.ZodNumber>;
+            expectedTables: z.ZodOptional<z.ZodNumber>;
+            expectedHeadings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            textBoxes: z.ZodOptional<z.ZodNumber>;
+            footnoteRefs: z.ZodOptional<z.ZodNumber>;
+            anchors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            rawMediaCount: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        chunkTargetChars: z.ZodOptional<z.ZodNumber>;
+        nodes: z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            title: z.ZodString;
+            level: z.ZodNumber;
+            parentId: z.ZodNullable<z.ZodString>;
+            headingPath: z.ZodArray<z.ZodString>;
+            children: z.ZodArray<z.ZodString>;
+            anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            indexPath: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        assets: z.ZodArray<z.ZodObject<{
+            assetId: z.ZodString;
+            mime: z.ZodString;
+            path: z.ZodString;
+            bytes: z.ZodNumber;
+            origin: z.ZodString;
+            source: z.ZodOptional<z.ZodType<import("./data.ts").Source, unknown, z.core.$ZodTypeInternals<import("./data.ts").Source, unknown>>>;
+        }, z.core.$strip>>;
+        coverageIncomplete: z.ZodOptional<z.ZodBoolean>;
+        warnings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            blocking: z.ZodBoolean;
+            page: z.ZodOptional<z.ZodNumber>;
+            kind: z.ZodOptional<z.ZodString>;
+            snippet: z.ZodOptional<z.ZodString>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        chunks: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            sourceVersion: z.ZodString;
+            docId: z.ZodString;
+            nodeId: z.ZodString;
+            keywords: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            chunkId: z.ZodString;
+            summary: z.ZodDefault<z.ZodString>;
+            path: z.ZodString;
+            headingPath: z.ZodArray<z.ZodString>;
+            oversizedReason: z.ZodOptional<z.ZodString>;
+            sourceFormat: z.ZodOptional<z.ZodEnum<{
+                docx: "docx";
+                pdf: "pdf";
+            }>>;
+            selectedPages: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+                count: z.ZodNumber;
+                total: z.ZodNumber;
+                partial: z.ZodBoolean;
+            }, z.core.$strip>>;
+            sourceHash: z.ZodString;
+            sourceLocations: z.ZodOptional<z.ZodArray<z.ZodType<import("./data.ts").Source, unknown, z.core.$ZodTypeInternals<import("./data.ts").Source, unknown>>>>;
+            blockRange: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+            assetRefs: z.ZodArray<z.ZodString>;
+            tableRefs: z.ZodArray<z.ZodString>;
+            relatedChunks: z.ZodArray<z.ZodString>;
+            reviewStatus: z.ZodEnum<{
+                source: "source";
+                generated: "generated";
+                "needs-review": "needs-review";
+            }>;
+            pageRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            fullChars: z.ZodNumber;
+            bodyChars: z.ZodNumber;
+            contentHash: z.ZodString;
+            summaryFallback: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        figures: z.ZodArray<z.ZodObject<{
+            types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                architecture: "architecture";
+                pinout: "pinout";
+                schematic: "schematic";
+                timing: "timing";
+                flowchart: "flowchart";
+                table: "table";
+                curve: "curve";
+                other: "other";
+                decoration: "decoration";
+            }>>>;
+            visibleLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            description: z.ZodOptional<z.ZodString>;
+            relations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strip>>>;
+            uncertainties: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            contextNotes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            pins: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>>;
+            timingConstraints: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>>;
+            tableRows: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>>;
+            status: z.ZodEnum<{
+                decoration: "decoration";
+                generated: "generated";
+                failed: "failed";
+                skipped: "skipped";
+                ignored: "ignored";
+                reviewed: "reviewed";
+            }>;
+            assetId: z.ZodString;
+            occurrenceId: z.ZodString;
+            caption: z.ZodDefault<z.ZodString>;
+            cacheKey: z.ZodString;
+            overlayKey: z.ZodString;
+            overlayHash: z.ZodString;
+            humanReviewed: z.ZodDefault<z.ZodBoolean>;
+            needsReview: z.ZodDefault<z.ZodBoolean>;
+            error: z.ZodOptional<z.ZodString>;
+            classification: z.ZodOptional<z.ZodObject<{
+                types: z.ZodArray<z.ZodEnum<{
+                    architecture: "architecture";
+                    pinout: "pinout";
+                    schematic: "schematic";
+                    timing: "timing";
+                    flowchart: "flowchart";
+                    table: "table";
+                    curve: "curve";
+                    other: "other";
+                    decoration: "decoration";
+                }>>;
+                reason: z.ZodString;
+            }, z.core.$strip>>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            model: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodString;
+                model: z.ZodString;
+            }, z.core.$strip>>;
+            promptVersion: z.ZodOptional<z.ZodString>;
+            context: z.ZodOptional<z.ZodObject<{
+                headingPath: z.ZodArray<z.ZodString>;
+                caption: z.ZodOptional<z.ZodString>;
+                nearby: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>;
+            source: z.ZodOptional<z.ZodType<import("./data.ts").Source, unknown, z.core.$ZodTypeInternals<import("./data.ts").Source, unknown>>>;
+            nativeLabels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            refreshToken: z.ZodOptional<z.ZodString>;
+            ignore: z.ZodOptional<z.ZodBoolean>;
+            skip: z.ZodOptional<z.ZodBoolean>;
+            previous: z.ZodOptional<z.ZodNullable<z.ZodType<import("./data.ts").Overlay, unknown, z.core.$ZodTypeInternals<import("./data.ts").Overlay, unknown>>>>;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            expectedHash: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Tree = z.infer<typeof treeSchema>;
+export type TreeDocument = z.infer<typeof treeDocumentSchema>;
+export declare const readSchema: z.ZodObject<{
+    kbId: z.ZodString;
+    chunkId: z.ZodString;
+    revision: z.ZodString;
+    text: z.ZodString;
+    complete: z.ZodBoolean;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+    previewJobId: z.ZodOptional<z.ZodString>;
+    continuation: z.ZodNullable<z.ZodObject<{
+        segmentIndex: z.ZodNumber;
+        offset: z.ZodNumber;
+    }, z.core.$strip>>;
+    assetRefs: z.ZodArray<z.ZodString>;
+    relatedChunks: z.ZodArray<z.ZodString>;
+    warnings: z.ZodArray<z.ZodString>;
+    source: z.ZodObject<{
+        docId: z.ZodString;
+        title: z.ZodString;
+        sourceVersion: z.ZodString;
+        sourceHash: z.ZodString;
+        revision: z.ZodString;
+        headingPath: z.ZodArray<z.ZodString>;
+        path: z.ZodString;
+        contentHash: z.ZodString;
+        sourceFormat: z.ZodOptional<z.ZodLiteral<"pdf">>;
+        pageCount: z.ZodOptional<z.ZodNumber>;
+        selectedPages: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            count: z.ZodNumber;
+            total: z.ZodNumber;
+            partial: z.ZodBoolean;
+        }, z.core.$strip>>;
+        pageRange: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        scope: z.ZodOptional<z.ZodString>;
+        locations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            page: z.ZodNumber;
+            pageLabel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            method: z.ZodString;
+            bbox: z.ZodNullable<z.ZodArray<z.ZodNumber>>;
+            caption: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        locationsTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ReadResult = z.infer<typeof readSchema>;
+export declare const searchResultSchema: z.ZodObject<{
+    kbId: z.ZodString;
+    revision: z.ZodString;
+    query: z.ZodString;
+    totalCandidates: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    candidates: z.ZodArray<z.ZodObject<{
+        chunkId: z.ZodString;
+        title: z.ZodString;
+        summary: z.ZodString;
+        fullChars: z.ZodNumber;
+        reviewStatus: z.ZodString;
+    }, z.core.$strip>>;
+    evidence: z.ZodArray<z.ZodUnknown>;
+    warnings: z.ZodArray<z.ZodObject<{
+        docId: z.ZodOptional<z.ZodString>;
+        chunkId: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SearchResult = z.infer<typeof searchResultSchema>;
+export declare const modelsSchema: z.ZodObject<{
+    providers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        models: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            inputModalities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ModelDirectory = z.infer<typeof modelsSchema>;
+export declare const schemaResultSchema: z.ZodObject<{
+    content: z.ZodString;
+    hash: z.ZodString;
+}, z.core.$strip>;
+export declare const inspectSchema: z.ZodObject<{
+    sourceFormat: z.ZodLiteral<"pdf">;
+    pageCount: z.ZodNumber;
+    outlineCount: z.ZodNumber;
+    samples: z.ZodArray<z.ZodObject<{
+        page: z.ZodNumber;
+        chars: z.ZodNumber;
+        hasGraphics: z.ZodBoolean;
+        possibleOcr: z.ZodBoolean;
+        hasStructure: z.ZodBoolean;
+    }, z.core.$strip>>;
+    possibleOcr: z.ZodBoolean;
+    note: z.ZodString;
+}, z.core.$strip>;
+export type Inspection = z.infer<typeof inspectSchema>;
+export declare const uploadResultSchema: z.ZodObject<{
+    receiptId: z.ZodString;
+    filename: z.ZodString;
+    bytes: z.ZodNumber;
+}, z.core.$strip>;