@topolo/mcp 0.10.1 → 0.10.2

package/dist/dispatch.js

@@ -82,6 +82,17 @@ function optionalResourceContext(args) {
   }
   return { resourceType, resourceId };
 }
+function summarizeActionCapabilities(service, actions) {
+  return {
+    service,
+    total: actions.length,
+    readOnly: actions.filter((action) => action.readOnly).length,
+    mutating: actions.filter((action) => !action.readOnly).length,
+    destructive: actions.filter((action) => action.destructive).length,
+    confirmationRequired: actions.filter((action) => action.requiresConfirmation).length,
+    resourceTypes: [...new Set(actions.map((action) => action.agentContract?.resource?.kind).filter(Boolean))].sort()
+  };
+}
 function coerceObjectParam(value, name) {
   let candidate = value;
   if (typeof candidate === "string" && candidate.trim().startsWith("{")) {
@@ -423,13 +434,14 @@ var TOOLS = [
   {
     name: "topolo_discover_capabilities",
     title: "Discover one Topolo application capability contract",
-    description: "Lists every action published by one application \u2014 its full capability contract, straight from the registry-canonical catalog. Use the actionService value returned by topolo_search_applications as service. Follow page.nextCursor via topolo_search_actions when the contract exceeds one page.",
+    description: "Lists every action published by one application \u2014 its full capability contract, straight from the registry-canonical catalog. Use the actionService value returned by topolo_search_applications as service.",
     requiredScopes: [],
     destructive: false,
     inputSchema: {
       type: "object",
       properties: {
         service: { type: "string", minLength: 1 },
+        summary: { type: "boolean", description: "Return compact counts without action rows." },
         detail: { type: "boolean", description: "Return full schemas and agent contracts. Defaults to compact capability guidance." }
       },
       required: ["service"],
@@ -438,8 +450,26 @@ var TOOLS = [
     handler: async (topolo, args) => {
       const service = typeof args["service"] === "string" ? args["service"].trim() : "";
       if (!service) throw new TopoloMcpPublicError("service is required.");
-      const result = await topolo.client.searchActions({ service, limit: 100 });
-      return args["detail"] === true ? result : { actions: result.actions.map(compactActionCatalogEntry), page: result.page };
+      if (args["summary"] === true && args["detail"] === true) {
+        throw new TopoloMcpPublicError("summary cannot be combined with detail.");
+      }
+      const actions = [];
+      const seenCursors = /* @__PURE__ */ new Set();
+      let cursor;
+      for (; ; ) {
+        const page = await topolo.client.searchActions({ service, limit: 100, ...cursor ? { cursor } : {} });
+        actions.push(...page.actions);
+        if (!page.page.hasMore) break;
+        const nextCursor = page.page.nextCursor?.trim();
+        if (!nextCursor || seenCursors.has(nextCursor)) {
+          throw new TopoloMcpPublicError("Capability discovery returned an invalid continuation cursor.");
+        }
+        seenCursors.add(nextCursor);
+        cursor = nextCursor;
+      }
+      if (args["summary"] === true) return summarizeActionCapabilities(service, actions);
+      const result = { actions, page: { nextCursor: null, hasMore: false } };
+      return args["detail"] === true ? result : { actions: actions.map(compactActionCatalogEntry), page: result.page };
     }
   },
   {

package/dist/http.js

@@ -15916,6 +15916,17 @@ function optionalResourceContext(args) {
   }
   return { resourceType, resourceId };
 }
+function summarizeActionCapabilities(service, actions) {
+  return {
+    service,
+    total: actions.length,
+    readOnly: actions.filter((action) => action.readOnly).length,
+    mutating: actions.filter((action) => !action.readOnly).length,
+    destructive: actions.filter((action) => action.destructive).length,
+    confirmationRequired: actions.filter((action) => action.requiresConfirmation).length,
+    resourceTypes: [...new Set(actions.map((action) => action.agentContract?.resource?.kind).filter(Boolean))].sort()
+  };
+}
 function coerceObjectParam(value, name) {
   let candidate = value;
   if (typeof candidate === "string" && candidate.trim().startsWith("{")) {
@@ -16257,13 +16268,14 @@ var TOOLS = [
   {
     name: "topolo_discover_capabilities",
     title: "Discover one Topolo application capability contract",
-    description: "Lists every action published by one application \u2014 its full capability contract, straight from the registry-canonical catalog. Use the actionService value returned by topolo_search_applications as service. Follow page.nextCursor via topolo_search_actions when the contract exceeds one page.",
+    description: "Lists every action published by one application \u2014 its full capability contract, straight from the registry-canonical catalog. Use the actionService value returned by topolo_search_applications as service.",
     requiredScopes: [],
     destructive: false,
     inputSchema: {
       type: "object",
       properties: {
         service: { type: "string", minLength: 1 },
+        summary: { type: "boolean", description: "Return compact counts without action rows." },
         detail: { type: "boolean", description: "Return full schemas and agent contracts. Defaults to compact capability guidance." }
       },
       required: ["service"],
@@ -16272,8 +16284,26 @@ var TOOLS = [
     handler: async (topolo, args) => {
       const service = typeof args["service"] === "string" ? args["service"].trim() : "";
       if (!service) throw new TopoloMcpPublicError("service is required.");
-      const result = await topolo.client.searchActions({ service, limit: 100 });
-      return args["detail"] === true ? result : { actions: result.actions.map(compactActionCatalogEntry), page: result.page };
+      if (args["summary"] === true && args["detail"] === true) {
+        throw new TopoloMcpPublicError("summary cannot be combined with detail.");
+      }
+      const actions = [];
+      const seenCursors = /* @__PURE__ */ new Set();
+      let cursor;
+      for (; ; ) {
+        const page = await topolo.client.searchActions({ service, limit: 100, ...cursor ? { cursor } : {} });
+        actions.push(...page.actions);
+        if (!page.page.hasMore) break;
+        const nextCursor = page.page.nextCursor?.trim();
+        if (!nextCursor || seenCursors.has(nextCursor)) {
+          throw new TopoloMcpPublicError("Capability discovery returned an invalid continuation cursor.");
+        }
+        seenCursors.add(nextCursor);
+        cursor = nextCursor;
+      }
+      if (args["summary"] === true) return summarizeActionCapabilities(service, actions);
+      const result = { actions, page: { nextCursor: null, hasMore: false } };
+      return args["detail"] === true ? result : { actions: actions.map(compactActionCatalogEntry), page: result.page };
     }
   },
   {

package/dist/index.js

@@ -4525,6 +4525,17 @@ function optionalResourceContext(args) {
   }
   return { resourceType, resourceId };
 }
+function summarizeActionCapabilities(service, actions) {
+  return {
+    service,
+    total: actions.length,
+    readOnly: actions.filter((action) => action.readOnly).length,
+    mutating: actions.filter((action) => !action.readOnly).length,
+    destructive: actions.filter((action) => action.destructive).length,
+    confirmationRequired: actions.filter((action) => action.requiresConfirmation).length,
+    resourceTypes: [...new Set(actions.map((action) => action.agentContract?.resource?.kind).filter(Boolean))].sort()
+  };
+}
 function coerceObjectParam(value, name) {
   let candidate = value;
   if (typeof candidate === "string" && candidate.trim().startsWith("{")) {
@@ -4866,13 +4877,14 @@ var TOOLS = [
   {
     name: "topolo_discover_capabilities",
     title: "Discover one Topolo application capability contract",
-    description: "Lists every action published by one application \u2014 its full capability contract, straight from the registry-canonical catalog. Use the actionService value returned by topolo_search_applications as service. Follow page.nextCursor via topolo_search_actions when the contract exceeds one page.",
+    description: "Lists every action published by one application \u2014 its full capability contract, straight from the registry-canonical catalog. Use the actionService value returned by topolo_search_applications as service.",
     requiredScopes: [],
     destructive: false,
     inputSchema: {
       type: "object",
       properties: {
         service: { type: "string", minLength: 1 },
+        summary: { type: "boolean", description: "Return compact counts without action rows." },
         detail: { type: "boolean", description: "Return full schemas and agent contracts. Defaults to compact capability guidance." }
       },
       required: ["service"],
@@ -4881,8 +4893,26 @@ var TOOLS = [
     handler: async (topolo, args) => {
       const service = typeof args["service"] === "string" ? args["service"].trim() : "";
       if (!service) throw new TopoloMcpPublicError("service is required.");
-      const result = await topolo.client.searchActions({ service, limit: 100 });
-      return args["detail"] === true ? result : { actions: result.actions.map(compactActionCatalogEntry), page: result.page };
+      if (args["summary"] === true && args["detail"] === true) {
+        throw new TopoloMcpPublicError("summary cannot be combined with detail.");
+      }
+      const actions = [];
+      const seenCursors = /* @__PURE__ */ new Set();
+      let cursor;
+      for (; ; ) {
+        const page = await topolo.client.searchActions({ service, limit: 100, ...cursor ? { cursor } : {} });
+        actions.push(...page.actions);
+        if (!page.page.hasMore) break;
+        const nextCursor = page.page.nextCursor?.trim();
+        if (!nextCursor || seenCursors.has(nextCursor)) {
+          throw new TopoloMcpPublicError("Capability discovery returned an invalid continuation cursor.");
+        }
+        seenCursors.add(nextCursor);
+        cursor = nextCursor;
+      }
+      if (args["summary"] === true) return summarizeActionCapabilities(service, actions);
+      const result = { actions, page: { nextCursor: null, hasMore: false } };
+      return args["detail"] === true ? result : { actions: actions.map(compactActionCatalogEntry), page: result.page };
     }
   },
   {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@topolo/mcp",
-  "version": "0.10.1",
-  "topoloPublishedVersion": "0.10.1",
+  "version": "0.10.2",
+  "topoloPublishedVersion": "0.10.2",
   "description": "Model Context Protocol server for the Topolo platform. Exposes scope-gated tools that third-party agents (Claude, Codex, etc.) can call natively.",
   "type": "module",
   "bin": {