@hasna/conversations 0.2.28 → 0.2.30

package/bin/index.js

@@ -14928,7 +14928,7 @@ var init_presence = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/conversations",
-    version: "0.2.28",
+    version: "0.2.30",
     description: "Real-time CLI messaging for AI agents",
     type: "module",
     bin: {
@@ -15709,6 +15709,125 @@ var init_graph = __esm(() => {
   init_db();
 });
 
+// src/cli/commands/tmux.ts
+import chalk9 from "chalk";
+import { execSync } from "child_process";
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function tmuxSend(target, message, opts = {}) {
+  const delay = opts.delayMs ?? Math.max(12000, message.length * 50);
+  const maxRetries = opts.retries ?? 3;
+  const verify = opts.verify !== false;
+  for (let attempt = 1;attempt <= maxRetries; attempt++) {
+    execSync(`tmux send-keys -t ${JSON.stringify(target)} -l ${JSON.stringify(message)}`);
+    await sleep(delay);
+    execSync(`tmux send-keys -t ${JSON.stringify(target)} Enter`);
+    if (!verify)
+      return { success: true, attempts: attempt };
+    await sleep(500);
+    const pane = execSync(`tmux capture-pane -t ${JSON.stringify(target)} -p`).toString();
+    const lastLines = pane.split(`
+`).slice(-3).join(`
+`);
+    if (!lastLines.includes(message.slice(0, 20))) {
+      return { success: true, attempts: attempt };
+    }
+    if (attempt < maxRetries)
+      await sleep(2000);
+  }
+  return { success: false, attempts: maxRetries };
+}
+function registerTmuxCommands(program2) {
+  const tmux = program2.command("tmux").description("Dispatch messages to tmux windows (Claude Code sessions)");
+  tmux.command("send").description("Send a message to a tmux window with paste+wait+Enter+verify").requiredOption("--target <target>", "Tmux target: session:window or session:window.pane").requiredOption("--message <text>", "Message text to send").option("--delay <ms>", "Wait time (ms) after paste before hitting Enter (default: max(12000, len*50))", parseInt).option("--retries <n>", "Max retry attempts (default: 3)", parseInt).option("--no-verify", "Skip verification after sending").option("--json", "Output result as JSON").action(async (opts) => {
+    const target = opts.target.trim();
+    const message = opts.message;
+    if (!target) {
+      console.error(chalk9.red("--target is required."));
+      process.exit(1);
+    }
+    if (!message || !message.trim()) {
+      console.error(chalk9.red("--message cannot be empty."));
+      process.exit(1);
+    }
+    try {
+      const result = await tmuxSend(target, message, {
+        delayMs: Number.isFinite(opts.delay) ? opts.delay : undefined,
+        retries: Number.isFinite(opts.retries) ? opts.retries : undefined,
+        verify: opts.verify !== false
+      });
+      if (opts.json) {
+        console.log(JSON.stringify({ target, result }));
+      } else if (result.success) {
+        console.log(chalk9.green(`Sent to ${target}`) + chalk9.dim(` (attempt ${result.attempts})`));
+      } else {
+        console.error(chalk9.red(`Failed to confirm delivery to ${target}`) + chalk9.dim(` after ${result.attempts} attempt(s)`));
+        process.exit(1);
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (opts.json) {
+        console.log(JSON.stringify({ target, error: msg }));
+      } else {
+        console.error(chalk9.red(`tmux error: ${msg}`));
+      }
+      process.exit(1);
+    }
+  });
+  tmux.command("broadcast").description("Send the same message to multiple tmux windows").requiredOption("--targets <list>", "Comma-separated list of tmux targets").requiredOption("--message <text>", "Message text to send").option("--delay <ms>", "Wait time (ms) after paste before Enter (default: max(12000, len*50))", parseInt).option("--stagger <ms>", "Delay (ms) between each target (default: 0)", parseInt).option("--retries <n>", "Max retry attempts per target (default: 3)", parseInt).option("--no-verify", "Skip verification after sending").option("--json", "Output results as JSON").action(async (opts) => {
+    const targets = opts.targets.split(",").map((t) => t.trim()).filter(Boolean);
+    const message = opts.message;
+    const stagger = Number.isFinite(opts.stagger) && opts.stagger > 0 ? opts.stagger : 0;
+    if (targets.length === 0) {
+      console.error(chalk9.red("--targets must be a non-empty comma-separated list."));
+      process.exit(1);
+    }
+    if (!message || !message.trim()) {
+      console.error(chalk9.red("--message cannot be empty."));
+      process.exit(1);
+    }
+    const results = [];
+    for (let i = 0;i < targets.length; i++) {
+      const target = targets[i];
+      if (i > 0 && stagger > 0)
+        await sleep(stagger);
+      try {
+        const result = await tmuxSend(target, message, {
+          delayMs: Number.isFinite(opts.delay) ? opts.delay : undefined,
+          retries: Number.isFinite(opts.retries) ? opts.retries : undefined,
+          verify: opts.verify !== false
+        });
+        results.push({ target, ...result });
+        if (!opts.json) {
+          if (result.success) {
+            console.log(chalk9.green(`  \u2713 ${target}`) + chalk9.dim(` (attempt ${result.attempts})`));
+          } else {
+            console.log(chalk9.red(`  \u2717 ${target}`) + chalk9.dim(` (failed after ${result.attempts} attempts)`));
+          }
+        }
+      } catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        results.push({ target, success: false, attempts: 0, error: errMsg });
+        if (!opts.json) {
+          console.log(chalk9.red(`  \u2717 ${target}: ${errMsg}`));
+        }
+      }
+    }
+    const succeeded = results.filter((r) => r.success).length;
+    const failed = results.length - succeeded;
+    if (opts.json) {
+      console.log(JSON.stringify({ results, succeeded, failed, total: results.length }));
+    } else {
+      console.log(chalk9.dim(`
+Broadcast complete: ${chalk9.green(succeeded)} succeeded, ${failed > 0 ? chalk9.red(failed) : chalk9.dim(failed)} failed`));
+    }
+    if (failed > 0)
+      process.exit(1);
+  });
+}
+var init_tmux = () => {};
+
 // node_modules/zod/v3/helpers/util.js
 var util2, objectUtil2, ZodParsedType2, getParsedType2 = (data) => {
   const t = typeof data;
@@ -46770,6 +46889,156 @@ var init_cloud = __esm(() => {
   CONFLICT_TABLES = new Set(["spaces", "projects", "agent_presence"]);
 });
 
+// src/mcp/channel.ts
+function registerChannelBridge(server, getAgentId) {
+  server.server.registerCapabilities({
+    experimental: {
+      "claude/channel": {}
+    }
+  });
+  let lastSeenId = 0;
+  let pollTimer = null;
+  function seedLastSeen(agentId) {
+    const latest = readMessages({
+      to: agentId,
+      order: "desc",
+      limit: 1
+    });
+    if (latest.length > 0) {
+      lastSeenId = latest[0].id;
+    }
+  }
+  function startPolling2() {
+    if (pollTimer)
+      return;
+    const agentId = getAgentId();
+    if (!agentId)
+      return;
+    seedLastSeen(agentId);
+    pollTimer = setInterval(() => {
+      const currentAgent = getAgentId();
+      if (!currentAgent)
+        return;
+      try {
+        const newMessages = readMessages({
+          to: currentAgent,
+          order: "asc",
+          limit: 20
+        }).filter((m) => m.id > lastSeenId);
+        for (const msg of newMessages) {
+          lastSeenId = msg.id;
+          server.server.notification({
+            method: "notifications/claude/channel",
+            params: {
+              content: msg.content,
+              meta: {
+                from: msg.from_agent,
+                session_id: msg.session_id,
+                ...msg.space ? { space: msg.space } : {},
+                ...msg.priority !== "normal" ? { priority: msg.priority } : {}
+              }
+            }
+          });
+        }
+      } catch {}
+    }, POLL_INTERVAL_MS);
+  }
+  setTimeout(() => startPolling2(), 500);
+}
+var POLL_INTERVAL_MS = 1000;
+var init_channel = __esm(() => {
+  init_messages();
+});
+
+// src/mcp/tools/tmux.ts
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function registerTmuxTools(server) {
+  server.registerTool("tmux_send", {
+    description: "Send a message to a tmux window (e.g. another agent's Claude Code session). " + "Pastes the text literally, waits for the pane to be idle, hits Enter, then verifies the message was submitted. " + "Retries up to N times on failure.",
+    inputSchema: {
+      target: exports_external2.string().describe("Tmux target: session:window or session:window.pane (e.g. platform-alumia:1)"),
+      message: exports_external2.string().describe("Message text to send"),
+      delay_ms: exports_external2.coerce.number().optional().describe("Wait time (ms) after paste before hitting Enter. Default: max(12000, message_length * 50)"),
+      retries: exports_external2.coerce.number().optional().describe("Max retry attempts (default: 3)"),
+      verify: exports_external2.coerce.boolean().optional().describe("Verify message was submitted after Enter (default: true)")
+    }
+  }, async (args) => {
+    const { target, message, delay_ms, retries, verify } = args;
+    if (!target || !target.trim()) {
+      return { content: [{ type: "text", text: "target is required" }], isError: true };
+    }
+    if (!message || !message.trim()) {
+      return { content: [{ type: "text", text: "message cannot be empty" }], isError: true };
+    }
+    try {
+      const result = await tmuxSend(target.trim(), message, {
+        delayMs: typeof delay_ms === "number" && delay_ms > 0 ? delay_ms : undefined,
+        retries: typeof retries === "number" && retries > 0 ? retries : undefined,
+        verify: verify !== false
+      });
+      return {
+        content: [{ type: "text", text: JSON.stringify({ target, result }) }],
+        isError: !result.success
+      };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `tmux error: ${msg}` }], isError: true };
+    }
+  });
+  server.registerTool("tmux_broadcast", {
+    description: "Send the same message to multiple tmux windows simultaneously. " + "Useful for broadcasting instructions to several agent sessions at once. " + "Supports staggered sending and per-target retry.",
+    inputSchema: {
+      targets: exports_external2.array(exports_external2.string()).describe("List of tmux targets (session:window or session:window.pane)"),
+      message: exports_external2.string().describe("Message text to send to all targets"),
+      delay_ms: exports_external2.coerce.number().optional().describe("Wait time (ms) after paste before Enter. Default: max(12000, message_length * 50)"),
+      stagger_ms: exports_external2.coerce.number().optional().describe("Delay (ms) between sending to each target (default: 0)"),
+      retries: exports_external2.coerce.number().optional().describe("Max retry attempts per target (default: 3)"),
+      verify: exports_external2.coerce.boolean().optional().describe("Verify each message was submitted (default: true)")
+    }
+  }, async (args) => {
+    const { targets, message, delay_ms, stagger_ms, retries, verify } = args;
+    if (!Array.isArray(targets) || targets.length === 0) {
+      return { content: [{ type: "text", text: "targets must be a non-empty array" }], isError: true };
+    }
+    if (!message || !message.trim()) {
+      return { content: [{ type: "text", text: "message cannot be empty" }], isError: true };
+    }
+    const stagger = typeof stagger_ms === "number" && stagger_ms > 0 ? stagger_ms : 0;
+    const results = [];
+    for (let i = 0;i < targets.length; i++) {
+      const target = targets[i].trim();
+      if (i > 0 && stagger > 0)
+        await sleep2(stagger);
+      try {
+        const result = await tmuxSend(target, message, {
+          delayMs: typeof delay_ms === "number" && delay_ms > 0 ? delay_ms : undefined,
+          retries: typeof retries === "number" && retries > 0 ? retries : undefined,
+          verify: verify !== false
+        });
+        results.push({ target, ...result });
+      } catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        results.push({ target, success: false, attempts: 0, error: errMsg });
+      }
+    }
+    const succeeded = results.filter((r) => r.success).length;
+    const failed = results.length - succeeded;
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({ results, succeeded, failed, total: results.length })
+      }],
+      isError: failed > 0
+    };
+  });
+}
+var init_tmux2 = __esm(() => {
+  init_zod2();
+  init_tmux();
+});
+
 // src/mcp/index.ts
 var exports_mcp = {};
 __export(exports_mcp, {
@@ -46804,6 +47073,8 @@ var init_mcp2 = __esm(() => {
   init_agents();
   init_advanced();
   init_cloud();
+  init_channel();
+  init_tmux2();
   import__package2 = __toESM(require_package(), 1);
   server = new McpServer({
     name: "conversations",
@@ -46815,6 +47086,8 @@ var init_mcp2 = __esm(() => {
   registerProjectTools(server);
   registerAgentTools(server, agentFocus, getAgentFocus);
   registerAdvancedTools(server, import__package2.default.version);
+  registerTmuxTools(server);
+  registerChannelBridge(server, () => process.env.CONVERSATIONS_AGENT_ID ?? null);
   isDirectRun = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith("mcp.js") || process.argv[1]?.endsWith("mcp.ts");
   if (isDirectRun) {
     startMcpServer().catch((error48) => {
@@ -47403,7 +47676,7 @@ var {
 
 // src/cli/index.tsx
 init_identity();
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 import { render } from "ink";
 import React8 from "react";
 
@@ -48518,17 +48791,18 @@ init_presence();
 init_db();
 import chalk4 from "chalk";
 function registerMessagingCommands(program2) {
-  program2.command("send").description("Send a message to an agent").argument("<message>", "Message content").requiredOption("--to <agent>", "Recipient agent ID").option("--from <agent>", "Sender agent ID").option("--session <id>", "Session ID (auto-generated if omitted)").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("--working-dir <path>", "Working directory context").option("--repository <repo>", "Repository context").option("--branch <branch>", "Branch context").option("--metadata <json>", "JSON metadata string").option("--blocking", "Send as a blocking message (recipient must acknowledge)").option("--json", "Output as JSON").action((message, opts) => {
+  program2.command("send").description("Send a message to an agent").argument("<message>", "Message content").option("--to <agent>", "Recipient agent ID (required unless --space is used)").option("--from <agent>", "Sender agent ID").option("--session <id>", "Session ID (auto-generated if omitted)").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("--working-dir <path>", "Working directory context").option("--repository <repo>", "Repository context").option("--branch <branch>", "Branch context").option("--metadata <json>", "JSON metadata string").option("--space <name>", "Send to a space instead of a specific agent").option("--blocking", "Send as a blocking message (recipient must acknowledge)").option("--json", "Output as JSON").action((message, opts) => {
     const from = resolveIdentity(opts.from).trim();
     const to = typeof opts.to === "string" ? opts.to.trim() : "";
+    const space = typeof opts.space === "string" ? opts.space.trim() : "";
     const content = typeof message === "string" ? message : "";
     const session = typeof opts.session === "string" && opts.session.trim() ? opts.session.trim() : undefined;
     if (!from) {
       console.error(chalk4.red("Sender identity is required."));
       process.exit(1);
     }
-    if (!to) {
-      console.error(chalk4.red("Recipient is required."));
+    if (!to && !space) {
+      console.error(chalk4.red("Recipient is required: use --to <agent> or --space <name>."));
       process.exit(1);
     }
     if (!content.trim()) {
@@ -48546,7 +48820,8 @@ function registerMessagingCommands(program2) {
     }
     const msg = sendMessage({
       from,
-      to,
+      to: to || from,
+      space: space || undefined,
       content,
       session_id: session,
       priority: opts.priority,
@@ -48558,6 +48833,8 @@ function registerMessagingCommands(program2) {
     });
     if (opts.json) {
       console.log(JSON.stringify(msg, null, 2));
+    } else if (space) {
+      console.log(chalk4.green(`Message sent to #${space}`) + chalk4.dim(` (id: ${msg.id})`));
     } else {
       console.log(chalk4.green(`Message sent`) + chalk4.dim(` (id: ${msg.id}, session: ${msg.session_id})`));
     }
@@ -49412,7 +49689,7 @@ function registerProjectCommands(program2) {
     }
     closeDb();
   });
-  project.command("update").description("Update a project").argument("<id>", "Project ID").option("--name <name>", "New name").option("--description <text>", "New description").option("--path <path>", "New path").option("--status <status>", "New status (active/archived)").option("--repository <url>", "New repository URL").option("--tags <json>", "New tags (JSON array)").option("--json", "Output as JSON").action((id, opts) => {
+  project.command("update").description("Update a project").argument("<id-or-name>", "Project ID or name").option("--name <name>", "New name").option("--description <text>", "New description").option("--path <path>", "New path").option("--status <status>", "New status (active/archived)").option("--repository <url>", "New repository URL").option("--tags <json>", "New tags (JSON array)").option("--json", "Output as JSON").action((id, opts) => {
     const updates = {};
     if (opts.name)
       updates.name = opts.name;
@@ -49433,7 +49710,9 @@ function registerProjectCommands(program2) {
       }
     }
     try {
-      const p = updateProject(id, updates);
+      const isUuid = /^[0-9a-f-]{36}$/i.test(id);
+      const resolvedId = isUuid ? id : getProjectByName(id)?.id ?? id;
+      const p = updateProject(resolvedId, updates);
       if (opts.json) {
         console.log(JSON.stringify(p, null, 2));
       } else {
@@ -49445,9 +49724,11 @@ function registerProjectCommands(program2) {
     }
     closeDb();
   });
-  project.command("delete").description("Delete a project").argument("<id>", "Project ID").option("--json", "Output as JSON").action((id, opts) => {
+  project.command("delete").description("Delete a project").argument("<id-or-name>", "Project ID or name").option("--json", "Output as JSON").action((id, opts) => {
     try {
-      const deleted = deleteProject(id);
+      const isUuid = /^[0-9a-f-]{36}$/i.test(id);
+      const resolvedId = isUuid ? id : getProjectByName(id)?.id ?? id;
+      const deleted = deleteProject(resolvedId);
       if (!deleted) {
         console.error(chalk6.red(`Project "${id}" not found.`));
         process.exit(1);
@@ -50008,6 +50289,7 @@ function registerAnalyticsCommands(program2) {
 }
 
 // src/cli/index.tsx
+init_tmux();
 var import__package3 = __toESM(require_package(), 1);
 var program2 = new Command;
 program2.name("conversations").description("Real-time CLI messaging for AI agents").version(import__package3.default.version);
@@ -50016,6 +50298,7 @@ registerSpaceCommands(program2);
 registerProjectCommands(program2);
 registerAgentCommands(program2);
 registerAnalyticsCommands(program2);
+registerTmuxCommands(program2);
 program2.command("mcp").description("Start MCP server").action(async () => {
   const { startMcpServer: startMcpServer2 } = await Promise.resolve().then(() => (init_mcp2(), exports_mcp));
   await startMcpServer2();
@@ -50040,11 +50323,11 @@ registerCloudCommands(program2, "conversations");
         const { PG_MIGRATIONS: PG_MIGRATIONS2 } = await Promise.resolve().then(() => (init_pg_migrations(), exports_pg_migrations));
         const config2 = getCloudConfig2();
         if (config2.mode === "local") {
-          console.error(chalk9.red("Error: cloud mode not configured. Set RDS credentials first."));
+          console.error(chalk10.red("Error: cloud mode not configured. Set RDS credentials first."));
           process.exit(1);
         }
         if (opts.dryRun) {
-          console.log(chalk9.dim(`-- Dry run: SQL that would be executed --
+          console.log(chalk10.dim(`-- Dry run: SQL that would be executed --
 `));
           for (const sql of PG_MIGRATIONS2)
             console.log(sql);
@@ -50052,14 +50335,14 @@ registerCloudCommands(program2, "conversations");
         }
         const pg = new PgAdapterAsync2(getConnectionString2("conversations"));
         for (let i = 0;i < PG_MIGRATIONS2.length; i++) {
-          process.stdout.write(chalk9.dim(`Running migration ${i + 1}/${PG_MIGRATIONS2.length}...`));
+          process.stdout.write(chalk10.dim(`Running migration ${i + 1}/${PG_MIGRATIONS2.length}...`));
           await pg.run(PG_MIGRATIONS2[i]);
-          console.log(chalk9.green(" done"));
+          console.log(chalk10.green(" done"));
         }
         await pg.close();
-        console.log(chalk9.green("\u2713 All migrations applied."));
+        console.log(chalk10.green("\u2713 All migrations applied."));
       } catch (e) {
-        console.error(chalk9.red(`Migration failed: ${e?.message ?? e}`));
+        console.error(chalk10.red(`Migration failed: ${e?.message ?? e}`));
         process.exit(1);
       }
     });
@@ -50067,8 +50350,8 @@ registerCloudCommands(program2, "conversations");
 }
 program2.action(() => {
   if (!process.stdin.isTTY) {
-    console.error(chalk9.red("Interactive mode requires a TTY terminal."));
-    console.error(chalk9.dim("Use subcommands (send, read, sessions, etc.) for non-interactive use."));
+    console.error(chalk10.red("Interactive mode requires a TTY terminal."));
+    console.error(chalk10.dim("Use subcommands (send, read, sessions, etc.) for non-interactive use."));
     process.exit(1);
   }
   const agent = resolveIdentity();

package/bin/mcp.js

@@ -44049,10 +44049,182 @@ function formatError2(e) {
     return e.message;
   return String(e);
 }
+
+// src/mcp/channel.ts
+var POLL_INTERVAL_MS = 1000;
+function registerChannelBridge(server, getAgentId) {
+  server.server.registerCapabilities({
+    experimental: {
+      "claude/channel": {}
+    }
+  });
+  let lastSeenId = 0;
+  let pollTimer = null;
+  function seedLastSeen(agentId) {
+    const latest = readMessages({
+      to: agentId,
+      order: "desc",
+      limit: 1
+    });
+    if (latest.length > 0) {
+      lastSeenId = latest[0].id;
+    }
+  }
+  function startPolling() {
+    if (pollTimer)
+      return;
+    const agentId = getAgentId();
+    if (!agentId)
+      return;
+    seedLastSeen(agentId);
+    pollTimer = setInterval(() => {
+      const currentAgent = getAgentId();
+      if (!currentAgent)
+        return;
+      try {
+        const newMessages = readMessages({
+          to: currentAgent,
+          order: "asc",
+          limit: 20
+        }).filter((m) => m.id > lastSeenId);
+        for (const msg of newMessages) {
+          lastSeenId = msg.id;
+          server.server.notification({
+            method: "notifications/claude/channel",
+            params: {
+              content: msg.content,
+              meta: {
+                from: msg.from_agent,
+                session_id: msg.session_id,
+                ...msg.space ? { space: msg.space } : {},
+                ...msg.priority !== "normal" ? { priority: msg.priority } : {}
+              }
+            }
+          });
+        }
+      } catch {}
+    }, POLL_INTERVAL_MS);
+  }
+  setTimeout(() => startPolling(), 500);
+}
+
+// src/cli/commands/tmux.ts
+import { execSync } from "child_process";
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function tmuxSend(target, message, opts = {}) {
+  const delay = opts.delayMs ?? Math.max(12000, message.length * 50);
+  const maxRetries = opts.retries ?? 3;
+  const verify = opts.verify !== false;
+  for (let attempt = 1;attempt <= maxRetries; attempt++) {
+    execSync(`tmux send-keys -t ${JSON.stringify(target)} -l ${JSON.stringify(message)}`);
+    await sleep(delay);
+    execSync(`tmux send-keys -t ${JSON.stringify(target)} Enter`);
+    if (!verify)
+      return { success: true, attempts: attempt };
+    await sleep(500);
+    const pane = execSync(`tmux capture-pane -t ${JSON.stringify(target)} -p`).toString();
+    const lastLines = pane.split(`
+`).slice(-3).join(`
+`);
+    if (!lastLines.includes(message.slice(0, 20))) {
+      return { success: true, attempts: attempt };
+    }
+    if (attempt < maxRetries)
+      await sleep(2000);
+  }
+  return { success: false, attempts: maxRetries };
+}
+
+// src/mcp/tools/tmux.ts
+function sleep2(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function registerTmuxTools(server) {
+  server.registerTool("tmux_send", {
+    description: "Send a message to a tmux window (e.g. another agent's Claude Code session). " + "Pastes the text literally, waits for the pane to be idle, hits Enter, then verifies the message was submitted. " + "Retries up to N times on failure.",
+    inputSchema: {
+      target: exports_external.string().describe("Tmux target: session:window or session:window.pane (e.g. platform-alumia:1)"),
+      message: exports_external.string().describe("Message text to send"),
+      delay_ms: exports_external.coerce.number().optional().describe("Wait time (ms) after paste before hitting Enter. Default: max(12000, message_length * 50)"),
+      retries: exports_external.coerce.number().optional().describe("Max retry attempts (default: 3)"),
+      verify: exports_external.coerce.boolean().optional().describe("Verify message was submitted after Enter (default: true)")
+    }
+  }, async (args) => {
+    const { target, message, delay_ms, retries, verify } = args;
+    if (!target || !target.trim()) {
+      return { content: [{ type: "text", text: "target is required" }], isError: true };
+    }
+    if (!message || !message.trim()) {
+      return { content: [{ type: "text", text: "message cannot be empty" }], isError: true };
+    }
+    try {
+      const result = await tmuxSend(target.trim(), message, {
+        delayMs: typeof delay_ms === "number" && delay_ms > 0 ? delay_ms : undefined,
+        retries: typeof retries === "number" && retries > 0 ? retries : undefined,
+        verify: verify !== false
+      });
+      return {
+        content: [{ type: "text", text: JSON.stringify({ target, result }) }],
+        isError: !result.success
+      };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { content: [{ type: "text", text: `tmux error: ${msg}` }], isError: true };
+    }
+  });
+  server.registerTool("tmux_broadcast", {
+    description: "Send the same message to multiple tmux windows simultaneously. " + "Useful for broadcasting instructions to several agent sessions at once. " + "Supports staggered sending and per-target retry.",
+    inputSchema: {
+      targets: exports_external.array(exports_external.string()).describe("List of tmux targets (session:window or session:window.pane)"),
+      message: exports_external.string().describe("Message text to send to all targets"),
+      delay_ms: exports_external.coerce.number().optional().describe("Wait time (ms) after paste before Enter. Default: max(12000, message_length * 50)"),
+      stagger_ms: exports_external.coerce.number().optional().describe("Delay (ms) between sending to each target (default: 0)"),
+      retries: exports_external.coerce.number().optional().describe("Max retry attempts per target (default: 3)"),
+      verify: exports_external.coerce.boolean().optional().describe("Verify each message was submitted (default: true)")
+    }
+  }, async (args) => {
+    const { targets, message, delay_ms, stagger_ms, retries, verify } = args;
+    if (!Array.isArray(targets) || targets.length === 0) {
+      return { content: [{ type: "text", text: "targets must be a non-empty array" }], isError: true };
+    }
+    if (!message || !message.trim()) {
+      return { content: [{ type: "text", text: "message cannot be empty" }], isError: true };
+    }
+    const stagger = typeof stagger_ms === "number" && stagger_ms > 0 ? stagger_ms : 0;
+    const results = [];
+    for (let i = 0;i < targets.length; i++) {
+      const target = targets[i].trim();
+      if (i > 0 && stagger > 0)
+        await sleep2(stagger);
+      try {
+        const result = await tmuxSend(target, message, {
+          delayMs: typeof delay_ms === "number" && delay_ms > 0 ? delay_ms : undefined,
+          retries: typeof retries === "number" && retries > 0 ? retries : undefined,
+          verify: verify !== false
+        });
+        results.push({ target, ...result });
+      } catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        results.push({ target, success: false, attempts: 0, error: errMsg });
+      }
+    }
+    const succeeded = results.filter((r) => r.success).length;
+    const failed = results.length - succeeded;
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({ results, succeeded, failed, total: results.length })
+      }],
+      isError: failed > 0
+    };
+  });
+}
 // package.json
 var package_default = {
   name: "@hasna/conversations",
-  version: "0.2.28",
+  version: "0.2.30",
   description: "Real-time CLI messaging for AI agents",
   type: "module",
   bin: {
@@ -44154,6 +44326,8 @@ registerSpaceTools(server);
 registerProjectTools(server);
 registerAgentTools(server, agentFocus, getAgentFocus);
 registerAdvancedTools(server, package_default.version);
+registerTmuxTools(server);
+registerChannelBridge(server, () => process.env.CONVERSATIONS_AGENT_ID ?? null);
 async function startMcpServer() {
   const transport = new StdioServerTransport;
   registerCloudSyncTools(server);

package/dist/cli/commands/tmux.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from "commander";
+interface TmuxSendOptions {
+    delayMs?: number;
+    retries?: number;
+    verify?: boolean;
+}
+interface TmuxSendResult {
+    success: boolean;
+    attempts: number;
+}
+export declare function tmuxSend(target: string, message: string, opts?: TmuxSendOptions): Promise<TmuxSendResult>;
+export declare function registerTmuxCommands(program: Command): void;
+export {};

package/dist/mcp/channel.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Claude Code channel bridge for conversations MCP server.
+ *
+ * Declares `experimental['claude/channel']` capability so Claude Code
+ * (and agent-claude) can use this server as a channel for inter-session
+ * messaging. When enabled, polls for new DMs to the current agent and
+ * pushes them as `notifications/claude/channel` events.
+ *
+ * Usage: Start agent-claude with:
+ *   agent-claude --channels server:conversations --dangerously-load-development-channels
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register the claude/channel capability and start polling for
+ * inbound messages to push as notifications.
+ */
+export declare function registerChannelBridge(server: McpServer, getAgentId: () => string | null): void;

package/dist/mcp/tools/tmux.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tmux dispatch tools: tmux_send, tmux_broadcast
+ *
+ * Send messages to tmux windows (other Claude Code sessions) with
+ * smart paste → wait → Enter → verify behavior.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTmuxTools(server: McpServer): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/conversations",
-  "version": "0.2.28",
+  "version": "0.2.30",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {