browser-use-sdk 2.0.12 → 2.0.14

package/dist/cjs/BaseClient.d.ts

@@ -4,7 +4,7 @@ export interface BaseClientOptions {
     environment?: core.Supplier<environments.BrowserUseEnvironment | string>;
     /** Specify a custom URL to connect the client to. */
     baseUrl?: core.Supplier<string>;
-    apiKey: core.Supplier<string>;
+    apiKey?: core.Supplier<string | undefined>;
     /** Additional headers to include in requests. */
     headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     /** The default maximum time to wait for a response in seconds. */

package/dist/cjs/Client.d.ts

@@ -6,7 +6,6 @@ import { Sessions } from "./api/resources/sessions/client/Client.js";
 import { Skills } from "./api/resources/skills/client/Client.js";
 import { SkillsMarketplace } from "./api/resources/skillsMarketplace/client/Client.js";
 import { Tasks } from "./api/resources/tasks/client/Client.js";
-import { Workflows } from "./api/resources/workflows/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
 export declare namespace BrowserUseClient {
     interface Options extends BaseClientOptions {
@@ -24,8 +23,7 @@ export declare class BrowserUseClient {
     protected _browsers: Browsers | undefined;
     protected _skills: Skills | undefined;
     protected _skillsMarketplace: SkillsMarketplace | undefined;
-    protected _workflows: Workflows | undefined;
-    constructor(_options: BrowserUseClient.Options);
+    constructor(_options?: BrowserUseClient.Options);
     get billing(): Billing;
     get tasks(): Tasks;
     get sessions(): Sessions;
@@ -34,5 +32,4 @@ export declare class BrowserUseClient {
     get browsers(): Browsers;
     get skills(): Skills;
     get skillsMarketplace(): SkillsMarketplace;
-    get workflows(): Workflows;
 }

package/dist/cjs/Client.js

@@ -43,16 +43,15 @@ const Client_js_5 = require("./api/resources/sessions/client/Client.js");
 const Client_js_6 = require("./api/resources/skills/client/Client.js");
 const Client_js_7 = require("./api/resources/skillsMarketplace/client/Client.js");
 const Client_js_8 = require("./api/resources/tasks/client/Client.js");
-const Client_js_9 = require("./api/resources/workflows/client/Client.js");
 const headers_js_1 = require("./core/headers.js");
 const core = __importStar(require("./core/index.js"));
 class BrowserUseClient {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = Object.assign(Object.assign({}, _options), { logging: core.logging.createLogger(_options === null || _options === void 0 ? void 0 : _options.logging), headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "browser-use-sdk",
-                "X-Fern-SDK-Version": "2.0.12",
-                "User-Agent": "browser-use-sdk/2.0.12",
+                "X-Fern-SDK-Version": "2.0.14",
+                "User-Agent": "browser-use-sdk/2.0.14",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });
@@ -89,9 +88,5 @@ class BrowserUseClient {
         var _a;
         return ((_a = this._skillsMarketplace) !== null && _a !== void 0 ? _a : (this._skillsMarketplace = new Client_js_7.SkillsMarketplace(this._options)));
     }
-    get workflows() {
-        var _a;
-        return ((_a = this._workflows) !== null && _a !== void 0 ? _a : (this._workflows = new Client_js_9.Workflows(this._options)));
-    }
 }
 exports.BrowserUseClient = BrowserUseClient;

package/dist/cjs/api/errors/ForbiddenError.d.ts

@@ -1,6 +1,5 @@
 import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
-import type * as BrowserUse from "../index.js";
 export declare class ForbiddenError extends errors.BrowserUseError {
-    constructor(body: BrowserUse.SessionTimeoutLimitExceededError, rawResponse?: core.RawResponse);
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
 }

package/dist/cjs/api/resources/billing/client/Client.d.ts

@@ -9,9 +9,9 @@ export declare namespace Billing {
 }
 export declare class Billing {
     protected readonly _options: Billing.Options;
-    constructor(_options: Billing.Options);
+    constructor(_options?: Billing.Options);
     /**
-     * Get authenticated account information including credit balances and account details.
+     * Get authenticated account information including credit balance and account details.
      *
      * @param {Billing.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/billing/client/Client.js

@@ -50,11 +50,11 @@ const environments = __importStar(require("../../../../environments.js"));
 const errors = __importStar(require("../../../../errors/index.js"));
 const BrowserUse = __importStar(require("../../../index.js"));
 class Billing {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**
-     * Get authenticated account information including credit balances and account details.
+     * Get authenticated account information including credit balance and account details.
      *
      * @param {Billing.RequestOptions} requestOptions - Request-specific configuration.
      *

package/dist/cjs/api/resources/browsers/client/Client.d.ts

@@ -9,7 +9,7 @@ export declare namespace Browsers {
 }
 export declare class Browsers {
     protected readonly _options: Browsers.Options;
-    constructor(_options: Browsers.Options);
+    constructor(_options?: Browsers.Options);
     /**
      * Get paginated list of browser sessions with optional status filtering.
      *
@@ -26,16 +26,18 @@ export declare class Browsers {
     /**
      * 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
      *
      * @param {BrowserUse.CreateBrowserSessionRequest} request
      * @param {Browsers.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/browsers/client/Client.js

@@ -61,7 +61,7 @@ const environments = __importStar(require("../../../../environments.js"));
 const errors = __importStar(require("../../../../errors/index.js"));
 const BrowserUse = __importStar(require("../../../index.js"));
 class Browsers {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**
@@ -142,16 +142,18 @@ class Browsers {
     /**
      * 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
      *
      * @param {BrowserUse.CreateBrowserSessionRequest} request
      * @param {Browsers.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/browsers/client/requests/CreateBrowserSessionRequest.d.ts

@@ -8,7 +8,7 @@ export interface CreateBrowserSessionRequest {
     profileId?: string | null;
     /** Country code for proxy location. */
     proxyCountryCode?: BrowserUse.ProxyCountryCode | null;
-    /** The timeout for the session in minutes. Free users are limited to 15 minutes, paid users can use up to 240 minutes (4 hours). */
+    /** The timeout for the session in minutes. All users can use up to 240 minutes (4 hours). Pay As You Go users are charged $0.06/hour, subscribers get 50% off. */
     timeout?: number;
     /** Custom screen width in pixels for the browser. */
     browserScreenWidth?: number | null;
@@ -16,4 +16,6 @@ export interface CreateBrowserSessionRequest {
     browserScreenHeight?: number | null;
     /** Whether to allow the browser to be resized during the session (not recommended since it reduces stealthiness). */
     allowResizing?: boolean;
+    /** Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available for Business and Scaleup subscribers. */
+    customProxy?: BrowserUse.CustomProxy | null;
 }

package/dist/cjs/api/resources/files/client/Client.d.ts

@@ -9,7 +9,7 @@ export declare namespace Files {
 }
 export declare class Files {
     protected readonly _options: Files.Options;
-    constructor(_options: Files.Options);
+    constructor(_options?: Files.Options);
     /**
      * Generate a secure presigned URL for uploading files to an agent session.
      *

package/dist/cjs/api/resources/files/client/Client.js

@@ -50,7 +50,7 @@ const environments = __importStar(require("../../../../environments.js"));
 const errors = __importStar(require("../../../../errors/index.js"));
 const BrowserUse = __importStar(require("../../../index.js"));
 class Files {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**

package/dist/cjs/api/resources/index.d.ts

@@ -13,5 +13,3 @@ export * from "./skillsMarketplace/client/requests/index.js";
 export * as skillsMarketplace from "./skillsMarketplace/index.js";
 export * from "./tasks/client/requests/index.js";
 export * as tasks from "./tasks/index.js";
-export * from "./workflows/client/requests/index.js";
-export * as workflows from "./workflows/index.js";

package/dist/cjs/api/resources/index.js

@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.workflows = exports.tasks = exports.skillsMarketplace = exports.skills = exports.sessions = exports.profiles = exports.files = exports.browsers = exports.billing = void 0;
+exports.tasks = exports.skillsMarketplace = exports.skills = exports.sessions = exports.profiles = exports.files = exports.browsers = exports.billing = void 0;
 exports.billing = __importStar(require("./billing/index.js"));
 __exportStar(require("./browsers/client/requests/index.js"), exports);
 exports.browsers = __importStar(require("./browsers/index.js"));
@@ -52,5 +52,3 @@ __exportStar(require("./skillsMarketplace/client/requests/index.js"), exports);
 exports.skillsMarketplace = __importStar(require("./skillsMarketplace/index.js"));
 __exportStar(require("./tasks/client/requests/index.js"), exports);
 exports.tasks = __importStar(require("./tasks/index.js"));
-__exportStar(require("./workflows/client/requests/index.js"), exports);
-exports.workflows = __importStar(require("./workflows/index.js"));

package/dist/cjs/api/resources/profiles/client/Client.d.ts

@@ -9,7 +9,7 @@ export declare namespace Profiles {
 }
 export declare class Profiles {
     protected readonly _options: Profiles.Options;
-    constructor(_options: Profiles.Options);
+    constructor(_options?: Profiles.Options);
     /**
      * Get paginated list of profiles.
      *

package/dist/cjs/api/resources/profiles/client/Client.js

@@ -61,7 +61,7 @@ const environments = __importStar(require("../../../../environments.js"));
 const errors = __importStar(require("../../../../errors/index.js"));
 const BrowserUse = __importStar(require("../../../index.js"));
 class Profiles {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**

package/dist/cjs/api/resources/sessions/client/Client.d.ts

@@ -9,7 +9,7 @@ export declare namespace Sessions {
 }
 export declare class Sessions {
     protected readonly _options: Sessions.Options;
-    constructor(_options: Sessions.Options);
+    constructor(_options?: Sessions.Options);
     /**
      * Get paginated list of AI agent sessions with optional status filtering.
      *
@@ -29,6 +29,7 @@ export declare class Sessions {
      * @param {BrowserUse.CreateSessionRequest} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link BrowserUse.PaymentRequiredError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
      * @throws {@link BrowserUse.TooManyRequestsError}

package/dist/cjs/api/resources/sessions/client/Client.js

@@ -61,7 +61,7 @@ const environments = __importStar(require("../../../../environments.js"));
 const errors = __importStar(require("../../../../errors/index.js"));
 const BrowserUse = __importStar(require("../../../index.js"));
 class Sessions {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**
@@ -142,6 +142,7 @@ class Sessions {
      * @param {BrowserUse.CreateSessionRequest} request
      * @param {Sessions.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link BrowserUse.PaymentRequiredError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
      * @throws {@link BrowserUse.TooManyRequestsError}
@@ -175,6 +176,8 @@ class Sessions {
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
+                    case 402:
+                        throw new BrowserUse.PaymentRequiredError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new BrowserUse.NotFoundError(_response.error.body, _response.rawResponse);
                     case 422:

package/dist/cjs/api/resources/sessions/client/requests/CreateSessionRequest.d.ts

@@ -14,4 +14,10 @@ export interface CreateSessionRequest {
     browserScreenWidth?: number | null;
     /** Custom screen height in pixels for the browser. */
     browserScreenHeight?: number | null;
+    /** If True (default), tasks in this session share memory and history with each other, allowing follow-up tasks to continue from previous context. If False, each task runs as a standalone task without any previous task context. */
+    persistMemory?: boolean;
+    /** If True (default), the browser session stays alive after tasks complete, allowing follow-up tasks. If False, the session is closed immediately after task completion. Set to False for simple one-off tasks to reduce session idle time. */
+    keepAlive?: boolean;
+    /** Custom proxy settings to use for the session. If not provided, our proxies will be used. Custom proxies are only available for Business and Scaleup subscribers. */
+    customProxy?: BrowserUse.CustomProxy | null;
 }

package/dist/cjs/api/resources/skills/client/Client.d.ts

@@ -9,7 +9,7 @@ export declare namespace Skills {
 }
 export declare class Skills {
     protected readonly _options: Skills.Options;
-    constructor(_options: Skills.Options);
+    constructor(_options?: Skills.Options);
     /**
      * List all skills owned by the authenticated project with optional filtering.
      *
@@ -30,7 +30,9 @@ export declare class Skills {
      * @param {Skills.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link BrowserUse.BadRequestError}
+     * @throws {@link BrowserUse.PaymentRequiredError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
      *
      * @example
      *     await client.skills.createSkill({
@@ -79,6 +81,7 @@ export declare class Skills {
      * @param {BrowserUse.UpdateSkillRequest} request
      * @param {Skills.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link BrowserUse.ForbiddenError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
      *
@@ -126,20 +129,22 @@ export declare class Skills {
     /**
      * Execute a skill with the provided parameters.
      *
-     * @param {BrowserUse.ExecuteSkillRequest} request
+     * @param {BrowserUse.ExecuteSkillSkillsSkillIdExecutePostRequest} request
      * @param {Skills.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link BrowserUse.BadRequestError}
      * @throws {@link BrowserUse.PaymentRequiredError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
      *
      * @example
      *     await client.skills.executeSkill({
-     *         skill_id: "skill_id"
+     *         skill_id: "skill_id",
+     *         body: {}
      *     })
      */
-    executeSkill(request: BrowserUse.ExecuteSkillRequest, requestOptions?: Skills.RequestOptions): core.HttpResponsePromise<BrowserUse.ExecuteSkillResponse>;
+    executeSkill(request: BrowserUse.ExecuteSkillSkillsSkillIdExecutePostRequest, requestOptions?: Skills.RequestOptions): core.HttpResponsePromise<BrowserUse.ExecuteSkillResponse>;
     private __executeSkill;
     /**
      * Refine a skill based on feedback.
@@ -150,6 +155,7 @@ export declare class Skills {
      * @throws {@link BrowserUse.BadRequestError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
      *
      * @example
      *     await client.skills.refineSkill({
@@ -159,5 +165,38 @@ export declare class Skills {
      */
     refineSkill(request: BrowserUse.RefineSkillRequest, requestOptions?: Skills.RequestOptions): core.HttpResponsePromise<BrowserUse.RefineSkillResponse>;
     private __refineSkill;
+    /**
+     * List executions for a specific skill.
+     *
+     * @param {BrowserUse.ListSkillExecutionsSkillsSkillIdExecutionsGetRequest} request
+     * @param {Skills.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.skills.listSkillExecutions({
+     *         skill_id: "skill_id"
+     *     })
+     */
+    listSkillExecutions(request: BrowserUse.ListSkillExecutionsSkillsSkillIdExecutionsGetRequest, requestOptions?: Skills.RequestOptions): core.HttpResponsePromise<BrowserUse.SkillExecutionListResponse>;
+    private __listSkillExecutions;
+    /**
+     * Get presigned URL for downloading skill execution output.
+     *
+     * @param {BrowserUse.GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest} request
+     * @param {Skills.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.skills.getSkillExecutionOutput({
+     *         skill_id: "skill_id",
+     *         execution_id: "execution_id"
+     *     })
+     */
+    getSkillExecutionOutput(request: BrowserUse.GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest, requestOptions?: Skills.RequestOptions): core.HttpResponsePromise<BrowserUse.SkillExecutionOutputResponse>;
+    private __getSkillExecutionOutput;
     protected _getCustomAuthorizationHeaders(): Promise<Record<string, string | undefined>>;
 }