@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-headers

package/dist/cjs/lib/v3/timeoutConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeoutConfig.js","sourceRoot":"","sources":["../../../../lib/v3/timeoutConfig.ts"],"names":[],"mappings":";;AAEA,0CAOC;AAED,kCAwBC;AAnCD,8DAA2D;AAE3D,SAAgB,eAAe,CAAC,IAAY;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC;AAEM,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,SAAoC,EACpC,SAAiB;IAEjB,IACE,OAAO,SAAS,KAAK,QAAQ;QAC7B,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,SAAS,IAAI,CAAC,EACd,CAAC;QACD,OAAO,MAAM,OAAO,CAAC;IACvB,CAAC;IAED,IAAI,SAAqC,CAAC;IAC1C,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACtD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,CAAC,IAAI,2BAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QACjD,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IACvD,CAAC;YAAS,CAAC;QACT,IAAI,SAAS;YAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;AACH,CAAC","sourcesContent":["import { TimeoutError } from \"./types/public/sdkErrors.js\";\n\nexport function getEnvTimeoutMs(name: string): number | undefined {\n  const raw = process.env[name];\n  if (!raw) return undefined;\n  const normalized = raw.trim().replace(/ms$/i, \"\");\n  const value = Number(normalized);\n  if (!Number.isFinite(value) || value <= 0) return undefined;\n  return value;\n}\n\nexport async function withTimeout<T>(\n  promise: Promise<T>,\n  timeoutMs: number | null | undefined,\n  operation: string,\n): Promise<T> {\n  if (\n    typeof timeoutMs !== \"number\" ||\n    !Number.isFinite(timeoutMs) ||\n    timeoutMs <= 0\n  ) {\n    return await promise;\n  }\n\n  let timeoutId: NodeJS.Timeout | undefined;\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeoutId = setTimeout(() => {\n      reject(new TimeoutError(operation, timeoutMs));\n    }, timeoutMs);\n  });\n  try {\n    return await Promise.race([promise, timeoutPromise]);\n  } finally {\n    if (timeoutId) clearTimeout(timeoutId);\n  }\n}\n"]}

package/dist/cjs/lib/v3/types/private/agent.d.ts

@@ -0,0 +1,6 @@
+export interface ActionMappingOptions {
+    toolCallName: string;
+    toolResult: unknown;
+    args: Record<string, unknown>;
+    reasoning?: string;
+}

package/dist/cjs/lib/v3/types/private/agent.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agent.js.map

package/dist/cjs/lib/v3/types/private/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/agent.ts"],"names":[],"mappings":"","sourcesContent":["export interface ActionMappingOptions {\n  toolCallName: string;\n  toolResult: unknown;\n  args: Record<string, unknown>;\n  reasoning?: string;\n}\n"]}

package/dist/cjs/lib/v3/types/private/api.d.ts

@@ -0,0 +1,11 @@
+import type { Protocol } from "devtools-protocol";
+export interface SerializableResponse {
+    requestId: string;
+    frameId?: string;
+    loaderId?: string;
+    response: Protocol.Network.Response;
+    fromServiceWorkerFlag?: boolean;
+    finishedSettled?: boolean;
+    extraInfoHeaders?: Protocol.Network.Headers | null;
+    extraInfoHeadersText?: string;
+}

package/dist/cjs/lib/v3/types/private/api.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.js.map

package/dist/cjs/lib/v3/types/private/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/api.ts"],"names":[],"mappings":"","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\n\nexport interface SerializableResponse {\n  requestId: string;\n  frameId?: string;\n  loaderId?: string;\n  response: Protocol.Network.Response;\n  fromServiceWorkerFlag?: boolean;\n  finishedSettled?: boolean;\n  extraInfoHeaders?: Protocol.Network.Headers | null;\n  extraInfoHeadersText?: string;\n}\n"]}

package/dist/cjs/lib/v3/types/private/cache.d.ts

@@ -0,0 +1,131 @@
+import type { ActOptions, ActResult, AvailableModel, Logger, AgentResult, Action, LoadState } from "../public/index.js";
+import { CacheStorage } from "../../cache/CacheStorage.js";
+import type { ActHandler } from "../../handlers/actHandler.js";
+import type { V3Context } from "../../understudy/context.js";
+import type { LLMClient } from "../../llm/LLMClient.js";
+export type ActFn = (instruction: string, options?: ActOptions) => Promise<ActResult>;
+export type AgentCacheContext = {
+    instruction: string;
+    startUrl: string;
+    options: SanitizedAgentExecuteOptions;
+    configSignature: string;
+    cacheKey: string;
+    variableKeys: string[] /** Variable keys used in this execution (for cache key) */;
+    /** Variable values to substitute during replay */
+    variables?: Record<string, string>;
+};
+export type AgentCacheTransferPayload = {
+    cacheKey: string;
+    entry: CachedAgentEntry;
+};
+export type AgentCacheDeps = {
+    storage: CacheStorage;
+    logger: Logger;
+    getActHandler: () => ActHandler | null;
+    getContext: () => V3Context | null;
+    getDefaultLlmClient: () => LLMClient;
+    getBaseModelName: () => AvailableModel;
+    getSystemPrompt: () => string | undefined;
+    domSettleTimeoutMs?: number;
+    act: ActFn;
+    bufferLatestEntry?: boolean;
+};
+export type ActCacheContext = {
+    instruction: string;
+    cacheKey: string;
+    pageUrl: string;
+    variableKeys: string[];
+    variables?: Record<string, string>;
+};
+export type ActCacheDeps = {
+    storage: CacheStorage;
+    logger: Logger;
+    getActHandler: () => ActHandler | null;
+    getDefaultLlmClient: () => LLMClient;
+    domSettleTimeoutMs?: number;
+};
+export type ReadJsonResult<T> = {
+    value: T | null;
+    path?: string;
+    error?: unknown;
+};
+export type WriteJsonResult = {
+    path?: string;
+    error?: unknown;
+};
+export interface CachedActEntry {
+    version: 1;
+    instruction: string;
+    url: string;
+    variableKeys: string[];
+    actions: Action[];
+    actionDescription?: string;
+    message?: string;
+}
+export type AgentReplayStep = AgentReplayActStep | AgentReplayFillFormStep | AgentReplayGotoStep | AgentReplayScrollStep | AgentReplayWaitStep | AgentReplayNavBackStep | AgentReplayKeysStep | {
+    type: string;
+    [key: string]: unknown;
+};
+export interface AgentReplayActStep {
+    type: "act";
+    instruction: string;
+    actions?: Action[];
+    actionDescription?: string;
+    message?: string;
+    timeout?: number;
+}
+export interface AgentReplayFillFormStep {
+    type: "fillForm";
+    fields?: Array<{
+        action: string;
+        value: string;
+    }>;
+    observeResults?: Action[];
+    actions?: Action[];
+}
+export interface AgentReplayGotoStep {
+    type: "goto";
+    url: string;
+    waitUntil?: LoadState;
+}
+export interface AgentReplayScrollStep {
+    type: "scroll";
+    deltaX?: number;
+    deltaY?: number;
+    anchor?: {
+        x: number;
+        y: number;
+    };
+}
+export interface AgentReplayWaitStep {
+    type: "wait";
+    timeMs: number;
+}
+export interface AgentReplayNavBackStep {
+    type: "navback";
+    waitUntil?: LoadState;
+}
+export interface AgentReplayKeysStep {
+    type: "keys";
+    instruction?: string;
+    playwrightArguments: {
+        method: "type" | "press";
+        text?: string;
+        keys?: string;
+        times?: number;
+    };
+}
+export interface SanitizedAgentExecuteOptions {
+    maxSteps?: number;
+    highlightCursor?: boolean;
+}
+export interface CachedAgentEntry {
+    version: 1;
+    instruction: string;
+    startUrl: string;
+    options: SanitizedAgentExecuteOptions;
+    configSignature: string;
+    steps: AgentReplayStep[];
+    result: AgentResult;
+    timestamp: string;
+}

package/dist/cjs/lib/v3/types/private/cache.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cache.js.map

package/dist/cjs/lib/v3/types/private/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/cache.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ActOptions,\n  ActResult,\n  AvailableModel,\n  Logger,\n  AgentResult,\n  Action,\n  LoadState,\n} from \"../public/index.js\";\nimport { CacheStorage } from \"../../cache/CacheStorage.js\";\nimport type { ActHandler } from \"../../handlers/actHandler.js\";\nimport type { V3Context } from \"../../understudy/context.js\";\nimport type { LLMClient } from \"../../llm/LLMClient.js\";\n\nexport type ActFn = (\n  instruction: string,\n  options?: ActOptions,\n) => Promise<ActResult>;\n\nexport type AgentCacheContext = {\n  instruction: string;\n  startUrl: string;\n  options: SanitizedAgentExecuteOptions;\n  configSignature: string;\n  cacheKey: string;\n  variableKeys: string[] /** Variable keys used in this execution (for cache key) */;\n  /** Variable values to substitute during replay */\n  variables?: Record<string, string>;\n};\n\nexport type AgentCacheTransferPayload = {\n  cacheKey: string;\n  entry: CachedAgentEntry;\n};\n\nexport type AgentCacheDeps = {\n  storage: CacheStorage;\n  logger: Logger;\n  getActHandler: () => ActHandler | null;\n  getContext: () => V3Context | null;\n  getDefaultLlmClient: () => LLMClient;\n  getBaseModelName: () => AvailableModel;\n  getSystemPrompt: () => string | undefined;\n  domSettleTimeoutMs?: number;\n  act: ActFn;\n  bufferLatestEntry?: boolean;\n};\n\nexport type ActCacheContext = {\n  instruction: string;\n  cacheKey: string;\n  pageUrl: string;\n  variableKeys: string[];\n  variables?: Record<string, string>;\n};\n\nexport type ActCacheDeps = {\n  storage: CacheStorage;\n  logger: Logger;\n  getActHandler: () => ActHandler | null;\n  getDefaultLlmClient: () => LLMClient;\n  domSettleTimeoutMs?: number;\n};\n\nexport type ReadJsonResult<T> = {\n  value: T | null;\n  path?: string;\n  error?: unknown;\n};\n\nexport type WriteJsonResult = {\n  path?: string;\n  error?: unknown;\n};\n\nexport interface CachedActEntry {\n  version: 1;\n  instruction: string;\n  url: string;\n  variableKeys: string[];\n  actions: Action[];\n  actionDescription?: string;\n  message?: string;\n}\n\nexport type AgentReplayStep =\n  | AgentReplayActStep\n  | AgentReplayFillFormStep\n  | AgentReplayGotoStep\n  | AgentReplayScrollStep\n  | AgentReplayWaitStep\n  | AgentReplayNavBackStep\n  | AgentReplayKeysStep\n  | { type: string; [key: string]: unknown };\n\nexport interface AgentReplayActStep {\n  type: \"act\";\n  instruction: string;\n  actions?: Action[];\n  actionDescription?: string;\n  message?: string;\n  timeout?: number;\n}\n\nexport interface AgentReplayFillFormStep {\n  type: \"fillForm\";\n  fields?: Array<{ action: string; value: string }>;\n  observeResults?: Action[];\n  actions?: Action[];\n}\n\nexport interface AgentReplayGotoStep {\n  type: \"goto\";\n  url: string;\n  waitUntil?: LoadState;\n}\n\nexport interface AgentReplayScrollStep {\n  type: \"scroll\";\n  deltaX?: number;\n  deltaY?: number;\n  anchor?: { x: number; y: number };\n}\n\nexport interface AgentReplayWaitStep {\n  type: \"wait\";\n  timeMs: number;\n}\n\nexport interface AgentReplayNavBackStep {\n  type: \"navback\";\n  waitUntil?: LoadState;\n}\n\nexport interface AgentReplayKeysStep {\n  type: \"keys\";\n  instruction?: string;\n  playwrightArguments: {\n    method: \"type\" | \"press\";\n    text?: string;\n    keys?: string;\n    times?: number;\n  };\n}\n\nexport interface SanitizedAgentExecuteOptions {\n  maxSteps?: number;\n  highlightCursor?: boolean;\n}\n\nexport interface CachedAgentEntry {\n  version: 1;\n  instruction: string;\n  startUrl: string;\n  options: SanitizedAgentExecuteOptions;\n  configSignature: string;\n  steps: AgentReplayStep[];\n  result: AgentResult;\n  timestamp: string;\n}\n"]}

package/dist/cjs/lib/v3/types/private/evaluator.d.ts

@@ -0,0 +1,40 @@
+export type EvaluateOptions = {
+    /** The question to ask about the task state */
+    question: string;
+    /** The answer to the question */
+    answer?: string;
+    /** Whether to take a screenshot of the task state, or array of screenshots to evaluate */
+    screenshot?: boolean | Buffer[];
+    /** Custom system prompt for the evaluator */
+    systemPrompt?: string;
+    /** Delay in milliseconds before taking the screenshot @default 250 */
+    screenshotDelayMs?: number;
+    /** The agent's reasoning/thought process for completing the task */
+    agentReasoning?: string;
+};
+export type BatchAskOptions = {
+    /** Array of questions with optional answers */
+    questions: Array<{
+        question: string;
+        answer?: string;
+    }>;
+    /** Whether to take a screenshot of the task state */
+    screenshot?: boolean;
+    /** Custom system prompt for the evaluator */
+    systemPrompt?: string;
+    /** Delay in milliseconds before taking the screenshot @default 1000 */
+    screenshotDelayMs?: number;
+};
+/**
+ * Result of an evaluation
+ */
+export interface EvaluationResult {
+    /**
+     * The evaluation result ('YES', 'NO', or 'INVALID' if parsing failed or value was unexpected)
+     */
+    evaluation: "YES" | "NO" | "INVALID";
+    /**
+     * The reasoning behind the evaluation
+     */
+    reasoning: string;
+}

package/dist/cjs/lib/v3/types/private/evaluator.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=evaluator.js.map

package/dist/cjs/lib/v3/types/private/evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/evaluator.ts"],"names":[],"mappings":"","sourcesContent":["export type EvaluateOptions = {\n  /** The question to ask about the task state */\n  question: string;\n  /** The answer to the question */\n  answer?: string;\n  /** Whether to take a screenshot of the task state, or array of screenshots to evaluate */\n  screenshot?: boolean | Buffer[];\n  /** Custom system prompt for the evaluator */\n  systemPrompt?: string;\n  /** Delay in milliseconds before taking the screenshot @default 250 */\n  screenshotDelayMs?: number;\n  /** The agent's reasoning/thought process for completing the task */\n  agentReasoning?: string;\n};\n\nexport type BatchAskOptions = {\n  /** Array of questions with optional answers */\n  questions: Array<{\n    question: string;\n    answer?: string;\n  }>;\n  /** Whether to take a screenshot of the task state */\n  screenshot?: boolean;\n  /** Custom system prompt for the evaluator */\n  systemPrompt?: string;\n  /** Delay in milliseconds before taking the screenshot @default 1000 */\n  screenshotDelayMs?: number;\n};\n\n/**\n * Result of an evaluation\n */\nexport interface EvaluationResult {\n  /**\n   * The evaluation result ('YES', 'NO', or 'INVALID' if parsing failed or value was unexpected)\n   */\n  evaluation: \"YES\" | \"NO\" | \"INVALID\";\n  /**\n   * The reasoning behind the evaluation\n   */\n  reasoning: string;\n}\n"]}

package/dist/cjs/lib/v3/types/private/handlers.d.ts

@@ -0,0 +1,39 @@
+import { Page } from "../../understudy/page.js";
+import { ModelConfiguration } from "../public/model.js";
+import type { StagehandZodSchema } from "../../zodCompat.js";
+import type { Variables } from "../public/agent.js";
+export interface ActHandlerParams {
+    instruction: string;
+    model?: ModelConfiguration;
+    variables?: Variables;
+    timeout?: number;
+    page: Page;
+}
+export interface ExtractHandlerParams<T extends StagehandZodSchema> {
+    instruction?: string;
+    schema?: T;
+    model?: ModelConfiguration;
+    timeout?: number;
+    selector?: string;
+    page: Page;
+}
+export interface ObserveHandlerParams {
+    instruction?: string;
+    model?: ModelConfiguration;
+    timeout?: number;
+    selector?: string;
+    page: Page;
+}
+export declare enum SupportedUnderstudyAction {
+    CLICK = "click",
+    FILL = "fill",
+    TYPE = "type",
+    PRESS = "press",
+    SCROLL = "scrollTo",
+    NEXT_CHUNK = "nextChunk",
+    PREV_CHUNK = "prevChunk",
+    SELECT_OPTION_FROM_DROPDOWN = "selectOptionFromDropdown",
+    HOVER = "hover",
+    DOUBLE_CLICK = "doubleClick",
+    DRAG_AND_DROP = "dragAndDrop"
+}

package/dist/cjs/lib/v3/types/private/handlers.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupportedUnderstudyAction = void 0;
+// We can use this enum to list the actions supported in performUnderstudyMethod
+var SupportedUnderstudyAction;
+(function (SupportedUnderstudyAction) {
+    SupportedUnderstudyAction["CLICK"] = "click";
+    SupportedUnderstudyAction["FILL"] = "fill";
+    SupportedUnderstudyAction["TYPE"] = "type";
+    SupportedUnderstudyAction["PRESS"] = "press";
+    SupportedUnderstudyAction["SCROLL"] = "scrollTo";
+    SupportedUnderstudyAction["NEXT_CHUNK"] = "nextChunk";
+    SupportedUnderstudyAction["PREV_CHUNK"] = "prevChunk";
+    SupportedUnderstudyAction["SELECT_OPTION_FROM_DROPDOWN"] = "selectOptionFromDropdown";
+    SupportedUnderstudyAction["HOVER"] = "hover";
+    SupportedUnderstudyAction["DOUBLE_CLICK"] = "doubleClick";
+    SupportedUnderstudyAction["DRAG_AND_DROP"] = "dragAndDrop";
+})(SupportedUnderstudyAction || (exports.SupportedUnderstudyAction = SupportedUnderstudyAction = {}));
+//# sourceMappingURL=handlers.js.map

package/dist/cjs/lib/v3/types/private/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/handlers.ts"],"names":[],"mappings":";;;AA8BA,gFAAgF;AAChF,IAAY,yBAYX;AAZD,WAAY,yBAAyB;IACnC,4CAAe,CAAA;IACf,0CAAa,CAAA;IACb,0CAAa,CAAA;IACb,4CAAe,CAAA;IACf,gDAAmB,CAAA;IACnB,qDAAwB,CAAA;IACxB,qDAAwB,CAAA;IACxB,qFAAwD,CAAA;IACxD,4CAAe,CAAA;IACf,yDAA4B,CAAA;IAC5B,0DAA6B,CAAA;AAC/B,CAAC,EAZW,yBAAyB,yCAAzB,yBAAyB,QAYpC","sourcesContent":["import { Page } from \"../../understudy/page.js\";\nimport { ModelConfiguration } from \"../public/model.js\";\nimport type { StagehandZodSchema } from \"../../zodCompat.js\";\nimport type { Variables } from \"../public/agent.js\";\n\nexport interface ActHandlerParams {\n  instruction: string;\n  model?: ModelConfiguration;\n  variables?: Variables;\n  timeout?: number;\n  page: Page;\n}\n\nexport interface ExtractHandlerParams<T extends StagehandZodSchema> {\n  instruction?: string;\n  schema?: T;\n  model?: ModelConfiguration;\n  timeout?: number;\n  selector?: string;\n  page: Page;\n}\n\nexport interface ObserveHandlerParams {\n  instruction?: string;\n  model?: ModelConfiguration;\n  timeout?: number;\n  selector?: string;\n  page: Page;\n}\n\n// We can use this enum to list the actions supported in performUnderstudyMethod\nexport enum SupportedUnderstudyAction {\n  CLICK = \"click\",\n  FILL = \"fill\",\n  TYPE = \"type\",\n  PRESS = \"press\",\n  SCROLL = \"scrollTo\",\n  NEXT_CHUNK = \"nextChunk\",\n  PREV_CHUNK = \"prevChunk\",\n  SELECT_OPTION_FROM_DROPDOWN = \"selectOptionFromDropdown\",\n  HOVER = \"hover\",\n  DOUBLE_CLICK = \"doubleClick\",\n  DRAG_AND_DROP = \"dragAndDrop\",\n}\n"]}

package/dist/cjs/lib/v3/types/private/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./api.js";
+export * from "./handlers.js";
+export * from "./internal.js";
+export * from "./evaluator.js";
+export * from "./cache.js";
+export * from "./agent.js";
+export * from "./snapshot.js";

package/dist/cjs/lib/v3/types/private/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./api.js"), exports);
+__exportStar(require("./handlers.js"), exports);
+__exportStar(require("./internal.js"), exports);
+__exportStar(require("./evaluator.js"), exports);
+__exportStar(require("./cache.js"), exports);
+__exportStar(require("./agent.js"), exports);
+__exportStar(require("./snapshot.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/lib/v3/types/private/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,gDAA8B;AAC9B,gDAA8B;AAC9B,iDAA+B;AAC/B,6CAA2B;AAC3B,6CAA2B;AAC3B,gDAA8B","sourcesContent":["export * from \"./api.js\";\nexport * from \"./handlers.js\";\nexport * from \"./internal.js\";\nexport * from \"./evaluator.js\";\nexport * from \"./cache.js\";\nexport * from \"./agent.js\";\nexport * from \"./snapshot.js\";\n"]}

package/dist/cjs/lib/v3/types/private/internal.d.ts

@@ -0,0 +1,39 @@
+import Browserbase from "@browserbasehq/sdk";
+import { LaunchedChrome } from "chrome-launcher";
+export type InitState = {
+    kind: "UNINITIALIZED";
+} | {
+    kind: "LOCAL";
+    chrome: LaunchedChrome;
+    ws: string;
+    userDataDir?: string;
+    createdTempProfile?: boolean;
+    preserveUserDataDir?: boolean;
+} | {
+    kind: "BROWSERBASE";
+    bb: Browserbase;
+    sessionId: string;
+    ws: string;
+};
+export type EncodedId = `${number}-${number}`;
+/**
+ * Represents a path through a Zod schema from the root object down to a
+ * particular field. The `segments` array describes the chain of keys/indices.
+ *
+ * - **String** segments indicate object property names.
+ * - **Number** segments indicate array indices.
+ *
+ * For example, `["users", 0, "homepage"]` might describe reaching
+ * the `homepage` field in `schema.users[0].homepage`.
+ */
+export interface ZodPathSegments {
+    /**
+     * The ordered list of keys/indices leading from the schema root
+     * to the targeted field.
+     */
+    segments: Array<string | number>;
+}
+export type InitScriptSource<Arg> = string | {
+    path?: string;
+    content?: string;
+} | ((arg: Arg) => unknown);

package/dist/cjs/lib/v3/types/private/internal.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=internal.js.map

package/dist/cjs/lib/v3/types/private/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/internal.ts"],"names":[],"mappings":"","sourcesContent":["import Browserbase from \"@browserbasehq/sdk\";\nimport { LaunchedChrome } from \"chrome-launcher\";\n\nexport type InitState =\n  | { kind: \"UNINITIALIZED\" }\n  | {\n      kind: \"LOCAL\";\n      chrome: LaunchedChrome;\n      ws: string;\n      userDataDir?: string;\n      createdTempProfile?: boolean;\n      preserveUserDataDir?: boolean;\n    }\n  | { kind: \"BROWSERBASE\"; bb: Browserbase; sessionId: string; ws: string };\n\nexport type EncodedId = `${number}-${number}`;\n\n/**\n * Represents a path through a Zod schema from the root object down to a\n * particular field. The `segments` array describes the chain of keys/indices.\n *\n * - **String** segments indicate object property names.\n * - **Number** segments indicate array indices.\n *\n * For example, `[\"users\", 0, \"homepage\"]` might describe reaching\n * the `homepage` field in `schema.users[0].homepage`.\n */\nexport interface ZodPathSegments {\n  /**\n   * The ordered list of keys/indices leading from the schema root\n   * to the targeted field.\n   */\n  segments: Array<string | number>;\n}\n\nexport type InitScriptSource<Arg> =\n  | string\n  | { path?: string; content?: string }\n  | ((arg: Arg) => unknown);\n"]}

package/dist/cjs/lib/v3/types/private/locator.d.ts

@@ -0,0 +1,9 @@
+import { Buffer } from "buffer";
+export interface NormalizedFilePayload {
+    name: string;
+    mimeType: string;
+    buffer: Buffer;
+    lastModified: number;
+    /** Absolute path to the source file when provided by the caller. */
+    absolutePath?: string;
+}

package/dist/cjs/lib/v3/types/private/locator.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=locator.js.map

package/dist/cjs/lib/v3/types/private/locator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/locator.ts"],"names":[],"mappings":"","sourcesContent":["import { Buffer } from \"buffer\";\n\nexport interface NormalizedFilePayload {\n  name: string;\n  mimeType: string;\n  buffer: Buffer;\n  lastModified: number;\n  /** Absolute path to the source file when provided by the caller. */\n  absolutePath?: string;\n}\n"]}

package/dist/cjs/lib/v3/types/private/network.d.ts

@@ -0,0 +1,34 @@
+import { Protocol } from "devtools-protocol";
+/** Metadata tracked for each network request currently in-flight. */
+export type NetworkRequestInfo = {
+    sessionId: string;
+    requestId: string;
+    requestKey: string;
+    frameId?: string;
+    loaderId?: string;
+    url?: string;
+    timestamp: number;
+    resourceType?: Protocol.Network.ResourceType;
+    documentRequest: boolean;
+};
+/** Callback hooks consumers can implement to observe network transitions. */
+export interface NetworkObserver {
+    onRequestStarted(info: NetworkRequestInfo): void;
+    onRequestFinished(info: NetworkRequestInfo): void;
+    onRequestFailed(info: NetworkRequestInfo): void;
+}
+/** Options for the idle waiter helper. */
+export type WaitForIdleOptions = {
+    startTime?: number;
+    timeoutMs: number;
+    idleTimeMs?: number;
+    filter?: (info: NetworkRequestInfo) => boolean;
+    totalBudgetMs?: number;
+};
+export declare const DEFAULT_IDLE_WAIT = 500;
+export declare const IGNORED_RESOURCE_TYPES: Set<Protocol.Network.ResourceType>;
+/** The handle returned by the network manager idle helper. */
+export type WaitForIdleHandle = {
+    promise: Promise<void>;
+    dispose: () => void;
+};

package/dist/cjs/lib/v3/types/private/network.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IGNORED_RESOURCE_TYPES = exports.DEFAULT_IDLE_WAIT = void 0;
+exports.DEFAULT_IDLE_WAIT = 500;
+exports.IGNORED_RESOURCE_TYPES = new Set(["EventSource", "WebSocket"]);
+//# sourceMappingURL=network.js.map

package/dist/cjs/lib/v3/types/private/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/network.ts"],"names":[],"mappings":";;;AA+Ba,QAAA,iBAAiB,GAAG,GAAG,CAAC;AACxB,QAAA,sBAAsB,GAAG,IAAI,GAAG,CAE3C,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC","sourcesContent":["import { Protocol } from \"devtools-protocol\";\n\n/** Metadata tracked for each network request currently in-flight. */\nexport type NetworkRequestInfo = {\n  sessionId: string;\n  requestId: string;\n  requestKey: string;\n  frameId?: string;\n  loaderId?: string;\n  url?: string;\n  timestamp: number;\n  resourceType?: Protocol.Network.ResourceType;\n  documentRequest: boolean;\n};\n\n/** Callback hooks consumers can implement to observe network transitions. */\nexport interface NetworkObserver {\n  onRequestStarted(info: NetworkRequestInfo): void;\n  onRequestFinished(info: NetworkRequestInfo): void;\n  onRequestFailed(info: NetworkRequestInfo): void;\n}\n\n/** Options for the idle waiter helper. */\nexport type WaitForIdleOptions = {\n  startTime?: number;\n  timeoutMs: number;\n  idleTimeMs?: number;\n  filter?: (info: NetworkRequestInfo) => boolean;\n  totalBudgetMs?: number;\n};\n\nexport const DEFAULT_IDLE_WAIT = 500;\nexport const IGNORED_RESOURCE_TYPES = new Set<\n  Protocol.Network.ResourceType | undefined\n>([\"EventSource\", \"WebSocket\"]);\n\n/** The handle returned by the network manager idle helper. */\nexport type WaitForIdleHandle = {\n  promise: Promise<void>;\n  dispose: () => void;\n};\n"]}

package/dist/cjs/lib/v3/types/private/shutdown.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Internal-only types for the shutdown supervisor process.
+ */
+export type ShutdownSupervisorConfig = {
+    kind: "LOCAL";
+    pid: number;
+    userDataDir?: string;
+    createdTempProfile?: boolean;
+    preserveUserDataDir?: boolean;
+} | {
+    kind: "STAGEHAND_API";
+    sessionId: string;
+    apiKey: string;
+    projectId?: string;
+};
+export interface ShutdownSupervisorHandle {
+    /** Best-effort signal to stop the supervisor process. */
+    stop: () => void;
+}

package/dist/cjs/lib/v3/types/private/shutdown.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Internal-only types for the shutdown supervisor process.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=shutdown.js.map

package/dist/cjs/lib/v3/types/private/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/shutdown.ts"],"names":[],"mappings":";AAAA;;GAEG","sourcesContent":["/**\n * Internal-only types for the shutdown supervisor process.\n */\n\nexport type ShutdownSupervisorConfig =\n  | {\n      kind: \"LOCAL\";\n      pid: number;\n      userDataDir?: string;\n      createdTempProfile?: boolean;\n      preserveUserDataDir?: boolean;\n    }\n  | {\n      kind: \"STAGEHAND_API\";\n      sessionId: string;\n      apiKey: string;\n      projectId?: string;\n    };\n\nexport interface ShutdownSupervisorHandle {\n  /** Best-effort signal to stop the supervisor process. */\n  stop: () => void;\n}\n"]}

package/dist/cjs/lib/v3/types/private/shutdownErrors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Internal-only errors for the shutdown supervisor.
+ */
+export declare class ShutdownSupervisorError extends Error {
+    constructor(message: string);
+}
+export declare class ShutdownSupervisorResolveError extends ShutdownSupervisorError {
+    constructor(message: string);
+}
+export declare class ShutdownSupervisorSpawnError extends ShutdownSupervisorError {
+    constructor(message: string);
+}

package/dist/cjs/lib/v3/types/private/shutdownErrors.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Internal-only errors for the shutdown supervisor.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShutdownSupervisorSpawnError = exports.ShutdownSupervisorResolveError = exports.ShutdownSupervisorError = void 0;
+class ShutdownSupervisorError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ShutdownSupervisorError";
+    }
+}
+exports.ShutdownSupervisorError = ShutdownSupervisorError;
+class ShutdownSupervisorResolveError extends ShutdownSupervisorError {
+    constructor(message) {
+        super(message);
+        this.name = "ShutdownSupervisorResolveError";
+    }
+}
+exports.ShutdownSupervisorResolveError = ShutdownSupervisorResolveError;
+class ShutdownSupervisorSpawnError extends ShutdownSupervisorError {
+    constructor(message) {
+        super(message);
+        this.name = "ShutdownSupervisorSpawnError";
+    }
+}
+exports.ShutdownSupervisorSpawnError = ShutdownSupervisorSpawnError;
+//# sourceMappingURL=shutdownErrors.js.map

package/dist/cjs/lib/v3/types/private/shutdownErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdownErrors.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/private/shutdownErrors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,MAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AALD,0DAKC;AAED,MAAa,8BAA+B,SAAQ,uBAAuB;IACzE,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AALD,wEAKC;AAED,MAAa,4BAA6B,SAAQ,uBAAuB;IACvE,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AALD,oEAKC","sourcesContent":["/**\n * Internal-only errors for the shutdown supervisor.\n */\n\nexport class ShutdownSupervisorError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ShutdownSupervisorError\";\n  }\n}\n\nexport class ShutdownSupervisorResolveError extends ShutdownSupervisorError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ShutdownSupervisorResolveError\";\n  }\n}\n\nexport class ShutdownSupervisorSpawnError extends ShutdownSupervisorError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ShutdownSupervisorSpawnError\";\n  }\n}\n"]}