cotal-ai 0.0.1 → 0.3.0

package/README.md

@@ -1,6 +1,13 @@
 # cotal-ai
 
-Reserved for **Cotal** — a standard wire interface for AI agents to coordinate as
-lateral peers in a shared pub/sub space. Implementation ships as the
-[`@cotal-ai/*`](https://www.npmjs.com/org/cotal-ai) packages. See the
-[repository](https://github.com/Cotal-AI/Cotal).
+The `cotal` CLI for **Cotal** — a standard wire interface for AI agents to coordinate
+as lateral peers in a shared pub/sub space (NATS + JetStream).
+
+```bash
+npx cotal-ai            # guided first-run setup: NATS, mesh, agent connectors
+npx cotal-ai up         # start a local mesh
+npx cotal-ai join --space demo --name you
+```
+
+Libraries ship as the [`@cotal-ai/*`](https://www.npmjs.com/org/cotal-ai) packages.
+See the [repository](https://github.com/Cotal-AI/Cotal) for docs.

package/dist/cotal.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * Composition root for the `cotal` operator CLI, published as `cotal-ai`. Importing an
+ * implementation self-registers its commands into the shared registry — base mesh commands
+ * plus `spawn`/`console` (@cotal-ai/cli) and the manager's control plane + daemon runners
+ * (@cotal-ai/manager). The root just picks which surfaces to pull in; `runCli` resolves
+ * whatever registered. A new surface (another connector, a control client …) is one more import line.
+ */
+import { runCli } from "@cotal-ai/cli"; // self-registers up / down / join / watch / spawn / console / setup
+import "@cotal-ai/manager"; // self-registers supervise / cmux / start / stop / ps / attach
+import "@cotal-ai/connector-claude-code"; // registers the `claude` connector that spawn / start resolve
+import "@cotal-ai/connector-opencode"; // registers the `opencode` connector (native in-process plugin)
+import "@cotal-ai/connector-hermes"; // registers the `hermes` connector (Nous Research gateway as a mesh peer)
+import "@cotal-ai/cmux"; // opt into the cmux integration — registers the `cmux` runtime + TerminalLayout providers
+import { claudeConnector } from "@cotal-ai/connector-claude-code";
+import { registry } from "@cotal-ai/core";
+// The manager's default agent type is "cotal"; make it a real Claude coder so a bare
+// cotal_spawn / `cotal start --name x` (no --agent) brings up a Claude Code session.
+registry.register({ ...claudeConnector, name: "cotal" });
+// Bare `npx cotal-ai` = guided first-run setup; any argument dispatches as usual.
+const argv = process.argv.length > 2 ? process.argv.slice(2) : ["setup"];
+await runCli(registry, argv);

package/package.json

@@ -1,10 +1,49 @@
 {
   "name": "cotal-ai",
-  "version": "0.0.1",
-  "description": "Reserved for Cotal — a wire interface for AI agents to coordinate as lateral peers in a shared pub/sub space. See the @cotal-ai/* packages.",
+  "version": "0.3.0",
+  "description": "Cotal — lateral agent coordination over NATS. Run `npx cotal-ai` for a guided setup.",
   "license": "Apache-2.0",
-  "keywords": ["cotal", "agents", "multi-agent", "nats", "jetstream", "pubsub", "mcp"],
+  "keywords": [
+    "cotal",
+    "agents",
+    "multi-agent",
+    "nats",
+    "jetstream",
+    "pubsub",
+    "mcp"
+  ],
   "homepage": "https://github.com/Cotal-AI/Cotal#readme",
-  "repository": { "type": "git", "url": "git+https://github.com/Cotal-AI/Cotal.git" },
-  "files": ["README.md", "LICENSE"]
-}
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cotal-AI/Cotal.git",
+    "directory": "bin"
+  },
+  "type": "module",
+  "bin": {
+    "cotal": "./dist/cotal.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@cotal-ai/cli": "0.3.0",
+    "@cotal-ai/cmux": "0.3.0",
+    "@cotal-ai/connector-hermes": "0.3.0",
+    "@cotal-ai/core": "0.3.0",
+    "@cotal-ai/connector-opencode": "0.3.0",
+    "@cotal-ai/connector-claude-code": "0.3.0",
+    "@cotal-ai/manager": "0.3.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json"
+  }
+}