@mobilerun/sdk 2.2.0 → 4.0.0

package/src/resources/tasks/tasks.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as TasksAPI from './tasks';
+import * as Shared from '../shared';
 import * as ScreenshotsAPI from './screenshots';
 import { MediaResponse, ScreenshotListResponse, ScreenshotRetrieveParams, Screenshots } from './screenshots';
 import * as UiStatesAPI from './ui-states';
@@ -11,6 +12,9 @@ import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Tasks API
+ */
 export class Tasks extends APIResource {
   screenshots: ScreenshotsAPI.Screenshots = new ScreenshotsAPI.Screenshots(this._client);
   uiStates: UiStatesAPI.UiStates = new UiStatesAPI.UiStates(this._client);
@@ -68,12 +72,20 @@ export class Tasks extends APIResource {
    * Create and dispatch a new agent task, returning an SSE stream of task events.
    * Cancels the task if the client disconnects.
    */
-  runStreamed(body: TaskRunStreamedParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.post('/tasks/stream', {
-      body,
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+  runStreamed(body: TaskRunStreamedParams, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.post('/tasks/stream', { body, ...options });
+  }
+
+  /**
+   * Send a message to a running agent task. The message ID is delivered via SSE
+   * (UserMessageEvent with action=queued).
+   */
+  sendMessage(
+    taskID: string,
+    body: TaskSendMessageParams,
+    options?: RequestOptions,
+  ): APIPromise<TaskSendMessageResponse> {
+    return this._client.post(path`/tasks/${taskID}/message`, { body, ...options });
   }
 
   /**
@@ -105,12 +117,22 @@ export interface Task {
 
   id?: string;
 
+  agentId?: number;
+
   apps?: Array<string>;
 
+  cancelRequestedAt?: string | null;
+
+  claimedAt?: string | null;
+
+  continueOnFailure?: boolean;
+
   createdAt?: string;
 
   credentials?: Array<PackageCredentials>;
 
+  dispatchedAt?: string | null;
+
   displayId?: number;
 
   executionTimeout?: number;
@@ -121,6 +143,13 @@ export interface Task {
 
   maxSteps?: number;
 
+  /**
+   * Memory namespace for cross-task personalization
+   */
+  memoryNamespace?: string;
+
+  message?: string | null;
+
   output?: { [key: string]: unknown } | null;
 
   outputSchema?: { [key: string]: unknown } | null;
@@ -133,6 +162,13 @@ export interface Task {
 
   steps?: number | null;
 
+  streamUrl?: string | null;
+
+  /**
+   * LLM model used by sub-agent roles: executor, app_opener, structured_output
+   */
+  subagentModel?: string;
+
   succeeded?: boolean | null;
 
   temperature?: number;
@@ -148,7 +184,15 @@ export interface Task {
   vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
 }
 
-export type TaskStatus = 'created' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+export type TaskStatus =
+  | 'queued'
+  | 'created'
+  | 'running'
+  | 'cancelling'
+  | 'paused'
+  | 'completed'
+  | 'failed'
+  | 'cancelled';
 
 export interface UsageResult {
   request_tokens: number;
@@ -176,51 +220,39 @@ export interface TaskListResponse {
   /**
    * Pagination metadata
    */
-  pagination: TaskListResponse.Pagination;
+  pagination: Shared.PaginationMeta;
 }
 
-export namespace TaskListResponse {
+export interface TaskGetStatusResponse {
   /**
-   * Pagination metadata
+   * The status of the task
    */
-  export interface Pagination {
-    /**
-     * Whether there is a next page
-     */
-    hasNext: boolean;
-
-    /**
-     * Whether there is a previous page
-     */
-    hasPrev: boolean;
+  status: TaskStatus;
 
-    /**
-     * Current page number (1-based)
-     */
-    page: number;
+  /**
+   * The last agent response (FastAgentResponseEvent or ManagerPlanEvent)
+   */
+  lastResponse?: { [key: string]: unknown } | null;
 
-    /**
-     * Total number of pages
-     */
-    pages: number;
+  /**
+   * The agent's final answer or failure reason
+   */
+  message?: string | null;
 
-    /**
-     * Number of items per page
-     */
-    pageSize: number;
+  /**
+   * Structured output if outputSchema was set
+   */
+  output?: { [key: string]: unknown } | null;
 
-    /**
-     * Total number of items
-     */
-    total: number;
-  }
-}
+  /**
+   * Number of steps taken
+   */
+  steps?: number | null;
 
-export interface TaskGetStatusResponse {
   /**
-   * The status of the task
+   * Whether the task succeeded
    */
-  status: TaskStatus;
+  succeeded?: boolean | null;
 }
 
 export interface TaskGetTrajectoryResponse {
@@ -228,6 +260,7 @@ export interface TaskGetTrajectoryResponse {
    * The trajectory of the task
    */
   trajectory: Array<
+    | TaskGetTrajectoryResponse.TrajectoryQueuedEvent
     | TaskGetTrajectoryResponse.TrajectoryCreatedEvent
     | TaskGetTrajectoryResponse.TrajectoryExceptionEvent
     | TaskGetTrajectoryResponse.TrajectoryCancelEvent
@@ -256,11 +289,32 @@ export interface TaskGetTrajectoryResponse {
     | TaskGetTrajectoryResponse.TrajectoryExecutorResponseEvent
     | TaskGetTrajectoryResponse.TrajectoryExecutorActionEvent
     | TaskGetTrajectoryResponse.TrajectoryExecutorActionResultEvent
+    | TaskGetTrajectoryResponse.TrajectoryUserMessageEvent
     | TaskGetTrajectoryResponse.TrajectoryUnknownEvent
   >;
 }
 
 export namespace TaskGetTrajectoryResponse {
+  export interface TrajectoryQueuedEvent {
+    /**
+     * Emitted to SSE clients when the task is waiting in the device queue.
+     */
+    data: TrajectoryQueuedEvent.Data;
+
+    event: 'QueuedEvent';
+  }
+
+  export namespace TrajectoryQueuedEvent {
+    /**
+     * Emitted to SSE clients when the task is waiting in the device queue.
+     */
+    export interface Data {
+      id: string;
+
+      status?: string;
+    }
+  }
+
   export interface TrajectoryCreatedEvent {
     data: TrajectoryCreatedEvent.Data;
 
@@ -271,8 +325,6 @@ export namespace TaskGetTrajectoryResponse {
     export interface Data {
       id: string;
 
-      token: string;
-
       streamUrl: string;
     }
   }
@@ -390,6 +442,8 @@ export namespace TaskGetTrajectoryResponse {
      * API OpenAPI schema can reference it without the heavy droidrun import.
      */
     export interface Data {
+      message?: string | null;
+
       steps?: number | null;
 
       structured_output?: { [key: string]: unknown } | null;
@@ -787,6 +841,32 @@ export namespace TaskGetTrajectoryResponse {
     }
   }
 
+  export interface TrajectoryUserMessageEvent {
+    /**
+     * Tracks the lifecycle of an external user message: queued → applied | dropped.
+     */
+    data: TrajectoryUserMessageEvent.Data;
+
+    event: 'UserMessageEvent';
+  }
+
+  export namespace TrajectoryUserMessageEvent {
+    /**
+     * Tracks the lifecycle of an external user message: queued → applied | dropped.
+     */
+    export interface Data {
+      action: string;
+
+      message_ids: Array<string>;
+
+      consumer?: string | null;
+
+      reason?: string | null;
+
+      step_number?: number | null;
+    }
+  }
+
   export interface TrajectoryUnknownEvent {
     event: string;
 
@@ -801,14 +881,23 @@ export interface TaskRunResponse {
   id: string;
 
   /**
-   * The token of the stream
+   * The status of the task (queued or created)
+   */
+  status: TaskStatus;
+
+  /**
+   * The URL of the stream (null when queued)
    */
-  token: string;
+  streamUrl?: string | null;
+}
+
+export type TaskRunStreamedResponse = unknown;
 
+export interface TaskSendMessageResponse {
   /**
-   * The URL of the stream
+   * Whether the message was queued for delivery
    */
-  streamUrl: string;
+  sent: boolean;
 }
 
 export interface TaskStopResponse {
@@ -823,14 +912,8 @@ export interface TaskListParams {
 
   orderByDirection?: 'asc' | 'desc';
 
-  /**
-   * Page number (1-based). If provided, returns paginated results.
-   */
-  page?: number | null;
+  page?: number;
 
-  /**
-   * Number of items per page
-   */
   pageSize?: number;
 
   /**
@@ -843,20 +926,19 @@ export interface TaskListParams {
 
 export interface TaskRunParams {
   /**
-   * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
+   * The ID of the device to run the task on.
    */
-  llmModel: string;
+  deviceId: string;
 
   task: string;
 
+  agentId?: number;
+
   apps?: Array<string>;
 
-  credentials?: Array<PackageCredentials>;
+  continueOnFailure?: boolean;
 
-  /**
-   * The ID of the device to run the task on.
-   */
-  deviceId?: string | null;
+  credentials?: Array<PackageCredentials>;
 
   /**
    * The display ID of the device to run the task on.
@@ -867,14 +949,30 @@ export interface TaskRunParams {
 
   files?: Array<string>;
 
+  /**
+   * The LLM model identifier to use for the task (e.g.
+   * 'google/gemini-3.1-flash-lite-preview')
+   */
+  llmModel?: string;
+
   maxSteps?: number;
 
+  /**
+   * Memory namespace for cross-task personalization
+   */
+  memoryNamespace?: string;
+
   outputSchema?: { [key: string]: unknown } | null;
 
   reasoning?: boolean;
 
   stealth?: boolean;
 
+  /**
+   * LLM model used by sub-agent roles: executor, app_opener, structured_output
+   */
+  subagentModel?: string;
+
   temperature?: number;
 
   vision?: boolean;
@@ -884,20 +982,19 @@ export interface TaskRunParams {
 
 export interface TaskRunStreamedParams {
   /**
-   * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
+   * The ID of the device to run the task on.
    */
-  llmModel: string;
+  deviceId: string;
 
   task: string;
 
+  agentId?: number;
+
   apps?: Array<string>;
 
-  credentials?: Array<PackageCredentials>;
+  continueOnFailure?: boolean;
 
-  /**
-   * The ID of the device to run the task on.
-   */
-  deviceId?: string | null;
+  credentials?: Array<PackageCredentials>;
 
   /**
    * The display ID of the device to run the task on.
@@ -908,14 +1005,30 @@ export interface TaskRunStreamedParams {
 
   files?: Array<string>;
 
+  /**
+   * The LLM model identifier to use for the task (e.g.
+   * 'google/gemini-3.1-flash-lite-preview')
+   */
+  llmModel?: string;
+
   maxSteps?: number;
 
+  /**
+   * Memory namespace for cross-task personalization
+   */
+  memoryNamespace?: string;
+
   outputSchema?: { [key: string]: unknown } | null;
 
   reasoning?: boolean;
 
   stealth?: boolean;
 
+  /**
+   * LLM model used by sub-agent roles: executor, app_opener, structured_output
+   */
+  subagentModel?: string;
+
   temperature?: number;
 
   vision?: boolean;
@@ -923,6 +1036,13 @@ export interface TaskRunStreamedParams {
   vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
 }
 
+export interface TaskSendMessageParams {
+  /**
+   * Message to send to the running agent
+   */
+  message: string;
+}
+
 Tasks.Screenshots = Screenshots;
 Tasks.UiStates = UiStates;
 
@@ -937,10 +1057,13 @@ export declare namespace Tasks {
     type TaskGetStatusResponse as TaskGetStatusResponse,
     type TaskGetTrajectoryResponse as TaskGetTrajectoryResponse,
     type TaskRunResponse as TaskRunResponse,
+    type TaskRunStreamedResponse as TaskRunStreamedResponse,
+    type TaskSendMessageResponse as TaskSendMessageResponse,
     type TaskStopResponse as TaskStopResponse,
     type TaskListParams as TaskListParams,
     type TaskRunParams as TaskRunParams,
     type TaskRunStreamedParams as TaskRunStreamedParams,
+    type TaskSendMessageParams as TaskSendMessageParams,
   };
 
   export {

package/src/resources/tasks/ui-states.ts

@@ -6,6 +6,9 @@ import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
+/**
+ * Tasks API
+ */
 export class UiStates extends APIResource {
   /**
    * Get a specific UI state by index.

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '2.2.0'; // x-release-please-version
+export const VERSION = '4.0.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.2.0";
+export declare const VERSION = "4.0.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.2.0";
+export declare const VERSION = "4.0.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '2.2.0'; // x-release-please-version
+exports.VERSION = '4.0.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '2.2.0'; // x-release-please-version
+export const VERSION = '4.0.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map