@letta-ai/letta-client 1.6.3 → 1.6.5

package/resources/conversations/conversations.mjs

@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as MessagesAPI from "./messages.mjs";
+import { Messages, } from "./messages.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Conversations extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.messages = new MessagesAPI.Messages(this._client);
+    }
+    /**
+     * Create a new conversation for an agent.
+     */
+    create(params, options) {
+        const { agent_id, ...body } = params;
+        return this._client.post('/v1/conversations/', { query: { agent_id }, body, ...options });
+    }
+    /**
+     * Retrieve a specific conversation.
+     */
+    retrieve(conversationID, options) {
+        return this._client.get(path `/v1/conversations/${conversationID}`, options);
+    }
+    /**
+     * List all conversations for an agent.
+     */
+    list(query, options) {
+        return this._client.get('/v1/conversations/', { query, ...options });
+    }
+}
+Conversations.Messages = Messages;
+//# sourceMappingURL=conversations.mjs.map

package/resources/conversations/conversations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.mjs","sourceRoot":"","sources":["../../src/resources/conversations/conversations.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EAML,QAAQ,GACT;OAGM,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,aAAc,SAAQ,WAAW;IAA9C;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAuB1E,CAAC;IArBC;;OAEG;IACH,MAAM,CAAC,MAAgC,EAAE,OAAwB;QAC/D,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,cAAsB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,qBAAqB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAA6B,EAAE,OAAwB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;CACF;AAwFD,aAAa,CAAC,QAAQ,GAAG,QAAQ,CAAC"}

package/resources/conversations/index.d.mts

@@ -0,0 +1,3 @@
+export { Conversations, type Conversation, type CreateConversation, type ConversationListResponse, type ConversationCreateParams, type ConversationListParams, } from "./conversations.mjs";
+export { Messages, type MessageListResponse, type MessageStreamResponse, type MessageCreateParams, type MessageListParams, type MessageStreamParams, } from "./messages.mjs";
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/conversations/index.ts"],"names":[],"mappings":"OAEO,EACL,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B;OACM,EACL,QAAQ,EACR,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB"}

package/resources/conversations/index.d.ts

@@ -0,0 +1,3 @@
+export { Conversations, type Conversation, type CreateConversation, type ConversationListResponse, type ConversationCreateParams, type ConversationListParams, } from "./conversations.js";
+export { Messages, type MessageListResponse, type MessageStreamResponse, type MessageCreateParams, type MessageListParams, type MessageStreamParams, } from "./messages.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/conversations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/conversations/index.ts"],"names":[],"mappings":"OAEO,EACL,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B;OACM,EACL,QAAQ,EACR,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB"}

package/resources/conversations/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Messages = exports.Conversations = void 0;
+var conversations_1 = require("./conversations.js");
+Object.defineProperty(exports, "Conversations", { enumerable: true, get: function () { return conversations_1.Conversations; } });
+var messages_1 = require("./messages.js");
+Object.defineProperty(exports, "Messages", { enumerable: true, get: function () { return messages_1.Messages; } });
+//# sourceMappingURL=index.js.map

package/resources/conversations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/conversations/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,oDAOyB;AANvB,8GAAA,aAAa,OAAA;AAOf,0CAOoB;AANlB,oGAAA,QAAQ,OAAA"}

package/resources/conversations/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Conversations, } from "./conversations.mjs";
+export { Messages, } from "./messages.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/conversations/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/conversations/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,aAAa,GAMd;OACM,EACL,QAAQ,GAMT"}

package/resources/conversations/messages.d.mts

@@ -0,0 +1,198 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as AgentsAPI from "../agents/agents.mjs";
+import * as MessagesAPI from "../agents/messages.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { Stream } from "../../core/streaming.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Messages extends APIResource {
+    /**
+     * Send a message to a conversation and get a streaming response.
+     *
+     * This endpoint sends a message to an existing conversation and streams the
+     * agent's response back.
+     */
+    create(conversationID: string, body: MessageCreateParams, options?: RequestOptions): APIPromise<Stream<MessagesAPI.LettaStreamingResponse>>;
+    /**
+     * List all messages in a conversation.
+     *
+     * Returns LettaMessage objects (UserMessage, AssistantMessage, etc.) for all
+     * messages in the conversation, ordered by position (oldest first), with support
+     * for cursor-based pagination.
+     */
+    list(conversationID: string, query?: MessageListParams | null | undefined, options?: RequestOptions): APIPromise<MessageListResponse>;
+    /**
+     * Resume the stream for the most recent active run in a conversation.
+     *
+     * This endpoint allows you to reconnect to an active background stream for a
+     * conversation, enabling recovery from network interruptions.
+     */
+    stream(conversationID: string, body?: MessageStreamParams | undefined, options?: RequestOptions): APIPromise<Stream<MessagesAPI.LettaStreamingResponse>>;
+}
+export type MessageListResponse = Array<MessagesAPI.Message>;
+export type MessageStreamResponse = unknown;
+export interface MessageCreateParams {
+    /**
+     * @deprecated The name of the message argument in the designated message tool.
+     * Still supported for legacy agent types, but deprecated for letta_v1_agent
+     * onward.
+     */
+    assistant_message_tool_kwarg?: string;
+    /**
+     * @deprecated The name of the designated message tool. Still supported for legacy
+     * agent types, but deprecated for letta_v1_agent onward.
+     */
+    assistant_message_tool_name?: string;
+    /**
+     * Whether to process the request in the background (only used when
+     * streaming=true).
+     */
+    background?: boolean;
+    /**
+     * Client-side tools that the agent can call. When the agent calls a client-side
+     * tool, execution pauses and returns control to the client to execute the tool and
+     * provide the result via a ToolReturn.
+     */
+    client_tools?: Array<MessageCreateParams.ClientTool> | null;
+    /**
+     * @deprecated If set to True, enables reasoning before responses or tool calls
+     * from the agent.
+     */
+    enable_thinking?: string;
+    /**
+     * Whether to include periodic keepalive ping messages in the stream to prevent
+     * connection timeouts (only used when streaming=true).
+     */
+    include_pings?: boolean;
+    /**
+     * Only return specified message types in the response. If `None` (default) returns
+     * all messages.
+     */
+    include_return_message_types?: Array<MessagesAPI.MessageType> | null;
+    /**
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
+     */
+    input?: string | Array<MessagesAPI.TextContent | MessagesAPI.ImageContent | MessagesAPI.ToolCallContent | MessagesAPI.ToolReturnContent | MessagesAPI.ReasoningContent | MessagesAPI.RedactedReasoningContent | MessagesAPI.OmittedReasoningContent | MessageCreateParams.SummarizedReasoningContent> | null;
+    /**
+     * Maximum number of steps the agent should take to process the request.
+     */
+    max_steps?: number;
+    /**
+     * The messages to be sent to the agent.
+     */
+    messages?: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate> | null;
+    /**
+     * Flag to determine if individual tokens should be streamed, rather than streaming
+     * per step (only used when streaming=true).
+     */
+    stream_tokens?: boolean;
+    /**
+     * If True, returns a streaming response (Server-Sent Events). If False (default),
+     * returns a complete response.
+     */
+    streaming?: boolean;
+    /**
+     * @deprecated Whether the server should parse specific tool call arguments
+     * (default `send_message`) as `AssistantMessage` objects. Still supported for
+     * legacy agent types, but deprecated for letta_v1_agent onward.
+     */
+    use_assistant_message?: boolean;
+}
+export declare namespace MessageCreateParams {
+    /**
+     * Schema for a client-side tool passed in the request.
+     *
+     * Client-side tools are executed by the client, not the server. When the agent
+     * calls a client-side tool, execution pauses and returns control to the client to
+     * execute the tool and provide the result.
+     */
+    interface ClientTool {
+        /**
+         * The name of the tool function
+         */
+        name: string;
+        /**
+         * Description of what the tool does
+         */
+        description?: string | null;
+        /**
+         * JSON Schema for the function parameters
+         */
+        parameters?: {
+            [key: string]: unknown;
+        } | null;
+    }
+    /**
+     * The style of reasoning content returned by the OpenAI Responses API
+     */
+    interface SummarizedReasoningContent {
+        /**
+         * The unique identifier for this reasoning step.
+         */
+        id: string;
+        /**
+         * Summaries of the reasoning content.
+         */
+        summary: Array<SummarizedReasoningContent.Summary>;
+        /**
+         * The encrypted reasoning content.
+         */
+        encrypted_content?: string;
+        /**
+         * Indicates this is a summarized reasoning step.
+         */
+        type?: 'summarized_reasoning';
+    }
+    namespace SummarizedReasoningContent {
+        interface Summary {
+            /**
+             * The index of the summary part.
+             */
+            index: number;
+            /**
+             * The text of the summary part.
+             */
+            text: string;
+        }
+    }
+}
+export interface MessageListParams {
+    /**
+     * Message ID cursor for pagination. Returns messages that come after this message
+     * ID in the conversation
+     */
+    after?: string | null;
+    /**
+     * Message ID cursor for pagination. Returns messages that come before this message
+     * ID in the conversation
+     */
+    before?: string | null;
+    /**
+     * Maximum number of messages to return
+     */
+    limit?: number | null;
+}
+export interface MessageStreamParams {
+    /**
+     * Number of entries to read per batch.
+     */
+    batch_size?: number | null;
+    /**
+     * Whether to include periodic keepalive ping messages in the stream to prevent
+     * connection timeouts.
+     */
+    include_pings?: boolean | null;
+    /**
+     * Seconds to wait between polls when no new data.
+     */
+    poll_interval?: number | null;
+    /**
+     * Sequence id to use as a cursor for pagination. Response will start streaming
+     * after this chunk sequence id
+     */
+    starting_after?: number;
+}
+export declare namespace Messages {
+    export { type MessageListResponse as MessageListResponse, type MessageStreamResponse as MessageStreamResponse, type MessageCreateParams as MessageCreateParams, type MessageListParams as MessageListParams, type MessageStreamParams as MessageStreamParams, };
+}
+//# sourceMappingURL=messages.d.mts.map

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

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

package/resources/conversations/messages.d.ts

@@ -0,0 +1,198 @@
+import { APIResource } from "../../core/resource.js";
+import * as AgentsAPI from "../agents/agents.js";
+import * as MessagesAPI from "../agents/messages.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { Stream } from "../../core/streaming.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Messages extends APIResource {
+    /**
+     * Send a message to a conversation and get a streaming response.
+     *
+     * This endpoint sends a message to an existing conversation and streams the
+     * agent's response back.
+     */
+    create(conversationID: string, body: MessageCreateParams, options?: RequestOptions): APIPromise<Stream<MessagesAPI.LettaStreamingResponse>>;
+    /**
+     * List all messages in a conversation.
+     *
+     * Returns LettaMessage objects (UserMessage, AssistantMessage, etc.) for all
+     * messages in the conversation, ordered by position (oldest first), with support
+     * for cursor-based pagination.
+     */
+    list(conversationID: string, query?: MessageListParams | null | undefined, options?: RequestOptions): APIPromise<MessageListResponse>;
+    /**
+     * Resume the stream for the most recent active run in a conversation.
+     *
+     * This endpoint allows you to reconnect to an active background stream for a
+     * conversation, enabling recovery from network interruptions.
+     */
+    stream(conversationID: string, body?: MessageStreamParams | undefined, options?: RequestOptions): APIPromise<Stream<MessagesAPI.LettaStreamingResponse>>;
+}
+export type MessageListResponse = Array<MessagesAPI.Message>;
+export type MessageStreamResponse = unknown;
+export interface MessageCreateParams {
+    /**
+     * @deprecated The name of the message argument in the designated message tool.
+     * Still supported for legacy agent types, but deprecated for letta_v1_agent
+     * onward.
+     */
+    assistant_message_tool_kwarg?: string;
+    /**
+     * @deprecated The name of the designated message tool. Still supported for legacy
+     * agent types, but deprecated for letta_v1_agent onward.
+     */
+    assistant_message_tool_name?: string;
+    /**
+     * Whether to process the request in the background (only used when
+     * streaming=true).
+     */
+    background?: boolean;
+    /**
+     * Client-side tools that the agent can call. When the agent calls a client-side
+     * tool, execution pauses and returns control to the client to execute the tool and
+     * provide the result via a ToolReturn.
+     */
+    client_tools?: Array<MessageCreateParams.ClientTool> | null;
+    /**
+     * @deprecated If set to True, enables reasoning before responses or tool calls
+     * from the agent.
+     */
+    enable_thinking?: string;
+    /**
+     * Whether to include periodic keepalive ping messages in the stream to prevent
+     * connection timeouts (only used when streaming=true).
+     */
+    include_pings?: boolean;
+    /**
+     * Only return specified message types in the response. If `None` (default) returns
+     * all messages.
+     */
+    include_return_message_types?: Array<MessagesAPI.MessageType> | null;
+    /**
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
+     */
+    input?: string | Array<MessagesAPI.TextContent | MessagesAPI.ImageContent | MessagesAPI.ToolCallContent | MessagesAPI.ToolReturnContent | MessagesAPI.ReasoningContent | MessagesAPI.RedactedReasoningContent | MessagesAPI.OmittedReasoningContent | MessageCreateParams.SummarizedReasoningContent> | null;
+    /**
+     * Maximum number of steps the agent should take to process the request.
+     */
+    max_steps?: number;
+    /**
+     * The messages to be sent to the agent.
+     */
+    messages?: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate> | null;
+    /**
+     * Flag to determine if individual tokens should be streamed, rather than streaming
+     * per step (only used when streaming=true).
+     */
+    stream_tokens?: boolean;
+    /**
+     * If True, returns a streaming response (Server-Sent Events). If False (default),
+     * returns a complete response.
+     */
+    streaming?: boolean;
+    /**
+     * @deprecated Whether the server should parse specific tool call arguments
+     * (default `send_message`) as `AssistantMessage` objects. Still supported for
+     * legacy agent types, but deprecated for letta_v1_agent onward.
+     */
+    use_assistant_message?: boolean;
+}
+export declare namespace MessageCreateParams {
+    /**
+     * Schema for a client-side tool passed in the request.
+     *
+     * Client-side tools are executed by the client, not the server. When the agent
+     * calls a client-side tool, execution pauses and returns control to the client to
+     * execute the tool and provide the result.
+     */
+    interface ClientTool {
+        /**
+         * The name of the tool function
+         */
+        name: string;
+        /**
+         * Description of what the tool does
+         */
+        description?: string | null;
+        /**
+         * JSON Schema for the function parameters
+         */
+        parameters?: {
+            [key: string]: unknown;
+        } | null;
+    }
+    /**
+     * The style of reasoning content returned by the OpenAI Responses API
+     */
+    interface SummarizedReasoningContent {
+        /**
+         * The unique identifier for this reasoning step.
+         */
+        id: string;
+        /**
+         * Summaries of the reasoning content.
+         */
+        summary: Array<SummarizedReasoningContent.Summary>;
+        /**
+         * The encrypted reasoning content.
+         */
+        encrypted_content?: string;
+        /**
+         * Indicates this is a summarized reasoning step.
+         */
+        type?: 'summarized_reasoning';
+    }
+    namespace SummarizedReasoningContent {
+        interface Summary {
+            /**
+             * The index of the summary part.
+             */
+            index: number;
+            /**
+             * The text of the summary part.
+             */
+            text: string;
+        }
+    }
+}
+export interface MessageListParams {
+    /**
+     * Message ID cursor for pagination. Returns messages that come after this message
+     * ID in the conversation
+     */
+    after?: string | null;
+    /**
+     * Message ID cursor for pagination. Returns messages that come before this message
+     * ID in the conversation
+     */
+    before?: string | null;
+    /**
+     * Maximum number of messages to return
+     */
+    limit?: number | null;
+}
+export interface MessageStreamParams {
+    /**
+     * Number of entries to read per batch.
+     */
+    batch_size?: number | null;
+    /**
+     * Whether to include periodic keepalive ping messages in the stream to prevent
+     * connection timeouts.
+     */
+    include_pings?: boolean | null;
+    /**
+     * Seconds to wait between polls when no new data.
+     */
+    poll_interval?: number | null;
+    /**
+     * Sequence id to use as a cursor for pagination. Response will start streaming
+     * after this chunk sequence id
+     */
+    starting_after?: number;
+}
+export declare namespace Messages {
+    export { type MessageListResponse as MessageListResponse, type MessageStreamResponse as MessageStreamResponse, type MessageCreateParams as MessageCreateParams, type MessageListParams as MessageListParams, type MessageStreamParams as MessageStreamParams, };
+}
+//# sourceMappingURL=messages.d.ts.map

package/resources/conversations/messages.d.ts.map

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

package/resources/conversations/messages.js

@@ -0,0 +1,46 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Messages = void 0;
+const resource_1 = require("../../core/resource.js");
+const path_1 = require("../../internal/utils/path.js");
+class Messages extends resource_1.APIResource {
+    /**
+     * Send a message to a conversation and get a streaming response.
+     *
+     * This endpoint sends a message to an existing conversation and streams the
+     * agent's response back.
+     */
+    create(conversationID, body, options) {
+        return this._client.post((0, path_1.path) `/v1/conversations/${conversationID}/messages`, {
+            body,
+            ...options,
+            stream: true,
+        });
+    }
+    /**
+     * List all messages in a conversation.
+     *
+     * Returns LettaMessage objects (UserMessage, AssistantMessage, etc.) for all
+     * messages in the conversation, ordered by position (oldest first), with support
+     * for cursor-based pagination.
+     */
+    list(conversationID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/conversations/${conversationID}/messages`, { query, ...options });
+    }
+    /**
+     * Resume the stream for the most recent active run in a conversation.
+     *
+     * This endpoint allows you to reconnect to an active background stream for a
+     * conversation, enabling recovery from network interruptions.
+     */
+    stream(conversationID, body = {}, options) {
+        return this._client.post((0, path_1.path) `/v1/conversations/${conversationID}/stream`, {
+            body,
+            ...options,
+            stream: true,
+        });
+    }
+}
+exports.Messages = Messages;
+//# sourceMappingURL=messages.js.map

package/resources/conversations/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/resources/conversations/messages.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAMlD,uDAAiD;AAEjD,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;OAKG;IACH,MAAM,CACJ,cAAsB,EACtB,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,WAAW,EAAE;YAC3E,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI;SACb,CAA2D,CAAC;IAC/D,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CACF,cAAsB,EACtB,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrG,CAAC;IAED;;;;;OAKG;IACH,MAAM,CACJ,cAAsB,EACtB,OAAwC,EAAE,EAC1C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,qBAAqB,cAAc,SAAS,EAAE;YACzE,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI;SACb,CAA2D,CAAC;IAC/D,CAAC;CACF;AAnDD,4BAmDC"}

package/resources/conversations/messages.mjs

@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Messages extends APIResource {
+    /**
+     * Send a message to a conversation and get a streaming response.
+     *
+     * This endpoint sends a message to an existing conversation and streams the
+     * agent's response back.
+     */
+    create(conversationID, body, options) {
+        return this._client.post(path `/v1/conversations/${conversationID}/messages`, {
+            body,
+            ...options,
+            stream: true,
+        });
+    }
+    /**
+     * List all messages in a conversation.
+     *
+     * Returns LettaMessage objects (UserMessage, AssistantMessage, etc.) for all
+     * messages in the conversation, ordered by position (oldest first), with support
+     * for cursor-based pagination.
+     */
+    list(conversationID, query = {}, options) {
+        return this._client.get(path `/v1/conversations/${conversationID}/messages`, { query, ...options });
+    }
+    /**
+     * Resume the stream for the most recent active run in a conversation.
+     *
+     * This endpoint allows you to reconnect to an active background stream for a
+     * conversation, enabling recovery from network interruptions.
+     */
+    stream(conversationID, body = {}, options) {
+        return this._client.post(path `/v1/conversations/${conversationID}/stream`, {
+            body,
+            ...options,
+            stream: true,
+        });
+    }
+}
+//# sourceMappingURL=messages.mjs.map

package/resources/conversations/messages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.mjs","sourceRoot":"","sources":["../../src/resources/conversations/messages.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAMf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;OAKG;IACH,MAAM,CACJ,cAAsB,EACtB,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,cAAc,WAAW,EAAE;YAC3E,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI;SACb,CAA2D,CAAC;IAC/D,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CACF,cAAsB,EACtB,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,qBAAqB,cAAc,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrG,CAAC;IAED;;;;;OAKG;IACH,MAAM,CACJ,cAAsB,EACtB,OAAwC,EAAE,EAC1C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,qBAAqB,cAAc,SAAS,EAAE;YACzE,IAAI;YACJ,GAAG,OAAO;YACV,MAAM,EAAE,IAAI;SACb,CAA2D,CAAC;IAC/D,CAAC;CACF"}

package/resources/conversations.d.mts

@@ -0,0 +1,2 @@
+export * from "./conversations/index.mjs";
+//# sourceMappingURL=conversations.d.mts.map

package/resources/conversations.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.mts","sourceRoot":"","sources":["../src/resources/conversations.ts"],"names":[],"mappings":""}

package/resources/conversations.d.ts

@@ -0,0 +1,2 @@
+export * from "./conversations/index.js";
+//# sourceMappingURL=conversations.d.ts.map

package/resources/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../src/resources/conversations.ts"],"names":[],"mappings":""}

package/resources/conversations.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./conversations/index.js"), exports);
+//# sourceMappingURL=conversations.js.map

package/resources/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../src/resources/conversations.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,mEAAsC"}

package/resources/conversations.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./conversations/index.mjs";
+//# sourceMappingURL=conversations.mjs.map

package/resources/conversations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.mjs","sourceRoot":"","sources":["../src/resources/conversations.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/index.d.mts

@@ -3,6 +3,7 @@ export { Agents, type AgentEnvironmentVariable, type AgentState, type AgentType,
 export { Archives, type Archive, type VectorDBProvider, type ArchiveCreateParams, type ArchiveUpdateParams, type ArchiveListParams, type ArchivesArrayPage, } from "./archives/archives.mjs";
 export { Batches, type BatchJob, type BatchCancelResponse, type BatchCreateParams, type BatchListParams, type BatchJobsArrayPage, } from "./batches/batches.mjs";
 export { Blocks, type BlockResponse, type CreateBlock, type BlockDeleteResponse, type BlockCreateParams, type BlockUpdateParams, type BlockListParams, type BlockResponsesArrayPage, } from "./blocks/blocks.mjs";
+export { Conversations, type Conversation, type CreateConversation, type ConversationListResponse, type ConversationCreateParams, type ConversationListParams, } from "./conversations/conversations.mjs";
 export { Folders, type Folder, type FolderDeleteResponse, type FolderCreateParams, type FolderUpdateParams, type FolderListParams, type FoldersArrayPage, } from "./folders/folders.mjs";
 export { Groups, type DynamicManager, type Group, type ManagerType, type RoundRobinManager, type SleeptimeManager, type SupervisorManager, type VoiceSleeptimeManager, type GroupDeleteResponse, type GroupCreateParams, type GroupUpdateParams, type GroupListParams, type GroupsArrayPage, } from "./groups/groups.mjs";
 export { Identities, type Identity, type IdentityProperty, type IdentityType, type IdentityDeleteResponse, type IdentityCreateParams, type IdentityUpdateParams, type IdentityListParams, type IdentityUpsertParams, type IdentitiesArrayPage, } from "./identities/identities.mjs";