@absolutejs/mcp 0.1.0 → 0.2.0

package/dist/index.js

@@ -150,16 +150,26 @@ var createMcpClient = (options) => {
     await notify("notifications/initialized");
     return isRecord(result) ? result : {};
   };
+  const MAX_LIST_PAGES = 40;
   const listTools = async () => {
-    const result = await rpc("tools/list");
-    const tools = isRecord(result) && Array.isArray(result.tools) ? result.tools : [];
-    return tools.filter(isRecord).map((tool) => ({
-      annotations: isRecord(tool.annotations) ? tool.annotations : undefined,
-      description: typeof tool.description === "string" ? tool.description : undefined,
-      inputSchema: isRecord(tool.inputSchema) ? tool.inputSchema : undefined,
-      name: typeof tool.name === "string" ? tool.name : "",
-      outputSchema: isRecord(tool.outputSchema) ? tool.outputSchema : undefined
-    }));
+    const collected = [];
+    let cursor;
+    for (let page = 0;page < MAX_LIST_PAGES; page += 1) {
+      const result = await rpc("tools/list", cursor === undefined ? undefined : { cursor });
+      const tools = isRecord(result) && Array.isArray(result.tools) ? result.tools : [];
+      collected.push(...tools.filter(isRecord).map((tool) => ({
+        annotations: isRecord(tool.annotations) ? tool.annotations : undefined,
+        description: typeof tool.description === "string" ? tool.description : undefined,
+        inputSchema: isRecord(tool.inputSchema) ? tool.inputSchema : undefined,
+        name: typeof tool.name === "string" ? tool.name : "",
+        outputSchema: isRecord(tool.outputSchema) ? tool.outputSchema : undefined
+      })));
+      const next = isRecord(result) && typeof result.nextCursor === "string" ? result.nextCursor : undefined;
+      if (next === undefined)
+        break;
+      cursor = next;
+    }
+    return collected;
   };
   const callTool = async (name, args) => {
     const result = await rpc("tools/call", { arguments: args ?? {}, name });
@@ -169,8 +179,19 @@ var createMcpClient = (options) => {
     return { content: [], isError: false };
   };
   const listResources = async () => {
-    const result = await rpc("resources/list");
-    return isRecord(result) && Array.isArray(result.resources) ? result.resources : [];
+    const collected = [];
+    let cursor;
+    for (let page = 0;page < MAX_LIST_PAGES; page += 1) {
+      const result = await rpc("resources/list", cursor === undefined ? undefined : { cursor });
+      if (isRecord(result) && Array.isArray(result.resources)) {
+        collected.push(...result.resources);
+      }
+      const next = isRecord(result) && typeof result.nextCursor === "string" ? result.nextCursor : undefined;
+      if (next === undefined)
+        break;
+      cursor = next;
+    }
+    return collected;
   };
   const readResource = async (uri) => rpc("resources/read", { uri });
   const ping = async () => {
@@ -212,6 +233,26 @@ var unauthorized = (metadataUrl, detail) => new Response(JSON.stringify({
 // src/dispatch.ts
 var DEFAULT_PROTOCOLS = ["2025-06-18", "2025-03-26", "2024-11-05"];
 var DEFAULT_RESOURCE_MIME = "text/markdown";
+var DEFAULT_LIST_PAGE_SIZE = 50;
+var decodeCursor = (params) => {
+  if (!isRecord(params) || typeof params.cursor !== "string")
+    return 0;
+  try {
+    const parsed = Number.parseInt(atob(params.cursor), 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+  } catch {
+    return 0;
+  }
+};
+var encodeCursor = (offset) => btoa(String(offset));
+var paginate = (items, offset, pageSize) => {
+  const page = items.slice(offset, offset + pageSize);
+  const nextOffset = offset + pageSize;
+  return {
+    items: page,
+    ...nextOffset < items.length ? { nextCursor: encodeCursor(nextOffset) } : {}
+  };
+};
 var idOf = (message) => typeof message.id === "string" || typeof message.id === "number" ? message.id : null;
 var negotiateProtocol = (supported, params) => {
   const preferred = supported[0] ?? DEFAULT_PROTOCOLS[0] ?? "";
@@ -244,16 +285,19 @@ var initialize = (config, id, params) => {
     serverInfo: config.serverInfo
   });
 };
-var toolsList = async (config, caller, scopes, id) => {
+var toolsList = async (config, caller, scopes, id, params) => {
   const tools = await config.tools({ caller, meta: {} });
+  const visible = Object.entries(tools).filter(([, tool]) => scopeAllows(tool, scopes)).map(([name, tool]) => ({
+    annotations: tool.annotations,
+    description: tool.description,
+    inputSchema: tool.inputSchema,
+    name,
+    ...tool.outputSchema === undefined ? {} : { outputSchema: tool.outputSchema }
+  }));
+  const { items, nextCursor } = paginate(visible, decodeCursor(params), config.listPageSize ?? DEFAULT_LIST_PAGE_SIZE);
   return rpcResult(id, {
-    tools: Object.entries(tools).filter(([, tool]) => scopeAllows(tool, scopes)).map(([name, tool]) => ({
-      annotations: tool.annotations,
-      description: tool.description,
-      inputSchema: tool.inputSchema,
-      name,
-      ...tool.outputSchema === undefined ? {} : { outputSchema: tool.outputSchema }
-    }))
+    tools: items,
+    ...nextCursor === undefined ? {} : { nextCursor }
   });
 };
 var errorResult = (id, text) => rpcResult(id, { content: [{ text, type: "text" }], isError: true });
@@ -288,15 +332,18 @@ var toolsCall = async (config, caller, scopes, id, params) => {
     await config.onCall({ args, caller, meta, name, ok });
   return response;
 };
-var promptsList = (config, id) => {
+var promptsList = (config, id, params) => {
   const definitions = config.prompts?.definitions ?? {};
+  const all = Object.entries(definitions).map(([name, def]) => ({
+    arguments: def.arguments ?? [],
+    description: def.description,
+    name,
+    title: def.title
+  }));
+  const { items, nextCursor } = paginate(all, decodeCursor(params), config.listPageSize ?? DEFAULT_LIST_PAGE_SIZE);
   return rpcResult(id, {
-    prompts: Object.entries(definitions).map(([name, def]) => ({
-      arguments: def.arguments ?? [],
-      description: def.description,
-      name,
-      title: def.title
-    }))
+    prompts: items,
+    ...nextCursor === undefined ? {} : { nextCursor }
   });
 };
 var promptsGet = async (config, caller, id, params) => {
@@ -320,11 +367,15 @@ var promptsGet = async (config, caller, id, params) => {
     messages: [{ content: { text, type: "text" }, role: "user" }]
   });
 };
-var resourcesList = async (config, caller, id) => {
+var resourcesList = async (config, caller, id, params) => {
   const resources = config.resources;
   if (!resources)
     return rpcResult(id, { resources: [] });
-  return rpcResult(id, { resources: await resources.list({ caller }) });
+  const { items, nextCursor } = paginate(await resources.list({ caller }), decodeCursor(params), config.listPageSize ?? DEFAULT_LIST_PAGE_SIZE);
+  return rpcResult(id, {
+    resources: items,
+    ...nextCursor === undefined ? {} : { nextCursor }
+  });
 };
 var resourcesRead = async (config, caller, id, params) => {
   const resources = config.resources;
@@ -357,17 +408,19 @@ var dispatchMcp = async (config, caller, scopes, message) => {
     return initialize(config, id, params);
   if (method === "ping")
     return rpcResult(id, {});
-  if (method === "tools/list")
-    return toolsList(config, caller, scopes, id);
+  if (method === "tools/list") {
+    return toolsList(config, caller, scopes, id, params);
+  }
   if (method === "tools/call") {
     return toolsCall(config, caller, scopes, id, params);
   }
   if (method === "prompts/list")
-    return promptsList(config, id);
+    return promptsList(config, id, params);
   if (method === "prompts/get")
     return promptsGet(config, caller, id, params);
-  if (method === "resources/list")
-    return resourcesList(config, caller, id);
+  if (method === "resources/list") {
+    return resourcesList(config, caller, id, params);
+  }
   if (method === "resources/read") {
     return resourcesRead(config, caller, id, params);
   }

package/dist/src/types.d.ts

@@ -135,6 +135,8 @@ export type McpServerConfig<Caller> = {
     instructions?: string;
     /** The token issuer — used for discovery metadata and the challenge URL. */
     issuer: string;
+    /** Page size for tools/prompts/resources list pagination (default 50). */
+    listPageSize?: number;
     /** Fired after every `tools/call` for auditing. `meta` carries anything the
      *  tool handler wrote during the call. */
     onCall?: (record: {

package/package.json

@@ -37,5 +37,5 @@
     "typecheck": "tsc --noEmit --project tsconfig.json"
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.1.0"
+  "version": "0.2.0"
 }