@letta-ai/letta-client 1.0.0-alpha.6 → 1.0.0

package/src/resources/groups/messages.ts

@@ -1,14 +1,30 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as ToolsAPI from '../tools';
 import * as AgentsAPI from '../agents/agents';
 import * as MessagesAPI from '../agents/messages';
-import * as ToolsAPI from '../tools/tools';
+import { MessagesArrayPage } from '../agents/messages';
 import { APIPromise } from '../../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
+import { Stream } from '../../core/streaming';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Messages extends APIResource {
+  /**
+   * Process a user message and return the group's response. This endpoint accepts a
+   * message from a user and processes it through through agents in the group based
+   * on the specified pattern
+   */
+  create(
+    groupID: string,
+    body: MessageCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<MessagesAPI.LettaResponse> {
+    return this._client.post(path`/v1/groups/${groupID}/messages`, { body, ...options });
+  }
+
   /**
    * Update the details of a message associated with an agent.
    */
@@ -28,21 +44,18 @@ export class Messages extends APIResource {
     groupID: string,
     query: MessageListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<MessageListResponse> {
-    return this._client.get(path`/v1/groups/${groupID}/messages`, { query, ...options });
+  ): PagePromise<MessagesArrayPage, MessagesAPI.Message> {
+    return this._client.getAPIList(path`/v1/groups/${groupID}/messages`, ArrayPage<MessagesAPI.Message>, {
+      query,
+      ...options,
+    });
   }
 
   /**
-   * Process a user message and return the group's response. This endpoint accepts a
-   * message from a user and processes it through through agents in the group based
-   * on the specified pattern
+   * Delete the group messages for all agents that are part of the multi-agent group.
    */
-  send(
-    groupID: string,
-    body: MessageSendParams,
-    options?: RequestOptions,
-  ): APIPromise<MessagesAPI.LettaResponse> {
-    return this._client.post(path`/v1/groups/${groupID}/messages`, { body, ...options });
+  reset(groupID: string, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.patch(path`/v1/groups/${groupID}/reset-messages`, options);
   }
 
   /**
@@ -51,8 +64,16 @@ export class Messages extends APIResource {
    * specified pattern. It will stream the steps of the response always, and stream
    * the tokens if 'stream_tokens' is set to True.
    */
-  sendStream(groupID: string, body: MessageSendStreamParams, options?: RequestOptions): APIPromise<unknown> {
-    return this._client.post(path`/v1/groups/${groupID}/messages/stream`, { body, ...options });
+  stream(
+    groupID: string,
+    body: MessageStreamParams,
+    options?: RequestOptions,
+  ): APIPromise<Stream<MessagesAPI.LettaStreamingResponse>> {
+    return this._client.post(path`/v1/groups/${groupID}/messages/stream`, {
+      body,
+      ...options,
+      stream: true,
+    }) as APIPromise<Stream<MessagesAPI.LettaStreamingResponse>>;
   }
 }
 
@@ -73,11 +94,116 @@ export type MessageUpdateResponse =
   | ToolsAPI.ToolReturnMessage
   | MessagesAPI.AssistantMessage
   | MessagesAPI.ApprovalRequestMessage
-  | MessagesAPI.ApprovalResponseMessage;
+  | MessagesAPI.ApprovalResponseMessage
+  | MessagesAPI.SummaryMessage
+  | MessagesAPI.EventMessage;
+
+export type MessageResetResponse = unknown;
+
+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;
 
-export type MessageListResponse = Array<MessagesAPI.LettaMessageUnion>;
+  /**
+   * @deprecated If set to True, enables reasoning before responses or tool calls
+   * from the agent.
+   */
+  enable_thinking?: string;
 
-export type MessageSendStreamResponse = unknown;
+  /**
+   * 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;
+
+  /**
+   * @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 {
+  /**
+   * 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 type MessageUpdateParams =
   | MessageUpdateParams.UpdateSystemMessage
@@ -88,7 +214,7 @@ export type MessageUpdateParams =
 export declare namespace MessageUpdateParams {
   export interface UpdateSystemMessage {
     /**
-     * Path param:
+     * Path param: The ID of the group in the format 'group-<uuid4>'
      */
     group_id: string;
 
@@ -106,7 +232,7 @@ export declare namespace MessageUpdateParams {
 
   export interface UpdateUserMessage {
     /**
-     * Path param:
+     * Path param: The ID of the group in the format 'group-<uuid4>'
      */
     group_id: string;
 
@@ -124,7 +250,7 @@ export declare namespace MessageUpdateParams {
 
   export interface UpdateReasoningMessage {
     /**
-     * Path param:
+     * Path param: The ID of the group in the format 'group-<uuid4>'
      */
     group_id: string;
 
@@ -141,7 +267,7 @@ export declare namespace MessageUpdateParams {
 
   export interface UpdateAssistantMessage {
     /**
-     * Path param:
+     * Path param: The ID of the group in the format 'group-<uuid4>'
      */
     group_id: string;
 
@@ -158,72 +284,55 @@ export declare namespace MessageUpdateParams {
   }
 }
 
-export interface MessageListParams {
+export interface MessageListParams extends ArrayPageParams {
   /**
-   * Message ID cursor for pagination. Returns messages that come after this message
-   * ID in the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * The name of the message argument.
+   * @deprecated The name of the message argument.
    */
   assistant_message_tool_kwarg?: string;
 
   /**
-   * The name of the designated message tool.
+   * @deprecated The name of the designated message tool.
    */
   assistant_message_tool_name?: string;
 
   /**
-   * Message ID cursor for pagination. Returns messages that come before this message
-   * ID in the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of messages to retrieve
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
-
-  /**
-   * Whether to use assistant messages
+   * @deprecated Whether to use assistant messages
    */
   use_assistant_message?: boolean;
 }
 
-export interface MessageSendParams {
+export interface MessageStreamParams {
   /**
-   * The messages to be sent to the agent.
+   * @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.
    */
-  messages: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate>;
+  assistant_message_tool_kwarg?: string;
 
   /**
-   * The name of the message argument in the designated message tool.
+   * @deprecated The name of the designated message tool. Still supported for legacy
+   * agent types, but deprecated for letta_v1_agent onward.
    */
-  assistant_message_tool_kwarg?: string;
+  assistant_message_tool_name?: string;
 
   /**
-   * The name of the designated message tool.
+   * Whether to process the request in the background (only used when
+   * streaming=true).
    */
-  assistant_message_tool_name?: string;
+  background?: boolean;
 
   /**
-   * If set to True, enables reasoning before responses or tool calls from the agent.
+   * @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.
@@ -231,81 +340,104 @@ export interface MessageSendParams {
   include_return_message_types?: Array<MessagesAPI.MessageType> | null;
 
   /**
-   * Maximum number of steps the agent should take to process the request.
+   * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+   * 'user', 'content': input}].
    */
-  max_steps?: number;
+  input?:
+    | string
+    | Array<
+        | MessagesAPI.TextContent
+        | MessagesAPI.ImageContent
+        | MessagesAPI.ToolCallContent
+        | MessagesAPI.ToolReturnContent
+        | MessagesAPI.ReasoningContent
+        | MessagesAPI.RedactedReasoningContent
+        | MessagesAPI.OmittedReasoningContent
+        | MessageStreamParams.SummarizedReasoningContent
+      >
+    | null;
 
   /**
-   * Whether the server should parse specific tool call arguments (default
-   * `send_message`) as `AssistantMessage` objects.
+   * Maximum number of steps the agent should take to process the request.
    */
-  use_assistant_message?: boolean;
-}
+  max_steps?: number;
 
-export interface MessageSendStreamParams {
   /**
    * The messages to be sent to the agent.
    */
-  messages: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate>;
-
-  /**
-   * The name of the message argument in the designated message tool.
-   */
-  assistant_message_tool_kwarg?: string;
+  messages?: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate> | null;
 
   /**
-   * The name of the designated message tool.
+   * Flag to determine if individual tokens should be streamed, rather than streaming
+   * per step (only used when streaming=true).
    */
-  assistant_message_tool_name?: string;
+  stream_tokens?: boolean;
 
   /**
-   * Whether to process the request in the background.
+   * If True, returns a streaming response (Server-Sent Events). If False (default),
+   * returns a complete response.
    */
-  background?: boolean;
+  streaming?: boolean;
 
   /**
-   * If set to True, enables reasoning before responses or tool calls from the agent.
+   * @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.
    */
-  enable_thinking?: string;
+  use_assistant_message?: boolean;
+}
 
+export namespace MessageStreamParams {
   /**
-   * Whether to include periodic keepalive ping messages in the stream to prevent
-   * connection timeouts.
+   * The style of reasoning content returned by the OpenAI Responses API
    */
-  include_pings?: boolean;
+  export interface SummarizedReasoningContent {
+    /**
+     * The unique identifier for this reasoning step.
+     */
+    id: string;
 
-  /**
-   * Only return specified message types in the response. If `None` (default) returns
-   * all messages.
-   */
-  include_return_message_types?: Array<MessagesAPI.MessageType> | null;
+    /**
+     * Summaries of the reasoning content.
+     */
+    summary: Array<SummarizedReasoningContent.Summary>;
 
-  /**
-   * Maximum number of steps the agent should take to process the request.
-   */
-  max_steps?: number;
+    /**
+     * The encrypted reasoning content.
+     */
+    encrypted_content?: string;
 
-  /**
-   * Flag to determine if individual tokens should be streamed, rather than streaming
-   * per step.
-   */
-  stream_tokens?: boolean;
+    /**
+     * Indicates this is a summarized reasoning step.
+     */
+    type?: 'summarized_reasoning';
+  }
 
-  /**
-   * Whether the server should parse specific tool call arguments (default
-   * `send_message`) as `AssistantMessage` objects.
-   */
-  use_assistant_message?: boolean;
+  export namespace SummarizedReasoningContent {
+    export interface Summary {
+      /**
+       * The index of the summary part.
+       */
+      index: number;
+
+      /**
+       * The text of the summary part.
+       */
+      text: string;
+    }
+  }
 }
 
 export declare namespace Messages {
   export {
     type MessageUpdateResponse as MessageUpdateResponse,
-    type MessageListResponse as MessageListResponse,
-    type MessageSendStreamResponse as MessageSendStreamResponse,
+    type MessageResetResponse as MessageResetResponse,
+    type MessageStreamResponse as MessageStreamResponse,
+    type MessageCreateParams as MessageCreateParams,
     type MessageUpdateParams as MessageUpdateParams,
     type MessageListParams as MessageListParams,
-    type MessageSendParams as MessageSendParams,
-    type MessageSendStreamParams as MessageSendStreamParams,
+    type MessageStreamParams as MessageStreamParams,
   };
 }
+
+export { type MessagesArrayPage };

package/src/resources/identities/agents.ts

@@ -0,0 +1,47 @@
+// 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 { AgentStatesArrayPage } from '../agents/agents';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Agents extends APIResource {
+  /**
+   * Get all agents associated with the specified identity.
+   */
+  list(
+    identityID: string,
+    query: AgentListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<AgentStatesArrayPage, AgentsAPI.AgentState> {
+    return this._client.getAPIList(
+      path`/v1/identities/${identityID}/agents`,
+      ArrayPage<AgentsAPI.AgentState>,
+      { query, ...options },
+    );
+  }
+}
+
+export interface AgentListParams extends ArrayPageParams {
+  /**
+   * Specify which relational fields to include in the response. No relationships are
+   * included by default.
+   */
+  include?: Array<
+    | 'agent.blocks'
+    | 'agent.identities'
+    | 'agent.managed_group'
+    | 'agent.secrets'
+    | 'agent.sources'
+    | 'agent.tags'
+    | 'agent.tools'
+  >;
+}
+
+export declare namespace Agents {
+  export { type AgentListParams as AgentListParams };
+}
+
+export { type AgentStatesArrayPage };

package/src/resources/identities/blocks.ts

@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as BlocksAPI from '../blocks/blocks';
+import { BlockResponsesArrayPage } from '../blocks/blocks';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Blocks extends APIResource {
+  /**
+   * Get all blocks associated with the specified identity.
+   */
+  list(
+    identityID: string,
+    query: BlockListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<BlockResponsesArrayPage, BlocksAPI.BlockResponse> {
+    return this._client.getAPIList(
+      path`/v1/identities/${identityID}/blocks`,
+      ArrayPage<BlocksAPI.BlockResponse>,
+      { query, ...options },
+    );
+  }
+}
+
+export interface BlockListParams extends ArrayPageParams {}
+
+export declare namespace Blocks {
+  export { type BlockListParams as BlockListParams };
+}
+
+export { type BlockResponsesArrayPage };