@particle-academy/agent-integrations 0.46.0 → 0.47.1

package/dist/dom-navigation/index.d.ts

@@ -0,0 +1,175 @@
+import { PageSnapshot, PageReadout, NavigationConfirmRequest, NavigationBridgeAdapter } from '../bridges/navigation.js';
+export { PageAction } from '../bridges/navigation.js';
+import '../tool-host-LYfdPE8u.js';
+import '../types-gzIpsUDE.js';
+import '../types-VX_9je7w.js';
+
+/**
+ * The in-page half of DOM co-browsing: a framework-free walker that turns a
+ * live document into a {@link PageSnapshot} of stable handles, and acts on
+ * those handles.
+ *
+ * Extracted from px-ui-sandbox's CoBrowseProvider so a host that does NOT own
+ * the page (Genie's browser, showing sites through an Electron
+ * WebContentsView) can run the same walker, injected into an isolated world.
+ *
+ * Constraints this file holds, because the injected IIFE is built from it:
+ *
+ * - NO runtime imports. Type-only imports are erased; anything else would be
+ *   bundled into a script that must run with no module loader.
+ * - Nothing touches `document` / `window` until a method is called, so the
+ *   script can be evaluated in a context with no DOM at all.
+ * - Every result is plain, structured-cloneable data.
+ *
+ * Trust boundary: the page is hostile input. It controls every attribute,
+ * label and text node read here. Two consequences:
+ * - Sensitive values (passwords, card fields, one-time codes, anything marked
+ *   `data-private`) are masked HERE, before anything leaves the page — the host
+ *   cannot mask what it has already received.
+ * - Handles are compared as plain strings, never spliced into a CSS selector,
+ *   so a crafted handle cannot change what a lookup matches.
+ */
+
+/** Elements the walker considers actionable. */
+declare const INTERACTIVE = "a[href], button, input, select, textarea, [role=button], [role=link], [role=checkbox], [role=tab], [data-co-handle]";
+/** Every method the in-page agent answers. The wire protocol is exactly this list. */
+declare const DOM_NAVIGATION_METHODS: readonly ["getLocation", "describe", "read", "visit", "back", "forward", "scrollTo", "scrollBy", "setField", "click", "submit", "rectFor"];
+type DomNavigationMethod = (typeof DOM_NAVIGATION_METHODS)[number];
+type ActionResult = {
+    ok: boolean;
+    error?: string;
+};
+type HandleRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+type FieldElement = HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+declare function isVisible(el: Element): boolean;
+/** Sensitive fields whose value is never read into the snapshot. */
+declare function isSensitive(el: Element): boolean;
+declare function roleOf(el: Element): string;
+declare function accessibleName(el: Element): string;
+declare function isDestructive(el: Element, label: string): boolean;
+/**
+ * The element's own stable handle: data-co-handle → name → id, or "" when it
+ * has none. An EMPTY attribute counts as absent — `button.name` is `""`, not
+ * null, on every button, anchor and input without one, so a plain `??` chain
+ * never reaches the id.
+ */
+declare function attributeHandle(el: Element): string;
+/**
+ * Build a fresh snapshot + a handle→element registry. Handle preference:
+ * data-co-handle → name → id → `role#index` (stable within a snapshot).
+ */
+declare function walk(doc?: Document): {
+    snapshot: PageSnapshot;
+    registry: Map<string, Element>;
+};
+/**
+ * Set a field's value so a React-controlled input sees the change.
+ *
+ * - Text, textarea, select: call the PROTOTYPE `value` setter (React shadows
+ *   `value` on the instance with its value tracker), then dispatch bubbling
+ *   `input` + `change`.
+ * - Checkbox, radio: React's onChange for these listens to `click`, not
+ *   `input` / `change`, so the write is a real `click()` — the browser toggles
+ *   the box and fires click, input and change itself. Only when the state
+ *   actually differs, so setting the current value is a no-op rather than a
+ *   toggle. A radio cannot be unchecked by clicking it; that one case falls
+ *   back to the setter.
+ */
+declare function setNativeValue(el: FieldElement, value: unknown): void;
+/**
+ * Visible text / heading outline, with sensitive text removed. Structured, so
+ * the bridge can render each page-supplied string on its own single line.
+ */
+declare function readPage(doc?: Document): PageReadout;
+type DomNavigationAgentOptions = {
+    /** Document to drive. Default: the global `document`, read lazily. */
+    document?: Document;
+    /**
+     * Called just before the agent acts on the page — before resolving a field
+     * for `setField`, and after resolving (only when the element exists) for
+     * `click` / `submit`. The sandbox uses it to attribute the request an action
+     * causes to the agent.
+     */
+    beforeAction?: (action: "setField" | "click" | "submit") => void;
+};
+type DomNavigationAgent = {
+    getLocation(): {
+        url: string;
+        title: string;
+    };
+    describe(): PageSnapshot;
+    read(): PageReadout;
+    /** Navigate. Only http(s) or same-site paths; deferred a tick so a remote call returns first. */
+    visit(url: string): void;
+    back(): void;
+    forward(): void;
+    scrollTo(opts: {
+        x?: number;
+        y?: number;
+        handle?: string;
+    }): void;
+    scrollBy(dy: number): void;
+    setField(handle: string, value: unknown): ActionResult;
+    click(handle: string): ActionResult;
+    submit(handle: string): ActionResult;
+    rectFor(handle: string): HandleRect | null;
+    /** Element for a handle: this snapshot's registry, then a live attribute lookup. */
+    resolve(handle: string): Element | null;
+    /** Serialisable dispatch — what the injected script exposes to a host. */
+    call(method: DomNavigationMethod, args?: unknown[]): unknown;
+};
+declare function createDomNavigationAgent(options?: DomNavigationAgentOptions): DomNavigationAgent;
+
+/**
+ * The host half: a {@link NavigationBridgeAdapter} that drives a page it does
+ * not run in, through any transport that can carry a method name and plain
+ * arguments into the page and a plain result back — Electron's
+ * `executeJavaScript` / `executeJavaScriptInIsolatedWorld`, a MessagePort, a
+ * WebSocket to a remote browser.
+ *
+ * Every result is treated as hostile: the page owns the DOM the in-page walker
+ * reads, and if the script was injected into the MAIN world the page can
+ * replace the walker outright. So results are coerced to the declared shapes
+ * here, and anything malformed is dropped rather than passed on to the agent.
+ */
+
+/** The global the injected script installs in the world it runs in. */
+declare const DOM_NAVIGATION_GLOBAL = "__fancyDomNavigation";
+/** Bumped only if the wire protocol changes incompatibly. */
+declare const DOM_NAVIGATION_PROTOCOL = 1;
+/**
+ * Carries one call into the page. `args` and the resolved value are plain,
+ * structured-cloneable data. Reject (or throw) when the call could not be
+ * delivered — e.g. the page navigated and the script must be re-injected.
+ */
+type DomNavigationTransport = {
+    call(method: DomNavigationMethod, args: unknown[]): Promise<unknown>;
+};
+type RemoteNavigationAdapterOptions = {
+    transport: DomNavigationTransport;
+    /** Optional fancy-screens screen id for presence targeting. */
+    screenId?: string;
+    /** Human-control revision, if the host tracks one. Omit to disable stale-intent protection. */
+    getRevision?: () => number | Promise<number>;
+    /**
+     * Trust-but-verify. Without it, `page_submit` and destructive `page_click`
+     * are NOT staged — they run as soon as the agent asks. A host showing pages
+     * it does not own should always supply one.
+     */
+    confirm?: (req: NavigationConfirmRequest) => Promise<boolean>;
+};
+/**
+ * A JavaScript expression that performs one call against the injected global —
+ * what a host passes to `executeJavaScript`. Arguments are embedded as JSON,
+ * which is a valid JS expression, so no argument can break out of its literal.
+ */
+declare function domNavigationCallScript(method: DomNavigationMethod, args?: unknown[]): string;
+/** Build a NavigationBridgeAdapter backed by a transport into the page. */
+declare function createRemoteNavigationAdapter(options: RemoteNavigationAdapterOptions): NavigationBridgeAdapter;
+
+export { type ActionResult, DOM_NAVIGATION_GLOBAL, DOM_NAVIGATION_METHODS, DOM_NAVIGATION_PROTOCOL, type DomNavigationAgent, type DomNavigationAgentOptions, type DomNavigationMethod, type DomNavigationTransport, type HandleRect, INTERACTIVE, NavigationBridgeAdapter, NavigationConfirmRequest, PageReadout, PageSnapshot, type RemoteNavigationAdapterOptions, accessibleName, attributeHandle, createDomNavigationAgent, createRemoteNavigationAdapter, domNavigationCallScript, isDestructive, isSensitive, isVisible, readPage, roleOf, setNativeValue, walk };

package/dist/dom-navigation/script.d.cts

@@ -0,0 +1,3 @@
+declare const DOM_NAVIGATION_SCRIPT: string;
+
+export { DOM_NAVIGATION_SCRIPT };

package/dist/dom-navigation/script.d.ts

@@ -0,0 +1,3 @@
+declare const DOM_NAVIGATION_SCRIPT: string;
+
+export { DOM_NAVIGATION_SCRIPT };

package/dist/dom-navigation-script.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+// dom-navigation-inject:virtual:dom-navigation-inject
+var virtual_dom_navigation_inject_default = '"use strict";\n(() => {\n  // src/dom-navigation/agent.ts\n  var INTERACTIVE = "a[href], button, input, select, textarea, [role=button], [role=link], [role=checkbox], [role=tab], [data-co-handle]";\n  var tag = (el) => el.tagName.toUpperCase();\n  function isVisible(el) {\n    const he = el;\n    if (el.type === "hidden") return false;\n    if (he.hidden || he.getAttribute("aria-hidden") === "true") return false;\n    return he.offsetParent !== null || he.getClientRects().length > 0;\n  }\n  function isSensitive(el) {\n    const input = el;\n    const ac = (el.getAttribute("autocomplete") ?? "").toLowerCase();\n    return input.type === "password" || ac.startsWith("cc-") || ac === "one-time-code" || el.hasAttribute("data-private");\n  }\n  function insideSensitive(node) {\n    for (let el = node.parentElement; el; el = el.parentElement) {\n      if (isSensitive(el)) return true;\n    }\n    return false;\n  }\n  function safeText(root) {\n    const doc = root.ownerDocument ?? root;\n    const walker = doc.createTreeWalker(root, 4);\n    let out = "";\n    for (let n = walker.nextNode(); n; n = walker.nextNode()) {\n      if (!insideSensitive(n)) out += n.nodeValue ?? "";\n    }\n    return out;\n  }\n  function roleOf(el) {\n    const explicit = el.getAttribute("role");\n    if (explicit) return explicit;\n    const t = tag(el);\n    if (t === "A") return "link";\n    if (t === "BUTTON") return "button";\n    if (t === "SELECT") return "select";\n    if (t === "TEXTAREA") return "textbox";\n    if (t === "INPUT") {\n      const type = el.type;\n      if (type === "checkbox") return "checkbox";\n      if (type === "radio") return "radio";\n      if (type === "submit" || type === "button") return "button";\n      return "textbox";\n    }\n    return "generic";\n  }\n  function labelFor(doc, id) {\n    for (const lbl of Array.from(doc.querySelectorAll("label[for]"))) {\n      if (lbl.getAttribute("for") === id) return lbl;\n    }\n    return null;\n  }\n  function accessibleName(el) {\n    const doc = el.ownerDocument;\n    const aria = el.getAttribute("aria-label");\n    if (aria) return aria.trim();\n    const labelledby = el.getAttribute("aria-labelledby");\n    if (labelledby) {\n      const txt = labelledby.split(/\\s+/).map((id2) => doc.getElementById(id2)?.textContent ?? "").join(" ").trim();\n      if (txt) return txt;\n    }\n    const id = el.getAttribute("id");\n    if (id) {\n      const lbl = labelFor(doc, id);\n      if (lbl?.textContent?.trim()) return lbl.textContent.trim();\n    }\n    const wrapping = el.closest("label");\n    if (wrapping) {\n      const txt = safeText(wrapping).trim();\n      if (txt) return txt;\n    }\n    const placeholder = el.getAttribute("placeholder");\n    if (placeholder) return placeholder.trim();\n    const text = isSensitive(el) ? "" : el.textContent?.trim();\n    if (text) return text.replace(/\\s+/g, " ").slice(0, 80);\n    return el.getAttribute("name") ?? el.getAttribute("id") ?? roleOf(el);\n  }\n  function isDestructive(el, label) {\n    if (el.hasAttribute("data-co-confirm")) return true;\n    if (el.type === "submit") return true;\n    if (tag(el) === "BUTTON" && el.type === "submit") return true;\n    return /\\b(delete|remove|destroy|sign out|log ?out|cancel subscription|deactivate)\\b/i.test(label);\n  }\n  function attributeHandle(el) {\n    return el.getAttribute("data-co-handle") || el.getAttribute("name") || el.getAttribute("id") || "";\n  }\n  function walk(doc = document) {\n    const registry = /* @__PURE__ */ new Map();\n    const actions = [];\n    const seen = /* @__PURE__ */ new Set();\n    let synthetic = 0;\n    for (const el of Array.from(doc.querySelectorAll(INTERACTIVE))) {\n      if (seen.has(el) || !isVisible(el)) continue;\n      seen.add(el);\n      const label = accessibleName(el);\n      const role = roleOf(el);\n      let handle = attributeHandle(el);\n      if (!handle || registry.has(handle)) handle = `${role}#${synthetic++}`;\n      registry.set(handle, el);\n      let value;\n      if (role === "textbox" || role === "select") {\n        value = isSensitive(el) ? void 0 : el.value;\n      } else if (role === "checkbox" || role === "radio") {\n        value = el.checked;\n      }\n      const action = { handle, role, label, destructive: isDestructive(el, label) };\n      if (value !== void 0) action.value = value;\n      actions.push(action);\n    }\n    const loc = doc.defaultView?.location;\n    return {\n      snapshot: { url: loc ? loc.pathname + loc.search : "", title: doc.title, actions },\n      registry\n    };\n  }\n  function isField(el) {\n    const t = tag(el);\n    return t === "INPUT" || t === "TEXTAREA" || t === "SELECT";\n  }\n  function setNativeValue(el, value) {\n    const view = el.ownerDocument.defaultView ?? globalThis;\n    const fire = () => {\n      el.dispatchEvent(new view.Event("input", { bubbles: true }));\n      el.dispatchEvent(new view.Event("change", { bubbles: true }));\n    };\n    const t = tag(el);\n    if (t === "INPUT" && (el.type === "checkbox" || el.type === "radio")) {\n      const input = el;\n      const want = Boolean(value);\n      if (input.checked === want) return;\n      if (input.type === "checkbox" || want) {\n        input.click();\n        return;\n      }\n      const setter2 = Object.getOwnPropertyDescriptor(view.HTMLInputElement.prototype, "checked")?.set;\n      setter2?.call(el, false);\n      fire();\n      return;\n    }\n    const proto = t === "TEXTAREA" ? view.HTMLTextAreaElement.prototype : t === "SELECT" ? view.HTMLSelectElement.prototype : view.HTMLInputElement.prototype;\n    const setter = Object.getOwnPropertyDescriptor(proto, "value")?.set;\n    setter?.call(el, String(value));\n    fire();\n  }\n  function readPage(doc = document) {\n    const main = doc.querySelector("main") ?? doc.body;\n    if (!main) return { title: doc.title, headings: [], text: "" };\n    const headings = Array.from(main.querySelectorAll("h1, h2, h3")).map((h) => ({\n      level: Number(h.tagName.slice(1)),\n      text: safeText(h).trim()\n    }));\n    const text = safeText(main).replace(/\\s+/g, " ").trim().slice(0, 4e3);\n    return { title: doc.title, headings, text };\n  }\n  function findByAttribute(doc, attr, value) {\n    for (const el of Array.from(doc.querySelectorAll(`[${attr}]`))) {\n      if (el.getAttribute(attr) === value) return el;\n    }\n    return null;\n  }\n  var num = (v) => typeof v === "number" ? v : void 0;\n  function createDomNavigationAgent(options = {}) {\n    let registry = /* @__PURE__ */ new Map();\n    const doc = () => options.document ?? document;\n    const win = () => doc().defaultView ?? window;\n    const before = (action) => options.beforeAction?.(action);\n    const resolve = (handle) => {\n      const hit = registry.get(handle);\n      if (hit && hit.isConnected) return hit;\n      const d = doc();\n      return findByAttribute(d, "data-co-handle", handle) ?? findByAttribute(d, "name", handle) ?? d.getElementById(handle);\n    };\n    const agent = {\n      getLocation: () => {\n        const loc = win().location;\n        return { url: loc.pathname + loc.search, title: doc().title };\n      },\n      describe: () => {\n        const res = walk(doc());\n        registry = res.registry;\n        return res.snapshot;\n      },\n      read: () => readPage(doc()),\n      visit: (url) => {\n        const w = win();\n        const target = new URL(String(url), w.location.href);\n        if (target.protocol !== "http:" && target.protocol !== "https:") {\n          throw new Error(`Refusing to navigate to a \'${target.protocol}\' URL.`);\n        }\n        w.setTimeout(() => w.location.assign(target.href), 0);\n      },\n      back: () => win().history.back(),\n      forward: () => win().history.forward(),\n      scrollTo: ({ x, y, handle }) => {\n        const w = win();\n        if (handle) {\n          resolve(handle)?.scrollIntoView({ behavior: "smooth", block: "center" });\n          return;\n        }\n        w.scrollTo({ left: x ?? w.scrollX, top: y ?? w.scrollY, behavior: "smooth" });\n      },\n      scrollBy: (dy) => win().scrollBy({ top: dy, behavior: "smooth" }),\n      setField: (handle, value) => {\n        before("setField");\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle "${handle}"` };\n        if (isField(el)) {\n          setNativeValue(el, value);\n          return { ok: true };\n        }\n        return { ok: false, error: `Handle "${handle}" is not a form field` };\n      },\n      click: (handle) => {\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle "${handle}"` };\n        before("click");\n        el.click();\n        return { ok: true };\n      },\n      submit: (handle) => {\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle "${handle}"` };\n        const form = tag(el) === "FORM" ? el : el.closest("form");\n        if (!form) return { ok: false, error: `Handle "${handle}" is not inside a form` };\n        before("submit");\n        if (typeof form.requestSubmit === "function") form.requestSubmit();\n        else form.submit();\n        return { ok: true };\n      },\n      rectFor: (handle) => {\n        const el = resolve(handle);\n        if (!el) return null;\n        const r = el.getBoundingClientRect();\n        return { x: r.left, y: r.top, width: r.width, height: r.height };\n      },\n      resolve,\n      call: (method, args = []) => {\n        const a = Array.isArray(args) ? args : [];\n        const handle = String(a[0] ?? "");\n        switch (method) {\n          case "getLocation":\n            return agent.getLocation();\n          case "describe":\n            return agent.describe();\n          case "read":\n            return agent.read();\n          case "visit":\n            agent.visit(String(a[0] ?? ""));\n            return void 0;\n          case "back":\n            agent.back();\n            return void 0;\n          case "forward":\n            agent.forward();\n            return void 0;\n          case "scrollTo": {\n            const o = a[0] && typeof a[0] === "object" ? a[0] : {};\n            agent.scrollTo({\n              x: num(o.x),\n              y: num(o.y),\n              handle: typeof o.handle === "string" ? o.handle : void 0\n            });\n            return void 0;\n          }\n          case "scrollBy":\n            agent.scrollBy(Number(a[0] ?? 0));\n            return void 0;\n          case "setField":\n            return agent.setField(handle, a[1]);\n          case "click":\n            return agent.click(handle);\n          case "submit":\n            return agent.submit(handle);\n          case "rectFor":\n            return agent.rectFor(handle);\n          default:\n            throw new Error(`Unknown dom-navigation method: ${String(method)}`);\n        }\n      }\n    };\n    return agent;\n  }\n\n  // src/dom-navigation/inject.ts\n  var KEY = "__fancyDomNavigation";\n  var PROTOCOL = 1;\n  var g = globalThis;\n  var existing = g[KEY];\n  if (!existing || existing.protocol !== PROTOCOL) {\n    const agent = createDomNavigationAgent();\n    Object.defineProperty(globalThis, KEY, {\n      configurable: true,\n      enumerable: false,\n      writable: false,\n      value: Object.freeze({\n        protocol: PROTOCOL,\n        call: (method, args) => agent.call(method, args)\n      })\n    });\n  }\n})();\n';
+
+// src/dom-navigation/script.ts
+var DOM_NAVIGATION_SCRIPT = virtual_dom_navigation_inject_default;
+
+exports.DOM_NAVIGATION_SCRIPT = DOM_NAVIGATION_SCRIPT;
+//# sourceMappingURL=dom-navigation-script.cjs.map
+//# sourceMappingURL=dom-navigation-script.cjs.map

package/dist/dom-navigation-script.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["dom-navigation-inject:virtual:dom-navigation-inject","../src/dom-navigation/script.ts"],"names":[],"mappings":";;;AAAA,IAAA,qCAAA,GAAA,gxWAAA;;;ACcO,IAAM,qBAAA,GAAgC","file":"dom-navigation-script.cjs","sourcesContent":["\"use strict\";\n(() => {\n  // src/dom-navigation/agent.ts\n  var INTERACTIVE = \"a[href], button, input, select, textarea, [role=button], [role=link], [role=checkbox], [role=tab], [data-co-handle]\";\n  var tag = (el) => el.tagName.toUpperCase();\n  function isVisible(el) {\n    const he = el;\n    if (el.type === \"hidden\") return false;\n    if (he.hidden || he.getAttribute(\"aria-hidden\") === \"true\") return false;\n    return he.offsetParent !== null || he.getClientRects().length > 0;\n  }\n  function isSensitive(el) {\n    const input = el;\n    const ac = (el.getAttribute(\"autocomplete\") ?? \"\").toLowerCase();\n    return input.type === \"password\" || ac.startsWith(\"cc-\") || ac === \"one-time-code\" || el.hasAttribute(\"data-private\");\n  }\n  function insideSensitive(node) {\n    for (let el = node.parentElement; el; el = el.parentElement) {\n      if (isSensitive(el)) return true;\n    }\n    return false;\n  }\n  function safeText(root) {\n    const doc = root.ownerDocument ?? root;\n    const walker = doc.createTreeWalker(root, 4);\n    let out = \"\";\n    for (let n = walker.nextNode(); n; n = walker.nextNode()) {\n      if (!insideSensitive(n)) out += n.nodeValue ?? \"\";\n    }\n    return out;\n  }\n  function roleOf(el) {\n    const explicit = el.getAttribute(\"role\");\n    if (explicit) return explicit;\n    const t = tag(el);\n    if (t === \"A\") return \"link\";\n    if (t === \"BUTTON\") return \"button\";\n    if (t === \"SELECT\") return \"select\";\n    if (t === \"TEXTAREA\") return \"textbox\";\n    if (t === \"INPUT\") {\n      const type = el.type;\n      if (type === \"checkbox\") return \"checkbox\";\n      if (type === \"radio\") return \"radio\";\n      if (type === \"submit\" || type === \"button\") return \"button\";\n      return \"textbox\";\n    }\n    return \"generic\";\n  }\n  function labelFor(doc, id) {\n    for (const lbl of Array.from(doc.querySelectorAll(\"label[for]\"))) {\n      if (lbl.getAttribute(\"for\") === id) return lbl;\n    }\n    return null;\n  }\n  function accessibleName(el) {\n    const doc = el.ownerDocument;\n    const aria = el.getAttribute(\"aria-label\");\n    if (aria) return aria.trim();\n    const labelledby = el.getAttribute(\"aria-labelledby\");\n    if (labelledby) {\n      const txt = labelledby.split(/\\s+/).map((id2) => doc.getElementById(id2)?.textContent ?? \"\").join(\" \").trim();\n      if (txt) return txt;\n    }\n    const id = el.getAttribute(\"id\");\n    if (id) {\n      const lbl = labelFor(doc, id);\n      if (lbl?.textContent?.trim()) return lbl.textContent.trim();\n    }\n    const wrapping = el.closest(\"label\");\n    if (wrapping) {\n      const txt = safeText(wrapping).trim();\n      if (txt) return txt;\n    }\n    const placeholder = el.getAttribute(\"placeholder\");\n    if (placeholder) return placeholder.trim();\n    const text = isSensitive(el) ? \"\" : el.textContent?.trim();\n    if (text) return text.replace(/\\s+/g, \" \").slice(0, 80);\n    return el.getAttribute(\"name\") ?? el.getAttribute(\"id\") ?? roleOf(el);\n  }\n  function isDestructive(el, label) {\n    if (el.hasAttribute(\"data-co-confirm\")) return true;\n    if (el.type === \"submit\") return true;\n    if (tag(el) === \"BUTTON\" && el.type === \"submit\") return true;\n    return /\\b(delete|remove|destroy|sign out|log ?out|cancel subscription|deactivate)\\b/i.test(label);\n  }\n  function attributeHandle(el) {\n    return el.getAttribute(\"data-co-handle\") || el.getAttribute(\"name\") || el.getAttribute(\"id\") || \"\";\n  }\n  function walk(doc = document) {\n    const registry = /* @__PURE__ */ new Map();\n    const actions = [];\n    const seen = /* @__PURE__ */ new Set();\n    let synthetic = 0;\n    for (const el of Array.from(doc.querySelectorAll(INTERACTIVE))) {\n      if (seen.has(el) || !isVisible(el)) continue;\n      seen.add(el);\n      const label = accessibleName(el);\n      const role = roleOf(el);\n      let handle = attributeHandle(el);\n      if (!handle || registry.has(handle)) handle = `${role}#${synthetic++}`;\n      registry.set(handle, el);\n      let value;\n      if (role === \"textbox\" || role === \"select\") {\n        value = isSensitive(el) ? void 0 : el.value;\n      } else if (role === \"checkbox\" || role === \"radio\") {\n        value = el.checked;\n      }\n      const action = { handle, role, label, destructive: isDestructive(el, label) };\n      if (value !== void 0) action.value = value;\n      actions.push(action);\n    }\n    const loc = doc.defaultView?.location;\n    return {\n      snapshot: { url: loc ? loc.pathname + loc.search : \"\", title: doc.title, actions },\n      registry\n    };\n  }\n  function isField(el) {\n    const t = tag(el);\n    return t === \"INPUT\" || t === \"TEXTAREA\" || t === \"SELECT\";\n  }\n  function setNativeValue(el, value) {\n    const view = el.ownerDocument.defaultView ?? globalThis;\n    const fire = () => {\n      el.dispatchEvent(new view.Event(\"input\", { bubbles: true }));\n      el.dispatchEvent(new view.Event(\"change\", { bubbles: true }));\n    };\n    const t = tag(el);\n    if (t === \"INPUT\" && (el.type === \"checkbox\" || el.type === \"radio\")) {\n      const input = el;\n      const want = Boolean(value);\n      if (input.checked === want) return;\n      if (input.type === \"checkbox\" || want) {\n        input.click();\n        return;\n      }\n      const setter2 = Object.getOwnPropertyDescriptor(view.HTMLInputElement.prototype, \"checked\")?.set;\n      setter2?.call(el, false);\n      fire();\n      return;\n    }\n    const proto = t === \"TEXTAREA\" ? view.HTMLTextAreaElement.prototype : t === \"SELECT\" ? view.HTMLSelectElement.prototype : view.HTMLInputElement.prototype;\n    const setter = Object.getOwnPropertyDescriptor(proto, \"value\")?.set;\n    setter?.call(el, String(value));\n    fire();\n  }\n  function readPage(doc = document) {\n    const main = doc.querySelector(\"main\") ?? doc.body;\n    if (!main) return { title: doc.title, headings: [], text: \"\" };\n    const headings = Array.from(main.querySelectorAll(\"h1, h2, h3\")).map((h) => ({\n      level: Number(h.tagName.slice(1)),\n      text: safeText(h).trim()\n    }));\n    const text = safeText(main).replace(/\\s+/g, \" \").trim().slice(0, 4e3);\n    return { title: doc.title, headings, text };\n  }\n  function findByAttribute(doc, attr, value) {\n    for (const el of Array.from(doc.querySelectorAll(`[${attr}]`))) {\n      if (el.getAttribute(attr) === value) return el;\n    }\n    return null;\n  }\n  var num = (v) => typeof v === \"number\" ? v : void 0;\n  function createDomNavigationAgent(options = {}) {\n    let registry = /* @__PURE__ */ new Map();\n    const doc = () => options.document ?? document;\n    const win = () => doc().defaultView ?? window;\n    const before = (action) => options.beforeAction?.(action);\n    const resolve = (handle) => {\n      const hit = registry.get(handle);\n      if (hit && hit.isConnected) return hit;\n      const d = doc();\n      return findByAttribute(d, \"data-co-handle\", handle) ?? findByAttribute(d, \"name\", handle) ?? d.getElementById(handle);\n    };\n    const agent = {\n      getLocation: () => {\n        const loc = win().location;\n        return { url: loc.pathname + loc.search, title: doc().title };\n      },\n      describe: () => {\n        const res = walk(doc());\n        registry = res.registry;\n        return res.snapshot;\n      },\n      read: () => readPage(doc()),\n      visit: (url) => {\n        const w = win();\n        const target = new URL(String(url), w.location.href);\n        if (target.protocol !== \"http:\" && target.protocol !== \"https:\") {\n          throw new Error(`Refusing to navigate to a '${target.protocol}' URL.`);\n        }\n        w.setTimeout(() => w.location.assign(target.href), 0);\n      },\n      back: () => win().history.back(),\n      forward: () => win().history.forward(),\n      scrollTo: ({ x, y, handle }) => {\n        const w = win();\n        if (handle) {\n          resolve(handle)?.scrollIntoView({ behavior: \"smooth\", block: \"center\" });\n          return;\n        }\n        w.scrollTo({ left: x ?? w.scrollX, top: y ?? w.scrollY, behavior: \"smooth\" });\n      },\n      scrollBy: (dy) => win().scrollBy({ top: dy, behavior: \"smooth\" }),\n      setField: (handle, value) => {\n        before(\"setField\");\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle \"${handle}\"` };\n        if (isField(el)) {\n          setNativeValue(el, value);\n          return { ok: true };\n        }\n        return { ok: false, error: `Handle \"${handle}\" is not a form field` };\n      },\n      click: (handle) => {\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle \"${handle}\"` };\n        before(\"click\");\n        el.click();\n        return { ok: true };\n      },\n      submit: (handle) => {\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle \"${handle}\"` };\n        const form = tag(el) === \"FORM\" ? el : el.closest(\"form\");\n        if (!form) return { ok: false, error: `Handle \"${handle}\" is not inside a form` };\n        before(\"submit\");\n        if (typeof form.requestSubmit === \"function\") form.requestSubmit();\n        else form.submit();\n        return { ok: true };\n      },\n      rectFor: (handle) => {\n        const el = resolve(handle);\n        if (!el) return null;\n        const r = el.getBoundingClientRect();\n        return { x: r.left, y: r.top, width: r.width, height: r.height };\n      },\n      resolve,\n      call: (method, args = []) => {\n        const a = Array.isArray(args) ? args : [];\n        const handle = String(a[0] ?? \"\");\n        switch (method) {\n          case \"getLocation\":\n            return agent.getLocation();\n          case \"describe\":\n            return agent.describe();\n          case \"read\":\n            return agent.read();\n          case \"visit\":\n            agent.visit(String(a[0] ?? \"\"));\n            return void 0;\n          case \"back\":\n            agent.back();\n            return void 0;\n          case \"forward\":\n            agent.forward();\n            return void 0;\n          case \"scrollTo\": {\n            const o = a[0] && typeof a[0] === \"object\" ? a[0] : {};\n            agent.scrollTo({\n              x: num(o.x),\n              y: num(o.y),\n              handle: typeof o.handle === \"string\" ? o.handle : void 0\n            });\n            return void 0;\n          }\n          case \"scrollBy\":\n            agent.scrollBy(Number(a[0] ?? 0));\n            return void 0;\n          case \"setField\":\n            return agent.setField(handle, a[1]);\n          case \"click\":\n            return agent.click(handle);\n          case \"submit\":\n            return agent.submit(handle);\n          case \"rectFor\":\n            return agent.rectFor(handle);\n          default:\n            throw new Error(`Unknown dom-navigation method: ${String(method)}`);\n        }\n      }\n    };\n    return agent;\n  }\n\n  // src/dom-navigation/inject.ts\n  var KEY = \"__fancyDomNavigation\";\n  var PROTOCOL = 1;\n  var g = globalThis;\n  var existing = g[KEY];\n  if (!existing || existing.protocol !== PROTOCOL) {\n    const agent = createDomNavigationAgent();\n    Object.defineProperty(globalThis, KEY, {\n      configurable: true,\n      enumerable: false,\n      writable: false,\n      value: Object.freeze({\n        protocol: PROTOCOL,\n        call: (method, args) => agent.call(method, args)\n      })\n    });\n  }\n})();\n","/**\n * `@particle-academy/agent-integrations/dom-navigation/script`\n *\n * The in-page walker as one self-contained script string — no imports, no\n * module system — for a host to inject into a page it does not own:\n *\n *   await webContents.executeJavaScriptInIsolatedWorld(worldId, [{ code: DOM_NAVIGATION_SCRIPT }]);\n *\n * Built at package build time from ./inject.ts (see\n * scripts/dom-navigation-inject-plugin.ts). Its own subpath so a host process\n * that only injects never loads the walker as a module, and vice versa.\n */\nimport source from \"virtual:dom-navigation-inject\";\n\nexport const DOM_NAVIGATION_SCRIPT: string = source;\n"]}

package/dist/dom-navigation-script.js

@@ -0,0 +1,9 @@
+// dom-navigation-inject:virtual:dom-navigation-inject
+var virtual_dom_navigation_inject_default = '"use strict";\n(() => {\n  // src/dom-navigation/agent.ts\n  var INTERACTIVE = "a[href], button, input, select, textarea, [role=button], [role=link], [role=checkbox], [role=tab], [data-co-handle]";\n  var tag = (el) => el.tagName.toUpperCase();\n  function isVisible(el) {\n    const he = el;\n    if (el.type === "hidden") return false;\n    if (he.hidden || he.getAttribute("aria-hidden") === "true") return false;\n    return he.offsetParent !== null || he.getClientRects().length > 0;\n  }\n  function isSensitive(el) {\n    const input = el;\n    const ac = (el.getAttribute("autocomplete") ?? "").toLowerCase();\n    return input.type === "password" || ac.startsWith("cc-") || ac === "one-time-code" || el.hasAttribute("data-private");\n  }\n  function insideSensitive(node) {\n    for (let el = node.parentElement; el; el = el.parentElement) {\n      if (isSensitive(el)) return true;\n    }\n    return false;\n  }\n  function safeText(root) {\n    const doc = root.ownerDocument ?? root;\n    const walker = doc.createTreeWalker(root, 4);\n    let out = "";\n    for (let n = walker.nextNode(); n; n = walker.nextNode()) {\n      if (!insideSensitive(n)) out += n.nodeValue ?? "";\n    }\n    return out;\n  }\n  function roleOf(el) {\n    const explicit = el.getAttribute("role");\n    if (explicit) return explicit;\n    const t = tag(el);\n    if (t === "A") return "link";\n    if (t === "BUTTON") return "button";\n    if (t === "SELECT") return "select";\n    if (t === "TEXTAREA") return "textbox";\n    if (t === "INPUT") {\n      const type = el.type;\n      if (type === "checkbox") return "checkbox";\n      if (type === "radio") return "radio";\n      if (type === "submit" || type === "button") return "button";\n      return "textbox";\n    }\n    return "generic";\n  }\n  function labelFor(doc, id) {\n    for (const lbl of Array.from(doc.querySelectorAll("label[for]"))) {\n      if (lbl.getAttribute("for") === id) return lbl;\n    }\n    return null;\n  }\n  function accessibleName(el) {\n    const doc = el.ownerDocument;\n    const aria = el.getAttribute("aria-label");\n    if (aria) return aria.trim();\n    const labelledby = el.getAttribute("aria-labelledby");\n    if (labelledby) {\n      const txt = labelledby.split(/\\s+/).map((id2) => doc.getElementById(id2)?.textContent ?? "").join(" ").trim();\n      if (txt) return txt;\n    }\n    const id = el.getAttribute("id");\n    if (id) {\n      const lbl = labelFor(doc, id);\n      if (lbl?.textContent?.trim()) return lbl.textContent.trim();\n    }\n    const wrapping = el.closest("label");\n    if (wrapping) {\n      const txt = safeText(wrapping).trim();\n      if (txt) return txt;\n    }\n    const placeholder = el.getAttribute("placeholder");\n    if (placeholder) return placeholder.trim();\n    const text = isSensitive(el) ? "" : el.textContent?.trim();\n    if (text) return text.replace(/\\s+/g, " ").slice(0, 80);\n    return el.getAttribute("name") ?? el.getAttribute("id") ?? roleOf(el);\n  }\n  function isDestructive(el, label) {\n    if (el.hasAttribute("data-co-confirm")) return true;\n    if (el.type === "submit") return true;\n    if (tag(el) === "BUTTON" && el.type === "submit") return true;\n    return /\\b(delete|remove|destroy|sign out|log ?out|cancel subscription|deactivate)\\b/i.test(label);\n  }\n  function attributeHandle(el) {\n    return el.getAttribute("data-co-handle") || el.getAttribute("name") || el.getAttribute("id") || "";\n  }\n  function walk(doc = document) {\n    const registry = /* @__PURE__ */ new Map();\n    const actions = [];\n    const seen = /* @__PURE__ */ new Set();\n    let synthetic = 0;\n    for (const el of Array.from(doc.querySelectorAll(INTERACTIVE))) {\n      if (seen.has(el) || !isVisible(el)) continue;\n      seen.add(el);\n      const label = accessibleName(el);\n      const role = roleOf(el);\n      let handle = attributeHandle(el);\n      if (!handle || registry.has(handle)) handle = `${role}#${synthetic++}`;\n      registry.set(handle, el);\n      let value;\n      if (role === "textbox" || role === "select") {\n        value = isSensitive(el) ? void 0 : el.value;\n      } else if (role === "checkbox" || role === "radio") {\n        value = el.checked;\n      }\n      const action = { handle, role, label, destructive: isDestructive(el, label) };\n      if (value !== void 0) action.value = value;\n      actions.push(action);\n    }\n    const loc = doc.defaultView?.location;\n    return {\n      snapshot: { url: loc ? loc.pathname + loc.search : "", title: doc.title, actions },\n      registry\n    };\n  }\n  function isField(el) {\n    const t = tag(el);\n    return t === "INPUT" || t === "TEXTAREA" || t === "SELECT";\n  }\n  function setNativeValue(el, value) {\n    const view = el.ownerDocument.defaultView ?? globalThis;\n    const fire = () => {\n      el.dispatchEvent(new view.Event("input", { bubbles: true }));\n      el.dispatchEvent(new view.Event("change", { bubbles: true }));\n    };\n    const t = tag(el);\n    if (t === "INPUT" && (el.type === "checkbox" || el.type === "radio")) {\n      const input = el;\n      const want = Boolean(value);\n      if (input.checked === want) return;\n      if (input.type === "checkbox" || want) {\n        input.click();\n        return;\n      }\n      const setter2 = Object.getOwnPropertyDescriptor(view.HTMLInputElement.prototype, "checked")?.set;\n      setter2?.call(el, false);\n      fire();\n      return;\n    }\n    const proto = t === "TEXTAREA" ? view.HTMLTextAreaElement.prototype : t === "SELECT" ? view.HTMLSelectElement.prototype : view.HTMLInputElement.prototype;\n    const setter = Object.getOwnPropertyDescriptor(proto, "value")?.set;\n    setter?.call(el, String(value));\n    fire();\n  }\n  function readPage(doc = document) {\n    const main = doc.querySelector("main") ?? doc.body;\n    if (!main) return { title: doc.title, headings: [], text: "" };\n    const headings = Array.from(main.querySelectorAll("h1, h2, h3")).map((h) => ({\n      level: Number(h.tagName.slice(1)),\n      text: safeText(h).trim()\n    }));\n    const text = safeText(main).replace(/\\s+/g, " ").trim().slice(0, 4e3);\n    return { title: doc.title, headings, text };\n  }\n  function findByAttribute(doc, attr, value) {\n    for (const el of Array.from(doc.querySelectorAll(`[${attr}]`))) {\n      if (el.getAttribute(attr) === value) return el;\n    }\n    return null;\n  }\n  var num = (v) => typeof v === "number" ? v : void 0;\n  function createDomNavigationAgent(options = {}) {\n    let registry = /* @__PURE__ */ new Map();\n    const doc = () => options.document ?? document;\n    const win = () => doc().defaultView ?? window;\n    const before = (action) => options.beforeAction?.(action);\n    const resolve = (handle) => {\n      const hit = registry.get(handle);\n      if (hit && hit.isConnected) return hit;\n      const d = doc();\n      return findByAttribute(d, "data-co-handle", handle) ?? findByAttribute(d, "name", handle) ?? d.getElementById(handle);\n    };\n    const agent = {\n      getLocation: () => {\n        const loc = win().location;\n        return { url: loc.pathname + loc.search, title: doc().title };\n      },\n      describe: () => {\n        const res = walk(doc());\n        registry = res.registry;\n        return res.snapshot;\n      },\n      read: () => readPage(doc()),\n      visit: (url) => {\n        const w = win();\n        const target = new URL(String(url), w.location.href);\n        if (target.protocol !== "http:" && target.protocol !== "https:") {\n          throw new Error(`Refusing to navigate to a \'${target.protocol}\' URL.`);\n        }\n        w.setTimeout(() => w.location.assign(target.href), 0);\n      },\n      back: () => win().history.back(),\n      forward: () => win().history.forward(),\n      scrollTo: ({ x, y, handle }) => {\n        const w = win();\n        if (handle) {\n          resolve(handle)?.scrollIntoView({ behavior: "smooth", block: "center" });\n          return;\n        }\n        w.scrollTo({ left: x ?? w.scrollX, top: y ?? w.scrollY, behavior: "smooth" });\n      },\n      scrollBy: (dy) => win().scrollBy({ top: dy, behavior: "smooth" }),\n      setField: (handle, value) => {\n        before("setField");\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle "${handle}"` };\n        if (isField(el)) {\n          setNativeValue(el, value);\n          return { ok: true };\n        }\n        return { ok: false, error: `Handle "${handle}" is not a form field` };\n      },\n      click: (handle) => {\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle "${handle}"` };\n        before("click");\n        el.click();\n        return { ok: true };\n      },\n      submit: (handle) => {\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle "${handle}"` };\n        const form = tag(el) === "FORM" ? el : el.closest("form");\n        if (!form) return { ok: false, error: `Handle "${handle}" is not inside a form` };\n        before("submit");\n        if (typeof form.requestSubmit === "function") form.requestSubmit();\n        else form.submit();\n        return { ok: true };\n      },\n      rectFor: (handle) => {\n        const el = resolve(handle);\n        if (!el) return null;\n        const r = el.getBoundingClientRect();\n        return { x: r.left, y: r.top, width: r.width, height: r.height };\n      },\n      resolve,\n      call: (method, args = []) => {\n        const a = Array.isArray(args) ? args : [];\n        const handle = String(a[0] ?? "");\n        switch (method) {\n          case "getLocation":\n            return agent.getLocation();\n          case "describe":\n            return agent.describe();\n          case "read":\n            return agent.read();\n          case "visit":\n            agent.visit(String(a[0] ?? ""));\n            return void 0;\n          case "back":\n            agent.back();\n            return void 0;\n          case "forward":\n            agent.forward();\n            return void 0;\n          case "scrollTo": {\n            const o = a[0] && typeof a[0] === "object" ? a[0] : {};\n            agent.scrollTo({\n              x: num(o.x),\n              y: num(o.y),\n              handle: typeof o.handle === "string" ? o.handle : void 0\n            });\n            return void 0;\n          }\n          case "scrollBy":\n            agent.scrollBy(Number(a[0] ?? 0));\n            return void 0;\n          case "setField":\n            return agent.setField(handle, a[1]);\n          case "click":\n            return agent.click(handle);\n          case "submit":\n            return agent.submit(handle);\n          case "rectFor":\n            return agent.rectFor(handle);\n          default:\n            throw new Error(`Unknown dom-navigation method: ${String(method)}`);\n        }\n      }\n    };\n    return agent;\n  }\n\n  // src/dom-navigation/inject.ts\n  var KEY = "__fancyDomNavigation";\n  var PROTOCOL = 1;\n  var g = globalThis;\n  var existing = g[KEY];\n  if (!existing || existing.protocol !== PROTOCOL) {\n    const agent = createDomNavigationAgent();\n    Object.defineProperty(globalThis, KEY, {\n      configurable: true,\n      enumerable: false,\n      writable: false,\n      value: Object.freeze({\n        protocol: PROTOCOL,\n        call: (method, args) => agent.call(method, args)\n      })\n    });\n  }\n})();\n';
+
+// src/dom-navigation/script.ts
+var DOM_NAVIGATION_SCRIPT = virtual_dom_navigation_inject_default;
+
+export { DOM_NAVIGATION_SCRIPT };
+//# sourceMappingURL=dom-navigation-script.js.map
+//# sourceMappingURL=dom-navigation-script.js.map

package/dist/dom-navigation-script.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["dom-navigation-inject:virtual:dom-navigation-inject","../src/dom-navigation/script.ts"],"names":[],"mappings":";AAAA,IAAA,qCAAA,GAAA,gxWAAA;;;ACcO,IAAM,qBAAA,GAAgC","file":"dom-navigation-script.js","sourcesContent":["\"use strict\";\n(() => {\n  // src/dom-navigation/agent.ts\n  var INTERACTIVE = \"a[href], button, input, select, textarea, [role=button], [role=link], [role=checkbox], [role=tab], [data-co-handle]\";\n  var tag = (el) => el.tagName.toUpperCase();\n  function isVisible(el) {\n    const he = el;\n    if (el.type === \"hidden\") return false;\n    if (he.hidden || he.getAttribute(\"aria-hidden\") === \"true\") return false;\n    return he.offsetParent !== null || he.getClientRects().length > 0;\n  }\n  function isSensitive(el) {\n    const input = el;\n    const ac = (el.getAttribute(\"autocomplete\") ?? \"\").toLowerCase();\n    return input.type === \"password\" || ac.startsWith(\"cc-\") || ac === \"one-time-code\" || el.hasAttribute(\"data-private\");\n  }\n  function insideSensitive(node) {\n    for (let el = node.parentElement; el; el = el.parentElement) {\n      if (isSensitive(el)) return true;\n    }\n    return false;\n  }\n  function safeText(root) {\n    const doc = root.ownerDocument ?? root;\n    const walker = doc.createTreeWalker(root, 4);\n    let out = \"\";\n    for (let n = walker.nextNode(); n; n = walker.nextNode()) {\n      if (!insideSensitive(n)) out += n.nodeValue ?? \"\";\n    }\n    return out;\n  }\n  function roleOf(el) {\n    const explicit = el.getAttribute(\"role\");\n    if (explicit) return explicit;\n    const t = tag(el);\n    if (t === \"A\") return \"link\";\n    if (t === \"BUTTON\") return \"button\";\n    if (t === \"SELECT\") return \"select\";\n    if (t === \"TEXTAREA\") return \"textbox\";\n    if (t === \"INPUT\") {\n      const type = el.type;\n      if (type === \"checkbox\") return \"checkbox\";\n      if (type === \"radio\") return \"radio\";\n      if (type === \"submit\" || type === \"button\") return \"button\";\n      return \"textbox\";\n    }\n    return \"generic\";\n  }\n  function labelFor(doc, id) {\n    for (const lbl of Array.from(doc.querySelectorAll(\"label[for]\"))) {\n      if (lbl.getAttribute(\"for\") === id) return lbl;\n    }\n    return null;\n  }\n  function accessibleName(el) {\n    const doc = el.ownerDocument;\n    const aria = el.getAttribute(\"aria-label\");\n    if (aria) return aria.trim();\n    const labelledby = el.getAttribute(\"aria-labelledby\");\n    if (labelledby) {\n      const txt = labelledby.split(/\\s+/).map((id2) => doc.getElementById(id2)?.textContent ?? \"\").join(\" \").trim();\n      if (txt) return txt;\n    }\n    const id = el.getAttribute(\"id\");\n    if (id) {\n      const lbl = labelFor(doc, id);\n      if (lbl?.textContent?.trim()) return lbl.textContent.trim();\n    }\n    const wrapping = el.closest(\"label\");\n    if (wrapping) {\n      const txt = safeText(wrapping).trim();\n      if (txt) return txt;\n    }\n    const placeholder = el.getAttribute(\"placeholder\");\n    if (placeholder) return placeholder.trim();\n    const text = isSensitive(el) ? \"\" : el.textContent?.trim();\n    if (text) return text.replace(/\\s+/g, \" \").slice(0, 80);\n    return el.getAttribute(\"name\") ?? el.getAttribute(\"id\") ?? roleOf(el);\n  }\n  function isDestructive(el, label) {\n    if (el.hasAttribute(\"data-co-confirm\")) return true;\n    if (el.type === \"submit\") return true;\n    if (tag(el) === \"BUTTON\" && el.type === \"submit\") return true;\n    return /\\b(delete|remove|destroy|sign out|log ?out|cancel subscription|deactivate)\\b/i.test(label);\n  }\n  function attributeHandle(el) {\n    return el.getAttribute(\"data-co-handle\") || el.getAttribute(\"name\") || el.getAttribute(\"id\") || \"\";\n  }\n  function walk(doc = document) {\n    const registry = /* @__PURE__ */ new Map();\n    const actions = [];\n    const seen = /* @__PURE__ */ new Set();\n    let synthetic = 0;\n    for (const el of Array.from(doc.querySelectorAll(INTERACTIVE))) {\n      if (seen.has(el) || !isVisible(el)) continue;\n      seen.add(el);\n      const label = accessibleName(el);\n      const role = roleOf(el);\n      let handle = attributeHandle(el);\n      if (!handle || registry.has(handle)) handle = `${role}#${synthetic++}`;\n      registry.set(handle, el);\n      let value;\n      if (role === \"textbox\" || role === \"select\") {\n        value = isSensitive(el) ? void 0 : el.value;\n      } else if (role === \"checkbox\" || role === \"radio\") {\n        value = el.checked;\n      }\n      const action = { handle, role, label, destructive: isDestructive(el, label) };\n      if (value !== void 0) action.value = value;\n      actions.push(action);\n    }\n    const loc = doc.defaultView?.location;\n    return {\n      snapshot: { url: loc ? loc.pathname + loc.search : \"\", title: doc.title, actions },\n      registry\n    };\n  }\n  function isField(el) {\n    const t = tag(el);\n    return t === \"INPUT\" || t === \"TEXTAREA\" || t === \"SELECT\";\n  }\n  function setNativeValue(el, value) {\n    const view = el.ownerDocument.defaultView ?? globalThis;\n    const fire = () => {\n      el.dispatchEvent(new view.Event(\"input\", { bubbles: true }));\n      el.dispatchEvent(new view.Event(\"change\", { bubbles: true }));\n    };\n    const t = tag(el);\n    if (t === \"INPUT\" && (el.type === \"checkbox\" || el.type === \"radio\")) {\n      const input = el;\n      const want = Boolean(value);\n      if (input.checked === want) return;\n      if (input.type === \"checkbox\" || want) {\n        input.click();\n        return;\n      }\n      const setter2 = Object.getOwnPropertyDescriptor(view.HTMLInputElement.prototype, \"checked\")?.set;\n      setter2?.call(el, false);\n      fire();\n      return;\n    }\n    const proto = t === \"TEXTAREA\" ? view.HTMLTextAreaElement.prototype : t === \"SELECT\" ? view.HTMLSelectElement.prototype : view.HTMLInputElement.prototype;\n    const setter = Object.getOwnPropertyDescriptor(proto, \"value\")?.set;\n    setter?.call(el, String(value));\n    fire();\n  }\n  function readPage(doc = document) {\n    const main = doc.querySelector(\"main\") ?? doc.body;\n    if (!main) return { title: doc.title, headings: [], text: \"\" };\n    const headings = Array.from(main.querySelectorAll(\"h1, h2, h3\")).map((h) => ({\n      level: Number(h.tagName.slice(1)),\n      text: safeText(h).trim()\n    }));\n    const text = safeText(main).replace(/\\s+/g, \" \").trim().slice(0, 4e3);\n    return { title: doc.title, headings, text };\n  }\n  function findByAttribute(doc, attr, value) {\n    for (const el of Array.from(doc.querySelectorAll(`[${attr}]`))) {\n      if (el.getAttribute(attr) === value) return el;\n    }\n    return null;\n  }\n  var num = (v) => typeof v === \"number\" ? v : void 0;\n  function createDomNavigationAgent(options = {}) {\n    let registry = /* @__PURE__ */ new Map();\n    const doc = () => options.document ?? document;\n    const win = () => doc().defaultView ?? window;\n    const before = (action) => options.beforeAction?.(action);\n    const resolve = (handle) => {\n      const hit = registry.get(handle);\n      if (hit && hit.isConnected) return hit;\n      const d = doc();\n      return findByAttribute(d, \"data-co-handle\", handle) ?? findByAttribute(d, \"name\", handle) ?? d.getElementById(handle);\n    };\n    const agent = {\n      getLocation: () => {\n        const loc = win().location;\n        return { url: loc.pathname + loc.search, title: doc().title };\n      },\n      describe: () => {\n        const res = walk(doc());\n        registry = res.registry;\n        return res.snapshot;\n      },\n      read: () => readPage(doc()),\n      visit: (url) => {\n        const w = win();\n        const target = new URL(String(url), w.location.href);\n        if (target.protocol !== \"http:\" && target.protocol !== \"https:\") {\n          throw new Error(`Refusing to navigate to a '${target.protocol}' URL.`);\n        }\n        w.setTimeout(() => w.location.assign(target.href), 0);\n      },\n      back: () => win().history.back(),\n      forward: () => win().history.forward(),\n      scrollTo: ({ x, y, handle }) => {\n        const w = win();\n        if (handle) {\n          resolve(handle)?.scrollIntoView({ behavior: \"smooth\", block: \"center\" });\n          return;\n        }\n        w.scrollTo({ left: x ?? w.scrollX, top: y ?? w.scrollY, behavior: \"smooth\" });\n      },\n      scrollBy: (dy) => win().scrollBy({ top: dy, behavior: \"smooth\" }),\n      setField: (handle, value) => {\n        before(\"setField\");\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle \"${handle}\"` };\n        if (isField(el)) {\n          setNativeValue(el, value);\n          return { ok: true };\n        }\n        return { ok: false, error: `Handle \"${handle}\" is not a form field` };\n      },\n      click: (handle) => {\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle \"${handle}\"` };\n        before(\"click\");\n        el.click();\n        return { ok: true };\n      },\n      submit: (handle) => {\n        const el = resolve(handle);\n        if (!el) return { ok: false, error: `No element for handle \"${handle}\"` };\n        const form = tag(el) === \"FORM\" ? el : el.closest(\"form\");\n        if (!form) return { ok: false, error: `Handle \"${handle}\" is not inside a form` };\n        before(\"submit\");\n        if (typeof form.requestSubmit === \"function\") form.requestSubmit();\n        else form.submit();\n        return { ok: true };\n      },\n      rectFor: (handle) => {\n        const el = resolve(handle);\n        if (!el) return null;\n        const r = el.getBoundingClientRect();\n        return { x: r.left, y: r.top, width: r.width, height: r.height };\n      },\n      resolve,\n      call: (method, args = []) => {\n        const a = Array.isArray(args) ? args : [];\n        const handle = String(a[0] ?? \"\");\n        switch (method) {\n          case \"getLocation\":\n            return agent.getLocation();\n          case \"describe\":\n            return agent.describe();\n          case \"read\":\n            return agent.read();\n          case \"visit\":\n            agent.visit(String(a[0] ?? \"\"));\n            return void 0;\n          case \"back\":\n            agent.back();\n            return void 0;\n          case \"forward\":\n            agent.forward();\n            return void 0;\n          case \"scrollTo\": {\n            const o = a[0] && typeof a[0] === \"object\" ? a[0] : {};\n            agent.scrollTo({\n              x: num(o.x),\n              y: num(o.y),\n              handle: typeof o.handle === \"string\" ? o.handle : void 0\n            });\n            return void 0;\n          }\n          case \"scrollBy\":\n            agent.scrollBy(Number(a[0] ?? 0));\n            return void 0;\n          case \"setField\":\n            return agent.setField(handle, a[1]);\n          case \"click\":\n            return agent.click(handle);\n          case \"submit\":\n            return agent.submit(handle);\n          case \"rectFor\":\n            return agent.rectFor(handle);\n          default:\n            throw new Error(`Unknown dom-navigation method: ${String(method)}`);\n        }\n      }\n    };\n    return agent;\n  }\n\n  // src/dom-navigation/inject.ts\n  var KEY = \"__fancyDomNavigation\";\n  var PROTOCOL = 1;\n  var g = globalThis;\n  var existing = g[KEY];\n  if (!existing || existing.protocol !== PROTOCOL) {\n    const agent = createDomNavigationAgent();\n    Object.defineProperty(globalThis, KEY, {\n      configurable: true,\n      enumerable: false,\n      writable: false,\n      value: Object.freeze({\n        protocol: PROTOCOL,\n        call: (method, args) => agent.call(method, args)\n      })\n    });\n  }\n})();\n","/**\n * `@particle-academy/agent-integrations/dom-navigation/script`\n *\n * The in-page walker as one self-contained script string — no imports, no\n * module system — for a host to inject into a page it does not own:\n *\n *   await webContents.executeJavaScriptInIsolatedWorld(worldId, [{ code: DOM_NAVIGATION_SCRIPT }]);\n *\n * Built at package build time from ./inject.ts (see\n * scripts/dom-navigation-inject-plugin.ts). Its own subpath so a host process\n * that only injects never loads the walker as a module, and vice versa.\n */\nimport source from \"virtual:dom-navigation-inject\";\n\nexport const DOM_NAVIGATION_SCRIPT: string = source;\n"]}