letta-client 0.1.15__tar.gz → 0.1.17__tar.gz

{letta_client-0.1.15 → letta_client-0.1.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: letta-client
-Version: 0.1.15
+Version: 0.1.17
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers
@@ -105,7 +105,7 @@ from letta_client import Letta, MessageCreate
 client = Letta(
     token="YOUR_TOKEN",
 )
-response = client.agents.messages.stream(
+response = client.agents.messages.create_stream(
     agent_id="agent_id",
     messages=[
         MessageCreate(

{letta_client-0.1.15 → letta_client-0.1.17}/README.md

@@ -78,7 +78,7 @@ from letta_client import Letta, MessageCreate
 client = Letta(
     token="YOUR_TOKEN",
 )
-response = client.agents.messages.stream(
+response = client.agents.messages.create_stream(
     agent_id="agent_id",
     messages=[
         MessageCreate(

{letta_client-0.1.15 → letta_client-0.1.17}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "letta-client"
-version = "0.1.15"
+version = "0.1.17"
 description = ""
 readme = "README.md"
 authors = []

{letta_client-0.1.15 → letta_client-0.1.17}/src/letta_client/__init__.py

@@ -11,7 +11,6 @@ from .types import (
     AppAuthScheme,
     AppAuthSchemeAuthMode,
     AppModel,
-    ArchivalMemorySummary,
     AssistantFile,
     AssistantMessageInput,
     AssistantMessageOutput,
@@ -50,16 +49,16 @@ from .types import (
     Job,
     JobStatus,
     JobType,
+    LettaMessageUnion,
+    LettaMessageUnion_AssistantMessage,
+    LettaMessageUnion_ReasoningMessage,
+    LettaMessageUnion_SystemMessage,
+    LettaMessageUnion_ToolCallMessage,
+    LettaMessageUnion_ToolReturnMessage,
+    LettaMessageUnion_UserMessage,
     LettaRequest,
     LettaRequestConfig,
     LettaResponse,
-    LettaResponseMessagesItem,
-    LettaResponseMessagesItem_AssistantMessage,
-    LettaResponseMessagesItem_ReasoningMessage,
-    LettaResponseMessagesItem_SystemMessage,
-    LettaResponseMessagesItem_ToolCallMessage,
-    LettaResponseMessagesItem_ToolReturnMessage,
-    LettaResponseMessagesItem_UserMessage,
     LettaSchemasLettaMessageToolCall,
     LettaSchemasMessageMessage,
     LettaSchemasOpenaiChatCompletionRequestTool,
@@ -89,7 +88,6 @@ from .types import (
     Passage,
     Provider,
     ReasoningMessage,
-    RecallMemorySummary,
     ResponseFormat,
     Run,
     SandboxConfig,
@@ -148,15 +146,6 @@ from .agents import (
 )
 from .client import AsyncLetta, Letta
 from .environment import LettaEnvironment
-from .runs import (
-    GetRunMessagesResponseItem,
-    GetRunMessagesResponseItem_AssistantMessage,
-    GetRunMessagesResponseItem_ReasoningMessage,
-    GetRunMessagesResponseItem_SystemMessage,
-    GetRunMessagesResponseItem_ToolCallMessage,
-    GetRunMessagesResponseItem_ToolReturnMessage,
-    GetRunMessagesResponseItem_UserMessage,
-)
 from .version import __version__
 
 __all__ = [
@@ -183,7 +172,6 @@ __all__ = [
     "AppAuthScheme",
     "AppAuthSchemeAuthMode",
     "AppModel",
-    "ArchivalMemorySummary",
     "AssistantFile",
     "AssistantMessageInput",
     "AssistantMessageOutput",
@@ -218,13 +206,6 @@ __all__ = [
     "FunctionCallInput",
     "FunctionCallOutput",
     "FunctionSchema",
-    "GetRunMessagesResponseItem",
-    "GetRunMessagesResponseItem_AssistantMessage",
-    "GetRunMessagesResponseItem_ReasoningMessage",
-    "GetRunMessagesResponseItem_SystemMessage",
-    "GetRunMessagesResponseItem_ToolCallMessage",
-    "GetRunMessagesResponseItem_ToolReturnMessage",
-    "GetRunMessagesResponseItem_UserMessage",
     "Health",
     "HttpValidationError",
     "InitToolRule",
@@ -235,16 +216,16 @@ __all__ = [
     "JobType",
     "Letta",
     "LettaEnvironment",
+    "LettaMessageUnion",
+    "LettaMessageUnion_AssistantMessage",
+    "LettaMessageUnion_ReasoningMessage",
+    "LettaMessageUnion_SystemMessage",
+    "LettaMessageUnion_ToolCallMessage",
+    "LettaMessageUnion_ToolReturnMessage",
+    "LettaMessageUnion_UserMessage",
     "LettaRequest",
     "LettaRequestConfig",
     "LettaResponse",
-    "LettaResponseMessagesItem",
-    "LettaResponseMessagesItem_AssistantMessage",
-    "LettaResponseMessagesItem_ReasoningMessage",
-    "LettaResponseMessagesItem_SystemMessage",
-    "LettaResponseMessagesItem_ToolCallMessage",
-    "LettaResponseMessagesItem_ToolReturnMessage",
-    "LettaResponseMessagesItem_UserMessage",
     "LettaSchemasLettaMessageToolCall",
     "LettaSchemasMessageMessage",
     "LettaSchemasOpenaiChatCompletionRequestTool",
@@ -275,7 +256,6 @@ __all__ = [
     "Passage",
     "Provider",
     "ReasoningMessage",
-    "RecallMemorySummary",
     "ResponseFormat",
     "Run",
     "SandboxConfig",

{letta_client-0.1.15 → letta_client-0.1.17}/src/letta_client/agents/__init__.py

@@ -17,17 +17,7 @@ from .types import (
     CreateAgentRequestToolRulesItem,
     UpdateAgentToolRulesItem,
 )
-from . import (
-    archival_memory,
-    context,
-    core_memory,
-    memory_variables,
-    messages,
-    recall_memory,
-    sources,
-    templates,
-    tools,
-)
+from . import archival_memory, context, core_memory, memory_variables, messages, sources, templates, tools
 from .memory_variables import MemoryVariablesGetResponse
 from .messages import (
     LettaStreamingResponse,
@@ -39,13 +29,6 @@ from .messages import (
     LettaStreamingResponse_UsageStatistics,
     LettaStreamingResponse_UserMessage,
     MessagesListResponse,
-    MessagesListResponseItem,
-    MessagesListResponseItem_AssistantMessage,
-    MessagesListResponseItem_ReasoningMessage,
-    MessagesListResponseItem_SystemMessage,
-    MessagesListResponseItem_ToolCallMessage,
-    MessagesListResponseItem_ToolReturnMessage,
-    MessagesListResponseItem_UserMessage,
 )
 from .templates import TemplatesMigrateResponse
 
@@ -74,13 +57,6 @@ __all__ = [
     "LettaStreamingResponse_UserMessage",
     "MemoryVariablesGetResponse",
     "MessagesListResponse",
-    "MessagesListResponseItem",
-    "MessagesListResponseItem_AssistantMessage",
-    "MessagesListResponseItem_ReasoningMessage",
-    "MessagesListResponseItem_SystemMessage",
-    "MessagesListResponseItem_ToolCallMessage",
-    "MessagesListResponseItem_ToolReturnMessage",
-    "MessagesListResponseItem_UserMessage",
     "TemplatesMigrateResponse",
     "UpdateAgentToolRulesItem",
     "archival_memory",
@@ -88,7 +64,6 @@ __all__ = [
     "core_memory",
     "memory_variables",
     "messages",
-    "recall_memory",
     "sources",
     "templates",
     "tools",

{letta_client-0.1.15 → letta_client-0.1.17}/src/letta_client/agents/archival_memory/client.py

@@ -3,14 +3,13 @@
 import typing
 from ...core.client_wrapper import SyncClientWrapper
 from ...core.request_options import RequestOptions
-from ...types.archival_memory_summary import ArchivalMemorySummary
+from ...types.passage import Passage
 from ...core.jsonable_encoder import jsonable_encoder
 from ...core.unchecked_base_model import construct_type
 from ...errors.unprocessable_entity_error import UnprocessableEntityError
 from ...types.http_validation_error import HttpValidationError
 from json.decoder import JSONDecodeError
 from ...core.api_error import ApiError
-from ...types.passage import Passage
 from ...core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
@@ -21,64 +20,6 @@ class ArchivalMemoryClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
         self._client_wrapper = client_wrapper
 
-    def get_summary(
-        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> ArchivalMemorySummary:
-        """
-        Retrieve the summary of the archival memory of a specific agent.
-
-        Parameters
-        ----------
-        agent_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        ArchivalMemorySummary
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            token="YOUR_TOKEN",
-        )
-        client.agents.archival_memory.get_summary(
-            agent_id="agent_id",
-        )
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/memory/archival",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    ArchivalMemorySummary,
-                    construct_type(
-                        type_=ArchivalMemorySummary,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        HttpValidationError,
-                        construct_type(
-                            type_=HttpValidationError,  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
     def list(
         self,
         agent_id: str,
@@ -124,7 +65,7 @@ class ArchivalMemoryClient:
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/archival",
+            f"v1/agents/{jsonable_encoder(agent_id)}/archival_memory",
             method="GET",
             params={
                 "after": after,
@@ -191,7 +132,7 @@ class ArchivalMemoryClient:
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/archival",
+            f"v1/agents/{jsonable_encoder(agent_id)}/archival_memory",
             method="POST",
             json={
                 "text": text,
@@ -259,7 +200,7 @@ class ArchivalMemoryClient:
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/archival/{jsonable_encoder(memory_id)}",
+            f"v1/agents/{jsonable_encoder(agent_id)}/archival_memory/{jsonable_encoder(memory_id)}",
             method="DELETE",
             request_options=request_options,
         )
@@ -292,72 +233,6 @@ class AsyncArchivalMemoryClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
         self._client_wrapper = client_wrapper
 
-    async def get_summary(
-        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> ArchivalMemorySummary:
-        """
-        Retrieve the summary of the archival memory of a specific agent.
-
-        Parameters
-        ----------
-        agent_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        ArchivalMemorySummary
-            Successful Response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.agents.archival_memory.get_summary(
-                agent_id="agent_id",
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/memory/archival",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    ArchivalMemorySummary,
-                    construct_type(
-                        type_=ArchivalMemorySummary,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        HttpValidationError,
-                        construct_type(
-                            type_=HttpValidationError,  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
     async def list(
         self,
         agent_id: str,
@@ -411,7 +286,7 @@ class AsyncArchivalMemoryClient:
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/archival",
+            f"v1/agents/{jsonable_encoder(agent_id)}/archival_memory",
             method="GET",
             params={
                 "after": after,
@@ -486,7 +361,7 @@ class AsyncArchivalMemoryClient:
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/archival",
+            f"v1/agents/{jsonable_encoder(agent_id)}/archival_memory",
             method="POST",
             json={
                 "text": text,
@@ -562,7 +437,7 @@ class AsyncArchivalMemoryClient:
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/archival/{jsonable_encoder(memory_id)}",
+            f"v1/agents/{jsonable_encoder(agent_id)}/archival_memory/{jsonable_encoder(memory_id)}",
             method="DELETE",
             request_options=request_options,
         )

{letta_client-0.1.15 → letta_client-0.1.17}/src/letta_client/agents/client.py

@@ -6,7 +6,6 @@ from .context.client import ContextClient
 from .tools.client import ToolsClient
 from .sources.client import SourcesClient
 from .core_memory.client import CoreMemoryClient
-from .recall_memory.client import RecallMemoryClient
 from .archival_memory.client import ArchivalMemoryClient
 from .messages.client import MessagesClient
 from .templates.client import TemplatesClient
@@ -34,7 +33,6 @@ from .context.client import AsyncContextClient
 from .tools.client import AsyncToolsClient
 from .sources.client import AsyncSourcesClient
 from .core_memory.client import AsyncCoreMemoryClient
-from .recall_memory.client import AsyncRecallMemoryClient
 from .archival_memory.client import AsyncArchivalMemoryClient
 from .messages.client import AsyncMessagesClient
 from .templates.client import AsyncTemplatesClient
@@ -51,7 +49,6 @@ class AgentsClient:
         self.tools = ToolsClient(client_wrapper=self._client_wrapper)
         self.sources = SourcesClient(client_wrapper=self._client_wrapper)
         self.core_memory = CoreMemoryClient(client_wrapper=self._client_wrapper)
-        self.recall_memory = RecallMemoryClient(client_wrapper=self._client_wrapper)
         self.archival_memory = ArchivalMemoryClient(client_wrapper=self._client_wrapper)
         self.messages = MessagesClient(client_wrapper=self._client_wrapper)
         self.templates = TemplatesClient(client_wrapper=self._client_wrapper)
@@ -163,9 +160,10 @@ class AgentsClient:
         embedding_config: typing.Optional[EmbeddingConfig] = OMIT,
         initial_message_sequence: typing.Optional[typing.Sequence[MessageCreate]] = OMIT,
         include_base_tools: typing.Optional[bool] = OMIT,
+        include_multi_agent_tools: typing.Optional[bool] = OMIT,
         description: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
-        llm: typing.Optional[str] = OMIT,
+        model: typing.Optional[str] = OMIT,
         embedding: typing.Optional[str] = OMIT,
         context_window_limit: typing.Optional[int] = OMIT,
         embedding_chunk_size: typing.Optional[int] = OMIT,
@@ -173,7 +171,7 @@ class AgentsClient:
         template: typing.Optional[bool] = OMIT,
         project: typing.Optional[str] = OMIT,
         tool_exec_environment_variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,
-        variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,
+        memory_variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -221,7 +219,10 @@ class AgentsClient:
             The initial set of messages to put in the agent's in-context memory.
 
         include_base_tools : typing.Optional[bool]
-            The LLM configuration used by the agent.
+            If true, attaches the Letta core tools (e.g. archival_memory and core_memory related functions).
+
+        include_multi_agent_tools : typing.Optional[bool]
+            If true, attaches the Letta multi-agent tools (e.g. sending a message to another agent).
 
         description : typing.Optional[str]
             The description of the agent.
@@ -229,7 +230,7 @@ class AgentsClient:
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
             The metadata of the agent.
 
-        llm : typing.Optional[str]
+        model : typing.Optional[str]
             The LLM configuration handle used by the agent, specified in the format provider/model-name, as an alternative to specifying llm_config.
 
         embedding : typing.Optional[str]
@@ -253,7 +254,7 @@ class AgentsClient:
         tool_exec_environment_variables : typing.Optional[typing.Dict[str, typing.Optional[str]]]
             The environment variables for tool execution specific to this agent.
 
-        variables : typing.Optional[typing.Dict[str, typing.Optional[str]]]
+        memory_variables : typing.Optional[typing.Dict[str, typing.Optional[str]]]
             The variables that should be set for the agent.
 
         request_options : typing.Optional[RequestOptions]
@@ -301,9 +302,10 @@ class AgentsClient:
                     object_=initial_message_sequence, annotation=typing.Sequence[MessageCreate], direction="write"
                 ),
                 "include_base_tools": include_base_tools,
+                "include_multi_agent_tools": include_multi_agent_tools,
                 "description": description,
                 "metadata_": metadata,
-                "llm": llm,
+                "model": model,
                 "embedding": embedding,
                 "context_window_limit": context_window_limit,
                 "embedding_chunk_size": embedding_chunk_size,
@@ -311,7 +313,7 @@ class AgentsClient:
                 "template": template,
                 "project": project,
                 "tool_exec_environment_variables": tool_exec_environment_variables,
-                "variables": variables,
+                "memory_variables": memory_variables,
             },
             headers={
                 "content-type": "application/json",
@@ -477,7 +479,7 @@ class AgentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
-        Update an exsiting agent
+        Update an existing agent
 
         Parameters
         ----------
@@ -740,7 +742,6 @@ class AsyncAgentsClient:
         self.tools = AsyncToolsClient(client_wrapper=self._client_wrapper)
         self.sources = AsyncSourcesClient(client_wrapper=self._client_wrapper)
         self.core_memory = AsyncCoreMemoryClient(client_wrapper=self._client_wrapper)
-        self.recall_memory = AsyncRecallMemoryClient(client_wrapper=self._client_wrapper)
         self.archival_memory = AsyncArchivalMemoryClient(client_wrapper=self._client_wrapper)
         self.messages = AsyncMessagesClient(client_wrapper=self._client_wrapper)
         self.templates = AsyncTemplatesClient(client_wrapper=self._client_wrapper)
@@ -860,9 +861,10 @@ class AsyncAgentsClient:
         embedding_config: typing.Optional[EmbeddingConfig] = OMIT,
         initial_message_sequence: typing.Optional[typing.Sequence[MessageCreate]] = OMIT,
         include_base_tools: typing.Optional[bool] = OMIT,
+        include_multi_agent_tools: typing.Optional[bool] = OMIT,
         description: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
-        llm: typing.Optional[str] = OMIT,
+        model: typing.Optional[str] = OMIT,
         embedding: typing.Optional[str] = OMIT,
         context_window_limit: typing.Optional[int] = OMIT,
         embedding_chunk_size: typing.Optional[int] = OMIT,
@@ -870,7 +872,7 @@ class AsyncAgentsClient:
         template: typing.Optional[bool] = OMIT,
         project: typing.Optional[str] = OMIT,
         tool_exec_environment_variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,
-        variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,
+        memory_variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -918,7 +920,10 @@ class AsyncAgentsClient:
             The initial set of messages to put in the agent's in-context memory.
 
         include_base_tools : typing.Optional[bool]
-            The LLM configuration used by the agent.
+            If true, attaches the Letta core tools (e.g. archival_memory and core_memory related functions).
+
+        include_multi_agent_tools : typing.Optional[bool]
+            If true, attaches the Letta multi-agent tools (e.g. sending a message to another agent).
 
         description : typing.Optional[str]
             The description of the agent.
@@ -926,7 +931,7 @@ class AsyncAgentsClient:
         metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
             The metadata of the agent.
 
-        llm : typing.Optional[str]
+        model : typing.Optional[str]
             The LLM configuration handle used by the agent, specified in the format provider/model-name, as an alternative to specifying llm_config.
 
         embedding : typing.Optional[str]
@@ -950,7 +955,7 @@ class AsyncAgentsClient:
         tool_exec_environment_variables : typing.Optional[typing.Dict[str, typing.Optional[str]]]
             The environment variables for tool execution specific to this agent.
 
-        variables : typing.Optional[typing.Dict[str, typing.Optional[str]]]
+        memory_variables : typing.Optional[typing.Dict[str, typing.Optional[str]]]
             The variables that should be set for the agent.
 
         request_options : typing.Optional[RequestOptions]
@@ -1006,9 +1011,10 @@ class AsyncAgentsClient:
                     object_=initial_message_sequence, annotation=typing.Sequence[MessageCreate], direction="write"
                 ),
                 "include_base_tools": include_base_tools,
+                "include_multi_agent_tools": include_multi_agent_tools,
                 "description": description,
                 "metadata_": metadata,
-                "llm": llm,
+                "model": model,
                 "embedding": embedding,
                 "context_window_limit": context_window_limit,
                 "embedding_chunk_size": embedding_chunk_size,
@@ -1016,7 +1022,7 @@ class AsyncAgentsClient:
                 "template": template,
                 "project": project,
                 "tool_exec_environment_variables": tool_exec_environment_variables,
-                "variables": variables,
+                "memory_variables": memory_variables,
             },
             headers={
                 "content-type": "application/json",
@@ -1198,7 +1204,7 @@ class AsyncAgentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
-        Update an exsiting agent
+        Update an existing agent
 
         Parameters
         ----------