letta-client 0.1.250__py3-none-any.whl → 0.1.252__py3-none-any.whl

letta_client/types/__init__.py

@@ -6,8 +6,7 @@ from .action_model import ActionModel
 from .action_parameters_model import ActionParametersModel
 from .action_response_model import ActionResponseModel
 from .agent_environment_variable import AgentEnvironmentVariable
-from .agent_schema import AgentSchema
-from .agent_schema_tool_rules_item import AgentSchemaToolRulesItem
+from .agent_file_schema import AgentFileSchema
 from .agent_state import AgentState
 from .agent_state_response_format import AgentStateResponseFormat
 from .agent_state_tool_rules_item import AgentStateToolRulesItem
@@ -26,7 +25,9 @@ from .base_64_image import Base64Image
 from .base_tool_rule_schema import BaseToolRuleSchema
 from .batch_job import BatchJob
 from .block import Block
+from .block_schema import BlockSchema
 from .block_update import BlockUpdate
+from .body_export_agent_serialized import BodyExportAgentSerialized
 from .chat_completion_assistant_message_param import ChatCompletionAssistantMessageParam
 from .chat_completion_assistant_message_param_content import ChatCompletionAssistantMessageParamContent
 from .chat_completion_assistant_message_param_content_item import ChatCompletionAssistantMessageParamContentItem
@@ -94,10 +95,12 @@ from .embedding_config import EmbeddingConfig
 from .embedding_config_embedding_endpoint_type import EmbeddingConfigEmbeddingEndpointType
 from .feedback_type import FeedbackType
 from .file import File
+from .file_agent_schema import FileAgentSchema
 from .file_block import FileBlock
 from .file_file import FileFile
 from .file_metadata import FileMetadata
 from .file_processing_status import FileProcessingStatus
+from .file_schema import FileSchema
 from .file_stats import FileStats
 from .folder import Folder
 from .function_call import FunctionCall
@@ -108,6 +111,8 @@ from .function_tool import FunctionTool
 from .generate_tool_input import GenerateToolInput
 from .generate_tool_output import GenerateToolOutput
 from .group import Group
+from .group_schema import GroupSchema
+from .group_schema_manager_config import GroupSchemaManagerConfig
 from .health import Health
 from .hidden_reasoning_message import HiddenReasoningMessage
 from .hidden_reasoning_message_state import HiddenReasoningMessageState
@@ -121,6 +126,7 @@ from .image_content import ImageContent
 from .image_content_source import ImageContentSource
 from .image_url import ImageUrl
 from .image_url_detail import ImageUrlDetail
+from .imported_agents_response import ImportedAgentsResponse
 from .init_tool_rule import InitToolRule
 from .input_audio import InputAudio
 from .input_audio_format import InputAudioFormat
@@ -140,6 +146,24 @@ from .letta_ping import LettaPing
 from .letta_request import LettaRequest
 from .letta_request_config import LettaRequestConfig
 from .letta_response import LettaResponse
+from .letta_schemas_agent_file_agent_schema import LettaSchemasAgentFileAgentSchema
+from .letta_schemas_agent_file_agent_schema_response_format import LettaSchemasAgentFileAgentSchemaResponseFormat
+from .letta_schemas_agent_file_agent_schema_tool_rules_item import LettaSchemasAgentFileAgentSchemaToolRulesItem
+from .letta_schemas_agent_file_message_schema import LettaSchemasAgentFileMessageSchema
+from .letta_schemas_agent_file_message_schema_content import LettaSchemasAgentFileMessageSchemaContent
+from .letta_schemas_agent_file_tool_schema import LettaSchemasAgentFileToolSchema
+from .letta_serialize_schemas_pydantic_agent_schema_agent_schema import (
+    LettaSerializeSchemasPydanticAgentSchemaAgentSchema,
+)
+from .letta_serialize_schemas_pydantic_agent_schema_agent_schema_tool_rules_item import (
+    LettaSerializeSchemasPydanticAgentSchemaAgentSchemaToolRulesItem,
+)
+from .letta_serialize_schemas_pydantic_agent_schema_message_schema import (
+    LettaSerializeSchemasPydanticAgentSchemaMessageSchema,
+)
+from .letta_serialize_schemas_pydantic_agent_schema_tool_schema import (
+    LettaSerializeSchemasPydanticAgentSchemaToolSchema,
+)
 from .letta_stop_reason import LettaStopReason
 from .letta_streaming_request import LettaStreamingRequest
 from .letta_usage_statistics import LettaUsageStatistics
@@ -152,6 +176,7 @@ from .local_sandbox_config import LocalSandboxConfig
 from .manager_type import ManagerType
 from .max_count_per_step_tool_rule import MaxCountPerStepToolRule
 from .max_count_per_step_tool_rule_schema import MaxCountPerStepToolRuleSchema
+from .mcp_server_schema import McpServerSchema
 from .mcp_server_type import McpServerType
 from .mcp_tool import McpTool
 from .memory import Memory
@@ -161,7 +186,6 @@ from .message_create import MessageCreate
 from .message_create_content import MessageCreateContent
 from .message_create_role import MessageCreateRole
 from .message_role import MessageRole
-from .message_schema import MessageSchema
 from .message_type import MessageType
 from .modal_sandbox_config import ModalSandboxConfig
 from .modal_sandbox_config_language import ModalSandboxConfigLanguage
@@ -215,6 +239,7 @@ from .sleeptime_manager import SleeptimeManager
 from .sleeptime_manager_update import SleeptimeManagerUpdate
 from .source import Source
 from .source_create import SourceCreate
+from .source_schema import SourceSchema
 from .source_stats import SourceStats
 from .source_update import SourceUpdate
 from .sse_server_config import SseServerConfig
@@ -246,7 +271,6 @@ from .tool_return_content import ToolReturnContent
 from .tool_return_message import ToolReturnMessage
 from .tool_return_message_status import ToolReturnMessageStatus
 from .tool_return_status import ToolReturnStatus
-from .tool_schema import ToolSchema
 from .tool_type import ToolType
 from .update_assistant_message import UpdateAssistantMessage
 from .update_assistant_message_content import UpdateAssistantMessageContent
@@ -280,8 +304,7 @@ __all__ = [
     "ActionParametersModel",
     "ActionResponseModel",
     "AgentEnvironmentVariable",
-    "AgentSchema",
-    "AgentSchemaToolRulesItem",
+    "AgentFileSchema",
     "AgentState",
     "AgentStateResponseFormat",
     "AgentStateToolRulesItem",
@@ -300,7 +323,9 @@ __all__ = [
     "BaseToolRuleSchema",
     "BatchJob",
     "Block",
+    "BlockSchema",
     "BlockUpdate",
+    "BodyExportAgentSerialized",
     "ChatCompletionAssistantMessageParam",
     "ChatCompletionAssistantMessageParamContent",
     "ChatCompletionAssistantMessageParamContentItem",
@@ -368,10 +393,12 @@ __all__ = [
     "EmbeddingConfigEmbeddingEndpointType",
     "FeedbackType",
     "File",
+    "FileAgentSchema",
     "FileBlock",
     "FileFile",
     "FileMetadata",
     "FileProcessingStatus",
+    "FileSchema",
     "FileStats",
     "Folder",
     "FunctionCall",
@@ -382,6 +409,8 @@ __all__ = [
     "GenerateToolInput",
     "GenerateToolOutput",
     "Group",
+    "GroupSchema",
+    "GroupSchemaManagerConfig",
     "Health",
     "HiddenReasoningMessage",
     "HiddenReasoningMessageState",
@@ -395,6 +424,7 @@ __all__ = [
     "ImageContentSource",
     "ImageUrl",
     "ImageUrlDetail",
+    "ImportedAgentsResponse",
     "InitToolRule",
     "InputAudio",
     "InputAudioFormat",
@@ -414,6 +444,16 @@ __all__ = [
     "LettaRequest",
     "LettaRequestConfig",
     "LettaResponse",
+    "LettaSchemasAgentFileAgentSchema",
+    "LettaSchemasAgentFileAgentSchemaResponseFormat",
+    "LettaSchemasAgentFileAgentSchemaToolRulesItem",
+    "LettaSchemasAgentFileMessageSchema",
+    "LettaSchemasAgentFileMessageSchemaContent",
+    "LettaSchemasAgentFileToolSchema",
+    "LettaSerializeSchemasPydanticAgentSchemaAgentSchema",
+    "LettaSerializeSchemasPydanticAgentSchemaAgentSchemaToolRulesItem",
+    "LettaSerializeSchemasPydanticAgentSchemaMessageSchema",
+    "LettaSerializeSchemasPydanticAgentSchemaToolSchema",
     "LettaStopReason",
     "LettaStreamingRequest",
     "LettaUsageStatistics",
@@ -426,6 +466,7 @@ __all__ = [
     "ManagerType",
     "MaxCountPerStepToolRule",
     "MaxCountPerStepToolRuleSchema",
+    "McpServerSchema",
     "McpServerType",
     "McpTool",
     "Memory",
@@ -435,7 +476,6 @@ __all__ = [
     "MessageCreateContent",
     "MessageCreateRole",
     "MessageRole",
-    "MessageSchema",
     "MessageType",
     "ModalSandboxConfig",
     "ModalSandboxConfigLanguage",
@@ -485,6 +525,7 @@ __all__ = [
     "SleeptimeManagerUpdate",
     "Source",
     "SourceCreate",
+    "SourceSchema",
     "SourceStats",
     "SourceUpdate",
     "SseServerConfig",
@@ -516,7 +557,6 @@ __all__ = [
     "ToolReturnMessage",
     "ToolReturnMessageStatus",
     "ToolReturnStatus",
-    "ToolSchema",
     "ToolType",
     "UpdateAssistantMessage",
     "UpdateAssistantMessageContent",

letta_client/types/agent_file_schema.py

@@ -0,0 +1,75 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .block_schema import BlockSchema
+from .file_schema import FileSchema
+from .group_schema import GroupSchema
+from .letta_schemas_agent_file_agent_schema import LettaSchemasAgentFileAgentSchema
+from .letta_schemas_agent_file_tool_schema import LettaSchemasAgentFileToolSchema
+from .mcp_server_schema import McpServerSchema
+from .source_schema import SourceSchema
+
+
+class AgentFileSchema(UncheckedBaseModel):
+    """
+    Schema for serialized agent file that can be exported to JSON and imported into agent server.
+    """
+
+    agents: typing.List[LettaSchemasAgentFileAgentSchema] = pydantic.Field()
+    """
+    List of agents in this agent file
+    """
+
+    groups: typing.List[GroupSchema] = pydantic.Field()
+    """
+    List of groups in this agent file
+    """
+
+    blocks: typing.List[BlockSchema] = pydantic.Field()
+    """
+    List of memory blocks in this agent file
+    """
+
+    files: typing.List[FileSchema] = pydantic.Field()
+    """
+    List of files in this agent file
+    """
+
+    sources: typing.List[SourceSchema] = pydantic.Field()
+    """
+    List of sources in this agent file
+    """
+
+    tools: typing.List[LettaSchemasAgentFileToolSchema] = pydantic.Field()
+    """
+    List of tools in this agent file
+    """
+
+    mcp_servers: typing.List[McpServerSchema] = pydantic.Field()
+    """
+    List of MCP servers in this agent file
+    """
+
+    metadata: typing.Optional[typing.Dict[str, str]] = pydantic.Field(default=None)
+    """
+    Metadata for this agent file, including revision_id and other export information.
+    """
+
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The timestamp when the object was created.
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

letta_client/types/block_schema.py

@@ -0,0 +1,73 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+
+
+class BlockSchema(UncheckedBaseModel):
+    """
+    Block with human-readable ID for agent file
+    """
+
+    value: str = pydantic.Field()
+    """
+    Value of the block.
+    """
+
+    limit: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Character limit of the block.
+    """
+
+    project_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The associated project id.
+    """
+
+    name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Name of the block if it is a template.
+    """
+
+    is_template: typing.Optional[bool] = None
+    preserve_on_migration: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Preserve the block on template migration.
+    """
+
+    label: str = pydantic.Field()
+    """
+    Label of the block.
+    """
+
+    read_only: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether the agent has read-only access to the block.
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Description of the block.
+    """
+
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Metadata of the block.
+    """
+
+    id: str = pydantic.Field()
+    """
+    Human-readable identifier for this block in the file
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

letta_client/types/body_export_agent_serialized.py

@@ -0,0 +1,25 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .agent_file_schema import AgentFileSchema
+from .letta_serialize_schemas_pydantic_agent_schema_agent_schema import (
+    LettaSerializeSchemasPydanticAgentSchemaAgentSchema,
+)
+
+
+class BodyExportAgentSerialized(UncheckedBaseModel):
+    spec: typing.Optional[AgentFileSchema] = None
+    legacy_spec: typing.Optional[LettaSerializeSchemasPydanticAgentSchemaAgentSchema] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

letta_client/types/completion_create_params_non_streaming.py

@@ -39,8 +39,10 @@ class CompletionCreateParamsNonStreaming(UncheckedBaseModel):
     parallel_tool_calls: typing.Optional[bool] = None
     prediction: typing.Optional[ChatCompletionPredictionContentParam] = None
     presence_penalty: typing.Optional[float] = None
+    prompt_cache_key: typing.Optional[str] = None
     reasoning_effort: typing.Optional[CompletionCreateParamsNonStreamingReasoningEffort] = None
     response_format: typing.Optional[CompletionCreateParamsNonStreamingResponseFormat] = None
+    safety_identifier: typing.Optional[str] = None
     seed: typing.Optional[int] = None
     service_tier: typing.Optional[CompletionCreateParamsNonStreamingServiceTier] = None
     stop: typing.Optional[CompletionCreateParamsNonStreamingStop] = None

letta_client/types/completion_create_params_streaming.py

@@ -39,8 +39,10 @@ class CompletionCreateParamsStreaming(UncheckedBaseModel):
     parallel_tool_calls: typing.Optional[bool] = None
     prediction: typing.Optional[ChatCompletionPredictionContentParam] = None
     presence_penalty: typing.Optional[float] = None
+    prompt_cache_key: typing.Optional[str] = None
     reasoning_effort: typing.Optional[CompletionCreateParamsStreamingReasoningEffort] = None
     response_format: typing.Optional[CompletionCreateParamsStreamingResponseFormat] = None
+    safety_identifier: typing.Optional[str] = None
     seed: typing.Optional[int] = None
     service_tier: typing.Optional[CompletionCreateParamsStreamingServiceTier] = None
     stop: typing.Optional[CompletionCreateParamsStreamingStop] = None

letta_client/types/file_agent_schema.py

@@ -0,0 +1,73 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+
+
+class FileAgentSchema(UncheckedBaseModel):
+    """
+    File-Agent relationship with human-readable ID for agent file
+    """
+
+    agent_id: str = pydantic.Field()
+    """
+    Unique identifier of the agent.
+    """
+
+    file_id: str = pydantic.Field()
+    """
+    Unique identifier of the file.
+    """
+
+    source_id: str = pydantic.Field()
+    """
+    Unique identifier of the source.
+    """
+
+    file_name: str = pydantic.Field()
+    """
+    Name of the file.
+    """
+
+    is_open: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    True if the agent currently has the file open.
+    """
+
+    visible_content: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Portion of the file the agent is focused on (may be large).
+    """
+
+    last_accessed_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    UTC timestamp of the agent's most recent access to this file.
+    """
+
+    start_line: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Starting line number (1-indexed) when file was opened with line range.
+    """
+
+    end_line: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Ending line number (exclusive) when file was opened with line range.
+    """
+
+    id: str = pydantic.Field()
+    """
+    Human-readable identifier for this file-agent relationship in the file
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

letta_client/types/file_schema.py

@@ -0,0 +1,93 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .file_processing_status import FileProcessingStatus
+
+
+class FileSchema(UncheckedBaseModel):
+    """
+    File with human-readable ID for agent file
+    """
+
+    source_id: str = pydantic.Field()
+    """
+    The unique identifier of the source associated with the document.
+    """
+
+    file_name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the file.
+    """
+
+    original_file_name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The original name of the file as uploaded.
+    """
+
+    file_path: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The path to the file.
+    """
+
+    file_type: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The type of the file (MIME type).
+    """
+
+    file_size: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The size of the file in bytes.
+    """
+
+    file_creation_date: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The creation date of the file.
+    """
+
+    file_last_modified_date: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The last modified date of the file.
+    """
+
+    processing_status: typing.Optional[FileProcessingStatus] = pydantic.Field(default=None)
+    """
+    The current processing status of the file (e.g. pending, parsing, embedding, completed, error).
+    """
+
+    error_message: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Optional error message if the file failed processing.
+    """
+
+    total_chunks: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Total number of chunks for the file.
+    """
+
+    chunks_embedded: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Number of chunks that have been embedded.
+    """
+
+    content: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Optional full-text content of the file; only populated on demand due to its size.
+    """
+
+    id: str = pydantic.Field()
+    """
+    Human-readable identifier for this file in the file
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

letta_client/types/group_schema.py

@@ -0,0 +1,53 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .group_schema_manager_config import GroupSchemaManagerConfig
+
+
+class GroupSchema(UncheckedBaseModel):
+    """
+    Group with human-readable ID for agent file
+    """
+
+    agent_ids: typing.List[str] = pydantic.Field()
+    """
+    
+    """
+
+    description: str = pydantic.Field()
+    """
+    
+    """
+
+    manager_config: typing.Optional[GroupSchemaManagerConfig] = pydantic.Field(default=None)
+    """
+    
+    """
+
+    project_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The associated project id.
+    """
+
+    shared_block_ids: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    
+    """
+
+    id: str = pydantic.Field()
+    """
+    Human-readable identifier for this group in the file
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

letta_client/types/group_schema_manager_config.py

@@ -0,0 +1,13 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from .dynamic_manager import DynamicManager
+from .round_robin_manager import RoundRobinManager
+from .sleeptime_manager import SleeptimeManager
+from .supervisor_manager import SupervisorManager
+from .voice_sleeptime_manager import VoiceSleeptimeManager
+
+GroupSchemaManagerConfig = typing.Union[
+    DynamicManager, RoundRobinManager, SleeptimeManager, SupervisorManager, VoiceSleeptimeManager
+]

letta_client/types/imported_agents_response.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+
+
+class ImportedAgentsResponse(UncheckedBaseModel):
+    """
+    Response model for imported agents
+    """
+
+    agent_ids: typing.List[str] = pydantic.Field()
+    """
+    List of IDs of the imported agents
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow