dsh-ab-ocr 0.1.0

package/lib/config.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Deployment configuration of the ocr tool.
+ *
+ * The fields fall into two groups. The first is a bound or a cost policy the
+ * deployment owns: the render resolution, the per-page pixel ceiling, the page,
+ * file, call, and startup ceilings, the outline candidate ceiling, the engine
+ * lifetime, and whether per-page text is kept at all. None of them carries a
+ * default, because a hidden one would state an agreement the deployment never
+ * made; a row that omits one fails to load and names the field.
+ *
+ * The second group is a resolution rule or a recognition heuristic — where the
+ * interpreter, the worker, and the artifacts are found, and how a page is read
+ * and merged. Their defaults are what a document reader wants, they are stated
+ * here rather than computed anywhere, and a deployment overrides the ones its
+ * documents disagree with.
+ * @module @deepseek-ai/dsh-ab-ocr/config
+ */
+import z from '@deepseek-ai/schemastery';
+/** Deployment-varying values for the worker, the render, and the merge. */
+export interface Config {
+    /** Python executable carrying the OCR dependencies; empty auto-detects the bundled environment. */
+    pythonPath: string;
+    /** Worker script to run; empty uses the script shipped inside this package. */
+    workerScript: string;
+    /** Directory the Markdown files go to; empty writes beside each source. */
+    outputDir: string;
+    /** Directory name, inside the output directory, that holds the per-page text. */
+    pageDirName: string;
+    /** Whether each page's recognized text is written to its own file as it finishes. */
+    writePageFiles: boolean;
+    /** Resolution PDF pages are rendered at before recognition. */
+    dpi: number;
+    /** Ceiling on one rendered page's pixel count; 0 disables it. */
+    maxPixels: number;
+    /** Recognition confidence below which a text region is dropped. */
+    textScore: number;
+    /** Whether headings are inferred at all. */
+    detectHeadings: boolean;
+    /** How much taller than body text a line must be to be read as a heading by size. */
+    headingMinRatio: number;
+    /** Left-edge offset, in body glyph heights, that marks an indented first line. */
+    indentRatio: number;
+    /** Vertical gap, in body glyph heights, that separates two paragraphs. */
+    paragraphGapRatio: number;
+    /** Glyph height over body height above which a line becomes an outline candidate. */
+    outlineCandidateRatio: number;
+    /** Most outline candidates one document may offer. */
+    maxOutlineCandidates: number;
+    /** Whether a page split into reading columns is detected and read column by column. */
+    detectColumns: boolean;
+    /** Whether folios are removed from the merged document. */
+    removePageNumbers: boolean;
+    /** Whether lines that repeat in the edge bands of most pages are removed. */
+    removeRunningHeads: boolean;
+    /** Fraction of pages a repeated edge line must appear on to count as a running head. */
+    runningHeadRatio: number;
+    /** Fewest pages such a line must appear on, whatever the ratio. */
+    runningHeadMinPages: number;
+    /** perDocument rebuilds the engine for each document; shared keeps one for the whole call. */
+    engineLifetime: 'perDocument' | 'shared';
+    /** Milliseconds one recognition may take; 0 disables the ceiling. */
+    timeoutMs: number;
+    /** Milliseconds the worker's startup check may take before the call is refused. */
+    startupTimeoutMs: number;
+    /** Pages one document may carry without an explicit selection; 0 disables the guard. */
+    maxPages: number;
+    /** Documents one call may name. */
+    maxDocuments: number;
+}
+/**
+ * Schemastery configuration for the tool. A bound or a cost policy the
+ * deployment owns is `.required()`, so the row states what this deployment is
+ * willing to carry; a resolution rule or a recognition heuristic keeps its
+ * documented default.
+ */
+export declare const Config: z<Config>;
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,2EAA2E;AAC3E,MAAM,WAAW,MAAM;IACrB,mGAAmG;IACnG,UAAU,EAAE,MAAM,CAAA;IAClB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAA;IACpB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAA;IACnB,qFAAqF;IACrF,cAAc,EAAE,OAAO,CAAA;IACvB,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAA;IACX,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,cAAc,EAAE,OAAO,CAAA;IACvB,qFAAqF;IACrF,eAAe,EAAE,MAAM,CAAA;IACvB,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAA;IACzB,qFAAqF;IACrF,qBAAqB,EAAE,MAAM,CAAA;IAC7B,sDAAsD;IACtD,oBAAoB,EAAE,MAAM,CAAA;IAC5B,uFAAuF;IACvF,aAAa,EAAE,OAAO,CAAA;IACtB,2DAA2D;IAC3D,iBAAiB,EAAE,OAAO,CAAA;IAC1B,6EAA6E;IAC7E,kBAAkB,EAAE,OAAO,CAAA;IAC3B,wFAAwF;IACxF,gBAAgB,EAAE,MAAM,CAAA;IACxB,mEAAmE;IACnE,mBAAmB,EAAE,MAAM,CAAA;IAC3B,8FAA8F;IAC9F,cAAc,EAAE,aAAa,GAAG,QAAQ,CAAA;IACxC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAA;IACjB,mFAAmF;IACnF,gBAAgB,EAAE,MAAM,CAAA;IACxB,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAyB3B,CAAA"}

package/lib/config.js

@@ -0,0 +1,51 @@
+/**
+ * Deployment configuration of the ocr tool.
+ *
+ * The fields fall into two groups. The first is a bound or a cost policy the
+ * deployment owns: the render resolution, the per-page pixel ceiling, the page,
+ * file, call, and startup ceilings, the outline candidate ceiling, the engine
+ * lifetime, and whether per-page text is kept at all. None of them carries a
+ * default, because a hidden one would state an agreement the deployment never
+ * made; a row that omits one fails to load and names the field.
+ *
+ * The second group is a resolution rule or a recognition heuristic — where the
+ * interpreter, the worker, and the artifacts are found, and how a page is read
+ * and merged. Their defaults are what a document reader wants, they are stated
+ * here rather than computed anywhere, and a deployment overrides the ones its
+ * documents disagree with.
+ * @module @deepseek-ai/dsh-ab-ocr/config
+ */
+import z from '@deepseek-ai/schemastery';
+/**
+ * Schemastery configuration for the tool. A bound or a cost policy the
+ * deployment owns is `.required()`, so the row states what this deployment is
+ * willing to carry; a resolution rule or a recognition heuristic keeps its
+ * documented default.
+ */
+export const Config = z.object({
+    pythonPath: z.string().default(''),
+    workerScript: z.string().default(''),
+    outputDir: z.string().default(''),
+    pageDirName: z.string().default('.ocr-pages'),
+    writePageFiles: z.boolean().required(),
+    dpi: z.number().step(1).min(72).max(600).required(),
+    maxPixels: z.number().step(1).min(0).required(),
+    textScore: z.number().min(0).max(1).default(0.5),
+    detectHeadings: z.boolean().default(true),
+    headingMinRatio: z.number().min(1).max(4).default(1.18),
+    indentRatio: z.number().min(0).max(4).default(1),
+    paragraphGapRatio: z.number().min(0).max(4).default(0.85),
+    outlineCandidateRatio: z.number().min(1).max(4).default(1.05),
+    maxOutlineCandidates: z.number().step(1).min(1).max(10000).required(),
+    detectColumns: z.boolean().default(true),
+    removePageNumbers: z.boolean().default(true),
+    removeRunningHeads: z.boolean().default(true),
+    runningHeadRatio: z.number().min(0).max(1).default(0.6),
+    runningHeadMinPages: z.number().step(1).min(2).default(3),
+    engineLifetime: z.union(['perDocument', 'shared']).required(),
+    timeoutMs: z.number().step(1).min(1000).required(),
+    startupTimeoutMs: z.number().step(1).min(1000).required(),
+    maxPages: z.number().step(1).min(0).required(),
+    maxDocuments: z.number().step(1).min(1).max(200).required(),
+});
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

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

package/lib/documents.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Writing one recognition's artifacts: the Markdown document the reader keeps,
+ * the record a later correction reads back, the outline sheet the model
+ * corrects, and the pointer to the newest recognition.
+ *
+ * Every write goes through the mounted filesystem capability, so a deployment's
+ * file policy sees it and its own backend decides how the bytes are published.
+ * The plain Markdown name is never overwritten with different content: when it
+ * already holds another document, the new one takes the digest name.
+ * @module @deepseek-ai/dsh-ab-ocr/documents
+ */
+import type FileSystem from '@deepseek-ai/dsh-fs';
+import type { ArtifactPaths } from './artifacts.ts';
+import type { DocumentState, DoneEvent } from './events.ts';
+import { type CallFence } from './sandbox.ts';
+import type { OcrDocument, OcrOutlineEntry } from './types.ts';
+/**
+ * Read the level corrections one recognition's stored record already carries.
+ * @param fs - the mounted filesystem capability.
+ * @param path - the record's path.
+ * @param signal - caller cancellation.
+ * @returns the corrections, or undefined when there is no record or it carries none.
+ */
+export declare function carriedLevels(fs: FileSystem, path: string, signal?: AbortSignal): Promise<Record<string, number> | undefined>;
+/**
+ * Record the level each candidate's line was given.
+ *
+ * The worker reports the level the merge inferred; a correction replaces it. Both
+ * are kept, because a caller re-reading the sheet after a correction has to be
+ * able to see that the correction took, and what it took the place of.
+ * @param outline - the candidates the merge collected.
+ * @param overrides - the corrections that were applied, if any.
+ * @returns the candidates, each carrying the level the document used.
+ */
+export declare function appliedOutline(outline: OcrOutlineEntry[], overrides: Record<string, number> | undefined): OcrOutlineEntry[];
+/**
+ * Write one finished document and the record an assembly pass reads back.
+ * @param fs - the mounted filesystem capability.
+ * @param artifacts - the paths this recognition's artifacts are written to.
+ * @param state - the document's state, carrying the geometry it collected.
+ * @param markdown - the document's text, after any carried correction was applied.
+ * @param outline - the heading candidates the merge collected.
+ * @param rawOutline - the event's outline field, which may carry none.
+ * @param carried - the corrections this recognition carried forward, if any.
+ * @param signal - caller cancellation.
+ * @param fence - the per-call fence this document and its records are written under; absent on a bare backend.
+ * @returns the Markdown path this call wrote.
+ */
+export declare function writeDocument(fs: FileSystem, artifacts: ArtifactPaths, state: DocumentState, markdown: string, outline: OcrOutlineEntry[], rawOutline: unknown, carried: Record<string, number> | undefined, signal?: AbortSignal, fence?: CallFence | undefined): Promise<string>;
+/**
+ * Build the document one finished recognition reports.
+ * @param state - the document's state, carrying what its start event named.
+ * @param artifacts - the paths this recognition's artifacts were written to.
+ * @param done - the finished-document event.
+ * @param output - the Markdown path the call wrote.
+ * @param pageDir - the directory holding the per-page text, or an empty string.
+ * @param truncated - whether the heading candidate ceiling cut the outline short.
+ * @param corrections - heading-level corrections this call applied.
+ * @returns the document's canonical value.
+ */
+export declare function recognizedDocument(state: DocumentState, artifacts: ArtifactPaths, done: DoneEvent, output: string, pageDir: string, truncated: boolean, corrections: number): OcrDocument;
+//# sourceMappingURL=documents.d.ts.map

package/lib/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE3D,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,cAAc,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAqD9D;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAY7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,eAAe,EAAE,CAM3H;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EAAE,EAC1B,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC3C,MAAM,CAAC,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAC5B,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,aAAa,EACxB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,EAClB,WAAW,EAAE,MAAM,GAClB,WAAW,CAuBb"}

package/lib/documents.js

@@ -0,0 +1,173 @@
+/**
+ * Writing one recognition's artifacts: the Markdown document the reader keeps,
+ * the record a later correction reads back, the outline sheet the model
+ * corrects, and the pointer to the newest recognition.
+ *
+ * Every write goes through the mounted filesystem capability, so a deployment's
+ * file policy sees it and its own backend decides how the bytes are published.
+ * The plain Markdown name is never overwritten with different content: when it
+ * already holds another document, the new one takes the digest name.
+ * @module @deepseek-ai/dsh-ab-ocr/documents
+ */
+import { readRecord, writeJson } from "./records.js";
+import { saveText } from "./sandbox.js";
+/**
+ * Decide whether one plain Markdown path already holds this document's text.
+ * @param fs - the mounted filesystem capability.
+ * @param path - the path to read.
+ * @param markdown - the document's text, as the worker produced it.
+ * @param signal - caller cancellation.
+ * @returns true when the file holds exactly this text.
+ */
+async function holdsText(fs, path, markdown, signal) {
+    const expected = Buffer.from(markdown, 'utf8');
+    try {
+        // Reading one byte past the text tells a longer file from this one without
+        // reading a document the call is not about to replace.
+        const target = await fs.resolve(path);
+        const bytes = await fs.readBytes(target, signal, expected.length + 1);
+        return Buffer.from(bytes).equals(expected);
+    }
+    catch {
+        // A file this call cannot read —longer than this document, denied, or gone
+        // since it was statted —is not the text about to be written, so the write
+        // goes to the digest name rather than over it.
+        return false;
+    }
+}
+/**
+ * Choose the Markdown path one recognized document is written to.
+ * @param fs - the mounted filesystem capability.
+ * @param artifacts - the document's artifact paths.
+ * @param markdown - the document's text, as the worker produced it.
+ * @param signal - caller cancellation.
+ * @returns the plain path when it is free or already holds this text, and the
+ *   digest path otherwise.
+ */
+async function chooseDocument(fs, artifacts, markdown, signal) {
+    const existing = await fs.stat(await fs.resolve(artifacts.document), signal);
+    if (existing === undefined)
+        return artifacts.document;
+    if (await holdsText(fs, artifacts.document, markdown, signal))
+        return artifacts.document;
+    // The plain name holds a different document, which this call leaves alone.
+    return artifacts.digestedDocument;
+}
+/**
+ * Read the level corrections one recognition's stored record already carries.
+ * @param fs - the mounted filesystem capability.
+ * @param path - the record's path.
+ * @param signal - caller cancellation.
+ * @returns the corrections, or undefined when there is no record or it carries none.
+ */
+export async function carriedLevels(fs, path, signal) {
+    let record;
+    try {
+        record = await readRecord(fs, path, signal);
+    }
+    catch {
+        // A record that is absent or unreadable is a first recognition of this
+        // digest, or one whose revision is being replaced; either way there are no
+        // corrections to carry forward, and the merge's own errors reach the caller.
+        return undefined;
+    }
+    const overrides = record.merge.levelOverrides;
+    return overrides === undefined || Object.keys(overrides).length === 0 ? undefined : overrides;
+}
+/**
+ * Record the level each candidate's line was given.
+ *
+ * The worker reports the level the merge inferred; a correction replaces it. Both
+ * are kept, because a caller re-reading the sheet after a correction has to be
+ * able to see that the correction took, and what it took the place of.
+ * @param outline - the candidates the merge collected.
+ * @param overrides - the corrections that were applied, if any.
+ * @returns the candidates, each carrying the level the document used.
+ */
+export function appliedOutline(outline, overrides) {
+    return outline.map(entry => {
+        const applied = overrides?.[entry.id];
+        if (applied === undefined)
+            return { ...entry, inferred: entry.level };
+        return { ...entry, inferred: entry.level, level: applied <= 0 ? null : Math.min(applied, 6) };
+    });
+}
+/**
+ * Write one finished document and the record an assembly pass reads back.
+ * @param fs - the mounted filesystem capability.
+ * @param artifacts - the paths this recognition's artifacts are written to.
+ * @param state - the document's state, carrying the geometry it collected.
+ * @param markdown - the document's text, after any carried correction was applied.
+ * @param outline - the heading candidates the merge collected.
+ * @param rawOutline - the event's outline field, which may carry none.
+ * @param carried - the corrections this recognition carried forward, if any.
+ * @param signal - caller cancellation.
+ * @param fence - the per-call fence this document and its records are written under; absent on a bare backend.
+ * @returns the Markdown path this call wrote.
+ */
+export async function writeDocument(fs, artifacts, state, markdown, outline, rawOutline, carried, signal, fence) {
+    const output = await chooseDocument(fs, artifacts, markdown, signal);
+    await saveText(fs, await fs.resolve(output), markdown, fence, signal);
+    state.carried = carried;
+    const record = {
+        digest: artifacts.digest,
+        input: state.job.input,
+        pages: [...state.selection],
+        totalPages: state.totalPages,
+        merge: carried === undefined ? state.job.job.merge : { ...state.job.job.merge, levelOverrides: carried },
+        geometry: { pages: state.geometry },
+        source: { size: state.job.stamp.size, mtimeMs: state.job.stamp.mtimeMs },
+        statUnavailable: state.job.stamp.unavailable,
+    };
+    await writeJson(fs, artifacts.record, record, signal, fence);
+    // A worker that reported no outline leaves the stored one alone rather than
+    // replacing it with nothing.
+    if (Array.isArray(rawOutline)) {
+        await writeJson(fs, artifacts.outline, appliedOutline(outline, carried), signal, fence);
+    }
+    const latest = {
+        digest: artifacts.digest,
+        output,
+        input: state.job.input,
+        pages: [...state.selection],
+        totalPages: state.totalPages,
+    };
+    await writeJson(fs, artifacts.latest, latest, signal, fence);
+    return output;
+}
+/**
+ * Build the document one finished recognition reports.
+ * @param state - the document's state, carrying what its start event named.
+ * @param artifacts - the paths this recognition's artifacts were written to.
+ * @param done - the finished-document event.
+ * @param output - the Markdown path the call wrote.
+ * @param pageDir - the directory holding the per-page text, or an empty string.
+ * @param truncated - whether the heading candidate ceiling cut the outline short.
+ * @param corrections - heading-level corrections this call applied.
+ * @returns the document's canonical value.
+ */
+export function recognizedDocument(state, artifacts, done, output, pageDir, truncated, corrections) {
+    return {
+        input: state.job.input,
+        output,
+        // The start event's explicit page list is what the call reports; the
+        // finished document's own count is the fallback for a worker that never
+        // named the selection.
+        pages: state.selection.length > 0 ? state.selection.length : done.pages,
+        totalPages: state.totalPages > 0 ? state.totalPages : done.totalPages,
+        lines: done.lines,
+        headings: done.headings,
+        chars: done.chars,
+        droppedPageNumbers: done.droppedPageNumbers,
+        droppedRunningHeads: done.droppedRunningHeads,
+        joinedAcrossPages: done.joinedAcrossPages,
+        pageDir,
+        seconds: done.seconds,
+        digest: artifacts.digest,
+        selection: [...state.selection],
+        outlinePath: artifacts.outline,
+        outlineTruncated: truncated,
+        corrections,
+    };
+}
+//# sourceMappingURL=documents.js.map

package/lib/documents.js.map

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

package/lib/events.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Interpretation of the worker's event stream, and the per-call state that
+ * interpretation accumulates.
+ *
+ * The worker is a separate process, so every value on this boundary is read
+ * defensively: a field that is absent, of the wrong type, or carries no page
+ * number is a protocol violation rather than a value to coerce. Everything an
+ * event reports about one document is kept in that document's
+ * {@link DocumentState} until it finishes, because the merge pass reads the
+ * geometry back.
+ * @module @deepseek-ai/dsh-ab-ocr/events
+ */
+import type { ArtifactPaths } from './artifacts.ts';
+import type { PreparedJob } from './plan.ts';
+import type { OcrDocument, OcrFailure, OcrOutlineEntry, OcrPageGeometry } from './types.ts';
+/** One finished document, as the worker reported it. */
+export interface DoneEvent {
+    /** Identifier the call planned the job under. */
+    id: string;
+    /** Pages recognized. */
+    pages: number;
+    /** Pages the source carries. */
+    totalPages: number;
+    /** Lines kept after page furniture was removed. */
+    lines: number;
+    /** Headings found in the outline. */
+    headings: number;
+    /** Characters the Markdown body carries. */
+    chars: number;
+    /** Folios removed. */
+    droppedPageNumbers: number;
+    /** Running heads and feet removed. */
+    droppedRunningHeads: number;
+    /** Paragraphs continued across a page break. */
+    joinedAcrossPages: number;
+    /** Wall-clock seconds the document took. */
+    seconds: number;
+    /** The merged Markdown document. */
+    markdown: string;
+}
+/**
+ * Read one worker event into the value the merge-shaped result is built from.
+ * @param event - the parsed event.
+ * @returns the document's counts and body, or undefined for another event.
+ */
+export declare function readDoneEvent(event: Record<string, unknown>): DoneEvent | undefined;
+/**
+ * Read one whole positive number off a worker event.
+ * @param value - the event field.
+ * @returns the number, or undefined when the field carries none.
+ */
+export declare function wholeNumber(value: unknown): number | undefined;
+/**
+ * Read the geometry one page event carries, which an assembly pass needs back.
+ * @param value - the event's `geometry` field.
+ * @returns the page's geometry, or undefined when the field does not carry it.
+ */
+export declare function readGeometry(value: unknown): OcrPageGeometry | undefined;
+/**
+ * Read the outline a finished document reported.
+ *
+ * The worker reports the level the merge inferred; the candidate carries that
+ * same level as its starting point until a correction replaces it.
+ * @param value - the event's `outline` field.
+ * @returns the outline entries, or an empty list when the field carries none.
+ */
+export declare function readOutline(value: unknown): OcrOutlineEntry[];
+/** One failure a worker reported, which also names the job it belongs to. */
+export interface WorkerFailure extends OcrFailure {
+    /** Identifier of the job that failed, empty when the worker named none. */
+    id: string;
+}
+/**
+ * Read the failures a finished batch reported.
+ * @param value - the end event's `failures` field.
+ * @returns the failures, each naming a path and its reason.
+ */
+export declare function readFailures(value: unknown): WorkerFailure[];
+/** What one planned document has reported while its batch runs. */
+export interface DocumentState {
+    /** The planned job and the paths that do not depend on the recognition. */
+    job: PreparedJob;
+    /**
+     * Every path this recognition's artifacts are written to. The digest covers the
+     * source's content, which only the worker can report, so the pages this
+     * document writes into are named by the start event rather than planned.
+     */
+    artifacts?: ArtifactPaths;
+    /** The explicit pages the start event named; empty until it arrives. */
+    selection: number[];
+    /** Pages the source carries; 0 until the start event arrives. */
+    totalPages: number;
+    /** The page number reported last; 0 before the first. */
+    lastPage: number;
+    /** Every page's geometry, in the order the pages arrived. */
+    geometry: OcrPageGeometry[];
+    /**
+     * Level corrections the stored record already carried when this recognition
+     * replaced it. They are not the recognition's to discard, so the batch writes
+     * them back into the record and re-applies them once it finishes.
+     */
+    carried: Record<string, number> | undefined;
+}
+/**
+ * Start the record one document reports into.
+ * @param job - the prepared job.
+ * @returns the document's empty state.
+ */
+export declare function documentState(job: PreparedJob): DocumentState;
+/**
+ * Report why one page event breaks the order a document's files rely on.
+ * @param page - the page number the event carried.
+ * @param state - what the document has reported so far.
+ * @returns the problem, or undefined when the page is in order.
+ */
+export declare function pageProblem(page: number, state: DocumentState): string | undefined;
+/** Serialized artifact writes: one chain, one recorded failure, and the abort it forces. */
+export interface WriteQueue {
+    /** Queue one write behind every write already queued. */
+    enqueue(task: () => Promise<void>): void;
+    /** Wait for every queued write and report the first failure. */
+    settle(): Promise<Error | undefined>;
+}
+/**
+ * Serialize a call's artifact writes behind one chain, so two writes never race
+ * for one path and a failed write is recorded once.
+ * @param controller - the controller whose abort stops the recognition.
+ * @returns the queue's enqueue and settle operations.
+ */
+export declare function writeQueue(controller: AbortController): WriteQueue;
+/** What one call collects while its batch runs. */
+export interface CallState {
+    /** Documents finished, in the order their files were written. */
+    documents: OcrDocument[];
+    /** Documents that failed, including the ones rejected before the batch. */
+    failures: OcrFailure[];
+    /** Identifiers whose failure is already reported, so the closing list adds none twice. */
+    reported: Set<string>;
+    /** Cancels the batch, whether the caller asked or the call noticed a violation. */
+    controller: AbortController;
+    /** Serialized artifact writes. */
+    queue: WriteQueue;
+    /**
+     * Documents the worker reported finished. Counted separately from the ones a
+     * caller kept, because a re-merge reports a document the caller only reads the
+     * text of, and the batch's own closing count still has to be matched.
+     */
+    finished: number;
+    /** The first protocol violation, which outranks the exit state it caused. */
+    problem?: Error;
+}
+/**
+ * Report one document's failure once, whether it arrived as its own event or in
+ * the batch's closing list. The worker reports a failure both ways, and its two
+ * reports agree on the job identifier as well as on the path and the reason.
+ * @param call - the call collecting failures.
+ * @param failure - the failure the worker reported.
+ * @returns nothing.
+ */
+export declare function reportFailure(call: CallState, failure: WorkerFailure): void;
+//# sourceMappingURL=events.d.ts.map

package/lib/events.d.ts.map

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