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

package/dist/esm/lib/v3/tests/keep-alive.helpers.js

@@ -0,0 +1,532 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import Browserbase from "@browserbasehq/sdk";
+import WebSocket from "ws";
+import { v3DynamicTestConfig } from "./v3.dynamic.config.js";
+const testsDir = path.dirname(fileURLToPath(import.meta.url));
+const findCoreDir = (startDir) => {
+  let current = path.resolve(startDir);
+  while (true) {
+    const packageJsonPath = path.join(current, "package.json");
+    if (fs.existsSync(packageJsonPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+        if (pkg.name === "@browserbasehq/stagehand") {
+          return current;
+        }
+      } catch {
+      }
+    }
+    const parent = path.dirname(current);
+    if (parent === current) {
+      return path.resolve(startDir, "../../..");
+    }
+    current = parent;
+  }
+};
+const coreDir = findCoreDir(testsDir);
+const resolveChildRunner = () => {
+  const distJsPath = path.join(
+    coreDir,
+    "dist",
+    "esm",
+    "lib",
+    "v3",
+    "tests",
+    "keep-alive.child.js"
+  );
+  if (fs.existsSync(distJsPath)) {
+    return { command: process.execPath, args: [distJsPath] };
+  }
+  return null;
+};
+const childRunner = resolveChildRunner();
+const DEBUG = process.env.KEEP_ALIVE_DEBUG === "1";
+const VIEW_MS = Number(process.env.KEEP_ALIVE_VIEW_MS ?? "0");
+const LOCAL_TIMEOUT_MS = Number(
+  process.env.KEEP_ALIVE_LOCAL_TIMEOUT_MS ?? "8000"
+);
+const BB_TIMEOUT_MS = Number(process.env.KEEP_ALIVE_BB_TIMEOUT_MS ?? "30000");
+const STAY_OPEN_MS = Number(process.env.KEEP_ALIVE_STAY_OPEN_MS ?? "6000");
+const ACTION_EXIT_TIMEOUT_MS = Number(
+  process.env.KEEP_ALIVE_ACTION_EXIT_TIMEOUT_MS ?? "3000"
+);
+const LOCAL_INFO_TIMEOUT_MS = Number(
+  process.env.KEEP_ALIVE_LOCAL_INFO_TIMEOUT_MS ?? "15000"
+);
+const BB_INFO_TIMEOUT_MS = Number(
+  process.env.KEEP_ALIVE_BB_INFO_TIMEOUT_MS ?? (process.env.CI ? "45000" : "30000")
+);
+const getInfoTimeoutMs = (env) => env === "BROWSERBASE" ? BB_INFO_TIMEOUT_MS : LOCAL_INFO_TIMEOUT_MS;
+function debugLog(message) {
+  if (DEBUG) {
+    console.log(message);
+  }
+}
+function parseChildInfo(line) {
+  const prefix = "__KEEPALIVE__";
+  if (!line.startsWith(prefix)) return null;
+  try {
+    return JSON.parse(line.slice(prefix.length));
+  } catch {
+    return null;
+  }
+}
+async function runScenario(config) {
+  const payload = {
+    env: config.env,
+    keepAlive: config.keepAlive,
+    disableAPI: config.disableAPI,
+    scenario: config.kind,
+    apiKey: config.apiKey,
+    projectId: config.projectId,
+    debug: config.debug,
+    viewMs: config.viewMs
+  };
+  const encoded = `cfg:${Buffer.from(JSON.stringify(payload)).toString("base64")}`;
+  if (!childRunner) {
+    throw new Error(
+      "keep-alive child script not found at dist/esm/lib/v3/tests/keep-alive.child.js"
+    );
+  }
+  const child = spawn(childRunner.command, [...childRunner.args, encoded], {
+    cwd: coreDir,
+    env: { ...process.env },
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  const logs = { stdout: [], stderr: [] };
+  let buffer = "";
+  let stderr = "";
+  let resolved = false;
+  const infoTimeoutMs = getInfoTimeoutMs(config.env);
+  const infoPromise = new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => {
+      child.kill("SIGKILL");
+      const stdoutDetails = logs.stdout.length > 0 ? `
+Child stdout:
+${logs.stdout.join("\n")}` : "";
+      const details = stderr.trim();
+      const suffix = details ? `
+Child stderr:
+${details}` : "\nChild did not emit keepAlive info.";
+      reject(
+        new Error(
+          `Child timed out waiting for info after ${infoTimeoutMs}ms (env=${config.env}, keepAlive=${config.keepAlive}, disableAPI=${config.disableAPI}, scenario=${config.kind}).${suffix}${stdoutDetails}`
+        )
+      );
+    }, infoTimeoutMs);
+    child.stdout.on("data", (chunk) => {
+      buffer += chunk.toString();
+      let idx = buffer.indexOf("\n");
+      while (idx !== -1) {
+        const line = buffer.slice(0, idx).trim();
+        buffer = buffer.slice(idx + 1);
+        const parsed = parseChildInfo(line);
+        if (parsed && !resolved) {
+          resolved = true;
+          clearTimeout(timeout);
+          resolve(parsed);
+        } else if (line.length > 0) {
+          logs.stdout.push(line);
+          debugLog(`[keep-alive-child] ${line}`);
+        }
+        idx = buffer.indexOf("\n");
+      }
+    });
+    child.on("exit", (code, signal) => {
+      if (resolved) return;
+      clearTimeout(timeout);
+      const stdoutDetails = logs.stdout.length > 0 ? `
+Child stdout:
+${logs.stdout.join("\n")}` : "";
+      const details = stderr.trim();
+      const suffix = details ? `
+Child stderr:
+${details}` : "\nChild exited without emitting keepAlive info.";
+      reject(
+        new Error(
+          `Child exited (code=${code ?? "null"}, signal=${signal ?? "null"}) before emitting keepAlive info (env=${config.env}, keepAlive=${config.keepAlive}, disableAPI=${config.disableAPI}, scenario=${config.kind}).${suffix}${stdoutDetails}`
+        )
+      );
+    });
+    child.on("error", (error) => {
+      if (resolved) return;
+      clearTimeout(timeout);
+      reject(error);
+    });
+  });
+  child.stderr.on("data", (chunk) => {
+    const text = chunk.toString();
+    stderr += text;
+    const trimmed = text.trim();
+    if (trimmed.length > 0) {
+      logs.stderr.push(trimmed);
+      debugLog(`[keep-alive-child] ${trimmed}`);
+    }
+  });
+  const info = await infoPromise;
+  return { info, child, logs };
+}
+async function stopChild(child) {
+  if (child.exitCode !== null) return;
+  try {
+    child.kill("SIGKILL");
+  } catch {
+    return;
+  }
+  await new Promise((resolve) => {
+    const timer = setTimeout(() => resolve(), 2e3);
+    child.once("exit", () => {
+      clearTimeout(timer);
+      resolve();
+    });
+  });
+}
+async function waitForChildExit(child, timeoutMs) {
+  if (child.exitCode !== null) return;
+  await new Promise((resolve) => {
+    const timer = setTimeout(() => resolve(), timeoutMs);
+    child.once("exit", () => {
+      clearTimeout(timer);
+      resolve();
+    });
+  });
+}
+async function checkLocalAlive(connectURL) {
+  let port = "";
+  try {
+    port = new URL(connectURL).port;
+  } catch {
+    return { alive: false, status: "INVALID_URL" };
+  }
+  if (!port) return { alive: false, status: "MISSING_PORT" };
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 1500);
+  try {
+    const resp = await fetch(`http://127.0.0.1:${port}/json/version`, {
+      signal: controller.signal
+    });
+    if (!resp.ok) {
+      return { alive: false, status: `HTTP_${resp.status}` };
+    }
+    const json = await resp.json();
+    const ws = json?.webSocketDebuggerUrl;
+    if (!ws) {
+      return { alive: false, status: "MISSING_WS" };
+    }
+    if (ws !== connectURL) {
+      return { alive: false, status: "WS_MISMATCH" };
+    }
+    return { alive: true, status: "MATCH" };
+  } catch {
+    return { alive: false, status: "FETCH_ERROR" };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function closeLocalBrowser(connectURL) {
+  await new Promise((resolve) => {
+    const ws = new WebSocket(connectURL);
+    const timer = setTimeout(() => {
+      ws.terminate();
+      resolve();
+    }, 2e3);
+    ws.on("open", () => {
+      ws.send(JSON.stringify({ id: 1, method: "Browser.close" }));
+    });
+    ws.on("error", () => {
+      clearTimeout(timer);
+      resolve();
+    });
+    ws.on("close", () => {
+      clearTimeout(timer);
+      resolve();
+    });
+  });
+}
+async function checkBrowserbaseAlive(sessionId, apiKey) {
+  if (!apiKey) return { alive: false, status: "NO_API_KEY" };
+  const bb = new Browserbase({ apiKey });
+  try {
+    const snapshot = await bb.sessions.retrieve(sessionId);
+    if (DEBUG) {
+      const status2 = snapshot?.status ?? "<missing>";
+      debugLog(`[keep-alive] session ${sessionId} status=${status2}`);
+    }
+    const status = snapshot?.status;
+    return { alive: status === "RUNNING", status };
+  } catch (error) {
+    debugLog(
+      `[keep-alive] session ${sessionId} retrieve failed: ${String(error)}`
+    );
+    return { alive: false, status: "RETRIEVE_FAILED" };
+  }
+}
+async function endBrowserbaseSession(sessionId, apiKey, projectId) {
+  if (!apiKey || !projectId) return;
+  const bb = new Browserbase({ apiKey });
+  try {
+    await bb.sessions.update(sessionId, {
+      status: "REQUEST_RELEASE",
+      projectId
+    });
+  } catch {
+  }
+}
+async function assertStaysOpen(check, durationMs, intervalMs = 500) {
+  const start = Date.now();
+  const deadline = start + durationMs;
+  let lastStatus;
+  while (Date.now() < deadline) {
+    const result = await check();
+    lastStatus = result.status ?? lastStatus;
+    if (!result.alive) {
+      const elapsed = Date.now() - start;
+      const status = lastStatus ? ` (last status ${lastStatus})` : "";
+      throw new Error(
+        `Browser closed after ${elapsed}ms (expected ${durationMs}ms)${status}.`
+      );
+    }
+    await new Promise((r) => setTimeout(r, intervalMs));
+  }
+  return { durationMs: Date.now() - start, lastStatus };
+}
+async function waitForClosed(check, timeoutMs, intervalMs = 500) {
+  const start = Date.now();
+  let lastStatus;
+  while (Date.now() - start < timeoutMs) {
+    const result = await check();
+    lastStatus = result.status ?? lastStatus;
+    if (!result.alive) {
+      return { durationMs: Date.now() - start, lastStatus };
+    }
+    await new Promise((r) => setTimeout(r, intervalMs));
+  }
+  const status = lastStatus ? ` (last status ${lastStatus})` : "";
+  throw new Error(`Browser still alive after ${timeoutMs}ms${status}.`);
+}
+async function assertBrowserState(env, info, shouldStayOpen, apiKey, projectId) {
+  const expected = shouldStayOpen ? "open" : "closed";
+  if (env === "LOCAL") {
+    if (shouldStayOpen) {
+      const result3 = await assertStaysOpen(
+        () => checkLocalAlive(info.connectURL),
+        STAY_OPEN_MS
+      );
+      const outcome = {
+        expected,
+        actual: "open",
+        durationMs: result3.durationMs,
+        lastStatus: result3.lastStatus
+      };
+      await closeLocalBrowser(info.connectURL);
+      return outcome;
+    }
+    const result2 = await waitForClosed(
+      () => checkLocalAlive(info.connectURL),
+      LOCAL_TIMEOUT_MS
+    );
+    return {
+      expected,
+      actual: "closed",
+      durationMs: result2.durationMs,
+      lastStatus: result2.lastStatus
+    };
+  }
+  if (!info.sessionId) {
+    throw new Error("Browserbase sessionId missing");
+  }
+  if (shouldStayOpen) {
+    const result2 = await assertStaysOpen(
+      () => checkBrowserbaseAlive(info.sessionId, apiKey),
+      STAY_OPEN_MS,
+      1e3
+    );
+    const outcome = {
+      expected,
+      actual: "open",
+      durationMs: result2.durationMs,
+      lastStatus: result2.lastStatus
+    };
+    await endBrowserbaseSession(info.sessionId, apiKey, projectId);
+    return outcome;
+  }
+  const result = await waitForClosed(
+    () => checkBrowserbaseAlive(info.sessionId, apiKey),
+    BB_TIMEOUT_MS,
+    1e3
+  );
+  return {
+    expected,
+    actual: "closed",
+    durationMs: result.durationMs,
+    lastStatus: result.lastStatus
+  };
+}
+function dumpLogs(logs) {
+  if (logs.stdout.length > 0) {
+    console.log("[keep-alive] child stdout:");
+    for (const line of logs.stdout) {
+      console.log(`  ${line}`);
+    }
+  }
+  if (logs.stderr.length > 0) {
+    console.log("[keep-alive] child stderr:");
+    for (const line of logs.stderr) {
+      console.log(`  ${line}`);
+    }
+  }
+}
+function logCaseResult(label, envLabel, keepAlive, outcome, error) {
+  const prefix = `[keep-alive] ${envLabel} keepAlive=${keepAlive} ${label}`;
+  if (error) {
+    console.log(`${prefix} FAIL: ${error.message}`);
+    return;
+  }
+  if (!outcome) {
+    console.log(`${prefix} FAIL: missing outcome`);
+    return;
+  }
+  const status = outcome.lastStatus !== void 0 ? ` (last status ${outcome.lastStatus})` : "";
+  if (outcome.actual === "open") {
+    console.log(
+      `${prefix} PASS: stayed open for ${outcome.durationMs}ms${status}`
+    );
+  } else {
+    console.log(
+      `${prefix} PASS: closed after ${outcome.durationMs}ms${status}`
+    );
+  }
+}
+function getKeepAliveEnvConfig() {
+  const testEnv = v3DynamicTestConfig.env;
+  const apiKey = testEnv === "BROWSERBASE" ? v3DynamicTestConfig.apiKey : void 0;
+  const projectId = testEnv === "BROWSERBASE" ? v3DynamicTestConfig.projectId : void 0;
+  const hasBrowserbaseCreds = Boolean(apiKey && projectId);
+  return { testEnv, apiKey, projectId, hasBrowserbaseCreds };
+}
+function buildKeepAliveCases(testEnv) {
+  const scenarios = [
+    { kind: "unhandled", label: "unhandled rejection" },
+    { kind: "close", label: "stagehand.close()" },
+    { kind: "sigterm", label: "SIGTERM" },
+    { kind: "sigint", label: "SIGINT" }
+  ];
+  const environments = testEnv === "BROWSERBASE" ? [
+    {
+      env: "BROWSERBASE",
+      label: "bb direct ws",
+      disableAPI: true,
+      requiresBrowserbase: true
+    },
+    {
+      env: "BROWSERBASE",
+      label: "bb via api",
+      disableAPI: false,
+      requiresBrowserbase: true
+    }
+  ] : [
+    {
+      env: "LOCAL",
+      label: "local",
+      disableAPI: false,
+      requiresBrowserbase: false
+    }
+  ];
+  const cases = [];
+  for (const keepAlive of [true, false]) {
+    for (const envConfig of environments) {
+      for (const scenario of scenarios) {
+        const expectation = keepAlive ? "expect open" : "expect closed";
+        cases.push({
+          title: `${envConfig.label} keepAlive=${keepAlive} ${scenario.label} (${expectation})`,
+          env: envConfig.env,
+          envLabel: envConfig.label,
+          keepAlive,
+          disableAPI: envConfig.disableAPI,
+          kind: scenario.kind,
+          requiresBrowserbase: envConfig.requiresBrowserbase
+        });
+      }
+    }
+  }
+  return cases;
+}
+async function runKeepAliveCase(testCase, envConfig) {
+  let info;
+  let child;
+  let logs;
+  try {
+    ({ info, child, logs } = await runScenario({
+      env: testCase.env,
+      keepAlive: testCase.keepAlive,
+      disableAPI: testCase.disableAPI,
+      kind: testCase.kind,
+      debug: DEBUG,
+      viewMs: VIEW_MS,
+      apiKey: envConfig.apiKey,
+      projectId: envConfig.projectId
+    }));
+  } catch (error) {
+    logCaseResult(
+      testCase.title,
+      testCase.envLabel,
+      testCase.keepAlive,
+      void 0,
+      error
+    );
+    throw error;
+  }
+  if (testCase.kind === "sigterm") {
+    child.kill("SIGTERM");
+  } else if (testCase.kind === "sigint") {
+    child.kill("SIGINT");
+  }
+  let outcome;
+  let failure;
+  try {
+    if (testCase.kind === "close" || testCase.kind === "unhandled" || testCase.kind === "sigterm" || testCase.kind === "sigint") {
+      await waitForChildExit(child, ACTION_EXIT_TIMEOUT_MS);
+    }
+    outcome = await assertBrowserState(
+      testCase.env,
+      info,
+      testCase.keepAlive,
+      envConfig.apiKey,
+      envConfig.projectId
+    );
+  } catch (error) {
+    failure = error;
+    if (logs) {
+      dumpLogs(logs);
+    }
+    throw error;
+  } finally {
+    logCaseResult(
+      testCase.title,
+      testCase.envLabel,
+      testCase.keepAlive,
+      outcome,
+      failure
+    );
+    await stopChild(child);
+    if (testCase.env === "LOCAL" && info.connectURL) {
+      await closeLocalBrowser(info.connectURL);
+    }
+    if (testCase.env === "BROWSERBASE" && info.sessionId) {
+      await endBrowserbaseSession(
+        info.sessionId,
+        envConfig.apiKey,
+        envConfig.projectId
+      );
+    }
+  }
+}
+export {
+  buildKeepAliveCases,
+  getKeepAliveEnvConfig,
+  runKeepAliveCase
+};
+//# sourceMappingURL=keep-alive.helpers.js.map

package/dist/esm/lib/v3/tests/keep-alive.helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/keep-alive.helpers.ts"],
+  "sourcesContent": ["import { spawn } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport Browserbase from \"@browserbasehq/sdk\";\nimport WebSocket from \"ws\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\n\nexport type EnvKind = \"LOCAL\" | \"BROWSERBASE\";\nexport type ScenarioKind = \"unhandled\" | \"close\" | \"sigterm\" | \"sigint\";\n\nexport type KeepAliveCase = {\n  title: string;\n  env: EnvKind;\n  envLabel: string;\n  keepAlive: boolean;\n  disableAPI: boolean;\n  kind: ScenarioKind;\n  requiresBrowserbase: boolean;\n};\n\ntype ScenarioConfig = {\n  env: EnvKind;\n  keepAlive: boolean;\n  disableAPI: boolean;\n  kind: ScenarioKind;\n  debug: boolean;\n  viewMs: number;\n  apiKey?: string;\n  projectId?: string;\n};\n\ntype ChildInfo = {\n  connectURL: string;\n  sessionId: string | null;\n};\n\ntype ChildLogs = {\n  stdout: string[];\n  stderr: string[];\n};\n\ntype CheckResult = {\n  alive: boolean;\n  status?: string;\n};\n\ntype Outcome = {\n  expected: \"open\" | \"closed\";\n  actual: \"open\" | \"closed\";\n  durationMs: number;\n  lastStatus?: string;\n};\n\nconst testsDir = path.dirname(fileURLToPath(import.meta.url));\nconst findCoreDir = (startDir: string): string => {\n  let current = path.resolve(startDir);\n  while (true) {\n    const packageJsonPath = path.join(current, \"package.json\");\n    if (fs.existsSync(packageJsonPath)) {\n      try {\n        const pkg = JSON.parse(fs.readFileSync(packageJsonPath, \"utf8\")) as {\n          name?: string;\n        };\n        if (pkg.name === \"@browserbasehq/stagehand\") {\n          return current;\n        }\n      } catch {\n        // keep climbing until we find the core package root\n      }\n    }\n\n    const parent = path.dirname(current);\n    if (parent === current) {\n      return path.resolve(startDir, \"../../..\");\n    }\n    current = parent;\n  }\n};\n\nconst coreDir = findCoreDir(testsDir);\n\nconst resolveChildRunner = (): { command: string; args: string[] } | null => {\n  const distJsPath = path.join(\n    coreDir,\n    \"dist\",\n    \"esm\",\n    \"lib\",\n    \"v3\",\n    \"tests\",\n    \"keep-alive.child.js\",\n  );\n  if (fs.existsSync(distJsPath)) {\n    return { command: process.execPath, args: [distJsPath] };\n  }\n\n  return null;\n};\n\nconst childRunner = resolveChildRunner();\n\nconst DEBUG = process.env.KEEP_ALIVE_DEBUG === \"1\";\nconst VIEW_MS = Number(process.env.KEEP_ALIVE_VIEW_MS ?? \"0\");\nconst LOCAL_TIMEOUT_MS = Number(\n  process.env.KEEP_ALIVE_LOCAL_TIMEOUT_MS ?? \"8000\",\n);\nconst BB_TIMEOUT_MS = Number(process.env.KEEP_ALIVE_BB_TIMEOUT_MS ?? \"30000\");\nconst STAY_OPEN_MS = Number(process.env.KEEP_ALIVE_STAY_OPEN_MS ?? \"6000\");\nconst ACTION_EXIT_TIMEOUT_MS = Number(\n  process.env.KEEP_ALIVE_ACTION_EXIT_TIMEOUT_MS ?? \"3000\",\n);\nconst LOCAL_INFO_TIMEOUT_MS = Number(\n  process.env.KEEP_ALIVE_LOCAL_INFO_TIMEOUT_MS ?? \"15000\",\n);\nconst BB_INFO_TIMEOUT_MS = Number(\n  process.env.KEEP_ALIVE_BB_INFO_TIMEOUT_MS ??\n    (process.env.CI ? \"45000\" : \"30000\"),\n);\n\nconst getInfoTimeoutMs = (env: EnvKind): number =>\n  env === \"BROWSERBASE\" ? BB_INFO_TIMEOUT_MS : LOCAL_INFO_TIMEOUT_MS;\n\nfunction debugLog(message: string): void {\n  if (DEBUG) {\n    console.log(message);\n  }\n}\n\nfunction parseChildInfo(line: string): ChildInfo | null {\n  const prefix = \"__KEEPALIVE__\";\n  if (!line.startsWith(prefix)) return null;\n  try {\n    return JSON.parse(line.slice(prefix.length)) as ChildInfo;\n  } catch {\n    return null;\n  }\n}\n\nasync function runScenario(config: ScenarioConfig): Promise<{\n  info: ChildInfo;\n  child: ReturnType<typeof spawn>;\n  logs: ChildLogs;\n}> {\n  const payload = {\n    env: config.env,\n    keepAlive: config.keepAlive,\n    disableAPI: config.disableAPI,\n    scenario: config.kind,\n    apiKey: config.apiKey,\n    projectId: config.projectId,\n    debug: config.debug,\n    viewMs: config.viewMs,\n  };\n  const encoded = `cfg:${Buffer.from(JSON.stringify(payload)).toString(\"base64\")}`;\n\n  if (!childRunner) {\n    throw new Error(\n      \"keep-alive child script not found at dist/esm/lib/v3/tests/keep-alive.child.js\",\n    );\n  }\n\n  const child = spawn(childRunner.command, [...childRunner.args, encoded], {\n    cwd: coreDir,\n    env: { ...process.env },\n    stdio: [\"ignore\", \"pipe\", \"pipe\"],\n  });\n\n  const logs: ChildLogs = { stdout: [], stderr: [] };\n  let buffer = \"\";\n  let stderr = \"\";\n  let resolved = false;\n  const infoTimeoutMs = getInfoTimeoutMs(config.env);\n\n  const infoPromise = new Promise<ChildInfo>((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      child.kill(\"SIGKILL\");\n      const stdoutDetails =\n        logs.stdout.length > 0\n          ? `\\nChild stdout:\\n${logs.stdout.join(\"\\n\")}`\n          : \"\";\n      const details = stderr.trim();\n      const suffix = details\n        ? `\\nChild stderr:\\n${details}`\n        : \"\\nChild did not emit keepAlive info.\";\n      reject(\n        new Error(\n          `Child timed out waiting for info after ${infoTimeoutMs}ms (env=${config.env}, keepAlive=${config.keepAlive}, disableAPI=${config.disableAPI}, scenario=${config.kind}).${suffix}${stdoutDetails}`,\n        ),\n      );\n    }, infoTimeoutMs);\n\n    child.stdout.on(\"data\", (chunk) => {\n      buffer += chunk.toString();\n      let idx = buffer.indexOf(\"\\n\");\n      while (idx !== -1) {\n        const line = buffer.slice(0, idx).trim();\n        buffer = buffer.slice(idx + 1);\n        const parsed = parseChildInfo(line);\n        if (parsed && !resolved) {\n          resolved = true;\n          clearTimeout(timeout);\n          resolve(parsed);\n        } else if (line.length > 0) {\n          logs.stdout.push(line);\n          debugLog(`[keep-alive-child] ${line}`);\n        }\n        idx = buffer.indexOf(\"\\n\");\n      }\n    });\n\n    child.on(\"exit\", (code, signal) => {\n      if (resolved) return;\n      clearTimeout(timeout);\n      const stdoutDetails =\n        logs.stdout.length > 0\n          ? `\\nChild stdout:\\n${logs.stdout.join(\"\\n\")}`\n          : \"\";\n      const details = stderr.trim();\n      const suffix = details\n        ? `\\nChild stderr:\\n${details}`\n        : \"\\nChild exited without emitting keepAlive info.\";\n      reject(\n        new Error(\n          `Child exited (code=${code ?? \"null\"}, signal=${signal ?? \"null\"}) before emitting keepAlive info (env=${config.env}, keepAlive=${config.keepAlive}, disableAPI=${config.disableAPI}, scenario=${config.kind}).${suffix}${stdoutDetails}`,\n        ),\n      );\n    });\n\n    child.on(\"error\", (error) => {\n      if (resolved) return;\n      clearTimeout(timeout);\n      reject(error);\n    });\n  });\n\n  child.stderr.on(\"data\", (chunk) => {\n    const text = chunk.toString();\n    stderr += text;\n    const trimmed = text.trim();\n    if (trimmed.length > 0) {\n      logs.stderr.push(trimmed);\n      debugLog(`[keep-alive-child] ${trimmed}`);\n    }\n  });\n\n  const info = await infoPromise;\n  return { info, child, logs };\n}\n\nasync function stopChild(child: ReturnType<typeof spawn>): Promise<void> {\n  if (child.exitCode !== null) return;\n  try {\n    child.kill(\"SIGKILL\");\n  } catch {\n    return;\n  }\n  await new Promise<void>((resolve) => {\n    const timer = setTimeout(() => resolve(), 2000);\n    child.once(\"exit\", () => {\n      clearTimeout(timer);\n      resolve();\n    });\n  });\n}\n\nasync function waitForChildExit(\n  child: ReturnType<typeof spawn>,\n  timeoutMs: number,\n): Promise<void> {\n  if (child.exitCode !== null) return;\n  await new Promise<void>((resolve) => {\n    const timer = setTimeout(() => resolve(), timeoutMs);\n    child.once(\"exit\", () => {\n      clearTimeout(timer);\n      resolve();\n    });\n  });\n}\n\nasync function checkLocalAlive(connectURL: string): Promise<CheckResult> {\n  let port = \"\";\n  try {\n    port = new URL(connectURL).port;\n  } catch {\n    return { alive: false, status: \"INVALID_URL\" };\n  }\n  if (!port) return { alive: false, status: \"MISSING_PORT\" };\n\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), 1500);\n  try {\n    const resp = await fetch(`http://127.0.0.1:${port}/json/version`, {\n      signal: controller.signal,\n    });\n    if (!resp.ok) {\n      return { alive: false, status: `HTTP_${resp.status}` };\n    }\n    const json = (await resp.json()) as { webSocketDebuggerUrl?: string };\n    const ws = json?.webSocketDebuggerUrl;\n    if (!ws) {\n      return { alive: false, status: \"MISSING_WS\" };\n    }\n    if (ws !== connectURL) {\n      return { alive: false, status: \"WS_MISMATCH\" };\n    }\n    return { alive: true, status: \"MATCH\" };\n  } catch {\n    return { alive: false, status: \"FETCH_ERROR\" };\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\nasync function closeLocalBrowser(connectURL: string): Promise<void> {\n  await new Promise<void>((resolve) => {\n    const ws = new WebSocket(connectURL);\n    const timer = setTimeout(() => {\n      ws.terminate();\n      resolve();\n    }, 2000);\n    ws.on(\"open\", () => {\n      ws.send(JSON.stringify({ id: 1, method: \"Browser.close\" }));\n    });\n    ws.on(\"error\", () => {\n      clearTimeout(timer);\n      resolve();\n    });\n    ws.on(\"close\", () => {\n      clearTimeout(timer);\n      resolve();\n    });\n  });\n}\n\nasync function checkBrowserbaseAlive(\n  sessionId: string,\n  apiKey?: string,\n): Promise<CheckResult> {\n  if (!apiKey) return { alive: false, status: \"NO_API_KEY\" };\n\n  const bb = new Browserbase({ apiKey });\n  try {\n    const snapshot = (await bb.sessions.retrieve(sessionId)) as {\n      status?: string;\n    };\n    if (DEBUG) {\n      const status = snapshot?.status ?? \"<missing>\";\n      debugLog(`[keep-alive] session ${sessionId} status=${status}`);\n    }\n    const status = snapshot?.status;\n    return { alive: status === \"RUNNING\", status };\n  } catch (error) {\n    debugLog(\n      `[keep-alive] session ${sessionId} retrieve failed: ${String(error)}`,\n    );\n    return { alive: false, status: \"RETRIEVE_FAILED\" };\n  }\n}\n\nasync function endBrowserbaseSession(\n  sessionId: string,\n  apiKey?: string,\n  projectId?: string,\n): Promise<void> {\n  if (!apiKey || !projectId) return;\n  const bb = new Browserbase({ apiKey });\n  try {\n    await bb.sessions.update(sessionId, {\n      status: \"REQUEST_RELEASE\",\n      projectId,\n    });\n  } catch {\n    // best-effort cleanup\n  }\n}\n\nasync function assertStaysOpen(\n  check: () => Promise<CheckResult>,\n  durationMs: number,\n  intervalMs = 500,\n): Promise<{ durationMs: number; lastStatus?: string }> {\n  const start = Date.now();\n  const deadline = start + durationMs;\n  let lastStatus: string | undefined;\n  while (Date.now() < deadline) {\n    const result = await check();\n    lastStatus = result.status ?? lastStatus;\n    if (!result.alive) {\n      const elapsed = Date.now() - start;\n      const status = lastStatus ? ` (last status ${lastStatus})` : \"\";\n      throw new Error(\n        `Browser closed after ${elapsed}ms (expected ${durationMs}ms)${status}.`,\n      );\n    }\n    await new Promise((r) => setTimeout(r, intervalMs));\n  }\n  return { durationMs: Date.now() - start, lastStatus };\n}\n\nasync function waitForClosed(\n  check: () => Promise<CheckResult>,\n  timeoutMs: number,\n  intervalMs = 500,\n): Promise<{ durationMs: number; lastStatus?: string }> {\n  const start = Date.now();\n  let lastStatus: string | undefined;\n  while (Date.now() - start < timeoutMs) {\n    const result = await check();\n    lastStatus = result.status ?? lastStatus;\n    if (!result.alive) {\n      return { durationMs: Date.now() - start, lastStatus };\n    }\n    await new Promise((r) => setTimeout(r, intervalMs));\n  }\n  const status = lastStatus ? ` (last status ${lastStatus})` : \"\";\n  throw new Error(`Browser still alive after ${timeoutMs}ms${status}.`);\n}\n\nasync function assertBrowserState(\n  env: EnvKind,\n  info: ChildInfo,\n  shouldStayOpen: boolean,\n  apiKey?: string,\n  projectId?: string,\n): Promise<Outcome> {\n  const expected: Outcome[\"expected\"] = shouldStayOpen ? \"open\" : \"closed\";\n  if (env === \"LOCAL\") {\n    if (shouldStayOpen) {\n      const result = await assertStaysOpen(\n        () => checkLocalAlive(info.connectURL),\n        STAY_OPEN_MS,\n      );\n      const outcome: Outcome = {\n        expected,\n        actual: \"open\",\n        durationMs: result.durationMs,\n        lastStatus: result.lastStatus,\n      };\n      await closeLocalBrowser(info.connectURL);\n      return outcome;\n    }\n\n    const result = await waitForClosed(\n      () => checkLocalAlive(info.connectURL),\n      LOCAL_TIMEOUT_MS,\n    );\n    return {\n      expected,\n      actual: \"closed\",\n      durationMs: result.durationMs,\n      lastStatus: result.lastStatus,\n    };\n  }\n\n  if (!info.sessionId) {\n    throw new Error(\"Browserbase sessionId missing\");\n  }\n\n  if (shouldStayOpen) {\n    const result = await assertStaysOpen(\n      () => checkBrowserbaseAlive(info.sessionId!, apiKey),\n      STAY_OPEN_MS,\n      1000,\n    );\n    const outcome: Outcome = {\n      expected,\n      actual: \"open\",\n      durationMs: result.durationMs,\n      lastStatus: result.lastStatus,\n    };\n    await endBrowserbaseSession(info.sessionId, apiKey, projectId);\n    return outcome;\n  }\n\n  const result = await waitForClosed(\n    () => checkBrowserbaseAlive(info.sessionId!, apiKey),\n    BB_TIMEOUT_MS,\n    1000,\n  );\n  return {\n    expected,\n    actual: \"closed\",\n    durationMs: result.durationMs,\n    lastStatus: result.lastStatus,\n  };\n}\n\nfunction dumpLogs(logs: ChildLogs): void {\n  if (logs.stdout.length > 0) {\n    console.log(\"[keep-alive] child stdout:\");\n    for (const line of logs.stdout) {\n      console.log(`  ${line}`);\n    }\n  }\n  if (logs.stderr.length > 0) {\n    console.log(\"[keep-alive] child stderr:\");\n    for (const line of logs.stderr) {\n      console.log(`  ${line}`);\n    }\n  }\n}\n\nfunction logCaseResult(\n  label: string,\n  envLabel: string,\n  keepAlive: boolean,\n  outcome?: Outcome,\n  error?: Error,\n): void {\n  const prefix = `[keep-alive] ${envLabel} keepAlive=${keepAlive} ${label}`;\n  if (error) {\n    console.log(`${prefix} FAIL: ${error.message}`);\n    return;\n  }\n  if (!outcome) {\n    console.log(`${prefix} FAIL: missing outcome`);\n    return;\n  }\n  const status =\n    outcome.lastStatus !== undefined\n      ? ` (last status ${outcome.lastStatus})`\n      : \"\";\n  if (outcome.actual === \"open\") {\n    console.log(\n      `${prefix} PASS: stayed open for ${outcome.durationMs}ms${status}`,\n    );\n  } else {\n    console.log(\n      `${prefix} PASS: closed after ${outcome.durationMs}ms${status}`,\n    );\n  }\n}\n\nexport function getKeepAliveEnvConfig(): {\n  testEnv: EnvKind;\n  apiKey?: string;\n  projectId?: string;\n  hasBrowserbaseCreds: boolean;\n} {\n  const testEnv = v3DynamicTestConfig.env;\n  const apiKey =\n    testEnv === \"BROWSERBASE\"\n      ? (v3DynamicTestConfig.apiKey as string | undefined)\n      : undefined;\n  const projectId =\n    testEnv === \"BROWSERBASE\"\n      ? (v3DynamicTestConfig.projectId as string | undefined)\n      : undefined;\n  const hasBrowserbaseCreds = Boolean(apiKey && projectId);\n  return { testEnv, apiKey, projectId, hasBrowserbaseCreds };\n}\n\nexport function buildKeepAliveCases(testEnv: EnvKind): KeepAliveCase[] {\n  const scenarios: Array<{ kind: ScenarioKind; label: string }> = [\n    { kind: \"unhandled\", label: \"unhandled rejection\" },\n    { kind: \"close\", label: \"stagehand.close()\" },\n    { kind: \"sigterm\", label: \"SIGTERM\" },\n    { kind: \"sigint\", label: \"SIGINT\" },\n  ];\n\n  const environments: Array<{\n    env: EnvKind;\n    label: string;\n    disableAPI: boolean;\n    requiresBrowserbase: boolean;\n  }> =\n    testEnv === \"BROWSERBASE\"\n      ? [\n          {\n            env: \"BROWSERBASE\",\n            label: \"bb direct ws\",\n            disableAPI: true,\n            requiresBrowserbase: true,\n          },\n          {\n            env: \"BROWSERBASE\",\n            label: \"bb via api\",\n            disableAPI: false,\n            requiresBrowserbase: true,\n          },\n        ]\n      : [\n          {\n            env: \"LOCAL\",\n            label: \"local\",\n            disableAPI: false,\n            requiresBrowserbase: false,\n          },\n        ];\n\n  const cases: KeepAliveCase[] = [];\n  for (const keepAlive of [true, false]) {\n    for (const envConfig of environments) {\n      for (const scenario of scenarios) {\n        const expectation = keepAlive ? \"expect open\" : \"expect closed\";\n        cases.push({\n          title: `${envConfig.label} keepAlive=${keepAlive} ${scenario.label} (${expectation})`,\n          env: envConfig.env,\n          envLabel: envConfig.label,\n          keepAlive,\n          disableAPI: envConfig.disableAPI,\n          kind: scenario.kind,\n          requiresBrowserbase: envConfig.requiresBrowserbase,\n        });\n      }\n    }\n  }\n  return cases;\n}\n\nexport async function runKeepAliveCase(\n  testCase: KeepAliveCase,\n  envConfig: {\n    apiKey?: string;\n    projectId?: string;\n  },\n): Promise<void> {\n  let info: ChildInfo | undefined;\n  let child: ReturnType<typeof spawn> | undefined;\n  let logs: ChildLogs | undefined;\n  try {\n    ({ info, child, logs } = await runScenario({\n      env: testCase.env,\n      keepAlive: testCase.keepAlive,\n      disableAPI: testCase.disableAPI,\n      kind: testCase.kind,\n      debug: DEBUG,\n      viewMs: VIEW_MS,\n      apiKey: envConfig.apiKey,\n      projectId: envConfig.projectId,\n    }));\n  } catch (error) {\n    logCaseResult(\n      testCase.title,\n      testCase.envLabel,\n      testCase.keepAlive,\n      undefined,\n      error as Error,\n    );\n    throw error;\n  }\n\n  if (testCase.kind === \"sigterm\") {\n    child.kill(\"SIGTERM\");\n  } else if (testCase.kind === \"sigint\") {\n    child.kill(\"SIGINT\");\n  }\n\n  let outcome: Outcome | undefined;\n  let failure: Error | undefined;\n  try {\n    if (\n      testCase.kind === \"close\" ||\n      testCase.kind === \"unhandled\" ||\n      testCase.kind === \"sigterm\" ||\n      testCase.kind === \"sigint\"\n    ) {\n      await waitForChildExit(child, ACTION_EXIT_TIMEOUT_MS);\n    }\n    outcome = await assertBrowserState(\n      testCase.env,\n      info,\n      testCase.keepAlive,\n      envConfig.apiKey,\n      envConfig.projectId,\n    );\n  } catch (error) {\n    failure = error as Error;\n    if (logs) {\n      dumpLogs(logs);\n    }\n    throw error;\n  } finally {\n    logCaseResult(\n      testCase.title,\n      testCase.envLabel,\n      testCase.keepAlive,\n      outcome,\n      failure,\n    );\n    await stopChild(child);\n    if (testCase.env === \"LOCAL\" && info.connectURL) {\n      await closeLocalBrowser(info.connectURL);\n    }\n    if (testCase.env === \"BROWSERBASE\" && info.sessionId) {\n      await endBrowserbaseSession(\n        info.sessionId,\n        envConfig.apiKey,\n        envConfig.projectId,\n      );\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["status", "result"]
+}

package/dist/esm/lib/v3/tests/keep-alive.spec.js

@@ -0,0 +1,19 @@
+import { test } from "@playwright/test";
+import {
+  buildKeepAliveCases,
+  getKeepAliveEnvConfig,
+  runKeepAliveCase
+} from "./keep-alive.helpers.js";
+test.describe.parallel("keepAlive behavior", () => {
+  const { testEnv, apiKey, projectId, hasBrowserbaseCreds } = getKeepAliveEnvConfig();
+  const cases = buildKeepAliveCases(testEnv);
+  for (const testCase of cases) {
+    test(testCase.title, async () => {
+      if (testCase.requiresBrowserbase) {
+        test.skip(!hasBrowserbaseCreds, "Browserbase credentials required");
+      }
+      await runKeepAliveCase(testCase, { apiKey, projectId });
+    });
+  }
+});
+//# sourceMappingURL=keep-alive.spec.js.map

package/dist/esm/lib/v3/tests/keep-alive.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/keep-alive.spec.ts"],
+  "sourcesContent": ["import { test } from \"@playwright/test\";\nimport {\n  buildKeepAliveCases,\n  getKeepAliveEnvConfig,\n  runKeepAliveCase,\n} from \"./keep-alive.helpers.js\";\n\ntest.describe.parallel(\"keepAlive behavior\", () => {\n  const { testEnv, apiKey, projectId, hasBrowserbaseCreds } =\n    getKeepAliveEnvConfig();\n  const cases = buildKeepAliveCases(testEnv);\n\n  for (const testCase of cases) {\n    test(testCase.title, async () => {\n      if (testCase.requiresBrowserbase) {\n        test.skip(!hasBrowserbaseCreds, \"Browserbase credentials required\");\n      }\n\n      await runKeepAliveCase(testCase, { apiKey, projectId });\n    });\n  }\n});\n"],
+  "mappings": "AAAA,SAAS,YAAY;AACrB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,KAAK,SAAS,SAAS,sBAAsB,MAAM;AACjD,QAAM,EAAE,SAAS,QAAQ,WAAW,oBAAoB,IACtD,sBAAsB;AACxB,QAAM,QAAQ,oBAAoB,OAAO;AAEzC,aAAW,YAAY,OAAO;AAC5B,SAAK,SAAS,OAAO,YAAY;AAC/B,UAAI,SAAS,qBAAqB;AAChC,aAAK,KAAK,CAAC,qBAAqB,kCAAkC;AAAA,MACpE;AAEA,YAAM,iBAAiB,UAAU,EAAE,QAAQ,UAAU,CAAC;AAAA,IACxD,CAAC;AAAA,EACH;AACF,CAAC;",
+  "names": []
+}