@browserbasehq/orca 3.1.0-patch.3 → 3.2.0-preview.1

package/dist/esm/tests/integration/keep-alive.child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-alive.child.js","sourceRoot":"","sources":["../../../../tests/integration/keep-alive.child.ts"],"names":[],"mappings":"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","sourcesContent":["import { V3 } from \"../../lib/v3/v3.js\";\n\nasync function main(): Promise<void> {\n  const encoded = process.argv.find((arg) => arg.startsWith(\"cfg:\"));\n  if (!encoded) {\n    throw new Error(\"Missing child config payload.\");\n  }\n  const raw = Buffer.from(encoded.slice(4), \"base64\").toString(\"utf8\");\n  const cfg = JSON.parse(raw) as {\n    env: \"LOCAL\" | \"BROWSERBASE\";\n    keepAlive: boolean;\n    disableAPI: boolean;\n    scenario: string;\n    apiKey?: string;\n    projectId?: string;\n    debug?: boolean;\n    viewMs?: number;\n  };\n  const {\n    env,\n    keepAlive,\n    disableAPI,\n    scenario,\n    apiKey,\n    projectId,\n    debug = false,\n    viewMs = 0,\n  } = cfg;\n\n  const log = (message: string): void => {\n    if (debug) {\n      console.log(message);\n    }\n  };\n\n  if (env !== \"LOCAL\" && env !== \"BROWSERBASE\") {\n    throw new Error(\"KEEP_ALIVE_ENV must be LOCAL or BROWSERBASE\");\n  }\n  if (!scenario) {\n    throw new Error(\"KEEP_ALIVE_SCENARIO is required\");\n  }\n\n  log(\n    `[keep-alive-child] env=${env} keepAlive=${keepAlive} disableAPI=${disableAPI} ` +\n      `scenario=${scenario} apiKey=${apiKey ? \"set\" : \"missing\"} ` +\n      `projectId=${projectId ? \"set\" : \"missing\"}`,\n  );\n\n  const showBrowser = viewMs > 0;\n  const v3 = new V3({\n    env,\n    keepAlive,\n    disableAPI,\n    apiKey,\n    projectId,\n    browserbaseSessionCreateParams: undefined,\n    localBrowserLaunchOptions:\n      env === \"LOCAL\"\n        ? {\n            executablePath: process.env.CHROME_PATH,\n            args: process.env.CI ? [\"--no-sandbox\"] : undefined,\n            headless: !showBrowser,\n            viewport: { width: 1288, height: 711 },\n          }\n        : undefined,\n    verbose: debug ? 2 : 0,\n    disablePino: true,\n    logger: debug ? (line) => console.log(line) : undefined,\n  });\n\n  await v3.init();\n\n  const info = {\n    connectURL: v3.connectURL(),\n    sessionId: v3.browserbaseSessionId ?? null,\n  };\n  await new Promise<void>((resolve, reject) => {\n    process.stdout.write(`__KEEPALIVE__${JSON.stringify(info)}\\n`, (error) => {\n      if (error) {\n        reject(error);\n        return;\n      }\n      resolve();\n    });\n  });\n\n  if (env === \"LOCAL\" && viewMs > 0) {\n    await new Promise((r) => setTimeout(r, viewMs));\n  }\n\n  if (scenario === \"close\") {\n    await v3.close().catch(() => {});\n    process.exit(0);\n  }\n\n  if (scenario === \"sigterm\") {\n    return;\n  }\n\n  if (scenario === \"sigint\") {\n    return;\n  }\n\n  if (scenario === \"unhandled\") {\n    setTimeout(() => {\n      void Promise.reject(new Error(\"keepAlive unhandled rejection\"));\n    }, 0);\n    return;\n  }\n\n  throw new Error(`Unknown scenario: ${scenario}`);\n}\n\nmain().catch((err) => {\n  console.error(err);\n  process.exit(1);\n});\n"]}

package/dist/esm/tests/integration/keep-alive.spec.d.ts

@@ -0,0 +1,22 @@
+export type EnvKind = "LOCAL" | "BROWSERBASE";
+export type ScenarioKind = "unhandled" | "close" | "sigterm" | "sigint";
+export type KeepAliveCase = {
+    title: string;
+    env: EnvKind;
+    envLabel: string;
+    keepAlive: boolean;
+    disableAPI: boolean;
+    kind: ScenarioKind;
+    requiresBrowserbase: boolean;
+};
+export declare function getKeepAliveEnvConfig(): {
+    testEnv: EnvKind;
+    apiKey?: string;
+    projectId?: string;
+    hasBrowserbaseCreds: boolean;
+};
+export declare function buildKeepAliveCases(testEnv: EnvKind): KeepAliveCase[];
+export declare function runKeepAliveCase(testCase: KeepAliveCase, envConfig: {
+    apiKey?: string;
+    projectId?: string;
+}): Promise<void>;

package/dist/esm/tests/integration/keep-alive.spec.js

@@ -0,0 +1,482 @@
+import { test } from "@playwright/test";
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import Browserbase from "@browserbasehq/sdk";
+import WebSocket from "ws";
+import { v3DynamicTestConfig } from "./v3.dynamic.config.js";
+import { getPackageRootDir } from "../../lib/v3/runtimePaths.js";
+const coreDir = getPackageRootDir();
+const resolveChildRunner = () => {
+    const distJsPath = `${coreDir}/dist/esm/tests/integration/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/tests/integration/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
+                ? `\nChild stdout:\n${logs.stdout.join("\n")}`
+                : "";
+            const details = stderr.trim();
+            const suffix = details
+                ? `\nChild stderr:\n${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
+                ? `\nChild stdout:\n${logs.stdout.join("\n")}`
+                : "";
+            const details = stderr.trim();
+            const suffix = details
+                ? `\nChild stderr:\n${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(), 2000);
+        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();
+        }, 2000);
+        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 status = snapshot?.status ?? "<missing>";
+            debugLog(`[keep-alive] session ${sessionId} status=${status}`);
+        }
+        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 {
+        // best-effort cleanup
+    }
+}
+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 result = await assertStaysOpen(() => checkLocalAlive(info.connectURL), STAY_OPEN_MS);
+            const outcome = {
+                expected,
+                actual: "open",
+                durationMs: result.durationMs,
+                lastStatus: result.lastStatus,
+            };
+            await closeLocalBrowser(info.connectURL);
+            return outcome;
+        }
+        const result = await waitForClosed(() => checkLocalAlive(info.connectURL), LOCAL_TIMEOUT_MS);
+        return {
+            expected,
+            actual: "closed",
+            durationMs: result.durationMs,
+            lastStatus: result.lastStatus,
+        };
+    }
+    if (!info.sessionId) {
+        throw new Error("Browserbase sessionId missing");
+    }
+    if (shouldStayOpen) {
+        const result = await assertStaysOpen(() => checkBrowserbaseAlive(info.sessionId, apiKey), STAY_OPEN_MS, 1000);
+        const outcome = {
+            expected,
+            actual: "open",
+            durationMs: result.durationMs,
+            lastStatus: result.lastStatus,
+        };
+        await endBrowserbaseSession(info.sessionId, apiKey, projectId);
+        return outcome;
+    }
+    const result = await waitForClosed(() => checkBrowserbaseAlive(info.sessionId, apiKey), BB_TIMEOUT_MS, 1000);
+    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 !== undefined
+        ? ` (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}`);
+    }
+}
+export function getKeepAliveEnvConfig() {
+    const testEnv = v3DynamicTestConfig.env;
+    const apiKey = testEnv === "BROWSERBASE"
+        ? v3DynamicTestConfig.apiKey
+        : undefined;
+    const projectId = testEnv === "BROWSERBASE"
+        ? v3DynamicTestConfig.projectId
+        : undefined;
+    const hasBrowserbaseCreds = Boolean(apiKey && projectId);
+    return { testEnv, apiKey, projectId, hasBrowserbaseCreds };
+}
+export 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;
+}
+export 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, undefined, 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);
+        }
+    }
+}
+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/tests/integration/keep-alive.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-alive.spec.js","sourceRoot":"","sources":["../../../../tests/integration/keep-alive.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { test } from \"@playwright/test\";\nimport { spawn } from \"node:child_process\";\nimport fs from \"node:fs\";\nimport Browserbase from \"@browserbasehq/sdk\";\nimport WebSocket from \"ws\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { getPackageRootDir } from \"../../lib/v3/runtimePaths.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 coreDir = getPackageRootDir();\n\nconst resolveChildRunner = (): { command: string; args: string[] } | null => {\n  const distJsPath = `${coreDir}/dist/esm/tests/integration/keep-alive.child.js`;\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/tests/integration/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: string;\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\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"]}

package/dist/esm/tests/integration/keyboard.spec.d.ts

@@ -0,0 +1 @@
+export {};