browser-use-sdk 2.0.13 → 2.0.15

package/dist/esm/api/resources/skills/client/Client.mjs

@@ -122,7 +122,9 @@ export 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({
@@ -158,8 +160,12 @@ export 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,
@@ -545,6 +551,7 @@ export class Skills {
      * @throws {@link BrowserUse.PaymentRequiredError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
      *
      * @example
      *     await client.skills.executeSkill({
@@ -587,6 +594,8 @@ export 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,
@@ -621,6 +630,7 @@ export class Skills {
      * @throws {@link BrowserUse.BadRequestError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
      *
      * @example
      *     await client.skills.refineSkill({
@@ -661,6 +671,8 @@ export 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,
@@ -686,6 +698,154 @@ export 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 = 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, `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 = 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, `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/esm/api/resources/skills/client/requests/GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest.d.mts

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

package/dist/esm/api/resources/skills/client/requests/GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/skills/client/requests/ListSkillExecutionsSkillsSkillIdExecutionsGetRequest.d.mts

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

package/dist/esm/api/resources/skills/client/requests/ListSkillExecutionsSkillsSkillIdExecutionsGetRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/skills/client/requests/index.d.mts

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

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

@@ -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/esm/api/resources/tasks/client/Client.mjs

@@ -113,12 +113,15 @@ export 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.
@@ -330,6 +333,82 @@ export 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 = 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, `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/esm/api/resources/tasks/client/requests/GetTaskStatusTasksTaskIdStatusGetRequest.d.mts

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

package/dist/esm/api/resources/tasks/client/requests/GetTaskStatusTasksTaskIdStatusGetRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/tasks/client/requests/index.d.mts

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

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

@@ -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/esm/api/types/BrowserSessionView.d.mts

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

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

@@ -0,0 +1,13 @@
+/**
+ * Request model for creating a custom proxy.
+ */
+export interface CustomProxy {
+    /** Host of the proxy. */
+    host: string;
+    /** Port of the proxy. */
+    port: number;
+    /** Username for proxy authentication. */
+    username?: string | null;
+    /** Password for proxy authentication. */
+    password?: string | null;
+}

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

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

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

@@ -4,4 +4,6 @@
 export interface ExecuteSkillRequest {
     /** Parameters to pass to the skill handler */
     parameters?: Record<string, unknown>;
+    /** Optional session ID (UUID) for IP persistence. */
+    sessionId?: string | null;
 }

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

@@ -1,5 +1,5 @@
 /**
- * Error response when user has insufficient credits
+ * Error response when there are insufficient credits
  */
 export interface InsufficientCreditsError {
     detail?: string;

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

@@ -15,4 +15,10 @@ export interface SessionItemView {
     finishedAt?: string | null;
     /** Whether tasks in this session share memory and history with each other */
     persistMemory: boolean;
+    /** Whether the browser session stays alive after tasks complete */
+    keepAlive: boolean;
+    /** Amount of proxy data used in MB */
+    proxyUsedMb?: string;
+    /** Cost of proxy usage in USD */
+    proxyCost?: string;
 }

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

@@ -19,4 +19,10 @@ export interface SessionView {
     publicShareUrl?: string | null;
     /** Whether tasks in this session share memory and history with each other */
     persistMemory?: boolean;
+    /** Whether the browser session stays alive after tasks complete */
+    keepAlive?: boolean;
+    /** Amount of proxy data used in MB */
+    proxyUsedMb?: string;
+    /** Cost of proxy usage in USD */
+    proxyCost?: string;
 }

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

@@ -0,0 +1,14 @@
+import type * as BrowserUse from "../index.mjs";
+/**
+ * Response for listing skill executions.
+ */
+export interface SkillExecutionListResponse {
+    /** List of executions */
+    items: BrowserUse.SkillExecutionView[];
+    /** Total number of items in the list */
+    totalItems: number;
+    /** Page number */
+    pageNumber: number;
+    /** Number of items per page */
+    pageSize: number;
+}

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

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

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

@@ -0,0 +1,7 @@
+/**
+ * Response containing presigned URL for downloading execution output.
+ */
+export interface SkillExecutionOutputResponse {
+    /** Presigned URL for downloading the execution output (valid for 5 minutes) */
+    downloadUrl: string;
+}

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

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

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

@@ -0,0 +1,21 @@
+/**
+ * View for a skill execution.
+ */
+export interface SkillExecutionView {
+    /** Unique identifier for the execution */
+    id: string;
+    /** ID of the skill that was executed */
+    skillId: string;
+    /** Execution status (running, completed, failed) */
+    status: string;
+    /** Whether the execution succeeded */
+    success: boolean;
+    /** When the execution started */
+    startedAt: string;
+    /** When the execution finished */
+    finishedAt: string | null;
+    /** Execution latency in milliseconds */
+    latencyMs: number | null;
+    /** Whether output is available for download */
+    hasOutput: boolean;
+}

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

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

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

@@ -1,5 +1,6 @@
 export declare const SupportedLlMs: {
     readonly BrowserUseLlm: "browser-use-llm";
+    readonly BrowserUse20: "browser-use-2.0";
     readonly Gpt41: "gpt-4.1";
     readonly Gpt41Mini: "gpt-4.1-mini";
     readonly O4Mini: "o4-mini";
@@ -7,6 +8,7 @@ export declare const SupportedLlMs: {
     readonly Gemini25Flash: "gemini-2.5-flash";
     readonly Gemini25Pro: "gemini-2.5-pro";
     readonly Gemini3ProPreview: "gemini-3-pro-preview";
+    readonly Gemini3FlashPreview: "gemini-3-flash-preview";
     readonly GeminiFlashLatest: "gemini-flash-latest";
     readonly GeminiFlashLiteLatest: "gemini-flash-lite-latest";
     readonly ClaudeSonnet420250514: "claude-sonnet-4-20250514";

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

@@ -1,6 +1,7 @@
 // This file was auto-generated by Fern from our API Definition.
 export const SupportedLlMs = {
     BrowserUseLlm: "browser-use-llm",
+    BrowserUse20: "browser-use-2.0",
     Gpt41: "gpt-4.1",
     Gpt41Mini: "gpt-4.1-mini",
     O4Mini: "o4-mini",
@@ -8,6 +9,7 @@ export const SupportedLlMs = {
     Gemini25Flash: "gemini-2.5-flash",
     Gemini25Pro: "gemini-2.5-pro",
     Gemini3ProPreview: "gemini-3-pro-preview",
+    Gemini3FlashPreview: "gemini-3-flash-preview",
     GeminiFlashLatest: "gemini-flash-latest",
     GeminiFlashLiteLatest: "gemini-flash-lite-latest",
     ClaudeSonnet420250514: "claude-sonnet-4-20250514",

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

@@ -30,4 +30,8 @@ export interface TaskItemView {
     judgement?: string | null;
     /** Judge verdict - True if the judge found the task to be successful, False otherwise (None if judge is not enabled) */
     judgeVerdict?: boolean | null;
+    /** Total cost of the task in USD. This is the sum of all step costs incurred during task execution. */
+    cost?: string | null;
+    /** List of actionable suggestions for improving task configuration based on detected issues during execution. */
+    suggestions?: Record<string, unknown>[] | null;
 }

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

@@ -0,0 +1,19 @@
+import type * as BrowserUse from "../index.mjs";
+/**
+ * Lightweight view optimized for polling. Use GET /tasks/{id}/status for efficient polling
+ * instead of GET /tasks/{id} which loads full step details.
+ */
+export interface TaskStatusView {
+    /** Unique identifier for the task */
+    id: string;
+    /** Current status of the task */
+    status: BrowserUse.TaskStatus;
+    /** Final output/result of the task (null while running) */
+    output?: string | null;
+    /** Naive UTC timestamp when the task completed (null if still running) */
+    finishedAt?: string | null;
+    /** Whether the task was successful based on the agent's self-reported output */
+    isSuccess?: boolean | null;
+    /** Total cost of the task in USD */
+    cost?: string | null;
+}

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

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};