@mobilerun/sdk 5.2.1 → 5.4.0

package/resources/assistant/assistant.d.ts

@@ -0,0 +1,10 @@
+import { APIResource } from "../../core/resource.js";
+import * as ConversationsAPI from "./conversations.js";
+import { ConversationAbortParams, ConversationAbortResponse, ConversationAnswerPermissionParams, ConversationAnswerPermissionResponse, ConversationAnswerQuestionParams, ConversationAnswerQuestionResponse, ConversationCreateParams, ConversationCreateResponse, ConversationHistoryParams, ConversationHistoryResponse, ConversationListParams, ConversationListResponse, ConversationRejectQuestionParams, ConversationRejectQuestionResponse, ConversationSendParams, ConversationSendResponse, ConversationStreamParams, ConversationStreamResponse, ConversationUpdateParams, ConversationUpdateResponse, Conversations } from "./conversations.js";
+export declare class Assistant extends APIResource {
+    conversations: ConversationsAPI.Conversations;
+}
+export declare namespace Assistant {
+    export { Conversations as Conversations, 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, };
+}
+//# sourceMappingURL=assistant.d.ts.map

package/resources/assistant/assistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.d.ts","sourceRoot":"","sources":["../../src/resources/assistant/assistant.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,gBAAgB,2BAAwB;AACpD,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kCAAkC,EAClC,oCAAoC,EACpC,gCAAgC,EAChC,kCAAkC,EAClC,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,gCAAgC,EAChC,kCAAkC,EAClC,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,aAAa,EACd,2BAAwB;AAEzB,qBAAa,SAAU,SAAQ,WAAW;IACxC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;CAClG;AAID,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,oCAAoC,IAAI,oCAAoC,EACjF,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,gCAAgC,IAAI,gCAAgC,EACzE,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,gCAAgC,IAAI,gCAAgC,EACzE,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,wBAAwB,IAAI,wBAAwB,GAC1D,CAAC;CACH"}

package/resources/assistant/assistant.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Assistant = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const ConversationsAPI = tslib_1.__importStar(require("./conversations.js"));
+const conversations_1 = require("./conversations.js");
+class Assistant extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.conversations = new ConversationsAPI.Conversations(this._client);
+    }
+}
+exports.Assistant = Assistant;
+Assistant.Conversations = conversations_1.Conversations;
+//# sourceMappingURL=assistant.js.map

package/resources/assistant/assistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.js","sourceRoot":"","sources":["../../src/resources/assistant/assistant.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,6EAAoD;AACpD,sDAsByB;AAEzB,MAAa,SAAU,SAAQ,sBAAW;IAA1C;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAFD,8BAEC;AAED,SAAS,CAAC,aAAa,GAAG,6BAAa,CAAC"}

package/resources/assistant/assistant.mjs

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as ConversationsAPI from "./conversations.mjs";
+import { Conversations, } from "./conversations.mjs";
+export class Assistant extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.conversations = new ConversationsAPI.Conversations(this._client);
+    }
+}
+Assistant.Conversations = Conversations;
+//# sourceMappingURL=assistant.mjs.map

package/resources/assistant/assistant.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.mjs","sourceRoot":"","sources":["../../src/resources/assistant/assistant.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,4BAAwB;AACpD,OAAO,EAqBL,aAAa,GACd,4BAAwB;AAEzB,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAED,SAAS,CAAC,aAAa,GAAG,aAAa,CAAC"}

package/resources/assistant/conversations.d.mts

@@ -0,0 +1,295 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { Stream } from "../../core/streaming.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * Deliver a HITL approval/rejection for an in-flight turn.
+     */
+    answerPermission(body: ConversationAnswerPermissionParams, options?: RequestOptions): APIPromise<ConversationAnswerPermissionResponse>;
+    /**
+     * 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 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>>;
+}
+export interface ConversationCreateResponse {
+    session: ConversationCreateResponse.Session;
+}
+export declare namespace ConversationCreateResponse {
+    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 declare namespace ConversationUpdateResponse {
+    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 declare namespace ConversationListResponse {
+    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;
+    }
+    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 declare namespace ConversationHistoryResponse {
+    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;
+    }
+    namespace Message {
+        interface Part {
+            type: string;
+            [k: string]: unknown;
+        }
+        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 declare namespace ConversationAnswerQuestionParams {
+    interface Label {
+        label: string;
+    }
+    interface Custom {
+        custom: string;
+    }
+    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, };
+}
+//# sourceMappingURL=conversations.d.mts.map

package/resources/assistant/conversations.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.mts","sourceRoot":"","sources":["../../src/resources/assistant/conversations.ts"],"names":[],"mappings":"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"}

package/resources/assistant/conversations.d.ts

@@ -0,0 +1,295 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { Stream } from "../../core/streaming.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * Deliver a HITL approval/rejection for an in-flight turn.
+     */
+    answerPermission(body: ConversationAnswerPermissionParams, options?: RequestOptions): APIPromise<ConversationAnswerPermissionResponse>;
+    /**
+     * 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 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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * 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>>;
+}
+export interface ConversationCreateResponse {
+    session: ConversationCreateResponse.Session;
+}
+export declare namespace ConversationCreateResponse {
+    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 declare namespace ConversationUpdateResponse {
+    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 declare namespace ConversationListResponse {
+    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;
+    }
+    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 declare namespace ConversationHistoryResponse {
+    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;
+    }
+    namespace Message {
+        interface Part {
+            type: string;
+            [k: string]: unknown;
+        }
+        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 declare namespace ConversationAnswerQuestionParams {
+    interface Label {
+        label: string;
+    }
+    interface Custom {
+        custom: string;
+    }
+    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, };
+}
+//# sourceMappingURL=conversations.d.ts.map