@browserbasehq/stagehand 3.0.6-alpha-90530b776ae6790751c318ca215c51c0e2f7c79d → 3.0.6-alpha-4e051b23add7ae276b0dbead38b4587838cfc1c1

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import { GoogleVertexProviderSettings as GoogleVertexProviderSettings$1 } from '
 import { LanguageModelV2 } from '@ai-sdk/provider';
 import { ClientOptions as ClientOptions$1 } from 'openai';
 import { Client, ClientOptions as ClientOptions$3 } from '@modelcontextprotocol/sdk/client/index.js';
-import { ToolSet, StreamTextResult, ModelMessage, wrapLanguageModel, generateObject, generateText, streamText, streamObject, experimental_generateImage, embed, embedMany, experimental_transcribe, experimental_generateSpeech } from 'ai';
+import { ToolSet, PrepareStepFunction, GenerateTextOnStepFinishCallback, StreamTextOnStepFinishCallback, StreamTextOnErrorCallback, StreamTextOnChunkCallback, StreamTextOnFinishCallback, StepResult, StreamTextResult, ModelMessage, wrapLanguageModel, generateObject, generateText, streamText, streamObject, experimental_generateImage, embed, embedMany, experimental_transcribe, experimental_generateSpeech } from 'ai';
 import { Page as Page$1 } from 'playwright-core';
 export { Page as PlaywrightPage } from 'playwright-core';
 import { Page as Page$2 } from 'puppeteer-core';
@@ -784,6 +784,10 @@ declare class PageNotFoundError extends StagehandError {
 declare class ConnectionTimeoutError extends StagehandError {
     constructor(message: string);
 }
+declare class StreamingCallbacksInNonStreamingModeError extends StagehandError {
+    readonly invalidCallbacks: string[];
+    constructor(invalidCallbacks: string[]);
+}
 
 declare class AISdkClient extends LLMClient {
     type: "aisdk";
@@ -1594,7 +1598,7 @@ declare class Page {
 }
 
 interface AgentContext {
-    options: AgentExecuteOptions;
+    options: AgentExecuteOptionsBase;
     maxSteps: number;
     systemPrompt: string;
     allTools: ToolSet;
@@ -1637,12 +1641,156 @@ interface AgentResult {
 type AgentStreamResult = StreamTextResult<ToolSet, never> & {
     result: Promise<AgentResult>;
 };
-interface AgentExecuteOptions {
+/**
+ * Base callbacks shared between execute (non-streaming) and streaming modes.
+ */
+interface AgentCallbacks {
+    /**
+     * Optional function called before each step to modify settings.
+     * You can change the model, tool choices, active tools, system prompt,
+     * and input messages for each step.
+     */
+    prepareStep?: PrepareStepFunction<ToolSet>;
+    /**
+     * Callback called when each step (LLM call) is finished.
+     * This is called for intermediate steps as well as the final step.
+     */
+    onStepFinish?: GenerateTextOnStepFinishCallback<ToolSet> | StreamTextOnStepFinishCallback<ToolSet>;
+}
+/**
+ * Error message type for streaming-only callbacks used in non-streaming mode.
+ * This provides a clear error message when users try to use streaming callbacks without stream: true.
+ */
+type StreamingCallbackNotAvailable = "This callback requires 'stream: true' in AgentConfig. Set stream: true to use streaming callbacks like onChunk, onFinish, onError, and onAbort.";
+/**
+ * Callbacks specific to the non-streaming execute method.
+ */
+interface AgentExecuteCallbacks extends AgentCallbacks {
+    /**
+     * Callback called when each step (LLM call) is finished.
+     */
+    onStepFinish?: GenerateTextOnStepFinishCallback<ToolSet>;
+    /**
+     * NOT AVAILABLE in non-streaming mode.
+     * This callback requires `stream: true` in AgentConfig.
+     *
+     * @example
+     * ```typescript
+     * // Enable streaming to use onChunk:
+     * const agent = stagehand.agent({ stream: true });
+     * await agent.execute({
+     *   instruction: "...",
+     *   callbacks: { onChunk: async (chunk) => console.log(chunk) }
+     * });
+     * ```
+     */
+    onChunk?: StreamingCallbackNotAvailable;
+    /**
+     * NOT AVAILABLE in non-streaming mode.
+     * This callback requires `stream: true` in AgentConfig.
+     *
+     * @example
+     * ```typescript
+     * // Enable streaming to use onFinish:
+     * const agent = stagehand.agent({ stream: true });
+     * await agent.execute({
+     *   instruction: "...",
+     *   callbacks: { onFinish: (event) => console.log("Done!", event) }
+     * });
+     * ```
+     */
+    onFinish?: StreamingCallbackNotAvailable;
+    /**
+     * NOT AVAILABLE in non-streaming mode.
+     * This callback requires `stream: true` in AgentConfig.
+     *
+     * @example
+     * ```typescript
+     * // Enable streaming to use onError:
+     * const agent = stagehand.agent({ stream: true });
+     * await agent.execute({
+     *   instruction: "...",
+     *   callbacks: { onError: ({ error }) => console.error(error) }
+     * });
+     * ```
+     */
+    onError?: StreamingCallbackNotAvailable;
+    /**
+     * NOT AVAILABLE in non-streaming mode.
+     * This callback requires `stream: true` in AgentConfig.
+     *
+     * @example
+     * ```typescript
+     * // Enable streaming to use onAbort:
+     * const agent = stagehand.agent({ stream: true });
+     * await agent.execute({
+     *   instruction: "...",
+     *   callbacks: { onAbort: (event) => console.log("Aborted", event.steps) }
+     * });
+     * ```
+     */
+    onAbort?: StreamingCallbackNotAvailable;
+}
+/**
+ * Callbacks specific to the streaming mode.
+ */
+interface AgentStreamCallbacks extends AgentCallbacks {
+    /**
+     * Callback called when each step (LLM call) is finished during streaming.
+     */
+    onStepFinish?: StreamTextOnStepFinishCallback<ToolSet>;
+    /**
+     * Callback called when an error occurs during streaming.
+     * Use this to log errors or handle error states.
+     */
+    onError?: StreamTextOnErrorCallback;
+    /**
+     * Callback called for each chunk of the stream.
+     * Stream processing will pause until the callback promise resolves.
+     */
+    onChunk?: StreamTextOnChunkCallback<ToolSet>;
+    /**
+     * Callback called when the stream finishes.
+     */
+    onFinish?: StreamTextOnFinishCallback<ToolSet>;
+    /**
+     * Callback called when the stream is aborted.
+     */
+    onAbort?: (event: {
+        steps: Array<StepResult<ToolSet>>;
+    }) => PromiseLike<void> | void;
+}
+/**
+ * Base options for agent execution (without callbacks).
+ */
+interface AgentExecuteOptionsBase {
     instruction: string;
     maxSteps?: number;
     page?: Page$1 | Page$2 | Page$3 | Page;
     highlightCursor?: boolean;
 }
+/**
+ * Options for non-streaming agent execution.
+ * Only accepts AgentExecuteCallbacks (no streaming-specific callbacks like onChunk, onFinish).
+ */
+interface AgentExecuteOptions extends AgentExecuteOptionsBase {
+    /**
+     * Callbacks for non-streaming agent execution.
+     * For streaming callbacks (onChunk, onFinish, onError, onAbort), use stream: true in AgentConfig.
+     */
+    callbacks?: AgentExecuteCallbacks;
+}
+/**
+ * Options for streaming agent execution.
+ * Accepts AgentStreamCallbacks including onChunk, onFinish, onError, and onAbort.
+ */
+interface AgentStreamExecuteOptions extends AgentExecuteOptionsBase {
+    /**
+     * Callbacks for streaming agent execution.
+     * Includes streaming-specific callbacks: onChunk, onFinish, onError, onAbort.
+     */
+    callbacks?: AgentStreamCallbacks;
+}
 type AgentType = "openai" | "anthropic" | "google" | "microsoft";
 declare const AVAILABLE_CUA_MODELS: readonly ["openai/computer-use-preview", "openai/computer-use-preview-2025-03-11", "anthropic/claude-3-7-sonnet-latest", "anthropic/claude-haiku-4-5-20251001", "anthropic/claude-sonnet-4-20250514", "anthropic/claude-sonnet-4-5-20250929", "google/gemini-2.5-computer-use-preview-10-2025", "microsoft/fara-7b"];
 type AvailableCuaModel = (typeof AVAILABLE_CUA_MODELS)[number];
@@ -1776,13 +1924,15 @@ type AgentConfig = {
 /**
  * Agent instance returned when stream: true is set in AgentConfig.
  * execute() returns a streaming result that can be consumed incrementally.
+ * Accepts AgentStreamExecuteOptions with streaming-specific callbacks.
  */
 interface StreamingAgentInstance {
-    execute: (instructionOrOptions: string | AgentExecuteOptions) => Promise<AgentStreamResult>;
+    execute: (instructionOrOptions: string | AgentStreamExecuteOptions) => Promise<AgentStreamResult>;
 }
 /**
  * Agent instance returned when stream is false or not set in AgentConfig.
  * execute() returns a result after the agent completes.
+ * Accepts AgentExecuteOptions with non-streaming callbacks only.
  */
 interface NonStreamingAgentInstance {
     execute: (instructionOrOptions: string | AgentExecuteOptions) => Promise<AgentResult>;
@@ -2115,7 +2265,7 @@ declare class V3 {
     agent(options: AgentConfig & {
         stream: true;
     }): {
-        execute: (instructionOrOptions: string | AgentExecuteOptions) => Promise<AgentStreamResult>;
+        execute: (instructionOrOptions: string | AgentStreamExecuteOptions) => Promise<AgentStreamResult>;
     };
     agent(options?: AgentConfig & {
         stream?: false;
@@ -2249,4 +2399,4 @@ declare class V3Evaluator {
     private _evaluateWithMultipleScreenshots;
 }
 
-export { type AISDKCustomProvider, type AISDKProvider, AISdkClient, AVAILABLE_CUA_MODELS, type ActOptions, type ActResult, type Action, type ActionExecutionResult, type AgentAction, type AgentConfig, type AgentContext, type AgentExecuteOptions, type AgentExecutionOptions, type AgentHandlerOptions, type AgentInstance, type AgentModelConfig, AgentProvider, type AgentProviderType, type AgentResult, AgentScreenshotProviderError, type AgentState, 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, 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, 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, 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, type Action, type ActionExecutionResult, 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, 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, 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 };

package/dist/index.js

@@ -141,12 +141,12 @@ var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")])
 var STAGEHAND_VERSION;
 var init_version = __esm({
   "lib/version.ts"() {
-    STAGEHAND_VERSION = "3.0.6-alpha-90530b776ae6790751c318ca215c51c0e2f7c79d";
+    STAGEHAND_VERSION = "3.0.6-alpha-4e051b23add7ae276b0dbead38b4587838cfc1c1";
   }
 });
 
 // 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, PageNotFoundError, ConnectionTimeoutError;
+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, PageNotFoundError, ConnectionTimeoutError, StreamingCallbacksInNonStreamingModeError;
 var init_sdkErrors = __esm({
   "lib/v3/types/public/sdkErrors.ts"() {
     init_version();
@@ -406,6 +406,14 @@ ${JSON.stringify(issues, null, 2)}`);
         super(`Connection timeout: ${message}`);
       }
     };
+    StreamingCallbacksInNonStreamingModeError = class extends StagehandError {
+      constructor(invalidCallbacks) {
+        super(
+          `Streaming-only callback(s) "${invalidCallbacks.join('", "')}" cannot be used in non-streaming mode. Set 'stream: true' in AgentConfig to use these callbacks.`
+        );
+        this.invalidCallbacks = invalidCallbacks;
+      }
+    };
   }
 });
 
@@ -25971,6 +25979,7 @@ __export(v3_exports, {
   StagehandShadowRootMissingError: () => StagehandShadowRootMissingError,
   StagehandShadowSegmentEmptyError: () => StagehandShadowSegmentEmptyError,
   StagehandShadowSegmentNotFoundError: () => StagehandShadowSegmentNotFoundError,
+  StreamingCallbacksInNonStreamingModeError: () => StreamingCallbacksInNonStreamingModeError,
   TimeoutError: () => TimeoutError,
   UnsupportedAISDKModelProviderError: () => UnsupportedAISDKModelProviderError,
   UnsupportedModelError: () => UnsupportedModelError,
@@ -30298,7 +30307,7 @@ var V3AgentHandler = class {
       }
     });
   }
-  createStepHandler(state) {
+  createStepHandler(state, userCallback) {
     return (event) => __async(this, null, function* () {
       var _a4;
       this.logger({
@@ -30341,6 +30350,9 @@ var V3AgentHandler = class {
         }
         state.currentPageUrl = (yield this.v3.context.awaitActivePage()).url();
       }
+      if (userCallback) {
+        yield userCallback(event);
+      }
     });
   }
   execute(instructionOrOptions) {
@@ -30355,6 +30367,21 @@ var V3AgentHandler = class {
         wrappedModel,
         initialPageUrl
       } = yield this.prepareAgent(instructionOrOptions);
+      const callbacks = instructionOrOptions.callbacks;
+      if (callbacks) {
+        const streamingOnlyCallbacks = [
+          "onChunk",
+          "onFinish",
+          "onError",
+          "onAbort"
+        ];
+        const invalidCallbacks = streamingOnlyCallbacks.filter(
+          (name) => callbacks[name] != null
+        );
+        if (invalidCallbacks.length > 0) {
+          throw new StreamingCallbacksInNonStreamingModeError(invalidCallbacks);
+        }
+      }
       const state = {
         collectedReasoning: [],
         actions: [],
@@ -30371,7 +30398,8 @@ var V3AgentHandler = class {
           stopWhen: (result2) => this.handleStop(result2, maxSteps),
           temperature: 1,
           toolChoice: "auto",
-          onStepFinish: this.createStepHandler(state)
+          prepareStep: callbacks == null ? void 0 : callbacks.prepareStep,
+          onStepFinish: this.createStepHandler(state, callbacks == null ? void 0 : callbacks.onStepFinish)
         });
         return this.consolidateMetricsAndResult(startTime, state, result);
       } catch (error) {
@@ -30400,6 +30428,7 @@ var V3AgentHandler = class {
         wrappedModel,
         initialPageUrl
       } = yield this.prepareAgent(instructionOrOptions);
+      const callbacks = instructionOrOptions.callbacks;
       const state = {
         collectedReasoning: [],
         actions: [],
@@ -30431,11 +30460,19 @@ var V3AgentHandler = class {
         stopWhen: (result) => this.handleStop(result, maxSteps),
         temperature: 1,
         toolChoice: "auto",
-        onStepFinish: this.createStepHandler(state),
-        onError: ({ error }) => {
-          handleError(error);
+        prepareStep: callbacks == null ? void 0 : callbacks.prepareStep,
+        onStepFinish: this.createStepHandler(state, callbacks == null ? void 0 : callbacks.onStepFinish),
+        onError: (event) => {
+          if (callbacks == null ? void 0 : callbacks.onError) {
+            callbacks.onError(event);
+          }
+          handleError(event.error);
         },
+        onChunk: callbacks == null ? void 0 : callbacks.onChunk,
         onFinish: (event) => {
+          if (callbacks == null ? void 0 : callbacks.onFinish) {
+            callbacks.onFinish(event);
+          }
           try {
             const result = this.consolidateMetricsAndResult(
               startTime,
@@ -62370,6 +62407,7 @@ var V3Context = class _V3Context {
       yield this.conn.enableAutoAttach();
       const targets = yield this.conn.getTargets();
       for (const t2 of targets) {
+        if (t2.attached) continue;
         try {
           yield this.conn.attachToTarget(t2.targetId);
         } catch (e2) {
@@ -64286,6 +64324,9 @@ Do not ask follow up questions, the user will trust your judgement.`
     return {
       execute: (instructionOrOptions) => __async(this, null, function* () {
         return withInstanceLogContext(this.instanceId, () => __async(this, null, function* () {
+          if (typeof instructionOrOptions === "object" && instructionOrOptions.callbacks && !this.experimental) {
+            throw new ExperimentalNotConfiguredError("Agent callbacks");
+          }
           if (isStreaming) {
             if (!this.experimental) {
               throw new ExperimentalNotConfiguredError("Agent streaming");
@@ -64301,7 +64342,9 @@ Do not ask follow up questions, the user will trust your judgement.`
                 return replayed;
               }
             }
-            const streamResult = yield handler2.stream(instructionOrOptions);
+            const streamResult = yield handler2.stream(
+              instructionOrOptions
+            );
             if (cacheContext2) {
               return this.agentCache.wrapStreamForCaching(
                 cacheContext2,
@@ -64339,7 +64382,9 @@ Do not ask follow up questions, the user will trust your judgement.`
                 page.mainFrameId()
               );
             } else {
-              result = yield handler.execute(instructionOrOptions);
+              result = yield handler.execute(
+                instructionOrOptions
+              );
             }
             if (recording) {
               agentSteps = this.endAgentReplayRecording();
@@ -64654,6 +64699,7 @@ I'm providing ${screenshots.length} screenshots showing the progression of the t
   StagehandShadowRootMissingError,
   StagehandShadowSegmentEmptyError,
   StagehandShadowSegmentNotFoundError,
+  StreamingCallbacksInNonStreamingModeError,
   TimeoutError,
   UnsupportedAISDKModelProviderError,
   UnsupportedModelError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand",
-  "version": "3.0.6-alpha-90530b776ae6790751c318ca215c51c0e2f7c79d",
+  "version": "3.0.6-alpha-4e051b23add7ae276b0dbead38b4587838cfc1c1",
   "description": "An AI web browsing framework focused on simplicity and extensibility.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",