letta-client 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

letta/types/source.py

@@ -0,0 +1,85 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+import pydantic
+from .embedding_config import EmbeddingConfig
+import typing_extensions
+from ..core.serialization import FieldMetadata
+import datetime as dt
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class Source(UniversalBaseModel):
+    """
+    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.
+    """
+
+    organization_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The ID of the organization that created the source.
+    """
+
+    metadata: typing_extensions.Annotated[
+        typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]], FieldMetadata(alias="metadata_")
+    ] = 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/types/system_message_input.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class SystemMessageInput(UniversalBaseModel):
+    content: str
+    role: typing.Optional[str] = None
+    name: 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/types/system_message_output.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import datetime as dt
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class SystemMessageOutput(UniversalBaseModel):
+    """
+    A message generated by the system. Never streamed back on a response, only used for cursor pagination.
+
+    Attributes:
+    message (str): The message sent by the system
+    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"
+    message: 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/types/terminal_tool_rule.py

@@ -0,0 +1,29 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import pydantic
+import typing
+from .tool_rule_type import ToolRuleType
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class TerminalToolRule(UniversalBaseModel):
+    """
+    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.Optional[ToolRuleType] = 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/types/tool_call_delta.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class ToolCallDelta(UniversalBaseModel):
+    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/types/tool_call_function_output.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+
+
+class ToolCallFunctionOutput(UniversalBaseModel):
+    name: str = pydantic.Field()
+    """
+    The name of the function to call
+    """
+
+    arguments: str = pydantic.Field()
+    """
+    The arguments to pass to the function (JSON dump)
+    """
+
+    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/types/tool_call_message.py

@@ -0,0 +1,33 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+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(UniversalBaseModel):
+    """
+    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/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 .letta_schemas_letta_message_tool_call import LettaSchemasLettaMessageToolCall
+from .tool_call_delta import ToolCallDelta
+
+ToolCallMessageToolCall = typing.Union[LettaSchemasLettaMessageToolCall, ToolCallDelta]

letta/types/tool_create.py

@@ -0,0 +1,57 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class ToolCreate(UniversalBaseModel):
+    name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the function (auto-generated from source_code if not provided).
+    """
+
+    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.
+    """
+
+    module: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The source code of the function.
+    """
+
+    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/types/tool_function_choice.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from .function_call_input import FunctionCallInput
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class ToolFunctionChoice(UniversalBaseModel):
+    type: typing.Optional[typing.Literal["function"]] = None
+    function: FunctionCallInput
+
+    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/types/tool_input.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from .function_schema import FunctionSchema
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class ToolInput(UniversalBaseModel):
+    type: typing.Optional[typing.Literal["function"]] = None
+    function: FunctionSchema
+
+    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/types/tool_message.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class ToolMessage(UniversalBaseModel):
+    content: str
+    role: typing.Optional[str] = None
+    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/types/tool_return_message.py

@@ -0,0 +1,41 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+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(UniversalBaseModel):
+    """
+    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/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/types/tool_rule_type.py

@@ -0,0 +1,10 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+ToolRuleType = typing.Union[
+    typing.Literal[
+        "InitToolRule", "TerminalToolRule", "continue_loop", "conditional", "ToolRule", "require_parent_tools"
+    ],
+    typing.Any,
+]

letta/types/usage_message.py

@@ -0,0 +1,31 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import datetime as dt
+import typing
+from .letta_usage_statistics import LettaUsageStatistics
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class UsageMessage(UniversalBaseModel):
+    """
+    A message representint the usage statistics for the agent interaction.
+
+    Attributes:
+    usage (LettaUsageStatistics): Usage statistics for the agent interaction.
+    """
+
+    id: str
+    date: dt.datetime
+    message_type: typing.Optional[typing.Literal["usage_message"]] = None
+    usage: LettaUsageStatistics
+
+    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/types/usage_statistics.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class UsageStatistics(UniversalBaseModel):
+    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

letta/types/user.py

@@ -0,0 +1,57 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+import pydantic
+import datetime as dt
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class User(UniversalBaseModel):
+    """
+    Representation of a user.
+
+    Parameters:
+    id (str): The unique identifier of the user.
+    name (str): The name of the user.
+    created_at (datetime): The creation date of the user.
+    """
+
+    id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The human-friendly ID of the User
+    """
+
+    organization_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The organization id of the user
+    """
+
+    name: str = pydantic.Field()
+    """
+    The name of the user.
+    """
+
+    created_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The creation date of the user.
+    """
+
+    updated_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The update date of the user.
+    """
+
+    is_deleted: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether this user is deleted or not.
+    """
+
+    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/types/user_create.py

@@ -0,0 +1,27 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+
+
+class UserCreate(UniversalBaseModel):
+    name: str = pydantic.Field()
+    """
+    The name of the user.
+    """
+
+    organization_id: str = pydantic.Field()
+    """
+    The organization id of the user.
+    """
+
+    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/types/user_message_input.py

@@ -0,0 +1,22 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+from .user_message_input_content import UserMessageInputContent
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class UserMessageInput(UniversalBaseModel):
+    content: UserMessageInputContent
+    role: typing.Optional[str] = None
+    name: 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/types/user_message_input_content.py

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

letta/types/user_message_output.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import datetime as dt
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class UserMessageOutput(UniversalBaseModel):
+    """
+    A message sent by the user. Never streamed back on a response, only used for cursor pagination.
+
+    Attributes:
+    message (str): The message sent by the user
+    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["user_message"] = "user_message"
+    message: 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