@mobilerun/sdk 5.2.0 → 5.3.0

package/src/resources/esims/index.ts

@@ -0,0 +1,28 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Esims,
+  type EsimCreateResponse,
+  type EsimRetrieveResponse,
+  type EsimUpdateResponse,
+  type EsimListResponse,
+  type EsimCapacityResponse,
+  type EsimConfirmPaymentResponse,
+  type EsimImportResponse,
+  type EsimInstallResponse,
+  type EsimInstallStatusResponse,
+  type EsimSelectorResponse,
+  type EsimCreateParams,
+  type EsimUpdateParams,
+  type EsimListParams,
+  type EsimImportParams,
+  type EsimInstallParams,
+  type EsimSelectorParams,
+} from './esims';
+export {
+  Messages,
+  type MessageListResponse,
+  type MessageSendResponse,
+  type MessageListParams,
+  type MessageSendParams,
+} from './messages';

package/src/resources/esims/messages.ts

@@ -0,0 +1,187 @@
+// 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 Messages extends APIResource {
+  /**
+   * List messages for one eSIM
+   *
+   * @example
+   * ```ts
+   * const messages = await client.esims.messages.list(
+   *   '550e8400-e29b-41d4-a716-446655440000',
+   * );
+   * ```
+   */
+  list(
+    id: string,
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MessageListResponse> {
+    return this._client.get(path`/numbers/esims/${id}/messages`, { query, ...options });
+  }
+
+  /**
+   * Send an SMS through one eSIM
+   *
+   * @example
+   * ```ts
+   * const response = await client.esims.messages.send(
+   *   '550e8400-e29b-41d4-a716-446655440000',
+   *   { body: 'x', to: '+15551230001' },
+   * );
+   * ```
+   */
+  send(id: string, body: MessageSendParams, options?: RequestOptions): APIPromise<MessageSendResponse> {
+    return this._client.post(path`/numbers/esims/${id}/messages`, { body, ...options });
+  }
+}
+
+export interface MessageListResponse {
+  items: Array<MessageListResponse.Item>;
+
+  pagination: Shared.Pagination;
+}
+
+export namespace MessageListResponse {
+  export interface Item {
+    id: string;
+
+    body: string | null;
+
+    createdAt: string;
+
+    deliveryStatus: string | null;
+
+    detectedSender: string | null;
+
+    direction: 'inbound' | 'outbound';
+
+    esimId: string | null;
+
+    occurredAt: string;
+
+    peerKey: string | null;
+
+    peerNumber: string | null;
+
+    providerCode: string | null;
+
+    status:
+      | 'received'
+      | 'queued'
+      | 'claimed'
+      | 'sending'
+      | 'sent'
+      | 'sent_unconfirmed'
+      | 'delivered'
+      | 'failed';
+  }
+}
+
+export interface MessageSendResponse {
+  data: MessageSendResponse.Data;
+}
+
+export namespace MessageSendResponse {
+  export interface Data {
+    id: string;
+
+    body: string | null;
+
+    createdAt: string;
+
+    deliveryStatus: string | null;
+
+    detectedSender: string | null;
+
+    direction: 'inbound' | 'outbound';
+
+    esimId: string | null;
+
+    occurredAt: string;
+
+    peerKey: string | null;
+
+    peerNumber: string | null;
+
+    providerCode: string | null;
+
+    status:
+      | 'received'
+      | 'queued'
+      | 'claimed'
+      | 'sending'
+      | 'sent'
+      | 'sent_unconfirmed'
+      | 'delivered'
+      | 'failed';
+  }
+}
+
+export interface MessageListParams {
+  direction?: 'all' | 'inbound' | 'outbound';
+
+  numberId?: string;
+
+  page?: number;
+
+  pageSize?: number;
+
+  peerKey?: string;
+
+  peerNumber?: string;
+
+  status?:
+    | 'all'
+    | 'received'
+    | 'queued'
+    | 'claimed'
+    | 'sending'
+    | 'sent'
+    | 'sent_unconfirmed'
+    | 'delivered'
+    | 'failed';
+}
+
+export interface MessageSendParams {
+  /**
+   * SMS body text (max 320 chars — smaller than the admin tier's cap; see the
+   * schema's own doc comment for why)
+   */
+  body: string;
+
+  /**
+   * Recipient phone number — normalized to E.164 (spaces/dashes/dots stripped);
+   * rejected with 400 if it doesn't validate as E.164 afterward.
+   */
+  to: string;
+
+  /**
+   * Client-supplied idempotency key, scoped to (owner, esimId, key). Replaying the
+   * same key + identical payload returns the original send; the same key with a
+   * DIFFERENT payload is a 409 conflict.
+   */
+  clientRequestId?: string;
+
+  /**
+   * Wait for physedge to confirm carrier delivery before completing the send (adds
+   * executor-side latency, never on this request — sends are always async/202).
+   * Defaults to false for the public tier (opt-in, unlike the admin tier's
+   * default-true).
+   */
+  deliveryReport?: boolean;
+}
+
+export declare namespace Messages {
+  export {
+    type MessageListResponse as MessageListResponse,
+    type MessageSendResponse as MessageSendResponse,
+    type MessageListParams as MessageListParams,
+    type MessageSendParams as MessageSendParams,
+  };
+}

package/src/resources/esims.ts

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

package/src/resources/files.ts

@@ -0,0 +1,225 @@
+// 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 Files extends APIResource {
+  /**
+   * Partial update of `displayName` and/or `enabled`. Only files with `zone=skills`
+   * are mutable; other zones return 422 `unsupported_zone`.
+   */
+  update(
+    fileID: string,
+    body: FileUpdateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<FileUpdateResponse> {
+    return this._client.patch(path`/agents/files/${fileID}`, { body, ...options });
+  }
+
+  /**
+   * List the user's ready files, optionally filtered by zone
+   */
+  list(
+    query: FileListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<FileListResponse> {
+    return this._client.get('/agents/files', { query, ...options });
+  }
+
+  /**
+   * Hard-delete a file
+   */
+  delete(fileID: string, options?: RequestOptions): APIPromise<FileDeleteResponse> {
+    return this._client.delete(path`/agents/files/${fileID}`, options);
+  }
+
+  /**
+   * Soft-cancels an in-flight upload before confirm. Only acts on `pending` rows —
+   * refuses to touch `ready` to avoid wiping confirmed files. Idempotent:
+   * `{ cancelled: false }` if the row exists but is no longer pending.
+   */
+  cancelPending(fileID: string, options?: RequestOptions): APIPromise<FileCancelPendingResponse> {
+    return this._client.delete(path`/agents/files/${fileID}/pending`, options);
+  }
+
+  /**
+   * Confirm a file upload by server-side HEAD validation
+   */
+  confirm(fileID: string, options?: RequestOptions): APIPromise<FileConfirmResponse> {
+    return this._client.post(path`/agents/files/${fileID}/confirm`, options);
+  }
+
+  /**
+   * Redirects to a short-lived presigned download URL. Missing, non-ready, and files
+   * owned by another tenant all return the same 404 response.
+   */
+  download(fileID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.get(path`/agents/files/${fileID}/download`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Mint a presigned PUT URL for a user file upload
+   */
+  uploadURL(params: FileUploadURLParams, options?: RequestOptions): APIPromise<FileUploadURLResponse> {
+    const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+    return this._client.post('/agents/files/upload-url', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+}
+
+export interface FileUpdateResponse {
+  createdAt: string;
+
+  createdBy: 'user' | 'agent' | 'workflow';
+
+  displayName: string | null;
+
+  enabled: boolean;
+
+  fileId: string;
+
+  filename: string;
+
+  mimeType: string;
+
+  sizeBytes: number;
+
+  zone: 'user' | 'agent' | 'workflow' | 'skills';
+}
+
+export interface FileListResponse {
+  files: Array<FileListResponse.File>;
+
+  quota: FileListResponse.Quota;
+}
+
+export namespace FileListResponse {
+  export interface File {
+    createdAt: string;
+
+    createdBy: 'user' | 'agent' | 'workflow';
+
+    displayName: string | null;
+
+    enabled: boolean;
+
+    fileId: string;
+
+    filename: string;
+
+    mimeType: string;
+
+    sizeBytes: number;
+
+    zone: 'user' | 'agent' | 'workflow' | 'skills';
+  }
+
+  export interface Quota {
+    currentBytes: number;
+
+    quotaBytes: number;
+  }
+}
+
+export interface FileDeleteResponse {
+  ok: true;
+}
+
+export interface FileCancelPendingResponse {
+  cancelled: boolean;
+}
+
+export interface FileConfirmResponse {
+  actualSizeBytes: number;
+
+  createdAt: string;
+
+  createdBy: 'user' | 'agent' | 'workflow';
+
+  displayName: string | null;
+
+  enabled: boolean;
+
+  fileId: string;
+
+  filename: string;
+
+  mimeType: string;
+
+  sizeBytes: number;
+
+  state: 'ready';
+
+  zone: 'user' | 'agent' | 'workflow' | 'skills';
+}
+
+export interface FileUploadURLResponse {
+  expiresAt: string;
+
+  fileId: string;
+
+  putUrl: string;
+}
+
+export interface FileUpdateParams {
+  displayName?: string | null;
+
+  enabled?: boolean;
+}
+
+export interface FileListParams {
+  zone?: 'user' | 'agent' | 'workflow' | 'skills';
+}
+
+export interface FileUploadURLParams {
+  /**
+   * Body param
+   */
+  filename: string;
+
+  /**
+   * Body param
+   */
+  mimeType: string;
+
+  /**
+   * Body param
+   */
+  sizeBytes: number;
+
+  /**
+   * Body param
+   */
+  zone?: 'user' | 'skills';
+
+  /**
+   * Header param
+   */
+  'Idempotency-Key'?: string;
+}
+
+export declare namespace Files {
+  export {
+    type FileUpdateResponse as FileUpdateResponse,
+    type FileListResponse as FileListResponse,
+    type FileDeleteResponse as FileDeleteResponse,
+    type FileCancelPendingResponse as FileCancelPendingResponse,
+    type FileConfirmResponse as FileConfirmResponse,
+    type FileUploadURLResponse as FileUploadURLResponse,
+    type FileUpdateParams as FileUpdateParams,
+    type FileListParams as FileListParams,
+    type FileUploadURLParams as FileUploadURLParams,
+  };
+}

package/src/resources/index.ts

@@ -1,6 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export * from './shared';
+export {
+  AppEvents,
+  type AppEventRetrieveResponse,
+  type AppEventListResponse,
+  type AppEventListParams,
+} from './app-events/app-events';
 export {
   Apps,
   type AppRetrieveResponse,
@@ -10,9 +16,11 @@ export {
   type AppCreateSignedUploadURLResponse,
   type AppListVersionsResponse,
   type AppMarkFailedResponse,
+  type AppStorageUsageResponse,
   type AppListParams,
   type AppCreateSignedUploadURLParams,
 } from './apps';
+export { Assistant } from './assistant/assistant';
 export {
   Carriers,
   type CarrierCreateResponse,
@@ -34,18 +42,73 @@ export {
 } from './credentials/credentials';
 export {
   Devices,
-  type Device,
+  type DeviceCreateResponse,
+  type DeviceRetrieveResponse,
   type DeviceListResponse,
   type DeviceCountResponse,
   type DeviceFingerprintResponse,
+  type DeviceRetrieveCapabilitiesResponse,
+  type DeviceSetNameResponse,
+  type DeviceWaitReadyResponse,
   type DeviceCreateParams,
   type DeviceListParams,
   type DeviceFingerprintParams,
   type DeviceSetNameParams,
   type DeviceTerminateParams,
 } from './devices/devices';
-export { Hooks } from './hooks';
+export {
+  Esims,
+  type EsimCreateResponse,
+  type EsimRetrieveResponse,
+  type EsimUpdateResponse,
+  type EsimListResponse,
+  type EsimCapacityResponse,
+  type EsimConfirmPaymentResponse,
+  type EsimImportResponse,
+  type EsimInstallResponse,
+  type EsimInstallStatusResponse,
+  type EsimSelectorResponse,
+  type EsimCreateParams,
+  type EsimUpdateParams,
+  type EsimListParams,
+  type EsimImportParams,
+  type EsimInstallParams,
+  type EsimSelectorParams,
+} from './esims/esims';
+export {
+  Files,
+  type FileUpdateResponse,
+  type FileListResponse,
+  type FileDeleteResponse,
+  type FileCancelPendingResponse,
+  type FileConfirmResponse,
+  type FileUploadURLResponse,
+  type FileUpdateParams,
+  type FileListParams,
+  type FileUploadURLParams,
+} from './files';
+export { Messages, type MessageListResponse, type MessageListParams } from './messages/messages';
 export { Models, type ModelListResponse } from './models';
+export {
+  Notifications,
+  type NotificationCatalogResponse,
+  type NotificationGetPreferencesResponse,
+  type NotificationUpdatePreferencesResponse,
+  type NotificationUpdatePreferencesParams,
+} from './notifications';
+export {
+  Numbers,
+  type NumberCreateResponse,
+  type NumberRetrieveResponse,
+  type NumberUpdateResponse,
+  type NumberListResponse,
+  type NumberDeleteResponse,
+  type NumberCountriesResponse,
+  type NumberPurposesResponse,
+  type NumberCreateParams,
+  type NumberUpdateParams,
+  type NumberListParams,
+} from './numbers/numbers';
 export {
   Profiles,
   type ProfileCreateResponse,
@@ -59,7 +122,6 @@ export {
 } from './profiles';
 export {
   Proxies,
-  type ProxyConfig,
   type ProxyCreateResponse,
   type ProxyRetrieveResponse,
   type ProxyUpdateResponse,
@@ -71,12 +133,9 @@ export {
   type ProxyListParams,
   type ProxyLookupParams,
 } from './proxies';
+export { Store, type StoreCategoriesResponse } from './store/store';
 export {
   Tasks,
-  type PackageCredentials,
-  type Task,
-  type TaskStatus,
-  type UsageResult,
   type TaskRetrieveResponse,
   type TaskListResponse,
   type TaskGetStatusResponse,
@@ -103,4 +162,4 @@ export {
   type WebhookUpdateParams,
   type WebhookListParams,
 } from './webhooks/webhooks';
-export { Workflows, type Flow } from './workflows/workflows';
+export { Workflows } from './workflows/workflows';

package/src/resources/messages/conversations.ts

@@ -0,0 +1,132 @@
+// 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';
+
+export class Conversations extends APIResource {
+  /**
+   * Lists the caller's own SMS conversations, one row per thread. Each row includes
+   * the most recent message in the thread, its unread inbound count, and the eSIMs
+   * it was seen through. Optional `esimId` or `numberId` narrows to threads on one
+   * eSIM or number.
+   *
+   * Cursor-paginated via `limit` (default 20, max 100) and
+   * `cursorLastOccurredAt`/`cursorLastMessageId` (both required together, taken from
+   * a previous page's `nextCursor`). Pagination follows each thread's most recent
+   * activity rather than a fixed snapshot, so a thread with new activity can move
+   * ahead of an in-progress page fetch. Clients that need a stable ordering should
+   * snapshot their own view.
+   */
+  list(
+    query: ConversationListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConversationListResponse> {
+    return this._client.get('/numbers/messages/conversations', { query, ...options });
+  }
+
+  /**
+   * Marks the caller's own inbound messages in a conversation thread as read, up to
+   * and including the given `(upToOccurredAt, upToMessageId)` cursor — typically a
+   * conversation row's `lastMessage`. Idempotent: repeating the call with the same
+   * cursor updates 0 rows. Returns the number of rows updated.
+   */
+  markRead(
+    body: ConversationMarkReadParams,
+    options?: RequestOptions,
+  ): APIPromise<ConversationMarkReadResponse> {
+    return this._client.post('/numbers/messages/conversations/read', { body, ...options });
+  }
+}
+
+export interface ConversationListResponse {
+  items: Array<ConversationListResponse.Item>;
+
+  nextCursor: ConversationListResponse.NextCursor | null;
+}
+
+export namespace ConversationListResponse {
+  export interface Item {
+    esimIds: Array<string>;
+
+    lastMessage: Item.LastMessage;
+
+    peerKey: string;
+
+    unreadCount: number;
+  }
+
+  export namespace Item {
+    export interface LastMessage {
+      id: string;
+
+      body: string | null;
+
+      direction: 'inbound' | 'outbound';
+
+      occurredAt: string;
+
+      status:
+        | 'received'
+        | 'queued'
+        | 'claimed'
+        | 'sending'
+        | 'sent'
+        | 'sent_unconfirmed'
+        | 'delivered'
+        | 'failed';
+    }
+  }
+
+  export interface NextCursor {
+    lastMessageId: string;
+
+    lastOccurredAt: string;
+  }
+}
+
+export interface ConversationMarkReadResponse {
+  data: ConversationMarkReadResponse.Data;
+}
+
+export namespace ConversationMarkReadResponse {
+  export interface Data {
+    updated: number;
+  }
+}
+
+export interface ConversationListParams {
+  cursorLastMessageId?: string;
+
+  cursorLastOccurredAt?: string;
+
+  esimId?: string;
+
+  limit?: number;
+
+  numberId?: string;
+}
+
+export interface ConversationMarkReadParams {
+  /**
+   * The thread's canonical peer key (see GET .../conversations)
+   */
+  peerKey: string;
+
+  upToMessageId: string;
+
+  /**
+   * Mark inbound messages read up to (and including) this occurredAt/upToMessageId
+   * cursor
+   */
+  upToOccurredAt: string;
+}
+
+export declare namespace Conversations {
+  export {
+    type ConversationListResponse as ConversationListResponse,
+    type ConversationMarkReadResponse as ConversationMarkReadResponse,
+    type ConversationListParams as ConversationListParams,
+    type ConversationMarkReadParams as ConversationMarkReadParams,
+  };
+}

package/src/resources/messages/index.ts

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Conversations,
+  type ConversationListResponse,
+  type ConversationMarkReadResponse,
+  type ConversationListParams,
+  type ConversationMarkReadParams,
+} from './conversations';
+export { Messages, type MessageListResponse, type MessageListParams } from './messages';