Platform for stateful agents: AI with advanced memory that can learn and self-improve over time.
feat: add pagination to folders endpoint (#2897)
cthomas6749dfb2d414
diff --git a/letta/server/rest_api/routers/v1/folders.py b/letta/server/rest_api/routers/v1/folders.pyindex 760b19304..9dc7dc13c 100644--- a/letta/server/rest_api/routers/v1/folders.py+++ b/letta/server/rest_api/routers/v1/folders.py@@ -3,7 +3,7 @@ import mimetypesimport osimport tempfilefrom pathlib import Path-from typing import List, Optional+from typing import List, Literal, Optionalfrom fastapi import APIRouter, Depends, Header, HTTPException, Query, UploadFilefrom starlette import status@@ -116,6 +116,17 @@ async def get_folders_metadata(@router.get("/", response_model=List[Folder], operation_id="list_folders")async def list_folders(+ before: Optional[str] = Query(+ None, description="Folder ID cursor for pagination. Returns folders that come before this folder ID in the specified sort order"+ ),+ after: Optional[str] = Query(+ None, description="Folder ID cursor for pagination. Returns folders that come after this folder ID in the specified sort order"+ ),+ limit: Optional[int] = Query(50, description="Maximum number of folders to return"),+ order: Literal["asc", "desc"] = Query(+ "asc", description="Sort order for folders by creation time. 'asc' for oldest first, 'desc' for newest first"+ ),+ order_by: Literal["created_at"] = Query("created_at", description="Field to sort by"),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):@@ -123,7 +134,7 @@ async def list_folders(List all data folders created by a user."""actor = await server.user_manager.get_actor_or_default_async(actor_id=actor_id)- return await server.source_manager.list_sources(actor=actor)+ return await server.source_manager.list_sources(actor=actor, before=before, after=after, limit=limit, ascending=(order == "asc"))@router.post("/", response_model=Folder, operation_id="create_folder")diff --git a/letta/services/source_manager.py b/letta/services/source_manager.pyindex 8f10baebf..64dc0743b 100644--- a/letta/services/source_manager.py+++ b/letta/services/source_manager.py@@ -230,14 +230,22 @@ class SourceManager:@enforce_types@trace_methodasync def list_sources(- self, actor: PydanticUser, after: Optional[str] = None, limit: Optional[int] = 50, **kwargs+ self,+ actor: PydanticUser,+ before: Optional[str] = None,+ after: Optional[str] = None,+ limit: Optional[int] = 50,+ ascending: bool = True,+ **kwargs,) -> List[PydanticSource]:"""List all sources with optional pagination."""async with db_registry.async_session() as session:sources = await SourceModel.list_async(db_session=session,+ before=before,after=after,limit=limit,+ ascending=ascending,organization_id=actor.organization_id,**kwargs,)