letta-client 1.0.0a6__py3-none-any.whl → 1.0.0a7__py3-none-any.whl

{letta_sdk → letta_client}/types/agents/approval_request_message.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Union, Optional
+from typing import List, Union, Optional
 from datetime import datetime
 from typing_extensions import Literal, TypeAlias
 
@@ -8,10 +8,12 @@ from . import tool_call
 from ..._models import BaseModel
 from .tool_call_delta import ToolCallDelta
 
-__all__ = ["ApprovalRequestMessage", "ToolCall"]
+__all__ = ["ApprovalRequestMessage", "ToolCall", "ToolCalls"]
 
 ToolCall: TypeAlias = Union[tool_call.ToolCall, ToolCallDelta]
 
+ToolCalls: TypeAlias = Union[List[tool_call.ToolCall], ToolCallDelta, None]
+
 
 class ApprovalRequestMessage(BaseModel):
     id: str
@@ -37,3 +39,9 @@ class ApprovalRequestMessage(BaseModel):
     seq_id: Optional[int] = None
 
     step_id: Optional[str] = None
+
+    tool_calls: Optional[ToolCalls] = None
+    """
+    The tool calls that have been requested by the llm to run, which are pending
+    approval
+    """

letta_client/types/agents/approval_response_message.py

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from ..._utils import PropertyInfo
+from ..._models import BaseModel
+from .tool_return import ToolReturn
+
+__all__ = ["ApprovalResponseMessage", "Approval", "ApprovalApprovalReturn"]
+
+
+class ApprovalApprovalReturn(BaseModel):
+    approve: bool
+    """Whether the tool has been approved"""
+
+    tool_call_id: str
+    """The ID of the tool call that corresponds to this approval"""
+
+    reason: Optional[str] = None
+    """An optional explanation for the provided approval status"""
+
+    type: Optional[Literal["approval"]] = None
+    """The message type to be created."""
+
+
+Approval: TypeAlias = Annotated[Union[ApprovalApprovalReturn, ToolReturn], PropertyInfo(discriminator="type")]
+
+
+class ApprovalResponseMessage(BaseModel):
+    id: str
+
+    date: datetime
+
+    approval_request_id: Optional[str] = None
+    """The message ID of the approval request"""
+
+    approvals: Optional[List[Approval]] = None
+    """The list of approval responses"""
+
+    approve: Optional[bool] = None
+    """Whether the tool has been approved"""
+
+    is_err: Optional[bool] = None
+
+    message_type: Optional[Literal["approval_response_message"]] = None
+    """The type of the message."""
+
+    name: Optional[str] = None
+
+    otid: Optional[str] = None
+
+    reason: Optional[str] = None
+    """An optional explanation for the provided approval status"""
+
+    run_id: Optional[str] = None
+
+    sender_id: Optional[str] = None
+
+    seq_id: Optional[int] = None
+
+    step_id: Optional[str] = None

{letta_sdk/types/agents/core_memory → letta_client/types/agents}/block.py

@@ -2,7 +2,7 @@
 
 from typing import Dict, Optional
 
-from ...._models import BaseModel
+from ..._models import BaseModel
 
 __all__ = ["Block"]
 

letta_sdk/types/identity_list_blocks_params.py → letta_client/types/agents/block_list_params.py

@@ -5,10 +5,10 @@ from __future__ import annotations
 from typing import Optional
 from typing_extensions import Literal, TypedDict
 
-__all__ = ["IdentityListBlocksParams"]
+__all__ = ["BlockListParams"]
 
 
-class IdentityListBlocksParams(TypedDict, total=False):
+class BlockListParams(TypedDict, total=False):
     after: Optional[str]
     """Block ID cursor for pagination.
 

{letta_sdk/types/agents/core_memory → letta_client/types/agents}/block_update_params.py

@@ -10,6 +10,7 @@ __all__ = ["BlockUpdateParams"]
 
 class BlockUpdateParams(TypedDict, total=False):
     agent_id: Required[str]
+    """The ID of the agent in the format 'agent-<uuid4>'"""
 
     base_template_id: Optional[str]
     """The base template id of the block."""

letta_client/types/agents/file_list_params.py

@@ -0,0 +1,40 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["FileListParams"]
+
+
+class FileListParams(TypedDict, total=False):
+    after: Optional[str]
+    """File ID cursor for pagination.
+
+    Returns files that come after this file ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """File ID cursor for pagination.
+
+    Returns files that come before this file ID in the specified sort order
+    """
+
+    cursor: Optional[str]
+    """Pagination cursor from previous response (deprecated, use before/after)"""
+
+    is_open: Optional[bool]
+    """Filter by open status (true for open files, false for closed files)"""
+
+    limit: Optional[int]
+    """Maximum number of files to return"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for files by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_client/types/agents/folder_list_params.py

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["FolderListParams"]
+
+
+class FolderListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Source ID cursor for pagination.
+
+    Returns sources that come after this source ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """Source ID cursor for pagination.
+
+    Returns sources that come before this source ID in the specified sort order
+    """
+
+    limit: Optional[int]
+    """Maximum number of sources to return"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for sources by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_sdk/types/source.py → letta_client/types/agents/folder_list_response.py

@@ -1,16 +1,17 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict, Optional
+from typing import Dict, List, Optional
 from datetime import datetime
+from typing_extensions import TypeAlias
 
-from .._models import BaseModel
-from .embedding_config import EmbeddingConfig
-from .vector_db_provider import VectorDBProvider
+from ..._models import BaseModel
+from ..embedding_config import EmbeddingConfig
+from ..vector_db_provider import VectorDBProvider
 
-__all__ = ["Source"]
+__all__ = ["FolderListResponse", "FolderListResponseItem"]
 
 
-class Source(BaseModel):
+class FolderListResponseItem(BaseModel):
     embedding_config: EmbeddingConfig
     """The embedding configuration used by the source."""
 
@@ -43,3 +44,6 @@ class Source(BaseModel):
 
     vector_db_provider: Optional[VectorDBProvider] = None
     """The vector database provider used for this source's passages"""
+
+
+FolderListResponse: TypeAlias = List[FolderListResponseItem]

letta_client/types/agents/group_list_params.py

@@ -0,0 +1,37 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["GroupListParams"]
+
+
+class GroupListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Group ID cursor for pagination.
+
+    Returns groups that come after this group ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """Group ID cursor for pagination.
+
+    Returns groups that come before this group ID in the specified sort order
+    """
+
+    limit: Optional[int]
+    """Maximum number of groups to return"""
+
+    manager_type: Optional[str]
+    """Manager type to filter groups by"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for groups by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_client/types/agents/group_list_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from ..group import Group
+
+__all__ = ["GroupListResponse"]
+
+GroupListResponse: TypeAlias = List[Group]

{letta_sdk → letta_client}/types/agents/letta_assistant_message_content_union.py

@@ -12,5 +12,8 @@ class LettaAssistantMessageContentUnion(BaseModel):
     text: str
     """The text content of the message."""
 
+    signature: Optional[str] = None
+    """Stores a unique identifier for any reasoning associated with this text content."""
+
     type: Optional[Literal["text"]] = None
     """The type of the message."""

{letta_sdk → letta_client}/types/agents/letta_assistant_message_content_union_param.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from typing import Optional
 from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["LettaAssistantMessageContentUnionParam"]
@@ -11,5 +12,8 @@ class LettaAssistantMessageContentUnionParam(TypedDict, total=False):
     text: Required[str]
     """The text content of the message."""
 
+    signature: Optional[str]
+    """Stores a unique identifier for any reasoning associated with this text content."""
+
     type: Literal["text"]
     """The type of the message."""

{letta_sdk → letta_client}/types/agents/letta_response.py

@@ -3,7 +3,6 @@
 from typing import List, Optional
 from typing_extensions import Literal
 
-from .message import Message
 from ..._models import BaseModel
 from ..stop_reason_type import StopReasonType
 from .letta_message_union import LettaMessageUnion
@@ -34,9 +33,6 @@ class Usage(BaseModel):
     step_count: Optional[int] = None
     """The number of steps taken by the agent."""
 
-    steps_messages: Optional[List[List[Message]]] = None
-    """The messages generated per step"""
-
     total_tokens: Optional[int] = None
     """The total number of tokens processed by the agent."""
 

{letta_sdk → letta_client}/types/agents/message.py

@@ -8,7 +8,6 @@ from pydantic import Field as FieldInfo
 
 from ..._utils import PropertyInfo
 from ..._models import BaseModel
-from .tool_return import ToolReturn
 from .message_role import MessageRole
 from .text_content import TextContent
 from .image_content import ImageContent
@@ -18,7 +17,75 @@ from .tool_return_content import ToolReturnContent
 from .omitted_reasoning_content import OmittedReasoningContent
 from .redacted_reasoning_content import RedactedReasoningContent
 
-__all__ = ["Message", "Content", "ToolCall", "ToolCallFunction"]
+__all__ = [
+    "Message",
+    "Approval",
+    "ApprovalApprovalReturn",
+    "ApprovalLettaSchemasMessageToolReturn",
+    "Content",
+    "ContentSummarizedReasoningContent",
+    "ContentSummarizedReasoningContentSummary",
+    "ToolCall",
+    "ToolCallFunction",
+    "ToolReturn",
+]
+
+
+class ApprovalApprovalReturn(BaseModel):
+    approve: bool
+    """Whether the tool has been approved"""
+
+    tool_call_id: str
+    """The ID of the tool call that corresponds to this approval"""
+
+    reason: Optional[str] = None
+    """An optional explanation for the provided approval status"""
+
+    type: Optional[Literal["approval"]] = None
+    """The message type to be created."""
+
+
+class ApprovalLettaSchemasMessageToolReturn(BaseModel):
+    status: Literal["success", "error"]
+    """The status of the tool call"""
+
+    func_response: Optional[str] = None
+    """The function response string"""
+
+    stderr: Optional[List[str]] = None
+    """Captured stderr from the tool invocation"""
+
+    stdout: Optional[List[str]] = None
+    """Captured stdout (e.g. prints, logs) from the tool invocation"""
+
+    tool_call_id: Optional[object] = None
+    """The ID for the tool call"""
+
+
+Approval: TypeAlias = Union[ApprovalApprovalReturn, ApprovalLettaSchemasMessageToolReturn]
+
+
+class ContentSummarizedReasoningContentSummary(BaseModel):
+    index: int
+    """The index of the summary part."""
+
+    text: str
+    """The text of the summary part."""
+
+
+class ContentSummarizedReasoningContent(BaseModel):
+    id: str
+    """The unique identifier for this reasoning step."""
+
+    summary: List[ContentSummarizedReasoningContentSummary]
+    """Summaries of the reasoning content."""
+
+    encrypted_content: Optional[str] = None
+    """The encrypted reasoning content."""
+
+    type: Optional[Literal["summarized_reasoning"]] = None
+    """Indicates this is a summarized reasoning step."""
+
 
 Content: TypeAlias = Annotated[
     Union[
@@ -29,6 +96,7 @@ Content: TypeAlias = Annotated[
         ReasoningContent,
         RedactedReasoningContent,
         OmittedReasoningContent,
+        ContentSummarizedReasoningContent,
     ],
     PropertyInfo(discriminator="type"),
 ]
@@ -72,6 +140,23 @@ class ToolCall(BaseModel):
         __pydantic_extra__: Dict[str, object]
 
 
+class ToolReturn(BaseModel):
+    status: Literal["success", "error"]
+    """The status of the tool call"""
+
+    func_response: Optional[str] = None
+    """The function response string"""
+
+    stderr: Optional[List[str]] = None
+    """Captured stderr from the tool invocation"""
+
+    stdout: Optional[List[str]] = None
+    """Captured stdout (e.g. prints, logs) from the tool invocation"""
+
+    tool_call_id: Optional[object] = None
+    """The ID for the tool call"""
+
+
 class Message(BaseModel):
     role: MessageRole
     """The role of the participant."""
@@ -88,6 +173,9 @@ class Message(BaseModel):
     request.
     """
 
+    approvals: Optional[List[Approval]] = None
+    """The list of approvals for this message."""
+
     approve: Optional[bool] = None
     """Whether tool call is approved."""
 
@@ -130,6 +218,9 @@ class Message(BaseModel):
     otid: Optional[str] = None
     """The offline threading id associated with this message"""
 
+    run_id: Optional[str] = None
+    """The id of the run that this message was created in."""
+
     sender_id: Optional[str] = None
     """The id of the sender of the message, can be an identity id or agent id"""
 

{letta_sdk → letta_client}/types/agents/message_list_params.py

@@ -3,14 +3,17 @@
 from __future__ import annotations
 
 from typing import Optional
-from typing_extensions import TypedDict
+from typing_extensions import Literal, TypedDict
 
 __all__ = ["MessageListParams"]
 
 
 class MessageListParams(TypedDict, total=False):
     after: Optional[str]
-    """Message after which to retrieve the returned messages."""
+    """Message ID cursor for pagination.
+
+    Returns messages that come after this message ID in the specified sort order
+    """
 
     assistant_message_tool_kwarg: str
     """The name of the message argument."""
@@ -19,7 +22,10 @@ class MessageListParams(TypedDict, total=False):
     """The name of the designated message tool."""
 
     before: Optional[str]
-    """Message before which to retrieve the returned messages."""
+    """Message ID cursor for pagination.
+
+    Returns messages that come before this message ID in the specified sort order
+    """
 
     group_id: Optional[str]
     """Group ID to filter messages by."""
@@ -30,8 +36,17 @@ class MessageListParams(TypedDict, total=False):
     For debugging purposes only.
     """
 
-    limit: int
-    """Maximum number of messages to retrieve."""
+    limit: Optional[int]
+    """Maximum number of messages to return"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for messages by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""
 
     use_assistant_message: bool
     """Whether to use assistant messages"""

letta_sdk/types/agent_reset_messages_params.py → letta_client/types/agents/message_reset_params.py

@@ -4,9 +4,9 @@ from __future__ import annotations
 
 from typing_extensions import TypedDict
 
-__all__ = ["AgentResetMessagesParams"]
+__all__ = ["MessageResetParams"]
 
 
-class AgentResetMessagesParams(TypedDict, total=False):
+class MessageResetParams(TypedDict, total=False):
     add_default_initial_messages: bool
     """If true, adds the default initial messages after resetting."""

{letta_sdk → letta_client}/types/agents/message_send_async_params.py

@@ -17,10 +17,18 @@ class MessageSendAsyncParams(TypedDict, total=False):
     """The messages to be sent to the agent."""
 
     assistant_message_tool_kwarg: str
-    """The name of the message argument in the designated message tool."""
+    """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_name: str
-    """The name of the designated message tool."""
+    """The name of the designated message tool.
+
+    Still supported for legacy agent types, but deprecated for letta_v1_agent
+    onward.
+    """
 
     callback_url: Optional[str]
     """Optional callback URL to POST to when the job completes"""
@@ -42,7 +50,8 @@ class MessageSendAsyncParams(TypedDict, total=False):
     use_assistant_message: bool
     """
     Whether the server should parse specific tool call arguments (default
-    `send_message`) as `AssistantMessage` objects.
+    `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
+    types, but deprecated for letta_v1_agent onward.
     """
 
 

{letta_sdk → letta_client}/types/agents/message_send_params.py

@@ -17,10 +17,18 @@ class MessageSendParams(TypedDict, total=False):
     """The messages to be sent to the agent."""
 
     assistant_message_tool_kwarg: str
-    """The name of the message argument in the designated message tool."""
+    """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_name: str
-    """The name of the designated message tool."""
+    """The name of the designated message tool.
+
+    Still supported for legacy agent types, but deprecated for letta_v1_agent
+    onward.
+    """
 
     enable_thinking: str
     """
@@ -39,7 +47,8 @@ class MessageSendParams(TypedDict, total=False):
     use_assistant_message: bool
     """
     Whether the server should parse specific tool call arguments (default
-    `send_message`) as `AssistantMessage` objects.
+    `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
+    types, but deprecated for letta_v1_agent onward.
     """
 
 

letta_sdk/types/agents/message_send_stream_params.py → letta_client/types/agents/message_stream_params.py

@@ -9,18 +9,26 @@ from .message_type import MessageType
 from ..message_create_param import MessageCreateParam
 from .approval_create_param import ApprovalCreateParam
 
-__all__ = ["MessageSendStreamParams", "Message"]
+__all__ = ["MessageStreamParams", "Message"]
 
 
-class MessageSendStreamParams(TypedDict, total=False):
+class MessageStreamParams(TypedDict, total=False):
     messages: Required[Iterable[Message]]
     """The messages to be sent to the agent."""
 
     assistant_message_tool_kwarg: str
-    """The name of the message argument in the designated message tool."""
+    """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_name: str
-    """The name of the designated message tool."""
+    """The name of the designated message tool.
+
+    Still supported for legacy agent types, but deprecated for letta_v1_agent
+    onward.
+    """
 
     background: bool
     """Whether to process the request in the background."""
@@ -54,7 +62,8 @@ class MessageSendStreamParams(TypedDict, total=False):
     use_assistant_message: bool
     """
     Whether the server should parse specific tool call arguments (default
-    `send_message`) as `AssistantMessage` objects.
+    `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
+    types, but deprecated for letta_v1_agent onward.
     """
 
 

{letta_sdk → letta_client}/types/agents/message_update_params.py

@@ -19,6 +19,7 @@ __all__ = [
 
 class UpdateSystemMessage(TypedDict, total=False):
     agent_id: Required[str]
+    """The ID of the agent in the format 'agent-<uuid4>'"""
 
     content: Required[str]
     """
@@ -31,6 +32,7 @@ class UpdateSystemMessage(TypedDict, total=False):
 
 class UpdateUserMessage(TypedDict, total=False):
     agent_id: Required[str]
+    """The ID of the agent in the format 'agent-<uuid4>'"""
 
     content: Required[Union[Iterable[LettaUserMessageContentUnionParam], str]]
     """
@@ -43,6 +45,7 @@ class UpdateUserMessage(TypedDict, total=False):
 
 class UpdateReasoningMessage(TypedDict, total=False):
     agent_id: Required[str]
+    """The ID of the agent in the format 'agent-<uuid4>'"""
 
     reasoning: Required[str]
 
@@ -51,6 +54,7 @@ class UpdateReasoningMessage(TypedDict, total=False):
 
 class UpdateAssistantMessage(TypedDict, total=False):
     agent_id: Required[str]
+    """The ID of the agent in the format 'agent-<uuid4>'"""
 
     content: Required[Union[Iterable[LettaAssistantMessageContentUnionParam], str]]
     """

{letta_sdk → letta_client}/types/agents/omitted_reasoning_content.py

@@ -9,5 +9,8 @@ __all__ = ["OmittedReasoningContent"]
 
 
 class OmittedReasoningContent(BaseModel):
+    signature: Optional[str] = None
+    """A unique identifier for this reasoning step."""
+
     type: Optional[Literal["omitted_reasoning"]] = None
     """Indicates this is an omitted reasoning step."""