@cotal-ai/connector-claude-code 0.2.0 → 0.3.0

package/.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/.mcp.json

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

package/dist/extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,SAAS,EAAoC,MAAM,gBAAgB,CAAC;AAS3G;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SAwC7B,CAAC"}
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,SAAS,EAAoC,MAAM,gBAAgB,CAAC;AAmB3G;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,SA8D7B,CAAC"}

package/dist/extension.js

@@ -1,11 +1,21 @@
 import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { loadAgentFile, registry } from "@cotal-ai/core";
-/** Channel ref for the locally-installed `cotal` plugin (marketplace `cotal-mesh`).
- *  `--dangerously-load-development-channels <ref>` turns on the plugin's
- *  `claude/channel` capability so an idle session wakes the instant a peer message
- *  arrives. The plugin must be *installed* (not `--plugin-dir`) for the channel to
- *  bind; the connector's identity guard keeps it inert in non-managed sessions. */
-const CHANNEL_REF = "plugin:cotal@cotal-mesh";
+/** Name the cotal MCP server is registered under via --mcp-config (see buildLaunch). */
+const MCP_SERVER_NAME = "cotal";
+/** Channel ref for `--dangerously-load-development-channels`, which turns on the cotal MCP server's
+ *  `claude/channel` capability so an idle session wakes the instant a peer message arrives. Because
+ *  we isolate the session with --strict-mcp-config the plugin's own MCP server is suppressed and
+ *  cotal is re-supplied via --mcp-config, so the ref is the manually-configured server tagged
+ *  `server:<name>` (the CLI rejects a plugin ref or a bare name here). The plugin stays installed
+ *  for its hooks, which do message delivery independent of this wake nudge. */
+const CHANNEL_REF = `server:${MCP_SERVER_NAME}`;
+/** Package root (parent of dist/), which doubles as the installable plugin dir: it carries
+ *  .claude-plugin/, .mcp.json, hooks/ and the dist/*.cjs bundles. */
+const PLUGIN_ROOT = fileURLToPath(new URL("..", import.meta.url));
+/** The cotal MCP server bundle, supplied explicitly so a spawned session can run with ONLY this
+ *  MCP server (see buildLaunch's --strict-mcp-config). */
+const MCP_CJS = resolve(PLUGIN_ROOT, "dist", "mcp.cjs");
 /**
  * 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
@@ -15,6 +25,7 @@ const CHANNEL_REF = "plugin:cotal@cotal-mesh";
 export const claudeConnector = {
     kind: "connector",
     name: "claude",
+    pluginRoot: PLUGIN_ROOT,
     buildLaunch(opts) {
         const env = {
             COTAL_SPACE: opts.space,
@@ -34,7 +45,22 @@ export const claudeConnector = {
             env.COTAL_CREDS = opts.creds;
         if (opts.servers)
             env.COTAL_SERVERS = opts.servers;
-        const args = ["--dangerously-load-development-channels", CHANNEL_REF];
+        // A leading positional is claude's first message, auto-submitted on start —
+        // so a driving session can greet the operator the moment it joins.
+        const args = opts.prompt
+            ? [opts.prompt, "--dangerously-load-development-channels", CHANNEL_REF]
+            : ["--dangerously-load-development-channels", CHANNEL_REF];
+        // Pre-allow fetching the public Cotal docs so a doc-grounded persona (e.g. david)
+        // can look something up under `npx` (no repo on disk) without prompting the operator
+        // mid-demo. Additive under the default permission mode — leaves other tools as-is.
+        args.push("--allowedTools", "WebFetch(domain:github.com),WebFetch(domain:raw.githubusercontent.com)");
+        // Isolate the spawned session's MCP to ONLY the cotal server. --strict-mcp-config drops every
+        // other MCP source — including the operator's personal ~/.claude.json servers (e.g. a headless
+        // Chromium, a DB server) that a meshed teammate never needs and that, multiplied across several
+        // spawns on a busy machine, starve memory and kill the session before it registers presence —
+        // and --mcp-config re-supplies cotal so its tools + presence still load. The plugin itself stays
+        // enabled (its hooks + the dev-channels wake path are unaffected; only MCP config is scoped).
+        args.push("--strict-mcp-config", "--mcp-config", JSON.stringify({ mcpServers: { [MCP_SERVER_NAME]: { command: "node", args: [MCP_CJS] } } }));
         // An agent file carries identity (read in-session via COTAL_AGENT_FILE) plus
         // persona + model, which can only be applied to a `claude` session at launch.
         if (opts.configPath) {

package/dist/extension.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAoD,MAAM,gBAAgB,CAAC;AAE3G;;;;mFAImF;AACnF,MAAM,WAAW,GAAG,yBAAyB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAc;IACxC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,QAAQ;IACd,WAAW,CAAC,IAAgB;QAC1B,MAAM,GAAG,GAA2B;YAClC,WAAW,EAAE,IAAI,CAAC,KAAK;YACvB,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,gFAAgF;YAChF,mFAAmF;YACnF,aAAa,EAAE,GAAG;YAClB,gFAAgF;YAChF,gFAAgF;YAChF,gBAAgB,EAAE,GAAG;SACtB,CAAC;QACF,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1C,IAAI,IAAI,CAAC,EAAE;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK;YAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7C,IAAI,IAAI,CAAC,OAAO;YAAE,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC;QAEnD,MAAM,IAAI,GAAG,CAAC,yCAAyC,EAAE,WAAW,CAAC,CAAC;QAEtE,6EAA6E;QAC7E,8EAA8E;QAC9E,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC5B,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,GAAG,CAAC,OAAO;gBAAE,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAClE,IAAI,GAAG,CAAC,KAAK;gBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,IAAI;YACJ,GAAG;YACH,wEAAwE;YACxE,yEAAyE;YACzE,OAAO,EAAE,kBAAkB;SAC5B,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC"}
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"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"}

package/dist/mcp.cjs

@@ -47816,7 +47816,8 @@ var CotalEndpoint = class extends import_node_events.EventEmitter {
   async requestControl(service, req, timeoutMs = 5e3) {
     if (!this.nc)
       throw new Error("endpoint not started");
-    const m = await this.nc.request(controlServiceSubject(this.space, service, this.card.id), JSON.stringify({ ...req, from: req.from ?? this.ref() }), { timeout: timeoutMs });
+    const body = { ...req, from: req.from ?? this.ref() };
+    const m = await this.nc.request(controlServiceSubject(this.space, service, this.card.id), JSON.stringify(body), { timeout: timeoutMs });
     return m.json();
   }
   // ---- presence ------------------------------------------------------------
@@ -48848,6 +48849,15 @@ var MeshAgent = class extends import_node_events2.EventEmitter {
       args: { name, graceful: opts?.graceful ?? true }
     });
   }
+  /** Ask the manager to purge the space's retained chat backlog (its `purge` op). Cleanup only —
+   *  it doesn't touch live agents or the anycast work queue. `includeDms` also clears DM history. */
+  async purgeHistory(opts) {
+    this.assertConnected();
+    return this.ep.requestControl("manager", {
+      op: "purge",
+      args: { includeDms: opts?.includeDms ?? false }
+    });
+  }
   /** Define a persona and persist it as config (the manager's `definePersona` op writes
    *  .cotal/agents/<name>.md). On success, announce it on the channel — the "send it out"
    *  half — so peers see the new persona; `spawn(name)` then launches an agent wearing it. */
@@ -49309,6 +49319,27 @@ ${info}${caught}`);
         }
       }
     },
+    {
+      name: "cotal_purge",
+      title: "Cotal: clear chat history",
+      description: "Ask the manager to purge this space's retained chat backlog (channel history). Set includeDms to also clear direct-message history. Cleanup only \u2014 it does not affect live agents or the anycast work queue. Irreversible.",
+      schema: {
+        includeDms: external_exports.boolean().optional().describe("Default false: channel history only. true = also purge DM history.")
+      },
+      async run(agent, _config, { includeDms }) {
+        try {
+          const reply = await agent.purgeHistory({ includeDms });
+          if (!reply.ok)
+            return err(`Couldn't purge history: ${reply.error ?? "manager refused"}`);
+          const d = reply.data;
+          const chat = d?.chat ?? 0;
+          const dm = d?.dm;
+          return ok(`Cleared ${chat} channel message${chat === 1 ? "" : "s"}${dm === void 0 ? "" : ` and ${dm} DM${dm === 1 ? "" : "s"}`} from "${_config.space}".`);
+        } catch (e) {
+          return err(`Couldn't purge history: no manager reachable (${e.message}). Is the manager running?`);
+        }
+      }
+    },
     {
       name: "cotal_persona",
       title: "Cotal: define a persona",

package/hooks/hooks.json

@@ -0,0 +1,82 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/dist/hook.cjs"]
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/dist/hook.cjs"]
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/dist/hook.cjs"]
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "permission_prompt|elicitation_dialog",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/dist/hook.cjs"]
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/dist/hook.cjs"]
+          }
+        ]
+      }
+    ],
+    "StopFailure": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/dist/hook.cjs"]
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/dist/hook.cjs"]
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cotal-ai/connector-claude-code",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -18,25 +18,28 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@cotal-ai/connector-core": "0.2.0"
+    "@cotal-ai/connector-core": "0.3.0"
   },
   "peerDependencies": {
-    "@cotal-ai/core": "0.1.3"
+    "@cotal-ai/core": ">=0.1.0"
   },
   "devDependencies": {
     "esbuild": "^0.28.0",
     "tsx": "^4.22.4",
-    "@cotal-ai/core": "0.1.3"
+    "@cotal-ai/core": "0.3.0"
   },
   "files": [
-    "dist"
+    "dist",
+    ".mcp.json",
+    "hooks",
+    ".claude-plugin"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.json && pnpm run bundle",
     "bundle": "esbuild src/mcp.ts src/hook.ts --bundle --platform=node --format=cjs --target=node20 --outdir=dist --out-extension:.js=.cjs"
   }
 }