@letta-ai/letta-client 1.6.4 → 1.6.6

package/src/resources/blocks/blocks.ts

@@ -133,6 +133,11 @@ export interface BlockResponse {
    */
   read_only?: boolean;
 
+  /**
+   * The tags associated with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * @deprecated (Deprecated) The id of the template.
    */
@@ -210,6 +215,11 @@ export interface CreateBlock {
    */
   read_only?: boolean;
 
+  /**
+   * The tags to associate with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * The id of the template.
    */
@@ -286,6 +296,11 @@ export interface BlockCreateParams {
    */
   read_only?: boolean;
 
+  /**
+   * The tags to associate with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * The id of the template.
    */
@@ -358,6 +373,11 @@ export interface BlockUpdateParams {
    */
   read_only?: boolean;
 
+  /**
+   * The tags to associate with the block.
+   */
+  tags?: Array<string> | null;
+
   /**
    * The id of the template.
    */
@@ -420,6 +440,12 @@ export interface BlockListParams extends ArrayPageParams {
    */
   label_search?: string | null;
 
+  /**
+   * If True, only returns blocks that match ALL given tags. Otherwise, return blocks
+   * that have ANY of the passed-in tags.
+   */
+  match_all_tags?: boolean;
+
   /**
    * Name filter (alphanumeric, spaces, hyphens, underscores)
    */
@@ -430,6 +456,11 @@ export interface BlockListParams extends ArrayPageParams {
    */
   project_id?: string | null;
 
+  /**
+   * List of tags to filter blocks by
+   */
+  tags?: Array<string> | null;
+
   /**
    * Whether to include only templates
    */

package/src/resources/conversations/conversations.ts

@@ -0,0 +1,168 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as MessagesAPI from './messages';
+import {
+  MessageCreateParams,
+  MessageListParams,
+  MessageListResponse,
+  MessageStreamParams,
+  MessageStreamResponse,
+  Messages,
+} from './messages';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Conversations extends APIResource {
+  messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
+
+  /**
+   * Create a new conversation for an agent.
+   */
+  create(params: ConversationCreateParams, options?: RequestOptions): APIPromise<Conversation> {
+    const { agent_id, ...body } = params;
+    return this._client.post('/v1/conversations/', { query: { agent_id }, body, ...options });
+  }
+
+  /**
+   * Retrieve a specific conversation.
+   */
+  retrieve(conversationID: string, options?: RequestOptions): APIPromise<Conversation> {
+    return this._client.get(path`/v1/conversations/${conversationID}`, options);
+  }
+
+  /**
+   * List all conversations for an agent.
+   */
+  list(query: ConversationListParams, options?: RequestOptions): APIPromise<ConversationListResponse> {
+    return this._client.get('/v1/conversations/', { query, ...options });
+  }
+}
+
+/**
+ * Represents a conversation on an agent for concurrent messaging.
+ */
+export interface Conversation {
+  /**
+   * The unique identifier of the conversation.
+   */
+  id: string;
+
+  /**
+   * The ID of the agent this conversation belongs to.
+   */
+  agent_id: string;
+
+  /**
+   * The timestamp when the object was created.
+   */
+  created_at?: string | null;
+
+  /**
+   * The id of the user that made this object.
+   */
+  created_by_id?: string | null;
+
+  /**
+   * The IDs of in-context messages for the conversation.
+   */
+  in_context_message_ids?: Array<string>;
+
+  /**
+   * IDs of blocks that are isolated (specific to this conversation, overriding agent
+   * defaults).
+   */
+  isolated_block_ids?: Array<string>;
+
+  /**
+   * The id of the user that made this object.
+   */
+  last_updated_by_id?: string | null;
+
+  /**
+   * A summary of the conversation.
+   */
+  summary?: string | null;
+
+  /**
+   * The timestamp when the object was last updated.
+   */
+  updated_at?: string | null;
+}
+
+/**
+ * Request model for creating a new conversation.
+ */
+export interface CreateConversation {
+  /**
+   * List of block labels that should be isolated (conversation-specific) rather than
+   * shared across conversations. New blocks will be created as copies of the agent's
+   * blocks with these labels.
+   */
+  isolated_block_labels?: Array<string> | null;
+
+  /**
+   * A summary of the conversation.
+   */
+  summary?: string | null;
+}
+
+export type ConversationListResponse = Array<Conversation>;
+
+export interface ConversationCreateParams {
+  /**
+   * Query param: The agent ID to create a conversation for
+   */
+  agent_id: string;
+
+  /**
+   * Body param: List of block labels that should be isolated (conversation-specific)
+   * rather than shared across conversations. New blocks will be created as copies of
+   * the agent's blocks with these labels.
+   */
+  isolated_block_labels?: Array<string> | null;
+
+  /**
+   * Body param: A summary of the conversation.
+   */
+  summary?: string | null;
+}
+
+export interface ConversationListParams {
+  /**
+   * The agent ID to list conversations for
+   */
+  agent_id: string;
+
+  /**
+   * Cursor for pagination (conversation ID)
+   */
+  after?: string | null;
+
+  /**
+   * Maximum number of conversations to return
+   */
+  limit?: number;
+}
+
+Conversations.Messages = Messages;
+
+export declare namespace Conversations {
+  export {
+    type Conversation as Conversation,
+    type CreateConversation as CreateConversation,
+    type ConversationListResponse as ConversationListResponse,
+    type ConversationCreateParams as ConversationCreateParams,
+    type ConversationListParams as ConversationListParams,
+  };
+
+  export {
+    Messages as Messages,
+    type MessageListResponse as MessageListResponse,
+    type MessageStreamResponse as MessageStreamResponse,
+    type MessageCreateParams as MessageCreateParams,
+    type MessageListParams as MessageListParams,
+    type MessageStreamParams as MessageStreamParams,
+  };
+}

package/src/resources/conversations/index.ts

@@ -0,0 +1,18 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Conversations,
+  type Conversation,
+  type CreateConversation,
+  type ConversationListResponse,
+  type ConversationCreateParams,
+  type ConversationListParams,
+} from './conversations';
+export {
+  Messages,
+  type MessageListResponse,
+  type MessageStreamResponse,
+  type MessageCreateParams,
+  type MessageListParams,
+  type MessageStreamParams,
+} from './messages';

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/folders/files.ts

@@ -357,7 +357,7 @@ export interface FileDeleteParams {
 
 export interface FileUploadParams {
   /**
-   * Body param:
+   * Body param
    */
   file: Uploadable;
 

package/src/resources/groups/messages.ts

@@ -256,7 +256,7 @@ export declare namespace MessageUpdateParams {
     content: string;
 
     /**
-     * Body param:
+     * Body param
      */
     message_type?: 'system_message';
   }
@@ -274,7 +274,7 @@ export declare namespace MessageUpdateParams {
     content: Array<MessagesAPI.LettaUserMessageContentUnion> | string;
 
     /**
-     * Body param:
+     * Body param
      */
     message_type?: 'user_message';
   }
@@ -286,12 +286,12 @@ export declare namespace MessageUpdateParams {
     group_id: string;
 
     /**
-     * Body param:
+     * Body param
      */
     reasoning: string;
 
     /**
-     * Body param:
+     * Body param
      */
     message_type?: 'reasoning_message';
   }
@@ -309,7 +309,7 @@ export declare namespace MessageUpdateParams {
     content: Array<MessagesAPI.LettaAssistantMessageContentUnion> | string;
 
     /**
-     * Body param:
+     * Body param
      */
     message_type?: 'assistant_message';
   }

package/src/resources/identities/agents.ts

@@ -33,6 +33,7 @@ export interface AgentListParams extends ArrayPageParams {
     | 'agent.blocks'
     | 'agent.identities'
     | 'agent.managed_group'
+    | 'agent.pending_approval'
     | 'agent.secrets'
     | 'agent.sources'
     | 'agent.tags'

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/mcp-servers/tools.ts

@@ -50,7 +50,7 @@ export interface ToolRetrieveParams {
 
 export interface ToolRunParams {
   /**
-   * Path param:
+   * Path param
    */
   mcp_server_id: string;
 

package/src/resources/messages.ts

@@ -38,6 +38,11 @@ export interface MessageSearchRequest {
    */
   agent_id?: string | null;
 
+  /**
+   * Filter messages by conversation ID
+   */
+  conversation_id?: string | null;
+
   /**
    * Filter messages created on or before this date
    */
@@ -233,6 +238,11 @@ export interface MessageListParams {
    */
   before?: string | null;
 
+  /**
+   * Conversation ID to filter messages by
+   */
+  conversation_id?: string | null;
+
   /**
    * Maximum number of messages to return
    */
@@ -256,6 +266,11 @@ export interface MessageSearchParams {
    */
   agent_id?: string | null;
 
+  /**
+   * Filter messages by conversation ID
+   */
+  conversation_id?: string | null;
+
   /**
    * Filter messages created on or before this date
    */

package/src/resources/runs/index.ts

@@ -8,4 +8,5 @@ export {
 } from './messages';
 export { Runs, type Job, type StopReasonType, type RunListParams } from './runs';
 export { Steps, type StepListParams } from './steps';
+export { Trace, type TraceRetrieveResponse, type TraceRetrieveParams } from './trace';
 export { Usage, type UsageRetrieveResponse } from './usage';