@mobilerun/sdk 3.0.0 → 4.0.0

package/src/client.ts

@@ -59,6 +59,7 @@ import {
   ProxyCreateParams,
   ProxyCreateResponse,
   ProxyDeleteResponse,
+  ProxyListParams,
   ProxyListResponse,
   ProxyRetrieveResponse,
   ProxyUpdateParams,
@@ -75,6 +76,7 @@ import {
   DeviceCreateParams,
   DeviceListParams,
   DeviceListResponse,
+  DeviceSetNameParams,
   DeviceTerminateParams,
   Devices,
 } from './resources/devices/devices';
@@ -867,6 +869,7 @@ export declare namespace Mobilerun {
     type ProxyDeleteResponse as ProxyDeleteResponse,
     type ProxyCreateParams as ProxyCreateParams,
     type ProxyUpdateParams as ProxyUpdateParams,
+    type ProxyListParams as ProxyListParams,
   };
 
   export {
@@ -897,6 +900,7 @@ export declare namespace Mobilerun {
     type DeviceCountResponse as DeviceCountResponse,
     type DeviceCreateParams as DeviceCreateParams,
     type DeviceListParams as DeviceListParams,
+    type DeviceSetNameParams as DeviceSetNameParams,
     type DeviceTerminateParams as DeviceTerminateParams,
   };
 
@@ -925,7 +929,6 @@ export declare namespace Mobilerun {
 
   export { Models as Models, type ModelListResponse as ModelListResponse };
 
-  export type Config = API.Config;
   export type DeviceCarrier = API.DeviceCarrier;
   export type DeviceIdentifiers = API.DeviceIdentifiers;
   export type DeviceSpec = API.DeviceSpec;

package/src/internal/utils/env.ts

@@ -9,10 +9,10 @@
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof (globalThis as any).process !== 'undefined') {
-    return (globalThis as any).process.env?.[env]?.trim() ?? undefined;
+    return (globalThis as any).process.env?.[env]?.trim() || undefined;
   }
   if (typeof (globalThis as any).Deno !== 'undefined') {
-    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+    return (globalThis as any).Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };

package/src/resources/agents.ts

@@ -34,6 +34,8 @@ export namespace AgentListResponse {
 
     reasoning: boolean;
 
+    subagentModel: string | null;
+
     vision: boolean;
   }
 }

package/src/resources/devices/devices.ts

@@ -22,6 +22,16 @@ import {
   AppUpdateParams,
   Apps,
 } from './apps';
+import * as EsimAPI from './esim';
+import {
+  Esim,
+  EsimActivateParams,
+  EsimActivateResponse,
+  EsimEnableParams,
+  EsimListParams,
+  EsimListResponse,
+  EsimRemoveParams,
+} from './esim';
 import * as FilesAPI from './files';
 import {
   FileDeleteParams,
@@ -42,7 +52,13 @@ import { PackageListParams, PackageListResponse, Packages } from './packages';
 import * as ProfileAPI from './profile';
 import { Profile, ProfileUpdateParams } from './profile';
 import * as ProxyAPI from './proxy';
-import { Proxy, ProxyConnectParams, ProxyDisconnectParams } from './proxy';
+import {
+  Proxy as ProxyAPIProxy,
+  ProxyConnectParams,
+  ProxyDisconnectParams,
+  ProxyStatusParams,
+  ProxyStatusResponse,
+} from './proxy';
 import * as StateAPI from './state';
 import {
   Rect,
@@ -57,7 +73,6 @@ import { TaskListParams, TaskListResponse, Tasks } from './tasks';
 import * as TimeAPI from './time';
 import {
   Time,
-  TimeSetTimeParams,
   TimeSetTimezoneParams,
   TimeTimeParams,
   TimeTimeResponse,
@@ -81,6 +96,7 @@ export class Devices extends APIResource {
   packages: PackagesAPI.Packages = new PackagesAPI.Packages(this._client);
   keyboard: KeyboardAPI.Keyboard = new KeyboardAPI.Keyboard(this._client);
   tasks: TasksAPI.Tasks = new TasksAPI.Tasks(this._client);
+  esim: EsimAPI.Esim = new EsimAPI.Esim(this._client);
 
   /**
    * Provision a new device
@@ -114,6 +130,13 @@ export class Devices extends APIResource {
     return this._client.get('/devices/count', options);
   }
 
+  /**
+   * Update device name
+   */
+  setName(deviceID: string, body: DeviceSetNameParams, options?: RequestOptions): APIPromise<Device> {
+    return this._client.put(path`/devices/${deviceID}/name`, { body, ...options });
+  }
+
   /**
    * Terminate a device
    */
@@ -136,6 +159,8 @@ export class Devices extends APIResource {
 export interface Device {
   id: string;
 
+  activeTaskId: string;
+
   assignedAt: string | null;
 
   createdAt: string;
@@ -161,6 +186,8 @@ export interface Device {
    */
   $schema?: string;
 
+  providerId?: string;
+
   streamToken?: string;
 
   userId?: string;
@@ -183,7 +210,11 @@ export interface DeviceCreateParams {
   /**
    * Query param
    */
-  deviceType?: 'dedicated_physical_device' | 'dedicated_premium_device' | 'dedicated_emulated_device';
+  deviceType?:
+    | 'dedicated_physical_device'
+    | 'dedicated_premium_device'
+    | 'dedicated_emulated_device'
+    | 'dedicated_ios_device';
 
   /**
    * Body param
@@ -213,12 +244,31 @@ export interface DeviceCreateParams {
   /**
    * Body param
    */
-  proxy?: Shared.Config;
+  proxy?: DeviceCreateParams.Proxy;
+}
 
-  /**
-   * Body param
-   */
-  smartIp?: boolean;
+export namespace DeviceCreateParams {
+  export interface Proxy {
+    name?: string;
+
+    smartIp?: boolean;
+
+    socks5?: Proxy.Socks5;
+
+    wireguard?: string;
+  }
+
+  export namespace Proxy {
+    export interface Socks5 {
+      host: string;
+
+      password: string;
+
+      port: number;
+
+      user: string;
+    }
+  }
 }
 
 export interface DeviceListParams {
@@ -234,9 +284,21 @@ export interface DeviceListParams {
 
   pageSize?: number;
 
-  state?: Array<'creating' | 'assigned' | 'ready' | 'disconnected' | 'terminated' | 'unknown'> | null;
+  providerId?: string;
 
-  type?: 'dedicated_physical_device' | 'dedicated_premium_device' | 'dedicated_emulated_device';
+  state?: Array<
+    'creating' | 'assigned' | 'ready' | 'rebooting' | 'migrating' | 'terminated' | 'maintenance' | 'unknown'
+  > | null;
+
+  type?:
+    | 'dedicated_physical_device'
+    | 'dedicated_premium_device'
+    | 'dedicated_emulated_device'
+    | 'dedicated_ios_device';
+}
+
+export interface DeviceSetNameParams {
+  name: string;
 }
 
 export interface DeviceTerminateParams {
@@ -248,7 +310,7 @@ export interface DeviceTerminateParams {
 Devices.Time = Time;
 Devices.Profile = Profile;
 Devices.Files = Files;
-Devices.Proxy = Proxy;
+Devices.Proxy = ProxyAPIProxy;
 Devices.Location = Location;
 Devices.Actions = Actions;
 Devices.State = State;
@@ -256,6 +318,7 @@ Devices.Apps = Apps;
 Devices.Packages = Packages;
 Devices.Keyboard = Keyboard;
 Devices.Tasks = Tasks;
+Devices.Esim = Esim;
 
 export declare namespace Devices {
   export {
@@ -264,6 +327,7 @@ export declare namespace Devices {
     type DeviceCountResponse as DeviceCountResponse,
     type DeviceCreateParams as DeviceCreateParams,
     type DeviceListParams as DeviceListParams,
+    type DeviceSetNameParams as DeviceSetNameParams,
     type DeviceTerminateParams as DeviceTerminateParams,
   };
 
@@ -271,7 +335,6 @@ export declare namespace Devices {
     Time as Time,
     type TimeTimeResponse as TimeTimeResponse,
     type TimeTimezoneResponse as TimeTimezoneResponse,
-    type TimeSetTimeParams as TimeSetTimeParams,
     type TimeSetTimezoneParams as TimeSetTimezoneParams,
     type TimeTimeParams as TimeTimeParams,
     type TimeTimezoneParams as TimeTimezoneParams,
@@ -291,9 +354,11 @@ export declare namespace Devices {
   };
 
   export {
-    Proxy as Proxy,
+    ProxyAPIProxy as Proxy,
+    type ProxyStatusResponse as ProxyStatusResponse,
     type ProxyConnectParams as ProxyConnectParams,
     type ProxyDisconnectParams as ProxyDisconnectParams,
+    type ProxyStatusParams as ProxyStatusParams,
   };
 
   export {
@@ -346,4 +411,14 @@ export declare namespace Devices {
   };
 
   export { Tasks as Tasks, type TaskListResponse as TaskListResponse, type TaskListParams as TaskListParams };
+
+  export {
+    Esim as Esim,
+    type EsimListResponse as EsimListResponse,
+    type EsimActivateResponse as EsimActivateResponse,
+    type EsimListParams as EsimListParams,
+    type EsimActivateParams as EsimActivateParams,
+    type EsimEnableParams as EsimEnableParams,
+    type EsimRemoveParams as EsimRemoveParams,
+  };
 }

package/src/resources/devices/esim.ts

@@ -0,0 +1,201 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Esim extends APIResource {
+  /**
+   * List eSIM subscriptions
+   */
+  list(
+    deviceID: string,
+    params: EsimListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<EsimListResponse | null> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
+    return this._client.get(path`/devices/${deviceID}/esim`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Configure eSIM (download profile and/or enable subscription)
+   */
+  activate(
+    deviceID: string,
+    params: EsimActivateParams,
+    options?: RequestOptions,
+  ): APIPromise<EsimActivateResponse> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;
+    return this._client.post(path`/devices/${deviceID}/esim`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Enable an eSIM subscription
+   */
+  enable(deviceID: string, params: EsimEnableParams, options?: RequestOptions): APIPromise<void> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;
+    return this._client.put(path`/devices/${deviceID}/esim`, {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * Delete eSIM subscription
+   */
+  remove(deviceID: string, params: EsimRemoveParams, options?: RequestOptions): APIPromise<void> {
+    const { subId, 'X-Device-Display-ID': xDeviceDisplayID } = params;
+    return this._client.delete(path`/devices/${deviceID}/esim`, {
+      query: { subId },
+      ...options,
+      headers: buildHeaders([
+        {
+          Accept: '*/*',
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export type EsimListResponse = Array<EsimListResponse.EsimListResponseItem>;
+
+export namespace EsimListResponse {
+  export interface EsimListResponseItem {
+    carrier: string;
+
+    displayName: string;
+
+    iccid: string;
+
+    isEmbedded: boolean;
+
+    slot: number;
+
+    subId: number;
+
+    type: string;
+
+    /**
+     * A URL to the JSON Schema for this object.
+     */
+    $schema?: string;
+  }
+}
+
+export interface EsimActivateResponse {
+  carrier: string;
+
+  displayName: string;
+
+  iccid: string;
+
+  isEmbedded: boolean;
+
+  slot: number;
+
+  subId: number;
+
+  type: string;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export interface EsimListParams {
+  'X-Device-Display-ID'?: number;
+}
+
+export interface EsimActivateParams {
+  /**
+   * Body param
+   */
+  enable: boolean;
+
+  /**
+   * Body param
+   */
+  matchingId: string;
+
+  /**
+   * Body param
+   */
+  smDpAddr: string;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
+export interface EsimEnableParams {
+  /**
+   * Body param
+   */
+  subId: number;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
+export interface EsimRemoveParams {
+  /**
+   * Query param
+   */
+  subId: number;
+
+  /**
+   * Header param
+   */
+  'X-Device-Display-ID'?: number;
+}
+
+export declare namespace Esim {
+  export {
+    type EsimListResponse as EsimListResponse,
+    type EsimActivateResponse as EsimActivateResponse,
+    type EsimListParams as EsimListParams,
+    type EsimActivateParams as EsimActivateParams,
+    type EsimEnableParams as EsimEnableParams,
+    type EsimRemoveParams as EsimRemoveParams,
+  };
+}

package/src/resources/devices/index.ts

@@ -25,8 +25,18 @@ export {
   type DeviceCountResponse,
   type DeviceCreateParams,
   type DeviceListParams,
+  type DeviceSetNameParams,
   type DeviceTerminateParams,
 } from './devices';
+export {
+  Esim,
+  type EsimListResponse,
+  type EsimActivateResponse,
+  type EsimListParams,
+  type EsimActivateParams,
+  type EsimEnableParams,
+  type EsimRemoveParams,
+} from './esim';
 export {
   Files,
   type FileInfo,
@@ -51,7 +61,13 @@ export {
 } from './location';
 export { Packages, type PackageListResponse, type PackageListParams } from './packages';
 export { Profile, type ProfileUpdateParams } from './profile';
-export { Proxy, type ProxyConnectParams, type ProxyDisconnectParams } from './proxy';
+export {
+  Proxy,
+  type ProxyStatusResponse,
+  type ProxyConnectParams,
+  type ProxyDisconnectParams,
+  type ProxyStatusParams,
+} from './proxy';
 export {
   State,
   type Rect,
@@ -65,7 +81,6 @@ export {
   Time,
   type TimeTimeResponse,
   type TimeTimezoneResponse,
-  type TimeSetTimeParams,
   type TimeSetTimezoneParams,
   type TimeTimeParams,
   type TimeTimezoneParams,

package/src/resources/devices/proxy.ts

@@ -49,6 +49,47 @@ export class Proxy extends APIResource {
       ]),
     });
   }
+
+  /**
+   * Get proxy connection state
+   */
+  status(
+    deviceID: string,
+    params: ProxyStatusParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ProxyStatusResponse> {
+    const { 'X-Device-Display-ID': xDeviceDisplayID } = params ?? {};
+    return this._client.get(path`/devices/${deviceID}/proxy`, {
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(xDeviceDisplayID?.toString() != null ?
+            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface ProxyStatusResponse {
+  connected: boolean;
+
+  /**
+   * Active proxy name
+   */
+  name: string | null;
+
+  /**
+   * Active proxy protocol (socks5 or wireguard).
+   */
+  protocol: string | null;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
 }
 
 export interface ProxyConnectParams {
@@ -57,6 +98,11 @@ export interface ProxyConnectParams {
    */
   host?: string;
 
+  /**
+   * Body param: Proxy name (used for wireguard tunnel name)
+   */
+  name?: string;
+
   /**
    * @deprecated Body param
    */
@@ -68,20 +114,26 @@ export interface ProxyConnectParams {
   port?: number;
 
   /**
-   * Body param: Preferred new format.
+   * Body param
    */
-  proxy?: ProxyConnectParams.Proxy;
+  smartIp?: boolean;
 
   /**
-   * Body param
+   * Body param: SOCKS5 proxy configuration (required for socks5).
    */
-  smartIp?: boolean;
+  socks5?: ProxyConnectParams.Socks5;
 
   /**
    * @deprecated Body param
    */
   user?: string;
 
+  /**
+   * Body param: WireGuard tunnel configuration file content (required for
+   * wireguard).
+   */
+  wireguard?: string;
+
   /**
    * Header param
    */
@@ -90,16 +142,16 @@ export interface ProxyConnectParams {
 
 export namespace ProxyConnectParams {
   /**
-   * Preferred new format.
+   * SOCKS5 proxy configuration (required for socks5).
    */
-  export interface Proxy {
+  export interface Socks5 {
     host: string;
 
-    password: string;
-
     port: number;
 
-    user: string;
+    password?: string;
+
+    user?: string;
   }
 }
 
@@ -107,9 +159,15 @@ export interface ProxyDisconnectParams {
   'X-Device-Display-ID'?: number;
 }
 
+export interface ProxyStatusParams {
+  'X-Device-Display-ID'?: number;
+}
+
 export declare namespace Proxy {
   export {
+    type ProxyStatusResponse as ProxyStatusResponse,
     type ProxyConnectParams as ProxyConnectParams,
     type ProxyDisconnectParams as ProxyDisconnectParams,
+    type ProxyStatusParams as ProxyStatusParams,
   };
 }

package/src/resources/devices/time.ts

@@ -7,26 +7,6 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Time extends APIResource {
-  /**
-   * Set device time
-   */
-  setTime(deviceID: string, params: TimeSetTimeParams, options?: RequestOptions): APIPromise<void> {
-    const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;
-    return this._client.post(path`/devices/${deviceID}/time`, {
-      body,
-      ...options,
-      headers: buildHeaders([
-        {
-          Accept: '*/*',
-          ...(xDeviceDisplayID?.toString() != null ?
-            { 'X-Device-Display-ID': xDeviceDisplayID?.toString() }
-          : undefined),
-        },
-        options?.headers,
-      ]),
-    });
-  }
-
   /**
    * Set device timezone
    */
@@ -95,7 +75,7 @@ export class Time extends APIResource {
 export type TimeTimeResponse = string;
 
 export interface TimeTimezoneResponse {
-  timezone: string;
+  timezone: string | null;
 
   /**
    * A URL to the JSON Schema for this object.
@@ -103,18 +83,6 @@ export interface TimeTimezoneResponse {
   $schema?: string;
 }
 
-export interface TimeSetTimeParams {
-  /**
-   * Body param
-   */
-  time: string;
-
-  /**
-   * Header param
-   */
-  'X-Device-Display-ID'?: number;
-}
-
 export interface TimeSetTimezoneParams {
   /**
    * Body param
@@ -139,7 +107,6 @@ export declare namespace Time {
   export {
     type TimeTimeResponse as TimeTimeResponse,
     type TimeTimezoneResponse as TimeTimezoneResponse,
-    type TimeSetTimeParams as TimeSetTimeParams,
     type TimeSetTimezoneParams as TimeSetTimezoneParams,
     type TimeTimeParams as TimeTimeParams,
     type TimeTimezoneParams as TimeTimezoneParams,