bus-agent 2.3.1 → 2.3.3

package/README.md

@@ -206,17 +206,19 @@ node coco-cli.js backup --list
 npm install -g bus-agent
 npx bus-agent
 
-# Or from source:
+# Or from source (local folder still 'mcp-coco'):
 git clone https://github.com/ClewCode/bus-agent.git
-cd mcp-coco
+cd bus-agent
 
 # MCP mode (for any MCP client)
 node index.js
 
 # CLI mode (for scripts / terminal agents)
-node coco-cli.js status
-node coco-cli.js agents
-node coco-cli.js send hermes "Hello"
+npx bus-agent          # Run as MCP server (stdio)
+# Or with global install:
+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
@@ -229,23 +231,37 @@ Add the following to your MCP client configuration:
 ```json
 {
   "mcpServers": {
-    "coco": {
-      "command": "node",
-      "args": ["/path/to/mcp-coco/index.js"]
+    "bus-agent": {
+      "command": "npx",
+      "args": ["bus-agent"]
     }
   }
 }
 ```
 
-Or use `node setup.js` to generate configuration automatically.
+Or from a local clone:
+
+```json
+{
+  "mcpServers": {
+    "bus-agent": {
+      "command": "node",
+      "args": ["/path/to/bus-agent/index.js"]
+    }
+  }
+}
+```
 
-### Environment Variable
+### Environment Variables
 
 ```bash
-# Set your agent identity
-export COCO_AGENT=opencode
+# Your agent name on the bus
+export COCO_AGENT=my-agent
 # Windows (PowerShell)
-$env:COCO_AGENT = "opencode"
+$env:COCO_AGENT = "my-agent"
+
+# Optional: custom data directory (default: ./.bus/ in CWD)
+export BUS_DIR=/path/to/my-bus-data
 ```
 
 ---
@@ -280,6 +296,12 @@ $env:COCO_AGENT = "opencode"
 
 All bus state is stored as plain JSON files on disk. No database or external service required.
 
+The data directory (`.bus/`) is resolved at runtime:
+1. `$BUS_DIR` environment variable (if set)
+2. `$CWD/.bus/` (current working directory — **default**)
+
+This means each user/project gets **their own isolated data**. No cross-user data sharing. The `.bus/` folder is gitignored by default.
+
 ---
 
 ## Data Layout
@@ -342,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/coco-cli.js

@@ -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);

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "bus-agent",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "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;