@mobilerun/sdk 6.1.0 → 6.1.1

package/src/resources/assistant/conversations.ts

@@ -21,11 +21,8 @@ export class Conversations extends APIResource {
 
   /**
    * Rename, change status, and/or pin. Title updates apply best-effort. Archiving
-   * always clears the pinned flag. `title` is rejected with 409
-   * `code: "session_title_managed_by_workflow"` when this chat is bound to a
-   * workflow — a bound chat's title is managed by the workflow. Other fields
-   * (description, status, pinned) remain updateable; archiving a bound chat stays
-   * allowed.
+   * always clears the pinned flag. Archiving a session with an in-flight turn is
+   * rejected with 409.
    */
   update(
     id: string,
@@ -61,10 +58,11 @@ export class Conversations extends APIResource {
   /**
    * Deliver a HITL approval/rejection for an in-flight turn. Interactive HITL
    * clients must start the turn with `Accept: text/event-stream`, wait for a
-   * `tool-hitl-approval` event, and send its `permissionId` here at
-   * `/assistant/chat/permission`. Do not submit approval as free-form user text or
-   * as `confirmed: true`. For `devices.reset`, only `once` and `reject` are allowed;
-   * the generic `always` response is rejected with HTTP 400.
+   * `tool-input-available` event with `toolName: "hitl-approval"`, and send its
+   * `toolCallId` as `permissionId` here at `/assistant/chat/permission`. Do not
+   * submit approval as free-form user text or as `confirmed: true`. For
+   * `devices.reset`, only `once` and `reject` are allowed; the generic `always`
+   * response is rejected with HTTP 400.
    */
   answerPermission(
     body: ConversationAnswerPermissionParams,
@@ -85,14 +83,15 @@ export class Conversations extends APIResource {
   }
 
   /**
-   * Return the user's chat history for the given session. History remains readable
-   * after the session is no longer active.
+   * Return the user's chat history for the given session. Inactive chat sessions
+   * return 404; workflow transcripts remain readable after completion.
    */
   history(
-    query: ConversationHistoryParams,
+    id: string,
+    query: ConversationHistoryParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<ConversationHistoryResponse> {
-    return this._client.get('/assistant/chat/messages', { query, ...options });
+    return this._client.get(path`/assistant/chat/sessions/${id}/messages`, { query, ...options });
   }
 
   /**
@@ -109,12 +108,15 @@ export class Conversations extends APIResource {
   /**
    * Send a single user message. The response format follows the Accept header:
    * `text/event-stream` for SSE, `application/json` for a buffered assistant reply.
-   * Interactive HITL requires `Accept: text/event-stream`: the stream can emit a
-   * `tool-hitl-approval` event, whose decision must be delivered to
-   * `/assistant/chat/permission`. Buffered JSON responses do not provide an
-   * interactive HITL continuation contract. `sessionId` targets a concrete active
-   * chat. The resolved chat session ID is returned as `chatSessionId` in the JSON
-   * body and as the `X-Chat-Session-Id` response header on the SSE response.
+   * Interactive HITL requires `Accept: text/event-stream`. An approval request
+   * arrives as a `tool-input-available` event with `toolName: "hitl-approval"`. Its
+   * `toolCallId` (equal to `input.permissionID`) is the permission id; deliver the
+   * decision to `/assistant/chat/permission`. In the message history, the same
+   * request appears as a `tool-hitl-approval` part. Buffered JSON responses do not
+   * provide an interactive HITL continuation contract. `sessionId` targets a
+   * concrete active chat. The resolved chat session ID is returned as
+   * `chatSessionId` in the JSON body and as the `X-Chat-Session-Id` response header
+   * on the SSE response.
    */
   send(body: ConversationSendParams, options?: RequestOptions): APIPromise<ConversationSendResponse> {
     return this._client.post('/assistant/chat/message', { body, ...options });
@@ -150,6 +152,8 @@ export namespace ConversationCreateResponse {
 
     agent: string | null;
 
+    agentId: string | null;
+
     basePromptTokens: number | null;
 
     contextExhaustedAt: string | null;
@@ -194,6 +198,8 @@ export namespace ConversationUpdateResponse {
 
     agent: string | null;
 
+    agentId: string | null;
+
     basePromptTokens: number | null;
 
     contextExhaustedAt: string | null;
@@ -238,6 +244,8 @@ export namespace ConversationListResponse {
 
     agent: string | null;
 
+    agentId: string | null;
+
     basePromptTokens: number | null;
 
     contextExhaustedAt: string | null;
@@ -284,6 +292,8 @@ export namespace ConversationListResponse {
 
     agent: string | null;
 
+    agentId: string | null;
+
     basePromptTokens: number | null;
 
     contextExhaustedAt: string | null;
@@ -339,22 +349,88 @@ export interface ConversationAnswerQuestionResponse {
 }
 
 export interface ConversationHistoryResponse {
-  messages: Array<ConversationHistoryResponse.Message>;
+  /**
+   * Session Agent identity, present on every page; null only when the session has no
+   * Agent.
+   */
+  agent: ConversationHistoryResponse.Agent | null;
 
-  turnActive: boolean;
+  data: Array<ConversationHistoryResponse.Data>;
 
-  lastTurnOutcome?: string | null;
+  /**
+   * Oldest real row in the page; pass as before to load older turns.
+   */
+  firstId: string | null;
 
-  truncated?: boolean;
+  /**
+   * Older whole turns exist.
+   */
+  hasMore: boolean;
+
+  /**
+   * Newest real row in the page, before continuation collapse or synthetic rows.
+   */
+  lastId: string | null;
 
-  turnState?: ConversationHistoryResponse.TurnState | null;
+  /**
+   * Newest-page turn snapshot; null when before is supplied.
+   */
+  turn: ConversationHistoryResponse.Turn | null;
 }
 
 export namespace ConversationHistoryResponse {
-  export interface Message {
+  /**
+   * Session Agent identity, present on every page; null only when the session has no
+   * Agent.
+   */
+  export interface Agent {
     id: string;
 
-    parts: Array<Message.Part>;
+    profile: Agent.Profile;
+  }
+
+  export namespace Agent {
+    export interface Profile {
+      /**
+       * Configuration of a `blob` avatar: its seed and optional user-chosen palette
+       * color. A color-only config retains the default seed fallback.
+       */
+      avatarConfig: Profile.AvatarConfig | null;
+
+      avatarKind: 'blob' | null;
+
+      displayName: string | null;
+    }
+
+    export namespace Profile {
+      /**
+       * Configuration of a `blob` avatar: its seed and optional user-chosen palette
+       * color. A color-only config retains the default seed fallback.
+       */
+      export interface AvatarConfig {
+        color?:
+          | 'slate'
+          | 'red'
+          | 'orange'
+          | 'amber'
+          | 'lime'
+          | 'green'
+          | 'teal'
+          | 'cyan'
+          | 'blue'
+          | 'indigo'
+          | 'violet'
+          | 'pink';
+
+        seed?: string | number;
+      }
+    }
+  }
+
+  export interface Data {
+    id: string;
+
+    parts: Array<Data.Part>;
 
     role: 'user' | 'assistant' | 'system';
 
@@ -364,7 +440,7 @@ export namespace ConversationHistoryResponse {
 
     feedback?: boolean | null;
 
-    metadata?: Message.Metadata;
+    metadata?: Data.Metadata;
 
     source?: 'cloud' | 'telegram' | 'api' | 'workflow' | 'notification';
 
@@ -378,7 +454,7 @@ export namespace ConversationHistoryResponse {
     userId?: string | null;
   }
 
-  export namespace Message {
+  export namespace Data {
     export interface Part {
       type: string;
 
@@ -392,6 +468,11 @@ export namespace ConversationHistoryResponse {
 
       agentSessionId?: string;
 
+      /**
+       * Backend notice classification on synthetic turn notes; user_stop is reserved.
+       */
+      notice?: 'user_stop' | 'interrupted' | 'no_progress' | 'tool_error' | 'error' | 'empty_answer';
+
       /**
        * Steer user rows appear directly above the collapsed assistant group of their
        * turn, matching live cloud ordering.
@@ -420,24 +501,41 @@ export namespace ConversationHistoryResponse {
     }
   }
 
-  export interface TurnState {
-    id: string;
+  /**
+   * Newest-page turn snapshot; null when before is supplied.
+   */
+  export interface Turn {
+    /**
+     * Whether this session owns an in-flight turn.
+     */
+    turnActive: boolean;
 
-    abortRequested: boolean;
+    turnState: Turn.TurnState | null;
+  }
 
-    attachable: boolean;
+  export namespace Turn {
+    export interface TurnState {
+      id: string;
 
-    claimHeld: boolean;
+      abortRequested: boolean;
 
-    outcome: string | null;
+      attachable: boolean;
 
-    phase: 'created' | 'running' | 'closed' | 'delivered' | 'failed';
+      claimHeld: boolean;
 
-    reaping: boolean;
+      /**
+       * Outcome of the latest turn, or null while it is still open.
+       */
+      outcome: string | null;
 
-    revision: number;
+      phase: 'created' | 'running' | 'closed' | 'delivered' | 'failed';
 
-    startedAt: string;
+      reaping: boolean;
+
+      revision: number;
+
+      startedAt: string;
+    }
   }
 }
 
@@ -491,6 +589,8 @@ export interface ConversationAnswerPermissionParams {
   permissionId: string;
 
   response: 'once' | 'always' | 'reject';
+
+  sessionId?: string;
 }
 
 export interface ConversationAnswerQuestionParams {
@@ -503,6 +603,8 @@ export interface ConversationAnswerQuestionParams {
   >;
 
   questionId: string;
+
+  sessionId?: string;
 }
 
 export namespace ConversationAnswerQuestionParams {
@@ -522,13 +624,18 @@ export namespace ConversationAnswerQuestionParams {
 }
 
 export interface ConversationHistoryParams {
-  sessionId: string;
+  /**
+   * Any real row in this session; its containing turn is excluded.
+   */
+  before?: string;
 
   limit?: number;
 }
 
 export interface ConversationRejectQuestionParams {
   questionId: string;
+
+  sessionId?: string;
 }
 
 export interface ConversationSendParams {

package/src/resources/devices/actions.ts

@@ -77,10 +77,9 @@ export class Actions extends APIResource {
 
   /**
    * Swipes from a start coordinate to an end coordinate over the given duration in
-   * milliseconds. An optional humanize flag applies human-like jitter and curved
-   * paths on devices that support it. With holdMs > 0 the request returns 422 when
-   * combined with humanize, when duration + holdMs exceeds 9000 ms, or on devices
-   * that do not support it.
+   * milliseconds. The optional humanize flag (best-effort, also with holdMs) adds a
+   * human-like path and timing. With holdMs > 0 the request returns 422 when
+   * duration + holdMs exceeds 9000 ms, or on devices that do not support it.
    */
   swipe(deviceID: string, params: ActionSwipeParams, options?: RequestOptions): APIPromise<void> {
     const { 'X-Device-Display-ID': xDeviceDisplayID, ...body } = params;

package/src/resources/devices/devices.ts

@@ -50,6 +50,22 @@ import * as LanguageAPI from './language';
 import { Language, LanguageGetParams, LanguageGetResponse, LanguageSetParams } from './language';
 import * as LocationAPI from './location';
 import { Location, LocationGetParams, LocationResetParams, LocationSetParams } from './location';
+import * as NumberAPI from './number';
+import {
+  Number,
+  NumberBindParams,
+  NumberBindResponse,
+  NumberRetrieveParams,
+  NumberRetrieveResponse,
+  NumberUnbindParams,
+  NumberUnbindResponse,
+} from './number';
+import * as NumberBindingsAPI from './number-bindings';
+import {
+  NumberBindingListCandidatesResponse,
+  NumberBindingListResponse,
+  NumberBindings,
+} from './number-bindings';
 import * as PackagesAPI from './packages';
 import { PackageListParams, PackageListResponse, Packages } from './packages';
 import * as ProfileAPI from './profile';
@@ -155,6 +171,8 @@ export class Devices extends APIResource {
   kiosk: KioskAPI.Kiosk = new KioskAPI.Kiosk(this._client);
   recordings: RecordingsAPI.Recordings = new RecordingsAPI.Recordings(this._client);
   trafficSessions: TrafficSessionsAPI.TrafficSessions = new TrafficSessionsAPI.TrafficSessions(this._client);
+  number: NumberAPI.Number = new NumberAPI.Number(this._client);
+  numberBindings: NumberBindingsAPI.NumberBindings = new NumberBindingsAPI.NumberBindings(this._client);
 
   /**
    * Requests a new device from the specification in the request body. Optional query
@@ -623,6 +641,8 @@ export namespace DeviceRetrieveCapabilitiesResponse {
 
     stream: boolean;
 
+    telephony: boolean;
+
     time: boolean;
 
     trafficInspection: boolean;
@@ -1015,6 +1035,8 @@ Devices.Browser = Browser;
 Devices.Kiosk = Kiosk;
 Devices.Recordings = Recordings;
 Devices.TrafficSessions = TrafficSessions;
+Devices.Number = Number;
+Devices.NumberBindings = NumberBindings;
 
 export declare namespace Devices {
   export {
@@ -1199,4 +1221,20 @@ export declare namespace Devices {
     type TrafficSessionListParams as TrafficSessionListParams,
     type TrafficSessionDeleteParams as TrafficSessionDeleteParams,
   };
+
+  export {
+    Number as Number,
+    type NumberRetrieveResponse as NumberRetrieveResponse,
+    type NumberBindResponse as NumberBindResponse,
+    type NumberUnbindResponse as NumberUnbindResponse,
+    type NumberRetrieveParams as NumberRetrieveParams,
+    type NumberBindParams as NumberBindParams,
+    type NumberUnbindParams as NumberUnbindParams,
+  };
+
+  export {
+    NumberBindings as NumberBindings,
+    type NumberBindingListResponse as NumberBindingListResponse,
+    type NumberBindingListCandidatesResponse as NumberBindingListCandidatesResponse,
+  };
 }

package/src/resources/devices/index.ts

@@ -89,6 +89,20 @@ export {
   type LocationResetParams,
   type LocationSetParams,
 } from './location';
+export {
+  Number,
+  type NumberRetrieveResponse,
+  type NumberBindResponse,
+  type NumberUnbindResponse,
+  type NumberRetrieveParams,
+  type NumberBindParams,
+  type NumberUnbindParams,
+} from './number';
+export {
+  NumberBindings,
+  type NumberBindingListResponse,
+  type NumberBindingListCandidatesResponse,
+} from './number-bindings';
 export { Packages, type PackageListResponse, type PackageListParams } from './packages';
 export { Profile, type ProfileUpdateParams } from './profile';
 export {

package/src/resources/devices/number-bindings.ts

@@ -0,0 +1,62 @@
+// 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 NumberBindings extends APIResource {
+  list(options?: RequestOptions): APIPromise<NumberBindingListResponse> {
+    return this._client.get('/devices/number-bindings', options);
+  }
+
+  listCandidates(options?: RequestOptions): APIPromise<NumberBindingListCandidatesResponse> {
+    return this._client.get('/devices/number-bindings/candidates', options);
+  }
+}
+
+export interface NumberBindingListResponse {
+  items: Array<NumberBindingListResponse.Item> | null;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export namespace NumberBindingListResponse {
+  export interface Item {
+    boundAt: string;
+
+    deviceId: string;
+
+    deviceName: string;
+
+    numberId: string;
+  }
+}
+
+export interface NumberBindingListCandidatesResponse {
+  items: Array<NumberBindingListCandidatesResponse.Item> | null;
+
+  /**
+   * A URL to the JSON Schema for this object.
+   */
+  $schema?: string;
+}
+
+export namespace NumberBindingListCandidatesResponse {
+  export interface Item {
+    id: string;
+
+    name: string;
+
+    state: 'ready';
+  }
+}
+
+export declare namespace NumberBindings {
+  export {
+    type NumberBindingListResponse as NumberBindingListResponse,
+    type NumberBindingListCandidatesResponse as NumberBindingListCandidatesResponse,
+  };
+}