@xopcai/xopc 0.0.82 → 0.0.83

package/dist/src/agent/tools/image-generate-tool.js

@@ -4,9 +4,9 @@ import { isFailoverError } from "../failover-error.js";
 import { imageAssetFromDataUrl, imageFileExtensionForMimeType, mimeTypeFromFileName, parseImageDataUrl, sniffImageMimeType } from "../image/generation/image-assets.js";
 import { getImageGenerationProvider } from "../image/generation/provider-registry.js";
 import { generateImage, listImageGenerationProvidersSummary } from "../image/generation/runtime.js";
-import path from "node:path";
 import { randomBytes } from "node:crypto";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/image-generate-tool.ts
 const DEFAULT_COUNT = 1;

package/dist/src/agent/tools/send-media.js

@@ -1,7 +1,7 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
-import { basename } from "node:path";
 import { readFile } from "fs/promises";
+import { basename } from "node:path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/send-media.ts
 const SendMediaSchema = Type.Object({

package/dist/src/agent/tools/skill-manage-tool.js

@@ -2,9 +2,9 @@ import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
 import { createSkillConfigManager } from "../skills/config.js";
 import { applyPatchToContent, atomicWriteUtf8, effectiveAgentWritePolicy, ensureCategorySegment, isPathInsideDir, maxSkillMdChars, maxSupportFileBytes, mutatableSkillOrNull, resolveCreateSkillDir, scanSkillDirOrError, validateSkillMdContent, validateSkillNameSegment, validateSupportingRelativePath } from "../skills/skill-manage-ops.js";
+import { readFile, rm } from "fs/promises";
 import { join } from "path";
 import { existsSync, rmSync } from "fs";
-import { readFile, rm } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/skill-manage-tool.ts
 init_paths();

package/dist/src/agent/tools/skills-tools.js

@@ -1,7 +1,7 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
-import { createSkillConfigManager, isSkillEnabled } from "../skills/config.js";
 import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from "./truncate.js";
+import { createSkillConfigManager, isSkillEnabled } from "../skills/config.js";
 import { resolveSkillReadablePath } from "../skills/skill-view-path.js";
 import { readFileSync, statSync } from "fs";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/tts-tool.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { speak } from "../../voice/tts/speak-core.js";
+import { mergeTtsConfigFromAppConfig } from "../../voice/tts/merge-config.js";
 import { getChannelOutputFormat } from "../../voice/tts/service.js";
 import { compressAudio } from "../../voice/tts/audio.js";
 import { Type } from "@sinclair/typebox";

package/dist/src/agent/tools/write.js

@@ -1,8 +1,8 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
-import { dirname } from "path";
 import { mkdir, writeFile } from "fs/promises";
+import { dirname } from "path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/write.ts
 const MAX_FILE_SIZE = 10 * 1024 * 1024;

package/dist/src/agent/workspace-runtime/registry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * WorkspaceRuntimeRegistry — lazy per-workspace cache of skill/memory/prompt-builder runtimes.
+ *
+ * Previously these four collaborators (`SkillManager`, `SystemPromptBuilder`,
+ * `BuiltinMemoryStore`, `MemoryManager`) were created inline inside
+ * `AgentManager.getWorkspaceRuntime` and cached in a private Map. They live
+ * outside `AgentInstance` because multiple session keys may share a workspace
+ * (the runtime is keyed by **resolved workspace path**, not session key).
+ *
+ * Extracted so:
+ *   - `AgentManager` no longer juggles four sibling caches.
+ *   - Hot-reload teardown (`clearAll`) lives in one place — there are now no
+ *     callers that forget to shut down `memoryManager`.
+ *   - Future per-workspace runtimes (e.g. embedding store, vector cache) plug in
+ *     through `getOrCreate` without touching `AgentManager`.
+ */
+import type { Config } from '../../config/schema.js';
+import { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';
+import type { MemoryManager } from '../memory/manager.js';
+import { SkillManager } from '../skills/skill-manager.js';
+import { SystemPromptBuilder } from '../prompt/service-prompt-builder.js';
+export interface WorkspaceRuntime {
+    skillManager: SkillManager;
+    systemPromptBuilder: SystemPromptBuilder;
+    builtinMemoryStore: BuiltinMemoryStore;
+    memoryManager: MemoryManager;
+}
+export interface WorkspaceRuntimeRegistryOptions {
+    /** Effective config snapshot accessor (must always return a value when called). */
+    getConfig: () => Config;
+    /** Absolute path to the bundled skills directory shared by every workspace. */
+    bundledSkillsDir: string;
+}
+export declare class WorkspaceRuntimeRegistry {
+    private readonly runtimes;
+    private readonly getConfig;
+    private readonly bundledSkillsDir;
+    constructor(opts: WorkspaceRuntimeRegistryOptions);
+    /** Lazily construct (and cache) the runtime for a resolved workspace path. */
+    getOrCreate(resolvedPath: string): WorkspaceRuntime;
+    /** Iterate every live workspace runtime (used by skill / config hot-reload). */
+    values(): IterableIterator<WorkspaceRuntime>;
+    /**
+     * Tear down every runtime (shutdown memory providers) and forget the cache.
+     * Used by `AgentManager.updateAgentDefaults` and `AgentManager.dispose`.
+     */
+    clearAll(): Promise<void>;
+}

package/dist/src/agent/workspace-runtime/registry.js

@@ -0,0 +1,59 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { resolveBuiltinMemoryStoreConfig } from "../memory/memory-config.js";
+import { BuiltinMemoryStore } from "../memory/builtin-memory-store.js";
+import { createMemoryManagerFromConfig } from "../memory/create-memory-manager.js";
+import { SkillManager } from "../skills/skill-manager.js";
+import { SystemPromptBuilder } from "../prompt/service-prompt-builder.js";
+//#region src/agent/workspace-runtime/registry.ts
+init_logger();
+const log = createLogger("WorkspaceRuntimeRegistry");
+var WorkspaceRuntimeRegistry = class {
+	runtimes = /* @__PURE__ */ new Map();
+	getConfig;
+	bundledSkillsDir;
+	constructor(opts) {
+		this.getConfig = opts.getConfig;
+		this.bundledSkillsDir = opts.bundledSkillsDir;
+	}
+	/** Lazily construct (and cache) the runtime for a resolved workspace path. */
+	getOrCreate(resolvedPath) {
+		const existing = this.runtimes.get(resolvedPath);
+		if (existing) return existing;
+		const cfg = this.getConfig();
+		const builtinMemoryStore = new BuiltinMemoryStore(resolveBuiltinMemoryStoreConfig(resolvedPath, cfg));
+		const memoryManager = createMemoryManagerFromConfig(resolvedPath, builtinMemoryStore, cfg);
+		const skillManager = new SkillManager(resolvedPath, this.bundledSkillsDir);
+		const rt = {
+			skillManager,
+			systemPromptBuilder: new SystemPromptBuilder({
+				workspace: resolvedPath,
+				config: cfg,
+				skillManager
+			}),
+			builtinMemoryStore,
+			memoryManager
+		};
+		this.runtimes.set(resolvedPath, rt);
+		return rt;
+	}
+	/** Iterate every live workspace runtime (used by skill / config hot-reload). */
+	values() {
+		return this.runtimes.values();
+	}
+	/**
+	* Tear down every runtime (shutdown memory providers) and forget the cache.
+	* Used by `AgentManager.updateAgentDefaults` and `AgentManager.dispose`.
+	*/
+	async clearAll() {
+		const toShutdown = [...this.runtimes.values()];
+		this.runtimes.clear();
+		await Promise.allSettled(toShutdown.map((rt) => rt.memoryManager.shutdownAll().catch((err) => {
+			log.warn({ err }, "memoryManager.shutdownAll failed");
+		})));
+	}
+};
+//#endregion
+export { WorkspaceRuntimeRegistry };
+
+//# sourceMappingURL=registry.js.map

package/dist/src/agent/workspace-runtime/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../../../src/agent/workspace-runtime/registry.ts"],"sourcesContent":["/**\n * WorkspaceRuntimeRegistry — lazy per-workspace cache of skill/memory/prompt-builder runtimes.\n *\n * Previously these four collaborators (`SkillManager`, `SystemPromptBuilder`,\n * `BuiltinMemoryStore`, `MemoryManager`) were created inline inside\n * `AgentManager.getWorkspaceRuntime` and cached in a private Map. They live\n * outside `AgentInstance` because multiple session keys may share a workspace\n * (the runtime is keyed by **resolved workspace path**, not session key).\n *\n * Extracted so:\n *   - `AgentManager` no longer juggles four sibling caches.\n *   - Hot-reload teardown (`clearAll`) lives in one place — there are now no\n *     callers that forget to shut down `memoryManager`.\n *   - Future per-workspace runtimes (e.g. embedding store, vector cache) plug in\n *     through `getOrCreate` without touching `AgentManager`.\n */\n\nimport type { Config } from '../../config/schema.js';\nimport { BuiltinMemoryStore } from '../memory/builtin-memory-store.js';\nimport { createMemoryManagerFromConfig } from '../memory/create-memory-manager.js';\nimport { resolveBuiltinMemoryStoreConfig } from '../memory/memory-config.js';\nimport type { MemoryManager } from '../memory/manager.js';\nimport { SkillManager } from '../skills/skill-manager.js';\nimport { SystemPromptBuilder } from '../prompt/service-prompt-builder.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('WorkspaceRuntimeRegistry');\n\nexport interface WorkspaceRuntime {\n  skillManager: SkillManager;\n  systemPromptBuilder: SystemPromptBuilder;\n  builtinMemoryStore: BuiltinMemoryStore;\n  memoryManager: MemoryManager;\n}\n\nexport interface WorkspaceRuntimeRegistryOptions {\n  /** Effective config snapshot accessor (must always return a value when called). */\n  getConfig: () => Config;\n  /** Absolute path to the bundled skills directory shared by every workspace. */\n  bundledSkillsDir: string;\n}\n\nexport class WorkspaceRuntimeRegistry {\n  private readonly runtimes = new Map<string, WorkspaceRuntime>();\n  private readonly getConfig: () => Config;\n  private readonly bundledSkillsDir: string;\n\n  constructor(opts: WorkspaceRuntimeRegistryOptions) {\n    this.getConfig = opts.getConfig;\n    this.bundledSkillsDir = opts.bundledSkillsDir;\n  }\n\n  /** Lazily construct (and cache) the runtime for a resolved workspace path. */\n  getOrCreate(resolvedPath: string): WorkspaceRuntime {\n    const existing = this.runtimes.get(resolvedPath);\n    if (existing) {\n      return existing;\n    }\n\n    const cfg = this.getConfig();\n    const builtinMemoryStore = new BuiltinMemoryStore(\n      resolveBuiltinMemoryStoreConfig(resolvedPath, cfg),\n    );\n    const memoryManager = createMemoryManagerFromConfig(resolvedPath, builtinMemoryStore, cfg);\n    const skillManager = new SkillManager(resolvedPath, this.bundledSkillsDir);\n    const systemPromptBuilder = new SystemPromptBuilder({\n      workspace: resolvedPath,\n      config: cfg,\n      skillManager,\n    });\n\n    const rt: WorkspaceRuntime = {\n      skillManager,\n      systemPromptBuilder,\n      builtinMemoryStore,\n      memoryManager,\n    };\n    this.runtimes.set(resolvedPath, rt);\n    return rt;\n  }\n\n  /** Iterate every live workspace runtime (used by skill / config hot-reload). */\n  values(): IterableIterator<WorkspaceRuntime> {\n    return this.runtimes.values();\n  }\n\n  /**\n   * Tear down every runtime (shutdown memory providers) and forget the cache.\n   * Used by `AgentManager.updateAgentDefaults` and `AgentManager.dispose`.\n   */\n  async clearAll(): Promise<void> {\n    const toShutdown = [...this.runtimes.values()];\n    this.runtimes.clear();\n    await Promise.allSettled(\n      toShutdown.map((rt) =>\n        rt.memoryManager.shutdownAll().catch((err) => {\n          log.warn({ err }, 'memoryManager.shutdownAll failed');\n        }),\n      ),\n    );\n  }\n}\n"],"mappings":";;;;;;;;aAwBqD;AAErD,MAAM,MAAM,aAAa,2BAA2B;AAgBpD,IAAa,2BAAb,MAAsC;CACpC,2BAA4B,IAAI,KAA+B;CAC/D;CACA;CAEA,YAAY,MAAuC;AACjD,OAAK,YAAY,KAAK;AACtB,OAAK,mBAAmB,KAAK;;;CAI/B,YAAY,cAAwC;EAClD,MAAM,WAAW,KAAK,SAAS,IAAI,aAAa;AAChD,MAAI,SACF,QAAO;EAGT,MAAM,MAAM,KAAK,WAAW;EAC5B,MAAM,qBAAqB,IAAI,mBAC7B,gCAAgC,cAAc,IAAI,CACnD;EACD,MAAM,gBAAgB,8BAA8B,cAAc,oBAAoB,IAAI;EAC1F,MAAM,eAAe,IAAI,aAAa,cAAc,KAAK,iBAAiB;EAO1E,MAAM,KAAuB;GAC3B;GACA,qBAAA,IAR8B,oBAAoB;IAClD,WAAW;IACX,QAAQ;IACR;IACD,CAIoB;GACnB;GACA;GACD;AACD,OAAK,SAAS,IAAI,cAAc,GAAG;AACnC,SAAO;;;CAIT,SAA6C;AAC3C,SAAO,KAAK,SAAS,QAAQ;;;;;;CAO/B,MAAM,WAA0B;EAC9B,MAAM,aAAa,CAAC,GAAG,KAAK,SAAS,QAAQ,CAAC;AAC9C,OAAK,SAAS,OAAO;AACrB,QAAM,QAAQ,WACZ,WAAW,KAAK,OACd,GAAG,cAAc,aAAa,CAAC,OAAO,QAAQ;AAC5C,OAAI,KAAK,EAAE,KAAK,EAAE,mCAAmC;IACrD,CACH,CACF"}

package/dist/src/auth/credentials.js

@@ -1,11 +1,11 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
-import { dirname, join } from "path";
+import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
 import { mkdir, readFile } from "fs/promises";
+import { dirname, join } from "path";
 //#region src/auth/credentials.ts
 function getCredentialResolver(options) {
 	return new CredentialResolver(options);

package/dist/src/auth/profiles/store.js

@@ -1,6 +1,6 @@
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
-import path from "node:path";
 import { chmodSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import path from "node:path";
 import { homedir } from "os";
 //#region src/auth/profiles/store.ts
 /**

package/dist/src/auth/sync-provider-auth.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveOAuthPath } from "../config/paths.js";
 import { init_loader, loadConfig } from "../config/loader.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/auth/sync-provider-auth.ts
 /**

package/dist/src/browser/cdp-local-launcher.js

@@ -1,10 +1,11 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { loadPlaywrightCoreModule } from "./providers/playwright-doctor.js";
 import { pickFreePort } from "./free-port.js";
-import { join } from "node:path";
-import { homedir, platform } from "node:os";
 import { existsSync } from "node:fs";
 import { mkdir, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir, platform } from "node:os";
 import { spawn } from "node:child_process";
 //#region src/browser/cdp-local-launcher.ts
 /**
@@ -31,7 +32,7 @@ async function resolveChromeBinary(override) {
 		return candidate;
 	}
 	try {
-		const pw = await import("playwright-core");
+		const pw = await loadPlaywrightCoreModule();
 		const exec = (pw.chromium ?? pw.default?.chromium)?.executablePath?.();
 		if (exec && existsSync(exec)) return exec;
 	} catch {}

package/dist/src/browser/cdp-local-launcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"cdp-local-launcher.js","names":["osPlatform"],"sources":["../../../src/browser/cdp-local-launcher.ts"],"sourcesContent":["/**\n * Launches a Chromium / Chrome instance locally with `--remote-debugging-port`\n * so the user can wire CDP backend without typing the command themselves.\n *\n * Instances live for the lifetime of the gateway process (no on-disk state).\n * Launching binds the debug port to 127.0.0.1; the user-data-dir is rooted\n * under `~/.xopc/cdp-launch/` and removed on stop.\n */\n\nimport { existsSync } from 'node:fs';\nimport { mkdir, rm } from 'node:fs/promises';\nimport { homedir, platform as osPlatform } from 'node:os';\nimport { join } from 'node:path';\nimport { ChildProcess, spawn } from 'node:child_process';\n\nimport { createLogger } from '../utils/logger.js';\n\nimport { pickFreePort } from './free-port.js';\n\nconst log = createLogger('CdpLocalLauncher');\n\nconst READY_TIMEOUT_MS = 20_000;\nconst READY_POLL_INTERVAL_MS = 250;\n\nexport interface LaunchedCdpInstance {\n  /** Debug port the instance listens on (loopback). */\n  port: number;\n  /** Browser-level WS endpoint, ready for Playwright `connectOverCDP`. */\n  wsEndpoint: string;\n  /** Browser process pid. */\n  pid: number;\n  /** Resolved Chrome / Chromium binary path used to spawn. */\n  executablePath: string;\n  /** Temporary `--user-data-dir`. Deleted on stop. */\n  userDataDir: string;\n  /** Wall-clock spawn time (ms epoch). */\n  startedAt: number;\n}\n\ninterface InstanceEntry extends LaunchedCdpInstance {\n  child: ChildProcess;\n}\n\nconst instances = new Map<number, InstanceEntry>();\n\nfunction defaultUserDataRoot(): string {\n  return join(homedir(), '.xopc', 'cdp-launch');\n}\n\n/** Resolve a Chrome / Chromium executable for the current platform. */\nexport async function resolveChromeBinary(override?: string): Promise<string> {\n  if (override && override.trim()) {\n    const candidate = override.trim();\n    if (!existsSync(candidate)) {\n      throw new Error(`Chrome executable not found at ${candidate}`);\n    }\n    return candidate;\n  }\n\n  try {\n    const pw = await import('playwright-core');\n    const chromium = pw.chromium\n      ?? (pw as { default?: { chromium?: (typeof pw)['chromium'] } }).default?.chromium;\n    const exec = chromium?.executablePath?.();\n    if (exec && existsSync(exec)) {\n      return exec;\n    }\n  } catch {\n    // playwright-core unavailable — fall through to system probes\n  }\n\n  const os = osPlatform();\n  const probes: string[] =\n    os === 'darwin'\n      ? [\n          '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',\n          '/Applications/Chromium.app/Contents/MacOS/Chromium',\n          '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',\n        ]\n      : os === 'win32'\n        ? [\n            'C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n            'C:\\\\Program Files (x86)\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n          ]\n        : ['/usr/bin/google-chrome', '/usr/bin/chromium', '/usr/bin/chromium-browser', '/snap/bin/chromium'];\n\n  for (const path of probes) {\n    if (existsSync(path)) return path;\n  }\n  throw new Error(\n    'No Chrome / Chromium binary found. Install Chrome or run `npx playwright install chromium` first.',\n  );\n}\n\nasync function waitForCdpEndpoint(port: number): Promise<string> {\n  const deadline = Date.now() + READY_TIMEOUT_MS;\n  while (Date.now() < deadline) {\n    try {\n      const res = await fetch(`http://127.0.0.1:${port}/json/version`, {\n        signal: AbortSignal.timeout(1500),\n      });\n      if (res.ok) {\n        const data = (await res.json()) as { webSocketDebuggerUrl?: string };\n        if (data.webSocketDebuggerUrl) return data.webSocketDebuggerUrl;\n      }\n    } catch {\n      // not ready yet\n    }\n    await new Promise((r) => setTimeout(r, READY_POLL_INTERVAL_MS));\n  }\n  throw new Error(`Chrome did not expose CDP within ${READY_TIMEOUT_MS / 1000}s on port ${port}`);\n}\n\nexport interface LaunchOptions {\n  /** Optional override for the Chrome / Chromium binary. */\n  executablePath?: string;\n  /** Run headless. Default false (visible window so user can interact). */\n  headless?: boolean;\n}\n\nexport async function launchLocalCdpChrome(opts: LaunchOptions = {}): Promise<LaunchedCdpInstance> {\n  const executablePath = await resolveChromeBinary(opts.executablePath);\n  const port = await pickFreePort();\n\n  const root = defaultUserDataRoot();\n  await mkdir(root, { recursive: true });\n  const userDataDir = join(root, `${process.pid}-${port}`);\n  await mkdir(userDataDir, { recursive: true });\n\n  const args = [\n    `--remote-debugging-address=127.0.0.1`,\n    `--remote-debugging-port=${port}`,\n    `--user-data-dir=${userDataDir}`,\n    '--no-first-run',\n    '--no-default-browser-check',\n  ];\n  if (opts.headless) args.push('--headless=new');\n  if (osPlatform() === 'darwin') args.push('--use-mock-keychain');\n\n  log.info({ executablePath, port, userDataDir }, 'Spawning local debuggable Chrome');\n\n  const child = spawn(executablePath, args, {\n    stdio: ['ignore', 'ignore', 'ignore'],\n    detached: false,\n  });\n\n  // Surface early launch failures before waitForCdpEndpoint times out.\n  const launchFailure = new Promise<never>((_resolve, reject) => {\n    const onErr = (err: Error) => reject(new Error(`spawn failed: ${err.message}`));\n    const onExit = (code: number | null, signal: NodeJS.Signals | null) => {\n      const reason = signal ? `signal ${signal}` : `exit ${code ?? 'unknown'}`;\n      reject(new Error(`Chrome exited before CDP came up (${reason})`));\n    };\n    child.once('error', onErr);\n    child.once('exit', onExit);\n  });\n\n  let wsEndpoint: string;\n  try {\n    wsEndpoint = await Promise.race([waitForCdpEndpoint(port), launchFailure]);\n  } catch (e) {\n    child.kill();\n    await rm(userDataDir, { recursive: true, force: true }).catch(() => {});\n    throw e;\n  }\n\n  const entry: InstanceEntry = {\n    port,\n    wsEndpoint,\n    pid: child.pid ?? -1,\n    executablePath,\n    userDataDir,\n    startedAt: Date.now(),\n    child,\n  };\n  instances.set(port, entry);\n\n  // If Chrome exits on its own, drop bookkeeping so /instances reflects truth.\n  child.once('exit', () => {\n    instances.delete(port);\n    void rm(userDataDir, { recursive: true, force: true }).catch(() => {});\n    log.info({ port }, 'Local CDP Chrome exited');\n  });\n\n  return toPublic(entry);\n}\n\nexport async function stopLocalCdpChrome(port: number): Promise<boolean> {\n  const entry = instances.get(port);\n  if (!entry) return false;\n  entry.child.kill();\n  // exit handler will clean up the map and user-data-dir.\n  return true;\n}\n\nexport function listLocalCdpInstances(): LaunchedCdpInstance[] {\n  return [...instances.values()].map(toPublic);\n}\n\nfunction toPublic(entry: InstanceEntry): LaunchedCdpInstance {\n  const { child: _child, ...pub } = entry;\n  return pub;\n}\n\n/** Graceful shutdown — call from gateway exit hooks. */\nexport async function stopAllLocalCdpChromes(): Promise<void> {\n  for (const [port] of instances) {\n    await stopLocalCdpChrome(port);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"cdp-local-launcher.js","names":["osPlatform"],"sources":["../../../src/browser/cdp-local-launcher.ts"],"sourcesContent":["/**\n * Launches a Chromium / Chrome instance locally with `--remote-debugging-port`\n * so the user can wire CDP backend without typing the command themselves.\n *\n * Instances live for the lifetime of the gateway process (no on-disk state).\n * Launching binds the debug port to 127.0.0.1; the user-data-dir is rooted\n * under `~/.xopc/cdp-launch/` and removed on stop.\n */\n\nimport { existsSync } from 'node:fs';\nimport { mkdir, rm } from 'node:fs/promises';\nimport { homedir, platform as osPlatform } from 'node:os';\nimport { join } from 'node:path';\nimport { ChildProcess, spawn } from 'node:child_process';\n\nimport { createLogger } from '../utils/logger.js';\n\nimport { pickFreePort } from './free-port.js';\nimport { loadPlaywrightCoreModule } from './providers/playwright-doctor.js';\n\nconst log = createLogger('CdpLocalLauncher');\n\nconst READY_TIMEOUT_MS = 20_000;\nconst READY_POLL_INTERVAL_MS = 250;\n\nexport interface LaunchedCdpInstance {\n  /** Debug port the instance listens on (loopback). */\n  port: number;\n  /** Browser-level WS endpoint, ready for Playwright `connectOverCDP`. */\n  wsEndpoint: string;\n  /** Browser process pid. */\n  pid: number;\n  /** Resolved Chrome / Chromium binary path used to spawn. */\n  executablePath: string;\n  /** Temporary `--user-data-dir`. Deleted on stop. */\n  userDataDir: string;\n  /** Wall-clock spawn time (ms epoch). */\n  startedAt: number;\n}\n\ninterface InstanceEntry extends LaunchedCdpInstance {\n  child: ChildProcess;\n}\n\nconst instances = new Map<number, InstanceEntry>();\n\nfunction defaultUserDataRoot(): string {\n  return join(homedir(), '.xopc', 'cdp-launch');\n}\n\n/** Resolve a Chrome / Chromium executable for the current platform. */\nexport async function resolveChromeBinary(override?: string): Promise<string> {\n  if (override && override.trim()) {\n    const candidate = override.trim();\n    if (!existsSync(candidate)) {\n      throw new Error(`Chrome executable not found at ${candidate}`);\n    }\n    return candidate;\n  }\n\n  try {\n    const pw = await loadPlaywrightCoreModule();\n    const chromium = pw.chromium\n      ?? (pw as { default?: { chromium?: (typeof pw)['chromium'] } }).default?.chromium;\n    const exec = chromium?.executablePath?.();\n    if (exec && existsSync(exec)) {\n      return exec;\n    }\n  } catch {\n    // playwright-core unavailable — fall through to system probes\n  }\n\n  const os = osPlatform();\n  const probes: string[] =\n    os === 'darwin'\n      ? [\n          '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',\n          '/Applications/Chromium.app/Contents/MacOS/Chromium',\n          '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',\n        ]\n      : os === 'win32'\n        ? [\n            'C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n            'C:\\\\Program Files (x86)\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n          ]\n        : ['/usr/bin/google-chrome', '/usr/bin/chromium', '/usr/bin/chromium-browser', '/snap/bin/chromium'];\n\n  for (const path of probes) {\n    if (existsSync(path)) return path;\n  }\n  throw new Error(\n    'No Chrome / Chromium binary found. Install Chrome or run `npx playwright install chromium` first.',\n  );\n}\n\nasync function waitForCdpEndpoint(port: number): Promise<string> {\n  const deadline = Date.now() + READY_TIMEOUT_MS;\n  while (Date.now() < deadline) {\n    try {\n      const res = await fetch(`http://127.0.0.1:${port}/json/version`, {\n        signal: AbortSignal.timeout(1500),\n      });\n      if (res.ok) {\n        const data = (await res.json()) as { webSocketDebuggerUrl?: string };\n        if (data.webSocketDebuggerUrl) return data.webSocketDebuggerUrl;\n      }\n    } catch {\n      // not ready yet\n    }\n    await new Promise((r) => setTimeout(r, READY_POLL_INTERVAL_MS));\n  }\n  throw new Error(`Chrome did not expose CDP within ${READY_TIMEOUT_MS / 1000}s on port ${port}`);\n}\n\nexport interface LaunchOptions {\n  /** Optional override for the Chrome / Chromium binary. */\n  executablePath?: string;\n  /** Run headless. Default false (visible window so user can interact). */\n  headless?: boolean;\n}\n\nexport async function launchLocalCdpChrome(opts: LaunchOptions = {}): Promise<LaunchedCdpInstance> {\n  const executablePath = await resolveChromeBinary(opts.executablePath);\n  const port = await pickFreePort();\n\n  const root = defaultUserDataRoot();\n  await mkdir(root, { recursive: true });\n  const userDataDir = join(root, `${process.pid}-${port}`);\n  await mkdir(userDataDir, { recursive: true });\n\n  const args = [\n    `--remote-debugging-address=127.0.0.1`,\n    `--remote-debugging-port=${port}`,\n    `--user-data-dir=${userDataDir}`,\n    '--no-first-run',\n    '--no-default-browser-check',\n  ];\n  if (opts.headless) args.push('--headless=new');\n  if (osPlatform() === 'darwin') args.push('--use-mock-keychain');\n\n  log.info({ executablePath, port, userDataDir }, 'Spawning local debuggable Chrome');\n\n  const child = spawn(executablePath, args, {\n    stdio: ['ignore', 'ignore', 'ignore'],\n    detached: false,\n  });\n\n  // Surface early launch failures before waitForCdpEndpoint times out.\n  const launchFailure = new Promise<never>((_resolve, reject) => {\n    const onErr = (err: Error) => reject(new Error(`spawn failed: ${err.message}`));\n    const onExit = (code: number | null, signal: NodeJS.Signals | null) => {\n      const reason = signal ? `signal ${signal}` : `exit ${code ?? 'unknown'}`;\n      reject(new Error(`Chrome exited before CDP came up (${reason})`));\n    };\n    child.once('error', onErr);\n    child.once('exit', onExit);\n  });\n\n  let wsEndpoint: string;\n  try {\n    wsEndpoint = await Promise.race([waitForCdpEndpoint(port), launchFailure]);\n  } catch (e) {\n    child.kill();\n    await rm(userDataDir, { recursive: true, force: true }).catch(() => {});\n    throw e;\n  }\n\n  const entry: InstanceEntry = {\n    port,\n    wsEndpoint,\n    pid: child.pid ?? -1,\n    executablePath,\n    userDataDir,\n    startedAt: Date.now(),\n    child,\n  };\n  instances.set(port, entry);\n\n  // If Chrome exits on its own, drop bookkeeping so /instances reflects truth.\n  child.once('exit', () => {\n    instances.delete(port);\n    void rm(userDataDir, { recursive: true, force: true }).catch(() => {});\n    log.info({ port }, 'Local CDP Chrome exited');\n  });\n\n  return toPublic(entry);\n}\n\nexport async function stopLocalCdpChrome(port: number): Promise<boolean> {\n  const entry = instances.get(port);\n  if (!entry) return false;\n  entry.child.kill();\n  // exit handler will clean up the map and user-data-dir.\n  return true;\n}\n\nexport function listLocalCdpInstances(): LaunchedCdpInstance[] {\n  return [...instances.values()].map(toPublic);\n}\n\nfunction toPublic(entry: InstanceEntry): LaunchedCdpInstance {\n  const { child: _child, ...pub } = entry;\n  return pub;\n}\n\n/** Graceful shutdown — call from gateway exit hooks. */\nexport async function stopAllLocalCdpChromes(): Promise<void> {\n  for (const [port] of instances) {\n    await stopLocalCdpChrome(port);\n  }\n}\n"],"mappings":"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"}

package/dist/src/browser/index.d.ts

@@ -1,6 +1,7 @@
 export { BrowserManager, type BrowserManagerOptions } from './manager.js';
 export { resolveBrowserBackendFromConfig } from './backend-from-config.js';
 export { resolveBrowserCommandTimeoutMs } from './browser-command-timeout.js';
+export { BrowserNotReadyError, buildBrowserSetupDeepLink, checkBrowserReadiness, type BrowserBackendKind, type BrowserNotReadyReason, type BrowserSetupHint, } from './readiness.js';
 export { assertBrowserUrlAllowed, checkPostRedirectUrl, containsApiKeyPattern, isAlwaysBlockedUrl, } from './url-policy.js';
 export { CdpSupervisor, type DialogEvent, type ConsoleEntry, type DialogPolicy } from './cdp-supervisor.js';
 export { truncateSnapshotAtBoundary, snapshotSummaryHeader } from './snapshot-helpers.js';

package/dist/src/browser/index.js

@@ -4,6 +4,7 @@ import { assertBrowserUrlAllowed, checkPostRedirectUrl, containsApiKeyPattern, i
 import { snapshotSummaryHeader, truncateSnapshotAtBoundary } from "./snapshot-helpers.js";
 import { BrowserManager } from "./manager.js";
 import { resolveBrowserBackendFromConfig } from "./backend-from-config.js";
+import { BrowserNotReadyError, buildBrowserSetupDeepLink, checkBrowserReadiness } from "./readiness.js";
 import { CdpSupervisor } from "./cdp-supervisor.js";
 import { checkBotDetection, cleanupOrphanProcesses, startTracing, stopTracing } from "./session-lifecycle.js";
 import { generateMousePath, generateScrollPlan, generateTypingPlan, humanizedClick, humanizedFill, humanizedPress, humanizedScroll, resolveHumanConfig } from "./humanize.js";
@@ -13,4 +14,4 @@ import { parseBrowserPipeline } from "./pipeline/schema.js";
 import { resolveTemplate, resolveTemplateDeep } from "./pipeline/template.js";
 import { runBrowserPipeline, validateBrowserPipeline } from "./pipeline/runner.js";
 import { loadBrowserPipelineSource } from "./pipeline/source.js";
-export { BrowserBackSchema, BrowserCdpSchema, BrowserClickSchema, BrowserCloseSchema, BrowserConsoleSchema, BrowserDialogSchema, BrowserGetImagesSchema, BrowserManager, BrowserNavigateSchema, BrowserPressSchema, BrowserScreenshotSchema, BrowserScrollSchema, BrowserSnapshotSchema, BrowserTypeSchema, BrowserVisionSchema, CdpSupervisor, WEBDRIVER_OVERRIDE_SCRIPT, assertBrowserUrlAllowed, buildLocalStealthArgs, buildStealthArgs, checkBotDetection, checkPostRedirectUrl, cleanupOrphanProcesses, containsApiKeyPattern, createBrowserActionRegistry, generateFingerprintSeed, generateMousePath, generateScrollPlan, generateTypingPlan, humanizedClick, humanizedFill, humanizedPress, humanizedScroll, isAlwaysBlockedUrl, loadBrowserPipelineSource, makeExecutable, parseBrowserPipeline, removeQuarantineAttr, resolveBrowserBackendFromConfig, resolveBrowserCommandTimeoutMs, resolveHumanConfig, resolveTemplate, resolveTemplateDeep, runBrowserPipeline, snapshotSummaryHeader, startTracing, stopTracing, truncateSnapshotAtBoundary, validateBrowserPipeline };
+export { BrowserBackSchema, BrowserCdpSchema, BrowserClickSchema, BrowserCloseSchema, BrowserConsoleSchema, BrowserDialogSchema, BrowserGetImagesSchema, BrowserManager, BrowserNavigateSchema, BrowserNotReadyError, BrowserPressSchema, BrowserScreenshotSchema, BrowserScrollSchema, BrowserSnapshotSchema, BrowserTypeSchema, BrowserVisionSchema, CdpSupervisor, WEBDRIVER_OVERRIDE_SCRIPT, assertBrowserUrlAllowed, buildBrowserSetupDeepLink, buildLocalStealthArgs, buildStealthArgs, checkBotDetection, checkBrowserReadiness, checkPostRedirectUrl, cleanupOrphanProcesses, containsApiKeyPattern, createBrowserActionRegistry, generateFingerprintSeed, generateMousePath, generateScrollPlan, generateTypingPlan, humanizedClick, humanizedFill, humanizedPress, humanizedScroll, isAlwaysBlockedUrl, loadBrowserPipelineSource, makeExecutable, parseBrowserPipeline, removeQuarantineAttr, resolveBrowserBackendFromConfig, resolveBrowserCommandTimeoutMs, resolveHumanConfig, resolveTemplate, resolveTemplateDeep, runBrowserPipeline, snapshotSummaryHeader, startTracing, stopTracing, truncateSnapshotAtBoundary, validateBrowserPipeline };

package/dist/src/browser/manager.js

@@ -1,5 +1,6 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { loadPlaywrightCoreModule } from "./providers/playwright-doctor.js";
 //#region src/browser/manager.ts
 init_logger();
 const log = createLogger("browser-manager");
@@ -124,7 +125,7 @@ var BrowserManager = class {
 		return this.context;
 	}
 	async _launchLocal(headless) {
-		const pw = await import("playwright-core");
+		const pw = await loadPlaywrightCoreModule();
 		const chromium = pw.chromium ?? pw.default?.chromium;
 		if (!chromium?.launch) throw new Error("playwright-core did not expose chromium (try reinstall: pnpm install playwright-core; install browser: npx playwright install chromium)");
 		this.browser = await chromium.launch({
@@ -145,7 +146,7 @@ var BrowserManager = class {
 		}, "Browser launched (local)");
 	}
 	async _connectViaCdp(wsEndpoint) {
-		const pw = await import("playwright-core");
+		const pw = await loadPlaywrightCoreModule();
 		const chromium = pw.chromium ?? pw.default?.chromium;
 		if (!chromium?.connectOverCDP) throw new Error("playwright-core does not support connectOverCDP");
 		this.browser = await chromium.connectOverCDP(wsEndpoint);

package/dist/src/browser/manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"manager.js","names":[],"sources":["../../../src/browser/manager.ts"],"sourcesContent":["import type { Browser, BrowserContext, Page } from 'playwright-core';\n\nimport { createLogger } from '../utils/logger.js';\n\nimport type { BrowserBackend, CloudBrowserProvider, CloudBrowserProviderConfig, ExtensionConnectionConfig } from './providers/types.js';\nimport type { ExtensionBrowserProvider } from './providers/extension.js';\n\nconst log = createLogger('browser-manager');\n\nconst MAX_PAGES = 3;\nconst PAGE_IDLE_TIMEOUT_MS = 5 * 60 * 1000;\n\nexport interface BrowserManagerOptions {\n  getHeadless: () => boolean;\n  /** Backend connection mode. Default: local Playwright. */\n  getBackend?: () => BrowserBackend;\n}\n\n/**\n * Multi-backend browser manager — supports local Playwright, direct CDP, and cloud providers.\n *\n * One browser context shared by all sessions; one {@link Page} per task/session key (max {@link MAX_PAGES}).\n * Backend is selected at first connection based on {@link BrowserManagerOptions.getBackend}.\n */\nexport class BrowserManager {\n  private browser: Browser | null = null;\n  private context: BrowserContext | null = null;\n  private cloudProvider: CloudBrowserProvider | null = null;\n  private extensionProvider: ExtensionBrowserProvider | null = null;\n  private extensionRelease: (() => Promise<void>) | null = null;\n  private cloakChildProcess: import('node:child_process').ChildProcess | null = null;\n  private cloakTempProfileDir: string | null = null;\n  private pages = new Map<string, { page: Page; lastUsed: number }>();\n  private readonly options: BrowserManagerOptions;\n  private activeBackendMode: BrowserBackend['mode'] | null = null;\n\n  constructor(options: BrowserManagerOptions) {\n    this.options = options;\n  }\n\n  /** Current backend mode (null if not yet connected). */\n  get backendMode(): string | null {\n    return this.activeBackendMode;\n  }\n\n  private evictIdlePages(): void {\n    const now = Date.now();\n    for (const [id, entry] of this.pages) {\n      if (entry.page.isClosed() || now - entry.lastUsed > PAGE_IDLE_TIMEOUT_MS) {\n        void entry.page.close().catch(() => {});\n        this.pages.delete(id);\n        log.debug({ taskId: id }, 'Evicted idle or closed browser page');\n      }\n    }\n  }\n\n  private _isPlaywrightConnectionAlive(): boolean {\n    if (!this.browser || !this.context) return false;\n    try {\n      if (typeof this.browser.isConnected === 'function' && !this.browser.isConnected()) {\n        return false;\n      }\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private _wireBrowserLifecycle(browser: Browser): void {\n    browser.on('disconnected', () => {\n      log.warn({ mode: this.activeBackendMode }, 'Browser disconnected — clearing stale session');\n      this._clearPlaywrightSessionRefs();\n    });\n  }\n\n  /** Drop Playwright handles without tearing down extension bridge. */\n  private _clearPlaywrightSessionRefs(): void {\n    this.pages.clear();\n    this.context = null;\n    this.browser = null;\n    this.cloakChildProcess = null;\n    this.cloakTempProfileDir = null;\n    if (this.cloudProvider) {\n      void this.cloudProvider.disconnect().catch(() => {});\n      this.cloudProvider = null;\n    }\n  }\n\n  private async _resetStalePlaywrightSession(): Promise<void> {\n    for (const [, entry] of this.pages) {\n      await entry.page.close().catch(() => {});\n    }\n    this.pages.clear();\n\n    if (this.cloudProvider) {\n      await this.cloudProvider.disconnect().catch(() => {});\n      this.cloudProvider = null;\n    }\n\n    if (this.cloakChildProcess || this.cloakTempProfileDir) {\n      const { cleanupCloakBrowser } = await import('./providers/cloakbrowser.js');\n      await cleanupCloakBrowser(this.cloakChildProcess, this.cloakTempProfileDir).catch(() => {});\n      this.cloakChildProcess = null;\n      this.cloakTempProfileDir = null;\n    }\n\n    await this.context?.close().catch(() => {});\n    await this.browser?.close().catch(() => {});\n    this.context = null;\n    this.browser = null;\n  }\n\n  /**\n   * Ensure Playwright context or Chrome Extension provider is ready.\n   * Extension mode does not create a Playwright {@link BrowserContext}.\n   */\n  async ensureConnected(): Promise<void> {\n    if (this.extensionProvider) return;\n\n    if (this.context && this._isPlaywrightConnectionAlive()) {\n      return;\n    }\n\n    if (this.context || this.browser) {\n      log.warn({ mode: this.activeBackendMode }, 'Browser session unavailable — reconnecting');\n      await this._resetStalePlaywrightSession();\n    }\n\n    const backend = this.options.getBackend?.() ?? { mode: 'local' as const, headless: false };\n\n    switch (backend.mode) {\n      case 'cdp':\n        await this._connectViaCdp(backend.config.wsEndpoint);\n        break;\n      case 'cloud':\n        await this._connectViaCloud(backend.config);\n        break;\n      case 'extension':\n        await this._connectViaExtension(backend.config);\n        break;\n      case 'cloakbrowser':\n        await this._connectViaCloakBrowser(backend.config);\n        break;\n      case 'local':\n      default:\n        await this._launchLocal(backend.mode === 'local' ? backend.headless : this.options.getHeadless() === true);\n        break;\n    }\n\n    this.activeBackendMode = backend.mode;\n    if (this.browser) {\n      this._wireBrowserLifecycle(this.browser);\n    }\n  }\n\n  /** @deprecated Use {@link ensureConnected}. */\n  async ensureBrowser(): Promise<BrowserContext> {\n    await this.ensureConnected();\n    if (!this.context) {\n      throw new Error('ensureBrowser: no Playwright context (extension backend uses ensureConnected + registry bridge)');\n    }\n    return this.context;\n  }\n\n  private async _launchLocal(headless: boolean): Promise<void> {\n    const pw = await import('playwright-core');\n    const chromium = pw.chromium ?? (pw as { default?: { chromium?: (typeof pw)['chromium'] } }).default?.chromium;\n    if (!chromium?.launch) {\n      throw new Error(\n        'playwright-core did not expose chromium (try reinstall: pnpm install playwright-core; install browser: npx playwright install chromium)',\n      );\n    }\n    this.browser = await chromium.launch({\n      headless,\n      ...(headless ? { channel: 'chromium' } : {}),\n      args: ['--no-sandbox', '--disable-setuid-sandbox'],\n    });\n    this.context = await this.browser.newContext({\n      viewport: { width: 1280, height: 720 },\n      userAgent:\n        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',\n    });\n    log.info({ headless, mode: 'local' }, 'Browser launched (local)');\n  }\n\n  private async _connectViaCdp(wsEndpoint: string): Promise<void> {\n    const pw = await import('playwright-core');\n    const chromium = pw.chromium ?? (pw as { default?: { chromium?: (typeof pw)['chromium'] } }).default?.chromium;\n    if (!chromium?.connectOverCDP) {\n      throw new Error('playwright-core does not support connectOverCDP');\n    }\n    this.browser = await chromium.connectOverCDP(wsEndpoint);\n    const contexts = this.browser.contexts();\n    this.context = contexts.length > 0 ? contexts[0] : await this.browser.newContext();\n    log.info({ mode: 'cdp', wsEndpoint }, 'Browser connected (CDP)');\n  }\n\n  private async _connectViaCloud(config: CloudBrowserProviderConfig): Promise<void> {\n    const { BrowserbaseProvider } = await import('./providers/browserbase.js');\n    const { BrowserUseProvider } = await import('./providers/browser-use.js');\n\n    const provider = config.type === 'browserbase'\n      ? new BrowserbaseProvider(config)\n      : new BrowserUseProvider(config);\n\n    const { browser, context } = await provider.connect();\n    this.browser = browser;\n    this.context = context;\n    this.cloudProvider = provider;\n    log.info({ mode: 'cloud', provider: config.type }, `Browser connected (${config.type})`);\n  }\n\n  private async _connectViaExtension(config?: ExtensionConnectionConfig): Promise<void> {\n    const { acquireExtensionBrowserServer } = await import('./providers/extension-ws-acquire.js');\n    const { provider, release } = await acquireExtensionBrowserServer(config);\n    this.extensionProvider = provider;\n    this.extensionRelease = release;\n    log.info({ port: config?.port ?? 19820 }, 'Extension WS server ready, waiting for Chrome Extension...');\n    await provider.waitForConnection();\n    // Extension mode does not use Playwright — context stays null.\n    // The action registry dispatches directly via extensionProvider.sendCommand().\n    log.info({ mode: 'extension' }, 'Browser connected (Chrome Extension)');\n  }\n\n  private async _connectViaCloakBrowser(config?: import('./providers/types.js').CloakBrowserConfig): Promise<void> {\n    const { launchCloakBrowser } = await import('./providers/cloakbrowser.js');\n    const result = await launchCloakBrowser(config);\n    if (!result.browser || !result.context) {\n      throw new Error('BrowserManager: CloakBrowser launch did not return a Playwright connection');\n    }\n    this.browser = result.browser;\n    this.context = result.context;\n    this.cloakChildProcess = result.childProcess;\n    this.cloakTempProfileDir = result.temporaryProfileDir;\n    log.info({ mode: 'cloakbrowser' }, 'Browser connected (CloakBrowser)');\n  }\n\n  async getPage(taskId: string): Promise<Page> {\n    if (this.extensionProvider) {\n      throw new Error('BrowserManager.getPage is not used in Chrome Extension backend mode');\n    }\n\n    this.evictIdlePages();\n    await this.ensureConnected();\n\n    const existing = this.pages.get(taskId);\n    if (existing && !existing.page.isClosed()) {\n      existing.lastUsed = Date.now();\n      return existing.page;\n    }\n    if (existing) {\n      this.pages.delete(taskId);\n    }\n\n    if (this.pages.size >= MAX_PAGES) {\n      const oldest = [...this.pages.entries()].sort((a, b) => a[1].lastUsed - b[1].lastUsed)[0];\n      if (oldest) {\n        await oldest[1].page.close().catch(() => {});\n        this.pages.delete(oldest[0]);\n      }\n    }\n\n    const ctx = this.context;\n    if (!ctx) {\n      throw new Error('BrowserManager: Playwright context missing after ensureConnected');\n    }\n    const page = await ctx.newPage();\n    this.pages.set(taskId, { page, lastUsed: Date.now() });\n    return page;\n  }\n\n  async closePage(taskId: string): Promise<void> {\n    if (this.extensionProvider) {\n      return;\n    }\n    const entry = this.pages.get(taskId);\n    if (entry) {\n      await entry.page.close().catch(() => {});\n      this.pages.delete(taskId);\n    }\n  }\n\n  /** Get the extension provider (only available in extension mode). */\n  getExtensionProvider(): ExtensionBrowserProvider | null {\n    return this.extensionProvider;\n  }\n\n  async shutdown(): Promise<void> {\n    for (const [, entry] of this.pages) {\n      await entry.page.close().catch(() => {});\n    }\n    this.pages.clear();\n\n    if (this.cloudProvider) {\n      await this.cloudProvider.disconnect().catch(() => {});\n      this.cloudProvider = null;\n    }\n\n    if (this.extensionRelease) {\n      await this.extensionRelease().catch(() => {});\n      this.extensionRelease = null;\n    }\n    this.extensionProvider = null;\n\n    // CloakBrowser cleanup — kill child process and remove temp profile\n    if (this.cloakChildProcess || this.cloakTempProfileDir) {\n      const { cleanupCloakBrowser } = await import('./providers/cloakbrowser.js');\n      await cleanupCloakBrowser(this.cloakChildProcess, this.cloakTempProfileDir).catch(() => {});\n      this.cloakChildProcess = null;\n      this.cloakTempProfileDir = null;\n    }\n\n    await this.context?.close().catch(() => {});\n    await this.browser?.close().catch(() => {});\n    this.context = null;\n    this.browser = null;\n    this.activeBackendMode = null;\n    log.info('Browser shut down');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"manager.js","names":[],"sources":["../../../src/browser/manager.ts"],"sourcesContent":["import type { Browser, BrowserContext, Page } from 'playwright-core';\n\nimport { createLogger } from '../utils/logger.js';\n\nimport { loadPlaywrightCoreModule } from './providers/playwright-doctor.js';\nimport type { BrowserBackend, CloudBrowserProvider, CloudBrowserProviderConfig, ExtensionConnectionConfig } from './providers/types.js';\nimport type { ExtensionBrowserProvider } from './providers/extension.js';\n\nconst log = createLogger('browser-manager');\n\nconst MAX_PAGES = 3;\nconst PAGE_IDLE_TIMEOUT_MS = 5 * 60 * 1000;\n\nexport interface BrowserManagerOptions {\n  getHeadless: () => boolean;\n  /** Backend connection mode. Default: local Playwright. */\n  getBackend?: () => BrowserBackend;\n}\n\n/**\n * Multi-backend browser manager — supports local Playwright, direct CDP, and cloud providers.\n *\n * One browser context shared by all sessions; one {@link Page} per task/session key (max {@link MAX_PAGES}).\n * Backend is selected at first connection based on {@link BrowserManagerOptions.getBackend}.\n */\nexport class BrowserManager {\n  private browser: Browser | null = null;\n  private context: BrowserContext | null = null;\n  private cloudProvider: CloudBrowserProvider | null = null;\n  private extensionProvider: ExtensionBrowserProvider | null = null;\n  private extensionRelease: (() => Promise<void>) | null = null;\n  private cloakChildProcess: import('node:child_process').ChildProcess | null = null;\n  private cloakTempProfileDir: string | null = null;\n  private pages = new Map<string, { page: Page; lastUsed: number }>();\n  private readonly options: BrowserManagerOptions;\n  private activeBackendMode: BrowserBackend['mode'] | null = null;\n\n  constructor(options: BrowserManagerOptions) {\n    this.options = options;\n  }\n\n  /** Current backend mode (null if not yet connected). */\n  get backendMode(): string | null {\n    return this.activeBackendMode;\n  }\n\n  private evictIdlePages(): void {\n    const now = Date.now();\n    for (const [id, entry] of this.pages) {\n      if (entry.page.isClosed() || now - entry.lastUsed > PAGE_IDLE_TIMEOUT_MS) {\n        void entry.page.close().catch(() => {});\n        this.pages.delete(id);\n        log.debug({ taskId: id }, 'Evicted idle or closed browser page');\n      }\n    }\n  }\n\n  private _isPlaywrightConnectionAlive(): boolean {\n    if (!this.browser || !this.context) return false;\n    try {\n      if (typeof this.browser.isConnected === 'function' && !this.browser.isConnected()) {\n        return false;\n      }\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private _wireBrowserLifecycle(browser: Browser): void {\n    browser.on('disconnected', () => {\n      log.warn({ mode: this.activeBackendMode }, 'Browser disconnected — clearing stale session');\n      this._clearPlaywrightSessionRefs();\n    });\n  }\n\n  /** Drop Playwright handles without tearing down extension bridge. */\n  private _clearPlaywrightSessionRefs(): void {\n    this.pages.clear();\n    this.context = null;\n    this.browser = null;\n    this.cloakChildProcess = null;\n    this.cloakTempProfileDir = null;\n    if (this.cloudProvider) {\n      void this.cloudProvider.disconnect().catch(() => {});\n      this.cloudProvider = null;\n    }\n  }\n\n  private async _resetStalePlaywrightSession(): Promise<void> {\n    for (const [, entry] of this.pages) {\n      await entry.page.close().catch(() => {});\n    }\n    this.pages.clear();\n\n    if (this.cloudProvider) {\n      await this.cloudProvider.disconnect().catch(() => {});\n      this.cloudProvider = null;\n    }\n\n    if (this.cloakChildProcess || this.cloakTempProfileDir) {\n      const { cleanupCloakBrowser } = await import('./providers/cloakbrowser.js');\n      await cleanupCloakBrowser(this.cloakChildProcess, this.cloakTempProfileDir).catch(() => {});\n      this.cloakChildProcess = null;\n      this.cloakTempProfileDir = null;\n    }\n\n    await this.context?.close().catch(() => {});\n    await this.browser?.close().catch(() => {});\n    this.context = null;\n    this.browser = null;\n  }\n\n  /**\n   * Ensure Playwright context or Chrome Extension provider is ready.\n   * Extension mode does not create a Playwright {@link BrowserContext}.\n   */\n  async ensureConnected(): Promise<void> {\n    if (this.extensionProvider) return;\n\n    if (this.context && this._isPlaywrightConnectionAlive()) {\n      return;\n    }\n\n    if (this.context || this.browser) {\n      log.warn({ mode: this.activeBackendMode }, 'Browser session unavailable — reconnecting');\n      await this._resetStalePlaywrightSession();\n    }\n\n    const backend = this.options.getBackend?.() ?? { mode: 'local' as const, headless: false };\n\n    switch (backend.mode) {\n      case 'cdp':\n        await this._connectViaCdp(backend.config.wsEndpoint);\n        break;\n      case 'cloud':\n        await this._connectViaCloud(backend.config);\n        break;\n      case 'extension':\n        await this._connectViaExtension(backend.config);\n        break;\n      case 'cloakbrowser':\n        await this._connectViaCloakBrowser(backend.config);\n        break;\n      case 'local':\n      default:\n        await this._launchLocal(backend.mode === 'local' ? backend.headless : this.options.getHeadless() === true);\n        break;\n    }\n\n    this.activeBackendMode = backend.mode;\n    if (this.browser) {\n      this._wireBrowserLifecycle(this.browser);\n    }\n  }\n\n  /** @deprecated Use {@link ensureConnected}. */\n  async ensureBrowser(): Promise<BrowserContext> {\n    await this.ensureConnected();\n    if (!this.context) {\n      throw new Error('ensureBrowser: no Playwright context (extension backend uses ensureConnected + registry bridge)');\n    }\n    return this.context;\n  }\n\n  private async _launchLocal(headless: boolean): Promise<void> {\n    const pw = await loadPlaywrightCoreModule();\n    const chromium = pw.chromium ?? (pw as { default?: { chromium?: (typeof pw)['chromium'] } }).default?.chromium;\n    if (!chromium?.launch) {\n      throw new Error(\n        'playwright-core did not expose chromium (try reinstall: pnpm install playwright-core; install browser: npx playwright install chromium)',\n      );\n    }\n    this.browser = await chromium.launch({\n      headless,\n      ...(headless ? { channel: 'chromium' } : {}),\n      args: ['--no-sandbox', '--disable-setuid-sandbox'],\n    });\n    this.context = await this.browser.newContext({\n      viewport: { width: 1280, height: 720 },\n      userAgent:\n        'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',\n    });\n    log.info({ headless, mode: 'local' }, 'Browser launched (local)');\n  }\n\n  private async _connectViaCdp(wsEndpoint: string): Promise<void> {\n    const pw = await loadPlaywrightCoreModule();\n    const chromium = pw.chromium ?? (pw as { default?: { chromium?: (typeof pw)['chromium'] } }).default?.chromium;\n    if (!chromium?.connectOverCDP) {\n      throw new Error('playwright-core does not support connectOverCDP');\n    }\n    this.browser = await chromium.connectOverCDP(wsEndpoint);\n    const contexts = this.browser.contexts();\n    this.context = contexts.length > 0 ? contexts[0] : await this.browser.newContext();\n    log.info({ mode: 'cdp', wsEndpoint }, 'Browser connected (CDP)');\n  }\n\n  private async _connectViaCloud(config: CloudBrowserProviderConfig): Promise<void> {\n    const { BrowserbaseProvider } = await import('./providers/browserbase.js');\n    const { BrowserUseProvider } = await import('./providers/browser-use.js');\n\n    const provider = config.type === 'browserbase'\n      ? new BrowserbaseProvider(config)\n      : new BrowserUseProvider(config);\n\n    const { browser, context } = await provider.connect();\n    this.browser = browser;\n    this.context = context;\n    this.cloudProvider = provider;\n    log.info({ mode: 'cloud', provider: config.type }, `Browser connected (${config.type})`);\n  }\n\n  private async _connectViaExtension(config?: ExtensionConnectionConfig): Promise<void> {\n    const { acquireExtensionBrowserServer } = await import('./providers/extension-ws-acquire.js');\n    const { provider, release } = await acquireExtensionBrowserServer(config);\n    this.extensionProvider = provider;\n    this.extensionRelease = release;\n    log.info({ port: config?.port ?? 19820 }, 'Extension WS server ready, waiting for Chrome Extension...');\n    await provider.waitForConnection();\n    // Extension mode does not use Playwright — context stays null.\n    // The action registry dispatches directly via extensionProvider.sendCommand().\n    log.info({ mode: 'extension' }, 'Browser connected (Chrome Extension)');\n  }\n\n  private async _connectViaCloakBrowser(config?: import('./providers/types.js').CloakBrowserConfig): Promise<void> {\n    const { launchCloakBrowser } = await import('./providers/cloakbrowser.js');\n    const result = await launchCloakBrowser(config);\n    if (!result.browser || !result.context) {\n      throw new Error('BrowserManager: CloakBrowser launch did not return a Playwright connection');\n    }\n    this.browser = result.browser;\n    this.context = result.context;\n    this.cloakChildProcess = result.childProcess;\n    this.cloakTempProfileDir = result.temporaryProfileDir;\n    log.info({ mode: 'cloakbrowser' }, 'Browser connected (CloakBrowser)');\n  }\n\n  async getPage(taskId: string): Promise<Page> {\n    if (this.extensionProvider) {\n      throw new Error('BrowserManager.getPage is not used in Chrome Extension backend mode');\n    }\n\n    this.evictIdlePages();\n    await this.ensureConnected();\n\n    const existing = this.pages.get(taskId);\n    if (existing && !existing.page.isClosed()) {\n      existing.lastUsed = Date.now();\n      return existing.page;\n    }\n    if (existing) {\n      this.pages.delete(taskId);\n    }\n\n    if (this.pages.size >= MAX_PAGES) {\n      const oldest = [...this.pages.entries()].sort((a, b) => a[1].lastUsed - b[1].lastUsed)[0];\n      if (oldest) {\n        await oldest[1].page.close().catch(() => {});\n        this.pages.delete(oldest[0]);\n      }\n    }\n\n    const ctx = this.context;\n    if (!ctx) {\n      throw new Error('BrowserManager: Playwright context missing after ensureConnected');\n    }\n    const page = await ctx.newPage();\n    this.pages.set(taskId, { page, lastUsed: Date.now() });\n    return page;\n  }\n\n  async closePage(taskId: string): Promise<void> {\n    if (this.extensionProvider) {\n      return;\n    }\n    const entry = this.pages.get(taskId);\n    if (entry) {\n      await entry.page.close().catch(() => {});\n      this.pages.delete(taskId);\n    }\n  }\n\n  /** Get the extension provider (only available in extension mode). */\n  getExtensionProvider(): ExtensionBrowserProvider | null {\n    return this.extensionProvider;\n  }\n\n  async shutdown(): Promise<void> {\n    for (const [, entry] of this.pages) {\n      await entry.page.close().catch(() => {});\n    }\n    this.pages.clear();\n\n    if (this.cloudProvider) {\n      await this.cloudProvider.disconnect().catch(() => {});\n      this.cloudProvider = null;\n    }\n\n    if (this.extensionRelease) {\n      await this.extensionRelease().catch(() => {});\n      this.extensionRelease = null;\n    }\n    this.extensionProvider = null;\n\n    // CloakBrowser cleanup — kill child process and remove temp profile\n    if (this.cloakChildProcess || this.cloakTempProfileDir) {\n      const { cleanupCloakBrowser } = await import('./providers/cloakbrowser.js');\n      await cleanupCloakBrowser(this.cloakChildProcess, this.cloakTempProfileDir).catch(() => {});\n      this.cloakChildProcess = null;\n      this.cloakTempProfileDir = null;\n    }\n\n    await this.context?.close().catch(() => {});\n    await this.browser?.close().catch(() => {});\n    this.context = null;\n    this.browser = null;\n    this.activeBackendMode = null;\n    log.info('Browser shut down');\n  }\n}\n"],"mappings":"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"}

package/dist/src/browser/providers/browser-ext-install.js

@@ -1,15 +1,15 @@
 import { PACKAGE_VERSION, init_package_version } from "../../package-version.js";
-import { assertCacheDir, init_cache_dir_policy } from "../cache-dir-policy.js";
+import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveBinDir } from "../../config/paths.js";
-import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
+import { assertCacheDir, init_cache_dir_policy } from "../cache-dir-policy.js";
 import { resolvePackageRoot } from "../../infra/update-check.js";
-import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { readFile, readdir, rm } from "node:fs/promises";
-import { spawn } from "node:child_process";
+import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
 //#region src/browser/providers/browser-ext-install.ts
 /**
 * Install bundled Chrome extension artifacts into {resolveBinDir()}/browser-ext/{version}/.

package/dist/src/browser/providers/browser-use.js

@@ -1,5 +1,6 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { loadPlaywrightCoreModule } from "./playwright-doctor.js";
 //#region src/browser/providers/browser-use.ts
 init_logger();
 const log = createLogger("BrowserProvider:BrowserUse");
@@ -37,7 +38,7 @@ var BrowserUseProvider = class {
 		}
 		const session = await response.json();
 		this.sessionId = session.session_id;
-		const pw = await import("playwright-core");
+		const pw = await loadPlaywrightCoreModule();
 		const chromium = pw.chromium ?? pw.default?.chromium;
 		if (!chromium?.connectOverCDP) throw new Error("playwright-core does not support connectOverCDP");
 		this.browser = await chromium.connectOverCDP(session.ws_url);

package/dist/src/browser/providers/browser-use.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-use.js","names":[],"sources":["../../../../src/browser/providers/browser-use.ts"],"sourcesContent":["import type { Browser, BrowserContext } from 'playwright-core';\n\nimport { createLogger } from '../../utils/logger.js';\n\nimport type { CloudBrowserProvider, CloudBrowserProviderConfig } from './types.js';\n\nconst log = createLogger('BrowserProvider:BrowserUse');\n\n/**\n * Browser Use cloud browser provider.\n *\n * Connects to a Browser Use-managed session via CDP WebSocket.\n * Requires `BROWSER_USE_API_KEY` or config-level `apiKey`.\n *\n * @see https://docs.browser-use.com\n */\nexport class BrowserUseProvider implements CloudBrowserProvider {\n  readonly name = 'browser-use';\n\n  private browser: Browser | null = null;\n  private context: BrowserContext | null = null;\n  private sessionId: string | null = null;\n  private readonly config: CloudBrowserProviderConfig;\n\n  constructor(config: CloudBrowserProviderConfig) {\n    this.config = config;\n  }\n\n  async connect(): Promise<{ browser: Browser; context: BrowserContext }> {\n    const apiKey = this.config.apiKey || process.env.BROWSER_USE_API_KEY;\n    if (!apiKey) {\n      throw new Error('Browser Use API key not configured (set BROWSER_USE_API_KEY or browser.cloudProvider config)');\n    }\n\n    // Create a Browser Use session via REST API\n    const createUrl = 'https://api.browser-use.com/api/v1/sessions';\n    const response = await fetch(createUrl, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify({}),\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => 'unknown');\n      throw new Error(`Browser Use session creation failed (${response.status}): ${errorText}`);\n    }\n\n    const session = (await response.json()) as { session_id: string; ws_url: string };\n    this.sessionId = session.session_id;\n\n    const pw = await import('playwright-core');\n    const chromium = pw.chromium ?? (pw as { default?: { chromium?: (typeof pw)['chromium'] } }).default?.chromium;\n    if (!chromium?.connectOverCDP) {\n      throw new Error('playwright-core does not support connectOverCDP');\n    }\n\n    this.browser = await chromium.connectOverCDP(session.ws_url);\n    const contexts = this.browser.contexts();\n    this.context = contexts.length > 0 ? contexts[0] : await this.browser.newContext();\n\n    log.info({ sessionId: this.sessionId }, 'Connected to Browser Use');\n    return { browser: this.browser, context: this.context };\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.browser) {\n      await this.browser.close().catch(() => {});\n      this.browser = null;\n      this.context = null;\n      log.info({ sessionId: this.sessionId }, 'Disconnected from Browser Use');\n      this.sessionId = null;\n    }\n  }\n\n  isConnected(): boolean {\n    return this.browser !== null && this.browser.isConnected();\n  }\n}\n"],"mappings":";;;aAEqD;AAIrD,MAAM,MAAM,aAAa,6BAA6B;;;;;;;;;AAUtD,IAAa,qBAAb,MAAgE;CAC9D,OAAgB;CAEhB,UAAkC;CAClC,UAAyC;CACzC,YAAmC;CACnC;CAEA,YAAY,QAAoC;AAC9C,OAAK,SAAS;;CAGhB,MAAM,UAAkE;EACtE,MAAM,SAAS,KAAK,OAAO,UAAU,QAAQ,IAAI;AACjD,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,+FAA+F;EAKjH,MAAM,WAAW,MAAM,MAAM,+CAAW;GACtC,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,eAAe,UAAU;IAC1B;GACD,MAAM,KAAK,UAAU,EAAE,CAAC;GACzB,CAAC;AAEF,MAAI,CAAC,SAAS,IAAI;GAChB,MAAM,YAAY,MAAM,SAAS,MAAM,CAAC,YAAY,UAAU;AAC9D,SAAM,IAAI,MAAM,wCAAwC,SAAS,OAAO,KAAK,YAAY;;EAG3F,MAAM,UAAW,MAAM,SAAS,MAAM;AACtC,OAAK,YAAY,QAAQ;EAEzB,MAAM,KAAK,MAAM,OAAO;EACxB,MAAM,WAAW,GAAG,YAAa,GAA4D,SAAS;AACtG,MAAI,CAAC,UAAU,eACb,OAAM,IAAI,MAAM,kDAAkD;AAGpE,OAAK,UAAU,MAAM,SAAS,eAAe,QAAQ,OAAO;EAC5D,MAAM,WAAW,KAAK,QAAQ,UAAU;AACxC,OAAK,UAAU,SAAS,SAAS,IAAI,SAAS,KAAK,MAAM,KAAK,QAAQ,YAAY;AAElF,MAAI,KAAK,EAAE,WAAW,KAAK,WAAW,EAAE,2BAA2B;AACnE,SAAO;GAAE,SAAS,KAAK;GAAS,SAAS,KAAK;GAAS;;CAGzD,MAAM,aAA4B;AAChC,MAAI,KAAK,SAAS;AAChB,SAAM,KAAK,QAAQ,OAAO,CAAC,YAAY,GAAG;AAC1C,QAAK,UAAU;AACf,QAAK,UAAU;AACf,OAAI,KAAK,EAAE,WAAW,KAAK,WAAW,EAAE,gCAAgC;AACxE,QAAK,YAAY;;;CAIrB,cAAuB;AACrB,SAAO,KAAK,YAAY,QAAQ,KAAK,QAAQ,aAAa"}
+{"version":3,"file":"browser-use.js","names":[],"sources":["../../../../src/browser/providers/browser-use.ts"],"sourcesContent":["import type { Browser, BrowserContext } from 'playwright-core';\n\nimport { createLogger } from '../../utils/logger.js';\n\nimport { loadPlaywrightCoreModule } from './playwright-doctor.js';\n\nimport type { CloudBrowserProvider, CloudBrowserProviderConfig } from './types.js';\n\nconst log = createLogger('BrowserProvider:BrowserUse');\n\n/**\n * Browser Use cloud browser provider.\n *\n * Connects to a Browser Use-managed session via CDP WebSocket.\n * Requires `BROWSER_USE_API_KEY` or config-level `apiKey`.\n *\n * @see https://docs.browser-use.com\n */\nexport class BrowserUseProvider implements CloudBrowserProvider {\n  readonly name = 'browser-use';\n\n  private browser: Browser | null = null;\n  private context: BrowserContext | null = null;\n  private sessionId: string | null = null;\n  private readonly config: CloudBrowserProviderConfig;\n\n  constructor(config: CloudBrowserProviderConfig) {\n    this.config = config;\n  }\n\n  async connect(): Promise<{ browser: Browser; context: BrowserContext }> {\n    const apiKey = this.config.apiKey || process.env.BROWSER_USE_API_KEY;\n    if (!apiKey) {\n      throw new Error('Browser Use API key not configured (set BROWSER_USE_API_KEY or browser.cloudProvider config)');\n    }\n\n    // Create a Browser Use session via REST API\n    const createUrl = 'https://api.browser-use.com/api/v1/sessions';\n    const response = await fetch(createUrl, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify({}),\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => 'unknown');\n      throw new Error(`Browser Use session creation failed (${response.status}): ${errorText}`);\n    }\n\n    const session = (await response.json()) as { session_id: string; ws_url: string };\n    this.sessionId = session.session_id;\n\n    const pw = await loadPlaywrightCoreModule();\n    const chromium = pw.chromium ?? (pw as { default?: { chromium?: (typeof pw)['chromium'] } }).default?.chromium;\n    if (!chromium?.connectOverCDP) {\n      throw new Error('playwright-core does not support connectOverCDP');\n    }\n\n    this.browser = await chromium.connectOverCDP(session.ws_url);\n    const contexts = this.browser.contexts();\n    this.context = contexts.length > 0 ? contexts[0] : await this.browser.newContext();\n\n    log.info({ sessionId: this.sessionId }, 'Connected to Browser Use');\n    return { browser: this.browser, context: this.context };\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.browser) {\n      await this.browser.close().catch(() => {});\n      this.browser = null;\n      this.context = null;\n      log.info({ sessionId: this.sessionId }, 'Disconnected from Browser Use');\n      this.sessionId = null;\n    }\n  }\n\n  isConnected(): boolean {\n    return this.browser !== null && this.browser.isConnected();\n  }\n}\n"],"mappings":";;;;aAEqD;AAMrD,MAAM,MAAM,aAAa,6BAA6B;;;;;;;;;AAUtD,IAAa,qBAAb,MAAgE;CAC9D,OAAgB;CAEhB,UAAkC;CAClC,UAAyC;CACzC,YAAmC;CACnC;CAEA,YAAY,QAAoC;AAC9C,OAAK,SAAS;;CAGhB,MAAM,UAAkE;EACtE,MAAM,SAAS,KAAK,OAAO,UAAU,QAAQ,IAAI;AACjD,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,+FAA+F;EAKjH,MAAM,WAAW,MAAM,MAAM,+CAAW;GACtC,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,eAAe,UAAU;IAC1B;GACD,MAAM,KAAK,UAAU,EAAE,CAAC;GACzB,CAAC;AAEF,MAAI,CAAC,SAAS,IAAI;GAChB,MAAM,YAAY,MAAM,SAAS,MAAM,CAAC,YAAY,UAAU;AAC9D,SAAM,IAAI,MAAM,wCAAwC,SAAS,OAAO,KAAK,YAAY;;EAG3F,MAAM,UAAW,MAAM,SAAS,MAAM;AACtC,OAAK,YAAY,QAAQ;EAEzB,MAAM,KAAK,MAAM,0BAA0B;EAC3C,MAAM,WAAW,GAAG,YAAa,GAA4D,SAAS;AACtG,MAAI,CAAC,UAAU,eACb,OAAM,IAAI,MAAM,kDAAkD;AAGpE,OAAK,UAAU,MAAM,SAAS,eAAe,QAAQ,OAAO;EAC5D,MAAM,WAAW,KAAK,QAAQ,UAAU;AACxC,OAAK,UAAU,SAAS,SAAS,IAAI,SAAS,KAAK,MAAM,KAAK,QAAQ,YAAY;AAElF,MAAI,KAAK,EAAE,WAAW,KAAK,WAAW,EAAE,2BAA2B;AACnE,SAAO;GAAE,SAAS,KAAK;GAAS,SAAS,KAAK;GAAS;;CAGzD,MAAM,aAA4B;AAChC,MAAI,KAAK,SAAS;AAChB,SAAM,KAAK,QAAQ,OAAO,CAAC,YAAY,GAAG;AAC1C,QAAK,UAAU;AACf,QAAK,UAAU;AACf,OAAI,KAAK,EAAE,WAAW,KAAK,WAAW,EAAE,gCAAgC;AACxE,QAAK,YAAY;;;CAIrB,cAAuB;AACrB,SAAO,KAAK,YAAY,QAAQ,KAAK,QAAQ,aAAa"}

package/dist/src/browser/providers/browserbase.js

@@ -1,5 +1,6 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { loadPlaywrightCoreModule } from "./playwright-doctor.js";
 //#region src/browser/providers/browserbase.ts
 init_logger();
 const log = createLogger("BrowserProvider:Browserbase");
@@ -43,7 +44,7 @@ var BrowserbaseProvider = class {
 		const session = await response.json();
 		this.sessionId = session.id;
 		const connectUrl = session.connectUrl || `wss://connect.browserbase.com?apiKey=${apiKey}&sessionId=${session.id}`;
-		const pw = await import("playwright-core");
+		const pw = await loadPlaywrightCoreModule();
 		const chromium = pw.chromium ?? pw.default?.chromium;
 		if (!chromium?.connectOverCDP) throw new Error("playwright-core does not support connectOverCDP");
 		this.browser = await chromium.connectOverCDP(connectUrl);

package/dist/src/browser/providers/browserbase.js.map

@@ -1 +1 @@
-{"version":3,"file":"browserbase.js","names":[],"sources":["../../../../src/browser/providers/browserbase.ts"],"sourcesContent":["import type { Browser, BrowserContext } from 'playwright-core';\n\nimport { createLogger } from '../../utils/logger.js';\n\nimport type { CloudBrowserProvider, CloudBrowserProviderConfig } from './types.js';\n\nconst log = createLogger('BrowserProvider:Browserbase');\n\n/**\n * Browserbase cloud browser provider.\n *\n * Connects to a Browserbase-managed Chromium instance via CDP WebSocket.\n * Requires `BROWSERBASE_API_KEY` or config-level `apiKey`, plus an optional `projectId`.\n *\n * @see https://docs.browserbase.com\n */\nexport class BrowserbaseProvider implements CloudBrowserProvider {\n  readonly name = 'browserbase';\n\n  private browser: Browser | null = null;\n  private context: BrowserContext | null = null;\n  private sessionId: string | null = null;\n  private readonly config: CloudBrowserProviderConfig;\n\n  constructor(config: CloudBrowserProviderConfig) {\n    this.config = config;\n  }\n\n  async connect(): Promise<{ browser: Browser; context: BrowserContext }> {\n    const apiKey = this.config.apiKey || process.env.BROWSERBASE_API_KEY;\n    if (!apiKey) {\n      throw new Error('Browserbase API key not configured (set BROWSERBASE_API_KEY or browser.cloudProvider config)');\n    }\n\n    const projectId = this.config.projectId || process.env.BROWSERBASE_PROJECT_ID;\n\n    // Create a Browserbase session via REST API\n    const createUrl = 'https://www.browserbase.com/v1/sessions';\n    const body: Record<string, unknown> = {};\n    if (projectId) body.projectId = projectId;\n    if (this.config.region) body.region = this.config.region;\n\n    const response = await fetch(createUrl, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'x-bb-api-key': apiKey,\n      },\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => 'unknown');\n      throw new Error(`Browserbase session creation failed (${response.status}): ${errorText}`);\n    }\n\n    const session = (await response.json()) as { id: string; connectUrl?: string };\n    this.sessionId = session.id;\n\n    // Connect via CDP\n    const connectUrl =\n      session.connectUrl || `wss://connect.browserbase.com?apiKey=${apiKey}&sessionId=${session.id}`;\n\n    const pw = await import('playwright-core');\n    const chromium = pw.chromium ?? (pw as { default?: { chromium?: (typeof pw)['chromium'] } }).default?.chromium;\n    if (!chromium?.connectOverCDP) {\n      throw new Error('playwright-core does not support connectOverCDP');\n    }\n\n    this.browser = await chromium.connectOverCDP(connectUrl);\n    const contexts = this.browser.contexts();\n    this.context = contexts.length > 0 ? contexts[0] : await this.browser.newContext();\n\n    log.info({ sessionId: this.sessionId }, 'Connected to Browserbase');\n    return { browser: this.browser, context: this.context };\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.browser) {\n      await this.browser.close().catch(() => {});\n      this.browser = null;\n      this.context = null;\n      log.info({ sessionId: this.sessionId }, 'Disconnected from Browserbase');\n      this.sessionId = null;\n    }\n  }\n\n  isConnected(): boolean {\n    return this.browser !== null && this.browser.isConnected();\n  }\n}\n"],"mappings":";;;aAEqD;AAIrD,MAAM,MAAM,aAAa,8BAA8B;;;;;;;;;AAUvD,IAAa,sBAAb,MAAiE;CAC/D,OAAgB;CAEhB,UAAkC;CAClC,UAAyC;CACzC,YAAmC;CACnC;CAEA,YAAY,QAAoC;AAC9C,OAAK,SAAS;;CAGhB,MAAM,UAAkE;EACtE,MAAM,SAAS,KAAK,OAAO,UAAU,QAAQ,IAAI;AACjD,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,+FAA+F;EAGjH,MAAM,YAAY,KAAK,OAAO,aAAa,QAAQ,IAAI;EAGvD,MAAM,YAAY;EAClB,MAAM,OAAgC,EAAE;AACxC,MAAI,UAAW,MAAK,YAAY;AAChC,MAAI,KAAK,OAAO,OAAQ,MAAK,SAAS,KAAK,OAAO;EAElD,MAAM,WAAW,MAAM,MAAM,WAAW;GACtC,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,gBAAgB;IACjB;GACD,MAAM,KAAK,UAAU,KAAK;GAC3B,CAAC;AAEF,MAAI,CAAC,SAAS,IAAI;GAChB,MAAM,YAAY,MAAM,SAAS,MAAM,CAAC,YAAY,UAAU;AAC9D,SAAM,IAAI,MAAM,wCAAwC,SAAS,OAAO,KAAK,YAAY;;EAG3F,MAAM,UAAW,MAAM,SAAS,MAAM;AACtC,OAAK,YAAY,QAAQ;EAGzB,MAAM,aACJ,QAAQ,cAAc,wCAAwC,OAAO,aAAa,QAAQ;EAE5F,MAAM,KAAK,MAAM,OAAO;EACxB,MAAM,WAAW,GAAG,YAAa,GAA4D,SAAS;AACtG,MAAI,CAAC,UAAU,eACb,OAAM,IAAI,MAAM,kDAAkD;AAGpE,OAAK,UAAU,MAAM,SAAS,eAAe,WAAW;EACxD,MAAM,WAAW,KAAK,QAAQ,UAAU;AACxC,OAAK,UAAU,SAAS,SAAS,IAAI,SAAS,KAAK,MAAM,KAAK,QAAQ,YAAY;AAElF,MAAI,KAAK,EAAE,WAAW,KAAK,WAAW,EAAE,2BAA2B;AACnE,SAAO;GAAE,SAAS,KAAK;GAAS,SAAS,KAAK;GAAS;;CAGzD,MAAM,aAA4B;AAChC,MAAI,KAAK,SAAS;AAChB,SAAM,KAAK,QAAQ,OAAO,CAAC,YAAY,GAAG;AAC1C,QAAK,UAAU;AACf,QAAK,UAAU;AACf,OAAI,KAAK,EAAE,WAAW,KAAK,WAAW,EAAE,gCAAgC;AACxE,QAAK,YAAY;;;CAIrB,cAAuB;AACrB,SAAO,KAAK,YAAY,QAAQ,KAAK,QAAQ,aAAa"}
+{"version":3,"file":"browserbase.js","names":[],"sources":["../../../../src/browser/providers/browserbase.ts"],"sourcesContent":["import type { Browser, BrowserContext } from 'playwright-core';\n\nimport { createLogger } from '../../utils/logger.js';\n\nimport { loadPlaywrightCoreModule } from './playwright-doctor.js';\n\nimport type { CloudBrowserProvider, CloudBrowserProviderConfig } from './types.js';\n\nconst log = createLogger('BrowserProvider:Browserbase');\n\n/**\n * Browserbase cloud browser provider.\n *\n * Connects to a Browserbase-managed Chromium instance via CDP WebSocket.\n * Requires `BROWSERBASE_API_KEY` or config-level `apiKey`, plus an optional `projectId`.\n *\n * @see https://docs.browserbase.com\n */\nexport class BrowserbaseProvider implements CloudBrowserProvider {\n  readonly name = 'browserbase';\n\n  private browser: Browser | null = null;\n  private context: BrowserContext | null = null;\n  private sessionId: string | null = null;\n  private readonly config: CloudBrowserProviderConfig;\n\n  constructor(config: CloudBrowserProviderConfig) {\n    this.config = config;\n  }\n\n  async connect(): Promise<{ browser: Browser; context: BrowserContext }> {\n    const apiKey = this.config.apiKey || process.env.BROWSERBASE_API_KEY;\n    if (!apiKey) {\n      throw new Error('Browserbase API key not configured (set BROWSERBASE_API_KEY or browser.cloudProvider config)');\n    }\n\n    const projectId = this.config.projectId || process.env.BROWSERBASE_PROJECT_ID;\n\n    // Create a Browserbase session via REST API\n    const createUrl = 'https://www.browserbase.com/v1/sessions';\n    const body: Record<string, unknown> = {};\n    if (projectId) body.projectId = projectId;\n    if (this.config.region) body.region = this.config.region;\n\n    const response = await fetch(createUrl, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'x-bb-api-key': apiKey,\n      },\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => 'unknown');\n      throw new Error(`Browserbase session creation failed (${response.status}): ${errorText}`);\n    }\n\n    const session = (await response.json()) as { id: string; connectUrl?: string };\n    this.sessionId = session.id;\n\n    // Connect via CDP\n    const connectUrl =\n      session.connectUrl || `wss://connect.browserbase.com?apiKey=${apiKey}&sessionId=${session.id}`;\n\n    const pw = await loadPlaywrightCoreModule();\n    const chromium = pw.chromium ?? (pw as { default?: { chromium?: (typeof pw)['chromium'] } }).default?.chromium;\n    if (!chromium?.connectOverCDP) {\n      throw new Error('playwright-core does not support connectOverCDP');\n    }\n\n    this.browser = await chromium.connectOverCDP(connectUrl);\n    const contexts = this.browser.contexts();\n    this.context = contexts.length > 0 ? contexts[0] : await this.browser.newContext();\n\n    log.info({ sessionId: this.sessionId }, 'Connected to Browserbase');\n    return { browser: this.browser, context: this.context };\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.browser) {\n      await this.browser.close().catch(() => {});\n      this.browser = null;\n      this.context = null;\n      log.info({ sessionId: this.sessionId }, 'Disconnected from Browserbase');\n      this.sessionId = null;\n    }\n  }\n\n  isConnected(): boolean {\n    return this.browser !== null && this.browser.isConnected();\n  }\n}\n"],"mappings":";;;;aAEqD;AAMrD,MAAM,MAAM,aAAa,8BAA8B;;;;;;;;;AAUvD,IAAa,sBAAb,MAAiE;CAC/D,OAAgB;CAEhB,UAAkC;CAClC,UAAyC;CACzC,YAAmC;CACnC;CAEA,YAAY,QAAoC;AAC9C,OAAK,SAAS;;CAGhB,MAAM,UAAkE;EACtE,MAAM,SAAS,KAAK,OAAO,UAAU,QAAQ,IAAI;AACjD,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,+FAA+F;EAGjH,MAAM,YAAY,KAAK,OAAO,aAAa,QAAQ,IAAI;EAGvD,MAAM,YAAY;EAClB,MAAM,OAAgC,EAAE;AACxC,MAAI,UAAW,MAAK,YAAY;AAChC,MAAI,KAAK,OAAO,OAAQ,MAAK,SAAS,KAAK,OAAO;EAElD,MAAM,WAAW,MAAM,MAAM,WAAW;GACtC,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,gBAAgB;IACjB;GACD,MAAM,KAAK,UAAU,KAAK;GAC3B,CAAC;AAEF,MAAI,CAAC,SAAS,IAAI;GAChB,MAAM,YAAY,MAAM,SAAS,MAAM,CAAC,YAAY,UAAU;AAC9D,SAAM,IAAI,MAAM,wCAAwC,SAAS,OAAO,KAAK,YAAY;;EAG3F,MAAM,UAAW,MAAM,SAAS,MAAM;AACtC,OAAK,YAAY,QAAQ;EAGzB,MAAM,aACJ,QAAQ,cAAc,wCAAwC,OAAO,aAAa,QAAQ;EAE5F,MAAM,KAAK,MAAM,0BAA0B;EAC3C,MAAM,WAAW,GAAG,YAAa,GAA4D,SAAS;AACtG,MAAI,CAAC,UAAU,eACb,OAAM,IAAI,MAAM,kDAAkD;AAGpE,OAAK,UAAU,MAAM,SAAS,eAAe,WAAW;EACxD,MAAM,WAAW,KAAK,QAAQ,UAAU;AACxC,OAAK,UAAU,SAAS,SAAS,IAAI,SAAS,KAAK,MAAM,KAAK,QAAQ,YAAY;AAElF,MAAI,KAAK,EAAE,WAAW,KAAK,WAAW,EAAE,2BAA2B;AACnE,SAAO;GAAE,SAAS,KAAK;GAAS,SAAS,KAAK;GAAS;;CAGzD,MAAM,aAA4B;AAChC,MAAI,KAAK,SAAS;AAChB,SAAM,KAAK,QAAQ,OAAO,CAAC,YAAY,GAAG;AAC1C,QAAK,UAAU;AACf,QAAK,UAAU;AACf,OAAI,KAAK,EAAE,WAAW,KAAK,WAAW,EAAE,gCAAgC;AACxE,QAAK,YAAY;;;CAIrB,cAAuB;AACrB,SAAO,KAAK,YAAY,QAAQ,KAAK,QAAQ,aAAa"}

package/dist/src/browser/providers/cloakbrowser.js

@@ -1,14 +1,15 @@
-import { assertCacheDir, expandHome, init_cache_dir_policy } from "../cache-dir-policy.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_paths, resolveBinDir } from "../../config/paths.js";
+import { assertCacheDir, expandHome, init_cache_dir_policy } from "../cache-dir-policy.js";
+import { loadPlaywrightCoreModule } from "./playwright-doctor.js";
 import { WEBDRIVER_OVERRIDE_SCRIPT, buildStealthArgs, filterCloakBrowserExtraArgs, generateFingerprintSeed, makeExecutable, removeQuarantineAttr } from "../stealth.js";
 import { pickFreePort } from "../free-port.js";
-import { join, resolve } from "node:path";
-import { arch, platform, tmpdir } from "node:os";
-import { createReadStream, createWriteStream } from "node:fs";
 import { createHash } from "node:crypto";
+import { createReadStream, createWriteStream } from "node:fs";
 import { mkdir, mkdtemp, readdir, rename, rm, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { arch, platform, tmpdir } from "node:os";
 import { spawn } from "node:child_process";
 import { Readable, Transform } from "node:stream";
 import AdmZip from "adm-zip";
@@ -482,7 +483,7 @@ async function launchCloakBrowser(config = {}) {
 			log.info({ port: cdpPort }, "Reusing existing CloakBrowser instance");
 			const meta = launchResultMeta(cdpPort, userDataDir, true, null, null, null);
 			if (skipPlaywrightConnect) return meta;
-			const pw = await import("playwright-core");
+			const pw = await loadPlaywrightCoreModule();
 			const chromium = pw.chromium ?? pw.default?.chromium;
 			if (!chromium?.connectOverCDP) throw new Error("playwright-core does not support connectOverCDP");
 			const wsUrl = `ws://127.0.0.1:${cdpPort}`;
@@ -578,7 +579,7 @@ async function launchCloakBrowser(config = {}) {
 		}, "CloakBrowser launched (CDP only)");
 		return meta;
 	}
-	const pw = await import("playwright-core");
+	const pw = await loadPlaywrightCoreModule();
 	const chromium = pw.chromium ?? pw.default?.chromium;
 	if (!chromium?.connectOverCDP) {
 		child.kill();