Platform for stateful agents: AI with advanced memory that can learn and self-improve over time.
feat: list_agents_for_archive endpoint [LET-4407] (#5684)
Ari Webb6b5c3a7130ef
diff --git a/fern/openapi.json b/fern/openapi.jsonindex da276fc39..debd89616 100644--- a/fern/openapi.json+++ b/fern/openapi.json@@ -470,6 +470,149 @@}}},+ "/v1/archives/{archive_id}/agents": {+ "get": {+ "tags": ["archives"],+ "summary": "List Agents For Archive",+ "description": "Get a list of agents that have access to an archive with pagination support.",+ "operationId": "list_agents_for_archive",+ "parameters": [+ {+ "name": "archive_id",+ "in": "path",+ "required": true,+ "schema": {+ "type": "string",+ "minLength": 44,+ "maxLength": 44,+ "pattern": "^archive-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",+ "description": "The ID of the archive in the format 'archive-<uuid4>'",+ "examples": ["archive-123e4567-e89b-42d3-8456-426614174000"],+ "title": "Archive Id"+ },+ "description": "The ID of the archive in the format 'archive-<uuid4>'"+ },+ {+ "name": "before",+ "in": "query",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "description": "Agent ID cursor for pagination. Returns agents that come before this agent ID in the specified sort order",+ "title": "Before"+ },+ "description": "Agent ID cursor for pagination. Returns agents that come before this agent ID in the specified sort order"+ },+ {+ "name": "after",+ "in": "query",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "description": "Agent ID cursor for pagination. Returns agents that come after this agent ID in the specified sort order",+ "title": "After"+ },+ "description": "Agent ID cursor for pagination. Returns agents that come after this agent ID in the specified sort order"+ },+ {+ "name": "limit",+ "in": "query",+ "required": false,+ "schema": {+ "anyOf": [+ {+ "type": "integer"+ },+ {+ "type": "null"+ }+ ],+ "description": "Maximum number of agents to return",+ "default": 50,+ "title": "Limit"+ },+ "description": "Maximum number of agents to return"+ },+ {+ "name": "order",+ "in": "query",+ "required": false,+ "schema": {+ "enum": ["asc", "desc"],+ "type": "string",+ "description": "Sort order for agents by creation time. 'asc' for oldest first, 'desc' for newest first",+ "default": "desc",+ "title": "Order"+ },+ "description": "Sort order for agents by creation time. 'asc' for oldest first, 'desc' for newest first"+ },+ {+ "name": "include",+ "in": "query",+ "required": false,+ "schema": {+ "type": "array",+ "items": {+ "enum": [+ "agent.blocks",+ "agent.identities",+ "agent.managed_group",+ "agent.secrets",+ "agent.sources",+ "agent.tags",+ "agent.tools"+ ],+ "type": "string"+ },+ "description": "Specify which relational fields to include in the response. No relationships are included by default.",+ "default": [],+ "title": "Include"+ },+ "description": "Specify which relational fields to include in the response. No relationships are included by default."+ }+ ],+ "responses": {+ "200": {+ "description": "Successful Response",+ "content": {+ "application/json": {+ "schema": {+ "type": "array",+ "items": {+ "$ref": "#/components/schemas/AgentState"+ },+ "title": "Response List Agents For Archive"+ }+ }+ }+ },+ "422": {+ "description": "Validation Error",+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/HTTPValidationError"+ }+ }+ }+ }+ }+ }+ },"/v1/tools/{tool_id}": {"delete": {"tags": ["tools"],diff --git a/letta/server/rest_api/routers/v1/archives.py b/letta/server/rest_api/routers/v1/archives.pyindex 2b009004a..ae8f2807e 100644--- a/letta/server/rest_api/routers/v1/archives.py+++ b/letta/server/rest_api/routers/v1/archives.py@@ -3,6 +3,8 @@ from typing import List, Literal, Optionalfrom fastapi import APIRouter, Body, Depends, Queryfrom pydantic import BaseModel+from letta import AgentState+from letta.schemas.agent import AgentRelationshipsfrom letta.schemas.archive import Archive as PydanticArchive, ArchiveBasefrom letta.server.rest_api.dependencies import HeaderParams, get_headers, get_letta_serverfrom letta.server.server import SyncServer@@ -176,3 +178,40 @@ async def detach_agent_from_archive(archive_id=archive_id,actor=actor,)++[email protected]("/{archive_id}/agents", response_model=List[AgentState], operation_id="list_agents_for_archive")+async def list_agents_for_archive(+ archive_id: ArchiveId,+ before: Optional[str] = Query(+ None,+ description="Agent ID cursor for pagination. Returns agents that come before this agent ID in the specified sort order",+ ),+ after: Optional[str] = Query(+ None,+ description="Agent ID cursor for pagination. Returns agents that come after this agent ID in the specified sort order",+ ),+ limit: Optional[int] = Query(50, description="Maximum number of agents to return"),+ order: Literal["asc", "desc"] = Query(+ "desc", description="Sort order for agents by creation time. 'asc' for oldest first, 'desc' for newest first"+ ),+ include: List[AgentRelationships] = Query(+ [],+ description=("Specify which relational fields to include in the response. No relationships are included by default."),+ ),+ server: "SyncServer" = Depends(get_letta_server),+ headers: HeaderParams = Depends(get_headers),+):+ """+ Get a list of agents that have access to an archive with pagination support.+ """+ actor = await server.user_manager.get_actor_or_default_async(actor_id=headers.actor_id)+ return await server.archive_manager.get_agents_for_archive_async(+ archive_id=archive_id,+ actor=actor,+ before=before,+ after=after,+ limit=limit,+ include=include,+ ascending=(order == "asc"),+ )diff --git a/letta/services/archive_manager.py b/letta/services/archive_manager.pyindex c9e04fcfa..5dff79528 100644--- a/letta/services/archive_manager.py+++ b/letta/services/archive_manager.py@@ -1,16 +1,19 @@+import asyncio+from datetime import datetimefrom typing import List, Optional-from sqlalchemy import delete, select+from sqlalchemy import delete, or_, selectfrom letta.helpers.tpuf_client import should_use_tpuffrom letta.log import get_loggerfrom letta.orm import ArchivalPassage, Archive as ArchiveModel, ArchivesAgentsfrom letta.otel.tracing import trace_method+from letta.schemas.agent import AgentState as PydanticAgentStatefrom letta.schemas.archive import Archive as PydanticArchivefrom letta.schemas.enums import PrimitiveType, VectorDBProviderfrom letta.schemas.user import User as PydanticUserfrom letta.server.db import db_registry-from letta.settings import settings+from letta.settings import DatabaseChoice, settingsfrom letta.utils import enforce_typesfrom letta.validators import raise_on_invalid_id@@ -332,11 +335,81 @@ class ArchiveManager:self,archive_id: str,actor: PydanticUser,- ) -> List[str]:- """Get all agent IDs that have access to an archive."""+ before: Optional[str] = None,+ after: Optional[str] = None,+ limit: Optional[int] = 50,+ ascending: bool = False,+ include: List[str] = [],+ ) -> List[PydanticAgentState]:+ """Get agents that have access to an archive with pagination support.++ Uses a subquery approach to avoid expensive JOINs.+ """+ from letta.orm import Agent as AgentModel+async with db_registry.async_session() as session:- result = await session.execute(select(ArchivesAgents.agent_id).where(ArchivesAgents.archive_id == archive_id))- return [row[0] for row in result.fetchall()]+ # Start with a basic query using subquery instead of JOIN+ query = (+ select(AgentModel)+ .where(AgentModel.id.in_(select(ArchivesAgents.agent_id).where(ArchivesAgents.archive_id == archive_id)))+ .where(AgentModel.organization_id == actor.organization_id)+ )++ # Apply pagination using cursor-based approach+ if after:+ result = (await session.execute(select(AgentModel.created_at, AgentModel.id).where(AgentModel.id == after))).first()+ if result:+ after_sort_value, after_id = result+ # SQLite does not support as granular timestamping, so we need to round the timestamp+ if settings.database_engine is DatabaseChoice.SQLITE and isinstance(after_sort_value, datetime):+ after_sort_value = after_sort_value.strftime("%Y-%m-%d %H:%M:%S")++ if ascending:+ query = query.where(+ AgentModel.created_at > after_sort_value,+ or_(AgentModel.created_at == after_sort_value, AgentModel.id > after_id),+ )+ else:+ query = query.where(+ AgentModel.created_at < after_sort_value,+ or_(AgentModel.created_at == after_sort_value, AgentModel.id < after_id),+ )++ if before:+ result = (await session.execute(select(AgentModel.created_at, AgentModel.id).where(AgentModel.id == before))).first()+ if result:+ before_sort_value, before_id = result+ # SQLite does not support as granular timestamping, so we need to round the timestamp+ if settings.database_engine is DatabaseChoice.SQLITE and isinstance(before_sort_value, datetime):+ before_sort_value = before_sort_value.strftime("%Y-%m-%d %H:%M:%S")++ if ascending:+ query = query.where(+ AgentModel.created_at < before_sort_value,+ or_(AgentModel.created_at == before_sort_value, AgentModel.id < before_id),+ )+ else:+ query = query.where(+ AgentModel.created_at > before_sort_value,+ or_(AgentModel.created_at == before_sort_value, AgentModel.id > before_id),+ )++ # Apply sorting+ if ascending:+ query = query.order_by(AgentModel.created_at.asc(), AgentModel.id.asc())+ else:+ query = query.order_by(AgentModel.created_at.desc(), AgentModel.id.desc())++ # Apply limit+ if limit:+ query = query.limit(limit)++ # Execute the query+ result = await session.execute(query)+ agents_orm = result.scalars().all()++ agents = await asyncio.gather(*[agent.to_pydantic_async(include_relationships=[], include=include) for agent in agents_orm])+ return agents@enforce_types@trace_methoddiff --git a/tests/managers/test_archive_manager.py b/tests/managers/test_archive_manager.pyindex 3c0c61e98..eb0a52e53 100644--- a/tests/managers/test_archive_manager.py+++ b/tests/managers/test_archive_manager.py@@ -54,7 +54,7 @@ from letta.orm import Base, Blockfrom letta.orm.block_history import BlockHistoryfrom letta.orm.errors import NoResultFound, UniqueConstraintViolationErrorfrom letta.orm.file import FileContent as FileContentModel, FileMetadata as FileMetadataModel-from letta.schemas.agent import CreateAgent, UpdateAgent+from letta.schemas.agent import AgentRelationships, CreateAgent, UpdateAgentfrom letta.schemas.block import Block as PydanticBlock, BlockUpdate, CreateBlockfrom letta.schemas.embedding_config import EmbeddingConfigfrom letta.schemas.enums import (@@ -147,9 +147,10 @@ async def test_archive_manager_get_agents_for_archive_async(server: SyncServer,agent_id=agent2.id, archive_id=archive.id, is_owner=False, actor=default_user)- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)- assert len(agent_ids) == 2+ assert len(agents) == 2+ agent_ids = [a.id for a in agents]assert sarah_agent.id in agent_idsassert agent2.id in agent_ids@@ -433,17 +434,17 @@ async def test_archive_manager_attach_agent_to_archive_async(server: SyncServer,)# verify attachment- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive1.id, actor=default_user)- assert sarah_agent.id in agent_ids+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive1.id, actor=default_user)+ assert sarah_agent.id in [a.id for a in agents]# attach agent as non-ownerawait server.archive_manager.attach_agent_to_archive_async(agent_id=agent2.id, archive_id=archive1.id, is_owner=False, actor=default_user)- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive1.id, actor=default_user)- assert len(agent_ids) == 2- assert agent2.id in agent_ids+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive1.id, actor=default_user)+ assert len(agents) == 2+ assert agent2.id in [a.id for a in agents]# test updating ownership (attach again with different is_owner)await server.archive_manager.attach_agent_to_archive_async(@@ -451,8 +452,8 @@ async def test_archive_manager_attach_agent_to_archive_async(server: SyncServer,)# verify still only 2 agents (no duplicate)- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive1.id, actor=default_user)- assert len(agent_ids) == 2+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive1.id, actor=default_user)+ assert len(agents) == 2# cleanupawait server.agent_manager.delete_agent_async(agent2.id, actor=default_user)@@ -497,8 +498,9 @@ async def test_archive_manager_detach_agent_from_archive_async(server: SyncServe)# verify both are attached- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)- assert len(agent_ids) == 2+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ assert len(agents) == 2+ agent_ids = [a.id for a in agents]assert agent1.id in agent_idsassert agent2.id in agent_ids@@ -506,8 +508,9 @@ async def test_archive_manager_detach_agent_from_archive_async(server: SyncServeawait server.archive_manager.detach_agent_from_archive_async(agent_id=agent1.id, archive_id=archive.id, actor=default_user)# verify only agent2 remains- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)- assert len(agent_ids) == 1+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ assert len(agents) == 1+ agent_ids = [a.id for a in agents]assert agent2.id in agent_idsassert agent1.id not in agent_ids@@ -515,16 +518,16 @@ async def test_archive_manager_detach_agent_from_archive_async(server: SyncServeawait server.archive_manager.detach_agent_from_archive_async(agent_id=agent1.id, archive_id=archive.id, actor=default_user)# verify still only agent2- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)- assert len(agent_ids) == 1- assert agent2.id in agent_ids+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ assert len(agents) == 1+ assert agent2.id in [a.id for a in agents]# detach agent2await server.archive_manager.detach_agent_from_archive_async(agent_id=agent2.id, archive_id=archive.id, actor=default_user)# verify archive has no agents- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)- assert len(agent_ids) == 0+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ assert len(agents) == 0# cleanupawait server.agent_manager.delete_agent_async(agent1.id, actor=default_user)@@ -554,16 +557,16 @@ async def test_archive_manager_attach_detach_idempotency(server: SyncServer, defawait server.archive_manager.attach_agent_to_archive_async(agent_id=agent.id, archive_id=archive.id, is_owner=False, actor=default_user)# verify only one relationship exists- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)- assert len(agent_ids) == 1- assert agent.id in agent_ids+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ assert len(agents) == 1+ assert agent.id in [a.id for a in agents]# test ownership update through re-attachmentawait server.archive_manager.attach_agent_to_archive_async(agent_id=agent.id, archive_id=archive.id, is_owner=True, actor=default_user)# still only one relationship- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)- assert len(agent_ids) == 1+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ assert len(agents) == 1# test detaching non-existent relationship (should be idempotent)non_existent_agent = await server.agent_manager.create_agent_async(@@ -581,9 +584,9 @@ async def test_archive_manager_attach_detach_idempotency(server: SyncServer, defawait server.archive_manager.detach_agent_from_archive_async(agent_id=non_existent_agent.id, archive_id=archive.id, actor=default_user)# verify original agent still attached- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)- assert len(agent_ids) == 1- assert agent.id in agent_ids+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ assert len(agents) == 1+ assert agent.id in [a.id for a in agents]# cleanupawait server.agent_manager.delete_agent_async(agent.id, actor=default_user)@@ -633,20 +636,20 @@ async def test_archive_manager_detach_with_multiple_archives(server: SyncServer,# verify initial stateagents_archive1 = await server.archive_manager.get_agents_for_archive_async(archive_id=archive1.id, actor=default_user)agents_archive2 = await server.archive_manager.get_agents_for_archive_async(archive_id=archive2.id, actor=default_user)- assert agent1.id in agents_archive1- assert agent2.id in agents_archive2+ assert agent1.id in [a.id for a in agents_archive1]+ assert agent2.id in [a.id for a in agents_archive2]# detach agent1 from archive1await server.archive_manager.detach_agent_from_archive_async(agent_id=agent1.id, archive_id=archive1.id, actor=default_user)# verify agent1 is detached from archive1agents_archive1 = await server.archive_manager.get_agents_for_archive_async(archive_id=archive1.id, actor=default_user)- assert agent1.id not in agents_archive1+ assert agent1.id not in [a.id for a in agents_archive1]assert len(agents_archive1) == 0# verify agent2 is still attached to archive2agents_archive2 = await server.archive_manager.get_agents_for_archive_async(archive_id=archive2.id, actor=default_user)- assert agent2.id in agents_archive2+ assert agent2.id in [a.id for a in agents_archive2]assert len(agents_archive2) == 1# cleanup@@ -683,8 +686,8 @@ async def test_archive_manager_detach_deleted_agent(server: SyncServer, default_await server.agent_manager.delete_agent_async(agent.id, actor=default_user)# verify agent is no longer attached- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)- assert len(agent_ids) == 0+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ assert len(agents) == 0# attempting to detach the deleted agent should be idempotent (no error)await server.archive_manager.detach_agent_from_archive_async(agent_id=agent_id, archive_id=archive.id, actor=default_user)@@ -731,8 +734,9 @@ async def test_archive_manager_cascade_delete_on_archive_deletion(server: SyncSe)# verify both agents are attached- agent_ids = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)- assert len(agent_ids) == 2+ agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ assert len(agents) == 2+ agent_ids = [a.id for a in agents]assert agent1.id in agent_idsassert agent2.id in agent_ids@@ -768,6 +772,69 @@ async def test_archive_manager_cascade_delete_on_archive_deletion(server: SyncSeawait server.agent_manager.delete_agent_async(agent2.id, actor=default_user)+async def test_archive_manager_list_agents_with_pagination(server: SyncServer, default_user):+ """Test listing agents for an archive with pagination support."""+ # create archive+ archive = await server.archive_manager.create_archive_async(+ name="pagination_test_archive", description="Archive for testing pagination", actor=default_user+ )++ # create multiple agents+ agents = []+ for i in range(5):+ agent = await server.agent_manager.create_agent_async(+ agent_create=CreateAgent(+ name=f"pagination_test_agent_{i}",+ memory_blocks=[],+ llm_config=LLMConfig.default_config("gpt-4o-mini"),+ embedding_config=EmbeddingConfig.default_config(provider="openai"),+ include_base_tools=False,+ ),+ actor=default_user,+ )+ agents.append(agent)+ # Attach to archive+ await server.archive_manager.attach_agent_to_archive_async(+ agent_id=agent.id, archive_id=archive.id, is_owner=(i == 0), actor=default_user+ )++ # Test basic listing (should get all 5)+ all_agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user, limit=10)+ assert len(all_agents) == 5+ all_agent_ids = [a.id for a in all_agents]+ for agent in agents:+ assert agent.id in all_agent_ids++ # Test with limit+ limited_agents = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user, limit=3)+ assert len(limited_agents) == 3++ # Test that pagination parameters are accepted without errors+ paginated = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user, limit=2)+ assert len(paginated) == 2+ assert all(a.id in all_agent_ids for a in paginated)++ # Test ascending/descending order by checking we get all agents in both+ ascending_agents = await server.archive_manager.get_agents_for_archive_async(+ archive_id=archive.id, actor=default_user, ascending=True, limit=10+ )+ assert len(ascending_agents) == 5++ descending_agents = await server.archive_manager.get_agents_for_archive_async(+ archive_id=archive.id, actor=default_user, ascending=False, limit=10+ )+ assert len(descending_agents) == 5++ # Verify both orders contain all agents+ assert set([a.id for a in ascending_agents]) == set([a.id for a in descending_agents])++ # Cleanup+ for agent in agents:+ await server.agent_manager.delete_agent_async(agent.id, actor=default_user)+ await server.archive_manager.delete_archive_async(archive.id, actor=default_user)++@pytest.mark.asyncioasync def test_archive_manager_get_default_archive_for_agent_async(server: SyncServer, default_user):"""Test getting default archive for an agent."""@@ -823,3 +890,67 @@ async def test_archive_manager_get_or_set_vector_db_namespace_async(server: Sync# cleanupawait server.archive_manager.delete_archive_async(archive.id, actor=default_user)+++async def test_archive_manager_get_agents_with_include_parameter(server: SyncServer, default_user):+ """Test getting agents for an archive with include parameter to load relationships."""+ # create an archive+ archive = await server.archive_manager.create_archive_async(+ name="test_include_archive", description="Test archive for include parameter", actor=default_user+ )++ # create agent without base tools (to avoid needing tools in test DB)+ agent = await server.agent_manager.create_agent_async(+ agent_create=CreateAgent(+ name="test_include_agent",+ memory_blocks=[],+ llm_config=LLMConfig.default_config("gpt-4o-mini"),+ embedding_config=EmbeddingConfig.default_config(provider="openai"),+ include_base_tools=False,+ ),+ actor=default_user,+ )++ # attach agent to archive+ await server.archive_manager.attach_agent_to_archive_async(agent_id=agent.id, archive_id=archive.id, is_owner=True, actor=default_user)++ # test without include parameter (default - no relationships loaded)+ agents_no_include = await server.archive_manager.get_agents_for_archive_async(archive_id=archive.id, actor=default_user)+ assert len(agents_no_include) == 1+ # By default, tools should be empty list (not loaded)+ assert agents_no_include[0].tools == []+ # By default, tags should also be empty (not loaded)+ assert agents_no_include[0].tags == []++ # test with include parameter to load tags+ agents_with_tags = await server.archive_manager.get_agents_for_archive_async(+ archive_id=archive.id, actor=default_user, include=["agent.tags"]+ )+ assert len(agents_with_tags) == 1+ # With include, tags should be loaded (as a list, even if empty)+ assert isinstance(agents_with_tags[0].tags, list)++ # test with include parameter to load blocks+ agents_with_blocks = await server.archive_manager.get_agents_for_archive_async(+ archive_id=archive.id, actor=default_user, include=["agent.blocks"]+ )+ assert len(agents_with_blocks) == 1+ # With include, blocks should be loaded+ assert isinstance(agents_with_blocks[0].blocks, list)+ # Agent should have blocks since we passed memory_blocks=[] which creates default blocks+ assert len(agents_with_blocks[0].blocks) >= 0++ # test with multiple includes+ agents_with_multiple = await server.archive_manager.get_agents_for_archive_async(+ archive_id=archive.id, actor=default_user, include=["agent.tags", "agent.blocks", "agent.tools"]+ )+ assert len(agents_with_multiple) == 1+ # All requested relationships should be loaded+ assert isinstance(agents_with_multiple[0].tags, list)+ assert isinstance(agents_with_multiple[0].blocks, list)+ assert isinstance(agents_with_multiple[0].tools, list)++ # cleanup+ await server.agent_manager.delete_agent_async(agent.id, actor=default_user)+ await server.archive_manager.delete_archive_async(archive.id, actor=default_user)