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

letta_client/types/letta_schemas_agent_file_agent_schema.py

@@ -0,0 +1,275 @@
+# 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_type import AgentType
+from .create_block import CreateBlock
+from .embedding_config import EmbeddingConfig
+from .file_agent_schema import FileAgentSchema
+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 .llm_config import LlmConfig
+from .message_create import MessageCreate
+
+
+class LettaSchemasAgentFileAgentSchema(UncheckedBaseModel):
+    """
+    Agent with human-readable ID for agent file
+    """
+
+    name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the agent.
+    """
+
+    memory_blocks: typing.Optional[typing.List[CreateBlock]] = pydantic.Field(default=None)
+    """
+    The blocks to create in the agent's in-context memory.
+    """
+
+    tools: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    The tools used by the agent.
+    """
+
+    tool_ids: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    The ids of the tools used by the agent.
+    """
+
+    source_ids: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    The ids of the sources used by the agent.
+    """
+
+    block_ids: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    The ids of the blocks used by the agent.
+    """
+
+    tool_rules: typing.Optional[typing.List[LettaSchemasAgentFileAgentSchemaToolRulesItem]] = pydantic.Field(
+        default=None
+    )
+    """
+    The tool rules governing the agent.
+    """
+
+    tags: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    The tags associated with the agent.
+    """
+
+    system: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The system prompt used by the agent.
+    """
+
+    agent_type: typing.Optional[AgentType] = pydantic.Field(default=None)
+    """
+    The type of agent.
+    """
+
+    llm_config: typing.Optional[LlmConfig] = pydantic.Field(default=None)
+    """
+    The LLM configuration used by the agent.
+    """
+
+    embedding_config: typing.Optional[EmbeddingConfig] = pydantic.Field(default=None)
+    """
+    The embedding configuration used by the agent.
+    """
+
+    initial_message_sequence: typing.Optional[typing.List[MessageCreate]] = pydantic.Field(default=None)
+    """
+    The initial set of messages to put in the agent's in-context memory.
+    """
+
+    include_base_tools: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    If true, attaches the Letta core tools (e.g. core_memory related functions).
+    """
+
+    include_multi_agent_tools: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    If true, attaches the Letta multi-agent tools (e.g. sending a message to another agent).
+    """
+
+    include_base_tool_rules: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    If true, attaches the Letta base tool rules (e.g. deny all tools not explicitly allowed).
+    """
+
+    include_default_source: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    If true, automatically creates and attaches a default data source for this agent.
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The description of the agent.
+    """
+
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    The metadata of the agent.
+    """
+
+    model: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The LLM configuration handle used by the agent, specified in the format provider/model-name, as an alternative to specifying llm_config.
+    """
+
+    embedding: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The embedding configuration handle used by the agent, specified in the format provider/model-name.
+    """
+
+    context_window_limit: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The context window limit used by the agent.
+    """
+
+    embedding_chunk_size: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The embedding chunk size used by the agent.
+    """
+
+    max_tokens: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The maximum number of tokens to generate, including reasoning step. If not set, the model will use its default value.
+    """
+
+    max_reasoning_tokens: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The maximum number of tokens to generate for reasoning step. If not set, the model will use its default value.
+    """
+
+    enable_reasoner: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether to enable internal extended thinking step for a reasoner model.
+    """
+
+    reasoning: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether to enable reasoning for this agent.
+    """
+
+    from_template: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The template id used to configure the agent
+    """
+
+    template: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether the agent is a template
+    """
+
+    project: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Deprecated: Project should now be passed via the X-Project header instead of in the request body. If using the sdk, this can be done via the new x_project field below.
+    """
+
+    tool_exec_environment_variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = pydantic.Field(
+        default=None
+    )
+    """
+    The environment variables for tool execution specific to this agent.
+    """
+
+    memory_variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = pydantic.Field(default=None)
+    """
+    The variables that should be set for the agent.
+    """
+
+    project_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the project the agent belongs to.
+    """
+
+    template_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the template the agent belongs to.
+    """
+
+    base_template_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The base template id of the agent.
+    """
+
+    identity_ids: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    The ids of the identities associated with this agent.
+    """
+
+    message_buffer_autoclear: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    If set to True, the agent will not remember previous messages (though the agent will still retain state via core memory blocks and archival/recall memory). Not recommended unless you have an advanced use case.
+    """
+
+    enable_sleeptime: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    If set to True, memory management will move to a background agent thread.
+    """
+
+    response_format: typing.Optional[LettaSchemasAgentFileAgentSchemaResponseFormat] = pydantic.Field(default=None)
+    """
+    The response format for the agent.
+    """
+
+    timezone: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The timezone of the agent (IANA format).
+    """
+
+    max_files_open: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Maximum number of files that can be open at once for this agent. Setting this too high may exceed the context window, which will break the agent.
+    """
+
+    per_file_view_window_char_limit: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The per-file view window character limit for this agent. Setting this too high may exceed the context window, which will break the agent.
+    """
+
+    hidden: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    If set to True, the agent will be hidden.
+    """
+
+    id: str = pydantic.Field()
+    """
+    Human-readable identifier for this agent in the file
+    """
+
+    in_context_message_ids: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    List of message IDs that are currently in the agent's context
+    """
+
+    messages: typing.Optional[typing.List[LettaSchemasAgentFileMessageSchema]] = pydantic.Field(default=None)
+    """
+    List of messages in the agent's conversation history
+    """
+
+    files_agents: typing.Optional[typing.List[FileAgentSchema]] = pydantic.Field(default=None)
+    """
+    List of file-agent relationships for this agent
+    """
+
+    group_ids: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    List of groups that the agent manages
+    """
+
+    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/letta_schemas_agent_file_agent_schema_response_format.py

@@ -0,0 +1,11 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from .json_object_response_format import JsonObjectResponseFormat
+from .json_schema_response_format import JsonSchemaResponseFormat
+from .text_response_format import TextResponseFormat
+
+LettaSchemasAgentFileAgentSchemaResponseFormat = typing.Union[
+    JsonObjectResponseFormat, JsonSchemaResponseFormat, TextResponseFormat
+]

letta_client/types/letta_schemas_agent_file_agent_schema_tool_rules_item.py

@@ -0,0 +1,23 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from .child_tool_rule import ChildToolRule
+from .conditional_tool_rule import ConditionalToolRule
+from .continue_tool_rule import ContinueToolRule
+from .init_tool_rule import InitToolRule
+from .max_count_per_step_tool_rule import MaxCountPerStepToolRule
+from .parent_tool_rule import ParentToolRule
+from .required_before_exit_tool_rule import RequiredBeforeExitToolRule
+from .terminal_tool_rule import TerminalToolRule
+
+LettaSchemasAgentFileAgentSchemaToolRulesItem = typing.Union[
+    ConditionalToolRule,
+    ChildToolRule,
+    ContinueToolRule,
+    TerminalToolRule,
+    MaxCountPerStepToolRule,
+    ParentToolRule,
+    RequiredBeforeExitToolRule,
+    InitToolRule,
+]

letta_client/types/letta_schemas_agent_file_message_schema.py

@@ -0,0 +1,74 @@
+# 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 .letta_schemas_agent_file_message_schema_content import LettaSchemasAgentFileMessageSchemaContent
+from .message_role import MessageRole
+
+
+class LettaSchemasAgentFileMessageSchema(UncheckedBaseModel):
+    """
+    Message with human-readable ID for agent file
+    """
+
+    role: MessageRole = pydantic.Field()
+    """
+    The role of the participant.
+    """
+
+    content: LettaSchemasAgentFileMessageSchemaContent = pydantic.Field()
+    """
+    The content of the message.
+    """
+
+    name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the participant.
+    """
+
+    otid: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The offline threading id associated with this message
+    """
+
+    sender_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the sender of the message, can be an identity id or agent id
+    """
+
+    batch_item_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the LLMBatchItem that this message is associated with
+    """
+
+    group_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The multi-agent group that the message was sent in
+    """
+
+    id: str = pydantic.Field()
+    """
+    Human-readable identifier for this message in the file
+    """
+
+    model: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The model used to make the function call
+    """
+
+    agent_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The unique identifier of the agent
+    """
+
+    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/letta_schemas_agent_file_message_schema_content.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from .letta_message_content_union import LettaMessageContentUnion
+
+LettaSchemasAgentFileMessageSchemaContent = typing.Union[typing.List[LettaMessageContentUnion], str]

letta_client/types/letta_schemas_agent_file_tool_schema.py

@@ -0,0 +1,104 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.serialization import FieldMetadata
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .npm_requirement import NpmRequirement
+from .pip_requirement import PipRequirement
+from .tool_type import ToolType
+
+
+class LettaSchemasAgentFileToolSchema(UncheckedBaseModel):
+    """
+    Tool with human-readable ID for agent file
+    """
+
+    id: str = pydantic.Field()
+    """
+    Human-readable identifier for this tool in the file
+    """
+
+    tool_type: typing.Optional[ToolType] = pydantic.Field(default=None)
+    """
+    The type of the tool.
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The description of the tool.
+    """
+
+    source_type: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The type of the source code.
+    """
+
+    name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the function.
+    """
+
+    tags: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    Metadata tags.
+    """
+
+    source_code: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The source code of the function.
+    """
+
+    json_schema: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    The JSON schema of the function.
+    """
+
+    args_json_schema: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    The args JSON schema of the function.
+    """
+
+    return_char_limit: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The maximum number of characters in the response.
+    """
+
+    pip_requirements: typing.Optional[typing.List[PipRequirement]] = pydantic.Field(default=None)
+    """
+    Optional list of pip packages required by this tool.
+    """
+
+    npm_requirements: typing.Optional[typing.List[NpmRequirement]] = pydantic.Field(default=None)
+    """
+    Optional list of npm packages required by this tool.
+    """
+
+    created_by_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the user that made this Tool.
+    """
+
+    last_updated_by_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the user that made this Tool.
+    """
+
+    metadata: typing_extensions.Annotated[
+        typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]], FieldMetadata(alias="metadata_")
+    ] = pydantic.Field(default=None)
+    """
+    A dictionary of additional metadata for the tool.
+    """
+
+    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/{agent_schema.py → letta_serialize_schemas_pydantic_agent_schema_agent_schema.py}

@@ -7,17 +7,23 @@ import typing_extensions
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 from ..core.serialization import FieldMetadata
 from ..core.unchecked_base_model import UncheckedBaseModel
-from .agent_schema_tool_rules_item import AgentSchemaToolRulesItem
 from .core_memory_block_schema import CoreMemoryBlockSchema
 from .embedding_config import EmbeddingConfig
+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 .llm_config import LlmConfig
-from .message_schema import MessageSchema
 from .tag_schema import TagSchema
 from .tool_env_var_schema import ToolEnvVarSchema
-from .tool_schema import ToolSchema
 
 
-class AgentSchema(UncheckedBaseModel):
+class LettaSerializeSchemasPydanticAgentSchemaAgentSchema(UncheckedBaseModel):
     agent_type: str
     core_memory: typing.List[CoreMemoryBlockSchema]
     created_at: str
@@ -26,7 +32,7 @@ class AgentSchema(UncheckedBaseModel):
     llm_config: LlmConfig
     message_buffer_autoclear: bool
     in_context_message_indices: typing.List[int]
-    messages: typing.List[MessageSchema]
+    messages: typing.List[LettaSerializeSchemasPydanticAgentSchemaMessageSchema]
     metadata: typing_extensions.Annotated[
         typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]], FieldMetadata(alias="metadata_")
     ] = None
@@ -35,8 +41,8 @@ class AgentSchema(UncheckedBaseModel):
     system: str
     tags: typing.List[TagSchema]
     tool_exec_environment_variables: typing.List[ToolEnvVarSchema]
-    tool_rules: typing.List[AgentSchemaToolRulesItem]
-    tools: typing.List[ToolSchema]
+    tool_rules: typing.List[LettaSerializeSchemasPydanticAgentSchemaAgentSchemaToolRulesItem]
+    tools: typing.List[LettaSerializeSchemasPydanticAgentSchemaToolSchema]
     updated_at: str
     version: str
 

letta_client/types/{agent_schema_tool_rules_item.py → letta_serialize_schemas_pydantic_agent_schema_agent_schema_tool_rules_item.py}

@@ -7,6 +7,6 @@ from .child_tool_rule_schema import ChildToolRuleSchema
 from .conditional_tool_rule_schema import ConditionalToolRuleSchema
 from .max_count_per_step_tool_rule_schema import MaxCountPerStepToolRuleSchema
 
-AgentSchemaToolRulesItem = typing.Union[
+LettaSerializeSchemasPydanticAgentSchemaAgentSchemaToolRulesItem = typing.Union[
     BaseToolRuleSchema, ChildToolRuleSchema, MaxCountPerStepToolRuleSchema, ConditionalToolRuleSchema
 ]

letta_client/types/{message_schema.py → letta_serialize_schemas_pydantic_agent_schema_message_schema.py}

@@ -8,7 +8,7 @@ from ..core.unchecked_base_model import UncheckedBaseModel
 from .letta_message_content_union import LettaMessageContentUnion
 
 
-class MessageSchema(UncheckedBaseModel):
+class LettaSerializeSchemasPydanticAgentSchemaMessageSchema(UncheckedBaseModel):
     created_at: str
     group_id: typing.Optional[str] = None
     model: typing.Optional[str] = None

letta_client/types/{tool_schema.py → letta_serialize_schemas_pydantic_agent_schema_tool_schema.py}

@@ -10,7 +10,7 @@ from ..core.unchecked_base_model import UncheckedBaseModel
 from .tool_json_schema import ToolJsonSchema
 
 
-class ToolSchema(UncheckedBaseModel):
+class LettaSerializeSchemasPydanticAgentSchemaToolSchema(UncheckedBaseModel):
     args_json_schema: typing.Optional[typing.Any] = None
     created_at: str
     description: str

letta_client/types/mcp_server_schema.py

@@ -0,0 +1,37 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+import typing_extensions
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.serialization import FieldMetadata
+from ..core.unchecked_base_model import UncheckedBaseModel
+
+
+class McpServerSchema(UncheckedBaseModel):
+    """
+    MCP server schema for agent files with remapped ID.
+    """
+
+    id: str = pydantic.Field()
+    """
+    Human-readable MCP server ID
+    """
+
+    server_type: str
+    server_name: str
+    server_url: typing.Optional[str] = None
+    stdio_config: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = None
+    metadata: typing_extensions.Annotated[
+        typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]], FieldMetadata(alias="metadata_")
+    ] = 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/source_schema.py

@@ -0,0 +1,63 @@
+# 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 .embedding_config import EmbeddingConfig
+
+
+class SourceSchema(UncheckedBaseModel):
+    """
+    Source with human-readable ID for agent file
+    """
+
+    name: str = pydantic.Field()
+    """
+    The name of the source.
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The description of the source.
+    """
+
+    instructions: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Instructions for how to use the source.
+    """
+
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Metadata associated with the source.
+    """
+
+    embedding: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The handle for the embedding config used by the source.
+    """
+
+    embedding_chunk_size: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The chunk size of the embedding.
+    """
+
+    embedding_config: typing.Optional[EmbeddingConfig] = pydantic.Field(default=None)
+    """
+    (Legacy) The embedding configuration used by the source.
+    """
+
+    id: str = pydantic.Field()
+    """
+    Human-readable identifier for this source 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-0.1.250.dist-info → letta_client-0.1.252.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: letta-client
-Version: 0.1.250
+Version: 0.1.252
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers