@cotal-ai/connector-claude-code 0.1.4-next-20260612020133 → 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,SAqC7B,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,
@@ -22,6 +33,9 @@ export const claudeConnector = {
             // Force the connector to emit channel wake-nudges: Claude doesn't advertise the
             // `claude/channel` capability back over MCP, so auto-detection would see it "off".
             COTAL_CHANNEL: "1",
+            // Managed sessions mirror their own transcript to `tr-<name>` so peers can read
+            // what the agent actually did. Personal sessions (no buildLaunch) never mirror.
+            COTAL_TRANSCRIPT: "1",
         };
         if (opts.role)
             env.COTAL_ROLE = opts.role;
@@ -31,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;SACnB,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/hook.cjs

@@ -6421,7 +6421,7 @@ var require_authenticator = __commonJS({
     exports2.tokenAuthenticator = tokenAuthenticator;
     exports2.nkeyAuthenticator = nkeyAuthenticator;
     exports2.jwtAuthenticator = jwtAuthenticator;
-    exports2.credsAuthenticator = credsAuthenticator4;
+    exports2.credsAuthenticator = credsAuthenticator5;
     var nkeys_1 = require_nkeys2();
     var encoders_1 = require_encoders();
     function multiAuthenticator(authenticators) {
@@ -6471,7 +6471,7 @@ var require_authenticator = __commonJS({
         return { jwt, nkey, sig };
       };
     }
-    function credsAuthenticator4(creds) {
+    function credsAuthenticator5(creds) {
       const fn = typeof creds !== "function" ? () => creds : creds;
       const parse = () => {
         const CREDS = /\s*(?:(?:[-]{3,}[^\n]*[-]{3,}\n)(.+)(?:\n\s*[-]{3,}[^\n]*[-]{3,}\n))/ig;
@@ -12404,7 +12404,7 @@ var require_jsclient = __commonJS({
     exports2.startFastIngest = startFastIngest;
     exports2.toJetStreamClient = toJetStreamClient;
     exports2.jetstream = jetstream2;
-    exports2.jetstreamManager = jetstreamManager3;
+    exports2.jetstreamManager = jetstreamManager4;
     exports2.scheduleSpecToHeader = scheduleSpecToHeader;
     var jsbaseclient_api_1 = require_jsbaseclient_api();
     var jsmconsumer_api_1 = require_jsmconsumer_api();
@@ -12491,7 +12491,7 @@ var require_jsclient = __commonJS({
     function jetstream2(nc, opts = {}) {
       return new JetStreamClientImpl(nc, opts);
     }
-    async function jetstreamManager3(nc, opts = {}) {
+    async function jetstreamManager4(nc, opts = {}) {
       const adm = new JetStreamManagerImpl(nc, opts);
       if (opts.checkAPI !== false) {
         try {
@@ -12606,7 +12606,7 @@ var require_jsclient = __commonJS({
         } catch (err) {
           return Promise.reject(err);
         }
-        return jetstreamManager3(this.nc, opts);
+        return jetstreamManager4(this.nc, opts);
       }
       get apiPrefix() {
         return this.prefix;
@@ -13601,11 +13601,11 @@ var require_connect = __commonJS({
   "../../node_modules/.pnpm/@nats-io+transport-node@3.4.0/node_modules/@nats-io/transport-node/lib/connect.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.connect = connect5;
+    exports2.connect = connect6;
     var node_transport_1 = require_node_transport();
     var nats_base_client_1 = require_nats_base_client();
     var nats_base_client_2 = require_nats_base_client();
-    function connect5(opts = {}) {
+    function connect6(opts = {}) {
       if ((0, nats_base_client_2.hasWsProtocol)(opts)) {
         return Promise.reject(nats_base_client_2.errors.InvalidArgumentError.format(`servers`, `node client doesn't support websockets, use the 'wsconnect' function instead`));
       }
@@ -13797,7 +13797,7 @@ var require_kv = __commonJS({
         throw new Error(`invalid bucket name: ${name}`);
       }
     }
-    var Kvm4 = class {
+    var Kvm5 = class {
       js;
       /**
        * Creates an instance of the Kv that allows you to create and access KV stores.
@@ -13863,7 +13863,7 @@ var require_kv = __commonJS({
         return new internal_2.ListerImpl(subj, filter, this.js);
       }
     };
-    exports2.Kvm = Kvm4;
+    exports2.Kvm = Kvm5;
     var Bucket = class _Bucket {
       js;
       jsm;
@@ -16422,6 +16422,11 @@ function loadAgentFile(path) {
   const kind = str("kind");
   if (kind && kind !== "agent" && kind !== "endpoint")
     throw new Error(`agent file ${path}: "kind" must be "agent" or "endpoint"`);
+  const known = /* @__PURE__ */ new Set(["name", "role", "kind", "description", "tags", "channels", "publish", "model"]);
+  const meta = {};
+  for (const [k, v] of Object.entries(fm))
+    if (!known.has(k) && typeof v === "string")
+      meta[k] = v;
   return {
     name,
     role: str("role"),
@@ -16431,6 +16436,7 @@ function loadAgentFile(path) {
     channels: list("channels"),
     publish: list("publish"),
     model: str("model"),
+    meta: Object.keys(meta).length ? meta : void 0,
     persona: persona || void 0
   };
 }
@@ -16441,6 +16447,11 @@ var import_jetstream2 = __toESM(require_mod4(), 1);
 var import_kv3 = __toESM(require_mod6(), 1);
 var DEFAULT_SERVER = "nats://127.0.0.1:4222";
 
+// ../../packages/core/dist/spaces.js
+var import_transport_node4 = __toESM(require_transport_node(), 1);
+var import_jetstream3 = __toESM(require_mod4(), 1);
+var import_kv4 = __toESM(require_mod6(), 1);
+
 // ../../packages/core/dist/registry.js
 var Registry = class {
   #byKey = /* @__PURE__ */ new Map();

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./extension.js";
+export { transcriptChannel } from "./transcript.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export * from "./extension.js"; // self-registers the `claude` connector on import
+export { transcriptChannel } from "./transcript.js"; // launchers provision pub rights for `tr-<name>` in auth mode
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC,CAAC,kDAAkD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC,CAAC,kDAAkD;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC,CAAC,8DAA8D"}

package/dist/mcp.cjs

@@ -13281,7 +13281,7 @@ var require_authenticator = __commonJS({
     exports2.tokenAuthenticator = tokenAuthenticator;
     exports2.nkeyAuthenticator = nkeyAuthenticator;
     exports2.jwtAuthenticator = jwtAuthenticator;
-    exports2.credsAuthenticator = credsAuthenticator4;
+    exports2.credsAuthenticator = credsAuthenticator5;
     var nkeys_1 = require_nkeys2();
     var encoders_1 = require_encoders();
     function multiAuthenticator(authenticators) {
@@ -13331,7 +13331,7 @@ var require_authenticator = __commonJS({
         return { jwt: jwt2, nkey, sig };
       };
     }
-    function credsAuthenticator4(creds) {
+    function credsAuthenticator5(creds) {
       const fn = typeof creds !== "function" ? () => creds : creds;
       const parse3 = () => {
         const CREDS = /\s*(?:(?:[-]{3,}[^\n]*[-]{3,}\n)(.+)(?:\n\s*[-]{3,}[^\n]*[-]{3,}\n))/ig;
@@ -19264,7 +19264,7 @@ var require_jsclient = __commonJS({
     exports2.startFastIngest = startFastIngest;
     exports2.toJetStreamClient = toJetStreamClient;
     exports2.jetstream = jetstream2;
-    exports2.jetstreamManager = jetstreamManager3;
+    exports2.jetstreamManager = jetstreamManager4;
     exports2.scheduleSpecToHeader = scheduleSpecToHeader;
     var jsbaseclient_api_1 = require_jsbaseclient_api();
     var jsmconsumer_api_1 = require_jsmconsumer_api();
@@ -19351,7 +19351,7 @@ var require_jsclient = __commonJS({
     function jetstream2(nc, opts = {}) {
       return new JetStreamClientImpl(nc, opts);
     }
-    async function jetstreamManager3(nc, opts = {}) {
+    async function jetstreamManager4(nc, opts = {}) {
       const adm = new JetStreamManagerImpl(nc, opts);
       if (opts.checkAPI !== false) {
         try {
@@ -19466,7 +19466,7 @@ var require_jsclient = __commonJS({
         } catch (err2) {
           return Promise.reject(err2);
         }
-        return jetstreamManager3(this.nc, opts);
+        return jetstreamManager4(this.nc, opts);
       }
       get apiPrefix() {
         return this.prefix;
@@ -20461,11 +20461,11 @@ var require_connect = __commonJS({
   "../../node_modules/.pnpm/@nats-io+transport-node@3.4.0/node_modules/@nats-io/transport-node/lib/connect.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.connect = connect4;
+    exports2.connect = connect5;
     var node_transport_1 = require_node_transport();
     var nats_base_client_1 = require_nats_base_client();
     var nats_base_client_2 = require_nats_base_client();
-    function connect4(opts = {}) {
+    function connect5(opts = {}) {
       if ((0, nats_base_client_2.hasWsProtocol)(opts)) {
         return Promise.reject(nats_base_client_2.errors.InvalidArgumentError.format(`servers`, `node client doesn't support websockets, use the 'wsconnect' function instead`));
       }
@@ -20657,7 +20657,7 @@ var require_kv = __commonJS({
         throw new Error(`invalid bucket name: ${name}`);
       }
     }
-    var Kvm4 = class {
+    var Kvm5 = class {
       js;
       /**
        * Creates an instance of the Kv that allows you to create and access KV stores.
@@ -20723,7 +20723,7 @@ var require_kv = __commonJS({
         return new internal_2.ListerImpl(subj, filter, this.js);
       }
     };
-    exports2.Kvm = Kvm4;
+    exports2.Kvm = Kvm5;
     var Bucket = class _Bucket {
       js;
       jsm;
@@ -20796,11 +20796,11 @@ var require_kv = __commonJS({
           sc.subject_delete_marker_ttl = (0, internal_1.nanos)(bo.markerTTL);
         }
         if (opts.mirror) {
-          const mirror = Object.assign({}, opts.mirror);
-          if (!mirror.name.startsWith(types_1.kvPrefix)) {
-            mirror.name = `${types_1.kvPrefix}${mirror.name}`;
+          const mirror2 = Object.assign({}, opts.mirror);
+          if (!mirror2.name.startsWith(types_1.kvPrefix)) {
+            mirror2.name = `${types_1.kvPrefix}${mirror2.name}`;
           }
-          sc.mirror = mirror;
+          sc.mirror = mirror2;
           sc.mirror_direct = true;
         } else if (opts.sources) {
           const sources = opts.sources.map((s) => {
@@ -20863,17 +20863,17 @@ var require_kv = __commonJS({
         this._prefixLen = 0;
         this.prefix = `$KV.${this.bucket}`;
         this.useJsPrefix = this.js.apiPrefix !== "$JS.API";
-        const { mirror } = info.config;
-        if (mirror) {
-          let n = mirror.name;
+        const { mirror: mirror2 } = info.config;
+        if (mirror2) {
+          let n = mirror2.name;
           if (n.startsWith(types_1.kvPrefix)) {
             n = n.substring(types_1.kvPrefix.length);
           }
-          if (mirror.external && mirror.external.api !== "") {
-            const mb = mirror.name.substring(types_1.kvPrefix.length);
+          if (mirror2.external && mirror2.external.api !== "") {
+            const mb = mirror2.name.substring(types_1.kvPrefix.length);
             this.useJsPrefix = false;
             this.prefix = `$KV.${mb}`;
-            this.editPrefix = `${mirror.external.api}.$KV.${n}`;
+            this.editPrefix = `${mirror2.external.api}.$KV.${n}`;
           } else {
             this.editPrefix = this.prefix;
           }
@@ -47553,6 +47553,11 @@ function loadAgentFile(path) {
   const kind = str("kind");
   if (kind && kind !== "agent" && kind !== "endpoint")
     throw new Error(`agent file ${path}: "kind" must be "agent" or "endpoint"`);
+  const known = /* @__PURE__ */ new Set(["name", "role", "kind", "description", "tags", "channels", "publish", "model"]);
+  const meta3 = {};
+  for (const [k, v] of Object.entries(fm))
+    if (!known.has(k) && typeof v === "string")
+      meta3[k] = v;
   return {
     name,
     role: str("role"),
@@ -47562,6 +47567,7 @@ function loadAgentFile(path) {
     channels: list("channels"),
     publish: list("publish"),
     model: str("model"),
+    meta: Object.keys(meta3).length ? meta3 : void 0,
     persona: persona || void 0
   };
 }
@@ -47810,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 ------------------------------------------------------------
@@ -48509,6 +48516,11 @@ function describeStatusError(err2) {
   return err2;
 }
 
+// ../../packages/core/dist/spaces.js
+var import_transport_node4 = __toESM(require_transport_node(), 1);
+var import_jetstream3 = __toESM(require_mod4(), 1);
+var import_kv4 = __toESM(require_mod6(), 1);
+
 // ../../packages/core/dist/registry.js
 var Registry = class {
   #byKey = /* @__PURE__ */ new Map();
@@ -48827,6 +48839,38 @@ var MeshAgent = class extends import_node_events2.EventEmitter {
     this.assertConnected();
     return this.ep.requestControl("manager", { op: "start", args: { name, role } });
   }
+  /** Ask the manager to tear a teammate down (its `stop` op). Graceful by default —
+   *  the session is told to exit cleanly (so it leaves the mesh) before the
+   *  process/tab is closed; `graceful:false` is a hard, immediate kill. */
+  async despawn(name, opts) {
+    this.assertConnected();
+    return this.ep.requestControl("manager", {
+      op: "stop",
+      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. */
+  async definePersona(def) {
+    this.assertConnected();
+    const reply = await this.ep.requestControl("manager", {
+      op: "definePersona",
+      args: { name: def.name, role: def.role, model: def.model, persona: def.prompt }
+    });
+    if (reply.ok)
+      await this.send(`persona \`${def.name}\` is now available \u2014 spawn it to bring it online`);
+    return reply;
+  }
   // ---- presence ------------------------------------------------------------
   /** The full roster, including ourselves. */
   roster() {
@@ -48927,6 +48971,8 @@ var err = (text) => ({ text, isError: true });
 function statusGlyph(s) {
   return s === "working" ? "\u25CF" : s === "waiting" ? "\u25D0" : s === "idle" ? "\u25CB" : "\xB7";
 }
+var FACE_TAG_RE = /\[\[\s*face\s*:\s*[\w-]+\s*\]\]\s?/gi;
+var stripFaceTags = (text) => text.replace(FACE_TAG_RE, "");
 var ATTENTION_DESC = {
   open: "open \u2014 you receive everything; untagged channel chatter wakes you when idle",
   dnd: "dnd \u2014 channel chatter no longer wakes you (it still arrives in your next turn); DMs, anycast, and @mentions still wake you",
@@ -49045,7 +49091,7 @@ ${all.map(fmtItem).join("\n")}`);
       },
       async run(agent, _config, { text: msg, channel, mentions }) {
         try {
-          const m = await agent.send(msg, channel, mentions);
+          const m = await agent.send(stripFaceTags(msg), channel, mentions);
           return ok(`Sent to #${m.channel}${m.mentions?.length ? ` (mentioned @${m.mentions.join(", @")})` : ""}.`);
         } catch (e) {
           return err(`Couldn't send: ${e.message}`);
@@ -49062,7 +49108,7 @@ ${all.map(fmtItem).join("\n")}`);
       },
       async run(agent, _config, { to, text: msg }) {
         try {
-          const { peer } = await agent.dm(to, msg);
+          const { peer } = await agent.dm(to, stripFaceTags(msg));
           return ok(`DM sent to ${peer.card.name}.`);
         } catch (e) {
           return err(`Couldn't DM: ${e.message}`);
@@ -49079,7 +49125,7 @@ ${all.map(fmtItem).join("\n")}`);
       },
       async run(agent, _config, { role, text: msg }) {
         try {
-          await agent.anycast(role, msg);
+          await agent.anycast(role, stripFaceTags(msg));
           return ok(`Sent to one @${role}.`);
         } catch (e) {
           return err(`Couldn't send: ${e.message}`);
@@ -49212,13 +49258,14 @@ ${info}${caught}`);
       schema: {
         origin: external_exports.enum(["human", "agent"]).describe(`"human" when relaying the user's feedback, "agent" when reporting an issue you hit yourself.`),
         type: external_exports.enum(["bug", "idea", "friction", "praise", "other"]).describe("What kind of feedback this is."),
-        summary: external_exports.string().max(2e3).describe("One-line summary of the feedback."),
-        details: external_exports.string().max(1e4).optional().describe("Longer free-form details."),
+        summary: external_exports.string().max(300).describe("Required one-line summary, max 300 characters."),
+        details: external_exports.string().max(1e4).optional().describe("Longer free-form details. Do not include secrets."),
         severity: external_exports.enum(["low", "medium", "high"]).optional().describe("How badly this hurts (bugs/friction)."),
-        area: external_exports.string().optional().describe("The part of Cotal this concerns (e.g. presence, channels, CLI)."),
-        repro: external_exports.string().optional().describe("Steps to reproduce."),
-        expected: external_exports.string().optional().describe("What you expected to happen."),
-        actual: external_exports.string().optional().describe("What actually happened."),
+        area: external_exports.string().max(120).optional().describe("The part of Cotal this concerns (e.g. presence, channels, CLI)."),
+        repro: external_exports.string().max(1e4).optional().describe("Steps to reproduce."),
+        expected: external_exports.string().max(5e3).optional().describe("What you expected to happen."),
+        actual: external_exports.string().max(5e3).optional().describe("What actually happened."),
+        diagnostics: external_exports.string().max(1e4).optional().describe("Relevant diagnostics as text (logs, errors). Never include secrets."),
         email: external_exports.string().optional().describe("Contact email \u2014 required on the keyless public path when none is configured in the environment.")
       },
       async run(_agent, _config, args) {
@@ -49236,14 +49283,83 @@ ${info}${caught}`);
         }
         try {
           const res = await fetch(url2, { method: "POST", headers, body: JSON.stringify(body) });
-          const reply = await res.json().catch(() => ({}));
+          const raw = await res.text();
+          let reply = {};
+          if (raw)
+            try {
+              reply = JSON.parse(raw);
+            } catch {
+              reply = { error: raw };
+            }
           if (!res.ok)
             return err(`Feedback rejected (${res.status}${reply.error ? `: ${reply.error}` : ""}).`);
-          return ok(`Feedback sent${reply.id ? ` (id ${reply.id})` : ""}. Thanks!`);
+          const note = reply.published === false ? " (stored, but the internal feedback channel publish failed)" : "";
+          return ok(`Feedback sent${reply.id ? ` (id ${reply.id})` : ""}${note}. Thanks!`);
         } catch (e) {
           return err(`Couldn't reach the feedback intake at ${url2}: ${e.message}`);
         }
       }
+    },
+    {
+      name: "cotal_despawn",
+      title: "Cotal: stop a teammate",
+      description: "Ask the manager to tear a teammate down \u2014 it leaves the mesh and its process/tab is closed. Graceful by default (the session exits cleanly first); pass graceful:false for a hard, immediate kill. The inverse of cotal_spawn.",
+      schema: {
+        name: external_exports.string().describe("Name of the peer to stop."),
+        graceful: external_exports.boolean().optional().describe("Default true: let the session exit cleanly. false = hard kill.")
+      },
+      async run(agent, _config, { name, graceful }) {
+        try {
+          const reply = await agent.despawn(name, { graceful });
+          if (!reply.ok)
+            return err(`Couldn't despawn ${name}: ${reply.error ?? "manager refused"}`);
+          return ok(`Stopping ${name}${graceful === false ? " (hard)" : ""} \u2014 it will leave the roster shortly.`);
+        } catch (e) {
+          return err(`Couldn't despawn ${name}: no manager reachable (${e.message}). Is the manager running?`);
+        }
+      }
+    },
+    {
+      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",
+      description: "Define a new persona and save it as config (the manager writes .cotal/agents/<name>.md), then announce it on the mesh. Afterwards cotal_spawn(name) launches a real agent wearing this persona/model. Use to grow the team with a custom role you describe on the fly.",
+      schema: {
+        name: external_exports.string().regex(/^[A-Za-z0-9_-]+$/, "letters, digits, _ or - only").describe("Unique name for the persona (also the spawn name): letters, digits, _ or -."),
+        prompt: external_exports.string().max(1e4).describe("The persona \u2014 an appended system prompt describing who this agent is."),
+        role: external_exports.string().max(120).optional().describe("Optional role label (e.g. reviewer, scout)."),
+        model: external_exports.string().max(120).optional().describe("Optional model override (e.g. opus, sonnet).")
+      },
+      async run(agent, _config, { name, prompt, role, model }) {
+        try {
+          const reply = await agent.definePersona({ name, prompt, role, model });
+          if (!reply.ok)
+            return err(`Couldn't define ${name}: ${reply.error ?? "manager refused"}`);
+          return ok(`Persona \`${name}\` saved \u2014 spawn it with cotal_spawn(name="${name}") to bring it online.`);
+        } catch (e) {
+          return err(`Couldn't define ${name}: no manager reachable (${e.message}). Is the manager running?`);
+        }
+      }
     }
   ];
 }
@@ -49322,13 +49438,176 @@ function startControlServer(agent, socketPath, handle) {
   return server;
 }
 
+// src/transcript.ts
+var import_node_fs4 = require("node:fs");
+var MAX_PREVIEW = 700;
+var MAX_CHUNK = 6e3;
+function transcriptChannel(name) {
+  return `tr-${name.toLowerCase().replace(/[^a-z0-9_-]+/g, "-")}`;
+}
+function truncate(s, max) {
+  return s.length > max ? `${s.slice(0, max - 1)}\u2026` : s;
+}
+function salient(input) {
+  const i = input ?? {};
+  const v = i.command ?? i.file_path ?? i.path ?? i.url ?? i.pattern ?? i.description;
+  const s = typeof v === "string" ? v : Object.keys(i).length ? JSON.stringify(i) : "";
+  return s ? `: ${truncate(s, 300)}` : "";
+}
+function resultText(content) {
+  if (typeof content === "string") return content;
+  if (Array.isArray(content))
+    return content.map((b) => typeof b?.text === "string" ? b.text : "").filter(Boolean).join("\n");
+  return "";
+}
+function condense(line) {
+  let e;
+  try {
+    e = JSON.parse(line);
+  } catch {
+    return [];
+  }
+  if (!e || e.isMeta) return [];
+  const content = e.message?.content;
+  if (e.type === "assistant" && Array.isArray(content)) {
+    const out = [];
+    for (const b of content) {
+      if (b.type === "text" && b.text?.trim()) out.push(b.text.trim());
+      else if (b.type === "tool_use" && b.name) out.push(`\u2692 ${b.name}${salient(b.input)}`);
+    }
+    return out;
+  }
+  if (e.type === "user") {
+    if (typeof content === "string")
+      return content.trim() ? [`\xBB ${truncate(content.trim(), MAX_PREVIEW)}`] : [];
+    if (Array.isArray(content)) {
+      const out = [];
+      for (const b of content) {
+        if (b.type === "tool_result") {
+          const t = resultText(b.content).trim();
+          out.push(`\u2192 ${b.is_error ? "ERROR: " : ""}${t ? truncate(t, MAX_PREVIEW) : "(no output)"}`);
+        } else if (b.type === "text" && b.text?.trim()) {
+          out.push(`\xBB ${truncate(b.text.trim(), MAX_PREVIEW)}`);
+        }
+      }
+      return out;
+    }
+  }
+  return [];
+}
+var TranscriptMirror = class {
+  constructor(agent, channel) {
+    this.agent = agent;
+    this.channel = channel;
+  }
+  agent;
+  channel;
+  path;
+  offset = 0;
+  /** A batch that failed mid-publish: chunks + how many already landed. Retried (from the
+   *  first unsent chunk — never re-sending a delivered one) before any new read. */
+  pending;
+  /** ALL path/offset mutation and publishing runs on this serialized chain — hook events
+   *  land concurrently on the control socket. */
+  chain = Promise.resolve();
+  /** Adopt the transcript at its CURRENT end — mirror only what happens from now on, so a
+   *  resumed session (or a mirror that first sees the path mid-session) never rebroadcasts. */
+  adopt(path) {
+    this.enqueue(() => {
+      this.adoptNow(path);
+      return Promise.resolve();
+    });
+  }
+  /** Queue a flush of new transcript entries to the channel. Never throws, never blocks the
+   *  hook reply — the read+publish runs on the serialized chain. */
+  flush(path) {
+    this.enqueue(() => {
+      if (!this.path) this.adoptNow(path);
+      return this.doFlush();
+    });
+  }
+  enqueue(step) {
+    this.chain = this.chain.then(step).catch((e) => {
+      process.stderr.write(`[cotal-connector] transcript mirror: ${e.message}
+`);
+    });
+  }
+  adoptNow(path) {
+    if (typeof path !== "string" || !path || this.path === path) return;
+    this.path = path;
+    this.pending = void 0;
+    try {
+      this.offset = (0, import_node_fs4.statSync)(path).size;
+    } catch {
+      this.offset = 0;
+    }
+  }
+  async doFlush() {
+    if (!this.path || !this.agent.connected) return;
+    if (!this.pending) {
+      const { lines, nextOffset } = this.readComplete();
+      if (nextOffset === this.offset) return;
+      this.pending = { chunks: chunkLines(lines.flatMap(condense), MAX_CHUNK), sent: 0, nextOffset };
+    }
+    const p = this.pending;
+    while (p.sent < p.chunks.length) {
+      await this.agent.send(p.chunks[p.sent], this.channel);
+      p.sent++;
+    }
+    this.offset = p.nextOffset;
+    this.pending = void 0;
+  }
+  /** New complete lines since the offset (a trailing partial line stays for the next flush). */
+  readComplete() {
+    const none = () => ({ lines: [], nextOffset: this.offset });
+    let fd;
+    try {
+      fd = (0, import_node_fs4.openSync)(this.path, "r");
+    } catch {
+      return none();
+    }
+    try {
+      const size = (0, import_node_fs4.fstatSync)(fd).size;
+      if (size < this.offset) this.offset = 0;
+      if (size === this.offset) return none();
+      const buf = Buffer.alloc(size - this.offset);
+      (0, import_node_fs4.readSync)(fd, buf, 0, buf.length, this.offset);
+      const text = buf.toString("utf8");
+      const lastNl = text.lastIndexOf("\n");
+      if (lastNl < 0) return none();
+      return {
+        lines: text.slice(0, lastNl).split("\n").filter(Boolean),
+        nextOffset: this.offset + Buffer.byteLength(text.slice(0, lastNl + 1), "utf8")
+      };
+    } finally {
+      (0, import_node_fs4.closeSync)(fd);
+    }
+  }
+};
+function chunkLines(lines, max) {
+  const chunks = [];
+  let cur = "";
+  for (const line of lines) {
+    if (cur && cur.length + 1 + line.length > max) {
+      chunks.push(cur);
+      cur = line;
+    } else {
+      cur = cur ? `${cur}
+${line}` : line;
+    }
+  }
+  if (cur) chunks.push(cur);
+  return chunks;
+}
+
 // src/mcp.ts
+var mirror;
 var pendingTool;
 function toolDetail(name, input) {
   if (typeof name !== "string" || !name) return void 0;
   const i = input ?? {};
-  const salient = i.command ?? i.file_path ?? i.path ?? i.url ?? i.pattern ?? i.description;
-  let detail = typeof salient === "string" ? salient : Object.keys(i).length ? JSON.stringify(i) : "";
+  const salient2 = i.command ?? i.file_path ?? i.path ?? i.url ?? i.pattern ?? i.description;
+  let detail = typeof salient2 === "string" ? salient2 : Object.keys(i).length ? JSON.stringify(i) : "";
   if (detail.length > 300) detail = `${detail.slice(0, 299)}\u2026`;
   return { name, detail };
 }
@@ -49338,6 +49617,7 @@ var claudeHandle = async (agent, ev) => {
   try {
     switch (event) {
       case "SessionStart": {
+        mirror?.adopt(ev.transcript_path);
         await agent.setStatus("idle");
         await agent.setAttention("open");
         const parts = [agent.channelBriefing(), formatInjection(agent.drainInbox())].filter(Boolean);
@@ -49345,10 +49625,12 @@ var claudeHandle = async (agent, ev) => {
       }
       case "UserPromptSubmit":
         pendingTool = void 0;
+        mirror?.flush(ev.transcript_path);
         await agent.setStatus("working");
         return withContext(formatInjection(agent.drainInbox()));
       case "PreToolUse":
         pendingTool = toolDetail(ev.tool_name, ev.tool_input);
+        mirror?.flush(ev.transcript_path);
         return {};
       case "Notification": {
         const msg = typeof ev.message === "string" ? ev.message : void 0;
@@ -49359,11 +49641,13 @@ var claudeHandle = async (agent, ev) => {
       case "Stop":
       case "StopFailure":
         pendingTool = void 0;
+        mirror?.flush(ev.transcript_path);
         await agent.setStatus("idle");
         const pending = agent.attention === "open" ? agent.inboxCount() : agent.directedPendingCount();
         if (pending > 0) agent.requestWake();
         return {};
       case "SessionEnd":
+        mirror?.flush(ev.transcript_path);
         await agent.setStatus("offline");
         return {};
       default:
@@ -49381,6 +49665,8 @@ async function main() {
   const config2 = configFromEnv();
   const agent = new MeshAgent(config2);
   agent.start();
+  if (/^(1|true|yes|on)$/i.test(process.env.COTAL_TRANSCRIPT ?? ""))
+    mirror = new TranscriptMirror(agent, transcriptChannel(config2.name));
   const socketPath = controlSocketPath(config2.space, config2.name);
   const controlServer = startControlServer(agent, socketPath, claudeHandle);
   const server = new McpServer(

package/dist/mcp.js

@@ -11,6 +11,10 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { configFromEnv, hasIdentity, MeshAgent, controlSocketPath, startControlServer, registerCotalTools, laneLine, feedbackLine, formatInjection, fmtFrom, channelMeta, } from "@cotal-ai/connector-core";
+import { TranscriptMirror, transcriptChannel } from "./transcript.js";
+/** Mirrors this session's transcript to `tr-<name>` — set in main() iff COTAL_TRANSCRIPT
+ *  is on (buildLaunch sets it for managed sessions; personal sessions never mirror). */
+let mirror;
 /**
  * Last tool Claude tried to use, captured on PreToolUse. When a permission Notification
  * fires moments later, this is *what* it's blocked on — so the dashboard shows the actual
@@ -35,6 +39,7 @@ const claudeHandle = async (agent, ev) => {
     try {
         switch (event) {
             case "SessionStart": {
+                mirror?.adopt(ev.transcript_path); // mirror from HERE — a resumed session never rebroadcasts
                 await agent.setStatus("idle");
                 await agent.setAttention("open"); // F3: reset to fail-open on every (re)start — a crashed/restarted agent must not stay silently deaf
                 // Boot push: a one-line note per subscribed channel (if the registry has loaded),
@@ -44,12 +49,14 @@ const claudeHandle = async (agent, ev) => {
             }
             case "UserPromptSubmit":
                 pendingTool = undefined; // new turn — the previous block (if any) is resolved
+                mirror?.flush(ev.transcript_path);
                 await agent.setStatus("working");
                 return withContext(formatInjection(agent.drainInbox()));
             case "PreToolUse":
                 // Remember what Claude is about to do; if it needs permission, the Notification
                 // below turns this into the "blocked on" detail. Auto-approved tools just overwrite it.
                 pendingTool = toolDetail(ev.tool_name, ev.tool_input);
+                mirror?.flush(ev.transcript_path); // near-live mirror: each tool boundary ships the turn so far
                 return {};
             case "Notification": {
                 // Claude Code's Notification carries the human-readable reason the session is
@@ -67,6 +74,7 @@ const claudeHandle = async (agent, ev) => {
             case "Stop":
             case "StopFailure": // turn died on an API error — Stop won't fire, so reset here too
                 pendingTool = undefined; // turn ended — don't let a stale tool attach to an idle-wait notification
+                mirror?.flush(ev.transcript_path);
                 await agent.setStatus("idle");
                 // Now idle: if ambient channel chatter was held while we were busy, ask the channel to
                 // wake one turn so its UserPromptSubmit drains+acks the batch. (Ack sites are two:
@@ -80,6 +88,7 @@ const claudeHandle = async (agent, ev) => {
                     agent.requestWake();
                 return {};
             case "SessionEnd":
+                mirror?.flush(ev.transcript_path); // best-effort — the process may exit before it lands
                 await agent.setStatus("offline");
                 return {};
             default:
@@ -101,6 +110,8 @@ async function main() {
     const config = configFromEnv();
     const agent = new MeshAgent(config);
     agent.start(); // background connect with retry — never blocks tool serving
+    if (/^(1|true|yes|on)$/i.test(process.env.COTAL_TRANSCRIPT ?? ""))
+        mirror = new TranscriptMirror(agent, transcriptChannel(config.name));
     // Local control plane for the lifecycle hooks (presence + message injection).
     const socketPath = controlSocketPath(config.space, config.name);
     const controlServer = startControlServer(agent, socketPath, claudeHandle);

package/dist/mcp.js.map

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

package/dist/transcript.d.ts

@@ -0,0 +1,28 @@
+import type { MeshAgent } from "@cotal-ai/connector-core";
+/** `tr-<name>` with the name reduced to subject-safe channel characters. */
+export declare function transcriptChannel(name: string): string;
+export declare class TranscriptMirror {
+    private readonly agent;
+    private readonly channel;
+    private path?;
+    private offset;
+    /** A batch that failed mid-publish: chunks + how many already landed. Retried (from the
+     *  first unsent chunk — never re-sending a delivered one) before any new read. */
+    private pending?;
+    /** ALL path/offset mutation and publishing runs on this serialized chain — hook events
+     *  land concurrently on the control socket. */
+    private chain;
+    constructor(agent: MeshAgent, channel: string);
+    /** Adopt the transcript at its CURRENT end — mirror only what happens from now on, so a
+     *  resumed session (or a mirror that first sees the path mid-session) never rebroadcasts. */
+    adopt(path: unknown): void;
+    /** Queue a flush of new transcript entries to the channel. Never throws, never blocks the
+     *  hook reply — the read+publish runs on the serialized chain. */
+    flush(path: unknown): void;
+    private enqueue;
+    private adoptNow;
+    private doFlush;
+    /** New complete lines since the offset (a trailing partial line stays for the next flush). */
+    private readComplete;
+}
+//# sourceMappingURL=transcript.d.ts.map

package/dist/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAK1D,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AA8DD,qBAAa,gBAAgB;IAWzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX1B,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,MAAM,CAAK;IACnB;sFACkF;IAClF,OAAO,CAAC,OAAO,CAAC,CAAyD;IACzE;mDAC+C;IAC/C,OAAO,CAAC,KAAK,CAAoC;gBAG9B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM;IAGlC;iGAC6F;IAC7F,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAO1B;sEACkE;IAClE,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAO1B,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,QAAQ;YAWF,OAAO;IAmBrB,8FAA8F;IAC9F,OAAO,CAAC,YAAY;CAyBrB"}

package/dist/transcript.js

@@ -0,0 +1,204 @@
+/**
+ * Transcript mirror — publishes this session's own Claude Code transcript (the JSONL
+ * behind the hooks' `transcript_path`) onto a per-agent mesh channel, `tr-<name>`, so
+ * peers and observer agents can read what the agent is ACTUALLY doing, not only what
+ * it chooses to narrate.
+ *
+ * Off unless the launch sets COTAL_TRANSCRIPT (the connector's buildLaunch sets it for
+ * managed sessions; a personal session never mirrors). Flushes ride the lifecycle hooks:
+ * read the JSONL from the last offset, condense each entry to its observable surface
+ * (assistant text in full, tool calls as one-liners, tool results truncated, thinking
+ * omitted), and multicast the batch. The offset starts at end-of-file on adopt, so a
+ * resumed session never rebroadcasts history. Publishing is at-least-once: the offset
+ * commits only after a successful publish, so a mesh outage replays the batch rather
+ * than losing it.
+ */
+import { closeSync, fstatSync, openSync, readSync, statSync } from "node:fs";
+const MAX_PREVIEW = 700; // tool results / user prompts — enough to see what happened
+const MAX_CHUNK = 6000; // chars per published message; batches split on entry boundaries
+/** `tr-<name>` with the name reduced to subject-safe channel characters. */
+export function transcriptChannel(name) {
+    return `tr-${name.toLowerCase().replace(/[^a-z0-9_-]+/g, "-")}`;
+}
+function truncate(s, max) {
+    return s.length > max ? `${s.slice(0, max - 1)}…` : s;
+}
+/** A tool call's most salient input, mirroring the presence preview in mcp.ts. */
+function salient(input) {
+    const i = (input ?? {});
+    const v = i.command ?? i.file_path ?? i.path ?? i.url ?? i.pattern ?? i.description;
+    const s = typeof v === "string" ? v : Object.keys(i).length ? JSON.stringify(i) : "";
+    return s ? `: ${truncate(s, 300)}` : "";
+}
+/** Flatten a tool_result's content (string or text-block array) to plain text. */
+function resultText(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content))
+        return content
+            .map((b) => (typeof b?.text === "string" ? b.text : ""))
+            .filter(Boolean)
+            .join("\n");
+    return "";
+}
+/** One JSONL entry → the lines worth mirroring (empty for meta/system/thinking-only entries). */
+function condense(line) {
+    let e;
+    try {
+        e = JSON.parse(line);
+    }
+    catch {
+        return [];
+    }
+    if (!e || e.isMeta)
+        return [];
+    const content = e.message?.content;
+    if (e.type === "assistant" && Array.isArray(content)) {
+        const out = [];
+        for (const b of content) {
+            if (b.type === "text" && b.text?.trim())
+                out.push(b.text.trim());
+            else if (b.type === "tool_use" && b.name)
+                out.push(`⚒ ${b.name}${salient(b.input)}`);
+        }
+        return out;
+    }
+    if (e.type === "user") {
+        if (typeof content === "string")
+            return content.trim() ? [`» ${truncate(content.trim(), MAX_PREVIEW)}`] : [];
+        if (Array.isArray(content)) {
+            const out = [];
+            for (const b of content) {
+                if (b.type === "tool_result") {
+                    const t = resultText(b.content).trim();
+                    out.push(`→ ${b.is_error ? "ERROR: " : ""}${t ? truncate(t, MAX_PREVIEW) : "(no output)"}`);
+                }
+                else if (b.type === "text" && b.text?.trim()) {
+                    out.push(`» ${truncate(b.text.trim(), MAX_PREVIEW)}`);
+                }
+            }
+            return out;
+        }
+    }
+    return [];
+}
+export class TranscriptMirror {
+    agent;
+    channel;
+    path;
+    offset = 0;
+    /** A batch that failed mid-publish: chunks + how many already landed. Retried (from the
+     *  first unsent chunk — never re-sending a delivered one) before any new read. */
+    pending;
+    /** ALL path/offset mutation and publishing runs on this serialized chain — hook events
+     *  land concurrently on the control socket. */
+    chain = Promise.resolve();
+    constructor(agent, channel) {
+        this.agent = agent;
+        this.channel = channel;
+    }
+    /** Adopt the transcript at its CURRENT end — mirror only what happens from now on, so a
+     *  resumed session (or a mirror that first sees the path mid-session) never rebroadcasts. */
+    adopt(path) {
+        this.enqueue(() => {
+            this.adoptNow(path);
+            return Promise.resolve();
+        });
+    }
+    /** Queue a flush of new transcript entries to the channel. Never throws, never blocks the
+     *  hook reply — the read+publish runs on the serialized chain. */
+    flush(path) {
+        this.enqueue(() => {
+            if (!this.path)
+                this.adoptNow(path);
+            return this.doFlush();
+        });
+    }
+    enqueue(step) {
+        this.chain = this.chain.then(step).catch((e) => {
+            process.stderr.write(`[cotal-connector] transcript mirror: ${e.message}\n`);
+        });
+    }
+    adoptNow(path) {
+        if (typeof path !== "string" || !path || this.path === path)
+            return;
+        this.path = path;
+        this.pending = undefined; // a batch from the old path must not commit the new offset
+        try {
+            this.offset = statSync(path).size;
+        }
+        catch {
+            this.offset = 0; // not written yet — everything from byte 0 is this session's
+        }
+    }
+    async doFlush() {
+        if (!this.path || !this.agent.connected)
+            return; // offset untouched — catch up next flush
+        if (!this.pending) {
+            const { lines, nextOffset } = this.readComplete();
+            if (nextOffset === this.offset)
+                return; // nothing new
+            this.pending = { chunks: chunkLines(lines.flatMap(condense), MAX_CHUNK), sent: 0, nextOffset };
+        }
+        // Publish the pinned batch, tracking per-chunk progress: a mid-batch failure resumes at
+        // the first UNSENT chunk (no duplicates), and only a fully delivered batch commits the
+        // offset — the read range stays pinned until then.
+        const p = this.pending;
+        while (p.sent < p.chunks.length) {
+            await this.agent.send(p.chunks[p.sent], this.channel);
+            p.sent++;
+        }
+        this.offset = p.nextOffset;
+        this.pending = undefined;
+    }
+    /** New complete lines since the offset (a trailing partial line stays for the next flush). */
+    readComplete() {
+        const none = () => ({ lines: [], nextOffset: this.offset }); // evaluated late — after any truncation reset
+        let fd;
+        try {
+            fd = openSync(this.path, "r");
+        }
+        catch {
+            return none();
+        }
+        try {
+            const size = fstatSync(fd).size;
+            if (size < this.offset)
+                this.offset = 0; // truncated/rotated — start over
+            if (size === this.offset)
+                return none();
+            const buf = Buffer.alloc(size - this.offset);
+            readSync(fd, buf, 0, buf.length, this.offset);
+            const text = buf.toString("utf8");
+            const lastNl = text.lastIndexOf("\n");
+            if (lastNl < 0)
+                return none();
+            return {
+                lines: text.slice(0, lastNl).split("\n").filter(Boolean),
+                nextOffset: this.offset + Buffer.byteLength(text.slice(0, lastNl + 1), "utf8"),
+            };
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+}
+/** Pack lines into chunks of at most `max` chars, splitting only on line boundaries
+ *  (an oversized single line becomes its own chunk — never dropped). */
+function chunkLines(lines, max) {
+    const chunks = [];
+    let cur = "";
+    for (const line of lines) {
+        if (cur && cur.length + 1 + line.length > max) {
+            chunks.push(cur);
+            cur = line;
+        }
+        else {
+            cur = cur ? `${cur}\n${line}` : line;
+        }
+    }
+    if (cur)
+        chunks.push(cur);
+    return chunks;
+}
+//# sourceMappingURL=transcript.js.map

package/dist/transcript.js.map

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

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.1.4-next-20260612020133",
+  "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-next-20260612020133"
+    "@cotal-ai/connector-core": "0.3.0"
   },
   "peerDependencies": {
-    "@cotal-ai/core": "0.1.2"
+    "@cotal-ai/core": ">=0.1.0"
   },
   "devDependencies": {
     "esbuild": "^0.28.0",
     "tsx": "^4.22.4",
-    "@cotal-ai/core": "0.1.2"
+    "@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"
   }
 }