Skip to content

armgit / letta

Public Imported from GitHub
0

Platform for stateful agents: AI with advanced memory that can learn and self-improve over time.

feat: add pagination to agent messages endpoint (#5088)

cthomascb5e89cfa2ca
diff --git a/fern/openapi.json b/fern/openapi.json
index e7b4f0962..046276690 100644
--- a/fern/openapi.json
+++ b/fern/openapi.json
@@ -5604,7 +5604,7 @@
}
},
{
- "name": "after",
+ "name": "before",
"in": "query",
"required": false,
"schema": {
@@ -5616,13 +5616,13 @@
"type": "null"
}
],
- "description": "Message after which to retrieve the returned messages.",
- "title": "After"
+ "description": "Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order",
+ "title": "Before"
},
- "description": "Message after which to retrieve the returned messages."
+ "description": "Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order"
},
{
- "name": "before",
+ "name": "after",
"in": "query",
"required": false,
"schema": {
@@ -5634,22 +5634,55 @@
"type": "null"
}
],
- "description": "Message before which to retrieve the returned messages.",
- "title": "Before"
+ "description": "Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order",
+ "title": "After"
},
- "description": "Message before which to retrieve the returned messages."
+ "description": "Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order"
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
- "type": "integer",
- "description": "Maximum number of messages to retrieve.",
- "default": 10,
+ "anyOf": [
+ {
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Maximum number of messages to return",
+ "default": 100,
"title": "Limit"
},
- "description": "Maximum number of messages to retrieve."
+ "description": "Maximum number of messages to return"
+ },
+ {
+ "name": "order",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "enum": ["asc", "desc"],
+ "type": "string",
+ "description": "Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first",
+ "default": "desc",
+ "title": "Order"
+ },
+ "description": "Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first"
+ },
+ {
+ "name": "order_by",
+ "in": "query",
+ "required": false,
+ "schema": {
+ "const": "created_at",
+ "type": "string",
+ "description": "Field to sort by",
+ "default": "created_at",
+ "title": "Order By"
+ },
+ "description": "Field to sort by"
},
{
"name": "group_id",
diff --git a/letta/server/rest_api/routers/v1/agents.py b/letta/server/rest_api/routers/v1/agents.py
index c55cfd2c6..93b7907fc 100644
--- a/letta/server/rest_api/routers/v1/agents.py
+++ b/letta/server/rest_api/routers/v1/agents.py
@@ -1072,9 +1072,17 @@ AgentMessagesResponse = Annotated[
async def list_messages(
agent_id: str,
server: "SyncServer" = Depends(get_letta_server),
- after: str | None = Query(None, description="Message after which to retrieve the returned messages."),
- before: str | None = Query(None, description="Message before which to retrieve the returned messages."),
- limit: int = Query(10, description="Maximum number of messages to retrieve."),
+ before: Optional[str] = Query(
+ None, description="Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order"
+ ),
+ after: Optional[str] = Query(
+ None, description="Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order"
+ ),
+ limit: Optional[int] = Query(100, description="Maximum number of messages to return"),
+ order: Literal["asc", "desc"] = Query(
+ "desc", description="Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first"
+ ),
+ order_by: Literal["created_at"] = Query("created_at", description="Field to sort by"),
group_id: str | None = Query(None, description="Group ID to filter messages by."),
use_assistant_message: bool = Query(True, description="Whether to use assistant messages"),
assistant_message_tool_name: str = Query(DEFAULT_MESSAGE_TOOL, description="The name of the designated message tool."),
@@ -1095,7 +1103,7 @@ async def list_messages(
before=before,
limit=limit,
group_id=group_id,
- reverse=True,
+ reverse=(order == "desc"),
return_message_object=False,
use_assistant_message=use_assistant_message,
assistant_message_tool_name=assistant_message_tool_name,