browser-use-sdk 2.0.12 → 2.0.14

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

@@ -25,7 +25,7 @@ import * as environments from "../../../../environments.mjs";
 import * as errors from "../../../../errors/index.mjs";
 import * as BrowserUse from "../../../index.mjs";
 export class Skills {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**
@@ -45,7 +45,7 @@ export class Skills {
     __listSkills() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
-            const { pageSize, pageNumber, isPublic, isEnabled, query, fromDate, toDate } = request;
+            const { pageSize, pageNumber, isPublic, isEnabled, category, query, fromDate, toDate } = request;
             const _queryParams = {};
             if (pageSize != null) {
                 _queryParams.pageSize = pageSize.toString();
@@ -59,6 +59,9 @@ export class Skills {
             if (isEnabled !== undefined) {
                 _queryParams.isEnabled = (_b = isEnabled === null || isEnabled === void 0 ? void 0 : isEnabled.toString()) !== null && _b !== void 0 ? _b : null;
             }
+            if (category !== undefined) {
+                _queryParams.category = category;
+            }
             if (query !== undefined) {
                 _queryParams.query = query;
             }
@@ -119,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({
@@ -155,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,
@@ -325,6 +334,7 @@ export class Skills {
      * @param {BrowserUse.UpdateSkillRequest} request
      * @param {Skills.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link BrowserUse.ForbiddenError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
      *
@@ -360,6 +370,8 @@ export class Skills {
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
+                    case 403:
+                        throw new BrowserUse.ForbiddenError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new BrowserUse.NotFoundError(_response.error.body, _response.rawResponse);
                     case 422:
@@ -532,17 +544,19 @@ export class Skills {
     /**
      * Execute a skill with the provided parameters.
      *
-     * @param {BrowserUse.ExecuteSkillRequest} request
+     * @param {BrowserUse.ExecuteSkillSkillsSkillIdExecutePostRequest} request
      * @param {Skills.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link BrowserUse.BadRequestError}
      * @throws {@link BrowserUse.PaymentRequiredError}
      * @throws {@link BrowserUse.NotFoundError}
      * @throws {@link BrowserUse.UnprocessableEntityError}
+     * @throws {@link BrowserUse.TooManyRequestsError}
      *
      * @example
      *     await client.skills.executeSkill({
-     *         skill_id: "skill_id"
+     *         skill_id: "skill_id",
+     *         body: {}
      *     })
      */
     executeSkill(request, requestOptions) {
@@ -551,7 +565,7 @@ export class Skills {
     __executeSkill(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { skill_id: skillId } = request, _body = __rest(request, ["skill_id"]);
+            const { skill_id: skillId, body: _body } = 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)}/execute`),
@@ -580,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,
@@ -614,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({
@@ -654,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,
@@ -679,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/ExecuteSkillSkillsSkillIdExecutePostRequest.d.mts

@@ -0,0 +1,12 @@
+import type * as BrowserUse from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         skill_id: "skill_id",
+ *         body: {}
+ *     }
+ */
+export interface ExecuteSkillSkillsSkillIdExecutePostRequest {
+    skill_id: string;
+    body: BrowserUse.ExecuteSkillRequest;
+}

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/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/ListSkillsSkillsGetRequest.d.mts

@@ -1,3 +1,4 @@
+import type * as BrowserUse from "../../../../index.mjs";
 /**
  * @example
  *     {}
@@ -7,6 +8,7 @@ export interface ListSkillsSkillsGetRequest {
     pageNumber?: number;
     isPublic?: boolean | null;
     isEnabled?: boolean | null;
+    category?: BrowserUse.SkillCategory | null;
     query?: string | null;
     fromDate?: string | null;
     toDate?: string | null;

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

@@ -1,3 +1,4 @@
+import type * as BrowserUse from "../../../../index.mjs";
 /**
  * @example
  *     {
@@ -10,8 +11,10 @@ export interface UpdateSkillRequest {
     title?: string | null;
     /** Description of what the skill does (shows up in the public view) */
     description?: string | null;
+    /** Categories to assign to the skill */
+    categories?: BrowserUse.SkillCategory[] | null;
+    /** Domains/websites this skill interacts with */
+    domains?: string[] | null;
     /** Whether the skill is enabled for execution */
     isEnabled?: boolean | null;
-    /** Whether the skill is publicly available */
-    isPublic?: boolean | null;
 }

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

@@ -1,8 +1,10 @@
 export type { CancelGenerationSkillsSkillIdCancelPostRequest } from "./CancelGenerationSkillsSkillIdCancelPostRequest.mjs";
 export type { CreateSkillRequest } from "./CreateSkillRequest.mjs";
 export type { DeleteSkillSkillsSkillIdDeleteRequest } from "./DeleteSkillSkillsSkillIdDeleteRequest.mjs";
-export type { ExecuteSkillRequest } from "./ExecuteSkillRequest.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/skillsMarketplace/client/Client.d.mts

@@ -9,7 +9,7 @@ export declare namespace SkillsMarketplace {
 }
 export declare class SkillsMarketplace {
     protected readonly _options: SkillsMarketplace.Options;
-    constructor(_options: SkillsMarketplace.Options);
+    constructor(_options?: SkillsMarketplace.Options);
     /**
      * List all public skills available in the marketplace with optional filtering.
      *
@@ -26,7 +26,7 @@ export declare class SkillsMarketplace {
     /**
      * Get details of a specific public skill from the marketplace.
      *
-     * @param {BrowserUse.GetSkillMarketplaceSkillsSkillIdGetRequest} request
+     * @param {BrowserUse.GetSkillMarketplaceSkillsSkillSlugGetRequest} request
      * @param {SkillsMarketplace.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link BrowserUse.NotFoundError}
@@ -34,10 +34,10 @@ export declare class SkillsMarketplace {
      *
      * @example
      *     await client.skillsMarketplace.getSkill({
-     *         skill_id: "skill_id"
+     *         skill_slug: "skill_slug"
      *     })
      */
-    getSkill(request: BrowserUse.GetSkillMarketplaceSkillsSkillIdGetRequest, requestOptions?: SkillsMarketplace.RequestOptions): core.HttpResponsePromise<BrowserUse.MarketplaceSkillResponse>;
+    getSkill(request: BrowserUse.GetSkillMarketplaceSkillsSkillSlugGetRequest, requestOptions?: SkillsMarketplace.RequestOptions): core.HttpResponsePromise<BrowserUse.MarketplaceSkillResponse>;
     private __getSkill;
     /**
      * Clone a public marketplace skill to the user's project.
@@ -54,7 +54,26 @@ export declare class SkillsMarketplace {
      *         skill_id: "skill_id"
      *     })
      */
-    cloneSkill(request: BrowserUse.CloneSkillMarketplaceSkillsSkillIdClonePostRequest, requestOptions?: SkillsMarketplace.RequestOptions): core.HttpResponsePromise<BrowserUse.MarketplaceSkillResponse>;
+    cloneSkill(request: BrowserUse.CloneSkillMarketplaceSkillsSkillIdClonePostRequest, requestOptions?: SkillsMarketplace.RequestOptions): core.HttpResponsePromise<BrowserUse.SkillResponse>;
     private __cloneSkill;
+    /**
+     * Execute a skill with the provided parameters.
+     *
+     * @param {BrowserUse.ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest} request
+     * @param {SkillsMarketplace.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.BadRequestError}
+     * @throws {@link BrowserUse.PaymentRequiredError}
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.skillsMarketplace.executeSkill({
+     *         skill_id: "skill_id",
+     *         body: {}
+     *     })
+     */
+    executeSkill(request: BrowserUse.ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest, requestOptions?: SkillsMarketplace.RequestOptions): core.HttpResponsePromise<BrowserUse.ExecuteSkillResponse>;
+    private __executeSkill;
     protected _getCustomAuthorizationHeaders(): Promise<Record<string, string | undefined>>;
 }

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

@@ -14,7 +14,7 @@ import * as environments from "../../../../environments.mjs";
 import * as errors from "../../../../errors/index.mjs";
 import * as BrowserUse from "../../../index.mjs";
 export class SkillsMarketplace {
-    constructor(_options) {
+    constructor(_options = {}) {
         this._options = _options;
     }
     /**
@@ -34,7 +34,7 @@ export class SkillsMarketplace {
     __listSkills() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { pageSize, pageNumber, query, fromDate, toDate } = request;
+            const { pageSize, pageNumber, query, category, fromDate, toDate } = request;
             const _queryParams = {};
             if (pageSize != null) {
                 _queryParams.pageSize = pageSize.toString();
@@ -45,6 +45,9 @@ export class SkillsMarketplace {
             if (query !== undefined) {
                 _queryParams.query = query;
             }
+            if (category !== undefined) {
+                _queryParams.category = category;
+            }
             if (fromDate !== undefined) {
                 _queryParams.fromDate = fromDate;
             }
@@ -101,7 +104,7 @@ export class SkillsMarketplace {
     /**
      * Get details of a specific public skill from the marketplace.
      *
-     * @param {BrowserUse.GetSkillMarketplaceSkillsSkillIdGetRequest} request
+     * @param {BrowserUse.GetSkillMarketplaceSkillsSkillSlugGetRequest} request
      * @param {SkillsMarketplace.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link BrowserUse.NotFoundError}
@@ -109,7 +112,7 @@ export class SkillsMarketplace {
      *
      * @example
      *     await client.skillsMarketplace.getSkill({
-     *         skill_id: "skill_id"
+     *         skill_slug: "skill_slug"
      *     })
      */
     getSkill(request, requestOptions) {
@@ -118,10 +121,10 @@ export class SkillsMarketplace {
     __getSkill(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { skill_id: skillId } = request;
+            const { skill_slug: skillSlug } = 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, `marketplace/skills/${core.url.encodePathParam(skillId)}`),
+                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, `marketplace/skills/${core.url.encodePathParam(skillSlug)}`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -156,7 +159,7 @@ export class SkillsMarketplace {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling GET /marketplace/skills/{skill_id}.");
+                    throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling GET /marketplace/skills/{skill_slug}.");
                 case "unknown":
                     throw new errors.BrowserUseError({
                         message: _response.error.errorMessage,
@@ -235,6 +238,83 @@ export class SkillsMarketplace {
             }
         });
     }
+    /**
+     * Execute a skill with the provided parameters.
+     *
+     * @param {BrowserUse.ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest} request
+     * @param {SkillsMarketplace.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link BrowserUse.BadRequestError}
+     * @throws {@link BrowserUse.PaymentRequiredError}
+     * @throws {@link BrowserUse.NotFoundError}
+     * @throws {@link BrowserUse.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.skillsMarketplace.executeSkill({
+     *         skill_id: "skill_id",
+     *         body: {}
+     *     })
+     */
+    executeSkill(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__executeSkill(request, requestOptions));
+    }
+    __executeSkill(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { skill_id: skillId, body: _body } = 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, `marketplace/skills/${core.url.encodePathParam(skillId)}/execute`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: _body,
+                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 400:
+                        throw new BrowserUse.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 402:
+                        throw new BrowserUse.PaymentRequiredError(_response.error.body, _response.rawResponse);
+                    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 POST /marketplace/skills/{skill_id}/execute.");
+                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/skillsMarketplace/client/requests/ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest.d.mts

@@ -0,0 +1,12 @@
+import type * as BrowserUse from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         skill_id: "skill_id",
+ *         body: {}
+ *     }
+ */
+export interface ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest {
+    skill_id: string;
+    body: BrowserUse.ExecuteSkillRequest;
+}

package/dist/esm/api/resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillSlugGetRequest.d.mts

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

package/dist/esm/api/resources/skillsMarketplace/client/requests/ListSkillsMarketplaceSkillsGetRequest.d.mts

@@ -1,3 +1,4 @@
+import type * as BrowserUse from "../../../../index.mjs";
 /**
  * @example
  *     {}
@@ -6,6 +7,7 @@ export interface ListSkillsMarketplaceSkillsGetRequest {
     pageSize?: number;
     pageNumber?: number;
     query?: string | null;
+    category?: BrowserUse.SkillCategory | null;
     fromDate?: string | null;
     toDate?: string | null;
 }

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

@@ -1,3 +1,4 @@
 export type { CloneSkillMarketplaceSkillsSkillIdClonePostRequest } from "./CloneSkillMarketplaceSkillsSkillIdClonePostRequest.mjs";
-export type { GetSkillMarketplaceSkillsSkillIdGetRequest } from "./GetSkillMarketplaceSkillsSkillIdGetRequest.mjs";
+export type { ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest } from "./ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest.mjs";
+export type { GetSkillMarketplaceSkillsSkillSlugGetRequest } from "./GetSkillMarketplaceSkillsSkillSlugGetRequest.mjs";
 export type { ListSkillsMarketplaceSkillsGetRequest } from "./ListSkillsMarketplaceSkillsGetRequest.mjs";

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

@@ -9,7 +9,7 @@ export declare namespace Tasks {
 }
 export declare class Tasks {
     protected readonly _options: Tasks.Options;
-    constructor(_options: Tasks.Options);
+    constructor(_options?: Tasks.Options);
     /**
      * Get paginated list of AI agent tasks with optional filtering by session and status.
      *
@@ -24,9 +24,18 @@ export declare class Tasks {
     listTasks(request?: BrowserUse.ListTasksTasksGetRequest, requestOptions?: Tasks.RequestOptions): core.HttpResponsePromise<BrowserUse.TaskListResponse>;
     private __listTasks;
     /**
+     * Create and start a new task.
+     *
      * You can either:
-     * 1. Start a new task (auto creates a new simple session)
-     * 2. Start a new task in an existing session (you can create a custom session before starting the task and reuse it for follow-up tasks)
+     * 1. Start a new task without a sessionId (auto-creates a session with US proxy by default).
+     *    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) 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.