@xrkseek/harness 0.3.11 → 0.4.0-rc.2

package/node_modules/@xrkseek/exec-voice/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@xrkseek/exec-voice",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser/index.d.ts",
+      "import": "./dist/browser/index.js",
+      "default": "./dist/browser/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@xrkseek/core-tools": "workspace:*"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrkseek/XRK-harness.git",
+    "directory": "packages/exec/voice"
+  },
+  "private": true
+}

package/node_modules/@xrkseek/exec-web/README.md

@@ -1,11 +1,11 @@
 # @xrkseek/exec-web
 
-Web capability seam + model-facing `web_search` / `web_fetch`.
+Web capability seam + model-facing `web_search` / `web_fetch` / `browser_*`.
 
-- **Definition**: `WebSearch` · `WebFetch`
-- **Provider**: anonymous HTTP fetch; Tavily / Brave search when a key is set
-- **Consumer**: `createWebTools(access)` — Face cards via `presentCall` / `presentResult` (`card: "web"`)
+- **Definition**: `WebSearch` · `WebFetch` · `BrowserSession`
+- **Provider**: anonymous HTTP fetch; Tavily / Brave search when a key is set; HTTP browser session via `createHttpBrowserSession`
+- **Consumer**: `createWebTools(access)` — Face cards via `presentCall` / `presentResult` (`card: "web"`); `createBrowserTools(session)` — `browser_open` / `browser_snapshot` / `browser_act`
 
-Tools stay registered when search has no key; execute returns `isError` (`WEB_PROVIDER_UNAVAILABLE`). Fetch is always usable.
+Tools stay registered when search has no key; execute returns `isError` (`WEB_PROVIDER_UNAVAILABLE`). Fetch and browser session reuse the same URL policy. Browser is an HTTP snapshot/act session (not CDP).
 
 See [docs/seams.md](../../../docs/seams.md) · [docs/web-tools.md](../../../docs/web-tools.md).

package/node_modules/@xrkseek/exec-web/dist/browser-cdp.d.ts

@@ -0,0 +1,23 @@
+import type { BrowserSession } from "./browser-session.js";
+import type { WebFetch } from "./types.js";
+export interface CdpCaller {
+    call(method: string, params?: Record<string, unknown>, sessionId?: string): Promise<unknown>;
+    close(): void;
+}
+export declare function browserCdpUrlFromEnv(env?: NodeJS.ProcessEnv): string;
+/** Hermes-style: pass through a browser websocket, else GET /json/version. */
+export declare function resolveCdpDebuggerUrl(raw: string, fetchJson?: (url: string) => Promise<unknown>): Promise<string>;
+export declare function connectCdpWebSocket(url: string): Promise<CdpCaller>;
+export declare function createCdpBrowserSession(options: {
+    readonly rawUrl: string;
+    readonly resolve?: (raw: string) => Promise<string>;
+    readonly connect?: (wsUrl: string) => Promise<CdpCaller>;
+}): BrowserSession;
+/** HTTP snapshot unless XRK_BROWSER_CDP_URL / BROWSER_CDP_URL is set. */
+export declare function createBrowserSession(options: {
+    readonly fetch: WebFetch;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly resolve?: (raw: string) => Promise<string>;
+    readonly connect?: (wsUrl: string) => Promise<CdpCaller>;
+}): BrowserSession;
+//# sourceMappingURL=browser-cdp.d.ts.map

package/node_modules/@xrkseek/exec-web/dist/browser-cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-cdp.d.ts","sourceRoot":"","sources":["../src/browser-cdp.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAe3C,MAAM,WAAW,SAAS;IACxB,IAAI,CACF,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,IAAI,IAAI,CAAC;CACf;AAgBD,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAMR;AAED,8EAA8E;AAC9E,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAoB,GAC9D,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAaD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAmDnE;AA2CD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAC1D,GAAG,cAAc,CA6JjB;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAC1D,GAAG,cAAc,CAUjB"}

package/node_modules/@xrkseek/exec-web/dist/browser-cdp.js

@@ -0,0 +1,286 @@
+/**
+ * Optional Chrome DevTools (CDP) backend for browser_*.
+ * HTTP snapshot stays the default. @eN refs are unchanged.
+ */
+import { formatBrowserSnapshot, } from "./browser-html.js";
+import { createHttpBrowserSession } from "./browser-session.js";
+import { WebError } from "./types.js";
+const INTERACTIVE = new Set([
+    "link",
+    "button",
+    "textbox",
+    "searchbox",
+    "combobox",
+    "checkbox",
+    "radio",
+    "switch",
+    "tab",
+]);
+export function browserCdpUrlFromEnv(env = process.env) {
+    return (env.XRK_BROWSER_CDP_URL?.trim() ||
+        env.BROWSER_CDP_URL?.trim() ||
+        "");
+}
+/** Hermes-style: pass through a browser websocket, else GET /json/version. */
+export async function resolveCdpDebuggerUrl(raw, fetchJson = defaultFetchJson) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        throw new WebError("empty CDP url", "WEB_BROWSER_CDP");
+    }
+    const lowered = trimmed.toLowerCase();
+    if (lowered.includes("/devtools/browser/") || lowered.includes("/devtools/page/")) {
+        return trimmed;
+    }
+    let discovery = trimmed;
+    if (lowered.startsWith("ws://") || lowered.startsWith("wss://")) {
+        discovery =
+            (lowered.startsWith("wss://") ? "https://" : "http://") +
+                trimmed.slice(trimmed.indexOf("://") + 3);
+    }
+    const versionUrl = discovery.toLowerCase().endsWith("/json/version")
+        ? discovery
+        : `${discovery.replace(/\/$/, "")}/json/version`;
+    const payload = await fetchJson(versionUrl);
+    const ws = payload && typeof payload === "object"
+        ? payload.webSocketDebuggerUrl
+        : undefined;
+    if (typeof ws === "string" && ws.trim())
+        return ws.trim();
+    throw new WebError(`CDP discovery at ${versionUrl} did not return webSocketDebuggerUrl`, "WEB_BROWSER_CDP");
+}
+async function defaultFetchJson(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new WebError(`CDP discovery HTTP ${response.status}`, "WEB_BROWSER_CDP");
+    }
+    return response.json();
+}
+export function connectCdpWebSocket(url) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(url);
+        let next = 1;
+        const pending = new Map();
+        ws.addEventListener("error", () => {
+            reject(new WebError("CDP socket failed", "WEB_BROWSER_CDP"));
+        });
+        ws.addEventListener("message", (event) => {
+            let data;
+            try {
+                data = JSON.parse(String(event.data));
+            }
+            catch {
+                return;
+            }
+            if (typeof data.id !== "number")
+                return;
+            const waiter = pending.get(data.id);
+            if (!waiter)
+                return;
+            pending.delete(data.id);
+            if (data.error) {
+                waiter.reject(new WebError(data.error.message ?? "CDP error", "WEB_BROWSER_CDP"));
+                return;
+            }
+            waiter.resolve(data.result);
+        });
+        ws.addEventListener("open", () => {
+            resolve({
+                call(method, params, sessionId) {
+                    const id = next++;
+                    const message = {
+                        id,
+                        method,
+                        params: params ?? {},
+                    };
+                    if (sessionId)
+                        message.sessionId = sessionId;
+                    ws.send(JSON.stringify(message));
+                    return new Promise((res, rej) => {
+                        pending.set(id, { resolve: res, reject: rej });
+                    });
+                },
+                close() {
+                    ws.close();
+                },
+            });
+        });
+    });
+}
+function axNodes(result) {
+    if (!result || typeof result !== "object")
+        return [];
+    const nodes = result.nodes;
+    return Array.isArray(nodes) ? nodes : [];
+}
+function toElements(nodes) {
+    const out = [];
+    for (const node of nodes) {
+        if (node.ignored === true)
+            continue;
+        const role = typeof node.role?.value === "string" ? node.role.value : "";
+        if (!INTERACTIVE.has(role))
+            continue;
+        const backend = node.backendDOMNodeId;
+        if (typeof backend !== "number")
+            continue;
+        const name = typeof node.name?.value === "string" && node.name.value.trim()
+            ? node.name.value.trim()
+            : role;
+        out.push({
+            ref: `e${out.length + 1}`,
+            role,
+            name: name.slice(0, 120),
+            backendNodeId: backend,
+        });
+        if (out.length >= 200)
+            break;
+    }
+    return out;
+}
+function asElements(nodes) {
+    return nodes.map((node) => ({
+        ref: node.ref,
+        role: node.role === "link" ? "link" : node.role === "button" ? "button" : node.role,
+        name: node.name,
+        tag: node.role,
+        ...(node.role === "textbox" || node.role === "searchbox"
+            ? { inputType: "text" }
+            : {}),
+    }));
+}
+export function createCdpBrowserSession(options) {
+    const resolve = options.resolve ?? resolveCdpDebuggerUrl;
+    const connect = options.connect ?? connectCdpWebSocket;
+    let caller;
+    let sessionId;
+    let browserLevel = false;
+    let nodes = [];
+    let url = "";
+    let title = "";
+    const fieldValues = new Map();
+    const ensure = async () => {
+        if (caller)
+            return caller;
+        const wsUrl = await resolve(options.rawUrl);
+        browserLevel = wsUrl.toLowerCase().includes("/devtools/browser/");
+        caller = await connect(wsUrl);
+        return caller;
+    };
+    const pageEval = async (cdp, expression) => {
+        const result = (await cdp.call("Runtime.evaluate", { expression, returnByValue: true }, sessionId));
+        const value = result?.result?.value;
+        return typeof value === "string" ? value : "";
+    };
+    const readMeta = async (cdp) => {
+        url = (await pageEval(cdp, "location.href")) || url;
+        title = await pageEval(cdp, "document.title");
+    };
+    const capture = async (cdp) => {
+        await cdp.call("Accessibility.enable", {}, sessionId);
+        const tree = await cdp.call("Accessibility.getFullAXTree", {}, sessionId);
+        nodes = toElements(axNodes(tree));
+        await readMeta(cdp);
+        return nodes;
+    };
+    const paint = (full) => ({
+        url,
+        title,
+        text: formatBrowserSnapshot({
+            url,
+            title,
+            elements: asElements(nodes),
+            fieldValues,
+            ...(full ? { full: true, pageText: "" } : {}),
+        }),
+    });
+    const requireCaller = () => {
+        if (!caller) {
+            throw new WebError("no open page — call browser_open first", "WEB_BROWSER_NO_PAGE");
+        }
+        return caller;
+    };
+    return {
+        async open(nextUrl) {
+            const cdp = await ensure();
+            if (browserLevel) {
+                const created = (await cdp.call("Target.createTarget", {
+                    url: nextUrl,
+                }));
+                const targetId = created.targetId ?? "";
+                const attached = (await cdp.call("Target.attachToTarget", {
+                    targetId,
+                    flatten: true,
+                }));
+                sessionId = attached.sessionId;
+            }
+            else {
+                await cdp.call("Page.navigate", { url: nextUrl }, sessionId);
+            }
+            url = nextUrl;
+            fieldValues.clear();
+            await capture(cdp);
+            return paint(false);
+        },
+        async snapshot(opts) {
+            const cdp = requireCaller();
+            await capture(cdp);
+            return paint(opts?.full === true);
+        },
+        async captureScreenshot() {
+            const cdp = requireCaller();
+            await cdp.call("Page.enable", {}, sessionId);
+            const shot = (await cdp.call("Page.captureScreenshot", { format: "png" }, sessionId));
+            const data = typeof shot.data === "string" ? shot.data.trim() : "";
+            if (!data) {
+                throw new WebError("CDP captureScreenshot returned no image", "WEB_BROWSER_CDP");
+            }
+            return Buffer.from(data, "base64");
+        },
+        async act(request) {
+            const cdp = requireCaller();
+            const ref = request.ref.replace(/^@/, "").trim();
+            const node = nodes.find((item) => item.ref === ref);
+            if (!node) {
+                throw new WebError(`unknown ref @${ref}`, "WEB_BROWSER_BAD_REF");
+            }
+            const resolved = (await cdp.call("DOM.resolveNode", { backendNodeId: node.backendNodeId }, sessionId));
+            const objectId = resolved.object?.objectId;
+            if (!objectId) {
+                throw new WebError(`CDP could not resolve @${ref}`, "WEB_BROWSER_CDP");
+            }
+            if (request.action === "type") {
+                if (node.role !== "textbox" && node.role !== "searchbox" && node.role !== "combobox") {
+                    throw new WebError(`@${ref} is not a textbox`, "WEB_BROWSER_BAD_REF");
+                }
+                const text = request.text ?? "";
+                fieldValues.set(ref, text);
+                await cdp.call("Runtime.callFunctionOn", {
+                    objectId,
+                    functionDeclaration: "function(value){ this.focus(); this.value = value; this.dispatchEvent(new Event('input', { bubbles: true })); }",
+                    arguments: [{ value: text }],
+                }, sessionId);
+                await capture(cdp);
+                return { ...paint(false), note: `typed into @${ref}` };
+            }
+            await cdp.call("Runtime.callFunctionOn", {
+                objectId,
+                functionDeclaration: "function(){ if (this.click) this.click(); }",
+            }, sessionId);
+            await capture(cdp);
+            return { ...paint(false), note: `clicked @${ref}` };
+        },
+    };
+}
+/** HTTP snapshot unless XRK_BROWSER_CDP_URL / BROWSER_CDP_URL is set. */
+export function createBrowserSession(options) {
+    const raw = browserCdpUrlFromEnv(options.env ?? process.env);
+    if (!raw) {
+        return createHttpBrowserSession({ fetch: options.fetch });
+    }
+    return createCdpBrowserSession({
+        rawUrl: raw,
+        ...(options.resolve ? { resolve: options.resolve } : {}),
+        ...(options.connect ? { connect: options.connect } : {}),
+    });
+}
+//# sourceMappingURL=browser-cdp.js.map

package/node_modules/@xrkseek/exec-web/dist/browser-cdp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-cdp.js","sourceRoot":"","sources":["../src/browser-cdp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,qBAAqB,GAEtB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,MAAM;IACN,QAAQ;IACR,SAAS;IACT,WAAW;IACX,UAAU;IACV,UAAU;IACV,OAAO;IACP,QAAQ;IACR,KAAK;CACN,CAAC,CAAC;AAyBH,MAAM,UAAU,oBAAoB,CAClC,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,CACL,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE;QAC/B,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE;QAC3B,EAAE,CACH,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAW,EACX,YAA+C,gBAAgB;IAE/D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACtC,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAClF,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,SAAS,GAAG,OAAO,CAAC;IACxB,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChE,SAAS;YACP,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QAClE,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,EAAE,GACN,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QACpC,CAAC,CAAE,OAA8C,CAAC,oBAAoB;QACtE,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,IAAI,QAAQ,CAChB,oBAAoB,UAAU,sCAAsC,EACpE,iBAAiB,CAClB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,QAAQ,CAChB,sBAAsB,QAAQ,CAAC,MAAM,EAAE,EACvC,iBAAiB,CAClB,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,MAAM,OAAO,GAAG,IAAI,GAAG,EAGpB,CAAC;QACJ,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAChC,MAAM,CAAC,IAAI,QAAQ,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACvC,IAAI,IAAsE,CAAC;YAC3E,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAgB,CAAC;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;gBAAE,OAAO;YACxC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,MAAM,CACX,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,WAAW,EAAE,iBAAiB,CAAC,CACnE,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;YAC/B,OAAO,CAAC;gBACN,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS;oBAC5B,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;oBAClB,MAAM,OAAO,GAA4B;wBACvC,EAAE;wBACF,MAAM;wBACN,MAAM,EAAE,MAAM,IAAI,EAAE;qBACrB,CAAC;oBACF,IAAI,SAAS;wBAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;oBAC7C,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;oBACjC,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;wBAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;oBACjD,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,KAAK;oBACH,EAAE,CAAC,KAAK,EAAE,CAAC;gBACb,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,MAAe;IAC9B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,KAAK,GAAI,MAA8B,CAAC,KAAK,CAAC;IACpD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,UAAU,CAAC,KAAwB;IAC1C,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YAAE,SAAS;QACpC,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACtC,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,SAAS;QAC1C,MAAM,IAAI,GACR,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAC5D,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YACxB,CAAC,CAAC,IAAI,CAAC;QACX,GAAG,CAAC,IAAI,CAAC;YACP,GAAG,EAAE,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE;YACzB,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YACxB,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;YAAE,MAAM;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,KAAyB;IAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QACnF,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,IAAI;QACd,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YACtD,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE;YACvB,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAIvC;IACC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,qBAAqB,CAAC;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,mBAAmB,CAAC;IACvD,IAAI,MAA6B,CAAC;IAClC,IAAI,SAA6B,CAAC;IAClC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,KAAK,GAAc,EAAE,CAAC;IAC1B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9C,MAAM,MAAM,GAAG,KAAK,IAAwB,EAAE;QAC5C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5C,YAAY,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QAClE,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,EACpB,GAAc,EACd,UAAkB,EACD,EAAE;QACnB,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAC5B,kBAAkB,EAClB,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,EACnC,SAAS,CACV,CAAqC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC;QACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAc,EAAiB,EAAE;QACvD,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,IAAI,GAAG,CAAC;QACpD,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAChD,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,EAAE,GAAc,EAAsB,EAAE;QAC3D,MAAM,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;QAC1E,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,IAAc,EAAyB,EAAE,CAAC,CAAC;QACxD,GAAG;QACH,KAAK;QACL,IAAI,EAAE,qBAAqB,CAAC;YAC1B,GAAG;YACH,KAAK;YACL,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC;YAC3B,WAAW;YACX,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,GAAc,EAAE;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,QAAQ,CAChB,wCAAwC,EACxC,qBAAqB,CACtB,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,OAAO;YAChB,MAAM,GAAG,GAAG,MAAM,MAAM,EAAE,CAAC;YAC3B,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE;oBACrD,GAAG,EAAE,OAAO;iBACb,CAAC,CAA0B,CAAC;gBAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;gBACxC,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE;oBACxD,QAAQ;oBACR,OAAO,EAAE,IAAI;iBACd,CAAC,CAA2B,CAAC;gBAC9B,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;YAC/D,CAAC;YACD,GAAG,GAAG,OAAO,CAAC;YACd,WAAW,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,IAAI;YACjB,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;YAC5B,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,iBAAiB;YACrB,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;YAC5B,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAC1B,wBAAwB,EACxB,EAAE,MAAM,EAAE,KAAK,EAAE,EACjB,SAAS,CACV,CAAuB,CAAC;YACzB,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,QAAQ,CAChB,yCAAyC,EACzC,iBAAiB,CAClB,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,OAAO;YACf,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,QAAQ,CAAC,gBAAgB,GAAG,EAAE,EAAE,qBAAqB,CAAC,CAAC;YACnE,CAAC;YACD,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAC9B,iBAAiB,EACjB,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,EACrC,SAAS,CACV,CAAuC,CAAC;YACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;YAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,QAAQ,CAAC,0BAA0B,GAAG,EAAE,EAAE,iBAAiB,CAAC,CAAC;YACzE,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBACrF,MAAM,IAAI,QAAQ,CAAC,IAAI,GAAG,mBAAmB,EAAE,qBAAqB,CAAC,CAAC;gBACxE,CAAC;gBACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;gBAChC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC3B,MAAM,GAAG,CAAC,IAAI,CACZ,wBAAwB,EACxB;oBACE,QAAQ;oBACR,mBAAmB,EACjB,iHAAiH;oBACnH,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;iBAC7B,EACD,SAAS,CACV,CAAC;gBACF,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;gBACnB,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,eAAe,GAAG,EAAE,EAAE,CAAC;YACzD,CAAC;YACD,MAAM,GAAG,CAAC,IAAI,CACZ,wBAAwB,EACxB;gBACE,QAAQ;gBACR,mBAAmB,EAAE,6CAA6C;aACnE,EACD,SAAS,CACV,CAAC;YACF,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,YAAY,GAAG,EAAE,EAAE,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAAC,OAKpC;IACC,MAAM,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,wBAAwB,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,uBAAuB,CAAC;QAC7B,MAAM,EAAE,GAAG;QACX,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@xrkseek/exec-web/dist/browser-html.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Lossy HTML → interactive element refs for browser_snapshot / browser_act.
+ * Not a full a11y tree — enough for Hermes-style @eN refs without CDP.
+ */
+export interface BrowserElement {
+    readonly ref: string;
+    readonly role: string;
+    readonly name: string;
+    readonly tag: string;
+    readonly href?: string;
+    readonly inputType?: string;
+    readonly value?: string;
+}
+/** Extract clickable / fillable elements with stable @eN refs. */
+export declare function extractBrowserElements(html: string): BrowserElement[];
+export declare function formatBrowserSnapshot(options: {
+    readonly url: string;
+    readonly title: string;
+    readonly elements: readonly BrowserElement[];
+    readonly fieldValues: ReadonlyMap<string, string>;
+    readonly full?: boolean;
+    readonly pageText?: string;
+    readonly maxChars?: number;
+}): string;
+export declare function titleFromHtml(html: string): string;
+//# sourceMappingURL=browser-html.d.ts.map

package/node_modules/@xrkseek/exec-web/dist/browser-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-html.d.ts","sourceRoot":"","sources":["../src/browser-html.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAyCD,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAqCrE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,MAAM,CA6BT;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD"}

package/node_modules/@xrkseek/exec-web/dist/browser-html.js

@@ -0,0 +1,118 @@
+/**
+ * Lossy HTML → interactive element refs for browser_snapshot / browser_act.
+ * Not a full a11y tree — enough for Hermes-style @eN refs without CDP.
+ */
+const TAG_RE = /<(a|button|input|textarea|select)\b([^>]*)>(?:([\s\S]*?)<\/\1>)?/gi;
+function attr(attrs, name) {
+    const re = new RegExp(`\\b${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s>]+))`, "i");
+    const m = re.exec(attrs);
+    return m?.[1] ?? m?.[2] ?? m?.[3];
+}
+function decodeLite(text) {
+    return text
+        .replace(/&nbsp;/gi, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#(\d+);/g, (_, n) => {
+        const code = Number(n);
+        return Number.isFinite(code) ? String.fromCodePoint(code) : "";
+    })
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function roleFor(tag, inputType) {
+    if (tag === "a")
+        return "link";
+    if (tag === "button")
+        return "button";
+    if (tag === "textarea")
+        return "textbox";
+    if (tag === "select")
+        return "combobox";
+    if (tag === "input") {
+        if (inputType === "submit" || inputType === "button")
+            return "button";
+        if (inputType === "checkbox")
+            return "checkbox";
+        if (inputType === "radio")
+            return "radio";
+        if (inputType === "hidden")
+            return "none";
+        return "textbox";
+    }
+    return tag;
+}
+/** Extract clickable / fillable elements with stable @eN refs. */
+export function extractBrowserElements(html) {
+    const out = [];
+    let index = 0;
+    TAG_RE.lastIndex = 0;
+    let match;
+    while ((match = TAG_RE.exec(html)) !== null) {
+        const tag = match[1].toLowerCase();
+        const attrs = match[2] ?? "";
+        const inner = match[3] ?? "";
+        const inputType = (attr(attrs, "type") ?? "text").toLowerCase();
+        const role = roleFor(tag, inputType);
+        if (role === "none")
+            continue;
+        const name = decodeLite(attr(attrs, "aria-label") ??
+            attr(attrs, "name") ??
+            attr(attrs, "placeholder") ??
+            attr(attrs, "value") ??
+            attr(attrs, "title") ??
+            inner.replace(/<[^>]+>/g, " ")) || tag;
+        const href = attr(attrs, "href");
+        index += 1;
+        out.push({
+            ref: `e${index}`,
+            role,
+            name: name.slice(0, 120),
+            tag,
+            ...(href !== undefined ? { href } : {}),
+            ...(tag === "input" ? { inputType } : {}),
+            ...(attr(attrs, "value") !== undefined
+                ? { value: decodeLite(attr(attrs, "value")) }
+                : {}),
+        });
+        if (out.length >= 200)
+            break;
+    }
+    return out;
+}
+export function formatBrowserSnapshot(options) {
+    const maxChars = options.maxChars ?? 15_000;
+    const lines = [
+        `url: ${options.url}`,
+        `title: ${options.title || "(untitled)"}`,
+        "elements:",
+    ];
+    for (const el of options.elements) {
+        const typed = options.fieldValues.get(el.ref);
+        const value = typed !== undefined
+            ? ` value=${JSON.stringify(typed)}`
+            : el.value
+                ? ` value=${JSON.stringify(el.value)}`
+                : "";
+        const href = el.href ? ` href=${JSON.stringify(el.href)}` : "";
+        lines.push(`  @${el.ref} [${el.role}] ${el.name}${href}${value}`);
+    }
+    if (options.full && options.pageText) {
+        lines.push("text:");
+        lines.push(options.pageText);
+    }
+    let text = lines.join("\n");
+    if (text.length > maxChars) {
+        text =
+            text.slice(0, maxChars) +
+                `\n… truncated (${text.length} chars). Pass full=false or act then snapshot again.`;
+    }
+    return text;
+}
+export function titleFromHtml(html) {
+    const m = /<title[^>]*>([\s\S]*?)<\/title>/i.exec(html);
+    return m ? decodeLite(m[1] ?? "") : "";
+}
+//# sourceMappingURL=browser-html.js.map

package/node_modules/@xrkseek/exec-web/dist/browser-html.js.map

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

package/node_modules/@xrkseek/exec-web/dist/browser-session.d.ts

@@ -0,0 +1,33 @@
+import type { WebFetch } from "./types.js";
+export interface BrowserSnapshotResult {
+    readonly url: string;
+    readonly title: string;
+    readonly text: string;
+}
+export interface BrowserActRequest {
+    readonly ref: string;
+    readonly action: "click" | "type";
+    readonly text?: string;
+}
+export interface BrowserActResult {
+    readonly url: string;
+    readonly title: string;
+    readonly note: string;
+    readonly text: string;
+}
+export interface BrowserSession {
+    open(url: string, signal?: AbortSignal): Promise<BrowserSnapshotResult>;
+    snapshot(opts?: {
+        readonly full?: boolean;
+    }): Promise<BrowserSnapshotResult>;
+    /**
+     * Graphical screenshot for vision. HTTP sessions have no browser and must
+     * throw instead of returning the element list.
+     */
+    captureScreenshot(signal?: AbortSignal): Promise<Uint8Array>;
+    act(request: BrowserActRequest, signal?: AbortSignal): Promise<BrowserActResult>;
+}
+export declare function createHttpBrowserSession(options: {
+    readonly fetch: WebFetch;
+}): BrowserSession;
+//# sourceMappingURL=browser-session.d.ts.map

package/node_modules/@xrkseek/exec-web/dist/browser-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session.d.ts","sourceRoot":"","sources":["../src/browser-session.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE;QACd,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;KACzB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACnC;;;OAGG;IACH,iBAAiB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7D,GAAG,CACD,OAAO,EAAE,iBAAiB,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B;AAkBD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B,GAAG,cAAc,CAsHjB"}