letta-client 0.1.4__py3-none-any.whl → 0.1.6__py3-none-any.whl

letta/types/context_window_overview.py

@@ -43,6 +43,11 @@ class ContextWindowOverview(UniversalBaseModel):
     The number of tokens in the external memory summary (archival + recall metadata).
     """
 
+    external_memory_summary: str = pydantic.Field()
+    """
+    The metadata summary of the external memory sources (archival + recall metadata).
+    """
+
     num_tokens_system: int = pydantic.Field()
     """
     The number of tokens in the system prompt.

letta/types/embedding_config.py

@@ -12,14 +12,14 @@ class EmbeddingConfig(UniversalBaseModel):
     Embedding model configuration. This object specifies all the information necessary to access an embedding model to usage with Letta, except for secret keys.
 
     Attributes:
-    embedding_endpoint_type (str): The endpoint type for the model.
-    embedding_endpoint (str): The endpoint for the model.
-    embedding_model (str): The model for the embedding.
-    embedding_dim (int): The dimension of the embedding.
-    embedding_chunk_size (int): The chunk size of the embedding.
-    azure_endpoint (:obj:`str`, optional): The Azure endpoint for the model (Azure only).
-    azure_version (str): The Azure version for the model (Azure only).
-    azure_deployment (str): The Azure deployment for the model (Azure only).
+        embedding_endpoint_type (str): The endpoint type for the model.
+        embedding_endpoint (str): The endpoint for the model.
+        embedding_model (str): The model for the embedding.
+        embedding_dim (int): The dimension of the embedding.
+        embedding_chunk_size (int): The chunk size of the embedding.
+        azure_endpoint (:obj:`str`, optional): The Azure endpoint for the model (Azure only).
+        azure_version (str): The Azure version for the model (Azure only).
+        azure_deployment (str): The Azure deployment for the model (Azure only).
     """
 
     embedding_endpoint_type: EmbeddingConfigEmbeddingEndpointType = pydantic.Field()

letta/types/job.py

@@ -15,11 +15,11 @@ class Job(UniversalBaseModel):
     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.
+        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)

letta/types/letta_response.py

@@ -2,6 +2,7 @@
 
 from ..core.pydantic_utilities import UniversalBaseModel
 import typing
+from .letta_response_messages_item import LettaResponseMessagesItem
 import pydantic
 from .letta_usage_statistics import LettaUsageStatistics
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
@@ -13,11 +14,11 @@ class LettaResponse(UniversalBaseModel):
     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 (List[Union[Message, LettaMessage]]): The messages returned by the agent.
+        usage (LettaUsageStatistics): The usage statistics
     """
 
-    messages: typing.List[typing.Optional[typing.Any]] = pydantic.Field()
+    messages: typing.List[LettaResponseMessagesItem] = pydantic.Field()
     """
     The messages returned by the agent.
     """

letta/types/letta_response_messages_item.py

@@ -0,0 +1,120 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from __future__ import annotations
+from ..core.pydantic_utilities import UniversalBaseModel
+import typing
+import datetime as dt
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+from .tool_call_message_tool_call import ToolCallMessageToolCall
+from .tool_return_message_status import ToolReturnMessageStatus
+
+
+class LettaResponseMessagesItem_SystemMessage(UniversalBaseModel):
+    message_type: typing.Literal["system_message"] = "system_message"
+    id: str
+    date: dt.datetime
+    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
+
+
+class LettaResponseMessagesItem_UserMessage(UniversalBaseModel):
+    message_type: typing.Literal["user_message"] = "user_message"
+    id: str
+    date: dt.datetime
+    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
+
+
+class LettaResponseMessagesItem_ReasoningMessage(UniversalBaseModel):
+    message_type: typing.Literal["reasoning_message"] = "reasoning_message"
+    id: str
+    date: dt.datetime
+    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
+
+
+class LettaResponseMessagesItem_ToolCallMessage(UniversalBaseModel):
+    message_type: typing.Literal["tool_call_message"] = "tool_call_message"
+    id: str
+    date: dt.datetime
+    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
+
+
+class LettaResponseMessagesItem_ToolReturnMessage(UniversalBaseModel):
+    message_type: typing.Literal["tool_return_message"] = "tool_return_message"
+    id: str
+    date: dt.datetime
+    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
+
+
+class LettaResponseMessagesItem_AssistantMessage(UniversalBaseModel):
+    message_type: typing.Literal["assistant_message"] = "assistant_message"
+    id: str
+    date: dt.datetime
+    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
+
+
+LettaResponseMessagesItem = typing.Union[
+    LettaResponseMessagesItem_SystemMessage,
+    LettaResponseMessagesItem_UserMessage,
+    LettaResponseMessagesItem_ReasoningMessage,
+    LettaResponseMessagesItem_ToolCallMessage,
+    LettaResponseMessagesItem_ToolReturnMessage,
+    LettaResponseMessagesItem_AssistantMessage,
+]

letta/types/letta_schemas_message_message.py

@@ -14,16 +14,16 @@ class LettaSchemasMessageMessage(UniversalBaseModel):
     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[ToolCall]): The list of tool calls requested.
-    tool_call_id (str): The id of the tool call.
+        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[ToolCall]): 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)

letta/types/letta_schemas_tool_tool.py

@@ -11,11 +11,11 @@ class LettaSchemasToolTool(UniversalBaseModel):
     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 (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)

letta/types/letta_usage_statistics.py

@@ -11,13 +11,12 @@ class LettaUsageStatistics(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 (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.

letta/types/llm_config.py

@@ -12,17 +12,17 @@ class LlmConfig(UniversalBaseModel):
     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.
+        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.
     """
 
     model: str = pydantic.Field()
     """
-    LLM model name.
+    LLM model name. 
     """
 
     model_endpoint_type: LlmConfigModelEndpointType = pydantic.Field()

letta/types/passage.py

@@ -15,14 +15,14 @@ class Passage(UniversalBaseModel):
     Representation of a passage, which is stored in archival memory.
 
     Parameters:
-    text (str): The text of the passage.
-    embedding (List[float]): The embedding of the passage.
-    embedding_config (EmbeddingConfig): The embedding configuration used by the passage.
-    created_at (datetime): The creation date of the passage.
-    user_id (str): The unique identifier of the user associated with the passage.
-    agent_id (str): The unique identifier of the agent associated with the passage.
-    source_id (str): The data source of the passage.
-    file_id (str): The unique identifier of the file associated with the passage.
+        text (str): The text of the passage.
+        embedding (List[float]): The embedding of the passage.
+        embedding_config (EmbeddingConfig): The embedding configuration used by the passage.
+        created_at (datetime): The creation date of the passage.
+        user_id (str): The unique identifier of the user associated with the passage.
+        agent_id (str): The unique identifier of the agent associated with the passage.
+        source_id (str): The data source of the passage.
+        file_id (str): The unique identifier of the file associated with the passage.
     """
 
     created_by_id: typing.Optional[str] = pydantic.Field(default=None)

letta/types/reasoning_message.py

@@ -2,8 +2,8 @@
 
 from ..core.pydantic_utilities import UniversalBaseModel
 import datetime as dt
-import typing
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
 import pydantic
 
 
@@ -12,14 +12,13 @@ class ReasoningMessage(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
+        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.Literal["reasoning_message"] = "reasoning_message"
     reasoning: str
 
     if IS_PYDANTIC_V2:

letta/types/sandbox_environment_variable.py

@@ -48,14 +48,14 @@ class SandboxEnvironmentVariable(UniversalBaseModel):
     An optional description of the environment variable.
     """
 
-    sandbox_config_id: str = pydantic.Field()
+    organization_id: typing.Optional[str] = pydantic.Field(default=None)
     """
-    The ID of the sandbox config this environment variable belongs to.
+    The ID of the organization this environment variable belongs to.
     """
 
-    organization_id: typing.Optional[str] = pydantic.Field(default=None)
+    sandbox_config_id: str = pydantic.Field()
     """
-    The ID of the organization this environment variable belongs to.
+    The ID of the sandbox config this environment variable belongs to.
     """
 
     if IS_PYDANTIC_V2:

letta/types/sandbox_environment_variable_update.py

@@ -7,10 +7,6 @@ from ..core.pydantic_utilities import IS_PYDANTIC_V2
 
 
 class SandboxEnvironmentVariableUpdate(UniversalBaseModel):
-    """
-    Pydantic model for updating SandboxEnvironmentVariable fields.
-    """
-
     key: typing.Optional[str] = pydantic.Field(default=None)
     """
     The name of the environment variable.

letta/types/source.py

@@ -15,12 +15,12 @@ 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 (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)

letta/types/system_message_output.py

@@ -2,8 +2,8 @@
 
 from ..core.pydantic_utilities import UniversalBaseModel
 import datetime as dt
-import typing
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
 import pydantic
 
 
@@ -12,14 +12,13 @@ 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
+        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:

letta/types/tool_call_message.py

@@ -2,9 +2,9 @@
 
 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 typing
 import pydantic
 
 
@@ -13,14 +13,13 @@ 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
+        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:

letta/types/tool_return_message.py

@@ -2,8 +2,8 @@
 
 from ..core.pydantic_utilities import UniversalBaseModel
 import datetime as dt
-import typing
 from .tool_return_message_status import ToolReturnMessageStatus
+import typing
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 import pydantic
 
@@ -13,18 +13,17 @@ 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
+        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

letta/types/user.py

@@ -12,9 +12,9 @@ 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 (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)

letta/types/user_message_output.py

@@ -2,8 +2,8 @@
 
 from ..core.pydantic_utilities import UniversalBaseModel
 import datetime as dt
-import typing
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
 import pydantic
 
 
@@ -12,14 +12,13 @@ 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
+        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:

{letta_client-0.1.4.dist-info → letta_client-0.1.6.dist-info}/METADATA

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