@browserbasehq/stagehand 3.0.7-alpha-934f492ec587bef81f0ce75b45a35b44ab545712 → 3.0.7-alpha-0d2b398cd40b32a9ecaf28ede70853036b7c91bd

package/dist/index.d.ts

@@ -817,6 +817,9 @@ declare class AgentAbortError extends StagehandError {
     readonly reason: string;
     constructor(reason?: string);
 }
+declare class StagehandClosedError extends StagehandError {
+    constructor();
+}
 
 declare class AISdkClient extends LLMClient {
     type: "aisdk";
@@ -1530,63 +1533,32 @@ declare class Page {
      * on the top-level page target's session. Coordinates are relative to the
      * viewport origin (top-left). Does not scroll.
      */
-    click(x: number, y: number, options: {
-        button?: "left" | "right" | "middle";
-        clickCount?: number;
-        returnXpath: true;
-    }): Promise<string>;
     click(x: number, y: number, options?: {
         button?: "left" | "right" | "middle";
         clickCount?: number;
-        returnXpath?: false;
-    }): Promise<void>;
-    click(x: number, y: number, options: {
-        button?: "left" | "right" | "middle";
-        clickCount?: number;
-        returnXpath: boolean;
-    }): Promise<void | string>;
+        returnXpath?: boolean;
+    }): Promise<string>;
     /**
      * Hover at absolute page coordinates (CSS pixels).
      * Dispatches mouseMoved via CDP Input domain on the top-level page target's
      * session.
      */
-    hover(x: number, y: number, options: {
-        returnXpath: true;
-    }): Promise<string>;
     hover(x: number, y: number, options?: {
-        returnXpath?: false;
-    }): Promise<void>;
-    scroll(x: number, y: number, deltaX: number, deltaY: number, options: {
-        returnXpath: true;
+        returnXpath?: boolean;
     }): Promise<string>;
     scroll(x: number, y: number, deltaX: number, deltaY: number, options?: {
-        returnXpath?: false;
-    }): Promise<void>;
-    scroll(x: number, y: number, deltaX: number, deltaY: number, options: {
-        returnXpath: boolean;
-    }): Promise<void | string>;
+        returnXpath?: boolean;
+    }): Promise<string>;
     /**
      * Drag from (fromX, fromY) to (toX, toY) using mouse events.
      * Sends mouseMoved → mousePressed → mouseMoved (steps) → mouseReleased.
      */
-    dragAndDrop(fromX: number, fromY: number, toX: number, toY: number, options: {
-        button?: "left" | "right" | "middle";
-        steps?: number;
-        delay?: number;
-        returnXpath: true;
-    }): Promise<[string, string]>;
     dragAndDrop(fromX: number, fromY: number, toX: number, toY: number, options?: {
         button?: "left" | "right" | "middle";
         steps?: number;
         delay?: number;
-        returnXpath?: false;
-    }): Promise<void>;
-    dragAndDrop(fromX: number, fromY: number, toX: number, toY: number, options: {
-        button?: "left" | "right" | "middle";
-        steps?: number;
-        delay?: number;
-        returnXpath: boolean;
-    }): Promise<void | [string, string]>;
+        returnXpath?: boolean;
+    }): Promise<[string, string]>;
     /**
      * Type a string by dispatching keyDown/keyUp events per character.
      * Focus must already be on the desired element. Uses CDP Input.dispatchKeyEvent
@@ -2474,4 +2446,4 @@ declare class V3Evaluator {
     private _evaluateWithMultipleScreenshots;
 }
 
-export { type AISDKCustomProvider, type AISDKProvider, AISdkClient, AVAILABLE_CUA_MODELS, type ActOptions, type ActResult, ActTimeoutError, type Action, type ActionExecutionResult, AgentAbortError, type AgentAction, type AgentCallbacks, type AgentConfig, type AgentContext, type AgentExecuteCallbacks, type AgentExecuteOptions, type AgentExecuteOptionsBase, type AgentExecutionOptions, type AgentHandlerOptions, type AgentInstance, type AgentModelConfig, AgentProvider, type AgentProviderType, type AgentResult, AgentScreenshotProviderError, type AgentState, type AgentStreamCallbacks, type AgentStreamExecuteOptions, type AgentStreamResult, type AgentType, AnnotatedScreenshotText, type AnthropicClientOptions, type AnthropicContentBlock, type AnthropicJsonSchemaObject, type AnthropicMessage, type AnthropicTextBlock, type AnthropicToolResult, type AnyPage, type AvailableCuaModel, type AvailableModel, BrowserbaseSessionNotFoundError, CaptchaTimeoutError, type ChatCompletionOptions, type ChatMessage, type ChatMessageContent, type ChatMessageImageContent, type ChatMessageTextContent, type ClientOptions, type ComputerCallItem, ConnectionTimeoutError, type ConsoleListener, ConsoleMessage, ContentFrameNotFoundError, type CreateChatCompletionOptions, CreateChatCompletionResponseError, CuaModelRequiredError, ElementNotVisibleError, ExperimentalApiConflictError, ExperimentalNotConfiguredError, type ExtractOptions, type ExtractResult, ExtractTimeoutError, type FunctionCallItem, type GoogleServiceAccountCredentials, type GoogleVertexProviderSettings, HandlerNotInitializedError, type HistoryEntry, type InferStagehandSchema, InvalidAISDKModelFormatError, type JsonSchema, type JsonSchemaDocument, type JsonSchemaProperty, LLMClient, type LLMParsedResponse, type LLMResponse, LLMResponseError, type LLMTool, type LLMUsage, LOG_LEVEL_NAMES, type LoadState, type LocalBrowserLaunchOptions, type LogLevel, type LogLine, type Logger, MCPConnectionError, MissingEnvironmentVariableError, MissingLLMConfigurationError, type ModelConfiguration, type ModelProvider, type NonStreamingAgentInstance, type ObserveOptions, ObserveTimeoutError, type OpenAIClientOptions, Page, PageNotFoundError, Response$1 as Response, ResponseBodyError, type ResponseInputItem, type ResponseItem, ResponseParseError, V3 as Stagehand, StagehandAPIError, StagehandAPIUnauthorizedError, StagehandClickError, StagehandDefaultError, StagehandDomProcessError, StagehandElementNotFoundError, StagehandEnvironmentError, StagehandError, StagehandEvalError, StagehandHttpError, StagehandIframeError, StagehandInitError, StagehandInvalidArgumentError, type StagehandMetrics, StagehandMissingArgumentError, StagehandNotInitializedError, StagehandResponseBodyError, StagehandResponseParseError, StagehandServerError, StagehandShadowRootMissingError, StagehandShadowSegmentEmptyError, StagehandShadowSegmentNotFoundError, type StagehandZodObject, type StagehandZodSchema, type StreamingAgentInstance, StreamingCallbacksInNonStreamingModeError, TimeoutError, type ToolUseItem, UnsupportedAISDKModelProviderError, UnsupportedModelError, UnsupportedModelProviderError, V3, type V3Env, V3Evaluator, V3FunctionName, type V3Options, XPathResolutionError, ZodSchemaValidationError, connectToMCPServer, defaultExtractSchema, getZodType, injectUrls, isRunningInBun, isZod3Schema, isZod4Schema, jsonSchemaToZod, loadApiKeyFromEnv, modelToAgentProviderMap, pageTextSchema, providerEnvVarMap, toGeminiSchema, toJsonSchema, transformSchema, trimTrailingTextNode, validateZodSchema };
+export { type AISDKCustomProvider, type AISDKProvider, AISdkClient, AVAILABLE_CUA_MODELS, type ActOptions, type ActResult, ActTimeoutError, type Action, type ActionExecutionResult, AgentAbortError, type AgentAction, type AgentCallbacks, type AgentConfig, type AgentContext, type AgentExecuteCallbacks, type AgentExecuteOptions, type AgentExecuteOptionsBase, type AgentExecutionOptions, type AgentHandlerOptions, type AgentInstance, type AgentModelConfig, AgentProvider, type AgentProviderType, type AgentResult, AgentScreenshotProviderError, type AgentState, type AgentStreamCallbacks, type AgentStreamExecuteOptions, type AgentStreamResult, type AgentType, AnnotatedScreenshotText, type AnthropicClientOptions, type AnthropicContentBlock, type AnthropicJsonSchemaObject, type AnthropicMessage, type AnthropicTextBlock, type AnthropicToolResult, type AnyPage, type AvailableCuaModel, type AvailableModel, BrowserbaseSessionNotFoundError, CaptchaTimeoutError, type ChatCompletionOptions, type ChatMessage, type ChatMessageContent, type ChatMessageImageContent, type ChatMessageTextContent, type ClientOptions, type ComputerCallItem, ConnectionTimeoutError, type ConsoleListener, ConsoleMessage, ContentFrameNotFoundError, type CreateChatCompletionOptions, CreateChatCompletionResponseError, CuaModelRequiredError, ElementNotVisibleError, ExperimentalApiConflictError, ExperimentalNotConfiguredError, type ExtractOptions, type ExtractResult, ExtractTimeoutError, type FunctionCallItem, type GoogleServiceAccountCredentials, type GoogleVertexProviderSettings, HandlerNotInitializedError, type HistoryEntry, type InferStagehandSchema, InvalidAISDKModelFormatError, type JsonSchema, type JsonSchemaDocument, type JsonSchemaProperty, LLMClient, type LLMParsedResponse, type LLMResponse, LLMResponseError, type LLMTool, type LLMUsage, LOG_LEVEL_NAMES, type LoadState, type LocalBrowserLaunchOptions, type LogLevel, type LogLine, type Logger, MCPConnectionError, MissingEnvironmentVariableError, MissingLLMConfigurationError, type ModelConfiguration, type ModelProvider, type NonStreamingAgentInstance, type ObserveOptions, ObserveTimeoutError, type OpenAIClientOptions, Page, PageNotFoundError, Response$1 as Response, ResponseBodyError, type ResponseInputItem, type ResponseItem, ResponseParseError, V3 as Stagehand, StagehandAPIError, StagehandAPIUnauthorizedError, StagehandClickError, StagehandClosedError, StagehandDefaultError, StagehandDomProcessError, StagehandElementNotFoundError, StagehandEnvironmentError, StagehandError, StagehandEvalError, StagehandHttpError, StagehandIframeError, StagehandInitError, StagehandInvalidArgumentError, type StagehandMetrics, StagehandMissingArgumentError, StagehandNotInitializedError, StagehandResponseBodyError, StagehandResponseParseError, StagehandServerError, StagehandShadowRootMissingError, StagehandShadowSegmentEmptyError, StagehandShadowSegmentNotFoundError, type StagehandZodObject, type StagehandZodSchema, type StreamingAgentInstance, StreamingCallbacksInNonStreamingModeError, TimeoutError, type ToolUseItem, UnsupportedAISDKModelProviderError, UnsupportedModelError, UnsupportedModelProviderError, V3, type V3Env, V3Evaluator, V3FunctionName, type V3Options, XPathResolutionError, ZodSchemaValidationError, connectToMCPServer, defaultExtractSchema, getZodType, injectUrls, isRunningInBun, isZod3Schema, isZod4Schema, jsonSchemaToZod, loadApiKeyFromEnv, modelToAgentProviderMap, pageTextSchema, providerEnvVarMap, toGeminiSchema, toJsonSchema, transformSchema, trimTrailingTextNode, validateZodSchema };

package/dist/index.js

@@ -179,12 +179,12 @@ var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")])
 var STAGEHAND_VERSION;
 var init_version = __esm({
   "lib/version.ts"() {
-    STAGEHAND_VERSION = "3.0.7-alpha-934f492ec587bef81f0ce75b45a35b44ab545712";
+    STAGEHAND_VERSION = "3.0.7-alpha-0d2b398cd40b32a9ecaf28ede70853036b7c91bd";
   }
 });
 
 // lib/v3/types/public/sdkErrors.ts
-var StagehandError, StagehandDefaultError, StagehandEnvironmentError, MissingEnvironmentVariableError, UnsupportedModelError, UnsupportedModelProviderError, UnsupportedAISDKModelProviderError, InvalidAISDKModelFormatError, StagehandNotInitializedError, BrowserbaseSessionNotFoundError, CaptchaTimeoutError, MissingLLMConfigurationError, HandlerNotInitializedError, StagehandInvalidArgumentError, StagehandElementNotFoundError, AgentScreenshotProviderError, StagehandMissingArgumentError, CreateChatCompletionResponseError, StagehandEvalError, StagehandDomProcessError, StagehandClickError, LLMResponseError, StagehandIframeError, ContentFrameNotFoundError, XPathResolutionError, ExperimentalApiConflictError, ExperimentalNotConfiguredError, CuaModelRequiredError, ZodSchemaValidationError, StagehandInitError, MCPConnectionError, StagehandShadowRootMissingError, StagehandShadowSegmentEmptyError, StagehandShadowSegmentNotFoundError, ElementNotVisibleError, ResponseBodyError, ResponseParseError, TimeoutError, ActTimeoutError, ExtractTimeoutError, ObserveTimeoutError, PageNotFoundError, ConnectionTimeoutError, StreamingCallbacksInNonStreamingModeError, AgentAbortError;
+var StagehandError, StagehandDefaultError, StagehandEnvironmentError, MissingEnvironmentVariableError, UnsupportedModelError, UnsupportedModelProviderError, UnsupportedAISDKModelProviderError, InvalidAISDKModelFormatError, StagehandNotInitializedError, BrowserbaseSessionNotFoundError, CaptchaTimeoutError, MissingLLMConfigurationError, HandlerNotInitializedError, StagehandInvalidArgumentError, StagehandElementNotFoundError, AgentScreenshotProviderError, StagehandMissingArgumentError, CreateChatCompletionResponseError, StagehandEvalError, StagehandDomProcessError, StagehandClickError, LLMResponseError, StagehandIframeError, ContentFrameNotFoundError, XPathResolutionError, ExperimentalApiConflictError, ExperimentalNotConfiguredError, CuaModelRequiredError, ZodSchemaValidationError, StagehandInitError, MCPConnectionError, StagehandShadowRootMissingError, StagehandShadowSegmentEmptyError, StagehandShadowSegmentNotFoundError, ElementNotVisibleError, ResponseBodyError, ResponseParseError, TimeoutError, ActTimeoutError, ExtractTimeoutError, ObserveTimeoutError, PageNotFoundError, ConnectionTimeoutError, StreamingCallbacksInNonStreamingModeError, AgentAbortError, StagehandClosedError;
 var init_sdkErrors = __esm({
   "lib/v3/types/public/sdkErrors.ts"() {
     init_version();
@@ -477,6 +477,11 @@ ${JSON.stringify(issues, null, 2)}`);
         this.reason = reason || "aborted";
       }
     };
+    StagehandClosedError = class extends StagehandError {
+      constructor() {
+        super("Stagehand session was closed");
+      }
+    };
   }
 });
 
@@ -26242,7 +26247,7 @@ var init_page = __esm({
               clickCount: i2
             });
           }
-          if (options == null ? void 0 : options.returnXpath) return xpathResult != null ? xpathResult : "";
+          return xpathResult != null ? xpathResult : "";
         });
       }
       hover(x2, y, options) {
@@ -26287,7 +26292,7 @@ var init_page = __esm({
             y,
             button: "none"
           });
-          if (options == null ? void 0 : options.returnXpath) return xpathResult != null ? xpathResult : "";
+          return xpathResult != null ? xpathResult : "";
         });
       }
       scroll(x2, y, deltaX, deltaY, options) {
@@ -26315,7 +26320,7 @@ var init_page = __esm({
             deltaX,
             deltaY
           });
-          if (options == null ? void 0 : options.returnXpath) return xpathResult != null ? xpathResult : "";
+          return xpathResult != null ? xpathResult : "";
         });
       }
       dragAndDrop(fromX, fromY, toX, toY, options) {
@@ -26389,7 +26394,7 @@ var init_page = __esm({
             buttons: buttonMask(button),
             clickCount: 1
           });
-          if (options == null ? void 0 : options.returnXpath) return [fromXpath != null ? fromXpath : "", toXpath != null ? toXpath : ""];
+          return [fromXpath != null ? fromXpath : "", toXpath != null ? toXpath : ""];
         });
       }
       type(text, options) {
@@ -26869,6 +26874,7 @@ __export(v3_exports, {
   StagehandAPIError: () => StagehandAPIError,
   StagehandAPIUnauthorizedError: () => StagehandAPIUnauthorizedError,
   StagehandClickError: () => StagehandClickError,
+  StagehandClosedError: () => StagehandClosedError,
   StagehandDefaultError: () => StagehandDefaultError,
   StagehandDomProcessError: () => StagehandDomProcessError,
   StagehandElementNotFoundError: () => StagehandElementNotFoundError,
@@ -31924,6 +31930,9 @@ var AnthropicCUAClient = class extends AgentClient {
               });
               yield this.actionHandler(action);
             } catch (error) {
+              if (error instanceof StagehandClosedError) {
+                throw error;
+              }
               const errorMessage = error instanceof Error ? error.message : String(error);
               logger({
                 category: "agent",
@@ -32763,6 +32772,9 @@ var OpenAICUAClient = class extends AgentClient {
             }
             nextInputItems.push(outputItem);
           } catch (error) {
+            if (error instanceof StagehandClosedError) {
+              throw error;
+            }
             const errorMessage = error instanceof Error ? error.message : String(error);
             logger({
               category: "agent",
@@ -32790,6 +32802,9 @@ var OpenAICUAClient = class extends AgentClient {
               }
               nextInputItems.push(errorOutputItem);
             } catch (screenshotError) {
+              if (screenshotError instanceof StagehandClosedError) {
+                throw screenshotError;
+              }
               logger({
                 category: "agent",
                 message: `Error capturing screenshot: ${String(screenshotError)}`,
@@ -32845,6 +32860,9 @@ var OpenAICUAClient = class extends AgentClient {
             };
             nextInputItems.push(outputItem);
           } catch (error) {
+            if (error instanceof StagehandClosedError) {
+              throw error;
+            }
             const errorMessage = error instanceof Error ? error.message : String(error);
             logger({
               category: "agent",
@@ -33396,6 +33414,9 @@ var GoogleCUAClient = class extends AgentClient {
                   yield new Promise((resolve3) => setTimeout(resolve3, delay2));
                 }
               } catch (actionError) {
+                if (actionError instanceof StagehandClosedError) {
+                  throw actionError;
+                }
                 logger({
                   category: "agent",
                   message: `Error executing action ${action.type}: ${actionError}`,
@@ -34522,6 +34543,7 @@ var AgentProvider = class _AgentProvider {
 
 // lib/v3/handlers/v3CuaAgentHandler.ts
 init_flowLogger();
+init_sdkErrors();
 var V3CuaAgentHandler = class {
   constructor(v3, logger, options, tools) {
     this.v3 = v3;
@@ -34538,14 +34560,25 @@ var V3CuaAgentHandler = class {
     this.setupAgentClient();
     this.agent = client;
   }
+  /**
+   * Ensures the V3 context is still available (not closed).
+   * Throws StagehandClosedError if stagehand.close() was called.
+   */
+  ensureNotClosed() {
+    if (!this.v3.context) {
+      throw new StagehandClosedError();
+    }
+  }
   setupAgentClient() {
     this.agentClient.setScreenshotProvider(() => __async(this, null, function* () {
+      this.ensureNotClosed();
       const page = yield this.v3.context.awaitActivePage();
       const base64 = yield page.screenshot({ fullPage: false });
       return base64.toString("base64");
     }));
     this.agentClient.setActionHandler((action) => __async(this, null, function* () {
       var _a4, _b, _c;
+      this.ensureNotClosed();
       action.pageUrl = (yield this.v3.context.awaitActivePage()).url();
       const defaultDelay = 500;
       const waitBetween = ((_a4 = this.options.clientOptions) == null ? void 0 : _a4.waitBetweenActions) || defaultDelay;
@@ -66078,6 +66111,7 @@ I'm providing ${screenshots.length} screenshots showing the progression of the t
   StagehandAPIError,
   StagehandAPIUnauthorizedError,
   StagehandClickError,
+  StagehandClosedError,
   StagehandDefaultError,
   StagehandDomProcessError,
   StagehandElementNotFoundError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand",
-  "version": "3.0.7-alpha-934f492ec587bef81f0ce75b45a35b44ab545712",
+  "version": "3.0.7-alpha-0d2b398cd40b32a9ecaf28ede70853036b7c91bd",
   "description": "An AI web browsing framework focused on simplicity and extensibility.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",