From a89e9a1bb995c10e6e1a627145ed4f0b18341fd0 Mon Sep 17 00:00:00 2001
From: Markov <markov@uix.su>
Date: Tue, 24 Feb 2026 10:30:49 +0100
Subject: [PATCH] feat: offset param in list_messages tool (pagination)

---
 src/tools/messages.ts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/tools/messages.ts b/src/tools/messages.ts
index b641776..e149396 100644
--- a/src/tools/messages.ts
+++ b/src/tools/messages.ts
@@ -13,6 +13,7 @@ const ListMessagesParams = Type.Object({
   chat_id: Type.Optional(Type.String({ description: 'Chat UUID' })),
   task_id: Type.Optional(Type.String({ description: 'Task UUID' })),
   limit: Type.Optional(Type.Number({ description: 'Max messages to return (default 50)' })),
+  offset: Type.Optional(Type.Number({ description: 'Skip N newest messages (for pagination). offset=30 skips 30 newest, returns next batch.' })),
 });
 
 function ok(text: string) {
@@ -41,6 +42,7 @@ export function createMessageTools(ctx: ToolContext): ToolDefinition<any>[] {
         if (params.chat_id) query.chat_id = params.chat_id;
         if (params.task_id) query.task_id = params.task_id;
         if (params.limit) query.limit = String(params.limit);
+        if (params.offset) query.offset = String(params.offset);
         const messages = await ctx.trackerClient.listMessages(query);
         return ok(JSON.stringify(messages, null, 2));
       },