@topolo/cli 0.7.1 → 0.7.3

package/dist/index.js

@@ -4644,6 +4644,18 @@ function emit(data, mode, pretty) {
     process.stdout.write(pretty() + "\n");
   }
 }
+function handleOutputStreamError(err, exit = process.exit) {
+  if (err?.code === "EPIPE") {
+    exit(0);
+    return;
+  }
+  throw err;
+}
+function installOutputErrorHandlers(stdout = process.stdout, stderr = process.stderr, exit = process.exit) {
+  const handler = (err) => handleOutputStreamError(err, exit);
+  stdout.on("error", handler);
+  stderr.on("error", handler);
+}
 function fail(err, mode) {
   const payload = normalizeError(err);
   if (mode === "json") {
@@ -5268,20 +5280,62 @@ function registerActionsCommand(program2) {
       fail(err, mode);
     }
   });
-  actions.command("capabilities").description("List every published action for one application (its capability contract)").option("-s, --service <service>", "App id, slug, or name").option("--detail", "Include full schemas and agent contracts").option("--json", "Output JSON").option("--no-json", "Output human-readable table").action(async (opts, command) => {
+  actions.command("capabilities").description("List every published action for one application (its capability contract)").option("-s, --service <service>", "App id, slug, or name").option("--summary", "Return compact capability counts without action rows").option("--detail", "Include full schemas and agent contracts").option("--json", "Output JSON").option("--no-json", "Output human-readable table").action(async (opts, command) => {
     const mode = resolveOutputMode(opts.json ?? command.parent?.opts().json);
     try {
       const topolo = await requiredClient();
       const service = opts.service || command.parent?.opts().service;
       if (!service?.trim()) throw new Error("--service is required for capability discovery");
-      const result = await topolo.client.searchActions({ service: service.trim(), limit: 100 });
-      const output2 = detailRequested(opts.detail, command) ? result : { actions: result.actions.map(compactActionCatalogEntry), page: result.page };
-      emit(output2, mode, () => formatActionRows(result.actions, result.page.nextCursor));
+      if (opts.summary && detailRequested(opts.detail, command)) {
+        throw new Error("--summary cannot be combined with --detail");
+      }
+      const resolvedService = service.trim();
+      const discovered = [];
+      const seenCursors = /* @__PURE__ */ new Set();
+      let cursor;
+      for (; ; ) {
+        const page = await topolo.client.searchActions({
+          service: resolvedService,
+          limit: 100,
+          ...cursor ? { cursor } : {}
+        });
+        discovered.push(...page.actions);
+        if (!page.page.hasMore) break;
+        const nextCursor = page.page.nextCursor?.trim();
+        if (!nextCursor || seenCursors.has(nextCursor)) {
+          throw new Error("Capability discovery returned an invalid continuation cursor.");
+        }
+        seenCursors.add(nextCursor);
+        cursor = nextCursor;
+      }
+      const result = { actions: discovered, page: { nextCursor: null, hasMore: false } };
+      const output2 = opts.summary ? summarizeActionCapabilities(resolvedService, discovered) : detailRequested(opts.detail, command) ? result : { actions: discovered.map(compactActionCatalogEntry), page: result.page };
+      emit(output2, mode, () => opts.summary ? formatActionCapabilitySummary(summarizeActionCapabilities(resolvedService, discovered)) : formatActionRows(discovered));
     } catch (err) {
       fail(err, mode);
     }
   });
 }
+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 formatActionCapabilitySummary(summary) {
+  return [
+    `Service: ${summary.service}`,
+    `Actions: ${summary.total} (${summary.readOnly} read-only, ${summary.mutating} mutating)`,
+    `Destructive: ${summary.destructive}`,
+    `Confirmation required: ${summary.confirmationRequired}`,
+    `Resource types: ${summary.resourceTypes.join(", ") || "-"}`
+  ].join("\n");
+}
 function detailRequested(local, command) {
   return local === true || command.parent?.opts().detail === true;
 }
@@ -13697,6 +13751,7 @@ Workspace: ${workspace.name} (${workspace.id})${workspace.isDefault ? "\nDefault
 }
 
 // src/index.ts
+installOutputErrorHandlers();
 var program = new Command();
 var argv;
 try {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@topolo/cli",
-  "version": "0.7.1",
-  "topoloPublishedVersion": "0.7.1",
+  "version": "0.7.3",
+  "topoloPublishedVersion": "0.7.3",
   "description": "Command-line interface for Topolo developers, operators, and agents, with internal first-party scaffolding available under the topolo platform namespace.",
   "type": "module",
   "bin": {

package/skills/topolo/SKILL.md

@@ -169,7 +169,7 @@ For large inputs, write one schema-valid JSON object to a file and pass it witho
 
 ```bash
 topolo actions validate <action-id> --data @payload.json --json
-topolo actions plan <action-id> --data @payload.json --json
+topolo actions plan <action-id> --data @payload.json --confirm --json
 topolo actions call <action-id> --data @payload.json --confirm --json
 ```
 
@@ -183,7 +183,7 @@ topolo actions plan <action-id> --data '<json>' --json
 
 MCP: `topolo_plan_action`.
 
-The plan must be valid and must expose the resolved request, confirmation requirement, verification steps, and rollback when one is published. If `executable` is false, do not call the action.
+The plan must be valid and must expose the resolved request, confirmation requirement, verification steps, and rollback when one is published. For a mutation that the user has already authorized, include `--confirm` in the plan so `executable` reflects the exact confirmed call; planning never executes the action. Before approval, omit `--confirm`, present the plan, and treat `executable: false` with `confirmationRequired: true` and `confirmationProvided: false` as awaiting approval rather than an invalid contract. Once approval is obtained, call the unchanged request with `--confirm` without planning it a second time. Any other `executable: false` result blocks the call.
 
 ### 6. Confirm mutations