browser-use-sdk 3.3.1 → 3.4.0

package/README.md

@@ -1,213 +1,32 @@
 # browser-use-sdk
 
-Official TypeScript SDK for the [Browser Use](https://browser-use.com) API -- run AI-powered browser agents in the cloud.
+Official TypeScript SDK for [Browser Use Cloud](https://browser-use.com).
 
-## Installation
+## Install
 
 ```bash
 npm install browser-use-sdk
-# or
-pnpm add browser-use-sdk
-# or
-yarn add browser-use-sdk
-# or
-bun add browser-use-sdk
 ```
 
-## Quick Start (v2)
+## Quick Start
 
-The default import exposes the **v2** API client.
+Get your API key at [cloud.browser-use.com/settings](https://cloud.browser-use.com/settings?tab=api-keys&new=1).
 
-```ts
-import { BrowserUse } from "browser-use-sdk";
-
-const client = new BrowserUse();
-
-const result = await client.run("Find the top post on Hacker News");
-console.log(result.output);
-console.log(result.id, result.status);
+```bash
+export BROWSER_USE_API_KEY=your_key
 ```
 
-## V3 (Experimental)
-
-The v3 API uses a unified session model. Import from `browser-use-sdk/v3`:
-
-```ts
-import { BrowserUse } from "browser-use-sdk/v3";
+```typescript
+import { BrowserUse } from "browser-use-sdk";
 
 const client = new BrowserUse();
-
-const output = await client.run("Find the top post on HN");
-console.log(output);
-```
-
-## Client Options
-
-```ts
-const client = new BrowserUse({
-  apiKey: "bu_...",           // Or set BROWSER_USE_API_KEY env var
-  baseUrl: "https://...",     // Override API base URL
-  maxRetries: 3,              // Retry on 429 (default: 3)
-  timeout: 30_000,            // Request timeout in ms (default: 30s)
-});
-```
-
-## Structured Output
-
-Pass a Zod schema to get typed results:
-
-```ts
-import { z } from "zod";
-
-const Product = z.object({ name: z.string(), price: z.number() });
-
-const result = await client.run("Find the price of the MacBook Air", { schema: Product });
-console.log(`${result.output.name}: $${result.output.price}`);
-```
-
-## Polling and Streaming
-
-`client.run()` returns a dual-purpose handle: `await` it for the output, or `for await...of` it for step-by-step progress.
-
-### Wait for Result
-
-```ts
-const result = await client.run("Search for AI news");
-console.log(result.output, result.id, result.status);
-```
-
-### Stream Steps
-
-```ts
-for await (const step of client.run("Search for AI news")) {
-  console.log(`[${step.number}] ${step.nextGoal} — ${step.url}`);
-}
-```
-
-## V2 API Reference
-
-### Billing
-
-| Method                | Description                          |
-|-----------------------|--------------------------------------|
-| `billing.account()`  | Get account info and credit balance  |
-
-### Tasks
-
-| Method                       | Description                             |
-|------------------------------|-----------------------------------------|
-| `tasks.create(body)`        | Create and start a new task             |
-| `tasks.list(params?)`       | List tasks with optional filtering      |
-| `tasks.get(taskId)`         | Get detailed task information           |
-| `tasks.stop(taskId)`        | Stop a running task                     |
-| `tasks.status(taskId)`      | Lightweight status for polling          |
-| `tasks.wait(taskId, opts?)` | Poll until terminal, return TaskView    |
-| `tasks.logs(taskId)`        | Get download URL for task logs          |
-
-### Sessions
-
-| Method                             | Description                          |
-|------------------------------------|--------------------------------------|
-| `sessions.create(body?)`          | Create a new session                 |
-| `sessions.list(params?)`          | List sessions                        |
-| `sessions.get(sessionId)`         | Get session details                  |
-| `sessions.stop(sessionId)`        | Stop session and running tasks       |
-| `sessions.delete(sessionId)`      | Delete session and all tasks         |
-| `sessions.getShare(sessionId)`    | Get public share info                |
-| `sessions.createShare(sessionId)` | Create public share link             |
-| `sessions.deleteShare(sessionId)` | Remove public share                  |
-
-### Files
-
-| Method                                  | Description                            |
-|-----------------------------------------|----------------------------------------|
-| `files.sessionUrl(sessionId, body)`    | Presigned URL for session file upload  |
-| `files.browserUrl(sessionId, body)`    | Presigned URL for browser file upload  |
-| `files.taskOutput(taskId, fileId)`     | Download URL for task output file      |
-
-### Profiles
-
-| Method                            | Description                  |
-|-----------------------------------|------------------------------|
-| `profiles.create(body?)`         | Create a browser profile     |
-| `profiles.list(params?)`         | List profiles                |
-| `profiles.get(profileId)`        | Get profile details          |
-| `profiles.update(profileId, body)` | Update a profile           |
-| `profiles.delete(profileId)`     | Delete a profile             |
-
-### Browsers
-
-| Method                        | Description                        |
-|-------------------------------|------------------------------------|
-| `browsers.create(body)`      | Create a browser session           |
-| `browsers.list(params?)`     | List browser sessions              |
-| `browsers.get(sessionId)`    | Get browser session details        |
-| `browsers.stop(sessionId)`   | Stop a browser session             |
-
-### Skills
-
-| Method                                         | Description                          |
-|------------------------------------------------|--------------------------------------|
-| `skills.create(body)`                         | Create a skill via generation        |
-| `skills.list(params?)`                        | List skills                          |
-| `skills.get(skillId)`                         | Get skill details                    |
-| `skills.delete(skillId)`                      | Delete a skill                       |
-| `skills.update(skillId, body)`                | Update skill metadata                |
-| `skills.cancel(skillId)`                      | Cancel in-progress generation        |
-| `skills.execute(skillId, body)`               | Execute a skill                      |
-| `skills.refine(skillId, body)`                | Refine a skill with feedback         |
-| `skills.rollback(skillId)`                    | Rollback to previous version         |
-| `skills.executions(skillId, params?)`         | List skill executions                |
-| `skills.executionOutput(skillId, executionId)` | Download execution output           |
-
-### Marketplace
-
-| Method                              | Description                         |
-|-------------------------------------|-------------------------------------|
-| `marketplace.list(params?)`        | List public marketplace skills      |
-| `marketplace.get(skillSlug)`       | Get marketplace skill by slug       |
-| `marketplace.clone(skillId)`       | Clone a marketplace skill           |
-| `marketplace.execute(skillId, body)` | Execute a marketplace skill       |
-
-## V3 API Reference
-
-### Sessions
-
-| Method                               | Description                          |
-|--------------------------------------|--------------------------------------|
-| `sessions.create(body)`             | Create session and run a task        |
-| `sessions.list(params?)`            | List sessions                        |
-| `sessions.get(sessionId)`           | Get session details                  |
-| `sessions.stop(sessionId)`          | Stop a session                       |
-| `sessions.files(sessionId, params?)` | List files in session workspace     |
-
-## Error Handling
-
-All API errors throw `BrowserUseError`:
-
-```ts
-import { BrowserUse, BrowserUseError } from "browser-use-sdk";
-
-try {
-  await client.tasks.get("nonexistent-id");
-} catch (err) {
-  if (err instanceof BrowserUseError) {
-    console.error(err.statusCode); // 404
-    console.error(err.message);    // "Task not found"
-    console.error(err.detail);     // Raw error body
-  }
-}
+const result = await client.run("Find the top 3 trending repos on GitHub today");
+console.log(result.output);
 ```
 
-The client automatically retries on `429` (rate limit) with exponential backoff.
+## Docs
 
-## TypeScript
-
-Types are re-exported from `browser-use-sdk` and `browser-use-sdk/v3`. The SDK ships with full type definitions for all request/response shapes.
-
-```ts
-import type { TaskView, CreateTaskRequest } from "browser-use-sdk";
-```
+[docs.browser-use.com](https://docs.browser-use.com)
 
 ## License
 

package/dist/{chunk-I75IFZAL.js → chunk-6TSB5AIP.js}

@@ -68,9 +68,8 @@ var HttpClient = class {
           errorBody = await response.json();
         } catch {
         }
-        const message = typeof errorBody === "object" && errorBody !== null ? String(
-          "message" in errorBody ? errorBody.message : "detail" in errorBody ? errorBody.detail : `HTTP ${response.status}`
-        ) : `HTTP ${response.status}`;
+        const raw = typeof errorBody === "object" && errorBody !== null ? "message" in errorBody ? errorBody.message : "detail" in errorBody ? errorBody.detail : void 0 : void 0;
+        const message = raw === void 0 ? `HTTP ${response.status}` : typeof raw === "string" ? raw : JSON.stringify(raw);
         throw new BrowserUseError(response.status, message, errorBody);
       } catch (error) {
         clearTimeout(timeoutId);
@@ -97,4 +96,4 @@ export {
   BrowserUseError,
   HttpClient
 };
-//# sourceMappingURL=chunk-I75IFZAL.js.map
+//# sourceMappingURL=chunk-6TSB5AIP.js.map

package/dist/chunk-6TSB5AIP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/errors.ts","../src/core/http.ts"],"sourcesContent":["export class BrowserUseError extends Error {\n  readonly statusCode: number;\n  readonly detail: unknown;\n\n  constructor(statusCode: number, message: string, detail?: unknown) {\n    super(message);\n    this.name = \"BrowserUseError\";\n    this.statusCode = statusCode;\n    this.detail = detail;\n  }\n}\n","import { BrowserUseError } from \"./errors.js\";\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly maxRetries: number;\n  private readonly timeout: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.maxRetries = options.maxRetries ?? 3;\n    this.timeout = options.timeout ?? 30_000;\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    options?: {\n      body?: unknown;\n      query?: Record<string, unknown>;\n      signal?: AbortSignal;\n    },\n  ): Promise<T> {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (options?.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n\n    const headers: Record<string, string> = {\n      \"X-Browser-Use-API-Key\": this.apiKey,\n    };\n    if (options?.body !== undefined) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (attempt > 0) {\n        const delay = Math.min(1000 * 2 ** (attempt - 1), 10_000);\n        await new Promise((resolve) => setTimeout(resolve, delay));\n      }\n\n      const controller = new AbortController();\n      const timeoutId = options?.signal\n        ? undefined\n        : setTimeout(() => controller.abort(), this.timeout);\n\n      // Combine user signal with internal timeout when both are present\n      const signal = options?.signal ?? controller.signal;\n\n      try {\n        const response = await fetch(url.toString(), {\n          method,\n          headers,\n          body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,\n          signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (response.ok) {\n          if (response.status === 204) {\n            return undefined as T;\n          }\n          return (await response.json()) as T;\n        }\n\n        const shouldRetry =\n          response.status === 429 &&\n          attempt < this.maxRetries;\n\n        if (shouldRetry) {\n          continue;\n        }\n\n        let errorBody: unknown;\n        try {\n          errorBody = await response.json();\n        } catch {\n          /* ignore parse errors */\n        }\n        const raw =\n          typeof errorBody === \"object\" && errorBody !== null\n            ? \"message\" in errorBody\n              ? (errorBody as Record<string, unknown>).message\n              : \"detail\" in errorBody\n                ? (errorBody as Record<string, unknown>).detail\n                : undefined\n            : undefined;\n        const message =\n          raw === undefined\n            ? `HTTP ${response.status}`\n            : typeof raw === \"string\"\n              ? raw\n              : JSON.stringify(raw);\n        throw new BrowserUseError(response.status, message, errorBody);\n      } catch (error) {\n        clearTimeout(timeoutId);\n        throw error;\n      }\n    }\n\n    throw new Error(\"Unreachable: retry loop exhausted\");\n  }\n\n  get<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"GET\", path, { query });\n  }\n\n  post<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"POST\", path, { body, query });\n  }\n\n  patch<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"PATCH\", path, { body, query });\n  }\n\n  delete<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"DELETE\", path, { query });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-RIRVOEIU.cjs → chunk-JT4IL3IZ.cjs}

@@ -68,9 +68,8 @@ var HttpClient = class {
           errorBody = await response.json();
         } catch (e) {
         }
-        const message = typeof errorBody === "object" && errorBody !== null ? String(
-          "message" in errorBody ? errorBody.message : "detail" in errorBody ? errorBody.detail : `HTTP ${response.status}`
-        ) : `HTTP ${response.status}`;
+        const raw = typeof errorBody === "object" && errorBody !== null ? "message" in errorBody ? errorBody.message : "detail" in errorBody ? errorBody.detail : void 0 : void 0;
+        const message = raw === void 0 ? `HTTP ${response.status}` : typeof raw === "string" ? raw : JSON.stringify(raw);
         throw new BrowserUseError(response.status, message, errorBody);
       } catch (error) {
         clearTimeout(timeoutId);
@@ -97,4 +96,4 @@ var HttpClient = class {
 
 
 exports.BrowserUseError = BrowserUseError; exports.HttpClient = HttpClient;
-//# sourceMappingURL=chunk-RIRVOEIU.cjs.map
+//# sourceMappingURL=chunk-JT4IL3IZ.cjs.map

package/dist/chunk-JT4IL3IZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/sauravpanda/Github/LLMs/Browser-Use/sdk/browser-use-node/dist/chunk-JT4IL3IZ.cjs","../src/core/errors.ts","../src/core/http.ts"],"names":[],"mappings":"AAAA;ACAO,IAAM,gBAAA,EAAN,MAAA,QAA8B,MAAM;AAAA,EAChC;AAAA,EACA;AAAA,EAET,WAAA,CAAY,UAAA,EAAoB,OAAA,EAAiB,MAAA,EAAkB;AACjE,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,KAAA,EAAO,iBAAA;AACZ,IAAA,IAAA,CAAK,WAAA,EAAa,UAAA;AAClB,IAAA,IAAA,CAAK,OAAA,EAAS,MAAA;AAAA,EAChB;AACF,CAAA;ADCA;AACA;AEHO,IAAM,WAAA,EAAN,MAAiB;AAAA,EACL;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,WAAA,CAAY,OAAA,EAA4B;AACtC,IAAA,IAAA,CAAK,OAAA,EAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,QAAA,EAAU,OAAA,CAAQ,OAAA,CAAQ,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA;AACjD,IAAA,IAAA,CAAK,WAAA,mBAAa,OAAA,CAAQ,UAAA,UAAc,GAAA;AACxC,IAAA,IAAA,CAAK,QAAA,mBAAU,OAAA,CAAQ,OAAA,UAAW,KAAA;AAAA,EACpC;AAAA,EAEA,MAAM,OAAA,CACJ,MAAA,EACA,IAAA,EACA,OAAA,EAKY;AACZ,IAAA,MAAM,IAAA,EAAM,IAAI,GAAA,CAAI,CAAA,EAAA;AACA,IAAA;AACD,MAAA;AACD,QAAA;AACR,UAAA;AACN,QAAA;AACF,MAAA;AACF,IAAA;AAEwC,IAAA;AACtC,MAAA;AACF,IAAA;AACa,IAAA;AACH,MAAA;AACV,IAAA;AAEmB,IAAA;AACA,MAAA;AACD,QAAA;AACJ,QAAA;AACZ,MAAA;AAEmB,MAAA;AACD,MAAA;AAKH,MAAA;AAEX,MAAA;AACe,QAAA;AACf,UAAA;AACA,UAAA;AACe,UAAA;AACf,UAAA;AACD,QAAA;AAEY,QAAA;AAEI,QAAA;AACF,UAAA;AACJ,YAAA;AACT,UAAA;AACc,UAAA;AAChB,QAAA;AAEM,QAAA;AAIW,QAAA;AACf,UAAA;AACF,QAAA;AAEI,QAAA;AACA,QAAA;AACU,UAAA;AACN,QAAA;AAER,QAAA;AAEE,QAAA;AAQA,QAAA;AAKQ,QAAA;AACI,MAAA;AACD,QAAA;AACP,QAAA;AACR,MAAA;AACF,IAAA;AAEgB,IAAA;AAClB,EAAA;AAEkE,EAAA;AACzC,IAAA;AACzB,EAAA;AAEsC,EAAA;AACb,IAAA;AACzB,EAAA;AAEuC,EAAA;AACd,IAAA;AACzB,EAAA;AAEqE,EAAA;AAC5C,IAAA;AACzB,EAAA;AACF;AFtCyB;AACA;AACA;AACA;AACA","file":"/Users/sauravpanda/Github/LLMs/Browser-Use/sdk/browser-use-node/dist/chunk-JT4IL3IZ.cjs","sourcesContent":[null,"export class BrowserUseError extends Error {\n  readonly statusCode: number;\n  readonly detail: unknown;\n\n  constructor(statusCode: number, message: string, detail?: unknown) {\n    super(message);\n    this.name = \"BrowserUseError\";\n    this.statusCode = statusCode;\n    this.detail = detail;\n  }\n}\n","import { BrowserUseError } from \"./errors.js\";\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  maxRetries?: number;\n  timeout?: number;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly maxRetries: number;\n  private readonly timeout: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.maxRetries = options.maxRetries ?? 3;\n    this.timeout = options.timeout ?? 30_000;\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    options?: {\n      body?: unknown;\n      query?: Record<string, unknown>;\n      signal?: AbortSignal;\n    },\n  ): Promise<T> {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (options?.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined && value !== null) {\n          url.searchParams.set(key, String(value));\n        }\n      }\n    }\n\n    const headers: Record<string, string> = {\n      \"X-Browser-Use-API-Key\": this.apiKey,\n    };\n    if (options?.body !== undefined) {\n      headers[\"Content-Type\"] = \"application/json\";\n    }\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (attempt > 0) {\n        const delay = Math.min(1000 * 2 ** (attempt - 1), 10_000);\n        await new Promise((resolve) => setTimeout(resolve, delay));\n      }\n\n      const controller = new AbortController();\n      const timeoutId = options?.signal\n        ? undefined\n        : setTimeout(() => controller.abort(), this.timeout);\n\n      // Combine user signal with internal timeout when both are present\n      const signal = options?.signal ?? controller.signal;\n\n      try {\n        const response = await fetch(url.toString(), {\n          method,\n          headers,\n          body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,\n          signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (response.ok) {\n          if (response.status === 204) {\n            return undefined as T;\n          }\n          return (await response.json()) as T;\n        }\n\n        const shouldRetry =\n          response.status === 429 &&\n          attempt < this.maxRetries;\n\n        if (shouldRetry) {\n          continue;\n        }\n\n        let errorBody: unknown;\n        try {\n          errorBody = await response.json();\n        } catch {\n          /* ignore parse errors */\n        }\n        const raw =\n          typeof errorBody === \"object\" && errorBody !== null\n            ? \"message\" in errorBody\n              ? (errorBody as Record<string, unknown>).message\n              : \"detail\" in errorBody\n                ? (errorBody as Record<string, unknown>).detail\n                : undefined\n            : undefined;\n        const message =\n          raw === undefined\n            ? `HTTP ${response.status}`\n            : typeof raw === \"string\"\n              ? raw\n              : JSON.stringify(raw);\n        throw new BrowserUseError(response.status, message, errorBody);\n      } catch (error) {\n        clearTimeout(timeoutId);\n        throw error;\n      }\n    }\n\n    throw new Error(\"Unreachable: retry loop exhausted\");\n  }\n\n  get<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"GET\", path, { query });\n  }\n\n  post<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"POST\", path, { body, query });\n  }\n\n  patch<T>(path: string, body?: unknown, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"PATCH\", path, { body, query });\n  }\n\n  delete<T>(path: string, query?: Record<string, unknown>): Promise<T> {\n    return this.request<T>(\"DELETE\", path, { query });\n  }\n}\n"]}

package/dist/index.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class;
 
 
-var _chunkRIRVOEIUcjs = require('./chunk-RIRVOEIU.cjs');
+var _chunkJT4IL3IZcjs = require('./chunk-JT4IL3IZ.cjs');
 
 // src/v2/client.ts
 var _zod = require('zod');
@@ -391,7 +391,7 @@ var BrowserUse = class {
         "No API key provided. Pass apiKey or set BROWSER_USE_API_KEY."
       );
     }
-    this.http = new (0, _chunkRIRVOEIUcjs.HttpClient)({
+    this.http = new (0, _chunkJT4IL3IZcjs.HttpClient)({
       apiKey,
       baseUrl: _nullishCoalesce(options.baseUrl, () => ( DEFAULT_BASE_URL)),
       maxRetries: options.maxRetries,
@@ -428,5 +428,5 @@ var BrowserUse = class {
 
 
 
-exports.Billing = Billing; exports.BrowserUse = BrowserUse; exports.BrowserUseError = _chunkRIRVOEIUcjs.BrowserUseError; exports.Browsers = Browsers; exports.Files = Files; exports.Marketplace = Marketplace; exports.Profiles = Profiles; exports.Sessions = Sessions; exports.Skills = Skills; exports.TaskRun = TaskRun; exports.Tasks = Tasks;
+exports.Billing = Billing; exports.BrowserUse = BrowserUse; exports.BrowserUseError = _chunkJT4IL3IZcjs.BrowserUseError; exports.Browsers = Browsers; exports.Files = Files; exports.Marketplace = Marketplace; exports.Profiles = Profiles; exports.Sessions = Sessions; exports.Skills = Skills; exports.TaskRun = TaskRun; exports.Tasks = Tasks;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1788,10 +1788,11 @@ interface components {
          *             CREATED: Task has been created but not yet started.
          *         STARTED: Task has been started and is currently running.
          *         FINISHED: Task has finished and the agent has completed the task.
+         *         FAILED: Task execution failed due to an error.
          *         STOPPED: Task execution has been manually stopped (cannot be resumed).
          * @enum {string}
          */
-        TaskStatus: "created" | "started" | "finished" | "stopped";
+        TaskStatus: "created" | "started" | "finished" | "failed" | "stopped";
         /**
          * TaskStatusView
          * @description Lightweight view optimized for polling. Use GET /tasks/{id}/status for efficient polling

package/dist/index.d.ts

@@ -1788,10 +1788,11 @@ interface components {
          *             CREATED: Task has been created but not yet started.
          *         STARTED: Task has been started and is currently running.
          *         FINISHED: Task has finished and the agent has completed the task.
+         *         FAILED: Task execution failed due to an error.
          *         STOPPED: Task execution has been manually stopped (cannot be resumed).
          * @enum {string}
          */
-        TaskStatus: "created" | "started" | "finished" | "stopped";
+        TaskStatus: "created" | "started" | "finished" | "failed" | "stopped";
         /**
          * TaskStatusView
          * @description Lightweight view optimized for polling. Use GET /tasks/{id}/status for efficient polling

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   BrowserUseError,
   HttpClient
-} from "./chunk-I75IFZAL.js";
+} from "./chunk-6TSB5AIP.js";
 
 // src/v2/client.ts
 import { z } from "zod";