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

letta_client/types/max_count_per_step_tool_rule.py

@@ -1,37 +1,28 @@
-# This file was auto-generated by Fern from our API Definition.
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
-import pydantic
-import typing
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from typing import Optional
+from typing_extensions import Literal
 
+from .._models import BaseModel
 
-class MaxCountPerStepToolRule(UncheckedBaseModel):
-    """
-    Represents a tool rule configuration which constrains the total number of times this tool can be invoked in a single step.
-    """
+__all__ = ["MaxCountPerStepToolRule"]
 
-    tool_name: str = pydantic.Field()
-    """
-    The name of the tool. Must exist in the database for the user's organization.
-    """
 
-    type: typing.Literal["max_count_per_step"] = "max_count_per_step"
-    prompt_template: typing.Optional[str] = pydantic.Field(default=None)
+class MaxCountPerStepToolRule(BaseModel):
     """
-    Optional Jinja2 template for generating agent prompt about this tool rule.
+    Represents a tool rule configuration which constrains the total number of times this tool can be invoked in a single step.
     """
 
-    max_count_limit: int = pydantic.Field()
+    max_count_limit: int
     """
-    The max limit for the total number of times this tool can be invoked in a single step.
+    The max limit for the total number of times this tool can be invoked in a single
+    step.
     """
 
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
+    tool_name: str
+    """The name of the tool. Must exist in the database for the user's organization."""
+
+    prompt_template: Optional[str] = None
+    """Optional template string (ignored)."""
 
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+    type: Optional[Literal["max_count_per_step"]] = None

letta_client/types/max_count_per_step_tool_rule_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 Optional
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["MaxCountPerStepToolRuleParam"]
+
+
+class MaxCountPerStepToolRuleParam(TypedDict, total=False):
+    """
+    Represents a tool rule configuration which constrains the total number of times this tool can be invoked in a single step.
+    """
+
+    max_count_limit: Required[int]
+    """
+    The max limit for the total number of times this tool can be invoked in a single
+    step.
+    """
+
+    tool_name: Required[str]
+    """The name of the tool. Must exist in the database for the user's organization."""
+
+    prompt_template: Optional[str]
+    """Optional template string (ignored)."""
+
+    type: Literal["max_count_per_step"]

letta_client/types/mcp_server_create_params.py

@@ -0,0 +1,23 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from typing_extensions import Required, TypeAlias, TypedDict
+
+from .create_sse_mcp_server_param import CreateSseMcpServerParam
+from .create_stdio_mcp_server_param import CreateStdioMcpServerParam
+from .create_streamable_http_mcp_server_param import CreateStreamableHTTPMcpServerParam
+
+__all__ = ["McpServerCreateParams", "Config"]
+
+
+class McpServerCreateParams(TypedDict, total=False):
+    config: Required[Config]
+    """The MCP server configuration (Stdio, SSE, or Streamable HTTP)"""
+
+    server_name: Required[str]
+    """The name of the MCP server"""
+
+
+Config: TypeAlias = Union[CreateStdioMcpServerParam, CreateSseMcpServerParam, CreateStreamableHTTPMcpServerParam]

letta_client/types/mcp_server_create_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union
+from typing_extensions import TypeAlias
+
+from .sse_mcp_server import SseMcpServer
+from .stdio_mcp_server import StdioMcpServer
+from .streamable_http_mcp_server import StreamableHTTPMcpServer
+
+__all__ = ["McpServerCreateResponse"]
+
+McpServerCreateResponse: TypeAlias = Union[StdioMcpServer, SseMcpServer, StreamableHTTPMcpServer]

letta_client/types/mcp_server_list_response.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union
+from typing_extensions import TypeAlias
+
+from .sse_mcp_server import SseMcpServer
+from .stdio_mcp_server import StdioMcpServer
+from .streamable_http_mcp_server import StreamableHTTPMcpServer
+
+__all__ = ["McpServerListResponse", "McpServerListResponseItem"]
+
+McpServerListResponseItem: TypeAlias = Union[StdioMcpServer, SseMcpServer, StreamableHTTPMcpServer]
+
+McpServerListResponse: TypeAlias = List[McpServerListResponseItem]

letta_client/types/mcp_server_refresh_params.py

@@ -0,0 +1,12 @@
+# 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 TypedDict
+
+__all__ = ["McpServerRefreshParams"]
+
+
+class McpServerRefreshParams(TypedDict, total=False):
+    agent_id: Optional[str]

letta_client/types/mcp_server_retrieve_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union
+from typing_extensions import TypeAlias
+
+from .sse_mcp_server import SseMcpServer
+from .stdio_mcp_server import StdioMcpServer
+from .streamable_http_mcp_server import StreamableHTTPMcpServer
+
+__all__ = ["McpServerRetrieveResponse"]
+
+McpServerRetrieveResponse: TypeAlias = Union[StdioMcpServer, SseMcpServer, StreamableHTTPMcpServer]

letta_client/types/mcp_server_update_params.py

@@ -0,0 +1,23 @@
+# 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 Required, TypeAlias, TypedDict
+
+from .update_sse_mcp_server_param import UpdateSseMcpServerParam
+from .update_stdio_mcp_server_param import UpdateStdioMcpServerParam
+from .update_streamable_http_mcp_server_param import UpdateStreamableHTTPMcpServerParam
+
+__all__ = ["McpServerUpdateParams", "Config"]
+
+
+class McpServerUpdateParams(TypedDict, total=False):
+    config: Required[Config]
+    """The MCP server configuration updates (Stdio, SSE, or Streamable HTTP)"""
+
+    server_name: Optional[str]
+    """The name of the MCP server"""
+
+
+Config: TypeAlias = Union[UpdateStdioMcpServerParam, UpdateSseMcpServerParam, UpdateStreamableHTTPMcpServerParam]

letta_client/types/mcp_server_update_response.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union
+from typing_extensions import TypeAlias
+
+from .sse_mcp_server import SseMcpServer
+from .stdio_mcp_server import StdioMcpServer
+from .streamable_http_mcp_server import StreamableHTTPMcpServer
+
+__all__ = ["McpServerUpdateResponse"]
+
+McpServerUpdateResponse: TypeAlias = Union[StdioMcpServer, SseMcpServer, StreamableHTTPMcpServer]

letta_client/types/mcp_servers/__init__.py

@@ -0,0 +1,6 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .tool_run_params import ToolRunParams as ToolRunParams
+from .tool_list_response import ToolListResponse as ToolListResponse

letta_client/types/mcp_servers/tool_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 ..tool import Tool
+
+__all__ = ["ToolListResponse"]
+
+ToolListResponse: TypeAlias = List[Tool]

letta_client/types/mcp_servers/tool_run_params.py

@@ -0,0 +1,15 @@
+# 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):
+    mcp_server_id: Required[str]
+
+    args: Dict[str, object]
+    """Arguments to pass to the tool"""

letta_client/types/message_create_param.py

@@ -0,0 +1,38 @@
+# 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, TypedDict
+
+from .letta_message_content_union_param import LettaMessageContentUnionParam
+
+__all__ = ["MessageCreateParam"]
+
+
+class MessageCreateParam(TypedDict, total=False):
+    """Request to create a message"""
+
+    content: Required[Union[Iterable[LettaMessageContentUnionParam], str]]
+    """The content of the message."""
+
+    role: Required[Literal["user", "system", "assistant"]]
+    """The role of the participant."""
+
+    batch_item_id: Optional[str]
+    """The id of the LLMBatchItem that this message is associated with"""
+
+    group_id: Optional[str]
+    """The multi-agent group that the message was sent in"""
+
+    name: Optional[str]
+    """The name of the participant."""
+
+    otid: Optional[str]
+    """The offline threading id associated with this message"""
+
+    sender_id: Optional[str]
+    """The id of the sender of the message, can be an identity id or agent id"""
+
+    type: Optional[Literal["message"]]
+    """The message type to be created."""

letta_client/types/message_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__ = ["MessageListParams"]
+
+
+class MessageListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Message ID cursor for pagination.
+
+    Returns messages that come after this message ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """Message ID cursor for pagination.
+
+    Returns messages that come before this message ID in the specified sort order
+    """
+
+    conversation_id: Optional[str]
+    """Conversation ID to filter messages by"""
+
+    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
+    """

letta_client/types/message_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 .agents.message import Message
+
+__all__ = ["MessageListResponse"]
+
+MessageListResponse: TypeAlias = List[Message]

letta_client/types/message_retrieve_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 .agents.message import Message
+
+__all__ = ["MessageRetrieveResponse"]
+
+MessageRetrieveResponse: TypeAlias = List[Message]

letta_client/types/message_search_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 Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["MessageSearchParams"]
+
+
+class MessageSearchParams(TypedDict, total=False):
+    query: Required[str]
+    """Text query for full-text search"""
+
+    agent_id: Optional[str]
+    """Filter messages by agent ID"""
+
+    conversation_id: Optional[str]
+    """Filter messages by conversation ID"""
+
+    end_date: Annotated[Union[str, datetime, None], PropertyInfo(format="iso8601")]
+    """Filter messages created on or before this date"""
+
+    limit: int
+    """Maximum number of results to return"""
+
+    search_mode: Literal["vector", "fts", "hybrid"]
+    """Search mode to use"""
+
+    start_date: Annotated[Union[str, datetime, None], PropertyInfo(format="iso8601")]
+    """Filter messages created after this date"""

letta_client/types/message_search_response.py

@@ -0,0 +1,124 @@
+# 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 .agents.letta_user_message_content_union import LettaUserMessageContentUnion
+from .agents.letta_assistant_message_content_union import LettaAssistantMessageContentUnion
+
+__all__ = [
+    "MessageSearchResponse",
+    "MessageSearchResponseItem",
+    "MessageSearchResponseItemSystemMessageListResult",
+    "MessageSearchResponseItemUserMessageListResult",
+    "MessageSearchResponseItemReasoningMessageListResult",
+    "MessageSearchResponseItemAssistantMessageListResult",
+]
+
+
+class MessageSearchResponseItemSystemMessageListResult(BaseModel):
+    """System message list result with agent context.
+
+    Shape is identical to UpdateSystemMessage but includes the owning agent_id and message id.
+    """
+
+    content: str
+    """
+    The message content sent by the system (can be a string or an array of
+    multi-modal content parts)
+    """
+
+    created_at: datetime
+    """The time the message was created in ISO format."""
+
+    message_id: str
+    """The unique identifier of the message."""
+
+    agent_id: Optional[str] = None
+    """The unique identifier of the agent that owns the message."""
+
+    message_type: Optional[Literal["system_message"]] = None
+
+
+class MessageSearchResponseItemUserMessageListResult(BaseModel):
+    """User message list result with agent context.
+
+    Shape is identical to UpdateUserMessage but includes the owning agent_id and message id.
+    """
+
+    content: Union[List[LettaUserMessageContentUnion], str]
+    """
+    The message content sent by the user (can be a string or an array of multi-modal
+    content parts)
+    """
+
+    created_at: datetime
+    """The time the message was created in ISO format."""
+
+    message_id: str
+    """The unique identifier of the message."""
+
+    agent_id: Optional[str] = None
+    """The unique identifier of the agent that owns the message."""
+
+    message_type: Optional[Literal["user_message"]] = None
+
+
+class MessageSearchResponseItemReasoningMessageListResult(BaseModel):
+    """Reasoning message list result with agent context.
+
+    Shape is identical to UpdateReasoningMessage but includes the owning agent_id and message id.
+    """
+
+    created_at: datetime
+    """The time the message was created in ISO format."""
+
+    message_id: str
+    """The unique identifier of the message."""
+
+    reasoning: str
+
+    agent_id: Optional[str] = None
+    """The unique identifier of the agent that owns the message."""
+
+    message_type: Optional[Literal["reasoning_message"]] = None
+
+
+class MessageSearchResponseItemAssistantMessageListResult(BaseModel):
+    """Assistant message list result with agent context.
+
+    Shape is identical to UpdateAssistantMessage but includes the owning agent_id and message id.
+    """
+
+    content: Union[List[LettaAssistantMessageContentUnion], str]
+    """
+    The message content sent by the assistant (can be a string or an array of
+    content parts)
+    """
+
+    created_at: datetime
+    """The time the message was created in ISO format."""
+
+    message_id: str
+    """The unique identifier of the message."""
+
+    agent_id: Optional[str] = None
+    """The unique identifier of the agent that owns the message."""
+
+    message_type: Optional[Literal["assistant_message"]] = None
+
+
+MessageSearchResponseItem: TypeAlias = Annotated[
+    Union[
+        MessageSearchResponseItemSystemMessageListResult,
+        MessageSearchResponseItemUserMessageListResult,
+        MessageSearchResponseItemReasoningMessageListResult,
+        MessageSearchResponseItemAssistantMessageListResult,
+    ],
+    PropertyInfo(discriminator="message_type"),
+]
+
+MessageSearchResponse: TypeAlias = List[MessageSearchResponseItem]

letta_client/types/model.py

@@ -0,0 +1,148 @@
+# 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 pydantic import Field as FieldInfo
+
+from .._utils import PropertyInfo
+from .._models import BaseModel
+from .provider_type import ProviderType
+from .provider_category import ProviderCategory
+from .text_response_format import TextResponseFormat
+from .json_object_response_format import JsonObjectResponseFormat
+from .json_schema_response_format import JsonSchemaResponseFormat
+
+__all__ = ["Model", "ResponseFormat"]
+
+ResponseFormat: TypeAlias = Annotated[
+    Union[TextResponseFormat, JsonSchemaResponseFormat, JsonObjectResponseFormat, None],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class Model(BaseModel):
+    context_window: int
+    """Deprecated: Use 'max_context_window' field instead.
+
+    The context window size for the model.
+    """
+
+    max_context_window: int
+    """The maximum context window for the model"""
+
+    model: str
+    """Deprecated: Use 'name' field instead. LLM model name."""
+
+    api_model_endpoint_type: Literal[
+        "openai",
+        "anthropic",
+        "google_ai",
+        "google_vertex",
+        "azure",
+        "groq",
+        "ollama",
+        "webui",
+        "webui-legacy",
+        "lmstudio",
+        "lmstudio-legacy",
+        "lmstudio-chatcompletions",
+        "llamacpp",
+        "koboldcpp",
+        "vllm",
+        "hugging-face",
+        "mistral",
+        "together",
+        "bedrock",
+        "deepseek",
+        "xai",
+        "zai",
+        "chatgpt_oauth",
+    ] = FieldInfo(alias="model_endpoint_type")
+    """Deprecated: Use 'provider_type' field instead. The endpoint type for the model."""
+
+    name: str
+    """The actual model name used by the provider"""
+
+    provider_type: ProviderType
+    """The type of the provider"""
+
+    compatibility_type: Optional[Literal["gguf", "mlx"]] = None
+    """Deprecated: The framework compatibility type for the model."""
+
+    display_name: Optional[str] = None
+    """A human-friendly display name for the model."""
+
+    effort: Optional[Literal["low", "medium", "high"]] = None
+    """The effort level for Anthropic Opus 4.5 model (controls token spending).
+
+    Not setting this gives similar performance to 'high'.
+    """
+
+    enable_reasoner: Optional[bool] = None
+    """
+    Deprecated: Whether or not the model should use extended thinking if it is a
+    'reasoning' style model.
+    """
+
+    frequency_penalty: Optional[float] = None
+    """
+    Deprecated: Positive values penalize new tokens based on their existing
+    frequency in the text so far.
+    """
+
+    handle: Optional[str] = None
+    """The handle for this config, in the format provider/model-name."""
+
+    max_reasoning_tokens: Optional[int] = None
+    """Deprecated: Configurable thinking budget for extended thinking."""
+
+    max_tokens: Optional[int] = None
+    """Deprecated: The maximum number of tokens to generate."""
+
+    api_model_endpoint: Optional[str] = FieldInfo(alias="model_endpoint", default=None)
+    """Deprecated: The endpoint for the model."""
+
+    api_model_type: Optional[Literal["llm"]] = FieldInfo(alias="model_type", default=None)
+    """Type of model (llm or embedding)"""
+
+    api_model_wrapper: Optional[str] = FieldInfo(alias="model_wrapper", default=None)
+    """Deprecated: The wrapper for the model."""
+
+    parallel_tool_calls: Optional[bool] = None
+    """Deprecated: If set to True, enables parallel tool calling."""
+
+    provider_category: Optional[ProviderCategory] = None
+    """Deprecated: The provider category for the model."""
+
+    provider_name: Optional[str] = None
+    """The provider name for the model."""
+
+    put_inner_thoughts_in_kwargs: Optional[bool] = None
+    """Deprecated: Puts 'inner_thoughts' as a kwarg in the function call."""
+
+    reasoning_effort: Optional[Literal["none", "minimal", "low", "medium", "high", "xhigh"]] = None
+    """Deprecated: The reasoning effort to use when generating text reasoning models."""
+
+    response_format: Optional[ResponseFormat] = None
+    """The response format for the model's output.
+
+    Supports text, json_object, and json_schema (structured outputs). Can be set via
+    model_settings.
+    """
+
+    strict: Optional[bool] = None
+    """Enable strict mode for tool calling.
+
+    When true, tool schemas include strict: true and additionalProperties: false,
+    guaranteeing tool outputs match JSON schemas.
+    """
+
+    temperature: Optional[float] = None
+    """Deprecated: The temperature to use when generating text with the model."""
+
+    tier: Optional[str] = None
+    """Deprecated: The cost tier for the model (cloud only)."""
+
+    verbosity: Optional[Literal["low", "medium", "high"]] = None
+    """Deprecated: Soft control for how verbose model output should be."""

letta_client/types/model_list_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 List, Optional
+from typing_extensions import TypedDict
+
+from .provider_type import ProviderType
+from .provider_category import ProviderCategory
+
+__all__ = ["ModelListParams"]
+
+
+class ModelListParams(TypedDict, total=False):
+    provider_category: Optional[List[ProviderCategory]]
+
+    provider_name: Optional[str]
+
+    provider_type: Optional[ProviderType]

letta_client/types/model_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 .model import Model
+
+__all__ = ["ModelListResponse"]
+
+ModelListResponse: TypeAlias = List[Model]