@browserbasehq/stagehand 1.0.1 → 1.0.2

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+import { Page, BrowserContext } from '@playwright/test';
+import { z } from 'zod';
+
+interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string | {
+        type: "image_url" | "text";
+        image_url?: {
+            url: string;
+        };
+        text?: string;
+    }[];
+}
+interface ChatCompletionOptions {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    top_p?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    image?: {
+        buffer: Buffer;
+        description?: string;
+    };
+    [key: string]: any;
+    response_model?: {
+        name: string;
+        schema: any;
+    };
+}
+interface LLMClient {
+    createChatCompletion(options: ChatCompletionOptions): Promise<any>;
+    logger: (message: {
+        category?: string;
+        message: string;
+    }) => void;
+}
+
+type AvailableModel = "gpt-4o" | "gpt-4o-mini" | "gpt-4o-2024-08-06" | "claude-3-5-sonnet-latest" | "claude-3-5-sonnet-20241022" | "claude-3-5-sonnet-20240620";
+declare class LLMProvider {
+    private modelToProviderMap;
+    private logger;
+    constructor(logger: (message: {
+        category?: string;
+        message: string;
+    }) => void);
+    getClient(modelName: AvailableModel): LLMClient;
+}
+
+declare class Stagehand {
+    private llmProvider;
+    private observations;
+    private actions;
+    private id;
+    page: Page;
+    context: BrowserContext;
+    private env;
+    private verbose;
+    private debugDom;
+    private defaultModelName;
+    private headless;
+    private logger;
+    private externalLogger?;
+    private domSettleTimeoutMs;
+    constructor({ env, verbose, debugDom, llmProvider, headless, logger, domSettleTimeoutMs, }?: {
+        env: "LOCAL" | "BROWSERBASE";
+        verbose?: 0 | 1 | 2;
+        debugDom?: boolean;
+        llmProvider?: LLMProvider;
+        headless?: boolean;
+        logger?: (message: {
+            category?: string;
+            message: string;
+            level?: 0 | 1 | 2;
+        }) => void;
+        domSettleTimeoutMs?: number;
+    });
+    init({ modelName, }?: {
+        modelName?: AvailableModel;
+    }): Promise<{
+        debugUrl: string;
+        sessionUrl: string;
+    }>;
+    private pending_logs_to_send_to_browserbase;
+    private is_processing_browserbase_logs;
+    log({ message, category, level, }: {
+        category?: string;
+        message: string;
+        level?: 0 | 1 | 2;
+    }): void;
+    private _run_browserbase_log_processing_cycle;
+    private _log_to_browserbase;
+    private _waitForSettledDom;
+    private startDomDebug;
+    private cleanupDomDebug;
+    private _generateId;
+    private _recordObservation;
+    private _recordAction;
+    private _extract;
+    private _observe;
+    private _act;
+    act({ action, modelName, useVision, }: {
+        action: string;
+        modelName?: AvailableModel;
+        useVision?: "fallback" | boolean;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        action: string;
+    }>;
+    extract<T extends z.AnyZodObject>({ instruction, schema, modelName, }: {
+        instruction: string;
+        schema: T;
+        modelName?: AvailableModel;
+    }): Promise<z.infer<T>>;
+    observe(options?: {
+        instruction?: string;
+        modelName?: AvailableModel;
+        useVision?: boolean;
+    }): Promise<{
+        selector: string;
+        description: string;
+    }[]>;
+}
+
+export { Stagehand };

package/dist/index.js

@@ -1082,8 +1082,7 @@ Live debug accessible here: ${debugUrl}.`,
             "--disable-blink-features=AutomationControlled",
             "--disable-web-security"
           ],
-          bypassCSP: true,
-          userDataDir: "./user_data"
+          bypassCSP: true
         }
       );
       logger({

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@browserbasehq/stagehand",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "An AI web browsing framework focused on simplicity and extensibility.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "scripts": {
     "2048": "npm run build-dom-scripts && tsx examples/2048.ts",
     "example": "npm run build-dom-scripts && tsx examples/example.ts",
@@ -13,7 +14,7 @@
     "evals": "npm run build-dom-scripts && npx braintrust eval evals/index.eval.ts",
     "build-dom-scripts": "mkdir -p ./lib/dom/build && mkdir -p ./dist/dom/build && esbuild ./lib/dom/*.ts --bundle --outdir=./dist/dom/build",
     "bundle-dom-scripts": "esbuild ./lib/dom/index.ts --bundle --outfile=./lib/dom/bundle.js --platform=browser --target=es2015 --minify",
-    "build": "npm run build-dom-scripts && tsup lib/index.ts",
+    "build": "npm run build-dom-scripts && tsup lib/index.ts --dts",
     "release": "changeset publish"
   },
   "files": [