browser-use-sdk 2.0.11 → 2.0.13

package/dist/esm/api/types/index.d.mts

@@ -1,11 +1,7 @@
 export * from "./AccountNotFoundError.mjs";
 export * from "./AccountView.mjs";
-export * from "./AppApiV2MarketplaceSkillsViewsParameterSchema.mjs";
-export * from "./AppApiV2MarketplaceSkillsViewsParameterType.mjs";
-export * from "./AppApiV2SkillsViewsInsufficientCreditsError.mjs";
-export * from "./AppApiV2SkillsViewsParameterSchema.mjs";
-export * from "./AppApiV2SkillsViewsParameterType.mjs";
-export * from "./AppViewsV2ErrorViewsInsufficientCreditsError.mjs";
+export * from "./AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.mjs";
+export * from "./AppEndpointsApiV2SkillsViewsInsufficientCreditsError.mjs";
 export * from "./BadRequestErrorBody.mjs";
 export * from "./BrowserSessionItemView.mjs";
 export * from "./BrowserSessionListResponse.mjs";
@@ -13,9 +9,13 @@ export * from "./BrowserSessionStatus.mjs";
 export * from "./BrowserSessionUpdateAction.mjs";
 export * from "./BrowserSessionView.mjs";
 export * from "./CannotDeleteSkillWhileGeneratingError.mjs";
+export * from "./CannotRollbackPublicSkillError.mjs";
+export * from "./CommonUtilsErrorsInsufficientCreditsError.mjs";
 export * from "./ConcurrentSkillCreationsError.mjs";
 export * from "./CreateSkillResponse.mjs";
 export * from "./DownloadUrlGenerationError.mjs";
+export * from "./EnabledSkillsLimitExceededError.mjs";
+export * from "./ExecuteSkillRequest.mjs";
 export * from "./ExecuteSkillResponse.mjs";
 export * from "./FileView.mjs";
 export * from "./GenerationNotCancellableError.mjs";
@@ -25,6 +25,8 @@ export * from "./MarketplaceSkillListResponse.mjs";
 export * from "./MarketplaceSkillResponse.mjs";
 export * from "./NotFoundErrorBody.mjs";
 export * from "./OutputFileNotFoundError.mjs";
+export * from "./ParameterSchema.mjs";
+export * from "./ParameterType.mjs";
 export * from "./PlanInfo.mjs";
 export * from "./ProfileListResponse.mjs";
 export * from "./ProfileNotFoundError.mjs";
@@ -42,6 +44,7 @@ export * from "./SessionUpdateAction.mjs";
 export * from "./SessionView.mjs";
 export * from "./ShareNotFoundError.mjs";
 export * from "./ShareView.mjs";
+export * from "./SkillCategory.mjs";
 export * from "./SkillListResponse.mjs";
 export * from "./SkillNotFinishedError.mjs";
 export * from "./SkillNotFoundError.mjs";
@@ -63,6 +66,7 @@ export * from "./UnsupportedContentTypeError.mjs";
 export * from "./UploadFilePresignedUrlResponse.mjs";
 export * from "./UploadFileRequest.mjs";
 export * from "./ValidationError.mjs";
+export * from "./WorkflowCreateFromTaskResponse.mjs";
 export * from "./WorkflowExecutionCreatedResponse.mjs";
 export * from "./WorkflowExecutionItemView.mjs";
 export * from "./WorkflowExecutionListResponse.mjs";

package/dist/esm/api/types/index.mjs

@@ -1,11 +1,7 @@
 export * from "./AccountNotFoundError.mjs";
 export * from "./AccountView.mjs";
-export * from "./AppApiV2MarketplaceSkillsViewsParameterSchema.mjs";
-export * from "./AppApiV2MarketplaceSkillsViewsParameterType.mjs";
-export * from "./AppApiV2SkillsViewsInsufficientCreditsError.mjs";
-export * from "./AppApiV2SkillsViewsParameterSchema.mjs";
-export * from "./AppApiV2SkillsViewsParameterType.mjs";
-export * from "./AppViewsV2ErrorViewsInsufficientCreditsError.mjs";
+export * from "./AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.mjs";
+export * from "./AppEndpointsApiV2SkillsViewsInsufficientCreditsError.mjs";
 export * from "./BadRequestErrorBody.mjs";
 export * from "./BrowserSessionItemView.mjs";
 export * from "./BrowserSessionListResponse.mjs";
@@ -13,9 +9,13 @@ export * from "./BrowserSessionStatus.mjs";
 export * from "./BrowserSessionUpdateAction.mjs";
 export * from "./BrowserSessionView.mjs";
 export * from "./CannotDeleteSkillWhileGeneratingError.mjs";
+export * from "./CannotRollbackPublicSkillError.mjs";
+export * from "./CommonUtilsErrorsInsufficientCreditsError.mjs";
 export * from "./ConcurrentSkillCreationsError.mjs";
 export * from "./CreateSkillResponse.mjs";
 export * from "./DownloadUrlGenerationError.mjs";
+export * from "./EnabledSkillsLimitExceededError.mjs";
+export * from "./ExecuteSkillRequest.mjs";
 export * from "./ExecuteSkillResponse.mjs";
 export * from "./FileView.mjs";
 export * from "./GenerationNotCancellableError.mjs";
@@ -25,6 +25,8 @@ export * from "./MarketplaceSkillListResponse.mjs";
 export * from "./MarketplaceSkillResponse.mjs";
 export * from "./NotFoundErrorBody.mjs";
 export * from "./OutputFileNotFoundError.mjs";
+export * from "./ParameterSchema.mjs";
+export * from "./ParameterType.mjs";
 export * from "./PlanInfo.mjs";
 export * from "./ProfileListResponse.mjs";
 export * from "./ProfileNotFoundError.mjs";
@@ -42,6 +44,7 @@ export * from "./SessionUpdateAction.mjs";
 export * from "./SessionView.mjs";
 export * from "./ShareNotFoundError.mjs";
 export * from "./ShareView.mjs";
+export * from "./SkillCategory.mjs";
 export * from "./SkillListResponse.mjs";
 export * from "./SkillNotFinishedError.mjs";
 export * from "./SkillNotFoundError.mjs";
@@ -63,6 +66,7 @@ export * from "./UnsupportedContentTypeError.mjs";
 export * from "./UploadFilePresignedUrlResponse.mjs";
 export * from "./UploadFileRequest.mjs";
 export * from "./ValidationError.mjs";
+export * from "./WorkflowCreateFromTaskResponse.mjs";
 export * from "./WorkflowExecutionCreatedResponse.mjs";
 export * from "./WorkflowExecutionItemView.mjs";
 export * from "./WorkflowExecutionListResponse.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.11";
+export declare const SDK_VERSION = "2.0.13";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "2.0.11";
+export const SDK_VERSION = "2.0.13";

package/package.json

@@ -1,84 +1,85 @@
 {
-  "name": "browser-use-sdk",
-  "version": "2.0.11",
-  "private": false,
-  "repository": "github:browser-use/browser-use-node",
-  "type": "commonjs",
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.mjs",
-  "types": "./dist/cjs/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/cjs/index.d.ts",
-      "import": {
-        "types": "./dist/esm/index.d.mts",
-        "default": "./dist/esm/index.mjs"
-      },
-      "require": {
-        "types": "./dist/cjs/index.d.ts",
-        "default": "./dist/cjs/index.js"
-      },
-      "default": "./dist/cjs/index.js"
+    "name": "browser-use-sdk",
+    "version": "2.0.13",
+    "private": false,
+    "repository": "github:browser-use/browser-use-node",
+    "type": "commonjs",
+    "main": "./dist/cjs/index.js",
+    "module": "./dist/esm/index.mjs",
+    "types": "./dist/cjs/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/cjs/index.d.ts",
+            "import": {
+                "types": "./dist/esm/index.d.mts",
+                "default": "./dist/esm/index.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/index.d.ts",
+                "default": "./dist/cjs/index.js"
+            },
+            "default": "./dist/cjs/index.js"
+        },
+        "./package.json": "./package.json"
     },
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "dist",
-    "reference.md",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "fast-json-stable-stringify": "^2.1.0"
-  },
-  "peerDependencies": {
-    "react": "^18 || ^19",
-    "zod": "^4"
-  },
-  "devDependencies": {
-    "webpack": "^5.97.1",
-    "ts-loader": "^9.5.1",
-    "vitest": "^3.2.4",
-    "msw": "2.11.2",
-    "@types/node": "^18.19.70",
-    "typescript": "~5.7.2",
-    "@biomejs/biome": "2.3.1",
-    "@dotenvx/dotenvx": "^1.49.0",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
-    "tsconfig-paths": "^4.2.0",
-    "ts-node": "^10.5.0",
-    "zod": "^4"
-  },
-  "browser": {
-    "fs": false,
-    "os": false,
-    "path": false,
-    "stream": false
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "sideEffects": false,
-  "description": "The official TypeScript library for the Browser Use API",
-  "author": {
-    "name": "Browser Use",
-    "url": "https://browser-use.com",
-    "email": "support@browser-use.com"
-  },
-  "scripts": {
-    "format": "biome format --write --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
-    "format:check": "biome format --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
-    "lint": "biome lint --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
-    "lint:fix": "biome lint --fix --unsafe --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
-    "check": "biome check --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
-    "check:fix": "biome check --fix --unsafe --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
-    "build": "pnpm build:cjs && pnpm build:esm",
-    "build:cjs": "tsc --project ./tsconfig.cjs.json",
-    "build:esm": "tsc --project ./tsconfig.esm.json && node scripts/rename-to-esm-files.js dist/esm",
-    "test": "vitest",
-    "test:unit": "vitest --project unit",
-    "test:wire": "vitest --project wire",
-    "tsn": "ts-node -r tsconfig-paths/register"
-  }
-}
+    "files": [
+        "dist",
+        "reference.md",
+        "README.md",
+        "LICENSE"
+    ],
+    "scripts": {
+        "format": "biome format --write --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "format:check": "biome format --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "lint": "biome lint --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "lint:fix": "biome lint --fix --unsafe --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "check": "biome check --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "check:fix": "biome check --fix --unsafe --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "build": "pnpm build:cjs && pnpm build:esm",
+        "build:cjs": "tsc --project ./tsconfig.cjs.json",
+        "build:esm": "tsc --project ./tsconfig.esm.json && node scripts/rename-to-esm-files.js dist/esm",
+        "test": "vitest",
+        "test:unit": "vitest --project unit",
+        "test:wire": "vitest --project wire",
+        "tsn": "ts-node -r tsconfig-paths/register"
+    },
+    "dependencies": {
+        "fast-json-stable-stringify": "^2.1.0"
+    },
+    "peerDependencies": {
+        "react": "^18 || ^19",
+        "zod": "^4"
+    },
+    "devDependencies": {
+        "webpack": "^5.97.1",
+        "ts-loader": "^9.5.1",
+        "vitest": "^3.2.4",
+        "msw": "2.11.2",
+        "@types/node": "^18.19.70",
+        "typescript": "~5.7.2",
+        "@biomejs/biome": "2.3.1",
+        "@dotenvx/dotenvx": "^1.49.0",
+        "react": "^19.1.1",
+        "react-dom": "^19.1.1",
+        "tsconfig-paths": "^4.2.0",
+        "ts-node": "^10.5.0",
+        "zod": "^4"
+    },
+    "browser": {
+        "fs": false,
+        "os": false,
+        "path": false,
+        "stream": false
+    },
+    "packageManager": "pnpm@10.20.0",
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "sideEffects": false,
+    "description": "The official TypeScript library for the Browser Use API",
+    "author": {
+        "name": "Browser Use",
+        "url": "https://browser-use.com",
+        "email": "support@browser-use.com"
+    }
+}

package/reference.md

@@ -12,7 +12,7 @@
 <dl>
 <dd>
 
-Get authenticated account information including credit balances and account details.
+Get authenticated account information including credit balance and account details.
 </dd>
 </dl>
 </dd>
@@ -131,9 +131,15 @@ await client.tasks.listTasks();
 <dl>
 <dd>
 
+Create and start a new task.
+
 You can either:
-1. Start a new task (auto creates a new simple session)
-2. Start a new task in an existing session (you can create a custom session before starting the task and reuse it for follow-up tasks)
+1. Start a new task without a sessionId (auto-creates a session with US proxy by default)
+2. Start a new task in an existing session (reuse for follow-up tasks or custom configuration)
+
+Important: Proxy configuration (proxyCountryCode) is a session-level setting, not a task-level setting.
+To use a custom proxy location, create a session first via POST /sessions with your desired proxyCountryCode,
+then pass that sessionId when creating tasks.
 </dd>
 </dl>
 </dd>
@@ -1512,16 +1518,18 @@ await client.browsers.listBrowserSessions();
 
 Create a new browser session.
 
-**Pricing:** Browser sessions are charged at $0.05 per hour.
-The full hourly rate is charged upfront when the session starts.
+**Pricing:** Browser sessions are charged per hour with tiered pricing:
+- Pay As You Go users: $0.06/hour
+- Business/Scaleup subscribers: $0.03/hour (50% discount)
+
+The full rate is charged upfront when the session starts.
 When you stop the session, any unused time is automatically refunded proportionally.
 
-Billing is rounded to the nearest minute (minimum 1 minute).
-For example, if you stop a session after 30 minutes, you'll be refunded $0.025.
+Billing is rounded up to the minute (minimum 1 minute).
+For example, if you stop a session after 30 minutes, you'll be refunded half the charged amount.
 
 **Session Limits:**
-- Free users (without active subscription): Maximum 15 minutes per session
-- Paid subscribers: Up to 4 hours per session
+- All users: Up to 4 hours per session
 </dd>
 </dl>
 </dd>
@@ -2077,7 +2085,72 @@ await client.skills.cancelGeneration({
 <dl>
 <dd>
 
-**request:** `BrowserUse.CancelGenerationSkillsSkillIdCancelGenerationPostRequest` 
+**request:** `BrowserUse.CancelGenerationSkillsSkillIdCancelPostRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Skills.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.skills.<a href="/src/api/resources/skills/client/Client.ts">rollbackSkill</a>({ ...params }) -> BrowserUse.SkillResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Rollback to the previous version (cannot be undone).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.skills.rollbackSkill({
+    skill_id: "skill_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `BrowserUse.RollbackSkillSkillsSkillIdRollbackPostRequest` 
     
 </dd>
 </dl>
@@ -2125,7 +2198,8 @@ Execute a skill with the provided parameters.
 
 ```typescript
 await client.skills.executeSkill({
-    skill_id: "skill_id"
+    skill_id: "skill_id",
+    body: {}
 });
 
 ```
@@ -2142,7 +2216,7 @@ await client.skills.executeSkill({
 <dl>
 <dd>
 
-**request:** `BrowserUse.ExecuteSkillRequest` 
+**request:** `BrowserUse.ExecuteSkillSkillsSkillIdExecutePostRequest` 
     
 </dd>
 </dl>
@@ -2320,7 +2394,7 @@ Get details of a specific public skill from the marketplace.
 
 ```typescript
 await client.skillsMarketplace.getSkill({
-    skill_id: "skill_id"
+    skill_slug: "skill_slug"
 });
 
 ```
@@ -2337,7 +2411,7 @@ await client.skillsMarketplace.getSkill({
 <dl>
 <dd>
 
-**request:** `BrowserUse.GetSkillMarketplaceSkillsSkillIdGetRequest` 
+**request:** `BrowserUse.GetSkillMarketplaceSkillsSkillSlugGetRequest` 
     
 </dd>
 </dl>
@@ -2357,7 +2431,7 @@ await client.skillsMarketplace.getSkill({
 </dl>
 </details>
 
-<details><summary><code>client.skillsMarketplace.<a href="/src/api/resources/skillsMarketplace/client/Client.ts">cloneSkill</a>({ ...params }) -> BrowserUse.MarketplaceSkillResponse</code></summary>
+<details><summary><code>client.skillsMarketplace.<a href="/src/api/resources/skillsMarketplace/client/Client.ts">cloneSkill</a>({ ...params }) -> BrowserUse.SkillResponse</code></summary>
 <dl>
 <dd>
 
@@ -2418,6 +2492,72 @@ await client.skillsMarketplace.cloneSkill({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.skillsMarketplace.<a href="/src/api/resources/skillsMarketplace/client/Client.ts">executeSkill</a>({ ...params }) -> BrowserUse.ExecuteSkillResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Execute a skill with the provided parameters.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.skillsMarketplace.executeSkill({
+    skill_id: "skill_id",
+    body: {}
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `BrowserUse.ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SkillsMarketplace.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -2811,6 +2951,83 @@ await client.workflows.getWorkflowGenerationState({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.workflows.<a href="/src/api/resources/workflows/client/Client.ts">createWorkflowFromTask</a>({ ...params }) -> BrowserUse.WorkflowCreateFromTaskResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Create a workflow from an existing agent task's recorded history.
+
+This endpoint creates a workflow by using the browser-use rerun history
+feature. The task must have completed with history stored in S3.
+
+The workflow creation process:
+1. Creates a new workflow record in pending state
+2. Triggers an Inngest event to process the task history
+3. The Inngest handler downloads history, detects variables, and updates the workflow
+
+Use GET /workflows/{workflow_id} to poll for creation completion.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.workflows.createWorkflowFromTask({
+    name: "name",
+    taskId: "taskId",
+    sessionId: "sessionId"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `BrowserUse.WorkflowCreateFromTaskRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Workflows.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>