@elizaos/plugin-browser 2.0.0-alpha.9 → 2.0.3-beta.2

package/dist/bridge-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge-policy.ts"],"sourcesContent":["export const MAX_BROWSER_FOCUS_WINDOW_MS = 2 * 60 * 1000;\nexport const DEFAULT_BROWSER_COMPANION_PAIRING_TOKEN_TTL_MS =\n  30 * 24 * 60 * 60 * 1000;\n\ntype BrowserBridgeCompanionPairingTokenEnv = {\n  readonly [key: string]: string | undefined;\n};\n\nexport function resolveBrowserBridgeCompanionPairingTokenTtlMs(\n  env: BrowserBridgeCompanionPairingTokenEnv = process.env,\n): number {\n  const raw =\n    env.BROWSER_BRIDGE_COMPANION_TOKEN_TTL_MS ??\n    env.ELIZA_BROWSER_BRIDGE_COMPANION_TOKEN_TTL_MS;\n  if (typeof raw === \"string\" && raw.trim().length > 0) {\n    const parsed = Number(raw);\n    if (Number.isFinite(parsed) && parsed > 0) {\n      return Math.trunc(parsed);\n    }\n  }\n  return DEFAULT_BROWSER_COMPANION_PAIRING_TOKEN_TTL_MS;\n}\n\nexport function resolveBrowserBridgeCompanionPairingTokenExpiresAt(\n  nowMs = Date.now(),\n  env?: Parameters<typeof resolveBrowserBridgeCompanionPairingTokenTtlMs>[0],\n): string {\n  return new Date(\n    nowMs + resolveBrowserBridgeCompanionPairingTokenTtlMs(env),\n  ).toISOString();\n}\n\nexport function browserBridgeDomainFromUrl(url: string): string | null {\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n      return null;\n    }\n    const hostname = parsed.hostname.trim().toLowerCase().replace(/\\.+$/, \"\");\n    return hostname.length > 0 ? hostname : null;\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"AAAO,MAAM,8BAA8B,IAAI,KAAK;AAC7C,MAAM,iDACX,KAAK,KAAK,KAAK,KAAK;AAMf,SAAS,+CACd,MAA6C,QAAQ,KAC7C;AACR,QAAM,MACJ,IAAI,yCACJ,IAAI;AACN,MAAI,OAAO,QAAQ,YAAY,IAAI,KAAK,EAAE,SAAS,GAAG;AACpD,UAAM,SAAS,OAAO,GAAG;AACzB,QAAI,OAAO,SAAS,MAAM,KAAK,SAAS,GAAG;AACzC,aAAO,KAAK,MAAM,MAAM;AAAA,IAC1B;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,mDACd,QAAQ,KAAK,IAAI,GACjB,KACQ;AACR,SAAO,IAAI;AAAA,IACT,QAAQ,+CAA+C,GAAG;AAAA,EAC5D,EAAE,YAAY;AAChB;AAEO,SAAS,2BAA2B,KAA4B;AACrE,MAAI;AACF,UAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,QAAI,OAAO,aAAa,WAAW,OAAO,aAAa,UAAU;AAC/D,aAAO;AAAA,IACT;AACA,UAAM,WAAW,OAAO,SAAS,KAAK,EAAE,YAAY,EAAE,QAAQ,QAAQ,EAAE;AACxE,WAAO,SAAS,SAAS,IAAI,WAAW;AAAA,EAC1C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/bridge-readiness.d.ts

@@ -0,0 +1,16 @@
+import type { BrowserBridgeCompanionStatus, BrowserBridgePermissionState, BrowserBridgeSettings } from "./contracts.js";
+export declare const BROWSER_BRIDGE_RECENT_CONTACT_WINDOW_MS: number;
+export type BrowserBridgeReadinessState = "ready" | "disabled" | "tracking_off" | "paused" | "control_disabled" | "no_companion" | "stale" | "permission_blocked";
+export interface BrowserBridgeReadiness {
+    state: BrowserBridgeReadinessState;
+    ready: boolean;
+    connectedCompanions: BrowserBridgeCompanionStatus[];
+    recentConnectedCompanions: BrowserBridgeCompanionStatus[];
+    primaryCompanion: BrowserBridgeCompanionStatus | null;
+}
+export declare function isBrowserBridgePaused(settings: Pick<BrowserBridgeSettings, "pauseUntil">, nowMs?: number): boolean;
+export declare function browserBridgeCompanionIsRecent(companion: Pick<BrowserBridgeCompanionStatus, "lastSeenAt">, nowMs?: number, recentWindowMs?: number): boolean;
+export declare function browserBridgeSiteAccessReady(settings: Pick<BrowserBridgeSettings, "siteAccessMode" | "grantedOrigins">, permissions: BrowserBridgePermissionState): boolean;
+export declare function browserBridgePermissionsReady(settings: Pick<BrowserBridgeSettings, "siteAccessMode" | "grantedOrigins">, permissions: BrowserBridgePermissionState): boolean;
+export declare function resolveBrowserBridgeReadiness(settings: BrowserBridgeSettings, companions: readonly BrowserBridgeCompanionStatus[], nowMs?: number): BrowserBridgeReadiness;
+//# sourceMappingURL=bridge-readiness.d.ts.map

package/dist/bridge-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-readiness.d.ts","sourceRoot":"","sources":["../src/bridge-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,uCAAuC,QAAa,CAAC;AAElE,MAAM,MAAM,2BAA2B,GACnC,OAAO,GACP,UAAU,GACV,cAAc,GACd,QAAQ,GACR,kBAAkB,GAClB,cAAc,GACd,OAAO,GACP,oBAAoB,CAAC;AAEzB,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,2BAA2B,CAAC;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,EAAE,4BAA4B,EAAE,CAAC;IACpD,yBAAyB,EAAE,4BAA4B,EAAE,CAAC;IAC1D,gBAAgB,EAAE,4BAA4B,GAAG,IAAI,CAAC;CACvD;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,EACnD,KAAK,SAAa,GACjB,OAAO,CAMT;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,CAAC,4BAA4B,EAAE,YAAY,CAAC,EAC3D,KAAK,SAAa,EAClB,cAAc,SAA0C,GACvD,OAAO,CAMT;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,EAC1E,WAAW,EAAE,4BAA4B,GACxC,OAAO,CAeT;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,EAC1E,WAAW,EAAE,4BAA4B,GACxC,OAAO,CAOT;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,qBAAqB,EAC/B,UAAU,EAAE,SAAS,4BAA4B,EAAE,EACnD,KAAK,SAAa,GACjB,sBAAsB,CAqDxB"}

package/dist/bridge-readiness.js

@@ -0,0 +1,82 @@
+const BROWSER_BRIDGE_RECENT_CONTACT_WINDOW_MS = 5 * 6e4;
+function isBrowserBridgePaused(settings, nowMs = Date.now()) {
+  if (!settings.pauseUntil) {
+    return false;
+  }
+  const pauseUntilMs = Date.parse(settings.pauseUntil);
+  return Number.isFinite(pauseUntilMs) && pauseUntilMs > nowMs;
+}
+function browserBridgeCompanionIsRecent(companion, nowMs = Date.now(), recentWindowMs = BROWSER_BRIDGE_RECENT_CONTACT_WINDOW_MS) {
+  if (!companion.lastSeenAt) {
+    return false;
+  }
+  const lastSeenMs = Date.parse(companion.lastSeenAt);
+  return Number.isFinite(lastSeenMs) && nowMs - lastSeenMs < recentWindowMs;
+}
+function browserBridgeSiteAccessReady(settings, permissions) {
+  switch (settings.siteAccessMode) {
+    case "all_sites":
+      return permissions.allOrigins;
+    case "granted_sites":
+      return permissions.allOrigins || settings.grantedOrigins.length > 0 && permissions.grantedOrigins.length > 0;
+    case "current_site_only":
+      return permissions.activeTab;
+    default:
+      return false;
+  }
+}
+function browserBridgePermissionsReady(settings, permissions) {
+  return permissions.tabs && permissions.scripting && permissions.activeTab && browserBridgeSiteAccessReady(settings, permissions);
+}
+function resolveBrowserBridgeReadiness(settings, companions, nowMs = Date.now()) {
+  const connectedCompanions = companions.filter(
+    (companion) => companion.connectionState === "connected"
+  );
+  const recentConnectedCompanions = connectedCompanions.filter(
+    (companion) => browserBridgeCompanionIsRecent(companion, nowMs)
+  );
+  const primaryCompanion = recentConnectedCompanions[0] ?? connectedCompanions[0] ?? companions[0] ?? null;
+  const base = {
+    connectedCompanions,
+    recentConnectedCompanions,
+    primaryCompanion
+  };
+  if (!settings.enabled) {
+    return { ...base, ready: false, state: "disabled" };
+  }
+  if (settings.trackingMode === "off") {
+    return { ...base, ready: false, state: "tracking_off" };
+  }
+  if (isBrowserBridgePaused(settings, nowMs)) {
+    return { ...base, ready: false, state: "paused" };
+  }
+  if (!settings.allowBrowserControl) {
+    return { ...base, ready: false, state: "control_disabled" };
+  }
+  if (companions.length === 0) {
+    return { ...base, ready: false, state: "no_companion" };
+  }
+  if (connectedCompanions.length === 0 && companions.some(
+    (companion) => companion.connectionState === "permission_blocked"
+  )) {
+    return { ...base, ready: false, state: "permission_blocked" };
+  }
+  if (recentConnectedCompanions.length === 0) {
+    return { ...base, ready: false, state: "stale" };
+  }
+  if (recentConnectedCompanions.some(
+    (companion) => browserBridgePermissionsReady(settings, companion.permissions)
+  )) {
+    return { ...base, ready: true, state: "ready" };
+  }
+  return { ...base, ready: false, state: "permission_blocked" };
+}
+export {
+  BROWSER_BRIDGE_RECENT_CONTACT_WINDOW_MS,
+  browserBridgeCompanionIsRecent,
+  browserBridgePermissionsReady,
+  browserBridgeSiteAccessReady,
+  isBrowserBridgePaused,
+  resolveBrowserBridgeReadiness
+};
+//# sourceMappingURL=bridge-readiness.js.map

package/dist/bridge-readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge-readiness.ts"],"sourcesContent":["import type {\n  BrowserBridgeCompanionStatus,\n  BrowserBridgePermissionState,\n  BrowserBridgeSettings,\n} from \"./contracts.js\";\n\nexport const BROWSER_BRIDGE_RECENT_CONTACT_WINDOW_MS = 5 * 60_000;\n\nexport type BrowserBridgeReadinessState =\n  | \"ready\"\n  | \"disabled\"\n  | \"tracking_off\"\n  | \"paused\"\n  | \"control_disabled\"\n  | \"no_companion\"\n  | \"stale\"\n  | \"permission_blocked\";\n\nexport interface BrowserBridgeReadiness {\n  state: BrowserBridgeReadinessState;\n  ready: boolean;\n  connectedCompanions: BrowserBridgeCompanionStatus[];\n  recentConnectedCompanions: BrowserBridgeCompanionStatus[];\n  primaryCompanion: BrowserBridgeCompanionStatus | null;\n}\n\nexport function isBrowserBridgePaused(\n  settings: Pick<BrowserBridgeSettings, \"pauseUntil\">,\n  nowMs = Date.now(),\n): boolean {\n  if (!settings.pauseUntil) {\n    return false;\n  }\n  const pauseUntilMs = Date.parse(settings.pauseUntil);\n  return Number.isFinite(pauseUntilMs) && pauseUntilMs > nowMs;\n}\n\nexport function browserBridgeCompanionIsRecent(\n  companion: Pick<BrowserBridgeCompanionStatus, \"lastSeenAt\">,\n  nowMs = Date.now(),\n  recentWindowMs = BROWSER_BRIDGE_RECENT_CONTACT_WINDOW_MS,\n): boolean {\n  if (!companion.lastSeenAt) {\n    return false;\n  }\n  const lastSeenMs = Date.parse(companion.lastSeenAt);\n  return Number.isFinite(lastSeenMs) && nowMs - lastSeenMs < recentWindowMs;\n}\n\nexport function browserBridgeSiteAccessReady(\n  settings: Pick<BrowserBridgeSettings, \"siteAccessMode\" | \"grantedOrigins\">,\n  permissions: BrowserBridgePermissionState,\n): boolean {\n  switch (settings.siteAccessMode) {\n    case \"all_sites\":\n      return permissions.allOrigins;\n    case \"granted_sites\":\n      return (\n        permissions.allOrigins ||\n        (settings.grantedOrigins.length > 0 &&\n          permissions.grantedOrigins.length > 0)\n      );\n    case \"current_site_only\":\n      return permissions.activeTab;\n    default:\n      return false;\n  }\n}\n\nexport function browserBridgePermissionsReady(\n  settings: Pick<BrowserBridgeSettings, \"siteAccessMode\" | \"grantedOrigins\">,\n  permissions: BrowserBridgePermissionState,\n): boolean {\n  return (\n    permissions.tabs &&\n    permissions.scripting &&\n    permissions.activeTab &&\n    browserBridgeSiteAccessReady(settings, permissions)\n  );\n}\n\nexport function resolveBrowserBridgeReadiness(\n  settings: BrowserBridgeSettings,\n  companions: readonly BrowserBridgeCompanionStatus[],\n  nowMs = Date.now(),\n): BrowserBridgeReadiness {\n  const connectedCompanions = companions.filter(\n    (companion) => companion.connectionState === \"connected\",\n  );\n  const recentConnectedCompanions = connectedCompanions.filter((companion) =>\n    browserBridgeCompanionIsRecent(companion, nowMs),\n  );\n  const primaryCompanion =\n    recentConnectedCompanions[0] ??\n    connectedCompanions[0] ??\n    companions[0] ??\n    null;\n\n  const base = {\n    connectedCompanions,\n    recentConnectedCompanions,\n    primaryCompanion,\n  };\n\n  if (!settings.enabled) {\n    return { ...base, ready: false, state: \"disabled\" };\n  }\n  if (settings.trackingMode === \"off\") {\n    return { ...base, ready: false, state: \"tracking_off\" };\n  }\n  if (isBrowserBridgePaused(settings, nowMs)) {\n    return { ...base, ready: false, state: \"paused\" };\n  }\n  if (!settings.allowBrowserControl) {\n    return { ...base, ready: false, state: \"control_disabled\" };\n  }\n  if (companions.length === 0) {\n    return { ...base, ready: false, state: \"no_companion\" };\n  }\n  if (\n    connectedCompanions.length === 0 &&\n    companions.some(\n      (companion) => companion.connectionState === \"permission_blocked\",\n    )\n  ) {\n    return { ...base, ready: false, state: \"permission_blocked\" };\n  }\n  if (recentConnectedCompanions.length === 0) {\n    return { ...base, ready: false, state: \"stale\" };\n  }\n  if (\n    recentConnectedCompanions.some((companion) =>\n      browserBridgePermissionsReady(settings, companion.permissions),\n    )\n  ) {\n    return { ...base, ready: true, state: \"ready\" };\n  }\n  return { ...base, ready: false, state: \"permission_blocked\" };\n}\n"],"mappings":"AAMO,MAAM,0CAA0C,IAAI;AAoBpD,SAAS,sBACd,UACA,QAAQ,KAAK,IAAI,GACR;AACT,MAAI,CAAC,SAAS,YAAY;AACxB,WAAO;AAAA,EACT;AACA,QAAM,eAAe,KAAK,MAAM,SAAS,UAAU;AACnD,SAAO,OAAO,SAAS,YAAY,KAAK,eAAe;AACzD;AAEO,SAAS,+BACd,WACA,QAAQ,KAAK,IAAI,GACjB,iBAAiB,yCACR;AACT,MAAI,CAAC,UAAU,YAAY;AACzB,WAAO;AAAA,EACT;AACA,QAAM,aAAa,KAAK,MAAM,UAAU,UAAU;AAClD,SAAO,OAAO,SAAS,UAAU,KAAK,QAAQ,aAAa;AAC7D;AAEO,SAAS,6BACd,UACA,aACS;AACT,UAAQ,SAAS,gBAAgB;AAAA,IAC/B,KAAK;AACH,aAAO,YAAY;AAAA,IACrB,KAAK;AACH,aACE,YAAY,cACX,SAAS,eAAe,SAAS,KAChC,YAAY,eAAe,SAAS;AAAA,IAE1C,KAAK;AACH,aAAO,YAAY;AAAA,IACrB;AACE,aAAO;AAAA,EACX;AACF;AAEO,SAAS,8BACd,UACA,aACS;AACT,SACE,YAAY,QACZ,YAAY,aACZ,YAAY,aACZ,6BAA6B,UAAU,WAAW;AAEtD;AAEO,SAAS,8BACd,UACA,YACA,QAAQ,KAAK,IAAI,GACO;AACxB,QAAM,sBAAsB,WAAW;AAAA,IACrC,CAAC,cAAc,UAAU,oBAAoB;AAAA,EAC/C;AACA,QAAM,4BAA4B,oBAAoB;AAAA,IAAO,CAAC,cAC5D,+BAA+B,WAAW,KAAK;AAAA,EACjD;AACA,QAAM,mBACJ,0BAA0B,CAAC,KAC3B,oBAAoB,CAAC,KACrB,WAAW,CAAC,KACZ;AAEF,QAAM,OAAO;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,MAAI,CAAC,SAAS,SAAS;AACrB,WAAO,EAAE,GAAG,MAAM,OAAO,OAAO,OAAO,WAAW;AAAA,EACpD;AACA,MAAI,SAAS,iBAAiB,OAAO;AACnC,WAAO,EAAE,GAAG,MAAM,OAAO,OAAO,OAAO,eAAe;AAAA,EACxD;AACA,MAAI,sBAAsB,UAAU,KAAK,GAAG;AAC1C,WAAO,EAAE,GAAG,MAAM,OAAO,OAAO,OAAO,SAAS;AAAA,EAClD;AACA,MAAI,CAAC,SAAS,qBAAqB;AACjC,WAAO,EAAE,GAAG,MAAM,OAAO,OAAO,OAAO,mBAAmB;AAAA,EAC5D;AACA,MAAI,WAAW,WAAW,GAAG;AAC3B,WAAO,EAAE,GAAG,MAAM,OAAO,OAAO,OAAO,eAAe;AAAA,EACxD;AACA,MACE,oBAAoB,WAAW,KAC/B,WAAW;AAAA,IACT,CAAC,cAAc,UAAU,oBAAoB;AAAA,EAC/C,GACA;AACA,WAAO,EAAE,GAAG,MAAM,OAAO,OAAO,OAAO,qBAAqB;AAAA,EAC9D;AACA,MAAI,0BAA0B,WAAW,GAAG;AAC1C,WAAO,EAAE,GAAG,MAAM,OAAO,OAAO,OAAO,QAAQ;AAAA,EACjD;AACA,MACE,0BAA0B;AAAA,IAAK,CAAC,cAC9B,8BAA8B,UAAU,UAAU,WAAW;AAAA,EAC/D,GACA;AACA,WAAO,EAAE,GAAG,MAAM,OAAO,MAAM,OAAO,QAAQ;AAAA,EAChD;AACA,SAAO,EAAE,GAAG,MAAM,OAAO,OAAO,OAAO,qBAAqB;AAC9D;","names":[]}

package/dist/bridge-records.d.ts

@@ -0,0 +1,9 @@
+import type { BrowserBridgeCompanionStatus, BrowserBridgePageContext, BrowserBridgeTabSummary } from "./contracts.js";
+export declare function createBrowserBridgeCompanionStatus(params: Omit<BrowserBridgeCompanionStatus, "id" | "createdAt" | "updatedAt" | "pairedAt" | "pairingTokenExpiresAt" | "pairingTokenRevokedAt"> & {
+    pairedAt?: string | null;
+    pairingTokenExpiresAt?: string | null;
+    pairingTokenRevokedAt?: string | null;
+}): BrowserBridgeCompanionStatus;
+export declare function createBrowserBridgeTabSummary(params: Omit<BrowserBridgeTabSummary, "id" | "createdAt" | "updatedAt">): BrowserBridgeTabSummary;
+export declare function createBrowserBridgePageContext(params: Omit<BrowserBridgePageContext, "id">): BrowserBridgePageContext;
+//# sourceMappingURL=bridge-records.d.ts.map

package/dist/bridge-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-records.d.ts","sourceRoot":"","sources":["../src/bridge-records.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAMxB,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,IAAI,CACV,4BAA4B,EAC1B,IAAI,GACJ,WAAW,GACX,WAAW,GACX,UAAU,GACV,uBAAuB,GACvB,uBAAuB,CAC1B,GAAG;IACF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,GACA,4BAA4B,CAW9B;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GACtE,uBAAuB,CAQzB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,IAAI,CAAC,GAC3C,wBAAwB,CAK1B"}

package/dist/bridge-records.js

@@ -0,0 +1,37 @@
+import crypto from "node:crypto";
+function isoNow() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function createBrowserBridgeCompanionStatus(params) {
+  const timestamp = isoNow();
+  return {
+    ...params,
+    id: crypto.randomUUID(),
+    pairedAt: params.pairedAt ?? timestamp,
+    pairingTokenExpiresAt: params.pairingTokenExpiresAt ?? null,
+    pairingTokenRevokedAt: params.pairingTokenRevokedAt ?? null,
+    createdAt: timestamp,
+    updatedAt: timestamp
+  };
+}
+function createBrowserBridgeTabSummary(params) {
+  const timestamp = isoNow();
+  return {
+    ...params,
+    id: crypto.randomUUID(),
+    createdAt: timestamp,
+    updatedAt: timestamp
+  };
+}
+function createBrowserBridgePageContext(params) {
+  return {
+    ...params,
+    id: crypto.randomUUID()
+  };
+}
+export {
+  createBrowserBridgeCompanionStatus,
+  createBrowserBridgePageContext,
+  createBrowserBridgeTabSummary
+};
+//# sourceMappingURL=bridge-records.js.map

package/dist/bridge-records.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge-records.ts"],"sourcesContent":["import crypto from \"node:crypto\";\nimport type {\n  BrowserBridgeCompanionStatus,\n  BrowserBridgePageContext,\n  BrowserBridgeTabSummary,\n} from \"./contracts.js\";\n\nfunction isoNow(): string {\n  return new Date().toISOString();\n}\n\nexport function createBrowserBridgeCompanionStatus(\n  params: Omit<\n    BrowserBridgeCompanionStatus,\n    | \"id\"\n    | \"createdAt\"\n    | \"updatedAt\"\n    | \"pairedAt\"\n    | \"pairingTokenExpiresAt\"\n    | \"pairingTokenRevokedAt\"\n  > & {\n    pairedAt?: string | null;\n    pairingTokenExpiresAt?: string | null;\n    pairingTokenRevokedAt?: string | null;\n  },\n): BrowserBridgeCompanionStatus {\n  const timestamp = isoNow();\n  return {\n    ...params,\n    id: crypto.randomUUID(),\n    pairedAt: params.pairedAt ?? timestamp,\n    pairingTokenExpiresAt: params.pairingTokenExpiresAt ?? null,\n    pairingTokenRevokedAt: params.pairingTokenRevokedAt ?? null,\n    createdAt: timestamp,\n    updatedAt: timestamp,\n  };\n}\n\nexport function createBrowserBridgeTabSummary(\n  params: Omit<BrowserBridgeTabSummary, \"id\" | \"createdAt\" | \"updatedAt\">,\n): BrowserBridgeTabSummary {\n  const timestamp = isoNow();\n  return {\n    ...params,\n    id: crypto.randomUUID(),\n    createdAt: timestamp,\n    updatedAt: timestamp,\n  };\n}\n\nexport function createBrowserBridgePageContext(\n  params: Omit<BrowserBridgePageContext, \"id\">,\n): BrowserBridgePageContext {\n  return {\n    ...params,\n    id: crypto.randomUUID(),\n  };\n}\n"],"mappings":"AAAA,OAAO,YAAY;AAOnB,SAAS,SAAiB;AACxB,UAAO,oBAAI,KAAK,GAAE,YAAY;AAChC;AAEO,SAAS,mCACd,QAa8B;AAC9B,QAAM,YAAY,OAAO;AACzB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,IAAI,OAAO,WAAW;AAAA,IACtB,UAAU,OAAO,YAAY;AAAA,IAC7B,uBAAuB,OAAO,yBAAyB;AAAA,IACvD,uBAAuB,OAAO,yBAAyB;AAAA,IACvD,WAAW;AAAA,IACX,WAAW;AAAA,EACb;AACF;AAEO,SAAS,8BACd,QACyB;AACzB,QAAM,YAAY,OAAO;AACzB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,IAAI,OAAO,WAAW;AAAA,IACtB,WAAW;AAAA,IACX,WAAW;AAAA,EACb;AACF;AAEO,SAAS,+BACd,QAC0B;AAC1B,SAAO;AAAA,IACL,GAAG;AAAA,IACH,IAAI,OAAO,WAAW;AAAA,EACxB;AACF;","names":[]}

package/dist/browser-capture-hooks.d.ts

@@ -0,0 +1,9 @@
+import type { BrowserCaptureConfig } from "./workspace/browser-capture.js";
+export interface BrowserCaptureHooks {
+    frameFile: string;
+    startBrowserCapture(config: BrowserCaptureConfig): Promise<void>;
+    stopBrowserCapture(): Promise<void>;
+}
+export declare function registerBrowserCaptureHooks(hooks: BrowserCaptureHooks): void;
+export declare function getBrowserCaptureHooks(): BrowserCaptureHooks | null;
+//# sourceMappingURL=browser-capture-hooks.d.ts.map

package/dist/browser-capture-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-capture-hooks.d.ts","sourceRoot":"","sources":["../src/browser-capture-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAYD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAE5E;AAED,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,IAAI,CAEnE"}

package/dist/browser-capture-hooks.js

@@ -0,0 +1,15 @@
+const BROWSER_CAPTURE_HOOKS = /* @__PURE__ */ Symbol.for("elizaos.browser-capture.hooks");
+function hooksGlobal() {
+  return globalThis;
+}
+function registerBrowserCaptureHooks(hooks) {
+  hooksGlobal()[BROWSER_CAPTURE_HOOKS] = hooks;
+}
+function getBrowserCaptureHooks() {
+  return hooksGlobal()[BROWSER_CAPTURE_HOOKS] ?? null;
+}
+export {
+  getBrowserCaptureHooks,
+  registerBrowserCaptureHooks
+};
+//# sourceMappingURL=browser-capture-hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser-capture-hooks.ts"],"sourcesContent":["import type { BrowserCaptureConfig } from \"./workspace/browser-capture.js\";\n\nexport interface BrowserCaptureHooks {\n  frameFile: string;\n  startBrowserCapture(config: BrowserCaptureConfig): Promise<void>;\n  stopBrowserCapture(): Promise<void>;\n}\n\nconst BROWSER_CAPTURE_HOOKS = Symbol.for(\"elizaos.browser-capture.hooks\");\n\ntype BrowserCaptureHooksGlobal = typeof globalThis & {\n  [BROWSER_CAPTURE_HOOKS]?: BrowserCaptureHooks;\n};\n\nfunction hooksGlobal(): BrowserCaptureHooksGlobal {\n  return globalThis as BrowserCaptureHooksGlobal;\n}\n\nexport function registerBrowserCaptureHooks(hooks: BrowserCaptureHooks): void {\n  hooksGlobal()[BROWSER_CAPTURE_HOOKS] = hooks;\n}\n\nexport function getBrowserCaptureHooks(): BrowserCaptureHooks | null {\n  return hooksGlobal()[BROWSER_CAPTURE_HOOKS] ?? null;\n}\n"],"mappings":"AAQA,MAAM,wBAAwB,uBAAO,IAAI,+BAA+B;AAMxE,SAAS,cAAyC;AAChD,SAAO;AACT;AAEO,SAAS,4BAA4B,OAAkC;AAC5E,cAAY,EAAE,qBAAqB,IAAI;AACzC;AAEO,SAAS,yBAAqD;AACnE,SAAO,YAAY,EAAE,qBAAqB,KAAK;AACjD;","names":[]}

package/dist/browser-service.d.ts

@@ -0,0 +1,103 @@
+/**
+ * BrowserService — single browser dispatcher with a pluggable target
+ * registry.
+ *
+ * The agent uses what is available: targets register themselves at plugin
+ * init (or later), and the BROWSER action calls into BrowserService which
+ * picks the active target. Targets can be queried by id, listed, or
+ * resolved by availability.
+ *
+ * Built-in targets:
+ *   - `workspace` — Eliza's electrobun-embedded BrowserView (with a JSDOM
+ *     web-mode fallback when the desktop bridge isn't configured). Always
+ *     registered by this plugin's `start`. Always available.
+ *
+ * Optional targets registered by other plugins:
+ *   - `bridge` — registered by this plugin when a `BrowserBridgeRouteService`
+ *     is reachable via the runtime; routes commands to the user's real
+ *     Chrome / Safari via the Agent Browser Bridge companion extension.
+ *     Available iff at least one companion is paired.
+ *   - `computeruse` — registered by `@elizaos/plugin-computeruse` on plugin
+ *     init when its capabilities indicate the puppeteer-driven Chromium is
+ *     ready.
+ *   - `stagehand` — registered by this plugin when a Stagehand command
+ *     endpoint is configured; used as a low-priority fallback.
+ *
+ * Anyone can add a new target later by calling `registerTarget` — that's
+ * the whole point of the pattern. The BROWSER action stays one action.
+ */
+import { type IAgentRuntime, Service } from "@elizaos/core";
+import type { BrowserWorkspaceCommand, BrowserWorkspaceCommandResult } from "./workspace/browser-workspace-types.js";
+export declare const BROWSER_SERVICE_TYPE = "browser";
+export type BrowserTargetKind = "app" | "companion" | "stagehand" | "external";
+export interface BrowserTargetResolutionContext {
+    command: BrowserWorkspaceCommand;
+    env: NodeJS.ProcessEnv;
+    mobile: boolean;
+}
+/**
+ * Pluggable browser backend. Implementations translate the canonical
+ * BrowserWorkspaceCommand surface into whatever native shape they speak
+ * (electrobun bridge, Chrome companion HTTP, puppeteer CDP, etc.) and
+ * return the canonical BrowserWorkspaceCommandResult.
+ *
+ * Targets MAY decline subactions they don't support — throw a clear
+ * `Error` from `execute` and the caller will see the message. Don't
+ * silently ignore it.
+ */
+export interface BrowserTarget {
+    /** Stable identifier — `workspace`, `bridge`, `computeruse`, etc. */
+    readonly id: string;
+    /** Short human-readable name for diagnostics. */
+    readonly name: string;
+    /** One-line description of what this target controls. */
+    readonly description: string;
+    /** Broad target class used for automatic routing. */
+    readonly kind?: BrowserTargetKind;
+    /** Lower scores are fallback choices. */
+    readonly priority?: number;
+    /**
+     * Optional command-aware score. Return `null` to opt out of automatic
+     * routing for this command while still allowing explicit `target`.
+     */
+    score?(context: BrowserTargetResolutionContext): number | null;
+    /**
+     * Cheap availability check. Called when the BROWSER action wants to
+     * route a command and the caller didn't pin a target. Should be fast
+     * (no network round-trips) when possible.
+     */
+    available(): Promise<boolean>;
+    /** Run the command. Throw on unsupported subactions. */
+    execute(command: BrowserWorkspaceCommand): Promise<BrowserWorkspaceCommandResult>;
+}
+export declare class BrowserService extends Service {
+    static readonly serviceType = "browser";
+    capabilityDescription: string;
+    private readonly targets;
+    /** Registration order — used as the default preference order. */
+    private readonly targetOrder;
+    stop(): Promise<void>;
+    static start(runtime: IAgentRuntime): Promise<BrowserService>;
+    /**
+     * Register a target. Idempotent on `id` — calling twice with the same id
+     * replaces the previous registration without affecting registration
+     * order. New ids are appended to the order list.
+     */
+    registerTarget(target: BrowserTarget): void;
+    unregisterTarget(id: string): boolean;
+    listTargets(): BrowserTarget[];
+    /**
+     * Resolve the active target for a command. If `preferredId` is given,
+     * returns that target only if available; otherwise scores registered
+     * targets and returns the best available one.
+     * Returns `null` if nothing is available.
+     */
+    resolveTarget(preferredId?: string, command?: BrowserWorkspaceCommand): Promise<BrowserTarget | null>;
+    resolveTargets(preferredId?: string, command?: BrowserWorkspaceCommand): Promise<BrowserTarget[]>;
+    /**
+     * Dispatch a command. `targetId` pins the target; otherwise the service
+     * picks the first available one in registration order.
+     */
+    execute(command: BrowserWorkspaceCommand, targetId?: string): Promise<BrowserWorkspaceCommandResult>;
+}
+//# sourceMappingURL=browser-service.d.ts.map

package/dist/browser-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-service.d.ts","sourceRoot":"","sources":["../src/browser-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAMpE,OAAO,KAAK,EACV,uBAAuB,EACvB,6BAA6B,EAC9B,MAAM,wCAAwC,CAAC;AAEhD,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,uBAAuB,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,8BAA8B,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/D;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,wDAAwD;IACxD,OAAO,CACL,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,6BAA6B,CAAC,CAAC;CAC3C;AAED,qBAAa,cAAe,SAAQ,OAAO;IACzC,gBAAyB,WAAW,aAAwB;IACnD,qBAAqB,SAC8K;IAE5M,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAEtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;WAKL,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA2B5E;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAU3C,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IASrC,WAAW,IAAI,aAAa,EAAE;IAM9B;;;;;OAKG;IACG,aAAa,CACjB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,uBAAgD,GACxD,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK1B,cAAc,CAClB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,uBAAgD,GACxD,OAAO,CAAC,aAAa,EAAE,CAAC;IA+C3B;;;OAGG;IACG,OAAO,CACX,OAAO,EAAE,uBAAuB,EAChC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,6BAA6B,CAAC;CA6B1C"}

package/dist/browser-service.js

@@ -0,0 +1,186 @@
+import { logger, Service } from "@elizaos/core";
+import {
+  BROWSER_BRIDGE_ROUTE_SERVICE_TYPE
+} from "./service.js";
+import { maybeCreateStagehandTarget } from "./targets/stagehand-target.js";
+const BROWSER_SERVICE_TYPE = "browser";
+class BrowserService extends Service {
+  static serviceType = BROWSER_SERVICE_TYPE;
+  capabilityDescription = "Single browser dispatcher with a pluggable target registry. Targets (workspace / bridge / computeruse / \u2026) register themselves; the BROWSER action picks the active target or honors a pinned override.";
+  targets = /* @__PURE__ */ new Map();
+  /** Registration order — used as the default preference order. */
+  targetOrder = [];
+  async stop() {
+    this.targets.clear();
+    this.targetOrder.length = 0;
+  }
+  static async start(runtime) {
+    const service = new BrowserService(runtime);
+    service.registerTarget(createWorkspaceTarget());
+    try {
+      const bridgeTarget = await maybeCreateBridgeTarget(runtime);
+      if (bridgeTarget) service.registerTarget(bridgeTarget);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      logger.debug(
+        `[BrowserService] bridge target not registered at start: ${message}`
+      );
+    }
+    try {
+      const stagehandTarget = await maybeCreateStagehandTarget();
+      if (stagehandTarget) service.registerTarget(stagehandTarget);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      logger.debug(
+        `[BrowserService] stagehand target not registered at start: ${message}`
+      );
+    }
+    return service;
+  }
+  /**
+   * Register a target. Idempotent on `id` — calling twice with the same id
+   * replaces the previous registration without affecting registration
+   * order. New ids are appended to the order list.
+   */
+  registerTarget(target) {
+    if (!this.targets.has(target.id)) {
+      this.targetOrder.push(target.id);
+    }
+    this.targets.set(target.id, target);
+    logger.debug(
+      `[BrowserService] registered target "${target.id}" (${target.name})`
+    );
+  }
+  unregisterTarget(id) {
+    const removed = this.targets.delete(id);
+    if (removed) {
+      const idx = this.targetOrder.indexOf(id);
+      if (idx >= 0) this.targetOrder.splice(idx, 1);
+    }
+    return removed;
+  }
+  listTargets() {
+    return this.targetOrder.map((id) => this.targets.get(id)).filter((target) => target !== void 0);
+  }
+  /**
+   * Resolve the active target for a command. If `preferredId` is given,
+   * returns that target only if available; otherwise scores registered
+   * targets and returns the best available one.
+   * Returns `null` if nothing is available.
+   */
+  async resolveTarget(preferredId, command = { subaction: "state" }) {
+    const targets = await this.resolveTargets(preferredId, command);
+    return targets[0] ?? null;
+  }
+  async resolveTargets(preferredId, command = { subaction: "state" }) {
+    if (preferredId) {
+      const target = this.targets.get(preferredId);
+      if (!target) return [];
+      try {
+        return await target.available() ? [target] : [];
+      } catch {
+        return [];
+      }
+    }
+    const context = {
+      command,
+      env: process.env,
+      mobile: isMobileBrowserRuntime(process.env)
+    };
+    const available = [];
+    for (const id of this.targetOrder) {
+      const target = this.targets.get(id);
+      if (!target) continue;
+      try {
+        const score = target.score ? target.score(context) : target.priority ?? 0;
+        if (score === null) continue;
+        if (await target.available()) {
+          available.push({
+            score,
+            order: this.targetOrder.indexOf(id),
+            target
+          });
+        }
+      } catch {
+      }
+    }
+    return available.sort((a, b) => b.score - a.score || a.order - b.order).map(({ target }) => target);
+  }
+  /**
+   * Dispatch a command. `targetId` pins the target; otherwise the service
+   * picks the first available one in registration order.
+   */
+  async execute(command, targetId) {
+    const targets = await this.resolveTargets(targetId, command);
+    if (targets.length === 0) {
+      const availableIds = this.targetOrder.join(", ") || "(none)";
+      throw new Error(
+        targetId ? `Browser target "${targetId}" is not available. Registered targets: ${availableIds}.` : `No browser target is available. Registered targets: ${availableIds}.`
+      );
+    }
+    let lastError = null;
+    for (const target of targets) {
+      try {
+        return await target.execute(command);
+      } catch (err) {
+        lastError = err;
+        if (targetId) break;
+        const message = err instanceof Error ? err.message : String(err);
+        logger.debug(
+          `[BrowserService] target "${target.id}" failed; trying next target: ${message}`
+        );
+      }
+    }
+    throw lastError instanceof Error ? lastError : new Error("Browser target execution failed.");
+  }
+}
+function createWorkspaceTarget() {
+  return {
+    id: "workspace",
+    name: "Browser Workspace",
+    description: "Eliza's electrobun-embedded BrowserView (desktop) or JSDOM fallback (web). Always available.",
+    kind: "app",
+    priority: 100,
+    score: ({ mobile }) => mobile ? 120 : 100,
+    available: async () => true,
+    execute: async (command) => {
+      const { executeBrowserWorkspaceCommand } = await import("./workspace/browser-workspace.js");
+      return executeBrowserWorkspaceCommand(command);
+    }
+  };
+}
+async function maybeCreateBridgeTarget(runtime) {
+  const service = runtime.getService(
+    BROWSER_BRIDGE_ROUTE_SERVICE_TYPE
+  );
+  if (!service) return null;
+  return {
+    id: "bridge",
+    name: "Browser Bridge (Chrome / Safari companion)",
+    description: "Routes commands to the user's real Chrome or Safari via the Agent Browser Bridge companion extension. Subset of subactions supported (open / navigate / close / list / state / show / hide / tab / get).",
+    kind: "companion",
+    priority: 80,
+    score: ({ mobile }) => mobile ? null : 80,
+    available: async () => {
+      try {
+        const companions = await service.listBrowserCompanions();
+        return companions.length > 0;
+      } catch {
+        return false;
+      }
+    },
+    execute: async (command) => {
+      const { dispatchBridgeCommand } = await import("./targets/bridge-target.js");
+      return dispatchBridgeCommand(service, command);
+    }
+  };
+}
+function isMobileBrowserRuntime(env) {
+  const platform = (env.ELIZA_MOBILE_PLATFORM ?? env.ELIZA_PLATFORM ?? env.CAPACITOR_PLATFORM ?? "").toLowerCase();
+  return platform === "ios" || platform === "android" || platform === "mobile";
+}
+export {
+  BROWSER_SERVICE_TYPE,
+  BrowserService
+};
+//# sourceMappingURL=browser-service.js.map

package/dist/browser-service.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser-service.ts"],"sourcesContent":["/**\n * BrowserService — single browser dispatcher with a pluggable target\n * registry.\n *\n * The agent uses what is available: targets register themselves at plugin\n * init (or later), and the BROWSER action calls into BrowserService which\n * picks the active target. Targets can be queried by id, listed, or\n * resolved by availability.\n *\n * Built-in targets:\n *   - `workspace` — Eliza's electrobun-embedded BrowserView (with a JSDOM\n *     web-mode fallback when the desktop bridge isn't configured). Always\n *     registered by this plugin's `start`. Always available.\n *\n * Optional targets registered by other plugins:\n *   - `bridge` — registered by this plugin when a `BrowserBridgeRouteService`\n *     is reachable via the runtime; routes commands to the user's real\n *     Chrome / Safari via the Agent Browser Bridge companion extension.\n *     Available iff at least one companion is paired.\n *   - `computeruse` — registered by `@elizaos/plugin-computeruse` on plugin\n *     init when its capabilities indicate the puppeteer-driven Chromium is\n *     ready.\n *   - `stagehand` — registered by this plugin when a Stagehand command\n *     endpoint is configured; used as a low-priority fallback.\n *\n * Anyone can add a new target later by calling `registerTarget` — that's\n * the whole point of the pattern. The BROWSER action stays one action.\n */\n\nimport { type IAgentRuntime, logger, Service } from \"@elizaos/core\";\nimport {\n  BROWSER_BRIDGE_ROUTE_SERVICE_TYPE,\n  type BrowserBridgeRouteService,\n} from \"./service.js\";\nimport { maybeCreateStagehandTarget } from \"./targets/stagehand-target.js\";\nimport type {\n  BrowserWorkspaceCommand,\n  BrowserWorkspaceCommandResult,\n} from \"./workspace/browser-workspace-types.js\";\n\nexport const BROWSER_SERVICE_TYPE = \"browser\";\n\nexport type BrowserTargetKind = \"app\" | \"companion\" | \"stagehand\" | \"external\";\n\nexport interface BrowserTargetResolutionContext {\n  command: BrowserWorkspaceCommand;\n  env: NodeJS.ProcessEnv;\n  mobile: boolean;\n}\n\n/**\n * Pluggable browser backend. Implementations translate the canonical\n * BrowserWorkspaceCommand surface into whatever native shape they speak\n * (electrobun bridge, Chrome companion HTTP, puppeteer CDP, etc.) and\n * return the canonical BrowserWorkspaceCommandResult.\n *\n * Targets MAY decline subactions they don't support — throw a clear\n * `Error` from `execute` and the caller will see the message. Don't\n * silently ignore it.\n */\nexport interface BrowserTarget {\n  /** Stable identifier — `workspace`, `bridge`, `computeruse`, etc. */\n  readonly id: string;\n  /** Short human-readable name for diagnostics. */\n  readonly name: string;\n  /** One-line description of what this target controls. */\n  readonly description: string;\n  /** Broad target class used for automatic routing. */\n  readonly kind?: BrowserTargetKind;\n  /** Lower scores are fallback choices. */\n  readonly priority?: number;\n  /**\n   * Optional command-aware score. Return `null` to opt out of automatic\n   * routing for this command while still allowing explicit `target`.\n   */\n  score?(context: BrowserTargetResolutionContext): number | null;\n  /**\n   * Cheap availability check. Called when the BROWSER action wants to\n   * route a command and the caller didn't pin a target. Should be fast\n   * (no network round-trips) when possible.\n   */\n  available(): Promise<boolean>;\n  /** Run the command. Throw on unsupported subactions. */\n  execute(\n    command: BrowserWorkspaceCommand,\n  ): Promise<BrowserWorkspaceCommandResult>;\n}\n\nexport class BrowserService extends Service {\n  static override readonly serviceType = BROWSER_SERVICE_TYPE;\n  override capabilityDescription =\n    \"Single browser dispatcher with a pluggable target registry. Targets (workspace / bridge / computeruse / …) register themselves; the BROWSER action picks the active target or honors a pinned override.\";\n\n  private readonly targets = new Map<string, BrowserTarget>();\n  /** Registration order — used as the default preference order. */\n  private readonly targetOrder: string[] = [];\n\n  async stop(): Promise<void> {\n    this.targets.clear();\n    this.targetOrder.length = 0;\n  }\n\n  static override async start(runtime: IAgentRuntime): Promise<BrowserService> {\n    const service = new BrowserService(runtime);\n    service.registerTarget(createWorkspaceTarget());\n    // Bridge target self-registers when its dependencies (BrowserBridgeRouteService\n    // implementor) are reachable via the runtime. Missing dependencies keep the\n    // agent in workspace-only mode.\n    try {\n      const bridgeTarget = await maybeCreateBridgeTarget(runtime);\n      if (bridgeTarget) service.registerTarget(bridgeTarget);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      logger.debug(\n        `[BrowserService] bridge target not registered at start: ${message}`,\n      );\n    }\n    try {\n      const stagehandTarget = await maybeCreateStagehandTarget();\n      if (stagehandTarget) service.registerTarget(stagehandTarget);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      logger.debug(\n        `[BrowserService] stagehand target not registered at start: ${message}`,\n      );\n    }\n    return service;\n  }\n\n  /**\n   * Register a target. Idempotent on `id` — calling twice with the same id\n   * replaces the previous registration without affecting registration\n   * order. New ids are appended to the order list.\n   */\n  registerTarget(target: BrowserTarget): void {\n    if (!this.targets.has(target.id)) {\n      this.targetOrder.push(target.id);\n    }\n    this.targets.set(target.id, target);\n    logger.debug(\n      `[BrowserService] registered target \"${target.id}\" (${target.name})`,\n    );\n  }\n\n  unregisterTarget(id: string): boolean {\n    const removed = this.targets.delete(id);\n    if (removed) {\n      const idx = this.targetOrder.indexOf(id);\n      if (idx >= 0) this.targetOrder.splice(idx, 1);\n    }\n    return removed;\n  }\n\n  listTargets(): BrowserTarget[] {\n    return this.targetOrder\n      .map((id) => this.targets.get(id))\n      .filter((target): target is BrowserTarget => target !== undefined);\n  }\n\n  /**\n   * Resolve the active target for a command. If `preferredId` is given,\n   * returns that target only if available; otherwise scores registered\n   * targets and returns the best available one.\n   * Returns `null` if nothing is available.\n   */\n  async resolveTarget(\n    preferredId?: string,\n    command: BrowserWorkspaceCommand = { subaction: \"state\" },\n  ): Promise<BrowserTarget | null> {\n    const targets = await this.resolveTargets(preferredId, command);\n    return targets[0] ?? null;\n  }\n\n  async resolveTargets(\n    preferredId?: string,\n    command: BrowserWorkspaceCommand = { subaction: \"state\" },\n  ): Promise<BrowserTarget[]> {\n    if (preferredId) {\n      const target = this.targets.get(preferredId);\n      if (!target) return [];\n      try {\n        return (await target.available()) ? [target] : [];\n      } catch {\n        return [];\n      }\n    }\n\n    const context: BrowserTargetResolutionContext = {\n      command,\n      env: process.env,\n      mobile: isMobileBrowserRuntime(process.env),\n    };\n    const available: Array<{\n      score: number;\n      order: number;\n      target: BrowserTarget;\n    }> = [];\n\n    for (const id of this.targetOrder) {\n      const target = this.targets.get(id);\n      if (!target) continue;\n      try {\n        const score = target.score\n          ? target.score(context)\n          : (target.priority ?? 0);\n        if (score === null) continue;\n        if (await target.available()) {\n          available.push({\n            score,\n            order: this.targetOrder.indexOf(id),\n            target,\n          });\n        }\n      } catch {\n        // Ignore unhealthy targets during target resolution.\n      }\n    }\n\n    return available\n      .sort((a, b) => b.score - a.score || a.order - b.order)\n      .map(({ target }) => target);\n  }\n\n  /**\n   * Dispatch a command. `targetId` pins the target; otherwise the service\n   * picks the first available one in registration order.\n   */\n  async execute(\n    command: BrowserWorkspaceCommand,\n    targetId?: string,\n  ): Promise<BrowserWorkspaceCommandResult> {\n    const targets = await this.resolveTargets(targetId, command);\n    if (targets.length === 0) {\n      const availableIds = this.targetOrder.join(\", \") || \"(none)\";\n      throw new Error(\n        targetId\n          ? `Browser target \"${targetId}\" is not available. Registered targets: ${availableIds}.`\n          : `No browser target is available. Registered targets: ${availableIds}.`,\n      );\n    }\n\n    let lastError: unknown = null;\n    for (const target of targets) {\n      try {\n        return await target.execute(command);\n      } catch (err) {\n        lastError = err;\n        if (targetId) break;\n        const message = err instanceof Error ? err.message : String(err);\n        logger.debug(\n          `[BrowserService] target \"${target.id}\" failed; trying next target: ${message}`,\n        );\n      }\n    }\n\n    throw lastError instanceof Error\n      ? lastError\n      : new Error(\"Browser target execution failed.\");\n  }\n}\n\nfunction createWorkspaceTarget(): BrowserTarget {\n  return {\n    id: \"workspace\",\n    name: \"Browser Workspace\",\n    description:\n      \"Eliza's electrobun-embedded BrowserView (desktop) or JSDOM fallback (web). Always available.\",\n    kind: \"app\",\n    priority: 100,\n    score: ({ mobile }) => (mobile ? 120 : 100),\n    available: async () => true,\n    execute: async (command) => {\n      const { executeBrowserWorkspaceCommand } = await import(\n        \"./workspace/browser-workspace.js\"\n      );\n      return executeBrowserWorkspaceCommand(command);\n    },\n  };\n}\n\nasync function maybeCreateBridgeTarget(\n  runtime: IAgentRuntime,\n): Promise<BrowserTarget | null> {\n  const service = runtime.getService<BrowserBridgeRouteService>(\n    BROWSER_BRIDGE_ROUTE_SERVICE_TYPE,\n  );\n  if (!service) return null;\n  return {\n    id: \"bridge\",\n    name: \"Browser Bridge (Chrome / Safari companion)\",\n    description:\n      \"Routes commands to the user's real Chrome or Safari via the Agent Browser Bridge companion extension. Subset of subactions supported (open / navigate / close / list / state / show / hide / tab / get).\",\n    kind: \"companion\",\n    priority: 80,\n    score: ({ mobile }) => (mobile ? null : 80),\n    available: async () => {\n      try {\n        const companions = await service.listBrowserCompanions();\n        return companions.length > 0;\n      } catch {\n        return false;\n      }\n    },\n    execute: async (command) => {\n      const { dispatchBridgeCommand } = await import(\n        \"./targets/bridge-target.js\"\n      );\n      return dispatchBridgeCommand(service, command);\n    },\n  };\n}\n\nfunction isMobileBrowserRuntime(env: NodeJS.ProcessEnv): boolean {\n  const platform = (\n    env.ELIZA_MOBILE_PLATFORM ??\n    env.ELIZA_PLATFORM ??\n    env.CAPACITOR_PLATFORM ??\n    \"\"\n  ).toLowerCase();\n  return platform === \"ios\" || platform === \"android\" || platform === \"mobile\";\n}\n"],"mappings":"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","names":[]}

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

@@ -0,0 +1,14 @@
+import type { BrowserWorkspaceTab, EvaluateBrowserWorkspaceTabRequest, NavigateBrowserWorkspaceTabRequest, OpenBrowserWorkspaceTabRequest } from "./workspace/browser-workspace-types.js";
+export interface BrowserWorkspaceHooks {
+    closeBrowserWorkspaceTab(id: string, env?: NodeJS.ProcessEnv): Promise<boolean>;
+    evaluateBrowserWorkspaceTab(request: EvaluateBrowserWorkspaceTabRequest, env?: NodeJS.ProcessEnv): Promise<unknown>;
+    isBrowserWorkspaceBridgeConfigured(env?: NodeJS.ProcessEnv): boolean;
+    listBrowserWorkspaceTabs(env?: NodeJS.ProcessEnv): Promise<BrowserWorkspaceTab[]>;
+    navigateBrowserWorkspaceTab(request: NavigateBrowserWorkspaceTabRequest, env?: NodeJS.ProcessEnv): Promise<BrowserWorkspaceTab>;
+    openBrowserWorkspaceTab(request: OpenBrowserWorkspaceTabRequest, env?: NodeJS.ProcessEnv): Promise<BrowserWorkspaceTab>;
+    resolveBrowserWorkspaceConnectorPartition(provider: string, accountId: string): string;
+    showBrowserWorkspaceTab(id: string, env?: NodeJS.ProcessEnv): Promise<BrowserWorkspaceTab>;
+}
+export declare function registerBrowserWorkspaceHooks(hooks: BrowserWorkspaceHooks): void;
+export declare function getBrowserWorkspaceHooks(): BrowserWorkspaceHooks | null;
+//# sourceMappingURL=browser-workspace-hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-workspace-hooks.d.ts","sourceRoot":"","sources":["../src/browser-workspace-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,kCAAkC,EAClC,kCAAkC,EAClC,8BAA8B,EAC/B,MAAM,wCAAwC,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,wBAAwB,CACtB,EAAE,EAAE,MAAM,EACV,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,2BAA2B,CACzB,OAAO,EAAE,kCAAkC,EAC3C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,kCAAkC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC;IACrE,wBAAwB,CACtB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAClC,2BAA2B,CACzB,OAAO,EAAE,kCAAkC,EAC3C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,uBAAuB,CACrB,OAAO,EAAE,8BAA8B,EACvC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChC,yCAAyC,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC;IACV,uBAAuB,CACrB,EAAE,EAAE,MAAM,EACV,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC;AAYD,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,qBAAqB,GAC3B,IAAI,CAEN;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,IAAI,CAEvE"}

package/dist/browser-workspace-hooks.js

@@ -0,0 +1,15 @@
+const BROWSER_WORKSPACE_HOOKS = /* @__PURE__ */ Symbol.for("elizaos.browser-workspace.hooks");
+function hooksGlobal() {
+  return globalThis;
+}
+function registerBrowserWorkspaceHooks(hooks) {
+  hooksGlobal()[BROWSER_WORKSPACE_HOOKS] = hooks;
+}
+function getBrowserWorkspaceHooks() {
+  return hooksGlobal()[BROWSER_WORKSPACE_HOOKS] ?? null;
+}
+export {
+  getBrowserWorkspaceHooks,
+  registerBrowserWorkspaceHooks
+};
+//# sourceMappingURL=browser-workspace-hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/browser-workspace-hooks.ts"],"sourcesContent":["import type {\n  BrowserWorkspaceTab,\n  EvaluateBrowserWorkspaceTabRequest,\n  NavigateBrowserWorkspaceTabRequest,\n  OpenBrowserWorkspaceTabRequest,\n} from \"./workspace/browser-workspace-types.js\";\n\nexport interface BrowserWorkspaceHooks {\n  closeBrowserWorkspaceTab(\n    id: string,\n    env?: NodeJS.ProcessEnv,\n  ): Promise<boolean>;\n  evaluateBrowserWorkspaceTab(\n    request: EvaluateBrowserWorkspaceTabRequest,\n    env?: NodeJS.ProcessEnv,\n  ): Promise<unknown>;\n  isBrowserWorkspaceBridgeConfigured(env?: NodeJS.ProcessEnv): boolean;\n  listBrowserWorkspaceTabs(\n    env?: NodeJS.ProcessEnv,\n  ): Promise<BrowserWorkspaceTab[]>;\n  navigateBrowserWorkspaceTab(\n    request: NavigateBrowserWorkspaceTabRequest,\n    env?: NodeJS.ProcessEnv,\n  ): Promise<BrowserWorkspaceTab>;\n  openBrowserWorkspaceTab(\n    request: OpenBrowserWorkspaceTabRequest,\n    env?: NodeJS.ProcessEnv,\n  ): Promise<BrowserWorkspaceTab>;\n  resolveBrowserWorkspaceConnectorPartition(\n    provider: string,\n    accountId: string,\n  ): string;\n  showBrowserWorkspaceTab(\n    id: string,\n    env?: NodeJS.ProcessEnv,\n  ): Promise<BrowserWorkspaceTab>;\n}\n\nconst BROWSER_WORKSPACE_HOOKS = Symbol.for(\"elizaos.browser-workspace.hooks\");\n\ntype BrowserWorkspaceHooksGlobal = typeof globalThis & {\n  [BROWSER_WORKSPACE_HOOKS]?: BrowserWorkspaceHooks;\n};\n\nfunction hooksGlobal(): BrowserWorkspaceHooksGlobal {\n  return globalThis as BrowserWorkspaceHooksGlobal;\n}\n\nexport function registerBrowserWorkspaceHooks(\n  hooks: BrowserWorkspaceHooks,\n): void {\n  hooksGlobal()[BROWSER_WORKSPACE_HOOKS] = hooks;\n}\n\nexport function getBrowserWorkspaceHooks(): BrowserWorkspaceHooks | null {\n  return hooksGlobal()[BROWSER_WORKSPACE_HOOKS] ?? null;\n}\n"],"mappings":"AAsCA,MAAM,0BAA0B,uBAAO,IAAI,iCAAiC;AAM5E,SAAS,cAA2C;AAClD,SAAO;AACT;AAEO,SAAS,8BACd,OACM;AACN,cAAY,EAAE,uBAAuB,IAAI;AAC3C;AAEO,SAAS,2BAAyD;AACvE,SAAO,YAAY,EAAE,uBAAuB,KAAK;AACnD;","names":[]}

package/dist/companion-auth.d.ts

@@ -0,0 +1,34 @@
+export type BrowserBridgeCompanionCredentialLike = {
+    companion: {
+        pairingTokenExpiresAt?: string | null;
+        pairingTokenRevokedAt?: string | null;
+    };
+    pairingTokenHash: string | null;
+    pendingPairingTokens?: BrowserBridgeCompanionPendingToken[] | null;
+    pendingPairingTokenHashes?: string[] | null;
+} | null;
+export type BrowserBridgeCompanionPendingToken = {
+    hash: string;
+    expiresAt: string | null;
+};
+export type BrowserBridgeCompanionAuthCode = "browser_bridge_companion_pairing_invalid" | "browser_bridge_companion_token_expired" | "browser_bridge_companion_token_revoked";
+export type BrowserBridgeCompanionAuthFailure = {
+    ok: false;
+    code: BrowserBridgeCompanionAuthCode;
+    message: string;
+};
+export type BrowserBridgeCompanionAuthSuccess = {
+    ok: true;
+    source: "active" | "pending";
+    expiresAt: string | null;
+    remainingPendingPairingTokens: BrowserBridgeCompanionPendingToken[];
+};
+export type BrowserBridgeCompanionAuthResult = BrowserBridgeCompanionAuthSuccess | BrowserBridgeCompanionAuthFailure;
+export declare function browserBridgeCompanionAuthFailure(code: BrowserBridgeCompanionAuthCode): BrowserBridgeCompanionAuthFailure;
+export declare function isoTimestampExpired(value: string | null | undefined, nowMs: number): boolean;
+export declare function authenticateBrowserBridgeCompanionCredential(args: {
+    credential: BrowserBridgeCompanionCredentialLike;
+    pairingTokenHash: string;
+    nowMs: number;
+}): BrowserBridgeCompanionAuthResult;
+//# sourceMappingURL=companion-auth.d.ts.map

package/dist/companion-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-auth.d.ts","sourceRoot":"","sources":["../src/companion-auth.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oCAAoC,GAAG;IACjD,SAAS,EAAE;QACT,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvC,CAAC;IACF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oBAAoB,CAAC,EAAE,kCAAkC,EAAE,GAAG,IAAI,CAAC;IACnE,yBAAyB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC7C,GAAG,IAAI,CAAC;AAET,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GACtC,0CAA0C,GAC1C,wCAAwC,GACxC,wCAAwC,CAAC;AAE7C,MAAM,MAAM,iCAAiC,GAAG;IAC9C,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6BAA6B,EAAE,kCAAkC,EAAE,CAAC;CACrE,CAAC;AAEF,MAAM,MAAM,gCAAgC,GACxC,iCAAiC,GACjC,iCAAiC,CAAC;AAEtC,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,8BAA8B,GACnC,iCAAiC,CAqBnC;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,KAAK,EAAE,MAAM,GACZ,OAAO,CAMT;AAiBD,wBAAgB,4CAA4C,CAAC,IAAI,EAAE;IACjE,UAAU,EAAE,oCAAoC,CAAC;IACjD,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,gCAAgC,CAuDnC"}