zero-vision 0.1.0

package/dist/cdp/extract.js

@@ -0,0 +1,197 @@
+const SKIP_ROLES = new Set(["none", "presentation", "InlineTextBox", "generic"]);
+function prop(node, name) {
+    return node.properties?.find((p) => p.name === name)?.value?.value;
+}
+function interesting(n) {
+    if (n.ignored)
+        return false;
+    const role = String(n.role?.value ?? "");
+    if (SKIP_ROLES.has(role) && !n.name?.value)
+        return false;
+    return true;
+}
+export function axToText(nodes) {
+    const byId = new Map(nodes.map((n) => [n.nodeId, n]));
+    const childOf = new Set();
+    for (const n of nodes)
+        for (const c of n.childIds ?? [])
+            childOf.add(c);
+    const roots = nodes.filter((n) => !childOf.has(n.nodeId));
+    let uid = 0;
+    const textLines = [];
+    const mdLines = [];
+    const yamlLines = [];
+    const walk = (id, depth) => {
+        const n = byId.get(id);
+        if (!n)
+            return;
+        const role = String(n.role?.value ?? "generic");
+        const name = String(n.name?.value ?? "").trim();
+        const value = n.value?.value != null ? String(n.value.value) : "";
+        const url = prop(n, "url");
+        const keep = interesting(n);
+        if (keep &&
+            role !== "RootWebArea" &&
+            role !== "WebArea" &&
+            (name || value || ["heading", "link", "button", "textbox", "checkbox"].includes(role))) {
+            const idn = `e${++uid}`;
+            const level = Number(prop(n, "level") ?? 0);
+            if (role === "heading") {
+                const hashes = "#".repeat(Math.min(Math.max(level || 1, 1), 6));
+                textLines.push(name);
+                mdLines.push(`${hashes} ${name}`);
+                yamlLines.push(`${"  ".repeat(depth)}- heading ${JSON.stringify(name)} [level=${level || 1}] [uid=${idn}]`);
+            }
+            else if (role === "link") {
+                textLines.push(name);
+                mdLines.push(typeof url === "string" && url ? `[${name}](${url})` : name);
+                yamlLines.push(`${"  ".repeat(depth)}- link ${JSON.stringify(name)} [uid=${idn}]`);
+            }
+            else if (role === "textbox") {
+                textLines.push(value ? `${name}: ${value}` : name);
+                mdLines.push(`**${name}:** ${value}`);
+                yamlLines.push(`${"  ".repeat(depth)}- textbox ${JSON.stringify(name)} [uid=${idn}] [value=${JSON.stringify(value)}]`);
+            }
+            else if (role === "checkbox") {
+                const checked = Boolean(prop(n, "checked"));
+                textLines.push(`${checked ? "[x]" : "[ ]"} ${name}`);
+                mdLines.push(`- [${checked ? "x" : " "}] ${name}`);
+                yamlLines.push(`${"  ".repeat(depth)}- checkbox ${JSON.stringify(name)} [uid=${idn}]`);
+            }
+            else if (role === "button") {
+                textLines.push(name);
+                mdLines.push(name);
+                yamlLines.push(`${"  ".repeat(depth)}- button ${JSON.stringify(name)} [uid=${idn}]`);
+            }
+            else if (name) {
+                textLines.push(name);
+                mdLines.push(name);
+                yamlLines.push(`${"  ".repeat(depth)}- ${role} ${JSON.stringify(name)} [uid=${idn}]`);
+            }
+        }
+        for (const c of n.childIds ?? [])
+            walk(c, depth + (keep ? 1 : 0));
+    };
+    for (const r of roots)
+        walk(r.nodeId, 0);
+    const cap = (s) => (s.length > 24000 ? s.slice(0, 24000) + "\n…[truncated]" : s);
+    return {
+        text: cap(textLines.join("\n")),
+        markdown: cap(mdLines.join("\n")),
+        a11y: cap(yamlLines.join("\n")),
+    };
+}
+const OPAQUE_JS = `() => {
+  const area = (el) => {
+    const r = el.getBoundingClientRect();
+    return Math.max(0, r.width) * Math.max(0, r.height);
+  };
+  const vp = innerWidth * innerHeight || 1;
+  const nodes = [...document.querySelectorAll('canvas, video')];
+  let px = 0;
+  const reasons = [];
+  for (const el of nodes) {
+    const a = area(el);
+    if (a / vp >= 0.05) {
+      px += a;
+      reasons.push(el.tagName.toLowerCase());
+    }
+  }
+  return { fraction: px / vp, reasons: [...new Set(reasons)] };
+}`;
+export async function extractPage(client, sessionId, opts = {}) {
+    await client.send("Runtime.enable", {}, sessionId);
+    await client.send("Page.enable", {}, sessionId);
+    await client.send("Accessibility.enable", {}, sessionId);
+    const ready = (await client.send("Runtime.evaluate", { expression: "document.readyState", returnByValue: true }, sessionId));
+    if (ready.result?.value !== "complete") {
+        await Promise.race([
+            new Promise((resolve) => {
+                const onLoad = () => {
+                    client.off("Page.loadEventFired", onLoad);
+                    resolve();
+                };
+                client.on("Page.loadEventFired", onLoad);
+            }),
+            new Promise((resolve) => setTimeout(resolve, 8000)),
+        ]);
+    }
+    await Promise.race([
+        new Promise((resolve) => {
+            const onAx = () => {
+                client.off("Accessibility.loadComplete", onAx);
+                resolve();
+            };
+            client.on("Accessibility.loadComplete", onAx);
+        }),
+        new Promise((resolve) => setTimeout(resolve, 2000)),
+    ]);
+    if (opts.waitMs)
+        await new Promise((r) => setTimeout(r, opts.waitMs));
+    if (opts.waitText) {
+        const deadline = Date.now() + 8000;
+        while (Date.now() < deadline) {
+            const ev = (await client.send("Runtime.evaluate", { expression: "document.body && document.body.innerText || ''", returnByValue: true }, sessionId));
+            if ((ev.result?.value ?? "").includes(opts.waitText))
+                break;
+            await new Promise((r) => setTimeout(r, 200));
+        }
+    }
+    if (opts.scroll) {
+        await client.send("Runtime.evaluate", {
+            expression: "(async () => { const h = document.body.scrollHeight; for (let y=0; y<h; y+=800) { scrollTo(0,y); await new Promise(r=>setTimeout(r,150)); } })()",
+            awaitPromise: true,
+        }, sessionId);
+    }
+    await new Promise((r) => setTimeout(r, 250));
+    const { nodes } = (await client.send("Accessibility.getFullAXTree", {}, sessionId));
+    const walked = axToText(nodes);
+    let opaque = { fraction: 0, reasons: [] };
+    try {
+        const ev = (await client.send("Runtime.evaluate", { expression: `(${OPAQUE_JS})()`, returnByValue: true }, sessionId));
+        if (ev.result?.value)
+            opaque = ev.result.value;
+    }
+    catch {
+        /* page may deny */
+    }
+    try {
+        await client.send("Accessibility.disable", {}, sessionId);
+    }
+    catch {
+        /* ignore */
+    }
+    let a11y = walked.a11y;
+    if (opaque.fraction >= 0.3) {
+        a11y += `\nopaque: ${opaque.reasons[0] ?? "canvas"} ${opaque.fraction.toFixed(2)} viewport`;
+    }
+    if (opts.verbose) {
+        a11y += "\n--- raw ---\n" + JSON.stringify(nodes).slice(0, 8000);
+    }
+    return { text: walked.text, markdown: walked.markdown, a11y, opaque };
+}
+export async function captureScreenshot(client, sessionId) {
+    const result = (await client.send("Page.captureScreenshot", { format: "png" }, sessionId));
+    if (!result?.data)
+        throw new Error("Page.captureScreenshot returned no data");
+    return Buffer.from(result.data, "base64");
+}
+export async function fetchUrl(url) {
+    const res = await fetch(url, { redirect: "follow" });
+    const html = await res.text();
+    const stripped = html
+        .replace(/<script[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style[\s\S]*?<\/style>/gi, " ")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (stripped.length < 200 && /id=["']root["']/.test(html)) {
+        throw Object.assign(new Error("page looks like a client render; open it in a debug Chrome and retry without --fetch"), { code: 1 });
+    }
+    return { text: stripped.slice(0, 24000), markdown: stripped.slice(0, 24000) };
+}
+//# sourceMappingURL=extract.js.map

package/dist/cdp/extract.js.map

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

package/dist/cli.js

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { perceive, resolveEngine } from "./engines/index.js";
+import { attach, findOpenPort, listTabs } from "./cdp/attach.js";
+import { captureScreenshot, extractPage, fetchUrl } from "./cdp/extract.js";
+import { interactiveCapture, runScreencapture } from "./snap.js";
+const BOOL = new Set([
+    "md",
+    "a11y",
+    "json",
+    "navigate",
+    "fetch",
+    "ocr",
+    "ocr-opaque",
+    "scroll",
+    "clipboard",
+    "tabs",
+    "verbose",
+    "help",
+]);
+function usage() {
+    process.stderr.write(`zrv — read a page, a screenshot, or a video as text
+  zrv [--md|--a11y] [--tab id] [--url u] [--engine e] [--json]
+  zrv --tabs
+  zrv ocr <file> [--engine e] [--task transcribe|describe] [--mode scene|interval|all-idr] [--interval s] [--max-frames n]
+  zrv snap [--ocr] [--save path]
+  zrv mcp
+`);
+    process.exit(1);
+}
+function isVideo(p) {
+    return /\.(mp4|mov|m4v|webm)$/i.test(p);
+}
+async function copyText(text) {
+    await new Promise((resolve) => {
+        const pb = spawn("pbcopy");
+        pb.stdin.write(text);
+        pb.stdin.end();
+        pb.on("close", () => resolve());
+    });
+}
+function failCode(result) {
+    const err = result.error ?? "";
+    if (err.includes("cannot describe"))
+        return 1;
+    if (err.includes("unavailable") || err.includes("weights missing") || err.includes("unset"))
+        return 3;
+    if (err.includes("input missing") || err.includes("path required"))
+        return 2;
+    return 4;
+}
+function outResult(result, json) {
+    if (json) {
+        process.stdout.write(JSON.stringify(result) + "\n");
+    }
+    else if (result.ok) {
+        process.stdout.write(result.text + (result.text.endsWith("\n") ? "" : "\n"));
+    }
+    else {
+        process.stderr.write((result.error ?? "failed") + "\n");
+    }
+    process.exit(result.ok ? 0 : failCode(result));
+}
+export function parseArgv(raw) {
+    const flags = {};
+    const pos = [];
+    const langs = [];
+    for (let i = 0; i < raw.length; i++) {
+        const a = raw[i];
+        if (a === "-h" || a === "--help")
+            flags.help = true;
+        else if (a === "--lang" && i + 1 < raw.length)
+            langs.push(raw[++i]);
+        else if (a.startsWith("--") && BOOL.has(a.slice(2)))
+            flags[a.slice(2)] = true;
+        else if (a.startsWith("--") && i + 1 < raw.length)
+            flags[a.slice(2)] = raw[++i];
+        else if (a.startsWith("--"))
+            usage();
+        else
+            pos.push(a);
+    }
+    const cmd = pos[0] === "ocr" || pos[0] === "snap" || pos[0] === "mcp" ? pos.shift() : "page";
+    return { cmd, pos, flags, langs };
+}
+async function main() {
+    const argv0 = process.argv[1] ?? "";
+    const raw = process.argv.slice(2);
+    if (argv0.endsWith("/snap") || argv0 === "snap" || argv0.endsWith("\\snap"))
+        raw.unshift("snap");
+    const { cmd, pos, flags, langs } = parseArgv(raw);
+    if (flags.help)
+        usage();
+    if (cmd === "mcp") {
+        const { startMcp } = await import("./mcp.js");
+        await startMcp();
+        return;
+    }
+    const engine = resolveEngine(typeof flags.engine === "string" ? flags.engine : undefined);
+    if (cmd === "snap") {
+        if (!flags.ocr && !flags.save) {
+            const code = await runScreencapture();
+            process.exit(code === 0 ? 0 : 130);
+        }
+        const save = typeof flags.save === "string" ? flags.save : undefined;
+        const file = await interactiveCapture({ save });
+        if (!file)
+            process.exit(130);
+        if (flags.ocr) {
+            const result = await perceive(engine, { kind: "image", path: file, task: "transcribe" });
+            if (!result.ok) {
+                process.stderr.write((result.error ?? "ocr failed") + "\n");
+                process.exit(failCode(result));
+            }
+            process.stdout.write(result.text + (result.text.endsWith("\n") ? "" : "\n"));
+            await copyText(result.text);
+        }
+        return;
+    }
+    if (cmd === "ocr") {
+        const file = pos[0];
+        const task = flags.task === "describe" ? "describe" : "transcribe";
+        if (flags.clipboard) {
+            const result = await perceive(engine, {
+                kind: "clipboard",
+                task,
+                level: flags.level === "fast" ? "fast" : "accurate",
+                lang: langs.length ? langs : undefined,
+            });
+            outResult(result, Boolean(flags.json));
+        }
+        if (!file)
+            usage();
+        const kind = isVideo(file) ? "video" : "image";
+        const modeRaw = typeof flags.mode === "string" ? flags.mode : "scene";
+        const mode = modeRaw === "interval" || modeRaw === "all-idr" ? modeRaw : "scene";
+        const result = await perceive(engine, {
+            kind,
+            path: file,
+            task,
+            level: flags.level === "fast" ? "fast" : "accurate",
+            lang: langs.length ? langs : undefined,
+            ...(kind === "video"
+                ? {
+                    video: {
+                        mode,
+                        interval: flags.interval ? Number(flags.interval) : 2,
+                        maxFrames: flags["max-frames"] ? Number(flags["max-frames"]) : 60,
+                    },
+                }
+                : {}),
+        });
+        outResult(result, Boolean(flags.json));
+    }
+    if (flags.tabs) {
+        const { port } = await findOpenPort(flags.port ? Number(flags.port) : undefined);
+        const tabs = await listTabs(port);
+        for (const t of tabs)
+            process.stdout.write(`${t.id}\t${t.title}\t${t.url}\n`);
+        return;
+    }
+    if (flags.fetch && typeof flags.url === "string") {
+        const { text, markdown } = await fetchUrl(flags.url);
+        process.stdout.write((flags.md ? markdown : text) + "\n");
+        return;
+    }
+    const attached = await attach({
+        port: flags.port ? Number(flags.port) : undefined,
+        tab: typeof flags.tab === "string" ? flags.tab : undefined,
+        url: typeof flags.url === "string" ? flags.url : undefined,
+        navigate: Boolean(flags.navigate),
+    });
+    process.stderr.write(`${attached.title}\t${attached.url}\n`);
+    try {
+        const extracted = await extractPage(attached.client, attached.sessionId, {
+            waitMs: flags["wait-ms"] ? Number(flags["wait-ms"]) : undefined,
+            waitText: typeof flags["wait-text"] === "string" ? flags["wait-text"] : undefined,
+            scroll: Boolean(flags.scroll),
+            verbose: Boolean(flags.verbose),
+        });
+        let body = extracted.text;
+        if (flags.a11y)
+            body = extracted.a11y;
+        else if (flags.md)
+            body = extracted.markdown;
+        if (flags["ocr-opaque"] && extracted.opaque.fraction >= 0.3) {
+            const png = await captureScreenshot(attached.client, attached.sessionId);
+            const ocr = await perceive(engine, { kind: "image", bytes: png, task: "transcribe" });
+            if (ocr.ok && ocr.text)
+                body += (body.endsWith("\n") ? "" : "\n") + "--- opaque ocr ---\n" + ocr.text;
+        }
+        if (flags.json) {
+            process.stdout.write(JSON.stringify({
+                ok: true,
+                source: "cdp",
+                port: attached.port,
+                targetId: attached.targetId,
+                title: attached.title,
+                url: attached.url,
+                text: body,
+                opaque: extracted.opaque,
+            }) + "\n");
+        }
+        else {
+            process.stdout.write(body + (body.endsWith("\n") ? "" : "\n"));
+        }
+    }
+    finally {
+        attached.client.close();
+    }
+}
+const isMain = process.argv[1]?.endsWith("cli.js") ||
+    process.argv[1]?.endsWith("cli.ts") ||
+    process.argv[1]?.endsWith("/zrv") ||
+    process.argv[1]?.endsWith("/snap");
+if (isMain) {
+    main().catch((err) => {
+        const code = typeof err === "object" && err && "code" in err ? Number(err.code) : 1;
+        process.stderr.write((err instanceof Error ? err.message : String(err)) + "\n");
+        process.exit(Number.isFinite(code) && code > 0 ? code : 1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/engines/apple-fm.js

@@ -0,0 +1,103 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+function runFm(argv) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("fm", argv, { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (c) => {
+            stdout += c;
+        });
+        child.stderr.on("data", (c) => {
+            stderr += c;
+        });
+        child.on("error", (err) => reject(err));
+        child.on("close", (code) => resolve({ code: code ?? 1, stdout, stderr }));
+    });
+}
+export const appleFm = {
+    id: "apple-fm",
+    capabilities: ["transcribe", "describe"],
+    async perceive(input) {
+        const t0 = Date.now();
+        const task = input.task ?? "transcribe";
+        if (!existsSync("/usr/bin/fm")) {
+            return {
+                ok: false,
+                engine: "apple-fm",
+                task,
+                text: "",
+                ms: 0,
+                error: "apple-fm unavailable",
+            };
+        }
+        if (input.kind === "video") {
+            return {
+                ok: false,
+                engine: "apple-fm",
+                task,
+                text: "",
+                ms: 0,
+                error: "apple-fm does not OCR video; use apple-vision",
+            };
+        }
+        if (input.kind === "clipboard" || !input.path) {
+            return {
+                ok: false,
+                engine: "apple-fm",
+                task,
+                text: "",
+                ms: 0,
+                error: "apple-fm needs --image path (clipboard: snap to a file first)",
+            };
+        }
+        const prompt = task === "describe"
+            ? "Describe this image. If it contains text, quote the text."
+            : "Transcribe all text verbatim. Do not paraphrase.";
+        try {
+            const { code, stdout, stderr } = await runFm([
+                "respond",
+                "--image",
+                input.path,
+                "--text",
+                prompt,
+                "--tool",
+                "ocr",
+                "--no-stream",
+            ]);
+            const text = stdout.trim();
+            if (code !== 0 || !text) {
+                return {
+                    ok: false,
+                    engine: "apple-fm",
+                    task,
+                    text: "",
+                    ms: Date.now() - t0,
+                    model: "system",
+                    error: stderr.trim() || `fm exit ${code}`,
+                };
+            }
+            return {
+                ok: true,
+                engine: "apple-fm",
+                task,
+                text,
+                ms: Date.now() - t0,
+                model: "system",
+            };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                engine: "apple-fm",
+                task,
+                text: "",
+                ms: Date.now() - t0,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    },
+};
+//# sourceMappingURL=apple-fm.js.map

package/dist/engines/apple-fm.js.map

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

package/dist/engines/apple-vision.js

@@ -0,0 +1,89 @@
+import { writeFileSync, mkdtempSync, rmSync, realpathSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawnNative } from "../native.js";
+function parseJson(stdout) {
+    const line = stdout.trim().split("\n").filter(Boolean).at(-1) ?? "{}";
+    try {
+        const raw = JSON.parse(line);
+        return { ...raw, engine: "apple-vision", task: raw.task ?? "transcribe" };
+    }
+    catch {
+        return {
+            ok: false,
+            engine: "apple-vision",
+            task: "transcribe",
+            text: "",
+            ms: 0,
+            error: `native json parse failed: ${line.slice(0, 200)}`,
+        };
+    }
+}
+export const appleVision = {
+    id: "apple-vision",
+    capabilities: ["transcribe"],
+    async perceive(input) {
+        const task = input.task ?? "transcribe";
+        const level = input.level ?? "accurate";
+        const langs = input.lang ?? ["en-US"];
+        const langArgs = langs.flatMap((l) => ["--lang", l]);
+        if (input.kind === "clipboard") {
+            const { stdout, stderr } = await spawnNative(["ocr-clipboard", "--level", level, ...langArgs, "--json"]);
+            return parseJson(stdout || stderr);
+        }
+        let path = input.path;
+        let tmp;
+        if (input.bytes) {
+            if (input.bytes.length > 30 * 1024 * 1024) {
+                return { ok: false, engine: "apple-vision", task, text: "", ms: 0, error: "input exceeds 30 MB" };
+            }
+            tmp = mkdtempSync(join(tmpdir(), "zrv-"));
+            path = join(tmp, "in.bin");
+            writeFileSync(path, input.bytes);
+        }
+        if (!path) {
+            return { ok: false, engine: "apple-vision", task, text: "", ms: 0, error: "path required" };
+        }
+        if (!tmp) {
+            try {
+                path = realpathSync(path);
+                if (!statSync(path).isFile()) {
+                    return { ok: false, engine: "apple-vision", task, text: "", ms: 0, error: "path required" };
+                }
+            }
+            catch {
+                return { ok: false, engine: "apple-vision", task, text: "", ms: 0, error: "input missing" };
+            }
+        }
+        try {
+            if (input.kind === "video") {
+                const mode = input.video?.mode ?? "scene";
+                const interval = String(input.video?.interval ?? 2);
+                const maxFrames = String(input.video?.maxFrames ?? 60);
+                const { stdout, stderr } = await spawnNative([
+                    "ocr-video",
+                    "--input",
+                    path,
+                    "--mode",
+                    mode,
+                    "--interval",
+                    interval,
+                    "--max-frames",
+                    maxFrames,
+                    "--level",
+                    level,
+                    ...langArgs,
+                    "--json",
+                ], { timeoutMs: 180_000 });
+                return parseJson(stdout || stderr);
+            }
+            const { stdout, stderr } = await spawnNative(["ocr-image", "--input", path, "--level", level, ...langArgs, "--json"]);
+            return parseJson(stdout || stderr);
+        }
+        finally {
+            if (tmp)
+                rmSync(tmp, { recursive: true, force: true });
+        }
+    },
+};
+//# sourceMappingURL=apple-vision.js.map