browser-use-sdk 2.0.12 → 2.0.14

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 (192) hide show
  1. package/dist/cjs/BaseClient.d.ts +1 -1
  2. package/dist/cjs/Client.d.ts +1 -4
  3. package/dist/cjs/Client.js +3 -8
  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 +3 -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/index.d.ts +0 -2
  13. package/dist/cjs/api/resources/index.js +1 -3
  14. package/dist/cjs/api/resources/profiles/client/Client.d.ts +1 -1
  15. package/dist/cjs/api/resources/profiles/client/Client.js +1 -1
  16. package/dist/cjs/api/resources/sessions/client/Client.d.ts +2 -1
  17. package/dist/cjs/api/resources/sessions/client/Client.js +4 -1
  18. package/dist/cjs/api/resources/sessions/client/requests/CreateSessionRequest.d.ts +6 -0
  19. package/dist/cjs/api/resources/skills/client/Client.d.ts +43 -4
  20. package/dist/cjs/api/resources/skills/client/Client.js +172 -5
  21. package/dist/cjs/api/resources/skills/client/requests/ExecuteSkillSkillsSkillIdExecutePostRequest.d.ts +12 -0
  22. package/dist/cjs/api/resources/skills/client/requests/GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest.d.ts +11 -0
  23. package/dist/cjs/api/resources/skills/client/requests/ListSkillExecutionsSkillsSkillIdExecutionsGetRequest.d.ts +11 -0
  24. package/dist/cjs/api/resources/skills/client/requests/ListSkillsSkillsGetRequest.d.ts +2 -0
  25. package/dist/cjs/api/resources/skills/client/requests/UpdateSkillRequest.d.ts +5 -2
  26. package/dist/cjs/api/resources/skills/client/requests/index.d.ts +3 -1
  27. package/dist/cjs/api/resources/skillsMarketplace/client/Client.d.ts +24 -5
  28. package/dist/cjs/api/resources/skillsMarketplace/client/Client.js +87 -7
  29. package/dist/cjs/api/resources/skillsMarketplace/client/requests/ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest.d.ts +12 -0
  30. package/dist/cjs/api/resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillSlugGetRequest.d.ts +9 -0
  31. package/dist/cjs/api/resources/skillsMarketplace/client/requests/ListSkillsMarketplaceSkillsGetRequest.d.ts +2 -0
  32. package/dist/cjs/api/resources/skillsMarketplace/client/requests/index.d.ts +2 -1
  33. package/dist/cjs/api/resources/tasks/client/Client.d.ts +12 -3
  34. package/dist/cjs/api/resources/tasks/client/Client.js +12 -3
  35. package/dist/cjs/api/resources/tasks/client/requests/CreateTaskRequest.d.ts +2 -0
  36. package/dist/cjs/api/types/AccountNotFoundError.d.ts +1 -1
  37. package/dist/cjs/api/types/AccountView.d.ts +5 -5
  38. package/dist/cjs/api/types/AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.d.ts +6 -0
  39. package/dist/cjs/api/types/AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.js +3 -0
  40. package/dist/cjs/api/types/AppEndpointsApiV2SkillsViewsInsufficientCreditsError.d.ts +6 -0
  41. package/dist/cjs/api/types/AppEndpointsApiV2SkillsViewsInsufficientCreditsError.js +3 -0
  42. package/dist/cjs/api/types/BrowserSessionItemView.d.ts +6 -0
  43. package/dist/cjs/api/types/BrowserSessionView.d.ts +6 -0
  44. package/dist/cjs/api/types/{InsufficientCreditsError.d.ts → CommonUtilsErrorsInsufficientCreditsError.d.ts} +1 -1
  45. package/dist/cjs/api/types/CommonUtilsErrorsInsufficientCreditsError.js +3 -0
  46. package/dist/cjs/api/types/CustomProxy.d.ts +13 -0
  47. package/dist/cjs/api/types/CustomProxy.js +3 -0
  48. package/dist/cjs/api/types/EnabledSkillsLimitExceededError.d.ts +6 -0
  49. package/dist/cjs/api/types/EnabledSkillsLimitExceededError.js +3 -0
  50. package/dist/cjs/api/types/ExecuteSkillRequest.d.ts +7 -0
  51. package/dist/cjs/api/types/ExecuteSkillRequest.js +3 -0
  52. package/dist/cjs/api/types/MarketplaceSkillResponse.d.ts +14 -0
  53. package/dist/cjs/api/types/SessionItemView.d.ts +8 -0
  54. package/dist/cjs/api/types/SessionStatus.d.ts +3 -3
  55. package/dist/cjs/api/types/SessionStatus.js +3 -3
  56. package/dist/cjs/api/types/SessionTimeoutLimitExceededError.d.ts +1 -1
  57. package/dist/cjs/api/types/SessionView.d.ts +8 -0
  58. package/dist/cjs/api/types/SkillCategory.d.ts +20 -0
  59. package/dist/cjs/api/types/SkillCategory.js +23 -0
  60. package/dist/cjs/api/types/SkillExecutionListResponse.d.ts +14 -0
  61. package/dist/cjs/api/types/SkillExecutionListResponse.js +3 -0
  62. package/dist/cjs/api/types/SkillExecutionOutputResponse.d.ts +7 -0
  63. package/dist/cjs/api/types/SkillExecutionOutputResponse.js +3 -0
  64. package/dist/cjs/api/types/SkillExecutionView.d.ts +21 -0
  65. package/dist/cjs/api/types/SkillExecutionView.js +3 -0
  66. package/dist/cjs/api/types/SkillResponse.d.ts +14 -2
  67. package/dist/cjs/api/types/SkillsGenerationStatus.d.ts +1 -0
  68. package/dist/cjs/api/types/SkillsGenerationStatus.js +1 -0
  69. package/dist/cjs/api/types/SupportedLlMs.d.ts +2 -0
  70. package/dist/cjs/api/types/SupportedLlMs.js +2 -0
  71. package/dist/cjs/api/types/TaskItemView.d.ts +2 -0
  72. package/dist/cjs/api/types/TaskView.d.ts +2 -0
  73. package/dist/cjs/api/types/WorkflowYamlPresignedUploadResponse.d.ts +1 -8
  74. package/dist/cjs/api/types/WorkflowYamlPresignedUploadResponse.js +0 -8
  75. package/dist/cjs/api/types/index.d.ts +10 -20
  76. package/dist/cjs/api/types/index.js +10 -20
  77. package/dist/cjs/version.d.ts +1 -1
  78. package/dist/cjs/version.js +1 -1
  79. package/dist/esm/BaseClient.d.mts +1 -1
  80. package/dist/esm/Client.d.mts +1 -4
  81. package/dist/esm/Client.mjs +3 -8
  82. package/dist/esm/api/errors/ForbiddenError.d.mts +1 -2
  83. package/dist/esm/api/resources/billing/client/Client.d.mts +2 -2
  84. package/dist/esm/api/resources/billing/client/Client.mjs +2 -2
  85. package/dist/esm/api/resources/browsers/client/Client.d.mts +9 -7
  86. package/dist/esm/api/resources/browsers/client/Client.mjs +9 -7
  87. package/dist/esm/api/resources/browsers/client/requests/CreateBrowserSessionRequest.d.mts +3 -1
  88. package/dist/esm/api/resources/files/client/Client.d.mts +1 -1
  89. package/dist/esm/api/resources/files/client/Client.mjs +1 -1
  90. package/dist/esm/api/resources/index.d.mts +0 -2
  91. package/dist/esm/api/resources/index.mjs +0 -2
  92. package/dist/esm/api/resources/profiles/client/Client.d.mts +1 -1
  93. package/dist/esm/api/resources/profiles/client/Client.mjs +1 -1
  94. package/dist/esm/api/resources/sessions/client/Client.d.mts +2 -1
  95. package/dist/esm/api/resources/sessions/client/Client.mjs +4 -1
  96. package/dist/esm/api/resources/sessions/client/requests/CreateSessionRequest.d.mts +6 -0
  97. package/dist/esm/api/resources/skills/client/Client.d.mts +43 -4
  98. package/dist/esm/api/resources/skills/client/Client.mjs +172 -5
  99. package/dist/esm/api/resources/skills/client/requests/ExecuteSkillSkillsSkillIdExecutePostRequest.d.mts +12 -0
  100. package/dist/esm/api/resources/skills/client/requests/GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest.d.mts +11 -0
  101. package/dist/esm/api/resources/skills/client/requests/ListSkillExecutionsSkillsSkillIdExecutionsGetRequest.d.mts +11 -0
  102. package/dist/esm/api/resources/skills/client/requests/ListSkillsSkillsGetRequest.d.mts +2 -0
  103. package/dist/esm/api/resources/skills/client/requests/UpdateSkillRequest.d.mts +5 -2
  104. package/dist/esm/api/resources/skills/client/requests/index.d.mts +3 -1
  105. package/dist/esm/api/resources/skillsMarketplace/client/Client.d.mts +24 -5
  106. package/dist/esm/api/resources/skillsMarketplace/client/Client.mjs +87 -7
  107. package/dist/esm/api/resources/skillsMarketplace/client/requests/ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest.d.mts +12 -0
  108. package/dist/esm/api/resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillSlugGetRequest.d.mts +9 -0
  109. package/dist/esm/api/resources/skillsMarketplace/client/requests/ListSkillsMarketplaceSkillsGetRequest.d.mts +2 -0
  110. package/dist/esm/api/resources/skillsMarketplace/client/requests/index.d.mts +2 -1
  111. package/dist/esm/api/resources/tasks/client/Client.d.mts +12 -3
  112. package/dist/esm/api/resources/tasks/client/Client.mjs +12 -3
  113. package/dist/esm/api/resources/tasks/client/requests/CreateTaskRequest.d.mts +2 -0
  114. package/dist/esm/api/types/AccountNotFoundError.d.mts +1 -1
  115. package/dist/esm/api/types/AccountView.d.mts +5 -5
  116. package/dist/esm/api/types/AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.d.mts +6 -0
  117. package/dist/esm/api/types/AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.mjs +2 -0
  118. package/dist/esm/api/types/AppEndpointsApiV2SkillsViewsInsufficientCreditsError.d.mts +6 -0
  119. package/dist/esm/api/types/AppEndpointsApiV2SkillsViewsInsufficientCreditsError.mjs +2 -0
  120. package/dist/esm/api/types/BrowserSessionItemView.d.mts +6 -0
  121. package/dist/esm/api/types/BrowserSessionView.d.mts +6 -0
  122. package/dist/esm/api/types/{InsufficientCreditsError.d.mts → CommonUtilsErrorsInsufficientCreditsError.d.mts} +1 -1
  123. package/dist/esm/api/types/CommonUtilsErrorsInsufficientCreditsError.mjs +2 -0
  124. package/dist/esm/api/types/CustomProxy.d.mts +13 -0
  125. package/dist/esm/api/types/CustomProxy.mjs +2 -0
  126. package/dist/esm/api/types/EnabledSkillsLimitExceededError.d.mts +6 -0
  127. package/dist/esm/api/types/EnabledSkillsLimitExceededError.mjs +2 -0
  128. package/dist/esm/api/types/ExecuteSkillRequest.d.mts +7 -0
  129. package/dist/esm/api/types/ExecuteSkillRequest.mjs +2 -0
  130. package/dist/esm/api/types/MarketplaceSkillResponse.d.mts +14 -0
  131. package/dist/esm/api/types/SessionItemView.d.mts +8 -0
  132. package/dist/esm/api/types/SessionStatus.d.mts +3 -3
  133. package/dist/esm/api/types/SessionStatus.mjs +3 -3
  134. package/dist/esm/api/types/SessionTimeoutLimitExceededError.d.mts +1 -1
  135. package/dist/esm/api/types/SessionView.d.mts +8 -0
  136. package/dist/esm/api/types/SkillCategory.d.mts +20 -0
  137. package/dist/esm/api/types/SkillCategory.mjs +20 -0
  138. package/dist/esm/api/types/SkillExecutionListResponse.d.mts +14 -0
  139. package/dist/esm/api/types/SkillExecutionListResponse.mjs +2 -0
  140. package/dist/esm/api/types/SkillExecutionOutputResponse.d.mts +7 -0
  141. package/dist/esm/api/types/SkillExecutionOutputResponse.mjs +2 -0
  142. package/dist/esm/api/types/SkillExecutionView.d.mts +21 -0
  143. package/dist/esm/api/types/SkillExecutionView.mjs +2 -0
  144. package/dist/esm/api/types/SkillResponse.d.mts +14 -2
  145. package/dist/esm/api/types/SkillsGenerationStatus.d.mts +1 -0
  146. package/dist/esm/api/types/SkillsGenerationStatus.mjs +1 -0
  147. package/dist/esm/api/types/SupportedLlMs.d.mts +2 -0
  148. package/dist/esm/api/types/SupportedLlMs.mjs +2 -0
  149. package/dist/esm/api/types/TaskItemView.d.mts +2 -0
  150. package/dist/esm/api/types/TaskView.d.mts +2 -0
  151. package/dist/esm/api/types/WorkflowYamlPresignedUploadResponse.d.mts +1 -8
  152. package/dist/esm/api/types/WorkflowYamlPresignedUploadResponse.mjs +1 -7
  153. package/dist/esm/api/types/index.d.mts +10 -20
  154. package/dist/esm/api/types/index.mjs +10 -20
  155. package/dist/esm/version.d.mts +1 -1
  156. package/dist/esm/version.mjs +1 -1
  157. package/package.json +1 -1
  158. package/reference.md +60 -916
  159. package/dist/cjs/api/resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillIdGetRequest.d.ts +0 -9
  160. package/dist/cjs/api/resources/workflows/types/ExecuteWorkflowWorkflowsWorkflowIdExecutePostResponse.d.ts +0 -2
  161. package/dist/cjs/api/resources/workflows/types/index.d.ts +0 -1
  162. package/dist/cjs/api/resources/workflows/types/index.js +0 -17
  163. package/dist/cjs/api/types/AppApiV2MarketplaceSkillsViewsParameterSchema.d.ts +0 -11
  164. package/dist/cjs/api/types/AppApiV2MarketplaceSkillsViewsParameterType.d.ts +0 -9
  165. package/dist/cjs/api/types/AppApiV2MarketplaceSkillsViewsParameterType.js +0 -12
  166. package/dist/cjs/api/types/AppApiV2SkillsViewsParameterSchema.d.ts +0 -11
  167. package/dist/cjs/api/types/AppApiV2SkillsViewsParameterType.d.ts +0 -10
  168. package/dist/cjs/api/types/AppApiV2SkillsViewsParameterType.js +0 -13
  169. package/dist/cjs/api/types/ExecutionMode.d.ts +0 -12
  170. package/dist/cjs/api/types/ExecutionMode.js +0 -15
  171. package/dist/esm/api/resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillIdGetRequest.d.mts +0 -9
  172. package/dist/esm/api/resources/workflows/types/ExecuteWorkflowWorkflowsWorkflowIdExecutePostResponse.d.mts +0 -2
  173. package/dist/esm/api/resources/workflows/types/index.d.mts +0 -1
  174. package/dist/esm/api/resources/workflows/types/index.mjs +0 -1
  175. package/dist/esm/api/types/AppApiV2MarketplaceSkillsViewsParameterSchema.d.mts +0 -11
  176. package/dist/esm/api/types/AppApiV2MarketplaceSkillsViewsParameterType.d.mts +0 -9
  177. package/dist/esm/api/types/AppApiV2MarketplaceSkillsViewsParameterType.mjs +0 -9
  178. package/dist/esm/api/types/AppApiV2SkillsViewsParameterSchema.d.mts +0 -11
  179. package/dist/esm/api/types/AppApiV2SkillsViewsParameterType.d.mts +0 -10
  180. package/dist/esm/api/types/AppApiV2SkillsViewsParameterType.mjs +0 -10
  181. package/dist/esm/api/types/ExecutionMode.d.mts +0 -12
  182. package/dist/esm/api/types/ExecutionMode.mjs +0 -12
  183. /package/dist/cjs/api/resources/{skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillIdGetRequest.js → skills/client/requests/ExecuteSkillSkillsSkillIdExecutePostRequest.js} +0 -0
  184. /package/dist/cjs/api/resources/{workflows/types/ExecuteWorkflowWorkflowsWorkflowIdExecutePostResponse.js → skills/client/requests/GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest.js} +0 -0
  185. /package/dist/cjs/api/{types/AppApiV2MarketplaceSkillsViewsParameterSchema.js → resources/skills/client/requests/ListSkillExecutionsSkillsSkillIdExecutionsGetRequest.js} +0 -0
  186. /package/dist/cjs/api/{types/AppApiV2SkillsViewsParameterSchema.js → resources/skillsMarketplace/client/requests/ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest.js} +0 -0
  187. /package/dist/cjs/api/{types/InsufficientCreditsError.js → resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillSlugGetRequest.js} +0 -0
  188. /package/dist/esm/api/resources/{skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillIdGetRequest.mjs → skills/client/requests/ExecuteSkillSkillsSkillIdExecutePostRequest.mjs} +0 -0
  189. /package/dist/esm/api/resources/{workflows/types/ExecuteWorkflowWorkflowsWorkflowIdExecutePostResponse.mjs → skills/client/requests/GetSkillExecutionOutputSkillsSkillIdExecutionsExecutionIdOutputGetRequest.mjs} +0 -0
  190. /package/dist/esm/api/{types/AppApiV2MarketplaceSkillsViewsParameterSchema.mjs → resources/skills/client/requests/ListSkillExecutionsSkillsSkillIdExecutionsGetRequest.mjs} +0 -0
  191. /package/dist/esm/api/{types/AppApiV2SkillsViewsParameterSchema.mjs → resources/skillsMarketplace/client/requests/ExecuteSkillMarketplaceSkillsSkillIdExecutePostRequest.mjs} +0 -0
  192. /package/dist/esm/api/{types/InsufficientCreditsError.mjs → resources/skillsMarketplace/client/requests/GetSkillMarketplaceSkillsSkillSlugGetRequest.mjs} +0 -0
@@ -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 Tasks {
28
- constructor(_options) {
28
+ constructor(_options = {}) {
29
29
  this._options = _options;
30
30
  }
31
31
  /**
@@ -110,9 +110,18 @@ export class Tasks {
110
110
  });
111
111
  }
112
112
  /**
113
+ * Create and start a new task.
114
+ *
113
115
  * You can either:
114
- * 1. Start a new task (auto creates a new simple session)
115
- * 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)
116
+ * 1. Start a new task without a sessionId (auto-creates a session with US proxy by default).
117
+ * Note: Tasks without a sessionId are one-off tasks that automatically close the session
118
+ * upon completion (keep_alive=false).
119
+ * 2. Start a new task in an existing session (reuse for follow-up tasks or custom configuration)
120
+ *
121
+ * Important: Proxy configuration (proxyCountryCode) and other session settings (like keep_alive) are
122
+ * session-level settings, not task-level settings. For full control over session configuration,
123
+ * create a session first via POST /sessions with your desired settings, then pass that sessionId
124
+ * when creating tasks.
116
125
  *
117
126
  * @param {BrowserUse.CreateTaskRequest} request
118
127
  * @param {Tasks.RequestOptions} requestOptions - Request-specific configuration.
@@ -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
  /**
@@ -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 {};
@@ -17,4 +17,10 @@ export interface BrowserSessionItemView {
17
17
  startedAt: string;
18
18
  /** Timestamp when the session was stopped (None if still active) */
19
19
  finishedAt?: string | null;
20
+ /** Amount of proxy data used in MB */
21
+ proxyUsedMb?: string;
22
+ /** Cost of proxy usage in USD */
23
+ proxyCost?: string;
24
+ /** Cost of browser session hosting in USD */
25
+ browserCost?: string;
20
26
  }
@@ -17,4 +17,10 @@ export interface BrowserSessionView {
17
17
  startedAt: string;
18
18
  /** Timestamp when the session was stopped (None if still active) */
19
19
  finishedAt?: string | null;
20
+ /** Amount of proxy data used in MB */
21
+ proxyUsedMb?: string;
22
+ /** Cost of proxy usage in USD */
23
+ proxyCost?: string;
24
+ /** Cost of browser session hosting in USD */
25
+ browserCost?: string;
20
26
  }
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Error response when user has insufficient credits
3
3
  */
4
- export interface InsufficientCreditsError {
4
+ export interface CommonUtilsErrorsInsufficientCreditsError {
5
5
  detail?: string;
6
6
  }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Request model for creating a custom proxy.
3
+ */
4
+ export interface CustomProxy {
5
+ /** Host of the proxy. */
6
+ host: string;
7
+ /** Port of the proxy. */
8
+ port: number;
9
+ /** Username for proxy authentication. */
10
+ username?: string | null;
11
+ /** Password for proxy authentication. */
12
+ password?: string | null;
13
+ }
@@ -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,10 +5,16 @@ 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
19
  parameters: BrowserUse.ParameterSchema[];
14
20
  /** Output schema of the skill */
@@ -17,6 +23,14 @@ export interface MarketplaceSkillResponse {
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 */
@@ -13,4 +13,12 @@ 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;
18
+ /** Whether the browser session stays alive after tasks complete */
19
+ keepAlive: boolean;
20
+ /** Amount of proxy data used in MB */
21
+ proxyUsedMb?: string;
22
+ /** Cost of proxy usage in USD */
23
+ proxyCost?: string;
16
24
  }
@@ -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,12 @@ 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;
22
+ /** Whether the browser session stays alive after tasks complete */
23
+ keepAlive?: boolean;
24
+ /** Amount of proxy data used in MB */
25
+ proxyUsedMb?: string;
26
+ /** Cost of proxy usage in USD */
27
+ proxyCost?: string;
20
28
  }
@@ -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
+ };
@@ -0,0 +1,14 @@
1
+ import type * as BrowserUse from "../index.mjs";
2
+ /**
3
+ * Response for listing skill executions.
4
+ */
5
+ export interface SkillExecutionListResponse {
6
+ /** List of executions */
7
+ items: BrowserUse.SkillExecutionView[];
8
+ /** Total number of items in the list */
9
+ totalItems: number;
10
+ /** Page number */
11
+ pageNumber: number;
12
+ /** Number of items per page */
13
+ pageSize: number;
14
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Response containing presigned URL for downloading execution output.
3
+ */
4
+ export interface SkillExecutionOutputResponse {
5
+ /** Presigned URL for downloading the execution output (valid for 5 minutes) */
6
+ downloadUrl: string;
7
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -0,0 +1,21 @@
1
+ /**
2
+ * View for a skill execution.
3
+ */
4
+ export interface SkillExecutionView {
5
+ /** Unique identifier for the execution */
6
+ id: string;
7
+ /** ID of the skill that was executed */
8
+ skillId: string;
9
+ /** Execution status (running, completed, failed) */
10
+ status: string;
11
+ /** Whether the execution succeeded */
12
+ success: boolean;
13
+ /** When the execution started */
14
+ startedAt: string;
15
+ /** When the execution finished */
16
+ finishedAt: string | null;
17
+ /** Execution latency in milliseconds */
18
+ latencyMs: number | null;
19
+ /** Whether output is available for download */
20
+ hasOutput: boolean;
21
+ }
@@ -0,0 +1,2 @@
1
+ // This file was auto-generated by Fern from our API Definition.
2
+ export {};
@@ -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) */
@@ -23,8 +29,12 @@ export interface SkillResponse {
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;
30
40
  /** When the current version started generating */
@@ -33,6 +43,8 @@ export interface SkillResponse {
33
43
  currentVersionFinishedAt?: string | null;
34
44
  /** Base64 encoded generated code (contact support@browser-use.com to get access) - ENTERPRISE ONLY */
35
45
  code?: string | null;
46
+ /** Unique identifier for the skill this skill was cloned from */
47
+ clonedFromSkillId?: string | null;
36
48
  /** Creation timestamp */
37
49
  createdAt: string;
38
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
  };
@@ -1,5 +1,6 @@
1
1
  export declare const SupportedLlMs: {
2
2
  readonly BrowserUseLlm: "browser-use-llm";
3
+ readonly BrowserUse20: "browser-use-2.0";
3
4
  readonly Gpt41: "gpt-4.1";
4
5
  readonly Gpt41Mini: "gpt-4.1-mini";
5
6
  readonly O4Mini: "o4-mini";
@@ -7,6 +8,7 @@ export declare const SupportedLlMs: {
7
8
  readonly Gemini25Flash: "gemini-2.5-flash";
8
9
  readonly Gemini25Pro: "gemini-2.5-pro";
9
10
  readonly Gemini3ProPreview: "gemini-3-pro-preview";
11
+ readonly Gemini3FlashPreview: "gemini-3-flash-preview";
10
12
  readonly GeminiFlashLatest: "gemini-flash-latest";
11
13
  readonly GeminiFlashLiteLatest: "gemini-flash-lite-latest";
12
14
  readonly ClaudeSonnet420250514: "claude-sonnet-4-20250514";
@@ -1,6 +1,7 @@
1
1
  // This file was auto-generated by Fern from our API Definition.
2
2
  export const SupportedLlMs = {
3
3
  BrowserUseLlm: "browser-use-llm",
4
+ BrowserUse20: "browser-use-2.0",
4
5
  Gpt41: "gpt-4.1",
5
6
  Gpt41Mini: "gpt-4.1-mini",
6
7
  O4Mini: "o4-mini",
@@ -8,6 +9,7 @@ export const SupportedLlMs = {
8
9
  Gemini25Flash: "gemini-2.5-flash",
9
10
  Gemini25Pro: "gemini-2.5-pro",
10
11
  Gemini3ProPreview: "gemini-3-pro-preview",
12
+ Gemini3FlashPreview: "gemini-3-flash-preview",
11
13
  GeminiFlashLatest: "gemini-flash-latest",
12
14
  GeminiFlashLiteLatest: "gemini-flash-lite-latest",
13
15
  ClaudeSonnet420250514: "claude-sonnet-4-20250514",
@@ -30,4 +30,6 @@ export interface TaskItemView {
30
30
  judgement?: string | null;
31
31
  /** Judge verdict - True if the judge found the task to be successful, False otherwise (None if judge is not enabled) */
32
32
  judgeVerdict?: boolean | null;
33
+ /** Total cost of the task in USD. This is the sum of all step costs incurred during task execution. */
34
+ cost?: string | null;
33
35
  }
@@ -32,4 +32,6 @@ export interface TaskView {
32
32
  judgement?: string | null;
33
33
  /** Judge verdict - True if the judge found the task to be successful, False otherwise (None if judge is not enabled) */
34
34
  judgeVerdict?: boolean | null;
35
+ /** Total cost of the task in USD. This is the sum of all step costs incurred during task execution. */
36
+ cost?: string | null;
35
37
  }
@@ -5,7 +5,7 @@ export interface WorkflowYamlPresignedUploadResponse {
5
5
  /** The URL to upload the YAML file to */
6
6
  url: string;
7
7
  /** The HTTP method to use for the upload */
8
- method: WorkflowYamlPresignedUploadResponse.Method;
8
+ method: "POST";
9
9
  /** The form fields to include in the upload request */
10
10
  fields: Record<string, string>;
11
11
  /** The S3 key where the file will be stored */
@@ -13,10 +13,3 @@ export interface WorkflowYamlPresignedUploadResponse {
13
13
  /** Number of seconds until the presigned URL expires */
14
14
  expiresIn: number;
15
15
  }
16
- export declare namespace WorkflowYamlPresignedUploadResponse {
17
- /** The HTTP method to use for the upload */
18
- const Method: {
19
- readonly Post: "POST";
20
- };
21
- type Method = (typeof Method)[keyof typeof Method];
22
- }
@@ -1,8 +1,2 @@
1
1
  // This file was auto-generated by Fern from our API Definition.
2
- export var WorkflowYamlPresignedUploadResponse;
3
- (function (WorkflowYamlPresignedUploadResponse) {
4
- /** The HTTP method to use for the upload */
5
- WorkflowYamlPresignedUploadResponse.Method = {
6
- Post: "POST",
7
- };
8
- })(WorkflowYamlPresignedUploadResponse || (WorkflowYamlPresignedUploadResponse = {}));
2
+ export {};
@@ -1,7 +1,7 @@
1
1
  export * from "./AccountNotFoundError.mjs";
2
2
  export * from "./AccountView.mjs";
3
- export * from "./AppApiV2SkillsViewsInsufficientCreditsError.mjs";
4
- export * from "./AppViewsV2ErrorViewsInsufficientCreditsError.mjs";
3
+ export * from "./AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.mjs";
4
+ export * from "./AppEndpointsApiV2SkillsViewsInsufficientCreditsError.mjs";
5
5
  export * from "./BadRequestErrorBody.mjs";
6
6
  export * from "./BrowserSessionItemView.mjs";
7
7
  export * from "./BrowserSessionListResponse.mjs";
@@ -10,9 +10,13 @@ export * from "./BrowserSessionUpdateAction.mjs";
10
10
  export * from "./BrowserSessionView.mjs";
11
11
  export * from "./CannotDeleteSkillWhileGeneratingError.mjs";
12
12
  export * from "./CannotRollbackPublicSkillError.mjs";
13
+ export * from "./CommonUtilsErrorsInsufficientCreditsError.mjs";
13
14
  export * from "./ConcurrentSkillCreationsError.mjs";
14
15
  export * from "./CreateSkillResponse.mjs";
16
+ export * from "./CustomProxy.mjs";
15
17
  export * from "./DownloadUrlGenerationError.mjs";
18
+ export * from "./EnabledSkillsLimitExceededError.mjs";
19
+ export * from "./ExecuteSkillRequest.mjs";
16
20
  export * from "./ExecuteSkillResponse.mjs";
17
21
  export * from "./FileView.mjs";
18
22
  export * from "./GenerationNotCancellableError.mjs";
@@ -41,6 +45,10 @@ export * from "./SessionUpdateAction.mjs";
41
45
  export * from "./SessionView.mjs";
42
46
  export * from "./ShareNotFoundError.mjs";
43
47
  export * from "./ShareView.mjs";
48
+ export * from "./SkillCategory.mjs";
49
+ export * from "./SkillExecutionListResponse.mjs";
50
+ export * from "./SkillExecutionOutputResponse.mjs";
51
+ export * from "./SkillExecutionView.mjs";
44
52
  export * from "./SkillListResponse.mjs";
45
53
  export * from "./SkillNotFinishedError.mjs";
46
54
  export * from "./SkillNotFoundError.mjs";
@@ -62,21 +70,3 @@ export * from "./UnsupportedContentTypeError.mjs";
62
70
  export * from "./UploadFilePresignedUrlResponse.mjs";
63
71
  export * from "./UploadFileRequest.mjs";
64
72
  export * from "./ValidationError.mjs";
65
- export * from "./WorkflowExecutionCreatedResponse.mjs";
66
- export * from "./WorkflowExecutionItemView.mjs";
67
- export * from "./WorkflowExecutionListResponse.mjs";
68
- export * from "./WorkflowExecutionLogResponse.mjs";
69
- export * from "./WorkflowExecutionMediaStepView.mjs";
70
- export * from "./WorkflowExecutionMediaView.mjs";
71
- export * from "./WorkflowExecutionResponse.mjs";
72
- export * from "./WorkflowExecutionStateView.mjs";
73
- export * from "./WorkflowExecutionStatus.mjs";
74
- export * from "./WorkflowExecutionStepView.mjs";
75
- export * from "./WorkflowGenerateResponse.mjs";
76
- export * from "./WorkflowGenerationStateView.mjs";
77
- export * from "./WorkflowGenerationStatus.mjs";
78
- export * from "./WorkflowGenerationStepView.mjs";
79
- export * from "./WorkflowItemView.mjs";
80
- export * from "./WorkflowListResponse.mjs";
81
- export * from "./WorkflowResponse.mjs";
82
- export * from "./WorkflowYamlPresignedUploadResponse.mjs";
@@ -1,7 +1,7 @@
1
1
  export * from "./AccountNotFoundError.mjs";
2
2
  export * from "./AccountView.mjs";
3
- export * from "./AppApiV2SkillsViewsInsufficientCreditsError.mjs";
4
- export * from "./AppViewsV2ErrorViewsInsufficientCreditsError.mjs";
3
+ export * from "./AppEndpointsApiV2MarketplaceSkillsViewsInsufficientCreditsError.mjs";
4
+ export * from "./AppEndpointsApiV2SkillsViewsInsufficientCreditsError.mjs";
5
5
  export * from "./BadRequestErrorBody.mjs";
6
6
  export * from "./BrowserSessionItemView.mjs";
7
7
  export * from "./BrowserSessionListResponse.mjs";
@@ -10,9 +10,13 @@ export * from "./BrowserSessionUpdateAction.mjs";
10
10
  export * from "./BrowserSessionView.mjs";
11
11
  export * from "./CannotDeleteSkillWhileGeneratingError.mjs";
12
12
  export * from "./CannotRollbackPublicSkillError.mjs";
13
+ export * from "./CommonUtilsErrorsInsufficientCreditsError.mjs";
13
14
  export * from "./ConcurrentSkillCreationsError.mjs";
14
15
  export * from "./CreateSkillResponse.mjs";
16
+ export * from "./CustomProxy.mjs";
15
17
  export * from "./DownloadUrlGenerationError.mjs";
18
+ export * from "./EnabledSkillsLimitExceededError.mjs";
19
+ export * from "./ExecuteSkillRequest.mjs";
16
20
  export * from "./ExecuteSkillResponse.mjs";
17
21
  export * from "./FileView.mjs";
18
22
  export * from "./GenerationNotCancellableError.mjs";
@@ -41,6 +45,10 @@ export * from "./SessionUpdateAction.mjs";
41
45
  export * from "./SessionView.mjs";
42
46
  export * from "./ShareNotFoundError.mjs";
43
47
  export * from "./ShareView.mjs";
48
+ export * from "./SkillCategory.mjs";
49
+ export * from "./SkillExecutionListResponse.mjs";
50
+ export * from "./SkillExecutionOutputResponse.mjs";
51
+ export * from "./SkillExecutionView.mjs";
44
52
  export * from "./SkillListResponse.mjs";
45
53
  export * from "./SkillNotFinishedError.mjs";
46
54
  export * from "./SkillNotFoundError.mjs";
@@ -62,21 +70,3 @@ export * from "./UnsupportedContentTypeError.mjs";
62
70
  export * from "./UploadFilePresignedUrlResponse.mjs";
63
71
  export * from "./UploadFileRequest.mjs";
64
72
  export * from "./ValidationError.mjs";
65
- export * from "./WorkflowExecutionCreatedResponse.mjs";
66
- export * from "./WorkflowExecutionItemView.mjs";
67
- export * from "./WorkflowExecutionListResponse.mjs";
68
- export * from "./WorkflowExecutionLogResponse.mjs";
69
- export * from "./WorkflowExecutionMediaStepView.mjs";
70
- export * from "./WorkflowExecutionMediaView.mjs";
71
- export * from "./WorkflowExecutionResponse.mjs";
72
- export * from "./WorkflowExecutionStateView.mjs";
73
- export * from "./WorkflowExecutionStatus.mjs";
74
- export * from "./WorkflowExecutionStepView.mjs";
75
- export * from "./WorkflowGenerateResponse.mjs";
76
- export * from "./WorkflowGenerationStateView.mjs";
77
- export * from "./WorkflowGenerationStatus.mjs";
78
- export * from "./WorkflowGenerationStepView.mjs";
79
- export * from "./WorkflowItemView.mjs";
80
- export * from "./WorkflowListResponse.mjs";
81
- export * from "./WorkflowResponse.mjs";
82
- export * from "./WorkflowYamlPresignedUploadResponse.mjs";
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "2.0.12";
1
+ export declare const SDK_VERSION = "2.0.14";
@@ -1 +1 @@
1
- export const SDK_VERSION = "2.0.12";
1
+ export const SDK_VERSION = "2.0.14";