@browserbasehq/orca 3.1.0-patch.2 → 3.1.0-patch.3

package/dist/cjs/cli.js

@@ -52,6 +52,7 @@ var PID_POLL_INTERVAL_MS = 500;
 var config = null;
 var cleanupPromise = null;
 var started = false;
+var localPidKnownGone = false;
 var exit = (code = 0) => {
   try {
     process.exit(code);
@@ -91,26 +92,43 @@ var startPidPolling = (pid) => {
   pidPollTimer = setInterval(() => {
     try {
       process.kill(pid, 0);
-    } catch {
-      if (pidPollTimer) {
-        clearInterval(pidPollTimer);
-        pidPollTimer = null;
-      }
-      void runCleanup().finally(() => exit(0));
+      return;
+    } catch (error) {
+      const err = error;
+      if (err.code !== "ESRCH") return;
+    }
+    localPidKnownGone = true;
+    if (pidPollTimer) {
+      clearInterval(pidPollTimer);
+      pidPollTimer = null;
     }
+    void runCleanup("Browser process exited").finally(() => exit(0));
   }, PID_POLL_INTERVAL_MS);
 };
-var cleanupLocal = async (cfg) => {
+var cleanupLocal = async (cfg, reason) => {
+  const deletingUserDataDir = Boolean(
+    cfg.createdTempProfile && !cfg.preserveUserDataDir && cfg.userDataDir
+  );
   await cleanupLocalBrowser({
-    killChrome: cfg.pid ? () => politeKill(cfg.pid) : void 0,
+    // If polling already observed ESRCH, avoid a follow-up PID kill.
+    // The PID could be reused by a different process before cleanup runs.
+    killChrome: cfg.pid && !localPidKnownGone ? () => {
+      console.error(
+        `[shutdown-supervisor] Shutting down Chrome pid=${cfg.pid} (reason=${reason}, deletingUserDataDir=${deletingUserDataDir})`
+      );
+      return politeKill(cfg.pid);
+    } : void 0,
     userDataDir: cfg.userDataDir,
     createdTempProfile: cfg.createdTempProfile,
     preserveUserDataDir: cfg.preserveUserDataDir
   });
 };
-var cleanupBrowserbase = async (cfg) => {
+var cleanupBrowserbase = async (cfg, reason) => {
   if (!cfg.apiKey || !cfg.projectId || !cfg.sessionId) return;
   try {
+    console.error(
+      `[shutdown-supervisor] Ending Browserbase session ${cfg.sessionId} (reason=${reason})`
+    );
     const bb = new import_sdk.default({ apiKey: cfg.apiKey });
     await bb.sessions.update(cfg.sessionId, {
       status: "REQUEST_RELEASE",
@@ -119,17 +137,17 @@ var cleanupBrowserbase = async (cfg) => {
   } catch {
   }
 };
-var runCleanup = () => {
+var runCleanup = (reason) => {
   if (!cleanupPromise) {
     cleanupPromise = (async () => {
       const cfg = config;
       if (!cfg) return;
       if (cfg.kind === "LOCAL") {
-        await cleanupLocal(cfg);
+        await cleanupLocal(cfg, reason);
         return;
       }
       if (cfg.kind === "STAGEHAND_API") {
-        await cleanupBrowserbase(cfg);
+        await cleanupBrowserbase(cfg, reason);
       }
     })();
   }
@@ -137,12 +155,13 @@ var runCleanup = () => {
 };
 var applyConfig = (nextConfig) => {
   config = nextConfig;
+  localPidKnownGone = false;
   if (config.kind === "LOCAL" && config.pid) {
     startPidPolling(config.pid);
   }
 };
-var onLifelineClosed = () => {
-  void runCleanup().finally(() => exit(0));
+var onLifelineClosed = (reason) => {
+  void runCleanup(reason).finally(() => exit(0));
 };
 var parseConfigFromArgv = (argv = process.argv.slice(2)) => {
   const prefix = "--supervisor-config=";
@@ -160,9 +179,18 @@ var runShutdownSupervisor = (initialConfig) => {
   applyConfig(initialConfig);
   try {
     process.stdin.resume();
-    process.stdin.on("end", onLifelineClosed);
-    process.stdin.on("close", onLifelineClosed);
-    process.stdin.on("error", onLifelineClosed);
+    process.stdin.on(
+      "end",
+      () => onLifelineClosed("Stagehand process completed")
+    );
+    process.stdin.on(
+      "close",
+      () => onLifelineClosed("Stagehand process completed")
+    );
+    process.stdin.on(
+      "error",
+      () => onLifelineClosed("Stagehand process crashed or was killed")
+    );
   } catch {
   }
 };

package/dist/cjs/cli.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../lib/v3/cli.js", "../../lib/v3/shutdown/supervisor.ts", "../../lib/v3/shutdown/cleanupLocal.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\n\nimport process from \"node:process\";\nimport { maybeRunShutdownSupervisorFromArgv } from \"./shutdown/supervisor.js\";\n\n// currently the CLI is only used to spawn the shutdown supervisor\n// in the future, we may want to add more CLI commands here\nif (!maybeRunShutdownSupervisorFromArgv(process.argv.slice(2))) {\n  console.error(\n    \"Unsupported stagehand CLI invocation. Expected --supervisor with valid args.\",\n  );\n  process.exit(1);\n}\n", "/**\n * Shutdown supervisor process.\n *\n * This process watches a stdin lifeline. When the parent dies, stdin closes\n * and the supervisor performs best-effort cleanup:\n * - LOCAL: kill Chrome + remove temp profile\n * - STAGEHAND_API: request session release\n */\n\nimport Browserbase from \"@browserbasehq/sdk\";\nimport type { ShutdownSupervisorConfig } from \"../types/private/shutdown.js\";\nimport { cleanupLocalBrowser } from \"./cleanupLocal.js\";\n\nconst SIGKILL_POLL_MS = 250;\nconst SIGKILL_TIMEOUT_MS = 7_000;\nconst PID_POLL_INTERVAL_MS = 500;\n\n// `cleanupPromise` guarantees we execute cleanup at most once.\nlet config: ShutdownSupervisorConfig | null = null;\nlet cleanupPromise: Promise<void> | null = null;\nlet started = false;\n\nconst exit = (code = 0): void => {\n  try {\n    process.exit(code);\n  } catch {\n    // ignore\n  }\n};\n\n// Best-effort two-phase kill: SIGTERM first, then SIGKILL after timeout.\n// Treat only ESRCH as \"already gone\"; other errors should not imply dead.\nconst politeKill = async (pid: number): Promise<void> => {\n  const isAlive = (): boolean => {\n    try {\n      process.kill(pid, 0);\n      return true;\n    } catch (error) {\n      const err = error as NodeJS.ErrnoException;\n      // ESRCH = \"No such process\" (PID is already gone).\n      return err.code !== \"ESRCH\";\n    }\n  };\n\n  if (!isAlive()) return;\n  try {\n    process.kill(pid, \"SIGTERM\");\n  } catch (error) {\n    const err = error as NodeJS.ErrnoException;\n    // ESRCH = process already exited; no further action needed.\n    if (err.code === \"ESRCH\") return;\n  }\n\n  const deadline = Date.now() + SIGKILL_TIMEOUT_MS;\n  while (Date.now() < deadline) {\n    await new Promise((resolve) => setTimeout(resolve, SIGKILL_POLL_MS));\n    if (!isAlive()) return;\n  }\n  try {\n    process.kill(pid, \"SIGKILL\");\n  } catch {\n    // best-effort\n  }\n};\n\nlet pidPollTimer: NodeJS.Timeout | null = null;\n\n// Local-only fallback: if Chrome dies while parent still lives, run cleanup and exit.\nconst startPidPolling = (pid: number): void => {\n  if (pidPollTimer) return;\n  pidPollTimer = setInterval(() => {\n    try {\n      process.kill(pid, 0);\n    } catch {\n      if (pidPollTimer) {\n        clearInterval(pidPollTimer);\n        pidPollTimer = null;\n      }\n      void runCleanup().finally(() => exit(0));\n    }\n  }, PID_POLL_INTERVAL_MS);\n};\n\nconst cleanupLocal = async (\n  cfg: Extract<ShutdownSupervisorConfig, { kind: \"LOCAL\" }>,\n) => {\n  await cleanupLocalBrowser({\n    killChrome: cfg.pid ? () => politeKill(cfg.pid) : undefined,\n    userDataDir: cfg.userDataDir,\n    createdTempProfile: cfg.createdTempProfile,\n    preserveUserDataDir: cfg.preserveUserDataDir,\n  });\n};\n\nconst cleanupBrowserbase = async (\n  cfg: Extract<ShutdownSupervisorConfig, { kind: \"STAGEHAND_API\" }>,\n) => {\n  if (!cfg.apiKey || !cfg.projectId || !cfg.sessionId) return;\n  try {\n    const bb = new Browserbase({ apiKey: cfg.apiKey });\n    await bb.sessions.update(cfg.sessionId, {\n      status: \"REQUEST_RELEASE\",\n      projectId: cfg.projectId,\n    });\n  } catch {\n    // best-effort cleanup\n  }\n};\n\n// Idempotent cleanup entrypoint used by all supervisor shutdown paths.\nconst runCleanup = (): Promise<void> => {\n  if (!cleanupPromise) {\n    cleanupPromise = (async () => {\n      const cfg = config;\n      if (!cfg) return;\n      if (cfg.kind === \"LOCAL\") {\n        await cleanupLocal(cfg);\n        return;\n      }\n      if (cfg.kind === \"STAGEHAND_API\") {\n        await cleanupBrowserbase(cfg);\n      }\n    })();\n  }\n  return cleanupPromise;\n};\n\nconst applyConfig = (nextConfig: ShutdownSupervisorConfig): void => {\n  config = nextConfig;\n  if (config.kind === \"LOCAL\" && config.pid) {\n    startPidPolling(config.pid);\n  }\n};\n\nconst onLifelineClosed = () => {\n  void runCleanup().finally(() => exit(0));\n};\n\nconst parseConfigFromArgv = (\n  argv: readonly string[] = process.argv.slice(2),\n): ShutdownSupervisorConfig | null => {\n  const prefix = \"--supervisor-config=\";\n  const raw = argv.find((arg) => arg.startsWith(prefix))?.slice(prefix.length);\n  if (!argv.includes(\"--supervisor\") || !raw) return null;\n  try {\n    return JSON.parse(raw) as ShutdownSupervisorConfig;\n  } catch {\n    return null;\n  }\n};\n\nexport const runShutdownSupervisor = (\n  initialConfig: ShutdownSupervisorConfig,\n): void => {\n  if (started) return;\n  started = true;\n  applyConfig(initialConfig);\n\n  // Stdin is the lifeline; losing it means parent is gone.\n  try {\n    process.stdin.resume();\n    process.stdin.on(\"end\", onLifelineClosed);\n    process.stdin.on(\"close\", onLifelineClosed);\n    process.stdin.on(\"error\", onLifelineClosed);\n  } catch {\n    // ignore\n  }\n};\n\nexport const maybeRunShutdownSupervisorFromArgv = (\n  argv: readonly string[] = process.argv.slice(2),\n): boolean => {\n  const parsed = parseConfigFromArgv(argv);\n  if (!parsed) return false;\n  runShutdownSupervisor(parsed);\n  return true;\n};\n", "import fs from \"node:fs\";\n\n/**\n * Shared cleanup logic for locally launched Chrome.\n *\n * Used by both `V3.close()` (normal shutdown) and the supervisor process\n * (crash cleanup). The caller provides a `killChrome` callback since the\n * kill mechanism differs: chrome-launcher's `chrome.kill()` in-process\n * vs raw `process.kill(pid)` from the supervisor.\n */\nexport async function cleanupLocalBrowser(opts: {\n  killChrome?: () => Promise<void> | void;\n  userDataDir?: string;\n  createdTempProfile?: boolean;\n  preserveUserDataDir?: boolean;\n}): Promise<void> {\n  if (opts.killChrome) {\n    try {\n      await opts.killChrome();\n    } catch {\n      // best-effort\n    }\n  }\n  if (\n    opts.createdTempProfile &&\n    !opts.preserveUserDataDir &&\n    opts.userDataDir\n  ) {\n    try {\n      fs.rmSync(opts.userDataDir, { recursive: true, force: true });\n    } catch {\n      // ignore cleanup errors\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["#!/usr/bin/env node\n\nimport process from \"node:process\";\nimport { maybeRunShutdownSupervisorFromArgv } from \"./shutdown/supervisor.js\";\n\n// currently the CLI is only used to spawn the shutdown supervisor\n// in the future, we may want to add more CLI commands here\nif (!maybeRunShutdownSupervisorFromArgv(process.argv.slice(2))) {\n  console.error(\n    \"Unsupported stagehand CLI invocation. Expected --supervisor with valid args.\",\n  );\n  process.exit(1);\n}\n", "/**\n * Shutdown supervisor process.\n *\n * This process watches a stdin lifeline. When the parent dies, stdin closes\n * and the supervisor performs best-effort cleanup:\n * - LOCAL: kill Chrome + remove temp profile\n * - STAGEHAND_API: request session release\n */\n\nimport Browserbase from \"@browserbasehq/sdk\";\nimport type { ShutdownSupervisorConfig } from \"../types/private/shutdown.js\";\nimport { cleanupLocalBrowser } from \"./cleanupLocal.js\";\n\nconst SIGKILL_POLL_MS = 250;\nconst SIGKILL_TIMEOUT_MS = 7_000;\nconst PID_POLL_INTERVAL_MS = 500;\n\n// `cleanupPromise` guarantees we execute cleanup at most once.\nlet config: ShutdownSupervisorConfig | null = null;\nlet cleanupPromise: Promise<void> | null = null;\nlet started = false;\nlet localPidKnownGone = false;\n\nconst exit = (code = 0): void => {\n  try {\n    process.exit(code);\n  } catch {\n    // ignore\n  }\n};\n\n// Best-effort two-phase kill: SIGTERM first, then SIGKILL after timeout.\n// Treat only ESRCH as \"already gone\"; other errors should not imply dead.\nconst politeKill = async (pid: number): Promise<void> => {\n  const isAlive = (): boolean => {\n    try {\n      process.kill(pid, 0);\n      return true;\n    } catch (error) {\n      const err = error as NodeJS.ErrnoException;\n      // ESRCH = \"No such process\" (PID is already gone).\n      return err.code !== \"ESRCH\";\n    }\n  };\n\n  if (!isAlive()) return;\n  try {\n    process.kill(pid, \"SIGTERM\");\n  } catch (error) {\n    const err = error as NodeJS.ErrnoException;\n    // ESRCH = process already exited; no further action needed.\n    if (err.code === \"ESRCH\") return;\n  }\n\n  const deadline = Date.now() + SIGKILL_TIMEOUT_MS;\n  while (Date.now() < deadline) {\n    await new Promise((resolve) => setTimeout(resolve, SIGKILL_POLL_MS));\n    if (!isAlive()) return;\n  }\n  try {\n    process.kill(pid, \"SIGKILL\");\n  } catch {\n    // best-effort\n  }\n};\n\nlet pidPollTimer: NodeJS.Timeout | null = null;\n\n// Local-only fallback: if Chrome dies while parent still lives, run cleanup and exit.\nconst startPidPolling = (pid: number): void => {\n  if (pidPollTimer) return;\n  pidPollTimer = setInterval(() => {\n    try {\n      process.kill(pid, 0);\n      return;\n    } catch (error) {\n      const err = error as NodeJS.ErrnoException;\n      // Only ESRCH means the process is definitely gone.\n      if (err.code !== \"ESRCH\") return;\n    }\n\n    localPidKnownGone = true;\n    if (pidPollTimer) {\n      clearInterval(pidPollTimer);\n      pidPollTimer = null;\n    }\n    void runCleanup(\"Browser process exited\").finally(() => exit(0));\n  }, PID_POLL_INTERVAL_MS);\n};\n\nconst cleanupLocal = async (\n  cfg: Extract<ShutdownSupervisorConfig, { kind: \"LOCAL\" }>,\n  reason: string,\n) => {\n  const deletingUserDataDir = Boolean(\n    cfg.createdTempProfile && !cfg.preserveUserDataDir && cfg.userDataDir,\n  );\n  await cleanupLocalBrowser({\n    // If polling already observed ESRCH, avoid a follow-up PID kill.\n    // The PID could be reused by a different process before cleanup runs.\n    killChrome:\n      cfg.pid && !localPidKnownGone\n        ? () => {\n            console.error(\n              `[shutdown-supervisor] Shutting down Chrome pid=${cfg.pid} ` +\n                `(reason=${reason}, deletingUserDataDir=${deletingUserDataDir})`,\n            );\n            return politeKill(cfg.pid);\n          }\n        : undefined,\n    userDataDir: cfg.userDataDir,\n    createdTempProfile: cfg.createdTempProfile,\n    preserveUserDataDir: cfg.preserveUserDataDir,\n  });\n};\n\nconst cleanupBrowserbase = async (\n  cfg: Extract<ShutdownSupervisorConfig, { kind: \"STAGEHAND_API\" }>,\n  reason: string,\n) => {\n  if (!cfg.apiKey || !cfg.projectId || !cfg.sessionId) return;\n  try {\n    console.error(\n      `[shutdown-supervisor] Ending Browserbase session ${cfg.sessionId} ` +\n        `(reason=${reason})`,\n    );\n    const bb = new Browserbase({ apiKey: cfg.apiKey });\n    await bb.sessions.update(cfg.sessionId, {\n      status: \"REQUEST_RELEASE\",\n      projectId: cfg.projectId,\n    });\n  } catch {\n    // best-effort cleanup\n  }\n};\n\n// Idempotent cleanup entrypoint used by all supervisor shutdown paths.\nconst runCleanup = (reason: string): Promise<void> => {\n  if (!cleanupPromise) {\n    cleanupPromise = (async () => {\n      const cfg = config;\n      if (!cfg) return;\n      if (cfg.kind === \"LOCAL\") {\n        await cleanupLocal(cfg, reason);\n        return;\n      }\n      if (cfg.kind === \"STAGEHAND_API\") {\n        await cleanupBrowserbase(cfg, reason);\n      }\n    })();\n  }\n  return cleanupPromise;\n};\n\nconst applyConfig = (nextConfig: ShutdownSupervisorConfig): void => {\n  config = nextConfig;\n  localPidKnownGone = false;\n  if (config.kind === \"LOCAL\" && config.pid) {\n    startPidPolling(config.pid);\n  }\n};\n\nconst onLifelineClosed = (reason: string) => {\n  void runCleanup(reason).finally(() => exit(0));\n};\n\nconst parseConfigFromArgv = (\n  argv: readonly string[] = process.argv.slice(2),\n): ShutdownSupervisorConfig | null => {\n  const prefix = \"--supervisor-config=\";\n  const raw = argv.find((arg) => arg.startsWith(prefix))?.slice(prefix.length);\n  if (!argv.includes(\"--supervisor\") || !raw) return null;\n  try {\n    return JSON.parse(raw) as ShutdownSupervisorConfig;\n  } catch {\n    return null;\n  }\n};\n\nexport const runShutdownSupervisor = (\n  initialConfig: ShutdownSupervisorConfig,\n): void => {\n  if (started) return;\n  started = true;\n  applyConfig(initialConfig);\n\n  // Stdin is the lifeline; losing it means parent is gone.\n  try {\n    process.stdin.resume();\n    process.stdin.on(\"end\", () =>\n      onLifelineClosed(\"Stagehand process completed\"),\n    );\n    process.stdin.on(\"close\", () =>\n      onLifelineClosed(\"Stagehand process completed\"),\n    );\n    process.stdin.on(\"error\", () =>\n      onLifelineClosed(\"Stagehand process crashed or was killed\"),\n    );\n  } catch {\n    // ignore\n  }\n};\n\nexport const maybeRunShutdownSupervisorFromArgv = (\n  argv: readonly string[] = process.argv.slice(2),\n): boolean => {\n  const parsed = parseConfigFromArgv(argv);\n  if (!parsed) return false;\n  runShutdownSupervisor(parsed);\n  return true;\n};\n", "import fs from \"node:fs\";\n\n/**\n * Shared cleanup logic for locally launched Chrome.\n *\n * Used by both `V3.close()` (normal shutdown) and the supervisor process\n * (crash cleanup). The caller provides a `killChrome` callback since the\n * kill mechanism differs: chrome-launcher's `chrome.kill()` in-process\n * vs raw `process.kill(pid)` from the supervisor.\n */\nexport async function cleanupLocalBrowser(opts: {\n  killChrome?: () => Promise<void> | void;\n  userDataDir?: string;\n  createdTempProfile?: boolean;\n  preserveUserDataDir?: boolean;\n}): Promise<void> {\n  if (opts.killChrome) {\n    try {\n      await opts.killChrome();\n    } catch {\n      // best-effort\n    }\n  }\n  if (\n    opts.createdTempProfile &&\n    !opts.preserveUserDataDir &&\n    opts.userDataDir\n  ) {\n    try {\n      fs.rmSync(opts.userDataDir, { recursive: true, force: true });\n    } catch {\n      // ignore cleanup errors\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": ["fs", "Browserbase", "process"]
 }