@letta-ai/letta-client 1.6.3 → 1.6.5

package/src/resources/conversations/messages.ts

@@ -0,0 +1,277 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as AgentsAPI from '../agents/agents';
+import * as MessagesAPI from '../agents/messages';
+import { APIPromise } from '../../core/api-promise';
+import { Stream } from '../../core/streaming';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+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: string,
+    body: MessageCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<Stream<MessagesAPI.LettaStreamingResponse>> {
+    return this._client.post(path`/v1/conversations/${conversationID}/messages`, {
+      body,
+      ...options,
+      stream: true,
+    }) as 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> {
+    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: string,
+    body: MessageStreamParams | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Stream<MessagesAPI.LettaStreamingResponse>> {
+    return this._client.post(path`/v1/conversations/${conversationID}/stream`, {
+      body,
+      ...options,
+      stream: true,
+    }) as 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 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.
+   */
+  export 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
+   */
+  export 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';
+  }
+
+  export namespace SummarizedReasoningContent {
+    export 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,
+  };
+}

package/src/resources/conversations.ts

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

package/src/resources/index.ts

@@ -76,6 +76,14 @@ export {
   type BlockListParams,
   type BlockResponsesArrayPage,
 } from './blocks/blocks';
+export {
+  Conversations,
+  type Conversation,
+  type CreateConversation,
+  type ConversationListResponse,
+  type ConversationCreateParams,
+  type ConversationListParams,
+} from './conversations/conversations';
 export {
   Folders,
   type Folder,

package/src/resources/messages.ts

@@ -33,6 +33,11 @@ export interface MessageSearchRequest {
    */
   query: string;
 
+  /**
+   * Filter messages by agent ID
+   */
+  agent_id?: string | null;
+
   /**
    * Filter messages created on or before this date
    */
@@ -246,6 +251,11 @@ export interface MessageSearchParams {
    */
   query: string;
 
+  /**
+   * Filter messages by agent ID
+   */
+  agent_id?: string | null;
+
   /**
    * Filter messages created on or before this date
    */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.6.3'; // x-release-please-version
+export const VERSION = '1.6.5'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.6.3";
+export declare const VERSION = "1.6.5";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.6.3";
+export declare const VERSION = "1.6.5";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.6.3'; // x-release-please-version
+exports.VERSION = '1.6.5'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.6.3'; // x-release-please-version
+export const VERSION = '1.6.5'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map