Platform for stateful agents: AI with advanced memory that can learn and self-improve over time.
feat: add patch archival memory route and fix naming (#1155)
cthomasf6b87a7d7652
diff --git a/letta/agent.py b/letta/agent.pyindex d2f0aafa1..a49cbe366 100644--- a/letta/agent.py+++ b/letta/agent.py@@ -61,15 +61,7 @@ from letta.settings import summarizer_settingsfrom letta.streaming_interface import StreamingRefreshCLIInterfacefrom letta.system import get_heartbeat, get_token_limit_warning, package_function_response, package_summarize_message, package_user_messagefrom letta.tracing import trace_method-from letta.utils import (- count_tokens,- get_friendly_error_msg,- get_tool_call_id,- log_telemetry,- parse_json,- printd,- validate_function_response,-)+from letta.utils import count_tokens, get_friendly_error_msg, get_tool_call_id, log_telemetry, parse_json, validate_function_responselogger = get_logger(__name__)diff --git a/letta/server/rest_api/routers/v1/agents.py b/letta/server/rest_api/routers/v1/agents.pyindex 4313c0c9b..a5b8c324a 100644--- a/letta/server/rest_api/routers/v1/agents.py+++ b/letta/server/rest_api/routers/v1/agents.py@@ -17,7 +17,7 @@ from letta.schemas.letta_request import LettaRequest, LettaStreamingRequestfrom letta.schemas.letta_response import LettaResponsefrom letta.schemas.memory import ContextWindowOverview, CreateArchivalMemory, Memoryfrom letta.schemas.message import Message, MessageUpdate-from letta.schemas.passage import Passage+from letta.schemas.passage import Passage, PassageUpdatefrom letta.schemas.run import Runfrom letta.schemas.source import Sourcefrom letta.schemas.tool import Tool@@ -273,14 +273,14 @@ def retrieve_agent_memory(@router.get("/{agent_id}/core-memory/blocks/{block_label}", response_model=Block, operation_id="retrieve_core_memory_block")-def retrieve_core_memory_block(+def retrieve_block(agent_id: str,block_label: str,server: "SyncServer" = Depends(get_letta_server),actor_id: Optional[str] = Header(None, alias="user_id"), # Extract user_id from header, default to None if not present):"""- Retrieve a memory block from an agent.+ Retrieve a core memory block from an agent."""actor = server.user_manager.get_user_or_default(user_id=actor_id)@@ -291,13 +291,13 @@ def retrieve_core_memory_block(@router.get("/{agent_id}/core-memory/blocks", response_model=List[Block], operation_id="list_core_memory_blocks")-def list_core_memory_blocks(+def list_blocks(agent_id: str,server: "SyncServer" = Depends(get_letta_server),actor_id: Optional[str] = Header(None, alias="user_id"), # Extract user_id from header, default to None if not present):"""- Retrieve the memory blocks of a specific agent.+ Retrieve the core memory blocks of a specific agent."""actor = server.user_manager.get_user_or_default(user_id=actor_id)try:@@ -308,7 +308,7 @@ def list_core_memory_blocks(@router.patch("/{agent_id}/core-memory/blocks/{block_label}", response_model=Block, operation_id="modify_core_memory_block")-def modify_core_memory_block(+def modify_block(agent_id: str,block_label: str,block_update: BlockUpdate = Body(...),@@ -316,7 +316,7 @@ def modify_core_memory_block(actor_id: Optional[str] = Header(None, alias="user_id"), # Extract user_id from header, default to None if not present):"""- Updates a memory block of an agent.+ Updates a core memory block of an agent."""actor = server.user_manager.get_user_or_default(user_id=actor_id)@@ -330,35 +330,35 @@ def modify_core_memory_block(@router.patch("/{agent_id}/core-memory/blocks/attach/{block_id}", response_model=AgentState, operation_id="attach_core_memory_block")-def attach_core_memory_block(+def attach_block(agent_id: str,block_id: str,server: "SyncServer" = Depends(get_letta_server),actor_id: Optional[str] = Header(None, alias="user_id"),):"""- Attach a block to an agent.+ Attach a core memoryblock to an agent."""actor = server.user_manager.get_user_or_default(user_id=actor_id)return server.agent_manager.attach_block(agent_id=agent_id, block_id=block_id, actor=actor)@router.patch("/{agent_id}/core-memory/blocks/detach/{block_id}", response_model=AgentState, operation_id="detach_core_memory_block")-def detach_core_memory_block(+def detach_block(agent_id: str,block_id: str,server: "SyncServer" = Depends(get_letta_server),actor_id: Optional[str] = Header(None, alias="user_id"),):"""- Detach a block from an agent.+ Detach a core memory block from an agent."""actor = server.user_manager.get_user_or_default(user_id=actor_id)return server.agent_manager.detach_block(agent_id=agent_id, block_id=block_id, actor=actor)[email protected]("/{agent_id}/archival-memory", response_model=List[Passage], operation_id="list_archival_memory")-def list_archival_memory([email protected]("/{agent_id}/archival-memory", response_model=List[Passage], operation_id="list_passages")+def list_passages(agent_id: str,server: "SyncServer" = Depends(get_letta_server),after: Optional[int] = Query(None, description="Unique ID of the memory to start the query range at."),@@ -380,8 +380,8 @@ def list_archival_memory()[email protected]("/{agent_id}/archival-memory", response_model=List[Passage], operation_id="create_archival_memory")-def create_archival_memory([email protected]("/{agent_id}/archival-memory", response_model=List[Passage], operation_id="create_passage")+def create_passage(agent_id: str,request: CreateArchivalMemory = Body(...),server: "SyncServer" = Depends(get_letta_server),@@ -395,10 +395,25 @@ def create_archival_memory(return server.insert_archival_memory(agent_id=agent_id, memory_contents=request.text, actor=actor)[email protected]("/{agent_id}/archival-memory/{memory_id}", response_model=List[Passage], operation_id="modify_passage")+def modify_passage(+ agent_id: str,+ memory_id: str,+ passage: PassageUpdate = Body(...),+ server: "SyncServer" = Depends(get_letta_server),+ actor_id: Optional[str] = Header(None, alias="user_id"), # Extract user_id from header, default to None if not present+):+ """+ Modify a memory in the agent's archival memory store.+ """+ actor = server.user_manager.get_user_or_default(user_id=actor_id)+ return server.modify_archival_memory(agent_id=agent_id, memory_id=memory_id, passage=passage, actor=actor)++# TODO(ethan): query or path parameter for memory_id?# @router.delete("/{agent_id}/archival")[email protected]("/{agent_id}/archival-memory/{memory_id}", response_model=None, operation_id="delete_archival_memory")-def delete_archival_memory([email protected]("/{agent_id}/archival-memory/{memory_id}", response_model=None, operation_id="delete_passage")+def delete_passage(agent_id: str,memory_id: str,# memory_id: str = Query(..., description="Unique ID of the memory to be deleted."),diff --git a/letta/server/server.py b/letta/server/server.pyindex 4383e8b22..2fe0b5d5c 100644--- a/letta/server/server.py+++ b/letta/server/server.py@@ -43,7 +43,7 @@ from letta.schemas.llm_config import LLMConfigfrom letta.schemas.memory import ArchivalMemorySummary, ContextWindowOverview, Memory, RecallMemorySummaryfrom letta.schemas.message import Message, MessageCreate, MessageRole, MessageUpdate, TextContentfrom letta.schemas.organization import Organization-from letta.schemas.passage import Passage+from letta.schemas.passage import Passage, PassageUpdatefrom letta.schemas.providers import (AnthropicBedrockProvider,AnthropicProvider,@@ -770,6 +770,11 @@ class SyncServer(Server):return passages+ def modify_archival_memory(self, agent_id: str, memory_id: str, passage: PassageUpdate, actor: User) -> List[Passage]:+ passage = Passage(**passage.model_dump(exclude_unset=True, exclude_none=True))+ passages = self.passage_manager.update_passage_by_id(passage_id=memory_id, passage=passage, actor=actor)+ return passages+def delete_archival_memory(self, memory_id: str, actor: User):# TODO check if it exists first, and throw error if not# TODO: @mindy make this return the deleted passage instead