bus-agent 2.3.4 → 2.3.6

package/SKILL.md

@@ -1,12 +1,12 @@
-# MCP CoCo — Universal Agent Communication Hub
+# MCP Bus — Universal Agent Communication Hub
 
 ## Overview
 
-MCP CoCo is an **Agent Communication Hub** — an MCP server that lets **any MCP-compatible agent** talk to any other.
+MCP Bus is an **Agent Communication Hub** — an MCP server that lets **any MCP-compatible agent** talk to any other.
 
 ```
 OpenClaw (Andul) ──┐
-                    ├──▶ MCP CoCo (Agent Bus) ◀──▶ Claude Desktop
+                    ├──▶ MCP Bus (Agent Bus) ◀──▶ Claude Desktop
 Hermes Agent ──────┘                               Cursor
                         │                          Any MCP agent
                         ├─ message_send(to, msg)
@@ -26,7 +26,7 @@ GitHub: https://github.com/ClewCode/bus-agent
 
 ```bash
 # Stdio mode (via mcporter)
-mcporter add coco --stdio "node E:\_system\.openclaw\workspace\repos\mcp-coco\index.js"
+mcporter add bus-agent --stdio "node E:\_system\.openclaw\workspace\repos\mcp-coco\index.js"
 
 # Daemon mode
 node E:\_system\.openclaw\workspace\repos\mcp-coco\index.js --daemon
@@ -44,7 +44,7 @@ node E:\_system\.openclaw\workspace\repos\mcp-coco\index.js --health
 | `ask_hermes(prompt, session_key?)` | Talk to Hermes Agent (multi-turn) |
 | `hermes_send(target, message)` | Send via Hermes to chat platform |
 | `hermes_channels(platform?)` | List Hermes channels |
-| `coco_health()` | Health check (CLI + gateway) |
+| `bus_health()` | Health check (CLI + gateway) |
 
 ### Agent Bus (new)
 
@@ -94,36 +94,36 @@ bus memory rebuild andul
 
 ```bash
 # Agent A registers
-mcporter call coco.agent_register name="alice"
+mcporter call bus-agent.agent_register name="alice"
 
 # Agent A sends to B
-mcporter call coco.message_send from="alice" to="bob" message="Hello!"
+mcporter call bus-agent.message_send from="alice" to="bob" message="Hello!"
 
 # Agent B fetches later
-mcporter call coco.message_fetch agent_name="bob"
+mcporter call bus-agent.message_fetch agent_name="bob"
 ```
 
 ### 2. Register → Wait (long-poll, real-time)
 
 ```bash
 # Agent B waits for messages (blocks up to 30s)
-mcporter call coco.message_wait agent_name="bob" timeout_ms=60000
+mcporter call bus-agent.message_wait agent_name="bob" timeout_ms=60000
 
 # Agent A sends → B gets the message immediately
-mcporter call coco.message_send from="alice" to="bob" message="Ping!"
+mcporter call bus-agent.message_send from="alice" to="bob" message="Ping!"
 ```
 
 ### 3. Channel (multi-agent chat)
 
 ```bash
 # Create
-mcporter call coco.channel_create channel_id="dev" topic="Dev chat"
+mcporter call bus-agent.channel_create channel_id="dev" topic="Dev chat"
 
 # Join
-mcporter call coco.channel_join channel_id="dev" agent_name="alice"
+mcporter call bus-agent.channel_join channel_id="dev" agent_name="alice"
 
 # Chat (sent to all members)
-mcporter call coco.channel_send channel_id="dev" from="alice" message="Hey team!"
+mcporter call bus-agent.channel_send channel_id="dev" from="alice" message="Hey team!"
 ```
 
 ## Webhook Gateway (port 8080)
@@ -163,13 +163,13 @@ node hermes-forwarder.js
 
 ## Scheduled Tasks (Windows)
 
-All CoCo services can run as Windows Scheduled Tasks (auto-start on boot, auto-restart on crash):
+All Bus services can run as Windows Scheduled Tasks (auto-start on boot, auto-restart on crash):
 
 | Task | Purpose | Port |
 |------|---------|------|
-| `MCP_CoCo_Daemon` | CoCo MCP server (agent bus) | stdio |
-| `MCP_CoCo_Webhook` | Webhook Gateway | :8080 |
-| `MCP_CoCo_HermesFwd` | Hermes Auto-Forwarder | — |
+| `MCP_Bus_Daemon` | Bus MCP server (agent bus) | stdio |
+| `MCP_Bus_Webhook` | Webhook Gateway | :8080 |
+| `MCP_Bus_HermesFwd` | Hermes Auto-Forwarder | — |
 
 Install:
 ```powershell
@@ -182,27 +182,27 @@ CLI agents (OpenCode, Claude Code, shell scripts) can access the message bus **d
 
 ```bash
 # Set your agent name (optional, defaults to $USER)
-export COCO_AGENT=opencode
+export BUS_AGENT=opencode
 
 # List agents
-node coco-cli.js agents
+node bus-cli.js agents
 
 # Check inbox
-node coco-cli.js inbox
+node bus-cli.js inbox
 
 # Send a message
-node coco-cli.js send andul "Hello from OpenCode!"
+node bus-cli.js send andul "Hello from OpenCode!"
 
 # Reply to a specific message
-node coco-cli.js reply <message-id> "Thanks!"
+node bus-cli.js reply <message-id> "Thanks!"
 
 # Watch for new messages (poll every 2s)
-node coco-cli.js watch
+node bus-cli.js watch
 
 # Or use the shorter wrapper
-node coco.js agents
-node coco.js inbox
-node coco.js send andul "Hey!"
+node bus.js agents
+node bus.js inbox
+node bus.js send andul "Hey!"
 ```
 
 ## One-liner for OpenCode
@@ -210,8 +210,8 @@ node coco.js send andul "Hey!"
 Set this in your shell profile:
 ```bash
 # ~/.bashrc or ~/.zshrc or $PROFILE (PowerShell)
-export COCO_AGENT=opencode
-alias coco='node E:\_system\.openclaw\workspace\repos\mcp-coco\coco.js'
+export BUS_AGENT=opencode
+alias bus='node E:\_system\.openclaw\workspace\repos\mcp-coco\bus.js'
 ```
 
 Then just:
@@ -233,12 +233,12 @@ When you run `bus send`, it auto-registers your agent on the bus. Other agents (
 
 ## Integration with Hermes
 
-MCP CoCo auto-registers itself as `coco` agent. Hermes can connect via:
+MCP Bus auto-registers itself as `bus-agent` (default). Hermes can connect via:
 ```bash
 mcporter add hermes --stdio "hermes mcp serve --accept-hooks"
 ```
 
-Then OpenClaw and Hermes can DM through CoCo's message bus — no need for direct subprocess calls.
+Then OpenClaw and Hermes can DM through Bus message bus — no need for direct subprocess calls.
 
 ## Troubleshooting
 
@@ -271,17 +271,17 @@ All data is JSON. Back up `.bus/` to preserve conversations.
 
 ### Bus Doctor
 
-Diagnostics and health checks for the CoCo bus:
+Diagnostics and health checks for the Agent bus:
 
 ```bash
 node doctor.js [--quick] [--fix] [--report] [--watch]
 # or via CLI
-node coco-cli.js doctor [--quick] [--fix]
+node bus-cli.js doctor [--quick] [--fix]
 ```
 
 Performs 18 checks: bus directory, permissions, agent registry (profiles, stale agents), orphaned agents, message integrity, channels, scheduler validity, auto-reply rules, workflows, disk usage, stale PIDs, event logs. With `--fix`, auto-creates missing directories, removes stale PID files, deletes corrupted messages.
 
-### CoCo Tunnel
+### Bus Tunnel
 
 Cross-machine bus proxy. Expose your local bus to remote agents:
 
@@ -291,7 +291,7 @@ node tunnel.js client --host <ip> --port 9090 --secret ***
 node tunnel.js sync --remote http://<ip>:9090
 node tunnel.js ssh --remote user@host
 # or via CLI
-node coco-cli.js tunnel server --port 9090 --secret ***
+node bus-cli.js tunnel server --port 9090 --secret ***
 ```
 
 Server exposes HTTP endpoints: `/health`, `/bus/agents`, `/bus/send`, `/bus/register`. Client pushes local agents and recent messages at configurable interval. Sync mode merges agent registries bidirectionally.
@@ -308,7 +308,7 @@ node backup.js --diff <file>           # Compare with current state
 node backup.js --cleanup 30            # Remove old backups
 node backup.js --watch 60              # Auto-backup every 60 min
 # or via CLI
-node coco-cli.js backup --list
+node bus-cli.js backup --list
 ```
 
 Backups stored in `.backups/` directory. Each backup includes checksum verification. Diff shows added/removed/modified files.

package/backup.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * CoCo Backup & Restore — Bus State Management CLI Wrapper
+ * Bus Backup & Restore — Bus State Management CLI Wrapper
  *
  * Thin wrapper around lib/backup.js
  * Usage: see --help
@@ -13,7 +13,7 @@ const args = process.argv.slice(2);
 const cmd = args[0];
 
 function help() {
-  console.log(`\n╔═══════════════════════════════════════════════╗\n║     CoCo — Backup & Restore                      ║\n╚═══════════════════════════════════════════════╝\n`);
+  console.log(`\n╔═══════════════════════════════════════════════╗\n║     Bus — Backup & Restore                      ║\n╚═══════════════════════════════════════════════╝\n`);
   console.log('Usage:');
   console.log('  node backup.js                         Create backup (timestamped name)');
   console.log('  node backup.js --out <file>            Create backup with custom path');
@@ -26,8 +26,8 @@ function help() {
   console.log('  node backup.js --watch <minutes>       Auto-backup every N minutes\n');
   console.log('Examples:');
   console.log('  node backup.js');
-  console.log('  node backup.js --restore .backups/coco-bus-2026-06-24.coco');
-  console.log('  node backup.js --diff .backups/coco-bus-2026-06-24.coco');
+  console.log('  node backup.js --restore .backups/bus-2026-06-24.coco');
+  console.log('  node backup.js --diff .backups/bus-2026-06-24.coco');
   console.log('  node backup.js --cleanup 30');
   console.log('  node backup.js --watch 60\n');
 }

package/bridge.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * CoCo External Bridge — Connect external platforms to the Agent Bus
+ * Bus External Bridge — Connect external platforms to the Agent Bus
  *
  * Generic bridge pattern that can be adapted for:
  * - Slack (Web API + Events API)
@@ -66,7 +66,7 @@ class GenericBridge {
       registered_at: agents[this.agentName]?.registered_at || new Date().toISOString(),
     };
     fs.writeFileSync(agentsFile, JSON.stringify(agents, null, 2), 'utf-8');
-    console.log(`  ✅ Registered as "${this.agentName}" on CoCo Bus`);
+    console.log(`  ✅ Registered as "${this.agentName}" on Agent Bus`);
   }
 
   // Map external channel → bus channel
@@ -222,7 +222,7 @@ const CHANNELS_DIR = path.join(BUS_DIR, 'channels');
 function help() {
   console.log(`
 ╔═══════════════════════════════════════════════╗
-║   MCP CoCo — External Platform Bridge        ║
+║   MCP Bus — External Platform Bridge        ║
 ╚═══════════════════════════════════════════════╝
 
 Usage:
@@ -281,11 +281,11 @@ async function main() {
 
   console.log(`
 ╔══════════════════════════════════════════════╗
-║  MCP CoCo — ${type.padEnd(22)}║
+║  MCP Bus — ${type.padEnd(22)}║
 ╚══════════════════════════════════════════════╝
 `);
 
-  bridge.registerAgent(`${type} bridge — connects ${type} to CoCo Bus`);
+  bridge.registerAgent(`${type} bridge — connects ${type} to Agent Bus`);
   startBridgeListener(bridge, port);
   bridge.start();
 

package/bus-aliases.sh

@@ -0,0 +1,10 @@
+
+# ── Bus Agent Aliases ──
+alias bus-agents='node E:\_system\.openclaw\workspace\repos\mcp-coco\bus-cli.js agents'
+alias bus-inbox='node E:\_system\.openclaw\workspace\repos\mcp-coco\bus-cli.js inbox'
+alias bus-send='node E:\_system\.openclaw\workspace\repos\mcp-coco\bus-cli.js send'
+alias bus-whoami='node E:\_system\.openclaw\workspace\repos\mcp-coco\bus-cli.js whoami'
+alias bus-status='node E:\_system\.openclaw\workspace\repos\mcp-coco\bus-cli.js status'
+alias bus-search='node E:\_system\.openclaw\workspace\repos\mcp-coco\bus-cli.js search'
+alias bus-watch='node E:\_system\.openclaw\workspace\repos\mcp-coco\bus-cli.js watch'
+alias bus-channel='node E:\_system\.openclaw\workspace\repos\mcp-coco\bus-cli.js channel'

package/{coco-cli.js → bus-cli.js}

@@ -78,7 +78,7 @@ function main() {
 
 function cmdWhoami() {
   const agents = loadAgents();
-  const name = process.env.COCO_AGENT || process.env.USER || 'anonymous';
+  const name = process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
   const seen = agents[name];
   const profile = seen || {};
   console.log(`\n👤 Your Agent Identity:`);
@@ -147,7 +147,7 @@ function cmdAgents(filterArgs) {
 // ── Inbox (enhanced with --from filter) ──
 
 function cmdInbox(agentName, extra) {
-  const agent = agentName || process.env.COCO_AGENT || process.env.USER || 'anonymous';
+  const agent = agentName || process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
   const dir = path.join(MSGS_DIR, agent);
 
   const opts = { from: null, unread: false };
@@ -204,7 +204,7 @@ function cmdSend(to, text) {
     console.log('Usage: bus send <to> <message>');
     process.exit(1);
   }
-  const from = process.env.COCO_AGENT || process.env.USER || 'anonymous';
+  const from = process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
   const msg = {
     id: `${Date.now()}_${Math.random().toString(36).slice(2, 10)}`,
     from,
@@ -223,7 +223,7 @@ function cmdReply(msgId, text) {
     console.log('Usage: bus reply <msg-id> <message>');
     process.exit(1);
   }
-  const from = process.env.COCO_AGENT || process.env.USER || 'anonymous';
+  const from = process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
 
   let original = null;
   if (fs.existsSync(MSGS_DIR)) {
@@ -266,7 +266,7 @@ function cmdProfile(subArgs) {
     return cmdProfileEdit(subArgs.slice(1));
   }
 
-  const agentName = subArgs[0] || process.env.COCO_AGENT || process.env.USER || 'anonymous';
+  const agentName = subArgs[0] || process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
   const agents = loadAgents();
   const profile = agents[agentName];
 
@@ -295,7 +295,7 @@ function cmdProfile(subArgs) {
 }
 
 function cmdProfileEdit(edits) {
-  const name = process.env.COCO_AGENT || process.env.USER || 'anonymous';
+  const name = process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
   const agents = loadAgents();
   if (!agents[name]) {
     console.log(`❌ Not registered. Register first with: send or whoami`);
@@ -375,7 +375,7 @@ function cmdStatus() {
   const online = Object.entries(agents).filter(([, a]) => new Date(a.last_seen).getTime() > cutoff);
   const offline = Object.entries(agents).filter(([, a]) => new Date(a.last_seen).getTime() <= cutoff);
 
-  const myName = process.env.COCO_AGENT || process.env.USER || 'anonymous';
+  const myName = process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
   const me = agents[myName];
   const myOnline = me && new Date(me.last_seen).getTime() > cutoff;
 
@@ -433,7 +433,7 @@ function cmdSubscribe(channelId) {
   const logDir = path.join(CHANNELS_DIR, channelId, 'log');
   if (!fs.existsSync(logDir)) fs.mkdirSync(logDir, { recursive: true });
 
-  const myName = process.env.COCO_AGENT || process.env.USER || 'anonymous';
+  const myName = process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
 
   // Join if not already
   const ch = JSON.parse(fs.readFileSync(chPath, 'utf-8'));
@@ -574,7 +574,7 @@ function cmdChannel(subArgs) {
     const chId = subArgs[1];
     const topic = subArgs.slice(2).join(' ') || '';
     if (!chId) { console.log('Usage: bus channel create <name> [topic]'); return; }
-    const ch = { id: chId, topic, created_by: process.env.COCO_AGENT || 'cli', created_at: new Date().toISOString(), members: [] };
+    const ch = { id: chId, topic, created_by: process.env.BUS_AGENT || process.env.COCO_AGENT || 'cli', created_at: new Date().toISOString(), members: [] };
     fs.writeFileSync(path.join(CHANNELS_DIR, `${chId}.json`), JSON.stringify(ch, null, 2), 'utf-8');
     console.log(`✅ Channel "#${chId}" created`);
     return;
@@ -582,7 +582,7 @@ function cmdChannel(subArgs) {
 
   if (sub === 'join') {
     const chId = subArgs[1];
-    const agentName = subArgs[2] || process.env.COCO_AGENT || process.env.USER || 'anonymous';
+    const agentName = subArgs[2] || process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
     if (!chId) { console.log('Usage: bus channel join <name> [agent]'); return; }
     const chPath = path.join(CHANNELS_DIR, `${chId}.json`);
     if (!fs.existsSync(chPath)) { console.log(`❌ Channel "${chId}" not found`); return; }
@@ -600,7 +600,7 @@ function cmdChannel(subArgs) {
       console.log('Usage: bus channel send <channel> <message>');
       return;
     }
-    const from = process.env.COCO_AGENT || process.env.USER || 'anonymous';
+    const from = process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
     const chPath = path.join(CHANNELS_DIR, `${channelId}.json`);
     if (!fs.existsSync(chPath)) {
       console.log(`❌ Channel "${channelId}" not found`);
@@ -655,7 +655,7 @@ function cmdChannel(subArgs) {
 // ── Watch ──
 
 function cmdWatch(agentName) {
-  const agent = agentName || process.env.COCO_AGENT || process.env.USER || 'anonymous';
+  const agent = agentName || process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'anonymous';
   const dir = path.join(MSGS_DIR, agent);
   if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
 
@@ -708,10 +708,10 @@ function cmdTunnel(args) {
   const mode = args[0];
   if (!mode || mode === '--help') {
     console.log('Usage: bus tunnel server|client|sync|ssh [options]');
-    console.log('  coco tunnel server --port 9090 --secret <token>');
-    console.log('  coco tunnel client --host <ip> --port 9090 --secret <token>');
-    console.log('  coco tunnel sync --remote http://<ip>:9090');
-    console.log('  coco tunnel ssh --remote user@host');
+    console.log('  bus tunnel server --port 9090 --secret <token>');
+    console.log('  bus tunnel client --host <ip> --port 9090 --secret <token>');
+    console.log('  bus tunnel sync --remote http://<ip>:9090');
+    console.log('  bus tunnel ssh --remote user@host');
     return;
   }
   const opts = { busDir: BUS_DIR };
@@ -910,7 +910,7 @@ Commands:
     filters: --online, --status, --capability, --tag, --model, --search
 
   whoami                          Show your agent identity
-  inbox [agent] [--from X]        Check messages (default: \$COCO_AGENT)
+  inbox [agent] [--from X]        Check messages (default: \$BUS_AGENT)
   send <to> <message>             Send a message to another agent
   reply <msg-id> <message>        Reply to an incoming message
   profile [agent]                 Show agent profile details
@@ -968,7 +968,7 @@ Commands:
   memory rebuild <agent>          Rebuild vector embeddings for all memories
 
 Environment:
-  COCO_AGENT=opencode             Set your agent name for inbox/send
+  BUS_AGENT=opencode             Set your agent name for inbox/send
 
 Examples:
   bus agents --online --capability code-review

package/{coco-tool.js → bus-tool.js}

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
 /**
- * CoCo Tool Wrapper — Direct bus calls from any tool/exec context
+ * Bus Tool Wrapper — Direct bus calls from any tool/exec context
  *
  * Acts as a lightweight RPC bridge between tools (OpenClaw, CLI, etc.)
- * and the CoCo Agent Bus. No MCP needed — direct file access.
+ * and the Agent Bus. No MCP needed — direct file access.
  *
  * Usage:
- *   node coco-tool.js <tool> [args...]
+ *   node bus-tool.js <tool> [args...]
  *
  * Examples:
- *   node coco-tool.js agent_list '{"online_only":true}'
- *   node coco-tool.js agent_get_profile '{"name":"coco"}'
- *   node coco-tool.js message_send '{"from":"andul","to":"hermes","message":"Hello!"}'
- *   node coco-tool.js message_fetch '{"agent_name":"andul"}'
- *   node coco-tool.js agent_search '{"query":"code"}'
- *   node coco-tool.js agent_register '{"name":"andul","description":"Andul 🐺","capabilities":["chat","code","browsing"]}'
- *   node coco-tool.js coco_health '{}'
+ *   node bus-tool.js agent_list '{"online_only":true}'
+ *   node bus-tool.js agent_get_profile '{"name":"bus-agent"}'
+ *   node bus-tool.js message_send '{"from":"andul","to":"hermes","message":"Hello!"}'
+ *   node bus-tool.js message_fetch '{"agent_name":"andul"}'
+ *   node bus-tool.js agent_search '{"query":"code"}'
+ *   node bus-tool.js agent_register '{"name":"andul","description":"Andul 🐺","capabilities":["chat","code","browsing"]}'
+ *   node bus-tool.js bus_health '{}'
  */
 const path = require('path');
 const fs = require('fs');
@@ -39,8 +39,8 @@ async function main() {
   let result;
 
   switch (tool) {
-    // CoCo Health
-    case 'coco_health':
+    // Bus Health
+    case 'bus_health':
       result = await bridge.healthCheck();
       break;
 
@@ -159,7 +159,7 @@ async function main() {
 
 function getToolList() {
   return [
-    'coco_health',
+    'bus_health',
     'agent_register', 'agent_update_profile', 'agent_get_profile',
     'agent_list', 'agent_search', 'agent_heartbeat', 'agent_set_status',
     'message_send', 'message_broadcast', 'message_fetch', 'message_delete',

package/bus.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * Bus — Convenience entry point for CLI agents
+ *
+ * Usage:
+ *   node bus.js agents           # List agents
+ *   node bus.js inbox            # Check your messages
+ *   node bus.js send "message"   # Send to last reply-to agent
+ *   node bus.js send <to> msg    # Send to specific agent
+ *   node bus.js watch            # Watch for new messages
+ */
+const { execSync } = require('child_process');
+const path = require('path');
+
+const CLI = path.join(__dirname, 'bus-cli.js');
+const args = process.argv.slice(2).join(' ');
+
+try {
+  const result = execSync(`node "${CLI}" ${args}`, {
+    encoding: 'utf-8',
+    stdio: 'inherit',
+    env: { ...process.env },
+  });
+} catch (e) {
+  // errors already shown via stdio
+}

package/claude-mcp.json

@@ -1,9 +1,9 @@
 {
   "mcpServers": {
-    "coco": {
+    "bus-agent": {
       "command": "node",
       "args": [
-        "E:\\_system\\.openclaw\\workspace\\repos\\mcp-coco\\index.js"
+        "E:\\_system\\.openclaw\\workspace\\repos\\bus-agent\\index.js"
       ]
     }
   }

package/clients/{coco-client.ts → bus-client.ts}

@@ -1,13 +1,13 @@
 /**
- * CoCo Bus Client — TypeScript/JS SDK for Agent Bus
+ * Bus Agent Client — TypeScript/JS SDK for Agent Bus
  *
- * Direct file-based access to the CoCo Agent Bus. No MCP needed.
+ * Direct file-based access to the Agent Bus. No MCP needed.
  * Works in Node.js. For browser, use the WebSocket/proxy approach.
  *
  * Usage:
- *   import { CoCoClient } from './coco-client.js';
+ *   import { BusClient } from './bus-client.js';
  *
- *   const bus = new CoCoClient('/path/to/.bus', 'my-agent');
+ *   const bus = new BusClient('/path/to/.bus', 'my-agent');
  *   await bus.register({ description: 'My agent' });
  *   await bus.send('hermes', 'Hello!');
  *   const msgs = await bus.fetchMessages();
@@ -42,7 +42,7 @@ interface BusMessage {
   timestamp: string;
 }
 
-export class CoCoClient {
+export class BusClient {
   private busDir: string;
   private msgsDir: string;
   private agentsFile: string;
@@ -54,7 +54,7 @@ export class CoCoClient {
     this.msgsDir = path.join(busDir, 'messages');
     this.agentsFile = path.join(busDir, 'agents.json');
     this.channelsDir = path.join(busDir, 'channels');
-    this.agentName = agentName || process.env.COCO_AGENT || process.env.USER || 'ts-agent';
+    this.agentName = agentName || process.env.BUS_AGENT || process.env.COCO_AGENT || process.env.USER || 'ts-agent';
     this._ensureDirs();
   }
 

package/clients/{coco_client.py → bus_client.py}

@@ -1,13 +1,13 @@
 """
-CoCo Bus Client — Python SDK for Agent Bus
+Bus Bus Client — Python SDK for Agent Bus
 
-Direct file-based access to the CoCo Agent Bus. No MCP needed.
+Direct file-based access to the Bus Agent Bus. No MCP needed.
 Any agent with filesystem access to the bus directory can use this.
 
 Usage:
-    from coco_client import CoCoClient
+    from bus_client import BusClient
 
-    bus = CoCoClient("/path/to/mcp-coco/.bus", agent_name="my-agent")
+    bus = BusClient("/path/to/bus-agent/.bus", agent_name="my-agent")
     bus.register(description="My Python agent", capabilities=["data-analysis", "api-calls"])
     bus.send("hermes", "Hello from Python!")
     msgs = bus.fetch_messages()
@@ -22,14 +22,14 @@ import time
 import uuid
 
 
-class CoCoClient:
+class BusClient:
     def __init__(self, bus_dir, agent_name=None):
         self.bus_dir = bus_dir
         self.msgs_dir = os.path.join(bus_dir, "messages")
         self.agents_file = os.path.join(bus_dir, "agents.json")
         self.channels_dir = os.path.join(bus_dir, "channels")
         self.events_dir = os.path.join(bus_dir, "events")
-        self.agent_name = agent_name or os.environ.get("COCO_AGENT") or os.environ.get("USER", "python-agent")
+        self.agent_name = agent_name or os.environ.get("BUS_AGENT") or os.environ.get("COCO_AGENT") or os.environ.get("USER", "python-agent")
         self._ensure_dirs()
 
     def _ensure_dirs(self):
@@ -55,7 +55,7 @@ class CoCoClient:
     # ── Registration ──
 
     def register(self, description="", capabilities=None, model=None, tags=None, version="1.0.0", status="idle"):
-        """Register yourself on the CoCo Agent Bus."""
+        """Register yourself on the Bus Agent Bus."""
         agents = self._load_agents()
         existing = agents.get(self.agent_name, {})
         agents[self.agent_name] = {

package/cursor-mcp.json

@@ -1,3 +1,3 @@
 {
-  "E:\\_system\\.openclaw\\workspace\\repos\\mcp-coco\\index.js": true
+  "E:\\_system\\.openclaw\\workspace\\repos\\bus-agent\\index.js": true
 }

package/doctor.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * CoCo Doctor — Diagnostics CLI Wrapper
+ * Bus Doctor — Diagnostics CLI Wrapper
  *
  * Thin wrapper around lib/doctor.js
  * Usage: node doctor.js [--quick] [--fix] [--report] [--watch]

package/hermes-forwarder.js

@@ -135,7 +135,7 @@ async function poll() {
 
 console.log(`
 ╔══════════════════════════════════════════╗
-║  MCP CoCo — Hermes Auto-Forwarder       ║
+║  MCP Bus — Hermes Auto-Forwarder       ║
 ║                                          ║
 ║  Any DM to "hermes" →                   ║
 ║    ask_hermes(prompt) → reply back       ║

package/hermes.example.json

@@ -1,8 +1,8 @@
 {
   "mcpServers": {
-    "coco": {
+    "bus-agent": {
       "command": "node",
-      "args": ["C:\\Users\\Administrator\\.openclaw\\workspace\\mcp-coco\\index.js"],
+      "args": ["C:\\Users\\Administrator\\.openclaw\\workspace\\bus-agent\\index.js"],
       "env": {}
     }
   }

package/index.js

@@ -33,7 +33,7 @@ async function main() {
     const bus = new AgentBus();
     const scheduler = new Scheduler(bus);
     scheduler.start();
-    console.log('CoCo Scheduler running. Press Ctrl+C to stop.');
+    console.log('Bus Scheduler running. Press Ctrl+C to stop.');
     // Keep alive
     process.on('SIGINT', () => { scheduler.stop(); process.exit(0); });
     process.on('SIGTERM', () => { scheduler.stop(); process.exit(0); });