@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-patch.1

package/dist/cjs/cli.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// packages/core/lib/v3/cli.js
+var import_node_process = __toESM(require("node:process"), 1);
+
+// packages/core/lib/v3/shutdown/supervisor.ts
+var import_sdk = __toESM(require("@browserbasehq/sdk"), 1);
+
+// packages/core/lib/v3/shutdown/cleanupLocal.ts
+var import_node_fs = __toESM(require("node:fs"), 1);
+async function cleanupLocalBrowser(opts) {
+  if (opts.killChrome) {
+    try {
+      await opts.killChrome();
+    } catch {
+    }
+  }
+  if (opts.createdTempProfile && !opts.preserveUserDataDir && opts.userDataDir) {
+    try {
+      import_node_fs.default.rmSync(opts.userDataDir, { recursive: true, force: true });
+    } catch {
+    }
+  }
+}
+
+// packages/core/lib/v3/shutdown/supervisor.ts
+var SIGKILL_POLL_MS = 250;
+var SIGKILL_TIMEOUT_MS = 7e3;
+var PID_POLL_INTERVAL_MS = 500;
+var config = null;
+var cleanupPromise = null;
+var started = false;
+var exit = (code = 0) => {
+  try {
+    process.exit(code);
+  } catch {
+  }
+};
+var politeKill = async (pid) => {
+  const isAlive = () => {
+    try {
+      process.kill(pid, 0);
+      return true;
+    } catch (error) {
+      const err = error;
+      return err.code !== "ESRCH";
+    }
+  };
+  if (!isAlive()) return;
+  try {
+    process.kill(pid, "SIGTERM");
+  } catch (error) {
+    const err = error;
+    if (err.code === "ESRCH") return;
+  }
+  const deadline = Date.now() + SIGKILL_TIMEOUT_MS;
+  while (Date.now() < deadline) {
+    await new Promise((resolve) => setTimeout(resolve, SIGKILL_POLL_MS));
+    if (!isAlive()) return;
+  }
+  try {
+    process.kill(pid, "SIGKILL");
+  } catch {
+  }
+};
+var pidPollTimer = null;
+var startPidPolling = (pid) => {
+  if (pidPollTimer) return;
+  pidPollTimer = setInterval(() => {
+    try {
+      process.kill(pid, 0);
+    } catch {
+      if (pidPollTimer) {
+        clearInterval(pidPollTimer);
+        pidPollTimer = null;
+      }
+      void runCleanup().finally(() => exit(0));
+    }
+  }, PID_POLL_INTERVAL_MS);
+};
+var cleanupLocal = async (cfg) => {
+  await cleanupLocalBrowser({
+    killChrome: cfg.pid ? () => politeKill(cfg.pid) : void 0,
+    userDataDir: cfg.userDataDir,
+    createdTempProfile: cfg.createdTempProfile,
+    preserveUserDataDir: cfg.preserveUserDataDir
+  });
+};
+var cleanupBrowserbase = async (cfg) => {
+  if (!cfg.apiKey || !cfg.projectId || !cfg.sessionId) return;
+  try {
+    const bb = new import_sdk.default({ apiKey: cfg.apiKey });
+    await bb.sessions.update(cfg.sessionId, {
+      status: "REQUEST_RELEASE",
+      projectId: cfg.projectId
+    });
+  } catch {
+  }
+};
+var runCleanup = () => {
+  if (!cleanupPromise) {
+    cleanupPromise = (async () => {
+      const cfg = config;
+      if (!cfg) return;
+      if (cfg.kind === "LOCAL") {
+        await cleanupLocal(cfg);
+        return;
+      }
+      if (cfg.kind === "STAGEHAND_API") {
+        await cleanupBrowserbase(cfg);
+      }
+    })();
+  }
+  return cleanupPromise;
+};
+var applyConfig = (nextConfig) => {
+  config = nextConfig;
+  if (config.kind === "LOCAL" && config.pid) {
+    startPidPolling(config.pid);
+  }
+};
+var onLifelineClosed = () => {
+  void runCleanup().finally(() => exit(0));
+};
+var parseConfigFromArgv = (argv = process.argv.slice(2)) => {
+  const prefix = "--supervisor-config=";
+  const raw = argv.find((arg) => arg.startsWith(prefix))?.slice(prefix.length);
+  if (!argv.includes("--supervisor") || !raw) return null;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+};
+var runShutdownSupervisor = (initialConfig) => {
+  if (started) return;
+  started = true;
+  applyConfig(initialConfig);
+  try {
+    process.stdin.resume();
+    process.stdin.on("end", onLifelineClosed);
+    process.stdin.on("close", onLifelineClosed);
+    process.stdin.on("error", onLifelineClosed);
+  } catch {
+  }
+};
+var maybeRunShutdownSupervisorFromArgv = (argv = process.argv.slice(2)) => {
+  const parsed = parseConfigFromArgv(argv);
+  if (!parsed) return false;
+  runShutdownSupervisor(parsed);
+  return true;
+};
+
+// packages/core/lib/v3/cli.js
+if (!maybeRunShutdownSupervisorFromArgv(import_node_process.default.argv.slice(2))) {
+  console.error(
+    "Unsupported stagehand CLI invocation. Expected --supervisor with valid args."
+  );
+  import_node_process.default.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cjs/cli.js.map

@@ -0,0 +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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",
+  "names": ["fs", "Browserbase", "process"]
+}

package/dist/cjs/index.d.ts

@@ -0,0 +1 @@
+export * from "./lib/v3/index";