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

package/resources/groups/messages.d.mts

@@ -2,9 +2,18 @@ import { APIResource } from "../../core/resource.mjs";
 import * as ToolsAPI from "../tools.mjs";
 import * as AgentsAPI from "../agents/agents.mjs";
 import * as MessagesAPI from "../agents/messages.mjs";
+import { MessagesArrayPage } from "../agents/messages.mjs";
 import { APIPromise } from "../../core/api-promise.mjs";
+import { type ArrayPageParams, PagePromise } from "../../core/pagination.mjs";
+import { Stream } from "../../core/streaming.mjs";
 import { RequestOptions } from "../../internal/request-options.mjs";
 export declare 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>;
     /**
      * Update the details of a message associated with an agent.
      */
@@ -12,24 +21,18 @@ export declare class Messages extends APIResource {
     /**
      * Retrieve message history for an agent.
      */
-    list(groupID: string, query?: MessageListParams | null | undefined, options?: RequestOptions): APIPromise<MessageListResponse>;
+    list(groupID: string, query?: MessageListParams | null | undefined, options?: RequestOptions): PagePromise<MessagesArrayPage, MessagesAPI.Message>;
     /**
      * Delete the group messages for all agents that are part of the multi-agent group.
      */
     reset(groupID: string, options?: RequestOptions): APIPromise<unknown>;
-    /**
-     * 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>;
     /**
      * 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>;
+    stream(groupID: string, body: MessageStreamParams, options?: RequestOptions): APIPromise<Stream<MessagesAPI.LettaStreamingResponse>>;
 }
 /**
  * A message generated by the system. Never streamed back on a response, only used
@@ -39,10 +42,86 @@ export declare class Messages extends APIResource {
  * created in ISO format name (Optional[str]): The name of the sender of the
  * message content (str): The message content sent by the system
  */
-export type MessageUpdateResponse = MessagesAPI.SystemMessage | MessagesAPI.UserMessage | MessagesAPI.ReasoningMessage | MessagesAPI.HiddenReasoningMessage | MessagesAPI.ToolCallMessage | ToolsAPI.ToolReturnMessage | MessagesAPI.AssistantMessage | MessagesAPI.ApprovalRequestMessage | MessagesAPI.ApprovalResponseMessage;
-export type MessageListResponse = Array<MessagesAPI.LettaMessageUnion>;
+export type MessageUpdateResponse = MessagesAPI.SystemMessage | MessagesAPI.UserMessage | MessagesAPI.ReasoningMessage | MessagesAPI.HiddenReasoningMessage | MessagesAPI.ToolCallMessage | ToolsAPI.ToolReturnMessage | MessagesAPI.AssistantMessage | MessagesAPI.ApprovalRequestMessage | 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 declare namespace MessageCreateParams {
+    /**
+     * 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 type MessageUpdateParams = MessageUpdateParams.UpdateSystemMessage | MessageUpdateParams.UpdateUserMessage | MessageUpdateParams.UpdateReasoningMessage | MessageUpdateParams.UpdateAssistantMessage;
 export declare namespace MessageUpdateParams {
     interface UpdateSystemMessage {
@@ -105,12 +184,7 @@ export declare namespace MessageUpdateParams {
         message_type?: 'assistant_message';
     }
 }
-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.
      */
@@ -119,71 +193,12 @@ export interface MessageListParams {
      * @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';
     /**
      * @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
@@ -196,7 +211,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;
     /**
@@ -206,7 +222,7 @@ export interface MessageStreamParams {
     enable_thinking?: string;
     /**
      * Whether to include periodic keepalive ping messages in the stream to prevent
-     * connection timeouts.
+     * connection timeouts (only used when streaming=true).
      */
     include_pings?: boolean;
     /**
@@ -214,15 +230,29 @@ export interface MessageStreamParams {
      * 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 | 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
@@ -230,7 +260,43 @@ export interface MessageStreamParams {
      */
     use_assistant_message?: boolean;
 }
+export declare namespace MessageStreamParams {
+    /**
+     * 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 declare namespace Messages {
-    export { type MessageUpdateResponse as MessageUpdateResponse, type MessageListResponse as MessageListResponse, type MessageResetResponse as MessageResetResponse, type MessageStreamResponse as MessageStreamResponse, type MessageUpdateParams as MessageUpdateParams, type MessageListParams as MessageListParams, type MessageSendParams as MessageSendParams, type MessageStreamParams as MessageStreamParams, };
+    export { type MessageUpdateResponse as MessageUpdateResponse, type MessageResetResponse as MessageResetResponse, type MessageStreamResponse as MessageStreamResponse, type MessageCreateParams as MessageCreateParams, type MessageUpdateParams as MessageUpdateParams, type MessageListParams as MessageListParams, type MessageStreamParams as MessageStreamParams, };
 }
+export { type MessagesArrayPage };
 //# sourceMappingURL=messages.d.mts.map

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

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

package/resources/groups/messages.d.ts

@@ -2,9 +2,18 @@ import { APIResource } from "../../core/resource.js";
 import * as ToolsAPI from "../tools.js";
 import * as AgentsAPI from "../agents/agents.js";
 import * as MessagesAPI from "../agents/messages.js";
+import { MessagesArrayPage } from "../agents/messages.js";
 import { APIPromise } from "../../core/api-promise.js";
+import { type ArrayPageParams, PagePromise } from "../../core/pagination.js";
+import { Stream } from "../../core/streaming.js";
 import { RequestOptions } from "../../internal/request-options.js";
 export declare 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>;
     /**
      * Update the details of a message associated with an agent.
      */
@@ -12,24 +21,18 @@ export declare class Messages extends APIResource {
     /**
      * Retrieve message history for an agent.
      */
-    list(groupID: string, query?: MessageListParams | null | undefined, options?: RequestOptions): APIPromise<MessageListResponse>;
+    list(groupID: string, query?: MessageListParams | null | undefined, options?: RequestOptions): PagePromise<MessagesArrayPage, MessagesAPI.Message>;
     /**
      * Delete the group messages for all agents that are part of the multi-agent group.
      */
     reset(groupID: string, options?: RequestOptions): APIPromise<unknown>;
-    /**
-     * 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>;
     /**
      * 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>;
+    stream(groupID: string, body: MessageStreamParams, options?: RequestOptions): APIPromise<Stream<MessagesAPI.LettaStreamingResponse>>;
 }
 /**
  * A message generated by the system. Never streamed back on a response, only used
@@ -39,10 +42,86 @@ export declare class Messages extends APIResource {
  * created in ISO format name (Optional[str]): The name of the sender of the
  * message content (str): The message content sent by the system
  */
-export type MessageUpdateResponse = MessagesAPI.SystemMessage | MessagesAPI.UserMessage | MessagesAPI.ReasoningMessage | MessagesAPI.HiddenReasoningMessage | MessagesAPI.ToolCallMessage | ToolsAPI.ToolReturnMessage | MessagesAPI.AssistantMessage | MessagesAPI.ApprovalRequestMessage | MessagesAPI.ApprovalResponseMessage;
-export type MessageListResponse = Array<MessagesAPI.LettaMessageUnion>;
+export type MessageUpdateResponse = MessagesAPI.SystemMessage | MessagesAPI.UserMessage | MessagesAPI.ReasoningMessage | MessagesAPI.HiddenReasoningMessage | MessagesAPI.ToolCallMessage | ToolsAPI.ToolReturnMessage | MessagesAPI.AssistantMessage | MessagesAPI.ApprovalRequestMessage | 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 declare namespace MessageCreateParams {
+    /**
+     * 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 type MessageUpdateParams = MessageUpdateParams.UpdateSystemMessage | MessageUpdateParams.UpdateUserMessage | MessageUpdateParams.UpdateReasoningMessage | MessageUpdateParams.UpdateAssistantMessage;
 export declare namespace MessageUpdateParams {
     interface UpdateSystemMessage {
@@ -105,12 +184,7 @@ export declare namespace MessageUpdateParams {
         message_type?: 'assistant_message';
     }
 }
-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.
      */
@@ -119,71 +193,12 @@ export interface MessageListParams {
      * @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';
     /**
      * @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
@@ -196,7 +211,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;
     /**
@@ -206,7 +222,7 @@ export interface MessageStreamParams {
     enable_thinking?: string;
     /**
      * Whether to include periodic keepalive ping messages in the stream to prevent
-     * connection timeouts.
+     * connection timeouts (only used when streaming=true).
      */
     include_pings?: boolean;
     /**
@@ -214,15 +230,29 @@ export interface MessageStreamParams {
      * 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 | 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
@@ -230,7 +260,43 @@ export interface MessageStreamParams {
      */
     use_assistant_message?: boolean;
 }
+export declare namespace MessageStreamParams {
+    /**
+     * 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 declare namespace Messages {
-    export { type MessageUpdateResponse as MessageUpdateResponse, type MessageListResponse as MessageListResponse, type MessageResetResponse as MessageResetResponse, type MessageStreamResponse as MessageStreamResponse, type MessageUpdateParams as MessageUpdateParams, type MessageListParams as MessageListParams, type MessageSendParams as MessageSendParams, type MessageStreamParams as MessageStreamParams, };
+    export { type MessageUpdateResponse as MessageUpdateResponse, type MessageResetResponse as MessageResetResponse, type MessageStreamResponse as MessageStreamResponse, type MessageCreateParams as MessageCreateParams, type MessageUpdateParams as MessageUpdateParams, type MessageListParams as MessageListParams, type MessageStreamParams as MessageStreamParams, };
 }
+export { type MessagesArrayPage };
 //# sourceMappingURL=messages.d.ts.map