@squadrules/mcp 5.21.0 → 5.22.0

package/dist/utils/pagination.js

@@ -0,0 +1,88 @@
+/**
+ * Cursor-based pagination utilities for MCP list operations.
+ *
+ * Implements the 2026-07-28 spec pagination model:
+ * - Opaque cursor tokens (base64-encoded JSON)
+ * - Server-determined page sizes
+ * - nextCursor field in responses when more results exist
+ * - Cache metadata (ttlMs, cacheScope) on all list/read responses
+ */
+import { getBuildVersion } from '../utils/build-version.js';
+/** Default page size for list operations */
+export const DEFAULT_PAGE_SIZE = 50;
+/** Cache TTL for embedded docs (5 minutes) */
+export const EMBEDDED_DOCS_TTL_MS = 300_000;
+/** Cache TTL for adapter content (30 seconds - bounded for store mutations) */
+export const ADAPTER_CONTENT_TTL_MS = 30_000;
+/** Cache scope for embedded docs (public - build-fresh) */
+export const EMBEDDED_DOCS_CACHE_SCOPE = 'public';
+/** Cache scope for adapter content (private - user-specific) */
+export const ADAPTER_CONTENT_CACHE_SCOPE = 'private';
+/**
+ * Encode a cursor from an offset position
+ */
+export function encodeCursor(offset) {
+    const payload = { offset };
+    return Buffer.from(JSON.stringify(payload)).toString('base64');
+}
+/**
+ * Decode a cursor to get the offset position
+ * Returns 0 if cursor is invalid or missing
+ */
+export function decodeCursor(cursor) {
+    if (!cursor)
+        return 0;
+    try {
+        const decoded = Buffer.from(cursor, 'base64').toString('utf-8');
+        const payload = JSON.parse(decoded);
+        return typeof payload.offset === 'number' && payload.offset >= 0 ? payload.offset : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Paginate an array of items based on cursor
+ * @returns The page of items and the next cursor (if more items exist)
+ */
+export function paginateItems(items, cursor, pageSize = DEFAULT_PAGE_SIZE) {
+    const offset = decodeCursor(cursor);
+    const page = items.slice(offset, offset + pageSize);
+    const hasMore = offset + pageSize < items.length;
+    return {
+        page,
+        ...(hasMore && { nextCursor: encodeCursor(offset + pageSize) })
+    };
+}
+/**
+ * Build cache metadata for embedded docs (resources, prompts from codebase)
+ * These are build-fresh and can be cached publicly
+ */
+export function buildEmbeddedDocsCacheMetadata() {
+    return {
+        ttlMs: EMBEDDED_DOCS_TTL_MS,
+        cacheScope: EMBEDDED_DOCS_CACHE_SCOPE
+    };
+}
+/**
+ * Build cache metadata for adapter content (reached through activate/forward)
+ * These are user-specific and have bounded TTL for store mutations
+ */
+export function buildAdapterContentCacheMetadata() {
+    return {
+        ttlMs: ADAPTER_CONTENT_TTL_MS,
+        cacheScope: ADAPTER_CONTENT_CACHE_SCOPE
+    };
+}
+/**
+ * Build cache metadata for server info (included in _meta)
+ */
+export function buildServerInfoMeta() {
+    return {
+        'io.modelcontextprotocol/serverInfo': {
+            name: 'SquadRules',
+            version: getBuildVersion()
+        }
+    };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/utils/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,2DAA2D;AAC3D,MAAM,CAAC,MAAM,yBAAyB,GAAG,QAAiB,CAAC;AAE3D,gEAAgE;AAChE,MAAM,CAAC,MAAM,2BAA2B,GAAG,SAAkB,CAAC;AAS9D;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,OAAO,GAAkB,EAAE,MAAM,EAAE,CAAC;IAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;QACrD,OAAO,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAU,EACV,MAA0B,EAC1B,WAAmB,iBAAiB;IAEpC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;IAEjD,OAAO;QACL,IAAI;QACJ,GAAG,CAAC,OAAO,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,MAAM,GAAG,QAAQ,CAAC,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B;IAI5C,OAAO;QACL,KAAK,EAAE,oBAAoB;QAC3B,UAAU,EAAE,yBAAyB;KACtC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC;IAI9C,OAAO;QACL,KAAK,EAAE,sBAAsB;QAC7B,UAAU,EAAE,2BAA2B;KACxC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,oCAAoC,EAAE;YACpC,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,eAAe,EAAE;SAC3B;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squadrules/mcp",
-  "version": "5.21.0",
+  "version": "5.22.0",
   "description": "SquadRules MCP server for agent automation: persistent memory and deterministic workflow execution for AI agents and chats",
   "type": "module",
   "main": "dist/index.js",