@mobilerun/sdk 5.2.0 → 5.3.0

package/src/resources/assistant/conversations.ts

@@ -0,0 +1,524 @@
+// 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 { Stream } from '../../core/streaming';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Conversations extends APIResource {
+  /**
+   * Creates a titled agent session. Setup may occur on the first prompt. Idempotent
+   * via the `Idempotency-Key` header — a duplicate submit by the same authenticated
+   * caller within the 24-hour idempotency window returns the already-created session
+   * instead of a second one.
+   */
+  create(params: ConversationCreateParams, options?: RequestOptions): APIPromise<ConversationCreateResponse> {
+    const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+    return this._client.post('/assistant/chat/sessions', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
+
+  /**
+   * 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.
+   */
+  update(
+    id: string,
+    body: ConversationUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<ConversationUpdateResponse> {
+    return this._client.patch(path`/assistant/chat/sessions/${id}`, { body, ...options });
+  }
+
+  /**
+   * Default (`kind` absent or `chat`): active named chat sessions, pinned first then
+   * most recent activity — `workflowId` must be absent, or the request 400s.
+   * `mine=true` (only valid with `kind=chat`) narrows to sessions the caller
+   * created. `kind=agent_workflow`: workflow-linked sessions for one workflow
+   * (`workflowId` required, or the request 400s), no status filter, newest episode
+   * first.
+   */
+  list(
+    query: ConversationListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ConversationListResponse> {
+    return this._client.get('/assistant/chat/sessions', { query, ...options });
+  }
+
+  /**
+   * Abort the in-flight chat turn owned by `sessionId`. Idempotent. A turn owned by
+   * a different session is left untouched (204).
+   */
+  abort(body: ConversationAbortParams, options?: RequestOptions): APIPromise<ConversationAbortResponse> {
+    return this._client.post('/assistant/chat/abort', { body, ...options });
+  }
+
+  /**
+   * Deliver a HITL approval/rejection for an in-flight turn.
+   */
+  answerPermission(
+    body: ConversationAnswerPermissionParams,
+    options?: RequestOptions,
+  ): APIPromise<ConversationAnswerPermissionResponse> {
+    return this._client.post('/assistant/chat/permission', { body, ...options });
+  }
+
+  /**
+   * Deliver the user's answers to the agent's pending question for an in-flight
+   * turn. Idempotent via the `idempotency-key` header.
+   */
+  answerQuestion(
+    body: ConversationAnswerQuestionParams,
+    options?: RequestOptions,
+  ): APIPromise<ConversationAnswerQuestionResponse> {
+    return this._client.post('/assistant/chat/question', { body, ...options });
+  }
+
+  /**
+   * Return the user's chat history for the given session. History remains readable
+   * after the session is no longer active.
+   */
+  history(
+    query: ConversationHistoryParams,
+    options?: RequestOptions,
+  ): APIPromise<ConversationHistoryResponse> {
+    return this._client.get('/assistant/chat/messages', { query, ...options });
+  }
+
+  /**
+   * Dismiss the agent's pending question. Already-resolved questions return 200
+   * (no-op) so multi-tab dismiss stays idempotent.
+   */
+  rejectQuestion(
+    body: ConversationRejectQuestionParams,
+    options?: RequestOptions,
+  ): APIPromise<ConversationRejectQuestionResponse> {
+    return this._client.post('/assistant/chat/question/reject', { body, ...options });
+  }
+
+  /**
+   * Send a single user message. The response format follows the Accept header:
+   * `text/event-stream` for SSE, `application/json` for a buffered assistant reply.
+   * `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 });
+  }
+
+  /**
+   * Reconnect to the in-flight turn stream. Replays buffered events from the start
+   * of the active turn, then continues live until the turn finishes. Responds 204
+   * when no active turn exists for the requested session. Upstream streaming
+   * failures return a retryable 503 with `Retry-After`. Resume is best-effort. Does
+   * not start an inactive session.
+   */
+  stream(
+    query: ConversationStreamParams,
+    options?: RequestOptions,
+  ): APIPromise<Stream<ConversationStreamResponse>> {
+    return this._client.get('/assistant/chat/stream', {
+      query,
+      ...options,
+      headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
+      stream: true,
+    }) as APIPromise<Stream<ConversationStreamResponse>>;
+  }
+}
+
+export interface ConversationCreateResponse {
+  session: ConversationCreateResponse.Session;
+}
+
+export namespace ConversationCreateResponse {
+  export interface Session {
+    id: string;
+
+    agent: string | null;
+
+    basePromptTokens: number | null;
+
+    contextExhaustedAt: string | null;
+
+    costCents: number;
+
+    costUsd: number;
+
+    createdAt: string;
+
+    description: string | null;
+
+    lastActiveAt: string;
+
+    peakPromptTokens: number | null;
+
+    pinned: boolean;
+
+    promptStatus: 'ready' | 'machine_replaced';
+
+    status: string;
+
+    title: string;
+
+    turnActive: boolean;
+
+    turnStartedAt: string | null;
+
+    createdBy?: string | null;
+  }
+}
+
+export interface ConversationUpdateResponse {
+  session: ConversationUpdateResponse.Session;
+}
+
+export namespace ConversationUpdateResponse {
+  export interface Session {
+    id: string;
+
+    agent: string | null;
+
+    basePromptTokens: number | null;
+
+    contextExhaustedAt: string | null;
+
+    costCents: number;
+
+    costUsd: number;
+
+    createdAt: string;
+
+    description: string | null;
+
+    lastActiveAt: string;
+
+    peakPromptTokens: number | null;
+
+    pinned: boolean;
+
+    promptStatus: 'ready' | 'machine_replaced';
+
+    status: string;
+
+    title: string;
+
+    turnActive: boolean;
+
+    turnStartedAt: string | null;
+
+    createdBy?: string | null;
+  }
+}
+
+export interface ConversationListResponse {
+  sessions: Array<ConversationListResponse.UnionMember0 | ConversationListResponse.UnionMember1>;
+}
+
+export namespace ConversationListResponse {
+  export interface UnionMember0 {
+    id: string;
+
+    agent: string | null;
+
+    basePromptTokens: number | null;
+
+    contextExhaustedAt: string | null;
+
+    costCents: number;
+
+    costUsd: number;
+
+    createdAt: string;
+
+    description: string | null;
+
+    episode: number;
+
+    kind: 'chat';
+
+    lastActiveAt: string;
+
+    peakPromptTokens: number | null;
+
+    pinned: boolean;
+
+    promptStatus: 'ready' | 'machine_replaced';
+
+    sourceExecutionId: null;
+
+    status: string;
+
+    title: string;
+
+    turnActive: boolean;
+
+    turnStartedAt: string | null;
+
+    workflowId: null;
+
+    createdBy?: string | null;
+  }
+
+  export interface UnionMember1 {
+    id: string;
+
+    agent: string | null;
+
+    basePromptTokens: number | null;
+
+    contextExhaustedAt: string | null;
+
+    costCents: number;
+
+    costUsd: number;
+
+    createdAt: string;
+
+    description: string | null;
+
+    episode: number;
+
+    kind: 'agent_workflow';
+
+    lastActiveAt: string;
+
+    peakPromptTokens: number | null;
+
+    pinned: boolean;
+
+    promptStatus: 'ready' | 'machine_replaced';
+
+    sourceExecutionId: string;
+
+    status: string;
+
+    title: string;
+
+    turnActive: boolean;
+
+    turnStartedAt: string | null;
+
+    workflowId: string;
+
+    createdBy?: string | null;
+  }
+}
+
+export interface ConversationAbortResponse {
+  ok: true;
+}
+
+export interface ConversationAnswerPermissionResponse {
+  ok: true;
+}
+
+export interface ConversationAnswerQuestionResponse {
+  ok: true;
+}
+
+export interface ConversationHistoryResponse {
+  messages: Array<ConversationHistoryResponse.Message>;
+
+  turnActive: boolean;
+
+  truncated?: boolean;
+}
+
+export namespace ConversationHistoryResponse {
+  export interface Message {
+    id: string;
+
+    parts: Array<Message.Part>;
+
+    role: 'user' | 'assistant' | 'system';
+
+    createdAt?: string;
+
+    createdBy?: string | null;
+
+    feedback?: boolean | null;
+
+    metadata?: Message.Metadata;
+
+    source?: 'cloud' | 'telegram' | 'api' | 'workflow' | 'notification';
+
+    synthetic?: boolean;
+
+    /**
+     * @deprecated Deprecated: use createdBy.
+     */
+    userId?: string | null;
+  }
+
+  export namespace Message {
+    export interface Part {
+      type: string;
+
+      [k: string]: unknown;
+    }
+
+    export interface Metadata {
+      agent?: string;
+
+      agentMessageId?: string;
+
+      agentSessionId?: string;
+
+      turnAnchorMessageId?: string;
+    }
+  }
+}
+
+export interface ConversationRejectQuestionResponse {
+  ok: true;
+}
+
+export interface ConversationSendResponse {
+  assistantText: string;
+
+  chatSessionId: string;
+
+  errorText?: string;
+}
+
+export type ConversationStreamResponse = string;
+
+export interface ConversationCreateParams {
+  /**
+   * Body param
+   */
+  title: string;
+
+  /**
+   * Body param
+   */
+  agent?: string;
+
+  /**
+   * Body param
+   */
+  description?: string;
+
+  /**
+   * Header param: Optional client key. Reusing the same key with the same request
+   * body by the same authenticated caller within 24 hours returns the
+   * already-created session instead of a second one.
+   */
+  'Idempotency-Key'?: string;
+}
+
+export interface ConversationUpdateParams {
+  description?: string | null;
+
+  pinned?: boolean;
+
+  status?: 'active' | 'archived';
+
+  title?: string;
+}
+
+export interface ConversationListParams {
+  kind?: 'chat' | 'agent_workflow';
+
+  mine?: 'true' | 'false';
+
+  workflowId?: string;
+}
+
+export interface ConversationAbortParams {
+  sessionId: string;
+}
+
+export interface ConversationAnswerPermissionParams {
+  permissionId: string;
+
+  response: 'once' | 'always' | 'reject';
+}
+
+export interface ConversationAnswerQuestionParams {
+  answers: Array<
+    Array<
+      | ConversationAnswerQuestionParams.Label
+      | ConversationAnswerQuestionParams.Custom
+      | ConversationAnswerQuestionParams.UnionMember2
+    >
+  >;
+
+  questionId: string;
+}
+
+export namespace ConversationAnswerQuestionParams {
+  export interface Label {
+    label: string;
+  }
+
+  export interface Custom {
+    custom: string;
+  }
+
+  export interface UnionMember2 {
+    custom: string;
+
+    label: string;
+  }
+}
+
+export interface ConversationHistoryParams {
+  sessionId: string;
+
+  limit?: number;
+}
+
+export interface ConversationRejectQuestionParams {
+  questionId: string;
+}
+
+export interface ConversationSendParams {
+  message: string;
+
+  sessionId: string;
+
+  agent?: string;
+}
+
+export interface ConversationStreamParams {
+  sessionId: string;
+}
+
+export declare namespace Conversations {
+  export {
+    type ConversationCreateResponse as ConversationCreateResponse,
+    type ConversationUpdateResponse as ConversationUpdateResponse,
+    type ConversationListResponse as ConversationListResponse,
+    type ConversationAbortResponse as ConversationAbortResponse,
+    type ConversationAnswerPermissionResponse as ConversationAnswerPermissionResponse,
+    type ConversationAnswerQuestionResponse as ConversationAnswerQuestionResponse,
+    type ConversationHistoryResponse as ConversationHistoryResponse,
+    type ConversationRejectQuestionResponse as ConversationRejectQuestionResponse,
+    type ConversationSendResponse as ConversationSendResponse,
+    type ConversationStreamResponse as ConversationStreamResponse,
+    type ConversationCreateParams as ConversationCreateParams,
+    type ConversationUpdateParams as ConversationUpdateParams,
+    type ConversationListParams as ConversationListParams,
+    type ConversationAbortParams as ConversationAbortParams,
+    type ConversationAnswerPermissionParams as ConversationAnswerPermissionParams,
+    type ConversationAnswerQuestionParams as ConversationAnswerQuestionParams,
+    type ConversationHistoryParams as ConversationHistoryParams,
+    type ConversationRejectQuestionParams as ConversationRejectQuestionParams,
+    type ConversationSendParams as ConversationSendParams,
+    type ConversationStreamParams as ConversationStreamParams,
+  };
+}

package/src/resources/assistant/index.ts

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Assistant } from './assistant';
+export {
+  Conversations,
+  type ConversationCreateResponse,
+  type ConversationUpdateResponse,
+  type ConversationListResponse,
+  type ConversationAbortResponse,
+  type ConversationAnswerPermissionResponse,
+  type ConversationAnswerQuestionResponse,
+  type ConversationHistoryResponse,
+  type ConversationRejectQuestionResponse,
+  type ConversationSendResponse,
+  type ConversationStreamResponse,
+  type ConversationCreateParams,
+  type ConversationUpdateParams,
+  type ConversationListParams,
+  type ConversationAbortParams,
+  type ConversationAnswerPermissionParams,
+  type ConversationAnswerQuestionParams,
+  type ConversationHistoryParams,
+  type ConversationRejectQuestionParams,
+  type ConversationSendParams,
+  type ConversationStreamParams,
+} from './conversations';

package/src/resources/assistant.ts

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

package/src/resources/credentials/credentials.ts

@@ -6,10 +6,10 @@ import * as PackagesAPI from './packages/packages';
 import {
   PackageCreateParams,
   PackageCreateResponse,
+  PackageListAllResponse,
   PackageListResponse,
   Packages,
 } from './packages/packages';
-import * as PackagesCredentialsAPI from './packages/credentials/credentials';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 
@@ -30,11 +30,48 @@ export class Credentials extends APIResource {
 }
 
 export interface CredentialListResponse {
-  items: Array<PackagesCredentialsAPI.Credential>;
+  items: Array<CredentialListResponse.Item>;
 
   pagination: Shared.Pagination;
 }
 
+export namespace CredentialListResponse {
+  export interface Item {
+    createdBy: string | null;
+
+    credentialName: string;
+
+    fields: Array<Item.Field>;
+
+    ownerId: string;
+
+    packageName: string;
+
+    secretPath: string;
+
+    /**
+     * @deprecated Deprecated: use createdBy (same value — the creating actor). Null
+     * for credentials created before rollout.
+     */
+    userId: string | null;
+  }
+
+  export namespace Item {
+    export interface Field {
+      fieldType:
+        | 'email'
+        | 'username'
+        | 'password'
+        | 'api_token'
+        | 'phone_number'
+        | 'two_factor_secret'
+        | 'backup_codes';
+
+      value: string;
+    }
+  }
+}
+
 export interface CredentialListParams {
   page?: number;
 
@@ -53,6 +90,7 @@ export declare namespace Credentials {
     Packages as Packages,
     type PackageCreateResponse as PackageCreateResponse,
     type PackageListResponse as PackageListResponse,
+    type PackageListAllResponse as PackageListAllResponse,
     type PackageCreateParams as PackageCreateParams,
   };
 }

package/src/resources/credentials/index.ts

@@ -5,5 +5,6 @@ export {
   Packages,
   type PackageCreateResponse,
   type PackageListResponse,
+  type PackageListAllResponse,
   type PackageCreateParams,
 } from './packages/index';