@mobilerun/sdk 5.4.0 → 5.6.0

package/src/resources/store/apps.ts

@@ -63,6 +63,8 @@ export namespace AppRetrieveResponse {
     updatedAt: string | null;
 
     version: Data.Version;
+
+    versions: Array<Data.Version>;
   }
 
   export namespace Data {
@@ -335,7 +337,294 @@ export namespace AppRetrieveResponse {
 
       sizeBytes: number | null;
 
-      source: 'user' | 'system' | 'portal' | 'store' | 'catalog';
+      source: 'user' | 'system' | 'portal' | 'store';
+
+      status: 'queued' | 'available' | 'failed';
+
+      targetSdk: number | null;
+
+      updatedAt: string | null;
+
+      /**
+       * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+       */
+      userId: string | null;
+
+      versionCode: number;
+
+      versionName: string;
+    }
+
+    export interface Version {
+      id: string;
+
+      appId: string;
+
+      country:
+        | 'AF'
+        | 'AL'
+        | 'DZ'
+        | 'AS'
+        | 'AD'
+        | 'AO'
+        | 'AI'
+        | 'AQ'
+        | 'AG'
+        | 'AR'
+        | 'AM'
+        | 'AW'
+        | 'AP'
+        | 'AU'
+        | 'AT'
+        | 'AZ'
+        | 'BS'
+        | 'BH'
+        | 'BD'
+        | 'BB'
+        | 'BY'
+        | 'BE'
+        | 'BZ'
+        | 'BJ'
+        | 'BM'
+        | 'BT'
+        | 'BO'
+        | 'BQ'
+        | 'BA'
+        | 'BW'
+        | 'BV'
+        | 'BR'
+        | 'IO'
+        | 'BN'
+        | 'BG'
+        | 'BF'
+        | 'BI'
+        | 'KH'
+        | 'CM'
+        | 'CA'
+        | 'CV'
+        | 'KY'
+        | 'CF'
+        | 'TD'
+        | 'CL'
+        | 'CN'
+        | 'CX'
+        | 'CC'
+        | 'CO'
+        | 'KM'
+        | 'CG'
+        | 'CD'
+        | 'CK'
+        | 'CR'
+        | 'HR'
+        | 'CU'
+        | 'CW'
+        | 'CY'
+        | 'CZ'
+        | 'CI'
+        | 'DK'
+        | 'DJ'
+        | 'DM'
+        | 'DO'
+        | 'EC'
+        | 'EG'
+        | 'SV'
+        | 'GQ'
+        | 'ER'
+        | 'EE'
+        | 'ET'
+        | 'FK'
+        | 'FO'
+        | 'FJ'
+        | 'FI'
+        | 'FR'
+        | 'GF'
+        | 'PF'
+        | 'TF'
+        | 'GA'
+        | 'GM'
+        | 'GE'
+        | 'DE'
+        | 'GH'
+        | 'GI'
+        | 'GR'
+        | 'GL'
+        | 'GD'
+        | 'GP'
+        | 'GU'
+        | 'GT'
+        | 'GG'
+        | 'GN'
+        | 'GW'
+        | 'GY'
+        | 'HT'
+        | 'HM'
+        | 'VA'
+        | 'HN'
+        | 'HK'
+        | 'HU'
+        | 'IS'
+        | 'IN'
+        | 'ID'
+        | 'IR'
+        | 'IQ'
+        | 'IE'
+        | 'IM'
+        | 'IL'
+        | 'IT'
+        | 'JM'
+        | 'JP'
+        | 'JE'
+        | 'JO'
+        | 'KZ'
+        | 'KE'
+        | 'KI'
+        | 'KR'
+        | 'KW'
+        | 'KG'
+        | 'LA'
+        | 'LV'
+        | 'LB'
+        | 'LS'
+        | 'LR'
+        | 'LY'
+        | 'LI'
+        | 'LT'
+        | 'LU'
+        | 'MO'
+        | 'MG'
+        | 'MW'
+        | 'MY'
+        | 'MV'
+        | 'ML'
+        | 'MT'
+        | 'MH'
+        | 'MQ'
+        | 'MR'
+        | 'MU'
+        | 'YT'
+        | 'MX'
+        | 'FM'
+        | 'MD'
+        | 'MC'
+        | 'MN'
+        | 'ME'
+        | 'MS'
+        | 'MA'
+        | 'MZ'
+        | 'MM'
+        | 'NA'
+        | 'NR'
+        | 'NP'
+        | 'NL'
+        | 'AN'
+        | 'NC'
+        | 'NZ'
+        | 'NI'
+        | 'NE'
+        | 'NG'
+        | 'NU'
+        | 'NF'
+        | 'KP'
+        | 'MK'
+        | 'MP'
+        | 'NO'
+        | 'OM'
+        | 'PK'
+        | 'PW'
+        | 'PS'
+        | 'PA'
+        | 'PG'
+        | 'PY'
+        | 'PE'
+        | 'PH'
+        | 'PN'
+        | 'PL'
+        | 'PT'
+        | 'PR'
+        | 'QA'
+        | 'RE'
+        | 'RO'
+        | 'RU'
+        | 'RW'
+        | 'BL'
+        | 'SH'
+        | 'KN'
+        | 'LC'
+        | 'MF'
+        | 'PM'
+        | 'VC'
+        | 'WS'
+        | 'SM'
+        | 'ST'
+        | 'SA'
+        | 'SN'
+        | 'RS'
+        | 'CS'
+        | 'SC'
+        | 'SL'
+        | 'SG'
+        | 'SX'
+        | 'SK'
+        | 'SI'
+        | 'SB'
+        | 'SO'
+        | 'ZA'
+        | 'GS'
+        | 'SS'
+        | 'ES'
+        | 'LK'
+        | 'SD'
+        | 'SR'
+        | 'SJ'
+        | 'SZ'
+        | 'SE'
+        | 'CH'
+        | 'SY'
+        | 'TW'
+        | 'TJ'
+        | 'TZ'
+        | 'TH'
+        | 'TL'
+        | 'TG'
+        | 'TK'
+        | 'TO'
+        | 'TT'
+        | 'TN'
+        | 'TR'
+        | 'TM'
+        | 'TC'
+        | 'TV'
+        | 'UG'
+        | 'UA'
+        | 'AE'
+        | 'GB'
+        | 'US'
+        | 'UM'
+        | 'UY'
+        | 'UZ'
+        | 'VU'
+        | 'VE'
+        | 'VN'
+        | 'VG'
+        | 'VI'
+        | 'WF'
+        | 'EH'
+        | 'YE'
+        | 'ZM'
+        | 'ZW'
+        | 'AX';
+
+      createdAt: string | null;
+
+      createdBy: string | null;
+
+      ownerId: string | null;
+
+      queuedAt: string | null;
+
+      sizeBytes: number | null;
+
+      source: 'user' | 'system' | 'portal' | 'store';
 
       status: 'queued' | 'available' | 'failed';
 
@@ -658,7 +947,7 @@ export namespace AppListResponse {
 
       sizeBytes: number | null;
 
-      source: 'user' | 'system' | 'portal' | 'store' | 'catalog';
+      source: 'user' | 'system' | 'portal' | 'store';
 
       status: 'queued' | 'available' | 'failed';
 

package/src/resources/tasks/tasks.ts

@@ -68,16 +68,8 @@ export class Tasks extends APIResource {
    * Create and dispatch a new agent task. Returns the task ID and device stream
    * details.
    */
-  run(params: TaskRunParams, options?: RequestOptions): APIPromise<TaskRunResponse> {
-    const { 'Idempotency-Key': idempotencyKey, ...body } = params;
-    return this._client.post('/tasks', {
-      body,
-      ...options,
-      headers: buildHeaders([
-        { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
-        options?.headers,
-      ]),
-    });
+  run(body: TaskRunParams, options?: RequestOptions): APIPromise<TaskRunResponse> {
+    return this._client.post('/tasks', { body, ...options });
   }
 
   /**
@@ -134,7 +126,15 @@ export namespace TaskRetrieveResponse {
 
     ownerId: string;
 
-    status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
+    status:
+      | 'prepared'
+      | 'queued'
+      | 'created'
+      | 'running'
+      | 'cancelling'
+      | 'completed'
+      | 'failed'
+      | 'cancelled';
 
     task: string;
 
@@ -147,8 +147,6 @@ export namespace TaskRetrieveResponse {
 
     accessibility?: boolean;
 
-    agentId?: number;
-
     apps?: Array<string>;
 
     cancelRequestedAt?: string | null;
@@ -175,11 +173,6 @@ export namespace TaskRetrieveResponse {
 
     maxSteps?: number;
 
-    /**
-     * Memory namespace for cross-task personalization
-     */
-    memoryNamespace?: string;
-
     message?: string | null;
 
     output?: { [key: string]: unknown } | null;
@@ -188,6 +181,22 @@ export namespace TaskRetrieveResponse {
 
     reasoning?: boolean;
 
+    recordingDeviceId?: string | null;
+
+    /**
+     * Record device video for the whole task and persist a retrievable reference
+     */
+    recordingEnabled?: boolean;
+
+    recordingId?: string | null;
+
+    /**
+     * Where the task came from: 'api' for tasks created via POST /tasks, 'agent' for
+     * tasks spawned by an agent step. Agent tasks are readable (status, trajectory,
+     * media) but not controllable via this API.
+     */
+    source?: 'api' | 'agent';
+
     stealth?: boolean;
 
     steps?: number | null;
@@ -201,6 +210,10 @@ export namespace TaskRetrieveResponse {
 
     succeeded?: boolean | null;
 
+    /**
+     * @deprecated Deprecated and ignored. Sampling behavior is controlled by the model
+     * provider.
+     */
     temperature?: number;
 
     updatedAt?: string;
@@ -249,7 +262,15 @@ export namespace TaskListResponse {
 
     ownerId: string;
 
-    status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
+    status:
+      | 'prepared'
+      | 'queued'
+      | 'created'
+      | 'running'
+      | 'cancelling'
+      | 'completed'
+      | 'failed'
+      | 'cancelled';
 
     task: string;
 
@@ -262,8 +283,6 @@ export namespace TaskListResponse {
 
     accessibility?: boolean;
 
-    agentId?: number;
-
     apps?: Array<string>;
 
     cancelRequestedAt?: string | null;
@@ -290,11 +309,6 @@ export namespace TaskListResponse {
 
     maxSteps?: number;
 
-    /**
-     * Memory namespace for cross-task personalization
-     */
-    memoryNamespace?: string;
-
     message?: string | null;
 
     output?: { [key: string]: unknown } | null;
@@ -303,6 +317,22 @@ export namespace TaskListResponse {
 
     reasoning?: boolean;
 
+    recordingDeviceId?: string | null;
+
+    /**
+     * Record device video for the whole task and persist a retrievable reference
+     */
+    recordingEnabled?: boolean;
+
+    recordingId?: string | null;
+
+    /**
+     * Where the task came from: 'api' for tasks created via POST /tasks, 'agent' for
+     * tasks spawned by an agent step. Agent tasks are readable (status, trajectory,
+     * media) but not controllable via this API.
+     */
+    source?: 'api' | 'agent';
+
     stealth?: boolean;
 
     steps?: number | null;
@@ -316,6 +346,10 @@ export namespace TaskListResponse {
 
     succeeded?: boolean | null;
 
+    /**
+     * @deprecated Deprecated and ignored. Sampling behavior is controlled by the model
+     * provider.
+     */
     temperature?: number;
 
     updatedAt?: string;
@@ -338,7 +372,7 @@ export interface TaskGetStatusResponse {
   /**
    * The status of the task
    */
-  status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
+  status: 'prepared' | 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
 
   /**
    * Execution metadata for abnormal terminal outcomes
@@ -360,6 +394,16 @@ export interface TaskGetStatusResponse {
    */
   output?: { [key: string]: unknown } | null;
 
+  /**
+   * Device ID associated with recordingId
+   */
+  recordingDeviceId?: string | null;
+
+  /**
+   * ID of the task's whole-task video recording, if recordingEnabled was set
+   */
+  recordingId?: string | null;
+
   /**
    * Number of steps taken
    */
@@ -703,6 +747,11 @@ export namespace TaskGetTrajectoryResponse {
 
       code?: string | null;
 
+      /**
+       * Classification of tool-call markup in an LLM response.
+       */
+      tool_call_status?: 'valid' | 'no_markup' | 'malformed';
+
       usage?: Data.Usage | null;
     }
 
@@ -1060,7 +1109,7 @@ export interface TaskRunResponse {
   /**
    * The status of the task (queued or created)
    */
-  status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
+  status: 'prepared' | 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
 
   /**
    * The URL of the stream (null when queued)
@@ -1108,116 +1157,89 @@ export interface TaskListParams {
    */
   query?: string | null;
 
-  status?: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled' | null;
+  /**
+   * Only tasks created via the API ('api') or spawned by an agent step ('agent').
+   */
+  source?: 'api' | 'agent' | null;
+
+  status?:
+    | 'prepared'
+    | 'queued'
+    | 'created'
+    | 'running'
+    | 'cancelling'
+    | 'completed'
+    | 'failed'
+    | 'cancelled'
+    | null;
 }
 
 export interface TaskRunParams {
   /**
-   * Body param: The ID of the device to run the task on.
+   * The ID of the device to run the task on.
    */
   deviceId: string;
 
-  /**
-   * Body param
-   */
   task: string;
 
-  /**
-   * Body param
-   */
   accessibility?: boolean;
 
-  /**
-   * Body param
-   */
-  agentId?: number;
-
-  /**
-   * Body param
-   */
   apps?: Array<string>;
 
-  /**
-   * Body param
-   */
   continueOnFailure?: boolean;
 
-  /**
-   * Body param
-   */
   credentials?: Array<TaskRunParams.Credential>;
 
   /**
-   * Body param: The display ID of the device to run the task on.
+   * The display ID of the device to run the task on.
    */
   displayId?: number;
 
   /**
-   * Body param
+   * Maximum agent execution time in seconds (1–2700).
    */
   executionTimeout?: number;
 
-  /**
-   * Body param
-   */
   files?: Array<string>;
 
   /**
-   * Body param: The LLM model identifier to use for the task (e.g.
-   * 'google/gemini-3.5-flash')
+   * The LLM model identifier to use for the task (e.g. 'openai/gpt-6-luna')
    */
   llmModel?: string;
 
-  /**
-   * Body param
-   */
   maxSteps?: number;
 
-  /**
-   * Body param: Memory namespace for cross-task personalization
-   */
-  memoryNamespace?: string;
-
-  /**
-   * Body param
-   */
   outputSchema?: { [key: string]: unknown } | null;
 
-  /**
-   * Body param
-   */
   reasoning?: boolean;
 
   /**
-   * Body param
+   * Record device video for the whole task and persist a retrievable reference
    */
+  recordingEnabled?: boolean;
+
   stealth?: boolean;
 
   /**
-   * Body param: LLM model used by sub-agent roles: executor, app_opener,
-   * structured_output
+   * LLM model used by sub-agent roles: executor, app_opener, structured_output
    */
   subagentModel?: string;
 
   /**
-   * Body param
+   * Optional custom behavioral overlay applied on top of the agent's default system
+   * prompts. Never echoed back in responses or errors.
    */
-  temperature?: number;
+  systemPrompt?: string | null;
 
   /**
-   * Body param
+   * @deprecated Deprecated and ignored. Sampling behavior is controlled by the model
+   * provider.
    */
+  temperature?: number;
+
   vision?: boolean;
 
-  /**
-   * Body param
-   */
   vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
-
-  /**
-   * Header param
-   */
-  'Idempotency-Key'?: string;
 }
 
 export namespace TaskRunParams {
@@ -1238,8 +1260,6 @@ export interface TaskRunStreamedParams {
 
   accessibility?: boolean;
 
-  agentId?: number;
-
   apps?: Array<string>;
 
   continueOnFailure?: boolean;
@@ -1251,26 +1271,29 @@ export interface TaskRunStreamedParams {
    */
   displayId?: number;
 
+  /**
+   * Maximum agent execution time in seconds (1–2700).
+   */
   executionTimeout?: number;
 
   files?: Array<string>;
 
   /**
-   * The LLM model identifier to use for the task (e.g. 'google/gemini-3.5-flash')
+   * The LLM model identifier to use for the task (e.g. 'openai/gpt-6-luna')
    */
   llmModel?: string;
 
   maxSteps?: number;
 
-  /**
-   * Memory namespace for cross-task personalization
-   */
-  memoryNamespace?: string;
-
   outputSchema?: { [key: string]: unknown } | null;
 
   reasoning?: boolean;
 
+  /**
+   * Record device video for the whole task and persist a retrievable reference
+   */
+  recordingEnabled?: boolean;
+
   stealth?: boolean;
 
   /**
@@ -1278,6 +1301,16 @@ export interface TaskRunStreamedParams {
    */
   subagentModel?: string;
 
+  /**
+   * Optional custom behavioral overlay applied on top of the agent's default system
+   * prompts. Never echoed back in responses or errors.
+   */
+  systemPrompt?: string | null;
+
+  /**
+   * @deprecated Deprecated and ignored. Sampling behavior is controlled by the model
+   * provider.
+   */
   temperature?: number;
 
   vision?: boolean;