cotal-ai 0.109.24 → 0.110.0

package/dist/daemon/command.js

@@ -350,17 +350,17 @@ const daemonCommand = {
     positionals: "<status|serve|login|connect-check|register|service-connect|service-disconnect|service-status>",
     flags: daemonFlags,
     subcommands: [
-        { name: "status", summary: "ask the running daemon for its status over the local endpoint", flagNames: ["daemon-home", "json", "plain"], outputs: ["json", "plain"], reads: true, prepareMeshTarget: false },
-        { name: "serve", summary: "run the daemon in the foreground and serve its local endpoint (refusals honor --json)", flagNames: ["daemon-home", "json", "plain"], outputs: ["json", "plain"], prepareMeshTarget: false },
-        { name: "login", summary: "sign the running daemon in to a provider with device approval; the daemon keeps the session", flagNames: ["idp", "client-id", "daemon-home", "json", "plain"], outputs: ["json", "plain"], prepareMeshTarget: false },
-        { name: "connect-check", summary: "ask the running daemon whether it could register with a space as its own service; registers nothing", flagNames: ["space", "daemon-home", "json", "plain"], outputs: ["json", "plain"], reads: true, prepareMeshTarget: false },
-        { name: "register", summary: "ask the running daemon to request its own service registration with a space; the space owner must approve it, and it does not connect", flagNames: ["space", "daemon-home", "json", "plain"], outputs: ["json", "plain"], prepareMeshTarget: false },
-        { name: "service-connect", summary: "connect the running daemon to a space as its own approved service; succeeds only when the broker accepts the connection and the space accepts it as ready", flagNames: ["space", "daemon-home", "json", "plain"], outputs: ["json", "plain"], prepareMeshTarget: false },
-        { name: "service-disconnect", summary: "close the running daemon's service connection to a space", flagNames: ["space", "daemon-home", "json", "plain"], outputs: ["json", "plain"], prepareMeshTarget: false },
-        { name: "service-status", summary: "read the running daemon's service connection to a space, without contacting it", flagNames: ["space", "daemon-home", "json", "plain"], outputs: ["json", "plain"], reads: true, prepareMeshTarget: false },
+        { name: "status", summary: "ask the running daemon for its status over the local endpoint", examples: [{ command: "cotal daemon status", note: "ask the running daemon for its status" }, { command: "cotal daemon status --json", note: "the same as one JSON document" }], flagNames: ["daemon-home", "json", "plain"], outputs: ["json", "plain"], reads: true, prepareMeshTarget: false },
+        { name: "serve", summary: "run the daemon in the foreground and serve its local endpoint (refusals honor --json)", examples: [{ command: "cotal daemon serve", note: "run the machine daemon in this terminal" }], flagNames: ["daemon-home", "json", "plain"], outputs: ["json", "plain"], prepareMeshTarget: false },
+        { name: "login", summary: "sign the running daemon in to a provider with device approval; the daemon keeps the session", examples: [{ command: "cotal daemon login --idp <url>", note: "sign the daemon in with device approval" }], flagNames: ["idp", "client-id", "daemon-home", "json", "plain"], outputs: ["json", "plain"], prepareMeshTarget: false },
+        { name: "connect-check", summary: "ask the running daemon whether it could register with a space as its own service; registers nothing", examples: [{ command: "cotal daemon connect-check --space <space>", note: "check whether it could register" }], flagNames: ["space", "daemon-home", "json", "plain"], outputs: ["json", "plain"], reads: true, prepareMeshTarget: false },
+        { name: "register", summary: "ask the running daemon to request its own service registration with a space; the space owner must approve it, and it does not connect", examples: [{ command: "cotal daemon register --space <space>", note: "ask a space to approve it as a service" }], flagNames: ["space", "daemon-home", "json", "plain"], outputs: ["json", "plain"], prepareMeshTarget: false },
+        { name: "service-connect", summary: "connect the running daemon to a space as its own approved service; succeeds only when the broker accepts the connection and the space accepts it as ready", examples: [{ command: "cotal daemon service-connect --space <space>", note: "connect it to a space" }], flagNames: ["space", "daemon-home", "json", "plain"], outputs: ["json", "plain"], prepareMeshTarget: false },
+        { name: "service-disconnect", summary: "close the running daemon's service connection to a space", examples: [{ command: "cotal daemon service-disconnect --space <space>", note: "close its service connection to a space" }], flagNames: ["space", "daemon-home", "json", "plain"], outputs: ["json", "plain"], prepareMeshTarget: false },
+        { name: "service-status", summary: "read the running daemon's service connection to a space, without contacting it", examples: [{ command: "cotal daemon service-status --space <space>", note: "read the state of that connection" }], flagNames: ["space", "daemon-home", "json", "plain"], outputs: ["json", "plain"], reads: true, prepareMeshTarget: false },
     ],
     prepareMeshTarget: false,
-    examples: ["cotal daemon serve", "cotal daemon status", "cotal daemon status --json", "cotal daemon login --idp https://example.org/api/auth", "cotal daemon connect-check --space acme", "cotal daemon register --space acme", "cotal daemon service-connect --space acme", "cotal daemon service-status --space acme"],
+    examples: [{ command: "cotal daemon serve", note: "run the machine daemon in this terminal" }, { command: "cotal daemon status", note: "ask the running daemon for its status" }, { command: "cotal daemon login --idp <url>", note: "sign the daemon in with device approval" }],
     run,
 };
 registry.register(daemonCommand);

package/dist/docs.js

@@ -161,7 +161,7 @@ const docsCommand = {
     positionals: "[<page>]",
     flags: docsFlags,
     outputs: ["json", "plain"],
-    examples: ["cotal docs", "cotal docs architecture", "cotal docs --search allowSubscribe", "cotal docs spec --refresh"],
+    examples: [{ command: "cotal docs", note: "list the docs pages bundled with this version" }, { command: "cotal docs cli", note: "read the CLI reference" }, { command: "cotal docs --search <query>", note: "find the sections that match a query" }],
     reads: true,
     run: docs,
     complete: docsComplete,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cotal-ai",
-  "version": "0.109.24",
+  "version": "0.110.0",
   "description": "Cotal — lateral agent coordination over NATS. Run `npx cotal-ai` for the CLI.",
   "license": "Apache-2.0",
   "keywords": [
@@ -33,26 +33,26 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@cotal-ai/auth": "0.109.24",
-    "@cotal-ai/cli": "0.109.24",
-    "@cotal-ai/connector-core": "0.109.24",
-    "@cotal-ai/core": "0.109.24",
-    "@cotal-ai/delivery": "0.109.24",
-    "@cotal-ai/manager": "0.109.24",
-    "@cotal-ai/runtime": "0.109.24",
-    "@cotal-ai/seat": "0.109.24",
-    "@cotal-ai/workspace": "0.109.24"
+    "@cotal-ai/auth": "0.110.0",
+    "@cotal-ai/cli": "0.110.0",
+    "@cotal-ai/connector-core": "0.110.0",
+    "@cotal-ai/core": "0.110.0",
+    "@cotal-ai/delivery": "0.110.0",
+    "@cotal-ai/manager": "0.110.0",
+    "@cotal-ai/runtime": "0.110.0",
+    "@cotal-ai/seat": "0.110.0",
+    "@cotal-ai/workspace": "0.110.0"
   },
   "devDependencies": {
-    "@cotal-ai/connector-claude-code": "0.109.24",
-    "@cotal-ai/connector-codex": "0.109.24",
-    "@cotal-ai/connector-hermes": "0.109.24",
-    "@cotal-ai/connector-jcode": "0.109.24",
-    "@cotal-ai/connector-opencode": "0.109.24",
-    "@cotal-ai/linear": "0.109.24",
-    "@cotal-ai/pi": "0.109.24",
+    "@cotal-ai/connector-claude-code": "0.110.0",
+    "@cotal-ai/connector-codex": "0.110.0",
+    "@cotal-ai/connector-hermes": "0.110.0",
+    "@cotal-ai/connector-jcode": "0.110.0",
+    "@cotal-ai/connector-opencode": "0.110.0",
+    "@cotal-ai/linear": "0.110.0",
+    "@cotal-ai/pi": "0.110.0",
     "@cotal-ai/smoke-kit": "0.0.0",
-    "@cotal-ai/web": "0.109.24",
+    "@cotal-ai/web": "0.110.0",
     "@nats-io/jetstream": "^3.4.0",
     "@nats-io/transport-node": "^3.4.0",
     "typescript": "^5.9.3"