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

letta_sdk/types/source_upload_file_params.py → letta_client/types/folders/file_upload_params.py

@@ -3,18 +3,17 @@
 from __future__ import annotations
 
 from typing import Optional
-from typing_extensions import Required, TypedDict
+from typing_extensions import Literal, Required, TypedDict
 
-from .._types import FileTypes
-from .duplicate_file_handling import DuplicateFileHandling
+from ..._types import FileTypes
 
-__all__ = ["SourceUploadFileParams"]
+__all__ = ["FileUploadParams"]
 
 
-class SourceUploadFileParams(TypedDict, total=False):
+class FileUploadParams(TypedDict, total=False):
     file: Required[FileTypes]
 
-    duplicate_handling: DuplicateFileHandling
+    duplicate_handling: Literal["skip", "error", "suffix", "replace"]
     """How to handle duplicate filenames"""
 
     name: Optional[str]

letta_client/types/folders/file_upload_response.py

@@ -0,0 +1,65 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["FileUploadResponse"]
+
+
+class FileUploadResponse(BaseModel):
+    source_id: str
+    """The unique identifier of the source associated with the document."""
+
+    id: Optional[str] = None
+    """The human-friendly ID of the File"""
+
+    chunks_embedded: Optional[int] = None
+    """Number of chunks that have been embedded."""
+
+    content: Optional[str] = None
+    """
+    Optional full-text content of the file; only populated on demand due to its
+    size.
+    """
+
+    created_at: Optional[datetime] = None
+    """The creation date of the file."""
+
+    error_message: Optional[str] = None
+    """Optional error message if the file failed processing."""
+
+    file_creation_date: Optional[str] = None
+    """The creation date of the file."""
+
+    file_last_modified_date: Optional[str] = None
+    """The last modified date of the file."""
+
+    file_name: Optional[str] = None
+    """The name of the file."""
+
+    file_path: Optional[str] = None
+    """The path to the file."""
+
+    file_size: Optional[int] = None
+    """The size of the file in bytes."""
+
+    file_type: Optional[str] = None
+    """The type of the file (MIME type)."""
+
+    original_file_name: Optional[str] = None
+    """The original name of the file as uploaded."""
+
+    processing_status: Optional[Literal["pending", "parsing", "embedding", "completed", "error"]] = None
+    """The current processing status of the file (e.g.
+
+    pending, parsing, embedding, completed, error).
+    """
+
+    total_chunks: Optional[int] = None
+    """Total number of chunks for the file."""
+
+    updated_at: Optional[datetime] = None
+    """The update date of the file."""

{letta_sdk → letta_client}/types/groups/__init__.py

@@ -4,7 +4,6 @@ from __future__ import annotations
 
 from .message_list_params import MessageListParams as MessageListParams
 from .message_send_params import MessageSendParams as MessageSendParams
-from .message_list_response import MessageListResponse as MessageListResponse
+from .message_stream_params import MessageStreamParams as MessageStreamParams
 from .message_update_params import MessageUpdateParams as MessageUpdateParams
 from .message_update_response import MessageUpdateResponse as MessageUpdateResponse
-from .message_send_stream_params import MessageSendStreamParams as MessageSendStreamParams

{letta_sdk → letta_client}/types/groups/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/groups/message_send_stream_params.py → letta_client/types/groups/message_stream_params.py

@@ -9,18 +9,26 @@ from ..agents.message_type import MessageType
 from ..message_create_param import MessageCreateParam
 from ..agents.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/groups/message_update_params.py

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

letta_sdk/types/health_check_response.py → letta_client/types/health_response.py

@@ -2,10 +2,10 @@
 
 from .._models import BaseModel
 
-__all__ = ["HealthCheckResponse"]
+__all__ = ["HealthResponse"]
 
 
-class HealthCheckResponse(BaseModel):
+class HealthResponse(BaseModel):
     status: str
 
     version: str

letta_client/types/identities/__init__.py

@@ -0,0 +1,7 @@
+# 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
+from .block_list_params import BlockListParams as BlockListParams
+from .property_upsert_params import PropertyUpsertParams as PropertyUpsertParams

letta_sdk/types/identity_list_agents_params.py → letta_client/types/identities/agent_list_params.py

@@ -2,13 +2,13 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import List, Optional
 from typing_extensions import Literal, TypedDict
 
-__all__ = ["IdentityListAgentsParams"]
+__all__ = ["AgentListParams"]
 
 
-class IdentityListAgentsParams(TypedDict, total=False):
+class AgentListParams(TypedDict, total=False):
     after: Optional[str]
     """Agent ID cursor for pagination.
 
@@ -21,6 +21,22 @@ class IdentityListAgentsParams(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.
+    """
+
     limit: Optional[int]
     """Maximum number of agents to return"""
 

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

letta_sdk/types/identity_upsert_properties_params.py → letta_client/types/identities/property_upsert_params.py

@@ -5,10 +5,10 @@ from __future__ import annotations
 from typing import Iterable
 from typing_extensions import Required, TypedDict
 
-from .identity_property_param import IdentityPropertyParam
+from ..identity_property_param import IdentityPropertyParam
 
-__all__ = ["IdentityUpsertPropertiesParams"]
+__all__ = ["PropertyUpsertParams"]
 
 
-class IdentityUpsertPropertiesParams(TypedDict, total=False):
+class PropertyUpsertParams(TypedDict, total=False):
     body: Required[Iterable[IdentityPropertyParam]]

letta_sdk/types/identity_modify_params.py → letta_client/types/identity_update_params.py

@@ -9,10 +9,10 @@ from .._types import SequenceNotStr
 from .identity_type import IdentityType
 from .identity_property_param import IdentityPropertyParam
 
-__all__ = ["IdentityModifyParams"]
+__all__ = ["IdentityUpdateParams"]
 
 
-class IdentityModifyParams(TypedDict, total=False):
+class IdentityUpdateParams(TypedDict, total=False):
     agent_ids: Optional[SequenceNotStr[str]]
     """The agent ids that are associated with the identity."""
 

{letta_sdk → letta_client}/types/init_tool_rule.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import Dict, Optional
 from typing_extensions import Literal
 
 from .._models import BaseModel
@@ -12,6 +12,15 @@ class InitToolRule(BaseModel):
     tool_name: str
     """The name of the tool. Must exist in the database for the user's organization."""
 
+    args: Optional[Dict[str, object]] = None
+    """Optional prefilled arguments for this tool.
+
+    When present, these values will override any LLM-provided arguments with the
+    same keys during invocation. 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.
+    """
+
     prompt_template: Optional[str] = None
     """Optional template string (ignored).
 

{letta_sdk → letta_client}/types/init_tool_rule_param.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Dict, Optional
 from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["InitToolRuleParam"]
@@ -12,6 +12,15 @@ class InitToolRuleParam(TypedDict, total=False):
     tool_name: Required[str]
     """The name of the tool. Must exist in the database for the user's organization."""
 
+    args: Optional[Dict[str, object]]
+    """Optional prefilled arguments for this tool.
+
+    When present, these values will override any LLM-provided arguments with the
+    same keys during invocation. 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.
+    """
+
     prompt_template: Optional[str]
     """Optional template string (ignored).
 

{letta_sdk → letta_client}/types/llm_config.py

@@ -46,6 +46,9 @@ class LlmConfig(BaseModel):
     compatibility_type: Optional[Literal["gguf", "mlx"]] = None
     """The framework compatibility type for the model."""
 
+    display_name: Optional[str] = None
+    """A human-friendly display name for the model."""
+
     enable_reasoner: Optional[bool] = None
     """
     Whether or not the model should use extended thinking if it is a 'reasoning'
@@ -81,6 +84,9 @@ class LlmConfig(BaseModel):
     api_model_wrapper: Optional[str] = FieldInfo(alias="model_wrapper", default=None)
     """The wrapper for the model."""
 
+    parallel_tool_calls: Optional[bool] = None
+    """If set to True, enables parallel tool calling. Defaults to False."""
+
     provider_category: Optional[ProviderCategory] = None
     """The provider category for the model."""
 

{letta_sdk → letta_client}/types/llm_config_param.py

@@ -47,6 +47,9 @@ class LlmConfigParam(TypedDict, total=False):
     compatibility_type: Optional[Literal["gguf", "mlx"]]
     """The framework compatibility type for the model."""
 
+    display_name: Optional[str]
+    """A human-friendly display name for the model."""
+
     enable_reasoner: bool
     """
     Whether or not the model should use extended thinking if it is a 'reasoning'
@@ -82,6 +85,9 @@ class LlmConfigParam(TypedDict, total=False):
     model_wrapper: Optional[str]
     """The wrapper for the model."""
 
+    parallel_tool_calls: Optional[bool]
+    """If set to True, enables parallel tool calling. Defaults to False."""
+
     provider_category: Optional[ProviderCategory]
     """The provider category for the model."""
 

{letta_sdk/types/voice_beta → letta_client/types/models}/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-from .chat_create_completion_params import ChatCreateCompletionParams as ChatCreateCompletionParams
+from .embedding_list_response import EmbeddingListResponse as EmbeddingListResponse

letta_sdk/types/agents/archival_memory_create_response.py → letta_client/types/models/embedding_list_response.py

@@ -3,8 +3,8 @@
 from typing import List
 from typing_extensions import TypeAlias
 
-from ..passage import Passage
+from ..embedding_config import EmbeddingConfig
 
-__all__ = ["ArchivalMemoryCreateResponse"]
+__all__ = ["EmbeddingListResponse"]
 
-ArchivalMemoryCreateResponse: TypeAlias = List[Passage]
+EmbeddingListResponse: TypeAlias = List[EmbeddingConfig]

{letta_sdk → letta_client}/types/run_list_params.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Optional
-from typing_extensions import TypedDict
+from typing_extensions import Literal, TypedDict
 
 from .._types import SequenceNotStr
 from .stop_reason_type import StopReasonType
@@ -16,25 +16,49 @@ class RunListParams(TypedDict, total=False):
     """Filter for active runs."""
 
     after: Optional[str]
-    """Cursor for pagination"""
+    """Run ID cursor for pagination.
 
-    agent_ids: Optional[SequenceNotStr[str]]
+    Returns runs that come after this run ID in the specified sort order
+    """
+
+    agent_id: Optional[str]
     """The unique identifier of the agent associated with the run."""
 
+    agent_ids: Optional[SequenceNotStr[str]]
+    """The unique identifiers of the agents associated with the run.
+
+    Deprecated in favor of agent_id field.
+    """
+
     ascending: bool
     """
     Whether to sort agents oldest to newest (True) or newest to oldest (False,
-    default)
+    default). Deprecated in favor of order field.
     """
 
     background: Optional[bool]
     """If True, filters for runs that were created in background mode."""
 
     before: Optional[str]
-    """Cursor for pagination"""
+    """Run ID cursor for pagination.
+
+    Returns runs that come before this run ID in the specified sort order
+    """
 
     limit: Optional[int]
     """Maximum number of runs to return"""
 
+    order: Literal["asc", "desc"]
+    """Sort order for runs by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""
+
+    statuses: Optional[SequenceNotStr[str]]
+    """Filter runs by status. Can specify multiple statuses."""
+
     stop_reason: Optional[StopReasonType]
     """Filter runs by stop reason."""

letta_client/types/runs/__init__.py

@@ -0,0 +1,8 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .step_list_params import StepListParams as StepListParams
+from .message_list_params import MessageListParams as MessageListParams
+from .message_stream_params import MessageStreamParams as MessageStreamParams
+from .usage_retrieve_response import UsageRetrieveResponse as UsageRetrieveResponse

letta_sdk/types/run_list_messages_params.py → letta_client/types/runs/message_list_params.py

@@ -5,10 +5,10 @@ from __future__ import annotations
 from typing import Optional
 from typing_extensions import Literal, TypedDict
 
-__all__ = ["RunListMessagesParams"]
+__all__ = ["MessageListParams"]
 
 
-class RunListMessagesParams(TypedDict, total=False):
+class MessageListParams(TypedDict, total=False):
     after: Optional[str]
     """Message ID cursor for pagination.
 
@@ -29,3 +29,6 @@ class RunListMessagesParams(TypedDict, total=False):
 
     'asc' for oldest first, 'desc' for newest first
     """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_sdk/types/run_retrieve_stream_params.py → letta_client/types/runs/message_stream_params.py

@@ -5,10 +5,10 @@ from __future__ import annotations
 from typing import Optional
 from typing_extensions import TypedDict
 
-__all__ = ["RunRetrieveStreamParams"]
+__all__ = ["MessageStreamParams"]
 
 
-class RunRetrieveStreamParams(TypedDict, total=False):
+class MessageStreamParams(TypedDict, total=False):
     batch_size: Optional[int]
     """Number of entries to read per batch."""
 

letta_sdk/types/run_list_steps_params.py → letta_client/types/runs/step_list_params.py

@@ -3,12 +3,12 @@
 from __future__ import annotations
 
 from typing import Optional
-from typing_extensions import TypedDict
+from typing_extensions import Literal, TypedDict
 
-__all__ = ["RunListStepsParams"]
+__all__ = ["StepListParams"]
 
 
-class RunListStepsParams(TypedDict, total=False):
+class StepListParams(TypedDict, total=False):
     after: Optional[str]
     """Cursor for pagination"""
 
@@ -18,8 +18,11 @@ class RunListStepsParams(TypedDict, total=False):
     limit: Optional[int]
     """Maximum number of messages to return"""
 
-    order: str
-    """Sort order by the created_at timestamp of the objects.
+    order: Literal["asc", "desc"]
+    """Sort order for steps by creation time.
 
-    asc for ascending order and desc for descending order.
+    'asc' for oldest first, 'desc' for newest first
     """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_sdk/types/run_retrieve_usage_response.py → letta_client/types/runs/usage_retrieve_response.py

@@ -2,9 +2,9 @@
 
 from typing import Optional
 
-from .._models import BaseModel
+from ..._models import BaseModel
 
-__all__ = ["RunRetrieveUsageResponse", "CompletionTokensDetails", "PromptTokensDetails"]
+__all__ = ["UsageRetrieveResponse", "CompletionTokensDetails", "PromptTokensDetails"]
 
 
 class CompletionTokensDetails(BaseModel):
@@ -15,7 +15,7 @@ class PromptTokensDetails(BaseModel):
     cached_tokens: Optional[int] = None
 
 
-class RunRetrieveUsageResponse(BaseModel):
+class UsageRetrieveResponse(BaseModel):
     completion_tokens: Optional[int] = None
 
     completion_tokens_details: Optional[CompletionTokensDetails] = None

{letta_sdk → letta_client}/types/step.py

@@ -37,12 +37,6 @@ class Step(BaseModel):
     feedback: Optional[Literal["positive", "negative"]] = None
     """The feedback for this step. Must be either 'positive' or 'negative'."""
 
-    job_id: Optional[str] = None
-    """The unique identifier of the job that this step belongs to.
-
-    Only included for async calls.
-    """
-
     messages: Optional[List[Message]] = None
     """The messages generated during this step.
 
@@ -73,6 +67,12 @@ class Step(BaseModel):
     provider_name: Optional[str] = None
     """The name of the provider used for this step."""
 
+    run_id: Optional[str] = None
+    """The unique identifier of the run that this step belongs to.
+
+    Only included for async calls.
+    """
+
     status: Optional[Literal["pending", "success", "failed", "cancelled"]] = None
     """Status of a step execution"""
 

letta_client/types/steps/__init__.py

@@ -0,0 +1,8 @@
+# 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
+from .feedback_create_params import FeedbackCreateParams as FeedbackCreateParams
+from .metric_retrieve_response import MetricRetrieveResponse as MetricRetrieveResponse

letta_sdk/types/step_update_feedback_params.py → letta_client/types/steps/feedback_create_params.py

@@ -5,12 +5,12 @@ from __future__ import annotations
 from typing import Optional
 from typing_extensions import Literal, TypedDict
 
-from .._types import SequenceNotStr
+from ..._types import SequenceNotStr
 
-__all__ = ["StepUpdateFeedbackParams"]
+__all__ = ["FeedbackCreateParams"]
 
 
-class StepUpdateFeedbackParams(TypedDict, total=False):
+class FeedbackCreateParams(TypedDict, total=False):
     feedback: Optional[Literal["positive", "negative"]]
     """Whether this feedback is positive or negative"""