@tjamescouch/agentchat 0.2.0 → 0.3.0

package/README.md

@@ -40,6 +40,9 @@ agentchat serve --port 8080 --host 127.0.0.1
 
 # With message logging (for debugging)
 agentchat serve --log-messages
+
+# Custom message buffer size (replayed to new joiners, default: 20)
+agentchat serve --buffer-size 50
 ```
 
 ### Client
@@ -151,6 +154,12 @@ Messages received via `listen` are JSON lines:
 {"type":"AGENT_LEFT","channel":"#general","agent":"@abc123","ts":1706889602000}
 ```
 
+**Message history replay:** When you join a channel, you receive the last N messages (default 20) with `"replay": true` so you can distinguish history from live messages:
+
+```json
+{"type":"MSG","from":"@abc123","to":"#general","content":"Earlier message","ts":1706889500000,"replay":true}
+```
+
 ## Protocol
 
 AgentChat uses WebSocket with JSON messages.

package/bin/agentchat.js

@@ -43,6 +43,7 @@ program
   .option('--log-messages', 'Log all messages (for debugging)')
   .option('--cert <file>', 'TLS certificate file (PEM format)')
   .option('--key <file>', 'TLS private key file (PEM format)')
+  .option('--buffer-size <n>', 'Message buffer size per channel for replay on join', '20')
   .action((options) => {
     // Validate TLS options (both or neither)
     if ((options.cert && !options.key) || (!options.cert && options.key)) {
@@ -56,7 +57,8 @@ program
       name: options.name,
       logMessages: options.logMessages,
       cert: options.cert,
-      key: options.key
+      key: options.key,
+      messageBufferSize: parseInt(options.bufferSize)
     });
   });
 

package/lib/server.js

@@ -38,6 +38,9 @@ export class AgentChatServer {
     // Rate limiting: 1 message per second per agent
     this.rateLimitMs = options.rateLimitMs || 1000;
 
+    // Message buffer size per channel (for replay on join)
+    this.messageBufferSize = options.messageBufferSize || 20;
+
     // State
     this.agents = new Map();      // ws -> agent info
     this.agentById = new Map();   // id -> ws
@@ -62,11 +65,40 @@ export class AgentChatServer {
         name,
         inviteOnly,
         invited: new Set(),
-        agents: new Set()
+        agents: new Set(),
+        messageBuffer: []  // Rolling buffer of recent messages
       });
     }
     return this.channels.get(name);
   }
+
+  /**
+   * Add a message to a channel's buffer (circular buffer)
+   */
+  _bufferMessage(channel, msg) {
+    const ch = this.channels.get(channel);
+    if (!ch) return;
+
+    ch.messageBuffer.push(msg);
+
+    // Trim to buffer size
+    if (ch.messageBuffer.length > this.messageBufferSize) {
+      ch.messageBuffer.shift();
+    }
+  }
+
+  /**
+   * Replay buffered messages to a newly joined agent
+   */
+  _replayMessages(ws, channel) {
+    const ch = this.channels.get(channel);
+    if (!ch || ch.messageBuffer.length === 0) return;
+
+    for (const msg of ch.messageBuffer) {
+      // Send with replay flag so client knows it's history
+      this._send(ws, { ...msg, replay: true });
+    }
+  }
   
   _log(event, data = {}) {
     const entry = {
@@ -310,8 +342,11 @@ export class AgentChatServer {
       channel: msg.channel,
       agents: agentList
     }));
+
+    // Replay recent messages to the joining agent
+    this._replayMessages(ws, msg.channel);
   }
-  
+
   _handleLeave(ws, msg) {
     const agent = this.agents.get(ws);
     if (!agent) {
@@ -376,7 +411,10 @@ export class AgentChatServer {
       
       // Broadcast to channel including sender
       this._broadcast(msg.to, outMsg);
-      
+
+      // Buffer the message for replay to future joiners
+      this._bufferMessage(msg.to, outMsg);
+
     } else if (isAgent(msg.to)) {
       // Direct message
       const targetId = msg.to.slice(1); // remove @
@@ -744,7 +782,8 @@ export function startServer(options = {}) {
     logMessages: options.logMessages || process.env.LOG_MESSAGES === 'true',
     cert: options.cert || process.env.TLS_CERT || null,
     key: options.key || process.env.TLS_KEY || null,
-    rateLimitMs: options.rateLimitMs || parseInt(process.env.RATE_LIMIT_MS || 1000)
+    rateLimitMs: options.rateLimitMs || parseInt(process.env.RATE_LIMIT_MS || 1000),
+    messageBufferSize: options.messageBufferSize || parseInt(process.env.MESSAGE_BUFFER_SIZE || 20)
   };
 
   const server = new AgentChatServer(config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tjamescouch/agentchat",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Real-time IRC-like communication protocol for AI agents",
   "main": "lib/client.js",
   "files": [