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

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

@@ -2,10 +2,9 @@
 
 from typing import Dict, List, Optional
 from datetime import datetime
+from typing_extensions import Literal
 
-from .job_type import JobType
 from ..._models import BaseModel
-from .job_status import JobStatus
 from .message_type import MessageType
 from ..stop_reason_type import StopReasonType
 
@@ -33,9 +32,18 @@ class RequestConfig(BaseModel):
 
 
 class Run(BaseModel):
+    agent_id: str
+    """The unique identifier of the agent associated with the run."""
+
     id: Optional[str] = None
     """The human-friendly ID of the Run"""
 
+    background: Optional[bool] = None
+    """Whether the run was created in background mode."""
+
+    base_template_id: Optional[str] = None
+    """The base template ID that the run belongs to."""
+
     callback_error: Optional[str] = None
     """Optional error message from attempting to POST the callback endpoint."""
 
@@ -46,30 +54,22 @@ class Run(BaseModel):
     """HTTP status code returned by the callback endpoint."""
 
     callback_url: Optional[str] = None
-    """If set, POST to this URL when the job completes."""
+    """If set, POST to this URL when the run completes."""
 
     completed_at: Optional[datetime] = None
-    """The unix timestamp of when the job was completed."""
+    """The timestamp when the run was completed."""
 
     created_at: Optional[datetime] = None
-    """The unix timestamp of when the job was created."""
-
-    created_by_id: Optional[str] = None
-    """The id of the user that made this object."""
-
-    job_type: Optional[JobType] = None
-
-    last_updated_by_id: Optional[str] = None
-    """The id of the user that made this object."""
+    """The timestamp when the run was created."""
 
     metadata: Optional[Dict[str, object]] = None
-    """The metadata of the job."""
+    """Additional metadata for the run."""
 
     request_config: Optional[RequestConfig] = None
     """The request configuration for the run."""
 
-    status: Optional[JobStatus] = None
-    """The status of the job."""
+    status: Optional[Literal["created", "running", "completed", "failed", "cancelled"]] = None
+    """The current status of the run."""
 
     stop_reason: Optional[StopReasonType] = None
     """The reason why the run was stopped."""
@@ -79,6 +79,3 @@ class Run(BaseModel):
 
     ttft_ns: Optional[int] = None
     """Time to first token for a run in nanoseconds"""
-
-    updated_at: Optional[datetime] = None
-    """The timestamp when the object was last updated."""

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

@@ -12,5 +12,8 @@ class TextContent(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/text_content_param.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from typing import Optional
 from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["TextContentParam"]
@@ -11,5 +12,8 @@ class TextContentParam(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/tool_call_content.py

@@ -21,5 +21,8 @@ class ToolCallContent(BaseModel):
     name: str
     """The name of the tool being called."""
 
+    signature: Optional[str] = None
+    """Stores a unique identifier for any reasoning associated with this tool call."""
+
     type: Optional[Literal["tool_call"]] = None
     """Indicates this content represents a tool call event."""

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

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict
+from typing import Dict, Optional
 from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["ToolCallContentParam"]
@@ -21,5 +21,8 @@ class ToolCallContentParam(TypedDict, total=False):
     name: Required[str]
     """The name of the tool being called."""
 
+    signature: Optional[str]
+    """Stores a unique identifier for any reasoning associated with this tool call."""
+
     type: Literal["tool_call"]
     """Indicates this content represents a tool call event."""

{letta_sdk → letta_client}/types/agents/tool_call_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__ = ["ToolCallMessage", "ToolCall"]
+__all__ = ["ToolCallMessage", "ToolCall", "ToolCalls"]
 
 ToolCall: TypeAlias = Union[tool_call.ToolCall, ToolCallDelta]
 
+ToolCalls: TypeAlias = Union[List[tool_call.ToolCall], ToolCallDelta, None]
+
 
 class ToolCallMessage(BaseModel):
     id: str
@@ -36,3 +38,5 @@ class ToolCallMessage(BaseModel):
     seq_id: Optional[int] = None
 
     step_id: Optional[str] = None
+
+    tool_calls: Optional[ToolCalls] = None

letta_client/types/agents/tool_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__ = ["ToolListParams"]
+
+
+class ToolListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Tool ID cursor for pagination.
+
+    Returns tools that come after this tool ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """Tool ID cursor for pagination.
+
+    Returns tools that come before this tool ID in the specified sort order
+    """
+
+    limit: Optional[int]
+    """Maximum number of tools to return"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for tools by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

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

@@ -10,10 +10,14 @@ __all__ = ["ToolReturn"]
 
 class ToolReturn(BaseModel):
     status: Literal["success", "error"]
-    """The status of the tool call"""
+
+    tool_call_id: str
+
+    tool_return: str
 
     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"""
+
+    type: Optional[Literal["tool"]] = None
+    """The message type to be created."""

letta_client/types/agents/tool_return_param.py

@@ -0,0 +1,25 @@
+# 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, Required, TypedDict
+
+from ..._types import SequenceNotStr
+
+__all__ = ["ToolReturnParam"]
+
+
+class ToolReturnParam(TypedDict, total=False):
+    status: Required[Literal["success", "error"]]
+
+    tool_call_id: Required[str]
+
+    tool_return: Required[str]
+
+    stderr: Optional[SequenceNotStr[str]]
+
+    stdout: Optional[SequenceNotStr[str]]
+
+    type: Literal["tool"]
+    """The message type to be created."""

letta_client/types/agents/tool_update_approval_params.py

@@ -0,0 +1,21 @@
+# 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 Required, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["ToolUpdateApprovalParams"]
+
+
+class ToolUpdateApprovalParams(TypedDict, total=False):
+    agent_id: Required[str]
+    """The ID of the agent in the format 'agent-<uuid4>'"""
+
+    body_requires_approval: Required[Annotated[bool, PropertyInfo(alias="requires_approval")]]
+    """Whether the tool requires approval before execution"""
+
+    query_requires_approval: Annotated[Optional[bool], PropertyInfo(alias="requires_approval")]
+    """Whether the tool requires approval before execution"""

{letta_sdk → letta_client}/types/archive.py

@@ -4,6 +4,7 @@ from typing import Dict, Optional
 from datetime import datetime
 
 from .._models import BaseModel
+from .embedding_config import EmbeddingConfig
 from .vector_db_provider import VectorDBProvider
 
 __all__ = ["Archive"]
@@ -13,6 +14,9 @@ class Archive(BaseModel):
     created_at: datetime
     """The creation date of the archive"""
 
+    embedding_config: EmbeddingConfig
+    """Embedding configuration for passages in this archive"""
+
     name: str
     """The name of the archive"""
 

letta_client/types/archive_create_params.py

@@ -0,0 +1,19 @@
+# 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 Required, TypedDict
+
+from .embedding_config_param import EmbeddingConfigParam
+
+__all__ = ["ArchiveCreateParams"]
+
+
+class ArchiveCreateParams(TypedDict, total=False):
+    embedding_config: Required[EmbeddingConfigParam]
+    """Embedding configuration for the archive"""
+
+    name: Required[str]
+
+    description: Optional[str]

letta_sdk/types/archive_retrieve_params.py → letta_client/types/archive_list_params.py

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

letta_sdk/types/archive_retrieve_response.py → letta_client/types/archive_list_response.py

@@ -5,6 +5,6 @@ from typing_extensions import TypeAlias
 
 from .archive import Archive
 
-__all__ = ["ArchiveRetrieveResponse"]
+__all__ = ["ArchiveListResponse"]
 
-ArchiveRetrieveResponse: TypeAlias = List[Archive]
+ArchiveListResponse: TypeAlias = List[Archive]

{letta_sdk → letta_client}/types/archive_update_params.py

@@ -3,12 +3,12 @@
 from __future__ import annotations
 
 from typing import Optional
-from typing_extensions import Required, TypedDict
+from typing_extensions import TypedDict
 
 __all__ = ["ArchiveUpdateParams"]
 
 
 class ArchiveUpdateParams(TypedDict, total=False):
-    name: Required[str]
-
     description: Optional[str]
+
+    name: Optional[str]

{letta_sdk/types/messages → letta_client/types}/batch_create_params.py

@@ -5,9 +5,9 @@ from __future__ import annotations
 from typing import List, Union, Iterable, Optional
 from typing_extensions import Required, TypeAlias, TypedDict
 
-from ..agents.message_type import MessageType
-from ..message_create_param import MessageCreateParam
-from ..agents.approval_create_param import ApprovalCreateParam
+from .agents.message_type import MessageType
+from .message_create_param import MessageCreateParam
+from .agents.approval_create_param import ApprovalCreateParam
 
 __all__ = ["BatchCreateParams", "Request", "RequestMessage"]
 
@@ -38,10 +38,18 @@ class Request(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
     """
@@ -60,5 +68,6 @@ class Request(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/job.py → letta_client/types/batch_job.py

@@ -8,13 +8,19 @@ from .agents.job_type import JobType
 from .stop_reason_type import StopReasonType
 from .agents.job_status import JobStatus
 
-__all__ = ["Job"]
+__all__ = ["BatchJob"]
 
 
-class Job(BaseModel):
+class BatchJob(BaseModel):
     id: Optional[str] = None
     """The human-friendly ID of the Job"""
 
+    agent_id: Optional[str] = None
+    """The agent associated with this job/run."""
+
+    background: Optional[bool] = None
+    """Whether the job was created in background mode."""
+
     callback_error: Optional[str] = None
     """Optional error message from attempting to POST the callback endpoint."""
 
@@ -37,7 +43,6 @@ class Job(BaseModel):
     """The id of the user that made this object."""
 
     job_type: Optional[JobType] = None
-    """The type of the job."""
 
     last_updated_by_id: Optional[str] = None
     """The id of the user that made this object."""

letta_client/types/batches/__init__.py

@@ -0,0 +1,6 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .message_list_params import MessageListParams as MessageListParams
+from .message_list_response import MessageListResponse as MessageListResponse

letta_sdk/types/messages/batch_list_messages_params.py → letta_client/types/batches/message_list_params.py

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

letta_sdk/types/messages/batch_list_messages_response.py → letta_client/types/batches/message_list_response.py

@@ -5,8 +5,8 @@ from typing import List
 from ..._models import BaseModel
 from ..agents.message import Message
 
-__all__ = ["BatchListMessagesResponse"]
+__all__ = ["MessageListResponse"]
 
 
-class BatchListMessagesResponse(BaseModel):
+class MessageListResponse(BaseModel):
     messages: List[Message]

{letta_sdk/types/tools → letta_client/types/blocks}/__init__.py

@@ -1,3 +1,5 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from __future__ import annotations
+
+from .agent_list_params import AgentListParams as AgentListParams

letta_sdk/types/block_list_agents_params.py → letta_client/types/blocks/agent_list_params.py

@@ -2,15 +2,15 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import List, Optional
 from typing_extensions import Literal, TypedDict
 
-from .._types import SequenceNotStr
+from ..._types import SequenceNotStr
 
-__all__ = ["BlockListAgentsParams"]
+__all__ = ["AgentListParams"]
 
 
-class BlockListAgentsParams(TypedDict, total=False):
+class AgentListParams(TypedDict, total=False):
     after: Optional[str]
     """Agent ID cursor for pagination.
 
@@ -23,11 +23,28 @@ class BlockListAgentsParams(TypedDict, total=False):
     Returns agents that come before this agent ID in the specified sort order
     """
 
+    include: List[
+        Literal[
+            "agent.blocks",
+            "agent.identities",
+            "agent.managed_group",
+            "agent.secrets",
+            "agent.sources",
+            "agent.tags",
+            "agent.tools",
+        ]
+    ]
+    """Specify which relational fields to include in the response.
+
+    No relationships are included by default.
+    """
+
     include_relationships: Optional[SequenceNotStr[str]]
     """
     Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
     in the response. If not provided, all relationships are loaded by default. Using
-    this can optimize performance by reducing unnecessary joins.
+    this can optimize performance by reducing unnecessary joins.This is a legacy
+    parameter, and no longer supported after 1.0.0 SDK versions.
     """
 
     limit: Optional[int]

letta_client/types/child_tool_rule.py

@@ -0,0 +1,40 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["ChildToolRule", "ChildArgNode"]
+
+
+class ChildArgNode(BaseModel):
+    name: str
+    """The name of the child tool to invoke next."""
+
+    args: Optional[Dict[str, object]] = None
+    """Optional prefilled arguments for this child tool.
+
+    Keys must match the tool's parameter names and values must satisfy the tool's
+    JSON schema. Supports partial prefill; non-overlapping parameters are left to
+    the model.
+    """
+
+
+class ChildToolRule(BaseModel):
+    children: List[str]
+    """The children tools that can be invoked."""
+
+    tool_name: str
+    """The name of the tool. Must exist in the database for the user's organization."""
+
+    child_arg_nodes: Optional[List[ChildArgNode]] = None
+    """Optional list of typed child argument overrides.
+
+    Each node must reference a child in 'children'.
+    """
+
+    prompt_template: Optional[str] = None
+    """Optional template string (ignored)."""
+
+    type: Optional[Literal["constrain_child_tools"]] = None

letta_client/types/child_tool_rule_param.py

@@ -0,0 +1,42 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Iterable, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+from .._types import SequenceNotStr
+
+__all__ = ["ChildToolRuleParam", "ChildArgNode"]
+
+
+class ChildArgNode(TypedDict, total=False):
+    name: Required[str]
+    """The name of the child tool to invoke next."""
+
+    args: Optional[Dict[str, object]]
+    """Optional prefilled arguments for this child tool.
+
+    Keys must match the tool's parameter names and values must satisfy the tool's
+    JSON schema. Supports partial prefill; non-overlapping parameters are left to
+    the model.
+    """
+
+
+class ChildToolRuleParam(TypedDict, total=False):
+    children: Required[SequenceNotStr[str]]
+    """The children tools that can be invoked."""
+
+    tool_name: Required[str]
+    """The name of the tool. Must exist in the database for the user's organization."""
+
+    child_arg_nodes: Optional[Iterable[ChildArgNode]]
+    """Optional list of typed child argument overrides.
+
+    Each node must reference a child in 'children'.
+    """
+
+    prompt_template: Optional[str]
+    """Optional template string (ignored)."""
+
+    type: Literal["constrain_child_tools"]

letta_client/types/folders/__init__.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .file_list_params import FileListParams as FileListParams
+from .agent_list_params import AgentListParams as AgentListParams
+from .file_list_response import FileListResponse as FileListResponse
+from .file_upload_params import FileUploadParams as FileUploadParams
+from .agent_list_response import AgentListResponse as AgentListResponse
+from .file_upload_response import FileUploadResponse as FileUploadResponse

letta_sdk/types/folder_list_agents_params.py → letta_client/types/folders/agent_list_params.py

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

letta_client/types/folders/agent_list_response.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import TypeAlias
+
+__all__ = ["AgentListResponse"]
+
+AgentListResponse: TypeAlias = str

letta_sdk/types/folder_list_files_params.py → letta_client/types/folders/file_list_params.py

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

letta_sdk/types/file_metadata.py → letta_client/types/folders/file_list_response.py

@@ -2,14 +2,14 @@
 
 from typing import Optional
 from datetime import datetime
+from typing_extensions import Literal
 
-from .._models import BaseModel
-from .file_processing_status import FileProcessingStatus
+from ..._models import BaseModel
 
-__all__ = ["FileMetadata"]
+__all__ = ["FileListResponse"]
 
 
-class FileMetadata(BaseModel):
+class FileListResponse(BaseModel):
     source_id: str
     """The unique identifier of the source associated with the document."""
 
@@ -52,7 +52,7 @@ class FileMetadata(BaseModel):
     original_file_name: Optional[str] = None
     """The original name of the file as uploaded."""
 
-    processing_status: Optional[FileProcessingStatus] = None
+    processing_status: Optional[Literal["pending", "parsing", "embedding", "completed", "error"]] = None
     """The current processing status of the file (e.g.
 
     pending, parsing, embedding, completed, error).