@topgunbuild/mcp-server 0.9.0 → 0.10.0

package/dist/index.d.mts

@@ -120,7 +120,7 @@ interface QueryToolArgs {
         order: 'asc' | 'desc';
     };
     limit?: number;
-    offset?: number;
+    cursor?: string;
 }
 /**
  * Mutate tool arguments
@@ -347,6 +347,8 @@ declare function createHTTPServer(mcpServer: TopGunMCPServer, config?: HTTPServe
 
 /**
  * topgun_query - Query data from a TopGun map with filters
+ *
+ * Phase 14.1: Updated to use cursor-based pagination via QueryHandle.
  */
 
 declare const queryTool: MCPTool;

package/dist/index.d.ts

@@ -120,7 +120,7 @@ interface QueryToolArgs {
         order: 'asc' | 'desc';
     };
     limit?: number;
-    offset?: number;
+    cursor?: string;
 }
 /**
  * Mutate tool arguments
@@ -347,6 +347,8 @@ declare function createHTTPServer(mcpServer: TopGunMCPServer, config?: HTTPServe
 
 /**
  * topgun_query - Query data from a TopGun map with filters
+ *
+ * Phase 14.1: Updated to use cursor-based pagination via QueryHandle.
  */
 
 declare const queryTool: MCPTool;

package/dist/index.js

@@ -23,7 +23,7 @@ var QueryArgsSchema = zod.z.object({
     order: zod.z.enum(["asc", "desc"]).describe("Sort order: ascending or descending")
   }).optional().describe("Sort configuration"),
   limit: zod.z.number().optional().default(10).describe("Maximum number of results to return"),
-  offset: zod.z.number().optional().default(0).describe("Number of results to skip (for pagination)")
+  cursor: zod.z.string().optional().describe("Opaque cursor for pagination (from previous response nextCursor)")
 });
 var MutateArgsSchema = zod.z.object({
   map: zod.z.string().describe("Name of the map to modify (e.g., 'tasks', 'users')"),
@@ -77,7 +77,7 @@ var toolSchemas = {
         description: "Sort configuration"
       },
       limit: { type: "number", description: "Maximum number of results to return", default: 10 },
-      offset: { type: "number", description: "Number of results to skip (for pagination)", default: 0 }
+      cursor: { type: "string", description: "Opaque cursor for pagination (from previous response nextCursor)" }
     },
     required: ["map"]
   },
@@ -167,7 +167,7 @@ var toolSchemas = {
 // src/tools/query.ts
 var queryTool = {
   name: "topgun_query",
-  description: "Query data from a TopGun map with filters and sorting. Use this to read data from the database. Supports filtering by field values and sorting by any field.",
+  description: "Query data from a TopGun map with filters and sorting. Use this to read data from the database. Supports filtering by field values, sorting, and cursor-based pagination.",
   inputSchema: toolSchemas.query
 };
 async function handleQuery(rawArgs, ctx) {
@@ -179,7 +179,7 @@ async function handleQuery(rawArgs, ctx) {
       isError: true
     };
   }
-  const { map, filter, sort, limit, offset } = parseResult.data;
+  const { map, filter, sort, limit, cursor } = parseResult.data;
   if (ctx.config.allowedMaps && !ctx.config.allowedMaps.includes(map)) {
     return {
       content: [
@@ -192,39 +192,26 @@ async function handleQuery(rawArgs, ctx) {
     };
   }
   const effectiveLimit = Math.min(limit ?? ctx.config.defaultLimit, ctx.config.maxLimit);
-  const effectiveOffset = offset ?? 0;
   try {
-    const lwwMap = ctx.client.getMap(map);
-    const allEntries = [];
-    for (const [key, value] of lwwMap.entries()) {
-      if (value !== null && typeof value === "object") {
-        let matches = true;
-        if (filter) {
-          for (const [filterKey, filterValue] of Object.entries(filter)) {
-            if (value[filterKey] !== filterValue) {
-              matches = false;
-              break;
-            }
-          }
-        }
-        if (matches) {
-          allEntries.push({ key: String(key), value });
-        }
-      }
-    }
+    const queryFilter = {
+      where: filter,
+      limit: effectiveLimit
+    };
     if (sort?.field) {
-      allEntries.sort((a, b) => {
-        const aVal = a.value[sort.field];
-        const bVal = b.value[sort.field];
-        if (aVal === bVal) return 0;
-        if (aVal === void 0 || aVal === null) return 1;
-        if (bVal === void 0 || bVal === null) return -1;
-        const comparison = aVal < bVal ? -1 : 1;
-        return sort.order === "desc" ? -comparison : comparison;
-      });
+      queryFilter.sort = { [sort.field]: sort.order };
     }
-    const paginatedEntries = allEntries.slice(effectiveOffset, effectiveOffset + effectiveLimit);
-    if (paginatedEntries.length === 0) {
+    if (cursor) {
+      queryFilter.cursor = cursor;
+    }
+    const handle = ctx.client.query(map, queryFilter);
+    const results = await new Promise((resolve) => {
+      const unsubscribe = handle.subscribe((data) => {
+        unsubscribe();
+        resolve(data);
+      });
+    });
+    const paginationInfo = handle.getPaginationInfo();
+    if (results.length === 0) {
       return {
         content: [
           {
@@ -234,17 +221,24 @@ async function handleQuery(rawArgs, ctx) {
         ]
       };
     }
-    const formatted = paginatedEntries.map((entry, idx) => `${idx + 1 + effectiveOffset}. [${entry.key}]: ${JSON.stringify(entry.value, null, 2)}`).join("\n\n");
-    const totalInfo = allEntries.length > effectiveLimit ? `
+    const formatted = results.map((entry, idx) => {
+      const { _key, ...value } = entry;
+      return `${idx + 1}. [${_key}]: ${JSON.stringify(value, null, 2)}`;
+    }).join("\n\n");
+    let paginationText = "";
+    if (paginationInfo.hasMore && paginationInfo.nextCursor) {
+      paginationText = `
 
-(Showing ${effectiveOffset + 1}-${effectiveOffset + paginatedEntries.length} of ${allEntries.length} total)` : "";
+---
+More results available. Use cursor: "${paginationInfo.nextCursor}" to fetch next page.`;
+    }
     return {
       content: [
         {
           type: "text",
-          text: `Found ${paginatedEntries.length} result(s) in map '${map}':
+          text: `Found ${results.length} result(s) in map '${map}':
 
-${formatted}${totalInfo}`
+${formatted}${paginationText}`
         }
       ]
     };