bus-agent 2.3.0

package/setup.js

@@ -0,0 +1,320 @@
+#!/usr/bin/env node
+/**
+ * CoCo Config Wizard — Interactive setup for connecting agents to CoCo Bus
+ *
+ * Generates MCP configs, env files, and bus registration for:
+ * - OpenCode / Clew Code
+ * - Claude Code
+ * - Cursor
+ * - Any MCP client
+ * - CLI agents (via coco-cli.js)
+ *
+ * Usage:
+ *   node setup.js              # Interactive wizard
+ *   node setup.js --quick      # Quick setup (defaults)
+ *   node setup.js opencode     # Just OpenCode config
+ *   node setup.js list         # List recommended configs
+ */
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const COCO_DIR = __dirname;
+const BUS_DIR = path.join(COCO_DIR, '.bus');
+const MSGS_DIR = path.join(BUS_DIR, 'messages');
+
+function rl() {
+  return readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+}
+
+function question(query) {
+  return new Promise(resolve => {
+    const i = rl();
+    i.question(query, answer => { i.close(); resolve(answer); });
+  });
+}
+
+// ═══════════════════════════════════════════════════════
+//  Config Generators
+// ═══════════════════════════════════════════════════════
+
+function generateMCPJson(serverName, command, args) {
+  return {
+    mcpServers: {
+      [serverName]: {
+        command,
+        args,
+      },
+    },
+  };
+}
+
+function generateMcpConfigOpenCode() {
+  return generateMCPJson(
+    'coco',
+    'node',
+    [path.join(COCO_DIR, 'index.js')]
+  );
+}
+
+function generateMcpConfigClaudeCode() {
+  return generateMCPJson(
+    'coco',
+    'node',
+    [path.join(COCO_DIR, 'index.js')]
+  );
+}
+
+function generateMcpConfigCursor() {
+  return {
+    [path.join(COCO_DIR, 'index.js')]: true,
+  };
+}
+
+function generateEnvFile(agentName) {
+  return `# CoCo Bus Agent Configuration
+# Generated by CoCo Config Wizard
+
+# Your agent name on the bus
+COCO_AGENT=${agentName}
+
+# Path to the CoCo bus directory
+COCO_BUS_DIR=${BUS_DIR}
+
+# CoCo CLI path (for coco-cli.js)
+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'
+`;
+}
+
+// ═══════════════════════════════════════════════════════
+//  Interactive Wizard
+// ═══════════════════════════════════════════════════════
+
+async function wizard() {
+  console.log(`
+╔═══════════════════════════════════════════════╗
+║    MCP CoCo — Config Wizard                  ║
+║    Connect your agents to the Agent Bus       ║
+╚═══════════════════════════════════════════════╝
+`);
+
+  const agentName = await question(`What's your agent name? [${process.env.USER || 'agent'}] `) || process.env.USER || 'agent';
+
+  console.log(`\n🤖 Agent: ${agentName}`);
+  console.log(`📁 CoCo:  ${COCO_DIR}\n`);
+
+  console.log('Which clients do you want to configure?');
+  console.log('  1) OpenCode / Clew Code');
+  console.log('  2) Claude Code');
+  console.log('  3) Cursor');
+  console.log('  4) All of the above');
+  console.log('  5) Just shell aliases + env file');
+  console.log('  6) Exit\n');
+
+  const choice = await question('Choose [4]: ') || '4';
+  console.log();
+
+  // Always register agent on bus
+  registerAgentOnBus(agentName);
+
+  const generated = [];
+
+  switch (choice) {
+    case '1':
+      generated.push(...await setupOpenCode(agentName));
+      break;
+    case '2':
+      generated.push(...await setupClaudeCode(agentName));
+      break;
+    case '3':
+      generated.push(...await setupCursor(agentName));
+      break;
+    case '4':
+      generated.push(...await setupOpenCode(agentName));
+      generated.push(...await setupClaudeCode(agentName));
+      generated.push(...await setupCursor(agentName));
+      break;
+    case '5':
+      generated.push(...generateEnvAndAliases(agentName));
+      break;
+    case '6':
+      console.log('Bye! 🐺');
+      process.exit(0);
+  }
+
+  console.log(`
+╔═══════════════════════════════════════════════╗
+║  ✅ Setup Complete!                          ║
+║                                               ║
+║  Your agent "${agentName}" is now on the bus  ║
+║  Run "node coco-cli.js status" to verify      ║
+╚═══════════════════════════════════════════════╝
+`);
+}
+
+async function setupOpenCode(agentName) {
+  const config = generateMcpConfigOpenCode();
+  const outPath = path.join(COCO_DIR, 'opencode-mcp.json');
+  fs.writeFileSync(outPath, JSON.stringify(config, null, 2), 'utf-8');
+  console.log(`  ✅ OpenCode MCP config → ${outPath}`);
+
+  // Try to place in common locations
+  const opencodeConfigs = [
+    path.join(os.homedir(), '.opencode.jsonc'),
+    path.join(os.homedir(), '.config', 'opencode.json'),
+  ];
+  for (const loc of opencodeConfigs) {
+    const dir = path.dirname(loc);
+    if (fs.existsSync(dir)) {
+      console.log(`     🔧 Copy to ${loc} to auto-connect`);
+    }
+  }
+
+  const [envFile] = generateEnvAndAliases(agentName);
+  return ['opencode-mcp.json', envFile];
+}
+
+async function setupClaudeCode(agentName) {
+  const config = generateMcpConfigClaudeCode();
+  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')}"`);
+
+  const [envFile] = generateEnvAndAliases(agentName);
+  return ['claude-mcp.json', envFile];
+}
+
+async function setupCursor(agentName) {
+  const config = generateMcpConfigCursor();
+  const outPath = path.join(COCO_DIR, 'cursor-mcp.json');
+  fs.writeFileSync(outPath, JSON.stringify(config, null, 2), 'utf-8');
+  console.log(`  ✅ Cursor MCP config → ${outPath}`);
+  console.log(`     Copy .cursor/mcp.json to your project`);
+
+  const [envFile] = generateEnvAndAliases(agentName);
+  return ['cursor-mcp.json', envFile];
+}
+
+function generateEnvAndAliases(agentName) {
+  const envContent = generateEnvFile(agentName);
+  const envPath = path.join(COCO_DIR, '.env.coco');
+  fs.writeFileSync(envPath, envContent, 'utf-8');
+  console.log(`  ✅ Environment file → ${envPath}`);
+
+  const aliasContent = generateShellAliases();
+  const aliasPath = path.join(COCO_DIR, 'coco-aliases.sh');
+  fs.writeFileSync(aliasPath, aliasContent, 'utf-8');
+  console.log(`  ✅ Shell aliases → ${aliasPath}`);
+  console.log(`     Source with: . ${aliasPath}`);
+
+  return ['.env.coco', 'coco-aliases.sh'];
+}
+
+function registerAgentOnBus(agentName) {
+  const agentsFile = path.join(BUS_DIR, 'agents.json');
+  if (!fs.existsSync(BUS_DIR)) fs.mkdirSync(BUS_DIR, { recursive: true });
+  if (!fs.existsSync(MSGS_DIR)) fs.mkdirSync(MSGS_DIR, { recursive: true });
+
+  const agents = fs.existsSync(agentsFile) ? JSON.parse(fs.readFileSync(agentsFile, 'utf-8')) : {};
+  agents[agentName] = {
+    name: agentName,
+    description: `Setup via CoCo Config Wizard`,
+    capabilities: [],
+    tags: [],
+    status: 'idle',
+    version: '1.0.0',
+    last_seen: new Date().toISOString(),
+    registered_at: agents[agentName]?.registered_at || new Date().toISOString(),
+  };
+  fs.writeFileSync(agentsFile, JSON.stringify(agents, null, 2), 'utf-8');
+  console.log(`  ✅ Registered "${agentName}" on the bus`);
+}
+
+// ═══════════════════════════════════════════════════════
+//  Quick Setup
+// ═══════════════════════════════════════════════════════
+
+function quickSetup() {
+  const agentName = process.env.COCO_AGENT || process.env.USER || 'agent';
+  registerAgentOnBus(agentName);
+
+  // Generate all configs
+  fs.writeFileSync(path.join(COCO_DIR, 'opencode-mcp.json'), JSON.stringify(generateMcpConfigOpenCode(), null, 2), 'utf-8');
+  fs.writeFileSync(path.join(COCO_DIR, 'claude-mcp.json'), JSON.stringify(generateMcpConfigClaudeCode(), null, 2), 'utf-8');
+  fs.writeFileSync(path.join(COCO_DIR, 'cursor-mcp.json'), JSON.stringify(generateMcpConfigCursor(), null, 2), 'utf-8');
+  fs.writeFileSync(path.join(COCO_DIR, '.env.coco'), generateEnvFile(agentName), 'utf-8');
+  fs.writeFileSync(path.join(COCO_DIR, 'coco-aliases.sh'), generateShellAliases(), 'utf-8');
+
+  console.log(`
+╔═══════════════════════════════════════════════╗
+║  ✅ Quick Setup Complete                    ║
+║  Agent: ${agentName.padEnd(34)}║
+║                                               ║
+║  Generated: opencode-mcp.json                ║
+║             claude-mcp.json                  ║
+║             cursor-mcp.json                  ║
+║             .env.coco, coco-aliases.sh       ║
+╚═══════════════════════════════════════════════╝
+`);
+}
+
+// ═══════════════════════════════════════════════════════
+//  CLI
+// ═══════════════════════════════════════════════════════
+
+async function main() {
+  const arg = process.argv[2];
+
+  if (arg === '--quick' || arg === '-q') {
+    quickSetup();
+    return;
+  }
+
+  if (arg === 'list') {
+    console.log(`\n📋 CoCo Bus — Recommended Configs\n`);
+    console.log(`  1. OpenCode / Clew Code:`);
+    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(`  3. Cursor:`);
+    console.log(`     Add to .cursor/mcp.json`);
+    return;
+  }
+
+  if (arg === 'opencode') {
+    registerAgentOnBus(process.env.COCO_AGENT || 'agent');
+    fs.writeFileSync(path.join(COCO_DIR, 'opencode-mcp.json'), JSON.stringify(generateMcpConfigOpenCode(), null, 2), 'utf-8');
+    console.log(`✅ OpenCode MCP config generated: opencode-mcp.json`);
+    return;
+  }
+
+  // Interactive
+  await wizard();
+}
+
+// Need os for homedir
+const os = require('os');
+
+main().catch(err => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});

package/tunnel.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * CoCo Tunnel — Cross-machine Bus Proxy CLI Wrapper
+ *
+ * Thin wrapper around lib/tunnel.js
+ * Usage:
+ *   node tunnel.js server --port 9090 --secret mykey
+ *   node tunnel.js client --host ... --port ... --secret ...
+ *   node tunnel.js sync --remote http://... --interval 5000
+ *   node tunnel.js ssh --remote user@host
+ *   node tunnel.js --help
+ */
+const path = require('path');
+const { startServer, startClient, startSync, printSSHHelp } = require('./lib/tunnel');
+
+const args = process.argv.slice(2);
+const mode = args[0];
+
+function parseArgs() {
+  const opts = { busDir: path.join(__dirname, '.bus') };
+  for (let i = 1; i < args.length; i++) {
+    switch (args[i]) {
+      case '--port': opts.port = parseInt(args[++i], 10); break;
+      case '--secret': opts.secret = args[++i]; break;
+      case '--host': opts.host = args[++i]; break;
+      case '--remote': opts.remote = args[++i]; break;
+      case '--interval': opts.interval = parseInt(args[++i], 10); break;
+    }
+  }
+  return opts;
+}
+
+function help() {
+  console.log(`\n╔═══════════════════════════════════════════════╗\n║     CoCo — Tunnel                               ║\n╚═══════════════════════════════════════════════╝\n`);
+  console.log('Usage:');
+  console.log('  node tunnel.js server [options]     Start tunnel server (receiving end)');
+  console.log('  node tunnel.js client [options]     Start tunnel client (sending end)');
+  console.log('  node tunnel.js sync [options]       Bidirectional sync');
+  console.log('  node tunnel.js ssh [options]        SSH tunnel instructions\n');
+  console.log('Options:');
+  console.log('  --port <number>     Port (default: 9090)');
+  console.log('  --host <hostname>   Remote host (default: localhost)');
+  console.log('  --secret <key>      Auth token');
+  console.log('  --remote <url>      Remote tunnel URL (for sync/client)');
+  console.log('  --interval <ms>     Sync interval (default: 10000)');
+  console.log('  --help              This help\n');
+  console.log('Examples:');
+  console.log('  node tunnel.js server --port 9090 --secret ***');
+  console.log('  node tunnel.js client --host 192.168.1.100 --port 9090 --secret ***');
+  console.log('  node tunnel.js sync --remote http://192.168.1.100:9090');
+  console.log('  node tunnel.js ssh --remote user@server.example.com\n');
+}
+
+async function main() {
+  if (!mode || mode === '--help') { help(); return; }
+  const opts = parseArgs();
+  switch (mode) {
+    case 'server': startServer(opts); break;
+    case 'client': await startClient(opts); break;
+    case 'sync': await startSync(opts); break;
+    case 'ssh': printSSHHelp(opts); break;
+    default: console.error(`Unknown mode: ${mode}`); help(); process.exit(1);
+  }
+}
+
+main().catch(err => { console.error('Error:', err.message); process.exit(1); });