browser-use-sdk 2.0.4 → 2.0.6

package/dist/esm/Client.d.mts

@@ -1,46 +1,32 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as environments from "./environments.mjs";
-import * as core from "./core/index.mjs";
-import { Accounts } from "./api/resources/accounts/client/Client.mjs";
-import { Tasks } from "./api/resources/tasks/client/Client.mjs";
-import { Sessions } from "./api/resources/sessions/client/Client.mjs";
+import { Billing } from "./api/resources/billing/client/Client.mjs";
+import { Browsers } from "./api/resources/browsers/client/Client.mjs";
 import { Files } from "./api/resources/files/client/Client.mjs";
 import { Profiles } from "./api/resources/profiles/client/Client.mjs";
+import { Sessions } from "./api/resources/sessions/client/Client.mjs";
+import { Tasks } from "./api/resources/tasks/client/Client.mjs";
+import { Workflows } from "./api/resources/workflows/client/Client.mjs";
+import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.mjs";
 export declare namespace BrowserUseClient {
-    interface Options {
-        environment?: core.Supplier<environments.BrowserUseEnvironment | string>;
-        /** Specify a custom URL to connect the client to. */
-        baseUrl?: core.Supplier<string>;
-        apiKey: core.Supplier<string>;
-        /** Additional headers to include in requests. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    interface Options extends BaseClientOptions {
     }
-    interface RequestOptions {
-        /** The maximum time to wait for a response in seconds. */
-        timeoutInSeconds?: number;
-        /** The number of times to retry the request. Defaults to 2. */
-        maxRetries?: number;
-        /** A hook to abort the request. */
-        abortSignal?: AbortSignal;
-        /** Additional query string parameters to include in the request. */
-        queryParams?: Record<string, unknown>;
-        /** Additional headers to include in the request. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    interface RequestOptions extends BaseRequestOptions {
     }
 }
 export declare class BrowserUseClient {
     protected readonly _options: BrowserUseClient.Options;
-    protected _accounts: Accounts | undefined;
+    protected _billing: Billing | undefined;
     protected _tasks: Tasks | undefined;
     protected _sessions: Sessions | undefined;
     protected _files: Files | undefined;
     protected _profiles: Profiles | undefined;
+    protected _browsers: Browsers | undefined;
+    protected _workflows: Workflows | undefined;
     constructor(_options: BrowserUseClient.Options);
-    get accounts(): Accounts;
+    get billing(): Billing;
     get tasks(): Tasks;
     get sessions(): Sessions;
     get files(): Files;
     get profiles(): Profiles;
+    get browsers(): Browsers;
+    get workflows(): Workflows;
 }

package/dist/esm/Client.mjs

@@ -1,27 +1,27 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
-import * as core from "./core/index.mjs";
-import { mergeHeaders } from "./core/headers.mjs";
-import { Accounts } from "./api/resources/accounts/client/Client.mjs";
-import { Tasks } from "./api/resources/tasks/client/Client.mjs";
-import { Sessions } from "./api/resources/sessions/client/Client.mjs";
+// This file was auto-generated by Fern from our API Definition.
+import { Billing } from "./api/resources/billing/client/Client.mjs";
+import { Browsers } from "./api/resources/browsers/client/Client.mjs";
 import { Files } from "./api/resources/files/client/Client.mjs";
 import { Profiles } from "./api/resources/profiles/client/Client.mjs";
+import { Sessions } from "./api/resources/sessions/client/Client.mjs";
+import { Tasks } from "./api/resources/tasks/client/Client.mjs";
+import { Workflows } from "./api/resources/workflows/client/Client.mjs";
+import { mergeHeaders } from "./core/headers.mjs";
+import * as core from "./core/index.mjs";
 export class BrowserUseClient {
     constructor(_options) {
-        this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
+        this._options = Object.assign(Object.assign({}, _options), { logging: core.logging.createLogger(_options === null || _options === void 0 ? void 0 : _options.logging), headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "browser-use-sdk",
-                "X-Fern-SDK-Version": "2.0.4",
-                "User-Agent": "browser-use-sdk/2.0.4",
+                "X-Fern-SDK-Version": "2.0.6",
+                "User-Agent": "browser-use-sdk/2.0.6",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });
     }
-    get accounts() {
+    get billing() {
         var _a;
-        return ((_a = this._accounts) !== null && _a !== void 0 ? _a : (this._accounts = new Accounts(this._options)));
+        return ((_a = this._billing) !== null && _a !== void 0 ? _a : (this._billing = new Billing(this._options)));
     }
     get tasks() {
         var _a;
@@ -39,4 +39,12 @@ export class BrowserUseClient {
         var _a;
         return ((_a = this._profiles) !== null && _a !== void 0 ? _a : (this._profiles = new Profiles(this._options)));
     }
+    get browsers() {
+        var _a;
+        return ((_a = this._browsers) !== null && _a !== void 0 ? _a : (this._browsers = new Browsers(this._options)));
+    }
+    get workflows() {
+        var _a;
+        return ((_a = this._workflows) !== null && _a !== void 0 ? _a : (this._workflows = new Workflows(this._options)));
+    }
 }

package/dist/esm/api/errors/BadRequestError.d.mts

@@ -1,8 +1,5 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+import type * as core from "../../core/index.mjs";
 import * as errors from "../../errors/index.mjs";
-import * as core from "../../core/index.mjs";
 export declare class BadRequestError extends errors.BrowserUseError {
     constructor(body?: unknown, rawResponse?: core.RawResponse);
 }

package/dist/esm/api/errors/BadRequestError.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 import * as errors from "../../errors/index.mjs";
 export class BadRequestError extends errors.BrowserUseError {
     constructor(body, rawResponse) {

package/dist/esm/api/errors/ForbiddenError.d.mts

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

package/dist/esm/api/errors/ForbiddenError.mjs

@@ -0,0 +1,13 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../errors/index.mjs";
+export class ForbiddenError extends errors.BrowserUseError {
+    constructor(body, rawResponse) {
+        super({
+            message: "ForbiddenError",
+            statusCode: 403,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, ForbiddenError.prototype);
+    }
+}

package/dist/esm/api/errors/InternalServerError.d.mts

@@ -1,8 +1,5 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+import type * as core from "../../core/index.mjs";
 import * as errors from "../../errors/index.mjs";
-import * as core from "../../core/index.mjs";
 export declare class InternalServerError extends errors.BrowserUseError {
     constructor(body?: unknown, rawResponse?: core.RawResponse);
 }

package/dist/esm/api/errors/InternalServerError.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 import * as errors from "../../errors/index.mjs";
 export class InternalServerError extends errors.BrowserUseError {
     constructor(body, rawResponse) {

package/dist/esm/api/errors/NotFoundError.d.mts

@@ -1,8 +1,5 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+import type * as core from "../../core/index.mjs";
 import * as errors from "../../errors/index.mjs";
-import * as core from "../../core/index.mjs";
 export declare class NotFoundError extends errors.BrowserUseError {
     constructor(body?: unknown, rawResponse?: core.RawResponse);
 }

package/dist/esm/api/errors/NotFoundError.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 import * as errors from "../../errors/index.mjs";
 export class NotFoundError extends errors.BrowserUseError {
     constructor(body, rawResponse) {

package/dist/esm/api/errors/PaymentRequiredError.d.mts

@@ -1,9 +1,6 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+import type * as core from "../../core/index.mjs";
 import * as errors from "../../errors/index.mjs";
-import * as BrowserUse from "../index.mjs";
-import * as core from "../../core/index.mjs";
+import type * as BrowserUse from "../index.mjs";
 export declare class PaymentRequiredError extends errors.BrowserUseError {
     constructor(body: BrowserUse.InsufficientCreditsError, rawResponse?: core.RawResponse);
 }

package/dist/esm/api/errors/PaymentRequiredError.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 import * as errors from "../../errors/index.mjs";
 export class PaymentRequiredError extends errors.BrowserUseError {
     constructor(body, rawResponse) {

package/dist/esm/api/errors/TooManyRequestsError.d.mts

@@ -1,9 +1,6 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+import type * as core from "../../core/index.mjs";
 import * as errors from "../../errors/index.mjs";
-import * as BrowserUse from "../index.mjs";
-import * as core from "../../core/index.mjs";
+import type * as BrowserUse from "../index.mjs";
 export declare class TooManyRequestsError extends errors.BrowserUseError {
     constructor(body: BrowserUse.TooManyConcurrentActiveSessionsError, rawResponse?: core.RawResponse);
 }

package/dist/esm/api/errors/TooManyRequestsError.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 import * as errors from "../../errors/index.mjs";
 export class TooManyRequestsError extends errors.BrowserUseError {
     constructor(body, rawResponse) {

package/dist/esm/api/errors/UnprocessableEntityError.d.mts

@@ -1,8 +1,5 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+import type * as core from "../../core/index.mjs";
 import * as errors from "../../errors/index.mjs";
-import * as core from "../../core/index.mjs";
 export declare class UnprocessableEntityError extends errors.BrowserUseError {
     constructor(body?: unknown, rawResponse?: core.RawResponse);
 }

package/dist/esm/api/errors/UnprocessableEntityError.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 import * as errors from "../../errors/index.mjs";
 export class UnprocessableEntityError extends errors.BrowserUseError {
     constructor(body, rawResponse) {

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

@@ -1,6 +1,7 @@
-export * from "./NotFoundError.mjs";
-export * from "./UnprocessableEntityError.mjs";
 export * from "./BadRequestError.mjs";
-export * from "./TooManyRequestsError.mjs";
+export * from "./ForbiddenError.mjs";
 export * from "./InternalServerError.mjs";
+export * from "./NotFoundError.mjs";
 export * from "./PaymentRequiredError.mjs";
+export * from "./TooManyRequestsError.mjs";
+export * from "./UnprocessableEntityError.mjs";

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

@@ -1,6 +1,7 @@
-export * from "./NotFoundError.mjs";
-export * from "./UnprocessableEntityError.mjs";
 export * from "./BadRequestError.mjs";
-export * from "./TooManyRequestsError.mjs";
+export * from "./ForbiddenError.mjs";
 export * from "./InternalServerError.mjs";
+export * from "./NotFoundError.mjs";
 export * from "./PaymentRequiredError.mjs";
+export * from "./TooManyRequestsError.mjs";
+export * from "./UnprocessableEntityError.mjs";

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

@@ -1,3 +1,3 @@
-export * from "./types/index.mjs";
 export * from "./errors/index.mjs";
 export * from "./resources/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/index.mjs

@@ -1,3 +1,3 @@
-export * from "./types/index.mjs";
 export * from "./errors/index.mjs";
 export * from "./resources/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/billing/client/Client.d.mts

@@ -0,0 +1,27 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as BrowserUse from "../../../index.mjs";
+export declare namespace Billing {
+    interface Options extends BaseClientOptions {
+    }
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class Billing {
+    protected readonly _options: Billing.Options;
+    constructor(_options: Billing.Options);
+    /**
+     * Get authenticated account information including credit balances and account details.
+     *
+     * @param {Billing.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.billing.getAccountBilling()
+     */
+    getAccountBilling(requestOptions?: Billing.RequestOptions): core.HttpResponsePromise<BrowserUse.AccountView>;
+    private __getAccountBilling;
+    protected _getCustomAuthorizationHeaders(): Promise<Record<string, string | undefined>>;
+}

package/dist/esm/api/resources/{accounts → billing}/client/Client.mjs

@@ -1,6 +1,4 @@
-/**
- * This file was auto-generated by Fern from our API Definition.
- */
+// This file was auto-generated by Fern from our API Definition.
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -10,40 +8,43 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import * as environments from "../../../../environments.mjs";
-import * as core from "../../../../core/index.mjs";
-import * as BrowserUse from "../../../index.mjs";
 import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as environments from "../../../../environments.mjs";
 import * as errors from "../../../../errors/index.mjs";
-export class Accounts {
+import * as BrowserUse from "../../../index.mjs";
+export class Billing {
     constructor(_options) {
         this._options = _options;
     }
     /**
      * Get authenticated account information including credit balances and account details.
      *
-     * @param {Accounts.RequestOptions} requestOptions - Request-specific configuration.
+     * @param {Billing.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
      *
      * @example
-     *     await client.accounts.getAccountMe()
+     *     await client.billing.getAccountBilling()
      */
-    getAccountMe(requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__getAccountMe(requestOptions));
+    getAccountBilling(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getAccountBilling(requestOptions));
     }
-    __getAccountMe(requestOptions) {
+    __getAccountBilling(requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c;
-            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrowserUseEnvironment.Production, "accounts/me"),
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BrowserUseEnvironment.Production, "billing/account"),
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
-                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
             });
             if (_response.ok) {
                 return { data: _response.body, rawResponse: _response.rawResponse };
@@ -52,6 +53,8 @@ export class Accounts {
                 switch (_response.error.statusCode) {
                     case 404:
                         throw new BrowserUse.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new BrowserUse.UnprocessableEntityError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.BrowserUseError({
                             statusCode: _response.error.statusCode,
@@ -68,7 +71,7 @@ export class Accounts {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling GET /accounts/me.");
+                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling GET /billing/account.");
                 case "unknown":
                     throw new errors.BrowserUseError({
                         message: _response.error.errorMessage,

package/dist/esm/api/resources/browsers/client/Client.d.mts

@@ -0,0 +1,90 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as BrowserUse from "../../../index.mjs";
+export declare namespace Browsers {
+    interface Options extends BaseClientOptions {
+    }
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class Browsers {
+    protected readonly _options: Browsers.Options;
+    constructor(_options: Browsers.Options);
+    /**
+     * Get paginated list of browser sessions with optional status filtering.
+     *
+     * @param {BrowserUse.ListBrowserSessionsBrowsersGetRequest} request
+     * @param {Browsers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.browsers.listBrowserSessions()
+     */
+    listBrowserSessions(request?: BrowserUse.ListBrowserSessionsBrowsersGetRequest, requestOptions?: Browsers.RequestOptions): core.HttpResponsePromise<BrowserUse.BrowserSessionListResponse>;
+    private __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.
+     * 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.
+     *
+     * **Session Limits:**
+     * - Free users (without active subscription): Maximum 15 minutes per session
+     * - Paid subscribers: Up to 4 hours per session
+     *
+     * @param {BrowserUse.CreateBrowserSessionRequest} request
+     * @param {Browsers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.ForbiddenError}
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
+     *
+     * @example
+     *     await client.browsers.createBrowserSession()
+     */
+    createBrowserSession(request?: BrowserUse.CreateBrowserSessionRequest, requestOptions?: Browsers.RequestOptions): core.HttpResponsePromise<BrowserUse.BrowserSessionItemView>;
+    private __createBrowserSession;
+    /**
+     * Get detailed browser session information including status and URLs.
+     *
+     * @param {BrowserUse.GetBrowserSessionBrowsersSessionIdGetRequest} request
+     * @param {Browsers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.browsers.getBrowserSession({
+     *         session_id: "session_id"
+     *     })
+     */
+    getBrowserSession(request: BrowserUse.GetBrowserSessionBrowsersSessionIdGetRequest, requestOptions?: Browsers.RequestOptions): core.HttpResponsePromise<BrowserUse.BrowserSessionView>;
+    private __getBrowserSession;
+    /**
+     * Stop a browser session.
+     *
+     * **Refund:** When you stop a session, unused time is automatically refunded.
+     * If the session ran for less than 1 hour, you'll receive a proportional refund.
+     * Billing is ceil to the nearest minute (minimum 1 minute).
+     *
+     * @param {BrowserUse.UpdateBrowserSessionRequest} request
+     * @param {Browsers.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.browsers.updateBrowserSession({
+     *         session_id: "session_id"
+     *     })
+     */
+    updateBrowserSession(request: BrowserUse.UpdateBrowserSessionRequest, requestOptions?: Browsers.RequestOptions): core.HttpResponsePromise<BrowserUse.BrowserSessionView>;
+    private __updateBrowserSession;
+    protected _getCustomAuthorizationHeaders(): Promise<Record<string, string | undefined>>;
+}