@mobilerun/sdk 2.0.0 → 2.1.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 (185) hide show
  1. package/CHANGELOG.md +65 -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/index.js.map +1 -1
  137. package/resources/tasks/index.mjs.map +1 -1
  138. package/resources/tasks/screenshots.d.mts +2 -2
  139. package/resources/tasks/screenshots.d.ts +2 -2
  140. package/resources/tasks/screenshots.js +2 -2
  141. package/resources/tasks/screenshots.mjs +2 -2
  142. package/resources/tasks/tasks.d.mts +103 -363
  143. package/resources/tasks/tasks.d.mts.map +1 -1
  144. package/resources/tasks/tasks.d.ts +103 -363
  145. package/resources/tasks/tasks.d.ts.map +1 -1
  146. package/resources/tasks/tasks.js +12 -10
  147. package/resources/tasks/tasks.js.map +1 -1
  148. package/resources/tasks/tasks.mjs +12 -10
  149. package/resources/tasks/tasks.mjs.map +1 -1
  150. package/resources/tasks/ui-states.d.mts +2 -2
  151. package/resources/tasks/ui-states.d.ts +2 -2
  152. package/resources/tasks/ui-states.js +2 -2
  153. package/resources/tasks/ui-states.mjs +2 -2
  154. package/src/client.ts +41 -26
  155. package/src/internal/parse.ts +6 -0
  156. package/src/internal/qs/LICENSE.md +13 -0
  157. package/src/internal/qs/README.md +3 -0
  158. package/src/internal/qs/formats.ts +10 -0
  159. package/src/internal/qs/index.ts +13 -0
  160. package/src/internal/qs/stringify.ts +385 -0
  161. package/src/internal/qs/types.ts +71 -0
  162. package/src/internal/qs/utils.ts +265 -0
  163. package/src/resources/apps.ts +2 -0
  164. package/src/resources/credentials/credentials.ts +34 -4
  165. package/src/resources/credentials/index.ts +1 -1
  166. package/src/resources/credentials/packages/credentials/fields.ts +6 -6
  167. package/src/resources/devices/actions.ts +10 -10
  168. package/src/resources/devices/apps.ts +42 -9
  169. package/src/resources/devices/devices.ts +37 -11
  170. package/src/resources/devices/index.ts +3 -0
  171. package/src/resources/devices/keyboard.ts +5 -5
  172. package/src/resources/devices/packages.ts +2 -2
  173. package/src/resources/devices/state.ts +4 -4
  174. package/src/resources/hooks.ts +9 -3
  175. package/src/resources/index.ts +9 -3
  176. package/src/resources/models.ts +39 -0
  177. package/src/resources/tasks/index.ts +0 -2
  178. package/src/resources/tasks/screenshots.ts +2 -2
  179. package/src/resources/tasks/tasks.ts +114 -493
  180. package/src/resources/tasks/ui-states.ts +2 -2
  181. package/src/version.ts +1 -1
  182. package/version.d.mts +1 -1
  183. package/version.d.ts +1 -1
  184. package/version.js +1 -1
  185. package/version.mjs +1 -1
@@ -9,20 +9,19 @@ export declare class Tasks extends APIResource {
9
9
  screenshots: ScreenshotsAPI.Screenshots;
10
10
  uiStates: UiStatesAPI.UiStates;
11
11
  /**
12
- * Get Task
12
+ * Get full details of a task by ID.
13
13
  */
14
14
  retrieve(taskID: string, options?: RequestOptions): APIPromise<TaskRetrieveResponse>;
15
15
  /**
16
- * List all tasks you've created so far
16
+ * List tasks with optional filtering, sorting, and pagination.
17
17
  */
18
18
  list(query?: TaskListParams | null | undefined, options?: RequestOptions): APIPromise<TaskListResponse>;
19
19
  /**
20
- * Attach Task
20
+ * Attach to a running task and receive its events as an SSE stream.
21
21
  */
22
22
  attach(taskID: string, options?: RequestOptions): APIPromise<void>;
23
23
  /**
24
- * Get the status of a task. If device is provided, return the status of the
25
- * specific device. Otherwise, return the status of all devices.
24
+ * Get the status of a task.
26
25
  */
27
26
  getStatus(taskID: string, options?: RequestOptions): APIPromise<TaskGetStatusResponse>;
28
27
  /**
@@ -30,28 +29,34 @@ export declare class Tasks extends APIResource {
30
29
  */
31
30
  getTrajectory(taskID: string, options?: RequestOptions): APIPromise<TaskGetTrajectoryResponse>;
32
31
  /**
33
- * Run Task
32
+ * Create and dispatch a new agent task. Returns the task ID and device stream
33
+ * details.
34
34
  */
35
35
  run(body: TaskRunParams, options?: RequestOptions): APIPromise<TaskRunResponse>;
36
36
  /**
37
- * Run Streamed Task
37
+ * Create and dispatch a new agent task, returning an SSE stream of task events.
38
+ * Cancels the task if the client disconnects.
38
39
  */
39
40
  runStreamed(body: TaskRunStreamedParams, options?: RequestOptions): APIPromise<void>;
40
41
  /**
41
- * Stop Task
42
+ * Cancel a running task. Returns an error if the task is already in a terminal
43
+ * state.
42
44
  */
43
45
  stop(taskID: string, options?: RequestOptions): APIPromise<TaskStopResponse>;
44
46
  }
45
- export type LlmModel = 'openai/gpt-5' | 'google/gemini-2.5-flash' | 'google/gemini-2.5-pro' | 'google/gemini-3-pro-preview' | 'anthropic/claude-sonnet-4.5' | 'minimax/minimax-m2' | 'moonshotai/kimi-k2-thinking' | 'qwen/qwen3-8b';
46
47
  export interface Task {
47
48
  deviceId: string;
48
- llmModel: LlmModel;
49
+ /**
50
+ * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
51
+ */
52
+ llmModel: string;
49
53
  task: string;
50
54
  userId: string;
51
55
  id?: string;
52
56
  apps?: Array<string>;
53
57
  createdAt?: string;
54
58
  credentials?: Array<Task.Credential>;
59
+ displayId?: number;
55
60
  executionTimeout?: number;
56
61
  files?: Array<string>;
57
62
  finishedAt?: string | null;
@@ -64,9 +69,11 @@ export interface Task {
64
69
  } | null;
65
70
  reasoning?: boolean;
66
71
  status?: TaskStatus;
72
+ stealth?: boolean;
67
73
  steps?: number | null;
68
74
  succeeded?: boolean | null;
69
75
  temperature?: number;
76
+ tmpDevice?: boolean;
70
77
  trajectory?: Array<{
71
78
  [key: string]: unknown;
72
79
  }>;
@@ -80,36 +87,6 @@ export declare namespace Task {
80
87
  packageName: string;
81
88
  }
82
89
  }
83
- export interface TaskCreate {
84
- llmModel: LlmModel;
85
- task: string;
86
- apps?: Array<string>;
87
- credentials?: Array<TaskCreate.Credential>;
88
- /**
89
- * The ID of the device to run the task on.
90
- */
91
- deviceId?: string | null;
92
- /**
93
- * The display ID of the device to run the task on.
94
- */
95
- displayId?: number;
96
- executionTimeout?: number;
97
- files?: Array<string>;
98
- maxSteps?: number;
99
- outputSchema?: {
100
- [key: string]: unknown;
101
- } | null;
102
- reasoning?: boolean;
103
- temperature?: number;
104
- vision?: boolean;
105
- vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
106
- }
107
- export declare namespace TaskCreate {
108
- interface Credential {
109
- credentialNames: Array<string>;
110
- packageName: string;
111
- }
112
- }
113
90
  export type TaskStatus = 'created' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
114
91
  export interface TaskRetrieveResponse {
115
92
  /**
@@ -168,7 +145,7 @@ export interface TaskGetTrajectoryResponse {
168
145
  /**
169
146
  * The trajectory of the task
170
147
  */
171
- trajectory: Array<TaskGetTrajectoryResponse.TrajectoryCreatedEvent | TaskGetTrajectoryResponse.TrajectoryExceptionEvent | TaskGetTrajectoryResponse.TrajectoryCancelEvent | TaskGetTrajectoryResponse.TrajectoryScreenshotEvent | TaskGetTrajectoryResponse.TrajectoryStartEvent | TaskGetTrajectoryResponse.TrajectoryFinalizeEvent | TaskGetTrajectoryResponse.TrajectoryStopEvent | TaskGetTrajectoryResponse.TrajectoryResultEvent | TaskGetTrajectoryResponse.TrajectoryManagerInputEvent | TaskGetTrajectoryResponse.TrajectoryManagerPlanEvent | TaskGetTrajectoryResponse.TrajectoryExecutorInputEvent | TaskGetTrajectoryResponse.TrajectoryExecutorResultEvent | TaskGetTrajectoryResponse.TrajectoryScripterExecutorInputEvent | TaskGetTrajectoryResponse.TrajectoryScripterExecutorResultEvent | TaskGetTrajectoryResponse.TrajectoryPlanCreatedEvent | TaskGetTrajectoryResponse.TrajectoryPlanInputEvent | TaskGetTrajectoryResponse.TrajectoryPlanThinkingEvent | TaskGetTrajectoryResponse.TrajectoryCodeActInputEvent | TaskGetTrajectoryResponse.TrajectoryCodeActResponseEvent | TaskGetTrajectoryResponse.TrajectoryCodeActCodeEvent | TaskGetTrajectoryResponse.TrajectoryCodeActOutputEvent | TaskGetTrajectoryResponse.TrajectoryCodeActEndEvent | TaskGetTrajectoryResponse.TrajectoryCodeActExecuteEvent | TaskGetTrajectoryResponse.TrajectoryCodeActResultEvent | TaskGetTrajectoryResponse.TrajectoryTapActionEvent | TaskGetTrajectoryResponse.TrajectorySwipeActionEvent | TaskGetTrajectoryResponse.TrajectoryDragActionEvent | TaskGetTrajectoryResponse.TrajectoryInputTextActionEvent | TaskGetTrajectoryResponse.TrajectoryKeyPressActionEvent | TaskGetTrajectoryResponse.TrajectoryStartAppEvent | TaskGetTrajectoryResponse.TrajectoryRecordUiStateEvent | TaskGetTrajectoryResponse.TrajectoryWaitEvent | TaskGetTrajectoryResponse.TrajectoryManagerContextEvent | TaskGetTrajectoryResponse.TrajectoryManagerResponseEvent | TaskGetTrajectoryResponse.TrajectoryManagerPlanDetailsEvent | TaskGetTrajectoryResponse.TrajectoryExecutorContextEvent | TaskGetTrajectoryResponse.TrajectoryExecutorResponseEvent | TaskGetTrajectoryResponse.TrajectoryExecutorActionEvent | TaskGetTrajectoryResponse.TrajectoryExecutorActionResultEvent | TaskGetTrajectoryResponse.TrajectoryScripterInputEvent | TaskGetTrajectoryResponse.TrajectoryScripterThinkingEvent | TaskGetTrajectoryResponse.TrajectoryScripterExecutionEvent | TaskGetTrajectoryResponse.TrajectoryScripterExecutionResultEvent | TaskGetTrajectoryResponse.TrajectoryScripterEndEvent | TaskGetTrajectoryResponse.TrajectoryTextManipulatorInputEvent | TaskGetTrajectoryResponse.TrajectoryTextManipulatorResultEvent>;
148
+ trajectory: Array<TaskGetTrajectoryResponse.TrajectoryCreatedEvent | TaskGetTrajectoryResponse.TrajectoryExceptionEvent | TaskGetTrajectoryResponse.TrajectoryCancelEvent | TaskGetTrajectoryResponse.TrajectoryScreenshotEvent | TaskGetTrajectoryResponse.TrajectoryStartEvent | TaskGetTrajectoryResponse.TrajectoryFinalizeEvent | TaskGetTrajectoryResponse.TrajectoryStopEvent | TaskGetTrajectoryResponse.TrajectoryResultEvent | TaskGetTrajectoryResponse.TrajectoryManagerInputEvent | TaskGetTrajectoryResponse.TrajectoryManagerPlanEvent | TaskGetTrajectoryResponse.TrajectoryExecutorInputEvent | TaskGetTrajectoryResponse.TrajectoryExecutorResultEvent | TaskGetTrajectoryResponse.TrajectoryFastAgentInputEvent | TaskGetTrajectoryResponse.TrajectoryFastAgentResponseEvent | TaskGetTrajectoryResponse.TrajectoryFastAgentToolCallEvent | TaskGetTrajectoryResponse.TrajectoryFastAgentOutputEvent | TaskGetTrajectoryResponse.TrajectoryFastAgentEndEvent | TaskGetTrajectoryResponse.TrajectoryFastAgentExecuteEvent | TaskGetTrajectoryResponse.TrajectoryFastAgentResultEvent | TaskGetTrajectoryResponse.TrajectoryToolExecutionEvent | TaskGetTrajectoryResponse.TrajectoryRecordUiStateEvent | TaskGetTrajectoryResponse.TrajectoryManagerContextEvent | TaskGetTrajectoryResponse.TrajectoryManagerResponseEvent | TaskGetTrajectoryResponse.TrajectoryManagerPlanDetailsEvent | TaskGetTrajectoryResponse.TrajectoryExecutorContextEvent | TaskGetTrajectoryResponse.TrajectoryExecutorResponseEvent | TaskGetTrajectoryResponse.TrajectoryExecutorActionEvent | TaskGetTrajectoryResponse.TrajectoryExecutorActionResultEvent | TaskGetTrajectoryResponse.TrajectoryUnknownEvent>;
172
149
  }
173
150
  export declare namespace TaskGetTrajectoryResponse {
174
151
  interface TrajectoryCreatedEvent {
@@ -258,11 +235,30 @@ export declare namespace TaskGetTrajectoryResponse {
258
235
  event: 'StopEvent';
259
236
  }
260
237
  interface TrajectoryResultEvent {
261
- data: {
262
- [key: string]: unknown;
263
- };
238
+ /**
239
+ * Lazy wrapper — avoids importing droidrun at module level.
240
+ *
241
+ * The worker uses droidrun's ResultEvent directly; this model only exists so the
242
+ * API OpenAPI schema can reference it without the heavy droidrun import.
243
+ */
244
+ data: TrajectoryResultEvent.Data;
264
245
  event: 'ResultEvent';
265
246
  }
247
+ namespace TrajectoryResultEvent {
248
+ /**
249
+ * Lazy wrapper — avoids importing droidrun at module level.
250
+ *
251
+ * The worker uses droidrun's ResultEvent directly; this model only exists so the
252
+ * API OpenAPI schema can reference it without the heavy droidrun import.
253
+ */
254
+ interface Data {
255
+ steps?: number | null;
256
+ structured_output?: {
257
+ [key: string]: unknown;
258
+ } | null;
259
+ success?: boolean | null;
260
+ }
261
+ }
266
262
  interface TrajectoryManagerInputEvent {
267
263
  /**
268
264
  * Trigger Manager workflow for planning
@@ -291,7 +287,7 @@ export declare namespace TaskGetTrajectoryResponse {
291
287
  current_subgoal: string;
292
288
  plan: string;
293
289
  thought: string;
294
- manager_answer?: string;
290
+ answer?: string;
295
291
  success?: boolean | null;
296
292
  }
297
293
  }
@@ -330,72 +326,21 @@ export declare namespace TaskGetTrajectoryResponse {
330
326
  summary: string;
331
327
  }
332
328
  }
333
- interface TrajectoryScripterExecutorInputEvent {
334
- /**
335
- * Trigger ScripterAgent workflow for off-device operations
336
- */
337
- data: TrajectoryScripterExecutorInputEvent.Data;
338
- event: 'ScripterExecutorInputEvent';
339
- }
340
- namespace TrajectoryScripterExecutorInputEvent {
341
- /**
342
- * Trigger ScripterAgent workflow for off-device operations
343
- */
344
- interface Data {
345
- task: string;
346
- }
347
- }
348
- interface TrajectoryScripterExecutorResultEvent {
349
- /**
350
- * Scripter finished.
351
- */
352
- data: TrajectoryScripterExecutorResultEvent.Data;
353
- event: 'ScripterExecutorResultEvent';
354
- }
355
- namespace TrajectoryScripterExecutorResultEvent {
356
- /**
357
- * Scripter finished.
358
- */
359
- interface Data {
360
- code_executions: number;
361
- message: string;
362
- success: boolean;
363
- task: string;
364
- }
365
- }
366
- interface TrajectoryPlanCreatedEvent {
367
- data: {
368
- [key: string]: unknown;
369
- };
370
- event: 'PlanCreatedEvent';
371
- }
372
- interface TrajectoryPlanInputEvent {
373
- data: {
374
- [key: string]: unknown;
375
- };
376
- event: 'PlanInputEvent';
377
- }
378
- interface TrajectoryPlanThinkingEvent {
379
- data: {
380
- [key: string]: unknown;
381
- };
382
- event: 'PlanThinkingEvent';
383
- }
384
- interface TrajectoryCodeActInputEvent {
329
+ interface TrajectoryFastAgentInputEvent {
385
330
  /**
386
331
  * Input ready for LLM.
387
332
  */
388
333
  data: unknown;
389
- event: 'CodeActInputEvent';
334
+ event: 'FastAgentInputEvent';
390
335
  }
391
- interface TrajectoryCodeActResponseEvent {
336
+ interface TrajectoryFastAgentResponseEvent {
392
337
  /**
393
338
  * LLM response received.
394
339
  */
395
- data: TrajectoryCodeActResponseEvent.Data;
396
- event: 'CodeActResponseEvent';
340
+ data: TrajectoryFastAgentResponseEvent.Data;
341
+ event: 'FastAgentResponseEvent';
397
342
  }
398
- namespace TrajectoryCodeActResponseEvent {
343
+ namespace TrajectoryFastAgentResponseEvent {
399
344
  /**
400
345
  * LLM response received.
401
346
  */
@@ -413,187 +358,91 @@ export declare namespace TaskGetTrajectoryResponse {
413
358
  }
414
359
  }
415
360
  }
416
- interface TrajectoryCodeActCodeEvent {
361
+ interface TrajectoryFastAgentToolCallEvent {
417
362
  /**
418
- * Code ready to execute (internal event).
363
+ * Tool calls ready to execute.
419
364
  */
420
- data: TrajectoryCodeActCodeEvent.Data;
421
- event: 'CodeActCodeEvent';
365
+ data: TrajectoryFastAgentToolCallEvent.Data;
366
+ event: 'FastAgentToolCallEvent';
422
367
  }
423
- namespace TrajectoryCodeActCodeEvent {
368
+ namespace TrajectoryFastAgentToolCallEvent {
424
369
  /**
425
- * Code ready to execute (internal event).
370
+ * Tool calls ready to execute.
426
371
  */
427
372
  interface Data {
428
- code: string;
373
+ tool_calls_repr: string;
429
374
  }
430
375
  }
431
- interface TrajectoryCodeActOutputEvent {
376
+ interface TrajectoryFastAgentOutputEvent {
432
377
  /**
433
- * Code execution result (internal event).
378
+ * Tool execution result.
434
379
  */
435
- data: TrajectoryCodeActOutputEvent.Data;
436
- event: 'CodeActOutputEvent';
380
+ data: TrajectoryFastAgentOutputEvent.Data;
381
+ event: 'FastAgentOutputEvent';
437
382
  }
438
- namespace TrajectoryCodeActOutputEvent {
383
+ namespace TrajectoryFastAgentOutputEvent {
439
384
  /**
440
- * Code execution result (internal event).
385
+ * Tool execution result.
441
386
  */
442
387
  interface Data {
443
388
  output: string;
444
389
  }
445
390
  }
446
- interface TrajectoryCodeActEndEvent {
391
+ interface TrajectoryFastAgentEndEvent {
447
392
  /**
448
- * CodeAct finished.
393
+ * FastAgent finished.
449
394
  */
450
- data: TrajectoryCodeActEndEvent.Data;
451
- event: 'CodeActEndEvent';
395
+ data: TrajectoryFastAgentEndEvent.Data;
396
+ event: 'FastAgentEndEvent';
452
397
  }
453
- namespace TrajectoryCodeActEndEvent {
398
+ namespace TrajectoryFastAgentEndEvent {
454
399
  /**
455
- * CodeAct finished.
400
+ * FastAgent finished.
456
401
  */
457
402
  interface Data {
458
403
  reason: string;
459
404
  success: boolean;
460
- code_executions?: number;
405
+ tool_call_count?: number;
461
406
  }
462
407
  }
463
- interface TrajectoryCodeActExecuteEvent {
464
- data: TrajectoryCodeActExecuteEvent.Data;
465
- event: 'CodeActExecuteEvent';
408
+ interface TrajectoryFastAgentExecuteEvent {
409
+ data: TrajectoryFastAgentExecuteEvent.Data;
410
+ event: 'FastAgentExecuteEvent';
466
411
  }
467
- namespace TrajectoryCodeActExecuteEvent {
412
+ namespace TrajectoryFastAgentExecuteEvent {
468
413
  interface Data {
469
414
  instruction: string;
470
415
  }
471
416
  }
472
- interface TrajectoryCodeActResultEvent {
473
- data: TrajectoryCodeActResultEvent.Data;
474
- event: 'CodeActResultEvent';
417
+ interface TrajectoryFastAgentResultEvent {
418
+ data: TrajectoryFastAgentResultEvent.Data;
419
+ event: 'FastAgentResultEvent';
475
420
  }
476
- namespace TrajectoryCodeActResultEvent {
421
+ namespace TrajectoryFastAgentResultEvent {
477
422
  interface Data {
478
423
  instruction: string;
479
424
  reason: string;
480
425
  success: boolean;
481
426
  }
482
427
  }
483
- interface TrajectoryTapActionEvent {
484
- /**
485
- * Event for tap actions with coordinates
486
- */
487
- data: TrajectoryTapActionEvent.Data;
488
- event: 'TapActionEvent';
489
- }
490
- namespace TrajectoryTapActionEvent {
491
- /**
492
- * Event for tap actions with coordinates
493
- */
494
- interface Data {
495
- action_type: string;
496
- description: string;
497
- x: number;
498
- y: number;
499
- element_bounds?: string;
500
- element_index?: number | null;
501
- element_text?: string;
502
- }
503
- }
504
- interface TrajectorySwipeActionEvent {
505
- /**
506
- * Event for swipe actions with coordinates
507
- */
508
- data: TrajectorySwipeActionEvent.Data;
509
- event: 'SwipeActionEvent';
510
- }
511
- namespace TrajectorySwipeActionEvent {
512
- /**
513
- * Event for swipe actions with coordinates
514
- */
515
- interface Data {
516
- action_type: string;
517
- description: string;
518
- duration_ms: number;
519
- end_x: number;
520
- end_y: number;
521
- start_x: number;
522
- start_y: number;
523
- }
524
- }
525
- interface TrajectoryDragActionEvent {
526
- /**
527
- * Event for drag actions with coordinates
528
- */
529
- data: TrajectoryDragActionEvent.Data;
530
- event: 'DragActionEvent';
531
- }
532
- namespace TrajectoryDragActionEvent {
533
- /**
534
- * Event for drag actions with coordinates
535
- */
536
- interface Data {
537
- action_type: string;
538
- description: string;
539
- duration_ms: number;
540
- end_x: number;
541
- end_y: number;
542
- start_x: number;
543
- start_y: number;
544
- }
545
- }
546
- interface TrajectoryInputTextActionEvent {
547
- /**
548
- * Event for text input actions
549
- */
550
- data: TrajectoryInputTextActionEvent.Data;
551
- event: 'InputTextActionEvent';
552
- }
553
- namespace TrajectoryInputTextActionEvent {
554
- /**
555
- * Event for text input actions
556
- */
557
- interface Data {
558
- action_type: string;
559
- description: string;
560
- text: string;
561
- }
562
- }
563
- interface TrajectoryKeyPressActionEvent {
428
+ interface TrajectoryToolExecutionEvent {
564
429
  /**
565
- * Event for key press actions
430
+ * Emitted after every tool call dispatched through ToolRegistry.
566
431
  */
567
- data: TrajectoryKeyPressActionEvent.Data;
568
- event: 'KeyPressActionEvent';
432
+ data: TrajectoryToolExecutionEvent.Data;
433
+ event: 'ToolExecutionEvent';
569
434
  }
570
- namespace TrajectoryKeyPressActionEvent {
435
+ namespace TrajectoryToolExecutionEvent {
571
436
  /**
572
- * Event for key press actions
437
+ * Emitted after every tool call dispatched through ToolRegistry.
573
438
  */
574
439
  interface Data {
575
- action_type: string;
576
- description: string;
577
- keycode: number;
578
- key_name?: string;
579
- }
580
- }
581
- interface TrajectoryStartAppEvent {
582
- /**
583
- * "Event for starting an app
584
- */
585
- data: TrajectoryStartAppEvent.Data;
586
- event: 'StartAppEvent';
587
- }
588
- namespace TrajectoryStartAppEvent {
589
- /**
590
- * "Event for starting an app
591
- */
592
- interface Data {
593
- action_type: string;
594
- description: string;
595
- package: string;
596
- activity?: string | null;
440
+ success: boolean;
441
+ summary: string;
442
+ tool_args: {
443
+ [key: string]: unknown;
444
+ };
445
+ tool_name: string;
597
446
  }
598
447
  }
599
448
  interface TrajectoryRecordUiStateEvent {
@@ -606,23 +455,6 @@ export declare namespace TaskGetTrajectoryResponse {
606
455
  url: string;
607
456
  }
608
457
  }
609
- interface TrajectoryWaitEvent {
610
- /**
611
- * Event for wait/sleep actions
612
- */
613
- data: TrajectoryWaitEvent.Data;
614
- event: 'WaitEvent';
615
- }
616
- namespace TrajectoryWaitEvent {
617
- /**
618
- * Event for wait/sleep actions
619
- */
620
- interface Data {
621
- action_type: string;
622
- description: string;
623
- duration: number;
624
- }
625
- }
626
458
  interface TrajectoryManagerContextEvent {
627
459
  /**
628
460
  * Context prepared, ready for LLM call.
@@ -755,111 +587,11 @@ export declare namespace TaskGetTrajectoryResponse {
755
587
  thought?: string;
756
588
  }
757
589
  }
758
- interface TrajectoryScripterInputEvent {
759
- /**
760
- * Input ready for LLM.
761
- */
762
- data: unknown;
763
- event: 'ScripterInputEvent';
764
- }
765
- interface TrajectoryScripterThinkingEvent {
766
- /**
767
- * LLM response received.
768
- */
769
- data: TrajectoryScripterThinkingEvent.Data;
770
- event: 'ScripterThinkingEvent';
771
- }
772
- namespace TrajectoryScripterThinkingEvent {
773
- /**
774
- * LLM response received.
775
- */
776
- interface Data {
777
- thought: string;
778
- code?: string | null;
779
- full_response?: string;
780
- usage?: Data.Usage | null;
781
- }
782
- namespace Data {
783
- interface Usage {
784
- request_tokens: number;
785
- requests: number;
786
- response_tokens: number;
787
- total_tokens: number;
788
- }
789
- }
790
- }
791
- interface TrajectoryScripterExecutionEvent {
792
- /**
793
- * Code ready to execute.
794
- */
795
- data: TrajectoryScripterExecutionEvent.Data;
796
- event: 'ScripterExecutionEvent';
797
- }
798
- namespace TrajectoryScripterExecutionEvent {
799
- /**
800
- * Code ready to execute.
801
- */
802
- interface Data {
803
- code: string;
804
- }
805
- }
806
- interface TrajectoryScripterExecutionResultEvent {
807
- /**
808
- * Code execution result.
809
- */
810
- data: TrajectoryScripterExecutionResultEvent.Data;
811
- event: 'ScripterExecutionResultEvent';
812
- }
813
- namespace TrajectoryScripterExecutionResultEvent {
814
- /**
815
- * Code execution result.
816
- */
817
- interface Data {
818
- output: string;
819
- }
820
- }
821
- interface TrajectoryScripterEndEvent {
822
- /**
823
- * Scripter finished.
824
- */
825
- data: TrajectoryScripterEndEvent.Data;
826
- event: 'ScripterEndEvent';
827
- }
828
- namespace TrajectoryScripterEndEvent {
829
- /**
830
- * Scripter finished.
831
- */
832
- interface Data {
833
- message: string;
834
- success: boolean;
835
- code_executions?: number;
836
- }
837
- }
838
- interface TrajectoryTextManipulatorInputEvent {
839
- /**
840
- * Trigger TextManipulatorAgent workflow for text manipulation
841
- */
842
- data: TrajectoryTextManipulatorInputEvent.Data;
843
- event: 'TextManipulatorInputEvent';
844
- }
845
- namespace TrajectoryTextManipulatorInputEvent {
846
- /**
847
- * Trigger TextManipulatorAgent workflow for text manipulation
848
- */
849
- interface Data {
850
- task: string;
851
- }
852
- }
853
- interface TrajectoryTextManipulatorResultEvent {
854
- data: TrajectoryTextManipulatorResultEvent.Data;
855
- event: 'TextManipulatorResultEvent';
856
- }
857
- namespace TrajectoryTextManipulatorResultEvent {
858
- interface Data {
859
- code_ran: string;
860
- task: string;
861
- text_to_type: string;
862
- }
590
+ interface TrajectoryUnknownEvent {
591
+ event: string;
592
+ data?: {
593
+ [key: string]: unknown;
594
+ };
863
595
  }
864
596
  }
865
597
  export interface TaskRunResponse {
@@ -900,7 +632,10 @@ export interface TaskListParams {
900
632
  status?: TaskStatus | null;
901
633
  }
902
634
  export interface TaskRunParams {
903
- llmModel: LlmModel;
635
+ /**
636
+ * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
637
+ */
638
+ llmModel: string;
904
639
  task: string;
905
640
  apps?: Array<string>;
906
641
  credentials?: Array<TaskRunParams.Credential>;
@@ -919,6 +654,7 @@ export interface TaskRunParams {
919
654
  [key: string]: unknown;
920
655
  } | null;
921
656
  reasoning?: boolean;
657
+ stealth?: boolean;
922
658
  temperature?: number;
923
659
  vision?: boolean;
924
660
  vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
@@ -930,7 +666,10 @@ export declare namespace TaskRunParams {
930
666
  }
931
667
  }
932
668
  export interface TaskRunStreamedParams {
933
- llmModel: LlmModel;
669
+ /**
670
+ * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
671
+ */
672
+ llmModel: string;
934
673
  task: string;
935
674
  apps?: Array<string>;
936
675
  credentials?: Array<TaskRunStreamedParams.Credential>;
@@ -949,6 +688,7 @@ export interface TaskRunStreamedParams {
949
688
  [key: string]: unknown;
950
689
  } | null;
951
690
  reasoning?: boolean;
691
+ stealth?: boolean;
952
692
  temperature?: number;
953
693
  vision?: boolean;
954
694
  vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
@@ -960,7 +700,7 @@ export declare namespace TaskRunStreamedParams {
960
700
  }
961
701
  }
962
702
  export declare namespace Tasks {
963
- export { type LlmModel as LlmModel, type Task as Task, type TaskCreate as TaskCreate, type TaskStatus as TaskStatus, type TaskRetrieveResponse as TaskRetrieveResponse, type TaskListResponse as TaskListResponse, type TaskGetStatusResponse as TaskGetStatusResponse, type TaskGetTrajectoryResponse as TaskGetTrajectoryResponse, type TaskRunResponse as TaskRunResponse, type TaskStopResponse as TaskStopResponse, type TaskListParams as TaskListParams, type TaskRunParams as TaskRunParams, type TaskRunStreamedParams as TaskRunStreamedParams, };
703
+ export { type Task as Task, type TaskStatus as TaskStatus, type TaskRetrieveResponse as TaskRetrieveResponse, type TaskListResponse as TaskListResponse, type TaskGetStatusResponse as TaskGetStatusResponse, type TaskGetTrajectoryResponse as TaskGetTrajectoryResponse, type TaskRunResponse as TaskRunResponse, type TaskStopResponse as TaskStopResponse, type TaskListParams as TaskListParams, type TaskRunParams as TaskRunParams, type TaskRunStreamedParams as TaskRunStreamedParams, };
964
704
  export { Screenshots as Screenshots, type MediaResponse as MediaResponse, type ScreenshotListResponse as ScreenshotListResponse, type ScreenshotRetrieveParams as ScreenshotRetrieveParams, };
965
705
  export { UiStates as UiStates, type UiStateListResponse as UiStateListResponse, type UiStateRetrieveParams as UiStateRetrieveParams, };
966
706
  }