fixes

Author: maticzav

.fernignore

@@ -1,4 +1,6 @@
 # Specify files that shouldn't be modified by Fern
 src/wrapper/
 examples/
-.vscode/
+.vscode/
+
+.gitignore

.gitignore

@@ -3,4 +3,5 @@ node_modules
 /dist
 .cursor
 
-.env
+.env*
+!.env.example

README.md

@@ -12,17 +12,19 @@ The BrowserUse TypeScript library provides convenient access to the BrowserUse A
 1. ✌️ Automate the web!
 
 ```ts
-import BrowserUse from "browser-use-sdk";
+import { BrowserUseClient } from "browser-use-sdk";
 
-const client = new BrowserUse({
+const client = new BrowserUseClient({
     apiKey: "bu_...",
 });
 
-const result = await client.tasks.run({
+const task = await client.tasks.createTask({
     task: "Search for the top 10 Hacker News posts and return the title and url.",
 });
 
-console.log(result.doneOutput);
+const result = await task.complete();
+
+console.log(result.output);
 ```
 
 > The full API of this library can be found in [api.md](api.md).
@@ -41,29 +43,27 @@ const TaskOutput = z.object({
     ),
 });
 
-const result = await client.tasks.run({
+const task = await client.tasks.createTask({
     task: "Search for the top 10 Hacker News posts and return the title and url.",
+    schema: TaskOutput,
 });
 
-for (const post of result.parsedOutput.posts) {
+const result = await task.complete();
+
+for (const post of result.parsed.posts) {
     console.log(`${post.title} - ${post.url}`);
 }
 ```
 
 ### Streaming Agent Updates
 
 ```ts
-const task = await browseruse.tasks.create({
+const task = await browseruse.tasks.createTask({
     task: "Search for the top 10 Hacker News posts and return the title and url.",
     schema: TaskOutput,
 });
 
-const stream = browseruse.tasks.stream({
-    taskId: task.id,
-    schema: TaskOutput,
-});
-
-for await (const msg of stream) {
+for await (const msg of task.stream()) {
     switch (msg.status) {
         case "started":
         case "paused":
@@ -74,51 +74,14 @@ for await (const msg of stream) {
         case "finished":
             console.log(`done:`);
 
-            for (const post of msg.parsedOutput.posts) {
+            for (const post of msg.parsed.posts) {
                 console.log(`${post.title} - ${post.url}`);
             }
             break;
     }
 }
 ```
 
-## Webhook Verification
-
-> We encourage you to use the SDK functions that verify and parse webhook events.
-
-```ts
-import { verifyWebhookEventSignature, type WebhookAgentTaskStatusUpdatePayload } from "browser-use-sdk/lib/webhooks";
-
-export async function POST(req: Request) {
-    const signature = req.headers["x-browser-use-signature"] as string;
-    const timestamp = req.headers["x-browser-use-timestamp"] as string;
-
-    const event = await verifyWebhookEventSignature(
-        {
-            body,
-            signature,
-            timestamp,
-        },
-        {
-            secret: SECRET_KEY,
-        },
-    );
-
-    if (!event.ok) {
-        return;
-    }
-
-    switch (event.event.type) {
-        case "agent.task.status_update":
-            break;
-        case "test":
-            break;
-        default:
-            break;
-    }
-}
-```
-
 ## Advanced Usage
 
 ## Handling errors

examples/.env

@@ -11,7 +11,7 @@ env();
 // gets API Key from environment variable BROWSER_USE_API_KEY
 const browseruse = new BrowserUseClient({
     apiKey: process.env.BROWSER_USE_API_KEY!,
-    environment: "production",
+    environment: "https://api.browser-use.com/api/v2",
 });
 
 // Basic ---------------------------------------------------------------------
@@ -22,7 +22,7 @@ async function basic() {
 
     // Create Task
     const rsp = await browseruse.tasks.createTask({
-        task: "What's the weather line in SF and what's the temperature?",
+        task: "What's the weather in SF and what's the temperature?",
         agent: { llm: "gemini-2.5-flash" },
     });
 
@@ -34,14 +34,16 @@ async function basic() {
             case "started":
             case "paused":
             case "stopped":
-                log = `agent ${status.status}`;
+                log = `agent ${status.status} ${status.sessionId} ${status.steps.length} steps`;
 
                 await new Promise((resolve) => setTimeout(resolve, 2000));
                 break;
 
             case "finished":
                 stop();
 
+                console.log(status);
+
                 console.log(status.output);
                 break poll;
         }
@@ -50,15 +52,11 @@ async function basic() {
 
 // Structured ----------------------------------------------------------------
 
-// Define Structured Output Schema
-const HackerNewsResponse = z.object({
-    title: z.string(),
-    url: z.string(),
-    score: z.number(),
-});
-
 const TaskOutput = z.object({
-    posts: z.array(HackerNewsResponse),
+    degreesFahrenheit: z.number(),
+    degreesCelsius: z.number(),
+
+    description: z.string(),
 });
 
 async function structured() {
@@ -67,7 +65,7 @@ async function structured() {
 
     // Create Task
     const rsp = await browseruse.tasks.createTask({
-        task: "Extract top 10 Hacker News posts and return the title, url, and score",
+        task: "What's the weather in SF and what's the temperature?",
         schema: TaskOutput,
         agent: { llm: "gpt-4.1" },
     });
@@ -98,11 +96,14 @@ async function structured() {
                 stop();
 
                 // Print Structured Output
-                console.log("Top Hacker News Posts:");
+                console.log("Weather in SF:");
+                console.log("--------------------------------");
+                console.log(status.parsed.description);
 
-                for (const post of status.parsed.posts) {
-                    console.log(` - ${post.title} (${post.score}) ${post.url}`);
-                }
+                console.log(` - ${status.parsed.degreesFahrenheit} degrees Fahrenheit`);
+                console.log(` - ${status.parsed.degreesCelsius} degrees Celsius`);
+
+                console.log("--------------------------------");
 
                 break poll;
         }

examples/retrieve.ts

@@ -10,7 +10,7 @@ env();
 // gets API Key from environment variable BROWSER_USE_API_KEY
 const browseruse = new BrowserUseClient({
     apiKey: process.env.BROWSER_USE_API_KEY!,
-    environment: "production",
+    environment: "https://api.browser-use.com/api/v2",
 });
 
 // Basic ---------------------------------------------------------------------
@@ -20,7 +20,7 @@ async function basic() {
 
     // Create Task
     const rsp = await browseruse.tasks.createTask({
-        task: "What's the weather line in SF and what's the temperature?",
+        task: "What's the weather in SF and what's the temperature?",
     });
 
     const result = await rsp.complete();

examples/run.ts

@@ -3,39 +3,34 @@
 import z from "zod";
 
 import { BrowserUseClient } from "..";
+
 import { env } from "./utils";
 
 env();
 
+const browseruse = new BrowserUseClient({
+    apiKey: process.env.BROWSER_USE_API_KEY!,
+    environment: "https://api.browser-use.com/api/v2",
+});
+
 // Basic ---------------------------------------------------------------------
 
 async function basic() {
-    // gets API Key from environment variable BROWSER_USE_API_KEY
-    const browseruse = new BrowserUseClient({
-        apiKey: process.env.BROWSER_USE_API_KEY!,
-        environment: "production",
-    });
-
     console.log("Basic: Creating task and starting stream...");
 
     // Create a task and get the stream
     const task = await browseruse.tasks.createTask({
-        task: "What's the weather line in SF and what's the temperature?",
+        task: "What's the weather in SF and what's the temperature?",
         agent: { llm: "gemini-2.5-flash" },
     });
 
-    const gen = task.stream();
-
-    for await (const msg of gen) {
-        console.log(
-            `Basic: ${msg.data.status} ${msg.data.sessionId} ${msg.data.steps[msg.data.steps.length - 1]?.nextGoal}`,
-        );
-
-        if (msg.data.status === "finished") {
-            console.log(`Basic: ${msg.data.output}`);
-        }
+    for await (const msg of task.stream()) {
+        console.log(msg);
     }
 
+    const result = await task.complete();
+    console.log(result);
+
     console.log("\nBasic: Stream completed");
 }
 
@@ -53,12 +48,6 @@ const TaskOutput = z.object({
 });
 
 async function structured() {
-    // gets API Key from environment variable BROWSER_USE_API_KEY
-    const browseruse = new BrowserUseClient({
-        apiKey: process.env.BROWSER_USE_API_KEY!,
-        environment: "production",
-    });
-
     console.log("Structured: Creating task and starting stream...\n");
 
     // Create a task and get the stream
@@ -68,32 +57,13 @@ async function structured() {
         agent: { llm: "gpt-4.1" },
     });
 
-    const stream = task.stream();
-
-    for await (const msg of stream) {
-        // Regular
-        process.stdout.write(`Structured: ${msg.data.status}`);
-        if (msg.data.sessionId) {
-            process.stdout.write(` | Live URL: ${msg.data.sessionId}`);
-        }
-
-        if (msg.data.steps.length > 0) {
-            const latestStep = msg.data.steps[msg.data.steps.length - 1];
-            process.stdout.write(` | ${latestStep!.nextGoal}`);
-        }
-
-        process.stdout.write("\n");
-
-        // Output
-        if (msg.data.status === "finished") {
-            process.stdout.write(`\n\nOUTPUT:`);
-
-            for (const post of msg.data.parsed!.posts) {
-                process.stdout.write(`\n - ${post.title} (${post.score}) ${post.url}`);
-            }
-        }
+    for await (const msg of task.stream()) {
+        console.log(msg);
     }
 
+    const result = await task.complete();
+    console.log(result);
+
     console.log("\nStructured: Stream completed");
 }