letta-client 0.0.1285__py3-none-any.whl

letta_client/types/sandbox_environment_variable_create.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import pydantic
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class SandboxEnvironmentVariableCreate(UncheckedBaseModel):
+    key: str = pydantic.Field()
+    """
+    The name of the environment variable.
+    """
+
+    value: str = pydantic.Field()
+    """
+    The value of the environment variable.
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    An optional description of the environment variable.
+    """
+
+    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/sandbox_environment_variable_update.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 SandboxEnvironmentVariableUpdate(UncheckedBaseModel):
+    key: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the environment variable.
+    """
+
+    value: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The value of the environment variable.
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    An optional description of the environment variable.
+    """
+
+    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/sandbox_type.py

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

letta_client/types/source.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
+from .embedding_config import EmbeddingConfig
+import datetime as dt
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class Source(UncheckedBaseModel):
+    """
+    Representation of a source, which is a collection of files and passages.
+
+    Parameters:
+        id (str): The ID of the source
+        name (str): The name of the source.
+        embedding_config (EmbeddingConfig): The embedding configuration used by the source.
+        user_id (str): The ID of the user that created the source.
+        metadata (dict): Metadata associated with the source.
+        description (str): The description of the source.
+    """
+
+    id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The human-friendly ID of the Source
+    """
+
+    name: str = pydantic.Field()
+    """
+    The name of the source.
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The description of the source.
+    """
+
+    embedding_config: EmbeddingConfig = pydantic.Field()
+    """
+    The embedding configuration used by the source.
+    """
+
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Metadata associated with the source.
+    """
+
+    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.
+    """
+
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The timestamp when the source was created.
+    """
+
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The timestamp when the source was last updated.
+    """
+
+    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/step.py

@@ -0,0 +1,95 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import pydantic
+import typing
+from .message import Message
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class Step(UncheckedBaseModel):
+    id: str = pydantic.Field()
+    """
+    The id of the step. Assigned by the database.
+    """
+
+    origin: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The surface that this agent step was initiated from.
+    """
+
+    provider_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The unique identifier of the provider that was configured for this step
+    """
+
+    job_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The unique identifier of the job that this step belongs to. Only included for async calls.
+    """
+
+    provider_name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the provider used for this step.
+    """
+
+    model: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the model used for this step.
+    """
+
+    model_endpoint: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The model endpoint url used for this step.
+    """
+
+    context_window_limit: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The context window limit configured for this step.
+    """
+
+    completion_tokens: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The number of tokens generated by the agent during this step.
+    """
+
+    prompt_tokens: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The number of tokens in the prompt during this step.
+    """
+
+    total_tokens: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The total number of tokens processed by the agent during this step.
+    """
+
+    completion_tokens_details: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(
+        default=None
+    )
+    """
+    Metadata for the agent.
+    """
+
+    tags: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    Metadata tags.
+    """
+
+    tid: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The unique identifier of the transaction that processed this step.
+    """
+
+    messages: typing.Optional[typing.List[Message]] = pydantic.Field(default=None)
+    """
+    The messages generated during this step.
+    """
+
+    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/system_message.py

@@ -0,0 +1,33 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import datetime as dt
+import typing
+from .system_message_content import SystemMessageContent
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class SystemMessage(UncheckedBaseModel):
+    """
+    A message generated by the system. Never streamed back on a response, only used for cursor pagination.
+
+    Attributes:
+        content (Union[str, List[MessageContentUnion]]): The message content sent by the user (can be a string or an array of content parts)
+        id (str): The ID of the message
+        date (datetime): The date the message was created in ISO format
+    """
+
+    id: str
+    date: dt.datetime
+    message_type: typing.Literal["system_message"] = "system_message"
+    content: SystemMessageContent
+
+    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/system_message_content.py

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

letta_client/types/terminal_tool_rule.py

@@ -0,0 +1,28 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import pydantic
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class TerminalToolRule(UncheckedBaseModel):
+    """
+    Represents a terminal tool rule configuration where if this tool gets called, it must end the agent loop.
+    """
+
+    tool_name: str = pydantic.Field()
+    """
+    The name of the tool. Must exist in the database for the user's organization.
+    """
+
+    type: typing.Literal["exit_loop"] = "exit_loop"
+
+    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/text_content.py

@@ -0,0 +1,23 @@
+# 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 TextContent(UncheckedBaseModel):
+    type: typing.Literal["text"] = "text"
+    text: str = pydantic.Field()
+    """
+    The text content of the message.
+    """
+
+    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/tool.py

@@ -0,0 +1,84 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+from .tool_type import ToolType
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class Tool(UncheckedBaseModel):
+    """
+    Representation of a tool, which is a function that can be called by the agent.
+
+    Parameters:
+        id (str): The unique identifier of the tool.
+        name (str): The name of the function.
+        tags (List[str]): Metadata tags.
+        source_code (str): The source code of the function.
+        json_schema (Dict): The JSON schema of the function.
+    """
+
+    id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The human-friendly ID of the Tool
+    """
+
+    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.
+    """
+
+    return_char_limit: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The maximum number of characters in the response.
+    """
+
+    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.
+    """
+
+    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/tool_call.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class ToolCall(UncheckedBaseModel):
+    name: str
+    arguments: str
+    tool_call_id: str
+
+    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/tool_call_delta.py

@@ -0,0 +1,21 @@
+# 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 ToolCallDelta(UncheckedBaseModel):
+    name: typing.Optional[str] = None
+    arguments: typing.Optional[str] = None
+    tool_call_id: typing.Optional[str] = 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/tool_call_message.py

@@ -0,0 +1,33 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import datetime as dt
+import typing
+from .tool_call_message_tool_call import ToolCallMessageToolCall
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class ToolCallMessage(UncheckedBaseModel):
+    """
+    A message representing a request to call a tool (generated by the LLM to trigger tool execution).
+
+    Attributes:
+        tool_call (Union[ToolCall, ToolCallDelta]): The tool call
+        id (str): The ID of the message
+        date (datetime): The date the message was created in ISO format
+    """
+
+    id: str
+    date: dt.datetime
+    message_type: typing.Literal["tool_call_message"] = "tool_call_message"
+    tool_call: ToolCallMessageToolCall
+
+    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/tool_call_message_tool_call.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .tool_call import ToolCall
+from .tool_call_delta import ToolCallDelta
+
+ToolCallMessageToolCall = typing.Union[ToolCall, ToolCallDelta]

letta_client/types/tool_create.py

@@ -0,0 +1,47 @@
+# 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 ToolCreate(UncheckedBaseModel):
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The description of the tool.
+    """
+
+    tags: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    Metadata tags.
+    """
+
+    source_code: str = pydantic.Field()
+    """
+    The source code of the function.
+    """
+
+    source_type: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The source type of the function.
+    """
+
+    json_schema: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    The JSON schema of the function (auto-generated from source_code if not provided)
+    """
+
+    return_char_limit: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The maximum number of characters in the response.
+    """
+
+    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/tool_return_message.py

@@ -0,0 +1,41 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import datetime as dt
+import typing
+from .tool_return_message_status import ToolReturnMessageStatus
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class ToolReturnMessage(UncheckedBaseModel):
+    """
+    A message representing the return value of a tool call (generated by Letta executing the requested tool).
+
+    Attributes:
+        tool_return (str): The return value of the tool
+        status (Literal["success", "error"]): The status of the tool call
+        id (str): The ID of the message
+        date (datetime): The date the message was created in ISO format
+        tool_call_id (str): A unique identifier for the tool call that generated this message
+        stdout (Optional[List(str)]): Captured stdout (e.g. prints, logs) from the tool invocation
+        stderr (Optional[List(str)]): Captured stderr from the tool invocation
+    """
+
+    id: str
+    date: dt.datetime
+    message_type: typing.Literal["tool_return_message"] = "tool_return_message"
+    tool_return: str
+    status: ToolReturnMessageStatus
+    tool_call_id: str
+    stdout: typing.Optional[typing.List[str]] = None
+    stderr: typing.Optional[typing.List[str]] = 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/tool_return_message_status.py

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

letta_client/types/tool_type.py

@@ -0,0 +1,10 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+ToolType = typing.Union[
+    typing.Literal[
+        "custom", "letta_core", "letta_memory_core", "letta_multi_agent_core", "external_composio", "external_langchain"
+    ],
+    typing.Any,
+]

letta_client/types/usage_statistics.py

@@ -0,0 +1,21 @@
+# 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 UsageStatistics(UncheckedBaseModel):
+    completion_tokens: typing.Optional[int] = None
+    prompt_tokens: typing.Optional[int] = None
+    total_tokens: typing.Optional[int] = 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