@mobilerun/sdk 2.1.0 → 3.0.0

package/src/resources/tasks/tasks.ts

@@ -1,6 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 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';
@@ -10,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);
@@ -67,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 });
   }
 
   /**
@@ -84,6 +97,12 @@ export class Tasks extends APIResource {
   }
 }
 
+export interface PackageCredentials {
+  credentialNames: Array<string>;
+
+  packageName: string;
+}
+
 export interface Task {
   deviceId: string;
 
@@ -98,11 +117,13 @@ export interface Task {
 
   id?: string;
 
+  agentId?: number;
+
   apps?: Array<string>;
 
   createdAt?: string;
 
-  credentials?: Array<Task.Credential>;
+  credentials?: Array<PackageCredentials>;
 
   displayId?: number;
 
@@ -114,6 +135,8 @@ export interface Task {
 
   maxSteps?: number;
 
+  message?: string | null;
+
   output?: { [key: string]: unknown } | null;
 
   outputSchema?: { [key: string]: unknown } | null;
@@ -141,15 +164,17 @@ export interface Task {
   vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
 }
 
-export namespace Task {
-  export interface Credential {
-    credentialNames: Array<string>;
+export type TaskStatus = 'created' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
 
-    packageName: string;
-  }
-}
+export interface UsageResult {
+  request_tokens: number;
 
-export type TaskStatus = 'created' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+  requests: number;
+
+  response_tokens: number;
+
+  total_tokens: number;
+}
 
 export interface TaskRetrieveResponse {
   /**
@@ -167,51 +192,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 {
@@ -247,6 +260,7 @@ export interface TaskGetTrajectoryResponse {
     | TaskGetTrajectoryResponse.TrajectoryExecutorResponseEvent
     | TaskGetTrajectoryResponse.TrajectoryExecutorActionEvent
     | TaskGetTrajectoryResponse.TrajectoryExecutorActionResultEvent
+    | TaskGetTrajectoryResponse.TrajectoryUserMessageEvent
     | TaskGetTrajectoryResponse.TrajectoryUnknownEvent
   >;
 }
@@ -262,8 +276,6 @@ export namespace TaskGetTrajectoryResponse {
     export interface Data {
       id: string;
 
-      token: string;
-
       streamUrl: string;
     }
   }
@@ -381,6 +393,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;
@@ -499,19 +513,7 @@ export namespace TaskGetTrajectoryResponse {
 
       code?: string | null;
 
-      usage?: Data.Usage | null;
-    }
-
-    export namespace Data {
-      export interface Usage {
-        request_tokens: number;
-
-        requests: number;
-
-        response_tokens: number;
-
-        total_tokens: number;
-      }
+      usage?: TasksAPI.UsageResult | null;
     }
   }
 
@@ -664,19 +666,7 @@ export namespace TaskGetTrajectoryResponse {
     export interface Data {
       response: string;
 
-      usage?: Data.Usage | null;
-    }
-
-    export namespace Data {
-      export interface Usage {
-        request_tokens: number;
-
-        requests: number;
-
-        response_tokens: number;
-
-        total_tokens: number;
-      }
+      usage?: TasksAPI.UsageResult | null;
     }
   }
 
@@ -746,19 +736,7 @@ export namespace TaskGetTrajectoryResponse {
     export interface Data {
       response: string;
 
-      usage?: Data.Usage | null;
-    }
-
-    export namespace Data {
-      export interface Usage {
-        request_tokens: number;
-
-        requests: number;
-
-        response_tokens: number;
-
-        total_tokens: number;
-      }
+      usage?: TasksAPI.UsageResult | null;
     }
   }
 
@@ -814,6 +792,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;
 
@@ -828,14 +832,18 @@ export interface TaskRunResponse {
   id: string;
 
   /**
-   * The token of the stream
+   * The URL of the stream
    */
-  token: string;
+  streamUrl: string;
+}
 
+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 {
@@ -850,14 +858,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;
 
   /**
@@ -870,20 +872,17 @@ 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;
 
-  apps?: Array<string>;
+  agentId?: number;
 
-  credentials?: Array<TaskRunParams.Credential>;
+  apps?: Array<string>;
 
-  /**
-   * 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.
@@ -894,6 +893,12 @@ 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;
 
   outputSchema?: { [key: string]: unknown } | null;
@@ -909,30 +914,19 @@ export interface TaskRunParams {
   vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
 }
 
-export namespace TaskRunParams {
-  export interface Credential {
-    credentialNames: Array<string>;
-
-    packageName: string;
-  }
-}
-
 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;
 
-  apps?: Array<string>;
+  agentId?: number;
 
-  credentials?: Array<TaskRunStreamedParams.Credential>;
+  apps?: Array<string>;
 
-  /**
-   * 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.
@@ -943,6 +937,12 @@ 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;
 
   outputSchema?: { [key: string]: unknown } | null;
@@ -958,12 +958,11 @@ export interface TaskRunStreamedParams {
   vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
 }
 
-export namespace TaskRunStreamedParams {
-  export interface Credential {
-    credentialNames: Array<string>;
-
-    packageName: string;
-  }
+export interface TaskSendMessageParams {
+  /**
+   * Message to send to the running agent
+   */
+  message: string;
 }
 
 Tasks.Screenshots = Screenshots;
@@ -971,17 +970,22 @@ Tasks.UiStates = UiStates;
 
 export declare namespace Tasks {
   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 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.1.0'; // x-release-please-version
+export const VERSION = '3.0.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.1.0";
+export declare const VERSION = "3.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.1.0'; // x-release-please-version
+exports.VERSION = '3.0.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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