@browserbasehq/convex-stagehand 0.0.3 → 0.1.0

package/dist/component/_generated/component.js

@@ -1,6 +1,6 @@
 /* eslint-disable */
 /**
- * Generated component type.
+ * Generated `ComponentApi` utility.
  *
  * THIS CODE IS AUTOMATICALLY GENERATED.
  *

package/dist/component/_generated/dataModel.d.ts

@@ -6,10 +6,41 @@
  * To regenerate, run `npx convex dev`.
  * @module
  */
-import type { DataModelFromSchemaDefinition } from "convex/server";
-import type schema from "../schema.js";
+import type { DataModelFromSchemaDefinition, DocumentByName, TableNamesInDataModel, SystemTableNames } from "convex/server";
+import type { GenericId } from "convex/values";
+import schema from "../schema.js";
+/**
+ * The names of all of your Convex tables.
+ */
+export type TableNames = TableNamesInDataModel<DataModel>;
 /**
  * The type of a document stored in Convex.
+ *
+ * @typeParam TableName - A string literal type of the table name (like "users").
+ */
+export type Doc<TableName extends TableNames> = DocumentByName<DataModel, TableName>;
+/**
+ * An identifier for a document in Convex.
+ *
+ * Convex documents are uniquely identified by their `Id`, which is accessible
+ * on the `_id` field. To learn more, see [Document IDs](https://docs.convex.dev/using/document-ids).
+ *
+ * Documents can be loaded using `db.get(tableName, id)` in query and mutation functions.
+ *
+ * IDs are just strings at runtime, but this type can be used to distinguish them from other
+ * strings when type checking.
+ *
+ * @typeParam TableName - A string literal type of the table name (like "users").
+ */
+export type Id<TableName extends TableNames | SystemTableNames> = GenericId<TableName>;
+/**
+ * A type describing your Convex data model.
+ *
+ * This type includes information about what tables you have, the type of
+ * documents stored in those tables, and the indexes defined on them.
+ *
+ * This type is used to parameterize methods like `queryGeneric` and
+ * `mutationGeneric` to make them type-safe.
  */
 export type DataModel = DataModelFromSchemaDefinition<typeof schema>;
 //# sourceMappingURL=dataModel.d.ts.map

package/dist/component/_generated/dataModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataModel.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/dataModel.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,6BAA6B,CAAC,OAAO,MAAM,CAAC,CAAC"}
+{"version":3,"file":"dataModel.d.ts","sourceRoot":"","sources":["../../../src/component/_generated/dataModel.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,6BAA6B,EAC7B,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,MAAM,MAAM,cAAc,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,GAAG,CAAC,SAAS,SAAS,UAAU,IAAI,cAAc,CAC5D,SAAS,EACT,SAAS,CACV,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,EAAE,CAAC,SAAS,SAAS,UAAU,GAAG,gBAAgB,IAC5D,SAAS,CAAC,SAAS,CAAC,CAAC;AAEvB;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,6BAA6B,CAAC,OAAO,MAAM,CAAC,CAAC"}

package/dist/component/api.d.ts

@@ -2,42 +2,64 @@
  * Stagehand REST API Client
  *
  * Wraps the Stagehand API at https://api.stagehand.browserbase.com
+ * Wire format matches the OpenAPI spec defined in stagehand/packages/core/lib/v3/types/public/api.ts
  */
+export type BrowserbaseRegion = "us-west-2" | "us-east-1" | "eu-central-1" | "ap-southeast-1";
+export interface BrowserbaseSessionCreateParams {
+    region?: BrowserbaseRegion;
+}
+export declare function getApiBase(region?: BrowserbaseRegion): string;
 export interface ApiConfig {
     browserbaseApiKey: string;
     browserbaseProjectId: string;
     modelApiKey: string;
     modelName?: string;
 }
+/** Matches SessionStartResult from the OpenAPI spec */
 export interface SessionData {
     sessionId: string;
-    browserbaseSessionId?: string;
-    cdpUrl?: string;
+    cdpUrl?: string | null;
     available: boolean;
 }
 export interface StartSessionOptions {
-    browserbaseSessionId?: string;
-    browserbaseSessionCreateParams?: Record<string, unknown>;
+    browserbaseSessionID?: string;
+    browserbaseSessionCreateParams?: BrowserbaseSessionCreateParams;
+    model?: unknown;
     domSettleTimeoutMs?: number;
     selfHeal?: boolean;
     systemPrompt?: string;
+    verbose?: 0 | 1 | 2;
+    experimental?: boolean;
 }
 export interface ApiResponse<T> {
     data: T;
     success: boolean;
 }
+/** POST /v1/sessions/start — matches SessionStartRequest schema */
 export declare function startSession(config: ApiConfig, options?: StartSessionOptions): Promise<SessionData>;
-export declare function endSession(sessionId: string, config: ApiConfig): Promise<void>;
+/** POST /v1/sessions/{id}/end */
+export declare function endSession(sessionId: string, config: ApiConfig, region?: BrowserbaseRegion): Promise<void>;
+/** Matches NavigateOptions from the OpenAPI spec */
 export interface NavigateOptions {
     waitUntil?: "load" | "domcontentloaded" | "networkidle";
     timeout?: number;
+    referer?: string;
 }
-export declare function navigate(sessionId: string, url: string, config: ApiConfig, options?: NavigateOptions): Promise<void>;
-export interface ExtractResult<T = any> {
+/** POST /v1/sessions/{id}/navigate — matches NavigateRequest schema */
+export declare function navigate(sessionId: string, url: string, config: ApiConfig, options?: NavigateOptions, region?: BrowserbaseRegion): Promise<void>;
+export interface ExtractResult<T = unknown> {
     result: T;
-    actionId: string;
+    actionId?: string;
+}
+/** Matches ExtractOptions from the OpenAPI spec */
+export interface ExtractOperationOptions {
+    model?: unknown;
+    timeout?: number;
+    selector?: string;
 }
-export declare function extract(sessionId: string, instruction: string, schema: any, config: ApiConfig): Promise<ExtractResult>;
+/** POST /v1/sessions/{id}/extract — matches ExtractRequest schema */
+export declare function extract(sessionId: string, instruction: string, schema: unknown, config: ApiConfig, operationOptions?: ExtractOperationOptions, region?: BrowserbaseRegion): Promise<ExtractResult>;
+/** Matches ActResultData from the OpenAPI spec */
 export interface ActResult {
     result: {
         actionDescription: string;
@@ -45,47 +67,86 @@ export interface ActResult {
             description: string;
             selector: string;
             arguments?: string[];
-            method: string;
+            method?: string;
+            backendNodeId?: number;
         }>;
         message: string;
         success: boolean;
     };
-    actionId: string;
+    actionId?: string;
+}
+/** Matches ActOptions from the OpenAPI spec */
+export interface ActOperationOptions {
+    model?: unknown;
+    variables?: Record<string, string>;
+    timeout?: number;
 }
-export declare function act(sessionId: string, action: string, config: ApiConfig): Promise<ActResult>;
+/** POST /v1/sessions/{id}/act — matches ActRequest schema */
+export declare function act(sessionId: string, action: string, config: ApiConfig, operationOptions?: ActOperationOptions, region?: BrowserbaseRegion): Promise<ActResult>;
+/** Matches ObserveResult from the OpenAPI spec (Action schema) */
 export interface ObserveResult {
     result: Array<{
         description: string;
         selector: string;
         arguments?: string[];
         backendNodeId?: number;
-        method: string;
+        method?: string;
     }>;
-    actionId: string;
+    actionId?: string;
+}
+/** Matches ObserveOptions from the OpenAPI spec */
+export interface ObserveOperationOptions {
+    model?: unknown;
+    timeout?: number;
+    selector?: string;
 }
-export declare function observe(sessionId: string, instruction: string, config: ApiConfig): Promise<ObserveResult>;
+/** POST /v1/sessions/{id}/observe — matches ObserveRequest schema */
+export declare function observe(sessionId: string, instruction: string, config: ApiConfig, operationOptions?: ObserveOperationOptions, region?: BrowserbaseRegion): Promise<ObserveResult>;
+/** Matches AgentConfig from the OpenAPI spec */
 export interface AgentConfig {
     cua?: boolean;
-    model?: string;
+    mode?: "dom" | "hybrid" | "cua";
+    model?: unknown;
     systemPrompt?: string;
+    executionModel?: unknown;
+    provider?: "openai" | "anthropic" | "google" | "microsoft";
 }
+/** Matches AgentExecuteOptions from the OpenAPI spec */
 export interface AgentExecuteOptions {
     instruction: string;
     maxSteps?: number;
+    highlightCursor?: boolean;
 }
+/** Matches AgentAction from the OpenAPI spec */
 export interface AgentAction {
     type: string;
     action?: string;
     reasoning?: string;
     timeMs?: number;
+    taskCompleted?: boolean;
+    pageText?: string;
+    pageUrl?: string;
+    instruction?: string;
+}
+/** Matches AgentUsage from the OpenAPI spec */
+export interface AgentUsage {
+    input_tokens: number;
+    output_tokens: number;
+    reasoning_tokens?: number;
+    cached_input_tokens?: number;
+    inference_time_ms: number;
 }
+/** Matches AgentExecuteResult from the OpenAPI spec */
 export interface AgentExecuteResult {
     result: {
         actions: AgentAction[];
         completed: boolean;
         message: string;
         success: boolean;
+        metadata?: Record<string, unknown>;
+        usage?: AgentUsage;
     };
 }
-export declare function agentExecute(sessionId: string, agentConfig: AgentConfig, executeOptions: AgentExecuteOptions, config: ApiConfig): Promise<AgentExecuteResult>;
+/** POST /v1/sessions/{id}/agentExecute — matches AgentExecuteRequest schema */
+export declare function agentExecute(sessionId: string, agentConfig: AgentConfig, executeOptions: AgentExecuteOptions, config: ApiConfig, shouldCache?: boolean, region?: BrowserbaseRegion): Promise<AgentExecuteResult>;
 //# sourceMappingURL=api.d.ts.map

package/dist/component/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/component/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/component/api.ts"],"names":[],"mappings":"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"}

package/dist/component/api.js

@@ -2,8 +2,20 @@
  * Stagehand REST API Client
  *
  * Wraps the Stagehand API at https://api.stagehand.browserbase.com
+ * Wire format matches the OpenAPI spec defined in stagehand/packages/core/lib/v3/types/public/api.ts
  */
-const API_BASE = "https://api.stagehand.browserbase.com/v1";
+/** Multi-region API URL mapping (matches official SDK) */
+const REGION_API_URLS = {
+    "us-west-2": "https://api.stagehand.browserbase.com",
+    "us-east-1": "https://api.use1.stagehand.browserbase.com",
+    "eu-central-1": "https://api.euc1.stagehand.browserbase.com",
+    "ap-southeast-1": "https://api.apse1.stagehand.browserbase.com",
+};
+export function getApiBase(region) {
+    const baseUrl = (region && REGION_API_URLS[region]) ||
+        REGION_API_URLS["us-west-2"];
+    return `${baseUrl}/v1`;
+}
 function getHeaders(config) {
     return {
         "Content-Type": "application/json",
@@ -23,34 +35,47 @@ async function handleResponse(response) {
     }
     return json.data;
 }
+/** POST /v1/sessions/start — matches SessionStartRequest schema */
 export async function startSession(config, options) {
-    const response = await fetch(`${API_BASE}/sessions/start`, {
+    const region = options?.browserbaseSessionCreateParams?.region;
+    const response = await fetch(`${getApiBase(region)}/sessions/start`, {
         method: "POST",
         headers: getHeaders(config),
         body: JSON.stringify({
             modelName: config.modelName || "openai/gpt-4o",
-            browserbaseSessionId: options?.browserbaseSessionId,
+            model: options?.model,
+            browserbaseSessionID: options?.browserbaseSessionID,
             browserbaseSessionCreateParams: options?.browserbaseSessionCreateParams,
             domSettleTimeoutMs: options?.domSettleTimeoutMs,
             selfHeal: options?.selfHeal,
             systemPrompt: options?.systemPrompt,
+            verbose: options?.verbose,
+            experimental: options?.experimental,
         }),
     });
     return handleResponse(response);
 }
-export async function endSession(sessionId, config) {
-    try {
-        await fetch(`${API_BASE}/sessions/${sessionId}/end`, {
-            method: "POST",
-            headers: getHeaders(config),
-        });
+/** POST /v1/sessions/{id}/end */
+export async function endSession(sessionId, config, region) {
+    const response = await fetch(`${getApiBase(region)}/sessions/${sessionId}/end`, {
+        method: "POST",
+        headers: getHeaders(config),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Stagehand API error (${response.status}): ${errorText}`);
     }
-    catch {
-        // Ignore errors when ending session - best effort cleanup
+    const text = await response.text();
+    if (text) {
+        const json = JSON.parse(text);
+        if (json.success === false) {
+            throw new Error("Stagehand API returned success: false");
+        }
     }
 }
-export async function navigate(sessionId, url, config, options) {
-    const response = await fetch(`${API_BASE}/sessions/${sessionId}/navigate`, {
+/** POST /v1/sessions/{id}/navigate — matches NavigateRequest schema */
+export async function navigate(sessionId, url, config, options, region) {
+    const response = await fetch(`${getApiBase(region)}/sessions/${sessionId}/navigate`, {
         method: "POST",
         headers: getHeaders(config),
         body: JSON.stringify({
@@ -58,54 +83,89 @@ export async function navigate(sessionId, url, config, options) {
             options: {
                 waitUntil: options?.waitUntil || "networkidle",
                 timeout: options?.timeout,
+                referer: options?.referer,
             },
         }),
     });
     await handleResponse(response);
 }
-export async function extract(sessionId, instruction, schema, config) {
-    const response = await fetch(`${API_BASE}/sessions/${sessionId}/extract`, {
+/** POST /v1/sessions/{id}/extract — matches ExtractRequest schema */
+export async function extract(sessionId, instruction, schema, config, operationOptions, region) {
+    const body = { instruction, schema };
+    if (operationOptions?.model != null ||
+        operationOptions?.timeout != null ||
+        operationOptions?.selector != null) {
+        body.options = {
+            model: operationOptions?.model,
+            timeout: operationOptions?.timeout,
+            selector: operationOptions?.selector,
+        };
+    }
+    const response = await fetch(`${getApiBase(region)}/sessions/${sessionId}/extract`, {
         method: "POST",
         headers: getHeaders(config),
-        body: JSON.stringify({
-            instruction,
-            schema,
-        }),
+        body: JSON.stringify(body),
     });
     return handleResponse(response);
 }
-export async function act(sessionId, action, config) {
-    const response = await fetch(`${API_BASE}/sessions/${sessionId}/act`, {
+/** POST /v1/sessions/{id}/act — matches ActRequest schema */
+export async function act(sessionId, action, config, operationOptions, region) {
+    const body = { input: action };
+    if (operationOptions?.model != null ||
+        operationOptions?.variables != null ||
+        operationOptions?.timeout != null) {
+        body.options = {
+            model: operationOptions?.model,
+            variables: operationOptions?.variables,
+            timeout: operationOptions?.timeout,
+        };
+    }
+    const response = await fetch(`${getApiBase(region)}/sessions/${sessionId}/act`, {
         method: "POST",
         headers: getHeaders(config),
-        body: JSON.stringify({
-            input: action,
-        }),
+        body: JSON.stringify(body),
     });
     return handleResponse(response);
 }
-export async function observe(sessionId, instruction, config) {
-    const response = await fetch(`${API_BASE}/sessions/${sessionId}/observe`, {
+/** POST /v1/sessions/{id}/observe — matches ObserveRequest schema */
+export async function observe(sessionId, instruction, config, operationOptions, region) {
+    const body = { instruction };
+    if (operationOptions?.model != null ||
+        operationOptions?.timeout != null ||
+        operationOptions?.selector != null) {
+        body.options = {
+            model: operationOptions?.model,
+            timeout: operationOptions?.timeout,
+            selector: operationOptions?.selector,
+        };
+    }
+    const response = await fetch(`${getApiBase(region)}/sessions/${sessionId}/observe`, {
         method: "POST",
         headers: getHeaders(config),
-        body: JSON.stringify({
-            instruction,
-        }),
+        body: JSON.stringify(body),
     });
     return handleResponse(response);
 }
-export async function agentExecute(sessionId, agentConfig, executeOptions, config) {
-    const response = await fetch(`${API_BASE}/sessions/${sessionId}/agentExecute`, {
+/** POST /v1/sessions/{id}/agentExecute — matches AgentExecuteRequest schema */
+export async function agentExecute(sessionId, agentConfig, executeOptions, config, shouldCache, region) {
+    const response = await fetch(`${getApiBase(region)}/sessions/${sessionId}/agentExecute`, {
         method: "POST",
         headers: getHeaders(config),
         body: JSON.stringify({
             agentConfig: {
                 cua: agentConfig.cua,
+                mode: agentConfig.mode,
                 model: agentConfig.model,
                 systemPrompt: agentConfig.systemPrompt,
+                executionModel: agentConfig.executionModel,
+                provider: agentConfig.provider,
+            },
+            executeOptions: {
+                instruction: executeOptions.instruction,
+                maxSteps: executeOptions.maxSteps,
+                highlightCursor: executeOptions.highlightCursor,
             },
-            instruction: executeOptions.instruction,
-            maxSteps: executeOptions.maxSteps,
+            shouldCache,
         }),
     });
     return handleResponse(response);

package/dist/component/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/component/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/component/api.ts"],"names":[],"mappings":"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"}

package/dist/component/lib.d.ts

@@ -4,14 +4,14 @@
  * AI-powered browser automation actions using the Stagehand REST API.
  * Supports both automatic session management and manual session control.
  */
-import * as api from "./api.js";
+export declare const upsertSessionMetadata: import("convex/server").RegisteredMutation<"internal", any, Promise<null>>;
+export declare const getSessionRegion: import("convex/server").RegisteredQuery<"internal", any, Promise<any>>;
 /**
  * Start a new browser session.
  * Returns session info including cdpUrl for direct Playwright/Puppeteer connection.
  */
 export declare const startSession: import("convex/server").RegisteredAction<"public", any, Promise<{
     sessionId: string;
-    browserbaseSessionId: string | undefined;
     cdpUrl: string | undefined;
 }>>;
 /**
@@ -25,7 +25,7 @@ export declare const endSession: import("convex/server").RegisteredAction<"publi
  * If sessionId is provided, uses existing session (doesn't end it).
  * Otherwise, handles full session lifecycle: start -> navigate -> extract -> end
  */
-export declare const extract: import("convex/server").RegisteredAction<"public", any, Promise<any>>;
+export declare const extract: import("convex/server").RegisteredAction<"public", any, Promise<unknown>>;
 /**
  * Execute browser actions using natural language instructions.
  * If sessionId is provided, uses existing session (doesn't end it).
@@ -44,8 +44,9 @@ export declare const act: import("convex/server").RegisteredAction<"public", any
 export declare const observe: import("convex/server").RegisteredAction<"public", any, Promise<{
     description: string;
     selector: string;
-    method: string;
+    method: string | undefined;
     arguments: string[] | undefined;
+    backendNodeId: number | undefined;
 }[]>>;
 /**
  * Execute autonomous multi-step browser automation using an AI agent.
@@ -54,9 +55,26 @@ export declare const observe: import("convex/server").RegisteredAction<"public",
  * Otherwise, handles full session lifecycle.
  */
 export declare const agent: import("convex/server").RegisteredAction<"public", any, Promise<{
-    actions: api.AgentAction[];
+    actions: {
+        type: any;
+        action: any;
+        reasoning: any;
+        timeMs: any;
+        taskCompleted: any;
+        pageText: any;
+        pageUrl: any;
+        instruction: any;
+    }[];
     completed: boolean;
     message: string;
     success: boolean;
+    metadata: Record<string, unknown> | undefined;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+        reasoning_tokens: number | undefined;
+        cached_input_tokens: number | undefined;
+        inference_time_ms: number;
+    } | undefined;
 }>>;
 //# sourceMappingURL=lib.d.ts.map

package/dist/component/lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAsBhC;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;GAwDvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;GAkBrB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,OAAO,uEAoElB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,GAAG;;;;GAsEd,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;;KAmElB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,KAAK;;;;;GAiFhB,CAAC"}
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2HH,eAAO,MAAM,qBAAqB,4EAyChC,CAAC;AAEH,eAAO,MAAM,gBAAgB,wEAY3B,CAAC;AAoGH;;;GAGG;AACH,eAAO,MAAM,YAAY;;;GA0FvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU;;GAuBrB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,OAAO,2EAgIlB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,GAAG;;;;GAsId,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,OAAO;;;;;;KAoIlB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;GAuLhB,CAAC"}