@cotal-ai/cli 0.9.1 → 0.10.0

package/dist/index.js

@@ -1,14 +1,15 @@
 import { registry } from "@cotal-ai/core";
+import { targetFlags } from "@cotal-ai/workspace";
 import { up } from "./commands/up.js";
 import { down } from "./commands/down.js";
 import { use, useComplete } from "./commands/use.js";
 import { meshes } from "./commands/meshes.js";
-import { setup, go } from "./commands/setup.js";
+import { setup, setupFlags } from "./commands/setup.js";
 import { join } from "./commands/join.js";
 import { console_ } from "./commands/console.js";
-import { demo } from "./commands/demo.js";
-import { web } from "./commands/web.js";
-import { spawn, spawnComplete } from "./commands/spawn.js";
+import { spawn, spawnComplete, spawnFlags } from "./commands/spawn.js";
+import { attach, attachFlags, managedAgentComplete, ps, psFlags, stop, stopFlags } from "./commands/agents.js";
+import { c } from "./ui.js";
 import { personas, personasComplete } from "./commands/personas.js";
 import { completion, completionComplete, complete } from "./commands/completion.js";
 import { mint } from "./commands/mint.js";
@@ -16,38 +17,83 @@ import { channels } from "./commands/channels.js";
 import { history } from "./commands/history.js";
 import { feedback } from "./commands/feedback.js";
 import { send, sendComplete } from "./commands/send.js";
+import { ext } from "./commands/ext.js";
 import { topology } from "./commands/topology.js";
-/** The minimal mesh CLI: thin NATS clients (up/join/console), plus `spawn` — a
- *  foreground agent launch that reuses the connector's launch recipe. Self-registers
- *  on import; heavier surfaces (the manager's control plane) register the same way
- *  and are composed at a root. */
+/** The minimal mesh CLI: thin NATS clients (up/join/console), plus `spawn` — an agent launch
+ *  (foreground or --detach) that reuses the connector's launch recipe. Self-registers on import;
+ *  heavier surfaces (the manager daemon, delivery) register the same way and are composed at a
+ *  root. Flags are DECLARED (here or co-located with the command) — the dispatcher parses them,
+ *  generates each command's help/usage/completion, and hands `run` the parsed args. Groups follow
+ *  the user's mental model (Setup · Mesh · Messaging · Agents · Observe), and the array is ordered
+ *  by group — the help listing renders groups in first-seen order. */
 const baseCommands = [
+    // ---- Setup --------------------------------------------------------------------------------
     {
         kind: "command",
         name: "setup",
         group: "Setup",
-        summary: "guided setup — first run walks you through it; --yes for non-interactive (agents/CI), --full to redo",
+        summary: "guided setup (configure-only: installs + seeds, launches nothing) — --yes non-interactive, --full to redo",
+        flags: setupFlags,
         run: setup,
     },
     {
         kind: "command",
-        name: "go",
+        name: "ext",
         group: "Setup",
-        summary: "open or resume your session (mesh + web + manager + your cmux tabs); first run installs",
-        run: go,
+        summary: "operator-installed CLI extensions — add an npm package's commands to this CLI",
+        usage: "ext <add <npm-package> | remove <name> | list>",
+        positionals: "<add <npm-package> | remove <name> | list>",
+        run: ext,
     },
+    {
+        kind: "command",
+        name: "completion",
+        group: "Setup",
+        summary: "shell completion — print a stub or install it persistently",
+        usage: "completion <bash|zsh|fish|powershell | install [shell]>",
+        positionals: "<bash|zsh|fish|powershell | install [shell]>",
+        run: completion,
+        complete: completionComplete,
+    },
+    {
+        kind: "command",
+        name: "__complete",
+        group: "Setup",
+        summary: "(internal) emit completion candidates for the current command line",
+        rawArgs: true,
+        positionals: "<words…>",
+        run: complete,
+    },
+    // ---- Mesh ---------------------------------------------------------------------------------
     {
         kind: "command",
         name: "up",
         group: "Mesh",
-        summary: "start a local nats-server (JetStream, JWT auth by default; --open for an unauthenticated dev mesh) — or `-f <cotal.yaml>` to launch a whole mesh from a manifest [--dry-run; --server/--host/--space/--runtime/--open override the file]",
+        summary: "start a local mesh (nats-server + JetStream, JWT auth by default) — or `-f <cotal.yaml>` for a whole manifest",
+        flags: [
+            { name: "server", type: "string", value: "<url>", description: "listen URL override" },
+            { name: "host", type: "string", value: "<host>", description: "bind host override" },
+            { name: "space", type: "string", value: "<s>", description: "space name (default: the folder's)" },
+            { name: "store-dir", type: "string", value: "<dir>", description: "JetStream store directory" },
+            { name: "channels", type: "string", value: "<a,b>", description: "channels to pre-create" },
+            { name: "open", type: "boolean", description: "unauthenticated dev mesh (no JWT/ACLs)" },
+            { name: "detach", type: "boolean", description: "run in the background (stop with `cotal down`)" },
+            { name: "runtime", type: "string", value: "<pty|tmux|cmux>", description: "with -f: override the manifest's runtime" },
+            { name: "file", type: "string", short: "f", value: "<cotal.yaml>", description: "launch a whole mesh from a manifest" },
+            { name: "dry-run", type: "boolean", description: "with -f: print the plan, mutate nothing" },
+        ],
         run: up,
     },
     {
         kind: "command",
         name: "down",
         group: "Mesh",
-        summary: "stop a background mesh started with `up --detach` — or `-f <cotal.yaml>` / `--run <id>` for an ownership-scoped teardown of a `spawn -f` deploy [--dry-run] (run from its project — local only)",
+        summary: "stop a background mesh — or `-f <cotal.yaml>` / `--run <id>` to tear down a `spawn -f` deploy",
+        flags: [
+            { name: "file", type: "string", short: "f", value: "<cotal.yaml>", description: "tear down this manifest's deploy" },
+            { name: "run", type: "string", value: "<id>", description: "tear down one `spawn -f` run by id" },
+            { name: "dry-run", type: "boolean", description: "print the plan, mutate nothing" },
+        ],
         run: down,
     },
     {
@@ -61,7 +107,8 @@ const baseCommands = [
         kind: "command",
         name: "use",
         group: "Mesh",
-        summary: "set the default mesh for a bare `cotal spawn` when several are running — use <space>",
+        summary: "set the default mesh for a bare `cotal spawn` when several are running",
+        positionals: "<space>",
         run: use,
         complete: useComplete,
     },
@@ -70,109 +117,195 @@ const baseCommands = [
         name: "join",
         group: "Mesh",
         summary: "join a space (interactive) — --space <s> --name <n> [--role <r>]",
+        flags: [
+            ...targetFlags,
+            { name: "name", type: "string", value: "<n>", description: "your presence name" },
+            { name: "role", type: "string", value: "<r>", description: "your role" },
+            { name: "channel", type: "string", value: "<c>", description: "channel to join" },
+            { name: "kind", type: "string", value: "<k>", description: "endpoint kind" },
+            { name: "link", type: "string", value: "<url>", description: "join link" },
+            { name: "token", type: "string", value: "<t>", description: "join token" },
+            { name: "tls", type: "boolean", description: "connect over TLS" },
+        ],
         run: join,
     },
     {
         kind: "command",
-        name: "send",
+        name: "mint",
         group: "Mesh",
-        summary: "send one message, then exit — send <dm <agent> | msg <channel> | ask <role>> \"<text>\"",
+        summary: "mint a creds file for a space (auth mode); --signer emits a stripped account-signing file",
+        positionals: "<name>",
+        flags: [
+            { name: "profile", type: "string", value: "<agent|observer|admin>", description: "cred profile (default agent)" },
+            { name: "out", type: "string", value: "<path>", description: "output path (default .cotal/auth/creds/<name>.creds)" },
+            { name: "signer", type: "boolean", description: "emit a stripped account-signing file instead" },
+            { name: "force", type: "boolean", description: "with --signer: overwrite an existing file" },
+            { name: "allow-subscribe", type: "string", value: "<a,b>", description: "read ACL override (comma-separated)" },
+            { name: "allow-publish", type: "string", value: "<a,b>", description: "post ACL override (comma-separated)" },
+        ],
+        run: mint,
+    },
+    {
+        kind: "command",
+        name: "topology",
+        group: "Mesh",
+        summary: "validate + view a mesh manifest's access graph (read-only)",
+        positionals: "<view>",
+        flags: [{ name: "file", type: "string", short: "f", value: "<cotal.yaml>", description: "the manifest to inspect" }],
+        run: topology,
+    },
+    // ---- Messaging ----------------------------------------------------------------------------
+    {
+        kind: "command",
+        name: "send",
+        group: "Messaging",
+        summary: "send one message, then exit — dm a peer, msg a channel, or ask a role",
         usage: 'send <dm <agent> | msg <channel> | ask <role>> "<text>"  [--space <s>] [--server <url>] [--creds <path>]',
+        positionals: '<dm <agent> | msg <channel> | ask <role>> "<text>"',
+        flags: [...targetFlags],
         run: send,
         complete: sendComplete,
     },
     {
         kind: "command",
-        name: "console",
-        group: "Mesh",
-        summary: "live protocol view for a space — lazygit-style TUI, or a line stream on --plain — --space <s> [--plain]",
-        run: console_,
+        name: "channels",
+        group: "Messaging",
+        summary: "inspect/set the channel registry (replay policy, description, instructions)",
+        usage: "channels <list | set <name> [--replay|--no-replay] [--desc <s>] [--instructions <s>] | default --replay|--no-replay>",
+        positionals: "<list | set <name> | default>",
+        flags: [
+            ...targetFlags,
+            { name: "replay", type: "boolean", description: "set/default: replay history to new joiners" },
+            { name: "no-replay", type: "boolean", description: "set/default: don't replay history" },
+            { name: "window", type: "string", value: "<n>", description: "set: replay window size" },
+            { name: "desc", type: "string", value: "<s>", description: "set: one-line channel description" },
+            { name: "instructions", type: "string", value: "<s>", description: "set: instructions shown to joiners" },
+        ],
+        run: channels,
     },
     {
         kind: "command",
-        name: "demo",
-        group: "Mesh",
-        // A dev/test traffic generator (see docs/protocol-view.md) — runnable, but kept off the
-        // top-level help so it doesn't clutter the user-facing surface.
-        hidden: true,
-        summary: "replay a scripted multi-agent trace (all message types) to exercise the console/web — --space <s> [--interval <ms>] [--once]",
-        run: demo,
+        name: "history",
+        group: "Messaging",
+        summary: "clear retained message history",
+        usage: "history clear --force [--dms] [--space <s>]",
+        positionals: "<clear>",
+        flags: [
+            ...targetFlags,
+            { name: "dms", type: "boolean", description: "also clear DM history" },
+            { name: "force", type: "boolean", description: "required — clear without prompting" },
+        ],
+        run: history,
     },
     {
         kind: "command",
-        name: "web",
-        group: "Mesh",
-        summary: "browser observability dashboard — presence, channels, live feed — --space <s> [--port <n>] [--no-open]",
-        run: web,
+        name: "feedback",
+        group: "Messaging",
+        summary: 'send feedback to the Cotal developers — feedback "<summary>" [--type <t>] [--email <e>]',
+        positionals: '"<summary>"',
+        flags: [
+            { name: "type", type: "string", value: "<t>", description: "bug | idea | friction | praise | other" },
+            { name: "details", type: "string", value: "<text>", description: "longer free-form details" },
+            { name: "severity", type: "string", value: "<s>", description: "low | medium | high" },
+            { name: "area", type: "string", value: "<a>", description: "the part of Cotal this concerns" },
+            { name: "email", type: "string", value: "<e>", description: "contact email (required on the keyless public path)" },
+            { name: "name", type: "string", value: "<n>", description: "your name (optional)" },
+            { name: "url", type: "string", value: "<url>", description: "intake URL override" },
+            { name: "key", type: "string", value: "<k>", description: "feedback key (default: COTAL_FEEDBACK_KEY)" },
+        ],
+        run: feedback,
     },
+    // ---- Agents -------------------------------------------------------------------------------
     {
         kind: "command",
         name: "spawn",
         group: "Agents",
-        summary: "launch an agent in this terminal from a file — spawn [<name-or-path>] (defaults to the `default` persona) | --name <n> --config <path> [--agent <a>] [--role <r>] [--resume <id>]",
+        summary: "launch an agent from a persona — spawn [<persona>] (defaults to COTAL_DEFAULT_PERSONA or `default`); --config accepts a persona name or path; foreground here, or --detach via the manager",
+        positionals: "[<persona>]",
+        flags: spawnFlags,
         run: spawn,
         complete: spawnComplete,
     },
     {
         kind: "command",
-        name: "personas",
+        name: "start",
         group: "Agents",
-        summary: "list/manage local personas (.cotal/agents) — personas <list [-v] [--running] | show <name> | edit <name> | new <name> (--prompt <t>|--from <f>) [--role <r>] [--model <m>] | rm <name> --force>",
-        run: personas,
-        complete: personasComplete,
+        // Tombstone (stage 2a): the verb is gone, the ability moved. Errors with the replacement —
+        // never a silent alias (no fallbacks). Hidden: not part of the surface, just a signpost.
+        hidden: true,
+        rawArgs: true,
+        positionals: "…",
+        summary: "(removed) `cotal start` was merged into `cotal spawn --detach`",
+        run: async () => {
+            console.error(c.red("✗ `cotal start` was merged into `cotal spawn --detach` — one launch grammar for foreground and detached (persona positional or --config; --name/--model/--cwd/--prompt/--subscribe/--allow-*/--share-tools all apply)"));
+            process.exit(1);
+        },
     },
     {
         kind: "command",
-        name: "completion",
+        name: "stop",
         group: "Agents",
-        summary: "shell completion — completion <bash|zsh|fish|powershell | install [shell]>",
-        run: completion,
-        complete: completionComplete,
+        summary: "ask the manager to stop an agent — --name <n>",
+        flags: stopFlags,
+        run: stop,
+        complete: managedAgentComplete,
     },
     {
         kind: "command",
-        name: "__complete",
+        name: "ps",
         group: "Agents",
-        summary: "(internal) emit completion candidates for the current command line",
-        run: complete,
-    },
-    {
-        kind: "command",
-        name: "mint",
-        group: "Mesh",
-        summary: "mint a creds file for a space (auth mode) — mint <name> --profile <agent|observer> [--out <path>]; --signer emits a stripped account-signing file (no operator key) for a containerized manager",
-        run: mint,
-    },
-    {
-        kind: "command",
-        name: "topology",
-        group: "Mesh",
-        summary: "validate + view a mesh manifest's access graph — topology view -f <cotal.yaml> (read-only; mutates nothing)",
-        run: topology,
+        summary: "list managed agents + their mesh status",
+        flags: psFlags,
+        run: ps,
     },
     {
         kind: "command",
-        name: "channels",
-        group: "Mesh",
-        summary: "inspect/set channel registry — channels <list | set <name> [--replay|--no-replay] [--desc <s>] [--instructions <s>] | default --replay|--no-replay>",
-        run: channels,
+        name: "attach",
+        group: "Agents",
+        summary: "stream + drive an agent's terminal (pty runtime) — --name <n>",
+        flags: attachFlags,
+        run: attach,
+        complete: managedAgentComplete,
     },
     {
         kind: "command",
-        name: "history",
-        group: "Mesh",
-        summary: "clear retained message history — history clear --force [--dms] [--space <s>]",
-        run: history,
+        name: "personas",
+        group: "Agents",
+        summary: "list/manage local personas (.cotal/agents)",
+        usage: "personas <list [-v] [--running] | show <name> | edit <name> | new <name> (--prompt <t>|--from <f>) [--role <r>] [--model <m>] | rm <name> --force>",
+        positionals: "<list | show <name> | edit <name> | new <name> | rm <name>>",
+        flags: [
+            ...targetFlags,
+            { name: "role", type: "string", value: "<r>", description: "new: the persona's role" },
+            { name: "model", type: "string", value: "<m>", description: "new: the persona's model" },
+            { name: "prompt", type: "string", value: "<t>", description: "new: the persona's prompt text" },
+            { name: "from", type: "string", value: "<f>", description: "new: seed the prompt from a file" },
+            { name: "verbose", type: "boolean", short: "v", description: "list: include role/model/description" },
+            { name: "running", type: "boolean", description: "list: mark personas live on the mesh" },
+            { name: "force", type: "boolean", description: "rm: required — delete without prompting" },
+        ],
+        run: personas,
+        complete: personasComplete,
     },
+    // ---- Observe ------------------------------------------------------------------------------
     {
         kind: "command",
-        name: "feedback",
-        group: "Mesh",
-        summary: 'send feedback — feedback "<summary>" [--type <t>] [--email <e>] — or run the intake server: feedback --keys <keys.json> --creds <creds> [--port <n>]',
-        run: feedback,
+        name: "console",
+        group: "Observe",
+        summary: "live protocol view for a space — lazygit-style TUI, or a line stream on --plain",
+        flags: [...targetFlags, { name: "plain", type: "boolean", description: "line stream instead of the TUI" }],
+        run: console_,
     },
+    // `web` (dashboard) moved out to the `cotal-web` extension package (stage 4) — installed via
+    // `cotal ext add`, it self-registers here and appears in this same surface.
 ];
 registry.register(...baseCommands);
 export { runCli } from "./command.js";
 export { c, statusBadge } from "./ui.js";
+// The full spawn grammar, for the composition root's launch-parity smoke (grammar ⊆ start-op ⊆ MCP).
+export { spawnFlags } from "./commands/spawn.js";
+// The launch-client timeout + the manifest launch client, for the same smoke: every launch door
+// must outlive the manager's readiness wait (#159 B1).
+export { START_TIMEOUT_MS } from "./lib/control.js";
+export { launchAgent } from "./lib/manifest/live.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/attach-client.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The detach key — Ctrl-] (0x1d) by default, as in telnet/ssh escape conventions. `COTAL_DETACH_KEY`
+ * rebinds it to another control key when Ctrl-] clashes with a keybinding inside the agent's TUI;
+ * accepts `ctrl-<char>` or `^<char>` (e.g. `ctrl-b`, `^_`). Read at point of use, per the repo's
+ * `COTAL_*` convention. An unparseable value — including a set-but-empty or whitespace-only one —
+ * throws (named), never silently falling back; the caller turns that into a loud exit. Only an
+ * unset var = the Ctrl-] default.
+ */
+export declare function detachKey(): {
+    byte: number;
+    label: string;
+    overridden: boolean;
+};
+/**
+ * Drive a manager's attach endpoint from the terminal: raw-mode stdin streams to
+ * the PTY, PTY output streams to stdout, and SIGWINCH-style resizes are forwarded.
+ * The detach key (Ctrl-] by default, {@link detachKey}) detaches without killing the agent.
+ */
+export declare function attachClient(url: string): Promise<void>;
+//# sourceMappingURL=attach-client.d.ts.map

package/dist/lib/attach-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-client.d.ts","sourceRoot":"","sources":["../../src/lib/attach-client.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAYhF;AAwDD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmIvD"}