letta-client 0.1.226__py3-none-any.whl → 1.7.2__py3-none-any.whl

letta_client/types/agents/system_message.py

@@ -0,0 +1,46 @@
+# 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__ = ["SystemMessage"]
+
+
+class SystemMessage(BaseModel):
+    """A message generated by the system.
+
+    Never streamed back on a response, only used for cursor pagination.
+
+    Args:
+        id (str): The ID of the message
+        date (datetime): The date the message was created in ISO format
+        name (Optional[str]): The name of the sender of the message
+        content (str): The message content sent by the system
+    """
+
+    id: str
+
+    content: str
+    """The message content sent by the system"""
+
+    date: datetime
+
+    is_err: Optional[bool] = None
+
+    message_type: Optional[Literal["system_message"]] = None
+    """The type of the message."""
+
+    name: Optional[str] = None
+
+    otid: Optional[str] = None
+
+    run_id: Optional[str] = None
+
+    sender_id: Optional[str] = None
+
+    seq_id: Optional[int] = None
+
+    step_id: Optional[str] = None

letta_client/types/agents/text_content.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["TextContent"]
+
+
+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_client/types/agents/text_content_param.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 Literal, Required, TypedDict
+
+__all__ = ["TextContentParam"]
+
+
+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_client/types/agents/tool_call.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ..._models import BaseModel
+
+__all__ = ["ToolCall"]
+
+
+class ToolCall(BaseModel):
+    arguments: str
+
+    name: str
+
+    tool_call_id: str

letta_client/types/agents/tool_call_content.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["ToolCallContent"]
+
+
+class ToolCallContent(BaseModel):
+    id: str
+    """A unique identifier for this specific tool call instance."""
+
+    input: Dict[str, object]
+    """
+    The parameters being passed to the tool, structured as a dictionary of parameter
+    names to values.
+    """
+
+    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_client/types/agents/tool_call_content_param.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["ToolCallContentParam"]
+
+
+class ToolCallContentParam(TypedDict, total=False):
+    id: Required[str]
+    """A unique identifier for this specific tool call instance."""
+
+    input: Required[Dict[str, object]]
+    """
+    The parameters being passed to the tool, structured as a dictionary of parameter
+    names to values.
+    """
+
+    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_client/types/agents/tool_call_delta.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ToolCallDelta"]
+
+
+class ToolCallDelta(BaseModel):
+    arguments: Optional[str] = None
+
+    name: Optional[str] = None
+
+    tool_call_id: Optional[str] = None

letta_client/types/agents/tool_call_message.py

@@ -0,0 +1,52 @@
+# 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, TypeAlias
+
+from . import tool_call
+from ..._models import BaseModel
+from .tool_call_delta import ToolCallDelta
+
+__all__ = ["ToolCallMessage", "ToolCall", "ToolCalls"]
+
+ToolCall: TypeAlias = Union[tool_call.ToolCall, ToolCallDelta]
+
+ToolCalls: TypeAlias = Union[List[tool_call.ToolCall], ToolCallDelta, None]
+
+
+class ToolCallMessage(BaseModel):
+    """
+    A message representing a request to call a tool (generated by the LLM to trigger tool execution).
+
+    Args:
+        id (str): The ID of the message
+        date (datetime): The date the message was created in ISO format
+        name (Optional[str]): The name of the sender of the message
+        tool_call (Union[ToolCall, ToolCallDelta]): The tool call
+    """
+
+    id: str
+
+    date: datetime
+
+    tool_call: ToolCall
+
+    is_err: Optional[bool] = None
+
+    message_type: Optional[Literal["tool_call_message"]] = None
+    """The type of the message."""
+
+    name: Optional[str] = None
+
+    otid: Optional[str] = None
+
+    run_id: Optional[str] = None
+
+    sender_id: Optional[str] = None
+
+    seq_id: Optional[int] = None
+
+    step_id: Optional[str] = None
+
+    tool_calls: Optional[ToolCalls] = None

letta_client/types/agents/tool_execution_result.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from ..agent_state import AgentState
+
+__all__ = ["ToolExecutionResult"]
+
+
+class ToolExecutionResult(BaseModel):
+    status: Literal["success", "error"]
+    """The status of the tool execution and return object"""
+
+    agent_state: Optional[AgentState] = None
+    """Representation of an agent's state.
+
+    This is the state of the agent at a given time, and is persisted in the DB
+    backend. The state has all the information needed to recreate a persisted agent.
+    """
+
+    func_return: Optional[object] = None
+    """The function return object"""
+
+    sandbox_config_fingerprint: Optional[str] = None
+    """The fingerprint of the config for the sandbox"""
+
+    stderr: Optional[List[str]] = None
+    """Captured stderr from the function invocation"""
+
+    stdout: Optional[List[str]] = None
+    """Captured stdout (prints, logs) from function invocation"""

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_client/types/agents/tool_return.py

@@ -0,0 +1,29 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from ..._utils import PropertyInfo
+from ..._models import BaseModel
+from .text_content import TextContent
+from .image_content import ImageContent
+
+__all__ = ["ToolReturn", "ToolReturnUnionMember0"]
+
+ToolReturnUnionMember0: TypeAlias = Annotated[Union[TextContent, ImageContent], PropertyInfo(discriminator="type")]
+
+
+class ToolReturn(BaseModel):
+    status: Literal["success", "error"]
+
+    tool_call_id: str
+
+    tool_return: Union[List[ToolReturnUnionMember0], str]
+    """The tool return value - either a string or list of content parts (text/image)"""
+
+    stderr: Optional[List[str]] = None
+
+    stdout: Optional[List[str]] = None
+
+    type: Optional[Literal["tool"]] = None
+    """The message type to be created."""

letta_client/types/agents/tool_return_content.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["ToolReturnContent"]
+
+
+class ToolReturnContent(BaseModel):
+    content: str
+    """The content returned by the tool execution."""
+
+    is_error: bool
+    """Indicates whether the tool execution resulted in an error."""
+
+    tool_call_id: str
+    """References the ID of the ToolCallContent that initiated this tool call."""
+
+    type: Optional[Literal["tool_return"]] = None
+    """Indicates this content represents a tool return event."""

letta_client/types/agents/tool_return_content_param.py

@@ -0,0 +1,21 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["ToolReturnContentParam"]
+
+
+class ToolReturnContentParam(TypedDict, total=False):
+    content: Required[str]
+    """The content returned by the tool execution."""
+
+    is_error: Required[bool]
+    """Indicates whether the tool execution resulted in an error."""
+
+    tool_call_id: Required[str]
+    """References the ID of the ToolCallContent that initiated this tool call."""
+
+    type: Literal["tool_return"]
+    """Indicates this content represents a tool return event."""

letta_client/types/agents/tool_return_param.py

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Iterable, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from ..._types import SequenceNotStr
+from .text_content_param import TextContentParam
+from .image_content_param import ImageContentParam
+
+__all__ = ["ToolReturnParam", "ToolReturnUnionMember0"]
+
+ToolReturnUnionMember0: TypeAlias = Union[TextContentParam, ImageContentParam]
+
+
+class ToolReturnParam(TypedDict, total=False):
+    status: Required[Literal["success", "error"]]
+
+    tool_call_id: Required[str]
+
+    tool_return: Required[Union[Iterable[ToolReturnUnionMember0], str]]
+    """The tool return value - either a string or list of content parts (text/image)"""
+
+    stderr: Optional[SequenceNotStr[str]]
+
+    stdout: Optional[SequenceNotStr[str]]
+
+    type: Literal["tool"]
+    """The message type to be created."""

letta_client/types/agents/tool_run_params.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict
+from typing_extensions import Required, TypedDict
+
+__all__ = ["ToolRunParams"]
+
+
+class ToolRunParams(TypedDict, total=False):
+    agent_id: Required[str]
+    """The ID of the agent in the format 'agent-<uuid4>'"""
+
+    args: Dict[str, object]
+    """Arguments to pass to the tool"""

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_client/types/agents/user_message.py

@@ -0,0 +1,50 @@
+# 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
+
+from ..._models import BaseModel
+from .letta_user_message_content_union import LettaUserMessageContentUnion
+
+__all__ = ["UserMessage"]
+
+
+class UserMessage(BaseModel):
+    """A message sent by the user.
+
+    Never streamed back on a response, only used for cursor pagination.
+
+    Args:
+        id (str): The ID of the message
+        date (datetime): The date the message was created in ISO format
+        name (Optional[str]): The name of the sender of the message
+        content (Union[str, List[LettaUserMessageContentUnion]]): The message content sent by the user (can be a string or an array of multi-modal content parts)
+    """
+
+    id: str
+
+    content: Union[List[LettaUserMessageContentUnion], str]
+    """
+    The message content sent by the user (can be a string or an array of multi-modal
+    content parts)
+    """
+
+    date: datetime
+
+    is_err: Optional[bool] = None
+
+    message_type: Optional[Literal["user_message"]] = None
+    """The type of the message."""
+
+    name: Optional[str] = None
+
+    otid: Optional[str] = None
+
+    run_id: Optional[str] = None
+
+    sender_id: Optional[str] = None
+
+    seq_id: Optional[int] = None
+
+    step_id: Optional[str] = None

letta_client/types/anthropic_model_settings.py

@@ -0,0 +1,62 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union, Optional
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from .._utils import PropertyInfo
+from .._models import BaseModel
+from .text_response_format import TextResponseFormat
+from .json_object_response_format import JsonObjectResponseFormat
+from .json_schema_response_format import JsonSchemaResponseFormat
+
+__all__ = ["AnthropicModelSettings", "ResponseFormat", "Thinking"]
+
+ResponseFormat: TypeAlias = Annotated[
+    Union[TextResponseFormat, JsonSchemaResponseFormat, JsonObjectResponseFormat, None],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class Thinking(BaseModel):
+    """The thinking configuration for the model."""
+
+    budget_tokens: Optional[int] = None
+    """The maximum number of tokens the model can use for extended thinking."""
+
+    type: Optional[Literal["enabled", "disabled"]] = None
+    """The type of thinking to use."""
+
+
+class AnthropicModelSettings(BaseModel):
+    effort: Optional[Literal["low", "medium", "high"]] = None
+    """Effort level for Opus 4.5 model (controls token conservation).
+
+    Not setting this gives similar performance to 'high'.
+    """
+
+    max_output_tokens: Optional[int] = None
+    """The maximum number of tokens the model can generate."""
+
+    parallel_tool_calls: Optional[bool] = None
+    """Whether to enable parallel tool calling."""
+
+    provider_type: Optional[Literal["anthropic"]] = None
+    """The type of the provider."""
+
+    response_format: Optional[ResponseFormat] = None
+    """The response format for the model."""
+
+    strict: Optional[bool] = None
+    """Enable strict mode for tool calling.
+
+    When true, tool outputs are guaranteed to match JSON schemas.
+    """
+
+    temperature: Optional[float] = None
+    """The temperature of the model."""
+
+    thinking: Optional[Thinking] = None
+    """The thinking configuration for the model."""
+
+    verbosity: Optional[Literal["low", "medium", "high"]] = None
+    """Soft control for how verbose model output should be, used for GPT-5 models."""

letta_client/types/anthropic_model_settings_param.py

@@ -0,0 +1,59 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Optional
+from typing_extensions import Literal, TypeAlias, TypedDict
+
+from .text_response_format_param import TextResponseFormatParam
+from .json_object_response_format_param import JsonObjectResponseFormatParam
+from .json_schema_response_format_param import JsonSchemaResponseFormatParam
+
+__all__ = ["AnthropicModelSettingsParam", "ResponseFormat", "Thinking"]
+
+ResponseFormat: TypeAlias = Union[TextResponseFormatParam, JsonSchemaResponseFormatParam, JsonObjectResponseFormatParam]
+
+
+class Thinking(TypedDict, total=False):
+    """The thinking configuration for the model."""
+
+    budget_tokens: int
+    """The maximum number of tokens the model can use for extended thinking."""
+
+    type: Literal["enabled", "disabled"]
+    """The type of thinking to use."""
+
+
+class AnthropicModelSettingsParam(TypedDict, total=False):
+    effort: Optional[Literal["low", "medium", "high"]]
+    """Effort level for Opus 4.5 model (controls token conservation).
+
+    Not setting this gives similar performance to 'high'.
+    """
+
+    max_output_tokens: int
+    """The maximum number of tokens the model can generate."""
+
+    parallel_tool_calls: bool
+    """Whether to enable parallel tool calling."""
+
+    provider_type: Literal["anthropic"]
+    """The type of the provider."""
+
+    response_format: Optional[ResponseFormat]
+    """The response format for the model."""
+
+    strict: bool
+    """Enable strict mode for tool calling.
+
+    When true, tool outputs are guaranteed to match JSON schemas.
+    """
+
+    temperature: float
+    """The temperature of the model."""
+
+    thinking: Thinking
+    """The thinking configuration for the model."""
+
+    verbosity: Optional[Literal["low", "medium", "high"]]
+    """Soft control for how verbose model output should be, used for GPT-5 models."""

letta_client/types/archive.py

@@ -0,0 +1,46 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+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"]
+
+
+class Archive(BaseModel):
+    """
+    Representation of an archive - a collection of archival passages that can be shared between agents.
+    """
+
+    id: str
+    """The human-friendly ID of the Archive"""
+
+    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"""
+
+    created_by_id: Optional[str] = None
+    """The id of the user that made this object."""
+
+    description: Optional[str] = None
+    """A description of the archive"""
+
+    last_updated_by_id: Optional[str] = None
+    """The id of the user that made this object."""
+
+    metadata: Optional[Dict[str, object]] = None
+    """Additional metadata"""
+
+    updated_at: Optional[datetime] = None
+    """The timestamp when the object was last updated."""
+
+    vector_db_provider: Optional[VectorDBProvider] = None
+    """The vector database provider used for this archive's passages"""