@mobilerun/sdk 2.0.0 → 2.2.0

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 (183) hide show
  1. package/CHANGELOG.md +75 -0
  2. package/README.md +2 -2
  3. package/client.d.mts +12 -11
  4. package/client.d.mts.map +1 -1
  5. package/client.d.ts +12 -11
  6. package/client.d.ts.map +1 -1
  7. package/client.js +20 -17
  8. package/client.js.map +1 -1
  9. package/client.mjs +21 -18
  10. package/client.mjs.map +1 -1
  11. package/internal/parse.d.mts.map +1 -1
  12. package/internal/parse.d.ts.map +1 -1
  13. package/internal/parse.js +5 -0
  14. package/internal/parse.js.map +1 -1
  15. package/internal/parse.mjs +5 -0
  16. package/internal/parse.mjs.map +1 -1
  17. package/internal/qs/formats.d.mts +7 -0
  18. package/internal/qs/formats.d.mts.map +1 -0
  19. package/internal/qs/formats.d.ts +7 -0
  20. package/internal/qs/formats.d.ts.map +1 -0
  21. package/internal/qs/formats.js +13 -0
  22. package/internal/qs/formats.js.map +1 -0
  23. package/internal/qs/formats.mjs +9 -0
  24. package/internal/qs/formats.mjs.map +1 -0
  25. package/internal/qs/index.d.mts +10 -0
  26. package/internal/qs/index.d.mts.map +1 -0
  27. package/internal/qs/index.d.ts +10 -0
  28. package/internal/qs/index.d.ts.map +1 -0
  29. package/internal/qs/index.js +14 -0
  30. package/internal/qs/index.js.map +1 -0
  31. package/internal/qs/index.mjs +10 -0
  32. package/internal/qs/index.mjs.map +1 -0
  33. package/internal/qs/stringify.d.mts +3 -0
  34. package/internal/qs/stringify.d.mts.map +1 -0
  35. package/internal/qs/stringify.d.ts +3 -0
  36. package/internal/qs/stringify.d.ts.map +1 -0
  37. package/internal/qs/stringify.js +277 -0
  38. package/internal/qs/stringify.js.map +1 -0
  39. package/internal/qs/stringify.mjs +274 -0
  40. package/internal/qs/stringify.mjs.map +1 -0
  41. package/internal/qs/types.d.mts +57 -0
  42. package/internal/qs/types.d.mts.map +1 -0
  43. package/internal/qs/types.d.ts +57 -0
  44. package/internal/qs/types.d.ts.map +1 -0
  45. package/internal/qs/types.js +3 -0
  46. package/internal/qs/types.js.map +1 -0
  47. package/internal/qs/types.mjs +2 -0
  48. package/internal/qs/types.mjs.map +1 -0
  49. package/internal/qs/utils.d.mts +15 -0
  50. package/internal/qs/utils.d.mts.map +1 -0
  51. package/internal/qs/utils.d.ts +15 -0
  52. package/internal/qs/utils.d.ts.map +1 -0
  53. package/internal/qs/utils.js +230 -0
  54. package/internal/qs/utils.js.map +1 -0
  55. package/internal/qs/utils.mjs +217 -0
  56. package/internal/qs/utils.mjs.map +1 -0
  57. package/package.json +1 -1
  58. package/resources/apps.d.mts +1 -0
  59. package/resources/apps.d.mts.map +1 -1
  60. package/resources/apps.d.ts +1 -0
  61. package/resources/apps.d.ts.map +1 -1
  62. package/resources/credentials/credentials.d.mts +18 -3
  63. package/resources/credentials/credentials.d.mts.map +1 -1
  64. package/resources/credentials/credentials.d.ts +18 -3
  65. package/resources/credentials/credentials.d.ts.map +1 -1
  66. package/resources/credentials/credentials.js +2 -2
  67. package/resources/credentials/credentials.js.map +1 -1
  68. package/resources/credentials/credentials.mjs +2 -2
  69. package/resources/credentials/credentials.mjs.map +1 -1
  70. package/resources/credentials/index.d.mts +1 -1
  71. package/resources/credentials/index.d.mts.map +1 -1
  72. package/resources/credentials/index.d.ts +1 -1
  73. package/resources/credentials/index.d.ts.map +1 -1
  74. package/resources/credentials/index.js.map +1 -1
  75. package/resources/credentials/index.mjs.map +1 -1
  76. package/resources/credentials/packages/credentials/fields.d.mts +6 -6
  77. package/resources/credentials/packages/credentials/fields.d.ts +6 -6
  78. package/resources/devices/actions.d.mts +10 -10
  79. package/resources/devices/actions.d.ts +10 -10
  80. package/resources/devices/apps.d.mts +24 -10
  81. package/resources/devices/apps.d.mts.map +1 -1
  82. package/resources/devices/apps.d.ts +24 -10
  83. package/resources/devices/apps.d.ts.map +1 -1
  84. package/resources/devices/apps.js +19 -0
  85. package/resources/devices/apps.js.map +1 -1
  86. package/resources/devices/apps.mjs +19 -0
  87. package/resources/devices/apps.mjs.map +1 -1
  88. package/resources/devices/devices.d.mts +26 -14
  89. package/resources/devices/devices.d.mts.map +1 -1
  90. package/resources/devices/devices.d.ts +26 -14
  91. package/resources/devices/devices.d.ts.map +1 -1
  92. package/resources/devices/devices.js +8 -1
  93. package/resources/devices/devices.js.map +1 -1
  94. package/resources/devices/devices.mjs +8 -1
  95. package/resources/devices/devices.mjs.map +1 -1
  96. package/resources/devices/index.d.mts +2 -2
  97. package/resources/devices/index.d.mts.map +1 -1
  98. package/resources/devices/index.d.ts +2 -2
  99. package/resources/devices/index.d.ts.map +1 -1
  100. package/resources/devices/index.js.map +1 -1
  101. package/resources/devices/index.mjs.map +1 -1
  102. package/resources/devices/keyboard.d.mts +5 -5
  103. package/resources/devices/keyboard.d.ts +5 -5
  104. package/resources/devices/packages.d.mts +2 -2
  105. package/resources/devices/packages.d.ts +2 -2
  106. package/resources/devices/state.d.mts +4 -4
  107. package/resources/devices/state.d.ts +4 -4
  108. package/resources/hooks.d.mts +7 -2
  109. package/resources/hooks.d.mts.map +1 -1
  110. package/resources/hooks.d.ts +7 -2
  111. package/resources/hooks.d.ts.map +1 -1
  112. package/resources/hooks.js +4 -3
  113. package/resources/hooks.js.map +1 -1
  114. package/resources/hooks.mjs +4 -3
  115. package/resources/hooks.mjs.map +1 -1
  116. package/resources/index.d.mts +5 -4
  117. package/resources/index.d.mts.map +1 -1
  118. package/resources/index.d.ts +5 -4
  119. package/resources/index.d.ts.map +1 -1
  120. package/resources/index.js +3 -1
  121. package/resources/index.js.map +1 -1
  122. package/resources/index.mjs +2 -1
  123. package/resources/index.mjs.map +1 -1
  124. package/resources/models.d.mts +28 -0
  125. package/resources/models.d.mts.map +1 -0
  126. package/resources/models.d.ts +28 -0
  127. package/resources/models.d.ts.map +1 -0
  128. package/resources/models.js +15 -0
  129. package/resources/models.js.map +1 -0
  130. package/resources/models.mjs +11 -0
  131. package/resources/models.mjs.map +1 -0
  132. package/resources/tasks/index.d.mts +1 -1
  133. package/resources/tasks/index.d.mts.map +1 -1
  134. package/resources/tasks/index.d.ts +1 -1
  135. package/resources/tasks/index.d.ts.map +1 -1
  136. package/resources/tasks/screenshots.d.mts +2 -2
  137. package/resources/tasks/screenshots.d.ts +2 -2
  138. package/resources/tasks/screenshots.js +2 -2
  139. package/resources/tasks/screenshots.mjs +2 -2
  140. package/resources/tasks/tasks.d.mts +120 -411
  141. package/resources/tasks/tasks.d.mts.map +1 -1
  142. package/resources/tasks/tasks.d.ts +120 -411
  143. package/resources/tasks/tasks.d.ts.map +1 -1
  144. package/resources/tasks/tasks.js +12 -10
  145. package/resources/tasks/tasks.js.map +1 -1
  146. package/resources/tasks/tasks.mjs +12 -10
  147. package/resources/tasks/tasks.mjs.map +1 -1
  148. package/resources/tasks/ui-states.d.mts +2 -2
  149. package/resources/tasks/ui-states.d.ts +2 -2
  150. package/resources/tasks/ui-states.js +2 -2
  151. package/resources/tasks/ui-states.mjs +2 -2
  152. package/src/client.ts +45 -26
  153. package/src/internal/parse.ts +6 -0
  154. package/src/internal/qs/LICENSE.md +13 -0
  155. package/src/internal/qs/README.md +3 -0
  156. package/src/internal/qs/formats.ts +10 -0
  157. package/src/internal/qs/index.ts +13 -0
  158. package/src/internal/qs/stringify.ts +385 -0
  159. package/src/internal/qs/types.ts +71 -0
  160. package/src/internal/qs/utils.ts +265 -0
  161. package/src/resources/apps.ts +2 -0
  162. package/src/resources/credentials/credentials.ts +34 -4
  163. package/src/resources/credentials/index.ts +1 -1
  164. package/src/resources/credentials/packages/credentials/fields.ts +6 -6
  165. package/src/resources/devices/actions.ts +10 -10
  166. package/src/resources/devices/apps.ts +42 -9
  167. package/src/resources/devices/devices.ts +37 -11
  168. package/src/resources/devices/index.ts +3 -0
  169. package/src/resources/devices/keyboard.ts +5 -5
  170. package/src/resources/devices/packages.ts +2 -2
  171. package/src/resources/devices/state.ts +4 -4
  172. package/src/resources/hooks.ts +9 -3
  173. package/src/resources/index.ts +11 -3
  174. package/src/resources/models.ts +39 -0
  175. package/src/resources/tasks/index.ts +2 -2
  176. package/src/resources/tasks/screenshots.ts +2 -2
  177. package/src/resources/tasks/tasks.ts +134 -554
  178. package/src/resources/tasks/ui-states.ts +2 -2
  179. package/src/version.ts +1 -1
  180. package/version.d.mts +1 -1
  181. package/version.d.ts +1 -1
  182. package/version.js +1 -1
  183. package/version.mjs +1 -1
@@ -1,6 +1,7 @@
1
1
  // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
2
 
3
3
  import { APIResource } from '../../core/resource';
4
+ import * as TasksAPI from './tasks';
4
5
  import * as ScreenshotsAPI from './screenshots';
5
6
  import { MediaResponse, ScreenshotListResponse, ScreenshotRetrieveParams, Screenshots } from './screenshots';
6
7
  import * as UiStatesAPI from './ui-states';
@@ -15,24 +16,24 @@ export class Tasks extends APIResource {
15
16
  uiStates: UiStatesAPI.UiStates = new UiStatesAPI.UiStates(this._client);
16
17
 
17
18
  /**
18
- * Get Task
19
+ * Get full details of a task by ID.
19
20
  */
20
21
  retrieve(taskID: string, options?: RequestOptions): APIPromise<TaskRetrieveResponse> {
21
22
  return this._client.get(path`/tasks/${taskID}`, options);
22
23
  }
23
24
 
24
25
  /**
25
- * List all tasks you've created so far
26
+ * List tasks with optional filtering, sorting, and pagination.
26
27
  */
27
28
  list(
28
29
  query: TaskListParams | null | undefined = {},
29
30
  options?: RequestOptions,
30
31
  ): APIPromise<TaskListResponse> {
31
- return this._client.get('/tasks/', { query, ...options });
32
+ return this._client.get('/tasks', { query, ...options });
32
33
  }
33
34
 
34
35
  /**
35
- * Attach Task
36
+ * Attach to a running task and receive its events as an SSE stream.
36
37
  */
37
38
  attach(taskID: string, options?: RequestOptions): APIPromise<void> {
38
39
  return this._client.get(path`/tasks/${taskID}/attach`, {
@@ -42,8 +43,7 @@ export class Tasks extends APIResource {
42
43
  }
43
44
 
44
45
  /**
45
- * Get the status of a task. If device is provided, return the status of the
46
- * specific device. Otherwise, return the status of all devices.
46
+ * Get the status of a task.
47
47
  */
48
48
  getStatus(taskID: string, options?: RequestOptions): APIPromise<TaskGetStatusResponse> {
49
49
  return this._client.get(path`/tasks/${taskID}/status`, options);
@@ -57,14 +57,16 @@ export class Tasks extends APIResource {
57
57
  }
58
58
 
59
59
  /**
60
- * Run Task
60
+ * Create and dispatch a new agent task. Returns the task ID and device stream
61
+ * details.
61
62
  */
62
63
  run(body: TaskRunParams, options?: RequestOptions): APIPromise<TaskRunResponse> {
63
- return this._client.post('/tasks/', { body, ...options });
64
+ return this._client.post('/tasks', { body, ...options });
64
65
  }
65
66
 
66
67
  /**
67
- * Run Streamed Task
68
+ * Create and dispatch a new agent task, returning an SSE stream of task events.
69
+ * Cancels the task if the client disconnects.
68
70
  */
69
71
  runStreamed(body: TaskRunStreamedParams, options?: RequestOptions): APIPromise<void> {
70
72
  return this._client.post('/tasks/stream', {
@@ -75,27 +77,27 @@ export class Tasks extends APIResource {
75
77
  }
76
78
 
77
79
  /**
78
- * Stop Task
80
+ * Cancel a running task. Returns an error if the task is already in a terminal
81
+ * state.
79
82
  */
80
83
  stop(taskID: string, options?: RequestOptions): APIPromise<TaskStopResponse> {
81
84
  return this._client.post(path`/tasks/${taskID}/cancel`, options);
82
85
  }
83
86
  }
84
87
 
85
- export type LlmModel =
86
- | 'openai/gpt-5'
87
- | 'google/gemini-2.5-flash'
88
- | 'google/gemini-2.5-pro'
89
- | 'google/gemini-3-pro-preview'
90
- | 'anthropic/claude-sonnet-4.5'
91
- | 'minimax/minimax-m2'
92
- | 'moonshotai/kimi-k2-thinking'
93
- | 'qwen/qwen3-8b';
88
+ export interface PackageCredentials {
89
+ credentialNames: Array<string>;
90
+
91
+ packageName: string;
92
+ }
94
93
 
95
94
  export interface Task {
96
95
  deviceId: string;
97
96
 
98
- llmModel: LlmModel;
97
+ /**
98
+ * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
99
+ */
100
+ llmModel: string;
99
101
 
100
102
  task: string;
101
103
 
@@ -107,7 +109,9 @@ export interface Task {
107
109
 
108
110
  createdAt?: string;
109
111
 
110
- credentials?: Array<Task.Credential>;
112
+ credentials?: Array<PackageCredentials>;
113
+
114
+ displayId?: number;
111
115
 
112
116
  executionTimeout?: number;
113
117
 
@@ -125,12 +129,16 @@ export interface Task {
125
129
 
126
130
  status?: TaskStatus;
127
131
 
132
+ stealth?: boolean;
133
+
128
134
  steps?: number | null;
129
135
 
130
136
  succeeded?: boolean | null;
131
137
 
132
138
  temperature?: number;
133
139
 
140
+ tmpDevice?: boolean;
141
+
134
142
  trajectory?: Array<{ [key: string]: unknown }>;
135
143
 
136
144
  updatedAt?: string;
@@ -140,60 +148,18 @@ export interface Task {
140
148
  vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
141
149
  }
142
150
 
143
- export namespace Task {
144
- export interface Credential {
145
- credentialNames: Array<string>;
146
-
147
- packageName: string;
148
- }
149
- }
150
-
151
- export interface TaskCreate {
152
- llmModel: LlmModel;
153
-
154
- task: string;
155
-
156
- apps?: Array<string>;
157
-
158
- credentials?: Array<TaskCreate.Credential>;
159
-
160
- /**
161
- * The ID of the device to run the task on.
162
- */
163
- deviceId?: string | null;
164
-
165
- /**
166
- * The display ID of the device to run the task on.
167
- */
168
- displayId?: number;
169
-
170
- executionTimeout?: number;
171
-
172
- files?: Array<string>;
173
-
174
- maxSteps?: number;
175
-
176
- outputSchema?: { [key: string]: unknown } | null;
177
-
178
- reasoning?: boolean;
179
-
180
- temperature?: number;
151
+ export type TaskStatus = 'created' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
181
152
 
182
- vision?: boolean;
153
+ export interface UsageResult {
154
+ request_tokens: number;
183
155
 
184
- vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
185
- }
156
+ requests: number;
186
157
 
187
- export namespace TaskCreate {
188
- export interface Credential {
189
- credentialNames: Array<string>;
158
+ response_tokens: number;
190
159
 
191
- packageName: string;
192
- }
160
+ total_tokens: number;
193
161
  }
194
162
 
195
- export type TaskStatus = 'created' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
196
-
197
163
  export interface TaskRetrieveResponse {
198
164
  /**
199
165
  * The task
@@ -274,26 +240,15 @@ export interface TaskGetTrajectoryResponse {
274
240
  | TaskGetTrajectoryResponse.TrajectoryManagerPlanEvent
275
241
  | TaskGetTrajectoryResponse.TrajectoryExecutorInputEvent
276
242
  | TaskGetTrajectoryResponse.TrajectoryExecutorResultEvent
277
- | TaskGetTrajectoryResponse.TrajectoryScripterExecutorInputEvent
278
- | TaskGetTrajectoryResponse.TrajectoryScripterExecutorResultEvent
279
- | TaskGetTrajectoryResponse.TrajectoryPlanCreatedEvent
280
- | TaskGetTrajectoryResponse.TrajectoryPlanInputEvent
281
- | TaskGetTrajectoryResponse.TrajectoryPlanThinkingEvent
282
- | TaskGetTrajectoryResponse.TrajectoryCodeActInputEvent
283
- | TaskGetTrajectoryResponse.TrajectoryCodeActResponseEvent
284
- | TaskGetTrajectoryResponse.TrajectoryCodeActCodeEvent
285
- | TaskGetTrajectoryResponse.TrajectoryCodeActOutputEvent
286
- | TaskGetTrajectoryResponse.TrajectoryCodeActEndEvent
287
- | TaskGetTrajectoryResponse.TrajectoryCodeActExecuteEvent
288
- | TaskGetTrajectoryResponse.TrajectoryCodeActResultEvent
289
- | TaskGetTrajectoryResponse.TrajectoryTapActionEvent
290
- | TaskGetTrajectoryResponse.TrajectorySwipeActionEvent
291
- | TaskGetTrajectoryResponse.TrajectoryDragActionEvent
292
- | TaskGetTrajectoryResponse.TrajectoryInputTextActionEvent
293
- | TaskGetTrajectoryResponse.TrajectoryKeyPressActionEvent
294
- | TaskGetTrajectoryResponse.TrajectoryStartAppEvent
243
+ | TaskGetTrajectoryResponse.TrajectoryFastAgentInputEvent
244
+ | TaskGetTrajectoryResponse.TrajectoryFastAgentResponseEvent
245
+ | TaskGetTrajectoryResponse.TrajectoryFastAgentToolCallEvent
246
+ | TaskGetTrajectoryResponse.TrajectoryFastAgentOutputEvent
247
+ | TaskGetTrajectoryResponse.TrajectoryFastAgentEndEvent
248
+ | TaskGetTrajectoryResponse.TrajectoryFastAgentExecuteEvent
249
+ | TaskGetTrajectoryResponse.TrajectoryFastAgentResultEvent
250
+ | TaskGetTrajectoryResponse.TrajectoryToolExecutionEvent
295
251
  | TaskGetTrajectoryResponse.TrajectoryRecordUiStateEvent
296
- | TaskGetTrajectoryResponse.TrajectoryWaitEvent
297
252
  | TaskGetTrajectoryResponse.TrajectoryManagerContextEvent
298
253
  | TaskGetTrajectoryResponse.TrajectoryManagerResponseEvent
299
254
  | TaskGetTrajectoryResponse.TrajectoryManagerPlanDetailsEvent
@@ -301,13 +256,7 @@ export interface TaskGetTrajectoryResponse {
301
256
  | TaskGetTrajectoryResponse.TrajectoryExecutorResponseEvent
302
257
  | TaskGetTrajectoryResponse.TrajectoryExecutorActionEvent
303
258
  | TaskGetTrajectoryResponse.TrajectoryExecutorActionResultEvent
304
- | TaskGetTrajectoryResponse.TrajectoryScripterInputEvent
305
- | TaskGetTrajectoryResponse.TrajectoryScripterThinkingEvent
306
- | TaskGetTrajectoryResponse.TrajectoryScripterExecutionEvent
307
- | TaskGetTrajectoryResponse.TrajectoryScripterExecutionResultEvent
308
- | TaskGetTrajectoryResponse.TrajectoryScripterEndEvent
309
- | TaskGetTrajectoryResponse.TrajectoryTextManipulatorInputEvent
310
- | TaskGetTrajectoryResponse.TrajectoryTextManipulatorResultEvent
259
+ | TaskGetTrajectoryResponse.TrajectoryUnknownEvent
311
260
  >;
312
261
  }
313
262
 
@@ -422,11 +371,33 @@ export namespace TaskGetTrajectoryResponse {
422
371
  }
423
372
 
424
373
  export interface TrajectoryResultEvent {
425
- data: { [key: string]: unknown };
374
+ /**
375
+ * Lazy wrapper — avoids importing droidrun at module level.
376
+ *
377
+ * The worker uses droidrun's ResultEvent directly; this model only exists so the
378
+ * API OpenAPI schema can reference it without the heavy droidrun import.
379
+ */
380
+ data: TrajectoryResultEvent.Data;
426
381
 
427
382
  event: 'ResultEvent';
428
383
  }
429
384
 
385
+ export namespace TrajectoryResultEvent {
386
+ /**
387
+ * Lazy wrapper — avoids importing droidrun at module level.
388
+ *
389
+ * The worker uses droidrun's ResultEvent directly; this model only exists so the
390
+ * API OpenAPI schema can reference it without the heavy droidrun import.
391
+ */
392
+ export interface Data {
393
+ steps?: number | null;
394
+
395
+ structured_output?: { [key: string]: unknown } | null;
396
+
397
+ success?: boolean | null;
398
+ }
399
+ }
400
+
430
401
  export interface TrajectoryManagerInputEvent {
431
402
  /**
432
403
  * Trigger Manager workflow for planning
@@ -462,7 +433,7 @@ export namespace TaskGetTrajectoryResponse {
462
433
 
463
434
  thought: string;
464
435
 
465
- manager_answer?: string;
436
+ answer?: string;
466
437
 
467
438
  success?: boolean | null;
468
439
  }
@@ -510,85 +481,25 @@ export namespace TaskGetTrajectoryResponse {
510
481
  }
511
482
  }
512
483
 
513
- export interface TrajectoryScripterExecutorInputEvent {
514
- /**
515
- * Trigger ScripterAgent workflow for off-device operations
516
- */
517
- data: TrajectoryScripterExecutorInputEvent.Data;
518
-
519
- event: 'ScripterExecutorInputEvent';
520
- }
521
-
522
- export namespace TrajectoryScripterExecutorInputEvent {
523
- /**
524
- * Trigger ScripterAgent workflow for off-device operations
525
- */
526
- export interface Data {
527
- task: string;
528
- }
529
- }
530
-
531
- export interface TrajectoryScripterExecutorResultEvent {
532
- /**
533
- * Scripter finished.
534
- */
535
- data: TrajectoryScripterExecutorResultEvent.Data;
536
-
537
- event: 'ScripterExecutorResultEvent';
538
- }
539
-
540
- export namespace TrajectoryScripterExecutorResultEvent {
541
- /**
542
- * Scripter finished.
543
- */
544
- export interface Data {
545
- code_executions: number;
546
-
547
- message: string;
548
-
549
- success: boolean;
550
-
551
- task: string;
552
- }
553
- }
554
-
555
- export interface TrajectoryPlanCreatedEvent {
556
- data: { [key: string]: unknown };
557
-
558
- event: 'PlanCreatedEvent';
559
- }
560
-
561
- export interface TrajectoryPlanInputEvent {
562
- data: { [key: string]: unknown };
563
-
564
- event: 'PlanInputEvent';
565
- }
566
-
567
- export interface TrajectoryPlanThinkingEvent {
568
- data: { [key: string]: unknown };
569
-
570
- event: 'PlanThinkingEvent';
571
- }
572
-
573
- export interface TrajectoryCodeActInputEvent {
484
+ export interface TrajectoryFastAgentInputEvent {
574
485
  /**
575
486
  * Input ready for LLM.
576
487
  */
577
488
  data: unknown;
578
489
 
579
- event: 'CodeActInputEvent';
490
+ event: 'FastAgentInputEvent';
580
491
  }
581
492
 
582
- export interface TrajectoryCodeActResponseEvent {
493
+ export interface TrajectoryFastAgentResponseEvent {
583
494
  /**
584
495
  * LLM response received.
585
496
  */
586
- data: TrajectoryCodeActResponseEvent.Data;
497
+ data: TrajectoryFastAgentResponseEvent.Data;
587
498
 
588
- event: 'CodeActResponseEvent';
499
+ event: 'FastAgentResponseEvent';
589
500
  }
590
501
 
591
- export namespace TrajectoryCodeActResponseEvent {
502
+ export namespace TrajectoryFastAgentResponseEvent {
592
503
  /**
593
504
  * LLM response received.
594
505
  */
@@ -597,99 +508,87 @@ export namespace TaskGetTrajectoryResponse {
597
508
 
598
509
  code?: string | null;
599
510
 
600
- usage?: Data.Usage | null;
601
- }
602
-
603
- export namespace Data {
604
- export interface Usage {
605
- request_tokens: number;
606
-
607
- requests: number;
608
-
609
- response_tokens: number;
610
-
611
- total_tokens: number;
612
- }
511
+ usage?: TasksAPI.UsageResult | null;
613
512
  }
614
513
  }
615
514
 
616
- export interface TrajectoryCodeActCodeEvent {
515
+ export interface TrajectoryFastAgentToolCallEvent {
617
516
  /**
618
- * Code ready to execute (internal event).
517
+ * Tool calls ready to execute.
619
518
  */
620
- data: TrajectoryCodeActCodeEvent.Data;
519
+ data: TrajectoryFastAgentToolCallEvent.Data;
621
520
 
622
- event: 'CodeActCodeEvent';
521
+ event: 'FastAgentToolCallEvent';
623
522
  }
624
523
 
625
- export namespace TrajectoryCodeActCodeEvent {
524
+ export namespace TrajectoryFastAgentToolCallEvent {
626
525
  /**
627
- * Code ready to execute (internal event).
526
+ * Tool calls ready to execute.
628
527
  */
629
528
  export interface Data {
630
- code: string;
529
+ tool_calls_repr: string;
631
530
  }
632
531
  }
633
532
 
634
- export interface TrajectoryCodeActOutputEvent {
533
+ export interface TrajectoryFastAgentOutputEvent {
635
534
  /**
636
- * Code execution result (internal event).
535
+ * Tool execution result.
637
536
  */
638
- data: TrajectoryCodeActOutputEvent.Data;
537
+ data: TrajectoryFastAgentOutputEvent.Data;
639
538
 
640
- event: 'CodeActOutputEvent';
539
+ event: 'FastAgentOutputEvent';
641
540
  }
642
541
 
643
- export namespace TrajectoryCodeActOutputEvent {
542
+ export namespace TrajectoryFastAgentOutputEvent {
644
543
  /**
645
- * Code execution result (internal event).
544
+ * Tool execution result.
646
545
  */
647
546
  export interface Data {
648
547
  output: string;
649
548
  }
650
549
  }
651
550
 
652
- export interface TrajectoryCodeActEndEvent {
551
+ export interface TrajectoryFastAgentEndEvent {
653
552
  /**
654
- * CodeAct finished.
553
+ * FastAgent finished.
655
554
  */
656
- data: TrajectoryCodeActEndEvent.Data;
555
+ data: TrajectoryFastAgentEndEvent.Data;
657
556
 
658
- event: 'CodeActEndEvent';
557
+ event: 'FastAgentEndEvent';
659
558
  }
660
559
 
661
- export namespace TrajectoryCodeActEndEvent {
560
+ export namespace TrajectoryFastAgentEndEvent {
662
561
  /**
663
- * CodeAct finished.
562
+ * FastAgent finished.
664
563
  */
665
564
  export interface Data {
666
565
  reason: string;
667
566
 
668
567
  success: boolean;
669
568
 
670
- code_executions?: number;
569
+ tool_call_count?: number;
671
570
  }
672
571
  }
673
572
 
674
- export interface TrajectoryCodeActExecuteEvent {
675
- data: TrajectoryCodeActExecuteEvent.Data;
573
+ export interface TrajectoryFastAgentExecuteEvent {
574
+ data: TrajectoryFastAgentExecuteEvent.Data;
676
575
 
677
- event: 'CodeActExecuteEvent';
576
+ event: 'FastAgentExecuteEvent';
678
577
  }
679
578
 
680
- export namespace TrajectoryCodeActExecuteEvent {
579
+ export namespace TrajectoryFastAgentExecuteEvent {
681
580
  export interface Data {
682
581
  instruction: string;
683
582
  }
684
583
  }
685
584
 
686
- export interface TrajectoryCodeActResultEvent {
687
- data: TrajectoryCodeActResultEvent.Data;
585
+ export interface TrajectoryFastAgentResultEvent {
586
+ data: TrajectoryFastAgentResultEvent.Data;
688
587
 
689
- event: 'CodeActResultEvent';
588
+ event: 'FastAgentResultEvent';
690
589
  }
691
590
 
692
- export namespace TrajectoryCodeActResultEvent {
591
+ export namespace TrajectoryFastAgentResultEvent {
693
592
  export interface Data {
694
593
  instruction: string;
695
594
 
@@ -699,163 +598,27 @@ export namespace TaskGetTrajectoryResponse {
699
598
  }
700
599
  }
701
600
 
702
- export interface TrajectoryTapActionEvent {
601
+ export interface TrajectoryToolExecutionEvent {
703
602
  /**
704
- * Event for tap actions with coordinates
603
+ * Emitted after every tool call dispatched through ToolRegistry.
705
604
  */
706
- data: TrajectoryTapActionEvent.Data;
605
+ data: TrajectoryToolExecutionEvent.Data;
707
606
 
708
- event: 'TapActionEvent';
607
+ event: 'ToolExecutionEvent';
709
608
  }
710
609
 
711
- export namespace TrajectoryTapActionEvent {
610
+ export namespace TrajectoryToolExecutionEvent {
712
611
  /**
713
- * Event for tap actions with coordinates
612
+ * Emitted after every tool call dispatched through ToolRegistry.
714
613
  */
715
614
  export interface Data {
716
- action_type: string;
717
-
718
- description: string;
719
-
720
- x: number;
721
-
722
- y: number;
723
-
724
- element_bounds?: string;
725
-
726
- element_index?: number | null;
727
-
728
- element_text?: string;
729
- }
730
- }
731
-
732
- export interface TrajectorySwipeActionEvent {
733
- /**
734
- * Event for swipe actions with coordinates
735
- */
736
- data: TrajectorySwipeActionEvent.Data;
737
-
738
- event: 'SwipeActionEvent';
739
- }
740
-
741
- export namespace TrajectorySwipeActionEvent {
742
- /**
743
- * Event for swipe actions with coordinates
744
- */
745
- export interface Data {
746
- action_type: string;
747
-
748
- description: string;
749
-
750
- duration_ms: number;
751
-
752
- end_x: number;
753
-
754
- end_y: number;
755
-
756
- start_x: number;
757
-
758
- start_y: number;
759
- }
760
- }
761
-
762
- export interface TrajectoryDragActionEvent {
763
- /**
764
- * Event for drag actions with coordinates
765
- */
766
- data: TrajectoryDragActionEvent.Data;
767
-
768
- event: 'DragActionEvent';
769
- }
770
-
771
- export namespace TrajectoryDragActionEvent {
772
- /**
773
- * Event for drag actions with coordinates
774
- */
775
- export interface Data {
776
- action_type: string;
777
-
778
- description: string;
779
-
780
- duration_ms: number;
781
-
782
- end_x: number;
783
-
784
- end_y: number;
785
-
786
- start_x: number;
787
-
788
- start_y: number;
789
- }
790
- }
791
-
792
- export interface TrajectoryInputTextActionEvent {
793
- /**
794
- * Event for text input actions
795
- */
796
- data: TrajectoryInputTextActionEvent.Data;
797
-
798
- event: 'InputTextActionEvent';
799
- }
800
-
801
- export namespace TrajectoryInputTextActionEvent {
802
- /**
803
- * Event for text input actions
804
- */
805
- export interface Data {
806
- action_type: string;
807
-
808
- description: string;
809
-
810
- text: string;
811
- }
812
- }
813
-
814
- export interface TrajectoryKeyPressActionEvent {
815
- /**
816
- * Event for key press actions
817
- */
818
- data: TrajectoryKeyPressActionEvent.Data;
819
-
820
- event: 'KeyPressActionEvent';
821
- }
822
-
823
- export namespace TrajectoryKeyPressActionEvent {
824
- /**
825
- * Event for key press actions
826
- */
827
- export interface Data {
828
- action_type: string;
829
-
830
- description: string;
831
-
832
- keycode: number;
833
-
834
- key_name?: string;
835
- }
836
- }
837
-
838
- export interface TrajectoryStartAppEvent {
839
- /**
840
- * "Event for starting an app
841
- */
842
- data: TrajectoryStartAppEvent.Data;
843
-
844
- event: 'StartAppEvent';
845
- }
846
-
847
- export namespace TrajectoryStartAppEvent {
848
- /**
849
- * "Event for starting an app
850
- */
851
- export interface Data {
852
- action_type: string;
615
+ success: boolean;
853
616
 
854
- description: string;
617
+ summary: string;
855
618
 
856
- package: string;
619
+ tool_args: { [key: string]: unknown };
857
620
 
858
- activity?: string | null;
621
+ tool_name: string;
859
622
  }
860
623
  }
861
624
 
@@ -873,28 +636,6 @@ export namespace TaskGetTrajectoryResponse {
873
636
  }
874
637
  }
875
638
 
876
- export interface TrajectoryWaitEvent {
877
- /**
878
- * Event for wait/sleep actions
879
- */
880
- data: TrajectoryWaitEvent.Data;
881
-
882
- event: 'WaitEvent';
883
- }
884
-
885
- export namespace TrajectoryWaitEvent {
886
- /**
887
- * Event for wait/sleep actions
888
- */
889
- export interface Data {
890
- action_type: string;
891
-
892
- description: string;
893
-
894
- duration: number;
895
- }
896
- }
897
-
898
639
  export interface TrajectoryManagerContextEvent {
899
640
  /**
900
641
  * Context prepared, ready for LLM call.
@@ -920,19 +661,7 @@ export namespace TaskGetTrajectoryResponse {
920
661
  export interface Data {
921
662
  response: string;
922
663
 
923
- usage?: Data.Usage | null;
924
- }
925
-
926
- export namespace Data {
927
- export interface Usage {
928
- request_tokens: number;
929
-
930
- requests: number;
931
-
932
- response_tokens: number;
933
-
934
- total_tokens: number;
935
- }
664
+ usage?: TasksAPI.UsageResult | null;
936
665
  }
937
666
  }
938
667
 
@@ -1002,19 +731,7 @@ export namespace TaskGetTrajectoryResponse {
1002
731
  export interface Data {
1003
732
  response: string;
1004
733
 
1005
- usage?: Data.Usage | null;
1006
- }
1007
-
1008
- export namespace Data {
1009
- export interface Usage {
1010
- request_tokens: number;
1011
-
1012
- requests: number;
1013
-
1014
- response_tokens: number;
1015
-
1016
- total_tokens: number;
1017
- }
734
+ usage?: TasksAPI.UsageResult | null;
1018
735
  }
1019
736
  }
1020
737
 
@@ -1070,141 +787,10 @@ export namespace TaskGetTrajectoryResponse {
1070
787
  }
1071
788
  }
1072
789
 
1073
- export interface TrajectoryScripterInputEvent {
1074
- /**
1075
- * Input ready for LLM.
1076
- */
1077
- data: unknown;
1078
-
1079
- event: 'ScripterInputEvent';
1080
- }
1081
-
1082
- export interface TrajectoryScripterThinkingEvent {
1083
- /**
1084
- * LLM response received.
1085
- */
1086
- data: TrajectoryScripterThinkingEvent.Data;
1087
-
1088
- event: 'ScripterThinkingEvent';
1089
- }
1090
-
1091
- export namespace TrajectoryScripterThinkingEvent {
1092
- /**
1093
- * LLM response received.
1094
- */
1095
- export interface Data {
1096
- thought: string;
1097
-
1098
- code?: string | null;
1099
-
1100
- full_response?: string;
1101
-
1102
- usage?: Data.Usage | null;
1103
- }
1104
-
1105
- export namespace Data {
1106
- export interface Usage {
1107
- request_tokens: number;
1108
-
1109
- requests: number;
1110
-
1111
- response_tokens: number;
1112
-
1113
- total_tokens: number;
1114
- }
1115
- }
1116
- }
1117
-
1118
- export interface TrajectoryScripterExecutionEvent {
1119
- /**
1120
- * Code ready to execute.
1121
- */
1122
- data: TrajectoryScripterExecutionEvent.Data;
1123
-
1124
- event: 'ScripterExecutionEvent';
1125
- }
790
+ export interface TrajectoryUnknownEvent {
791
+ event: string;
1126
792
 
1127
- export namespace TrajectoryScripterExecutionEvent {
1128
- /**
1129
- * Code ready to execute.
1130
- */
1131
- export interface Data {
1132
- code: string;
1133
- }
1134
- }
1135
-
1136
- export interface TrajectoryScripterExecutionResultEvent {
1137
- /**
1138
- * Code execution result.
1139
- */
1140
- data: TrajectoryScripterExecutionResultEvent.Data;
1141
-
1142
- event: 'ScripterExecutionResultEvent';
1143
- }
1144
-
1145
- export namespace TrajectoryScripterExecutionResultEvent {
1146
- /**
1147
- * Code execution result.
1148
- */
1149
- export interface Data {
1150
- output: string;
1151
- }
1152
- }
1153
-
1154
- export interface TrajectoryScripterEndEvent {
1155
- /**
1156
- * Scripter finished.
1157
- */
1158
- data: TrajectoryScripterEndEvent.Data;
1159
-
1160
- event: 'ScripterEndEvent';
1161
- }
1162
-
1163
- export namespace TrajectoryScripterEndEvent {
1164
- /**
1165
- * Scripter finished.
1166
- */
1167
- export interface Data {
1168
- message: string;
1169
-
1170
- success: boolean;
1171
-
1172
- code_executions?: number;
1173
- }
1174
- }
1175
-
1176
- export interface TrajectoryTextManipulatorInputEvent {
1177
- /**
1178
- * Trigger TextManipulatorAgent workflow for text manipulation
1179
- */
1180
- data: TrajectoryTextManipulatorInputEvent.Data;
1181
-
1182
- event: 'TextManipulatorInputEvent';
1183
- }
1184
-
1185
- export namespace TrajectoryTextManipulatorInputEvent {
1186
- /**
1187
- * Trigger TextManipulatorAgent workflow for text manipulation
1188
- */
1189
- export interface Data {
1190
- task: string;
1191
- }
1192
- }
1193
-
1194
- export interface TrajectoryTextManipulatorResultEvent {
1195
- data: TrajectoryTextManipulatorResultEvent.Data;
1196
-
1197
- event: 'TextManipulatorResultEvent';
1198
- }
1199
-
1200
- export namespace TrajectoryTextManipulatorResultEvent {
1201
- export interface Data {
1202
- code_ran: string;
1203
-
1204
- task: string;
1205
-
1206
- text_to_type: string;
1207
- }
793
+ data?: { [key: string]: unknown };
1208
794
  }
1209
795
  }
1210
796
 
@@ -1256,13 +842,16 @@ export interface TaskListParams {
1256
842
  }
1257
843
 
1258
844
  export interface TaskRunParams {
1259
- llmModel: LlmModel;
845
+ /**
846
+ * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
847
+ */
848
+ llmModel: string;
1260
849
 
1261
850
  task: string;
1262
851
 
1263
852
  apps?: Array<string>;
1264
853
 
1265
- credentials?: Array<TaskRunParams.Credential>;
854
+ credentials?: Array<PackageCredentials>;
1266
855
 
1267
856
  /**
1268
857
  * The ID of the device to run the task on.
@@ -1284,6 +873,8 @@ export interface TaskRunParams {
1284
873
 
1285
874
  reasoning?: boolean;
1286
875
 
876
+ stealth?: boolean;
877
+
1287
878
  temperature?: number;
1288
879
 
1289
880
  vision?: boolean;
@@ -1291,22 +882,17 @@ export interface TaskRunParams {
1291
882
  vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
1292
883
  }
1293
884
 
1294
- export namespace TaskRunParams {
1295
- export interface Credential {
1296
- credentialNames: Array<string>;
1297
-
1298
- packageName: string;
1299
- }
1300
- }
1301
-
1302
885
  export interface TaskRunStreamedParams {
1303
- llmModel: LlmModel;
886
+ /**
887
+ * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
888
+ */
889
+ llmModel: string;
1304
890
 
1305
891
  task: string;
1306
892
 
1307
893
  apps?: Array<string>;
1308
894
 
1309
- credentials?: Array<TaskRunStreamedParams.Credential>;
895
+ credentials?: Array<PackageCredentials>;
1310
896
 
1311
897
  /**
1312
898
  * The ID of the device to run the task on.
@@ -1328,6 +914,8 @@ export interface TaskRunStreamedParams {
1328
914
 
1329
915
  reasoning?: boolean;
1330
916
 
917
+ stealth?: boolean;
918
+
1331
919
  temperature?: number;
1332
920
 
1333
921
  vision?: boolean;
@@ -1335,23 +923,15 @@ export interface TaskRunStreamedParams {
1335
923
  vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
1336
924
  }
1337
925
 
1338
- export namespace TaskRunStreamedParams {
1339
- export interface Credential {
1340
- credentialNames: Array<string>;
1341
-
1342
- packageName: string;
1343
- }
1344
- }
1345
-
1346
926
  Tasks.Screenshots = Screenshots;
1347
927
  Tasks.UiStates = UiStates;
1348
928
 
1349
929
  export declare namespace Tasks {
1350
930
  export {
1351
- type LlmModel as LlmModel,
931
+ type PackageCredentials as PackageCredentials,
1352
932
  type Task as Task,
1353
- type TaskCreate as TaskCreate,
1354
933
  type TaskStatus as TaskStatus,
934
+ type UsageResult as UsageResult,
1355
935
  type TaskRetrieveResponse as TaskRetrieveResponse,
1356
936
  type TaskListResponse as TaskListResponse,
1357
937
  type TaskGetStatusResponse as TaskGetStatusResponse,