@zenalexa/unicli 0.213.3 → 0.215.0

package/dist/commands/browser-operator-runtime.js

@@ -0,0 +1,281 @@
+import { homedir } from "node:os";
+import { isAbsolute, relative, resolve } from "node:path";
+import { BrowserBridge } from "../browser/bridge.js";
+import { resolveBrowserWorkspace } from "../browser/workspace.js";
+import { generateInterceptorJs, generateReadInterceptedJs, } from "../engine/interceptor.js";
+import { buildSensitivePathDenial, isSensitivePathRealpath, } from "../permissions/sensitive-paths.js";
+import { detectFormat, format } from "../output/formatter.js";
+import { makeCtx } from "../output/envelope.js";
+import { errorTypeToCode, mapErrorToExitCode } from "../output/error-map.js";
+export function validateRef(ref) {
+    if (!/^\d+$/.test(ref)) {
+        throw new Error(`Invalid ref "${ref}". Expected a number from the state output.`);
+    }
+    return ref;
+}
+function getRootOpts(root) {
+    return root.opts();
+}
+export function resolveWorkspace(root, namespace) {
+    const opts = getRootOpts(root);
+    return resolveBrowserWorkspace(namespace, {
+        workspace: opts.workspace,
+        isolated: opts.isolated,
+        sharedSession: opts.sharedSession,
+    });
+}
+export async function withBrowserOperatorEnv(root, fn) {
+    const opts = getRootOpts(root);
+    const prevPort = process.env.UNICLI_DAEMON_PORT;
+    const prevFocus = process.env.UNICLI_WINDOW_FOCUSED;
+    if (opts.daemonPort) {
+        process.env.UNICLI_DAEMON_PORT = opts.daemonPort;
+    }
+    if (opts.focus) {
+        process.env.UNICLI_WINDOW_FOCUSED = "1";
+    }
+    else if (opts.background) {
+        process.env.UNICLI_WINDOW_FOCUSED = "0";
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        if (opts.daemonPort) {
+            if (prevPort === undefined)
+                delete process.env.UNICLI_DAEMON_PORT;
+            else
+                process.env.UNICLI_DAEMON_PORT = prevPort;
+        }
+        if (opts.focus || opts.background) {
+            if (prevFocus === undefined)
+                delete process.env.UNICLI_WINDOW_FOCUSED;
+            else
+                process.env.UNICLI_WINDOW_FOCUSED = prevFocus;
+        }
+    }
+}
+export async function getOperatorPage(root, namespace) {
+    const bridge = new BrowserBridge();
+    const page = await bridge.connect({
+        timeout: 30_000,
+        workspace: resolveWorkspace(root, namespace),
+    });
+    return page;
+}
+export async function operatorAction(program, root, namespace, name, fn) {
+    const startedAt = Date.now();
+    const ctx = makeCtx(`${namespace}.${name.split(" ").join("_")}`, startedAt);
+    const fmt = detectFormat(program.opts().format);
+    try {
+        const result = await withBrowserOperatorEnv(root, fn);
+        let data;
+        if (result === undefined || result === null) {
+            data = { ok: true };
+        }
+        else if (typeof result === "string") {
+            data = { value: result };
+        }
+        else if (Array.isArray(result)) {
+            data = result;
+        }
+        else if (typeof result === "object") {
+            data = result;
+        }
+        else {
+            data = { value: String(result) };
+        }
+        ctx.duration_ms = Date.now() - startedAt;
+        console.log(format(data, undefined, fmt, ctx));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const tagged = err;
+        ctx.error = {
+            code: tagged.code ?? errorTypeToCode(err),
+            message,
+            ...(tagged.suggestion ? { suggestion: tagged.suggestion } : {}),
+            retryable: /timeout|ETIMEDOUT|ECONNREFUSED|ECONNRESET|daemon failed/i.test(message),
+        };
+        ctx.duration_ms = Date.now() - startedAt;
+        console.error(format(null, undefined, fmt, ctx));
+        process.exitCode = mapErrorToExitCode(err);
+    }
+}
+export async function ensureNetworkCapture(page) {
+    const pageAny = page;
+    let captureStarted = false;
+    if (typeof pageAny.startNetworkCapture === "function") {
+        captureStarted = (await pageAny.startNetworkCapture()) !== false;
+    }
+    if (!captureStarted) {
+        try {
+            await page.evaluate(generateInterceptorJs("", { captureText: true }));
+        }
+        catch {
+            // Best effort only.
+        }
+    }
+}
+export async function readNetworkEntries(page) {
+    const pageAny = page;
+    if (typeof pageAny.readNetworkCapture === "function") {
+        const rawEntries = (await pageAny.readNetworkCapture()) ?? [];
+        if (rawEntries.length > 0) {
+            return {
+                raw: rawEntries,
+                normalized: rawEntries.map((entry) => ({
+                    url: entry.url,
+                    method: entry.method,
+                    status: entry.status,
+                    contentType: entry.contentType,
+                    bodySize: entry.size,
+                    ...(entry.responseBody ? { body: entry.responseBody } : {}),
+                })),
+            };
+        }
+    }
+    try {
+        const raw = (await page.evaluate(generateReadInterceptedJs()));
+        const parsed = JSON.parse(raw);
+        if (parsed.length > 0) {
+            return {
+                raw: parsed,
+                normalized: parsed.map((entry) => ({
+                    url: entry.url,
+                    method: entry.method ?? "GET",
+                    status: entry.status ?? 200,
+                    contentType: entry.type === "text" ? "text/plain" : "application/json",
+                    bodySize: entry.data == null ? 0 : JSON.stringify(entry.data).length,
+                    ...(entry.data !== undefined ? { body: entry.data } : {}),
+                })),
+            };
+        }
+    }
+    catch {
+        // Interceptor not installed or buffer malformed.
+    }
+    const requests = await page.networkRequests();
+    return {
+        raw: requests,
+        normalized: requests.map((request) => ({
+            url: request.url,
+            method: request.method,
+            status: request.status,
+            contentType: request.type,
+            bodySize: request.size,
+        })),
+    };
+}
+export async function readFrames(page) {
+    const raw = (await page.sendCDP("Page.getFrameTree"));
+    const frames = [];
+    function walk(tree, includeSelf) {
+        if (!tree)
+            return;
+        if (includeSelf && tree.frame?.id) {
+            frames.push({
+                index: frames.length,
+                frameId: tree.frame.id,
+                parentFrameId: tree.frame.parentId,
+                url: tree.frame.url ?? "",
+            });
+        }
+        for (const child of tree.childFrames ?? []) {
+            walk(child, true);
+        }
+    }
+    walk(raw.frameTree ?? null, false);
+    return frames;
+}
+export function buildFindJs(selector, limit, textMax) {
+    const selectorJson = JSON.stringify(selector);
+    return `(() => {
+    const matches = Array.from(document.querySelectorAll(${selectorJson})).slice(0, ${String(limit)});
+    let maxRef = 0;
+    for (const node of document.querySelectorAll('[data-unicli-ref]')) {
+      const value = parseInt(node.getAttribute('data-unicli-ref') || '0', 10);
+      if (!Number.isNaN(value) && value > maxRef) maxRef = value;
+    }
+    return matches.map((el, index) => {
+      let ref = el.getAttribute('data-unicli-ref');
+      if (!ref) {
+        ref = String(++maxRef);
+        el.setAttribute('data-unicli-ref', ref);
+      }
+      const style = window.getComputedStyle(el);
+      const rect = el.getBoundingClientRect();
+      const visible =
+        style.display !== 'none' &&
+        style.visibility !== 'hidden' &&
+        rect.width > 0 &&
+        rect.height > 0;
+      const attrs = {};
+      for (const name of ['id', 'name', 'type', 'href', 'src', 'placeholder', 'role', 'aria-label', 'data-testid']) {
+        const value = el.getAttribute(name);
+        if (value) attrs[name] = value;
+      }
+      return {
+        nth: index,
+        ref,
+        tag: el.tagName.toLowerCase(),
+        role: el.getAttribute('role') || el.tagName.toLowerCase(),
+        text: (el.innerText || el.textContent || '').trim().slice(0, ${String(textMax)}),
+        visible,
+        attrs,
+      };
+    });
+  })()`;
+}
+export function buildExtractJs(selector) {
+    const selectorJson = selector && selector.trim() ? JSON.stringify(selector.trim()) : "null";
+    return `(() => {
+    const picks = [];
+    const explicit = ${selectorJson};
+    if (explicit) picks.push(explicit);
+    picks.push('main', 'article', '[role="main"]', 'body');
+    let target = null;
+    let resolved = 'body';
+    for (const pick of picks) {
+      const node = document.querySelector(pick);
+      if (node) {
+        target = node;
+        resolved = pick;
+        break;
+      }
+    }
+    const text = (target?.innerText || document.body?.innerText || '').replace(/\\u00a0/g, ' ').trim();
+    return {
+      selector: resolved,
+      title: document.title || '',
+      url: location.href,
+      content: text,
+    };
+  })()`;
+}
+function isSameOrDescendantPath(parent, candidate) {
+    const rel = relative(parent, candidate);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+export function resolveAllowedUploadPath(filePath) {
+    const absolutePath = resolve(filePath);
+    if (isSensitivePathRealpath(absolutePath)) {
+        const denial = buildSensitivePathDenial(absolutePath);
+        const err = new Error("upload blocked by sensitive-path guard");
+        err.code = "permission_denied";
+        err.suggestion = denial.hint;
+        throw err;
+    }
+    const cwd = process.cwd();
+    const home = homedir();
+    if (!isSameOrDescendantPath(cwd, absolutePath) &&
+        !isSameOrDescendantPath(home, absolutePath)) {
+        const err = new Error(`upload blocked: path ${absolutePath} is outside workspace and home directory`);
+        err.code = "permission_denied";
+        err.suggestion =
+            "Copy the file under the current working directory or $HOME before uploading.";
+        throw err;
+    }
+    return absolutePath;
+}
+//# sourceMappingURL=browser-operator-runtime.js.map

package/dist/commands/browser-operator-runtime.js.map

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

package/dist/commands/browser-operator.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "commander";
+import { withBrowserOperatorEnv } from "./browser-operator-runtime.js";
+export { withBrowserOperatorEnv };
+export declare function applyBrowserOperatorRootOptions(command: Command): void;
+export declare function registerBrowserOperatorSubcommands(root: Command, program: Command, namespace: "browser" | "operate"): void;
+//# sourceMappingURL=browser-operator.d.ts.map

package/dist/commands/browser-operator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-operator.d.ts","sourceRoot":"","sources":["../../src/commands/browser-operator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,OAAO,EAUL,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoBtE;AAED,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,GAAG,SAAS,GAC/B,IAAI,CAodN"}

package/dist/commands/browser-operator.js

@@ -0,0 +1,374 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname as pathDirname, join } from "node:path";
+import chalk from "chalk";
+import { FINGERPRINT_PERSIST_JS, verifyRef, } from "../browser/snapshot-identity.js";
+import { rankCandidates } from "../browser/observe.js";
+import { buildExtractJs, buildFindJs, ensureNetworkCapture, getOperatorPage, operatorAction, readFrames, resolveAllowedUploadPath, resolveWorkspace, validateRef, withBrowserOperatorEnv, } from "./browser-operator-runtime.js";
+import { sendCommand } from "../browser/daemon-client.js";
+import { registerBrowserAuthoringSubcommands } from "./browser-authoring-operator.js";
+export { withBrowserOperatorEnv };
+export function applyBrowserOperatorRootOptions(command) {
+    command
+        .option("--workspace <name>", "Reuse a named automation workspace instead of the default shared session")
+        .option("--isolated", "Use a unique per-command workspace to avoid cross-command interference")
+        .option("--shared-session", "Force the default shared browser workspace")
+        .option("--daemon-port <port>", "Route through a specific daemon port for multi-profile setups")
+        .option("--focus", "Allow the automation window to take focus")
+        .option("--background", "Prefer background operation and avoid focus-stealing where possible");
+}
+export function registerBrowserOperatorSubcommands(root, program, namespace) {
+    root
+        .command("open <url>")
+        .description("Navigate to URL in daemon browser")
+        .action((url) => operatorAction(program, root, namespace, "open", async () => {
+        const page = await getOperatorPage(root, namespace);
+        await ensureNetworkCapture(page);
+        await page.goto(url, { settleMs: 2000 });
+        const title = await page.title();
+        return {
+            ok: true,
+            url,
+            title,
+            workspace: resolveWorkspace(root, namespace),
+        };
+    }));
+    root
+        .command("back")
+        .description("Navigate back in history")
+        .action(() => operatorAction(program, root, namespace, "back", async () => {
+        const page = await getOperatorPage(root, namespace);
+        await page.evaluate("history.back()");
+        await page.wait(2);
+        return { ok: true, url: await page.url() };
+    }));
+    root
+        .command("state")
+        .description("Get DOM accessibility tree snapshot")
+        .option("--interactive", "only show interactive elements")
+        .option("--compact", "omit decorative nodes")
+        .action((opts) => operatorAction(program, root, namespace, "state", async () => {
+        const page = await getOperatorPage(root, namespace);
+        const url = await page.url();
+        const snapshot = await page.snapshot({
+            interactive: opts.interactive,
+            compact: opts.compact,
+        });
+        console.error(chalk.dim(`URL: ${url}`));
+        return { url, snapshot };
+    }));
+    root
+        .command("screenshot [path]")
+        .description("Capture page screenshot")
+        .option("--full-page", "capture full scrollable page")
+        .action((path, opts) => operatorAction(program, root, namespace, "screenshot", async () => {
+        const page = await getOperatorPage(root, namespace);
+        const buf = await page.screenshot({
+            fullPage: opts.fullPage,
+            path: path ?? undefined,
+        });
+        if (path) {
+            return { ok: true, path, size: buf.length };
+        }
+        return buf.toString("base64");
+    }));
+    root
+        .command("click <ref>")
+        .description("Click element by ref number from state")
+        .action((ref) => operatorAction(program, root, namespace, "click", async () => {
+        validateRef(ref);
+        const page = await getOperatorPage(root, namespace);
+        const selector = `[data-unicli-ref="${ref}"]`;
+        await verifyRef(page, selector);
+        await page.click(selector);
+        return { ok: true, clicked: ref };
+    }));
+    root
+        .command("type <ref> <text>")
+        .description("Type text into element by ref number")
+        .action((ref, text) => operatorAction(program, root, namespace, "type", async () => {
+        validateRef(ref);
+        const page = await getOperatorPage(root, namespace);
+        const selector = `[data-unicli-ref="${ref}"]`;
+        await verifyRef(page, selector);
+        await page.click(selector);
+        await page.wait(0.3);
+        await page.insertText(text);
+        return { ok: true, ref, text };
+    }));
+    root
+        .command("keys <key>")
+        .description("Press keyboard key (e.g., Enter, Escape, Control+a)")
+        .action((key) => operatorAction(program, root, namespace, "keys", async () => {
+        const page = await getOperatorPage(root, namespace);
+        if (key.includes("+")) {
+            const parts = key.split("+");
+            const actualKey = parts.pop();
+            await page.press(actualKey, parts.map((modifier) => modifier.toLowerCase()));
+        }
+        else {
+            await page.press(key);
+        }
+        return { ok: true, key };
+    }));
+    root
+        .command("scroll [direction]")
+        .description("Scroll page (down, up, bottom, top)")
+        .option("--auto", "auto-scroll to bottom")
+        .option("--max <n>", "max scroll iterations for auto", "10")
+        .action((direction, opts) => operatorAction(program, root, namespace, "scroll", async () => {
+        const page = await getOperatorPage(root, namespace);
+        if (opts.auto) {
+            await page.autoScroll({
+                maxScrolls: parseInt(opts.max, 10),
+                delay: 1000,
+            });
+        }
+        else {
+            await page.scroll((direction ?? "down"));
+        }
+        return { ok: true, direction: direction ?? "down" };
+    }));
+    const get = root
+        .command("get")
+        .description("Get page data (title, url, text, value, html, attributes)");
+    get
+        .command("title")
+        .description("Get page title")
+        .action(() => operatorAction(program, root, namespace, "get title", async () => {
+        const page = await getOperatorPage(root, namespace);
+        return await page.title();
+    }));
+    get
+        .command("url")
+        .description("Get current URL")
+        .action(() => operatorAction(program, root, namespace, "get url", async () => {
+        const page = await getOperatorPage(root, namespace);
+        return await page.url();
+    }));
+    get
+        .command("text <ref>")
+        .description("Get text content of element by ref")
+        .action((ref) => operatorAction(program, root, namespace, "get text", async () => {
+        validateRef(ref);
+        const page = await getOperatorPage(root, namespace);
+        return await page.evaluate(`document.querySelector('[data-unicli-ref="${ref}"]')?.textContent?.trim() ?? null`);
+    }));
+    get
+        .command("value <ref>")
+        .description("Get value of input element by ref")
+        .action((ref) => operatorAction(program, root, namespace, "get value", async () => {
+        validateRef(ref);
+        const page = await getOperatorPage(root, namespace);
+        return await page.evaluate(`document.querySelector('[data-unicli-ref="${ref}"]')?.value ?? null`);
+    }));
+    get
+        .command("html [selector]")
+        .description("Get outerHTML of element (or full page)")
+        .action((selector) => operatorAction(program, root, namespace, "get html", async () => {
+        const page = await getOperatorPage(root, namespace);
+        if (selector) {
+            const selectorStr = JSON.stringify(selector);
+            return await page.evaluate(`document.querySelector(${selectorStr})?.outerHTML?.slice(0, 50000) ?? null`);
+        }
+        return await page.evaluate("document.documentElement.outerHTML.slice(0, 50000)");
+    }));
+    get
+        .command("attributes <ref>")
+        .description("Get all attributes of element by ref")
+        .action((ref) => operatorAction(program, root, namespace, "get attributes", async () => {
+        validateRef(ref);
+        const page = await getOperatorPage(root, namespace);
+        return await page.evaluate(`(() => { const el = document.querySelector('[data-unicli-ref="${ref}"]'); if (!el) return null; const attrs = {}; for (const a of el.attributes) attrs[a.name] = a.value; return attrs; })()`);
+    }));
+    root
+        .command("wait <type> [value]")
+        .description("Wait for condition (time <ms>, selector <sel>, text <str>)")
+        .option("--timeout <ms>", "timeout in ms", "10000")
+        .action((type, value, opts) => operatorAction(program, root, namespace, "wait", async () => {
+        const page = await getOperatorPage(root, namespace);
+        const timeout = parseInt(opts.timeout, 10);
+        switch (type) {
+            case "time":
+                await page.wait(parseInt(value ?? "1000", 10) / 1000);
+                break;
+            case "selector":
+                if (!value)
+                    throw new Error("selector value required");
+                await page.waitForSelector(value, timeout);
+                break;
+            case "text": {
+                if (!value)
+                    throw new Error("text value required");
+                const deadline = Date.now() + timeout;
+                const valueStr = JSON.stringify(value);
+                while (Date.now() < deadline) {
+                    const found = await page.evaluate(`document.body.innerText.includes(${valueStr})`);
+                    if (found)
+                        return { ok: true, found: true };
+                    await new Promise((resolve) => setTimeout(resolve, 200));
+                }
+                throw new Error(`Text "${value}" not found within ${String(timeout)}ms`);
+            }
+            default:
+                throw new Error(`Unknown wait type: ${type}. Use: time, selector, text`);
+        }
+        return { ok: true };
+    }));
+    root
+        .command("eval <js>")
+        .description("Execute JavaScript in page context")
+        .action((js) => operatorAction(program, root, namespace, "eval", async () => {
+        const page = await getOperatorPage(root, namespace);
+        return await page.evaluate(js);
+    }));
+    registerBrowserAuthoringSubcommands(root, program, namespace);
+    root
+        .command("select <ref> <option>")
+        .description("Select option in dropdown by ref")
+        .action((ref, option) => operatorAction(program, root, namespace, "select", async () => {
+        validateRef(ref);
+        const page = await getOperatorPage(root, namespace);
+        const optionStr = JSON.stringify(option);
+        await page.evaluate(`(() => {
+            const el = document.querySelector('[data-unicli-ref="${ref}"]');
+            if (!el || el.tagName !== 'SELECT') throw new Error('Not a <select> element');
+            el.value = ${optionStr};
+            el.dispatchEvent(new Event('change', { bubbles: true }));
+          })()`);
+        return { ok: true, ref, option };
+    }));
+    root
+        .command("upload <ref> <path>")
+        .description("Upload file to file input element by ref number")
+        .action((ref, filePath) => operatorAction(program, root, namespace, "upload", async () => {
+        validateRef(ref);
+        const selector = `[data-unicli-ref="${ref}"]`;
+        const absolutePath = resolveAllowedUploadPath(filePath);
+        const page = await getOperatorPage(root, namespace);
+        await page.setFileInput(selector, [absolutePath]);
+        return { ok: true, ref, path: absolutePath };
+    }));
+    root
+        .command("hover <ref>")
+        .description("Hover over element by ref number")
+        .action((ref) => operatorAction(program, root, namespace, "hover", async () => {
+        validateRef(ref);
+        const selector = `[data-unicli-ref="${ref}"]`;
+        const selectorJson = JSON.stringify(selector);
+        const page = await getOperatorPage(root, namespace);
+        await page.evaluate(`(() => {
+            const el = document.querySelector(${selectorJson});
+            if (!el) throw new Error('Element not found: ' + ${selectorJson});
+            el.dispatchEvent(new MouseEvent('mouseenter', { bubbles: true }));
+            el.dispatchEvent(new MouseEvent('mouseover', { bubbles: true }));
+          })()`);
+        return { ok: true, ref };
+    }));
+    root
+        .command("observe <query>")
+        .description("Preview ranked candidate actions for a natural-language goal")
+        .option("--top-k <n>", "Number of candidates to return", "5")
+        .option("--cache <path>", "Cache file (default ~/.unicli/observe-cache.jsonl)")
+        .action((query, opts) => operatorAction(program, root, namespace, "observe", async () => {
+        const page = await getOperatorPage(root, namespace);
+        const rawSnapshot = await page.snapshot({
+            interactive: true,
+            raw: true,
+        });
+        let parsed = { refs: [] };
+        if (typeof rawSnapshot === "string") {
+            try {
+                parsed = JSON.parse(rawSnapshot);
+            }
+            catch {
+                // Ignore malformed raw snapshot payloads.
+            }
+        }
+        else {
+            parsed = rawSnapshot;
+        }
+        const refs = Array.isArray(parsed.refs) ? parsed.refs : [];
+        const topK = parseInt(opts.topK ?? "5", 10) || 5;
+        const candidates = rankCandidates(refs, query, topK);
+        const cachePath = opts.cache ?? join(homedir(), ".unicli", "observe-cache.jsonl");
+        try {
+            mkdirSync(pathDirname(cachePath), { recursive: true });
+            appendFileSync(cachePath, JSON.stringify({
+                ts: new Date().toISOString(),
+                url: await page.url(),
+                query,
+                candidates,
+            }) + "\n", "utf-8");
+        }
+        catch {
+            // Cache failures are non-fatal.
+        }
+        return { query, candidates };
+    }));
+    root
+        .command("find")
+        .description("Find elements by CSS selector and allocate refs on demand")
+        .requiredOption("--css <selector>", "CSS selector to query")
+        .option("--limit <n>", "Maximum matches to return", "20")
+        .option("--text-max <n>", "Maximum text length per row", "120")
+        .action((opts) => operatorAction(program, root, namespace, "find", async () => {
+        const page = await getOperatorPage(root, namespace);
+        const results = (await page.evaluate(buildFindJs(opts.css, parseInt(opts.limit, 10) || 20, parseInt(opts.textMax, 10) || 120)));
+        try {
+            await page.evaluate(FINGERPRINT_PERSIST_JS);
+        }
+        catch {
+            // Best-effort only.
+        }
+        return results;
+    }));
+    root
+        .command("frames")
+        .description("List iframe frame tree entries for the current page")
+        .action(() => operatorAction(program, root, namespace, "frames", async () => {
+        const page = await getOperatorPage(root, namespace);
+        return await readFrames(page);
+    }));
+    root
+        .command("extract")
+        .description("Extract long-form page text with chunked pagination")
+        .option("--selector <css>", "Optional content root selector")
+        .option("--chunk-size <n>", "Maximum chars to return", "8000")
+        .option("--start <n>", "Start offset", "0")
+        .action((opts) => operatorAction(program, root, namespace, "extract", async () => {
+        const page = await getOperatorPage(root, namespace);
+        const result = (await page.evaluate(buildExtractJs(opts.selector)));
+        const start = Math.max(0, parseInt(opts.start, 10) || 0);
+        const chunkSize = Math.max(256, parseInt(opts.chunkSize, 10) || 8000);
+        const end = Math.min(result.content.length, start + chunkSize);
+        return {
+            url: result.url,
+            title: result.title,
+            selector: result.selector,
+            total_chars: result.content.length,
+            chunk_size: chunkSize,
+            start,
+            end,
+            next_start_char: end < result.content.length ? end : null,
+            content: result.content.slice(start, end),
+        };
+    }));
+    root
+        .command("tabs")
+        .description("List tabs for the current browser workspace")
+        .action(() => operatorAction(program, root, namespace, "tabs", async () => {
+        const workspace = resolveWorkspace(root, namespace);
+        const result = await sendCommand("tabs", { workspace });
+        return Array.isArray(result) ? result : [];
+    }));
+    root
+        .command("close")
+        .description("Close the automation browser window")
+        .action(() => operatorAction(program, root, namespace, "close", async () => {
+        const page = await getOperatorPage(root, namespace);
+        await page.closeWindow();
+        return { ok: true, workspace: resolveWorkspace(root, namespace) };
+    }));
+}
+//# sourceMappingURL=browser-operator.js.map