@mobilerun/sdk 4.0.0 → 5.1.0

package/src/resources/shared.ts

@@ -1,5 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import * as Shared from './shared';
+
 export interface DeviceCarrier {
   GsmOperatorAlpha: string;
 
@@ -52,17 +54,27 @@ export interface DeviceSpec {
    */
   $schema?: string;
 
+  androidVersion?: number;
+
   apps?: Array<string> | null;
 
   carrier?: DeviceCarrier;
 
+  country?: string;
+
   files?: Array<string> | null;
 
   identifiers?: DeviceIdentifiers;
 
+  locale?: string;
+
+  location?: Location;
+
   name?: string;
 
   proxy?: DeviceSpec.Proxy;
+
+  timezone?: string;
 }
 
 export namespace DeviceSpec {
@@ -71,22 +83,19 @@ export namespace DeviceSpec {
 
     smartIp?: boolean;
 
-    socks5?: Proxy.Socks5;
-
-    wireguard?: string;
+    socks5?: Shared.Socks5;
   }
+}
 
-  export namespace Proxy {
-    export interface Socks5 {
-      host: string;
-
-      password: string;
+export interface Location {
+  latitude: number;
 
-      port: number;
+  longitude: number;
 
-      user: string;
-    }
-  }
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
 }
 
 export interface Meta {
@@ -159,3 +168,13 @@ export interface PermissionSet {
 
   write: boolean;
 }
+
+export interface Socks5 {
+  host: string;
+
+  password: string;
+
+  port: number;
+
+  user: string;
+}

package/src/resources/tasks/tasks.ts

@@ -117,6 +117,8 @@ export interface Task {
 
   id?: string;
 
+  accessibility?: boolean;
+
   agentId?: number;
 
   apps?: Array<string>;
@@ -131,6 +133,8 @@ export interface Task {
 
   credentials?: Array<PackageCredentials>;
 
+  creditsUsed?: number | null;
+
   dispatchedAt?: string | null;
 
   displayId?: number;
@@ -141,6 +145,8 @@ export interface Task {
 
   finishedAt?: string | null;
 
+  heartbeatAt?: string | null;
+
   maxSteps?: number;
 
   /**
@@ -215,7 +221,7 @@ export interface TaskListResponse {
   /**
    * The paginated items
    */
-  items: Array<Task>;
+  items: Array<TaskListResponse.Item>;
 
   /**
    * Pagination metadata
@@ -223,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
@@ -463,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.
@@ -475,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.
@@ -932,6 +1026,8 @@ export interface TaskRunParams {
 
   task: string;
 
+  accessibility?: boolean;
+
   agentId?: number;
 
   apps?: Array<string>;
@@ -951,7 +1047,7 @@ 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;
 
@@ -988,6 +1084,8 @@ export interface TaskRunStreamedParams {
 
   task: string;
 
+  accessibility?: boolean;
+
   agentId?: number;
 
   apps?: Array<string>;
@@ -1007,7 +1105,7 @@ 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;
 

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';