bus-agent 2.3.2 → 2.3.4

package/README.md

@@ -216,9 +216,9 @@ node index.js
 # CLI mode (for scripts / terminal agents)
 npx bus-agent          # Run as MCP server (stdio)
 # Or with global install:
-coco status            # Check bus health
-coco agents            # List registered agents
-coco send hermes "Hello"  # Send a DM
+bus status             # Check bus health
+bus agents             # List registered agents
+bus send hermes "Hello"  # Send a DM
 
 # Webhook gateway (optional)
 node webhook-gateway.js 8080
@@ -231,7 +231,7 @@ Add the following to your MCP client configuration:
 ```json
 {
   "mcpServers": {
-    "coco": {
+    "bus-agent": {
       "command": "npx",
       "args": ["bus-agent"]
     }
@@ -244,7 +244,7 @@ Or from a local clone:
 ```json
 {
   "mcpServers": {
-    "coco": {
+    "bus-agent": {
       "command": "node",
       "args": ["/path/to/bus-agent/index.js"]
     }
@@ -364,11 +364,11 @@ Agent memory system with dual-mode search:
 | Pluggable | Switch between keyword, Ollama, OpenAI, or custom |
 
 ```bash
-coco memory store andul "Jonus likes clean architecture" --key architecture-pref --namespace preferences
-coco memory search andul "architecture layers" --limit 5
-coco memory configure --provider ollama --endpoint http://localhost:11434 --model nomic-embed-text
-coco memory rebuild andul
-coco memory archive andul --max-age-days 7
+bus memory store andul "Jonus likes clean architecture" --key architecture-pref --namespace preferences
+bus memory search andul "architecture layers" --limit 5
+bus memory configure --provider ollama --endpoint http://localhost:11434 --model nomic-embed-text
+bus memory rebuild andul
+bus memory archive andul --max-age-days 7
 ```
 
 ## Utility Tools

package/SKILL.md

@@ -82,10 +82,10 @@ Agent memory with TF-IDF keyword search (built-in) and optional vector search vi
 **Dual-mode search:** Vector (cosine similarity) → TF-IDF fallback. Stored in `.bus/memory/{agent}/` as JSONL + vectors.json.
 
 ```bash
-coco memory store andul "content" --key k --namespace preferences
-coco memory search andul "query" --limit 5
-coco memory configure --provider ollama --endpoint http://localhost:11434
-coco memory rebuild andul
+bus memory store andul "content" --key k --namespace preferences
+bus memory search andul "query" --limit 5
+bus memory configure --provider ollama --endpoint http://localhost:11434
+bus memory rebuild andul
 ```
 
 ## Communication Patterns
@@ -216,12 +216,12 @@ alias coco='node E:\_system\.openclaw\workspace\repos\mcp-coco\coco.js'
 
 Then just:
 ```bash
-coco agents
-coco inbox
-coco send andul "Hello world!"
+bus agents
+bus inbox
+bus send andul "Hello world!"
 ```
 
-When you run `coco send`, it auto-registers your agent on the bus. Other agents (Andul, Hermes) will see you online and can message you back.
+When you run `bus send`, it auto-registers your agent on the bus. Other agents (Andul, Hermes) will see you online and can message you back.
 
 ## Windows Notes
 

package/bin/cli.js

@@ -14,28 +14,37 @@ const args = process.argv.slice(2);
 
 if (args.includes('--help') || args.includes('-h')) {
   console.log(`
-MCP Bus — MCP Bridge: OpenClaw ↔ Hermes Agent
+MCP Bus — Agent Communication Hub
 
 Usage:
-  bus-agent                    Run as stdio MCP server (for mcporter)
+  bus-agent                    Run as stdio MCP server (for MCP clients)
   bus-agent --daemon           Start background daemon
   bus-agent --health           Quick health check (exit 0 = ok)
   bus-agent --help             Show this help
 
 Examples:
   # Run as stdio server (connect via mcporter):
-  mcporter add coco --stdio "node path/to/index.js"
+  mcporter config add bus-agent --stdio "bus-agent"
 
   # Start as background daemon:
   bus-agent --daemon
 
-  # Call from OpenClaw:
-  mcporter call coco.ask_hermes prompt="Hello Hermes"
-
   # Check health:
   bus-agent --health
 `);
   process.exit(0);
 }
 
+if (args.includes('--health')) {
+  const { AgentBus } = require(path.join(__dirname, '..', 'lib', 'bus'));
+  try {
+    const bus = new AgentBus();
+    const busDir = process.env.BUS_DIR || path.join(process.cwd(), '.bus');
+    const ok = require('fs').existsSync(path.join(busDir, 'agents.json'));
+    process.exit(ok ? 0 : 1);
+  } catch {
+    process.exit(1);
+  }
+}
+
 require(path.join(__dirname, '..', 'index.js'));

package/coco-cli.js

@@ -1,23 +1,23 @@
 #!/usr/bin/env node
 /**
- * CoCo CLI v2.1 — Direct bus interface for CLI agents
+ * Bus CLI v2.3.3 - Direct bus interface for CLI agents
  *
- * No MCP needed. Direct file access to the CoCo Agent Bus.
+ * No MCP needed. Direct file access to the Bus Agent Bus.
  *
  * Usage:
- *   node coco-cli.js agents                          # List all agents (with filters)
- *   node coco-cli.js whoami                          # Show your agent identity
- *   node coco-cli.js inbox [agent]                   # Show inbox messages
- *   node coco-cli.js send <to> <message>             # Send a message
- *   node coco-cli.js reply <msg-id> <message>        # Reply to a message
- *   node coco-cli.js profile [agent]                 # Show profile
- *   node coco-cli.js profile edit --status busy       # Edit your profile
- *   node coco-cli.js search <query>                  # Search agents
- *   node coco-cli.js status                          # Show CoCo + your agent status
- *   node coco-cli.js subscribe <channel>             # Listen to channel messages
- *   node coco-cli.js channel list|send|history       # Channel operations
- *   node coco-cli.js events [since]                  # View system events
- *   node coco-cli.js watch [agent]                   # Watch for new messages
+ *   bus agents                          # List all agents (with filters)
+ *   bus whoami                          # Show your agent identity
+ *   bus inbox [agent]                   # Show inbox messages
+ *   bus send <to> <message>             # Send a message
+ *   bus reply <msg-id> <message>        # Reply to a message
+ *   bus profile [agent]                 # Show profile
+ *   bus profile edit --status busy       # Edit your profile
+ *   bus search <query>                  # Search agents
+ *   bus status                          # Show Bus + your agent status
+ *   bus subscribe <channel>             # Listen to channel messages
+ *   bus channel list|send|history       # Channel operations
+ *   bus events [since]                  # View system events
+ *   bus watch [agent]                   # Watch for new messages
  */
 const path = require('path');
 const fs = require('fs');
@@ -123,7 +123,7 @@ function cmdAgents(filterArgs) {
     (a.description || '').toLowerCase().includes(filters.search.toLowerCase())
   );
 
-  console.log(`\n🤖 Agents on CoCo Bus (${list.length} total):`);
+  console.log(`\n🤖 Agents on Bus (${list.length} total):`);
   console.log('─'.repeat(70));
 
   list.sort((a, b) => new Date(b[1].last_seen) - new Date(a[1].last_seen));
@@ -201,7 +201,7 @@ function cmdInbox(agentName, extra) {
 
 function cmdSend(to, text) {
   if (!to || !text) {
-    console.log('Usage: node coco-cli.js send <to> <message>');
+    console.log('Usage: bus send <to> <message>');
     process.exit(1);
   }
   const from = process.env.COCO_AGENT || process.env.USER || 'anonymous';
@@ -220,7 +220,7 @@ function cmdSend(to, text) {
 
 function cmdReply(msgId, text) {
   if (!msgId || !text) {
-    console.log('Usage: node coco-cli.js reply <msg-id> <message>');
+    console.log('Usage: bus reply <msg-id> <message>');
     process.exit(1);
   }
   const from = process.env.COCO_AGENT || process.env.USER || 'anonymous';
@@ -340,7 +340,7 @@ function cmdProfileEdit(edits) {
 
 function cmdSearch(query) {
   if (!query) {
-    console.log('Usage: node coco-cli.js search <query>');
+    console.log('Usage: bus search <query>');
     console.log('Searches agent names, descriptions, capabilities, and tags');
     return;
   }
@@ -391,7 +391,7 @@ function cmdStatus() {
 
   console.log(`
 ╔══════════════════════════════════════════╗
-║     MCP CoCo — Agent Bus Status         ║
+║     Bus Agent — Agent Bus Status        ║
 ╚══════════════════════════════════════════╝`);
   console.log(`  You:            ${myName} ${myOnline ? '🟢 online' : '⚫ offline'}`);
   console.log(`  Bus agents:     ${Object.keys(agents).length} total (${online.length} online, ${offline.length} offline)`);
@@ -419,7 +419,7 @@ function cmdStatus() {
 
 function cmdSubscribe(channelId) {
   if (!channelId) {
-    console.log('Usage: node coco-cli.js subscribe <channel>');
+    console.log('Usage: bus subscribe <channel>');
     console.log('Listens to channel messages in real-time.');
     process.exit(1);
   }
@@ -573,7 +573,7 @@ function cmdChannel(subArgs) {
   if (sub === 'create') {
     const chId = subArgs[1];
     const topic = subArgs.slice(2).join(' ') || '';
-    if (!chId) { console.log('Usage: node coco-cli.js channel create <name> [topic]'); return; }
+    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: [] };
     fs.writeFileSync(path.join(CHANNELS_DIR, `${chId}.json`), JSON.stringify(ch, null, 2), 'utf-8');
     console.log(`✅ Channel "#${chId}" created`);
@@ -583,7 +583,7 @@ function cmdChannel(subArgs) {
   if (sub === 'join') {
     const chId = subArgs[1];
     const agentName = subArgs[2] || process.env.COCO_AGENT || process.env.USER || 'anonymous';
-    if (!chId) { console.log('Usage: node coco-cli.js channel join <name> [agent]'); return; }
+    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; }
     const ch = JSON.parse(fs.readFileSync(chPath, 'utf-8'));
@@ -597,7 +597,7 @@ function cmdChannel(subArgs) {
     const channelId = subArgs[1];
     const text = subArgs.slice(2).join(' ');
     if (!channelId || !text) {
-      console.log('Usage: node coco-cli.js channel send <channel> <message>');
+      console.log('Usage: bus channel send <channel> <message>');
       return;
     }
     const from = process.env.COCO_AGENT || process.env.USER || 'anonymous';
@@ -672,7 +672,7 @@ function cmdWatch(agentName) {
           const msg = JSON.parse(fs.readFileSync(path.join(dir, f), 'utf-8'));
           const tag = msg.metadata?.channel ? `[#${msg.metadata.channel}]` : '';
           console.log(`\n📩 ${tag} [${msg.from}] ${msg.message}`);
-          console.log(`   Reply: node coco-cli.js reply ${msg.id} "your message"\n`);
+          console.log(`   Reply: bus reply ${msg.id} "your message"\n`);
         } catch {}
       }
       lastCount = files.length;
@@ -707,7 +707,7 @@ function cmdTunnel(args) {
   const { startServer, startClient, startSync, printSSHHelp } = require('./lib/tunnel');
   const mode = args[0];
   if (!mode || mode === '--help') {
-    console.log('Usage: coco tunnel server|client|sync|ssh [options]');
+    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');
@@ -739,7 +739,7 @@ async function cmdMemory(args) {
   const { MemoryStore } = require('./lib/memory');
   const mem = new MemoryStore(BUS_DIR);
   const sub = args[0];
-  if (!sub) { console.log('Usage: coco memory store|search|recall|list|forget|stats|archive|clear|configure|rebuild <args>'); return; }
+  if (!sub) { console.log('Usage: bus memory store|search|recall|list|forget|stats|archive|clear|configure|rebuild <args>'); return; }
 
   try {
     switch (sub) {
@@ -749,7 +749,7 @@ async function cmdMemory(args) {
         const key = args.includes('--key') ? args[args.indexOf('--key') + 1] : undefined;
         const namespace = args.includes('--namespace') ? args[args.indexOf('--namespace') + 1] : undefined;
         const ttl = args.includes('--ttl') ? parseInt(args[args.indexOf('--ttl') + 1], 10) : undefined;
-        if (!agent || !content) { console.log('Usage: coco memory store <agent> <content> [--key] [--namespace] [--ttl]'); return; }
+        if (!agent || !content) { console.log('Usage: bus memory store <agent> <content> [--key] [--namespace] [--ttl]'); return; }
         const id = await mem.store(agent, { content, key, namespace, ttl });
         console.log('  ✅ Memory stored: ' + id);
         break;
@@ -759,7 +759,7 @@ async function cmdMemory(args) {
         const query = args.slice(2).filter(a => !a.startsWith('--')).join(' ');
         const limit = args.includes('--limit') ? parseInt(args[args.indexOf('--limit') + 1], 10) : 10;
         const namespace = args.includes('--namespace') ? args[args.indexOf('--namespace') + 1] : undefined;
-        if (!agent || !query) { console.log('Usage: coco memory search <agent> <query> [--limit] [--namespace]'); return; }
+        if (!agent || !query) { console.log('Usage: bus memory search <agent> <query> [--limit] [--namespace]'); return; }
         const results = await mem.search(agent, query, { limit, namespace });
         if (results.length === 0) { console.log('  No results found.'); return; }
         console.log('');
@@ -775,7 +775,7 @@ async function cmdMemory(args) {
       }
       case 'recall': {
         const agent = args[1]; const id = args[2];
-        if (!agent || !id) { console.log('Usage: coco memory recall <agent> <id>'); return; }
+        if (!agent || !id) { console.log('Usage: bus memory recall <agent> <id>'); return; }
         const e = mem.recall(agent, id);
         if (!e) { console.log('  Not found.'); return; }
         console.log('');
@@ -789,7 +789,7 @@ async function cmdMemory(args) {
       }
       case 'list': {
         const agent = args[1];
-        if (!agent) { console.log('Usage: coco memory list <agent> [--namespace] [--limit] [--offset]'); return; }
+        if (!agent) { console.log('Usage: bus memory list <agent> [--namespace] [--limit] [--offset]'); return; }
         const limit = args.includes('--limit') ? parseInt(args[args.indexOf('--limit') + 1], 10) : 50;
         const offset = args.includes('--offset') ? parseInt(args[args.indexOf('--offset') + 1], 10) : 0;
         const namespace = args.includes('--namespace') ? args[args.indexOf('--namespace') + 1] : undefined;
@@ -804,14 +804,14 @@ async function cmdMemory(args) {
       }
       case 'forget': {
         const agent = args[1]; const id = args[2];
-        if (!agent || !id) { console.log('Usage: coco memory forget <agent> <id>'); return; }
+        if (!agent || !id) { console.log('Usage: bus memory forget <agent> <id>'); return; }
         const ok = mem.forget(agent, id);
         console.log(ok ? '  Deleted.' : '  Not found.');
         break;
       }
       case 'stats': {
         const agent = args[1];
-        if (!agent) { console.log('Usage: coco memory stats <agent>'); return; }
+        if (!agent) { console.log('Usage: bus memory stats <agent>'); return; }
         const s = mem.stats(agent);
         console.log('');
         console.log('  Memory Stats - ' + agent + ':');
@@ -828,7 +828,7 @@ async function cmdMemory(args) {
       }
       case 'archive': {
         const agent = args[1];
-        if (!agent) { console.log('Usage: coco memory archive <agent> [--max-age-days] [--no-delete]'); return; }
+        if (!agent) { console.log('Usage: bus memory archive <agent> [--max-age-days] [--no-delete]'); return; }
         const maxAge = args.includes('--max-age-days') ? parseInt(args[args.indexOf('--max-age-days') + 1], 10) : 7;
         const deleteAfter = !args.includes('--no-delete');
         const r = await mem.archive(agent, { maxAgeDays: maxAge, deleteAfter });
@@ -838,7 +838,7 @@ async function cmdMemory(args) {
       case 'clear': {
         const agent = args[1];
         const ns = args.includes('--namespace') ? args[args.indexOf('--namespace') + 1] : undefined;
-        if (!agent) { console.log('Usage: coco memory clear <agent> [--namespace]'); return; }
+        if (!agent) { console.log('Usage: bus memory clear <agent> [--namespace]'); return; }
         const count = mem.clear(agent, ns);
         console.log('  Cleared ' + count + ' entries' + (ns ? ' in namespace "' + ns + '"' : ''));
         break;
@@ -848,7 +848,7 @@ async function cmdMemory(args) {
         const endpoint = args.includes('--endpoint') ? args[args.indexOf('--endpoint') + 1] : undefined;
         const model = args.includes('--model') ? args[args.indexOf('--model') + 1] : undefined;
         const apiKey = args.includes('--api-key') ? args[args.indexOf('--api-key') + 1] : undefined;
-        if (!provider) { console.log('Usage: coco memory configure --provider <keyword|ollama|openai|custom> [--endpoint] [--model] [--api-key]'); return; }
+        if (!provider) { console.log('Usage: bus memory configure --provider <keyword|ollama|openai|custom> [--endpoint] [--model] [--api-key]'); return; }
         const cfg = mem.configure({ provider, endpoint, model, api_key: apiKey });
         console.log('  Configured: ' + cfg.provider);
         if (cfg.model) console.log('  Model: ' + cfg.model);
@@ -857,7 +857,7 @@ async function cmdMemory(args) {
       }
       case 'rebuild': {
         const agent = args[1];
-        if (!agent) { console.log('Usage: coco memory rebuild <agent>'); return; }
+        if (!agent) { console.log('Usage: bus memory rebuild <agent>'); return; }
         const r = await mem.rebuildVectors(agent);
         console.log('  Rebuilt ' + r.rebuilt + ' vectors.');
         if (r.failed > 0) console.log('  Failed: ' + r.failed);
@@ -865,7 +865,7 @@ async function cmdMemory(args) {
         break;
       }
       default:
-        console.log('Usage: coco memory store|search|recall|list|forget|stats|archive|clear|configure|rebuild');
+        console.log('Usage: bus memory store|search|recall|list|forget|stats|archive|clear|configure|rebuild');
     }
   } catch (err) {
     console.error('Error:', err.message);
@@ -887,7 +887,7 @@ function cmdBackup(args) {
       case '--cleanup': cleanupBackups(BUS_DIR, parseInt(args[1], 10) || 30); break;
       case '--auto': autoBackup(BUS_DIR); break;
       case '--watch': watchMode(BUS_DIR, parseInt(args[1], 10) || 30); break;
-      default: console.log('Usage: coco backup [--list|--info|--restore|--diff|--cleanup|--auto|--watch]');
+      default: console.log('Usage: bus backup [--list|--info|--restore|--diff|--cleanup|--auto|--watch]');
     }
   } catch (err) {
     console.error('Error:', err.message);
@@ -899,11 +899,11 @@ function cmdBackup(args) {
 function cmdHelp() {
   console.log(`
 ╔═══════════════════════════════════════════════╗
-║     MCP CoCo v2.1 — CLI Agent Bus Interface  ║
+║     MCP Bus v2.3.3 - CLI Agent Bus Interface (bus)  ║
 ╚═══════════════════════════════════════════════╝
 
 Usage:
-  node coco-cli.js <command> [args]
+  bus <command> [args]
 
 Commands:
   agents [filters]                List all agents on the bus
@@ -916,7 +916,7 @@ Commands:
   profile [agent]                 Show agent profile details
   profile edit --status busy      Edit your profile fields
   search <query>                  Search agents by name/capability/description
-  status                          Show CoCo bus health & online agents
+  status                          Show bus health & online agents
   subscribe <channel>             Listen to channel messages in real-time
 
   channel list                    List all channels
@@ -971,12 +971,12 @@ Environment:
   COCO_AGENT=opencode             Set your agent name for inbox/send
 
 Examples:
-  node coco-cli.js agents --online --capability code-review
-  node coco-cli.js profile opencode
-  node coco-cli.js search web
-  node coco-cli.js status
-  node coco-cli.js subscribe dev-chat
-  node coco-cli.js channel create dev-chat "Development chat"
+  bus agents --online --capability code-review
+  bus profile opencode
+  bus search web
+  bus status
+  bus subscribe dev-chat
+  bus channel create dev-chat "Development chat"
 `);
 }
 

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "bus-agent",
-  "version": "2.3.2",
+  "version": "2.3.4",
   "description": "Universal Agent Communication Hub — Connect any AI agent to any other. MCP bus with messaging, channels, memory, scheduling, workflows, and diagnostics.",
   "main": "index.js",
   "bin": {
-    "coco": "./coco-cli.js",
+    "bus": "./coco-cli.js",
     "bus-agent": "./bin/cli.js"
   },
   "scripts": {

package/setup.js

@@ -92,14 +92,14 @@ COCO_CLI=${path.join(COCO_DIR, 'coco-cli.js')}
 function generateShellAliases() {
   return `
 # ── CoCo Bus Aliases ──
-alias coco-agents='node ${path.join(COCO_DIR, 'coco-cli.js')} agents'
-alias coco-inbox='node ${path.join(COCO_DIR, 'coco-cli.js')} inbox'
-alias coco-send='node ${path.join(COCO_DIR, 'coco-cli.js')} send'
-alias coco-whoami='node ${path.join(COCO_DIR, 'coco-cli.js')} whoami'
-alias coco-status='node ${path.join(COCO_DIR, 'coco-cli.js')} status'
-alias coco-search='node ${path.join(COCO_DIR, 'coco-cli.js')} search'
-alias coco-watch='node ${path.join(COCO_DIR, 'coco-cli.js')} watch'
-alias coco-channel='node ${path.join(COCO_DIR, 'coco-cli.js')} channel'
+alias bus-agents='node ${path.join(COCO_DIR, 'coco-cli.js')} agents'
+alias bus-inbox='node ${path.join(COCO_DIR, 'coco-cli.js')} inbox'
+alias bus-send='node ${path.join(COCO_DIR, 'coco-cli.js')} send'
+alias bus-whoami='node ${path.join(COCO_DIR, 'coco-cli.js')} whoami'
+alias bus-status='node ${path.join(COCO_DIR, 'coco-cli.js')} status'
+alias bus-search='node ${path.join(COCO_DIR, 'coco-cli.js')} search'
+alias bus-watch='node ${path.join(COCO_DIR, 'coco-cli.js')} watch'
+alias bus-channel='node ${path.join(COCO_DIR, 'coco-cli.js')} channel'
 `;
 }
 
@@ -196,7 +196,7 @@ async function setupClaudeCode(agentName) {
   const outPath = path.join(COCO_DIR, 'claude-mcp.json');
   fs.writeFileSync(outPath, JSON.stringify(config, null, 2), 'utf-8');
   console.log(`  ✅ Claude Code MCP config → ${outPath}`);
-  console.log(`     Run: claude mcp add coco "node ${path.join(COCO_DIR, 'index.js')}"`);
+  console.log(`     Run: claude mcp add bus-agent "node ${path.join(COCO_DIR, 'index.js')}"`);
 
   const [envFile] = generateEnvAndAliases(agentName);
   return ['claude-mcp.json', envFile];
@@ -294,7 +294,7 @@ async function main() {
     console.log(`     Add to .mcp.json:`);
     console.log(`     ${JSON.stringify(generateMcpConfigOpenCode(), null, 4).split('\n').map(l => '     ' + l).join('\n')}\n`);
     console.log(`  2. Claude Code:`);
-    console.log(`     claude mcp add coco "node ${path.join(COCO_DIR, 'index.js')}"\n`);
+    console.log(`     claude mcp add bus-agent "node ${path.join(COCO_DIR, 'index.js')}"\n`);
     console.log(`  3. Cursor:`);
     console.log(`     Add to .cursor/mcp.json`);
     return;