@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,4 +1,5 @@
1
1
  import { APIResource } from "../../core/resource.js";
2
+ import * as TasksAPI from "./tasks.js";
2
3
  import * as ScreenshotsAPI from "./screenshots.js";
3
4
  import { MediaResponse, ScreenshotListResponse, ScreenshotRetrieveParams, Screenshots } from "./screenshots.js";
4
5
  import * as UiStatesAPI from "./ui-states.js";
@@ -9,20 +10,19 @@ export declare class Tasks extends APIResource {
9
10
  screenshots: ScreenshotsAPI.Screenshots;
10
11
  uiStates: UiStatesAPI.UiStates;
11
12
  /**
12
- * Get Task
13
+ * Get full details of a task by ID.
13
14
  */
14
15
  retrieve(taskID: string, options?: RequestOptions): APIPromise<TaskRetrieveResponse>;
15
16
  /**
16
- * List all tasks you've created so far
17
+ * List tasks with optional filtering, sorting, and pagination.
17
18
  */
18
19
  list(query?: TaskListParams | null | undefined, options?: RequestOptions): APIPromise<TaskListResponse>;
19
20
  /**
20
- * Attach Task
21
+ * Attach to a running task and receive its events as an SSE stream.
21
22
  */
22
23
  attach(taskID: string, options?: RequestOptions): APIPromise<void>;
23
24
  /**
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.
25
+ * Get the status of a task.
26
26
  */
27
27
  getStatus(taskID: string, options?: RequestOptions): APIPromise<TaskGetStatusResponse>;
28
28
  /**
@@ -30,28 +30,38 @@ export declare class Tasks extends APIResource {
30
30
  */
31
31
  getTrajectory(taskID: string, options?: RequestOptions): APIPromise<TaskGetTrajectoryResponse>;
32
32
  /**
33
- * Run Task
33
+ * Create and dispatch a new agent task. Returns the task ID and device stream
34
+ * details.
34
35
  */
35
36
  run(body: TaskRunParams, options?: RequestOptions): APIPromise<TaskRunResponse>;
36
37
  /**
37
- * Run Streamed Task
38
+ * Create and dispatch a new agent task, returning an SSE stream of task events.
39
+ * Cancels the task if the client disconnects.
38
40
  */
39
41
  runStreamed(body: TaskRunStreamedParams, options?: RequestOptions): APIPromise<void>;
40
42
  /**
41
- * Stop Task
43
+ * Cancel a running task. Returns an error if the task is already in a terminal
44
+ * state.
42
45
  */
43
46
  stop(taskID: string, options?: RequestOptions): APIPromise<TaskStopResponse>;
44
47
  }
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';
48
+ export interface PackageCredentials {
49
+ credentialNames: Array<string>;
50
+ packageName: string;
51
+ }
46
52
  export interface Task {
47
53
  deviceId: string;
48
- llmModel: LlmModel;
54
+ /**
55
+ * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
56
+ */
57
+ llmModel: string;
49
58
  task: string;
50
59
  userId: string;
51
60
  id?: string;
52
61
  apps?: Array<string>;
53
62
  createdAt?: string;
54
- credentials?: Array<Task.Credential>;
63
+ credentials?: Array<PackageCredentials>;
64
+ displayId?: number;
55
65
  executionTimeout?: number;
56
66
  files?: Array<string>;
57
67
  finishedAt?: string | null;
@@ -64,9 +74,11 @@ export interface Task {
64
74
  } | null;
65
75
  reasoning?: boolean;
66
76
  status?: TaskStatus;
77
+ stealth?: boolean;
67
78
  steps?: number | null;
68
79
  succeeded?: boolean | null;
69
80
  temperature?: number;
81
+ tmpDevice?: boolean;
70
82
  trajectory?: Array<{
71
83
  [key: string]: unknown;
72
84
  }>;
@@ -74,43 +86,13 @@ export interface Task {
74
86
  vision?: boolean;
75
87
  vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
76
88
  }
77
- export declare namespace Task {
78
- interface Credential {
79
- credentialNames: Array<string>;
80
- packageName: string;
81
- }
82
- }
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
89
  export type TaskStatus = 'created' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
90
+ export interface UsageResult {
91
+ request_tokens: number;
92
+ requests: number;
93
+ response_tokens: number;
94
+ total_tokens: number;
95
+ }
114
96
  export interface TaskRetrieveResponse {
115
97
  /**
116
98
  * The task
@@ -168,7 +150,7 @@ export interface TaskGetTrajectoryResponse {
168
150
  /**
169
151
  * The trajectory of the task
170
152
  */
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>;
153
+ 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
154
  }
173
155
  export declare namespace TaskGetTrajectoryResponse {
174
156
  interface TrajectoryCreatedEvent {
@@ -258,11 +240,30 @@ export declare namespace TaskGetTrajectoryResponse {
258
240
  event: 'StopEvent';
259
241
  }
260
242
  interface TrajectoryResultEvent {
261
- data: {
262
- [key: string]: unknown;
263
- };
243
+ /**
244
+ * Lazy wrapper — avoids importing droidrun at module level.
245
+ *
246
+ * The worker uses droidrun's ResultEvent directly; this model only exists so the
247
+ * API OpenAPI schema can reference it without the heavy droidrun import.
248
+ */
249
+ data: TrajectoryResultEvent.Data;
264
250
  event: 'ResultEvent';
265
251
  }
252
+ namespace TrajectoryResultEvent {
253
+ /**
254
+ * Lazy wrapper — avoids importing droidrun at module level.
255
+ *
256
+ * The worker uses droidrun's ResultEvent directly; this model only exists so the
257
+ * API OpenAPI schema can reference it without the heavy droidrun import.
258
+ */
259
+ interface Data {
260
+ steps?: number | null;
261
+ structured_output?: {
262
+ [key: string]: unknown;
263
+ } | null;
264
+ success?: boolean | null;
265
+ }
266
+ }
266
267
  interface TrajectoryManagerInputEvent {
267
268
  /**
268
269
  * Trigger Manager workflow for planning
@@ -291,7 +292,7 @@ export declare namespace TaskGetTrajectoryResponse {
291
292
  current_subgoal: string;
292
293
  plan: string;
293
294
  thought: string;
294
- manager_answer?: string;
295
+ answer?: string;
295
296
  success?: boolean | null;
296
297
  }
297
298
  }
@@ -330,270 +331,115 @@ export declare namespace TaskGetTrajectoryResponse {
330
331
  summary: string;
331
332
  }
332
333
  }
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 {
334
+ interface TrajectoryFastAgentInputEvent {
385
335
  /**
386
336
  * Input ready for LLM.
387
337
  */
388
338
  data: unknown;
389
- event: 'CodeActInputEvent';
339
+ event: 'FastAgentInputEvent';
390
340
  }
391
- interface TrajectoryCodeActResponseEvent {
341
+ interface TrajectoryFastAgentResponseEvent {
392
342
  /**
393
343
  * LLM response received.
394
344
  */
395
- data: TrajectoryCodeActResponseEvent.Data;
396
- event: 'CodeActResponseEvent';
345
+ data: TrajectoryFastAgentResponseEvent.Data;
346
+ event: 'FastAgentResponseEvent';
397
347
  }
398
- namespace TrajectoryCodeActResponseEvent {
348
+ namespace TrajectoryFastAgentResponseEvent {
399
349
  /**
400
350
  * LLM response received.
401
351
  */
402
352
  interface Data {
403
353
  thought: string;
404
354
  code?: string | null;
405
- usage?: Data.Usage | null;
406
- }
407
- namespace Data {
408
- interface Usage {
409
- request_tokens: number;
410
- requests: number;
411
- response_tokens: number;
412
- total_tokens: number;
413
- }
355
+ usage?: TasksAPI.UsageResult | null;
414
356
  }
415
357
  }
416
- interface TrajectoryCodeActCodeEvent {
358
+ interface TrajectoryFastAgentToolCallEvent {
417
359
  /**
418
- * Code ready to execute (internal event).
360
+ * Tool calls ready to execute.
419
361
  */
420
- data: TrajectoryCodeActCodeEvent.Data;
421
- event: 'CodeActCodeEvent';
362
+ data: TrajectoryFastAgentToolCallEvent.Data;
363
+ event: 'FastAgentToolCallEvent';
422
364
  }
423
- namespace TrajectoryCodeActCodeEvent {
365
+ namespace TrajectoryFastAgentToolCallEvent {
424
366
  /**
425
- * Code ready to execute (internal event).
367
+ * Tool calls ready to execute.
426
368
  */
427
369
  interface Data {
428
- code: string;
370
+ tool_calls_repr: string;
429
371
  }
430
372
  }
431
- interface TrajectoryCodeActOutputEvent {
373
+ interface TrajectoryFastAgentOutputEvent {
432
374
  /**
433
- * Code execution result (internal event).
375
+ * Tool execution result.
434
376
  */
435
- data: TrajectoryCodeActOutputEvent.Data;
436
- event: 'CodeActOutputEvent';
377
+ data: TrajectoryFastAgentOutputEvent.Data;
378
+ event: 'FastAgentOutputEvent';
437
379
  }
438
- namespace TrajectoryCodeActOutputEvent {
380
+ namespace TrajectoryFastAgentOutputEvent {
439
381
  /**
440
- * Code execution result (internal event).
382
+ * Tool execution result.
441
383
  */
442
384
  interface Data {
443
385
  output: string;
444
386
  }
445
387
  }
446
- interface TrajectoryCodeActEndEvent {
388
+ interface TrajectoryFastAgentEndEvent {
447
389
  /**
448
- * CodeAct finished.
390
+ * FastAgent finished.
449
391
  */
450
- data: TrajectoryCodeActEndEvent.Data;
451
- event: 'CodeActEndEvent';
392
+ data: TrajectoryFastAgentEndEvent.Data;
393
+ event: 'FastAgentEndEvent';
452
394
  }
453
- namespace TrajectoryCodeActEndEvent {
395
+ namespace TrajectoryFastAgentEndEvent {
454
396
  /**
455
- * CodeAct finished.
397
+ * FastAgent finished.
456
398
  */
457
399
  interface Data {
458
400
  reason: string;
459
401
  success: boolean;
460
- code_executions?: number;
402
+ tool_call_count?: number;
461
403
  }
462
404
  }
463
- interface TrajectoryCodeActExecuteEvent {
464
- data: TrajectoryCodeActExecuteEvent.Data;
465
- event: 'CodeActExecuteEvent';
405
+ interface TrajectoryFastAgentExecuteEvent {
406
+ data: TrajectoryFastAgentExecuteEvent.Data;
407
+ event: 'FastAgentExecuteEvent';
466
408
  }
467
- namespace TrajectoryCodeActExecuteEvent {
409
+ namespace TrajectoryFastAgentExecuteEvent {
468
410
  interface Data {
469
411
  instruction: string;
470
412
  }
471
413
  }
472
- interface TrajectoryCodeActResultEvent {
473
- data: TrajectoryCodeActResultEvent.Data;
474
- event: 'CodeActResultEvent';
414
+ interface TrajectoryFastAgentResultEvent {
415
+ data: TrajectoryFastAgentResultEvent.Data;
416
+ event: 'FastAgentResultEvent';
475
417
  }
476
- namespace TrajectoryCodeActResultEvent {
418
+ namespace TrajectoryFastAgentResultEvent {
477
419
  interface Data {
478
420
  instruction: string;
479
421
  reason: string;
480
422
  success: boolean;
481
423
  }
482
424
  }
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 {
425
+ interface TrajectoryToolExecutionEvent {
564
426
  /**
565
- * Event for key press actions
427
+ * Emitted after every tool call dispatched through ToolRegistry.
566
428
  */
567
- data: TrajectoryKeyPressActionEvent.Data;
568
- event: 'KeyPressActionEvent';
429
+ data: TrajectoryToolExecutionEvent.Data;
430
+ event: 'ToolExecutionEvent';
569
431
  }
570
- namespace TrajectoryKeyPressActionEvent {
432
+ namespace TrajectoryToolExecutionEvent {
571
433
  /**
572
- * Event for key press actions
434
+ * Emitted after every tool call dispatched through ToolRegistry.
573
435
  */
574
436
  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;
437
+ success: boolean;
438
+ summary: string;
439
+ tool_args: {
440
+ [key: string]: unknown;
441
+ };
442
+ tool_name: string;
597
443
  }
598
444
  }
599
445
  interface TrajectoryRecordUiStateEvent {
@@ -606,23 +452,6 @@ export declare namespace TaskGetTrajectoryResponse {
606
452
  url: string;
607
453
  }
608
454
  }
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
455
  interface TrajectoryManagerContextEvent {
627
456
  /**
628
457
  * Context prepared, ready for LLM call.
@@ -643,15 +472,7 @@ export declare namespace TaskGetTrajectoryResponse {
643
472
  */
644
473
  interface Data {
645
474
  response: string;
646
- usage?: Data.Usage | null;
647
- }
648
- namespace Data {
649
- interface Usage {
650
- request_tokens: number;
651
- requests: number;
652
- response_tokens: number;
653
- total_tokens: number;
654
- }
475
+ usage?: TasksAPI.UsageResult | null;
655
476
  }
656
477
  }
657
478
  interface TrajectoryManagerPlanDetailsEvent {
@@ -704,15 +525,7 @@ export declare namespace TaskGetTrajectoryResponse {
704
525
  */
705
526
  interface Data {
706
527
  response: string;
707
- usage?: Data.Usage | null;
708
- }
709
- namespace Data {
710
- interface Usage {
711
- request_tokens: number;
712
- requests: number;
713
- response_tokens: number;
714
- total_tokens: number;
715
- }
528
+ usage?: TasksAPI.UsageResult | null;
716
529
  }
717
530
  }
718
531
  interface TrajectoryExecutorActionEvent {
@@ -755,111 +568,11 @@ export declare namespace TaskGetTrajectoryResponse {
755
568
  thought?: string;
756
569
  }
757
570
  }
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
- }
571
+ interface TrajectoryUnknownEvent {
572
+ event: string;
573
+ data?: {
574
+ [key: string]: unknown;
575
+ };
863
576
  }
864
577
  }
865
578
  export interface TaskRunResponse {
@@ -900,10 +613,13 @@ export interface TaskListParams {
900
613
  status?: TaskStatus | null;
901
614
  }
902
615
  export interface TaskRunParams {
903
- llmModel: LlmModel;
616
+ /**
617
+ * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
618
+ */
619
+ llmModel: string;
904
620
  task: string;
905
621
  apps?: Array<string>;
906
- credentials?: Array<TaskRunParams.Credential>;
622
+ credentials?: Array<PackageCredentials>;
907
623
  /**
908
624
  * The ID of the device to run the task on.
909
625
  */
@@ -919,21 +635,19 @@ export interface TaskRunParams {
919
635
  [key: string]: unknown;
920
636
  } | null;
921
637
  reasoning?: boolean;
638
+ stealth?: boolean;
922
639
  temperature?: number;
923
640
  vision?: boolean;
924
641
  vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
925
642
  }
926
- export declare namespace TaskRunParams {
927
- interface Credential {
928
- credentialNames: Array<string>;
929
- packageName: string;
930
- }
931
- }
932
643
  export interface TaskRunStreamedParams {
933
- llmModel: LlmModel;
644
+ /**
645
+ * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
646
+ */
647
+ llmModel: string;
934
648
  task: string;
935
649
  apps?: Array<string>;
936
- credentials?: Array<TaskRunStreamedParams.Credential>;
650
+ credentials?: Array<PackageCredentials>;
937
651
  /**
938
652
  * The ID of the device to run the task on.
939
653
  */
@@ -949,18 +663,13 @@ export interface TaskRunStreamedParams {
949
663
  [key: string]: unknown;
950
664
  } | null;
951
665
  reasoning?: boolean;
666
+ stealth?: boolean;
952
667
  temperature?: number;
953
668
  vision?: boolean;
954
669
  vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
955
670
  }
956
- export declare namespace TaskRunStreamedParams {
957
- interface Credential {
958
- credentialNames: Array<string>;
959
- packageName: string;
960
- }
961
- }
962
671
  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, };
672
+ export { type PackageCredentials as PackageCredentials, type Task as Task, type TaskStatus as TaskStatus, type UsageResult as UsageResult, 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
673
  export { Screenshots as Screenshots, type MediaResponse as MediaResponse, type ScreenshotListResponse as ScreenshotListResponse, type ScreenshotRetrieveParams as ScreenshotRetrieveParams, };
965
674
  export { UiStates as UiStates, type UiStateListResponse as UiStateListResponse, type UiStateRetrieveParams as UiStateRetrieveParams, };
966
675
  }