@mobilerun/sdk 5.1.0 → 5.2.0

package/src/resources/tasks/tasks.ts

@@ -64,8 +64,16 @@ export class Tasks extends APIResource {
    * Create and dispatch a new agent task. Returns the task ID and device stream
    * details.
    */
-  run(body: TaskRunParams, options?: RequestOptions): APIPromise<TaskRunResponse> {
-    return this._client.post('/tasks', { body, ...options });
+  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,
+      ]),
+    });
   }
 
   /**
@@ -104,117 +112,132 @@ export interface PackageCredentials {
 }
 
 export interface Task {
-  deviceId: string;
+  createdAt: string;
 
-  /**
-   * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
-   */
-  llmModel: string;
+  taskId: string;
 
-  task: string;
+  updatedAt: string;
+}
 
-  userId: string;
+export type TaskStatus =
+  | 'queued'
+  | 'created'
+  | 'running'
+  | 'cancelling'
+  | 'completed'
+  | 'failed'
+  | 'cancelled';
 
-  id?: string;
+export interface UsageResult {
+  request_tokens: number;
 
-  accessibility?: boolean;
+  requests: number;
 
-  agentId?: number;
+  response_tokens: number;
 
-  apps?: Array<string>;
+  total_tokens: number;
+}
 
-  cancelRequestedAt?: string | null;
+export interface TaskRetrieveResponse {
+  /**
+   * The task
+   */
+  task: TaskRetrieveResponse.Task;
+}
 
-  claimedAt?: string | null;
+export namespace TaskRetrieveResponse {
+  /**
+   * The task
+   */
+  export interface Task {
+    id: string;
 
-  continueOnFailure?: boolean;
+    deviceId: string;
 
-  createdAt?: string;
+    displayId: number;
 
-  credentials?: Array<PackageCredentials>;
+    /**
+     * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
+     */
+    llmModel: string;
 
-  creditsUsed?: number | null;
+    ownerId: string;
 
-  dispatchedAt?: string | null;
+    status: TasksAPI.TaskStatus;
 
-  displayId?: number;
+    task: string;
 
-  executionTimeout?: number;
+    tmpDevice: boolean;
 
-  files?: Array<string>;
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
+    userId: string;
 
-  finishedAt?: string | null;
+    accessibility?: boolean;
 
-  heartbeatAt?: string | null;
+    agentId?: number;
 
-  maxSteps?: number;
+    apps?: Array<string>;
 
-  /**
-   * Memory namespace for cross-task personalization
-   */
-  memoryNamespace?: string;
+    cancelRequestedAt?: string | null;
 
-  message?: string | null;
+    claimedAt?: string | null;
 
-  output?: { [key: string]: unknown } | null;
+    continueOnFailure?: boolean;
 
-  outputSchema?: { [key: string]: unknown } | null;
+    createdAt?: string;
 
-  reasoning?: boolean;
+    createdBy?: string | null;
 
-  status?: TaskStatus;
+    credentials?: Array<TasksAPI.PackageCredentials>;
 
-  stealth?: boolean;
+    creditsUsed?: number | null;
 
-  steps?: number | null;
+    dispatchedAt?: string | null;
 
-  streamUrl?: string | null;
+    executionTimeout?: number;
 
-  /**
-   * LLM model used by sub-agent roles: executor, app_opener, structured_output
-   */
-  subagentModel?: string;
+    files?: Array<string>;
 
-  succeeded?: boolean | null;
+    finishedAt?: string | null;
 
-  temperature?: number;
+    maxSteps?: number;
 
-  tmpDevice?: boolean;
+    /**
+     * Memory namespace for cross-task personalization
+     */
+    memoryNamespace?: string;
 
-  trajectory?: Array<{ [key: string]: unknown }>;
+    message?: string | null;
 
-  updatedAt?: string;
+    output?: { [key: string]: unknown } | null;
 
-  vision?: boolean;
+    outputSchema?: { [key: string]: unknown } | null;
 
-  vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
-}
+    reasoning?: boolean;
 
-export type TaskStatus =
-  | 'queued'
-  | 'created'
-  | 'running'
-  | 'cancelling'
-  | 'paused'
-  | 'completed'
-  | 'failed'
-  | 'cancelled';
+    stealth?: boolean;
 
-export interface UsageResult {
-  request_tokens: number;
+    steps?: number | null;
 
-  requests: number;
+    streamUrl?: string | null;
 
-  response_tokens: number;
+    /**
+     * LLM model used by sub-agent roles: executor, app_opener, structured_output
+     */
+    subagentModel?: string;
 
-  total_tokens: number;
-}
+    succeeded?: boolean | null;
 
-export interface TaskRetrieveResponse {
-  /**
-   * The task
-   */
-  task: Task;
+    temperature?: number;
+
+    updatedAt?: string;
+
+    vision?: boolean;
+
+    vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
+  }
 }
 
 export interface TaskListResponse {
@@ -245,12 +268,17 @@ export namespace TaskListResponse {
      */
     llmModel: string;
 
+    ownerId: string;
+
     status: TasksAPI.TaskStatus;
 
     task: string;
 
     tmpDevice: boolean;
 
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
     userId: string;
 
     accessibility?: boolean;
@@ -267,6 +295,8 @@ export namespace TaskListResponse {
 
     createdAt?: string;
 
+    createdBy?: string | null;
+
     credentials?: Array<TasksAPI.PackageCredentials>;
 
     creditsUsed?: number | null;
@@ -323,6 +353,11 @@ export interface TaskGetStatusResponse {
    */
   status: TaskStatus;
 
+  /**
+   * Execution metadata for abnormal terminal outcomes
+   */
+  execution?: TaskGetStatusResponse.Execution | null;
+
   /**
    * The last agent response (FastAgentResponseEvent or ManagerPlanEvent)
    */
@@ -349,6 +384,31 @@ export interface TaskGetStatusResponse {
   succeeded?: boolean | null;
 }
 
+export namespace TaskGetStatusResponse {
+  /**
+   * Execution metadata for abnormal terminal outcomes
+   */
+  export interface Execution {
+    checkpoint: Execution.Checkpoint;
+
+    terminationReason: 'execution_timeout' | 'worker_lost' | 'cancelled' | 'agent_failed';
+
+    retrySafety?: 'unknown';
+  }
+
+  export namespace Execution {
+    export interface Checkpoint {
+      currentSubgoal?: string | null;
+
+      plan?: string | null;
+
+      progressSummary?: string | null;
+
+      steps?: number;
+    }
+  }
+}
+
 export interface TaskGetTrajectoryResponse {
   /**
    * The trajectory of the task
@@ -1002,6 +1062,16 @@ export interface TaskStopResponse {
 }
 
 export interface TaskListParams {
+  /**
+   * Only tasks created by this user id.
+   */
+  createdBy?: string | null;
+
+  /**
+   * Only tasks created by the calling user.
+   */
+  mine?: boolean;
+
   orderBy?: 'id' | 'createdAt' | 'finishedAt' | 'status' | null;
 
   orderByDirection?: 'asc' | 'desc';
@@ -1020,60 +1090,111 @@ export interface TaskListParams {
 
 export interface TaskRunParams {
   /**
-   * The ID of the device to run the task on.
+   * Body param: 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<PackageCredentials>;
 
   /**
-   * The display ID of the device to run the task on.
+   * Body param: The display ID of the device to run the task on.
    */
   displayId?: number;
 
+  /**
+   * Body param
+   */
   executionTimeout?: number;
 
+  /**
+   * Body param
+   */
   files?: Array<string>;
 
   /**
-   * The LLM model identifier to use for the task (e.g.
-   * 'google/gemini-3.1-flash-lite')
+   * Body param: The LLM model identifier to use for the task (e.g.
+   * 'google/gemini-3.5-flash')
    */
   llmModel?: string;
 
+  /**
+   * Body param
+   */
   maxSteps?: number;
 
   /**
-   * Memory namespace for cross-task personalization
+   * Body param: Memory namespace for cross-task personalization
    */
   memoryNamespace?: string;
 
+  /**
+   * Body param
+   */
   outputSchema?: { [key: string]: unknown } | null;
 
+  /**
+   * Body param
+   */
   reasoning?: boolean;
 
+  /**
+   * Body param
+   */
   stealth?: boolean;
 
   /**
-   * LLM model used by sub-agent roles: executor, app_opener, structured_output
+   * Body param: LLM model used by sub-agent roles: executor, app_opener,
+   * structured_output
    */
   subagentModel?: string;
 
+  /**
+   * Body param
+   */
   temperature?: number;
 
+  /**
+   * Body param
+   */
   vision?: boolean;
 
+  /**
+   * Body param
+   */
   vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
+
+  /**
+   * Header param
+   */
+  'Idempotency-Key'?: string;
 }
 
 export interface TaskRunStreamedParams {
@@ -1104,8 +1225,7 @@ export interface TaskRunStreamedParams {
   files?: Array<string>;
 
   /**
-   * The LLM model identifier to use for the task (e.g.
-   * 'google/gemini-3.1-flash-lite')
+   * The LLM model identifier to use for the task (e.g. 'google/gemini-3.5-flash')
    */
   llmModel?: string;
 

package/src/resources/webhooks/deliveries.ts

@@ -8,7 +8,10 @@ import { path } from '../../internal/utils/path';
 
 export class Deliveries extends APIResource {
   /**
-   * List deliveries across all your webhooks
+   * Returns a paginated feed of webhook deliveries across all of your subscriptions,
+   * with the originating endpoint URL included on each record. Results can be
+   * filtered by delivery status (pending, success, skipped, or dead), by a `since`
+   * timestamp, and by `eventId` (exact match against the originating event id).
    *
    * @example
    * ```ts
@@ -23,7 +26,10 @@ export class Deliveries extends APIResource {
   }
 
   /**
-   * List deliveries for a webhook
+   * Returns a paginated list of deliveries for a single webhook subscription,
+   * identified by its id. Each record reports the event, delivery status, attempt
+   * count, and the last response code or error. Results can be filtered by `eventId`
+   * (exact match against the originating event id).
    *
    * @example
    * ```ts
@@ -42,7 +48,9 @@ export class Deliveries extends APIResource {
   }
 
   /**
-   * Get a delivery with its attempts
+   * Returns a single delivery for a webhook subscription along with the full list of
+   * captured attempt records. Each attempt includes the request URL, method, headers
+   * and body, whether it was signed, and the response status, headers, and snippet.
    *
    * @example
    * ```ts
@@ -63,7 +71,10 @@ export class Deliveries extends APIResource {
   }
 
   /**
-   * Aggregate delivery statistics (excludes test sends)
+   * Returns aggregate delivery statistics across all of your webhooks, including the
+   * total count, a breakdown by status (pending, success, skipped, dead), and the
+   * overall success rate. An optional `since` timestamp narrows the reporting
+   * window.
    *
    * @example
    * ```ts
@@ -94,6 +105,12 @@ export namespace DeliveryListResponse {
 
     createdAt: string;
 
+    /**
+     * Id of the parent endpoint's creator. Null when the endpoint row is gone or its
+     * creator was never recorded.
+     */
+    createdBy: string | null;
+
     durationMs: number | null;
 
     endpointId: string;
@@ -134,6 +151,12 @@ export namespace DeliveryListForWebhookResponse {
 
     createdAt: string;
 
+    /**
+     * Id of the parent endpoint's creator. Null when the endpoint row is gone or its
+     * creator was never recorded.
+     */
+    createdBy: string | null;
+
     durationMs: number | null;
 
     endpointId: string;
@@ -170,6 +193,12 @@ export namespace DeliveryRetrieveAttemptsResponse {
 
     createdAt: string;
 
+    /**
+     * Id of the parent endpoint's creator. Null when the endpoint row is gone or its
+     * creator was never recorded.
+     */
+    createdBy: string | null;
+
     durationMs: number | null;
 
     endpointId: string;
@@ -247,6 +276,11 @@ export namespace DeliveryStatsResponse {
 }
 
 export interface DeliveryListParams {
+  /**
+   * Exact text match against the originating event id.
+   */
+  eventId?: string;
+
   page?: number;
 
   pageSize?: number;
@@ -257,6 +291,11 @@ export interface DeliveryListParams {
 }
 
 export interface DeliveryListForWebhookParams {
+  /**
+   * Exact text match against the originating event id.
+   */
+  eventId?: string;
+
   page?: number;
 
   pageSize?: number;