browser-use-sdk 2.0.13 → 2.0.15

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,7 +23,6 @@ export declare class BrowserUseClient {
     protected _browsers: Browsers | undefined;
     protected _skills: Skills | undefined;
     protected _skillsMarketplace: SkillsMarketplace | undefined;
-    protected _workflows: Workflows | undefined;
     constructor(_options?: BrowserUseClient.Options);
     get billing(): Billing;
     get tasks(): Tasks;
@@ -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,7 +43,6 @@ 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 {
@@ -51,8 +50,8 @@ class BrowserUseClient {
         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.13",
-                "User-Agent": "browser-use-sdk/2.0.13",
+                "X-Fern-SDK-Version": "2.0.15",
+                "User-Agent": "browser-use-sdk/2.0.15",
                 "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/resources/browsers/client/requests/CreateBrowserSessionRequest.d.ts

@@ -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/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/sessions/client/Client.d.ts

@@ -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

@@ -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

@@ -16,4 +16,8 @@ export interface CreateSessionRequest {
     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

@@ -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({
@@ -134,6 +136,7 @@ export declare class Skills {
      * @throws {@link BrowserUse.PaymentRequiredError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
      *
      * @example
      *     await client.skills.executeSkill({
@@ -152,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({
@@ -161,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>>;
 }

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

@@ -158,7 +158,9 @@ 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({
@@ -194,8 +196,12 @@ class Skills {
                 switch (_response.error.statusCode) {
                     case 400:
                         throw new BrowserUse.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 402:
+                        throw new BrowserUse.PaymentRequiredError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new BrowserUse.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new BrowserUse.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.BrowserUseError({
                             statusCode: _response.error.statusCode,
@@ -581,6 +587,7 @@ class Skills {
      * @throws {@link BrowserUse.PaymentRequiredError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
      *
      * @example
      *     await client.skills.executeSkill({
@@ -623,6 +630,8 @@ class Skills {
                         throw new BrowserUse.NotFoundError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new BrowserUse.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new BrowserUse.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.BrowserUseError({
                             statusCode: _response.error.statusCode,
@@ -657,6 +666,7 @@ class Skills {
      * @throws {@link BrowserUse.BadRequestError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
      *
      * @example
      *     await client.skills.refineSkill({
@@ -697,6 +707,8 @@ class Skills {
                         throw new BrowserUse.NotFoundError(_response.error.body, _response.rawResponse);
                     case 422:
                         throw new BrowserUse.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new BrowserUse.TooManyRequestsError(_response.error.body, _response.rawResponse);
                     default:
                         throw new errors.BrowserUseError({
                             statusCode: _response.error.statusCode,
@@ -722,6 +734,154 @@ class Skills {
             }
         });
     }
+    /**
+     * 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, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listSkillExecutions(request, requestOptions));
+    }
+    __listSkillExecutions(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { skill_id: skillId, pageSize, pageNumber } = request;
+            const _queryParams = {};
+            if (pageSize != null) {
+                _queryParams.pageSize = pageSize.toString();
+            }
+            if (pageNumber != null) {
+                _queryParams.pageNumber = pageNumber.toString();
+            }
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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, `skills/${core.url.encodePathParam(skillId)}/executions`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                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,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                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,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.BrowserUseError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling GET /skills/{skill_id}/executions.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * 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, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getSkillExecutionOutput(request, requestOptions));
+    }
+    __getSkillExecutionOutput(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { skill_id: skillId, execution_id: executionId } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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, `skills/${core.url.encodePathParam(skillId)}/executions/${core.url.encodePathParam(executionId)}/output`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                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,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                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,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.BrowserUseError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling GET /skills/{skill_id}/executions/{execution_id}/output.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getCustomAuthorizationHeaders() {
         return __awaiter(this, void 0, void 0, function* () {
             const apiKeyValue = yield core.Supplier.get(this._options.apiKey);

package/dist/cjs/api/resources/skills/client/requests/GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @example
+ *     {
+ *         skill_id: "skill_id",
+ *         execution_id: "execution_id"
+ *     }
+ */
+export interface GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest {
+    skill_id: string;
+    execution_id: string;
+}

package/dist/cjs/api/resources/skills/client/requests/GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/skills/client/requests/ListSkillExecutionsSkillsSkillIdExecutionsGetRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @example
+ *     {
+ *         skill_id: "skill_id"
+ *     }
+ */
+export interface ListSkillExecutionsSkillsSkillIdExecutionsGetRequest {
+    skill_id: string;
+    pageSize?: number;
+    pageNumber?: number;
+}

package/dist/cjs/api/resources/skills/client/requests/ListSkillExecutionsSkillsSkillIdExecutionsGetRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/skills/client/requests/index.d.ts

@@ -2,7 +2,9 @@ export type { CancelGenerationSkillsSkillIdCancelPostRequest } from "./CancelGen
 export type { CreateSkillRequest } from "./CreateSkillRequest.js";
 export type { DeleteSkillSkillsSkillIdDeleteRequest } from "./DeleteSkillSkillsSkillIdDeleteRequest.js";
 export type { ExecuteSkillSkillsSkillIdExecutePostRequest } from "./ExecuteSkillSkillsSkillIdExecutePostRequest.js";
+export type { GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest } from "./GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest.js";
 export type { GetSkillSkillsSkillIdGetRequest } from "./GetSkillSkillsSkillIdGetRequest.js";
+export type { ListSkillExecutionsSkillsSkillIdExecutionsGetRequest } from "./ListSkillExecutionsSkillsSkillIdExecutionsGetRequest.js";
 export type { ListSkillsSkillsGetRequest } from "./ListSkillsSkillsGetRequest.js";
 export type { RefineSkillRequest } from "./RefineSkillRequest.js";
 export type { RollbackSkillSkillsSkillIdRollbackPostRequest } from "./RollbackSkillSkillsSkillIdRollbackPostRequest.js";

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

@@ -27,12 +27,15 @@ export declare class Tasks {
      * Create and start a new task.
      *
      * You can either:
-     * 1. Start a new task without a sessionId (auto-creates a session with US proxy by default)
+     * 1. Start a new task without a sessionId (auto-creates a session with US proxy by default).
+     *    Note: Tasks without a sessionId are one-off tasks that automatically close the session
+     *    upon completion (keep_alive=false).
      * 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.
+     * Important: Proxy configuration (proxyCountryCode) and other session settings (like keep_alive) are
+     * session-level settings, not task-level settings. For full control over session configuration,
+     * create a session first via POST /sessions with your desired settings, then pass that sessionId
+     * when creating tasks.
      *
      * @param {BrowserUse.CreateTaskRequest} request
      * @param {Tasks.RequestOptions} requestOptions - Request-specific configuration.
@@ -82,6 +85,31 @@ export declare class Tasks {
      */
     updateTask(request: BrowserUse.UpdateTaskRequest, requestOptions?: Tasks.RequestOptions): core.HttpResponsePromise<BrowserUse.TaskView>;
     private __updateTask;
+    /**
+     * Lightweight endpoint optimized for polling task status.
+     *
+     * Returns only the task status, output, and cost without loading steps,
+     * files, or session details. Use this endpoint for efficient polling
+     * instead of GET /tasks/{task_id}.
+     *
+     * Recommended polling pattern:
+     * 1. POST /tasks to create a task
+     * 2. Poll GET /tasks/{task_id}/status until status is 'finished' or 'stopped'
+     * 3. GET /tasks/{task_id} once at the end for full details including steps
+     *
+     * @param {BrowserUse.GetTaskStatusTasksTaskIdStatusGetRequest} request
+     * @param {Tasks.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.tasks.getTaskStatus({
+     *         task_id: "task_id"
+     *     })
+     */
+    getTaskStatus(request: BrowserUse.GetTaskStatusTasksTaskIdStatusGetRequest, requestOptions?: Tasks.RequestOptions): core.HttpResponsePromise<BrowserUse.TaskStatusView>;
+    private __getTaskStatus;
     /**
      * Get secure download URL for task execution logs with step-by-step details.
      *

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

@@ -149,12 +149,15 @@ class Tasks {
      * Create and start a new task.
      *
      * You can either:
-     * 1. Start a new task without a sessionId (auto-creates a session with US proxy by default)
+     * 1. Start a new task without a sessionId (auto-creates a session with US proxy by default).
+     *    Note: Tasks without a sessionId are one-off tasks that automatically close the session
+     *    upon completion (keep_alive=false).
      * 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.
+     * Important: Proxy configuration (proxyCountryCode) and other session settings (like keep_alive) are
+     * session-level settings, not task-level settings. For full control over session configuration,
+     * create a session first via POST /sessions with your desired settings, then pass that sessionId
+     * when creating tasks.
      *
      * @param {BrowserUse.CreateTaskRequest} request
      * @param {Tasks.RequestOptions} requestOptions - Request-specific configuration.
@@ -366,6 +369,82 @@ class Tasks {
             }
         });
     }
+    /**
+     * Lightweight endpoint optimized for polling task status.
+     *
+     * Returns only the task status, output, and cost without loading steps,
+     * files, or session details. Use this endpoint for efficient polling
+     * instead of GET /tasks/{task_id}.
+     *
+     * Recommended polling pattern:
+     * 1. POST /tasks to create a task
+     * 2. Poll GET /tasks/{task_id}/status until status is 'finished' or 'stopped'
+     * 3. GET /tasks/{task_id} once at the end for full details including steps
+     *
+     * @param {BrowserUse.GetTaskStatusTasksTaskIdStatusGetRequest} request
+     * @param {Tasks.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.tasks.getTaskStatus({
+     *         task_id: "task_id"
+     *     })
+     */
+    getTaskStatus(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getTaskStatus(request, requestOptions));
+    }
+    __getTaskStatus(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { task_id: taskId } = request;
+            const _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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, `tasks/${core.url.encodePathParam(taskId)}/status`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                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 };
+            }
+            if (_response.error.reason === "status-code") {
+                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,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.BrowserUseError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling GET /tasks/{task_id}/status.");
+                case "unknown":
+                    throw new errors.BrowserUseError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Get secure download URL for task execution logs with step-by-step details.
      *

package/dist/cjs/api/resources/tasks/client/requests/GetTaskStatusTasksTaskIdStatusGetRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         task_id: "task_id"
+ *     }
+ */
+export interface GetTaskStatusTasksTaskIdStatusGetRequest {
+    task_id: string;
+}

package/dist/cjs/api/resources/tasks/client/requests/GetTaskStatusTasksTaskIdStatusGetRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/tasks/client/requests/index.d.ts

@@ -1,5 +1,6 @@
 export type { CreateTaskRequest } from "./CreateTaskRequest.js";
 export type { GetTaskLogsTasksTaskIdLogsGetRequest } from "./GetTaskLogsTasksTaskIdLogsGetRequest.js";
+export type { GetTaskStatusTasksTaskIdStatusGetRequest } from "./GetTaskStatusTasksTaskIdStatusGetRequest.js";
 export type { GetTaskTasksTaskIdGetRequest } from "./GetTaskTasksTaskIdGetRequest.js";
 export type { ListTasksTasksGetRequest } from "./ListTasksTasksGetRequest.js";
 export type { UpdateTaskRequest } from "./UpdateTaskRequest.js";

package/dist/cjs/api/types/BrowserSessionItemView.d.ts

@@ -17,4 +17,10 @@ export interface BrowserSessionItemView {
     startedAt: string;
     /** Timestamp when the session was stopped (None if still active) */
     finishedAt?: string | null;
+    /** Amount of proxy data used in MB */
+    proxyUsedMb?: string;
+    /** Cost of proxy usage in USD */
+    proxyCost?: string;
+    /** Cost of browser session hosting in USD */
+    browserCost?: string;
 }

package/dist/cjs/api/types/BrowserSessionView.d.ts

@@ -17,4 +17,10 @@ export interface BrowserSessionView {
     startedAt: string;
     /** Timestamp when the session was stopped (None if still active) */
     finishedAt?: string | null;
+    /** Amount of proxy data used in MB */
+    proxyUsedMb?: string;
+    /** Cost of proxy usage in USD */
+    proxyCost?: string;
+    /** Cost of browser session hosting in USD */
+    browserCost?: string;
 }