browser-use-sdk 2.0.11 → 2.0.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (168) hide show
  1. package/dist/cjs/BaseClient.d.ts +1 -1
  2. package/dist/cjs/Client.d.ts +1 -1
  3. package/dist/cjs/Client.js +3 -3
  4. package/dist/cjs/api/errors/ForbiddenError.d.ts +1 -2
  5. package/dist/cjs/api/resources/billing/client/Client.d.ts +2 -2
  6. package/dist/cjs/api/resources/billing/client/Client.js +2 -2
  7. package/dist/cjs/api/resources/browsers/client/Client.d.ts +9 -7
  8. package/dist/cjs/api/resources/browsers/client/Client.js +9 -7
  9. package/dist/cjs/api/resources/browsers/client/requests/CreateBrowserSessionRequest.d.ts +1 -1
  10. package/dist/cjs/api/resources/files/client/Client.d.ts +1 -1
  11. package/dist/cjs/api/resources/files/client/Client.js +1 -1
  12. package/dist/cjs/api/resources/profiles/client/Client.d.ts +1 -1
  13. package/dist/cjs/api/resources/profiles/client/Client.js +1 -1
  14. package/dist/cjs/api/resources/sessions/client/Client.d.ts +1 -1
  15. package/dist/cjs/api/resources/sessions/client/Client.js +1 -1
  16. package/dist/cjs/api/resources/sessions/client/requests/CreateSessionRequest.d.ts +2 -0
  17. package/dist/cjs/api/resources/skills/client/Client.d.ts +25 -6
  18. package/dist/cjs/api/resources/skills/client/Client.js +85 -8
  19. package/dist/cjs/api/resources/skills/client/requests/CancelGenerationSkillsSkillIdCancelPostRequest.d.ts +9 -0
  20. package/dist/cjs/api/resources/skills/client/requests/CancelGenerationSkillsSkillIdCancelPostRequest.js +3 -0
  21. package/dist/cjs/api/resources/skills/client/requests/ExecuteSkillSkillsSkillIdExecutePostRequest.d.ts +12 -0
  22. package/dist/cjs/api/resources/skills/client/requests/ExecuteSkillSkillsSkillIdExecutePostRequest.js +3 -0
  23. package/dist/cjs/api/resources/skills/client/requests/ListSkillsSkillsGetRequest.d.ts +2 -0
  24. package/dist/cjs/api/resources/skills/client/requests/RollbackSkillSkillsSkillIdRollbackPostRequest.d.ts +9 -0
  25. package/dist/cjs/api/resources/skills/client/requests/RollbackSkillSkillsSkillIdRollbackPostRequest.js +3 -0
  26. package/dist/cjs/api/resources/skills/client/requests/UpdateSkillRequest.d.ts +5 -2
  27. package/dist/cjs/api/resources/skills/client/requests/index.d.ts +3 -2
  28. package/dist/cjs/api/resources/skillsMarketplace/client/Client.d.ts +24 -5
  29. package/dist/cjs/api/resources/skillsMarketplace/client/Client.js +87 -7
  30. package/dist/cjs/api/resources/skillsMarketplace/client/requests/ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest.d.ts +12 -0
  31. package/dist/cjs/api/resources/skillsMarketplace/client/requests/ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest.js +3 -0
  32. package/dist/cjs/api/resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillSlugGetRequest.d.ts +9 -0
  33. package/dist/cjs/api/resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillSlugGetRequest.js +3 -0
  34. package/dist/cjs/api/resources/skillsMarketplace/client/requests/ListSkillsMarketplaceSkillsGetRequest.d.ts +2 -0
  35. package/dist/cjs/api/resources/skillsMarketplace/client/requests/index.d.ts +2 -1
  36. package/dist/cjs/api/resources/tasks/client/Client.d.ts +9 -3
  37. package/dist/cjs/api/resources/tasks/client/Client.js +9 -3
  38. package/dist/cjs/api/resources/tasks/client/requests/CreateTaskRequest.d.ts +2 -0
  39. package/dist/cjs/api/resources/workflows/client/Client.d.ts +29 -1
  40. package/dist/cjs/api/resources/workflows/client/Client.js +85 -1
  41. package/dist/cjs/api/resources/workflows/client/requests/WorkflowCreateFromTaskRequest.d.ts +18 -0
  42. package/dist/cjs/api/resources/workflows/client/requests/WorkflowCreateFromTaskRequest.js +3 -0
  43. package/dist/cjs/api/resources/workflows/client/requests/index.d.ts +1 -0
  44. package/dist/cjs/api/types/AccountNotFoundError.d.ts +1 -1
  45. package/dist/cjs/api/types/AccountView.d.ts +5 -5
  46. package/dist/cjs/api/types/AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.d.ts +6 -0
  47. package/dist/cjs/api/types/AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.js +3 -0
  48. package/dist/cjs/api/types/AppEndpointsApiV2SkillsViewsInsufficientCreditsError.d.ts +6 -0
  49. package/dist/cjs/api/types/AppEndpointsApiV2SkillsViewsInsufficientCreditsError.js +3 -0
  50. package/dist/cjs/api/types/CannotRollbackPublicSkillError.d.ts +6 -0
  51. package/dist/cjs/api/types/CannotRollbackPublicSkillError.js +3 -0
  52. package/dist/cjs/api/types/CommonUtilsErrorsInsufficientCreditsError.d.ts +6 -0
  53. package/dist/cjs/api/types/CommonUtilsErrorsInsufficientCreditsError.js +3 -0
  54. package/dist/cjs/api/types/EnabledSkillsLimitExceededError.d.ts +6 -0
  55. package/dist/cjs/api/types/EnabledSkillsLimitExceededError.js +3 -0
  56. package/dist/cjs/api/types/ExecuteSkillRequest.d.ts +7 -0
  57. package/dist/cjs/api/types/ExecuteSkillRequest.js +3 -0
  58. package/dist/cjs/api/types/MarketplaceSkillResponse.d.ts +15 -1
  59. package/dist/cjs/api/types/ParameterSchema.d.ts +1 -0
  60. package/dist/cjs/api/types/ParameterType.d.ts +1 -0
  61. package/dist/cjs/api/types/ParameterType.js +1 -0
  62. package/dist/cjs/api/types/SessionItemView.d.ts +2 -0
  63. package/dist/cjs/api/types/SessionStatus.d.ts +3 -3
  64. package/dist/cjs/api/types/SessionStatus.js +3 -3
  65. package/dist/cjs/api/types/SessionTimeoutLimitExceededError.d.ts +1 -1
  66. package/dist/cjs/api/types/SessionView.d.ts +2 -0
  67. package/dist/cjs/api/types/SkillCategory.d.ts +20 -0
  68. package/dist/cjs/api/types/SkillCategory.js +23 -0
  69. package/dist/cjs/api/types/SkillResponse.d.ts +19 -3
  70. package/dist/cjs/api/types/SkillsGenerationStatus.d.ts +1 -0
  71. package/dist/cjs/api/types/SkillsGenerationStatus.js +1 -0
  72. package/dist/cjs/api/types/WorkflowCreateFromTaskResponse.d.ts +11 -0
  73. package/dist/cjs/api/types/WorkflowCreateFromTaskResponse.js +3 -0
  74. package/dist/cjs/api/types/WorkflowExecutionResponse.d.ts +4 -0
  75. package/dist/cjs/api/types/WorkflowExecutionStateView.d.ts +4 -0
  76. package/dist/cjs/api/types/WorkflowExecutionStepView.d.ts +4 -4
  77. package/dist/cjs/api/types/WorkflowGenerationStateView.d.ts +6 -0
  78. package/dist/cjs/api/types/WorkflowItemView.d.ts +7 -0
  79. package/dist/cjs/api/types/WorkflowResponse.d.ts +2 -0
  80. package/dist/cjs/api/types/index.d.ts +10 -6
  81. package/dist/cjs/api/types/index.js +10 -6
  82. package/dist/cjs/version.d.ts +1 -1
  83. package/dist/cjs/version.js +1 -1
  84. package/dist/esm/BaseClient.d.mts +1 -1
  85. package/dist/esm/Client.d.mts +1 -1
  86. package/dist/esm/Client.mjs +3 -3
  87. package/dist/esm/api/errors/ForbiddenError.d.mts +1 -2
  88. package/dist/esm/api/resources/billing/client/Client.d.mts +2 -2
  89. package/dist/esm/api/resources/billing/client/Client.mjs +2 -2
  90. package/dist/esm/api/resources/browsers/client/Client.d.mts +9 -7
  91. package/dist/esm/api/resources/browsers/client/Client.mjs +9 -7
  92. package/dist/esm/api/resources/browsers/client/requests/CreateBrowserSessionRequest.d.mts +1 -1
  93. package/dist/esm/api/resources/files/client/Client.d.mts +1 -1
  94. package/dist/esm/api/resources/files/client/Client.mjs +1 -1
  95. package/dist/esm/api/resources/profiles/client/Client.d.mts +1 -1
  96. package/dist/esm/api/resources/profiles/client/Client.mjs +1 -1
  97. package/dist/esm/api/resources/sessions/client/Client.d.mts +1 -1
  98. package/dist/esm/api/resources/sessions/client/Client.mjs +1 -1
  99. package/dist/esm/api/resources/sessions/client/requests/CreateSessionRequest.d.mts +2 -0
  100. package/dist/esm/api/resources/skills/client/Client.d.mts +25 -6
  101. package/dist/esm/api/resources/skills/client/Client.mjs +85 -8
  102. package/dist/esm/api/resources/skills/client/requests/CancelGenerationSkillsSkillIdCancelPostRequest.d.mts +9 -0
  103. package/dist/esm/api/resources/skills/client/requests/CancelGenerationSkillsSkillIdCancelPostRequest.mjs +2 -0
  104. package/dist/esm/api/resources/skills/client/requests/ExecuteSkillSkillsSkillIdExecutePostRequest.d.mts +12 -0
  105. package/dist/esm/api/resources/skills/client/requests/ExecuteSkillSkillsSkillIdExecutePostRequest.mjs +2 -0
  106. package/dist/esm/api/resources/skills/client/requests/ListSkillsSkillsGetRequest.d.mts +2 -0
  107. package/dist/esm/api/resources/skills/client/requests/RollbackSkillSkillsSkillIdRollbackPostRequest.d.mts +9 -0
  108. package/dist/esm/api/resources/skills/client/requests/RollbackSkillSkillsSkillIdRollbackPostRequest.mjs +2 -0
  109. package/dist/esm/api/resources/skills/client/requests/UpdateSkillRequest.d.mts +5 -2
  110. package/dist/esm/api/resources/skills/client/requests/index.d.mts +3 -2
  111. package/dist/esm/api/resources/skillsMarketplace/client/Client.d.mts +24 -5
  112. package/dist/esm/api/resources/skillsMarketplace/client/Client.mjs +87 -7
  113. package/dist/esm/api/resources/skillsMarketplace/client/requests/ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest.d.mts +12 -0
  114. package/dist/esm/api/resources/skillsMarketplace/client/requests/ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest.mjs +2 -0
  115. package/dist/esm/api/resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillSlugGetRequest.d.mts +9 -0
  116. package/dist/esm/api/resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillSlugGetRequest.mjs +2 -0
  117. package/dist/esm/api/resources/skillsMarketplace/client/requests/ListSkillsMarketplaceSkillsGetRequest.d.mts +2 -0
  118. package/dist/esm/api/resources/skillsMarketplace/client/requests/index.d.mts +2 -1
  119. package/dist/esm/api/resources/tasks/client/Client.d.mts +9 -3
  120. package/dist/esm/api/resources/tasks/client/Client.mjs +9 -3
  121. package/dist/esm/api/resources/tasks/client/requests/CreateTaskRequest.d.mts +2 -0
  122. package/dist/esm/api/resources/workflows/client/Client.d.mts +29 -1
  123. package/dist/esm/api/resources/workflows/client/Client.mjs +85 -1
  124. package/dist/esm/api/resources/workflows/client/requests/WorkflowCreateFromTaskRequest.d.mts +18 -0
  125. package/dist/esm/api/resources/workflows/client/requests/WorkflowCreateFromTaskRequest.mjs +2 -0
  126. package/dist/esm/api/resources/workflows/client/requests/index.d.mts +1 -0
  127. package/dist/esm/api/types/AccountNotFoundError.d.mts +1 -1
  128. package/dist/esm/api/types/AccountView.d.mts +5 -5
  129. package/dist/esm/api/types/AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.d.mts +6 -0
  130. package/dist/esm/api/types/AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.mjs +2 -0
  131. package/dist/esm/api/types/AppEndpointsApiV2SkillsViewsInsufficientCreditsError.d.mts +6 -0
  132. package/dist/esm/api/types/AppEndpointsApiV2SkillsViewsInsufficientCreditsError.mjs +2 -0
  133. package/dist/esm/api/types/CannotRollbackPublicSkillError.d.mts +6 -0
  134. package/dist/esm/api/types/CannotRollbackPublicSkillError.mjs +2 -0
  135. package/dist/esm/api/types/CommonUtilsErrorsInsufficientCreditsError.d.mts +6 -0
  136. package/dist/esm/api/types/CommonUtilsErrorsInsufficientCreditsError.mjs +2 -0
  137. package/dist/esm/api/types/EnabledSkillsLimitExceededError.d.mts +6 -0
  138. package/dist/esm/api/types/EnabledSkillsLimitExceededError.mjs +2 -0
  139. package/dist/esm/api/types/ExecuteSkillRequest.d.mts +7 -0
  140. package/dist/esm/api/types/ExecuteSkillRequest.mjs +2 -0
  141. package/dist/esm/api/types/MarketplaceSkillResponse.d.mts +15 -1
  142. package/dist/esm/api/types/ParameterSchema.d.mts +1 -0
  143. package/dist/esm/api/types/ParameterType.d.mts +1 -0
  144. package/dist/esm/api/types/ParameterType.mjs +1 -0
  145. package/dist/esm/api/types/SessionItemView.d.mts +2 -0
  146. package/dist/esm/api/types/SessionStatus.d.mts +3 -3
  147. package/dist/esm/api/types/SessionStatus.mjs +3 -3
  148. package/dist/esm/api/types/SessionTimeoutLimitExceededError.d.mts +1 -1
  149. package/dist/esm/api/types/SessionView.d.mts +2 -0
  150. package/dist/esm/api/types/SkillCategory.d.mts +20 -0
  151. package/dist/esm/api/types/SkillCategory.mjs +20 -0
  152. package/dist/esm/api/types/SkillResponse.d.mts +19 -3
  153. package/dist/esm/api/types/SkillsGenerationStatus.d.mts +1 -0
  154. package/dist/esm/api/types/SkillsGenerationStatus.mjs +1 -0
  155. package/dist/esm/api/types/WorkflowCreateFromTaskResponse.d.mts +11 -0
  156. package/dist/esm/api/types/WorkflowCreateFromTaskResponse.mjs +2 -0
  157. package/dist/esm/api/types/WorkflowExecutionResponse.d.mts +4 -0
  158. package/dist/esm/api/types/WorkflowExecutionStateView.d.mts +4 -0
  159. package/dist/esm/api/types/WorkflowExecutionStepView.d.mts +4 -4
  160. package/dist/esm/api/types/WorkflowGenerationStateView.d.mts +6 -0
  161. package/dist/esm/api/types/WorkflowItemView.d.mts +7 -0
  162. package/dist/esm/api/types/WorkflowResponse.d.mts +2 -0
  163. package/dist/esm/api/types/index.d.mts +10 -6
  164. package/dist/esm/api/types/index.mjs +10 -6
  165. package/dist/esm/version.d.mts +1 -1
  166. package/dist/esm/version.mjs +1 -1
  167. package/package.json +83 -82
  168. package/reference.md +232 -15
@@ -42,6 +42,8 @@ export interface CreateTaskRequest {
42
42
  judgeGroundTruth?: string | null;
43
43
  /** The LLM model to use for judging. If not provided, uses the default judge LLM. */
44
44
  judgeLlm?: BrowserUse.SupportedLlMs | null;
45
+ /** List of skill IDs to enable for this task. Use ['*'] to enable all available skills for the project. */
46
+ skillIds?: string[] | null;
45
47
  }
46
48
  export declare namespace CreateTaskRequest {
47
49
  /**
@@ -9,7 +9,7 @@ export declare namespace Workflows {
9
9
  }
10
10
  export declare class Workflows {
11
11
  protected readonly _options: Workflows.Options;
12
- constructor(_options: Workflows.Options);
12
+ constructor(_options?: Workflows.Options);
13
13
  /**
14
14
  * Get paginated list of workflows with optional filtering.
15
15
  *
@@ -102,6 +102,34 @@ export declare class Workflows {
102
102
  */
103
103
  getWorkflowGenerationState(request: BrowserUse.GetWorkflowGenerationStateWorkflowsWorkflowIdGenerationStateGetRequest, requestOptions?: Workflows.RequestOptions): core.HttpResponsePromise<BrowserUse.WorkflowGenerationStateView>;
104
104
  private __getWorkflowGenerationState;
105
+ /**
106
+ * Create a workflow from an existing agent task's recorded history.
107
+ *
108
+ * This endpoint creates a workflow by using the browser-use rerun history
109
+ * feature. The task must have completed with history stored in S3.
110
+ *
111
+ * The workflow creation process:
112
+ * 1. Creates a new workflow record in pending state
113
+ * 2. Triggers an Inngest event to process the task history
114
+ * 3. The Inngest handler downloads history, detects variables, and updates the workflow
115
+ *
116
+ * Use GET /workflows/{workflow_id} to poll for creation completion.
117
+ *
118
+ * @param {BrowserUse.WorkflowCreateFromTaskRequest} request
119
+ * @param {Workflows.RequestOptions} requestOptions - Request-specific configuration.
120
+ *
121
+ * @throws {@link BrowserUse.NotFoundError}
122
+ * @throws {@link BrowserUse.UnprocessableEntityError}
123
+ *
124
+ * @example
125
+ * await client.workflows.createWorkflowFromTask({
126
+ * name: "name",
127
+ * taskId: "taskId",
128
+ * sessionId: "sessionId"
129
+ * })
130
+ */
131
+ createWorkflowFromTask(request: BrowserUse.WorkflowCreateFromTaskRequest, requestOptions?: Workflows.RequestOptions): core.HttpResponsePromise<BrowserUse.WorkflowCreateFromTaskResponse>;
132
+ private __createWorkflowFromTask;
105
133
  /**
106
134
  * Get a presigned URL to upload workflow YAML directly to S3 from the browser.
107
135
  *
@@ -25,7 +25,7 @@ import * as environments from "../../../../environments.mjs";
25
25
  import * as errors from "../../../../errors/index.mjs";
26
26
  import * as BrowserUse from "../../../index.mjs";
27
27
  export class Workflows {
28
- constructor(_options) {
28
+ constructor(_options = {}) {
29
29
  this._options = _options;
30
30
  }
31
31
  /**
@@ -435,6 +435,90 @@ export class Workflows {
435
435
  }
436
436
  });
437
437
  }
438
+ /**
439
+ * Create a workflow from an existing agent task's recorded history.
440
+ *
441
+ * This endpoint creates a workflow by using the browser-use rerun history
442
+ * feature. The task must have completed with history stored in S3.
443
+ *
444
+ * The workflow creation process:
445
+ * 1. Creates a new workflow record in pending state
446
+ * 2. Triggers an Inngest event to process the task history
447
+ * 3. The Inngest handler downloads history, detects variables, and updates the workflow
448
+ *
449
+ * Use GET /workflows/{workflow_id} to poll for creation completion.
450
+ *
451
+ * @param {BrowserUse.WorkflowCreateFromTaskRequest} request
452
+ * @param {Workflows.RequestOptions} requestOptions - Request-specific configuration.
453
+ *
454
+ * @throws {@link BrowserUse.NotFoundError}
455
+ * @throws {@link BrowserUse.UnprocessableEntityError}
456
+ *
457
+ * @example
458
+ * await client.workflows.createWorkflowFromTask({
459
+ * name: "name",
460
+ * taskId: "taskId",
461
+ * sessionId: "sessionId"
462
+ * })
463
+ */
464
+ createWorkflowFromTask(request, requestOptions) {
465
+ return core.HttpResponsePromise.fromPromise(this.__createWorkflowFromTask(request, requestOptions));
466
+ }
467
+ __createWorkflowFromTask(request, requestOptions) {
468
+ return __awaiter(this, void 0, void 0, function* () {
469
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j;
470
+ 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);
471
+ const _response = yield core.fetcher({
472
+ 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, "workflows/from-task"),
473
+ method: "POST",
474
+ headers: _headers,
475
+ contentType: "application/json",
476
+ queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
477
+ requestType: "json",
478
+ body: request,
479
+ 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,
480
+ 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,
481
+ abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
482
+ fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
483
+ logging: this._options.logging,
484
+ });
485
+ if (_response.ok) {
486
+ return {
487
+ data: _response.body,
488
+ rawResponse: _response.rawResponse,
489
+ };
490
+ }
491
+ if (_response.error.reason === "status-code") {
492
+ switch (_response.error.statusCode) {
493
+ case 404:
494
+ throw new BrowserUse.NotFoundError(_response.error.body, _response.rawResponse);
495
+ case 422:
496
+ throw new BrowserUse.UnprocessableEntityError(_response.error.body, _response.rawResponse);
497
+ default:
498
+ throw new errors.BrowserUseError({
499
+ statusCode: _response.error.statusCode,
500
+ body: _response.error.body,
501
+ rawResponse: _response.rawResponse,
502
+ });
503
+ }
504
+ }
505
+ switch (_response.error.reason) {
506
+ case "non-json":
507
+ throw new errors.BrowserUseError({
508
+ statusCode: _response.error.statusCode,
509
+ body: _response.error.rawBody,
510
+ rawResponse: _response.rawResponse,
511
+ });
512
+ case "timeout":
513
+ throw new errors.BrowserUseTimeoutError("Timeout exceeded when calling POST /workflows/from-task.");
514
+ case "unknown":
515
+ throw new errors.BrowserUseError({
516
+ message: _response.error.errorMessage,
517
+ rawResponse: _response.rawResponse,
518
+ });
519
+ }
520
+ });
521
+ }
438
522
  /**
439
523
  * Get a presigned URL to upload workflow YAML directly to S3 from the browser.
440
524
  *
@@ -0,0 +1,18 @@
1
+ /**
2
+ * @example
3
+ * {
4
+ * name: "name",
5
+ * taskId: "taskId",
6
+ * sessionId: "sessionId"
7
+ * }
8
+ */
9
+ export interface WorkflowCreateFromTaskRequest {
10
+ /** Name for the new workflow */
11
+ name: string;
12
+ /** ID of the agent task to create workflow from */
13
+ taskId: string;
14
+ /** ID of the agent session containing the task */
15
+ sessionId: string;
16
+ /** Optional description for the workflow */
17
+ description?: string | null;
18
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -9,6 +9,7 @@ export type { GetWorkflowWorkflowsWorkflowIdGetRequest } from "./GetWorkflowWork
9
9
  export type { ListAllExecutionsWorkflowsExecutionsGetRequest } from "./ListAllExecutionsWorkflowsExecutionsGetRequest.mjs";
10
10
  export type { ListWorkflowExecutionsWorkflowsWorkflowIdExecutionsGetRequest } from "./ListWorkflowExecutionsWorkflowsWorkflowIdExecutionsGetRequest.mjs";
11
11
  export type { ListWorkflowsWorkflowsGetRequest } from "./ListWorkflowsWorkflowsGetRequest.mjs";
12
+ export type { WorkflowCreateFromTaskRequest } from "./WorkflowCreateFromTaskRequest.mjs";
12
13
  export type { WorkflowCreateRequest } from "./WorkflowCreateRequest.mjs";
13
14
  export type { WorkflowExecuteRequest } from "./WorkflowExecuteRequest.mjs";
14
15
  export type { WorkflowGenerateRequest } from "./WorkflowGenerateRequest.mjs";
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Error response when a account is not found
2
+ * Error response when an account is not found
3
3
  */
4
4
  export interface AccountNotFoundError {
5
5
  detail?: string;
@@ -1,16 +1,16 @@
1
1
  import type * as BrowserUse from "../index.mjs";
2
2
  /**
3
- * View model for account information
3
+ * View model for account information.
4
4
  */
5
5
  export interface AccountView {
6
6
  /** The name of the user */
7
7
  name?: string | null;
8
- /** The monthly credits balance in USD */
9
- monthlyCreditsBalanceUsd: number;
10
- /** The additional credits balance in USD */
11
- additionalCreditsBalanceUsd: number;
12
8
  /** The total credits balance in USD */
13
9
  totalCreditsBalanceUsd: number;
10
+ /** Monthly subscription credits balance in USD */
11
+ monthlyCreditsBalanceUsd: number;
12
+ /** Additional top-up credits balance in USD */
13
+ additionalCreditsBalanceUsd: number;
14
14
  /** The rate limit for the account */
15
15
  rateLimit: number;
16
16
  /** The plan information */
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Error response when there are insufficient credits
3
+ */
4
+ export interface AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError {
5
+ detail?: string;
6
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Error response when there are insufficient credits
3
+ */
4
+ export interface AppEndpointsApiV2SkillsViewsInsufficientCreditsError {
5
+ detail?: string;
6
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Error response when trying to rollback a public skill
3
+ */
4
+ export interface CannotRollbackPublicSkillError {
5
+ detail?: string;
6
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Error response when user has insufficient credits
3
+ */
4
+ export interface CommonUtilsErrorsInsufficientCreditsError {
5
+ detail?: string;
6
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Error response when trying to enable more skills than allowed by plan
3
+ */
4
+ export interface EnabledSkillsLimitExceededError {
5
+ detail?: string;
6
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Request to execute a skill.
3
+ */
4
+ export interface ExecuteSkillRequest {
5
+ /** Parameters to pass to the skill handler */
6
+ parameters?: Record<string, unknown>;
7
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -5,18 +5,32 @@ import type * as BrowserUse from "../index.mjs";
5
5
  export interface MarketplaceSkillResponse {
6
6
  /** Unique identifier for the skill */
7
7
  id: string;
8
+ /** URL-friendly slug for the skill */
9
+ slug: string;
8
10
  /** Title of the skill (shows up in the public view) */
9
11
  title: string;
10
12
  /** Description of the skill (shows up in the public view) */
11
13
  description: string;
14
+ /** Categories of the skill */
15
+ categories: BrowserUse.SkillCategory[];
16
+ /** Domains/websites this skill interacts with */
17
+ domains: string[];
12
18
  /** Input parameters of the skill */
13
- parameters: BrowserUse.AppApiV2MarketplaceSkillsViewsParameterSchema[];
19
+ parameters: BrowserUse.ParameterSchema[];
14
20
  /** Output schema of the skill */
15
21
  outputSchema: Record<string, unknown>;
16
22
  /** Current version of the skill */
17
23
  currentVersion: number | null;
18
24
  /** Whether the skill is official (verified by Browser Use) */
19
25
  isOfficial: boolean;
26
+ /** Number of times this skill has been cloned */
27
+ cloneCount: number;
28
+ /** URL of the custom skill icon */
29
+ iconUrl?: string | null;
30
+ /** When the skill was first published */
31
+ firstPublishedAt: string;
32
+ /** When the skill was last published */
33
+ lastPublishedAt: string;
20
34
  /** Creation timestamp */
21
35
  createdAt: string;
22
36
  /** Last update timestamp */
@@ -8,4 +8,5 @@ export interface ParameterSchema {
8
8
  required?: boolean;
9
9
  description?: string | null;
10
10
  default?: unknown | null;
11
+ cookieDomain?: string | null;
11
12
  }
@@ -5,5 +5,6 @@ export declare const ParameterType: {
5
5
  readonly Boolean: "boolean";
6
6
  readonly Object: "object";
7
7
  readonly Array: "array";
8
+ readonly Cookie: "cookie";
8
9
  };
9
10
  export type ParameterType = (typeof ParameterType)[keyof typeof ParameterType];
@@ -6,4 +6,5 @@ export const ParameterType = {
6
6
  Boolean: "boolean",
7
7
  Object: "object",
8
8
  Array: "array",
9
+ Cookie: "cookie",
9
10
  };
@@ -13,4 +13,6 @@ export interface SessionItemView {
13
13
  startedAt: string;
14
14
  /** Timestamp when the session was stopped (None if still active) */
15
15
  finishedAt?: string | null;
16
+ /** Whether tasks in this session share memory and history with each other */
17
+ persistMemory: boolean;
16
18
  }
@@ -1,9 +1,9 @@
1
1
  /**
2
- * Enumeration of possible (browser) session states
2
+ * Enumeration of possible agent session states
3
3
  *
4
4
  * Attributes:
5
- * ACTIVE: Session is currently active and running (browser is running)
6
- * STOPPED: Session has been stopped and is no longer active (browser is stopped)
5
+ * ACTIVE: Agent session is currently active and running
6
+ * STOPPED: Agent session has been stopped and is no longer active
7
7
  */
8
8
  export declare const SessionStatus: {
9
9
  readonly Active: "active";
@@ -1,10 +1,10 @@
1
1
  // This file was auto-generated by Fern from our API Definition.
2
2
  /**
3
- * Enumeration of possible (browser) session states
3
+ * Enumeration of possible agent session states
4
4
  *
5
5
  * Attributes:
6
- * ACTIVE: Session is currently active and running (browser is running)
7
- * STOPPED: Session has been stopped and is no longer active (browser is stopped)
6
+ * ACTIVE: Agent session is currently active and running
7
+ * STOPPED: Agent session has been stopped and is no longer active
8
8
  */
9
9
  export const SessionStatus = {
10
10
  Active: "active",
@@ -1,5 +1,5 @@
1
1
  /**
2
- * Error response when free user tries to create session longer than allowed
2
+ * Error response when session timeout exceeds the maximum allowed limit
3
3
  */
4
4
  export interface SessionTimeoutLimitExceededError {
5
5
  detail?: string;
@@ -17,4 +17,6 @@ export interface SessionView {
17
17
  tasks: BrowserUse.TaskItemView[];
18
18
  /** Optional URL to access the public share of the session */
19
19
  publicShareUrl?: string | null;
20
+ /** Whether tasks in this session share memory and history with each other */
21
+ persistMemory?: boolean;
20
22
  }
@@ -0,0 +1,20 @@
1
+ /** Skill category. */
2
+ export declare const SkillCategory: {
3
+ readonly Search: "search";
4
+ readonly ECommerce: "e_commerce";
5
+ readonly Financial: "financial";
6
+ readonly News: "news";
7
+ readonly RealEstate: "real_estate";
8
+ readonly SocialMedia: "social_media";
9
+ readonly Travel: "travel";
10
+ readonly Marketplace: "marketplace";
11
+ readonly LeadGeneration: "lead_generation";
12
+ readonly Seo: "seo";
13
+ readonly Jobs: "jobs";
14
+ readonly Developer: "developer";
15
+ readonly Media: "media";
16
+ readonly Automation: "automation";
17
+ readonly Integration: "integration";
18
+ readonly Other: "other";
19
+ };
20
+ export type SkillCategory = (typeof SkillCategory)[keyof typeof SkillCategory];
@@ -0,0 +1,20 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ /** Skill category. */
3
+ export const SkillCategory = {
4
+ Search: "search",
5
+ ECommerce: "e_commerce",
6
+ Financial: "financial",
7
+ News: "news",
8
+ RealEstate: "real_estate",
9
+ SocialMedia: "social_media",
10
+ Travel: "travel",
11
+ Marketplace: "marketplace",
12
+ LeadGeneration: "lead_generation",
13
+ Seo: "seo",
14
+ Jobs: "jobs",
15
+ Developer: "developer",
16
+ Media: "media",
17
+ Automation: "automation",
18
+ Integration: "integration",
19
+ Other: "other",
20
+ };
@@ -5,10 +5,16 @@ import type * as BrowserUse from "../index.mjs";
5
5
  export interface SkillResponse {
6
6
  /** Unique identifier for the skill */
7
7
  id: string;
8
+ /** URL-friendly slug for the skill */
9
+ slug?: string | null;
8
10
  /** Title of the skill (shows up in the public view) */
9
11
  title: string;
10
12
  /** Description of the skill (shows up in the public view) */
11
13
  description: string;
14
+ /** Categories of the skill */
15
+ categories: BrowserUse.SkillCategory[];
16
+ /** Domains/websites this skill interacts with */
17
+ domains: string[];
12
18
  /** Goal of the skill (not shown in the public view) */
13
19
  goal?: string | null;
14
20
  /** Prompt for the agent to use when generating the skill automatically (not shown in the public view) */
@@ -16,19 +22,29 @@ export interface SkillResponse {
16
22
  /** Status of the skill */
17
23
  status: BrowserUse.SkillsGenerationStatus;
18
24
  /** Input parameters of the skill */
19
- parameters: BrowserUse.AppApiV2SkillsViewsParameterSchema[];
25
+ parameters: BrowserUse.ParameterSchema[];
20
26
  /** Output schema of the skill */
21
27
  outputSchema: Record<string, unknown>;
22
28
  /** Whether the skill is enabled */
23
29
  isEnabled: boolean;
24
30
  /** Whether the skill is publicly available */
25
31
  isPublic: boolean;
26
- /** Whether the user is the owner of the skill */
27
- isOwner: boolean;
32
+ /** URL of the custom skill icon */
33
+ iconUrl?: string | null;
34
+ /** When the skill was first published */
35
+ firstPublishedAt?: string | null;
36
+ /** When the skill was last published */
37
+ lastPublishedAt?: string | null;
28
38
  /** Current version of the skill */
29
39
  currentVersion: number | null;
40
+ /** When the current version started generating */
41
+ currentVersionStartedAt?: string | null;
42
+ /** When the current version finished generating */
43
+ currentVersionFinishedAt?: string | null;
30
44
  /** Base64 encoded generated code (contact support@browser-use.com to get access) - ENTERPRISE ONLY */
31
45
  code?: string | null;
46
+ /** Unique identifier for the skill this skill was cloned from */
47
+ clonedFromSkillId?: string | null;
32
48
  /** Creation timestamp */
33
49
  createdAt: string;
34
50
  /** Last update timestamp */
@@ -5,5 +5,6 @@ export declare const SkillsGenerationStatus: {
5
5
  readonly Failed: "failed";
6
6
  readonly Finished: "finished";
7
7
  readonly Cancelled: "cancelled";
8
+ readonly TimedOut: "timed_out";
8
9
  };
9
10
  export type SkillsGenerationStatus = (typeof SkillsGenerationStatus)[keyof typeof SkillsGenerationStatus];
@@ -6,4 +6,5 @@ export const SkillsGenerationStatus = {
6
6
  Failed: "failed",
7
7
  Finished: "finished",
8
8
  Cancelled: "cancelled",
9
+ TimedOut: "timed_out",
9
10
  };
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Response model for workflow created from an agent task.
3
+ */
4
+ export interface WorkflowCreateFromTaskResponse {
5
+ /** ID of the newly created workflow */
6
+ workflowId: string;
7
+ /** Status of the workflow creation (pending, completed) */
8
+ status?: string;
9
+ /** Human-readable message about the creation */
10
+ message?: string;
11
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -33,6 +33,10 @@ export interface WorkflowExecutionResponse {
33
33
  executionMetadata?: Record<string, unknown> | null;
34
34
  /** Presigned URL to download execution logs */
35
35
  logsDownloadUrl?: string | null;
36
+ /** AI-generated summary of the execution result */
37
+ aiSummary?: string | null;
38
+ /** AI's determination of whether execution succeeded */
39
+ aiSuccess?: boolean | null;
36
40
  /** Naive UTC timestamp when execution was created */
37
41
  createdAt: string;
38
42
  }
@@ -25,4 +25,8 @@ export interface WorkflowExecutionStateView {
25
25
  createdAt: string;
26
26
  /** Live browser view URL (available during and up to 60s after execution) */
27
27
  liveUrl?: string | null;
28
+ /** AI-generated summary of the execution result */
29
+ aiSummary?: string | null;
30
+ /** AI's determination of whether execution succeeded */
31
+ aiSuccess?: boolean | null;
28
32
  }
@@ -3,13 +3,13 @@
3
3
  */
4
4
  export interface WorkflowExecutionStepView {
5
5
  /** Unique identifier for the step (execution_id-step-N) */
6
- id: string;
6
+ id?: string;
7
7
  /** Sequential step number (1-indexed) */
8
- stepNumber: number;
8
+ stepNumber?: number;
9
9
  /** Name of the step from workflow definition */
10
10
  stepName?: string | null;
11
11
  /** Description of what this step is doing */
12
- nextGoal: string;
12
+ nextGoal?: string;
13
13
  /** Whether the step has completed */
14
14
  isDone?: boolean;
15
15
  /** Whether the step succeeded (None if in progress) */
@@ -25,5 +25,5 @@ export interface WorkflowExecutionStepView {
25
25
  /** Error message if step failed */
26
26
  error?: string | null;
27
27
  /** ISO 8601 timestamp when step was executed */
28
- createdAt: string;
28
+ createdAt?: string;
29
29
  }
@@ -9,10 +9,16 @@ export interface WorkflowGenerationStateView {
9
9
  name: string;
10
10
  /** Current status of workflow generation */
11
11
  generationStatus: BrowserUse.WorkflowGenerationStatus;
12
+ /** Error message if generation failed */
13
+ generationError?: string | null;
14
+ /** Current progress step (e.g., "downloading_history", "detecting_variables") */
15
+ generationProgress?: string | null;
12
16
  /** Live browser view URL (available only during generation) */
13
17
  liveUrl?: string | null;
14
18
  /** List of generated workflow steps (available after completion) */
15
19
  steps?: BrowserUse.WorkflowGenerationStepView[];
16
20
  /** When workflow was created */
17
21
  createdAt: string;
22
+ /** When workflow was last updated */
23
+ updatedAt?: string | null;
18
24
  }
@@ -1,3 +1,4 @@
1
+ import type * as BrowserUse from "../index.mjs";
1
2
  /**
2
3
  * Minimal view model for listing workflows.
3
4
  */
@@ -14,6 +15,12 @@ export interface WorkflowItemView {
14
15
  cost?: string;
15
16
  /** Whether the workflow is archived */
16
17
  isArchived?: boolean;
18
+ /** Status of workflow generation */
19
+ generationStatus?: BrowserUse.WorkflowGenerationStatus;
20
+ /** Error message if generation failed */
21
+ generationError?: string | null;
22
+ /** Generation metadata including progress_step */
23
+ generationMetadata?: Record<string, unknown> | null;
17
24
  /** Naive UTC timestamp when the workflow was created */
18
25
  createdAt: string;
19
26
  }
@@ -27,6 +27,8 @@ export interface WorkflowResponse {
27
27
  generationStatus?: BrowserUse.WorkflowGenerationStatus;
28
28
  /** Error message if generation failed */
29
29
  generationError?: string | null;
30
+ /** Generation metadata including progress_step */
31
+ generationMetadata?: Record<string, unknown> | null;
30
32
  /** Input schema from workflow YAML defining required/optional variables */
31
33
  inputSchema?: Record<string, unknown>[] | null;
32
34
  /** Pre-filled input template based on input_schema for easy execution */