ghostbus 0.0.0-stage → 0.5.2

package/package.json

@@ -1,6 +1,48 @@
 {
+  "author": "Ghost Developer Studio",
+  "bin": {
+    "ghostbus": "src/mcp-server.mjs",
+    "ghostbus-cli": "src/cli.mjs",
+    "ghostbus-relay": "src/http-server.mjs"
+  },
+  "description": "Agent-to-agent message bus and shared workspace, exposed as an MCP server. Zero dependencies.",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "src",
+    "examples",
+    "docs",
+    "README.md",
+    "PLAN.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "homepage": "https://github.com/littlestjames82-sys/ghostbus#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "agent",
+    "multi-agent",
+    "message-bus",
+    "a2a",
+    "agent-to-agent"
+  ],
+  "license": "MIT",
   "name": "ghostbus",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/littlestjames82-sys/ghostbus.git"
+  },
+  "scripts": {
+    "demo": "node examples/two-agent-demo.mjs",
+    "demo-team": "node examples/three-agent-team.mjs",
+    "relay": "node src/http-server.mjs",
+    "start": "node src/mcp-server.mjs",
+    "test": "node test.mjs",
+    "test:serverless": "node deploy/netlify/test-lib.mjs",
+    "hosted": "node src/hosted-server.mjs"
+  },
+  "type": "module",
+  "version": "0.5.2"
+}

package/src/board.html

@@ -0,0 +1,78 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>GhostBus — Shared Workspace Board</title>
+<style>
+  :root { --violet:#6716f3; --bg:#0e0c14; --panel:#17131f; --line:#2a2138; --text:#ece8f5; --muted:#9b8fb5; }
+  * { box-sizing:border-box; } body { margin:0; font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif; background:var(--bg); color:var(--text); }
+  header { display:flex; align-items:center; gap:12px; padding:14px 20px; border-bottom:1px solid var(--line); }
+  header h1 { font-size:18px; margin:0; } header .dot { width:10px;height:10px;border-radius:50%;background:#3ddc84; }
+  header span { color:var(--muted); font-size:13px; }
+  main { display:grid; grid-template-columns:repeat(auto-fit,minmax(300px,1fr)); gap:16px; padding:16px 20px; }
+  section { background:var(--panel); border:1px solid var(--line); border-radius:12px; padding:14px 16px; }
+  section h2 { font-size:13px; text-transform:uppercase; letter-spacing:.08em; color:var(--muted); margin:0 0 10px; }
+  .agent, .task, .file, .ev { padding:7px 0; border-bottom:1px dashed var(--line); font-size:14px; }
+  .agent:last-child,.task:last-child,.file:last-child,.ev:last-child{border-bottom:none}
+  .pill { display:inline-block; padding:1px 8px; border-radius:99px; font-size:11px; background:#241a3d; color:#c9b8ff; margin-left:6px; }
+  .pill.green{ background:#123524; color:#7fe6ae; } .pill.amber{ background:#3a2c10; color:#ffd97a; }
+  .muted{ color:var(--muted); font-size:12px; } a{ color:#c9b8ff; }
+  #keybar { padding:10px 20px; border-bottom:1px solid var(--line); display:none; gap:8px; }
+  input { background:#0e0c14; border:1px solid var(--line); color:var(--text); border-radius:8px; padding:6px 10px; }
+  button { background:var(--violet); color:#fff; border:none; border-radius:8px; padding:6px 14px; cursor:pointer; }
+</style>
+</head>
+<body>
+<header>
+  <div class="dot" id="dot"></div>
+  <h1>👻 GhostBus Board</h1>
+  <span id="ws">connecting…</span>
+  <span style="margin-left:auto" id="clock"></span>
+</header>
+<div id="keybar">
+  <span class="muted">This relay requires the workspace key:</span>
+  <input id="key" type="password" placeholder="GHOSTBUS_KEY" size="28">
+  <button onclick="saveKey()">Connect</button>
+</div>
+<main>
+  <section><h2>Agents</h2><div id="agents">—</div></section>
+  <section><h2>Open tasks</h2><div id="tasks">—</div></section>
+  <section><h2>Shared files</h2><div id="files">—</div></section>
+  <section><h2>Recent activity</h2><div id="events">—</div></section>
+</main>
+<script>
+const $ = id => document.getElementById(id);
+const BASE = location.pathname.replace(/\/$/, ''); // '' at root, '/w/<id>' on hosted relays
+const key = () => localStorage.getItem('ghostbus_key') || '';
+function saveKey(){ localStorage.setItem('ghostbus_key', $('key').value.trim()); $('keybar').style.display='none'; refresh(); }
+async function api(path){
+  const r = await fetch(BASE + path, { headers: key() ? { 'x-bus-key': key() } : {} });
+  if (r.status === 401) { $('keybar').style.display = 'flex'; throw new Error('key needed'); }
+  if (!r.ok) throw new Error(path + ' ' + r.status);
+  return r.json();
+}
+const esc = s => String(s ?? '').replace(/[&<>"]/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;'}[c]));
+async function refresh(){
+  try {
+    const [status, agents, tasks, files, events] = await Promise.all([
+      api('/api/status'), api('/api/agents'), api('/api/tasks'), api('/api/files/list'), api('/api/events?limit=12')
+    ]);
+    $('ws').textContent = `${status.workspace.name} · v${status.version} · ${status.messages} messages`;
+    $('dot').style.background = '#3ddc84';
+    $('agents').innerHTML = agents.agents.length ? agents.agents.map(a =>
+      `<div class="agent"><strong>${esc(a.name)}</strong><span class="pill ${a.online?'green':''}">${a.online?'online':'away'}</span><br><span class="muted">${esc(a.role||'agent')}${a.capabilities?.length ? ' · ' + esc(a.capabilities.join(', ')) : ''} · last seen ${esc(a.lastSeenAt)}</span></div>`).join('') : '<span class="muted">none registered</span>';
+    const open = tasks.tasks.filter(t => !['done','cancelled'].includes(t.status));
+    $('tasks').innerHTML = open.length ? open.map(t =>
+      `<div class="task">#${t.id} <strong>${esc(t.title)}</strong><span class="pill ${t.status==='needs-approval'?'amber':''}">${esc(t.status)}</span><br><span class="muted">from ${esc(t.from)}${t.claimedBy ? ' · claimed by ' + esc(t.claimedBy) : ''}${t.assignee ? ' · for ' + esc(t.assignee) : ''}</span></div>`).join('') : '<span class="muted">queue is empty</span>';
+    $('files').innerHTML = files.files.length ? files.files.map(f =>
+      `<div class="file">📄 ${esc(f.path)}<br><span class="muted">${f.bytes} bytes · ${esc(f.updatedBy)} · ${esc(f.updatedAt)}</span></div>`).join('') : '<span class="muted">no shared files</span>';
+    $('events').innerHTML = events.events.slice().reverse().map(e =>
+      `<div class="ev"><span class="muted">${esc(e.at)}</span> <strong>${esc(e.actor)}</strong> ${esc(e.summary)}</div>`).join('');
+    $('clock').textContent = 'updated ' + new Date().toLocaleTimeString();
+  } catch (e) { $('dot').style.background = '#e05252'; $('ws').textContent = 'disconnected: ' + e.message; }
+}
+refresh(); setInterval(refresh, 5000);
+</script>
+</body>
+</html>

package/src/cli.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * GhostBus terminal CLI — drive a workspace from the shell (handy for humans,
+ * scripts, and wake hooks). Works directly on a store file:
+ *
+ *   ghostbus-cli --store ./ghostbus-data.json status
+ *   ghostbus-cli register alice --role planner
+ *   ghostbus-cli send alice bob "ship it"        (to = * broadcasts)
+ *   ghostbus-cli inbox bob
+ *   ghostbus-cli task alice "Build the API" [--assign bob] [--urgent] [--approve-first]
+ *   ghostbus-cli tasks [--status queued]
+ *   ghostbus-cli claim 1 bob | complete 1 bob "done, tests green" | comment 1 alice "note"
+ *   ghostbus-cli board | agents | search "API" | put-file alice path.md ./local.md | get-file path.md
+ *   ghostbus-cli export ./backup.json            (full-state snapshot to a file, or stdout with -)
+ *   ghostbus-cli import ./backup.json            (restore a snapshot INTO this store — replaces state)
+ *
+ * Env: GHOSTBUS_STORE, GHOSTBUS_TOKEN_<AGENT> for token-enforced buses.
+ */
+import fs from 'node:fs';
+import { createBus, MemoryStore, FileStore, GHOSTBUS_VERSION } from './core.mjs';
+
+const argv = process.argv.slice(2);
+const storeIdx = argv.indexOf('--store');
+const storePath = storeIdx >= 0 ? argv[storeIdx + 1] : (process.env.GHOSTBUS_STORE || './ghostbus-data.json');
+const args = argv.filter((a, i) => i !== storeIdx && i !== storeIdx + 1);
+const [cmd, ...rest] = args;
+const flag = (name) => rest.includes(name);
+const flagVal = (name) => { const i = rest.indexOf(name); return i >= 0 ? rest[i + 1] : null; };
+const positional = rest.filter((a, i) => !a.startsWith('--') && rest[i - 1] !== '--assign' && rest[i - 1] !== '--status' && rest[i - 1] !== '--role');
+const tokenFor = (agent) => process.env[`GHOSTBUS_TOKEN_${String(agent).toUpperCase().replace(/[^A-Z0-9]/g, '_')}`] || null;
+
+const store = storePath === ':memory:' ? new MemoryStore() : new FileStore(storePath);
+const bus = await createBus(store, {}, { requireTokens: process.env.GHOSTBUS_REQUIRE_TOKENS === '1' });
+const out = (v) => console.log(typeof v === 'string' ? v : JSON.stringify(v, null, 2));
+
+try {
+  switch (cmd) {
+    case 'status': out(await bus.status()); break;
+    case 'agents': out(await bus.listAgents()); break;
+    case 'register': {
+      const r = await bus.registerAgent({ name: positional[0], role: flagVal('--role') || '', token: tokenFor(positional[0]) });
+      out(r); if (r.token) console.error('⚠ agent token shown ONCE — store it (CLI: GHOSTBUS_TOKEN_' + positional[0].toUpperCase() + ')');
+      break;
+    }
+    case 'send': out(await bus.sendMessage({ from: positional[0], to: positional[1], body: positional.slice(2).join(' '), token: tokenFor(positional[0]) })); break;
+    case 'inbox': out(await bus.inbox(positional[0], { unreadOnly: flag('--unread'), token: tokenFor(positional[0]) })); break;
+    case 'task': out(await bus.createTask({ from: positional[0], title: positional.slice(1).join(' '), assignee: flagVal('--assign'), priority: flag('--urgent') ? 'urgent' : 'normal', needsApproval: flag('--approve-first'), token: tokenFor(positional[0]) })); break;
+    case 'tasks': out(await bus.listTasks({ status: flagVal('--status') })); break;
+    case 'claim': out(await bus.claimTask(Number(positional[0]), { by: positional[1], token: tokenFor(positional[1]) })); break;
+    case 'approve': out(await bus.approveTask(Number(positional[0]), { by: positional[1], token: tokenFor(positional[1]) })); break;
+    case 'complete': out(await bus.completeTask(Number(positional[0]), { by: positional[1], result: positional.slice(2).join(' '), token: tokenFor(positional[1]) })); break;
+    case 'comment': out(await bus.addTaskComment(Number(positional[0]), { by: positional[1], body: positional.slice(2).join(' '), token: tokenFor(positional[1]) })); break;
+    case 'board': out(await bus.board()); break;
+    case 'search': out(await bus.search(positional.join(' '))); break;
+    case 'put-file': out(await bus.putFile({ by: positional[0], path: positional[1], text: fs.readFileSync(positional[2], 'utf8'), token: tokenFor(positional[0]) })); break;
+    case 'get-file': { const f = await bus.getFile(positional[0]); out(f.text); break; }
+    case 'events': out(await bus.events({ limit: Number(flagVal('--limit') || 20) })); break;
+    case 'export': {
+      const env = { ghostbusExport: 1, version: GHOSTBUS_VERSION, exportedAt: new Date().toISOString(), workspace: (await bus.status()).workspace, state: await bus.snapshot() };
+      const text = JSON.stringify(env, null, 2);
+      if (!positional[0] || positional[0] === '-') console.log(text);
+      else { fs.writeFileSync(positional[0], text); console.error(`exported ${env.state.agents.length} agents, ${env.state.tasks.length} tasks, ${env.state.messages.length} messages -> ${positional[0]}`); }
+      break;
+    }
+    case 'import': {
+      if (!positional[0]) { console.error('usage: ghostbus-cli import <backup.json>'); process.exit(2); }
+      const parsed = JSON.parse(fs.readFileSync(positional[0], 'utf8'));
+      const state = parsed.ghostbusExport ? parsed.state : (parsed.state || parsed);
+      const st = await bus.restore(state, { by: 'cli' });
+      out({ imported: true, agents: st.agents, messages: st.messages, tasks: st.tasks.total });
+      break;
+    }
+    default:
+      console.error('usage: ghostbus-cli [--store file] <status|agents|register|send|inbox|task|tasks|claim|approve|complete|comment|board|search|put-file|get-file|events|export|import>');
+      process.exit(2);
+  }
+} catch (e) { console.error(`Error: ${e.message}`); process.exit(1); }