@mobilerun/sdk 5.4.0 → 5.5.0

package/src/resources/tasks/tasks.ts

@@ -134,7 +134,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 +155,6 @@ export namespace TaskRetrieveResponse {
 
     accessibility?: boolean;
 
-    agentId?: number;
-
     apps?: Array<string>;
 
     cancelRequestedAt?: string | null;
@@ -175,11 +181,6 @@ export namespace TaskRetrieveResponse {
 
     maxSteps?: number;
 
-    /**
-     * Memory namespace for cross-task personalization
-     */
-    memoryNamespace?: string;
-
     message?: string | null;
 
     output?: { [key: string]: unknown } | null;
@@ -188,6 +189,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 +218,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 +270,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 +291,6 @@ export namespace TaskListResponse {
 
     accessibility?: boolean;
 
-    agentId?: number;
-
     apps?: Array<string>;
 
     cancelRequestedAt?: string | null;
@@ -290,11 +317,6 @@ export namespace TaskListResponse {
 
     maxSteps?: number;
 
-    /**
-     * Memory namespace for cross-task personalization
-     */
-    memoryNamespace?: string;
-
     message?: string | null;
 
     output?: { [key: string]: unknown } | null;
@@ -303,6 +325,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 +354,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 +380,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 +402,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
    */
@@ -1060,7 +1112,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,7 +1160,21 @@ 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 {
@@ -1127,11 +1193,6 @@ export interface TaskRunParams {
    */
   accessibility?: boolean;
 
-  /**
-   * Body param
-   */
-  agentId?: number;
-
   /**
    * Body param
    */
@@ -1153,7 +1214,7 @@ export interface TaskRunParams {
   displayId?: number;
 
   /**
-   * Body param
+   * Body param: Maximum agent execution time in seconds (1–2700).
    */
   executionTimeout?: number;
 
@@ -1164,7 +1225,7 @@ export interface TaskRunParams {
 
   /**
    * Body param: The LLM model identifier to use for the task (e.g.
-   * 'google/gemini-3.5-flash')
+   * 'openai/gpt-5.6-luna')
    */
   llmModel?: string;
 
@@ -1173,11 +1234,6 @@ export interface TaskRunParams {
    */
   maxSteps?: number;
 
-  /**
-   * Body param: Memory namespace for cross-task personalization
-   */
-  memoryNamespace?: string;
-
   /**
    * Body param
    */
@@ -1188,6 +1244,12 @@ export interface TaskRunParams {
    */
   reasoning?: boolean;
 
+  /**
+   * Body param: Record device video for the whole task and persist a retrievable
+   * reference
+   */
+  recordingEnabled?: boolean;
+
   /**
    * Body param
    */
@@ -1200,7 +1262,14 @@ export interface TaskRunParams {
   subagentModel?: string;
 
   /**
-   * Body param
+   * Body param: 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 Body param: Deprecated and ignored. Sampling behavior is controlled
+   * by the model provider.
    */
   temperature?: number;
 
@@ -1238,8 +1307,6 @@ export interface TaskRunStreamedParams {
 
   accessibility?: boolean;
 
-  agentId?: number;
-
   apps?: Array<string>;
 
   continueOnFailure?: boolean;
@@ -1251,26 +1318,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-5.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 +1348,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;

package/src/resources/webhooks/webhooks.ts

@@ -370,6 +370,8 @@ export namespace WebhookEventTypesResponse {
           toast: boolean;
 
           webhook: boolean;
+
+          agent?: boolean;
         }
       }
     }

package/src/resources/workflows/events.ts

@@ -49,10 +49,14 @@ export namespace EventDryRunResponse {
       export interface Action {
         continueOnError: boolean;
 
+        flowActionId: string;
+
         method: string;
 
         name: string;
 
+        recordingEnabled: boolean;
+
         service: 'tasks_api' | 'devices_api' | 'agents_api' | 'webhooks';
 
         /**
@@ -67,6 +71,8 @@ export namespace EventDryRunResponse {
       export interface Flow {
         id: string;
 
+        archivedAt: string | null;
+
         blockedAt: string | null;
 
         consecutiveFailures: number;
@@ -83,6 +89,10 @@ export namespace EventDryRunResponse {
 
         deviceIds: Array<string>;
 
+        /**
+         * Compatibility projection of lifecycleStatus; true only when lifecycleStatus is
+         * enabled.
+         */
         enabled: boolean;
 
         healthMonitoringEnabled: boolean;
@@ -100,6 +110,8 @@ export namespace EventDryRunResponse {
 
         lastTriggeredAt: string | null;
 
+        lifecycleStatus: 'enabled' | 'disabled' | 'archived';
+
         name: string;
 
         notifyOnFailure: boolean;
@@ -110,8 +122,14 @@ export namespace EventDryRunResponse {
 
         ownerId: string;
 
+        /**
+         * @deprecated Deprecated: use recordingPolicy.mode ("flow" =
+         * recordingEnabled=true, "off" = recordingEnabled=false).
+         */
         recordingEnabled: boolean;
 
+        recordingPolicy: Flow.RecordingPolicy;
+
         selfHealingEnabled: boolean;
 
         selfHealingMaxAttempts: number;
@@ -136,6 +154,12 @@ export namespace EventDryRunResponse {
         userId: string;
       }
 
+      export namespace Flow {
+        export interface RecordingPolicy {
+          mode: 'off' | 'flow' | 'selected_steps';
+        }
+      }
+
       export interface Gates {
         blocked: boolean;
 

package/src/resources/workflows/executions.ts

@@ -17,8 +17,9 @@ export class Executions extends APIResource {
 
   /**
    * Return a paginated history of flow executions. Supports filtering by `flowId`,
-   * `triggerId`, `status`, and a `from`/`to` time range, plus free-text `search` and
-   * ordering by startedAt, finishedAt, or status.
+   * `triggerId`, `invocationId` (the client/verify key), `status`, and a `from`/`to`
+   * time range, plus free-text `search` and ordering by startedAt, finishedAt, or
+   * status.
    */
   list(
     query: ExecutionListParams | null | undefined = {},
@@ -58,6 +59,12 @@ export namespace ExecutionRetrieveResponse {
 
     createdBy: string | null;
 
+    /**
+     * Device this execution targets (the job's deviceId). Null for device-less
+     * (event-only) runs.
+     */
+    deviceId: string | null;
+
     error: string | null;
 
     eventId: string | null;
@@ -75,7 +82,14 @@ export namespace ExecutionRetrieveResponse {
 
     flowName: string | null;
 
-    kind: 'live' | 'dry_run';
+    /**
+     * Client/verify invocation key this row belongs to. Set on live custom fires (one
+     * row per device fan-out) and on verification runs; null for event/schedule live
+     * rows.
+     */
+    invocationId: string | null;
+
+    kind: 'live' | 'dry_run' | 'verification';
 
     recordingDeviceId: string | null;
 
@@ -86,6 +100,12 @@ export namespace ExecutionRetrieveResponse {
      */
     recordingId: string | null;
 
+    /**
+     * Durable recording segments ordered by step/loop coordinate and retry attempt.
+     * Whole-flow recordings use -1 for every coordinate.
+     */
+    recordings: Array<Data.Recording>;
+
     startedAt: string | null;
 
     status: 'pending' | 'running' | 'success' | 'failed' | 'cancelled' | 'skipped' | 'invalid' | null;
@@ -115,6 +135,36 @@ export namespace ExecutionRetrieveResponse {
 
       sizeBytes: number;
     }
+
+    export interface Recording {
+      id: string;
+
+      attempt: number;
+
+      childIndex: number;
+
+      flowActionId: string | null;
+
+      iterationIndex: number;
+
+      lastError: string | null;
+
+      parentIndex: number;
+
+      recordingDeviceId: string | null;
+
+      recordingId: string | null;
+
+      scope: 'flow' | 'step';
+
+      startedAt: string | null;
+
+      status: 'starting' | 'recording' | 'stopping' | 'stopped' | 'failed';
+
+      stepIndex: number;
+
+      stoppedAt: string | null;
+    }
   }
 }
 
@@ -130,6 +180,12 @@ export namespace ExecutionListResponse {
 
     createdBy: string | null;
 
+    /**
+     * Device this execution targets (the job's deviceId). Null for device-less
+     * (event-only) runs.
+     */
+    deviceId: string | null;
+
     error: string | null;
 
     eventId: string | null;
@@ -140,7 +196,14 @@ export namespace ExecutionListResponse {
 
     flowName: string | null;
 
-    kind: 'live' | 'dry_run';
+    /**
+     * Client/verify invocation key this row belongs to. Set on live custom fires (one
+     * row per device fan-out) and on verification runs; null for event/schedule live
+     * rows.
+     */
+    invocationId: string | null;
+
+    kind: 'live' | 'dry_run' | 'verification';
 
     recordingDeviceId: string | null;
 
@@ -151,6 +214,12 @@ export namespace ExecutionListResponse {
      */
     recordingId: string | null;
 
+    /**
+     * Durable recording segments ordered by step/loop coordinate and retry attempt.
+     * Whole-flow recordings use -1 for every coordinate.
+     */
+    recordings: Array<Item.Recording>;
+
     startedAt: string | null;
 
     status: 'pending' | 'running' | 'success' | 'failed' | 'cancelled' | 'skipped' | 'invalid' | null;
@@ -169,6 +238,38 @@ export namespace ExecutionListResponse {
      */
     result?: unknown;
   }
+
+  export namespace Item {
+    export interface Recording {
+      id: string;
+
+      attempt: number;
+
+      childIndex: number;
+
+      flowActionId: string | null;
+
+      iterationIndex: number;
+
+      lastError: string | null;
+
+      parentIndex: number;
+
+      recordingDeviceId: string | null;
+
+      recordingId: string | null;
+
+      scope: 'flow' | 'step';
+
+      startedAt: string | null;
+
+      status: 'starting' | 'recording' | 'stopping' | 'stopped' | 'failed';
+
+      stepIndex: number;
+
+      stoppedAt: string | null;
+    }
+  }
 }
 
 export interface ExecutionAbortResponse {
@@ -179,6 +280,12 @@ export namespace ExecutionAbortResponse {
   export interface Data {
     id: string;
 
+    /**
+     * Device this execution targets (the job's deviceId). Null for device-less
+     * (event-only) runs.
+     */
+    deviceId: string | null;
+
     error: string | null;
 
     eventId: string | null;
@@ -189,7 +296,14 @@ export namespace ExecutionAbortResponse {
 
     flowName: string | null;
 
-    kind: 'live' | 'dry_run';
+    /**
+     * Client/verify invocation key this row belongs to. Set on live custom fires (one
+     * row per device fan-out) and on verification runs; null for event/schedule live
+     * rows.
+     */
+    invocationId: string | null;
+
+    kind: 'live' | 'dry_run' | 'verification';
 
     recordingDeviceId: string | null;
 
@@ -259,6 +373,8 @@ export interface ExecutionListParams {
 
   from?: string | null;
 
+  invocationId?: string;
+
   orderBy?: 'startedAt' | 'finishedAt' | 'status';
 
   orderByDirection?: 'asc' | 'desc';

package/src/resources/workflows/flows/actions.ts

@@ -75,6 +75,12 @@ export namespace ActionListResponse {
     parentFlowActionId: string | null;
 
     position: number;
+
+    /**
+     * Selected for per-step recording under the flow's "selected_steps" recording
+     * policy.
+     */
+    recordingEnabled: boolean;
   }
 
   export namespace Data {
@@ -107,6 +113,12 @@ export namespace ActionAddResponse {
     parentFlowActionId: string | null;
 
     position: number;
+
+    /**
+     * Selected for per-step recording under the flow's "selected_steps" recording
+     * policy.
+     */
+    recordingEnabled: boolean;
   }
 
   export namespace Data {
@@ -143,6 +155,12 @@ export namespace ActionReplaceResponse {
     parentFlowActionId: string | null;
 
     position: number;
+
+    /**
+     * Selected for per-step recording under the flow's "selected_steps" recording
+     * policy.
+     */
+    recordingEnabled: boolean;
   }
 
   export namespace Data {
@@ -166,6 +184,8 @@ export interface ActionAddParams {
   overrides?: ActionAddParams.Overrides | null;
 
   parentFlowActionId?: string | null;
+
+  recordingEnabled?: boolean;
 }
 
 export namespace ActionAddParams {
@@ -179,6 +199,8 @@ export namespace ActionAddParams {
     nameOverride?: string;
 
     overrides?: Child.Overrides | null;
+
+    recordingEnabled?: boolean;
   }
 
   export namespace Child {
@@ -213,6 +235,8 @@ export namespace ActionReplaceParams {
     nameOverride?: string;
 
     overrides?: Action.Overrides | null;
+
+    recordingEnabled?: boolean;
   }
 
   export namespace Action {
@@ -226,6 +250,8 @@ export namespace ActionReplaceParams {
       nameOverride?: string;
 
       overrides?: Child.Overrides | null;
+
+      recordingEnabled?: boolean;
     }
 
     export namespace Child {