@mobilerun/sdk 6.0.1 → 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;
+
+    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<Message.Part>;
+    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 {
@@ -537,6 +644,8 @@ export interface ConversationSendParams {
   sessionId: string;
 
   agent?: string;
+
+  model?: string;
 }
 
 export interface ConversationStreamParams {

package/src/resources/connect/connect.ts

@@ -8,6 +8,7 @@ import {
   Proxies,
   ProxyBuyParams,
   ProxyBuyResponse,
+  ProxyCheckoutResponse,
   ProxyEnsureHealthyResponse,
   ProxyListConnectionsParams,
   ProxyListConnectionsResponse,
@@ -55,6 +56,7 @@ export declare namespace Connect {
     type ProxyUpdateResponse as ProxyUpdateResponse,
     type ProxyListResponse as ProxyListResponse,
     type ProxyBuyResponse as ProxyBuyResponse,
+    type ProxyCheckoutResponse as ProxyCheckoutResponse,
     type ProxyEnsureHealthyResponse as ProxyEnsureHealthyResponse,
     type ProxyListConnectionsResponse as ProxyListConnectionsResponse,
     type ProxyPingResponse as ProxyPingResponse,

package/src/resources/connect/index.ts

@@ -8,6 +8,7 @@ export {
   type ProxyUpdateResponse,
   type ProxyListResponse,
   type ProxyBuyResponse,
+  type ProxyCheckoutResponse,
   type ProxyEnsureHealthyResponse,
   type ProxyListConnectionsResponse,
   type ProxyPingResponse,

package/src/resources/connect/proxies.ts

@@ -53,6 +53,15 @@ export class Proxies extends APIResource {
     });
   }
 
+  /**
+   * Refreshes a pending dedicated proxy's checkout on explicit payment intent.
+   * Already-paid proxies (provisioning, active, or cancelling) return their current
+   * status without a payment URL. An expired checkout requires a new purchase.
+   */
+  checkout(id: string, options?: RequestOptions): APIPromise<ProxyCheckoutResponse> {
+    return this._client.post(path`/connect/proxies/${id}/checkout`, options);
+  }
+
   /**
    * Checks right now that the proxy's upstream accepts a connection through its
    * current session. If the upstream refuses the session and the proxy is a rotating
@@ -321,6 +330,23 @@ export interface ProxyBuyResponse {
   paymentUrl?: string | null;
 }
 
+export interface ProxyCheckoutResponse {
+  /**
+   * Lifecycle of a proxy. A freshly created proxy is `checking` while its billing
+   * identity is being resolved — clients should poll until a `paymentUrl` or a later
+   * status appears — then `provisioning` — or `pending_payment` until the customer
+   * completes checkout — and becomes `active` once its upstream is assigned.
+   * `cancelling` retains full access through the paid period; when the subscription
+   * expires the proxy is `ended`. `error` marks a failed provisioning attempt.
+   */
+  status: 'checking' | 'pending_payment' | 'provisioning' | 'active' | 'cancelling' | 'ended' | 'error';
+
+  /**
+   * Payable checkout URL; omitted after payment.
+   */
+  paymentUrl?: string | null;
+}
+
 /**
  * The outcome of an ensure-healthy check.
  */
@@ -717,6 +743,7 @@ export declare namespace Proxies {
     type ProxyUpdateResponse as ProxyUpdateResponse,
     type ProxyListResponse as ProxyListResponse,
     type ProxyBuyResponse as ProxyBuyResponse,
+    type ProxyCheckoutResponse as ProxyCheckoutResponse,
     type ProxyEnsureHealthyResponse as ProxyEnsureHealthyResponse,
     type ProxyListConnectionsResponse as ProxyListConnectionsResponse,
     type ProxyPingResponse as ProxyPingResponse,

package/src/resources/credentials/credentials.ts

@@ -2,6 +2,14 @@
 
 import { APIResource } from '../../core/resource';
 import * as Shared from '../shared';
+import * as OnepasswordAPI from './onepassword/onepassword';
+import {
+  Onepassword,
+  OnepasswordConnectParams,
+  OnepasswordConnectResponse,
+  OnepasswordDisconnectResponse,
+  OnepasswordRetrieveResponse,
+} from './onepassword/onepassword';
 import * as PackagesAPI from './packages/packages';
 import {
   PackageCreateParams,
@@ -15,6 +23,7 @@ import { RequestOptions } from '../../internal/request-options';
 
 export class Credentials extends APIResource {
   packages: PackagesAPI.Packages = new PackagesAPI.Packages(this._client);
+  onepassword: OnepasswordAPI.Onepassword = new OnepasswordAPI.Onepassword(this._client);
 
   /**
    * Returns a paginated list of all credentials belonging to the authenticated user
@@ -54,6 +63,10 @@ export namespace CredentialListResponse {
      * for credentials created before rollout.
      */
     userId: string | null;
+
+    link?: Item.Link;
+
+    source?: 'mobilerun' | 'onepassword';
   }
 
   export namespace Item {
@@ -69,6 +82,35 @@ export namespace CredentialListResponse {
 
       value: string;
     }
+
+    export interface Link {
+      fieldMap: Array<Link.FieldMap>;
+
+      itemId: string;
+
+      itemTitle: string;
+
+      provider: 'onepassword';
+
+      vaultId: string;
+
+      vaultName: string;
+    }
+
+    export namespace Link {
+      export interface FieldMap {
+        fieldId: string;
+
+        fieldType:
+          | 'email'
+          | 'username'
+          | 'password'
+          | 'api_token'
+          | 'phone_number'
+          | 'two_factor_secret'
+          | 'backup_codes';
+      }
+    }
   }
 }
 
@@ -79,6 +121,7 @@ export interface CredentialListParams {
 }
 
 Credentials.Packages = Packages;
+Credentials.Onepassword = Onepassword;
 
 export declare namespace Credentials {
   export {
@@ -93,4 +136,12 @@ export declare namespace Credentials {
     type PackageListAllResponse as PackageListAllResponse,
     type PackageCreateParams as PackageCreateParams,
   };
+
+  export {
+    Onepassword as Onepassword,
+    type OnepasswordRetrieveResponse as OnepasswordRetrieveResponse,
+    type OnepasswordConnectResponse as OnepasswordConnectResponse,
+    type OnepasswordDisconnectResponse as OnepasswordDisconnectResponse,
+    type OnepasswordConnectParams as OnepasswordConnectParams,
+  };
 }

package/src/resources/credentials/index.ts

@@ -1,6 +1,13 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Credentials, type CredentialListResponse, type CredentialListParams } from './credentials';
+export {
+  Onepassword,
+  type OnepasswordRetrieveResponse,
+  type OnepasswordConnectResponse,
+  type OnepasswordDisconnectResponse,
+  type OnepasswordConnectParams,
+} from './onepassword/index';
 export {
   Packages,
   type PackageCreateResponse,

package/src/resources/credentials/onepassword/index.ts

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Onepassword,
+  type OnepasswordRetrieveResponse,
+  type OnepasswordConnectResponse,
+  type OnepasswordDisconnectResponse,
+  type OnepasswordConnectParams,
+} from './onepassword';
+export { Vaults } from './vaults/index';

package/src/resources/credentials/onepassword/onepassword.ts

@@ -0,0 +1,101 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as VaultsAPI from './vaults/vaults';
+import { Vaults } from './vaults/vaults';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Onepassword extends APIResource {
+  vaults: VaultsAPI.Vaults = new VaultsAPI.Vaults(this._client);
+
+  /**
+   * Get 1Password connection
+   */
+  retrieve(options?: RequestOptions): APIPromise<OnepasswordRetrieveResponse> {
+    return this._client.get('/credentials/onepassword', options);
+  }
+
+  /**
+   * Connect a 1Password service account
+   */
+  connect(body: OnepasswordConnectParams, options?: RequestOptions): APIPromise<OnepasswordConnectResponse> {
+    return this._client.put('/credentials/onepassword', { body, ...options });
+  }
+
+  /**
+   * Disconnect 1Password
+   */
+  disconnect(options?: RequestOptions): APIPromise<OnepasswordDisconnectResponse> {
+    return this._client.delete('/credentials/onepassword', options);
+  }
+}
+
+export interface OnepasswordRetrieveResponse {
+  data: OnepasswordRetrieveResponse.Data;
+}
+
+export namespace OnepasswordRetrieveResponse {
+  export interface Data {
+    connected: boolean;
+
+    connectedAt?: string;
+
+    connectedBy?: string;
+
+    vaults?: Array<Data.Vault>;
+  }
+
+  export namespace Data {
+    export interface Vault {
+      id: string;
+
+      title: string;
+    }
+  }
+}
+
+export interface OnepasswordConnectResponse {
+  data: OnepasswordConnectResponse.Data;
+}
+
+export namespace OnepasswordConnectResponse {
+  export interface Data {
+    connected: boolean;
+
+    connectedAt?: string;
+
+    connectedBy?: string;
+
+    vaults?: Array<Data.Vault>;
+  }
+
+  export namespace Data {
+    export interface Vault {
+      id: string;
+
+      title: string;
+    }
+  }
+}
+
+export interface OnepasswordDisconnectResponse {
+  message: string;
+}
+
+export interface OnepasswordConnectParams {
+  serviceAccountToken: string;
+}
+
+Onepassword.Vaults = Vaults;
+
+export declare namespace Onepassword {
+  export {
+    type OnepasswordRetrieveResponse as OnepasswordRetrieveResponse,
+    type OnepasswordConnectResponse as OnepasswordConnectResponse,
+    type OnepasswordDisconnectResponse as OnepasswordDisconnectResponse,
+    type OnepasswordConnectParams as OnepasswordConnectParams,
+  };
+
+  export { Vaults as Vaults };
+}

package/src/resources/credentials/onepassword/vaults/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Items, type ItemListResponse } from './items/index';
+export { Vaults } from './vaults';

package/src/resources/credentials/onepassword/vaults/items/fields.ts

@@ -0,0 +1,40 @@
+// 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 Fields extends APIResource {
+  /**
+   * List 1Password field metadata
+   */
+  list(itemID: string, params: FieldListParams, options?: RequestOptions): APIPromise<FieldListResponse> {
+    const { vaultId } = params;
+    return this._client.get(path`/credentials/onepassword/vaults/${vaultId}/items/${itemID}/fields`, options);
+  }
+}
+
+export interface FieldListResponse {
+  data: Array<FieldListResponse.Data>;
+}
+
+export namespace FieldListResponse {
+  export interface Data {
+    id: string;
+
+    fieldType: string;
+
+    title: string;
+
+    sectionId?: string;
+  }
+}
+
+export interface FieldListParams {
+  vaultId: string;
+}
+
+export declare namespace Fields {
+  export { type FieldListResponse as FieldListResponse, type FieldListParams as FieldListParams };
+}

package/src/resources/credentials/onepassword/vaults/items/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Fields, type FieldListResponse, type FieldListParams } from './fields';
+export { Items, type ItemListResponse } from './items';