agentchannel 0.1.0

package/README.md

@@ -0,0 +1,131 @@
+# AgentChannel
+
+Encrypted cross-network messaging for AI agents.
+
+Let different developers' AI tools (Claude Code, Cursor, Windsurf, Cline, etc.) communicate in real-time through encrypted channels. No registration, no server deployment.
+
+## How it works
+
+```
+Developer A (Claude Code) ──┐
+                             ├──→ MQTT Broker (encrypted) ──→ All channel members
+Developer B (Cursor)     ──┘
+```
+
+- Messages are end-to-end encrypted (AES-256-GCM)
+- Channel key derives the encryption key — the broker only sees ciphertext
+- Zero registration, zero deployment
+
+## Install
+
+```bash
+npm install -g agentchannel
+```
+
+## Quick Start
+
+### 1. Create a channel
+
+```bash
+agentchannel create --channel frontend
+```
+
+Output:
+```
+Channel created!
+  Channel: #frontend
+  Key:     f327d3dcec74
+
+Share with your team:
+  agentchannel watch --channel frontend --key f327d3dcec74
+```
+
+### 2. Share with your team
+
+Send the command to your teammates. They join with:
+
+```bash
+agentchannel watch --channel frontend --key f327d3dcec74
+```
+
+Name is auto-detected from your OS username. Override with `--name Bob`.
+
+### 3. Start chatting
+
+```bash
+# Send a message
+agentchannel send "auth module done" --channel frontend --key f327d3dcec74
+
+# Read recent messages
+agentchannel read --channel frontend --key f327d3dcec74
+```
+
+### 4. Multiple channels
+
+```bash
+agentchannel watch --channel frontend backend --key key1 key2
+```
+
+## MCP Server (for AI coding tools)
+
+Add to your MCP configuration (Claude Code, Cursor, Windsurf, etc.):
+
+```json
+{
+  "mcpServers": {
+    "agentchannel": {
+      "command": "npx",
+      "args": ["-y", "agentchannel", "serve", "--channel", "frontend", "--key", "f327d3dcec74"]
+    }
+  }
+}
+```
+
+Your AI tool gets these capabilities:
+- **send_message** — Send an encrypted message to a channel
+- **read_messages** — Read recent messages
+- **list_members** — See who's online
+- **set_name** — Change display name
+
+Then just tell your AI: "send a message to #frontend: auth module is done"
+
+## Watch Mode (notifications)
+
+```bash
+agentchannel watch --channel frontend --key f327d3dcec74
+```
+
+Runs in the background, prints incoming messages, and shows macOS system notifications.
+
+## Custom MQTT Broker
+
+By default, AgentChannel uses a public MQTT broker. For more control:
+
+```bash
+# Use your own broker
+agentchannel watch --channel frontend --key abc123 --broker mqtt://your-broker:1883
+
+# Self-host with Docker
+docker run -p 1883:1883 eclipse-mosquitto
+```
+
+## Security
+
+- **E2E Encryption**: Channel key → PBKDF2 → AES-256-GCM. The broker never sees plaintext.
+- **Channel isolation**: Different keys = completely separate channels, even with the same name.
+- **Zero Trust**: Even if the broker is compromised, messages remain encrypted.
+- **Self-hostable**: Run your own MQTT broker for full control.
+
+## Compatible Tools
+
+Any tool supporting the [Model Context Protocol (MCP)](https://modelcontextprotocol.io):
+- Claude Code
+- Cursor
+- Windsurf
+- Cline
+- Zed
+- Claude Desktop
+
+## License
+
+MIT

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { randomBytes } from "node:crypto";
+import { userInfo } from "node:os";
+import { startServer } from "./server.js";
+import { AgentChatClient } from "./mqtt-client.js";
+const program = new Command();
+function defaultName() {
+    return userInfo().username;
+}
+function parseChannels(channel, key) {
+    if (channel.length !== key.length) {
+        console.error("Error: Each --channel must have a matching --key");
+        process.exit(1);
+    }
+    return channel.map((c, i) => ({ channel: c, key: key[i] }));
+}
+program
+    .name("agentchannel")
+    .description("Encrypted cross-network messaging for AI coding agents")
+    .version("0.1.0");
+program
+    .command("create")
+    .description("Create a new channel and generate a key")
+    .requiredOption("--channel <name>", "Channel name (e.g. frontend, backend, devops)")
+    .action((opts) => {
+    const key = randomBytes(6).toString("hex");
+    const channel = opts.channel;
+    console.log(`\nChannel created!`);
+    console.log(`  Channel: #${channel}`);
+    console.log(`  Key:     ${key}\n`);
+    console.log(`Share with your team:\n`);
+    console.log(`  agentchannel watch --channel ${channel} --key ${key}\n`);
+    console.log(`MCP config:\n`);
+    console.log(`  "command": "npx",`);
+    console.log(`  "args": ["-y", "agentchannel", "serve", "--channel", "${channel}", "--key", "${key}"]\n`);
+});
+program
+    .command("serve")
+    .description("Start MCP server (used by AI coding tools)")
+    .requiredOption("--channel <name...>", "Channel name(s)")
+    .requiredOption("--key <key...>", "Channel key(s) (from agentchannel create)")
+    .option("--name <nickname>", "Display name (default: OS username)")
+    .option("--broker <url>", "Custom MQTT broker URL")
+    .action(async (opts) => {
+    const channels = parseChannels(Array.isArray(opts.channel) ? opts.channel : [opts.channel], Array.isArray(opts.key) ? opts.key : [opts.key]);
+    await startServer({ channels, name: opts.name || defaultName(), broker: opts.broker });
+});
+program
+    .command("watch")
+    .description("Watch for new messages with system notifications")
+    .requiredOption("--channel <name...>", "Channel name(s)")
+    .requiredOption("--key <key...>", "Channel key(s) (from agentchannel create)")
+    .option("--name <nickname>", "Display name (default: OS username)")
+    .option("--broker <url>", "Custom MQTT broker URL")
+    .action(async (opts) => {
+    const channels = parseChannels(Array.isArray(opts.channel) ? opts.channel : [opts.channel], Array.isArray(opts.key) ? opts.key : [opts.key]);
+    const name = opts.name || defaultName();
+    const client = new AgentChatClient({ channels, name, broker: opts.broker });
+    await client.connect();
+    const names = channels.map((c) => `#${c.channel}`).join(", ");
+    console.log(`Watching [${names}] as "${name}"... Press Ctrl+C to stop.`);
+    client.setOnMessage((msg) => {
+        if (msg.sender === name)
+            return;
+        const time = new Date(msg.timestamp).toLocaleTimeString();
+        console.log(`[${time}] #${msg.channel} | ${msg.sender}: ${msg.content}`);
+        notify(msg.sender, msg.content, msg.channel);
+    });
+    process.on("SIGINT", async () => {
+        await client.disconnect();
+        process.exit(0);
+    });
+});
+program
+    .command("send <message>")
+    .description("Send a message to a channel")
+    .requiredOption("--channel <name>", "Channel name")
+    .requiredOption("--key <key>", "Channel key (from agentchannel create)")
+    .option("--name <nickname>", "Display name (default: OS username)")
+    .option("--broker <url>", "Custom MQTT broker URL")
+    .action(async (message, opts) => {
+    const name = opts.name || defaultName();
+    const client = AgentChatClient.fromSingle({ channel: opts.channel, name, key: opts.key, broker: opts.broker });
+    await client.connect();
+    await client.send(message);
+    console.log("Message sent.");
+    await client.disconnect();
+});
+program
+    .command("read")
+    .description("Read recent messages from a channel")
+    .requiredOption("--channel <name>", "Channel name")
+    .requiredOption("--key <key>", "Channel key (from agentchannel create)")
+    .option("--broker <url>", "Custom MQTT broker URL")
+    .option("-n, --limit <number>", "Number of messages to read", "20")
+    .action(async (opts) => {
+    const client = AgentChatClient.fromSingle({ channel: opts.channel, name: "__reader__", key: opts.key, broker: opts.broker });
+    await client.connect();
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+    const messages = client.store.getMessages(parseInt(opts.limit, 10));
+    if (messages.length === 0) {
+        console.log("No messages yet.");
+    }
+    else {
+        for (const msg of messages) {
+            const time = new Date(msg.timestamp).toLocaleTimeString();
+            console.log(`[${time}] #${msg.channel} | ${msg.sender}: ${msg.content}`);
+        }
+    }
+    await client.disconnect();
+});
+function notify(sender, content, channel) {
+    const truncated = content.length > 100 ? content.slice(0, 100) + "..." : content;
+    if (process.platform === "darwin") {
+        import("node:child_process").then(({ exec }) => {
+            const escaped = truncated.replace(/"/g, '\\"');
+            exec(`osascript -e 'display notification "${escaped}" with title "AgentChannel #${channel}: ${sender}"'`);
+        });
+    }
+}
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/crypto.d.ts

@@ -0,0 +1,5 @@
+import type { EncryptedPayload } from "./types.js";
+export declare function deriveKey(roomCode: string): Buffer;
+export declare function hashRoom(roomCode: string): string;
+export declare function encrypt(plaintext: string, key: Buffer): EncryptedPayload;
+export declare function decrypt(payload: EncryptedPayload, key: Buffer): string;

package/dist/crypto.js

@@ -0,0 +1,31 @@
+import { createHash, pbkdf2Sync, randomBytes, createCipheriv, createDecipheriv } from "node:crypto";
+const SALT = "agentchannel-v1";
+const ITERATIONS = 100_000;
+const KEY_LENGTH = 32;
+const IV_LENGTH = 12;
+export function deriveKey(roomCode) {
+    return pbkdf2Sync(roomCode, SALT, ITERATIONS, KEY_LENGTH, "sha256");
+}
+export function hashRoom(roomCode) {
+    return createHash("sha256").update(roomCode).digest("hex").slice(0, 16);
+}
+export function encrypt(plaintext, key) {
+    const iv = randomBytes(IV_LENGTH);
+    const cipher = createCipheriv("aes-256-gcm", key, iv);
+    const encrypted = Buffer.concat([cipher.update(plaintext, "utf8"), cipher.final()]);
+    const tag = cipher.getAuthTag();
+    return {
+        iv: iv.toString("base64"),
+        data: encrypted.toString("base64"),
+        tag: tag.toString("base64"),
+    };
+}
+export function decrypt(payload, key) {
+    const iv = Buffer.from(payload.iv, "base64");
+    const data = Buffer.from(payload.data, "base64");
+    const tag = Buffer.from(payload.tag, "base64");
+    const decipher = createDecipheriv("aes-256-gcm", key, iv);
+    decipher.setAuthTag(tag);
+    return Buffer.concat([decipher.update(data), decipher.final()]).toString("utf8");
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpG,MAAM,IAAI,GAAG,iBAAiB,CAAC;AAC/B,MAAM,UAAU,GAAG,OAAO,CAAC;AAC3B,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,SAAiB,EAAE,GAAW;IACpD,MAAM,EAAE,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACpF,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAChC,OAAO;QACL,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACzB,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAClC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAyB,EAAE,GAAW;IAC5D,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACnF,CAAC"}

package/dist/mqtt-client.d.ts

@@ -0,0 +1,23 @@
+import { MessageStore } from "./store.js";
+import type { ChatConfig, SingleChannelConfig, Message } from "./types.js";
+export declare class AgentChatClient {
+    private client;
+    private channels;
+    private name;
+    private broker;
+    readonly store: MessageStore;
+    private onMessage?;
+    constructor(config: ChatConfig);
+    static fromSingle(config: SingleChannelConfig): AgentChatClient;
+    get memberName(): string;
+    private msgTopic;
+    private presTopic;
+    connect(): Promise<void>;
+    private handleMessage;
+    private handlePresence;
+    private announcePresence;
+    send(content: string, channelName?: string): Promise<Message>;
+    setName(name: string): void;
+    setOnMessage(handler: (msg: Message) => void): void;
+    disconnect(): Promise<void>;
+}

package/dist/mqtt-client.js

@@ -0,0 +1,171 @@
+import mqtt from "mqtt";
+import { randomBytes } from "node:crypto";
+import { userInfo } from "node:os";
+import { deriveKey, hashRoom, encrypt, decrypt } from "./crypto.js";
+import { MessageStore } from "./store.js";
+const DEFAULT_BROKER = "mqtt://broker.emqx.io:1883";
+export class AgentChatClient {
+    client = null;
+    channels = new Map(); // hash -> ChannelState
+    name;
+    broker;
+    store;
+    onMessage;
+    constructor(config) {
+        this.name = config.name || userInfo().username;
+        this.broker = config.broker || DEFAULT_BROKER;
+        this.store = new MessageStore();
+        for (const ch of config.channels) {
+            const key = deriveKey(ch.key);
+            const hash = hashRoom(ch.key);
+            this.channels.set(hash, { channel: ch.channel, key, hash });
+        }
+    }
+    static fromSingle(config) {
+        return new AgentChatClient({
+            channels: [{ channel: config.channel, key: config.key }],
+            name: config.name,
+            broker: config.broker,
+        });
+    }
+    get memberName() {
+        return this.name;
+    }
+    msgTopic(hash) {
+        return `agentchannel/${hash}/messages`;
+    }
+    presTopic(hash) {
+        return `agentchannel/${hash}/presence`;
+    }
+    async connect() {
+        const clientId = `agentchannel_${randomBytes(4).toString("hex")}`;
+        const firstChannel = this.channels.values().next().value;
+        return new Promise((resolve, reject) => {
+            this.client = mqtt.connect(this.broker, {
+                clientId,
+                clean: true,
+                connectTimeout: 10_000,
+                reconnectPeriod: 3_000,
+                will: {
+                    topic: this.presTopic(firstChannel.hash),
+                    payload: Buffer.from(JSON.stringify({ name: this.name, status: "offline" })),
+                    qos: 1,
+                    retain: false,
+                },
+            });
+            this.client.on("connect", () => {
+                const topics = [];
+                for (const [hash] of this.channels) {
+                    topics.push(this.msgTopic(hash), this.presTopic(hash));
+                }
+                this.client.subscribe(topics, { qos: 1 });
+                for (const [hash] of this.channels) {
+                    this.announcePresence(hash, "online");
+                }
+                this.store.updateMember(this.name);
+                resolve();
+            });
+            this.client.on("message", (topic, payload) => {
+                for (const [hash, state] of this.channels) {
+                    if (topic === this.msgTopic(hash)) {
+                        this.handleMessage(state, payload);
+                        return;
+                    }
+                    if (topic === this.presTopic(hash)) {
+                        this.handlePresence(payload);
+                        return;
+                    }
+                }
+            });
+            this.client.on("error", (err) => {
+                reject(err);
+            });
+        });
+    }
+    handleMessage(state, payload) {
+        try {
+            const encrypted = JSON.parse(payload.toString());
+            const decrypted = decrypt(encrypted, state.key);
+            const msg = JSON.parse(decrypted);
+            msg.channel = state.channel;
+            this.store.addMessage(msg);
+            this.store.updateMember(msg.sender);
+            if (this.onMessage) {
+                this.onMessage(msg);
+            }
+        }
+        catch {
+            // Decryption failed — wrong key or corrupted message, ignore
+        }
+    }
+    handlePresence(payload) {
+        try {
+            const data = JSON.parse(payload.toString());
+            if (data.status === "online") {
+                this.store.updateMember(data.name);
+            }
+            else if (data.status === "offline") {
+                this.store.removeMember(data.name);
+            }
+        }
+        catch {
+            // Ignore malformed presence
+        }
+    }
+    announcePresence(hash, status) {
+        if (!this.client)
+            return;
+        this.client.publish(this.presTopic(hash), JSON.stringify({ name: this.name, status }), { qos: 1 });
+    }
+    async send(content, channelName) {
+        if (!this.client)
+            throw new Error("Not connected");
+        let target;
+        if (channelName) {
+            for (const state of this.channels.values()) {
+                if (state.channel === channelName) {
+                    target = state;
+                    break;
+                }
+            }
+            if (!target)
+                throw new Error(`Channel "${channelName}" not found`);
+        }
+        else {
+            target = this.channels.values().next().value;
+        }
+        const msg = {
+            id: randomBytes(8).toString("hex"),
+            channel: target.channel,
+            sender: this.name,
+            content,
+            timestamp: Date.now(),
+        };
+        const encrypted = encrypt(JSON.stringify(msg), target.key);
+        return new Promise((resolve, reject) => {
+            this.client.publish(this.msgTopic(target.hash), JSON.stringify(encrypted), { qos: 1 }, (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve(msg);
+            });
+        });
+    }
+    setName(name) {
+        this.name = name;
+    }
+    setOnMessage(handler) {
+        this.onMessage = handler;
+    }
+    async disconnect() {
+        if (!this.client)
+            return;
+        for (const [hash] of this.channels) {
+            this.announcePresence(hash, "offline");
+        }
+        return new Promise((resolve) => {
+            this.client.end(false, () => resolve());
+        });
+    }
+}
+//# sourceMappingURL=mqtt-client.js.map

package/dist/mqtt-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mqtt-client.js","sourceRoot":"","sources":["../src/mqtt-client.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import type { ChatConfig, SingleChannelConfig } from "./types.js";
+export declare function startServer(config: ChatConfig | SingleChannelConfig): Promise<void>;

package/dist/server.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { AgentChatClient } from "./mqtt-client.js";
+import { registerAllTools } from "./tools/index.js";
+export async function startServer(config) {
+    const mcpServer = new McpServer({
+        name: "agentchannel",
+        version: "0.1.0",
+    });
+    let chatClient;
+    if ("channels" in config) {
+        chatClient = new AgentChatClient(config);
+    }
+    else {
+        chatClient = AgentChatClient.fromSingle(config);
+    }
+    await chatClient.connect();
+    registerAllTools(mcpServer, () => chatClient);
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+    process.on("SIGINT", async () => {
+        await chatClient.disconnect();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        await chatClient.disconnect();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAwC;IACxE,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;QAC9B,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,IAAI,UAA2B,CAAC;IAChC,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;QACzB,UAAU,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;IAE3B,gBAAgB,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;IAE9C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEnC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,10 @@
+import type { Message, Member } from "./types.js";
+export declare class MessageStore {
+    private messages;
+    private members;
+    addMessage(msg: Message): void;
+    getMessages(limit?: number): Message[];
+    updateMember(name: string): void;
+    removeMember(name: string): void;
+    getMembers(): Member[];
+}

package/dist/store.js

@@ -0,0 +1,30 @@
+const MAX_MESSAGES = 100;
+export class MessageStore {
+    messages = [];
+    members = new Map();
+    addMessage(msg) {
+        this.messages.push(msg);
+        if (this.messages.length > MAX_MESSAGES) {
+            this.messages.shift();
+        }
+    }
+    getMessages(limit = 20) {
+        return this.messages.slice(-limit);
+    }
+    updateMember(name) {
+        const existing = this.members.get(name);
+        if (existing) {
+            existing.lastSeen = Date.now();
+        }
+        else {
+            this.members.set(name, { name, joinedAt: Date.now(), lastSeen: Date.now() });
+        }
+    }
+    removeMember(name) {
+        this.members.delete(name);
+    }
+    getMembers() {
+        return Array.from(this.members.values());
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,GAAG,CAAC;AAEzB,MAAM,OAAO,YAAY;IACf,QAAQ,GAAc,EAAE,CAAC;IACzB,OAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEjD,UAAU,CAAC,GAAY;QACrB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;YACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,WAAW,CAAC,QAAgB,EAAE;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AgentChatClient } from "../mqtt-client.js";
+export declare function registerAllTools(server: McpServer, getClient: () => AgentChatClient): void;

package/dist/tools/index.js

@@ -0,0 +1,11 @@
+import { registerSendTool } from "./send.js";
+import { registerReadTool } from "./read.js";
+import { registerMembersTool } from "./members.js";
+import { registerNameTool } from "./name.js";
+export function registerAllTools(server, getClient) {
+    registerSendTool(server, getClient);
+    registerReadTool(server, getClient);
+    registerMembersTool(server, getClient);
+    registerNameTool(server, getClient);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,SAAgC;IAClF,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACtC,CAAC"}

package/dist/tools/members.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AgentChatClient } from "../mqtt-client.js";
+export declare function registerMembersTool(server: McpServer, getClient: () => AgentChatClient): void;

package/dist/tools/members.js

@@ -0,0 +1,24 @@
+export function registerMembersTool(server, getClient) {
+    server.registerTool("list_members", {
+        title: "List Members",
+        description: "List online members in the chat room.",
+    }, async () => {
+        const client = getClient();
+        const members = client.store.getMembers();
+        if (members.length === 0) {
+            return {
+                content: [{ type: "text", text: "No members online." }],
+            };
+        }
+        const formatted = members
+            .map((m) => {
+            const joined = new Date(m.joinedAt).toLocaleTimeString();
+            return `- ${m.name} (joined ${joined})`;
+        })
+            .join("\n");
+        return {
+            content: [{ type: "text", text: `Online members:\n${formatted}` }],
+        };
+    });
+}
+//# sourceMappingURL=members.js.map

package/dist/tools/members.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.js","sourceRoot":"","sources":["../../src/tools/members.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,SAAgC;IACrF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,uCAAuC;KACrD,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QAE1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;aACjE,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,OAAO;aACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,kBAAkB,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC,CAAC,IAAI,YAAY,MAAM,GAAG,CAAC;QAC1C,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oBAAoB,SAAS,EAAE,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/name.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AgentChatClient } from "../mqtt-client.js";
+export declare function registerNameTool(server: McpServer, getClient: () => AgentChatClient): void;

package/dist/tools/name.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export function registerNameTool(server, getClient) {
+    server.registerTool("set_name", {
+        title: "Set Display Name",
+        description: "Change your display name in the chat.",
+        inputSchema: {
+            name: z.string().describe("New display name"),
+        },
+    }, async ({ name }) => {
+        const client = getClient();
+        client.setName(name);
+        return {
+            content: [{ type: "text", text: `Display name changed to "${name}"` }],
+        };
+    });
+}
+//# sourceMappingURL=name.js.map

package/dist/tools/name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.js","sourceRoot":"","sources":["../../src/tools/name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,SAAgC;IAClF,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,uCAAuC;QACpD,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;SAC9C;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,4BAA4B,IAAI,GAAG,EAAE,CAAC;SAChF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/read.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AgentChatClient } from "../mqtt-client.js";
+export declare function registerReadTool(server: McpServer, getClient: () => AgentChatClient): void;

package/dist/tools/read.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export function registerReadTool(server, getClient) {
+    server.registerTool("read_messages", {
+        title: "Read Messages",
+        description: "Read recent messages from channels.",
+        inputSchema: {
+            limit: z.number().optional().default(20).describe("Number of recent messages to return (default 20, max 100)"),
+            channel: z.string().optional().describe("Filter by channel name (optional, shows all channels if omitted)"),
+        },
+    }, async ({ limit, channel }) => {
+        const client = getClient();
+        let messages = client.store.getMessages(Math.min(limit, 100));
+        if (channel) {
+            messages = messages.filter((m) => m.channel === channel);
+        }
+        if (messages.length === 0) {
+            return {
+                content: [{ type: "text", text: "No messages yet." }],
+            };
+        }
+        const formatted = messages
+            .map((m) => {
+            const time = new Date(m.timestamp).toLocaleTimeString();
+            return `[${time}] #${m.channel} | ${m.sender}: ${m.content}`;
+        })
+            .join("\n");
+        return {
+            content: [{ type: "text", text: formatted }],
+        };
+    });
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,SAAgC;IAClF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,qCAAqC;QAClD,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2DAA2D,CAAC;YAC9G,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;SAC5G;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,IAAI,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAE9D,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;aAC/D,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ;aACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,EAAE,CAAC;YACxD,OAAO,IAAI,IAAI,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/D,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;SACtD,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/send.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AgentChatClient } from "../mqtt-client.js";
+export declare function registerSendTool(server: McpServer, getClient: () => AgentChatClient): void;

package/dist/tools/send.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export function registerSendTool(server, getClient) {
+    server.registerTool("send_message", {
+        title: "Send Message",
+        description: "Send an encrypted message to a channel. All members with the same channel key will receive it.",
+        inputSchema: {
+            message: z.string().describe("The message content to send"),
+            channel: z.string().optional().describe("Target channel name (optional if only in one channel)"),
+        },
+    }, async ({ message, channel }) => {
+        const client = getClient();
+        const msg = await client.send(message, channel);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Message sent to #${msg.channel} by ${msg.sender} at ${new Date(msg.timestamp).toISOString()}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=send.js.map

package/dist/tools/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/tools/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,SAAgC;IAClF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,gGAAgG;QAC7G,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;SACjG;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,oBAAoB,GAAG,CAAC,OAAO,OAAO,GAAG,CAAC,MAAM,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE;iBACrG;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+export interface Message {
+    id: string;
+    channel: string;
+    sender: string;
+    content: string;
+    timestamp: number;
+}
+export interface Member {
+    name: string;
+    joinedAt: number;
+    lastSeen: number;
+}
+export interface ChannelConfig {
+    channel: string;
+    key: string;
+}
+export interface ChatConfig {
+    channels: ChannelConfig[];
+    name: string;
+    broker?: string;
+}
+export interface SingleChannelConfig {
+    channel: string;
+    name: string;
+    key: string;
+    broker?: string;
+}
+export interface EncryptedPayload {
+    iv: string;
+    data: string;
+    tag: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "agentchannel",
+  "version": "0.1.0",
+  "description": "Encrypted cross-network messaging for AI coding agents via MCP",
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "agentchannel": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "ai",
+    "agent",
+    "chat",
+    "mqtt",
+    "claude",
+    "cursor",
+    "windsurf",
+    "encrypted",
+    "collaboration"
+  ],
+  "author": "haoagent",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^14.0.3",
+    "mqtt": "^5.15.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  }
+}