Platform for stateful agents: AI with advanced memory that can learn and self-improve over time.
feat: memory blocks viewer (#3610)
Shubham Naik6b38262b6012
diff --git a/letta/server/rest_api/routers/v1/blocks.py b/letta/server/rest_api/routers/v1/blocks.pyindex 0320b8321..39d57d0ff 100644--- a/letta/server/rest_api/routers/v1/blocks.py+++ b/letta/server/rest_api/routers/v1/blocks.py@@ -24,6 +24,50 @@ async def list_blocks(identifier_keys: Optional[List[str]] = Query(None, description="Search agents by identifier keys"),project_id: Optional[str] = Query(None, description="Search blocks by project id"),limit: Optional[int] = Query(50, description="Number of blocks to return"),+ before: Optional[str] = Query(+ None,+ description="Cursor for pagination. If provided, returns blocks before this cursor.",+ ),+ after: Optional[str] = Query(+ None,+ description="Cursor for pagination. If provided, returns blocks after this cursor.",+ ),+ label_search: Optional[str] = Query(+ None,+ description=("Search blocks by label. If provided, returns blocks that match this label. " "This is a full-text search on labels."),+ ),+ description_search: Optional[str] = Query(+ None,+ description=(+ "Search blocks by description. If provided, returns blocks that match this description. "+ "This is a full-text search on block descriptions."+ ),+ ),+ value_search: Optional[str] = Query(+ None,+ description=("Search blocks by value. If provided, returns blocks that match this value."),+ ),+ connected_to_agents_count_gt: Optional[int] = Query(+ None,+ description=(+ "Filter blocks by the number of connected agents. "+ "If provided, returns blocks that have more than this number of connected agents."+ ),+ ),+ connected_to_agents_count_lt: Optional[int] = Query(+ None,+ description=(+ "Filter blocks by the number of connected agents. "+ "If provided, returns blocks that have less than this number of connected agents."+ ),+ ),+ connected_to_agents_count_eq: Optional[List[int]] = Query(+ None,+ description=(+ "Filter blocks by the exact number of connected agents. "+ "If provided, returns blocks that have exactly this number of connected agents."+ ),+ ),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):@@ -32,11 +76,19 @@ async def list_blocks(actor=actor,label=label,is_template=templates_only,+ value_search=value_search,+ label_search=label_search,+ description_search=description_search,template_name=name,identity_id=identity_id,identifier_keys=identifier_keys,project_id=project_id,+ before=before,+ connected_to_agents_count_gt=connected_to_agents_count_gt,+ connected_to_agents_count_lt=connected_to_agents_count_lt,+ connected_to_agents_count_eq=connected_to_agents_count_eq,limit=limit,+ after=after,)diff --git a/letta/services/block_manager.py b/letta/services/block_manager.pyindex c0799026c..678e3f57b 100644--- a/letta/services/block_manager.py+++ b/letta/services/block_manager.py@@ -2,7 +2,7 @@ import asynciofrom datetime import datetimefrom typing import Dict, List, Optional-from sqlalchemy import delete, or_, select+from sqlalchemy import and_, delete, func, or_, selectfrom sqlalchemy.orm import Sessionfrom letta.log import get_logger@@ -182,6 +182,12 @@ class BlockManager:before: Optional[str] = None,after: Optional[str] = None,limit: Optional[int] = 50,+ label_search: Optional[str] = None,+ description_search: Optional[str] = None,+ value_search: Optional[str] = None,+ connected_to_agents_count_gt: Optional[int] = None,+ connected_to_agents_count_lt: Optional[int] = None,+ connected_to_agents_count_eq: Optional[List[int]] = None,ascending: bool = True,) -> List[PydanticBlock]:"""Async version of get_blocks method. Retrieve blocks based on various optional filters."""@@ -214,8 +220,64 @@ class BlockManager:if project_id:query = query.where(BlockModel.project_id == project_id)+ if label_search and not label:+ query = query.where(BlockModel.label.ilike(f"%{label_search}%"))++ if description_search:+ query = query.where(BlockModel.description.ilike(f"%{description_search}%"))++ if value_search:+ query = query.where(BlockModel.value.ilike(f"%{value_search}%"))+needs_distinct = False+ needs_agent_count_join = any(+ condition is not None+ for condition in [connected_to_agents_count_gt, connected_to_agents_count_lt, connected_to_agents_count_eq]+ )++ # If any agent count filters are specified, create a single subquery and apply all filters+ if needs_agent_count_join:+ # Create a subquery to count agents per block+ agent_count_subquery = (+ select(BlocksAgents.block_id, func.count(BlocksAgents.agent_id).label("agent_count"))+ .group_by(BlocksAgents.block_id)+ .subquery()+ )++ # Determine if we need a left join (for cases involving 0 counts)+ needs_left_join = (connected_to_agents_count_lt is not None) or (+ connected_to_agents_count_eq is not None and 0 in connected_to_agents_count_eq+ )++ if needs_left_join:+ # Left join to include blocks with no agents+ query = query.outerjoin(agent_count_subquery, BlockModel.id == agent_count_subquery.c.block_id)+ # Use coalesce to treat NULL as 0 for blocks with no agents+ agent_count_expr = func.coalesce(agent_count_subquery.c.agent_count, 0)+ else:+ # Inner join since we don't need blocks with no agents+ query = query.join(agent_count_subquery, BlockModel.id == agent_count_subquery.c.block_id)+ agent_count_expr = agent_count_subquery.c.agent_count++ # Build the combined filter conditions+ conditions = []++ if connected_to_agents_count_gt is not None:+ conditions.append(agent_count_expr > connected_to_agents_count_gt)++ if connected_to_agents_count_lt is not None:+ conditions.append(agent_count_expr < connected_to_agents_count_lt)++ if connected_to_agents_count_eq is not None:+ conditions.append(agent_count_expr.in_(connected_to_agents_count_eq))++ # Apply all conditions with AND logic+ if conditions:+ query = query.where(and_(*conditions))++ needs_distinct = True+if identifier_keys:query = query.join(BlockModel.identities).filter(BlockModel.identities.property.mapper.class_.identifier_key.in_(identifier_keys)