@mobilerun/sdk 2.1.0 → 3.0.0

package/src/client.ts

@@ -11,13 +11,24 @@ import type { APIResponseProps } from './internal/parse';
 import { getPlatformHeaders } from './internal/detect-platform';
 import * as Shims from './internal/shims';
 import * as Opts from './internal/request-options';
-import * as qs from './internal/qs';
+import { stringifyQuery } from './internal/utils/query';
 import { VERSION } from './version';
 import * as Errors from './core/error';
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
+import { AgentListResponse, Agents } from './resources/agents';
 import { AppListParams, AppListResponse, Apps } from './resources/apps';
+import {
+  Carrier,
+  CarrierCreateParams,
+  CarrierDeleteResponse,
+  CarrierListParams,
+  CarrierListResponse,
+  CarrierLookupParams,
+  CarrierUpdateParams,
+  Carriers,
+} from './resources/carriers';
 import {
   HookGetSampleDataResponse,
   HookListParams,
@@ -33,6 +44,26 @@ import {
   Hooks,
 } from './resources/hooks';
 import { ModelListResponse, Models } from './resources/models';
+import {
+  Profile,
+  ProfileCreateParams,
+  ProfileDeleteResponse,
+  ProfileListParams,
+  ProfileListResponse,
+  ProfileUpdateParams,
+  Profiles,
+} from './resources/profiles';
+import {
+  Proxies,
+  ProxyConfig,
+  ProxyCreateParams,
+  ProxyCreateResponse,
+  ProxyDeleteResponse,
+  ProxyListResponse,
+  ProxyRetrieveResponse,
+  ProxyUpdateParams,
+  ProxyUpdateResponse,
+} from './resources/proxies';
 import {
   CredentialListParams,
   CredentialListResponse,
@@ -48,6 +79,7 @@ import {
   Devices,
 } from './resources/devices/devices';
 import {
+  PackageCredentials,
   Task,
   TaskGetStatusResponse,
   TaskGetTrajectoryResponse,
@@ -57,9 +89,13 @@ import {
   TaskRunParams,
   TaskRunResponse,
   TaskRunStreamedParams,
+  TaskRunStreamedResponse,
+  TaskSendMessageParams,
+  TaskSendMessageResponse,
   TaskStatus,
   TaskStopResponse,
   Tasks,
+  UsageResult,
 } from './resources/tasks/tasks';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
@@ -260,8 +296,8 @@ export class Mobilerun {
     return buildHeaders([{ Authorization: `Bearer ${this.apiKey}` }]);
   }
 
-  protected stringifyQuery(query: Record<string, unknown>): string {
-    return qs.stringify(query, { arrayFormat: 'comma' });
+  protected stringifyQuery(query: object | Record<string, unknown>): string {
+    return stringifyQuery(query);
   }
 
   private getUserAgent(): string {
@@ -293,12 +329,13 @@ export class Mobilerun {
       : new URL(baseURL + (baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
 
     const defaultQuery = this.defaultQuery();
-    if (!isEmptyObj(defaultQuery)) {
-      query = { ...defaultQuery, ...query };
+    const pathQuery = Object.fromEntries(url.searchParams);
+    if (!isEmptyObj(defaultQuery) || !isEmptyObj(pathQuery)) {
+      query = { ...pathQuery, ...defaultQuery, ...query };
     }
 
     if (typeof query === 'object' && query && !Array.isArray(query)) {
-      url.search = this.stringifyQuery(query as Record<string, unknown>);
+      url.search = this.stringifyQuery(query);
     }
 
     return url.toString();
@@ -603,9 +640,9 @@ export class Mobilerun {
       }
     }
 
-    // If the API asks us to wait a certain amount of time (and it's a reasonable amount),
-    // just do what it says, but otherwise calculate a default
-    if (!(timeoutMillis && 0 <= timeoutMillis && timeoutMillis < 60 * 1000)) {
+    // If the API asks us to wait a certain amount of time, just do what it
+    // says, but otherwise calculate a default
+    if (timeoutMillis === undefined) {
       const maxRetries = options.maxRetries ?? this.maxRetries;
       timeoutMillis = this.calculateDefaultRetryTimeoutMillis(retriesRemaining, maxRetries);
     }
@@ -737,7 +774,7 @@ export class Mobilerun {
     ) {
       return {
         bodyHeaders: { 'content-type': 'application/x-www-form-urlencoded' },
-        body: this.stringifyQuery(body as Record<string, unknown>),
+        body: this.stringifyQuery(body),
       };
     } else {
       return this.#encoder({ body, headers });
@@ -763,15 +800,32 @@ export class Mobilerun {
 
   static toFile = Uploads.toFile;
 
+  /**
+   * Tasks API
+   */
   tasks: API.Tasks = new API.Tasks(this);
+  /**
+   * Agents API
+   */
+  agents: API.Agents = new API.Agents(this);
+  proxies: API.Proxies = new API.Proxies(this);
+  carriers: API.Carriers = new API.Carriers(this);
+  profiles: API.Profiles = new API.Profiles(this);
   devices: API.Devices = new API.Devices(this);
   apps: API.Apps = new API.Apps(this);
   credentials: API.Credentials = new API.Credentials(this);
+  /**
+   * Webhooks API
+   */
   hooks: API.Hooks = new API.Hooks(this);
   models: API.Models = new API.Models(this);
 }
 
 Mobilerun.Tasks = Tasks;
+Mobilerun.Agents = Agents;
+Mobilerun.Proxies = Proxies;
+Mobilerun.Carriers = Carriers;
+Mobilerun.Profiles = Profiles;
 Mobilerun.Devices = Devices;
 Mobilerun.Apps = Apps;
 Mobilerun.Credentials = Credentials;
@@ -783,17 +837,57 @@ export declare namespace Mobilerun {
 
   export {
     Tasks as Tasks,
+    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,
     type TaskGetTrajectoryResponse as TaskGetTrajectoryResponse,
     type TaskRunResponse as TaskRunResponse,
+    type TaskRunStreamedResponse as TaskRunStreamedResponse,
+    type TaskSendMessageResponse as TaskSendMessageResponse,
     type TaskStopResponse as TaskStopResponse,
     type TaskListParams as TaskListParams,
     type TaskRunParams as TaskRunParams,
     type TaskRunStreamedParams as TaskRunStreamedParams,
+    type TaskSendMessageParams as TaskSendMessageParams,
+  };
+
+  export { Agents as Agents, type AgentListResponse as AgentListResponse };
+
+  export {
+    Proxies as Proxies,
+    type ProxyConfig as ProxyConfig,
+    type ProxyCreateResponse as ProxyCreateResponse,
+    type ProxyRetrieveResponse as ProxyRetrieveResponse,
+    type ProxyUpdateResponse as ProxyUpdateResponse,
+    type ProxyListResponse as ProxyListResponse,
+    type ProxyDeleteResponse as ProxyDeleteResponse,
+    type ProxyCreateParams as ProxyCreateParams,
+    type ProxyUpdateParams as ProxyUpdateParams,
+  };
+
+  export {
+    Carriers as Carriers,
+    type Carrier as Carrier,
+    type CarrierListResponse as CarrierListResponse,
+    type CarrierDeleteResponse as CarrierDeleteResponse,
+    type CarrierCreateParams as CarrierCreateParams,
+    type CarrierUpdateParams as CarrierUpdateParams,
+    type CarrierListParams as CarrierListParams,
+    type CarrierLookupParams as CarrierLookupParams,
+  };
+
+  export {
+    Profiles as Profiles,
+    type Profile as Profile,
+    type ProfileListResponse as ProfileListResponse,
+    type ProfileDeleteResponse as ProfileDeleteResponse,
+    type ProfileCreateParams as ProfileCreateParams,
+    type ProfileUpdateParams as ProfileUpdateParams,
+    type ProfileListParams as ProfileListParams,
   };
 
   export {
@@ -830,4 +924,13 @@ 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;
+  export type Meta = API.Meta;
+  export type Pagination = API.Pagination;
+  export type PaginationMeta = API.PaginationMeta;
+  export type PermissionSet = API.PermissionSet;
 }

package/src/internal/utils/query.ts

@@ -0,0 +1,7 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import * as qs from '../qs/stringify';
+
+export function stringifyQuery(query: object | Record<string, unknown>) {
+  return qs.stringify(query, { arrayFormat: 'comma' });
+}

package/src/internal/utils.ts

@@ -6,3 +6,4 @@ export * from './utils/env';
 export * from './utils/log';
 export * from './utils/uuid';
 export * from './utils/sleep';
+export * from './utils/query';

package/src/resources/agents.ts

@@ -0,0 +1,43 @@
+// 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 { RequestOptions } from '../internal/request-options';
+
+/**
+ * Agents API
+ */
+export class Agents extends APIResource {
+  /**
+   * List all available agents with their default configurations.
+   */
+  list(options?: RequestOptions): APIPromise<AgentListResponse> {
+    return this._client.get('/agents', options);
+  }
+}
+
+export type AgentListResponse = Array<AgentListResponse.AgentListResponseItem>;
+
+export namespace AgentListResponse {
+  export interface AgentListResponseItem {
+    id: number;
+
+    description: string | null;
+
+    icon: string;
+
+    llmModel: string;
+
+    maxSteps: number;
+
+    name: string;
+
+    reasoning: boolean;
+
+    vision: boolean;
+  }
+}
+
+export declare namespace Agents {
+  export { type AgentListResponse as AgentListResponse };
+}

package/src/resources/apps.ts

@@ -1,6 +1,7 @@
 // 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';
 
@@ -18,7 +19,7 @@ export interface AppListResponse {
 
   items: Array<AppListResponse.Item>;
 
-  pagination: AppListResponse.Pagination;
+  pagination: Shared.Pagination;
 }
 
 export namespace AppListResponse {
@@ -291,8 +292,7 @@ export namespace AppListResponse {
       | 'YE'
       | 'ZM'
       | 'ZW'
-      | 'AX'
-      | null;
+      | 'AX';
 
     createdAt: string | null;
 
@@ -302,7 +302,7 @@ export namespace AppListResponse {
 
     displayName: string;
 
-    externalIds: Array<string> | null;
+    expectedFiles: string | number | boolean | { [key: string]: unknown } | Array<unknown> | null;
 
     iconURL: string;
 
@@ -320,30 +320,22 @@ export namespace AppListResponse {
 
     source: 'uploaded' | 'store';
 
+    status: 'queued' | 'available' | 'failed';
+
+    stealthTier: 'tier1' | 'tier2' | 'tier3' | null;
+
     targetSdk: number | null;
 
+    type: 'android' | 'ios';
+
     updatedAt: string | null;
 
     userId: string | null;
 
-    versionCode: number | null;
+    versionCode: number;
 
     versionName: string;
   }
-
-  export interface Pagination {
-    hasNext: boolean;
-
-    hasPrev: boolean;
-
-    page: number;
-
-    pages: number;
-
-    pageSize: number;
-
-    total: number;
-  }
 }
 
 export interface AppListParams {

package/src/resources/carriers.ts

@@ -0,0 +1,327 @@
+// 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 Carriers extends APIResource {
+  /**
+   * Create a new carrier
+   */
+  create(body: CarrierCreateParams, options?: RequestOptions): APIPromise<Carrier> {
+    return this._client.post('/carriers', { body, ...options });
+  }
+
+  /**
+   * Get carrier by ID
+   */
+  retrieve(carrierID: number, options?: RequestOptions): APIPromise<Carrier> {
+    return this._client.get(path`/carriers/${carrierID}`, options);
+  }
+
+  /**
+   * Update a carrier
+   */
+  update(carrierID: number, body: CarrierUpdateParams, options?: RequestOptions): APIPromise<Carrier> {
+    return this._client.patch(path`/carriers/${carrierID}`, { body, ...options });
+  }
+
+  /**
+   * List carriers with pagination
+   */
+  list(
+    query: CarrierListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<CarrierListResponse> {
+    return this._client.get('/carriers', { query, ...options });
+  }
+
+  /**
+   * Delete a carrier
+   */
+  delete(carrierID: number, options?: RequestOptions): APIPromise<CarrierDeleteResponse> {
+    return this._client.delete(path`/carriers/${carrierID}`, options);
+  }
+
+  /**
+   * Get carrier by MCC and MNC
+   */
+  lookup(query: CarrierLookupParams, options?: RequestOptions): APIPromise<Carrier> {
+    return this._client.get('/carriers/lookup', { query, ...options });
+  }
+}
+
+export interface Carrier {
+  id: number;
+
+  company: string;
+
+  country: string;
+
+  country_code: string;
+
+  country_iso: string;
+
+  created_at: string;
+
+  detail_url: string;
+
+  gsm_bands: string;
+
+  lte_bands: string;
+
+  mcc: string;
+
+  mnc: string;
+
+  mobile_prefix: string;
+
+  nsn_size: string;
+
+  number_format: string;
+
+  operator: string;
+
+  protocols: string;
+
+  umts_bands: string;
+
+  website: string;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export interface CarrierListResponse {
+  items: Array<Carrier> | null;
+
+  pagination: Shared.Meta;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export interface CarrierDeleteResponse {
+  message: string;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export interface CarrierCreateParams {
+  /**
+   * Country name
+   */
+  country: string;
+
+  /**
+   * Mobile Country Code
+   */
+  mcc: string;
+
+  /**
+   * Mobile Network Code
+   */
+  mnc: string;
+
+  /**
+   * Operator name
+   */
+  operator: string;
+
+  /**
+   * Company name
+   */
+  company?: string;
+
+  /**
+   * Country dialing code (e.g., +1)
+   */
+  country_code?: string;
+
+  /**
+   * ISO country code
+   */
+  country_iso?: string;
+
+  /**
+   * URL to carrier details page
+   */
+  detail_url?: string;
+
+  /**
+   * Supported GSM bands
+   */
+  gsm_bands?: string;
+
+  /**
+   * Supported LTE bands
+   */
+  lte_bands?: string;
+
+  /**
+   * Mobile number prefix
+   */
+  mobile_prefix?: string;
+
+  /**
+   * National Significant Number size
+   */
+  nsn_size?: string;
+
+  /**
+   * Phone number format
+   */
+  number_format?: string;
+
+  /**
+   * Supported protocols (comma-separated)
+   */
+  protocols?: string;
+
+  /**
+   * Supported UMTS bands
+   */
+  umts_bands?: string;
+
+  /**
+   * Company website
+   */
+  website?: string;
+}
+
+export interface CarrierUpdateParams {
+  /**
+   * Company name
+   */
+  company?: string;
+
+  /**
+   * Country name
+   */
+  country?: string;
+
+  /**
+   * Country dialing code
+   */
+  country_code?: string;
+
+  /**
+   * ISO country code
+   */
+  country_iso?: string;
+
+  /**
+   * URL to carrier details
+   */
+  detail_url?: string;
+
+  /**
+   * Supported GSM bands
+   */
+  gsm_bands?: string;
+
+  /**
+   * Supported LTE bands
+   */
+  lte_bands?: string;
+
+  /**
+   * Mobile number prefix
+   */
+  mobile_prefix?: string;
+
+  /**
+   * NSN size
+   */
+  nsn_size?: string;
+
+  /**
+   * Phone number format
+   */
+  number_format?: string;
+
+  /**
+   * Operator name
+   */
+  operator?: string;
+
+  /**
+   * Supported protocols
+   */
+  protocols?: string;
+
+  /**
+   * Supported UMTS bands
+   */
+  umts_bands?: string;
+
+  /**
+   * Company website
+   */
+  website?: string;
+}
+
+export interface CarrierListParams {
+  /**
+   * Filter by country name
+   */
+  country?: string;
+
+  /**
+   * Filter by country ISO code
+   */
+  countryISO?: string;
+
+  /**
+   * Field to order by
+   */
+  orderBy?: 'id' | 'mcc' | 'mnc' | 'operator' | 'country' | 'country_iso';
+
+  /**
+   * Order direction
+   */
+  orderDir?: 'asc' | 'desc';
+
+  /**
+   * Page number
+   */
+  page?: number;
+
+  /**
+   * Items per page
+   */
+  pageSize?: number;
+}
+
+export interface CarrierLookupParams {
+  /**
+   * Mobile Country Code
+   */
+  mcc: string;
+
+  /**
+   * Mobile Network Code
+   */
+  mnc: string;
+}
+
+export declare namespace Carriers {
+  export {
+    type Carrier as Carrier,
+    type CarrierListResponse as CarrierListResponse,
+    type CarrierDeleteResponse as CarrierDeleteResponse,
+    type CarrierCreateParams as CarrierCreateParams,
+    type CarrierUpdateParams as CarrierUpdateParams,
+    type CarrierListParams as CarrierListParams,
+    type CarrierLookupParams as CarrierLookupParams,
+  };
+}