@pentoshi/clai 3.9.7 → 3.10.0

package/dist/tools/ocr.js

@@ -0,0 +1,316 @@
+import { mkdtemp, open, readFile, rm, stat } from "node:fs/promises";
+import { platform, tmpdir } from "node:os";
+import { join } from "node:path";
+import { commandAvailable } from "../os/pkgmgr.js";
+import { readImageDimensions } from "../attachments/image-content.js";
+import { spawnArgv } from "./shell.js";
+export const LANG_PATTERN = /^[A-Za-z0-9_+-]+$/;
+const PREPROCESS_TARGET_EDGE = 2400;
+const PREPROCESS_MIN_EDGE = 1600;
+const PREPROCESS_MAX_SCALE = 4;
+const GOOD_ENOUGH_SCORE = 40;
+export const MIN_RELIABLE_CONFIDENCE = 55;
+const MIN_RELIABLE_WORDS = 2;
+export function stripCommandEcho(output) {
+    return output.replace(/^\$ [^\n]*\n?/, "");
+}
+export function meaningfulCharCount(text) {
+    return (text.match(/[A-Za-z0-9]/g) ?? []).length;
+}
+export function scoreOcrText(text) {
+    const alphanumeric = meaningfulCharCount(text);
+    const words = (text.match(/\b[A-Za-z]{2,}\b/g) ?? []).length;
+    const noise = (text.match(/[^\w\s.,:;!?'"()\[\]{}<>@#$%&*+/\\|=~^-]/g) ?? [])
+        .length;
+    return alphanumeric + words * 3 - noise * 2;
+}
+function parseTsvWords(tsv) {
+    const words = [];
+    for (const line of tsv.split(/\r?\n/)) {
+        const columns = line.split("\t");
+        if (columns.length < 12 || columns[0] !== "5")
+            continue;
+        const confidence = Number(columns[10]);
+        const text = (columns[11] ?? "").trim();
+        if (!Number.isFinite(confidence) || confidence < 0 || text.length === 0) {
+            continue;
+        }
+        words.push({ confidence, text });
+    }
+    return words;
+}
+function meanConfidence(words) {
+    let weight = 0;
+    let total = 0;
+    for (const word of words) {
+        const length = Math.max(1, word.text.replace(/\s+/g, "").length);
+        weight += length;
+        total += word.confidence * length;
+    }
+    return weight === 0 ? 0 : total / weight;
+}
+function looksLikeRealText(words) {
+    const wordLike = words.filter((word) => /^[A-Za-z][A-Za-z'’-]{1,}$/.test(word.text) && /[aeiouy]/i.test(word.text));
+    const numeric = words.filter((word) => /^[$€£]?\d[\d.,:/%-]*$/.test(word.text));
+    const trusted = wordLike.length + numeric.length;
+    if (trusted < MIN_RELIABLE_WORDS)
+        return false;
+    return trusted / words.length >= 0.4;
+}
+const MISSING_RECHECK_MS = 15_000;
+let tesseractPresent = false;
+let tesseractCheckedAt = 0;
+export async function tesseractUnavailableReason() {
+    if (tesseractPresent)
+        return undefined;
+    if (Date.now() - tesseractCheckedAt < MISSING_RECHECK_MS) {
+        return missingTesseractHint();
+    }
+    tesseractCheckedAt = Date.now();
+    tesseractPresent = await commandAvailable("tesseract");
+    return tesseractPresent ? undefined : missingTesseractHint();
+}
+function missingTesseractHint() {
+    return platform() === "darwin"
+        ? "tesseract is not installed. Install it with `brew install tesseract` (add `brew install tesseract-lang` for non-English), then retry."
+        : platform() === "win32"
+            ? "tesseract is not installed. Install it with `scoop install tesseract` or `choco install tesseract`, then retry."
+            : "tesseract is not installed. Install it with `apt install tesseract-ocr` (or `dnf install tesseract`), then retry.";
+}
+let cachedLanguages;
+async function installedLanguages() {
+    if (cachedLanguages)
+        return cachedLanguages;
+    const result = await spawnArgv({
+        command: "tesseract",
+        argv: ["--list-langs"],
+        timeoutMs: 10_000,
+        noArtifact: true,
+        maxModelBytes: 32_000,
+    });
+    if (!result.ok)
+        return undefined;
+    const lines = stripCommandEcho(result.output)
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !/[:\s]/.test(line));
+    if (lines.length === 0)
+        return undefined;
+    cachedLanguages = new Set(lines);
+    return cachedLanguages;
+}
+export async function languageUnavailableReason(lang) {
+    const installed = await installedLanguages();
+    if (!installed)
+        return undefined;
+    const missing = lang
+        .split("+")
+        .map((code) => code.trim())
+        .filter((code) => code.length > 0 && !installed.has(code));
+    if (missing.length === 0)
+        return undefined;
+    const hint = platform() === "darwin"
+        ? "install the data with `brew install tesseract-lang`"
+        : platform() === "win32"
+            ? "download the .traineddata files into the tessdata directory"
+            : `install the data with \`apt install tesseract-ocr-${missing[0]}\``;
+    return `tesseract has no training data for ${missing.join(", ")} (installed: ${[...installed].slice(0, 12).join(", ")}). Use one of the installed codes or ${hint}.`;
+}
+export function resetOcrEnvironmentCache() {
+    tesseractPresent = false;
+    tesseractCheckedAt = 0;
+    cachedLanguages = undefined;
+}
+async function readHeader(path, length) {
+    const handle = await open(path, "r");
+    try {
+        const buffer = Buffer.alloc(length);
+        const { bytesRead } = await handle.read(buffer, 0, length, 0);
+        return buffer.subarray(0, bytesRead);
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function preprocessForOcr(source, workDir, timeoutMs, signal) {
+    let longestEdge = 0;
+    try {
+        const header = await readHeader(source, 65_536);
+        const dimensions = readImageDimensions(header);
+        if (dimensions) {
+            longestEdge = Math.max(dimensions.width, dimensions.height);
+        }
+    }
+    catch {
+        return undefined;
+    }
+    if (longestEdge === 0 || longestEdge >= PREPROCESS_MIN_EDGE)
+        return undefined;
+    const target = Math.min(PREPROCESS_TARGET_EDGE, Math.round(longestEdge * PREPROCESS_MAX_SCALE));
+    const destination = join(workDir, "upscaled.png");
+    if (await commandAvailable("magick")) {
+        const result = await spawnArgv({
+            command: "magick",
+            argv: [
+                `${source}[0]`,
+                "-colorspace",
+                "Gray",
+                "-filter",
+                "Lanczos",
+                "-resize",
+                `${target}x${target}`,
+                "-normalize",
+                "-sharpen",
+                "0x1",
+                destination,
+            ],
+            timeoutMs,
+            signal,
+            noArtifact: true,
+            maxModelBytes: 4_000,
+        });
+        if (result.ok && (await fileHasBytes(destination)))
+            return destination;
+    }
+    if (platform() === "darwin" && (await commandAvailable("sips"))) {
+        const result = await spawnArgv({
+            command: "sips",
+            argv: [
+                "-s",
+                "format",
+                "png",
+                "-Z",
+                String(target),
+                source,
+                "--out",
+                destination,
+            ],
+            timeoutMs,
+            signal,
+            noArtifact: true,
+            maxModelBytes: 4_000,
+        });
+        if (result.ok && (await fileHasBytes(destination)))
+            return destination;
+    }
+    return undefined;
+}
+async function fileHasBytes(path) {
+    try {
+        const info = await stat(path);
+        return info.isFile() && info.size > 0;
+    }
+    catch {
+        return false;
+    }
+}
+export async function runOcr(request) {
+    const fail = (error) => ({
+        ok: false,
+        text: "",
+        psm: -1,
+        preprocessed: false,
+        confidence: 0,
+        reliable: false,
+        error,
+    });
+    const unavailable = await tesseractUnavailableReason();
+    if (unavailable)
+        return fail(unavailable);
+    const languageIssue = await languageUnavailableReason(request.lang);
+    if (languageIssue)
+        return fail(languageIssue);
+    const candidates = request.psmCandidates.length > 0 ? [...request.psmCandidates] : [3];
+    let workDir;
+    let input = request.path;
+    let preprocessed = false;
+    try {
+        if (request.preprocess !== false) {
+            workDir = await mkdtemp(join(tmpdir(), "clai-ocrpre-"));
+            const upscaled = await preprocessForOcr(request.path, workDir, Math.min(request.timeoutMs, 30_000), request.signal);
+            if (upscaled) {
+                input = upscaled;
+                preprocessed = true;
+            }
+        }
+        if (!workDir)
+            workDir = await mkdtemp(join(tmpdir(), "clai-ocr-"));
+        let best;
+        let lastError;
+        for (const [attempt, psm] of candidates.entries()) {
+            if (request.signal?.aborted)
+                break;
+            const base = join(workDir, `pass-${attempt}`);
+            const argv = [input, base, "-l", request.lang, "--psm", String(psm)];
+            if (request.dpi)
+                argv.push("--dpi", String(request.dpi));
+            argv.push("-c", "preserve_interword_spaces=1", "txt", "tsv");
+            const result = await spawnArgv({
+                command: "tesseract",
+                argv,
+                timeoutMs: request.timeoutMs,
+                signal: request.signal,
+                onOutput: request.onOutput,
+                noArtifact: true,
+                maxModelBytes: 8_000,
+            });
+            if (!result.ok) {
+                lastError =
+                    stripCommandEcho(result.output).trim() ||
+                        `tesseract exited with code ${result.exitCode ?? 1}`;
+                continue;
+            }
+            const text = (await readTextFile(`${base}.txt`))
+                .replace(/^Estimating resolution as \d+\s*$/gim, "")
+                .replace(/^Warning[^\n]*$/gim, "")
+                .replace(/\f/g, "")
+                .trimEnd();
+            const words = parseTsvWords(await readTextFile(`${base}.tsv`));
+            const confidence = meanConfidence(words);
+            const reliable = words.length > 0 &&
+                confidence >= MIN_RELIABLE_CONFIDENCE &&
+                looksLikeRealText(words);
+            const candidate = {
+                ok: true,
+                text: text.trim(),
+                psm,
+                preprocessed,
+                confidence: Math.round(confidence),
+                reliable,
+            };
+            if (!best || isBetterOcr(candidate, best))
+                best = candidate;
+            if (reliable && scoreOcrText(candidate.text) >= GOOD_ENOUGH_SCORE)
+                break;
+        }
+        if (best)
+            return best;
+        return {
+            ok: false,
+            text: "",
+            psm: candidates[0] ?? 3,
+            preprocessed,
+            confidence: 0,
+            reliable: false,
+            error: lastError ?? "tesseract produced no output",
+        };
+    }
+    finally {
+        if (workDir)
+            await rm(workDir, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+function isBetterOcr(candidate, current) {
+    if (candidate.reliable !== current.reliable)
+        return candidate.reliable;
+    return scoreOcrText(candidate.text) > scoreOcrText(current.text);
+}
+async function readTextFile(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+//# sourceMappingURL=ocr.js.map

package/dist/tools/ocr.js.map

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

package/dist/tools/pdf.d.ts

@@ -3,16 +3,4 @@ export interface PdfToolRunOptions {
     signal?: AbortSignal | undefined;
     onOutput?: ((chunk: string, stream: "stdout" | "stderr") => void) | undefined;
 }
-/**
- * Read a PDF as text.
- *
- * Strategy (mirrors what a human would do):
- *   1. Run `pdftotext -layout <pdf> -` — fast and exact for born-digital PDFs.
- *   2. If that yields little/no real text the PDF is scanned (image-only), so
- *      render every page to a PNG with `pdftoppm` and OCR each one with
- *      `tesseract`, concatenating the results page by page.
- *
- * Auto-executes (read-only). Returns a helpful error naming the missing
- * binary so the agent can pkg.install it and retry.
- */
 export declare function pdfRead(args: Record<string, unknown>, options?: PdfToolRunOptions): Promise<ToolResult>;