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

package/dist/cjs/tests/unit/public-api/public-error-types.test.js

@@ -0,0 +1,110 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publicErrorTypes = void 0;
+const vitest_1 = require("vitest");
+const Stagehand = __importStar(require("@browserbasehq/stagehand"));
+exports.publicErrorTypes = {
+    AgentAbortError: Stagehand.AgentAbortError,
+    CdpConnectionClosedError: Stagehand.CdpConnectionClosedError,
+    AgentScreenshotProviderError: Stagehand.AgentScreenshotProviderError,
+    BrowserbaseSessionNotFoundError: Stagehand.BrowserbaseSessionNotFoundError,
+    CaptchaTimeoutError: Stagehand.CaptchaTimeoutError,
+    ConnectionTimeoutError: Stagehand.ConnectionTimeoutError,
+    ContentFrameNotFoundError: Stagehand.ContentFrameNotFoundError,
+    CookieSetError: Stagehand.CookieSetError,
+    CookieValidationError: Stagehand.CookieValidationError,
+    CreateChatCompletionResponseError: Stagehand.CreateChatCompletionResponseError,
+    CuaModelRequiredError: Stagehand.CuaModelRequiredError,
+    ElementNotVisibleError: Stagehand.ElementNotVisibleError,
+    ExperimentalApiConflictError: Stagehand.ExperimentalApiConflictError,
+    ExperimentalNotConfiguredError: Stagehand.ExperimentalNotConfiguredError,
+    HandlerNotInitializedError: Stagehand.HandlerNotInitializedError,
+    InvalidAISDKModelFormatError: Stagehand.InvalidAISDKModelFormatError,
+    LLMResponseError: Stagehand.LLMResponseError,
+    MCPConnectionError: Stagehand.MCPConnectionError,
+    MissingEnvironmentVariableError: Stagehand.MissingEnvironmentVariableError,
+    MissingLLMConfigurationError: Stagehand.MissingLLMConfigurationError,
+    PageNotFoundError: Stagehand.PageNotFoundError,
+    ResponseBodyError: Stagehand.ResponseBodyError,
+    ResponseParseError: Stagehand.ResponseParseError,
+    StagehandAPIError: Stagehand.StagehandAPIError,
+    StagehandAPIUnauthorizedError: Stagehand.StagehandAPIUnauthorizedError,
+    StagehandClickError: Stagehand.StagehandClickError,
+    StagehandClosedError: Stagehand.StagehandClosedError,
+    StagehandDefaultError: Stagehand.StagehandDefaultError,
+    StagehandDomProcessError: Stagehand.StagehandDomProcessError,
+    StagehandElementNotFoundError: Stagehand.StagehandElementNotFoundError,
+    StagehandEnvironmentError: Stagehand.StagehandEnvironmentError,
+    StagehandError: Stagehand.StagehandError,
+    StagehandEvalError: Stagehand.StagehandEvalError,
+    StagehandHttpError: Stagehand.StagehandHttpError,
+    StagehandIframeError: Stagehand.StagehandIframeError,
+    StagehandInitError: Stagehand.StagehandInitError,
+    StagehandInvalidArgumentError: Stagehand.StagehandInvalidArgumentError,
+    StagehandLocatorError: Stagehand.StagehandLocatorError,
+    StagehandMissingArgumentError: Stagehand.StagehandMissingArgumentError,
+    StagehandNotInitializedError: Stagehand.StagehandNotInitializedError,
+    StagehandResponseBodyError: Stagehand.StagehandResponseBodyError,
+    StagehandResponseParseError: Stagehand.StagehandResponseParseError,
+    StagehandServerError: Stagehand.StagehandServerError,
+    StagehandShadowRootMissingError: Stagehand.StagehandShadowRootMissingError,
+    StagehandShadowSegmentEmptyError: Stagehand.StagehandShadowSegmentEmptyError,
+    StagehandShadowSegmentNotFoundError: Stagehand.StagehandShadowSegmentNotFoundError,
+    StreamingCallbacksInNonStreamingModeError: Stagehand.StreamingCallbacksInNonStreamingModeError,
+    StagehandSnapshotError: Stagehand.StagehandSnapshotError,
+    TimeoutError: Stagehand.TimeoutError,
+    UnsupportedAISDKModelProviderError: Stagehand.UnsupportedAISDKModelProviderError,
+    UnsupportedModelError: Stagehand.UnsupportedModelError,
+    UnsupportedModelProviderError: Stagehand.UnsupportedModelProviderError,
+    XPathResolutionError: Stagehand.XPathResolutionError,
+    ZodSchemaValidationError: Stagehand.ZodSchemaValidationError,
+    ActTimeoutError: Stagehand.ActTimeoutError,
+    ObserveTimeoutError: Stagehand.ObserveTimeoutError,
+    ExtractTimeoutError: Stagehand.ExtractTimeoutError,
+    UnderstudyCommandException: Stagehand.UnderstudyCommandException,
+    StagehandSetExtraHTTPHeadersError: Stagehand.StagehandSetExtraHTTPHeadersError,
+};
+const errorTypes = Object.keys(exports.publicErrorTypes);
+(0, vitest_1.describe)("Stagehand public error types", () => {
+    (0, vitest_1.describe)("errors", () => {
+        vitest_1.it.each(errorTypes)("%s extends Error", (errorTypeName) => {
+            const ErrorClass = Stagehand[errorTypeName];
+            (0, vitest_1.expectTypeOf)().toExtend();
+            void ErrorClass; // Mark as used to satisfy ESLint
+        });
+    });
+});
+//# sourceMappingURL=public-error-types.test.js.map

package/dist/cjs/tests/unit/public-api/public-error-types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-error-types.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/public-error-types.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expectTypeOf, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\nexport const publicErrorTypes = {\n  AgentAbortError: Stagehand.AgentAbortError,\n  CdpConnectionClosedError: Stagehand.CdpConnectionClosedError,\n  AgentScreenshotProviderError: Stagehand.AgentScreenshotProviderError,\n  BrowserbaseSessionNotFoundError: Stagehand.BrowserbaseSessionNotFoundError,\n  CaptchaTimeoutError: Stagehand.CaptchaTimeoutError,\n  ConnectionTimeoutError: Stagehand.ConnectionTimeoutError,\n  ContentFrameNotFoundError: Stagehand.ContentFrameNotFoundError,\n  CookieSetError: Stagehand.CookieSetError,\n  CookieValidationError: Stagehand.CookieValidationError,\n  CreateChatCompletionResponseError:\n    Stagehand.CreateChatCompletionResponseError,\n  CuaModelRequiredError: Stagehand.CuaModelRequiredError,\n  ElementNotVisibleError: Stagehand.ElementNotVisibleError,\n  ExperimentalApiConflictError: Stagehand.ExperimentalApiConflictError,\n  ExperimentalNotConfiguredError: Stagehand.ExperimentalNotConfiguredError,\n  HandlerNotInitializedError: Stagehand.HandlerNotInitializedError,\n  InvalidAISDKModelFormatError: Stagehand.InvalidAISDKModelFormatError,\n  LLMResponseError: Stagehand.LLMResponseError,\n  MCPConnectionError: Stagehand.MCPConnectionError,\n  MissingEnvironmentVariableError: Stagehand.MissingEnvironmentVariableError,\n  MissingLLMConfigurationError: Stagehand.MissingLLMConfigurationError,\n  PageNotFoundError: Stagehand.PageNotFoundError,\n  ResponseBodyError: Stagehand.ResponseBodyError,\n  ResponseParseError: Stagehand.ResponseParseError,\n  StagehandAPIError: Stagehand.StagehandAPIError,\n  StagehandAPIUnauthorizedError: Stagehand.StagehandAPIUnauthorizedError,\n  StagehandClickError: Stagehand.StagehandClickError,\n  StagehandClosedError: Stagehand.StagehandClosedError,\n  StagehandDefaultError: Stagehand.StagehandDefaultError,\n  StagehandDomProcessError: Stagehand.StagehandDomProcessError,\n  StagehandElementNotFoundError: Stagehand.StagehandElementNotFoundError,\n  StagehandEnvironmentError: Stagehand.StagehandEnvironmentError,\n  StagehandError: Stagehand.StagehandError,\n  StagehandEvalError: Stagehand.StagehandEvalError,\n  StagehandHttpError: Stagehand.StagehandHttpError,\n  StagehandIframeError: Stagehand.StagehandIframeError,\n  StagehandInitError: Stagehand.StagehandInitError,\n  StagehandInvalidArgumentError: Stagehand.StagehandInvalidArgumentError,\n  StagehandLocatorError: Stagehand.StagehandLocatorError,\n  StagehandMissingArgumentError: Stagehand.StagehandMissingArgumentError,\n  StagehandNotInitializedError: Stagehand.StagehandNotInitializedError,\n  StagehandResponseBodyError: Stagehand.StagehandResponseBodyError,\n  StagehandResponseParseError: Stagehand.StagehandResponseParseError,\n  StagehandServerError: Stagehand.StagehandServerError,\n  StagehandShadowRootMissingError: Stagehand.StagehandShadowRootMissingError,\n  StagehandShadowSegmentEmptyError: Stagehand.StagehandShadowSegmentEmptyError,\n  StagehandShadowSegmentNotFoundError:\n    Stagehand.StagehandShadowSegmentNotFoundError,\n  StreamingCallbacksInNonStreamingModeError:\n    Stagehand.StreamingCallbacksInNonStreamingModeError,\n  StagehandSnapshotError: Stagehand.StagehandSnapshotError,\n  TimeoutError: Stagehand.TimeoutError,\n  UnsupportedAISDKModelProviderError:\n    Stagehand.UnsupportedAISDKModelProviderError,\n  UnsupportedModelError: Stagehand.UnsupportedModelError,\n  UnsupportedModelProviderError: Stagehand.UnsupportedModelProviderError,\n  XPathResolutionError: Stagehand.XPathResolutionError,\n  ZodSchemaValidationError: Stagehand.ZodSchemaValidationError,\n  ActTimeoutError: Stagehand.ActTimeoutError,\n  ObserveTimeoutError: Stagehand.ObserveTimeoutError,\n  ExtractTimeoutError: Stagehand.ExtractTimeoutError,\n  UnderstudyCommandException: Stagehand.UnderstudyCommandException,\n  StagehandSetExtraHTTPHeadersError:\n    Stagehand.StagehandSetExtraHTTPHeadersError,\n} as const;\n\nconst errorTypes = Object.keys(publicErrorTypes) as Array<\n  keyof typeof publicErrorTypes\n>;\n\ndescribe(\"Stagehand public error types\", () => {\n  describe(\"errors\", () => {\n    it.each(errorTypes)(\"%s extends Error\", (errorTypeName) => {\n      const ErrorClass = Stagehand[errorTypeName];\n      type ErrorClassType = typeof ErrorClass;\n      expectTypeOf<InstanceType<ErrorClassType>>().toExtend<Error>();\n      void ErrorClass; // Mark as used to satisfy ESLint\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/public-api/public-types.test.d.ts

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

package/dist/cjs/tests/unit/public-api/public-types.test.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+(0, vitest_1.describe)("Stagehand public API types", () => {
+    (0, vitest_1.describe)("AnyPage", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("ActOptions", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("ActResult", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("ExtractOptions", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("ObserveOptions", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("ObserveResult", () => {
+        (0, vitest_1.it)("is an Action array with optional cacheStatus", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("Action", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("AgentAction", () => {
+        // AgentAction is a separate type from Action, not an extension
+        // It has additional fields like type, reasoning, taskCompleted, etc.
+        (0, vitest_1.it)("has type field", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("AgentExecuteOptions", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("AgentStreamExecuteOptions", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("AgentExecutionOptions", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("AgentResult", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("AgentConfig", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+    });
+    (0, vitest_1.describe)("AgentToolMode", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("HistoryEntry", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("Cookie", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("CookieParam", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("ClearCookieOptions", () => {
+        (0, vitest_1.it)("matches expected type shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+});
+//# sourceMappingURL=public-types.test.js.map

package/dist/cjs/tests/unit/public-api/public-types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-types.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/public-types.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expectTypeOf, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\n// Type-level manifest of all expected exported types\n// Since these types don't exist at runtime, we currently need to manually add new publicly exported types\n// to this list ourselves - it's not automatically going to catch changes like our export-surface.test.ts does.\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\ntype ExpectedExportedTypes = {\n  // Types from model.ts\n  AvailableModel: Stagehand.AvailableModel;\n  AvailableCuaModel: Stagehand.AvailableCuaModel;\n  ModelProvider: Stagehand.ModelProvider;\n  ClientOptions: Stagehand.ClientOptions;\n  ModelConfiguration: Stagehand.ModelConfiguration;\n  AnthropicJsonSchemaObject: Stagehand.AnthropicJsonSchemaObject;\n  AISDKProvider: Stagehand.AISDKProvider;\n  AISDKCustomProvider: Stagehand.AISDKCustomProvider;\n  LLMTool: Stagehand.LLMTool;\n  // Types from methods.ts\n  ActOptions: Stagehand.ActOptions;\n  ActResult: Stagehand.ActResult;\n  ExtractResult: Stagehand.ExtractResult<Stagehand.StagehandZodSchema>;\n  Action: Stagehand.Action;\n  HistoryEntry: Stagehand.HistoryEntry;\n  ExtractOptions: Stagehand.ExtractOptions;\n  ObserveOptions: Stagehand.ObserveOptions;\n  ObserveResult: Stagehand.ObserveResult;\n  V3FunctionName: Stagehand.V3FunctionName;\n  // Types from agent.ts\n  Tool: Stagehand.Tool;\n  AgentAction: Stagehand.AgentAction;\n  AgentResult: Stagehand.AgentResult;\n  AgentExecuteOptions: Stagehand.AgentExecuteOptions;\n  AgentType: Stagehand.AgentType;\n  AgentExecutionOptions: Stagehand.AgentExecutionOptions<Stagehand.AgentExecuteOptions>;\n  AgentHandlerOptions: Stagehand.AgentHandlerOptions;\n  ActionExecutionResult: Stagehand.ActionExecutionResult;\n  ToolUseItem: Stagehand.ToolUseItem;\n  AnthropicMessage: Stagehand.AnthropicMessage;\n  AnthropicContentBlock: Stagehand.AnthropicContentBlock;\n  AnthropicTextBlock: Stagehand.AnthropicTextBlock;\n  AnthropicToolResult: Stagehand.AnthropicToolResult;\n  ResponseItem: Stagehand.ResponseItem;\n  ComputerCallItem: Stagehand.ComputerCallItem;\n  FunctionCallItem: Stagehand.FunctionCallItem;\n  ResponseInputItem: Stagehand.ResponseInputItem;\n  AgentInstance: Stagehand.AgentInstance;\n  AgentProviderType: Stagehand.AgentProviderType;\n  AgentModelConfig: Stagehand.AgentModelConfig;\n  AgentConfig: Stagehand.AgentConfig;\n  AgentToolMode: Stagehand.AgentToolMode;\n  VariableValue: Stagehand.VariableValue;\n  Variables: Stagehand.Variables;\n  AgentCallbacks: Stagehand.AgentCallbacks;\n  AgentExecuteCallbacks: Stagehand.AgentExecuteCallbacks;\n  AgentStreamCallbacks: Stagehand.AgentStreamCallbacks;\n  AgentExecuteOptionsBase: Stagehand.AgentExecuteOptionsBase;\n  AgentStreamExecuteOptions: Stagehand.AgentStreamExecuteOptions;\n  ModelMessage: Stagehand.ModelMessage;\n  // Types from agent/tools\n  AgentTools: Stagehand.AgentTools;\n  AgentToolTypesMap: Stagehand.AgentToolTypesMap;\n  AgentUITools: Stagehand.AgentUITools;\n  AgentToolCall: Stagehand.AgentToolCall;\n  AgentToolResult: Stagehand.AgentToolResult;\n  // Types from logs.ts\n  LogLevel: Stagehand.LogLevel;\n  LogLine: Stagehand.LogLine;\n  Logger: Stagehand.Logger;\n  // Types from metrics.ts\n  StagehandMetrics: Stagehand.StagehandMetrics;\n  // Types from options.ts\n  V3Env: Stagehand.V3Env;\n  LocalBrowserLaunchOptions: Stagehand.LocalBrowserLaunchOptions;\n  V3Options: Stagehand.V3Options;\n  // Types from page.ts\n  AnyPage: Stagehand.AnyPage;\n  Page: Stagehand.Page;\n  PlaywrightPage: Stagehand.PlaywrightPage;\n  PatchrightPage: Stagehand.PatchrightPage;\n  PuppeteerPage: Stagehand.PuppeteerPage;\n  ConsoleListener: Stagehand.ConsoleListener;\n  LoadState: Stagehand.LoadState;\n  // Types from LLMClient.ts\n  ChatMessage: Stagehand.ChatMessage;\n  ChatMessageContent: Stagehand.ChatMessageContent;\n  ChatMessageImageContent: Stagehand.ChatMessageImageContent;\n  ChatMessageTextContent: Stagehand.ChatMessageTextContent;\n  ChatCompletionOptions: Stagehand.ChatCompletionOptions;\n  LLMResponse: Stagehand.LLMResponse;\n  CreateChatCompletionOptions: Stagehand.CreateChatCompletionOptions;\n  LLMUsage: Stagehand.LLMUsage;\n  LLMParsedResponse: Stagehand.LLMParsedResponse<Record<string, unknown>>;\n  // Types from zodCompat.ts\n  StagehandZodSchema: Stagehand.StagehandZodSchema;\n  StagehandZodObject: Stagehand.StagehandZodObject;\n  InferStagehandSchema: Stagehand.InferStagehandSchema<Stagehand.StagehandZodSchema>;\n  JsonSchemaDocument: Stagehand.JsonSchemaDocument;\n  // Types from utils.ts\n  JsonSchema: Stagehand.JsonSchema;\n  JsonSchemaProperty: Stagehand.JsonSchemaProperty;\n  // Types from cookies.ts\n  Cookie: Stagehand.Cookie;\n  CookieParam: Stagehand.CookieParam;\n  ClearCookieOptions: Stagehand.ClearCookieOptions;\n};\n\ndescribe(\"Stagehand public API types\", () => {\n  describe(\"AnyPage\", () => {\n    type ExpectedAnyPage =\n      | Stagehand.PlaywrightPage\n      | Stagehand.PuppeteerPage\n      | Stagehand.PatchrightPage\n      | Stagehand.Page;\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.AnyPage>().toEqualTypeOf<ExpectedAnyPage>();\n    });\n  });\n\n  describe(\"ActOptions\", () => {\n    type ExpectedActOptions = {\n      model?: Stagehand.ModelConfiguration;\n      variables?: Stagehand.Variables;\n      timeout?: number;\n      page?: Stagehand.AnyPage;\n      serverCache?: boolean;\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.ActOptions>().toEqualTypeOf<ExpectedActOptions>();\n    });\n  });\n\n  describe(\"ActResult\", () => {\n    type ExpectedActResult = {\n      success: boolean;\n      message: string;\n      actionDescription: string;\n      actions: Stagehand.Action[];\n      cacheStatus?: \"HIT\" | \"MISS\";\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.ActResult>().toEqualTypeOf<ExpectedActResult>();\n    });\n  });\n\n  describe(\"ExtractOptions\", () => {\n    type ExpectedExtractOptions = {\n      model?: Stagehand.ModelConfiguration;\n      timeout?: number;\n      selector?: string;\n      page?: Stagehand.AnyPage;\n      serverCache?: boolean;\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.ExtractOptions>().toEqualTypeOf<ExpectedExtractOptions>();\n    });\n  });\n\n  describe(\"ObserveOptions\", () => {\n    type ExpectedObserveOptions = {\n      model?: Stagehand.ModelConfiguration;\n      timeout?: number;\n      selector?: string;\n      page?: Stagehand.AnyPage;\n      serverCache?: boolean;\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.ObserveOptions>().toEqualTypeOf<ExpectedObserveOptions>();\n    });\n  });\n\n  describe(\"ObserveResult\", () => {\n    it(\"is an Action array with optional cacheStatus\", () => {\n      expectTypeOf<Stagehand.ObserveResult>().toExtend<Stagehand.Action[]>();\n      expectTypeOf<Stagehand.ObserveResult[\"cacheStatus\"]>().toEqualTypeOf<\n        \"HIT\" | \"MISS\" | undefined\n      >();\n    });\n  });\n\n  describe(\"Action\", () => {\n    type ExpectedAction = {\n      selector: string;\n      description: string;\n      method?: string;\n      arguments?: string[];\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.Action>().toEqualTypeOf<ExpectedAction>();\n    });\n  });\n\n  describe(\"AgentAction\", () => {\n    // AgentAction is a separate type from Action, not an extension\n    // It has additional fields like type, reasoning, taskCompleted, etc.\n    it(\"has type field\", () => {\n      type TestAction = { type: string } & Stagehand.AgentAction;\n      expectTypeOf<TestAction[\"type\"]>().toEqualTypeOf<string>();\n    });\n  });\n\n  describe(\"AgentExecuteOptions\", () => {\n    type ExpectedAgentExecuteOptions = {\n      instruction: string;\n      maxSteps?: number;\n      page?: Stagehand.AnyPage;\n      highlightCursor?: boolean;\n      messages?: Stagehand.ModelMessage[];\n      signal?: AbortSignal;\n      excludeTools?: string[];\n      output?: Stagehand.StagehandZodObject;\n      callbacks?: Stagehand.AgentExecuteCallbacks;\n      variables?: Stagehand.Variables;\n      toolTimeout?: number;\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.AgentExecuteOptions>().toEqualTypeOf<ExpectedAgentExecuteOptions>();\n    });\n  });\n\n  describe(\"AgentStreamExecuteOptions\", () => {\n    type ExpectedAgentStreamExecuteOptions = {\n      instruction: string;\n      maxSteps?: number;\n      page?: Stagehand.AnyPage;\n      highlightCursor?: boolean;\n      messages?: Stagehand.ModelMessage[];\n      signal?: AbortSignal;\n      excludeTools?: string[];\n      output?: Stagehand.StagehandZodObject;\n      callbacks?: Stagehand.AgentStreamCallbacks;\n      variables?: Stagehand.Variables;\n      toolTimeout?: number;\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.AgentStreamExecuteOptions>().toEqualTypeOf<ExpectedAgentStreamExecuteOptions>();\n    });\n  });\n\n  describe(\"AgentExecutionOptions\", () => {\n    type ExpectedAgentExecutionOptions<T = Stagehand.AgentExecuteOptions> = {\n      options: T;\n      logger: (message: Stagehand.LogLine) => void;\n      retries?: number;\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<\n        Stagehand.AgentExecutionOptions<Stagehand.AgentExecuteOptions>\n      >().toEqualTypeOf<\n        ExpectedAgentExecutionOptions<Stagehand.AgentExecuteOptions>\n      >();\n    });\n  });\n\n  describe(\"AgentResult\", () => {\n    type ExpectedAgentResult = {\n      success: boolean;\n      message: string;\n      actions: Stagehand.AgentAction[];\n      completed: boolean;\n      metadata?: Record<string, unknown>;\n      usage?: {\n        input_tokens: number;\n        output_tokens: number;\n        reasoning_tokens?: number;\n        cached_input_tokens?: number;\n        inference_time_ms: number;\n      };\n      messages?: Stagehand.ModelMessage[];\n      output?: Record<string, unknown>;\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.AgentResult>().toEqualTypeOf<ExpectedAgentResult>();\n    });\n  });\n\n  describe(\"AgentConfig\", () => {\n    type ExpectedAgentConfig = {\n      systemPrompt?: string;\n      integrations?: (unknown | string)[];\n      tools?: unknown;\n      cua?: boolean;\n      model?: string | Stagehand.AgentModelConfig<string>;\n      executionModel?: string | Stagehand.AgentModelConfig<string>;\n      stream?: boolean;\n      mode?: Stagehand.AgentToolMode;\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.AgentConfig>().toExtend<ExpectedAgentConfig>();\n    });\n  });\n\n  describe(\"AgentToolMode\", () => {\n    type ExpectedAgentToolMode = \"dom\" | \"hybrid\" | \"cua\";\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.AgentToolMode>().toEqualTypeOf<ExpectedAgentToolMode>();\n    });\n  });\n\n  describe(\"HistoryEntry\", () => {\n    type ExpectedHistoryEntry = {\n      method: \"act\" | \"extract\" | \"observe\" | \"navigate\" | \"agent\";\n      parameters: unknown;\n      result: unknown;\n      timestamp: string;\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.HistoryEntry>().toEqualTypeOf<ExpectedHistoryEntry>();\n    });\n  });\n\n  describe(\"Cookie\", () => {\n    type ExpectedCookie = {\n      name: string;\n      value: string;\n      domain: string;\n      path: string;\n      expires: number;\n      httpOnly: boolean;\n      secure: boolean;\n      sameSite: \"Strict\" | \"Lax\" | \"None\";\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.Cookie>().toEqualTypeOf<ExpectedCookie>();\n    });\n  });\n\n  describe(\"CookieParam\", () => {\n    type ExpectedCookieParam = {\n      name: string;\n      value: string;\n      url?: string;\n      domain?: string;\n      path?: string;\n      expires?: number;\n      httpOnly?: boolean;\n      secure?: boolean;\n      sameSite?: \"Strict\" | \"Lax\" | \"None\";\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.CookieParam>().toEqualTypeOf<ExpectedCookieParam>();\n    });\n  });\n\n  describe(\"ClearCookieOptions\", () => {\n    type ExpectedClearCookieOptions = {\n      name?: string | RegExp;\n      domain?: string | RegExp;\n      path?: string | RegExp;\n    };\n\n    it(\"matches expected type shape\", () => {\n      expectTypeOf<Stagehand.ClearCookieOptions>().toEqualTypeOf<ExpectedClearCookieOptions>();\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/public-api/runtime-utils.test.d.ts

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

package/dist/cjs/tests/unit/public-api/runtime-utils.test.js

@@ -0,0 +1,60 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const Stagehand = __importStar(require("@browserbasehq/stagehand"));
+(0, vitest_1.describe)("Runtime Utils public API types", () => {
+    (0, vitest_1.describe)("injectUrls", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.injectUrls).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("isRunningInBun", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.isRunningInBun).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("loadApiKeyFromEnv", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.loadApiKeyFromEnv).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("providerEnvVarMap", () => {
+        (0, vitest_1.it)("maps providers to environment variable names", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+    });
+});
+//# sourceMappingURL=runtime-utils.test.js.map

package/dist/cjs/tests/unit/public-api/runtime-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-utils.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/runtime-utils.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mCAAoD;AACpD,oEAAsD;AAEtD,IAAA,iBAAQ,EAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,IAAA,iBAAQ,EAAC,YAAY,EAAE,GAAG,EAAE;QAO1B,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,IAAA,qBAAY,EACV,SAAS,CAAC,UAAU,CACrB,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,EAA4B,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,gBAAgB,EAAE,GAAG,EAAE;QAG9B,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,IAAA,qBAAY,EACV,SAAS,CAAC,cAAc,CACzB,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,EAAgC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,mBAAmB,EAAE,GAAG,EAAE;QAMjC,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,IAAA,qBAAY,EACV,SAAS,CAAC,iBAAiB,CAC5B,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,EAAmC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,mBAAmB,EAAE,GAAG,EAAE;QAKjC,IAAA,WAAE,EAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,IAAA,qBAAY,GAET,CAAC,QAAQ,EAA6B,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expectTypeOf, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\ndescribe(\"Runtime Utils public API types\", () => {\n  describe(\"injectUrls\", () => {\n    type ExpectedInjectUrlsParams = [\n      unknown,\n      Array<string | number>,\n      Record<string, string>,\n    ];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.injectUrls,\n      ).parameters.branded.toEqualTypeOf<ExpectedInjectUrlsParams>();\n    });\n  });\n\n  describe(\"isRunningInBun\", () => {\n    type ExpectedIsRunningInBunParams = [];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.isRunningInBun,\n      ).parameters.branded.toEqualTypeOf<ExpectedIsRunningInBunParams>();\n    });\n  });\n\n  describe(\"loadApiKeyFromEnv\", () => {\n    type ExpectedLoadApiKeyFromEnvParams = [\n      string | undefined,\n      (logLine: Stagehand.LogLine) => void,\n    ];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.loadApiKeyFromEnv,\n      ).parameters.branded.toEqualTypeOf<ExpectedLoadApiKeyFromEnvParams>();\n    });\n  });\n\n  describe(\"providerEnvVarMap\", () => {\n    type ExpectedProviderEnvVarMap = Partial<\n      Record<string, string | Array<string>>\n    >;\n\n    it(\"maps providers to environment variable names\", () => {\n      expectTypeOf<\n        typeof Stagehand.providerEnvVarMap\n      >().toExtend<ExpectedProviderEnvVarMap>();\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/public-api/schema-utils.test.d.ts

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

package/dist/cjs/tests/unit/public-api/schema-utils.test.js

@@ -0,0 +1,95 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const Stagehand = __importStar(require("@browserbasehq/stagehand"));
+(0, vitest_1.describe)("Schema Utils public API types", () => {
+    (0, vitest_1.describe)("defaultExtractSchema", () => {
+        (0, vitest_1.it)("infers to the correct type", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("getZodType", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.getZodType).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("isZod3Schema", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.isZod3Schema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("isZod4Schema", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.isZod4Schema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("jsonSchemaToZod", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.jsonSchemaToZod).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("pageTextSchema", () => {
+        (0, vitest_1.it)("infers to the correct type", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("toGeminiSchema", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.toGeminiSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("toJsonSchema", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.toJsonSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("transformSchema", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.transformSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("trimTrailingTextNode", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.trimTrailingTextNode).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("validateZodSchema", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.validateZodSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+});
+//# sourceMappingURL=schema-utils.test.js.map

package/dist/cjs/tests/unit/public-api/schema-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/schema-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expectTypeOf, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\ndescribe(\"Schema Utils public API types\", () => {\n  describe(\"defaultExtractSchema\", () => {\n    type ExpectedInferredType = { extraction: string };\n\n    it(\"infers to the correct type\", () => {\n      expectTypeOf<\n        Stagehand.InferStagehandSchema<typeof Stagehand.defaultExtractSchema>\n      >().toEqualTypeOf<ExpectedInferredType>();\n    });\n  });\n\n  describe(\"getZodType\", () => {\n    type ExpectedGetZodTypeParams = [Stagehand.StagehandZodSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.getZodType,\n      ).parameters.branded.toEqualTypeOf<ExpectedGetZodTypeParams>();\n    });\n  });\n\n  describe(\"isZod3Schema\", () => {\n    type ExpectedIsZod3SchemaParams = [Stagehand.StagehandZodSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.isZod3Schema,\n      ).parameters.branded.toEqualTypeOf<ExpectedIsZod3SchemaParams>();\n    });\n  });\n\n  describe(\"isZod4Schema\", () => {\n    type ExpectedIsZod4SchemaParams = [Stagehand.StagehandZodSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.isZod4Schema,\n      ).parameters.branded.toEqualTypeOf<ExpectedIsZod4SchemaParams>();\n    });\n  });\n\n  describe(\"jsonSchemaToZod\", () => {\n    type ExpectedJsonSchemaToZodParams = [Stagehand.JsonSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.jsonSchemaToZod,\n      ).parameters.branded.toEqualTypeOf<ExpectedJsonSchemaToZodParams>();\n    });\n  });\n\n  describe(\"pageTextSchema\", () => {\n    type ExpectedInferredType = { pageText: string };\n\n    it(\"infers to the correct type\", () => {\n      expectTypeOf<\n        Stagehand.InferStagehandSchema<typeof Stagehand.pageTextSchema>\n      >().toEqualTypeOf<ExpectedInferredType>();\n    });\n  });\n\n  describe(\"toGeminiSchema\", () => {\n    type ExpectedToGeminiSchemaParams = [Stagehand.StagehandZodSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.toGeminiSchema,\n      ).parameters.branded.toEqualTypeOf<ExpectedToGeminiSchemaParams>();\n    });\n  });\n\n  describe(\"toJsonSchema\", () => {\n    type ExpectedToJsonSchemaParams = [Stagehand.StagehandZodSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.toJsonSchema,\n      ).parameters.branded.toEqualTypeOf<ExpectedToJsonSchemaParams>();\n    });\n  });\n\n  describe(\"transformSchema\", () => {\n    type ExpectedTransformSchemaParams = [\n      Stagehand.StagehandZodSchema,\n      Array<string | number>,\n    ];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.transformSchema,\n      ).parameters.branded.toEqualTypeOf<ExpectedTransformSchemaParams>();\n    });\n  });\n\n  describe(\"trimTrailingTextNode\", () => {\n    type ExpectedTrimTrailingTextNodeParams = [string | undefined];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.trimTrailingTextNode,\n      ).parameters.branded.toEqualTypeOf<ExpectedTrimTrailingTextNodeParams>();\n    });\n  });\n\n  describe(\"validateZodSchema\", () => {\n    type ExpectedValidateZodSchemaParams = [\n      Stagehand.StagehandZodSchema,\n      unknown,\n    ];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.validateZodSchema,\n      ).parameters.branded.toEqualTypeOf<ExpectedValidateZodSchemaParams>();\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/public-api/timeout-error-types.test.d.ts

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

package/dist/cjs/tests/unit/public-api/timeout-error-types.test.js

@@ -0,0 +1,121 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const Stagehand = __importStar(require("@browserbasehq/stagehand"));
+// ============================================================================
+// Public Timeout Error Types Runtime Tests
+// ============================================================================
+// These tests verify the runtime behavior of exported timeout error types,
+// complementing the type-level tests in public-error-types.test.ts
+(0, vitest_1.describe)("Public timeout error types runtime behavior", () => {
+    (0, vitest_1.describe)("ActTimeoutError", () => {
+        (0, vitest_1.it)("is exported and extends Error", () => {
+            const error = new Stagehand.ActTimeoutError(1000);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Error);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Stagehand.ActTimeoutError);
+            (0, vitest_1.expect)(error.name).toBe("ActTimeoutError");
+        });
+        (0, vitest_1.it)("contains timeout value in milliseconds in message", () => {
+            const error = new Stagehand.ActTimeoutError(500);
+            (0, vitest_1.expect)(error.message).toContain("500ms");
+        });
+        (0, vitest_1.it)("contains operation name in message", () => {
+            const error = new Stagehand.ActTimeoutError(100);
+            (0, vitest_1.expect)(error.message).toContain("act()");
+        });
+        (0, vitest_1.it)("extends TimeoutError", () => {
+            const error = new Stagehand.ActTimeoutError(1000);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+    });
+    (0, vitest_1.describe)("ExtractTimeoutError", () => {
+        (0, vitest_1.it)("is exported and extends Error", () => {
+            const error = new Stagehand.ExtractTimeoutError(1000);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Error);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Stagehand.ExtractTimeoutError);
+            (0, vitest_1.expect)(error.name).toBe("ExtractTimeoutError");
+        });
+        (0, vitest_1.it)("contains timeout value in milliseconds in message", () => {
+            const error = new Stagehand.ExtractTimeoutError(1000);
+            (0, vitest_1.expect)(error.message).toContain("1000ms");
+        });
+        (0, vitest_1.it)("contains operation name in message", () => {
+            const error = new Stagehand.ExtractTimeoutError(100);
+            (0, vitest_1.expect)(error.message).toContain("extract()");
+        });
+        (0, vitest_1.it)("extends TimeoutError", () => {
+            const error = new Stagehand.ExtractTimeoutError(1000);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+    });
+    (0, vitest_1.describe)("ObserveTimeoutError", () => {
+        (0, vitest_1.it)("is exported and extends Error", () => {
+            const error = new Stagehand.ObserveTimeoutError(1000);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Error);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Stagehand.ObserveTimeoutError);
+            (0, vitest_1.expect)(error.name).toBe("ObserveTimeoutError");
+        });
+        (0, vitest_1.it)("contains timeout value in milliseconds in message", () => {
+            const error = new Stagehand.ObserveTimeoutError(1500);
+            (0, vitest_1.expect)(error.message).toContain("1500ms");
+        });
+        (0, vitest_1.it)("contains operation name in message", () => {
+            const error = new Stagehand.ObserveTimeoutError(100);
+            (0, vitest_1.expect)(error.message).toContain("observe()");
+        });
+        (0, vitest_1.it)("extends TimeoutError", () => {
+            const error = new Stagehand.ObserveTimeoutError(1000);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+    });
+    (0, vitest_1.describe)("TimeoutError (base class)", () => {
+        (0, vitest_1.it)("is exported and extends Error", () => {
+            const error = new Stagehand.TimeoutError("custom operation", 2000);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Error);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+        (0, vitest_1.it)("contains operation name and timeout in message", () => {
+            const error = new Stagehand.TimeoutError("custom operation", 2000);
+            (0, vitest_1.expect)(error.message).toContain("custom operation");
+            (0, vitest_1.expect)(error.message).toContain("2000ms");
+        });
+        (0, vitest_1.it)("extends StagehandError", () => {
+            const error = new Stagehand.TimeoutError("operation", 1000);
+            (0, vitest_1.expect)(error).toBeInstanceOf(Stagehand.StagehandError);
+        });
+    });
+});
+//# sourceMappingURL=timeout-error-types.test.js.map

package/dist/cjs/tests/unit/public-api/timeout-error-types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-error-types.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/timeout-error-types.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\n// ============================================================================\n// Public Timeout Error Types Runtime Tests\n// ============================================================================\n// These tests verify the runtime behavior of exported timeout error types,\n// complementing the type-level tests in public-error-types.test.ts\n\ndescribe(\"Public timeout error types runtime behavior\", () => {\n  describe(\"ActTimeoutError\", () => {\n    it(\"is exported and extends Error\", () => {\n      const error = new Stagehand.ActTimeoutError(1000);\n      expect(error).toBeInstanceOf(Error);\n      expect(error).toBeInstanceOf(Stagehand.ActTimeoutError);\n      expect(error.name).toBe(\"ActTimeoutError\");\n    });\n\n    it(\"contains timeout value in milliseconds in message\", () => {\n      const error = new Stagehand.ActTimeoutError(500);\n      expect(error.message).toContain(\"500ms\");\n    });\n\n    it(\"contains operation name in message\", () => {\n      const error = new Stagehand.ActTimeoutError(100);\n      expect(error.message).toContain(\"act()\");\n    });\n\n    it(\"extends TimeoutError\", () => {\n      const error = new Stagehand.ActTimeoutError(1000);\n      expect(error).toBeInstanceOf(Stagehand.TimeoutError);\n    });\n  });\n\n  describe(\"ExtractTimeoutError\", () => {\n    it(\"is exported and extends Error\", () => {\n      const error = new Stagehand.ExtractTimeoutError(1000);\n      expect(error).toBeInstanceOf(Error);\n      expect(error).toBeInstanceOf(Stagehand.ExtractTimeoutError);\n      expect(error.name).toBe(\"ExtractTimeoutError\");\n    });\n\n    it(\"contains timeout value in milliseconds in message\", () => {\n      const error = new Stagehand.ExtractTimeoutError(1000);\n      expect(error.message).toContain(\"1000ms\");\n    });\n\n    it(\"contains operation name in message\", () => {\n      const error = new Stagehand.ExtractTimeoutError(100);\n      expect(error.message).toContain(\"extract()\");\n    });\n\n    it(\"extends TimeoutError\", () => {\n      const error = new Stagehand.ExtractTimeoutError(1000);\n      expect(error).toBeInstanceOf(Stagehand.TimeoutError);\n    });\n  });\n\n  describe(\"ObserveTimeoutError\", () => {\n    it(\"is exported and extends Error\", () => {\n      const error = new Stagehand.ObserveTimeoutError(1000);\n      expect(error).toBeInstanceOf(Error);\n      expect(error).toBeInstanceOf(Stagehand.ObserveTimeoutError);\n      expect(error.name).toBe(\"ObserveTimeoutError\");\n    });\n\n    it(\"contains timeout value in milliseconds in message\", () => {\n      const error = new Stagehand.ObserveTimeoutError(1500);\n      expect(error.message).toContain(\"1500ms\");\n    });\n\n    it(\"contains operation name in message\", () => {\n      const error = new Stagehand.ObserveTimeoutError(100);\n      expect(error.message).toContain(\"observe()\");\n    });\n\n    it(\"extends TimeoutError\", () => {\n      const error = new Stagehand.ObserveTimeoutError(1000);\n      expect(error).toBeInstanceOf(Stagehand.TimeoutError);\n    });\n  });\n\n  describe(\"TimeoutError (base class)\", () => {\n    it(\"is exported and extends Error\", () => {\n      const error = new Stagehand.TimeoutError(\"custom operation\", 2000);\n      expect(error).toBeInstanceOf(Error);\n      expect(error).toBeInstanceOf(Stagehand.TimeoutError);\n    });\n\n    it(\"contains operation name and timeout in message\", () => {\n      const error = new Stagehand.TimeoutError(\"custom operation\", 2000);\n      expect(error.message).toContain(\"custom operation\");\n      expect(error.message).toContain(\"2000ms\");\n    });\n\n    it(\"extends StagehandError\", () => {\n      const error = new Stagehand.TimeoutError(\"operation\", 1000);\n      expect(error).toBeInstanceOf(Stagehand.StagehandError);\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/public-api/tool-type-export.test.d.ts

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