@teneo-protocol/sdk 1.0.1 → 2.0.0

package/examples/agent-room-management-example.ts

@@ -0,0 +1,334 @@
+/**
+ * Agent Room Management Example
+ *
+ * Demonstrates how to customize which agents are available in each room using Teneo SDK v2.0.
+ *
+ * This example shows:
+ * - Listing available agents for a room
+ * - Adding specific agents to your room
+ * - Listing agents currently in a room
+ * - Removing agents from a room
+ * - Using cache for performance
+ * - Real-time agent status updates
+ *
+ * Prerequisites:
+ * - Set TENEO_WS_URL environment variable
+ * - Set PRIVATE_KEY environment variable (64 hex characters, no 0x prefix)
+ * - Have at least one owned room
+ *
+ * Run:
+ *   npx ts-node examples/agent-room-management-example.ts
+ */
+
+import { TeneoSDK } from "../src";
+import * as dotenv from "dotenv";
+
+dotenv.config();
+
+const wsUrl = process.env.TENEO_WS_URL!;
+const privateKey = process.env.PRIVATE_KEY!;
+
+async function main() {
+  console.log("🚀 Teneo SDK v2.0 - Agent Room Management Example\n");
+
+  // Initialize SDK
+  const sdk = new TeneoSDK({
+    wsUrl,
+    privateKey,
+    logLevel: "info",
+    reconnect: true
+  });
+
+  // Set up event listeners
+  setupEventListeners(sdk);
+
+  try {
+    // Connect and authenticate
+    console.log("📡 Connecting to Teneo network...");
+    await sdk.connect();
+    console.log("✅ Connected and authenticated\n");
+
+    // Wait for initial data to load
+    await new Promise(resolve => setTimeout(resolve, 1000));
+
+    // Step 1: Get or create a test room
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("🏠 Setting Up Test Room");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    const testRoom = await getOrCreateTestRoom(sdk);
+
+    if (!testRoom) {
+      console.log("❌ Could not get or create a test room");
+      return;
+    }
+
+    console.log(`Using room: "${testRoom.name}" (${testRoom.id})\n`);
+
+    // Step 2: List current agents in the room
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("📋 Current Agents in Room");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    const currentAgents = await sdk.listRoomAgents(testRoom.id, false); // Force fresh data
+    displayAgents(currentAgents, "room");
+
+    // Step 3: List available agents (not yet in room)
+    console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("🆕 Available Agents (Not in Room)");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    const availableAgents = await sdk.listAvailableAgents(testRoom.id, false);
+    displayAgents(availableAgents, "available");
+
+    // Step 4: Add agents to the room
+    if (availableAgents.length > 0) {
+      console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+      console.log("➕ Adding Agents to Room");
+      console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+      await addAgentsToRoom(sdk, testRoom.id, availableAgents);
+
+      // Wait for additions to process
+      await new Promise(resolve => setTimeout(resolve, 500));
+    }
+
+    // Step 5: List updated room agents (using cache this time)
+    console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("📋 Updated Room Agents (from cache)");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    const updatedAgents = await sdk.listRoomAgents(testRoom.id, true); // Use cache
+    displayAgents(updatedAgents, "room");
+
+    // Step 6: Demonstrate synchronous query methods
+    console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("⚡ Instant Cache Queries (No Network Call)");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    demonstrateCacheQueries(sdk, testRoom.id, updatedAgents);
+
+    // Step 7: Remove agents from the room
+    if (updatedAgents.length > 0) {
+      console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+      console.log("➖ Removing Agents from Room");
+      console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+      await removeAgentsFromRoom(sdk, testRoom.id, updatedAgents);
+
+      // Wait for removals to process
+      await new Promise(resolve => setTimeout(resolve, 500));
+    }
+
+    // Step 8: Final room status
+    console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("📊 Final Room Status");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    const finalAgents = await sdk.listRoomAgents(testRoom.id, false);
+    displayAgents(finalAgents, "room");
+
+    // Step 9: Demonstrate cache invalidation
+    console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("🔄 Cache Management");
+    console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+    console.log("Cache is automatically invalidated when:");
+    console.log("  ✓ You add an agent to the room");
+    console.log("  ✓ You remove an agent from the room");
+    console.log("  ✓ An agent's status changes");
+    console.log("  ✓ Cache TTL expires (5 minutes)");
+    console.log("\nManual cache invalidation:");
+    sdk.invalidateAgentRoomCache(testRoom.id);
+    console.log(`  ✅ Cache cleared for room ${testRoom.id}`);
+
+    console.log("\n✅ Agent room management example completed!");
+
+  } catch (error: any) {
+    console.error("\n❌ Error:", error.message);
+    console.error(error.stack);
+  } finally {
+    // Disconnect
+    console.log("\n👋 Disconnecting...");
+    sdk.disconnect();
+    console.log("✅ Disconnected");
+  }
+}
+
+function setupEventListeners(sdk: TeneoSDK) {
+  // Agent added
+  sdk.on("agent_room:agent_added", (roomId, agentId) => {
+    console.log(`  ✅ Agent ${agentId} added to room ${roomId}`);
+  });
+
+  // Agent removed
+  sdk.on("agent_room:agent_removed", (roomId, agentId) => {
+    console.log(`  ✅ Agent ${agentId} removed from room ${roomId}`);
+  });
+
+  // Agents listed
+  sdk.on("agent_room:agents_listed", (roomId, agents) => {
+    console.log(`  📋 Listed ${agents.length} agents in room ${roomId}`);
+  });
+
+  // Available agents listed
+  sdk.on("agent_room:available_agents_listed", (agents) => {
+    console.log(`  📋 Listed ${agents.length} available agents`);
+  });
+
+  // Status updates (real-time)
+  sdk.on("agent_room:status_update", (data) => {
+    console.log(`  🔄 Agent ${data.agentId} status updated in room ${data.roomId}`);
+    console.log(`     New status: ${data.status}`);
+  });
+
+  // Error events
+  sdk.on("agent_room:add_error", (error, roomId) => {
+    console.error(`  ❌ Failed to add agent to room ${roomId}: ${error.message}`);
+  });
+
+  sdk.on("agent_room:remove_error", (error, roomId) => {
+    console.error(`  ❌ Failed to remove agent from room ${roomId}: ${error.message}`);
+  });
+
+  sdk.on("agent_room:list_error", (error, roomId) => {
+    console.error(`  ❌ Failed to list agents in room ${roomId}: ${error.message}`);
+  });
+}
+
+async function getOrCreateTestRoom(sdk: TeneoSDK) {
+  // Try to get an existing owned room
+  const ownedRooms = sdk.getOwnedRooms();
+
+  if (ownedRooms.length > 0) {
+    console.log(`Found ${ownedRooms.length} existing owned room(s)`);
+    console.log(`Using first room: "${ownedRooms[0].name}"`);
+    return ownedRooms[0];
+  }
+
+  // Create a new test room
+  console.log("No owned rooms found. Creating test room...");
+
+  if (!sdk.canCreateRoom()) {
+    console.log("⚠️  Cannot create room - limit reached");
+    console.log(`   Current: ${sdk.getOwnedRoomCount()}/${sdk.getRoomLimit()}`);
+    return null;
+  }
+
+  try {
+    const room = await sdk.createRoom({
+      name: "Agent Test Room",
+      description: "Room for testing agent customization (SDK v2.0 example)"
+    });
+    console.log(`✅ Created test room: ${room.id}`);
+    return room;
+  } catch (error: any) {
+    console.error(`Failed to create test room: ${error.message}`);
+    return null;
+  }
+}
+
+function displayAgents(agents: any[], type: "room" | "available") {
+  if (agents.length === 0) {
+    console.log(`  (No ${type === "room" ? "agents in room" : "available agents"})`);
+    return;
+  }
+
+  console.log(`Found ${agents.length} agent(s):\n`);
+
+  agents.forEach((agent, i) => {
+    console.log(`${i + 1}. ${agent.agent_name || "Unnamed Agent"}`);
+    console.log(`   ID: ${agent.agent_id}`);
+
+    if (agent.description) {
+      console.log(`   Description: ${agent.description}`);
+    }
+
+    if (agent.status) {
+      console.log(`   Status: ${agent.status}`);
+    }
+
+    if (agent.capabilities && agent.capabilities.length > 0) {
+      const capNames = agent.capabilities.map((c: any) => c.name).join(", ");
+      console.log(`   Capabilities: ${capNames}`);
+    }
+
+    if (agent.commands && agent.commands.length > 0) {
+      const cmdTriggers = agent.commands.map((c: any) => `/${c.trigger}`).join(", ");
+      console.log(`   Commands: ${cmdTriggers}`);
+    }
+
+    if (agent.image) {
+      console.log(`   Image: ${agent.image.substring(0, 50)}...`);
+    }
+
+    if (agent.added_at) {
+      console.log(`   Added at: ${agent.added_at}`);
+    }
+
+    if (agent.added_by) {
+      console.log(`   Added by: ${agent.added_by}`);
+    }
+
+    console.log();
+  });
+}
+
+async function addAgentsToRoom(sdk: TeneoSDK, roomId: string, availableAgents: any[]) {
+  // Add up to 2 agents from the available list
+  const agentsToAdd = availableAgents.slice(0, 2);
+
+  console.log(`Adding ${agentsToAdd.length} agent(s) to the room...\n`);
+
+  for (const agent of agentsToAdd) {
+    try {
+      console.log(`Adding "${agent.agent_name}" (${agent.agent_id})...`);
+      await sdk.addAgentToRoom(roomId, agent.agent_id);
+      // Wait a bit between additions
+      await new Promise(resolve => setTimeout(resolve, 300));
+    } catch (error: any) {
+      console.error(`Failed to add agent ${agent.agent_id}: ${error.message}`);
+    }
+  }
+}
+
+async function removeAgentsFromRoom(sdk: TeneoSDK, roomId: string, roomAgents: any[]) {
+  // Remove up to 2 agents
+  const agentsToRemove = roomAgents.slice(0, 2);
+
+  console.log(`Removing ${agentsToRemove.length} agent(s) from the room...\n`);
+
+  for (const agent of agentsToRemove) {
+    try {
+      console.log(`Removing "${agent.agent_name}" (${agent.agent_id})...`);
+      await sdk.removeAgentFromRoom(roomId, agent.agent_id);
+      // Wait a bit between removals
+      await new Promise(resolve => setTimeout(resolve, 300));
+    } catch (error: any) {
+      console.error(`Failed to remove agent ${agent.agent_id}: ${error.message}`);
+    }
+  }
+}
+
+function demonstrateCacheQueries(sdk: TeneoSDK, roomId: string, agents: any[]) {
+  // Get agent count (instant, from cache)
+  const count = sdk.getRoomAgentCount(roomId);
+  console.log(`Room agent count: ${count}`);
+
+  // Get cached agents (instant)
+  const cachedAgents = sdk.getRoomAgents(roomId);
+  if (cachedAgents) {
+    const names = cachedAgents.map(a => a.agent_name || "Unnamed").join(", ");
+    console.log(`Cached agents: ${names}`);
+  }
+
+  // Check if specific agent is in room (instant)
+  if (agents.length > 0) {
+    const firstAgent = agents[0];
+    const isInRoom = sdk.isAgentInRoom(roomId, firstAgent.agent_id);
+    console.log(`Is "${firstAgent.agent_name}" in room? ${isInRoom === true ? "✅ Yes" : isInRoom === false ? "❌ No" : "❓ Unknown (no cache)"}`);
+  }
+
+  // Get cached available agents (instant)
+  const cachedAvailable = sdk.getAvailableAgents(roomId);
+  if (cachedAvailable) {
+    console.log(`Cached available agents: ${cachedAvailable.length}`);
+  }
+
+  console.log("\n💡 These queries are instant - no network calls!");
+  console.log("   Cache is automatically maintained and invalidated as needed.");
+}
+
+// Run the example
+main().catch(console.error);

package/examples/claude-agent-x-follower/.env.example

@@ -7,8 +7,8 @@
 
 # WebSocket URL for Teneo AI Network
 # Production: wss://your-production-server.com/ws
-# Development: wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+# Development: wss://your-teneo-server.com/ws
+WS_URL=wss://your-teneo-server.com/ws
 
 # Ethereum Private Key (with 0x prefix)
 # IMPORTANT: Never commit your actual private key to version control!

package/examples/claude-agent-x-follower/QUICKSTART.md

@@ -27,7 +27,7 @@ Edit `.env` with your credentials:
 
 ```env
 # Required: Teneo Network Connection
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+WS_URL=wss://your-teneo-server.com/ws
 PRIVATE_KEY=0x1234567890123456789012345678901234567890123456789012345678901234
 WALLET_ADDRESS=0x1234567890123456789012345678901234567890  # Optional - auto-derived
 

package/examples/claude-agent-x-follower/README.md

@@ -70,7 +70,7 @@ cp examples/claude-agent-x-follower/.env.example examples/claude-agent-x-followe
 
 ```env
 # Teneo Network Connection
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+WS_URL=wss://your-teneo-server.com/ws
 PRIVATE_KEY=0x1234567890123456789012345678901234567890123456789012345678901234
 WALLET_ADDRESS=0x1234567890123456789012345678901234567890  # Optional - auto-derived from private key
 

package/examples/n8n-teneo/.env.example

@@ -7,8 +7,8 @@
 
 # WebSocket URL for Teneo AI Network
 # Production: wss://your-production-server.com/ws
-# Development: wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+# Development: wss://your-teneo-server.com/ws
+WS_URL=wss://your-teneo-server.com/ws
 
 # Ethereum Private Key (with 0x prefix)
 # IMPORTANT: Never commit your actual private key to version control!

package/examples/n8n-teneo/README.md

@@ -76,7 +76,7 @@ cp .env.example .env
 nano .env  # or your preferred editor
 
 # Required:
-#   WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+#   WS_URL=wss://your-teneo-server.com/ws
 #   PRIVATE_KEY=0x...
 #   WALLET_ADDRESS=0x... (optional - auto-derived from private key)
 #   DEFAULT_ROOM=general (or x-agent-enterprise-v2 for X features)

package/examples/openai-teneo/.env.example

@@ -18,8 +18,8 @@ OPENAI_MODEL=gpt-4-turbo-preview
 
 # WebSocket URL for Teneo AI Network
 # Production: wss://your-production-server.com/ws
-# Development: wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+# Development: wss://your-teneo-server.com/ws
+WS_URL=wss://your-teneo-server.com/ws
 
 # Ethereum Private Key (with 0x prefix)
 # IMPORTANT: Never commit your actual private key to version control!

package/examples/openai-teneo/README.md

@@ -66,7 +66,7 @@ cp examples/openai-teneo/.env.example examples/openai-teneo/.env
 OPENAI_API_KEY=sk-proj-your-openai-api-key-here
 
 # Teneo Network Connection
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+WS_URL=wss://your-teneo-server.com/ws
 PRIVATE_KEY=0x1234567890123456789012345678901234567890123456789012345678901234
 WALLET_ADDRESS=0x1234567890123456789012345678901234567890  # Optional - auto-derived from private key
 

package/examples/production-dashboard/.env.example

@@ -7,8 +7,8 @@
 
 # WebSocket URL for Teneo AI Network
 # Production: wss://your-production-server.com/ws
-# Development: wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+# Development: wss://your-teneo-server.com/ws
+WS_URL=wss://your-teneo-server.com/ws
 
 # Ethereum Private Key (with 0x prefix)
 # IMPORTANT: Never commit your actual private key to version control!

package/examples/production-dashboard/README.md

@@ -11,7 +11,9 @@ This is the **ultimate reference implementation** showcasing every SDK capabilit
 ✅ **WebSocket Connection** - Auto-reconnection with exponential backoff
 ✅ **Ethereum Authentication** - Wallet-based authentication
 ✅ **Message Sending** - Coordinator-based and direct agent commands
-✅ **Room Management** - Subscribe, unsubscribe, and list rooms
+✅ **Room Management (v1)** - Subscribe, unsubscribe, and list rooms
+✅ **Room Management (v2.0)** - Create, update, delete rooms with ownership tracking
+✅ **Agent-Room Management (v2.0)** - Add/remove agents per room, list room agents
 ✅ **Agent Discovery** - List agents with capabilities
 ✅ **Response Formatting** - Raw JSON, humanized text, or both
 
@@ -29,6 +31,17 @@ This is the **ultimate reference implementation** showcasing every SDK capabilit
 ✅ **Error Handling** - Custom error classes with recovery strategies
 ✅ **Event System** - Complete event-driven architecture
 
+### v2.0 Features (New!)
+
+✅ **Multi-Room Management** - Create, update, and delete your own rooms
+✅ **Room Ownership Tracking** - Distinguish between owned and shared rooms
+✅ **Room Limits** - Track and display room creation quotas
+✅ **Agent-Room Customization** - Add/remove agents per room (owner only)
+✅ **Room Agent Listing** - List agents in specific rooms with caching
+✅ **Available Agents** - See which agents can be added to a room
+✅ **Real-time Room Events** - Live updates for room creation/updates/deletions
+✅ **Real-time Agent-Room Events** - Live updates when agents are added/removed
+
 ### Production Features
 
 ✅ **Health Check Endpoint** - `/health` for Kubernetes/Docker monitoring
@@ -205,15 +218,46 @@ const config = new SDKConfigBuilder()
 - `GET /api/agents/search/capability/:capability` - **PERF-3**: Search by capability (O(1))
 - `GET /api/agents/search/name/:name` - **PERF-3**: Search by name (O(k))
 - `GET /api/agents/search/status/:status` - **PERF-3**: Search by status (O(1))
-- `GET /api/rooms` - List all available rooms
+- `GET /api/rooms` - List all available rooms (v1)
 - `GET /api/deduplication` - **CB-4**: Get message deduplication status
-- `POST /api/room/subscribe` - Subscribe to a room
+- `POST /api/room/subscribe` - Subscribe to a room (v1)
   ```json
   {
     "roomId": "tech-support"
   }
   ```
-- `POST /api/room/unsubscribe` - Unsubscribe from a room
+- `POST /api/room/unsubscribe` - Unsubscribe from a room (v1)
+
+### Room Management v2.0 API
+
+- `GET /api/v2/rooms/owned` - Get all rooms you own
+- `GET /api/v2/rooms/shared` - Get all rooms you're a member of
+- `GET /api/v2/rooms/limit` - Get your room creation limit
+- `POST /api/v2/rooms` - Create a new room
+  ```json
+  {
+    "name": "My Room",
+    "description": "Optional description"
+  }
+  ```
+- `PUT /api/v2/rooms/:id` - Update room (owner only)
+  ```json
+  {
+    "name": "Updated Name",
+    "description": "New description"
+  }
+  ```
+- `DELETE /api/v2/rooms/:id` - Delete room (owner only)
+
+### Agent-Room Management v2.0 API
+
+- `GET /api/v2/rooms/:id/agents` - List agents in room (with 5-min cache)
+- `GET /api/v2/rooms/:id/available-agents` - List agents available to add
+- `GET /api/v2/rooms/:id/agents/count` - Get agent count (instant, from cache)
+- `GET /api/v2/rooms/:roomId/agents/:agentId/check` - Check if agent is in room
+- `POST /api/v2/rooms/:roomId/agents/:agentId` - Add agent to room (owner only)
+- `DELETE /api/v2/rooms/:roomId/agents/:agentId` - Remove agent from room (owner only)
+- `POST /api/v2/rooms/:id/cache/invalidate` - Manually invalidate agent-room cache
 
 ### Real-time Data
 
@@ -240,10 +284,12 @@ const config = new SDKConfigBuilder()
 ### Tabs
 
 1. **Agents Tab**: List all agents with capabilities and status
-2. **Rooms Tab**: Manage room subscriptions (subscribe/unsubscribe)
-3. **Messages Tab**: View message history with responses
-4. **Webhooks Tab**: Monitor received webhooks
-5. **Events Tab**: Real-time event stream
+2. **Rooms Tab**: Manage room subscriptions (subscribe/unsubscribe) - v1
+3. **Room Mgmt Tab** 🆕: Create, update, delete rooms - View owned/shared rooms with room limits (v2.0)
+4. **Agent-Room Tab** 🆕: Add/remove agents to rooms - List room agents and available agents (v2.0)
+5. **Messages Tab**: View message history with responses
+6. **Webhooks Tab**: Monitor received webhooks
+7. **Events Tab**: Real-time event stream (includes v2.0 room and agent-room events)
 
 ### Health Monitor
 
@@ -265,18 +311,18 @@ import { SecurePrivateKey } from "@teneo-protocol/sdk";
 const secureKey = new SecurePrivateKey(process.env.PRIVATE_KEY);
 
 // Use with SDK - automatically decrypted when needed
-const config = new SDKConfigBuilder()
-  .withAuthentication(secureKey, WALLET_ADDRESS)
-  .build();
+const config = new SDKConfigBuilder().withAuthentication(secureKey, WALLET_ADDRESS).build();
 ```
 
 **Security Benefits:**
+
 - Private key is encrypted in memory using AES-256-GCM
 - Protected from memory dumps and debugging tools
 - Automatic secure cleanup when no longer needed
 - Minimal performance overhead
 
 **Example Test:**
+
 ```bash
 # Without encryption: private key visible in memory dump
 # With encryption: only encrypted bytes visible
@@ -298,17 +344,20 @@ Prevent duplicate message processing using a TTL-based cache:
 ```
 
 **How It Works:**
+
 - Maintains an in-memory cache of processed message IDs
 - Automatically expires entries after TTL (Time To Live)
 - Bounded size prevents unbounded memory growth
 - Messages without IDs are allowed through (graceful degradation)
 
 **Configuration Options:**
+
 - `enabled`: Enable/disable deduplication (default: true)
 - `ttl`: How long to remember message IDs in milliseconds (default: 60000ms = 1 minute)
 - `maxSize`: Maximum number of message IDs to cache (default: 10000)
 
 **Monitoring:**
+
 ```bash
 # Check deduplication status
 curl http://localhost:3000/api/deduplication
@@ -324,15 +373,18 @@ curl http://localhost:3000/api/deduplication
 ```
 
 **Events:**
+
 - `message:duplicate` - Emitted when a duplicate message is detected and skipped
 
 **Testing:**
+
 1. Send the same message multiple times rapidly
 2. Watch Events tab for `message:duplicate` events
 3. Verify duplicates are not processed
 4. Monitor `/api/deduplication` to see cache size increase
 
 **Production Benefits:**
+
 - Prevents duplicate task execution if messages are retransmitted
 - Protects against network-level duplicates during reconnections
 - Configurable TTL balances memory usage vs duplicate window
@@ -354,11 +406,13 @@ curl http://localhost:3000/api/agents/search/status/online
 ```
 
 **Performance Comparison:**
+
 - Traditional: O(n) - iterate through all agents
 - Indexed: O(1) - direct map lookup for capability/status
 - Indexed: O(k) - token-based search for names (k = tokens)
 
 **SDK Usage:**
+
 ```typescript
 // Fast capability search
 const weatherAgents = sdk.findAgentsByCapability("weather-forecast");
@@ -524,7 +578,7 @@ Monitor rate limit status via `/metrics` endpoint.
 - Watch Webhooks tab for incoming webhook events
 - See event types: `task`, `agent_selected`, `task_response`
 
-### 5. Test Room Management
+### 5. Test Room Management (v1)
 
 - Go to Rooms tab
 - Enter a room ID
@@ -532,6 +586,29 @@ Monitor rate limit status via `/metrics` endpoint.
 - See room appear in subscribed list
 - Click "Unsubscribe" to unsubscribe from room
 
+### 5b. Test Room Management v2.0
+
+- Go to **Room Mgmt** tab
+- See your owned and shared rooms
+- Check your room limit (e.g., "2/50 rooms")
+- **Create a room**: Enter name and description, click "Create Room"
+- See room appear in "Private Rooms" list with owner badge
+- **Update room**: Click "Update" on an owned room, modify name/description
+- **Delete room**: Click "Delete" on an owned room
+- Watch Events tab for `room:created`, `room:updated`, `room:deleted` events
+
+### 5c. Test Agent-Room Management v2.0
+
+- Go to **Agent-Room** tab
+- Select a room you own from the dropdown
+- See "Agents in Room" list (may be empty for new rooms)
+- See "Available Agents" list (agents you can add)
+- **Add an agent**: Click "Add" next to an available agent
+- Watch agent move from "Available" to "Agents in Room"
+- See agent count update in real-time
+- **Remove an agent**: Click "Remove" next to an agent in room
+- Watch Events tab for `agent_room:agent_added`, `agent_room:agent_removed` events
+
 ### 6. Test Signature Verification
 
 - Enable in `.env`: `ENABLE_SIGNATURE_VERIFICATION=true`