claudelink 1.0.0

package/dist/cli.js

@@ -0,0 +1,277 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const NEXUS_DIR = path_1.default.join(os_1.default.homedir(), ".claudelink");
+const MCP_SERVER_CONFIG = {
+    type: "stdio",
+    command: "claudelink-server",
+};
+const CLAUDE_MD_CONTENT = `
+## ClaudeLink - Autonomous Agent Communication
+
+You are part of a multi-agent team. Other agents may be running in separate terminals and can send you messages at any time via ClaudeLink.
+
+### Automatic Inbox Checking
+
+- **BEFORE starting any task**: Check your inbox using \`read_inbox\` first
+- **AFTER completing any task**: Check your inbox again using \`read_inbox\`
+- If you receive a message, acknowledge it and act on it before moving on
+- If a message requires you to change your current work, do so immediately
+- If a message is from another agent asking for information, respond using \`send\` before continuing your own work
+- High-priority messages take precedence over your current task
+
+### Autonomous Collaboration
+
+- When you finish work that another agent might care about, proactively send them an update
+- If you encounter a problem that another agent's role could help with, send them a message
+- When you make a decision that affects the project, post it to the bulletin board
+- If you're blocked waiting for another agent, say so and check inbox again
+
+### Communication Shortcuts
+
+- **"check response"** or **"check messages"** — Use \`read_inbox\` to check for new messages
+- **"ask the [role]"** — Send a message to that role and check inbox for their reply
+- **"tell the [role]"** — Send a one-way message to that role
+- **"who's online"** — Use \`get_agents\` to list all connected agents
+- **"update the board"** — Use \`post_bulletin\` to post a status update
+- **"check the board"** — Use \`get_bulletin\` to read the bulletin board
+`.trim();
+const CLAUDE_MD_MARKER = "## ClaudeLink - Autonomous Agent Communication";
+function installClaudeMd(scope) {
+    let claudeMdPath;
+    if (scope === "global") {
+        const claudeDir = path_1.default.join(os_1.default.homedir(), ".claude");
+        if (!fs_1.default.existsSync(claudeDir)) {
+            fs_1.default.mkdirSync(claudeDir, { recursive: true });
+        }
+        claudeMdPath = path_1.default.join(claudeDir, "CLAUDE.md");
+    }
+    else {
+        claudeMdPath = path_1.default.join(process.cwd(), "CLAUDE.md");
+    }
+    // Check if CLAUDE.md exists and already has ClaudeLink content
+    if (fs_1.default.existsSync(claudeMdPath)) {
+        const existing = fs_1.default.readFileSync(claudeMdPath, "utf-8");
+        if (existing.includes(CLAUDE_MD_MARKER)) {
+            console.log(`  CLAUDE.md already has ClaudeLink instructions (${claudeMdPath})`);
+            return;
+        }
+        // Append to existing file
+        const separator = existing.endsWith("\n") ? "\n" : "\n\n";
+        fs_1.default.writeFileSync(claudeMdPath, existing + separator + CLAUDE_MD_CONTENT + "\n");
+        console.log(`  Added ClaudeLink instructions to existing ${claudeMdPath}`);
+    }
+    else {
+        // Create new file
+        fs_1.default.writeFileSync(claudeMdPath, "# Global Instructions\n\n" + CLAUDE_MD_CONTENT + "\n");
+        console.log(`  Created ${claudeMdPath} with ClaudeLink instructions`);
+    }
+}
+function printBanner() {
+    console.log(`
+    ╔═══════════════════════════════════════════╗
+    ║            C L A U D E  L I N K           ║
+    ║   The hub where your AI agents connect.   ║
+    ╚═══════════════════════════════════════════╝
+  `);
+}
+function initProject() {
+    const cwd = process.cwd();
+    const mcpJsonPath = path_1.default.join(cwd, ".mcp.json");
+    // Create ~/.claudelink directory
+    if (!fs_1.default.existsSync(NEXUS_DIR)) {
+        fs_1.default.mkdirSync(NEXUS_DIR, { recursive: true });
+        console.log(`  Created ${NEXUS_DIR}/`);
+    }
+    // Read or create .mcp.json
+    let mcpConfig = { mcpServers: {} };
+    if (fs_1.default.existsSync(mcpJsonPath)) {
+        try {
+            const content = fs_1.default.readFileSync(mcpJsonPath, "utf-8");
+            mcpConfig = JSON.parse(content);
+            if (!mcpConfig.mcpServers) {
+                mcpConfig.mcpServers = {};
+            }
+            console.log(`  Found existing .mcp.json`);
+        }
+        catch {
+            console.log(`  Warning: Could not parse existing .mcp.json, creating fresh one`);
+            mcpConfig = { mcpServers: {} };
+        }
+    }
+    // Add claudelink server config
+    mcpConfig.mcpServers["claudelink"] = MCP_SERVER_CONFIG;
+    fs_1.default.writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+    console.log(`  Updated ${mcpJsonPath}`);
+    // Install CLAUDE.md with autonomous mode instructions
+    installClaudeMd("project");
+    console.log(`
+  ClaudeLink is ready!
+
+  What was set up:
+    - .mcp.json: MCP server config (tells Claude Code to connect to ClaudeLink)
+    - CLAUDE.md: Autonomous mode instructions (agents check inbox automatically)
+
+  Next steps:
+    1. Restart Claude Code in your terminals
+    2. In each terminal, tell Claude to register:
+       "Register as a developer agent"
+       "Register as a code reviewer"
+    3. Agents can now communicate:
+       "Send a message to the reviewer: please check auth.ts"
+       "Check my inbox for messages"
+       "Post to the bulletin board: deployment at 3pm"
+
+  Data stored in: ${NEXUS_DIR}/nexus.db
+  Config written to: ${mcpJsonPath}
+  `);
+}
+function initGlobal() {
+    // Create ~/.claudelink directory
+    if (!fs_1.default.existsSync(NEXUS_DIR)) {
+        fs_1.default.mkdirSync(NEXUS_DIR, { recursive: true });
+        console.log(`  Created ${NEXUS_DIR}/`);
+    }
+    // Use claude mcp add command for proper global registration
+    const { execSync } = require("child_process");
+    let mcpSuccess = false;
+    try {
+        execSync("claude mcp add --scope user claudelink -- claudelink-server", {
+            stdio: "inherit",
+        });
+        mcpSuccess = true;
+    }
+    catch {
+        console.log(`
+  Could not run "claude mcp add" automatically.
+
+  Run this command manually to add ClaudeLink globally:
+
+    claude mcp add --scope user claudelink -- claudelink-server
+    `);
+    }
+    // Install global CLAUDE.md with autonomous mode instructions
+    installClaudeMd("global");
+    if (mcpSuccess) {
+        console.log(`
+  ClaudeLink is ready (global install)!
+
+  What was set up:
+    - ~/.claude.json: MCP server config (available in ALL projects)
+    - ~/.claude/CLAUDE.md: Autonomous mode instructions (agents check inbox automatically)
+
+  Next steps:
+    1. Restart Claude Code in your terminals
+    2. In each terminal, tell Claude to register:
+       "Register as a developer agent"
+       "Register as a code reviewer"
+    3. Agents can now communicate!
+
+  Data stored in: ${NEXUS_DIR}/nexus.db
+    `);
+    }
+}
+function showHelp() {
+    console.log(`
+  Usage: claudelink <command>
+
+  Commands:
+    init          Add ClaudeLink to .mcp.json in current project + CLAUDE.md
+    init --global Add ClaudeLink globally + ~/.claude/CLAUDE.md
+    status        Show registered agents and their status
+    reset         Clear all messages and agent registrations
+    help          Show this help message
+  `);
+}
+function showStatus() {
+    const dbPath = path_1.default.join(NEXUS_DIR, "nexus.db");
+    if (!fs_1.default.existsSync(dbPath)) {
+        console.log("  No ClaudeLink database found. Run 'claudelink init' first.");
+        return;
+    }
+    // Dynamic import to avoid requiring better-sqlite3 for CLI-only usage
+    try {
+        const Database = require("better-sqlite3");
+        const db = new Database(dbPath, { readonly: true });
+        const agents = db.prepare("SELECT * FROM agents ORDER BY registered_at DESC").all();
+        const msgCount = db.prepare("SELECT COUNT(*) as count FROM messages WHERE read = 0").get();
+        const bulletinCount = db.prepare("SELECT COUNT(*) as count FROM bulletin").get();
+        console.log(`\n  ClaudeLink Status`);
+        console.log(`  ─────────────────`);
+        console.log(`  Database: ${dbPath}`);
+        console.log(`  Unread messages: ${msgCount.count}`);
+        console.log(`  Bulletin entries: ${bulletinCount.count}`);
+        console.log(`  Registered agents: ${agents.length}\n`);
+        for (const agent of agents) {
+            let alive = false;
+            try {
+                process.kill(agent.pid, 0);
+                alive = true;
+            }
+            catch { }
+            const status = alive ? "ONLINE" : "OFFLINE";
+            console.log(`    [${status}] ${agent.role} (pid: ${agent.pid}) - registered: ${agent.registered_at}`);
+            if (agent.description) {
+                console.log(`             ${agent.description}`);
+            }
+        }
+        console.log();
+        db.close();
+    }
+    catch (err) {
+        console.log(`  Error reading database: ${err.message}`);
+    }
+}
+function resetDB() {
+    const dbPath = path_1.default.join(NEXUS_DIR, "nexus.db");
+    if (fs_1.default.existsSync(dbPath)) {
+        fs_1.default.unlinkSync(dbPath);
+        // Clean up WAL files if present
+        if (fs_1.default.existsSync(dbPath + "-wal"))
+            fs_1.default.unlinkSync(dbPath + "-wal");
+        if (fs_1.default.existsSync(dbPath + "-shm"))
+            fs_1.default.unlinkSync(dbPath + "-shm");
+        console.log("  ClaudeLink database cleared. All messages and registrations removed.");
+    }
+    else {
+        console.log("  No database found. Nothing to reset.");
+    }
+}
+// --- Main ---
+const args = process.argv.slice(2);
+const command = args[0];
+printBanner();
+switch (command) {
+    case "init":
+        if (args.includes("--global")) {
+            initGlobal();
+        }
+        else {
+            initProject();
+        }
+        break;
+    case "status":
+        showStatus();
+        break;
+    case "reset":
+        resetDB();
+        break;
+    case "help":
+    case "--help":
+    case "-h":
+        showHelp();
+        break;
+    default:
+        if (command) {
+            console.log(`  Unknown command: ${command}\n`);
+        }
+        showHelp();
+        break;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;AAEA,4CAAoB;AACpB,gDAAwB;AACxB,4CAAoB;AAEpB,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AAEzD,MAAM,iBAAiB,GAAG;IACxB,IAAI,EAAE,OAAgB;IACtB,OAAO,EAAE,mBAAmB;CAC7B,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BzB,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,gBAAgB,GAAG,gDAAgD,CAAC;AAE1E,SAAS,eAAe,CAAC,KAA2B;IAClD,IAAI,YAAoB,CAAC;IAEzB,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,YAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,+DAA+D;IAC/D,IAAI,YAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,YAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,oDAAoD,YAAY,GAAG,CAAC,CAAC;YACjF,OAAO;QACT,CAAC;QACD,0BAA0B;QAC1B,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1D,YAAE,CAAC,aAAa,CAAC,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,iBAAiB,GAAG,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,GAAG,CAAC,+CAA+C,YAAY,EAAE,CAAC,CAAC;IAC7E,CAAC;SAAM,CAAC;QACN,kBAAkB;QAClB,YAAE,CAAC,aAAa,CAAC,YAAY,EAAE,2BAA2B,GAAG,iBAAiB,GAAG,IAAI,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,aAAa,YAAY,+BAA+B,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,CAAC,GAAG,CAAC;;;;;GAKX,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,WAAW,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAEhD,iCAAiC;IACjC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,YAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,2BAA2B;IAC3B,IAAI,SAAS,GAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAExC,IAAI,YAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACtD,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;gBAC1B,SAAS,CAAC,UAAU,GAAG,EAAE,CAAC;YAC5B,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;YACjF,SAAS,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,iBAAiB,CAAC;IAEvD,YAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,aAAa,WAAW,EAAE,CAAC,CAAC;IAExC,sDAAsD;IACtD,eAAe,CAAC,SAAS,CAAC,CAAC;IAE3B,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;oBAiBM,SAAS;uBACN,WAAW;GAC/B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU;IACjB,iCAAiC;IACjC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,YAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,4DAA4D;IAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,CAAC,6DAA6D,EAAE;YACtE,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC;;;;;;KAMX,CAAC,CAAC;IACL,CAAC;IAED,6DAA6D;IAC7D,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE1B,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;oBAcI,SAAS;KACxB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;;;;;;;;;GASX,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;QAC5E,OAAO;IACT,CAAC;IAED,sEAAsE;IACtE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,kDAAkD,CAAC,CAAC,GAAG,EAAE,CAAC;QACpF,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,uDAAuD,CAAC,CAAC,GAAG,EAAS,CAAC;QAClG,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC,GAAG,EAAS,CAAC;QAExF,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,sBAAsB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,uBAAuB,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAEvD,KAAK,MAAM,KAAK,IAAI,MAAe,EAAE,CAAC;YACpC,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC3B,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YAEV,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,KAAK,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,GAAG,mBAAmB,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;YACtG,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,6BAA6B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,OAAO;IACd,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACtB,gCAAgC;QAChC,IAAI,YAAE,CAAC,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;YAAE,YAAE,CAAC,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;QACnE,IAAI,YAAE,CAAC,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;YAAE,YAAE,CAAC,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;IACxF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,eAAe;AACf,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAExB,WAAW,EAAE,CAAC;AAEd,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,MAAM;QACT,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,UAAU,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,WAAW,EAAE,CAAC;QAChB,CAAC;QACD,MAAM;IACR,KAAK,QAAQ;QACX,UAAU,EAAE,CAAC;QACb,MAAM;IACR,KAAK,OAAO;QACV,OAAO,EAAE,CAAC;QACV,MAAM;IACR,KAAK,MAAM,CAAC;IACZ,KAAK,QAAQ,CAAC;IACd,KAAK,IAAI;QACP,QAAQ,EAAE,CAAC;QACX,MAAM;IACR;QACE,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,QAAQ,EAAE,CAAC;QACX,MAAM;AACV,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,40 @@
+export interface Agent {
+    id: string;
+    role: string;
+    description: string | null;
+    registered_at: string;
+    last_seen: string;
+    pid: number;
+    alive: boolean;
+}
+export interface Message {
+    id: number;
+    from_role: string;
+    from_agent: string;
+    to_agent: string | null;
+    content: string;
+    priority: string;
+    created_at: string;
+}
+export interface BulletinEntry {
+    id: number;
+    from_role: string;
+    from_agent: string;
+    content: string;
+    created_at: string;
+}
+export declare class NexusDB {
+    private db;
+    constructor();
+    private migrate;
+    registerAgent(role: string, description: string | null, pid: number): string;
+    heartbeat(agentId: string): void;
+    getAgents(): Agent[];
+    sendMessage(fromId: string, toRole: string, content: string, priority?: string): number;
+    broadcastMessage(fromId: string, content: string): void;
+    readInbox(agentId: string): Message[];
+    postBulletin(fromId: string, content: string): void;
+    getBulletin(limit?: number): BulletinEntry[];
+    pruneDeadAgents(): void;
+    close(): void;
+}

package/dist/db.js

@@ -0,0 +1,169 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NexusDB = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const fs_1 = __importDefault(require("fs"));
+const crypto_1 = __importDefault(require("crypto"));
+const NEXUS_DIR = path_1.default.join(os_1.default.homedir(), ".claudelink");
+const DB_PATH = path_1.default.join(NEXUS_DIR, "nexus.db");
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+class NexusDB {
+    constructor() {
+        if (!fs_1.default.existsSync(NEXUS_DIR)) {
+            fs_1.default.mkdirSync(NEXUS_DIR, { recursive: true });
+        }
+        this.db = new better_sqlite3_1.default(DB_PATH);
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("busy_timeout = 5000");
+        this.migrate();
+    }
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS agents (
+        id TEXT PRIMARY KEY,
+        role TEXT NOT NULL,
+        description TEXT,
+        registered_at TEXT DEFAULT (datetime('now')),
+        last_seen TEXT DEFAULT (datetime('now')),
+        pid INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS messages (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        from_agent TEXT NOT NULL,
+        to_agent TEXT,
+        content TEXT NOT NULL,
+        priority TEXT DEFAULT 'normal',
+        read INTEGER DEFAULT 0,
+        created_at TEXT DEFAULT (datetime('now')),
+        FOREIGN KEY (from_agent) REFERENCES agents(id)
+      );
+
+      CREATE TABLE IF NOT EXISTS bulletin (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        from_agent TEXT NOT NULL,
+        content TEXT NOT NULL,
+        created_at TEXT DEFAULT (datetime('now')),
+        FOREIGN KEY (from_agent) REFERENCES agents(id)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_messages_to_agent ON messages(to_agent);
+      CREATE INDEX IF NOT EXISTS idx_messages_read ON messages(read);
+      CREATE INDEX IF NOT EXISTS idx_agents_role ON agents(role);
+    `);
+    }
+    registerAgent(role, description, pid) {
+        this.pruneDeadAgents();
+        const id = crypto_1.default.randomUUID();
+        this.db
+            .prepare(`INSERT INTO agents (id, role, description, pid) VALUES (?, ?, ?, ?)`)
+            .run(id, role, description, pid);
+        return id;
+    }
+    heartbeat(agentId) {
+        this.db
+            .prepare(`UPDATE agents SET last_seen = datetime('now') WHERE id = ?`)
+            .run(agentId);
+    }
+    getAgents() {
+        this.pruneDeadAgents();
+        const rows = this.db
+            .prepare(`SELECT * FROM agents ORDER BY registered_at DESC`)
+            .all();
+        return rows.map((row) => ({
+            ...row,
+            alive: isProcessAlive(row.pid),
+        }));
+    }
+    sendMessage(fromId, toRole, content, priority = "normal") {
+        const targets = this.db
+            .prepare(`SELECT id FROM agents WHERE role = ?`)
+            .all(toRole);
+        if (targets.length === 0) {
+            throw new Error(`No agent found with role "${toRole}". Use get_agents to see available agents.`);
+        }
+        const insert = this.db.prepare(`INSERT INTO messages (from_agent, to_agent, content, priority) VALUES (?, ?, ?, ?)`);
+        const sendAll = this.db.transaction(() => {
+            for (const target of targets) {
+                insert.run(fromId, target.id, content, priority);
+            }
+        });
+        sendAll();
+        return targets.length;
+    }
+    broadcastMessage(fromId, content) {
+        this.db
+            .prepare(`INSERT INTO messages (from_agent, to_agent, content, priority) VALUES (?, NULL, ?, 'normal')`)
+            .run(fromId, content);
+    }
+    readInbox(agentId) {
+        const readMessages = this.db.transaction(() => {
+            const rows = this.db
+                .prepare(`SELECT m.id, m.from_agent, m.to_agent, m.content, m.priority, m.created_at,
+                  a.role as from_role
+           FROM messages m
+           LEFT JOIN agents a ON m.from_agent = a.id
+           WHERE (m.to_agent = ? OR m.to_agent IS NULL)
+             AND m.from_agent != ?
+             AND m.read = 0
+           ORDER BY m.created_at ASC`)
+                .all(agentId, agentId);
+            if (rows.length > 0) {
+                const ids = rows.map((r) => r.id);
+                const placeholders = ids.map(() => "?").join(",");
+                this.db
+                    .prepare(`UPDATE messages SET read = 1 WHERE id IN (${placeholders})`)
+                    .run(...ids);
+            }
+            return rows;
+        });
+        return readMessages();
+    }
+    postBulletin(fromId, content) {
+        this.db
+            .prepare(`INSERT INTO bulletin (from_agent, content) VALUES (?, ?)`)
+            .run(fromId, content);
+    }
+    getBulletin(limit = 10) {
+        return this.db
+            .prepare(`SELECT b.id, b.from_agent, b.content, b.created_at,
+                a.role as from_role
+         FROM bulletin b
+         LEFT JOIN agents a ON b.from_agent = a.id
+         ORDER BY b.created_at DESC
+         LIMIT ?`)
+            .all(limit);
+    }
+    pruneDeadAgents() {
+        const agents = this.db
+            .prepare(`SELECT id, pid FROM agents`)
+            .all();
+        const deadIds = agents
+            .filter((a) => !isProcessAlive(a.pid))
+            .map((a) => a.id);
+        if (deadIds.length > 0) {
+            const placeholders = deadIds.map(() => "?").join(",");
+            this.db
+                .prepare(`DELETE FROM agents WHERE id IN (${placeholders})`)
+                .run(...deadIds);
+        }
+    }
+    close() {
+        this.db.close();
+    }
+}
+exports.NexusDB = NexusDB;
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":";;;;;;AAAA,oEAAsC;AACtC,gDAAwB;AACxB,4CAAoB;AACpB,4CAAoB;AACpB,oDAA4B;AA8B5B,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AACzD,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAEjD,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAa,OAAO;IAGlB;QACE,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,YAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,IAAI,wBAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAEtC,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgCZ,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,IAAY,EAAE,WAA0B,EAAE,GAAW;QACjE,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,MAAM,EAAE,GAAG,gBAAM,CAAC,UAAU,EAAE,CAAC;QAE/B,IAAI,CAAC,EAAE;aACJ,OAAO,CACN,qEAAqE,CACtE;aACA,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QAEnC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,SAAS,CAAC,OAAe;QACvB,IAAI,CAAC,EAAE;aACJ,OAAO,CAAC,4DAA4D,CAAC;aACrE,GAAG,CAAC,OAAO,CAAC,CAAC;IAClB,CAAC;IAED,SAAS;QACP,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC,kDAAkD,CAAC;aAC3D,GAAG,EAA4B,CAAC;QAEnC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACxB,GAAG,GAAG;YACN,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;SAC/B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,WAAW,CACT,MAAc,EACd,MAAc,EACd,OAAe,EACf,WAAmB,QAAQ;QAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE;aACpB,OAAO,CAAC,sCAAsC,CAAC;aAC/C,GAAG,CAAC,MAAM,CAAqB,CAAC;QAEnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,6BAA6B,MAAM,4CAA4C,CAChF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC5B,oFAAoF,CACrF,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YACvC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YACnD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,CAAC;QACV,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IAED,gBAAgB,CAAC,MAAc,EAAE,OAAe;QAC9C,IAAI,CAAC,EAAE;aACJ,OAAO,CACN,8FAA8F,CAC/F;aACA,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS,CAAC,OAAe;QACvB,MAAM,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;iBACjB,OAAO,CACN;;;;;;;qCAO2B,CAC5B;iBACA,GAAG,CAAC,OAAO,EAAE,OAAO,CAAc,CAAC;YAEtC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClC,MAAM,YAAY,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClD,IAAI,CAAC,EAAE;qBACJ,OAAO,CACN,6CAA6C,YAAY,GAAG,CAC7D;qBACA,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;YACjB,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,OAAO,YAAY,EAAE,CAAC;IACxB,CAAC;IAED,YAAY,CAAC,MAAc,EAAE,OAAe;QAC1C,IAAI,CAAC,EAAE;aACJ,OAAO,CAAC,0DAA0D,CAAC;aACnE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,WAAW,CAAC,QAAgB,EAAE;QAC5B,OAAO,IAAI,CAAC,EAAE;aACX,OAAO,CACN;;;;;iBAKS,CACV;aACA,GAAG,CAAC,KAAK,CAAoB,CAAC;IACnC,CAAC;IAED,eAAe;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE;aACnB,OAAO,CAAC,4BAA4B,CAAC;aACrC,GAAG,EAAmC,CAAC;QAE1C,MAAM,OAAO,GAAG,MAAM;aACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAEpB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtD,IAAI,CAAC,EAAE;iBACJ,OAAO,CAAC,mCAAmC,YAAY,GAAG,CAAC;iBAC3D,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF;AAhMD,0BAgMC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};