@mobilerun/sdk 5.1.0 → 5.2.1

package/src/resources/store/store.ts

@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AppsAPI from './apps';
+import { AppAddToWorkspaceResponse, AppListParams, AppListResponse, AppRetrieveResponse, Apps } from './apps';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Store extends APIResource {
+  apps: AppsAPI.Apps = new AppsAPI.Apps(this._client);
+
+  /**
+   * Distinct, sorted categories among PUBLISHED store listings. No pagination.
+   */
+  categories(options?: RequestOptions): APIPromise<StoreCategoriesResponse> {
+    return this._client.get('/store/categories', options);
+  }
+}
+
+export interface StoreCategoriesResponse {
+  categories: Array<string>;
+}
+
+Store.Apps = Apps;
+
+export declare namespace Store {
+  export { type StoreCategoriesResponse as StoreCategoriesResponse };
+
+  export {
+    Apps as Apps,
+    type AppRetrieveResponse as AppRetrieveResponse,
+    type AppListResponse as AppListResponse,
+    type AppAddToWorkspaceResponse as AppAddToWorkspaceResponse,
+    type AppListParams as AppListParams,
+  };
+}

package/src/resources/store.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './store/index';

package/src/resources/tasks/index.ts

@@ -2,16 +2,12 @@
 
 export {
   Screenshots,
-  type MediaResponse,
+  type ScreenshotRetrieveResponse,
   type ScreenshotListResponse,
   type ScreenshotRetrieveParams,
 } from './screenshots';
 export {
   Tasks,
-  type PackageCredentials,
-  type Task,
-  type TaskStatus,
-  type UsageResult,
   type TaskRetrieveResponse,
   type TaskListResponse,
   type TaskGetStatusResponse,
@@ -25,4 +21,9 @@ export {
   type TaskRunStreamedParams,
   type TaskSendMessageParams,
 } from './tasks';
-export { UiStates, type UiStateListResponse, type UiStateRetrieveParams } from './ui-states';
+export {
+  UiStates,
+  type UiStateRetrieveResponse,
+  type UiStateListResponse,
+  type UiStateRetrieveParams,
+} from './ui-states';

package/src/resources/tasks/screenshots.ts

@@ -16,7 +16,7 @@ export class Screenshots extends APIResource {
     index: number,
     params: ScreenshotRetrieveParams,
     options?: RequestOptions,
-  ): APIPromise<MediaResponse> {
+  ): APIPromise<ScreenshotRetrieveResponse> {
     const { task_id } = params;
     return this._client.get(path`/tasks/${task_id}/screenshots/${index}`, options);
   }
@@ -29,7 +29,7 @@ export class Screenshots extends APIResource {
   }
 }
 
-export interface MediaResponse {
+export interface ScreenshotRetrieveResponse {
   /**
    * The URL of the media
    */
@@ -49,7 +49,7 @@ export interface ScreenshotRetrieveParams {
 
 export declare namespace Screenshots {
   export {
-    type MediaResponse as MediaResponse,
+    type ScreenshotRetrieveResponse as ScreenshotRetrieveResponse,
     type ScreenshotListResponse as ScreenshotListResponse,
     type ScreenshotRetrieveParams as ScreenshotRetrieveParams,
   };

package/src/resources/tasks/tasks.ts

@@ -1,12 +1,16 @@
 // 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 {
+  ScreenshotListResponse,
+  ScreenshotRetrieveParams,
+  ScreenshotRetrieveResponse,
+  Screenshots,
+} from './screenshots';
 import * as UiStatesAPI from './ui-states';
-import { UiStateListResponse, UiStateRetrieveParams, UiStates } from './ui-states';
+import { UiStateListResponse, UiStateRetrieveParams, UiStateRetrieveResponse, UiStates } from './ui-states';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -64,8 +68,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,
+      ]),
+    });
   }
 
   /**
@@ -97,124 +109,114 @@ export class Tasks extends APIResource {
   }
 }
 
-export interface PackageCredentials {
-  credentialNames: Array<string>;
-
-  packageName: string;
+export interface TaskRetrieveResponse {
+  /**
+   * The task
+   */
+  task: TaskRetrieveResponse.Task;
 }
 
-export interface Task {
-  deviceId: string;
-
+export namespace TaskRetrieveResponse {
   /**
-   * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
+   * The task
    */
-  llmModel: string;
-
-  task: string;
-
-  userId: string;
-
-  id?: string;
+  export interface Task {
+    id: string;
 
-  accessibility?: boolean;
+    deviceId: string;
 
-  agentId?: number;
+    displayId: number;
 
-  apps?: Array<string>;
+    /**
+     * The LLM model identifier to use for the task (e.g. 'gemini/gemini-2.5-flash')
+     */
+    llmModel: string;
 
-  cancelRequestedAt?: string | null;
+    ownerId: string;
 
-  claimedAt?: string | null;
+    status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
 
-  continueOnFailure?: boolean;
+    task: string;
 
-  createdAt?: string;
+    tmpDevice: boolean;
 
-  credentials?: Array<PackageCredentials>;
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
+    userId: string;
 
-  creditsUsed?: number | null;
+    accessibility?: boolean;
 
-  dispatchedAt?: string | null;
+    agentId?: number;
 
-  displayId?: number;
+    apps?: Array<string>;
 
-  executionTimeout?: number;
+    cancelRequestedAt?: string | null;
 
-  files?: Array<string>;
+    claimedAt?: string | null;
 
-  finishedAt?: string | null;
+    continueOnFailure?: boolean;
 
-  heartbeatAt?: string | null;
+    createdAt?: string;
 
-  maxSteps?: number;
+    createdBy?: string | null;
 
-  /**
-   * Memory namespace for cross-task personalization
-   */
-  memoryNamespace?: string;
+    credentials?: Array<Task.Credential>;
 
-  message?: string | null;
+    creditsUsed?: number | null;
 
-  output?: { [key: string]: unknown } | null;
+    dispatchedAt?: string | null;
 
-  outputSchema?: { [key: string]: unknown } | null;
+    executionTimeout?: number;
 
-  reasoning?: boolean;
+    files?: Array<string>;
 
-  status?: TaskStatus;
+    finishedAt?: string | null;
 
-  stealth?: boolean;
+    maxSteps?: number;
 
-  steps?: number | null;
+    /**
+     * Memory namespace for cross-task personalization
+     */
+    memoryNamespace?: string;
 
-  streamUrl?: string | null;
+    message?: string | null;
 
-  /**
-   * LLM model used by sub-agent roles: executor, app_opener, structured_output
-   */
-  subagentModel?: string;
+    output?: { [key: string]: unknown } | null;
 
-  succeeded?: boolean | null;
+    outputSchema?: { [key: string]: unknown } | null;
 
-  temperature?: number;
+    reasoning?: boolean;
 
-  tmpDevice?: boolean;
+    stealth?: boolean;
 
-  trajectory?: Array<{ [key: string]: unknown }>;
+    steps?: number | null;
 
-  updatedAt?: string;
+    streamUrl?: string | null;
 
-  vision?: boolean;
+    /**
+     * LLM model used by sub-agent roles: executor, app_opener, structured_output
+     */
+    subagentModel?: string;
 
-  vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
-}
+    succeeded?: boolean | null;
 
-export type TaskStatus =
-  | 'queued'
-  | 'created'
-  | 'running'
-  | 'cancelling'
-  | 'paused'
-  | 'completed'
-  | 'failed'
-  | 'cancelled';
+    temperature?: number;
 
-export interface UsageResult {
-  request_tokens: number;
+    updatedAt?: string;
 
-  requests: number;
+    vision?: boolean;
 
-  response_tokens: number;
+    vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
+  }
 
-  total_tokens: number;
-}
+  export namespace Task {
+    export interface Credential {
+      credentialNames: Array<string>;
 
-export interface TaskRetrieveResponse {
-  /**
-   * The task
-   */
-  task: Task;
+      packageName: string;
+    }
+  }
 }
 
 export interface TaskListResponse {
@@ -245,12 +247,17 @@ export namespace TaskListResponse {
      */
     llmModel: string;
 
-    status: TasksAPI.TaskStatus;
+    ownerId: string;
+
+    status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
 
     task: string;
 
     tmpDevice: boolean;
 
+    /**
+     * @deprecated Deprecated: use ownerId (tenancy) / createdBy (actor).
+     */
     userId: string;
 
     accessibility?: boolean;
@@ -267,7 +274,9 @@ export namespace TaskListResponse {
 
     createdAt?: string;
 
-    credentials?: Array<TasksAPI.PackageCredentials>;
+    createdBy?: string | null;
+
+    credentials?: Array<Item.Credential>;
 
     creditsUsed?: number | null;
 
@@ -315,13 +324,26 @@ export namespace TaskListResponse {
 
     vpnCountry?: 'US' | 'BR' | 'FR' | 'DE' | 'IN' | 'JP' | 'KR' | 'ZA' | null;
   }
+
+  export namespace Item {
+    export interface Credential {
+      credentialNames: Array<string>;
+
+      packageName: string;
+    }
+  }
 }
 
 export interface TaskGetStatusResponse {
   /**
    * The status of the task
    */
-  status: TaskStatus;
+  status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
+
+  /**
+   * Execution metadata for abnormal terminal outcomes
+   */
+  execution?: TaskGetStatusResponse.Execution | null;
 
   /**
    * The last agent response (FastAgentResponseEvent or ManagerPlanEvent)
@@ -349,6 +371,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
@@ -656,7 +703,19 @@ export namespace TaskGetTrajectoryResponse {
 
       code?: string | null;
 
-      usage?: TasksAPI.UsageResult | null;
+      usage?: Data.Usage | null;
+    }
+
+    export namespace Data {
+      export interface Usage {
+        request_tokens: number;
+
+        requests: number;
+
+        response_tokens: number;
+
+        total_tokens: number;
+      }
     }
   }
 
@@ -809,7 +868,19 @@ export namespace TaskGetTrajectoryResponse {
     export interface Data {
       response: string;
 
-      usage?: TasksAPI.UsageResult | null;
+      usage?: Data.Usage | null;
+    }
+
+    export namespace Data {
+      export interface Usage {
+        request_tokens: number;
+
+        requests: number;
+
+        response_tokens: number;
+
+        total_tokens: number;
+      }
     }
   }
 
@@ -879,7 +950,19 @@ export namespace TaskGetTrajectoryResponse {
     export interface Data {
       response: string;
 
-      usage?: TasksAPI.UsageResult | null;
+      usage?: Data.Usage | null;
+    }
+
+    export namespace Data {
+      export interface Usage {
+        request_tokens: number;
+
+        requests: number;
+
+        response_tokens: number;
+
+        total_tokens: number;
+      }
     }
   }
 
@@ -977,7 +1060,7 @@ export interface TaskRunResponse {
   /**
    * The status of the task (queued or created)
    */
-  status: TaskStatus;
+  status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
 
   /**
    * The URL of the stream (null when queued)
@@ -1002,6 +1085,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';
@@ -1015,65 +1108,124 @@ export interface TaskListParams {
    */
   query?: string | null;
 
-  status?: TaskStatus | null;
+  status?: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled' | null;
 }
 
 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;
 
-  credentials?: Array<PackageCredentials>;
+  /**
+   * Body param
+   */
+  credentials?: Array<TaskRunParams.Credential>;
 
   /**
-   * 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 namespace TaskRunParams {
+  export interface Credential {
+    credentialNames: Array<string>;
+
+    packageName: string;
+  }
 }
 
 export interface TaskRunStreamedParams {
@@ -1092,7 +1244,7 @@ export interface TaskRunStreamedParams {
 
   continueOnFailure?: boolean;
 
-  credentials?: Array<PackageCredentials>;
+  credentials?: Array<TaskRunStreamedParams.Credential>;
 
   /**
    * The display ID of the device to run the task on.
@@ -1104,8 +1256,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;
 
@@ -1134,6 +1285,14 @@ 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
@@ -1146,10 +1305,6 @@ 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,
@@ -1166,13 +1321,14 @@ export declare namespace Tasks {
 
   export {
     Screenshots as Screenshots,
-    type MediaResponse as MediaResponse,
+    type ScreenshotRetrieveResponse as ScreenshotRetrieveResponse,
     type ScreenshotListResponse as ScreenshotListResponse,
     type ScreenshotRetrieveParams as ScreenshotRetrieveParams,
   };
 
   export {
     UiStates as UiStates,
+    type UiStateRetrieveResponse as UiStateRetrieveResponse,
     type UiStateListResponse as UiStateListResponse,
     type UiStateRetrieveParams as UiStateRetrieveParams,
   };