@elizaos/plugin-browser 2.0.3-beta.2 → 2.0.3-beta.4

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/workspace/browser-capture.ts"],"sourcesContent":["/**\n * Headless browser capture — opens the StreamView in headless Chrome and\n * saves screenshots to a temp file. FFmpeg reads the temp file using\n * -loop 1 to continuously re-read the latest frame.\n *\n * This approach avoids the pipe bottleneck — FFmpeg reads at its own\n * pace while the browser updates the file independently.\n *\n * Visual parity with the desktop shell:\n * - Appends `?popout` to the URL so the app renders StreamView directly\n *   (without onboarding, auth gates, or navigation chrome).\n * - Enables SwiftShader for WebGL so VRM avatar renders identically.\n * - Seeds localStorage with overlay layout, theme, and avatar index so\n *   the first rendered frame matches the configured appearance.\n * - Uses `waitUntil: \"networkidle0\"` to ensure all assets load before capture.\n * - Keeps CSS animations/transitions enabled for visual parity.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { setTimeout as sleep } from \"node:timers/promises\";\nimport { logger } from \"@elizaos/core\";\nimport type { Browser } from \"puppeteer-core\";\n\nconst CHROME_PATH =\n  process.platform === \"darwin\"\n    ? \"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\"\n    : process.platform === \"win32\"\n      ? \"C:\\\\Program Files\\\\Google Chrome\\\\Application\\\\chrome.exe\"\n      : \"/usr/bin/google-chrome-stable\";\n\nlet activeBrowser: Browser | null = null;\nlet activeCaptureLoop: Promise<void> | null = null;\nlet stopSignal = false;\n\n/** Path to the temp frame file that FFmpeg reads */\nexport const FRAME_FILE = join(tmpdir(), \"eliza-stream-frame.jpg\");\n\nexport interface BrowserCaptureConfig {\n  url: string;\n  width?: number;\n  height?: number;\n  fps?: number;\n  quality?: number;\n  /** Optional overlay layout JSON to seed into localStorage before page load. */\n  overlayLayout?: string;\n  /** Theme name to apply (e.g. \"eliza\", \"haxor\", \"psycho\"). */\n  theme?: string;\n  /** Avatar VRM index (1–8). */\n  avatarIndex?: number;\n  /** Destination ID — seeds the destination-specific localStorage key. */\n  destinationId?: string;\n}\n\nexport function getBrowserCaptureExecutablePath(): string {\n  return CHROME_PATH;\n}\n\nexport function isBrowserCaptureSupported(): boolean {\n  return existsSync(CHROME_PATH);\n}\n\n/**\n * Ensure the URL includes the `?popout` parameter so the app renders only\n * StreamView without startup gates or navigation chrome.\n */\nfunction ensurePopoutUrl(raw: string): string {\n  try {\n    const u = new URL(raw);\n    // Handle both query and hash-based routing\n    if (u.hash?.includes(\"?\")) {\n      if (!u.hash.includes(\"popout\")) {\n        u.hash = `${u.hash}&popout`;\n      }\n    } else if (u.hash) {\n      u.hash = `${u.hash}?popout`;\n    } else if (!u.searchParams.has(\"popout\")) {\n      u.searchParams.set(\"popout\", \"\");\n    }\n    return u.toString();\n  } catch {\n    // Fallback: just append\n    const sep = raw.includes(\"?\") ? \"&\" : \"?\";\n    return `${raw}${sep}popout`;\n  }\n}\n\nexport async function startBrowserCapture(config: BrowserCaptureConfig) {\n  if (activeBrowser) {\n    logger.info(\"[browser-capture] Already running\");\n    return;\n  }\n\n  if (!isBrowserCaptureSupported()) {\n    throw new Error(\n      `Google Chrome not found at ${CHROME_PATH}. Install Chrome or update browser-capture before enabling screen capture.`,\n    );\n  }\n\n  const { url, width = 1280, height = 720, fps = 4, quality = 70 } = config;\n  const captureUrl = ensurePopoutUrl(url);\n\n  stopSignal = false;\n  logger.info(`[browser-capture] Launching headless Chrome to ${captureUrl}`);\n\n  const { default: puppeteer } = await import(\"puppeteer-core\");\n  const browser = await puppeteer.launch({\n    executablePath: CHROME_PATH,\n    headless: true,\n    args: [\n      `--window-size=${width},${height}`,\n      \"--no-sandbox\",\n      \"--disable-dev-shm-usage\",\n      \"--disable-extensions\",\n      \"--mute-audio\",\n      // WebGL / SwiftShader — required for VRM avatar rendering parity\n      \"--use-gl=swiftshader\",\n      \"--enable-webgl\",\n      \"--ignore-gpu-blocklist\",\n    ],\n  });\n\n  activeBrowser = browser;\n\n  const page = await browser.newPage();\n  await page.setViewport({ width, height, deviceScaleFactor: 1 });\n\n  // Seed localStorage before navigation so the first render matches the desktop shell.\n  // Keys must match exactly what the React app reads:\n  //   - \"eliza:theme\"                        → ThemeName\n  //   - \"eliza_avatar_index\"                 → VRM index (1–8)\n  //   - \"eliza.stream.overlay-layout.v1[.destId]\" → OverlayLayout JSON\n  await page.evaluateOnNewDocument(\n    (\n      overlayLayout: string | undefined,\n      theme: string | undefined,\n      avatarIndex: number | undefined,\n      destinationId: string | undefined,\n    ) => {\n      if (overlayLayout) {\n        // Seed both global and destination-specific keys so the hook\n        // resolves correctly regardless of when activeDestination loads.\n        localStorage.setItem(\"eliza.stream.overlay-layout.v1\", overlayLayout);\n        if (destinationId) {\n          localStorage.setItem(\n            `eliza.stream.overlay-layout.v1.${destinationId}`,\n            overlayLayout,\n          );\n        }\n      }\n      if (theme) {\n        localStorage.setItem(\"eliza:theme\", theme);\n      }\n      if (avatarIndex != null) {\n        localStorage.setItem(\"eliza_avatar_index\", String(avatarIndex));\n      }\n    },\n    config.overlayLayout,\n    config.theme,\n    config.avatarIndex,\n    config.destinationId,\n  );\n\n  // Use networkidle0 so fonts, VRM models, and preview images finish loading\n  await page.goto(captureUrl, {\n    waitUntil: \"networkidle0\",\n    timeout: 60_000,\n  });\n\n  logger.info(`[browser-capture] Page loaded, writing frames to ${FRAME_FILE}`);\n\n  let frameCount = 0;\n  const frameIntervalMs = Math.max(100, Math.round(1000 / Math.max(1, fps)));\n  activeCaptureLoop = (async () => {\n    while (!stopSignal) {\n      try {\n        await page.screenshot({\n          path: FRAME_FILE,\n          quality,\n          type: \"jpeg\",\n        });\n        frameCount += 1;\n        if (frameCount % 20 === 0) {\n          logger.debug(`[browser-capture] ${frameCount} frames written`);\n        }\n      } catch (error) {\n        if (!stopSignal) {\n          logger.warn(\n            `[browser-capture] frame capture failed: ${\n              error instanceof Error ? error.message : String(error)\n            }`,\n          );\n        }\n      }\n      if (!stopSignal) {\n        await sleep(frameIntervalMs);\n      }\n    }\n  })();\n\n  logger.info(\n    `[browser-capture] Screenshot loop active (${fps} fps), saving to ${FRAME_FILE}`,\n  );\n}\n\nexport async function stopBrowserCapture() {\n  stopSignal = true;\n  if (activeCaptureLoop) {\n    try {\n      await activeCaptureLoop;\n    } catch {}\n    activeCaptureLoop = null;\n  }\n  if (activeBrowser) {\n    try {\n      await activeBrowser.close();\n    } catch {}\n    activeBrowser = null;\n  }\n  logger.info(\"[browser-capture] Stopped\");\n}\n\nexport function isBrowserCaptureRunning(): boolean {\n  return activeBrowser !== null;\n}\n\nexport function hasFrameFile(): boolean {\n  return existsSync(FRAME_FILE);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/workspace/browser-capture.ts"],"sourcesContent":["/**\n * Headless browser capture — opens the StreamView in headless Chrome and\n * saves screenshots to a temp file. FFmpeg reads the temp file using\n * -loop 1 to continuously re-read the latest frame.\n *\n * This approach avoids the pipe bottleneck — FFmpeg reads at its own\n * pace while the browser updates the file independently.\n *\n * Visual parity with the desktop shell:\n * - Appends `?popout` to the URL so the app renders StreamView directly\n *   (without onboarding, auth gates, or navigation chrome).\n * - Enables SwiftShader for WebGL so VRM avatar renders identically.\n * - Seeds localStorage with overlay layout, theme, and avatar index so\n *   the first rendered frame matches the configured appearance.\n * - Uses `waitUntil: \"networkidle0\"` to ensure all assets load before capture.\n * - Keeps CSS animations/transitions enabled for visual parity.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { setTimeout as sleep } from \"node:timers/promises\";\nimport { logger } from \"@elizaos/core\";\nimport type { Browser } from \"puppeteer-core\";\n\nfunction resolveChromePath(): string {\n  if (process.platform === \"darwin\") {\n    return \"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\";\n  }\n  if (process.platform === \"win32\") {\n    // Chrome installs under Google/Chrome/Application (a subdirectory), not a\n    // \"Google Chrome\" folder, and may be 64-bit, 32-bit, or per-user. Probe the\n    // standard locations and pick the first that exists. (join normalizes the\n    // forward-slash fallbacks to the Windows separator.)\n    const candidates = [\n      join(\n        process.env.PROGRAMFILES ?? \"C:/Program Files\",\n        \"Google\",\n        \"Chrome\",\n        \"Application\",\n        \"chrome.exe\",\n      ),\n      join(\n        process.env[\"PROGRAMFILES(X86)\"] ?? \"C:/Program Files (x86)\",\n        \"Google\",\n        \"Chrome\",\n        \"Application\",\n        \"chrome.exe\",\n      ),\n      join(\n        process.env.LOCALAPPDATA ?? \"\",\n        \"Google\",\n        \"Chrome\",\n        \"Application\",\n        \"chrome.exe\",\n      ),\n    ];\n    return candidates.find((p) => existsSync(p)) ?? candidates[0];\n  }\n  return \"/usr/bin/google-chrome-stable\";\n}\n\nconst CHROME_PATH = resolveChromePath();\n\nlet activeBrowser: Browser | null = null;\nlet activeCaptureLoop: Promise<void> | null = null;\nlet stopSignal = false;\n\n/** Path to the temp frame file that FFmpeg reads */\nexport const FRAME_FILE = join(tmpdir(), \"eliza-stream-frame.jpg\");\n\nexport interface BrowserCaptureConfig {\n  url: string;\n  width?: number;\n  height?: number;\n  fps?: number;\n  quality?: number;\n  /** Optional overlay layout JSON to seed into localStorage before page load. */\n  overlayLayout?: string;\n  /** Theme name to apply (e.g. \"eliza\", \"haxor\", \"psycho\"). */\n  theme?: string;\n  /** Avatar VRM index (1–8). */\n  avatarIndex?: number;\n  /** Destination ID — seeds the destination-specific localStorage key. */\n  destinationId?: string;\n}\n\nexport function getBrowserCaptureExecutablePath(): string {\n  return CHROME_PATH;\n}\n\nexport function isBrowserCaptureSupported(): boolean {\n  return existsSync(CHROME_PATH);\n}\n\n/**\n * Ensure the URL includes the `?popout` parameter so the app renders only\n * StreamView without startup gates or navigation chrome.\n */\nfunction ensurePopoutUrl(raw: string): string {\n  try {\n    const u = new URL(raw);\n    // Handle both query and hash-based routing\n    if (u.hash?.includes(\"?\")) {\n      if (!u.hash.includes(\"popout\")) {\n        u.hash = `${u.hash}&popout`;\n      }\n    } else if (u.hash) {\n      u.hash = `${u.hash}?popout`;\n    } else if (!u.searchParams.has(\"popout\")) {\n      u.searchParams.set(\"popout\", \"\");\n    }\n    return u.toString();\n  } catch {\n    // Fallback: just append\n    const sep = raw.includes(\"?\") ? \"&\" : \"?\";\n    return `${raw}${sep}popout`;\n  }\n}\n\nexport async function startBrowserCapture(config: BrowserCaptureConfig) {\n  if (activeBrowser) {\n    logger.info(\"[browser-capture] Already running\");\n    return;\n  }\n\n  if (!isBrowserCaptureSupported()) {\n    throw new Error(\n      `Google Chrome not found at ${CHROME_PATH}. Install Chrome or update browser-capture before enabling screen capture.`,\n    );\n  }\n\n  const { url, width = 1280, height = 720, fps = 4, quality = 70 } = config;\n  const captureUrl = ensurePopoutUrl(url);\n\n  stopSignal = false;\n  logger.info(`[browser-capture] Launching headless Chrome to ${captureUrl}`);\n\n  const { default: puppeteer } = await import(\"puppeteer-core\");\n  const browser = await puppeteer.launch({\n    executablePath: CHROME_PATH,\n    headless: true,\n    args: [\n      `--window-size=${width},${height}`,\n      \"--no-sandbox\",\n      \"--disable-dev-shm-usage\",\n      \"--disable-extensions\",\n      \"--mute-audio\",\n      // WebGL / SwiftShader — required for VRM avatar rendering parity\n      \"--use-gl=swiftshader\",\n      \"--enable-webgl\",\n      \"--ignore-gpu-blocklist\",\n    ],\n  });\n\n  activeBrowser = browser;\n\n  const page = await browser.newPage();\n  await page.setViewport({ width, height, deviceScaleFactor: 1 });\n\n  // Seed localStorage before navigation so the first render matches the desktop shell.\n  // Keys must match exactly what the React app reads:\n  //   - \"eliza:theme\"                        → ThemeName\n  //   - \"eliza_avatar_index\"                 → VRM index (1–8)\n  //   - \"eliza.stream.overlay-layout.v1[.destId]\" → OverlayLayout JSON\n  await page.evaluateOnNewDocument(\n    (\n      overlayLayout: string | undefined,\n      theme: string | undefined,\n      avatarIndex: number | undefined,\n      destinationId: string | undefined,\n    ) => {\n      if (overlayLayout) {\n        // Seed both global and destination-specific keys so the hook\n        // resolves correctly regardless of when activeDestination loads.\n        localStorage.setItem(\"eliza.stream.overlay-layout.v1\", overlayLayout);\n        if (destinationId) {\n          localStorage.setItem(\n            `eliza.stream.overlay-layout.v1.${destinationId}`,\n            overlayLayout,\n          );\n        }\n      }\n      if (theme) {\n        localStorage.setItem(\"eliza:theme\", theme);\n      }\n      if (avatarIndex != null) {\n        localStorage.setItem(\"eliza_avatar_index\", String(avatarIndex));\n      }\n    },\n    config.overlayLayout,\n    config.theme,\n    config.avatarIndex,\n    config.destinationId,\n  );\n\n  // Use networkidle0 so fonts, VRM models, and preview images finish loading\n  await page.goto(captureUrl, {\n    waitUntil: \"networkidle0\",\n    timeout: 60_000,\n  });\n\n  logger.info(`[browser-capture] Page loaded, writing frames to ${FRAME_FILE}`);\n\n  let frameCount = 0;\n  const frameIntervalMs = Math.max(100, Math.round(1000 / Math.max(1, fps)));\n  activeCaptureLoop = (async () => {\n    while (!stopSignal) {\n      try {\n        await page.screenshot({\n          path: FRAME_FILE,\n          quality,\n          type: \"jpeg\",\n        });\n        frameCount += 1;\n        if (frameCount % 20 === 0) {\n          logger.debug(`[browser-capture] ${frameCount} frames written`);\n        }\n      } catch (error) {\n        if (!stopSignal) {\n          logger.warn(\n            `[browser-capture] frame capture failed: ${\n              error instanceof Error ? error.message : String(error)\n            }`,\n          );\n        }\n      }\n      if (!stopSignal) {\n        await sleep(frameIntervalMs);\n      }\n    }\n  })();\n\n  logger.info(\n    `[browser-capture] Screenshot loop active (${fps} fps), saving to ${FRAME_FILE}`,\n  );\n}\n\nexport async function stopBrowserCapture() {\n  stopSignal = true;\n  if (activeCaptureLoop) {\n    try {\n      await activeCaptureLoop;\n    } catch {}\n    activeCaptureLoop = null;\n  }\n  if (activeBrowser) {\n    try {\n      await activeBrowser.close();\n    } catch {}\n    activeBrowser = null;\n  }\n  logger.info(\"[browser-capture] Stopped\");\n}\n\nexport function isBrowserCaptureRunning(): boolean {\n  return activeBrowser !== null;\n}\n\nexport function hasFrameFile(): boolean {\n  return existsSync(FRAME_FILE);\n}\n"],"mappings":"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","names":[]}

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

@@ -1 +1 @@
-{"version":3,"file":"browser-workspace-desktop.d.ts","sourceRoot":"","sources":["../../src/workspace/browser-workspace-desktop.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,4BAA4B,EAC5B,uBAAuB,EACvB,6BAA6B,EAE7B,8BAA8B,EAC9B,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,8BAA8B,CAAC;AAsBtC,wBAAgB,mCAAmC,CACjD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,4BAA4B,GAAG,IAAI,CAUrC;AAED,wBAAgB,kCAAkC,CAChD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAET;AAED,wBAAgB,qCAAqC,IAAI,MAAM,CAE9D;AAED,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,WAAW,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,CAAC,CAAC,CA6BZ;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kCAAkC,EAC3C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,MAAM,EACV,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAY3B;AAsBD,wBAAgB,0CAA0C,CACxD,OAAO,EAAE,uBAAuB,EAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CA0wBR;AAED,wBAAgB,0CAA0C,CACxD,OAAO,EAAE,uBAAuB,GAC/B,MAAM,CAibR;AAED,wBAAsB,4CAA4C,CAChE,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,6BAA6B,CAAC,CAwCxC;AAED,wBAAsB,wCAAwC,CAC5D,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,8BAA8B,CAAC,CA0CzC;AAED,wBAAsB,sCAAsC,CAC1D,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwClC;AAED,wBAAsB,uCAAuC,CAC3D,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,wCAAwC,CAC5D,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,6BAA6B,CAAC,CA+DxC;AAID,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,mBAAmB,EAAE,GAC1B,mBAAmB,GAAG,IAAI,CAgB5B;AAED,wBAAsB,yCAAyC,CAC7D,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAoBjB"}
+{"version":3,"file":"browser-workspace-desktop.d.ts","sourceRoot":"","sources":["../../src/workspace/browser-workspace-desktop.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,4BAA4B,EAC5B,uBAAuB,EACvB,6BAA6B,EAE7B,8BAA8B,EAC9B,mBAAmB,EACnB,kCAAkC,EACnC,MAAM,8BAA8B,CAAC;AAsBtC,wBAAgB,mCAAmC,CACjD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,4BAA4B,GAAG,IAAI,CAUrC;AAED,wBAAgB,kCAAkC,CAChD,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAET;AAED,wBAAgB,qCAAqC,IAAI,MAAM,CAE9D;AAED,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,WAAW,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,CAAC,CAAC,CAsCZ;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kCAAkC,EAC3C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,OAAO,CAAC,CAyBlB;AAED,wBAAsB,2BAA2B,CAC/C,EAAE,EAAE,MAAM,EACV,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAc3B;AAsBD,wBAAgB,0CAA0C,CACxD,OAAO,EAAE,uBAAuB,EAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CA0wBR;AAED,wBAAgB,0CAA0C,CACxD,OAAO,EAAE,uBAAuB,GAC/B,MAAM,CAibR;AAED,wBAAsB,4CAA4C,CAChE,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,6BAA6B,CAAC,CAwCxC;AAED,wBAAsB,wCAAwC,CAC5D,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,8BAA8B,CAAC,CA0CzC;AAED,wBAAsB,sCAAsC,CAC1D,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwClC;AAED,wBAAsB,uCAAuC,CAC3D,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,wCAAwC,CAC5D,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,6BAA6B,CAAC,CA+DxC;AAID,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,mBAAmB,EAAE,GAC1B,mBAAmB,GAAG,IAAI,CAgB5B;AAED,wBAAsB,yCAAyC,CAC7D,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

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

@@ -1,3 +1,4 @@
+import { createBrowserWorkspaceError } from "./browser-workspace-errors.js";
 import {
   assertBrowserWorkspaceConnectorSecretsNotExported,
   assertBrowserWorkspaceUserScriptAllowed,
@@ -44,7 +45,11 @@ function getBrowserWorkspaceUnavailableMessage() {
 async function requestBrowserWorkspace(path, init, env = process.env) {
   const config = resolveBrowserWorkspaceBridgeConfig(env);
   if (!config) {
-    throw new Error(getBrowserWorkspaceUnavailableMessage());
+    throw createBrowserWorkspaceError(
+      "desktop_only",
+      "desktop_bridge",
+      getBrowserWorkspaceUnavailableMessage()
+    );
   }
   const headers = new Headers(init?.headers ?? {});
   headers.set("Accept", "application/json");
@@ -61,15 +66,22 @@ async function requestBrowserWorkspace(path, init, env = process.env) {
   });
   if (!response.ok) {
     const details = await readErrorBody(response);
-    throw new Error(
-      `Browser workspace request failed (${response.status})${details ? `: ${details}` : ""}`
+    const message = `Browser workspace request failed (${response.status})${details ? `: ${details}` : ""}`;
+    throw createBrowserWorkspaceError(
+      response.status === 404 ? "tab_not_found" : "command_failed",
+      path,
+      message,
+      details || void 0,
+      response.status
     );
   }
   return await response.json();
 }
 async function evaluateBrowserWorkspaceTab(request, env = process.env) {
   if (!isBrowserWorkspaceBridgeConfigured(env)) {
-    throw new Error(
+    throw createBrowserWorkspaceError(
+      "desktop_only",
+      "eval",
       "Eliza browser workspace eval is only available in the desktop app."
     );
   }
@@ -91,7 +103,9 @@ async function evaluateBrowserWorkspaceTab(request, env = process.env) {
 }
 async function snapshotBrowserWorkspaceTab(id, env = process.env) {
   if (!isBrowserWorkspaceBridgeConfigured(env)) {
-    throw new Error(
+    throw createBrowserWorkspaceError(
+      "desktop_only",
+      "snapshot",
       "Eliza browser workspace snapshot is only available in the desktop app."
     );
   }

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/workspace/browser-workspace-desktop.ts"],"sourcesContent":["import {\n  assertBrowserWorkspaceConnectorSecretsNotExported,\n  assertBrowserWorkspaceUserScriptAllowed,\n  createBrowserWorkspaceCommandTargetError,\n  DEFAULT_TIMEOUT_MS,\n  isBrowserWorkspaceUserScriptAllowed,\n  normalizeEnvValue,\n  resolveBrowserWorkspaceCommandElementRefs,\n} from \"./browser-workspace-helpers.js\";\nimport {\n  appendBrowserWorkspaceProfilerEntry,\n  appendBrowserWorkspaceTraceEntry,\n  getBrowserWorkspaceRuntimeState,\n  registerBrowserWorkspaceElementRefs,\n} from \"./browser-workspace-state.js\";\nimport type {\n  BrowserWorkspaceBridgeConfig,\n  BrowserWorkspaceCommand,\n  BrowserWorkspaceCommandResult,\n  BrowserWorkspaceDomElementSummary,\n  BrowserWorkspaceSnapshotRecord,\n  BrowserWorkspaceTab,\n  EvaluateBrowserWorkspaceTabRequest,\n} from \"./browser-workspace-types.js\";\n\nasync function assertDesktopBrowserWorkspaceCanAccessProfileSecrets(\n  id: string,\n  env: NodeJS.ProcessEnv,\n  operation: string,\n): Promise<void> {\n  const payload = await requestBrowserWorkspace<{\n    tabs?: BrowserWorkspaceTab[];\n  }>(\"/tabs\", undefined, env);\n  const tab = payload.tabs?.find((entry) => entry.id === id) ?? null;\n  assertBrowserWorkspaceConnectorSecretsNotExported(tab?.partition, operation);\n}\n\nasync function readErrorBody(response: Response): Promise<string> {\n  try {\n    return (await response.text()).trim().slice(0, 240);\n  } catch {\n    return \"\";\n  }\n}\n\nexport function resolveBrowserWorkspaceBridgeConfig(\n  env: NodeJS.ProcessEnv = process.env,\n): BrowserWorkspaceBridgeConfig | null {\n  const baseUrl = normalizeEnvValue(env.ELIZA_BROWSER_WORKSPACE_URL);\n  if (!baseUrl) {\n    return null;\n  }\n\n  return {\n    baseUrl: baseUrl.replace(/\\/{1,1024}$/, \"\"),\n    token: normalizeEnvValue(env.ELIZA_BROWSER_WORKSPACE_TOKEN),\n  };\n}\n\nexport function isBrowserWorkspaceBridgeConfigured(\n  env: NodeJS.ProcessEnv = process.env,\n): boolean {\n  return resolveBrowserWorkspaceBridgeConfig(env) !== null;\n}\n\nexport function getBrowserWorkspaceUnavailableMessage(): string {\n  return \"Eliza browser workspace desktop bridge is unavailable.\";\n}\n\nexport async function requestBrowserWorkspace<T>(\n  path: string,\n  init?: RequestInit,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<T> {\n  const config = resolveBrowserWorkspaceBridgeConfig(env);\n  if (!config) {\n    throw new Error(getBrowserWorkspaceUnavailableMessage());\n  }\n\n  const headers = new Headers(init?.headers ?? {});\n  headers.set(\"Accept\", \"application/json\");\n  if (!headers.has(\"Content-Type\") && init?.body) {\n    headers.set(\"Content-Type\", \"application/json\");\n  }\n  if (config.token) {\n    headers.set(\"Authorization\", `Bearer ${config.token}`);\n  }\n\n  const response = await fetch(`${config.baseUrl}${path}`, {\n    ...init,\n    headers,\n    signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),\n  });\n\n  if (!response.ok) {\n    const details = await readErrorBody(response);\n    throw new Error(\n      `Browser workspace request failed (${response.status})${details ? `: ${details}` : \"\"}`,\n    );\n  }\n\n  return (await response.json()) as T;\n}\n\nexport async function evaluateBrowserWorkspaceTab(\n  request: EvaluateBrowserWorkspaceTabRequest,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<unknown> {\n  if (!isBrowserWorkspaceBridgeConfigured(env)) {\n    throw new Error(\n      \"Eliza browser workspace eval is only available in the desktop app.\",\n    );\n  }\n\n  const evalBody: { script: string; partition?: string } = {\n    script: request.script,\n  };\n  if (request.partition !== undefined) {\n    evalBody.partition = request.partition;\n  }\n\n  const payload = await requestBrowserWorkspace<{ result: unknown }>(\n    `/tabs/${encodeURIComponent(request.id)}/eval`,\n    {\n      method: \"POST\",\n      body: JSON.stringify(evalBody),\n    },\n    env,\n  );\n  return payload.result;\n}\n\nexport async function snapshotBrowserWorkspaceTab(\n  id: string,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<{ data: string }> {\n  if (!isBrowserWorkspaceBridgeConfigured(env)) {\n    throw new Error(\n      \"Eliza browser workspace snapshot is only available in the desktop app.\",\n    );\n  }\n\n  return await requestBrowserWorkspace<{ data: string }>(\n    `/tabs/${encodeURIComponent(id)}/snapshot`,\n    undefined,\n    env,\n  );\n}\n\nfunction desktopBrowserWorkspaceWaitScriptBranch(\n  env: NodeJS.ProcessEnv,\n): string {\n  if (isBrowserWorkspaceUserScriptAllowed(env)) {\n    return `\n          if (command.script) {\n            const fn = new Function(\"document\", \"window\", \"location\", \"return (\" + command.script + \");\");\n            if (fn(document, window, location)) {\n              resolve({ ok: true, script: true });\n              return;\n            }\n          }`;\n  }\n  return `\n          if (command.script) {\n            reject(new Error(\"Browser workspace wait script is disabled (GHSA-mhhr-9ph9-64j7).\"));\n            return;\n          }`;\n}\n\nexport function createDesktopBrowserWorkspaceCommandScript(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv = process.env,\n): string {\n  const waitScriptBranch = desktopBrowserWorkspaceWaitScriptBranch(env);\n  return `\n(() => {\n  const command = ${JSON.stringify(command)};\n  const normalize = (value) => String(value ?? \"\").replace(/\\\\s+/g, \" \").trim();\n  const textMatches = (candidate, wanted, exact = false) => {\n    const left = normalize(candidate).toLowerCase();\n    const right = normalize(wanted).toLowerCase();\n    if (!left || !right) return false;\n    return exact ? left === right : left.includes(right);\n  };\n  const selectorFor = (element) => {\n    if (!element) return \"\";\n    if (element.id) return \"#\" + element.id.replace(/[^a-zA-Z0-9_-]/g, \"\\\\\\\\$&\");\n    const testId = element.getAttribute?.(\"data-testid\");\n    if (testId) return \\`[data-testid=\"\\${testId}\"]\\`;\n    const name = element.getAttribute?.(\"name\");\n    if (name) return \\`\\${element.tagName.toLowerCase()}[name=\"\\${name}\"]\\`;\n    const type = element.getAttribute?.(\"type\");\n    if (type) return \\`\\${element.tagName.toLowerCase()}[type=\"\\${type}\"]\\`;\n    let index = 1;\n    let previous = element.previousElementSibling;\n    while (previous) {\n      if (previous.tagName === element.tagName) index += 1;\n      previous = previous.previousElementSibling;\n    }\n    return \\`\\${element.tagName.toLowerCase()}:nth-of-type(\\${index})\\`;\n  };\n  const serialize = (element) => {\n    const value =\n      element instanceof HTMLInputElement ||\n      element instanceof HTMLTextAreaElement ||\n      element instanceof HTMLSelectElement\n        ? element.value\n        : null;\n    return {\n      selector: selectorFor(element),\n      tag: element.tagName.toLowerCase(),\n      text: normalize(value ?? element.textContent),\n      type: element.getAttribute?.(\"type\"),\n      name: element.getAttribute?.(\"name\"),\n      href: element.getAttribute?.(\"href\"),\n      value: typeof value === \"string\" ? value : null,\n    };\n  };\n  const searchTexts = (element) => {\n    const labelText = element.id\n      ? Array.from(document.querySelectorAll('label[for=\"' + element.id + '\"]'))\n          .map((label) => label.textContent)\n          .join(\" \")\n      : \"\";\n    return [\n      element.textContent,\n      element.getAttribute?.(\"aria-label\"),\n      element.getAttribute?.(\"placeholder\"),\n      element.getAttribute?.(\"title\"),\n      element.getAttribute?.(\"name\"),\n      element.getAttribute?.(\"alt\"),\n      element.getAttribute?.(\"data-testid\"),\n      labelText,\n      element.value,\n    ]\n      .map((value) => normalize(value))\n      .filter(Boolean);\n  };\n  const isVisible = (element) => {\n    if (!element) return false;\n    if (element.hasAttribute?.(\"hidden\") || element.getAttribute?.(\"aria-hidden\") === \"true\") {\n      return false;\n    }\n    const style = element.style || {};\n    return style.display !== \"none\" && style.visibility !== \"hidden\";\n  };\n  const nativeRole = (element) => {\n    const explicit = element.getAttribute?.(\"role\")?.trim()?.toLowerCase();\n    if (explicit) return explicit;\n    const tag = element.tagName.toLowerCase();\n    if (tag === \"a\" && element.getAttribute?.(\"href\")) return \"link\";\n    if (tag === \"button\") return \"button\";\n    if (tag === \"select\") return \"combobox\";\n    if (tag === \"option\") return \"option\";\n    if (tag === \"textarea\") return \"textbox\";\n    if (tag === \"form\") return \"form\";\n    if (/^h[1-6]$/.test(tag)) return \"heading\";\n    if (tag === \"input\") {\n      const type = (element.type || \"text\").toLowerCase();\n      if (type === \"checkbox\") return \"checkbox\";\n      if (type === \"radio\") return \"radio\";\n      if ([\"button\", \"submit\", \"reset\", \"image\"].includes(type)) return \"button\";\n      return \"textbox\";\n    }\n    return null;\n  };\n  const findByText = (wanted) => {\n    const needle = normalize(wanted).toLowerCase();\n    if (!needle) return null;\n    const elements = Array.from(document.querySelectorAll(\n      \"a, button, input, textarea, select, option, label, h1, h2, h3, [role='button'], [data-testid]\"\n    ));\n    for (const element of elements) {\n      const haystacks = [\n        element.textContent,\n        element.getAttribute?.(\"aria-label\"),\n        element.getAttribute?.(\"placeholder\"),\n        element.getAttribute?.(\"title\"),\n        element.getAttribute?.(\"name\"),\n        element.value,\n      ]\n        .map((value) => normalize(value))\n        .filter(Boolean)\n        .map((value) => value.toLowerCase());\n      if (haystacks.some((value) => value.includes(needle))) {\n        return element;\n      }\n    }\n    return null;\n  };\n  const findByLabel = (wanted, exact = false) => {\n    const labels = Array.from(document.querySelectorAll(\"label\"));\n    for (const label of labels) {\n      if (!textMatches(label.textContent, wanted, exact)) continue;\n      const forId = label.getAttribute(\"for\");\n      if (forId) {\n        const explicit = document.getElementById(forId);\n        if (explicit) return explicit;\n      }\n      const nested = label.querySelector(\"input, textarea, select, button\");\n      if (nested) return nested;\n    }\n    return null;\n  };\n  const findByRole = (role, name, exact = false) => {\n    const candidates = Array.from(\n      document.querySelectorAll(\n        \"a, button, input, textarea, select, option, form, h1, h2, h3, h4, h5, h6, [role], [data-testid]\"\n      )\n    );\n    for (const candidate of candidates) {\n      if (nativeRole(candidate) !== role.trim().toLowerCase()) continue;\n      if (!name) return candidate;\n      if (searchTexts(candidate).some((value) => textMatches(value, name, exact))) {\n        return candidate;\n      }\n    }\n    return null;\n  };\n  const trimQuoted = (value) => {\n    const trimmed = String(value || \"\").trim();\n    const hasTextMatch = trimmed.match(/^has-text\\\\((?:\"([^\"]*)\"|'([^']*)')\\\\)$/i);\n    if (hasTextMatch?.[1] || hasTextMatch?.[2]) {\n      return (hasTextMatch[1] || hasTextMatch[2] || \"\").trim();\n    }\n    if (\n      (trimmed.startsWith('\"') && trimmed.endsWith('\"')) ||\n      (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\"))\n    ) {\n      return trimmed.slice(1, -1).trim();\n    }\n    return trimmed;\n  };\n  const normalizeSelectorSyntax = (selector) => {\n    let normalized = String(selector || \"\").trim();\n    normalized = normalized.replace(\n      /^role\\\\s*[:=]\\\\s*([a-z0-9_-]+)\\\\s+name\\\\s*[:=]\\\\s*(.+)$/i,\n      \"role=$1[name=$2]\"\n    );\n    normalized = normalized.replace(\n      /^((?:label|text|placeholder|alt|title|testid|data-testid)\\\\s*[:=]\\\\s*(?:has-text\\\\((?:\"[^\"]*\"|'[^']*')\\\\)|\"[^\"]+\"|'[^']+'|[^>]+?))\\\\s+((?:input|textarea|select)[\\\\s\\\\S]*)$/i,\n      \"$1 >> $2\"\n    );\n    return normalized;\n  };\n  const parseSemanticSelector = (selector) => {\n    const trimmed = normalizeSelectorSyntax(selector);\n    const match = trimmed.match(/^([a-z-]+)\\\\s*[:=]\\\\s*(.+)$/i);\n    if (!match) return null;\n    const kind = match[1]?.trim()?.toLowerCase();\n    const rawValue = match[2]?.trim() || \"\";\n    if (!kind || !rawValue) return null;\n    switch (kind) {\n      case \"alt\":\n        return { findBy: \"alt\", text: trimQuoted(rawValue) };\n      case \"css\":\n        return { selector: trimQuoted(rawValue) };\n      case \"data-testid\":\n      case \"testid\":\n        return { findBy: \"testid\", text: trimQuoted(rawValue) };\n      case \"label\":\n        return { findBy: \"label\", text: trimQuoted(rawValue) };\n      case \"placeholder\":\n        return { findBy: \"placeholder\", text: trimQuoted(rawValue) };\n      case \"role\": {\n        const roleMatch = rawValue.match(\n          /^([a-z0-9_-]+)(?:\\\\s*\\\\[\\\\s*name\\\\s*[:=]\\\\s*(.+?)\\\\s*\\\\])?$/i\n        );\n        if (!roleMatch?.[1]) return null;\n        return {\n          findBy: \"role\",\n          name: roleMatch[2] ? trimQuoted(roleMatch[2]) : undefined,\n          role: roleMatch[1].trim().toLowerCase(),\n        };\n      }\n      case \"text\":\n        return { findBy: \"text\", text: trimQuoted(rawValue) };\n      case \"title\":\n        return { findBy: \"title\", text: trimQuoted(rawValue) };\n      default:\n        return null;\n    }\n  };\n  const mergeSelectorCommand = (selector) => {\n    const parsed = parseSemanticSelector(selector);\n    if (!parsed) return null;\n    return { ...command, ...parsed, selector: parsed.selector };\n  };\n  const queryOne = (selector) => {\n    try {\n      return document.querySelector(selector);\n    } catch {\n      throw new Error(\"Invalid selector \" + selector);\n    }\n  };\n  const queryAll = (selector) => {\n    try {\n      return Array.from(document.querySelectorAll(selector));\n    } catch {\n      throw new Error(\"Invalid selector \" + selector);\n    }\n  };\n  const findSemantic = (targetCommand = command) => {\n    switch (targetCommand.findBy) {\n      case \"alt\":\n        return Array.from(document.querySelectorAll(\"[alt]\")).find((element) =>\n          textMatches(\n            element.getAttribute(\"alt\"),\n            targetCommand.text,\n            targetCommand.exact\n          )\n        ) || null;\n      case \"first\":\n        return targetCommand.selector ? queryOne(targetCommand.selector) : null;\n      case \"label\":\n        return targetCommand.text\n          ? findByLabel(targetCommand.text, targetCommand.exact)\n          : null;\n      case \"last\":\n        return targetCommand.selector\n          ? queryAll(targetCommand.selector).at(-1) || null\n          : null;\n      case \"nth\":\n        return targetCommand.selector && Number.isInteger(targetCommand.index)\n          ? queryAll(targetCommand.selector).at(targetCommand.index) || null\n          : null;\n      case \"placeholder\":\n        return Array.from(document.querySelectorAll(\"[placeholder]\")).find((element) =>\n          textMatches(\n            element.getAttribute(\"placeholder\"),\n            targetCommand.text,\n            targetCommand.exact\n          )\n        ) || null;\n      case \"role\":\n        return targetCommand.role\n          ? findByRole(\n              targetCommand.role,\n              targetCommand.name,\n              targetCommand.exact\n            )\n          : null;\n      case \"testid\":\n        return targetCommand.text\n          ? document.querySelector('[data-testid=\"' + targetCommand.text + '\"]')\n          : null;\n      case \"text\":\n        return targetCommand.text ? findByText(targetCommand.text) : null;\n      case \"title\":\n        return Array.from(document.querySelectorAll(\"[title]\")).find((element) =>\n          textMatches(\n            element.getAttribute(\"title\"),\n            targetCommand.text,\n            targetCommand.exact\n          )\n        ) || null;\n      default:\n        return null;\n    }\n  };\n  const findTarget = () => {\n    if (command.selector) {\n      const selectorChain = normalizeSelectorSyntax(command.selector)\n        .split(/s*>>s*/)\n        .map((segment) => segment.trim())\n        .filter(Boolean);\n      if (selectorChain.length > 1) {\n        let current = queryTarget(selectorChain[0]);\n        for (let index = 1; current && index < selectorChain.length; index += 1) {\n          const segment = selectorChain[index];\n          if (!segment) continue;\n          if (typeof current.matches === \"function\" && current.matches(segment)) {\n            continue;\n          }\n          if (\n            /^(input|textarea|select)(?:[[^]]+])?$/i.test(segment) &&\n            (current.tagName === \"INPUT\" ||\n              current.tagName === \"TEXTAREA\" ||\n              current.tagName === \"SELECT\")\n          ) {\n            continue;\n          }\n          current = queryOneWithin(current, segment);\n        }\n        return current;\n      }\n      return queryTarget(command.selector);\n    }\n    if (command.findBy) return findSemantic();\n    if (command.text) return findByText(command.text);\n    return null;\n  };\n  const queryOneWithin = (root, selector) => {\n    try {\n      return root.querySelector(selector);\n    } catch {\n      throw new Error(\"Invalid selector \" + selector);\n    }\n  };\n  const queryTarget = (selector) => {\n    const semantic = mergeSelectorCommand(selector);\n    if (semantic) return findSemantic(semantic);\n    return queryOne(selector);\n  };\n  const inspect = () =>\n    Array.from(\n      document.querySelectorAll(\n        \"a, button, input, textarea, select, form, [role='button'], [data-testid]\"\n      )\n    )\n      .slice(0, 40)\n      .map((element) => serialize(element));\n  const snapshot = () => ({\n    title: document.title,\n    url: location.href,\n    bodyText: normalize(document.body?.textContent).slice(0, 800),\n    elements: inspect(),\n  });\n  const setInputValue = (appendMode, target) => {\n    const element = target || findTarget();\n    if (!element) {\n      throw new Error(\"Target element was not found.\");\n    }\n    if (\n      !(\n        element instanceof HTMLInputElement ||\n        element instanceof HTMLTextAreaElement ||\n        element instanceof HTMLSelectElement\n      )\n    ) {\n      throw new Error(\"Target element is not an input, textarea, or select.\");\n    }\n    const nextValue = appendMode ? \\`\\${element.value ?? \"\"}\\${command.value ?? \"\"}\\` : (command.value ?? \"\");\n    element.value = nextValue;\n    element.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    element.dispatchEvent(new Event(\"change\", { bubbles: true }));\n    return { selector: selectorFor(element), value: element.value };\n  };\n  const setChecked = (targetValue) => {\n    const element = findTarget();\n    if (!element) throw new Error(\"Target element was not found.\");\n    if (!(element instanceof HTMLInputElement)) {\n      throw new Error(\"Target element is not a checkbox or radio input.\");\n    }\n    const type = (element.type || \"\").toLowerCase();\n    if (type !== \"checkbox\" && type !== \"radio\") {\n      throw new Error(\"Target element is not a checkbox or radio input.\");\n    }\n    element.checked = targetValue;\n    element.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    element.dispatchEvent(new Event(\"change\", { bubbles: true }));\n    return { checked: element.checked, selector: selectorFor(element) };\n  };\n  const setSelectValue = () => {\n    const element = findTarget();\n    if (!element) throw new Error(\"Target element was not found.\");\n    if (!(element instanceof HTMLSelectElement)) {\n      throw new Error(\"Target element is not a select.\");\n    }\n    const targetValue = command.value ?? \"\";\n    const option = Array.from(element.options).find(\n      (entry) =>\n        entry.value === targetValue || textMatches(entry.textContent, targetValue, true)\n    );\n    if (!option) {\n      throw new Error(\"Select option was not found.\");\n    }\n    element.value = option.value;\n    option.selected = true;\n    element.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    element.dispatchEvent(new Event(\"change\", { bubbles: true }));\n    return { selector: selectorFor(element), value: element.value };\n  };\n  const focusElement = (element) => {\n    if (!element) throw new Error(\"Target element was not found.\");\n    if (typeof element.focus === \"function\") {\n      element.focus();\n    }\n    return {\n      focused: document.activeElement === element,\n      selector: selectorFor(element),\n    };\n  };\n  const hoverElement = (element) => {\n    if (!element) throw new Error(\"Target element was not found.\");\n    element.setAttribute(\"data-eliza-hover\", \"true\");\n    return { hovered: true, selector: selectorFor(element) };\n  };\n  const activateElement = (subaction, element) => {\n    if (!element) throw new Error(\"Target element was not found.\");\n    if (subaction === \"dblclick\") {\n      element.dispatchEvent(new MouseEvent(\"dblclick\", { bubbles: true }));\n    }\n    if (typeof element.click === \"function\") {\n      element.click();\n    }\n    return {\n      clickCount: subaction === \"dblclick\" ? 2 : 1,\n      element: serialize(element),\n      url: location.href,\n    };\n  };\n  const ensureTabKit = () => {\n    const kit = window.__elizaTabKit;\n    if (!kit) {\n      throw new Error(\n        \"browser tab kit not installed (BROWSER_TAB_PRELOAD_SCRIPT missing)\",\n      );\n    }\n    return kit;\n  };\n  const runRealisticSubaction = (subaction) => {\n    const kit = ensureTabKit();\n    const cursorDuration = Number(command.cursorDurationMs) || 220;\n    if (subaction === \"cursor-hide\") {\n      kit.cursor.hide();\n      return { hidden: true };\n    }\n    if (subaction === \"cursor-move\") {\n      const x = Number(command.x);\n      const y = Number(command.y);\n      if (!Number.isFinite(x) || !Number.isFinite(y)) {\n        throw new Error(\"cursor-move requires x and y\");\n      }\n      kit.cursor.show();\n      return Promise.resolve(\n        kit.cursor.moveTo({ x: x, y: y }, { durationMs: cursorDuration }),\n      ).then(() => ({ x: x, y: y }));\n    }\n    if (subaction === \"realistic-press\") {\n      const target = findTarget() || document.activeElement || document.body;\n      const key = command.key || \"Enter\";\n      target.dispatchEvent(\n        new KeyboardEvent(\"keydown\", {\n          key: key,\n          bubbles: true,\n          cancelable: true,\n          composed: true,\n        }),\n      );\n      target.dispatchEvent(\n        new KeyboardEvent(\"keyup\", {\n          key: key,\n          bubbles: true,\n          cancelable: true,\n          composed: true,\n        }),\n      );\n      return { key: key, selector: selectorFor(target), url: location.href };\n    }\n    const element = findTarget();\n    if (!element) {\n      throw new Error(\"Target element was not found.\");\n    }\n    kit.cursor.show();\n    if (subaction === \"realistic-click\") {\n      kit.cursor.highlight(element);\n      return Promise.resolve(\n        kit.dispatchPointerSequence(element, { button: 0 }),\n      ).then(() => ({\n        element: serialize(element),\n        url: location.href,\n      }));\n    }\n    if (subaction === \"realistic-fill\" || subaction === \"realistic-type\") {\n      const value = command.value ?? command.text ?? \"\";\n      const replace = subaction === \"realistic-fill\" || command.replace === true;\n      const perCharDelayMs = Number(command.perCharDelayMs);\n      kit.cursor.highlight(element);\n      return Promise.resolve(\n        kit\n          .dispatchPointerSequence(element, { button: 0 })\n          .then(() =>\n            kit.typeRealistic(element, value, {\n              replace: replace,\n              perCharDelayMs: Number.isFinite(perCharDelayMs)\n                ? perCharDelayMs\n                : undefined,\n            }),\n          ),\n      ).then(() => ({\n        element: serialize(element),\n        value: element.value,\n      }));\n    }\n    if (subaction === \"realistic-upload\") {\n      const url = (command.files && command.files[0]) || command.url || command.value;\n      if (!url) {\n        throw new Error(\"realistic-upload requires files[0] or url\");\n      }\n      if (element.tagName !== \"INPUT\" || element.type !== \"file\") {\n        throw new Error(\"realistic-upload target must be input[type=file]\");\n      }\n      kit.cursor.highlight(element);\n      return Promise.resolve(kit.setFileInput(element, url, {})).then((info) => ({\n        element: serialize(element),\n        upload: info,\n      }));\n    }\n    throw new Error(\"Unsupported realistic subaction: \" + subaction);\n  };\n  const keyboardTarget = () => findTarget() || document.activeElement || document.body;\n  const keyboardWrite = (appendMode) => {\n    const target = keyboardTarget();\n    if (\n      !(\n        target instanceof HTMLInputElement ||\n        target instanceof HTMLTextAreaElement ||\n        target instanceof HTMLSelectElement\n      )\n    ) {\n      throw new Error(\"Keyboard text input requires an input, textarea, or select target.\");\n    }\n    return setInputValue(appendMode, target);\n  };\n  const keyPhase = (phase) => {\n    const target = keyboardTarget();\n    const key = command.key || \"Enter\";\n    target.dispatchEvent(new KeyboardEvent(phase, { key, bubbles: true }));\n    return { key, phase, selector: selectorFor(target) };\n  };\n  const scrollTarget = () => findTarget();\n  const scroll = () => {\n    const target = scrollTarget();\n    const direction = command.direction || \"down\";\n    const pixels = Math.max(1, Math.abs(Number(command.pixels) || 240));\n    const axis = direction === \"left\" || direction === \"right\" ? \"x\" : \"y\";\n    const delta = direction === \"up\" || direction === \"left\" ? -pixels : pixels;\n    if (target instanceof HTMLElement) {\n      if (axis === \"y\") {\n        target.scrollTop = (target.scrollTop || 0) + delta;\n        return { axis, selector: selectorFor(target), value: target.scrollTop };\n      }\n      target.scrollLeft = (target.scrollLeft || 0) + delta;\n      return { axis, selector: selectorFor(target), value: target.scrollLeft };\n    }\n    if (axis === \"y\") {\n      window.scrollBy(0, delta);\n      return { axis, selector: null, value: window.scrollY };\n    }\n    window.scrollBy(delta, 0);\n    return { axis, selector: null, value: window.scrollX };\n  };\n  const getResult = () => {\n    if (command.getMode === \"title\") return document.title;\n    if (command.getMode === \"url\") return location.href;\n    if (command.getMode === \"count\") {\n      if (!command.selector) throw new Error(\"count requires selector\");\n      const semantic = mergeSelectorCommand(command.selector);\n      return semantic ? Number(Boolean(findSemantic(semantic))) : queryAll(command.selector).length;\n    }\n    const element = findTarget();\n    if (!element) throw new Error(\"Target element was not found.\");\n    switch (command.getMode) {\n      case \"attr\":\n        if (!command.attribute) throw new Error(\"attr lookups require attribute\");\n        return element.getAttribute(command.attribute);\n      case \"box\":\n        return element.getBoundingClientRect();\n      case \"checked\":\n        return element instanceof HTMLInputElement\n          ? Boolean(element.checked)\n          : element instanceof HTMLOptionElement\n            ? Boolean(element.selected)\n            : false;\n      case \"enabled\":\n        return \"disabled\" in element ? !Boolean(element.disabled) : true;\n      case \"html\":\n        return element.innerHTML;\n      case \"styles\": {\n        const computed = getComputedStyle(element);\n        return {\n          display: computed.display || null,\n          visibility: computed.visibility || null,\n          opacity: computed.opacity || null,\n        };\n      }\n      case \"text\":\n        return normalize(element.textContent);\n      case \"value\":\n        return element.value ?? element.getAttribute?.(\"value\");\n      case \"visible\":\n        return isVisible(element);\n      default:\n        return normalize(element.textContent);\n    }\n  };\n  const waitForCondition = () =>\n    new Promise((resolve, reject) => {\n      if (\n        !command.selector &&\n        !command.findBy &&\n        !command.text &&\n        !command.url &&\n        !command.script &&\n        Number.isFinite(Number(command.timeoutMs))\n      ) {\n        const waitedMs = Math.max(0, Number(command.timeoutMs) || 0);\n        setTimeout(() => resolve({ ok: true, waitedMs }), waitedMs);\n        return;\n      }\n      const deadline = Date.now() + (Number(command.timeoutMs) || 4000);\n      const check = () => {\n        try {\n          if (command.selector) {\n            const found = findTarget();\n            const visible =\n              command.state === \"hidden\"\n                ? !found || !isVisible(found)\n                : found && isVisible(found);\n            if (visible) {\n              resolve({ ok: true, selector: command.selector, state: command.state || \"visible\" });\n              return;\n            }\n          }\n          if (command.findBy) {\n            const found = findSemantic();\n            if (command.state === \"hidden\" ? !found : found) {\n              resolve({ findBy: command.findBy, ok: true });\n              return;\n            }\n          }\n          if (command.text && normalize(document.body?.textContent).includes(command.text)) {\n            resolve({ ok: true, text: command.text });\n            return;\n          }\n          if (command.url && location.href.includes(command.url)) {\n            resolve({ ok: true, url: location.href });\n            return;\n          }\n          ${waitScriptBranch}\n          if (Date.now() >= deadline) {\n            reject(new Error(\"Timed out waiting for browser workspace condition.\"));\n            return;\n          }\n          setTimeout(check, 100);\n        } catch (error) {\n          reject(error);\n        }\n      };\n      check();\n    });\n\n  switch (command.subaction) {\n    case \"inspect\":\n      return { title: document.title, url: location.href, elements: inspect() };\n    case \"snapshot\":\n      return snapshot();\n    case \"get\":\n      return { value: getResult() };\n    case \"find\": {\n      const element = findTarget();\n      if (!element) throw new Error(\"Target element was not found.\");\n      switch (command.action) {\n        case \"check\":\n          return setChecked(true);\n        case \"click\":\n          return activateElement(\"click\", element);\n        case \"fill\":\n          return setInputValue(false, element);\n        case \"focus\":\n          return focusElement(element);\n        case \"hover\":\n          return hoverElement(element);\n        case \"text\":\n        case undefined:\n          return { element: serialize(element), value: normalize(element.textContent) };\n        case \"type\":\n          return setInputValue(true, element);\n        case \"uncheck\":\n          return setChecked(false);\n        default:\n          throw new Error(\"Unsupported find action.\");\n      }\n    }\n    case \"click\": {\n      const element = findTarget();\n      return activateElement(\"click\", element);\n    }\n    case \"dblclick\": {\n      const element = findTarget();\n      return activateElement(\"dblclick\", element);\n    }\n    case \"check\":\n      return setChecked(true);\n    case \"fill\":\n      return setInputValue(false);\n    case \"focus\": {\n      const element = findTarget();\n      return focusElement(element);\n    }\n    case \"hover\": {\n      const element = findTarget();\n      return hoverElement(element);\n    }\n    case \"keyboardinserttext\":\n      return keyboardWrite(false);\n    case \"keyboardtype\":\n      return keyboardWrite(true);\n    case \"keydown\":\n      return keyPhase(\"keydown\");\n    case \"keyup\":\n      return keyPhase(\"keyup\");\n    case \"type\":\n      return setInputValue(true);\n    case \"press\": {\n      const target = findTarget() ?? document.activeElement ?? document.body;\n      const key = command.key || \"Enter\";\n      target.dispatchEvent(new KeyboardEvent(\"keydown\", { key, bubbles: true }));\n      target.dispatchEvent(new KeyboardEvent(\"keyup\", { key, bubbles: true }));\n      return { key, url: location.href };\n    }\n    case \"realistic-click\":\n    case \"realistic-fill\":\n    case \"realistic-type\":\n    case \"realistic-press\":\n    case \"realistic-upload\":\n    case \"cursor-move\":\n    case \"cursor-hide\":\n      return runRealisticSubaction(command.subaction);\n    case \"scroll\":\n      return scroll();\n    case \"scrollinto\": {\n      const element = findTarget();\n      if (!element) throw new Error(\"Target element was not found.\");\n      if (typeof element.scrollIntoView === \"function\") {\n        element.scrollIntoView();\n      }\n      return { scrolled: true, selector: selectorFor(element) };\n    }\n    case \"select\":\n      return setSelectValue();\n    case \"uncheck\":\n      return setChecked(false);\n    case \"wait\":\n      return waitForCondition();\n    case \"back\":\n      history.back();\n      return { url: location.href, title: document.title };\n    case \"forward\":\n      history.forward();\n      return { url: location.href, title: document.title };\n    case \"reload\":\n      location.reload();\n      return { url: location.href, title: document.title };\n    default:\n      throw new Error(\\`Unsupported desktop browser subaction: \\${command.subaction}\\`);\n  }\n})()\n`.trim();\n}\n\nexport function createDesktopBrowserWorkspaceUtilityScript(\n  command: BrowserWorkspaceCommand,\n): string {\n  return `\n(() => {\n  const command = ${JSON.stringify(command)};\n  const normalize = (value) => String(value ?? \"\").replace(/\\\\s+/g, \" \").trim();\n  const state =\n    window.__elizaBrowserWorkspaceState ||\n    (window.__elizaBrowserWorkspaceState = {\n      clipboardText: \"\",\n      consoleEntries: [],\n      currentFrame: null,\n      dialog: null,\n      errors: [],\n      highlightedSelector: null,\n      mouse: { buttons: [], x: 0, y: 0 },\n      networkHar: { active: false, entries: [], startedAt: null },\n      networkNextRequestId: 1,\n      networkRequests: [],\n      networkRoutes: [],\n      settings: {\n        credentials: null,\n        device: null,\n        geo: null,\n        headers: {},\n        media: null,\n        offline: false,\n        viewport: null\n      }\n    });\n  const patternMatches = (pattern, value) => {\n    const trimmed = String(pattern ?? \"\").trim();\n    if (!trimmed) return false;\n    if (!trimmed.includes(\"*\")) return String(value ?? \"\").includes(trimmed);\n    let wildcard = \"\";\n    for (let i = 0; i < trimmed.length; i += 1) {\n      const char = trimmed[i];\n      if (char === \"*\") {\n        if (trimmed[i + 1] === \"*\") {\n          wildcard += \".*\";\n          i += 1;\n        } else {\n          wildcard += \".*\";\n        }\n      } else {\n        wildcard += char.replace(/[|\\\\\\\\{}()[\\\\]^$+?.]/g, \"\\\\\\\\$&\");\n      }\n    }\n    return new RegExp(\"^\" + wildcard + \"$\", \"i\").test(String(value ?? \"\"));\n  };\n  const buildSelector = (element) => {\n    if (!element || !element.tagName) return null;\n    const testId = element.getAttribute && element.getAttribute(\"data-testid\");\n    if (testId) return '[data-testid=\"' + testId + '\"]';\n    const name = element.getAttribute && element.getAttribute(\"name\");\n    if (name) return element.tagName.toLowerCase() + '[name=\"' + name + '\"]';\n    const title = element.getAttribute && element.getAttribute(\"title\");\n    if (title) return element.tagName.toLowerCase() + '[title=\"' + title + '\"]';\n    return element.tagName.toLowerCase();\n  };\n  const activeDocument = (() => {\n    if (!state.currentFrame) return document;\n    try {\n      const frame = document.querySelector(state.currentFrame);\n      return frame && frame.contentDocument ? frame.contentDocument : document;\n    } catch {\n      return document;\n    }\n  })();\n  const queryOne = (selector, root = activeDocument) => {\n    try {\n      return root.querySelector(selector);\n    } catch {\n      throw new Error(\"Invalid selector \" + selector);\n    }\n  };\n  const findByText = (needle) => {\n    const wanted = normalize(needle).toLowerCase();\n    if (!wanted) return null;\n    const candidates = Array.from(\n      activeDocument.querySelectorAll(\n        \"a, button, input, textarea, select, option, label, h1, h2, h3, [role='button'], [data-testid]\"\n      )\n    );\n    return (\n      candidates.find((element) => {\n        const haystacks = [\n          element.textContent,\n          element.getAttribute(\"aria-label\"),\n          element.getAttribute(\"placeholder\"),\n          element.getAttribute(\"title\"),\n          element.getAttribute(\"name\"),\n          element.value\n        ]\n          .map((value) => normalize(value).toLowerCase())\n          .filter(Boolean);\n        return haystacks.some((value) => value.includes(wanted));\n      }) || null\n    );\n  };\n  const resolveTarget = () => {\n    if (command.selector) return queryOne(command.selector);\n    if (command.text) return findByText(command.text);\n    return activeDocument.activeElement || activeDocument.body;\n  };\n  const recordRequest = (request) => {\n    const entry = {\n      ...request,\n      id: \"req_\" + state.networkNextRequestId++,\n      timestamp: new Date().toISOString()\n    };\n    state.networkRequests.push(entry);\n    if (state.networkHar.active) state.networkHar.entries.push(entry);\n    return entry;\n  };\n  if (!state.consoleWrapped) {\n    for (const level of [\"log\", \"info\", \"warn\", \"error\"]) {\n      console[level] = (...args) => {\n        state.consoleEntries.push({\n          level,\n          message: args.map((value) => normalize(value)).join(\" \"),\n          timestamp: new Date().toISOString()\n        });\n      };\n    }\n    state.consoleWrapped = true;\n  }\n  if (!state.dialogWrapped) {\n    window.alert = (message) => {\n      state.dialog = { defaultValue: null, message: String(message ?? \"\"), open: true, type: \"alert\" };\n    };\n    window.confirm = (message) => {\n      state.dialog = { defaultValue: null, message: String(message ?? \"\"), open: true, type: \"confirm\" };\n      return false;\n    };\n    window.prompt = (message, defaultValue) => {\n      state.dialog = {\n        defaultValue: defaultValue ?? null,\n        message: String(message ?? \"\"),\n        open: true,\n        type: \"prompt\"\n      };\n      return null;\n    };\n    state.dialogWrapped = true;\n  }\n  if (!state.fetchWrapped) {\n    state.originalFetch = window.fetch ? window.fetch.bind(window) : null;\n    window.fetch = async (input, init = {}) => {\n      const inputUrl =\n        typeof input === \"string\"\n          ? input\n          : input instanceof URL\n            ? input.toString()\n            : typeof input?.url === \"string\"\n              ? input.url\n              : String(input);\n      const url = new URL(inputUrl, location.href).toString();\n      if (state.settings.offline) {\n        recordRequest({\n          matchedRoute: null,\n          method: String(init.method || \"GET\").toUpperCase(),\n          resourceType: \"fetch\",\n          responseBody: null,\n          responseHeaders: {},\n          status: 0,\n          url\n        });\n        throw new Error(\"Browser workspace is offline.\");\n      }\n      const route = [...state.networkRoutes].reverse().find((entry) => patternMatches(entry.pattern, url)) || null;\n      if (route && route.abort) {\n        recordRequest({\n          matchedRoute: route.pattern,\n          method: String(init.method || \"GET\").toUpperCase(),\n          resourceType: \"fetch\",\n          responseBody: null,\n          responseHeaders: route.headers || {},\n          status: 0,\n          url\n        });\n        throw new Error(\"Browser workspace network route aborted request: \" + url);\n      }\n      if (route && (route.body !== null || route.status !== null || Object.keys(route.headers || {}).length > 0)) {\n        const response = new Response(route.body || \"\", {\n          headers: route.headers || {},\n          status: route.status || 200\n        });\n        recordRequest({\n          matchedRoute: route.pattern,\n          method: String(init.method || \"GET\").toUpperCase(),\n          resourceType: \"fetch\",\n          responseBody: route.body || \"\",\n          responseHeaders: route.headers || {},\n          status: route.status || 200,\n          url\n        });\n        return response;\n      }\n      const headers = new Headers(init.headers || {});\n      for (const [key, value] of Object.entries(state.settings.headers || {})) {\n        if (!headers.has(key)) headers.set(key, value);\n      }\n      if (state.settings.credentials && state.settings.credentials.username && !headers.has(\"Authorization\")) {\n        headers.set(\n          \"Authorization\",\n          \"Basic \" + btoa(state.settings.credentials.username + \":\" + state.settings.credentials.password)\n        );\n      }\n      const response = await state.originalFetch(url, { ...init, headers });\n      recordRequest({\n        matchedRoute: null,\n        method: String(init.method || \"GET\").toUpperCase(),\n        resourceType: \"fetch\",\n        responseBody: null,\n        responseHeaders: Object.fromEntries(response.headers.entries()),\n        status: response.status,\n        url: response.url || url\n      });\n      return response;\n    };\n    state.fetchWrapped = true;\n  }\n  Object.defineProperty(navigator, \"onLine\", {\n    configurable: true,\n    get: () => !state.settings.offline\n  });\n  switch (command.subaction) {\n    case \"clipboard\": {\n      const action = command.clipboardAction || \"read\";\n      if (action === \"read\") return state.clipboardText;\n      if (action === \"write\") {\n        state.clipboardText = command.value || command.text || \"\";\n        return state.clipboardText;\n      }\n      if (action === \"copy\") {\n        const target = resolveTarget();\n        state.clipboardText =\n          target && typeof target.value === \"string\"\n            ? String(target.value || \"\")\n            : normalize(target?.textContent || activeDocument.body?.textContent);\n        return state.clipboardText;\n      }\n      const target = resolveTarget();\n      if (target && typeof target.value === \"string\") {\n        target.value = String(target.value || \"\") + state.clipboardText;\n        target.setAttribute(\"value\", target.value);\n        return { selector: buildSelector(target), value: target.value };\n      }\n      return state.clipboardText;\n    }\n    case \"mouse\": {\n      const action = command.mouseAction || \"move\";\n      if (action === \"move\") {\n        state.mouse.x = typeof command.x === \"number\" ? command.x : state.mouse.x;\n        state.mouse.y = typeof command.y === \"number\" ? command.y : state.mouse.y;\n        return state.mouse;\n      }\n      if (action === \"down\") {\n        const button = command.button || \"left\";\n        state.mouse.buttons = Array.from(new Set([...(state.mouse.buttons || []), button]));\n        return state.mouse;\n      }\n      if (action === \"up\") {\n        const button = command.button || \"left\";\n        state.mouse.buttons = (state.mouse.buttons || []).filter((entry) => entry !== button);\n        return state.mouse;\n      }\n      window.scrollBy(command.deltaX || 0, command.deltaY || command.pixels || 240);\n      return { axis: Math.abs(command.deltaY || 0) >= Math.abs(command.deltaX || 0) ? \"y\" : \"x\", value: window.scrollY };\n    }\n    case \"drag\": {\n      const source = resolveTarget();\n      const target = command.value ? queryOne(command.value) : null;\n      if (!source || !target) throw new Error(\"Eliza browser workspace drag requires source selector and target selector in value.\");\n      source.setAttribute(\"data-eliza-dragging\", \"true\");\n      target.setAttribute(\"data-eliza-drop-target\", \"true\");\n      return { source: buildSelector(source), target: buildSelector(target) };\n    }\n    case \"upload\": {\n      const target = resolveTarget();\n      if (!target || target.tagName !== \"INPUT\") throw new Error(\"Eliza browser workspace upload requires a file input target.\");\n      const files = Array.isArray(command.files) ? command.files.map((entry) => String(entry).split(/[\\\\\\\\/]/).pop()) : [];\n      target.setAttribute(\"data-eliza-uploaded-files\", files.join(\",\"));\n      return { files, selector: buildSelector(target) };\n    }\n    case \"set\": {\n      const action = command.setAction || \"viewport\";\n      if (action === \"viewport\") {\n        state.settings.viewport = { width: command.width || 1280, height: command.height || 720, scale: command.scale || 1 };\n      } else if (action === \"device\") {\n        state.settings.device = command.device || null;\n      } else if (action === \"geo\") {\n        state.settings.geo =\n          typeof command.latitude === \"number\" && typeof command.longitude === \"number\"\n            ? { latitude: command.latitude, longitude: command.longitude }\n            : null;\n      } else if (action === \"offline\") {\n        state.settings.offline = Boolean(command.offline);\n      } else if (action === \"headers\") {\n        state.settings.headers = command.headers || {};\n      } else if (action === \"credentials\") {\n        state.settings.credentials =\n          command.username || command.password\n            ? { username: command.username || \"\", password: command.password || \"\" }\n            : null;\n      } else if (action === \"media\") {\n        state.settings.media = command.media || null;\n      }\n      return state.settings;\n    }\n    case \"cookies\": {\n      const action = command.cookieAction || \"get\";\n      if (action === \"clear\") {\n        const current = document.cookie || \"\";\n        current.split(/;\\\\s*/).forEach((entry) => {\n          const name = entry.split(\"=\")[0];\n          if (name) document.cookie = name + \"=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/\";\n        });\n        return { cleared: true };\n      }\n      if (action === \"set\") {\n        const name = command.name || command.entryKey;\n        if (!name) throw new Error(\"Eliza browser workspace cookies set requires name.\");\n        document.cookie = name + \"=\" + (command.value || \"\") + \"; path=/\";\n      }\n      const cookieString = document.cookie || \"\";\n      return Object.fromEntries(\n        cookieString\n          .split(/;\\\\s*/)\n          .filter(Boolean)\n          .map((entry) => {\n            const [name, ...rest] = entry.split(\"=\");\n            return [name, rest.join(\"=\")];\n          })\n      );\n    }\n    case \"storage\": {\n      const storage = command.storageArea === \"session\" ? sessionStorage : localStorage;\n      const action = command.storageAction || \"get\";\n      if (action === \"clear\") {\n        storage.clear();\n        return { cleared: true };\n      }\n      if (action === \"set\") {\n        const key = command.entryKey || command.name;\n        if (!key) throw new Error(\"Eliza browser workspace storage set requires entryKey.\");\n        storage.setItem(key, command.value || \"\");\n      }\n      if (command.entryKey || command.name) {\n        return storage.getItem(command.entryKey || command.name);\n      }\n      const out = {};\n      for (let i = 0; i < storage.length; i += 1) {\n        const key = storage.key(i);\n        if (key) out[key] = storage.getItem(key) || \"\";\n      }\n      return out;\n    }\n    case \"network\": {\n      const action = command.networkAction || \"requests\";\n      if (action === \"route\") {\n        if (!command.url) throw new Error(\"Eliza browser workspace network route requires url pattern.\");\n        state.networkRoutes.push({\n          abort: Boolean(command.offline),\n          body: command.responseBody ?? null,\n          headers: command.responseHeaders || {},\n          pattern: command.url,\n          status: typeof command.responseStatus === \"number\" ? command.responseStatus : null\n        });\n        return state.networkRoutes;\n      }\n      if (action === \"unroute\") {\n        state.networkRoutes = command.url\n          ? state.networkRoutes.filter((entry) => entry.pattern !== command.url)\n          : [];\n        return state.networkRoutes;\n      }\n      if (action === \"request\") {\n        return state.networkRequests.find((entry) => entry.id === command.requestId) || null;\n      }\n      if (action === \"harstart\") {\n        state.networkHar = { active: true, entries: [], startedAt: new Date().toISOString() };\n        return state.networkHar;\n      }\n      if (action === \"harstop\") {\n        state.networkHar.active = false;\n        return { log: { entries: state.networkHar.entries, startedAt: state.networkHar.startedAt } };\n      }\n      let requests = [...state.networkRequests];\n      if (command.filter) requests = requests.filter((entry) => entry.url.includes(command.filter));\n      if (command.method) requests = requests.filter((entry) => entry.method === String(command.method).toUpperCase());\n      if (command.status) requests = requests.filter((entry) => String(entry.status || \"\") === String(command.status));\n      return requests;\n    }\n    case \"dialog\": {\n      const action = command.dialogAction || \"status\";\n      if (action === \"status\") return state.dialog;\n      if (state.dialog) state.dialog.open = false;\n      const result =\n        action === \"accept\"\n          ? { accepted: true, dialog: state.dialog, promptText: command.promptText || command.value || null }\n          : { accepted: false, dialog: state.dialog };\n      state.dialog = null;\n      return result;\n    }\n    case \"console\":\n      if (command.consoleAction === \"clear\") state.consoleEntries = [];\n      return state.consoleEntries;\n    case \"errors\":\n      if (command.consoleAction === \"clear\") state.errors = [];\n      return state.errors;\n    case \"highlight\": {\n      const target = resolveTarget();\n      if (!target) throw new Error(\"Target element was not found.\");\n      target.setAttribute(\"data-eliza-highlight\", \"true\");\n      state.highlightedSelector = buildSelector(target);\n      return { selector: state.highlightedSelector };\n    }\n    case \"frame\": {\n      if ((command.frameAction || \"select\") === \"main\") {\n        state.currentFrame = null;\n        return { frame: null };\n      }\n      const frame = command.selector ? document.querySelector(command.selector) : null;\n      if (!frame || frame.tagName !== \"IFRAME\") throw new Error(\"Eliza browser workspace frame select requires an iframe selector.\");\n      state.currentFrame = buildSelector(frame);\n      return { frame: state.currentFrame };\n    }\n    default:\n      throw new Error(\"Unsupported desktop browser workspace utility subaction: \" + command.subaction);\n  }\n})()\n`.trim();\n}\n\nexport async function executeDesktopBrowserWorkspaceUtilityCommand(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv,\n): Promise<BrowserWorkspaceCommandResult> {\n  const id = await resolveDesktopBrowserWorkspaceTargetTabId(command, env);\n  if (\n    command.subaction === \"cookies\" ||\n    command.subaction === \"storage\" ||\n    (command.subaction === \"set\" &&\n      (command.setAction === \"credentials\" || command.setAction === \"headers\"))\n  ) {\n    await assertDesktopBrowserWorkspaceCanAccessProfileSecrets(\n      id,\n      env,\n      command.subaction,\n    );\n  }\n  const startedAt = Date.now();\n  const result = await evaluateBrowserWorkspaceTab(\n    {\n      id,\n      script: createDesktopBrowserWorkspaceUtilityScript({\n        ...command,\n        id,\n      }),\n    },\n    env,\n  );\n  const runtime = getBrowserWorkspaceRuntimeState(\"desktop\", id);\n  appendBrowserWorkspaceTraceEntry(runtime, {\n    subaction: command.subaction,\n    type: \"utility\",\n  });\n  appendBrowserWorkspaceProfilerEntry(runtime, {\n    durationMs: Date.now() - startedAt,\n    subaction: command.subaction,\n    type: \"utility\",\n  });\n  return {\n    mode: \"desktop\",\n    subaction: command.subaction,\n    value: result,\n  };\n}\n\nexport async function getDesktopBrowserWorkspaceSnapshotRecord(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv,\n): Promise<BrowserWorkspaceSnapshotRecord> {\n  const id = await resolveDesktopBrowserWorkspaceTargetTabId(command, env);\n  const result = await evaluateBrowserWorkspaceTab(\n    {\n      id,\n      script: `\n(() => {\n  const activeDocument = (() => {\n    const state = window.__elizaBrowserWorkspaceState || {};\n    if (!state.currentFrame) return document;\n    try {\n      const frame = document.querySelector(state.currentFrame);\n      return frame && frame.contentDocument ? frame.contentDocument : document;\n    } catch {\n      return document;\n    }\n  })();\n  const normalize = (value) => String(value ?? \"\").replace(/\\\\s+/g, \" \").trim();\n  const controlText = Array.from(activeDocument.querySelectorAll(\"input, textarea, select, option:checked\"))\n    .map((element) => {\n      const name = element.getAttribute(\"name\") || element.getAttribute(\"id\") || element.tagName.toLowerCase();\n      const value =\n        element.tagName === \"SELECT\"\n          ? element.value\n          : typeof element.value === \"string\"\n            ? element.value\n            : element.textContent || \"\";\n      return name + \":\" + normalize(value);\n    })\n    .filter(Boolean)\n    .join(\" \");\n  return {\n    bodyText: normalize((activeDocument.body?.textContent || \"\") + \" \" + controlText),\n    title: normalize(document.title),\n    url: location.href\n  };\n})()\n      `.trim(),\n    },\n    env,\n  );\n  return result as BrowserWorkspaceSnapshotRecord;\n}\n\nexport async function getDesktopBrowserWorkspaceSessionState(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv,\n): Promise<Record<string, unknown>> {\n  const id = await resolveDesktopBrowserWorkspaceTargetTabId(command, env);\n  await assertDesktopBrowserWorkspaceCanAccessProfileSecrets(id, env, \"state\");\n  const result = await evaluateBrowserWorkspaceTab(\n    {\n      id,\n      script: `\n(() => {\n  const state = window.__elizaBrowserWorkspaceState || {};\n  const readStorage = (storage) => {\n    const out = {};\n    for (let i = 0; i < storage.length; i += 1) {\n      const key = storage.key(i);\n      if (key) out[key] = storage.getItem(key) || \"\";\n    }\n    return out;\n  };\n  const cookies = Object.fromEntries(\n    String(document.cookie || \"\")\n      .split(/;\\\\s*/)\n      .filter(Boolean)\n      .map((entry) => {\n        const [name, ...rest] = entry.split(\"=\");\n        return [name, rest.join(\"=\")];\n      })\n  );\n  return {\n    clipboard: state.clipboardText || \"\",\n    cookies,\n    localStorage: readStorage(localStorage),\n    sessionStorage: readStorage(sessionStorage),\n    settings: state.settings || {},\n    url: location.href\n  };\n})()\n      `.trim(),\n    },\n    env,\n  );\n  return result as Record<string, unknown>;\n}\n\nexport async function loadDesktopBrowserWorkspaceSessionState(\n  command: BrowserWorkspaceCommand,\n  payload: Record<string, unknown>,\n  env: NodeJS.ProcessEnv,\n): Promise<void> {\n  const id = await resolveDesktopBrowserWorkspaceTargetTabId(command, env);\n  await assertDesktopBrowserWorkspaceCanAccessProfileSecrets(id, env, \"state\");\n  await evaluateBrowserWorkspaceTab(\n    {\n      id,\n      script: `\n(() => {\n  const payload = ${JSON.stringify(payload)};\n  const state =\n    window.__elizaBrowserWorkspaceState ||\n    (window.__elizaBrowserWorkspaceState = { settings: {} });\n  localStorage.clear();\n  for (const [key, value] of Object.entries(payload.localStorage || {})) {\n    localStorage.setItem(key, String(value ?? \"\"));\n  }\n  sessionStorage.clear();\n  for (const [key, value] of Object.entries(payload.sessionStorage || {})) {\n    sessionStorage.setItem(key, String(value ?? \"\"));\n  }\n  for (const [key, value] of Object.entries(payload.cookies || {})) {\n    document.cookie = key + \"=\" + String(value ?? \"\") + \"; path=/\";\n  }\n  state.clipboardText = typeof payload.clipboard === \"string\" ? payload.clipboard : \"\";\n  state.settings = typeof payload.settings === \"object\" && payload.settings ? payload.settings : state.settings;\n  return { loaded: true };\n})()\n      `.trim(),\n    },\n    env,\n  );\n}\n\nexport async function executeDesktopBrowserWorkspaceDomCommand(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv,\n): Promise<BrowserWorkspaceCommandResult> {\n  assertBrowserWorkspaceUserScriptAllowed(\n    command.script,\n    \"wait\",\n    \"desktop\",\n    env,\n  );\n  const id = await resolveDesktopBrowserWorkspaceTargetTabId(command, env);\n  const startedAt = Date.now();\n  command = resolveBrowserWorkspaceCommandElementRefs(command, \"desktop\", id);\n  const result = await evaluateBrowserWorkspaceTab(\n    {\n      id,\n      script: createDesktopBrowserWorkspaceCommandScript(\n        {\n          ...command,\n          id,\n        },\n        env,\n      ),\n    },\n    env,\n  );\n\n  if (command.subaction === \"inspect\" || command.subaction === \"snapshot\") {\n    const value =\n      result && typeof result === \"object\" && !Array.isArray(result)\n        ? (result as {\n            bodyText?: string;\n            elements?: BrowserWorkspaceDomElementSummary[];\n          })\n        : null;\n    const elements = registerBrowserWorkspaceElementRefs(\n      \"desktop\",\n      id,\n      Array.isArray(value?.elements) ? value.elements : [],\n    );\n    return {\n      mode: \"desktop\",\n      subaction: command.subaction,\n      elements,\n      value: result,\n    };\n  }\n\n  const runtime = getBrowserWorkspaceRuntimeState(\"desktop\", id);\n  appendBrowserWorkspaceTraceEntry(runtime, {\n    subaction: command.subaction,\n    type: \"dom\",\n  });\n  appendBrowserWorkspaceProfilerEntry(runtime, {\n    durationMs: Date.now() - startedAt,\n    subaction: command.subaction,\n    type: \"dom\",\n  });\n  return {\n    mode: \"desktop\",\n    subaction: command.subaction,\n    value:\n      result && typeof result === \"object\" && !Array.isArray(result)\n        ? ((result as { value?: unknown }).value ?? result)\n        : result,\n  };\n}\n\n// --- Desktop tab resolution ---\n\nexport function resolveBrowserWorkspaceCurrentTab(\n  tabs: BrowserWorkspaceTab[],\n): BrowserWorkspaceTab | null {\n  if (tabs.length === 0) {\n    return null;\n  }\n\n  return (\n    tabs.find((tab) => tab.visible) ??\n    [...tabs].sort((left, right) => {\n      const leftTime = left.lastFocusedAt ?? left.updatedAt ?? \"\";\n      const rightTime = right.lastFocusedAt ?? right.updatedAt ?? \"\";\n      return (\n        rightTime.localeCompare(leftTime) || left.id.localeCompare(right.id)\n      );\n    })[0] ??\n    null\n  );\n}\n\nexport async function resolveDesktopBrowserWorkspaceTargetTabId(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv,\n): Promise<string> {\n  if (command.id?.trim()) {\n    return command.id.trim();\n  }\n\n  // This function is only called on desktop-bridge paths where the\n  // Electrobun HTTP bridge is configured. Calling `listBrowserWorkspaceTabs`\n  // from `browser-workspace.ts` here would create a compile-time circular\n  // dependency (browser-workspace → desktop → browser-workspace); the web\n  // fallback in that function is also not reachable from these call sites.\n  // Query the bridge directly and avoid the circular detour.\n  const payload = await requestBrowserWorkspace<{\n    tabs?: BrowserWorkspaceTab[];\n  }>(\"/tabs\", undefined, env);\n  const tabs = Array.isArray(payload.tabs) ? payload.tabs : [];\n  const current = resolveBrowserWorkspaceCurrentTab(tabs);\n  if (!current) {\n    throw createBrowserWorkspaceCommandTargetError(command.subaction);\n  }\n  return current.id;\n}\n"],"mappings":"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A;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YA8oB/B,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuH1B,KAAK;AACP;AAEO,SAAS,2CACd,SACQ;AACR,SAAO;AAAA;AAAA,oBAEW,KAAK,UAAU,OAAO,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6azC,KAAK;AACP;AAEA,eAAsB,6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","names":[]}
+{"version":3,"sources":["../../src/workspace/browser-workspace-desktop.ts"],"sourcesContent":["import { createBrowserWorkspaceError } from \"./browser-workspace-errors.js\";\nimport {\n  assertBrowserWorkspaceConnectorSecretsNotExported,\n  assertBrowserWorkspaceUserScriptAllowed,\n  createBrowserWorkspaceCommandTargetError,\n  DEFAULT_TIMEOUT_MS,\n  isBrowserWorkspaceUserScriptAllowed,\n  normalizeEnvValue,\n  resolveBrowserWorkspaceCommandElementRefs,\n} from \"./browser-workspace-helpers.js\";\nimport {\n  appendBrowserWorkspaceProfilerEntry,\n  appendBrowserWorkspaceTraceEntry,\n  getBrowserWorkspaceRuntimeState,\n  registerBrowserWorkspaceElementRefs,\n} from \"./browser-workspace-state.js\";\nimport type {\n  BrowserWorkspaceBridgeConfig,\n  BrowserWorkspaceCommand,\n  BrowserWorkspaceCommandResult,\n  BrowserWorkspaceDomElementSummary,\n  BrowserWorkspaceSnapshotRecord,\n  BrowserWorkspaceTab,\n  EvaluateBrowserWorkspaceTabRequest,\n} from \"./browser-workspace-types.js\";\n\nasync function assertDesktopBrowserWorkspaceCanAccessProfileSecrets(\n  id: string,\n  env: NodeJS.ProcessEnv,\n  operation: string,\n): Promise<void> {\n  const payload = await requestBrowserWorkspace<{\n    tabs?: BrowserWorkspaceTab[];\n  }>(\"/tabs\", undefined, env);\n  const tab = payload.tabs?.find((entry) => entry.id === id) ?? null;\n  assertBrowserWorkspaceConnectorSecretsNotExported(tab?.partition, operation);\n}\n\nasync function readErrorBody(response: Response): Promise<string> {\n  try {\n    return (await response.text()).trim().slice(0, 240);\n  } catch {\n    return \"\";\n  }\n}\n\nexport function resolveBrowserWorkspaceBridgeConfig(\n  env: NodeJS.ProcessEnv = process.env,\n): BrowserWorkspaceBridgeConfig | null {\n  const baseUrl = normalizeEnvValue(env.ELIZA_BROWSER_WORKSPACE_URL);\n  if (!baseUrl) {\n    return null;\n  }\n\n  return {\n    baseUrl: baseUrl.replace(/\\/{1,1024}$/, \"\"),\n    token: normalizeEnvValue(env.ELIZA_BROWSER_WORKSPACE_TOKEN),\n  };\n}\n\nexport function isBrowserWorkspaceBridgeConfigured(\n  env: NodeJS.ProcessEnv = process.env,\n): boolean {\n  return resolveBrowserWorkspaceBridgeConfig(env) !== null;\n}\n\nexport function getBrowserWorkspaceUnavailableMessage(): string {\n  return \"Eliza browser workspace desktop bridge is unavailable.\";\n}\n\nexport async function requestBrowserWorkspace<T>(\n  path: string,\n  init?: RequestInit,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<T> {\n  const config = resolveBrowserWorkspaceBridgeConfig(env);\n  if (!config) {\n    throw createBrowserWorkspaceError(\n      \"desktop_only\",\n      \"desktop_bridge\",\n      getBrowserWorkspaceUnavailableMessage(),\n    );\n  }\n\n  const headers = new Headers(init?.headers ?? {});\n  headers.set(\"Accept\", \"application/json\");\n  if (!headers.has(\"Content-Type\") && init?.body) {\n    headers.set(\"Content-Type\", \"application/json\");\n  }\n  if (config.token) {\n    headers.set(\"Authorization\", `Bearer ${config.token}`);\n  }\n\n  const response = await fetch(`${config.baseUrl}${path}`, {\n    ...init,\n    headers,\n    signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),\n  });\n\n  if (!response.ok) {\n    const details = await readErrorBody(response);\n    const message = `Browser workspace request failed (${response.status})${details ? `: ${details}` : \"\"}`;\n    throw createBrowserWorkspaceError(\n      response.status === 404 ? \"tab_not_found\" : \"command_failed\",\n      path,\n      message,\n      details || undefined,\n      response.status,\n    );\n  }\n\n  return (await response.json()) as T;\n}\n\nexport async function evaluateBrowserWorkspaceTab(\n  request: EvaluateBrowserWorkspaceTabRequest,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<unknown> {\n  if (!isBrowserWorkspaceBridgeConfigured(env)) {\n    throw createBrowserWorkspaceError(\n      \"desktop_only\",\n      \"eval\",\n      \"Eliza browser workspace eval is only available in the desktop app.\",\n    );\n  }\n\n  const evalBody: { script: string; partition?: string } = {\n    script: request.script,\n  };\n  if (request.partition !== undefined) {\n    evalBody.partition = request.partition;\n  }\n\n  const payload = await requestBrowserWorkspace<{ result: unknown }>(\n    `/tabs/${encodeURIComponent(request.id)}/eval`,\n    {\n      method: \"POST\",\n      body: JSON.stringify(evalBody),\n    },\n    env,\n  );\n  return payload.result;\n}\n\nexport async function snapshotBrowserWorkspaceTab(\n  id: string,\n  env: NodeJS.ProcessEnv = process.env,\n): Promise<{ data: string }> {\n  if (!isBrowserWorkspaceBridgeConfigured(env)) {\n    throw createBrowserWorkspaceError(\n      \"desktop_only\",\n      \"snapshot\",\n      \"Eliza browser workspace snapshot is only available in the desktop app.\",\n    );\n  }\n\n  return await requestBrowserWorkspace<{ data: string }>(\n    `/tabs/${encodeURIComponent(id)}/snapshot`,\n    undefined,\n    env,\n  );\n}\n\nfunction desktopBrowserWorkspaceWaitScriptBranch(\n  env: NodeJS.ProcessEnv,\n): string {\n  if (isBrowserWorkspaceUserScriptAllowed(env)) {\n    return `\n          if (command.script) {\n            const fn = new Function(\"document\", \"window\", \"location\", \"return (\" + command.script + \");\");\n            if (fn(document, window, location)) {\n              resolve({ ok: true, script: true });\n              return;\n            }\n          }`;\n  }\n  return `\n          if (command.script) {\n            reject(new Error(\"Browser workspace wait script is disabled (GHSA-mhhr-9ph9-64j7).\"));\n            return;\n          }`;\n}\n\nexport function createDesktopBrowserWorkspaceCommandScript(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv = process.env,\n): string {\n  const waitScriptBranch = desktopBrowserWorkspaceWaitScriptBranch(env);\n  return `\n(() => {\n  const command = ${JSON.stringify(command)};\n  const normalize = (value) => String(value ?? \"\").replace(/\\\\s+/g, \" \").trim();\n  const textMatches = (candidate, wanted, exact = false) => {\n    const left = normalize(candidate).toLowerCase();\n    const right = normalize(wanted).toLowerCase();\n    if (!left || !right) return false;\n    return exact ? left === right : left.includes(right);\n  };\n  const selectorFor = (element) => {\n    if (!element) return \"\";\n    if (element.id) return \"#\" + element.id.replace(/[^a-zA-Z0-9_-]/g, \"\\\\\\\\$&\");\n    const testId = element.getAttribute?.(\"data-testid\");\n    if (testId) return \\`[data-testid=\"\\${testId}\"]\\`;\n    const name = element.getAttribute?.(\"name\");\n    if (name) return \\`\\${element.tagName.toLowerCase()}[name=\"\\${name}\"]\\`;\n    const type = element.getAttribute?.(\"type\");\n    if (type) return \\`\\${element.tagName.toLowerCase()}[type=\"\\${type}\"]\\`;\n    let index = 1;\n    let previous = element.previousElementSibling;\n    while (previous) {\n      if (previous.tagName === element.tagName) index += 1;\n      previous = previous.previousElementSibling;\n    }\n    return \\`\\${element.tagName.toLowerCase()}:nth-of-type(\\${index})\\`;\n  };\n  const serialize = (element) => {\n    const value =\n      element instanceof HTMLInputElement ||\n      element instanceof HTMLTextAreaElement ||\n      element instanceof HTMLSelectElement\n        ? element.value\n        : null;\n    return {\n      selector: selectorFor(element),\n      tag: element.tagName.toLowerCase(),\n      text: normalize(value ?? element.textContent),\n      type: element.getAttribute?.(\"type\"),\n      name: element.getAttribute?.(\"name\"),\n      href: element.getAttribute?.(\"href\"),\n      value: typeof value === \"string\" ? value : null,\n    };\n  };\n  const searchTexts = (element) => {\n    const labelText = element.id\n      ? Array.from(document.querySelectorAll('label[for=\"' + element.id + '\"]'))\n          .map((label) => label.textContent)\n          .join(\" \")\n      : \"\";\n    return [\n      element.textContent,\n      element.getAttribute?.(\"aria-label\"),\n      element.getAttribute?.(\"placeholder\"),\n      element.getAttribute?.(\"title\"),\n      element.getAttribute?.(\"name\"),\n      element.getAttribute?.(\"alt\"),\n      element.getAttribute?.(\"data-testid\"),\n      labelText,\n      element.value,\n    ]\n      .map((value) => normalize(value))\n      .filter(Boolean);\n  };\n  const isVisible = (element) => {\n    if (!element) return false;\n    if (element.hasAttribute?.(\"hidden\") || element.getAttribute?.(\"aria-hidden\") === \"true\") {\n      return false;\n    }\n    const style = element.style || {};\n    return style.display !== \"none\" && style.visibility !== \"hidden\";\n  };\n  const nativeRole = (element) => {\n    const explicit = element.getAttribute?.(\"role\")?.trim()?.toLowerCase();\n    if (explicit) return explicit;\n    const tag = element.tagName.toLowerCase();\n    if (tag === \"a\" && element.getAttribute?.(\"href\")) return \"link\";\n    if (tag === \"button\") return \"button\";\n    if (tag === \"select\") return \"combobox\";\n    if (tag === \"option\") return \"option\";\n    if (tag === \"textarea\") return \"textbox\";\n    if (tag === \"form\") return \"form\";\n    if (/^h[1-6]$/.test(tag)) return \"heading\";\n    if (tag === \"input\") {\n      const type = (element.type || \"text\").toLowerCase();\n      if (type === \"checkbox\") return \"checkbox\";\n      if (type === \"radio\") return \"radio\";\n      if ([\"button\", \"submit\", \"reset\", \"image\"].includes(type)) return \"button\";\n      return \"textbox\";\n    }\n    return null;\n  };\n  const findByText = (wanted) => {\n    const needle = normalize(wanted).toLowerCase();\n    if (!needle) return null;\n    const elements = Array.from(document.querySelectorAll(\n      \"a, button, input, textarea, select, option, label, h1, h2, h3, [role='button'], [data-testid]\"\n    ));\n    for (const element of elements) {\n      const haystacks = [\n        element.textContent,\n        element.getAttribute?.(\"aria-label\"),\n        element.getAttribute?.(\"placeholder\"),\n        element.getAttribute?.(\"title\"),\n        element.getAttribute?.(\"name\"),\n        element.value,\n      ]\n        .map((value) => normalize(value))\n        .filter(Boolean)\n        .map((value) => value.toLowerCase());\n      if (haystacks.some((value) => value.includes(needle))) {\n        return element;\n      }\n    }\n    return null;\n  };\n  const findByLabel = (wanted, exact = false) => {\n    const labels = Array.from(document.querySelectorAll(\"label\"));\n    for (const label of labels) {\n      if (!textMatches(label.textContent, wanted, exact)) continue;\n      const forId = label.getAttribute(\"for\");\n      if (forId) {\n        const explicit = document.getElementById(forId);\n        if (explicit) return explicit;\n      }\n      const nested = label.querySelector(\"input, textarea, select, button\");\n      if (nested) return nested;\n    }\n    return null;\n  };\n  const findByRole = (role, name, exact = false) => {\n    const candidates = Array.from(\n      document.querySelectorAll(\n        \"a, button, input, textarea, select, option, form, h1, h2, h3, h4, h5, h6, [role], [data-testid]\"\n      )\n    );\n    for (const candidate of candidates) {\n      if (nativeRole(candidate) !== role.trim().toLowerCase()) continue;\n      if (!name) return candidate;\n      if (searchTexts(candidate).some((value) => textMatches(value, name, exact))) {\n        return candidate;\n      }\n    }\n    return null;\n  };\n  const trimQuoted = (value) => {\n    const trimmed = String(value || \"\").trim();\n    const hasTextMatch = trimmed.match(/^has-text\\\\((?:\"([^\"]*)\"|'([^']*)')\\\\)$/i);\n    if (hasTextMatch?.[1] || hasTextMatch?.[2]) {\n      return (hasTextMatch[1] || hasTextMatch[2] || \"\").trim();\n    }\n    if (\n      (trimmed.startsWith('\"') && trimmed.endsWith('\"')) ||\n      (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\"))\n    ) {\n      return trimmed.slice(1, -1).trim();\n    }\n    return trimmed;\n  };\n  const normalizeSelectorSyntax = (selector) => {\n    let normalized = String(selector || \"\").trim();\n    normalized = normalized.replace(\n      /^role\\\\s*[:=]\\\\s*([a-z0-9_-]+)\\\\s+name\\\\s*[:=]\\\\s*(.+)$/i,\n      \"role=$1[name=$2]\"\n    );\n    normalized = normalized.replace(\n      /^((?:label|text|placeholder|alt|title|testid|data-testid)\\\\s*[:=]\\\\s*(?:has-text\\\\((?:\"[^\"]*\"|'[^']*')\\\\)|\"[^\"]+\"|'[^']+'|[^>]+?))\\\\s+((?:input|textarea|select)[\\\\s\\\\S]*)$/i,\n      \"$1 >> $2\"\n    );\n    return normalized;\n  };\n  const parseSemanticSelector = (selector) => {\n    const trimmed = normalizeSelectorSyntax(selector);\n    const match = trimmed.match(/^([a-z-]+)\\\\s*[:=]\\\\s*(.+)$/i);\n    if (!match) return null;\n    const kind = match[1]?.trim()?.toLowerCase();\n    const rawValue = match[2]?.trim() || \"\";\n    if (!kind || !rawValue) return null;\n    switch (kind) {\n      case \"alt\":\n        return { findBy: \"alt\", text: trimQuoted(rawValue) };\n      case \"css\":\n        return { selector: trimQuoted(rawValue) };\n      case \"data-testid\":\n      case \"testid\":\n        return { findBy: \"testid\", text: trimQuoted(rawValue) };\n      case \"label\":\n        return { findBy: \"label\", text: trimQuoted(rawValue) };\n      case \"placeholder\":\n        return { findBy: \"placeholder\", text: trimQuoted(rawValue) };\n      case \"role\": {\n        const roleMatch = rawValue.match(\n          /^([a-z0-9_-]+)(?:\\\\s*\\\\[\\\\s*name\\\\s*[:=]\\\\s*(.+?)\\\\s*\\\\])?$/i\n        );\n        if (!roleMatch?.[1]) return null;\n        return {\n          findBy: \"role\",\n          name: roleMatch[2] ? trimQuoted(roleMatch[2]) : undefined,\n          role: roleMatch[1].trim().toLowerCase(),\n        };\n      }\n      case \"text\":\n        return { findBy: \"text\", text: trimQuoted(rawValue) };\n      case \"title\":\n        return { findBy: \"title\", text: trimQuoted(rawValue) };\n      default:\n        return null;\n    }\n  };\n  const mergeSelectorCommand = (selector) => {\n    const parsed = parseSemanticSelector(selector);\n    if (!parsed) return null;\n    return { ...command, ...parsed, selector: parsed.selector };\n  };\n  const queryOne = (selector) => {\n    try {\n      return document.querySelector(selector);\n    } catch {\n      throw new Error(\"Invalid selector \" + selector);\n    }\n  };\n  const queryAll = (selector) => {\n    try {\n      return Array.from(document.querySelectorAll(selector));\n    } catch {\n      throw new Error(\"Invalid selector \" + selector);\n    }\n  };\n  const findSemantic = (targetCommand = command) => {\n    switch (targetCommand.findBy) {\n      case \"alt\":\n        return Array.from(document.querySelectorAll(\"[alt]\")).find((element) =>\n          textMatches(\n            element.getAttribute(\"alt\"),\n            targetCommand.text,\n            targetCommand.exact\n          )\n        ) || null;\n      case \"first\":\n        return targetCommand.selector ? queryOne(targetCommand.selector) : null;\n      case \"label\":\n        return targetCommand.text\n          ? findByLabel(targetCommand.text, targetCommand.exact)\n          : null;\n      case \"last\":\n        return targetCommand.selector\n          ? queryAll(targetCommand.selector).at(-1) || null\n          : null;\n      case \"nth\":\n        return targetCommand.selector && Number.isInteger(targetCommand.index)\n          ? queryAll(targetCommand.selector).at(targetCommand.index) || null\n          : null;\n      case \"placeholder\":\n        return Array.from(document.querySelectorAll(\"[placeholder]\")).find((element) =>\n          textMatches(\n            element.getAttribute(\"placeholder\"),\n            targetCommand.text,\n            targetCommand.exact\n          )\n        ) || null;\n      case \"role\":\n        return targetCommand.role\n          ? findByRole(\n              targetCommand.role,\n              targetCommand.name,\n              targetCommand.exact\n            )\n          : null;\n      case \"testid\":\n        return targetCommand.text\n          ? document.querySelector('[data-testid=\"' + targetCommand.text + '\"]')\n          : null;\n      case \"text\":\n        return targetCommand.text ? findByText(targetCommand.text) : null;\n      case \"title\":\n        return Array.from(document.querySelectorAll(\"[title]\")).find((element) =>\n          textMatches(\n            element.getAttribute(\"title\"),\n            targetCommand.text,\n            targetCommand.exact\n          )\n        ) || null;\n      default:\n        return null;\n    }\n  };\n  const findTarget = () => {\n    if (command.selector) {\n      const selectorChain = normalizeSelectorSyntax(command.selector)\n        .split(/s*>>s*/)\n        .map((segment) => segment.trim())\n        .filter(Boolean);\n      if (selectorChain.length > 1) {\n        let current = queryTarget(selectorChain[0]);\n        for (let index = 1; current && index < selectorChain.length; index += 1) {\n          const segment = selectorChain[index];\n          if (!segment) continue;\n          if (typeof current.matches === \"function\" && current.matches(segment)) {\n            continue;\n          }\n          if (\n            /^(input|textarea|select)(?:[[^]]+])?$/i.test(segment) &&\n            (current.tagName === \"INPUT\" ||\n              current.tagName === \"TEXTAREA\" ||\n              current.tagName === \"SELECT\")\n          ) {\n            continue;\n          }\n          current = queryOneWithin(current, segment);\n        }\n        return current;\n      }\n      return queryTarget(command.selector);\n    }\n    if (command.findBy) return findSemantic();\n    if (command.text) return findByText(command.text);\n    return null;\n  };\n  const queryOneWithin = (root, selector) => {\n    try {\n      return root.querySelector(selector);\n    } catch {\n      throw new Error(\"Invalid selector \" + selector);\n    }\n  };\n  const queryTarget = (selector) => {\n    const semantic = mergeSelectorCommand(selector);\n    if (semantic) return findSemantic(semantic);\n    return queryOne(selector);\n  };\n  const inspect = () =>\n    Array.from(\n      document.querySelectorAll(\n        \"a, button, input, textarea, select, form, [role='button'], [data-testid]\"\n      )\n    )\n      .slice(0, 40)\n      .map((element) => serialize(element));\n  const snapshot = () => ({\n    title: document.title,\n    url: location.href,\n    bodyText: normalize(document.body?.textContent).slice(0, 800),\n    elements: inspect(),\n  });\n  const setInputValue = (appendMode, target) => {\n    const element = target || findTarget();\n    if (!element) {\n      throw new Error(\"Target element was not found.\");\n    }\n    if (\n      !(\n        element instanceof HTMLInputElement ||\n        element instanceof HTMLTextAreaElement ||\n        element instanceof HTMLSelectElement\n      )\n    ) {\n      throw new Error(\"Target element is not an input, textarea, or select.\");\n    }\n    const nextValue = appendMode ? \\`\\${element.value ?? \"\"}\\${command.value ?? \"\"}\\` : (command.value ?? \"\");\n    element.value = nextValue;\n    element.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    element.dispatchEvent(new Event(\"change\", { bubbles: true }));\n    return { selector: selectorFor(element), value: element.value };\n  };\n  const setChecked = (targetValue) => {\n    const element = findTarget();\n    if (!element) throw new Error(\"Target element was not found.\");\n    if (!(element instanceof HTMLInputElement)) {\n      throw new Error(\"Target element is not a checkbox or radio input.\");\n    }\n    const type = (element.type || \"\").toLowerCase();\n    if (type !== \"checkbox\" && type !== \"radio\") {\n      throw new Error(\"Target element is not a checkbox or radio input.\");\n    }\n    element.checked = targetValue;\n    element.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    element.dispatchEvent(new Event(\"change\", { bubbles: true }));\n    return { checked: element.checked, selector: selectorFor(element) };\n  };\n  const setSelectValue = () => {\n    const element = findTarget();\n    if (!element) throw new Error(\"Target element was not found.\");\n    if (!(element instanceof HTMLSelectElement)) {\n      throw new Error(\"Target element is not a select.\");\n    }\n    const targetValue = command.value ?? \"\";\n    const option = Array.from(element.options).find(\n      (entry) =>\n        entry.value === targetValue || textMatches(entry.textContent, targetValue, true)\n    );\n    if (!option) {\n      throw new Error(\"Select option was not found.\");\n    }\n    element.value = option.value;\n    option.selected = true;\n    element.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    element.dispatchEvent(new Event(\"change\", { bubbles: true }));\n    return { selector: selectorFor(element), value: element.value };\n  };\n  const focusElement = (element) => {\n    if (!element) throw new Error(\"Target element was not found.\");\n    if (typeof element.focus === \"function\") {\n      element.focus();\n    }\n    return {\n      focused: document.activeElement === element,\n      selector: selectorFor(element),\n    };\n  };\n  const hoverElement = (element) => {\n    if (!element) throw new Error(\"Target element was not found.\");\n    element.setAttribute(\"data-eliza-hover\", \"true\");\n    return { hovered: true, selector: selectorFor(element) };\n  };\n  const activateElement = (subaction, element) => {\n    if (!element) throw new Error(\"Target element was not found.\");\n    if (subaction === \"dblclick\") {\n      element.dispatchEvent(new MouseEvent(\"dblclick\", { bubbles: true }));\n    }\n    if (typeof element.click === \"function\") {\n      element.click();\n    }\n    return {\n      clickCount: subaction === \"dblclick\" ? 2 : 1,\n      element: serialize(element),\n      url: location.href,\n    };\n  };\n  const ensureTabKit = () => {\n    const kit = window.__elizaTabKit;\n    if (!kit) {\n      throw new Error(\n        \"browser tab kit not installed (BROWSER_TAB_PRELOAD_SCRIPT missing)\",\n      );\n    }\n    return kit;\n  };\n  const runRealisticSubaction = (subaction) => {\n    const kit = ensureTabKit();\n    const cursorDuration = Number(command.cursorDurationMs) || 220;\n    if (subaction === \"cursor-hide\") {\n      kit.cursor.hide();\n      return { hidden: true };\n    }\n    if (subaction === \"cursor-move\") {\n      const x = Number(command.x);\n      const y = Number(command.y);\n      if (!Number.isFinite(x) || !Number.isFinite(y)) {\n        throw new Error(\"cursor-move requires x and y\");\n      }\n      kit.cursor.show();\n      return Promise.resolve(\n        kit.cursor.moveTo({ x: x, y: y }, { durationMs: cursorDuration }),\n      ).then(() => ({ x: x, y: y }));\n    }\n    if (subaction === \"realistic-press\") {\n      const target = findTarget() || document.activeElement || document.body;\n      const key = command.key || \"Enter\";\n      target.dispatchEvent(\n        new KeyboardEvent(\"keydown\", {\n          key: key,\n          bubbles: true,\n          cancelable: true,\n          composed: true,\n        }),\n      );\n      target.dispatchEvent(\n        new KeyboardEvent(\"keyup\", {\n          key: key,\n          bubbles: true,\n          cancelable: true,\n          composed: true,\n        }),\n      );\n      return { key: key, selector: selectorFor(target), url: location.href };\n    }\n    const element = findTarget();\n    if (!element) {\n      throw new Error(\"Target element was not found.\");\n    }\n    kit.cursor.show();\n    if (subaction === \"realistic-click\") {\n      kit.cursor.highlight(element);\n      return Promise.resolve(\n        kit.dispatchPointerSequence(element, { button: 0 }),\n      ).then(() => ({\n        element: serialize(element),\n        url: location.href,\n      }));\n    }\n    if (subaction === \"realistic-fill\" || subaction === \"realistic-type\") {\n      const value = command.value ?? command.text ?? \"\";\n      const replace = subaction === \"realistic-fill\" || command.replace === true;\n      const perCharDelayMs = Number(command.perCharDelayMs);\n      kit.cursor.highlight(element);\n      return Promise.resolve(\n        kit\n          .dispatchPointerSequence(element, { button: 0 })\n          .then(() =>\n            kit.typeRealistic(element, value, {\n              replace: replace,\n              perCharDelayMs: Number.isFinite(perCharDelayMs)\n                ? perCharDelayMs\n                : undefined,\n            }),\n          ),\n      ).then(() => ({\n        element: serialize(element),\n        value: element.value,\n      }));\n    }\n    if (subaction === \"realistic-upload\") {\n      const url = (command.files && command.files[0]) || command.url || command.value;\n      if (!url) {\n        throw new Error(\"realistic-upload requires files[0] or url\");\n      }\n      if (element.tagName !== \"INPUT\" || element.type !== \"file\") {\n        throw new Error(\"realistic-upload target must be input[type=file]\");\n      }\n      kit.cursor.highlight(element);\n      return Promise.resolve(kit.setFileInput(element, url, {})).then((info) => ({\n        element: serialize(element),\n        upload: info,\n      }));\n    }\n    throw new Error(\"Unsupported realistic subaction: \" + subaction);\n  };\n  const keyboardTarget = () => findTarget() || document.activeElement || document.body;\n  const keyboardWrite = (appendMode) => {\n    const target = keyboardTarget();\n    if (\n      !(\n        target instanceof HTMLInputElement ||\n        target instanceof HTMLTextAreaElement ||\n        target instanceof HTMLSelectElement\n      )\n    ) {\n      throw new Error(\"Keyboard text input requires an input, textarea, or select target.\");\n    }\n    return setInputValue(appendMode, target);\n  };\n  const keyPhase = (phase) => {\n    const target = keyboardTarget();\n    const key = command.key || \"Enter\";\n    target.dispatchEvent(new KeyboardEvent(phase, { key, bubbles: true }));\n    return { key, phase, selector: selectorFor(target) };\n  };\n  const scrollTarget = () => findTarget();\n  const scroll = () => {\n    const target = scrollTarget();\n    const direction = command.direction || \"down\";\n    const pixels = Math.max(1, Math.abs(Number(command.pixels) || 240));\n    const axis = direction === \"left\" || direction === \"right\" ? \"x\" : \"y\";\n    const delta = direction === \"up\" || direction === \"left\" ? -pixels : pixels;\n    if (target instanceof HTMLElement) {\n      if (axis === \"y\") {\n        target.scrollTop = (target.scrollTop || 0) + delta;\n        return { axis, selector: selectorFor(target), value: target.scrollTop };\n      }\n      target.scrollLeft = (target.scrollLeft || 0) + delta;\n      return { axis, selector: selectorFor(target), value: target.scrollLeft };\n    }\n    if (axis === \"y\") {\n      window.scrollBy(0, delta);\n      return { axis, selector: null, value: window.scrollY };\n    }\n    window.scrollBy(delta, 0);\n    return { axis, selector: null, value: window.scrollX };\n  };\n  const getResult = () => {\n    if (command.getMode === \"title\") return document.title;\n    if (command.getMode === \"url\") return location.href;\n    if (command.getMode === \"count\") {\n      if (!command.selector) throw new Error(\"count requires selector\");\n      const semantic = mergeSelectorCommand(command.selector);\n      return semantic ? Number(Boolean(findSemantic(semantic))) : queryAll(command.selector).length;\n    }\n    const element = findTarget();\n    if (!element) throw new Error(\"Target element was not found.\");\n    switch (command.getMode) {\n      case \"attr\":\n        if (!command.attribute) throw new Error(\"attr lookups require attribute\");\n        return element.getAttribute(command.attribute);\n      case \"box\":\n        return element.getBoundingClientRect();\n      case \"checked\":\n        return element instanceof HTMLInputElement\n          ? Boolean(element.checked)\n          : element instanceof HTMLOptionElement\n            ? Boolean(element.selected)\n            : false;\n      case \"enabled\":\n        return \"disabled\" in element ? !Boolean(element.disabled) : true;\n      case \"html\":\n        return element.innerHTML;\n      case \"styles\": {\n        const computed = getComputedStyle(element);\n        return {\n          display: computed.display || null,\n          visibility: computed.visibility || null,\n          opacity: computed.opacity || null,\n        };\n      }\n      case \"text\":\n        return normalize(element.textContent);\n      case \"value\":\n        return element.value ?? element.getAttribute?.(\"value\");\n      case \"visible\":\n        return isVisible(element);\n      default:\n        return normalize(element.textContent);\n    }\n  };\n  const waitForCondition = () =>\n    new Promise((resolve, reject) => {\n      if (\n        !command.selector &&\n        !command.findBy &&\n        !command.text &&\n        !command.url &&\n        !command.script &&\n        Number.isFinite(Number(command.timeoutMs))\n      ) {\n        const waitedMs = Math.max(0, Number(command.timeoutMs) || 0);\n        setTimeout(() => resolve({ ok: true, waitedMs }), waitedMs);\n        return;\n      }\n      const deadline = Date.now() + (Number(command.timeoutMs) || 4000);\n      const check = () => {\n        try {\n          if (command.selector) {\n            const found = findTarget();\n            const visible =\n              command.state === \"hidden\"\n                ? !found || !isVisible(found)\n                : found && isVisible(found);\n            if (visible) {\n              resolve({ ok: true, selector: command.selector, state: command.state || \"visible\" });\n              return;\n            }\n          }\n          if (command.findBy) {\n            const found = findSemantic();\n            if (command.state === \"hidden\" ? !found : found) {\n              resolve({ findBy: command.findBy, ok: true });\n              return;\n            }\n          }\n          if (command.text && normalize(document.body?.textContent).includes(command.text)) {\n            resolve({ ok: true, text: command.text });\n            return;\n          }\n          if (command.url && location.href.includes(command.url)) {\n            resolve({ ok: true, url: location.href });\n            return;\n          }\n          ${waitScriptBranch}\n          if (Date.now() >= deadline) {\n            reject(new Error(\"Timed out waiting for browser workspace condition.\"));\n            return;\n          }\n          setTimeout(check, 100);\n        } catch (error) {\n          reject(error);\n        }\n      };\n      check();\n    });\n\n  switch (command.subaction) {\n    case \"inspect\":\n      return { title: document.title, url: location.href, elements: inspect() };\n    case \"snapshot\":\n      return snapshot();\n    case \"get\":\n      return { value: getResult() };\n    case \"find\": {\n      const element = findTarget();\n      if (!element) throw new Error(\"Target element was not found.\");\n      switch (command.action) {\n        case \"check\":\n          return setChecked(true);\n        case \"click\":\n          return activateElement(\"click\", element);\n        case \"fill\":\n          return setInputValue(false, element);\n        case \"focus\":\n          return focusElement(element);\n        case \"hover\":\n          return hoverElement(element);\n        case \"text\":\n        case undefined:\n          return { element: serialize(element), value: normalize(element.textContent) };\n        case \"type\":\n          return setInputValue(true, element);\n        case \"uncheck\":\n          return setChecked(false);\n        default:\n          throw new Error(\"Unsupported find action.\");\n      }\n    }\n    case \"click\": {\n      const element = findTarget();\n      return activateElement(\"click\", element);\n    }\n    case \"dblclick\": {\n      const element = findTarget();\n      return activateElement(\"dblclick\", element);\n    }\n    case \"check\":\n      return setChecked(true);\n    case \"fill\":\n      return setInputValue(false);\n    case \"focus\": {\n      const element = findTarget();\n      return focusElement(element);\n    }\n    case \"hover\": {\n      const element = findTarget();\n      return hoverElement(element);\n    }\n    case \"keyboardinserttext\":\n      return keyboardWrite(false);\n    case \"keyboardtype\":\n      return keyboardWrite(true);\n    case \"keydown\":\n      return keyPhase(\"keydown\");\n    case \"keyup\":\n      return keyPhase(\"keyup\");\n    case \"type\":\n      return setInputValue(true);\n    case \"press\": {\n      const target = findTarget() ?? document.activeElement ?? document.body;\n      const key = command.key || \"Enter\";\n      target.dispatchEvent(new KeyboardEvent(\"keydown\", { key, bubbles: true }));\n      target.dispatchEvent(new KeyboardEvent(\"keyup\", { key, bubbles: true }));\n      return { key, url: location.href };\n    }\n    case \"realistic-click\":\n    case \"realistic-fill\":\n    case \"realistic-type\":\n    case \"realistic-press\":\n    case \"realistic-upload\":\n    case \"cursor-move\":\n    case \"cursor-hide\":\n      return runRealisticSubaction(command.subaction);\n    case \"scroll\":\n      return scroll();\n    case \"scrollinto\": {\n      const element = findTarget();\n      if (!element) throw new Error(\"Target element was not found.\");\n      if (typeof element.scrollIntoView === \"function\") {\n        element.scrollIntoView();\n      }\n      return { scrolled: true, selector: selectorFor(element) };\n    }\n    case \"select\":\n      return setSelectValue();\n    case \"uncheck\":\n      return setChecked(false);\n    case \"wait\":\n      return waitForCondition();\n    case \"back\":\n      history.back();\n      return { url: location.href, title: document.title };\n    case \"forward\":\n      history.forward();\n      return { url: location.href, title: document.title };\n    case \"reload\":\n      location.reload();\n      return { url: location.href, title: document.title };\n    default:\n      throw new Error(\\`Unsupported desktop browser subaction: \\${command.subaction}\\`);\n  }\n})()\n`.trim();\n}\n\nexport function createDesktopBrowserWorkspaceUtilityScript(\n  command: BrowserWorkspaceCommand,\n): string {\n  return `\n(() => {\n  const command = ${JSON.stringify(command)};\n  const normalize = (value) => String(value ?? \"\").replace(/\\\\s+/g, \" \").trim();\n  const state =\n    window.__elizaBrowserWorkspaceState ||\n    (window.__elizaBrowserWorkspaceState = {\n      clipboardText: \"\",\n      consoleEntries: [],\n      currentFrame: null,\n      dialog: null,\n      errors: [],\n      highlightedSelector: null,\n      mouse: { buttons: [], x: 0, y: 0 },\n      networkHar: { active: false, entries: [], startedAt: null },\n      networkNextRequestId: 1,\n      networkRequests: [],\n      networkRoutes: [],\n      settings: {\n        credentials: null,\n        device: null,\n        geo: null,\n        headers: {},\n        media: null,\n        offline: false,\n        viewport: null\n      }\n    });\n  const patternMatches = (pattern, value) => {\n    const trimmed = String(pattern ?? \"\").trim();\n    if (!trimmed) return false;\n    if (!trimmed.includes(\"*\")) return String(value ?? \"\").includes(trimmed);\n    let wildcard = \"\";\n    for (let i = 0; i < trimmed.length; i += 1) {\n      const char = trimmed[i];\n      if (char === \"*\") {\n        if (trimmed[i + 1] === \"*\") {\n          wildcard += \".*\";\n          i += 1;\n        } else {\n          wildcard += \".*\";\n        }\n      } else {\n        wildcard += char.replace(/[|\\\\\\\\{}()[\\\\]^$+?.]/g, \"\\\\\\\\$&\");\n      }\n    }\n    return new RegExp(\"^\" + wildcard + \"$\", \"i\").test(String(value ?? \"\"));\n  };\n  const buildSelector = (element) => {\n    if (!element || !element.tagName) return null;\n    const testId = element.getAttribute && element.getAttribute(\"data-testid\");\n    if (testId) return '[data-testid=\"' + testId + '\"]';\n    const name = element.getAttribute && element.getAttribute(\"name\");\n    if (name) return element.tagName.toLowerCase() + '[name=\"' + name + '\"]';\n    const title = element.getAttribute && element.getAttribute(\"title\");\n    if (title) return element.tagName.toLowerCase() + '[title=\"' + title + '\"]';\n    return element.tagName.toLowerCase();\n  };\n  const activeDocument = (() => {\n    if (!state.currentFrame) return document;\n    try {\n      const frame = document.querySelector(state.currentFrame);\n      return frame && frame.contentDocument ? frame.contentDocument : document;\n    } catch {\n      return document;\n    }\n  })();\n  const queryOne = (selector, root = activeDocument) => {\n    try {\n      return root.querySelector(selector);\n    } catch {\n      throw new Error(\"Invalid selector \" + selector);\n    }\n  };\n  const findByText = (needle) => {\n    const wanted = normalize(needle).toLowerCase();\n    if (!wanted) return null;\n    const candidates = Array.from(\n      activeDocument.querySelectorAll(\n        \"a, button, input, textarea, select, option, label, h1, h2, h3, [role='button'], [data-testid]\"\n      )\n    );\n    return (\n      candidates.find((element) => {\n        const haystacks = [\n          element.textContent,\n          element.getAttribute(\"aria-label\"),\n          element.getAttribute(\"placeholder\"),\n          element.getAttribute(\"title\"),\n          element.getAttribute(\"name\"),\n          element.value\n        ]\n          .map((value) => normalize(value).toLowerCase())\n          .filter(Boolean);\n        return haystacks.some((value) => value.includes(wanted));\n      }) || null\n    );\n  };\n  const resolveTarget = () => {\n    if (command.selector) return queryOne(command.selector);\n    if (command.text) return findByText(command.text);\n    return activeDocument.activeElement || activeDocument.body;\n  };\n  const recordRequest = (request) => {\n    const entry = {\n      ...request,\n      id: \"req_\" + state.networkNextRequestId++,\n      timestamp: new Date().toISOString()\n    };\n    state.networkRequests.push(entry);\n    if (state.networkHar.active) state.networkHar.entries.push(entry);\n    return entry;\n  };\n  if (!state.consoleWrapped) {\n    for (const level of [\"log\", \"info\", \"warn\", \"error\"]) {\n      console[level] = (...args) => {\n        state.consoleEntries.push({\n          level,\n          message: args.map((value) => normalize(value)).join(\" \"),\n          timestamp: new Date().toISOString()\n        });\n      };\n    }\n    state.consoleWrapped = true;\n  }\n  if (!state.dialogWrapped) {\n    window.alert = (message) => {\n      state.dialog = { defaultValue: null, message: String(message ?? \"\"), open: true, type: \"alert\" };\n    };\n    window.confirm = (message) => {\n      state.dialog = { defaultValue: null, message: String(message ?? \"\"), open: true, type: \"confirm\" };\n      return false;\n    };\n    window.prompt = (message, defaultValue) => {\n      state.dialog = {\n        defaultValue: defaultValue ?? null,\n        message: String(message ?? \"\"),\n        open: true,\n        type: \"prompt\"\n      };\n      return null;\n    };\n    state.dialogWrapped = true;\n  }\n  if (!state.fetchWrapped) {\n    state.originalFetch = window.fetch ? window.fetch.bind(window) : null;\n    window.fetch = async (input, init = {}) => {\n      const inputUrl =\n        typeof input === \"string\"\n          ? input\n          : input instanceof URL\n            ? input.toString()\n            : typeof input?.url === \"string\"\n              ? input.url\n              : String(input);\n      const url = new URL(inputUrl, location.href).toString();\n      if (state.settings.offline) {\n        recordRequest({\n          matchedRoute: null,\n          method: String(init.method || \"GET\").toUpperCase(),\n          resourceType: \"fetch\",\n          responseBody: null,\n          responseHeaders: {},\n          status: 0,\n          url\n        });\n        throw new Error(\"Browser workspace is offline.\");\n      }\n      const route = [...state.networkRoutes].reverse().find((entry) => patternMatches(entry.pattern, url)) || null;\n      if (route && route.abort) {\n        recordRequest({\n          matchedRoute: route.pattern,\n          method: String(init.method || \"GET\").toUpperCase(),\n          resourceType: \"fetch\",\n          responseBody: null,\n          responseHeaders: route.headers || {},\n          status: 0,\n          url\n        });\n        throw new Error(\"Browser workspace network route aborted request: \" + url);\n      }\n      if (route && (route.body !== null || route.status !== null || Object.keys(route.headers || {}).length > 0)) {\n        const response = new Response(route.body || \"\", {\n          headers: route.headers || {},\n          status: route.status || 200\n        });\n        recordRequest({\n          matchedRoute: route.pattern,\n          method: String(init.method || \"GET\").toUpperCase(),\n          resourceType: \"fetch\",\n          responseBody: route.body || \"\",\n          responseHeaders: route.headers || {},\n          status: route.status || 200,\n          url\n        });\n        return response;\n      }\n      const headers = new Headers(init.headers || {});\n      for (const [key, value] of Object.entries(state.settings.headers || {})) {\n        if (!headers.has(key)) headers.set(key, value);\n      }\n      if (state.settings.credentials && state.settings.credentials.username && !headers.has(\"Authorization\")) {\n        headers.set(\n          \"Authorization\",\n          \"Basic \" + btoa(state.settings.credentials.username + \":\" + state.settings.credentials.password)\n        );\n      }\n      const response = await state.originalFetch(url, { ...init, headers });\n      recordRequest({\n        matchedRoute: null,\n        method: String(init.method || \"GET\").toUpperCase(),\n        resourceType: \"fetch\",\n        responseBody: null,\n        responseHeaders: Object.fromEntries(response.headers.entries()),\n        status: response.status,\n        url: response.url || url\n      });\n      return response;\n    };\n    state.fetchWrapped = true;\n  }\n  Object.defineProperty(navigator, \"onLine\", {\n    configurable: true,\n    get: () => !state.settings.offline\n  });\n  switch (command.subaction) {\n    case \"clipboard\": {\n      const action = command.clipboardAction || \"read\";\n      if (action === \"read\") return state.clipboardText;\n      if (action === \"write\") {\n        state.clipboardText = command.value || command.text || \"\";\n        return state.clipboardText;\n      }\n      if (action === \"copy\") {\n        const target = resolveTarget();\n        state.clipboardText =\n          target && typeof target.value === \"string\"\n            ? String(target.value || \"\")\n            : normalize(target?.textContent || activeDocument.body?.textContent);\n        return state.clipboardText;\n      }\n      const target = resolveTarget();\n      if (target && typeof target.value === \"string\") {\n        target.value = String(target.value || \"\") + state.clipboardText;\n        target.setAttribute(\"value\", target.value);\n        return { selector: buildSelector(target), value: target.value };\n      }\n      return state.clipboardText;\n    }\n    case \"mouse\": {\n      const action = command.mouseAction || \"move\";\n      if (action === \"move\") {\n        state.mouse.x = typeof command.x === \"number\" ? command.x : state.mouse.x;\n        state.mouse.y = typeof command.y === \"number\" ? command.y : state.mouse.y;\n        return state.mouse;\n      }\n      if (action === \"down\") {\n        const button = command.button || \"left\";\n        state.mouse.buttons = Array.from(new Set([...(state.mouse.buttons || []), button]));\n        return state.mouse;\n      }\n      if (action === \"up\") {\n        const button = command.button || \"left\";\n        state.mouse.buttons = (state.mouse.buttons || []).filter((entry) => entry !== button);\n        return state.mouse;\n      }\n      window.scrollBy(command.deltaX || 0, command.deltaY || command.pixels || 240);\n      return { axis: Math.abs(command.deltaY || 0) >= Math.abs(command.deltaX || 0) ? \"y\" : \"x\", value: window.scrollY };\n    }\n    case \"drag\": {\n      const source = resolveTarget();\n      const target = command.value ? queryOne(command.value) : null;\n      if (!source || !target) throw new Error(\"Eliza browser workspace drag requires source selector and target selector in value.\");\n      source.setAttribute(\"data-eliza-dragging\", \"true\");\n      target.setAttribute(\"data-eliza-drop-target\", \"true\");\n      return { source: buildSelector(source), target: buildSelector(target) };\n    }\n    case \"upload\": {\n      const target = resolveTarget();\n      if (!target || target.tagName !== \"INPUT\") throw new Error(\"Eliza browser workspace upload requires a file input target.\");\n      const files = Array.isArray(command.files) ? command.files.map((entry) => String(entry).split(/[\\\\\\\\/]/).pop()) : [];\n      target.setAttribute(\"data-eliza-uploaded-files\", files.join(\",\"));\n      return { files, selector: buildSelector(target) };\n    }\n    case \"set\": {\n      const action = command.setAction || \"viewport\";\n      if (action === \"viewport\") {\n        state.settings.viewport = { width: command.width || 1280, height: command.height || 720, scale: command.scale || 1 };\n      } else if (action === \"device\") {\n        state.settings.device = command.device || null;\n      } else if (action === \"geo\") {\n        state.settings.geo =\n          typeof command.latitude === \"number\" && typeof command.longitude === \"number\"\n            ? { latitude: command.latitude, longitude: command.longitude }\n            : null;\n      } else if (action === \"offline\") {\n        state.settings.offline = Boolean(command.offline);\n      } else if (action === \"headers\") {\n        state.settings.headers = command.headers || {};\n      } else if (action === \"credentials\") {\n        state.settings.credentials =\n          command.username || command.password\n            ? { username: command.username || \"\", password: command.password || \"\" }\n            : null;\n      } else if (action === \"media\") {\n        state.settings.media = command.media || null;\n      }\n      return state.settings;\n    }\n    case \"cookies\": {\n      const action = command.cookieAction || \"get\";\n      if (action === \"clear\") {\n        const current = document.cookie || \"\";\n        current.split(/;\\\\s*/).forEach((entry) => {\n          const name = entry.split(\"=\")[0];\n          if (name) document.cookie = name + \"=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/\";\n        });\n        return { cleared: true };\n      }\n      if (action === \"set\") {\n        const name = command.name || command.entryKey;\n        if (!name) throw new Error(\"Eliza browser workspace cookies set requires name.\");\n        document.cookie = name + \"=\" + (command.value || \"\") + \"; path=/\";\n      }\n      const cookieString = document.cookie || \"\";\n      return Object.fromEntries(\n        cookieString\n          .split(/;\\\\s*/)\n          .filter(Boolean)\n          .map((entry) => {\n            const [name, ...rest] = entry.split(\"=\");\n            return [name, rest.join(\"=\")];\n          })\n      );\n    }\n    case \"storage\": {\n      const storage = command.storageArea === \"session\" ? sessionStorage : localStorage;\n      const action = command.storageAction || \"get\";\n      if (action === \"clear\") {\n        storage.clear();\n        return { cleared: true };\n      }\n      if (action === \"set\") {\n        const key = command.entryKey || command.name;\n        if (!key) throw new Error(\"Eliza browser workspace storage set requires entryKey.\");\n        storage.setItem(key, command.value || \"\");\n      }\n      if (command.entryKey || command.name) {\n        return storage.getItem(command.entryKey || command.name);\n      }\n      const out = {};\n      for (let i = 0; i < storage.length; i += 1) {\n        const key = storage.key(i);\n        if (key) out[key] = storage.getItem(key) || \"\";\n      }\n      return out;\n    }\n    case \"network\": {\n      const action = command.networkAction || \"requests\";\n      if (action === \"route\") {\n        if (!command.url) throw new Error(\"Eliza browser workspace network route requires url pattern.\");\n        state.networkRoutes.push({\n          abort: Boolean(command.offline),\n          body: command.responseBody ?? null,\n          headers: command.responseHeaders || {},\n          pattern: command.url,\n          status: typeof command.responseStatus === \"number\" ? command.responseStatus : null\n        });\n        return state.networkRoutes;\n      }\n      if (action === \"unroute\") {\n        state.networkRoutes = command.url\n          ? state.networkRoutes.filter((entry) => entry.pattern !== command.url)\n          : [];\n        return state.networkRoutes;\n      }\n      if (action === \"request\") {\n        return state.networkRequests.find((entry) => entry.id === command.requestId) || null;\n      }\n      if (action === \"harstart\") {\n        state.networkHar = { active: true, entries: [], startedAt: new Date().toISOString() };\n        return state.networkHar;\n      }\n      if (action === \"harstop\") {\n        state.networkHar.active = false;\n        return { log: { entries: state.networkHar.entries, startedAt: state.networkHar.startedAt } };\n      }\n      let requests = [...state.networkRequests];\n      if (command.filter) requests = requests.filter((entry) => entry.url.includes(command.filter));\n      if (command.method) requests = requests.filter((entry) => entry.method === String(command.method).toUpperCase());\n      if (command.status) requests = requests.filter((entry) => String(entry.status || \"\") === String(command.status));\n      return requests;\n    }\n    case \"dialog\": {\n      const action = command.dialogAction || \"status\";\n      if (action === \"status\") return state.dialog;\n      if (state.dialog) state.dialog.open = false;\n      const result =\n        action === \"accept\"\n          ? { accepted: true, dialog: state.dialog, promptText: command.promptText || command.value || null }\n          : { accepted: false, dialog: state.dialog };\n      state.dialog = null;\n      return result;\n    }\n    case \"console\":\n      if (command.consoleAction === \"clear\") state.consoleEntries = [];\n      return state.consoleEntries;\n    case \"errors\":\n      if (command.consoleAction === \"clear\") state.errors = [];\n      return state.errors;\n    case \"highlight\": {\n      const target = resolveTarget();\n      if (!target) throw new Error(\"Target element was not found.\");\n      target.setAttribute(\"data-eliza-highlight\", \"true\");\n      state.highlightedSelector = buildSelector(target);\n      return { selector: state.highlightedSelector };\n    }\n    case \"frame\": {\n      if ((command.frameAction || \"select\") === \"main\") {\n        state.currentFrame = null;\n        return { frame: null };\n      }\n      const frame = command.selector ? document.querySelector(command.selector) : null;\n      if (!frame || frame.tagName !== \"IFRAME\") throw new Error(\"Eliza browser workspace frame select requires an iframe selector.\");\n      state.currentFrame = buildSelector(frame);\n      return { frame: state.currentFrame };\n    }\n    default:\n      throw new Error(\"Unsupported desktop browser workspace utility subaction: \" + command.subaction);\n  }\n})()\n`.trim();\n}\n\nexport async function executeDesktopBrowserWorkspaceUtilityCommand(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv,\n): Promise<BrowserWorkspaceCommandResult> {\n  const id = await resolveDesktopBrowserWorkspaceTargetTabId(command, env);\n  if (\n    command.subaction === \"cookies\" ||\n    command.subaction === \"storage\" ||\n    (command.subaction === \"set\" &&\n      (command.setAction === \"credentials\" || command.setAction === \"headers\"))\n  ) {\n    await assertDesktopBrowserWorkspaceCanAccessProfileSecrets(\n      id,\n      env,\n      command.subaction,\n    );\n  }\n  const startedAt = Date.now();\n  const result = await evaluateBrowserWorkspaceTab(\n    {\n      id,\n      script: createDesktopBrowserWorkspaceUtilityScript({\n        ...command,\n        id,\n      }),\n    },\n    env,\n  );\n  const runtime = getBrowserWorkspaceRuntimeState(\"desktop\", id);\n  appendBrowserWorkspaceTraceEntry(runtime, {\n    subaction: command.subaction,\n    type: \"utility\",\n  });\n  appendBrowserWorkspaceProfilerEntry(runtime, {\n    durationMs: Date.now() - startedAt,\n    subaction: command.subaction,\n    type: \"utility\",\n  });\n  return {\n    mode: \"desktop\",\n    subaction: command.subaction,\n    value: result,\n  };\n}\n\nexport async function getDesktopBrowserWorkspaceSnapshotRecord(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv,\n): Promise<BrowserWorkspaceSnapshotRecord> {\n  const id = await resolveDesktopBrowserWorkspaceTargetTabId(command, env);\n  const result = await evaluateBrowserWorkspaceTab(\n    {\n      id,\n      script: `\n(() => {\n  const activeDocument = (() => {\n    const state = window.__elizaBrowserWorkspaceState || {};\n    if (!state.currentFrame) return document;\n    try {\n      const frame = document.querySelector(state.currentFrame);\n      return frame && frame.contentDocument ? frame.contentDocument : document;\n    } catch {\n      return document;\n    }\n  })();\n  const normalize = (value) => String(value ?? \"\").replace(/\\\\s+/g, \" \").trim();\n  const controlText = Array.from(activeDocument.querySelectorAll(\"input, textarea, select, option:checked\"))\n    .map((element) => {\n      const name = element.getAttribute(\"name\") || element.getAttribute(\"id\") || element.tagName.toLowerCase();\n      const value =\n        element.tagName === \"SELECT\"\n          ? element.value\n          : typeof element.value === \"string\"\n            ? element.value\n            : element.textContent || \"\";\n      return name + \":\" + normalize(value);\n    })\n    .filter(Boolean)\n    .join(\" \");\n  return {\n    bodyText: normalize((activeDocument.body?.textContent || \"\") + \" \" + controlText),\n    title: normalize(document.title),\n    url: location.href\n  };\n})()\n      `.trim(),\n    },\n    env,\n  );\n  return result as BrowserWorkspaceSnapshotRecord;\n}\n\nexport async function getDesktopBrowserWorkspaceSessionState(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv,\n): Promise<Record<string, unknown>> {\n  const id = await resolveDesktopBrowserWorkspaceTargetTabId(command, env);\n  await assertDesktopBrowserWorkspaceCanAccessProfileSecrets(id, env, \"state\");\n  const result = await evaluateBrowserWorkspaceTab(\n    {\n      id,\n      script: `\n(() => {\n  const state = window.__elizaBrowserWorkspaceState || {};\n  const readStorage = (storage) => {\n    const out = {};\n    for (let i = 0; i < storage.length; i += 1) {\n      const key = storage.key(i);\n      if (key) out[key] = storage.getItem(key) || \"\";\n    }\n    return out;\n  };\n  const cookies = Object.fromEntries(\n    String(document.cookie || \"\")\n      .split(/;\\\\s*/)\n      .filter(Boolean)\n      .map((entry) => {\n        const [name, ...rest] = entry.split(\"=\");\n        return [name, rest.join(\"=\")];\n      })\n  );\n  return {\n    clipboard: state.clipboardText || \"\",\n    cookies,\n    localStorage: readStorage(localStorage),\n    sessionStorage: readStorage(sessionStorage),\n    settings: state.settings || {},\n    url: location.href\n  };\n})()\n      `.trim(),\n    },\n    env,\n  );\n  return result as Record<string, unknown>;\n}\n\nexport async function loadDesktopBrowserWorkspaceSessionState(\n  command: BrowserWorkspaceCommand,\n  payload: Record<string, unknown>,\n  env: NodeJS.ProcessEnv,\n): Promise<void> {\n  const id = await resolveDesktopBrowserWorkspaceTargetTabId(command, env);\n  await assertDesktopBrowserWorkspaceCanAccessProfileSecrets(id, env, \"state\");\n  await evaluateBrowserWorkspaceTab(\n    {\n      id,\n      script: `\n(() => {\n  const payload = ${JSON.stringify(payload)};\n  const state =\n    window.__elizaBrowserWorkspaceState ||\n    (window.__elizaBrowserWorkspaceState = { settings: {} });\n  localStorage.clear();\n  for (const [key, value] of Object.entries(payload.localStorage || {})) {\n    localStorage.setItem(key, String(value ?? \"\"));\n  }\n  sessionStorage.clear();\n  for (const [key, value] of Object.entries(payload.sessionStorage || {})) {\n    sessionStorage.setItem(key, String(value ?? \"\"));\n  }\n  for (const [key, value] of Object.entries(payload.cookies || {})) {\n    document.cookie = key + \"=\" + String(value ?? \"\") + \"; path=/\";\n  }\n  state.clipboardText = typeof payload.clipboard === \"string\" ? payload.clipboard : \"\";\n  state.settings = typeof payload.settings === \"object\" && payload.settings ? payload.settings : state.settings;\n  return { loaded: true };\n})()\n      `.trim(),\n    },\n    env,\n  );\n}\n\nexport async function executeDesktopBrowserWorkspaceDomCommand(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv,\n): Promise<BrowserWorkspaceCommandResult> {\n  assertBrowserWorkspaceUserScriptAllowed(\n    command.script,\n    \"wait\",\n    \"desktop\",\n    env,\n  );\n  const id = await resolveDesktopBrowserWorkspaceTargetTabId(command, env);\n  const startedAt = Date.now();\n  command = resolveBrowserWorkspaceCommandElementRefs(command, \"desktop\", id);\n  const result = await evaluateBrowserWorkspaceTab(\n    {\n      id,\n      script: createDesktopBrowserWorkspaceCommandScript(\n        {\n          ...command,\n          id,\n        },\n        env,\n      ),\n    },\n    env,\n  );\n\n  if (command.subaction === \"inspect\" || command.subaction === \"snapshot\") {\n    const value =\n      result && typeof result === \"object\" && !Array.isArray(result)\n        ? (result as {\n            bodyText?: string;\n            elements?: BrowserWorkspaceDomElementSummary[];\n          })\n        : null;\n    const elements = registerBrowserWorkspaceElementRefs(\n      \"desktop\",\n      id,\n      Array.isArray(value?.elements) ? value.elements : [],\n    );\n    return {\n      mode: \"desktop\",\n      subaction: command.subaction,\n      elements,\n      value: result,\n    };\n  }\n\n  const runtime = getBrowserWorkspaceRuntimeState(\"desktop\", id);\n  appendBrowserWorkspaceTraceEntry(runtime, {\n    subaction: command.subaction,\n    type: \"dom\",\n  });\n  appendBrowserWorkspaceProfilerEntry(runtime, {\n    durationMs: Date.now() - startedAt,\n    subaction: command.subaction,\n    type: \"dom\",\n  });\n  return {\n    mode: \"desktop\",\n    subaction: command.subaction,\n    value:\n      result && typeof result === \"object\" && !Array.isArray(result)\n        ? ((result as { value?: unknown }).value ?? result)\n        : result,\n  };\n}\n\n// --- Desktop tab resolution ---\n\nexport function resolveBrowserWorkspaceCurrentTab(\n  tabs: BrowserWorkspaceTab[],\n): BrowserWorkspaceTab | null {\n  if (tabs.length === 0) {\n    return null;\n  }\n\n  return (\n    tabs.find((tab) => tab.visible) ??\n    [...tabs].sort((left, right) => {\n      const leftTime = left.lastFocusedAt ?? left.updatedAt ?? \"\";\n      const rightTime = right.lastFocusedAt ?? right.updatedAt ?? \"\";\n      return (\n        rightTime.localeCompare(leftTime) || left.id.localeCompare(right.id)\n      );\n    })[0] ??\n    null\n  );\n}\n\nexport async function resolveDesktopBrowserWorkspaceTargetTabId(\n  command: BrowserWorkspaceCommand,\n  env: NodeJS.ProcessEnv,\n): Promise<string> {\n  if (command.id?.trim()) {\n    return command.id.trim();\n  }\n\n  // This function is only called on desktop-bridge paths where the\n  // Electrobun HTTP bridge is configured. Calling `listBrowserWorkspaceTabs`\n  // from `browser-workspace.ts` here would create a compile-time circular\n  // dependency (browser-workspace → desktop → browser-workspace); the web\n  // fallback in that function is also not reachable from these call sites.\n  // Query the bridge directly and avoid the circular detour.\n  const payload = await requestBrowserWorkspace<{\n    tabs?: BrowserWorkspaceTab[];\n  }>(\"/tabs\", undefined, env);\n  const tabs = Array.isArray(payload.tabs) ? payload.tabs : [];\n  const current = resolveBrowserWorkspaceCurrentTab(tabs);\n  if (!current) {\n    throw createBrowserWorkspaceCommandTargetError(command.subaction);\n  }\n  return current.id;\n}\n"],"mappings":"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AK,UAAU,OAAO,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YA8oB/B,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuH1B,KAAK;AACP;AAEO,SAAS,2CACd,SACQ;AACR,SAAO;AAAA;AAAA,oBAEW,KAAK,UAAU,OAAO,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAA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","names":[]}

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

@@ -0,0 +1,62 @@
+/**
+ * Structured browser-workspace error contract (issue #9476).
+ *
+ * The workspace command path (`executeBrowserWorkspaceCommand` and the helpers
+ * in `browser-workspace-helpers.ts`) throws bare `new Error(...)` for many
+ * distinct failure modes — an invalid URL, a missing tab, a desktop-only
+ * subaction, a forbidden user script, a connector secret-export attempt — so
+ * callers today must regex the human-readable message to react. This mirrors the
+ * CUA `screenshot-errors.ts` contract: a machine-readable
+ * {@link BrowserWorkspaceErrorCode} added **additively** via
+ * {@link tagBrowserWorkspaceError} (annotates the existing Error in place,
+ * preserving its identity/message) plus a pure {@link classifyBrowserWorkspaceErrorCode}
+ * that maps the well-known thrown-message shapes to a code — one testable source
+ * of truth. This increment is the contract + classifier only; wiring
+ * `tagBrowserWorkspaceError` into the `executeBrowserWorkspaceCommand` catch
+ * boundary is a follow-up.
+ */
+export type BrowserWorkspaceErrorCode = 
+/** URL rejected: not a valid URL, or not http/https. */
+"invalid_url"
+/** The referenced tab id does not exist (404). */
+ | "tab_not_found"
+/** The subaction needs a current/target tab and none was available. */
+ | "target_missing"
+/** The subaction is only available in the desktop app / bridge. */
+ | "desktop_only"
+/** Arbitrary user/JSDOM script execution is disabled (GHSA-mhhr-9ph9-64j7). */
+ | "script_forbidden"
+/** A connector session tried to export raw cookies/tokens/storage/state. */
+ | "connector_secret_export_forbidden"
+/** A snapshot element ref is stale/unknown (re-snapshot needed). */
+ | "unknown_element_ref"
+/** The operation exceeded its timeout. */
+ | "timeout"
+/** Any other workspace command failure. */
+ | "command_failed";
+/** An `Error` carrying a machine-readable {@link BrowserWorkspaceErrorCode}. */
+export interface BrowserWorkspaceError extends Error {
+    readonly browserWorkspaceErrorCode: BrowserWorkspaceErrorCode;
+    /** The workspace operation that failed (e.g. `navigate`, `eval`). */
+    readonly operation: string;
+    /** Underlying message, when this wraps a lower-level failure. */
+    readonly details?: string;
+    /** HTTP status from an upstream workspace bridge, when available. */
+    readonly status?: number;
+}
+export declare function isBrowserWorkspaceError(value: unknown): value is BrowserWorkspaceError;
+export declare function createBrowserWorkspaceError(code: BrowserWorkspaceErrorCode, operation: string, message: string, details?: string, status?: number): BrowserWorkspaceError;
+/**
+ * Map any thrown value to a {@link BrowserWorkspaceErrorCode} from the
+ * well-known message shapes the workspace helpers throw. Already-tagged errors
+ * return their own code. Pure — the single source of truth for the mapping.
+ */
+export declare function classifyBrowserWorkspaceErrorCode(error: unknown): BrowserWorkspaceErrorCode;
+/**
+ * Tag an existing thrown value with its {@link BrowserWorkspaceErrorCode} +
+ * operation, **in place and additively** (preserves the original Error identity
+ * and message). Idempotent: re-tagging keeps the first code. A non-Error value
+ * is wrapped in a fresh `BrowserWorkspaceError`.
+ */
+export declare function tagBrowserWorkspaceError(error: unknown, operation: string): BrowserWorkspaceError;
+//# sourceMappingURL=browser-workspace-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-workspace-errors.d.ts","sourceRoot":"","sources":["../../src/workspace/browser-workspace-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,yBAAyB;AACnC,wDAAwD;AACtD,aAAa;AACf,kDAAkD;GAChD,eAAe;AACjB,uEAAuE;GACrE,gBAAgB;AAClB,mEAAmE;GACjE,cAAc;AAChB,+EAA+E;GAC7E,kBAAkB;AACpB,4EAA4E;GAC1E,mCAAmC;AACrC,oEAAoE;GAClE,qBAAqB;AACvB,0CAA0C;GACxC,SAAS;AACX,2CAA2C;GACzC,gBAAgB,CAAC;AAErB,gFAAgF;AAChF,MAAM,WAAW,qBAAsB,SAAQ,KAAK;IAClD,QAAQ,CAAC,yBAAyB,EAAE,yBAAyB,CAAC;IAC9D,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAQD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAOhC;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,yBAAyB,EAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,qBAAqB,CAQvB;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,GACb,yBAAyB,CAuC3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,qBAAqB,CAavB"}