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

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

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

package/dist/esm/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/esm/tests/unit/public-api/runtime-utils.test.d.ts

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

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

@@ -0,0 +1,25 @@
+import { describe, expectTypeOf, it } from "vitest";
+import * as Stagehand from "@browserbasehq/stagehand";
+describe("Runtime Utils public API types", () => {
+    describe("injectUrls", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.injectUrls).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("isRunningInBun", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.isRunningInBun).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("loadApiKeyFromEnv", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.loadApiKeyFromEnv).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("providerEnvVarMap", () => {
+        it("maps providers to environment variable names", () => {
+            expectTypeOf().toExtend();
+        });
+    });
+});
+//# sourceMappingURL=runtime-utils.test.js.map

package/dist/esm/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,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AAEtD,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAO1B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,YAAY,CACV,SAAS,CAAC,UAAU,CACrB,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,EAA4B,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAG9B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,YAAY,CACV,SAAS,CAAC,cAAc,CACzB,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,EAAgC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAMjC,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,YAAY,CACV,SAAS,CAAC,iBAAiB,CAC5B,CAAC,UAAU,CAAC,OAAO,CAAC,aAAa,EAAmC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAKjC,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,YAAY,EAET,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/esm/tests/unit/public-api/schema-utils.test.d.ts

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

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

@@ -0,0 +1,60 @@
+import { describe, expectTypeOf, it } from "vitest";
+import * as Stagehand from "@browserbasehq/stagehand";
+describe("Schema Utils public API types", () => {
+    describe("defaultExtractSchema", () => {
+        it("infers to the correct type", () => {
+            expectTypeOf().toEqualTypeOf();
+        });
+    });
+    describe("getZodType", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.getZodType).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("isZod3Schema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.isZod3Schema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("isZod4Schema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.isZod4Schema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("jsonSchemaToZod", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.jsonSchemaToZod).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("pageTextSchema", () => {
+        it("infers to the correct type", () => {
+            expectTypeOf().toEqualTypeOf();
+        });
+    });
+    describe("toGeminiSchema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.toGeminiSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("toJsonSchema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.toJsonSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("transformSchema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.transformSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("trimTrailingTextNode", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.trimTrailingTextNode).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("validateZodSchema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.validateZodSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+});
+//# sourceMappingURL=schema-utils.test.js.map

package/dist/esm/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/esm/tests/unit/public-api/timeout-error-types.test.d.ts

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

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

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import * as Stagehand from "@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
+describe("Public timeout error types runtime behavior", () => {
+    describe("ActTimeoutError", () => {
+        it("is exported and extends Error", () => {
+            const error = new Stagehand.ActTimeoutError(1000);
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(Stagehand.ActTimeoutError);
+            expect(error.name).toBe("ActTimeoutError");
+        });
+        it("contains timeout value in milliseconds in message", () => {
+            const error = new Stagehand.ActTimeoutError(500);
+            expect(error.message).toContain("500ms");
+        });
+        it("contains operation name in message", () => {
+            const error = new Stagehand.ActTimeoutError(100);
+            expect(error.message).toContain("act()");
+        });
+        it("extends TimeoutError", () => {
+            const error = new Stagehand.ActTimeoutError(1000);
+            expect(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+    });
+    describe("ExtractTimeoutError", () => {
+        it("is exported and extends Error", () => {
+            const error = new Stagehand.ExtractTimeoutError(1000);
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(Stagehand.ExtractTimeoutError);
+            expect(error.name).toBe("ExtractTimeoutError");
+        });
+        it("contains timeout value in milliseconds in message", () => {
+            const error = new Stagehand.ExtractTimeoutError(1000);
+            expect(error.message).toContain("1000ms");
+        });
+        it("contains operation name in message", () => {
+            const error = new Stagehand.ExtractTimeoutError(100);
+            expect(error.message).toContain("extract()");
+        });
+        it("extends TimeoutError", () => {
+            const error = new Stagehand.ExtractTimeoutError(1000);
+            expect(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+    });
+    describe("ObserveTimeoutError", () => {
+        it("is exported and extends Error", () => {
+            const error = new Stagehand.ObserveTimeoutError(1000);
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(Stagehand.ObserveTimeoutError);
+            expect(error.name).toBe("ObserveTimeoutError");
+        });
+        it("contains timeout value in milliseconds in message", () => {
+            const error = new Stagehand.ObserveTimeoutError(1500);
+            expect(error.message).toContain("1500ms");
+        });
+        it("contains operation name in message", () => {
+            const error = new Stagehand.ObserveTimeoutError(100);
+            expect(error.message).toContain("observe()");
+        });
+        it("extends TimeoutError", () => {
+            const error = new Stagehand.ObserveTimeoutError(1000);
+            expect(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+    });
+    describe("TimeoutError (base class)", () => {
+        it("is exported and extends Error", () => {
+            const error = new Stagehand.TimeoutError("custom operation", 2000);
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+        it("contains operation name and timeout in message", () => {
+            const error = new Stagehand.TimeoutError("custom operation", 2000);
+            expect(error.message).toContain("custom operation");
+            expect(error.message).toContain("2000ms");
+        });
+        it("extends StagehandError", () => {
+            const error = new Stagehand.TimeoutError("operation", 1000);
+            expect(error).toBeInstanceOf(Stagehand.StagehandError);
+        });
+    });
+});
+//# sourceMappingURL=timeout-error-types.test.js.map

package/dist/esm/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/esm/tests/unit/public-api/tool-type-export.test.d.ts

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

package/dist/esm/tests/unit/public-api/tool-type-export.test.js

@@ -0,0 +1,30 @@
+import { describe, expectTypeOf, it, expect } from "vitest";
+import * as Stagehand from "@browserbasehq/stagehand";
+import { z } from "zod";
+/**
+ * Test to verify tool-related exports from Stagehand.
+ * Users should be able to create custom tools using the exported `tool` function
+ * without needing to install the ai package directly.
+ */
+describe("Tool exports from AI SDK", () => {
+    it("exports Tool type that matches AI SDK Tool type", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("exports tool function", () => {
+        expect(typeof Stagehand.tool).toBe("function");
+    });
+    it("tool function can be used to define custom tools", () => {
+        const customTool = Stagehand.tool({
+            description: "A test tool",
+            inputSchema: z.object({
+                input: z.string(),
+            }),
+            execute: async ({ input }) => {
+                return { result: `Processed: ${input}` };
+            },
+        });
+        expect(customTool).toBeDefined();
+        expect(customTool.description).toBe("A test tool");
+    });
+});
+//# sourceMappingURL=tool-type-export.test.js.map

package/dist/esm/tests/unit/public-api/tool-type-export.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-type-export.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/tool-type-export.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC5D,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,YAAY,EAAkB,CAAC,aAAa,EAAQ,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC;YAChC,WAAW,EAAE,aAAa;YAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;aAClB,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,OAAO,EAAE,MAAM,EAAE,cAAc,KAAK,EAAE,EAAE,CAAC;YAC3C,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expectTypeOf, it, expect } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\nimport { type Tool } from \"ai\";\nimport { z } from \"zod\";\n\n/**\n * Test to verify tool-related exports from Stagehand.\n * Users should be able to create custom tools using the exported `tool` function\n * without needing to install the ai package directly.\n */\ndescribe(\"Tool exports from AI SDK\", () => {\n  it(\"exports Tool type that matches AI SDK Tool type\", () => {\n    expectTypeOf<Stagehand.Tool>().toEqualTypeOf<Tool>();\n  });\n\n  it(\"exports tool function\", () => {\n    expect(typeof Stagehand.tool).toBe(\"function\");\n  });\n\n  it(\"tool function can be used to define custom tools\", () => {\n    const customTool = Stagehand.tool({\n      description: \"A test tool\",\n      inputSchema: z.object({\n        input: z.string(),\n      }),\n      execute: async ({ input }) => {\n        return { result: `Processed: ${input}` };\n      },\n    });\n\n    expect(customTool).toBeDefined();\n    expect(customTool.description).toBe(\"A test tool\");\n  });\n});\n"]}

package/dist/esm/tests/unit/public-api/v3-core.test.d.ts

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

package/dist/esm/tests/unit/public-api/v3-core.test.js

@@ -0,0 +1,73 @@
+import { describe, expect, expectTypeOf, it } from "vitest";
+import * as Stagehand from "@browserbasehq/stagehand";
+describe("V3 Core public API types", () => {
+    describe("Stagehand", () => {
+        it("has correct public interface shape", () => {
+            expectTypeOf().toExtend();
+        });
+        it("act accepts Action as first parameter", () => {
+            const mockAction = {};
+            expectTypeOf().toBeCallableWith(mockAction, {});
+        });
+        it("extract accepts instruction and schema", () => {
+            const mockSchema = {};
+            expectTypeOf().toBeCallableWith("instruction", mockSchema, {});
+        });
+        it("observe accepts instruction and options", () => {
+            expectTypeOf().toBeCallableWith("instruction", {});
+        });
+        it("agent execute accepts page option", () => {
+            const mockPage = {};
+            expectTypeOf().toBeCallableWith({
+                instruction: "test",
+                page: mockPage,
+            });
+        });
+    });
+    describe("StagehandMetrics", () => {
+        it("matches the published metrics shape", () => {
+            expectTypeOf().toEqualTypeOf();
+        });
+    });
+    describe("V3", () => {
+        // V3 is the same class as Stagehand, just re-exported with a different name.
+        // The public interface shape is already tested in the "Stagehand" test above.
+        it("is exported", () => {
+            expect(Stagehand.V3).toBeDefined();
+        });
+    });
+    describe("V3Evaluator", () => {
+        it("is exported", () => {
+            expect(Stagehand.V3Evaluator).toBeDefined();
+        });
+        it("has ask method", () => {
+            expectTypeOf().toExtend();
+        });
+        it("has batchAsk method", () => {
+            expectTypeOf().toExtend();
+        });
+    });
+    describe("V3FunctionName", () => {
+        const expectedFunctionNames = [
+            "ACT",
+            "EXTRACT",
+            "OBSERVE",
+            "AGENT",
+        ];
+        it("matches the known function name literals", () => {
+            expectTypeOf().toExtend();
+            void expectedFunctionNames; // Mark as used to satisfy ESLint
+        });
+    });
+    describe("connectToMCPServer", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.connectToMCPServer).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("LOG_LEVEL_NAMES", () => {
+        it("maps numeric levels to strings", () => {
+            expectTypeOf().toExtend();
+        });
+    });
+});
+//# sourceMappingURL=v3-core.test.js.map

package/dist/esm/tests/unit/public-api/v3-core.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-core.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/v3-core.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, expectTypeOf, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\ndescribe(\"V3 Core public API types\", () => {\n  describe(\"Stagehand\", () => {\n    type ExpectedShape = {\n      init: () => Promise<void>;\n      close: (opts?: { force?: boolean }) => Promise<void>;\n      act: (\n        input: string | Stagehand.Action,\n        options?: Stagehand.ActOptions,\n      ) => Promise<Stagehand.ActResult>;\n      extract: (...args: unknown[]) => Promise<unknown>;\n      observe: (...args: unknown[]) => Promise<Stagehand.Action[]>;\n      agent: (config?: Stagehand.AgentConfig) => {\n        execute: (\n          instructionOrOptions: string | Stagehand.AgentExecuteOptions,\n        ) => Promise<Stagehand.AgentResult>;\n      };\n      connectURL: () => string;\n      context: unknown;\n      metrics: Promise<Stagehand.StagehandMetrics>;\n      history: Promise<ReadonlyArray<Stagehand.HistoryEntry>>;\n      llmClient: Stagehand.LLMClient;\n      browserbaseSessionID: string | undefined;\n      browserbaseSessionURL: string | undefined;\n      browserbaseDebugURL: string | undefined;\n      experimental: boolean;\n      logInferenceToFile: boolean;\n      verbose: 0 | 1 | 2;\n      logger: (logLine: Stagehand.LogLine) => void;\n      isAgentReplayActive: () => boolean;\n      recordAgentReplayStep: (step: unknown) => void;\n    };\n\n    type StagehandInstance = InstanceType<typeof Stagehand.Stagehand>;\n\n    it(\"has correct public interface shape\", () => {\n      expectTypeOf<StagehandInstance>().toExtend<ExpectedShape>();\n    });\n\n    it(\"act accepts Action as first parameter\", () => {\n      const mockAction = {} as Stagehand.Action;\n      expectTypeOf<StagehandInstance[\"act\"]>().toBeCallableWith(\n        mockAction,\n        {} as Stagehand.ActOptions,\n      );\n    });\n\n    it(\"extract accepts instruction and schema\", () => {\n      const mockSchema = {} as Stagehand.StagehandZodSchema;\n      expectTypeOf<StagehandInstance[\"extract\"]>().toBeCallableWith(\n        \"instruction\",\n        mockSchema,\n        {} as Stagehand.ExtractOptions,\n      );\n    });\n\n    it(\"observe accepts instruction and options\", () => {\n      expectTypeOf<StagehandInstance[\"observe\"]>().toBeCallableWith(\n        \"instruction\",\n        {} as Stagehand.ObserveOptions,\n      );\n    });\n\n    it(\"agent execute accepts page option\", () => {\n      type AgentReturn = ReturnType<StagehandInstance[\"agent\"]>;\n      const mockPage = {} as Stagehand.AnyPage;\n      expectTypeOf<AgentReturn[\"execute\"]>().toBeCallableWith({\n        instruction: \"test\",\n        page: mockPage,\n      } satisfies Stagehand.AgentExecuteOptions);\n    });\n  });\n\n  describe(\"StagehandMetrics\", () => {\n    type ExpectedStagehandMetrics = {\n      actPromptTokens: number;\n      actCompletionTokens: number;\n      actReasoningTokens: number;\n      actCachedInputTokens: number;\n      actInferenceTimeMs: number;\n      extractPromptTokens: number;\n      extractCompletionTokens: number;\n      extractReasoningTokens: number;\n      extractCachedInputTokens: number;\n      extractInferenceTimeMs: number;\n      observePromptTokens: number;\n      observeCompletionTokens: number;\n      observeReasoningTokens: number;\n      observeCachedInputTokens: number;\n      observeInferenceTimeMs: number;\n      agentPromptTokens: number;\n      agentCompletionTokens: number;\n      agentReasoningTokens: number;\n      agentCachedInputTokens: number;\n      agentInferenceTimeMs: number;\n      totalPromptTokens: number;\n      totalCompletionTokens: number;\n      totalReasoningTokens: number;\n      totalCachedInputTokens: number;\n      totalInferenceTimeMs: number;\n    };\n\n    it(\"matches the published metrics shape\", () => {\n      expectTypeOf<Stagehand.StagehandMetrics>().toEqualTypeOf<ExpectedStagehandMetrics>();\n    });\n  });\n\n  describe(\"V3\", () => {\n    // V3 is the same class as Stagehand, just re-exported with a different name.\n    // The public interface shape is already tested in the \"Stagehand\" test above.\n    it(\"is exported\", () => {\n      expect(Stagehand.V3).toBeDefined();\n    });\n  });\n\n  describe(\"V3Evaluator\", () => {\n    type V3EvaluatorInstance = InstanceType<typeof Stagehand.V3Evaluator>;\n\n    it(\"is exported\", () => {\n      expect(Stagehand.V3Evaluator).toBeDefined();\n    });\n\n    it(\"has ask method\", () => {\n      expectTypeOf<V3EvaluatorInstance[\"ask\"]>().toExtend<\n        (options: unknown) => Promise<unknown>\n      >();\n    });\n\n    it(\"has batchAsk method\", () => {\n      expectTypeOf<V3EvaluatorInstance[\"batchAsk\"]>().toExtend<\n        (options: unknown) => Promise<unknown[]>\n      >();\n    });\n  });\n\n  describe(\"V3FunctionName\", () => {\n    const expectedFunctionNames = [\n      \"ACT\",\n      \"EXTRACT\",\n      \"OBSERVE\",\n      \"AGENT\",\n    ] as const;\n\n    it(\"matches the known function name literals\", () => {\n      expectTypeOf<Stagehand.V3FunctionName>().toExtend<\n        (typeof expectedFunctionNames)[number]\n      >();\n      void expectedFunctionNames; // Mark as used to satisfy ESLint\n    });\n  });\n\n  describe(\"connectToMCPServer\", () => {\n    type ExpectedServerConfig =\n      | string\n      | URL\n      | { command: string; args?: string[]; env?: Record<string, string> }\n      | {\n          serverUrl: string | URL;\n          clientOptions?: unknown;\n          requestOptions?: unknown;\n        };\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.connectToMCPServer,\n      ).parameters.branded.toEqualTypeOf<[ExpectedServerConfig]>();\n    });\n  });\n\n  describe(\"LOG_LEVEL_NAMES\", () => {\n    type ExpectedLOG_LEVEL_NAMES = Record<Stagehand.LogLevel, string>;\n\n    it(\"maps numeric levels to strings\", () => {\n      expectTypeOf<\n        typeof Stagehand.LOG_LEVEL_NAMES\n      >().toExtend<ExpectedLOG_LEVEL_NAMES>();\n    });\n  });\n});\n"]}

package/dist/esm/tests/unit/rerender-missing-shadows.test.d.ts

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