@elizaos/plugin-browser 2.0.0-alpha.9 → 2.0.11-beta.7

package/dist/workspace/browser-workspace-forms.js

@@ -0,0 +1,277 @@
+import {
+  buildBrowserWorkspaceElementSelector,
+  findClosestBrowserWorkspaceForm
+} from "./browser-workspace-elements.js";
+import {
+  assertBrowserWorkspaceUrl,
+  inferBrowserWorkspaceTitle,
+  normalizeBrowserWorkspaceText
+} from "./browser-workspace-helpers.js";
+import {
+  createEmptyWebBrowserWorkspaceDom,
+  ensureBrowserWorkspaceDom,
+  getJSDOMClass,
+  installBrowserWorkspaceWebRuntime
+} from "./browser-workspace-jsdom.js";
+import { fetchBrowserWorkspaceTrackedResponse } from "./browser-workspace-network.js";
+import {
+  getBrowserWorkspaceRuntimeState,
+  getBrowserWorkspaceTimestamp,
+  resetBrowserWorkspaceRuntimeNavigationState
+} from "./browser-workspace-state.js";
+function ensureBrowserWorkspaceFormControlElement(element, subaction) {
+  if (element.tagName === "INPUT" || element.tagName === "TEXTAREA" || element.tagName === "SELECT") {
+    return element;
+  }
+  throw new Error(
+    `Eliza browser workspace ${subaction} requires an input, textarea, or select target.`
+  );
+}
+function ensureBrowserWorkspaceCheckboxElement(element, subaction) {
+  if (element.tagName === "INPUT") {
+    const input = element;
+    const type = input.type.trim().toLowerCase();
+    if (type === "checkbox" || type === "radio") {
+      return input;
+    }
+  }
+  throw new Error(
+    `Eliza browser workspace ${subaction} requires a checkbox or radio input target.`
+  );
+}
+function setBrowserWorkspaceControlValue(control, nextValue) {
+  control.value = nextValue;
+  if (control.tagName === "TEXTAREA") {
+    control.textContent = nextValue;
+  }
+  control.setAttribute("value", nextValue);
+}
+async function activateWebBrowserWorkspaceElement(tab, element, subaction) {
+  const tag = element.tagName.toLowerCase();
+  if (tag === "a") {
+    const href = element.getAttribute("href")?.trim();
+    if (!href) {
+      throw new Error("Target link does not have an href.");
+    }
+    const nextUrl = new URL(href, tab.url).toString();
+    clearWebBrowserWorkspaceTabElementRefs(tab.id);
+    tab.url = assertBrowserWorkspaceUrl(nextUrl);
+    tab.title = inferBrowserWorkspaceTitle(tab.url);
+    tab.dom = null;
+    tab.loadedUrl = null;
+    pushWebBrowserWorkspaceHistory(tab, tab.url);
+    await loadWebBrowserWorkspaceTabDocument(tab);
+    return {
+      mode: "web",
+      subaction,
+      tab: cloneWebBrowserWorkspaceTabState(tab),
+      value: {
+        clickCount: subaction === "dblclick" ? 2 : 1,
+        selector: buildBrowserWorkspaceElementSelector(element),
+        url: tab.url
+      }
+    };
+  }
+  const inputElement = tag === "input" ? element : null;
+  const inputType = inputElement?.type?.toLowerCase() ?? "";
+  if (inputElement && (inputType === "checkbox" || inputType === "radio")) {
+    inputElement.checked = inputType === "radio" ? true : !inputElement.checked;
+    return {
+      mode: "web",
+      subaction,
+      value: {
+        checked: inputElement.checked,
+        clickCount: subaction === "dblclick" ? 2 : 1,
+        selector: buildBrowserWorkspaceElementSelector(element)
+      }
+    };
+  }
+  const submitForm = findClosestBrowserWorkspaceForm(element);
+  if (submitForm && (tag === "form" || tag === "button" || tag === "input" && ["button", "image", "submit"].includes(inputType || "submit"))) {
+    await submitWebBrowserWorkspaceForm(tab, submitForm);
+    return {
+      mode: "web",
+      subaction,
+      tab: cloneWebBrowserWorkspaceTabState(tab),
+      value: {
+        clickCount: subaction === "dblclick" ? 2 : 1,
+        selector: buildBrowserWorkspaceElementSelector(element),
+        url: tab.url
+      }
+    };
+  }
+  return {
+    mode: "web",
+    subaction,
+    value: {
+      clickCount: subaction === "dblclick" ? 2 : 1,
+      selector: buildBrowserWorkspaceElementSelector(element),
+      text: normalizeBrowserWorkspaceText(element.textContent)
+    }
+  };
+}
+function scrollWebBrowserWorkspaceTarget(dom, element, direction, pixels) {
+  const resolvedPixels = Number.isFinite(pixels) ? Math.max(1, Math.abs(pixels)) : 240;
+  const axis = direction === "left" || direction === "right" ? "x" : "y";
+  const delta = direction === "up" || direction === "left" ? -resolvedPixels : resolvedPixels;
+  if (element && element instanceof dom.window.HTMLElement) {
+    if (axis === "y") {
+      element.scrollTop = (element.scrollTop || 0) + delta;
+      return {
+        axis,
+        selector: buildBrowserWorkspaceElementSelector(element),
+        value: element.scrollTop
+      };
+    }
+    element.scrollLeft = (element.scrollLeft || 0) + delta;
+    return {
+      axis,
+      selector: buildBrowserWorkspaceElementSelector(element),
+      value: element.scrollLeft
+    };
+  }
+  const key = axis === "y" ? "__elizaScrollY" : "__elizaScrollX";
+  const current = Number(Reflect.get(dom.window, key) ?? 0);
+  const next = current + delta;
+  Reflect.set(dom.window, key, next);
+  return {
+    axis,
+    selector: null,
+    value: next
+  };
+}
+async function submitWebBrowserWorkspaceForm(tab, form) {
+  const state = getBrowserWorkspaceRuntimeState("web", tab.id);
+  const dom = ensureBrowserWorkspaceDom(tab);
+  const action = form.getAttribute("action")?.trim() || tab.url;
+  const method = (form.getAttribute("method")?.trim() || "get").toLowerCase();
+  const submitUrl = new URL(action, tab.url).toString();
+  const formData = new dom.window.FormData(form);
+  const searchParams = new URLSearchParams();
+  for (const [key, value] of formData.entries()) {
+    searchParams.append(key, String(value));
+  }
+  if (method === "get") {
+    const nextUrl = new URL(submitUrl);
+    nextUrl.search = searchParams.toString();
+    clearWebBrowserWorkspaceTabElementRefs(tab.id);
+    tab.url = nextUrl.toString();
+    tab.title = inferBrowserWorkspaceTitle(tab.url);
+    tab.dom = null;
+    tab.loadedUrl = null;
+    pushWebBrowserWorkspaceHistory(tab, tab.url);
+    await loadWebBrowserWorkspaceTabDocument(tab);
+    return;
+  }
+  const response = await fetchBrowserWorkspaceTrackedResponse(
+    state,
+    submitUrl,
+    {
+      body: searchParams.toString(),
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded; charset=utf-8"
+      },
+      method: method.toUpperCase()
+    },
+    "document"
+  );
+  if (!response.ok) {
+    throw new Error(
+      `Browser workspace form submit failed (${response.status}): ${submitUrl}`
+    );
+  }
+  const html = await response.text();
+  const finalUrl = assertBrowserWorkspaceUrl(response.url?.trim() || submitUrl);
+  const nextDom = new (getJSDOMClass())(html, {
+    pretendToBeVisual: true,
+    url: finalUrl
+  });
+  installBrowserWorkspaceWebRuntime(tab, nextDom);
+  resetBrowserWorkspaceRuntimeNavigationState(state);
+  clearWebBrowserWorkspaceTabElementRefs(tab.id);
+  tab.url = finalUrl;
+  tab.dom = nextDom;
+  tab.loadedUrl = finalUrl;
+  tab.title = normalizeBrowserWorkspaceText(nextDom.window.document.title) || inferBrowserWorkspaceTitle(finalUrl);
+  tab.updatedAt = getBrowserWorkspaceTimestamp();
+  pushWebBrowserWorkspaceHistory(tab, finalUrl);
+}
+import { clearBrowserWorkspaceElementRefs } from "./browser-workspace-state.js";
+function clearWebBrowserWorkspaceTabElementRefs(tabId) {
+  clearBrowserWorkspaceElementRefs("web", tabId);
+}
+function cloneWebBrowserWorkspaceTabState(tab) {
+  return {
+    id: tab.id,
+    title: tab.title,
+    url: tab.url,
+    partition: tab.partition,
+    kind: tab.kind,
+    visible: tab.visible,
+    createdAt: tab.createdAt,
+    updatedAt: tab.updatedAt,
+    lastFocusedAt: tab.lastFocusedAt
+  };
+}
+function pushWebBrowserWorkspaceHistory(tab, nextUrl) {
+  const nextHistory = tab.history.slice(0, tab.historyIndex + 1);
+  nextHistory.push(nextUrl);
+  tab.history = nextHistory;
+  tab.historyIndex = nextHistory.length - 1;
+}
+async function loadWebBrowserWorkspaceTabDocument(tab) {
+  const state = getBrowserWorkspaceRuntimeState("web", tab.id);
+  if (tab.url === "about:blank") {
+    tab.dom = createEmptyWebBrowserWorkspaceDom(tab.url);
+    installBrowserWorkspaceWebRuntime(tab, tab.dom);
+    tab.loadedUrl = tab.url;
+    tab.title = "New Tab";
+    tab.updatedAt = getBrowserWorkspaceTimestamp();
+    return;
+  }
+  const response = await fetchBrowserWorkspaceTrackedResponse(
+    state,
+    tab.url,
+    {},
+    "document"
+  );
+  if (!response.ok) {
+    throw new Error(
+      `Browser workspace web load failed (${response.status}): ${tab.url}`
+    );
+  }
+  const html = await response.text();
+  const finalUrl = assertBrowserWorkspaceUrl(response.url?.trim() || tab.url);
+  const dom = new (getJSDOMClass())(html, {
+    pretendToBeVisual: true,
+    url: finalUrl
+  });
+  installBrowserWorkspaceWebRuntime(tab, dom);
+  resetBrowserWorkspaceRuntimeNavigationState(state);
+  tab.dom = dom;
+  tab.loadedUrl = finalUrl;
+  tab.url = finalUrl;
+  tab.title = normalizeBrowserWorkspaceText(dom.window.document.title) || inferBrowserWorkspaceTitle(finalUrl);
+  tab.updatedAt = getBrowserWorkspaceTimestamp();
+  tab.history[tab.historyIndex] = finalUrl;
+}
+async function ensureLoadedWebBrowserWorkspaceTabDocument(tab) {
+  if (!tab.dom || tab.loadedUrl !== tab.url) {
+    await loadWebBrowserWorkspaceTabDocument(tab);
+  }
+  return ensureBrowserWorkspaceDom(tab);
+}
+export {
+  activateWebBrowserWorkspaceElement,
+  clearWebBrowserWorkspaceTabElementRefs,
+  cloneWebBrowserWorkspaceTabState,
+  ensureBrowserWorkspaceCheckboxElement,
+  ensureBrowserWorkspaceFormControlElement,
+  ensureLoadedWebBrowserWorkspaceTabDocument,
+  loadWebBrowserWorkspaceTabDocument,
+  pushWebBrowserWorkspaceHistory,
+  scrollWebBrowserWorkspaceTarget,
+  setBrowserWorkspaceControlValue,
+  submitWebBrowserWorkspaceForm
+};
+//# sourceMappingURL=browser-workspace-forms.js.map

package/dist/workspace/browser-workspace-forms.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/workspace/browser-workspace-forms.ts"],"sourcesContent":["import type { JSDOM } from \"jsdom\";\nimport {\n  buildBrowserWorkspaceElementSelector,\n  findClosestBrowserWorkspaceForm,\n} from \"./browser-workspace-elements.js\";\nimport {\n  assertBrowserWorkspaceUrl,\n  inferBrowserWorkspaceTitle,\n  normalizeBrowserWorkspaceText,\n} from \"./browser-workspace-helpers.js\";\nimport {\n  createEmptyWebBrowserWorkspaceDom,\n  ensureBrowserWorkspaceDom,\n  getJSDOMClass,\n  installBrowserWorkspaceWebRuntime,\n} from \"./browser-workspace-jsdom.js\";\nimport { fetchBrowserWorkspaceTrackedResponse } from \"./browser-workspace-network.js\";\nimport {\n  getBrowserWorkspaceRuntimeState,\n  getBrowserWorkspaceTimestamp,\n  resetBrowserWorkspaceRuntimeNavigationState,\n} from \"./browser-workspace-state.js\";\nimport type {\n  BrowserWorkspaceCommandResult,\n  BrowserWorkspaceScrollDirection,\n  WebBrowserWorkspaceTabState,\n} from \"./browser-workspace-types.js\";\n\nexport function ensureBrowserWorkspaceFormControlElement(\n  element: Element,\n  subaction:\n    | \"clipboard\"\n    | \"fill\"\n    | \"keyboardinserttext\"\n    | \"keyboardtype\"\n    | \"select\"\n    | \"type\",\n): HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement {\n  if (\n    element.tagName === \"INPUT\" ||\n    element.tagName === \"TEXTAREA\" ||\n    element.tagName === \"SELECT\"\n  ) {\n    return element as\n      | HTMLInputElement\n      | HTMLTextAreaElement\n      | HTMLSelectElement;\n  }\n\n  throw new Error(\n    `Eliza browser workspace ${subaction} requires an input, textarea, or select target.`,\n  );\n}\n\nexport function ensureBrowserWorkspaceCheckboxElement(\n  element: Element,\n  subaction: \"check\" | \"uncheck\",\n): HTMLInputElement {\n  if (element.tagName === \"INPUT\") {\n    const input = element as HTMLInputElement;\n    const type = input.type.trim().toLowerCase();\n    if (type === \"checkbox\" || type === \"radio\") {\n      return input;\n    }\n  }\n\n  throw new Error(\n    `Eliza browser workspace ${subaction} requires a checkbox or radio input target.`,\n  );\n}\n\nexport function setBrowserWorkspaceControlValue(\n  control: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement,\n  nextValue: string,\n): void {\n  control.value = nextValue;\n  if (control.tagName === \"TEXTAREA\") {\n    control.textContent = nextValue;\n  }\n  control.setAttribute(\"value\", nextValue);\n}\n\nexport async function activateWebBrowserWorkspaceElement(\n  tab: WebBrowserWorkspaceTabState,\n  element: Element,\n  subaction: \"click\" | \"dblclick\",\n): Promise<BrowserWorkspaceCommandResult> {\n  const tag = element.tagName.toLowerCase();\n  if (tag === \"a\") {\n    const href = element.getAttribute(\"href\")?.trim();\n    if (!href) {\n      throw new Error(\"Target link does not have an href.\");\n    }\n    const nextUrl = new URL(href, tab.url).toString();\n    clearWebBrowserWorkspaceTabElementRefs(tab.id);\n    tab.url = assertBrowserWorkspaceUrl(nextUrl);\n    tab.title = inferBrowserWorkspaceTitle(tab.url);\n    tab.dom = null;\n    tab.loadedUrl = null;\n    pushWebBrowserWorkspaceHistory(tab, tab.url);\n    await loadWebBrowserWorkspaceTabDocument(tab);\n    return {\n      mode: \"web\",\n      subaction,\n      tab: cloneWebBrowserWorkspaceTabState(tab),\n      value: {\n        clickCount: subaction === \"dblclick\" ? 2 : 1,\n        selector: buildBrowserWorkspaceElementSelector(element),\n        url: tab.url,\n      },\n    };\n  }\n\n  const inputElement = tag === \"input\" ? (element as HTMLInputElement) : null;\n  const inputType = inputElement?.type?.toLowerCase() ?? \"\";\n  if (inputElement && (inputType === \"checkbox\" || inputType === \"radio\")) {\n    inputElement.checked = inputType === \"radio\" ? true : !inputElement.checked;\n    return {\n      mode: \"web\",\n      subaction,\n      value: {\n        checked: inputElement.checked,\n        clickCount: subaction === \"dblclick\" ? 2 : 1,\n        selector: buildBrowserWorkspaceElementSelector(element),\n      },\n    };\n  }\n\n  const submitForm = findClosestBrowserWorkspaceForm(element);\n  if (\n    submitForm &&\n    (tag === \"form\" ||\n      tag === \"button\" ||\n      (tag === \"input\" &&\n        [\"button\", \"image\", \"submit\"].includes(inputType || \"submit\")))\n  ) {\n    await submitWebBrowserWorkspaceForm(tab, submitForm);\n    return {\n      mode: \"web\",\n      subaction,\n      tab: cloneWebBrowserWorkspaceTabState(tab),\n      value: {\n        clickCount: subaction === \"dblclick\" ? 2 : 1,\n        selector: buildBrowserWorkspaceElementSelector(element),\n        url: tab.url,\n      },\n    };\n  }\n\n  return {\n    mode: \"web\",\n    subaction,\n    value: {\n      clickCount: subaction === \"dblclick\" ? 2 : 1,\n      selector: buildBrowserWorkspaceElementSelector(element),\n      text: normalizeBrowserWorkspaceText(element.textContent),\n    },\n  };\n}\n\nexport function scrollWebBrowserWorkspaceTarget(\n  dom: JSDOM,\n  element: Element | null,\n  direction: BrowserWorkspaceScrollDirection,\n  pixels: number,\n): {\n  axis: \"x\" | \"y\";\n  selector: string | null;\n  value: number;\n} {\n  const resolvedPixels = Number.isFinite(pixels)\n    ? Math.max(1, Math.abs(pixels))\n    : 240;\n  const axis = direction === \"left\" || direction === \"right\" ? \"x\" : \"y\";\n  const delta =\n    direction === \"up\" || direction === \"left\"\n      ? -resolvedPixels\n      : resolvedPixels;\n\n  if (element && element instanceof dom.window.HTMLElement) {\n    if (axis === \"y\") {\n      element.scrollTop = (element.scrollTop || 0) + delta;\n      return {\n        axis,\n        selector: buildBrowserWorkspaceElementSelector(element),\n        value: element.scrollTop,\n      };\n    }\n    element.scrollLeft = (element.scrollLeft || 0) + delta;\n    return {\n      axis,\n      selector: buildBrowserWorkspaceElementSelector(element),\n      value: element.scrollLeft,\n    };\n  }\n\n  const key = axis === \"y\" ? \"__elizaScrollY\" : \"__elizaScrollX\";\n  const current = Number(Reflect.get(dom.window, key) ?? 0);\n  const next = current + delta;\n  Reflect.set(dom.window, key, next);\n  return {\n    axis,\n    selector: null,\n    value: next,\n  };\n}\n\nexport async function submitWebBrowserWorkspaceForm(\n  tab: WebBrowserWorkspaceTabState,\n  form: HTMLFormElement,\n): Promise<void> {\n  const state = getBrowserWorkspaceRuntimeState(\"web\", tab.id);\n  const dom = ensureBrowserWorkspaceDom(tab);\n  const action = form.getAttribute(\"action\")?.trim() || tab.url;\n  const method = (form.getAttribute(\"method\")?.trim() || \"get\").toLowerCase();\n  const submitUrl = new URL(action, tab.url).toString();\n  const formData = new dom.window.FormData(form);\n  const searchParams = new URLSearchParams();\n\n  for (const [key, value] of formData.entries()) {\n    searchParams.append(key, String(value));\n  }\n\n  if (method === \"get\") {\n    const nextUrl = new URL(submitUrl);\n    nextUrl.search = searchParams.toString();\n    clearWebBrowserWorkspaceTabElementRefs(tab.id);\n    tab.url = nextUrl.toString();\n    tab.title = inferBrowserWorkspaceTitle(tab.url);\n    tab.dom = null;\n    tab.loadedUrl = null;\n    pushWebBrowserWorkspaceHistory(tab, tab.url);\n    await loadWebBrowserWorkspaceTabDocument(tab);\n    return;\n  }\n\n  const response = await fetchBrowserWorkspaceTrackedResponse(\n    state,\n    submitUrl,\n    {\n      body: searchParams.toString(),\n      headers: {\n        \"Content-Type\": \"application/x-www-form-urlencoded; charset=utf-8\",\n      },\n      method: method.toUpperCase(),\n    },\n    \"document\",\n  );\n\n  if (!response.ok) {\n    throw new Error(\n      `Browser workspace form submit failed (${response.status}): ${submitUrl}`,\n    );\n  }\n\n  const html = await response.text();\n  const finalUrl = assertBrowserWorkspaceUrl(response.url?.trim() || submitUrl);\n  const nextDom = new (getJSDOMClass())(html, {\n    pretendToBeVisual: true,\n    url: finalUrl,\n  });\n  installBrowserWorkspaceWebRuntime(tab, nextDom);\n  resetBrowserWorkspaceRuntimeNavigationState(state);\n  clearWebBrowserWorkspaceTabElementRefs(tab.id);\n  tab.url = finalUrl;\n  tab.dom = nextDom;\n  tab.loadedUrl = finalUrl;\n  tab.title =\n    normalizeBrowserWorkspaceText(nextDom.window.document.title) ||\n    inferBrowserWorkspaceTitle(finalUrl);\n  tab.updatedAt = getBrowserWorkspaceTimestamp();\n  pushWebBrowserWorkspaceHistory(tab, finalUrl);\n}\n\n// --- Web tab helpers that forms/activation need ---\n\nimport { clearBrowserWorkspaceElementRefs } from \"./browser-workspace-state.js\";\nimport type { BrowserWorkspaceTab } from \"./browser-workspace-types.js\";\n\nexport function clearWebBrowserWorkspaceTabElementRefs(tabId: string): void {\n  clearBrowserWorkspaceElementRefs(\"web\", tabId);\n}\n\nexport function cloneWebBrowserWorkspaceTabState(\n  tab: WebBrowserWorkspaceTabState,\n): BrowserWorkspaceTab {\n  return {\n    id: tab.id,\n    title: tab.title,\n    url: tab.url,\n    partition: tab.partition,\n    kind: tab.kind,\n    visible: tab.visible,\n    createdAt: tab.createdAt,\n    updatedAt: tab.updatedAt,\n    lastFocusedAt: tab.lastFocusedAt,\n  };\n}\n\nexport function pushWebBrowserWorkspaceHistory(\n  tab: WebBrowserWorkspaceTabState,\n  nextUrl: string,\n): void {\n  const nextHistory = tab.history.slice(0, tab.historyIndex + 1);\n  nextHistory.push(nextUrl);\n  tab.history = nextHistory;\n  tab.historyIndex = nextHistory.length - 1;\n}\n\nexport async function loadWebBrowserWorkspaceTabDocument(\n  tab: WebBrowserWorkspaceTabState,\n): Promise<void> {\n  const state = getBrowserWorkspaceRuntimeState(\"web\", tab.id);\n  if (tab.url === \"about:blank\") {\n    tab.dom = createEmptyWebBrowserWorkspaceDom(tab.url);\n    installBrowserWorkspaceWebRuntime(tab, tab.dom);\n    tab.loadedUrl = tab.url;\n    tab.title = \"New Tab\";\n    tab.updatedAt = getBrowserWorkspaceTimestamp();\n    return;\n  }\n\n  const response = await fetchBrowserWorkspaceTrackedResponse(\n    state,\n    tab.url,\n    {},\n    \"document\",\n  );\n  if (!response.ok) {\n    throw new Error(\n      `Browser workspace web load failed (${response.status}): ${tab.url}`,\n    );\n  }\n\n  const html = await response.text();\n  const finalUrl = assertBrowserWorkspaceUrl(response.url?.trim() || tab.url);\n  const dom = new (getJSDOMClass())(html, {\n    pretendToBeVisual: true,\n    url: finalUrl,\n  });\n  installBrowserWorkspaceWebRuntime(tab, dom);\n  resetBrowserWorkspaceRuntimeNavigationState(state);\n\n  tab.dom = dom;\n  tab.loadedUrl = finalUrl;\n  tab.url = finalUrl;\n  tab.title =\n    normalizeBrowserWorkspaceText(dom.window.document.title) ||\n    inferBrowserWorkspaceTitle(finalUrl);\n  tab.updatedAt = getBrowserWorkspaceTimestamp();\n  tab.history[tab.historyIndex] = finalUrl;\n}\n\nexport async function ensureLoadedWebBrowserWorkspaceTabDocument(\n  tab: WebBrowserWorkspaceTabState,\n): Promise<JSDOM> {\n  if (!tab.dom || tab.loadedUrl !== tab.url) {\n    await loadWebBrowserWorkspaceTabDocument(tab);\n  }\n  return ensureBrowserWorkspaceDom(tab);\n}\n"],"mappings":"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","names":[]}

package/dist/workspace/browser-workspace-helpers.d.ts

@@ -0,0 +1,32 @@
+import type { BrowserWorkspaceCommand, BrowserWorkspaceMode, BrowserWorkspaceSubaction } from "./browser-workspace-types.js";
+export declare const DEFAULT_TIMEOUT_MS = 12000;
+export declare const DEFAULT_WAIT_INTERVAL_MS = 120;
+export declare const DEFAULT_WEB_PARTITION = "persist:eliza-browser";
+export declare const CONNECTOR_BROWSER_WORKSPACE_PARTITION_PREFIX = "persist:connector-";
+export declare const DESKTOP_BRIDGE_UNAVAILABLE_MESSAGE = "Eliza browser workspace desktop bridge is unavailable.";
+export declare const browserWorkspacePageFetch: any;
+export declare function normalizeEnvValue(value: string | undefined): string | null;
+export declare function normalizeBrowserWorkspaceText(value: unknown): string;
+export declare function parseBrowserWorkspaceNumberLike(value: unknown): number | undefined;
+export declare function assertBrowserWorkspaceUrl(rawUrl: string): string;
+export declare function inferBrowserWorkspaceTitle(url: string): string;
+export declare function resolveConnectorBrowserWorkspacePartition(provider: string, accountId: string): string;
+export declare function isConnectorBrowserWorkspacePartition(partition: string | null | undefined): boolean;
+export declare function resolveBrowserWorkspaceCommandPartition(command: Pick<BrowserWorkspaceCommand, "connectorAccountId" | "connectorProvider" | "partition">, fallbackPartition: string): string;
+export declare function assertBrowserWorkspaceConnectorSecretsNotExported(partition: string | null | undefined, operation: string): void;
+export declare function createBrowserWorkspaceDesktopOnlyMessage(subaction: BrowserWorkspaceSubaction): string;
+export declare function createBrowserWorkspaceNotFoundError(tabId: string): Error;
+export declare function createBrowserWorkspaceCommandTargetError(subaction: BrowserWorkspaceSubaction): Error;
+export declare function sleep(ms: number): Promise<void>;
+export declare function writeBrowserWorkspaceFile(filePath: string, contents: string | Uint8Array): Promise<string>;
+export declare function normalizeBrowserWorkspaceCommand(command: BrowserWorkspaceCommand): BrowserWorkspaceCommand;
+export declare function resolveBrowserWorkspaceCommandElementRefs(command: BrowserWorkspaceCommand, mode: BrowserWorkspaceMode, tabId: string): BrowserWorkspaceCommand;
+export declare function buildBrowserWorkspaceCssStringLiteral(value: string): string;
+/** GHSA-mhhr-9ph9-64j7 / elizaOS/eliza#6767 — arbitrary script must not run in Node (JSDOM). */
+export declare const BROWSER_WORKSPACE_JSDOM_SCRIPT_FORBIDDEN = "Browser workspace arbitrary script execution is disabled in the JSDOM (web) backend because it runs in the Node.js agent process via unsafe eval patterns (GHSA-mhhr-9ph9-64j7). Use structured subactions (click, fill, get, wait on selector/url/text) or desktop browser workspace mode instead.";
+export declare const BROWSER_WORKSPACE_USER_SCRIPT_FORBIDDEN = "Browser workspace arbitrary user script is disabled (GHSA-mhhr-9ph9-64j7). Use structured browser workspace subactions instead.";
+export declare function isBrowserWorkspaceUserScriptAllowed(env?: NodeJS.ProcessEnv): boolean;
+export declare function assertBrowserWorkspaceUserScriptAllowed(script: string | undefined, context: "eval" | "wait", mode: BrowserWorkspaceMode, env?: NodeJS.ProcessEnv): void;
+export declare function createBrowserWorkspaceJsdomScriptExecutionError(context: "eval" | "wait"): Error;
+export declare function assertBrowserWorkspaceJsdomScriptNotRequested(script: string | undefined, context: "eval" | "wait"): void;
+//# sourceMappingURL=browser-workspace-helpers.d.ts.map

package/dist/workspace/browser-workspace-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-workspace-helpers.d.ts","sourceRoot":"","sources":["../../src/workspace/browser-workspace-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,8BAA8B,CAAC;AAEtC,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,4CAA4C,uBACnC,CAAC;AACvB,eAAO,MAAM,kCAAkC,2DACW,CAAC;AAC3D,eAAO,MAAM,yBAAyB,KAAoC,CAAC;AAE3E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAM1E;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIpE;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,SAAS,CASpB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAoBhE;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAU9D;AAgCD,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAWR;AAED,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,OAAO,CAKT;AAED,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,IAAI,CACX,uBAAuB,EACvB,oBAAoB,GAAG,mBAAmB,GAAG,WAAW,CACzD,EACD,iBAAiB,EAAE,MAAM,GACxB,MAAM,CAWR;AAED,wBAAgB,iDAAiD,CAC/D,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,SAAS,EAAE,MAAM,GAChB,IAAI,CAON;AAED,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,yBAAyB,GACnC,MAAM,CAER;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAIxE;AAED,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,yBAAyB,GACnC,KAAK,CAIP;AAED,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErD;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,UAAU,GAC5B,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,uBAAuB,GAC/B,uBAAuB,CA2BzB;AAED,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,MAAM,GACZ,uBAAuB,CA0BzB;AAED,wBAAgB,qCAAqC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,gGAAgG;AAChG,eAAO,MAAM,wCAAwC,wSACkP,CAAC;AAExS,eAAO,MAAM,uCAAuC,oIAC+E,CAAC;AAEpI,wBAAgB,mCAAmC,CACjD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAKT;AAED,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,IAAI,EAAE,oBAAoB,EAC1B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,IAAI,CAgBN;AAED,wBAAgB,+CAA+C,CAC7D,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,KAAK,CAMP;AAED,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,GACvB,IAAI,CAIN"}

package/dist/workspace/browser-workspace-helpers.js

@@ -0,0 +1,232 @@
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { resolveBrowserWorkspaceElementRef } from "./browser-workspace-state.js";
+const DEFAULT_TIMEOUT_MS = 12e3;
+const DEFAULT_WAIT_INTERVAL_MS = 120;
+const DEFAULT_WEB_PARTITION = "persist:eliza-browser";
+const CONNECTOR_BROWSER_WORKSPACE_PARTITION_PREFIX = "persist:connector-";
+const DESKTOP_BRIDGE_UNAVAILABLE_MESSAGE = "Eliza browser workspace desktop bridge is unavailable.";
+const browserWorkspacePageFetch = globalThis.fetch.bind(globalThis);
+function normalizeEnvValue(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function normalizeBrowserWorkspaceText(value) {
+  return String(value ?? "").replace(/\s+/g, " ").trim();
+}
+function parseBrowserWorkspaceNumberLike(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const parsed = Number.parseFloat(value.trim());
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function assertBrowserWorkspaceUrl(rawUrl) {
+  const trimmed = rawUrl.trim();
+  if (trimmed === "about:blank") {
+    return trimmed;
+  }
+  let parsed;
+  try {
+    parsed = new URL(trimmed);
+  } catch {
+    throw new Error(`browser workspace rejected invalid URL: ${rawUrl}`);
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new Error(
+      `browser workspace only supports http/https URLs, got ${parsed.protocol}`
+    );
+  }
+  return parsed.toString();
+}
+function inferBrowserWorkspaceTitle(url) {
+  if (url === "about:blank") {
+    return "New Tab";
+  }
+  try {
+    return new URL(url).hostname.replace(/^www\./, "") || "Eliza Browser";
+  } catch {
+    return "Eliza Browser";
+  }
+}
+function normalizeConnectorBrowserWorkspaceSegment(value, fieldName) {
+  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-").slice(0, 64);
+  if (!normalized) {
+    throw new Error(`Eliza browser connector session requires ${fieldName}.`);
+  }
+  return normalized;
+}
+function hashConnectorBrowserWorkspacePartitionKey(provider, accountId) {
+  const input = `${provider.trim().toLowerCase()}\0${accountId.trim().toLowerCase()}`;
+  let hash = 2166136261;
+  for (let i = 0; i < input.length; i++) {
+    hash ^= input.charCodeAt(i);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return hash.toString(36).padStart(7, "0");
+}
+function resolveConnectorBrowserWorkspacePartition(provider, accountId) {
+  const providerSegment = normalizeConnectorBrowserWorkspaceSegment(
+    provider,
+    "provider"
+  );
+  const accountSegment = normalizeConnectorBrowserWorkspaceSegment(
+    accountId,
+    "accountId"
+  );
+  const suffix = hashConnectorBrowserWorkspacePartitionKey(provider, accountId);
+  return `${CONNECTOR_BROWSER_WORKSPACE_PARTITION_PREFIX}${providerSegment}-${accountSegment}-${suffix}`;
+}
+function isConnectorBrowserWorkspacePartition(partition) {
+  return (partition ?? "").trim().toLowerCase().startsWith(CONNECTOR_BROWSER_WORKSPACE_PARTITION_PREFIX);
+}
+function resolveBrowserWorkspaceCommandPartition(command, fallbackPartition) {
+  const explicitPartition = command.partition?.trim();
+  if (explicitPartition) {
+    return explicitPartition;
+  }
+  const provider = command.connectorProvider?.trim();
+  const accountId = command.connectorAccountId?.trim();
+  if (provider && accountId) {
+    return resolveConnectorBrowserWorkspacePartition(provider, accountId);
+  }
+  return fallbackPartition;
+}
+function assertBrowserWorkspaceConnectorSecretsNotExported(partition, operation) {
+  if (!isConnectorBrowserWorkspacePartition(partition)) {
+    return;
+  }
+  throw new Error(
+    `Connector browser sessions do not allow raw cookie, token, storage, or state export (${operation}). Use the returned partition/profile/session handle instead.`
+  );
+}
+function createBrowserWorkspaceDesktopOnlyMessage(subaction) {
+  return `Eliza browser workspace ${subaction} is only available in the desktop app.`;
+}
+function createBrowserWorkspaceNotFoundError(tabId) {
+  return new Error(
+    `Browser workspace request failed (404): Tab ${tabId} was not found.`
+  );
+}
+function createBrowserWorkspaceCommandTargetError(subaction) {
+  return new Error(
+    `Eliza browser workspace ${subaction} requires a current tab. Open or show a tab first, or pass an explicit id.`
+  );
+}
+async function sleep(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function writeBrowserWorkspaceFile(filePath, contents) {
+  const resolved = path.resolve(filePath);
+  await fsp.mkdir(path.dirname(resolved), { recursive: true });
+  await fsp.writeFile(resolved, contents);
+  return resolved;
+}
+function normalizeBrowserWorkspaceCommand(command) {
+  const raw = command;
+  const normalizedSubaction = typeof raw.subaction === "string" ? raw.subaction.trim().toLowerCase() : typeof raw.operation === "string" ? raw.operation.trim().toLowerCase() : "";
+  const subaction = normalizedSubaction === "goto" ? "navigate" : normalizedSubaction === "read" ? "get" : command.subaction;
+  const timeoutMs = parseBrowserWorkspaceNumberLike(command.timeoutMs) ?? parseBrowserWorkspaceNumberLike(raw.ms) ?? parseBrowserWorkspaceNumberLike(raw.milliseconds);
+  return {
+    ...command,
+    subaction,
+    timeoutMs,
+    steps: Array.isArray(command.steps) ? command.steps.map((step) => normalizeBrowserWorkspaceCommand(step)) : command.steps
+  };
+}
+function resolveBrowserWorkspaceCommandElementRefs(command, mode, tabId) {
+  const selector = command.selector?.trim();
+  if (!selector) {
+    return command;
+  }
+  const match = selector.match(/^(@e\d+)([\s\S]*)$/i);
+  if (!match?.[1]) {
+    return command;
+  }
+  const resolvedSelector = resolveBrowserWorkspaceElementRef(
+    mode,
+    tabId,
+    match[1]
+  );
+  if (!resolvedSelector) {
+    throw new Error(
+      `Unknown browser snapshot element ref ${match[1]}. Run snapshot or inspect again before reusing element refs.`
+    );
+  }
+  return {
+    ...command,
+    selector: `${resolvedSelector}${match[2] ?? ""}`
+  };
+}
+function buildBrowserWorkspaceCssStringLiteral(value) {
+  return JSON.stringify(value);
+}
+const BROWSER_WORKSPACE_JSDOM_SCRIPT_FORBIDDEN = "Browser workspace arbitrary script execution is disabled in the JSDOM (web) backend because it runs in the Node.js agent process via unsafe eval patterns (GHSA-mhhr-9ph9-64j7). Use structured subactions (click, fill, get, wait on selector/url/text) or desktop browser workspace mode instead.";
+const BROWSER_WORKSPACE_USER_SCRIPT_FORBIDDEN = "Browser workspace arbitrary user script is disabled (GHSA-mhhr-9ph9-64j7). Use structured browser workspace subactions instead.";
+function isBrowserWorkspaceUserScriptAllowed(env = process.env) {
+  const flag = normalizeEnvValue(
+    env.ELIZA_BROWSER_WORKSPACE_ALLOW_USER_SCRIPT
+  )?.toLowerCase();
+  return flag === "1" || flag === "true" || flag === "yes";
+}
+function assertBrowserWorkspaceUserScriptAllowed(script, context, mode, env = process.env) {
+  if (!script?.trim()) {
+    return;
+  }
+  if (mode === "web") {
+    throw createBrowserWorkspaceJsdomScriptExecutionError(context);
+  }
+  if (!isBrowserWorkspaceUserScriptAllowed(env)) {
+    const suffix = context === "eval" ? "Eval subactions with a user `script` are disabled by default." : "Wait conditions with a user `script` are disabled by default.";
+    throw new Error(
+      `${BROWSER_WORKSPACE_USER_SCRIPT_FORBIDDEN} ${suffix} Set ELIZA_BROWSER_WORKSPACE_ALLOW_USER_SCRIPT=1 only on trusted single-user hosts.`
+    );
+  }
+}
+function createBrowserWorkspaceJsdomScriptExecutionError(context) {
+  const suffix = context === "eval" ? "Eval subactions are not supported on the web backend." : "Wait conditions with `script` are not supported on the web backend.";
+  return new Error(`${BROWSER_WORKSPACE_JSDOM_SCRIPT_FORBIDDEN} ${suffix}`);
+}
+function assertBrowserWorkspaceJsdomScriptNotRequested(script, context) {
+  if (script?.trim()) {
+    throw createBrowserWorkspaceJsdomScriptExecutionError(context);
+  }
+}
+export {
+  BROWSER_WORKSPACE_JSDOM_SCRIPT_FORBIDDEN,
+  BROWSER_WORKSPACE_USER_SCRIPT_FORBIDDEN,
+  CONNECTOR_BROWSER_WORKSPACE_PARTITION_PREFIX,
+  DEFAULT_TIMEOUT_MS,
+  DEFAULT_WAIT_INTERVAL_MS,
+  DEFAULT_WEB_PARTITION,
+  DESKTOP_BRIDGE_UNAVAILABLE_MESSAGE,
+  assertBrowserWorkspaceConnectorSecretsNotExported,
+  assertBrowserWorkspaceJsdomScriptNotRequested,
+  assertBrowserWorkspaceUrl,
+  assertBrowserWorkspaceUserScriptAllowed,
+  browserWorkspacePageFetch,
+  buildBrowserWorkspaceCssStringLiteral,
+  createBrowserWorkspaceCommandTargetError,
+  createBrowserWorkspaceDesktopOnlyMessage,
+  createBrowserWorkspaceJsdomScriptExecutionError,
+  createBrowserWorkspaceNotFoundError,
+  inferBrowserWorkspaceTitle,
+  isBrowserWorkspaceUserScriptAllowed,
+  isConnectorBrowserWorkspacePartition,
+  normalizeBrowserWorkspaceCommand,
+  normalizeBrowserWorkspaceText,
+  normalizeEnvValue,
+  parseBrowserWorkspaceNumberLike,
+  resolveBrowserWorkspaceCommandElementRefs,
+  resolveBrowserWorkspaceCommandPartition,
+  resolveConnectorBrowserWorkspacePartition,
+  sleep,
+  writeBrowserWorkspaceFile
+};
+//# sourceMappingURL=browser-workspace-helpers.js.map

package/dist/workspace/browser-workspace-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/workspace/browser-workspace-helpers.ts"],"sourcesContent":["import * as fsp from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { resolveBrowserWorkspaceElementRef } from \"./browser-workspace-state.js\";\nimport type {\n  BrowserWorkspaceCommand,\n  BrowserWorkspaceMode,\n  BrowserWorkspaceSubaction,\n} from \"./browser-workspace-types.js\";\n\nexport const DEFAULT_TIMEOUT_MS = 12_000;\nexport const DEFAULT_WAIT_INTERVAL_MS = 120;\nexport const DEFAULT_WEB_PARTITION = \"persist:eliza-browser\";\nexport const CONNECTOR_BROWSER_WORKSPACE_PARTITION_PREFIX =\n  \"persist:connector-\";\nexport const DESKTOP_BRIDGE_UNAVAILABLE_MESSAGE =\n  \"Eliza browser workspace desktop bridge is unavailable.\";\nexport const browserWorkspacePageFetch = globalThis.fetch.bind(globalThis);\n\nexport function normalizeEnvValue(value: string | undefined): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nexport function normalizeBrowserWorkspaceText(value: unknown): string {\n  return String(value ?? \"\")\n    .replace(/\\s+/g, \" \")\n    .trim();\n}\n\nexport function parseBrowserWorkspaceNumberLike(\n  value: unknown,\n): number | undefined {\n  if (typeof value === \"number\" && Number.isFinite(value)) {\n    return value;\n  }\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  const parsed = Number.parseFloat(value.trim());\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nexport function assertBrowserWorkspaceUrl(rawUrl: string): string {\n  const trimmed = rawUrl.trim();\n  if (trimmed === \"about:blank\") {\n    return trimmed;\n  }\n\n  let parsed: URL;\n  try {\n    parsed = new URL(trimmed);\n  } catch {\n    throw new Error(`browser workspace rejected invalid URL: ${rawUrl}`);\n  }\n\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new Error(\n      `browser workspace only supports http/https URLs, got ${parsed.protocol}`,\n    );\n  }\n\n  return parsed.toString();\n}\n\nexport function inferBrowserWorkspaceTitle(url: string): string {\n  if (url === \"about:blank\") {\n    return \"New Tab\";\n  }\n\n  try {\n    return new URL(url).hostname.replace(/^www\\./, \"\") || \"Eliza Browser\";\n  } catch {\n    return \"Eliza Browser\";\n  }\n}\n\nfunction normalizeConnectorBrowserWorkspaceSegment(\n  value: string,\n  fieldName: string,\n): string {\n  const normalized = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .replace(/-{2,}/g, \"-\")\n    .slice(0, 64);\n  if (!normalized) {\n    throw new Error(`Eliza browser connector session requires ${fieldName}.`);\n  }\n  return normalized;\n}\n\nfunction hashConnectorBrowserWorkspacePartitionKey(\n  provider: string,\n  accountId: string,\n): string {\n  const input = `${provider.trim().toLowerCase()}\\0${accountId.trim().toLowerCase()}`;\n  let hash = 0x811c9dc5;\n  for (let i = 0; i < input.length; i++) {\n    hash ^= input.charCodeAt(i);\n    hash = Math.imul(hash, 0x01000193) >>> 0;\n  }\n  return hash.toString(36).padStart(7, \"0\");\n}\n\nexport function resolveConnectorBrowserWorkspacePartition(\n  provider: string,\n  accountId: string,\n): string {\n  const providerSegment = normalizeConnectorBrowserWorkspaceSegment(\n    provider,\n    \"provider\",\n  );\n  const accountSegment = normalizeConnectorBrowserWorkspaceSegment(\n    accountId,\n    \"accountId\",\n  );\n  const suffix = hashConnectorBrowserWorkspacePartitionKey(provider, accountId);\n  return `${CONNECTOR_BROWSER_WORKSPACE_PARTITION_PREFIX}${providerSegment}-${accountSegment}-${suffix}`;\n}\n\nexport function isConnectorBrowserWorkspacePartition(\n  partition: string | null | undefined,\n): boolean {\n  return (partition ?? \"\")\n    .trim()\n    .toLowerCase()\n    .startsWith(CONNECTOR_BROWSER_WORKSPACE_PARTITION_PREFIX);\n}\n\nexport function resolveBrowserWorkspaceCommandPartition(\n  command: Pick<\n    BrowserWorkspaceCommand,\n    \"connectorAccountId\" | \"connectorProvider\" | \"partition\"\n  >,\n  fallbackPartition: string,\n): string {\n  const explicitPartition = command.partition?.trim();\n  if (explicitPartition) {\n    return explicitPartition;\n  }\n  const provider = command.connectorProvider?.trim();\n  const accountId = command.connectorAccountId?.trim();\n  if (provider && accountId) {\n    return resolveConnectorBrowserWorkspacePartition(provider, accountId);\n  }\n  return fallbackPartition;\n}\n\nexport function assertBrowserWorkspaceConnectorSecretsNotExported(\n  partition: string | null | undefined,\n  operation: string,\n): void {\n  if (!isConnectorBrowserWorkspacePartition(partition)) {\n    return;\n  }\n  throw new Error(\n    `Connector browser sessions do not allow raw cookie, token, storage, or state export (${operation}). Use the returned partition/profile/session handle instead.`,\n  );\n}\n\nexport function createBrowserWorkspaceDesktopOnlyMessage(\n  subaction: BrowserWorkspaceSubaction,\n): string {\n  return `Eliza browser workspace ${subaction} is only available in the desktop app.`;\n}\n\nexport function createBrowserWorkspaceNotFoundError(tabId: string): Error {\n  return new Error(\n    `Browser workspace request failed (404): Tab ${tabId} was not found.`,\n  );\n}\n\nexport function createBrowserWorkspaceCommandTargetError(\n  subaction: BrowserWorkspaceSubaction,\n): Error {\n  return new Error(\n    `Eliza browser workspace ${subaction} requires a current tab. Open or show a tab first, or pass an explicit id.`,\n  );\n}\n\nexport async function sleep(ms: number): Promise<void> {\n  await new Promise<void>((resolve) => setTimeout(resolve, ms));\n}\n\nexport async function writeBrowserWorkspaceFile(\n  filePath: string,\n  contents: string | Uint8Array,\n): Promise<string> {\n  const resolved = path.resolve(filePath);\n  await fsp.mkdir(path.dirname(resolved), { recursive: true });\n  await fsp.writeFile(resolved, contents);\n  return resolved;\n}\n\nexport function normalizeBrowserWorkspaceCommand(\n  command: BrowserWorkspaceCommand,\n): BrowserWorkspaceCommand {\n  const raw = command as BrowserWorkspaceCommand & Record<string, unknown>;\n  const normalizedSubaction =\n    typeof raw.subaction === \"string\"\n      ? raw.subaction.trim().toLowerCase()\n      : typeof raw.operation === \"string\"\n        ? raw.operation.trim().toLowerCase()\n        : \"\";\n  const subaction =\n    normalizedSubaction === \"goto\"\n      ? \"navigate\"\n      : normalizedSubaction === \"read\"\n        ? \"get\"\n        : command.subaction;\n  const timeoutMs =\n    parseBrowserWorkspaceNumberLike(command.timeoutMs) ??\n    parseBrowserWorkspaceNumberLike(raw.ms) ??\n    parseBrowserWorkspaceNumberLike(raw.milliseconds);\n\n  return {\n    ...command,\n    subaction,\n    timeoutMs,\n    steps: Array.isArray(command.steps)\n      ? command.steps.map((step) => normalizeBrowserWorkspaceCommand(step))\n      : command.steps,\n  };\n}\n\nexport function resolveBrowserWorkspaceCommandElementRefs(\n  command: BrowserWorkspaceCommand,\n  mode: BrowserWorkspaceMode,\n  tabId: string,\n): BrowserWorkspaceCommand {\n  const selector = command.selector?.trim();\n  if (!selector) {\n    return command;\n  }\n\n  const match = selector.match(/^(@e\\d+)([\\s\\S]*)$/i);\n  if (!match?.[1]) {\n    return command;\n  }\n\n  const resolvedSelector = resolveBrowserWorkspaceElementRef(\n    mode,\n    tabId,\n    match[1],\n  );\n  if (!resolvedSelector) {\n    throw new Error(\n      `Unknown browser snapshot element ref ${match[1]}. Run snapshot or inspect again before reusing element refs.`,\n    );\n  }\n\n  return {\n    ...command,\n    selector: `${resolvedSelector}${match[2] ?? \"\"}`,\n  };\n}\n\nexport function buildBrowserWorkspaceCssStringLiteral(value: string): string {\n  return JSON.stringify(value);\n}\n\n/** GHSA-mhhr-9ph9-64j7 / elizaOS/eliza#6767 — arbitrary script must not run in Node (JSDOM). */\nexport const BROWSER_WORKSPACE_JSDOM_SCRIPT_FORBIDDEN =\n  \"Browser workspace arbitrary script execution is disabled in the JSDOM (web) backend because it runs in the Node.js agent process via unsafe eval patterns (GHSA-mhhr-9ph9-64j7). Use structured subactions (click, fill, get, wait on selector/url/text) or desktop browser workspace mode instead.\";\n\nexport const BROWSER_WORKSPACE_USER_SCRIPT_FORBIDDEN =\n  \"Browser workspace arbitrary user script is disabled (GHSA-mhhr-9ph9-64j7). Use structured browser workspace subactions instead.\";\n\nexport function isBrowserWorkspaceUserScriptAllowed(\n  env: NodeJS.ProcessEnv = process.env,\n): boolean {\n  const flag = normalizeEnvValue(\n    env.ELIZA_BROWSER_WORKSPACE_ALLOW_USER_SCRIPT,\n  )?.toLowerCase();\n  return flag === \"1\" || flag === \"true\" || flag === \"yes\";\n}\n\nexport function assertBrowserWorkspaceUserScriptAllowed(\n  script: string | undefined,\n  context: \"eval\" | \"wait\",\n  mode: BrowserWorkspaceMode,\n  env: NodeJS.ProcessEnv = process.env,\n): void {\n  if (!script?.trim()) {\n    return;\n  }\n  if (mode === \"web\") {\n    throw createBrowserWorkspaceJsdomScriptExecutionError(context);\n  }\n  if (!isBrowserWorkspaceUserScriptAllowed(env)) {\n    const suffix =\n      context === \"eval\"\n        ? \"Eval subactions with a user `script` are disabled by default.\"\n        : \"Wait conditions with a user `script` are disabled by default.\";\n    throw new Error(\n      `${BROWSER_WORKSPACE_USER_SCRIPT_FORBIDDEN} ${suffix} Set ELIZA_BROWSER_WORKSPACE_ALLOW_USER_SCRIPT=1 only on trusted single-user hosts.`,\n    );\n  }\n}\n\nexport function createBrowserWorkspaceJsdomScriptExecutionError(\n  context: \"eval\" | \"wait\",\n): Error {\n  const suffix =\n    context === \"eval\"\n      ? \"Eval subactions are not supported on the web backend.\"\n      : \"Wait conditions with `script` are not supported on the web backend.\";\n  return new Error(`${BROWSER_WORKSPACE_JSDOM_SCRIPT_FORBIDDEN} ${suffix}`);\n}\n\nexport function assertBrowserWorkspaceJsdomScriptNotRequested(\n  script: string | undefined,\n  context: \"eval\" | \"wait\",\n): void {\n  if (script?.trim()) {\n    throw createBrowserWorkspaceJsdomScriptExecutionError(context);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/workspace/browser-workspace-jsdom.d.ts

@@ -0,0 +1,16 @@
+import type { JSDOM } from "jsdom";
+import type { BrowserWorkspaceRuntimeState, WebBrowserWorkspaceTabState } from "./browser-workspace-types.js";
+/**
+ * Locate jsdom's package.json on disk, then resolve its declared entry file from there.
+ * Vitest workers run on Node; Node cannot resolve `jsdom` from workspace roots when
+ * Bun hoists deps under node_modules/.bun, but requiring jsdom from its own package
+ * directory still works.
+ */
+export declare function findJsdomPackageJsonPath(): string;
+/** Lazy-load jsdom so importing this module does not require jsdom at parse time (Vitest / server tests). */
+export declare function getJSDOMClass(): typeof import("jsdom").JSDOM;
+export declare function createEmptyWebBrowserWorkspaceDom(url: string): JSDOM;
+export declare function applyBrowserWorkspaceDomSettings(dom: JSDOM, state: BrowserWorkspaceRuntimeState): void;
+export declare function installBrowserWorkspaceWebRuntime(tab: WebBrowserWorkspaceTabState, dom: JSDOM): void;
+export declare function ensureBrowserWorkspaceDom(tab: WebBrowserWorkspaceTabState): JSDOM;
+//# sourceMappingURL=browser-workspace-jsdom.d.ts.map

package/dist/workspace/browser-workspace-jsdom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-workspace-jsdom.d.ts","sourceRoot":"","sources":["../../src/workspace/browser-workspace-jsdom.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AASnC,OAAO,KAAK,EACV,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,8BAA8B,CAAC;AAItC;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CA2CjD;AAED,6GAA6G;AAC7G,wBAAgB,aAAa,IAAI,cAAc,OAAO,EAAE,KAAK,CAc5D;AAED,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAQpE;AAED,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,KAAK,EACV,KAAK,EAAE,4BAA4B,GAClC,IAAI,CA8EN;AAED,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,2BAA2B,EAChC,GAAG,EAAE,KAAK,GACT,IAAI,CAqFN;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,2BAA2B,GAC/B,KAAK,CAQP"}