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

letta/types/letta_response.py

@@ -0,0 +1,125 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing_extensions
+import typing
+from .letta_response_assistant_message import LettaResponseAssistantMessage
+from ..core.serialization import FieldMetadata
+from .letta_response_letta_usage_statistics import LettaResponseLettaUsageStatistics
+import pydantic
+from .letta_response_reasoning_message import LettaResponseReasoningMessage
+from .letta_response_system_message import LettaResponseSystemMessage
+from .letta_response_tool_call import LettaResponseToolCall
+from .letta_response_tool_call_delta import LettaResponseToolCallDelta
+from .letta_response_tool_call_message import LettaResponseToolCallMessage
+from .letta_response_tool_return_message import LettaResponseToolReturnMessage
+from .letta_response_usage_message import LettaResponseUsageMessage
+from .letta_response_user_message import LettaResponseUserMessage
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LettaResponse(UniversalBaseModel):
+    assistant_message: typing_extensions.Annotated[
+        typing.Optional[LettaResponseAssistantMessage], FieldMetadata(alias="AssistantMessage")
+    ] = None
+    letta_usage_statistics: typing_extensions.Annotated[
+        typing.Optional[LettaResponseLettaUsageStatistics], FieldMetadata(alias="LettaUsageStatistics")
+    ] = pydantic.Field(default=None)
+    """
+    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.
+    """
+
+    reasoning_message: typing_extensions.Annotated[
+        typing.Optional[LettaResponseReasoningMessage], FieldMetadata(alias="ReasoningMessage")
+    ] = pydantic.Field(default=None)
+    """
+    Representation of an agent's internal reasoning.
+    
+    Attributes:
+    reasoning (str): The internal reasoning of the agent
+    id (str): The ID of the message
+    date (datetime): The date the message was created in ISO format
+    """
+
+    system_message: typing_extensions.Annotated[
+        typing.Optional[LettaResponseSystemMessage], FieldMetadata(alias="SystemMessage")
+    ] = pydantic.Field(default=None)
+    """
+    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
+    """
+
+    tool_call: typing_extensions.Annotated[typing.Optional[LettaResponseToolCall], FieldMetadata(alias="ToolCall")] = (
+        None
+    )
+    tool_call_delta: typing_extensions.Annotated[
+        typing.Optional[LettaResponseToolCallDelta], FieldMetadata(alias="ToolCallDelta")
+    ] = None
+    tool_call_message: typing_extensions.Annotated[
+        typing.Optional[LettaResponseToolCallMessage], FieldMetadata(alias="ToolCallMessage")
+    ] = pydantic.Field(default=None)
+    """
+    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
+    """
+
+    tool_return_message: typing_extensions.Annotated[
+        typing.Optional[LettaResponseToolReturnMessage], FieldMetadata(alias="ToolReturnMessage")
+    ] = pydantic.Field(default=None)
+    """
+    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
+    """
+
+    usage_message: typing_extensions.Annotated[
+        typing.Optional[LettaResponseUsageMessage], FieldMetadata(alias="UsageMessage")
+    ] = pydantic.Field(default=None)
+    """
+    A message representint the usage statistics for the agent interaction.
+    
+    Attributes:
+    usage (LettaUsageStatistics): Usage statistics for the agent interaction.
+    """
+
+    user_message: typing_extensions.Annotated[
+        typing.Optional[LettaResponseUserMessage], FieldMetadata(alias="UserMessage")
+    ] = pydantic.Field(default=None)
+    """
+    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
+    """
+
+    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/letta_response_assistant_message.py

@@ -0,0 +1,23 @@
+# 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 LettaResponseAssistantMessage(UniversalBaseModel):
+    id: str
+    date: dt.datetime
+    message_type: typing.Optional[typing.Literal["assistant_message"]] = None
+    assistant_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/letta_response_letta_usage_statistics.py

@@ -0,0 +1,47 @@
+# 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 LettaResponseLettaUsageStatistics(UniversalBaseModel):
+    """
+    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.
+    """
+
+    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/types/letta_response_reasoning_message.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 LettaResponseReasoningMessage(UniversalBaseModel):
+    """
+    Representation of an agent's internal reasoning.
+
+    Attributes:
+    reasoning (str): The internal reasoning of the agent
+    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.Optional[typing.Literal["reasoning_message"]] = None
+    reasoning: 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/letta_response_system_message.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 LettaResponseSystemMessage(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.Optional[typing.Literal["system_message"]] = None
+    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/letta_response_tool_call.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.pydantic_utilities import UniversalBaseModel
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+import pydantic
+
+
+class LettaResponseToolCall(UniversalBaseModel):
+    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/types/letta_response_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 LettaResponseToolCallDelta(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/letta_response_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 .letta_response_tool_call_message_tool_call import LettaResponseToolCallMessageToolCall
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class LettaResponseToolCallMessage(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.Optional[typing.Literal["tool_call_message"]] = None
+    tool_call: LettaResponseToolCallMessageToolCall
+
+    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/letta_response_tool_call_message_tool_call.py

@@ -0,0 +1,9 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .letta_response_tool_call_message_tool_call_zero import LettaResponseToolCallMessageToolCallZero
+from .letta_response_tool_call_message_tool_call_one import LettaResponseToolCallMessageToolCallOne
+
+LettaResponseToolCallMessageToolCall = typing.Union[
+    LettaResponseToolCallMessageToolCallZero, LettaResponseToolCallMessageToolCallOne
+]

letta/types/letta_response_tool_call_message_tool_call_one.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 LettaResponseToolCallMessageToolCallOne(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/letta_response_tool_call_message_tool_call_zero.py

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

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

letta/types/letta_response_usage_message.py

@@ -0,0 +1,40 @@
+# 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_response_usage_message_usage import LettaResponseUsageMessageUsage
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LettaResponseUsageMessage(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: LettaResponseUsageMessageUsage = pydantic.Field()
+    """
+    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.
+    """
+
+    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/letta_response_usage_message_usage.py

@@ -0,0 +1,47 @@
+# 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 LettaResponseUsageMessageUsage(UniversalBaseModel):
+    """
+    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.
+    """
+
+    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/types/letta_response_user_message.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 LettaResponseUserMessage(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.Optional[typing.Literal["user_message"]] = None
+    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/letta_schemas_letta_message_tool_call.py

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