@mobilerun/sdk 5.3.0 → 5.5.0

package/src/resources/mailboxes/messages.ts

@@ -0,0 +1,134 @@
+// 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';
+import { path } from '../../internal/utils/path';
+
+export class Messages extends APIResource {
+  /**
+   * Get a mailbox message
+   *
+   * @example
+   * ```ts
+   * const message = await client.mailboxes.messages.retrieve(
+   *   'x',
+   *   { mailboxId: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+   * );
+   * ```
+   */
+  retrieve(
+    messageID: string,
+    params: MessageRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<MessageRetrieveResponse> {
+    const { mailboxId } = params;
+    return this._client.get(path`/mailboxes/${mailboxId}/messages/${messageID}`, options);
+  }
+
+  /**
+   * Lists mailbox messages with cursor pagination and optional time, sender, and OTP
+   * filters.
+   *
+   * @example
+   * ```ts
+   * const messages = await client.mailboxes.messages.list(
+   *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+   * );
+   * ```
+   */
+  list(
+    mailboxID: string,
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MessageListResponse> {
+    return this._client.get(path`/mailboxes/${mailboxID}/messages`, { query, ...options });
+  }
+}
+
+export interface MessageRetrieveResponse {
+  data: MessageRetrieveResponse.Data;
+}
+
+export namespace MessageRetrieveResponse {
+  export interface Data {
+    id: string;
+
+    attachmentCount: number;
+
+    attachments: Array<Data.Attachment>;
+
+    fromAddress: string | null;
+
+    fromName: string | null;
+
+    hasOtp: boolean;
+
+    mailboxId: string;
+
+    receivedAt: string;
+
+    subject: string | null;
+
+    textBody: string | null;
+  }
+
+  export namespace Data {
+    export interface Attachment {
+      contentType: string | null;
+
+      name: string | null;
+
+      size: number;
+    }
+  }
+}
+
+export interface MessageListResponse {
+  items: Array<MessageListResponse.Item>;
+
+  nextCursor: string | null;
+}
+
+export namespace MessageListResponse {
+  export interface Item {
+    id: string;
+
+    fromAddress: string | null;
+
+    hasOtp: boolean;
+
+    mailboxId: string;
+
+    preview: string | null;
+
+    receivedAt: string;
+
+    subject: string | null;
+  }
+}
+
+export interface MessageRetrieveParams {
+  mailboxId: string;
+}
+
+export interface MessageListParams {
+  after?: string;
+
+  cursor?: string;
+
+  hasOtp?: 'true' | 'false';
+
+  limit?: number;
+
+  sender?: string;
+}
+
+export declare namespace Messages {
+  export {
+    type MessageRetrieveResponse as MessageRetrieveResponse,
+    type MessageListResponse as MessageListResponse,
+    type MessageRetrieveParams as MessageRetrieveParams,
+    type MessageListParams as MessageListParams,
+  };
+}

package/src/resources/{esims.ts → mailboxes.ts}

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

package/src/resources/messages/conversations.ts

@@ -6,17 +6,8 @@ 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.
+   * Lists SMS conversations by recent activity. Use both cursor fields from
+   * `nextCursor` to fetch the next page.
    */
   list(
     query: ConversationListParams | null | undefined = {},
@@ -26,10 +17,8 @@ export class Conversations extends APIResource {
   }
 
   /**
-   * 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.
+   * Marks inbound messages in a conversation as read through the supplied cursor.
+   * Repeating the request is safe.
    */
   markRead(
     body: ConversationMarkReadParams,

package/src/resources/messages/messages.ts

@@ -17,10 +17,8 @@ export class Messages extends APIResource {
   conversations: ConversationsAPI.Conversations = new ConversationsAPI.Conversations(this._client);
 
   /**
-   * Lists the caller's own SMS messages, newest first. Supports filtering by
-   * direction, esimId, numberId, status, peerNumber (substring search, min 3
-   * characters), and peerKey (exact thread match). Each row includes its canonical
-   * thread key (`peerKey`).
+   * Lists SMS messages newest first, with filters for direction, eSIM, phone number,
+   * status, and conversation.
    */
   list(
     query: MessageListParams | null | undefined = {},

package/src/resources/numbers/index.ts

@@ -8,9 +8,11 @@ export {
   type NumberUpdateResponse,
   type NumberListResponse,
   type NumberDeleteResponse,
+  type NumberCapacityResponse,
   type NumberCountriesResponse,
   type NumberPurposesResponse,
   type NumberCreateParams,
   type NumberUpdateParams,
   type NumberListParams,
+  type NumberCapacityParams,
 } from './numbers';

package/src/resources/numbers/numbers.ts

@@ -13,9 +13,8 @@ export class Numbers extends APIResource {
   messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
 
   /**
-   * Starts a Mobilerun Phone purchase for the authenticated owner. Accepted requests
-   * always return the same asynchronous envelope; poll GET /numbers/phones/{id} for
-   * its business state. `purpose` and `country` are mutually exclusive.
+   * Starts a phone-number purchase. Poll the returned phone number for status
+   * updates. `purpose` and `country` cannot be combined.
    *
    * @example
    * ```ts
@@ -52,11 +51,8 @@ export class Numbers extends APIResource {
   }
 
   /**
-   * Updates the phone number's user-defined display label. Omitting `label` leaves
-   * it unchanged; setting it to null or an empty string clears it. The label is
-   * capped at 100 characters, is display-only, and never affects routing. It also
-   * seeds the billing entity name when set at purchase time; a later change here
-   * does not rename the already-created billing entity.
+   * Updates the display label. Omitting `label` leaves it unchanged; null or an
+   * empty string clears it.
    *
    * @example
    * ```ts
@@ -74,8 +70,7 @@ export class Numbers extends APIResource {
   }
 
   /**
-   * Lists phone numbers owned by the authenticated user — both BYO (`user`) and
-   * provisioned (`mobilerun`) numbers.
+   * Lists the caller's phone numbers.
    *
    * @example
    * ```ts
@@ -90,23 +85,9 @@ export class Numbers extends APIResource {
   }
 
   /**
-   * Cancels a Mobilerun Phone. The outcome depends on the number's current state:
-   *
-   * - If the number is still awaiting payment and no payment for it is currently
-   *   being processed, the checkout is closed immediately and the number is retired.
-   * - If the number is on the standard paid plan and already paid and in service,
-   *   cancellation is scheduled for the end of the current billing period rather
-   *   than taking effect immediately. The number stays usable through the period
-   *   already paid for, with no partial refund. Calling this again while a
-   *   cancellation is already scheduled is a no-op that returns the same result. The
-   *   response's `state` reflects this as `cancel_scheduled` with
-   *   `cancelAtPeriodEnd: true`; `currentPeriodEnd` is populated once billing
-   *   confirms the cancellation.
-   *
-   * Any other state (already refunding, a permanent billing failure, a payment
-   * currently being processed, an included-plan number, or a non-hosted/BYO number)
-   * returns 409 `not_cancellable`. Returns 404 if the number doesn't exist or isn't
-   * owned by the caller.
+   * Cancels a pending purchase or schedules cancellation of an active paid phone
+   * number. Repeating a scheduled cancellation is safe. Returns 409 when
+   * cancellation is not available.
    *
    * @example
    * ```ts
@@ -120,8 +101,22 @@ export class Numbers extends APIResource {
   }
 
   /**
-   * Lists the countries currently offered for a dedicated Mobilerun Phone, with live
-   * stock status. Pass `country` as the `country` field on POST /numbers/phones.
+   * Returns included phone capacity for a country. Creating a phone is
+   * authoritative.
+   *
+   * @example
+   * ```ts
+   * const response = await client.numbers.capacity({
+   *   country: 'de',
+   * });
+   * ```
+   */
+  capacity(query: NumberCapacityParams, options?: RequestOptions): APIPromise<NumberCapacityResponse> {
+    return this._client.get('/numbers/phones/capacity', { query, ...options });
+  }
+
+  /**
+   * Lists available countries and current phone-number availability.
    *
    * @example
    * ```ts
@@ -305,6 +300,26 @@ export namespace NumberDeleteResponse {
   }
 }
 
+export interface NumberCapacityResponse {
+  data: NumberCapacityResponse.Data;
+}
+
+export namespace NumberCapacityResponse {
+  export interface Data {
+    included: number;
+
+    /**
+     * @deprecated Deprecated — always equal to `remaining`. Migrate to `remaining`;
+     * this field will be removed in a future revision.
+     */
+    includedRemaining: number;
+
+    remaining: number;
+
+    status: 'available' | 'exhausted' | 'not_included';
+  }
+}
+
 export interface NumberCountriesResponse {
   data: NumberCountriesResponse.Data;
 }
@@ -347,14 +362,14 @@ export namespace NumberPurposesResponse {
 
 export interface NumberCreateParams {
   /**
-   * Body param: Prefer a free package seat ('included', default) or force the paid
-   * checkout ('rent')
+   * Body param: Use included capacity when available, require included capacity
+   * without paid fallback (included_only), or start a paid checkout (rent).
    */
-  billingPreference?: 'included' | 'rent';
+  billingPreference?: 'included' | 'included_only' | 'rent';
 
   /**
    * Body param: Optional ISO 3166-1 alpha-2 country code from GET
-   * /numbers/countries. Cannot be combined with `purpose`.
+   * /numbers/phones/countries. Cannot be combined with `purpose`.
    */
   country?: string;
 
@@ -366,7 +381,7 @@ export interface NumberCreateParams {
   label?: string | null;
 
   /**
-   * Body param: Optional Mobilerun Phone purpose slug from GET /numbers/purposes.
+   * Body param: Optional purpose from GET /numbers/phones/purposes.
    */
   purpose?: string;
 
@@ -391,6 +406,13 @@ export interface NumberListParams {
   pageSize?: number;
 }
 
+export interface NumberCapacityParams {
+  /**
+   * ISO 3166-1 alpha-2 country code from GET /numbers/phones/countries.
+   */
+  country: string;
+}
+
 Numbers.Messages = Messages;
 
 export declare namespace Numbers {
@@ -400,11 +422,13 @@ export declare namespace Numbers {
     type NumberUpdateResponse as NumberUpdateResponse,
     type NumberListResponse as NumberListResponse,
     type NumberDeleteResponse as NumberDeleteResponse,
+    type NumberCapacityResponse as NumberCapacityResponse,
     type NumberCountriesResponse as NumberCountriesResponse,
     type NumberPurposesResponse as NumberPurposesResponse,
     type NumberCreateParams as NumberCreateParams,
     type NumberUpdateParams as NumberUpdateParams,
     type NumberListParams as NumberListParams,
+    type NumberCapacityParams as NumberCapacityParams,
   };
 
   export {

package/src/resources/tasks/tasks.ts

@@ -134,7 +134,15 @@ export namespace TaskRetrieveResponse {
 
     ownerId: string;
 
-    status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
+    status:
+      | 'prepared'
+      | 'queued'
+      | 'created'
+      | 'running'
+      | 'cancelling'
+      | 'completed'
+      | 'failed'
+      | 'cancelled';
 
     task: string;
 
@@ -147,8 +155,6 @@ export namespace TaskRetrieveResponse {
 
     accessibility?: boolean;
 
-    agentId?: number;
-
     apps?: Array<string>;
 
     cancelRequestedAt?: string | null;
@@ -175,11 +181,6 @@ export namespace TaskRetrieveResponse {
 
     maxSteps?: number;
 
-    /**
-     * Memory namespace for cross-task personalization
-     */
-    memoryNamespace?: string;
-
     message?: string | null;
 
     output?: { [key: string]: unknown } | null;
@@ -188,6 +189,22 @@ export namespace TaskRetrieveResponse {
 
     reasoning?: boolean;
 
+    recordingDeviceId?: string | null;
+
+    /**
+     * Record device video for the whole task and persist a retrievable reference
+     */
+    recordingEnabled?: boolean;
+
+    recordingId?: string | null;
+
+    /**
+     * Where the task came from: 'api' for tasks created via POST /tasks, 'agent' for
+     * tasks spawned by an agent step. Agent tasks are readable (status, trajectory,
+     * media) but not controllable via this API.
+     */
+    source?: 'api' | 'agent';
+
     stealth?: boolean;
 
     steps?: number | null;
@@ -201,6 +218,10 @@ export namespace TaskRetrieveResponse {
 
     succeeded?: boolean | null;
 
+    /**
+     * @deprecated Deprecated and ignored. Sampling behavior is controlled by the model
+     * provider.
+     */
     temperature?: number;
 
     updatedAt?: string;
@@ -249,7 +270,15 @@ export namespace TaskListResponse {
 
     ownerId: string;
 
-    status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
+    status:
+      | 'prepared'
+      | 'queued'
+      | 'created'
+      | 'running'
+      | 'cancelling'
+      | 'completed'
+      | 'failed'
+      | 'cancelled';
 
     task: string;
 
@@ -262,8 +291,6 @@ export namespace TaskListResponse {
 
     accessibility?: boolean;
 
-    agentId?: number;
-
     apps?: Array<string>;
 
     cancelRequestedAt?: string | null;
@@ -290,11 +317,6 @@ export namespace TaskListResponse {
 
     maxSteps?: number;
 
-    /**
-     * Memory namespace for cross-task personalization
-     */
-    memoryNamespace?: string;
-
     message?: string | null;
 
     output?: { [key: string]: unknown } | null;
@@ -303,6 +325,22 @@ export namespace TaskListResponse {
 
     reasoning?: boolean;
 
+    recordingDeviceId?: string | null;
+
+    /**
+     * Record device video for the whole task and persist a retrievable reference
+     */
+    recordingEnabled?: boolean;
+
+    recordingId?: string | null;
+
+    /**
+     * Where the task came from: 'api' for tasks created via POST /tasks, 'agent' for
+     * tasks spawned by an agent step. Agent tasks are readable (status, trajectory,
+     * media) but not controllable via this API.
+     */
+    source?: 'api' | 'agent';
+
     stealth?: boolean;
 
     steps?: number | null;
@@ -316,6 +354,10 @@ export namespace TaskListResponse {
 
     succeeded?: boolean | null;
 
+    /**
+     * @deprecated Deprecated and ignored. Sampling behavior is controlled by the model
+     * provider.
+     */
     temperature?: number;
 
     updatedAt?: string;
@@ -338,7 +380,7 @@ export interface TaskGetStatusResponse {
   /**
    * The status of the task
    */
-  status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
+  status: 'prepared' | 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
 
   /**
    * Execution metadata for abnormal terminal outcomes
@@ -360,6 +402,16 @@ export interface TaskGetStatusResponse {
    */
   output?: { [key: string]: unknown } | null;
 
+  /**
+   * Device ID associated with recordingId
+   */
+  recordingDeviceId?: string | null;
+
+  /**
+   * ID of the task's whole-task video recording, if recordingEnabled was set
+   */
+  recordingId?: string | null;
+
   /**
    * Number of steps taken
    */
@@ -1060,7 +1112,7 @@ export interface TaskRunResponse {
   /**
    * The status of the task (queued or created)
    */
-  status: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
+  status: 'prepared' | 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
 
   /**
    * The URL of the stream (null when queued)
@@ -1108,7 +1160,21 @@ export interface TaskListParams {
    */
   query?: string | null;
 
-  status?: 'queued' | 'created' | 'running' | 'cancelling' | 'completed' | 'failed' | 'cancelled' | null;
+  /**
+   * Only tasks created via the API ('api') or spawned by an agent step ('agent').
+   */
+  source?: 'api' | 'agent' | null;
+
+  status?:
+    | 'prepared'
+    | 'queued'
+    | 'created'
+    | 'running'
+    | 'cancelling'
+    | 'completed'
+    | 'failed'
+    | 'cancelled'
+    | null;
 }
 
 export interface TaskRunParams {
@@ -1127,11 +1193,6 @@ export interface TaskRunParams {
    */
   accessibility?: boolean;
 
-  /**
-   * Body param
-   */
-  agentId?: number;
-
   /**
    * Body param
    */
@@ -1153,7 +1214,7 @@ export interface TaskRunParams {
   displayId?: number;
 
   /**
-   * Body param
+   * Body param: Maximum agent execution time in seconds (1–2700).
    */
   executionTimeout?: number;
 
@@ -1164,7 +1225,7 @@ export interface TaskRunParams {
 
   /**
    * Body param: The LLM model identifier to use for the task (e.g.
-   * 'google/gemini-3.5-flash')
+   * 'openai/gpt-5.6-luna')
    */
   llmModel?: string;
 
@@ -1173,11 +1234,6 @@ export interface TaskRunParams {
    */
   maxSteps?: number;
 
-  /**
-   * Body param: Memory namespace for cross-task personalization
-   */
-  memoryNamespace?: string;
-
   /**
    * Body param
    */
@@ -1188,6 +1244,12 @@ export interface TaskRunParams {
    */
   reasoning?: boolean;
 
+  /**
+   * Body param: Record device video for the whole task and persist a retrievable
+   * reference
+   */
+  recordingEnabled?: boolean;
+
   /**
    * Body param
    */
@@ -1200,7 +1262,14 @@ export interface TaskRunParams {
   subagentModel?: string;
 
   /**
-   * Body param
+   * Body param: Optional custom behavioral overlay applied on top of the agent's
+   * default system prompts. Never echoed back in responses or errors.
+   */
+  systemPrompt?: string | null;
+
+  /**
+   * @deprecated Body param: Deprecated and ignored. Sampling behavior is controlled
+   * by the model provider.
    */
   temperature?: number;
 
@@ -1238,8 +1307,6 @@ export interface TaskRunStreamedParams {
 
   accessibility?: boolean;
 
-  agentId?: number;
-
   apps?: Array<string>;
 
   continueOnFailure?: boolean;
@@ -1251,26 +1318,29 @@ export interface TaskRunStreamedParams {
    */
   displayId?: number;
 
+  /**
+   * Maximum agent execution time in seconds (1–2700).
+   */
   executionTimeout?: number;
 
   files?: Array<string>;
 
   /**
-   * The LLM model identifier to use for the task (e.g. 'google/gemini-3.5-flash')
+   * The LLM model identifier to use for the task (e.g. 'openai/gpt-5.6-luna')
    */
   llmModel?: string;
 
   maxSteps?: number;
 
-  /**
-   * Memory namespace for cross-task personalization
-   */
-  memoryNamespace?: string;
-
   outputSchema?: { [key: string]: unknown } | null;
 
   reasoning?: boolean;
 
+  /**
+   * Record device video for the whole task and persist a retrievable reference
+   */
+  recordingEnabled?: boolean;
+
   stealth?: boolean;
 
   /**
@@ -1278,6 +1348,16 @@ export interface TaskRunStreamedParams {
    */
   subagentModel?: string;
 
+  /**
+   * Optional custom behavioral overlay applied on top of the agent's default system
+   * prompts. Never echoed back in responses or errors.
+   */
+  systemPrompt?: string | null;
+
+  /**
+   * @deprecated Deprecated and ignored. Sampling behavior is controlled by the model
+   * provider.
+   */
   temperature?: number;
 
   vision?: boolean;

package/src/resources/webhooks/webhooks.ts

@@ -370,6 +370,8 @@ export namespace WebhookEventTypesResponse {
           toast: boolean;
 
           webhook: boolean;
+
+          agent?: boolean;
         }
       }
     }