letta-client 0.0.1285__py3-none-any.whl

letta_client/types/internal_server_error_body.py

@@ -0,0 +1,19 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class InternalServerErrorBody(UncheckedBaseModel):
+    message: typing.Literal["Failed to create agent template"] = "Failed to create agent template"
+
+    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/job.py

@@ -0,0 +1,76 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+import datetime as dt
+from .job_status import JobStatus
+from .job_type import JobType
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class Job(UncheckedBaseModel):
+    """
+    Representation of offline jobs, used for tracking status of data loading tasks (involving parsing and embedding files).
+
+    Parameters:
+        id (str): The unique identifier of the job.
+        status (JobStatus): The status of the job.
+        created_at (datetime): The unix timestamp of when the job was created.
+        completed_at (datetime): The unix timestamp of when the job was completed.
+        user_id (str): The unique identifier of the user associated with the.
+    """
+
+    created_by_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the user that made this object.
+    """
+
+    last_updated_by_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the user that made this object.
+    """
+
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The timestamp when the object was created.
+    """
+
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The timestamp when the object was last updated.
+    """
+
+    status: typing.Optional[JobStatus] = pydantic.Field(default=None)
+    """
+    The status of the job.
+    """
+
+    completed_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The unix timestamp of when the job was completed.
+    """
+
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    The metadata of the job.
+    """
+
+    job_type: typing.Optional[JobType] = pydantic.Field(default=None)
+    """
+    The type of the job.
+    """
+
+    id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The human-friendly ID of the Job
+    """
+
+    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/job_status.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+JobStatus = typing.Union[typing.Literal["created", "running", "completed", "failed", "pending"], typing.Any]

letta_client/types/job_type.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+JobType = typing.Union[typing.Literal["job", "run"], typing.Any]

letta_client/types/json_schema.py

@@ -0,0 +1,26 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import typing_extensions
+from ..core.serialization import FieldMetadata
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class JsonSchema(UncheckedBaseModel):
+    name: str
+    description: typing.Optional[str] = None
+    schema_: typing_extensions.Annotated[
+        typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]], FieldMetadata(alias="schema")
+    ] = None
+    strict: typing.Optional[bool] = 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/letta_message_union.py

@@ -0,0 +1,13 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .system_message import SystemMessage
+from .user_message import UserMessage
+from .reasoning_message import ReasoningMessage
+from .tool_call_message import ToolCallMessage
+from .tool_return_message import ToolReturnMessage
+from .assistant_message import AssistantMessage
+
+LettaMessageUnion = typing.Union[
+    SystemMessage, UserMessage, ReasoningMessage, ToolCallMessage, ToolReturnMessage, AssistantMessage
+]

letta_client/types/letta_request.py

@@ -0,0 +1,38 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+from .message_create import MessageCreate
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LettaRequest(UncheckedBaseModel):
+    messages: typing.List[MessageCreate] = pydantic.Field()
+    """
+    The messages to be sent to the agent.
+    """
+
+    use_assistant_message: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
+    """
+
+    assistant_message_tool_name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the designated message tool.
+    """
+
+    assistant_message_tool_kwarg: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the message argument in the designated message 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/letta_request_config.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LettaRequestConfig(UncheckedBaseModel):
+    use_assistant_message: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
+    """
+
+    assistant_message_tool_name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the designated message tool.
+    """
+
+    assistant_message_tool_kwarg: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the message argument in the designated message 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/letta_response.py

@@ -0,0 +1,38 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+from .letta_message_union import LettaMessageUnion
+import pydantic
+from .letta_usage_statistics import LettaUsageStatistics
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LettaResponse(UncheckedBaseModel):
+    """
+    Response object from an agent interaction, consisting of the new messages generated by the agent and usage statistics.
+    The type of the returned messages can be either `Message` or `LettaMessage`, depending on what was specified in the request.
+
+    Attributes:
+        messages (List[Union[Message, LettaMessage]]): The messages returned by the agent.
+        usage (LettaUsageStatistics): The usage statistics
+    """
+
+    messages: typing.List[LettaMessageUnion] = pydantic.Field()
+    """
+    The messages returned by the agent.
+    """
+
+    usage: LettaUsageStatistics = pydantic.Field()
+    """
+    The usage statistics 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_usage_statistics.py

@@ -0,0 +1,48 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LettaUsageStatistics(UncheckedBaseModel):
+    """
+    Usage statistics for the agent interaction.
+
+    Attributes:
+        completion_tokens (int): The number of tokens generated by the agent.
+        prompt_tokens (int): The number of tokens in the prompt.
+        total_tokens (int): The total number of tokens processed by the agent.
+        step_count (int): The number of steps taken by the agent.
+    """
+
+    message_type: typing.Optional[typing.Literal["usage_statistics"]] = None
+    completion_tokens: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The number of tokens generated by the agent.
+    """
+
+    prompt_tokens: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The number of tokens in the prompt.
+    """
+
+    total_tokens: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The total number of tokens processed by the agent.
+    """
+
+    step_count: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The number of steps taken by 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/llm_config.py

@@ -0,0 +1,77 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import pydantic
+from .llm_config_model_endpoint_type import LlmConfigModelEndpointType
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LlmConfig(UncheckedBaseModel):
+    """
+    Configuration for a Language Model (LLM) model. This object specifies all the information necessary to access an LLM model to usage with Letta, except for secret keys.
+
+    Attributes:
+        model (str): The name of the LLM model.
+        model_endpoint_type (str): The endpoint type for the model.
+        model_endpoint (str): The endpoint for the model.
+        model_wrapper (str): The wrapper for the model. This is used to wrap additional text around the input/output of the model. This is useful for text-to-text completions, such as the Completions API in OpenAI.
+        context_window (int): The context window size for the model.
+        put_inner_thoughts_in_kwargs (bool): Puts `inner_thoughts` as a kwarg in the function call if this is set to True. This helps with function calling performance and also the generation of inner thoughts.
+        temperature (float): The temperature to use when generating text with the model. A higher temperature will result in more random text.
+        max_tokens (int): The maximum number of tokens to generate.
+    """
+
+    model: str = pydantic.Field()
+    """
+    LLM model name. 
+    """
+
+    model_endpoint_type: LlmConfigModelEndpointType = pydantic.Field()
+    """
+    The endpoint type for the model.
+    """
+
+    model_endpoint: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The endpoint for the model.
+    """
+
+    model_wrapper: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The wrapper for the model.
+    """
+
+    context_window: int = pydantic.Field()
+    """
+    The context window size for the model.
+    """
+
+    put_inner_thoughts_in_kwargs: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Puts 'inner_thoughts' as a kwarg in the function call if this is set to True. This helps with function calling performance and also the generation of inner thoughts.
+    """
+
+    handle: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The handle for this config, in the format provider/model-name.
+    """
+
+    temperature: typing.Optional[float] = pydantic.Field(default=None)
+    """
+    The temperature to use when generating text with the model. A higher temperature will result in more random text.
+    """
+
+    max_tokens: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The maximum number of tokens to generate. If not set, the model will use its default value.
+    """
+
+    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/llm_config_model_endpoint_type.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+LlmConfigModelEndpointType = typing.Union[
+    typing.Literal[
+        "openai",
+        "anthropic",
+        "cohere",
+        "google_ai",
+        "azure",
+        "groq",
+        "ollama",
+        "webui",
+        "webui-legacy",
+        "lmstudio",
+        "lmstudio-legacy",
+        "llamacpp",
+        "koboldcpp",
+        "vllm",
+        "hugging-face",
+        "mistral",
+        "together",
+        "bedrock",
+    ],
+    typing.Any,
+]

letta_client/types/local_sandbox_config.py

@@ -0,0 +1,38 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+from .pip_requirement import PipRequirement
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LocalSandboxConfig(UncheckedBaseModel):
+    sandbox_dir: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Directory for the sandbox environment.
+    """
+
+    use_venv: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether or not to use the venv, or run directly in the same run loop.
+    """
+
+    venv_name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name for the venv in the sandbox directory. We first search for an existing venv with this name, otherwise, we make it from the requirements.txt.
+    """
+
+    pip_requirements: typing.Optional[typing.List[PipRequirement]] = pydantic.Field(default=None)
+    """
+    List of pip packages to install with mandatory name and optional version following semantic versioning. This only is considered when use_venv is True.
+    """
+
+    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/memory.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+from .block import Block
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class Memory(UncheckedBaseModel):
+    """
+    Represents the in-context memory (i.e. Core memory) of the agent. This includes both the `Block` objects (labelled by sections), as well as tools to edit the blocks.
+    """
+
+    blocks: typing.List[Block] = pydantic.Field()
+    """
+    Memory blocks contained in the agent's in-context memory
+    """
+
+    prompt_template: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Jinja2 template for compiling memory blocks into a prompt string
+    """
+
+    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/message.py

@@ -0,0 +1,102 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+import datetime as dt
+from .message_role import MessageRole
+from .text_content import TextContent
+from .chat_completion_message_tool_call_output import ChatCompletionMessageToolCallOutput
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class Message(UncheckedBaseModel):
+    """
+    Letta's internal representation of a message. Includes methods to convert to/from LLM provider formats.
+
+    Attributes:
+        id (str): The unique identifier of the message.
+        role (MessageRole): The role of the participant.
+        text (str): The text of the message.
+        user_id (str): The unique identifier of the user.
+        agent_id (str): The unique identifier of the agent.
+        model (str): The model used to make the function call.
+        name (str): The name of the participant.
+        created_at (datetime): The time the message was created.
+        tool_calls (List[OpenAIToolCall,]): The list of tool calls requested.
+        tool_call_id (str): The id of the tool call.
+    """
+
+    created_by_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the user that made this object.
+    """
+
+    last_updated_by_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the user that made this object.
+    """
+
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The timestamp when the object was created.
+    """
+
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The timestamp when the object was last updated.
+    """
+
+    id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The human-friendly ID of the Message
+    """
+
+    role: MessageRole = pydantic.Field()
+    """
+    The role of the participant.
+    """
+
+    content: typing.Optional[typing.List[TextContent]] = pydantic.Field(default=None)
+    """
+    The content of the message.
+    """
+
+    agent_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The unique identifier of the agent.
+    """
+
+    model: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The model used to make the function call.
+    """
+
+    name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the participant.
+    """
+
+    tool_calls: typing.Optional[typing.List[ChatCompletionMessageToolCallOutput]] = pydantic.Field(default=None)
+    """
+    The list of tool calls requested.
+    """
+
+    tool_call_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the tool call.
+    """
+
+    step_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the step that this message was created in.
+    """
+
+    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/message_create.py

@@ -0,0 +1,38 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .message_create_role import MessageCreateRole
+import pydantic
+from .message_create_content import MessageCreateContent
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class MessageCreate(UncheckedBaseModel):
+    """
+    Request to create a message
+    """
+
+    role: MessageCreateRole = pydantic.Field()
+    """
+    The role of the participant.
+    """
+
+    content: MessageCreateContent = pydantic.Field()
+    """
+    The content of the message.
+    """
+
+    name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the participant.
+    """
+
+    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/message_create_content.py

@@ -0,0 +1,6 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .text_content import TextContent
+
+MessageCreateContent = typing.Union[str, typing.List[TextContent]]

letta_client/types/message_create_role.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+MessageCreateRole = typing.Union[typing.Literal["user", "system"], typing.Any]

letta_client/types/message_role.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+MessageRole = typing.Union[typing.Literal["assistant", "user", "tool", "function", "system"], typing.Any]

letta_client/types/not_found_error_body.py

@@ -0,0 +1,19 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class NotFoundErrorBody(UncheckedBaseModel):
+    message: typing.Literal["Agent not found"] = "Agent not found"
+
+    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