@respan/cli 0.16.0 → 0.17.0

package/dist/commands/tools/list.d.ts

@@ -2,6 +2,8 @@ import { BaseCommand } from '../../lib/base-command.js';
 export default class ToolsList extends BaseCommand {
     static description: string;
     static flags: {
+        category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        categories: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'mcp-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'base-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/tools/list.js

@@ -6,8 +6,26 @@ class ToolsList extends BaseCommand {
         const { flags } = await this.parse(ToolsList);
         this.globalFlags = flags;
         try {
-            const tools = await withMcpClient(this.getAuth(), flags['mcp-url'], listMcpTools);
-            this.outputResult(tools, ['name', 'description']);
+            let tools = await withMcpClient(this.getAuth(), flags['mcp-url'], listMcpTools);
+            const categoryOf = (tool) => typeof tool._meta?.['respan/category'] === 'string' ? tool._meta['respan/category'] : 'uncategorized';
+            const counts = new Map();
+            for (const tool of tools) {
+                const category = categoryOf(tool);
+                counts.set(category, (counts.get(category) ?? 0) + 1);
+            }
+            if (flags.category) {
+                if (!counts.has(flags.category))
+                    throw new Error(`Unknown category '${flags.category}'. Available: ${[...counts.keys()].sort().join(', ')}`);
+                tools = tools.filter((tool) => categoryOf(tool) === flags.category);
+            }
+            if (flags.categories) {
+                const rows = [...counts].filter(([category]) => !flags.category || category === flags.category)
+                    .sort(([a], [b]) => a.localeCompare(b)).map(([category, tool_count]) => ({ category, tool_count }));
+                this.outputResult(rows, ['category', 'tool_count']);
+            }
+            else {
+                this.outputResult(flags.json ? tools : tools.map((tool) => ({ ...tool, category: categoryOf(tool) })), ['category', 'name', 'description']);
+            }
         }
         catch (error) {
             this.handleError(error);
@@ -17,6 +35,8 @@ class ToolsList extends BaseCommand {
 ToolsList.description = 'List the current Respan MCP tools, their input schemas, and annotations.';
 ToolsList.flags = {
     ...BaseCommand.baseFlags,
+    category: Flags.string({ description: 'Filter by a category returned by the MCP server' }),
+    categories: Flags.boolean({ description: 'List available categories and tool counts instead of tools' }),
     'mcp-url': Flags.string({ description: 'Custom MCP server URL (defaults to the active Platform or Enterprise server)' }),
 };
 export default ToolsList;

package/oclif.manifest.json

@@ -3640,6 +3640,19 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "category": {
+          "description": "Filter by a category returned by the MCP server",
+          "name": "category",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "categories": {
+          "description": "List available categories and tool counts instead of tools",
+          "name": "categories",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "mcp-url": {
           "description": "Custom MCP server URL (defaults to the active Platform or Enterprise server)",
           "name": "mcp-url",
@@ -4272,5 +4285,5 @@
       ]
     }
   },
-  "version": "0.16.0"
+  "version": "0.17.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@respan/cli",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Respan CLI - manage your LLM observability from the command line",
   "type": "module",
   "main": "dist/index.js",