@letta-ai/letta-client 1.0.0-alpha.7 → 1.1.0

package/src/resources/groups/messages.ts

@@ -4,11 +4,27 @@ import { APIResource } from '../../core/resource';
 import * as ToolsAPI from '../tools';
 import * as AgentsAPI from '../agents/agents';
 import * as MessagesAPI from '../agents/messages';
+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,8 +44,11 @@ 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,
+    });
   }
 
   /**
@@ -39,27 +58,22 @@ export class Messages extends APIResource {
     return this._client.patch(path`/v1/groups/${groupID}/reset-messages`, 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
-   */
-  send(
-    groupID: string,
-    body: MessageSendParams,
-    options?: RequestOptions,
-  ): APIPromise<MessagesAPI.LettaResponse> {
-    return this._client.post(path`/v1/groups/${groupID}/messages`, { body, ...options });
-  }
-
   /**
    * Process a user message and return the group's responses. This endpoint accepts a
    * message from a user and processes it through agents in the group based on the
    * specified pattern. It will stream the steps of the response always, and stream
    * the tokens if 'stream_tokens' is set to True.
    */
-  stream(groupID: string, body: MessageStreamParams, 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>>;
   }
 }
 
@@ -80,14 +94,117 @@ export type MessageUpdateResponse =
   | ToolsAPI.ToolReturnMessage
   | MessagesAPI.AssistantMessage
   | MessagesAPI.ApprovalRequestMessage
-  | MessagesAPI.ApprovalResponseMessage;
-
-export type MessageListResponse = Array<MessagesAPI.LettaMessageUnion>;
+  | 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;
+
+  /**
+   * @deprecated If set to True, enables reasoning before responses or tool calls
+   * from the agent.
+   */
+  enable_thinking?: string;
+
+  /**
+   * 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
   | MessageUpdateParams.UpdateUserMessage
@@ -167,13 +284,7 @@ export declare namespace MessageUpdateParams {
   }
 }
 
-export interface MessageListParams {
-  /**
-   * Message ID cursor for pagination. Returns messages that come after this message
-   * ID in the specified sort order
-   */
-  after?: string | null;
-
+export interface MessageListParams extends ArrayPageParams {
   /**
    * @deprecated The name of the message argument.
    */
@@ -184,84 +295,13 @@ export interface MessageListParams {
    */
   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';
-
   /**
    * @deprecated Whether to use assistant messages
    */
   use_assistant_message?: boolean;
 }
 
-export interface MessageSendParams {
-  /**
-   * The messages to be sent to the agent.
-   */
-  messages: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate>;
-
-  /**
-   * @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;
-
-  /**
-   * @deprecated If set to True, enables reasoning before responses or tool calls
-   * from the agent.
-   */
-  enable_thinking?: string;
-
-  /**
-   * Only return specified message types in the response. If `None` (default) returns
-   * all messages.
-   */
-  include_return_message_types?: Array<MessagesAPI.MessageType> | null;
-
-  /**
-   * Maximum number of steps the agent should take to process the request.
-   */
-  max_steps?: number;
-
-  /**
-   * @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 interface MessageStreamParams {
-  /**
-   * The messages to be sent to the agent.
-   */
-  messages: Array<AgentsAPI.MessageCreate | MessagesAPI.ApprovalCreate>;
-
   /**
    * @deprecated The name of the message argument in the designated message tool.
    * Still supported for legacy agent types, but deprecated for letta_v1_agent
@@ -276,7 +316,8 @@ export interface MessageStreamParams {
   assistant_message_tool_name?: string;
 
   /**
-   * Whether to process the request in the background.
+   * Whether to process the request in the background (only used when
+   * streaming=true).
    */
   background?: boolean;
 
@@ -288,7 +329,7 @@ export interface MessageStreamParams {
 
   /**
    * Whether to include periodic keepalive ping messages in the stream to prevent
-   * connection timeouts.
+   * connection timeouts (only used when streaming=true).
    */
   include_pings?: boolean;
 
@@ -298,17 +339,46 @@ export interface MessageStreamParams {
    */
   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
+        | MessageStreamParams.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.
+   * 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
@@ -317,15 +387,57 @@ export interface MessageStreamParams {
   use_assistant_message?: boolean;
 }
 
+export namespace MessageStreamParams {
+  /**
+   * 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 declare namespace Messages {
   export {
     type MessageUpdateResponse as MessageUpdateResponse,
-    type MessageListResponse as MessageListResponse,
     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 MessageStreamParams as MessageStreamParams,
   };
 }
+
+export { type MessagesArrayPage };

package/src/resources/identities/agents.ts

@@ -2,7 +2,8 @@
 
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from '../agents/agents';
-import { APIPromise } from '../../core/api-promise';
+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';
 
@@ -14,26 +15,16 @@ export class Agents extends APIResource {
     identityID: string,
     query: AgentListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<AgentListResponse> {
-    return this._client.get(path`/v1/identities/${identityID}/agents`, { query, ...options });
+  ): PagePromise<AgentStatesArrayPage, AgentsAPI.AgentState> {
+    return this._client.getAPIList(
+      path`/v1/identities/${identityID}/agents`,
+      ArrayPage<AgentsAPI.AgentState>,
+      { query, ...options },
+    );
   }
 }
 
-export type AgentListResponse = Array<AgentsAPI.AgentState>;
-
-export interface AgentListParams {
-  /**
-   * Agent ID cursor for pagination. Returns agents that come after this agent ID in
-   * the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Agent ID cursor for pagination. Returns agents that come before this agent ID in
-   * the specified sort order
-   */
-  before?: string | null;
-
+export interface AgentListParams extends ArrayPageParams {
   /**
    * Specify which relational fields to include in the response. No relationships are
    * included by default.
@@ -47,24 +38,10 @@ export interface AgentListParams {
     | 'agent.tags'
     | 'agent.tools'
   >;
-
-  /**
-   * Maximum number of agents to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for agents by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
 }
 
 export declare namespace Agents {
-  export { type AgentListResponse as AgentListResponse, type AgentListParams as AgentListParams };
+  export { type AgentListParams as AgentListParams };
 }
+
+export { type AgentStatesArrayPage };

package/src/resources/identities/blocks.ts

@@ -1,8 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as BlocksAPI from '../agents/blocks';
-import { APIPromise } from '../../core/api-promise';
+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';
 
@@ -14,43 +15,19 @@ export class Blocks extends APIResource {
     identityID: string,
     query: BlockListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<BlockListResponse> {
-    return this._client.get(path`/v1/identities/${identityID}/blocks`, { query, ...options });
+  ): PagePromise<BlockResponsesArrayPage, BlocksAPI.BlockResponse> {
+    return this._client.getAPIList(
+      path`/v1/identities/${identityID}/blocks`,
+      ArrayPage<BlocksAPI.BlockResponse>,
+      { query, ...options },
+    );
   }
 }
 
-export type BlockListResponse = Array<BlocksAPI.Block>;
-
-export interface BlockListParams {
-  /**
-   * Block ID cursor for pagination. Returns blocks that come after this block ID in
-   * the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Block ID cursor for pagination. Returns blocks that come before this block ID in
-   * the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of blocks to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for blocks by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
-}
+export interface BlockListParams extends ArrayPageParams {}
 
 export declare namespace Blocks {
-  export { type BlockListResponse as BlockListResponse, type BlockListParams as BlockListParams };
+  export { type BlockListParams as BlockListParams };
 }
+
+export { type BlockResponsesArrayPage };