@clawops/cli 2.1.1 → 2.1.3

package/dist/{context-7VI3R6EK.js → context-WOKSKAIA.js}

@@ -2,18 +2,18 @@
 import {
   buildContext,
   loadAdapterModule
-} from "./chunk-QDNFADJI.js";
-import "./chunk-BELTQGHT.js";
+} from "./chunk-AVERNLUY.js";
+import "./chunk-CHNSL3TC.js";
+import "./chunk-VUFMZEIM.js";
 import "./chunk-GIEVAGEK.js";
 import "./chunk-VOEJYRIK.js";
 import "./chunk-EI7CQQ7D.js";
 import "./chunk-FEK7VJAY.js";
 import "./chunk-RHOWYIWT.js";
 import "./chunk-N4WZLWJ4.js";
-import "./chunk-ELU3XQEA.js";
-import "./chunk-64PONSA5.js";
+import "./chunk-RDUKRIRC.js";
+import "./chunk-GFIR2IIJ.js";
 import "./chunk-KGXPLI7W.js";
-import "./chunk-VUFMZEIM.js";
 export {
   buildContext,
   loadAdapterModule

package/dist/{flows-RI7FGHAM.js → flows-HGJIA6EL.js}

@@ -2,9 +2,9 @@
 
 // src/harden/flows.ts
 async function cutOverToTailnet(ctx, conn, config) {
-  const { withRemoteExec } = await import("./harden-3KKCR7BL.js");
-  const { verifyTailnetAddress, probeSsh } = await import("./tailscale-cutover-6YP2QKFM.js");
-  const { setConfig } = await import("./store-OVB3DAJR.js");
+  const { withRemoteExec } = await import("./harden-RUOUA5BV.js");
+  const { verifyTailnetAddress, probeSsh } = await import("./tailscale-cutover-EKAQSDXP.js");
+  const { setConfig } = await import("./store-YOLQYXMB.js");
   const result = await withRemoteExec(
     conn,
     void 0,
@@ -49,11 +49,11 @@ async function revertTailnet(ctx, config) {
       message: `Stack "${ctx.stackName}" is not using a tailnet address; nothing to revert.`
     };
   }
-  const { buildContext } = await import("./context-7VI3R6EK.js");
+  const { buildContext } = await import("./context-WOKSKAIA.js");
   const { extractBaseOutputs } = await import("./outputs-DJHBY7EE.js");
-  const { probeSsh, leaveTailnet } = await import("./tailscale-cutover-6YP2QKFM.js");
-  const { withRemoteExec } = await import("./harden-3KKCR7BL.js");
-  const { getConfig, setConfig } = await import("./store-OVB3DAJR.js");
+  const { probeSsh, leaveTailnet } = await import("./tailscale-cutover-EKAQSDXP.js");
+  const { withRemoteExec } = await import("./harden-RUOUA5BV.js");
+  const { getConfig, setConfig } = await import("./store-YOLQYXMB.js");
   const { forgetHost } = await import("./known-hosts-file-I3Q3NBYQ.js");
   const direct = buildContext({ stack: ctx.stackName, ignoreTailnet: true });
   const outputMap = await (await direct.getStack()).outputs();

package/dist/{generate-JNJ63ZYZ.js → generate-NE54BATS.js}

@@ -5,21 +5,21 @@ import {
   isInstanceAlias,
   parseDiffForTest,
   planId
-} from "./chunk-YEBFVLOE.js";
+} from "./chunk-PTCVFLZ3.js";
 import "./chunk-XFN3YDZE.js";
-import "./chunk-QDNFADJI.js";
+import "./chunk-AVERNLUY.js";
+import "./chunk-CHNSL3TC.js";
 import "./chunk-JW5A7E3X.js";
-import "./chunk-BELTQGHT.js";
+import "./chunk-VUFMZEIM.js";
 import "./chunk-GIEVAGEK.js";
 import "./chunk-VOEJYRIK.js";
 import "./chunk-EI7CQQ7D.js";
 import "./chunk-FEK7VJAY.js";
 import "./chunk-RHOWYIWT.js";
 import "./chunk-N4WZLWJ4.js";
-import "./chunk-ELU3XQEA.js";
-import "./chunk-64PONSA5.js";
+import "./chunk-RDUKRIRC.js";
+import "./chunk-GFIR2IIJ.js";
 import "./chunk-KGXPLI7W.js";
-import "./chunk-VUFMZEIM.js";
 export {
   INSTANCE_ALIASES,
   generatePlan,

package/dist/{harden-3KKCR7BL.js → harden-RUOUA5BV.js}

@@ -2,7 +2,7 @@
 import {
   makeTailscaleModule,
   tailscaleModule
-} from "./chunk-X56CQ6GB.js";
+} from "./chunk-4MHDW2NB.js";
 import {
   acquireSession,
   drainPool
@@ -28,7 +28,7 @@ import {
 import {
   resolveProjectId
 } from "./chunk-TC2VYPLH.js";
-import "./chunk-64PONSA5.js";
+import "./chunk-GFIR2IIJ.js";
 import "./chunk-KGXPLI7W.js";
 
 // src/harden/types.ts

package/dist/init-HOPXDNWY.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import {
+  PROVIDER_DEFAULTS,
+  SUPPORTED_PROVIDERS,
+  initStack
+} from "./chunk-755X5OGS.js";
+import "./chunk-GFIR2IIJ.js";
+import "./chunk-KGXPLI7W.js";
+export {
+  PROVIDER_DEFAULTS,
+  SUPPORTED_PROVIDERS,
+  initStack
+};

package/dist/{mcp-wire-B57DUNOD.js → mcp-wire-FIO5DFBY.js}

@@ -1,29 +1,30 @@
 #!/usr/bin/env node
 import {
   MCP_HTTP_PORT
-} from "./chunk-OFTAXLOY.js";
-import "./chunk-R3DTA35B.js";
+} from "./chunk-TYHTISI5.js";
+import "./chunk-7T4CIT7C.js";
+import "./chunk-PTCVFLZ3.js";
 import "./chunk-BOPSG2LI.js";
 import "./chunk-6ZFIFDBJ.js";
 import "./chunk-3QJBNAHW.js";
 import "./chunk-2I7KCMXZ.js";
-import "./chunk-3Z5TDXCJ.js";
-import "./chunk-AEEMRFZV.js";
-import "./chunk-YEBFVLOE.js";
 import "./chunk-XFN3YDZE.js";
+import "./chunk-55UMO37O.js";
+import "./chunk-AEEMRFZV.js";
+import "./chunk-AVERNLUY.js";
 import "./chunk-2Z7J3ERQ.js";
 import "./chunk-E4NJSJ54.js";
 import "./chunk-MC5ATCXS.js";
-import "./chunk-QDNFADJI.js";
-import "./chunk-GFUK6KDR.js";
+import "./chunk-CPCO6UJK.js";
 import "./chunk-NUL5F6YV.js";
 import "./chunk-3OLUJPCB.js";
 import {
   execPrivileged
 } from "./chunk-NUDIHZEH.js";
+import "./chunk-CHNSL3TC.js";
 import "./chunk-JW5A7E3X.js";
 import "./chunk-LT4XMO5D.js";
-import "./chunk-BELTQGHT.js";
+import "./chunk-VUFMZEIM.js";
 import "./chunk-GIEVAGEK.js";
 import "./chunk-VOEJYRIK.js";
 import "./chunk-EI7CQQ7D.js";
@@ -31,10 +32,9 @@ import "./chunk-FEK7VJAY.js";
 import "./chunk-RHOWYIWT.js";
 import "./chunk-Q7NQY5HV.js";
 import "./chunk-N4WZLWJ4.js";
-import "./chunk-ELU3XQEA.js";
-import "./chunk-64PONSA5.js";
+import "./chunk-RDUKRIRC.js";
+import "./chunk-GFIR2IIJ.js";
 import "./chunk-KGXPLI7W.js";
-import "./chunk-VUFMZEIM.js";
 
 // src/cli/mcp-wire.ts
 var GATEWAY_MCP_NAME = "clawops";

package/dist/{package-SAUDFQLG.js → package-MF5LPITL.js}

@@ -2,7 +2,7 @@
 
 // package.json
 var name = "@clawops/cli";
-var version = "2.1.1";
+var version = "2.1.3";
 var description = "Deploy self-hosted OpenClaw to AWS, GCP, Azure or a local VM \u2014 a CLI and an MCP server in one.";
 var keywords = [
   "openclaw",

package/dist/{server-RHON6QMN.js → server-OXWHBTXK.js}

@@ -5,27 +5,28 @@ import {
   bearerFrom,
   isLoopbackBind,
   serveMcp
-} from "./chunk-OFTAXLOY.js";
-import "./chunk-R3DTA35B.js";
+} from "./chunk-TYHTISI5.js";
+import "./chunk-7T4CIT7C.js";
+import "./chunk-PTCVFLZ3.js";
 import "./chunk-BOPSG2LI.js";
 import "./chunk-6ZFIFDBJ.js";
 import "./chunk-3QJBNAHW.js";
 import "./chunk-2I7KCMXZ.js";
-import "./chunk-3Z5TDXCJ.js";
-import "./chunk-AEEMRFZV.js";
-import "./chunk-YEBFVLOE.js";
 import "./chunk-XFN3YDZE.js";
+import "./chunk-55UMO37O.js";
+import "./chunk-AEEMRFZV.js";
+import "./chunk-AVERNLUY.js";
 import "./chunk-2Z7J3ERQ.js";
 import "./chunk-E4NJSJ54.js";
 import "./chunk-MC5ATCXS.js";
-import "./chunk-QDNFADJI.js";
-import "./chunk-GFUK6KDR.js";
+import "./chunk-CPCO6UJK.js";
 import "./chunk-NUL5F6YV.js";
 import "./chunk-3OLUJPCB.js";
 import "./chunk-NUDIHZEH.js";
+import "./chunk-CHNSL3TC.js";
 import "./chunk-JW5A7E3X.js";
 import "./chunk-LT4XMO5D.js";
-import "./chunk-BELTQGHT.js";
+import "./chunk-VUFMZEIM.js";
 import "./chunk-GIEVAGEK.js";
 import "./chunk-VOEJYRIK.js";
 import "./chunk-EI7CQQ7D.js";
@@ -33,10 +34,9 @@ import "./chunk-FEK7VJAY.js";
 import "./chunk-RHOWYIWT.js";
 import "./chunk-Q7NQY5HV.js";
 import "./chunk-N4WZLWJ4.js";
-import "./chunk-ELU3XQEA.js";
-import "./chunk-64PONSA5.js";
+import "./chunk-RDUKRIRC.js";
+import "./chunk-GFIR2IIJ.js";
 import "./chunk-KGXPLI7W.js";
-import "./chunk-VUFMZEIM.js";
 export {
   MCP_HTTP_PORT,
   authRequirement,

package/dist/{stack-config-LUTS2XAD.js → stack-config-ICQ5YHUL.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   writeStackConfig
-} from "./chunk-3Z5TDXCJ.js";
+} from "./chunk-55UMO37O.js";
 import "./chunk-AEEMRFZV.js";
 import "./chunk-VOEJYRIK.js";
 import "./chunk-EI7CQQ7D.js";
-import "./chunk-64PONSA5.js";
+import "./chunk-GFIR2IIJ.js";
 import "./chunk-KGXPLI7W.js";
 export {
   writeStackConfig

package/dist/{state-AOAYLYY5.js → state-AKZP2S4T.js}

@@ -5,8 +5,8 @@ import {
   stateDir,
   statePath,
   writeLocalState
-} from "./chunk-ELU3XQEA.js";
-import "./chunk-64PONSA5.js";
+} from "./chunk-RDUKRIRC.js";
+import "./chunk-GFIR2IIJ.js";
 import "./chunk-KGXPLI7W.js";
 export {
   localStateToConnectionInfo,

package/dist/{store-OVB3DAJR.js → store-YOLQYXMB.js}

@@ -5,7 +5,7 @@ import {
   getConfigPath,
   requireConfig,
   setConfig
-} from "./chunk-64PONSA5.js";
+} from "./chunk-GFIR2IIJ.js";
 import "./chunk-KGXPLI7W.js";
 export {
   getConfig,

package/dist/{tailscale-cutover-6YP2QKFM.js → tailscale-cutover-EKAQSDXP.js}

@@ -3,13 +3,13 @@ import {
   isTailscaleIpv4,
   parseStatus,
   rootPrefix
-} from "./chunk-X56CQ6GB.js";
+} from "./chunk-4MHDW2NB.js";
 import {
   formatKnownHostsLine,
   keyTypeFromBlob,
   verifyAgainstKnownHosts
 } from "./chunk-MC5ATCXS.js";
-import "./chunk-64PONSA5.js";
+import "./chunk-GFIR2IIJ.js";
 import "./chunk-KGXPLI7W.js";
 
 // src/harden/tailscale-cutover.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawops/cli",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "Deploy self-hosted OpenClaw to AWS, GCP, Azure or a local VM — a CLI and an MCP server in one.",
   "keywords": [
     "openclaw",

package/spec/mcp-tools.yaml

@@ -136,8 +136,8 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
-      tailLines: { type: integer, optional: true, default: 100, max: 1000 }
+      stackName: { type: string, optional: true, description: "Which stack's gateway to read. Omitted = the default stack in ~/.clawops/config.json" }
+      tailLines: { type: integer, optional: true, default: 100, max: 1000, description: "How many of the most recent lines to return. Keep it small; output is trimmed to 8KB regardless" }
       sinceMin: { type: integer, optional: true, description: "Lines since N minutes ago" }
     output:
       lines: { type: array, items: { type: string }, description: "Trimmed log lines (R14: hard cap 8KB)" }
@@ -227,7 +227,7 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
+      stackName: { type: string, optional: true, description: "Which stack's gateway config to read. Omitted = the default stack in ~/.clawops/config.json" }
       key: { type: string, optional: true, description: "Dot-path config key, e.g., gateway.auth.mode. Omit to dump the full config." }
     output:
       value: { type: string, description: "Stringified value; complex objects are JSON-encoded" }
@@ -249,7 +249,7 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
+      stackName: { type: string, optional: true, description: "Which stack's agents to list. Omitted = the default stack in ~/.clawops/config.json" }
     output:
       agents:
         type: array
@@ -286,13 +286,13 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
+      stackName: { type: string, optional: true, description: "Name for the stack to provision, and the name every later command refers to it by. Omitted = the default stack in ~/.clawops/config.json" }
       provider:
         type: enum
         values: [aws, gcp, azure, local]
         optional: true
         description: Defaults to provider configured for this stack
-      region: { type: string, optional: true }
+      region: { type: string, optional: true, description: "Cloud region to deploy into, in the provider's own spelling (us-east-1, us-central1, eastus). Omitted = the region recorded for the stack" }
       instanceType:
         type: string
         optional: true
@@ -318,10 +318,10 @@ tools:
         optional: true
         description: Which interface the gateway binds. 'all' serves plaintext HTTP.
       openclawVersion: { type: string, optional: true, description: "semver or 'stable'/'dev'" }
-      dryRun: { type: boolean, optional: true, default: false }
+      dryRun: { type: boolean, optional: true, default: false, description: "Show what would be created and change nothing. Use this first when the user has not yet approved a spend" }
     output:
       taskId: { type: string, description: "For >60s ops; poll clawops_task_status" }
-      stackName: { type: string }
+      stackName: { type: string, description: "Name for the stack to provision, and the name every later command refers to it by. Omitted = the default stack in ~/.clawops/config.json" }
       gatewayUrl: { type: string, format: uri }
       resourceCount: { type: integer }
 
@@ -346,7 +346,7 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string }
+      stackName: { type: string, description: "The stack to destroy. Required, and worth repeating back to the user before calling: this deletes every resource it provisioned" }
       yes: { type: boolean, optional: true, default: false, description: "Skip elicitation; CI/scripted use only" }
     output:
       taskId: { type: string }
@@ -371,7 +371,7 @@ tools:
       openWorldHint: true
     input:
       planPath: { type: string, description: "Absolute path to plan JSON (R7)" }
-      yes: { type: boolean, optional: true, default: false }
+      yes: { type: boolean, optional: true, default: false, description: "Skip the confirmation and apply immediately. Only when the user has already approved this specific plan" }
     output:
       taskId: { type: string }
       summary: { type: string, description: "Trimmed; full output as resource (R14)" }
@@ -394,9 +394,9 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
-      provider: { type: enum, values: [aws, gcp, azure, local], optional: true }
-      region: { type: string, optional: true }
+      stackName: { type: string, optional: true, description: "Which stack the plan is for. Omitted = the default stack in ~/.clawops/config.json" }
+      provider: { type: enum, values: [aws, gcp, azure, local], optional: true, description: "Cloud to plan against. Omitted = the provider recorded for the stack. 'local' has no plan/apply path and is refused" }
+      region: { type: string, optional: true, description: "Cloud region, in the provider's own spelling (us-east-1, us-central1, eastus). Omitted = the region recorded for the stack" }
       instanceType: { type: string, optional: true, description: "A clawops alias (micro|small|medium|large|gpu) or a machine type the cloud names itself, e.g. t3.small" }
       openclawVersion: { type: string, optional: true, description: "semver, or 'stable'/'dev'" }
       sshCidr: { type: string, optional: true, description: "CIDR(s) allowed to reach SSH, comma-separated, or 'auto' for this machine. Omitted = none, and nothing will be able to connect" }
@@ -428,10 +428,10 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
-      key: { type: string }
+      stackName: { type: string, optional: true, description: "Which stack's gateway config to write. Omitted = the default stack in ~/.clawops/config.json" }
+      key: { type: string, description: "Dotted path into the gateway config, e.g. models.provider or channels.slack.enabled" }
       value: { type: string, description: "Stringified; JSON for complex values" }
-      restart: { type: boolean, optional: true, default: false }
+      restart: { type: boolean, optional: true, default: false, description: "Restart the gateway so the change takes effect. Without it the value is written and the running gateway keeps the old one" }
     output:
       message: { type: string, description: "Confirmation of the change applied" }
 
@@ -453,9 +453,9 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
+      stackName: { type: string, optional: true, description: "Which stack's gateway config to write. Omitted = the default stack in ~/.clawops/config.json" }
       key: { type: string, description: "Dot-path config key to remove" }
-      restart: { type: boolean, optional: true, default: false }
+      restart: { type: boolean, optional: true, default: false, description: "Restart the gateway so the removal takes effect. Without it the key is removed and the running gateway keeps the old value" }
     output:
       message: { type: string, description: "Confirmation of the key removed" }
 
@@ -477,7 +477,7 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
+      stackName: { type: string, optional: true, description: "Which stack's deployed config to validate. Omitted = the default stack in ~/.clawops/config.json" }
     output:
       valid: { type: boolean }
       issues: { type: array, items: { type: string } }
@@ -499,7 +499,7 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
+      stackName: { type: string, optional: true, description: "Which stack's gateway to restart. Omitted = the default stack in ~/.clawops/config.json" }
     output:
       restartedAt: { type: string, format: date-time }
       previousUptimeSec: { type: integer }
@@ -508,6 +508,47 @@ tools:
 # COMPOSITE WORKFLOW TOOLS (R2: encode user intent, not API sequences)
 # ────────────────────────────────────────────────────────────────────────────
 
+  - name: clawops_init
+    toolset: [cli]
+    description: |
+      Register a stack and write ~/.clawops/config.json: the provider, the state backend, the
+      region, and an SSH key pair generated if one is not already there. Nothing is provisioned
+      and nothing is charged; this only creates local configuration.
+
+      Use when: any other clawops tool reports that there is no config, or the user wants to add
+      a second stack alongside the ones they have. This is the first call on a machine that has
+      never run clawops — a fresh container, a new laptop, a sandbox.
+
+      Adding a stack is additive and safe: existing stacks are kept. Overwriting one needs
+      force: true, because changing a state backend orphans the Pulumi state it points at — the
+      infrastructure stays up and clawops can no longer see or destroy it.
+
+      For aws, gcp and azure, stateUrl can be omitted and clawops names a bucket from the
+      account it can see; that needs cloud credentials in the environment, so in a sandbox pass
+      stateUrl explicitly. The local provider needs host instead, and no cloud account at all.
+
+      Do NOT use when: the user wants to deploy — that is clawops_up, after this. Credentials
+      are never passed here: clawops reads them from the environment (R6).
+    annotations:
+      title: Initialise clawops Config
+      readOnlyHint: false
+      destructiveHint: false
+      idempotentHint: false
+      openWorldHint: false
+    input:
+      provider: { type: enum, values: [aws, gcp, azure, local], description: "Which cloud this stack deploys to, or 'local' for a machine you already have" }
+      stackName: { type: string, optional: true, description: "Name for the stack, used by every later call. Omitted = \"default\"" }
+      stateUrl: { type: string, optional: true, description: "Where Pulumi state lives, e.g. s3://bucket/clawops, gs://bucket/clawops, azblob://container. Omitted = clawops names one from the cloud account it can see, which needs credentials" }
+      region: { type: string, optional: true, description: "Cloud region in the provider's own spelling. Omitted = us-east-1 (aws), us-central1 (gcp), eastus (azure)" }
+      host: { type: string, optional: true, description: "[local only] Hostname or IP of the machine to manage. Required when provider is local" }
+      sshUser: { type: string, optional: true, description: "[local only] SSH login user. Omitted = root" }
+      sshPort: { type: integer, optional: true, description: "[local only] SSH port. Omitted = 22" }
+      force: { type: boolean, optional: true, description: "Overwrite a stack that already exists. Refused without it, because replacing a state backend orphans the state it points at" }
+    output:
+      configPath: { type: string }
+      stackName: { type: string }
+      stateUrl: { type: string }
+
   - name: clawops_harden
     toolset: [cli]
     description: |
@@ -543,7 +584,7 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
+      stackName: { type: string, optional: true, description: "Which stack to harden. Omitted = the default stack in ~/.clawops/config.json" }
       options: { type: string, optional: true, description: "Comma-separated module IDs; default is every defaultOn module for the provider" }
       dryRun: { type: boolean, optional: true, default: false, description: "Report the current state, change nothing" }
       tailscale: { type: boolean, optional: true, default: false, description: "Join the tailnet, verify this machine reaches the host there, then use that address" }
@@ -577,14 +618,14 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      provider: { type: enum, values: [aws, gcp, azure, local] }
-      region: { type: string, optional: true }
-      stackName: { type: string, optional: true, default: "default" }
-      instanceType: { type: enum, values: [micro, small, medium, large, gpu], optional: true, default: small }
+      provider: { type: enum, values: [aws, gcp, azure, local], description: "Cloud to deploy to. Omitted = the default provider in ~/.clawops/config.json" }
+      region: { type: string, optional: true, description: "Cloud region, in the provider's own spelling (us-east-1, us-central1, eastus). Omitted = the provider's default" }
+      stackName: { type: string, optional: true, default: "default", description: "Name for the new stack. Omitted = the default stack name in ~/.clawops/config.json" }
+      instanceType: { type: enum, values: [micro, small, medium, large, gpu], optional: true, default: small, description: "Machine size: a clawops alias (micro|small|medium|large|gpu) or a type the cloud names itself, e.g. t3.small" }
     output:
       taskId: { type: string }
       gatewayUrl: { type: string, format: uri }
-      stackName: { type: string }
+      stackName: { type: string, description: "Name for the new stack. Omitted = the default stack name in ~/.clawops/config.json" }
 
   - name: clawops_workflow_recover
     toolset: [workflow, read]
@@ -605,7 +646,7 @@ tools:
       idempotentHint: true
       openWorldHint: true
     input:
-      stackName: { type: string, optional: true }
+      stackName: { type: string, optional: true, description: "Which stack to diagnose. Omitted = the default stack in ~/.clawops/config.json" }
     output:
       report:
         type: object
@@ -633,7 +674,7 @@ tools:
       idempotentHint: true
       openWorldHint: false
     input:
-      taskId: { type: string }
+      taskId: { type: string, description: "The taskId returned by a long-running tool such as clawops_up, clawops_apply or clawops_destroy" }
     output:
       status: { type: enum, values: [working, input_required, completed, failed, cancelled] }
       progress: { type: number, minimum: 0, maximum: 1 }

package/dist/{chunk-BELTQGHT.js → chunk-CHNSL3TC.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  registerProvider
+} from "./chunk-VUFMZEIM.js";
 import {
   CONFIG_FILENAME,
   CONTAINER_UID,
@@ -17,9 +20,6 @@ import {
 import {
   INSTANCE_TYPE_MAP
 } from "./chunk-N4WZLWJ4.js";
-import {
-  registerProvider
-} from "./chunk-VUFMZEIM.js";
 
 // src/providers/aws/index.ts
 import process2 from "process";