@mobilerun/sdk 3.0.0 → 5.1.0

package/src/resources/tasks/tasks.ts

@@ -117,14 +117,26 @@ export interface Task {
 
   id?: string;
 
+  accessibility?: boolean;
+
   agentId?: number;
 
   apps?: Array<string>;
 
+  cancelRequestedAt?: string | null;
+
+  claimedAt?: string | null;
+
+  continueOnFailure?: boolean;
+
   createdAt?: string;
 
   credentials?: Array<PackageCredentials>;
 
+  creditsUsed?: number | null;
+
+  dispatchedAt?: string | null;
+
   displayId?: number;
 
   executionTimeout?: number;
@@ -133,8 +145,15 @@ export interface Task {
 
   finishedAt?: string | null;
 
+  heartbeatAt?: string | null;
+
   maxSteps?: number;
 
+  /**
+   * Memory namespace for cross-task personalization
+   */
+  memoryNamespace?: string;
+
   message?: string | null;
 
   output?: { [key: string]: unknown } | null;
@@ -149,6 +168,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;
@@ -164,7 +190,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;
@@ -187,7 +221,7 @@ export interface TaskListResponse {
   /**
    * The paginated items
    */
-  items: Array<Task>;
+  items: Array<TaskListResponse.Item>;
 
   /**
    * Pagination metadata
@@ -195,6 +229,94 @@ export interface TaskListResponse {
   pagination: Shared.PaginationMeta;
 }
 
+export namespace TaskListResponse {
+  /**
+   * Task representation for list endpoints — omits the large trajectory field.
+   */
+  export interface Item {
+    id: string;
+
+    deviceId: string;
+
+    displayId: number;
+
+    /**
+     * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
+     */
+    llmModel: string;
+
+    status: TasksAPI.TaskStatus;
+
+    task: string;
+
+    tmpDevice: boolean;
+
+    userId: string;
+
+    accessibility?: boolean;
+
+    agentId?: number;
+
+    apps?: Array<string>;
+
+    cancelRequestedAt?: string | null;
+
+    claimedAt?: string | null;
+
+    continueOnFailure?: boolean;
+
+    createdAt?: string;
+
+    credentials?: Array<TasksAPI.PackageCredentials>;
+
+    creditsUsed?: number | null;
+
+    dispatchedAt?: string | null;
+
+    executionTimeout?: number;
+
+    files?: Array<string>;
+
+    finishedAt?: string | null;
+
+    maxSteps?: number;
+
+    /**
+     * Memory namespace for cross-task personalization
+     */
+    memoryNamespace?: string;
+
+    message?: string | null;
+
+    output?: { [key: string]: unknown } | null;
+
+    outputSchema?: { [key: string]: unknown } | null;
+
+    reasoning?: boolean;
+
+    stealth?: boolean;
+
+    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;
+
+    updatedAt?: string;
+
+    vision?: boolean;
+
+    vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
+  }
+}
+
 export interface TaskGetStatusResponse {
   /**
    * The status of the task
@@ -232,6 +354,7 @@ export interface TaskGetTrajectoryResponse {
    * The trajectory of the task
    */
   trajectory: Array<
+    | TaskGetTrajectoryResponse.TrajectoryQueuedEvent
     | TaskGetTrajectoryResponse.TrajectoryCreatedEvent
     | TaskGetTrajectoryResponse.TrajectoryExceptionEvent
     | TaskGetTrajectoryResponse.TrajectoryCancelEvent
@@ -266,6 +389,26 @@ export interface TaskGetTrajectoryResponse {
 }
 
 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;
 
@@ -414,7 +557,7 @@ export namespace TaskGetTrajectoryResponse {
 
   export interface TrajectoryManagerPlanEvent {
     /**
-     * Coordination event from ManagerAgent to DroidAgent.
+     * Coordination event from ManagerAgent to MobileAgent.
      *
      * Used for workflow step routing only (NOT streamed to frontend). For internal
      * events with memory_update metadata, see ManagerPlanDetailsEvent.
@@ -426,7 +569,7 @@ export namespace TaskGetTrajectoryResponse {
 
   export namespace TrajectoryManagerPlanEvent {
     /**
-     * Coordination event from ManagerAgent to DroidAgent.
+     * Coordination event from ManagerAgent to MobileAgent.
      *
      * Used for workflow step routing only (NOT streamed to frontend). For internal
      * events with memory_update metadata, see ManagerPlanDetailsEvent.
@@ -832,9 +975,14 @@ export interface TaskRunResponse {
   id: string;
 
   /**
-   * The URL of the stream
+   * The status of the task (queued or created)
+   */
+  status: TaskStatus;
+
+  /**
+   * The URL of the stream (null when queued)
    */
-  streamUrl: string;
+  streamUrl?: string | null;
 }
 
 export type TaskRunStreamedResponse = unknown;
@@ -878,10 +1026,14 @@ export interface TaskRunParams {
 
   task: string;
 
+  accessibility?: boolean;
+
   agentId?: number;
 
   apps?: Array<string>;
 
+  continueOnFailure?: boolean;
+
   credentials?: Array<PackageCredentials>;
 
   /**
@@ -895,18 +1047,28 @@ export interface TaskRunParams {
 
   /**
    * The LLM model identifier to use for the task (e.g.
-   * 'google/gemini-3.1-flash-lite-preview')
+   * 'google/gemini-3.1-flash-lite')
    */
   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;
@@ -922,10 +1084,14 @@ export interface TaskRunStreamedParams {
 
   task: string;
 
+  accessibility?: boolean;
+
   agentId?: number;
 
   apps?: Array<string>;
 
+  continueOnFailure?: boolean;
+
   credentials?: Array<PackageCredentials>;
 
   /**
@@ -939,18 +1105,28 @@ export interface TaskRunStreamedParams {
 
   /**
    * The LLM model identifier to use for the task (e.g.
-   * 'google/gemini-3.1-flash-lite-preview')
+   * 'google/gemini-3.1-flash-lite')
    */
   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;

package/src/resources/webhooks/deliveries.ts

@@ -0,0 +1,284 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as Shared from '../shared';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Deliveries extends APIResource {
+  /**
+   * List deliveries across all your webhooks
+   *
+   * @example
+   * ```ts
+   * const deliveries = await client.webhooks.deliveries.list();
+   * ```
+   */
+  list(
+    query: DeliveryListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DeliveryListResponse> {
+    return this._client.get('/webhooks/deliveries', { query, ...options });
+  }
+
+  /**
+   * List deliveries for a webhook
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.webhooks.deliveries.listForWebhook(
+   *     '550e8400-e29b-41d4-a716-446655440000',
+   *   );
+   * ```
+   */
+  listForWebhook(
+    id: string,
+    query: DeliveryListForWebhookParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DeliveryListForWebhookResponse> {
+    return this._client.get(path`/webhooks/${id}/deliveries`, { query, ...options });
+  }
+
+  /**
+   * Get a delivery with its attempts
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.webhooks.deliveries.retrieveAttempts(
+   *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   *     { id: '550e8400-e29b-41d4-a716-446655440000' },
+   *   );
+   * ```
+   */
+  retrieveAttempts(
+    deliveryID: string,
+    params: DeliveryRetrieveAttemptsParams,
+    options?: RequestOptions,
+  ): APIPromise<DeliveryRetrieveAttemptsResponse> {
+    const { id } = params;
+    return this._client.get(path`/webhooks/${id}/deliveries/${deliveryID}`, options);
+  }
+
+  /**
+   * Aggregate delivery statistics (excludes test sends)
+   *
+   * @example
+   * ```ts
+   * const response = await client.webhooks.deliveries.stats();
+   * ```
+   */
+  stats(
+    query: DeliveryStatsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DeliveryStatsResponse> {
+    return this._client.get('/webhooks/deliveries/stats', { query, ...options });
+  }
+}
+
+export interface DeliveryListResponse {
+  items: Array<DeliveryListResponse.Item>;
+
+  pagination: Shared.Pagination;
+}
+
+export namespace DeliveryListResponse {
+  export interface Item {
+    id: string;
+
+    attempts: number;
+
+    completedAt: string | null;
+
+    createdAt: string;
+
+    durationMs: number | null;
+
+    endpointId: string;
+
+    endpointUrl: string;
+
+    eventId: string;
+
+    eventType: string;
+
+    isTest: boolean;
+
+    lastError: string | null;
+
+    lastStatusCode: number | null;
+
+    occurredAt: string;
+
+    source: string;
+
+    status: 'pending' | 'success' | 'skipped' | 'dead';
+  }
+}
+
+export interface DeliveryListForWebhookResponse {
+  items: Array<DeliveryListForWebhookResponse.Item>;
+
+  pagination: Shared.Pagination;
+}
+
+export namespace DeliveryListForWebhookResponse {
+  export interface Item {
+    id: string;
+
+    attempts: number;
+
+    completedAt: string | null;
+
+    createdAt: string;
+
+    durationMs: number | null;
+
+    endpointId: string;
+
+    eventId: string;
+
+    eventType: string;
+
+    isTest: boolean;
+
+    lastError: string | null;
+
+    lastStatusCode: number | null;
+
+    occurredAt: string;
+
+    source: string;
+
+    status: 'pending' | 'success' | 'skipped' | 'dead';
+  }
+}
+
+export interface DeliveryRetrieveAttemptsResponse {
+  data: DeliveryRetrieveAttemptsResponse.Data;
+}
+
+export namespace DeliveryRetrieveAttemptsResponse {
+  export interface Data {
+    id: string;
+
+    attempts: Array<Data.Attempt>;
+
+    completedAt: string | null;
+
+    createdAt: string;
+
+    durationMs: number | null;
+
+    endpointId: string;
+
+    eventId: string;
+
+    eventType: string;
+
+    isTest: boolean;
+
+    lastError: string | null;
+
+    lastStatusCode: number | null;
+
+    occurredAt: string;
+
+    source: string;
+
+    status: 'pending' | 'success' | 'skipped' | 'dead';
+  }
+
+  export namespace Data {
+    export interface Attempt {
+      attemptNo: number;
+
+      durationMs: number | null;
+
+      error: string | null;
+
+      requestBody: string | null;
+
+      requestHeaders: { [key: string]: string } | null;
+
+      requestMethod: string;
+
+      requestUrl: string;
+
+      responseHeaders: { [key: string]: string } | null;
+
+      responseSnippet: string | null;
+
+      responseStatus: number | null;
+
+      sentAt: string;
+
+      signed: boolean;
+    }
+  }
+}
+
+export interface DeliveryStatsResponse {
+  data: DeliveryStatsResponse.Data;
+}
+
+export namespace DeliveryStatsResponse {
+  export interface Data {
+    byStatus: Data.ByStatus;
+
+    successRate: number | null;
+
+    total: number;
+  }
+
+  export namespace Data {
+    export interface ByStatus {
+      dead: number;
+
+      pending: number;
+
+      skipped: number;
+
+      success: number;
+    }
+  }
+}
+
+export interface DeliveryListParams {
+  page?: number;
+
+  pageSize?: number;
+
+  since?: string;
+
+  status?: 'pending' | 'success' | 'skipped' | 'dead';
+}
+
+export interface DeliveryListForWebhookParams {
+  page?: number;
+
+  pageSize?: number;
+}
+
+export interface DeliveryRetrieveAttemptsParams {
+  id: string;
+}
+
+export interface DeliveryStatsParams {
+  since?: string;
+}
+
+export declare namespace Deliveries {
+  export {
+    type DeliveryListResponse as DeliveryListResponse,
+    type DeliveryListForWebhookResponse as DeliveryListForWebhookResponse,
+    type DeliveryRetrieveAttemptsResponse as DeliveryRetrieveAttemptsResponse,
+    type DeliveryStatsResponse as DeliveryStatsResponse,
+    type DeliveryListParams as DeliveryListParams,
+    type DeliveryListForWebhookParams as DeliveryListForWebhookParams,
+    type DeliveryRetrieveAttemptsParams as DeliveryRetrieveAttemptsParams,
+    type DeliveryStatsParams as DeliveryStatsParams,
+  };
+}

package/src/resources/webhooks/index.ts

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Deliveries,
+  type DeliveryListResponse,
+  type DeliveryListForWebhookResponse,
+  type DeliveryRetrieveAttemptsResponse,
+  type DeliveryStatsResponse,
+  type DeliveryListParams,
+  type DeliveryListForWebhookParams,
+  type DeliveryRetrieveAttemptsParams,
+  type DeliveryStatsParams,
+} from './deliveries';
+export {
+  Webhooks,
+  type WebhookCreateResponse,
+  type WebhookRetrieveResponse,
+  type WebhookUpdateResponse,
+  type WebhookListResponse,
+  type WebhookEventTypesResponse,
+  type WebhookRotateSecretResponse,
+  type WebhookTestDeliveryResponse,
+  type WebhookCreateParams,
+  type WebhookUpdateParams,
+  type WebhookListParams,
+} from './webhooks';