cotal-ai 0.11.2 → 0.11.4

package/dist/cotal.js

@@ -13,10 +13,6 @@ import { runCli } from "@cotal-ai/cli"; // self-registers the base surface incl.
 import "@cotal-ai/manager"; // self-registers `supervise` — the agent-supervisor daemon
 import "@cotal-ai/delivery"; // self-registers `deliver` — the server-side Plane-3 delivery daemon
 import "@cotal-ai/auth"; // self-registers login / logout — per-user IdP sessions (device-code sign-in)
-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 { claudeConnector } from "@cotal-ai/connector-claude-code";
 import { registry } from "@cotal-ai/core";
 // A CLI must exit quietly when its stdout is closed early — piped to `head`, a pager that quits,
 // or a shell's process substitution (`source <(cotal completion bash)`). Node otherwise turns the
@@ -27,14 +23,15 @@ process.stdout.on("error", (e) => {
         process.exit(0);
     throw e;
 });
-// The manager's built-in default agent type is "cotal" (when COTAL_DEFAULT_AGENT is unset); make it
-// a real Claude coder so a bare cotal_spawn / `cotal spawn --detach <persona>` (no --agent) brings
-// up a Claude Code session. Revisited at the start→spawn merge (stage 2a): still needed — the
-// default rides the MANAGER side of the control plane, not the removed CLI verb.
-registry.register({ ...claudeConnector, name: "cotal" });
+// The four agent connectors (claude/opencode/hermes/pi) are NOT imported here: they are removable,
+// install-seeded `cotal ext` plugins loaded through the manifest, exactly like a third-party
+// connector (and like the `@cotal-ai/orca` runtime already is). `runCli` seeds them on first run and
+// materializes each lazily when a command resolves it; the default agent is `COTAL_DEFAULT_AGENT`
+// (else claude), resolved manager-side. The old `"cotal"` default-agent alias is gone with them.
+//
 // Bare `cotal` prints help; explicit `cotal setup` runs guided setup. The published binary is
 // the ONE composition root that loads operator-installed extensions (`cotal ext add …`) — commands,
-// runtimes, and local process components all self-register from those packages. Library roots keep
-// the explicit-import model.
+// runtimes, connectors, and local process components all self-register from those packages. Library
+// roots keep the explicit-import model.
 const argv = process.argv.slice(2);
 await runCli(registry, argv, { extensions: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cotal-ai",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "description": "Cotal — lateral agent coordination over NATS. Run `npx cotal-ai` for the CLI.",
   "license": "Apache-2.0",
   "keywords": [
@@ -26,19 +26,23 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@cotal-ai/auth": "0.11.2",
-    "@cotal-ai/cli": "0.11.2",
-    "@cotal-ai/connector-hermes": "0.11.2",
-    "@cotal-ai/connector-claude-code": "0.11.2",
-    "@cotal-ai/connector-opencode": "0.11.2",
-    "@cotal-ai/core": "0.11.2",
-    "@cotal-ai/delivery": "0.11.2",
-    "@cotal-ai/manager": "0.11.2",
-    "@cotal-ai/workspace": "0.11.2",
-    "@cotal-ai/connector-core": "0.11.2"
+    "@cotal-ai/auth": "0.11.4",
+    "@cotal-ai/cli": "0.11.4",
+    "@cotal-ai/delivery": "0.11.4",
+    "@cotal-ai/connector-core": "0.11.4",
+    "@cotal-ai/core": "0.11.4",
+    "@cotal-ai/manager": "0.11.4",
+    "@cotal-ai/workspace": "0.11.4"
+  },
+  "devDependencies": {
+    "@cotal-ai/connector-claude-code": "0.11.4",
+    "@cotal-ai/pi": "0.11.4",
+    "@cotal-ai/connector-hermes": "0.11.4",
+    "@cotal-ai/connector-opencode": "0.11.4"
   },
   "files": [
     "dist",
+    "seeded-connectors",
     "README.md",
     "LICENSE"
   ],
@@ -47,6 +51,7 @@
   },
   "scripts": {
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "build": "tsc -p tsconfig.json"
+    "build": "tsc -p tsconfig.json",
+    "seeded-connectors": "node scripts/copy-seeded-connectors.mjs"
   }
 }

package/seeded-connectors/claude/.claude-plugin/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "cotal",
+  "version": "0.0.0",
+  "description": "Join the Cotal mesh — coordinate with other AI agents as lateral peers (presence, messaging, role requests) over NATS.",
+  "author": { "name": "Cotal" }
+}

package/seeded-connectors/claude/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "cotal": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/mcp.cjs"]
+    }
+  }
+}

package/seeded-connectors/claude/README.md

@@ -0,0 +1,78 @@
+# @cotal-ai/connector-claude-code
+
+The Claude Code adapter: a bundled, installed plugin plus `claude/channel` push that turns a
+real `claude` session into a Cotal mesh peer. A thin client over
+[`@cotal-ai/connector-core`](../connector-core).
+
+**Tier:** `extensions/`. Peer-depends [`@cotal-ai/core`](../../packages/core); self-registers on
+import.
+
+See [docs/connect-claude.md](../../docs/connect-claude.md) for the integration guide, and the
+[root AGENTS.md](../../AGENTS.md) for the tier rules.
+
+## Claude Code hook reference
+
+The full set of Claude Code hook events, grouped by lifecycle — this is Claude *product*
+surface, kept here with the adapter rather than in the protocol docs. Source:
+[code.claude.com/docs/en/hooks](https://code.claude.com/docs/en/hooks) (Claude Code
+2.1.16x, 31 events). The connector consumes the subset mapped in
+[docs/connect-claude.md](../../docs/connect-claude.md) (presence mapping + message
+delivery); the rest are listed for completeness.
+
+### Once per session
+| Event | Fires when | Matchers |
+|---|---|---|
+| `SessionStart` | a session begins or resumes | `startup`, `resume`, `clear`, `compact` |
+| `Setup` | started with `--init-only`, or `--init`/`--maintenance` in `-p` | `init`, `maintenance` |
+| `SessionEnd` | a session terminates | `clear`, `resume`, `logout`, `prompt_input_exit`, `bypass_permissions_disabled`, `other` |
+
+### Once per turn
+| Event | Fires when | Matchers |
+|---|---|---|
+| `UserPromptSubmit` | user submits a prompt, before Claude processes it | (none) |
+| `UserPromptExpansion` | a typed command expands into a prompt | command name |
+| `Stop` | Claude finishes responding | (none) |
+| `StopFailure` | turn ends due to an API error | `rate_limit`, `authentication_failed`, `oauth_org_not_allowed`, `billing_error`, `invalid_request`, `model_not_found`, `server_error`, `max_output_tokens`, `unknown` |
+
+### Per tool call (agentic loop)
+| Event | Fires when | Matchers |
+|---|---|---|
+| `PreToolUse` | before a tool call executes (can block) | tool name |
+| `PermissionRequest` | a permission dialog appears | tool name |
+| `PermissionDenied` | a tool call denied by auto-mode classifier | tool name |
+| `PostToolUse` | after a tool call succeeds | tool name |
+| `PostToolUseFailure` | after a tool call fails | tool name |
+| `PostToolBatch` | after a parallel tool batch resolves, before next model call | (none) |
+| `SubagentStart` | a subagent is spawned | agent type |
+| `SubagentStop` | a subagent finishes | agent type |
+| `TaskCreated` | a task is created via `TaskCreate` | (none) |
+| `TaskCompleted` | a task is marked completed | (none) |
+| `TeammateIdle` | an agent-team teammate is about to go idle | (none) |
+
+### Compaction
+| Event | Fires when | Matchers |
+|---|---|---|
+| `PreCompact` | before context compaction | `manual`, `auto` |
+| `PostCompact` | after compaction completes | `manual`, `auto` |
+
+### Async / background
+| Event | Fires when | Matchers |
+|---|---|---|
+| `CwdChanged` | working directory changes | (none) |
+| `FileChanged` | a watched file changes on disk | literal filenames |
+| `ConfigChange` | a config file changes mid-session | `user_settings`, `project_settings`, `local_settings`, `policy_settings`, `skills` |
+| `InstructionsLoaded` | CLAUDE.md / `.claude/rules/*.md` loaded into context | `session_start`, `nested_traversal`, `path_glob_match`, `include`, `compact` |
+| `Notification` | Claude Code emits a notification | `permission_prompt`, `idle_prompt`, `auth_success`, `elicitation_dialog`, `elicitation_complete`, `elicitation_response` |
+| `MessageDisplay` | while assistant message text is displayed (display-only) | (none) |
+
+### Worktree
+| Event | Fires when | Matchers |
+|---|---|---|
+| `WorktreeCreate` | a worktree is created (`--worktree` / `isolation: "worktree"`) | (none) |
+| `WorktreeRemove` | a worktree is removed | (none) |
+
+### MCP elicitation
+| Event | Fires when | Matchers |
+|---|---|---|
+| `Elicitation` | an MCP server requests user input during a tool call | MCP server name |
+| `ElicitationResult` | after the user responds, before it is sent to the server | MCP server name |

package/seeded-connectors/claude/dist/extension.d.ts

@@ -0,0 +1,9 @@
+import { type Connector } from "@cotal-ai/core";
+/**
+ * The Claude Code connector: launches the real `claude` with the Cotal identity in
+ * the environment and the mesh channel enabled, so the session joins the mesh and
+ * wakes on incoming peer messages. Self-registers on import; the manager resolves it
+ * by agent type "claude".
+ */
+export declare const claudeConnector: Connector;
+//# sourceMappingURL=extension.d.ts.map

package/seeded-connectors/claude/dist/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAIA,OAAO,EAA2D,KAAK,SAAS,EAAoC,MAAM,gBAAgB,CAAC;AAoB3I;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAmI7B,CAAC"}