@teneo-protocol/sdk 1.0.1 → 2.2.0

package/examples/usage/.env.example

@@ -1,8 +1,8 @@
 # Teneo SDK Examples - Environment Configuration
 # Copy this file to .env and fill in your actual values
 
-# Required: WebSocket URL for Teneo network
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+# Required: WebSocket URL for Teneo Protocol
+WS_URL=wss://your-teneo-server.com/ws
 
 # Required: Your Ethereum private key (keep this secret!)
 PRIVATE_KEY=your-private-key-here

package/examples/usage/01-connect.ts

@@ -14,8 +14,7 @@ import "dotenv/config";
 import { TeneoSDK, SDKConfigBuilder } from "../../dist/index.js";
 
 // Load configuration from environment
-const WS_URL =
-  process.env.WS_URL || "wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws";
+const WS_URL = process.env.WS_URL || "wss://your-teneo-server.com/ws";
 const PRIVATE_KEY = process.env.PRIVATE_KEY || "";
 const DEFAULT_ROOM = process.env.DEFAULT_ROOM || "general";
 
@@ -80,8 +79,8 @@ async function main() {
   console.log("✅ Event listeners configured\n");
 
   try {
-    // Step 4: Connect to Teneo network
-    console.log("⚙️  Step 4: Connecting to Teneo network...");
+    // Step 4: Connect to Teneo Protocol
+    console.log("⚙️  Step 4: Connecting to Teneo Protocol...");
     await sdk.connect();
     console.log("✅ Connected and authenticated!\n");
 

package/examples/usage/02-list-agents.ts

@@ -14,8 +14,7 @@ import "dotenv/config";
 import { TeneoSDK, SDKConfigBuilder } from "../../dist/index.js";
 
 // Load configuration from environment
-const WS_URL =
-  process.env.WS_URL || "wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws";
+const WS_URL = process.env.WS_URL || "wss://your-teneo-server.com/ws";
 const PRIVATE_KEY = process.env.PRIVATE_KEY || "";
 const DEFAULT_ROOM = process.env.DEFAULT_ROOM || "general";
 
@@ -44,7 +43,7 @@ async function main() {
 
   try {
     // Connect to Teneo
-    console.log("🔌 Connecting to Teneo network...");
+    console.log("🔌 Connecting to Teneo Protocol...");
     await sdk.connect();
     console.log("✅ Connected!\n");
 

package/examples/usage/03-pick-agent.ts

@@ -15,8 +15,7 @@ import "dotenv/config";
 import { TeneoSDK, SDKConfigBuilder, FormattedResponse } from "../../dist/index.js";
 
 // Load configuration from environment
-const WS_URL =
-  process.env.WS_URL || "wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws";
+const WS_URL = process.env.WS_URL || "wss://your-teneo-server.com/ws";
 const PRIVATE_KEY = process.env.PRIVATE_KEY || "";
 const DEFAULT_ROOM = process.env.DEFAULT_ROOM || "general";
 
@@ -52,7 +51,7 @@ async function main() {
 
   try {
     // Connect
-    console.log("🔌 Connecting to Teneo network...");
+    console.log("🔌 Connecting to Teneo Protocol...");
     await sdk.connect();
     console.log("✅ Connected!\n");
 

package/examples/usage/04-find-by-capability.ts

@@ -15,8 +15,7 @@ import "dotenv/config";
 import { TeneoSDK, SDKConfigBuilder } from "../../dist/index.js";
 
 // Load configuration from environment
-const WS_URL =
-  process.env.WS_URL || "wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws";
+const WS_URL = process.env.WS_URL || "wss://your-teneo-server.com/ws";
 const PRIVATE_KEY = process.env.PRIVATE_KEY || "";
 const DEFAULT_ROOM = process.env.DEFAULT_ROOM || "general";
 
@@ -40,7 +39,7 @@ async function main() {
 
   try {
     // Connect
-    console.log("🔌 Connecting to Teneo network...");
+    console.log("🔌 Connecting to Teneo Protocol...");
     await sdk.connect();
     console.log("✅ Connected!\n");
 

package/examples/usage/05-webhook-example.ts

@@ -26,8 +26,7 @@ import express from "express";
 import type { Request, Response } from "express";
 
 // Load configuration from environment
-const WS_URL =
-  process.env.WS_URL || "wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws";
+const WS_URL = process.env.WS_URL || "wss://your-teneo-server.com/ws";
 const PRIVATE_KEY = process.env.PRIVATE_KEY || "";
 const DEFAULT_ROOM = process.env.DEFAULT_ROOM || "general";
 const WEBHOOK_PORT = parseInt(process.env.WEBHOOK_PORT || "3001");
@@ -177,7 +176,7 @@ async function main() {
 
   try {
     // Step 4: Connect to Teneo
-    console.log("⚙️  Step 4: Connecting to Teneo network...");
+    console.log("⚙️  Step 4: Connecting to Teneo Protocol...");
     await sdk.connect();
     console.log("✅ Connected!\n");
 

package/examples/usage/06-simple-api-server.ts

@@ -21,8 +21,7 @@ import type { Request, Response } from "express";
 import { TeneoSDK, SDKConfigBuilder } from "../../dist/index.js";
 
 // Load configuration from environment
-const WS_URL =
-  process.env.WS_URL || "wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws";
+const WS_URL = process.env.WS_URL || "wss://your-teneo-server.com/ws";
 const PRIVATE_KEY = process.env.PRIVATE_KEY || "";
 const DEFAULT_ROOM = process.env.DEFAULT_ROOM || "general";
 const PORT = parseInt(process.env.PORT || "3000");
@@ -78,7 +77,7 @@ sdk.on("error", (error) => {
 });
 
 // Connect to Teneo
-console.log("🔌 Connecting to Teneo network...");
+console.log("🔌 Connecting to Teneo Protocol...");
 await sdk.connect();
 console.log("✅ Connected!\n");
 

package/examples/usage/07-event-listener.ts

@@ -15,8 +15,7 @@ import "dotenv/config";
 import { TeneoSDK, SDKConfigBuilder } from "../../dist/index.js";
 
 // Load configuration from environment
-const WS_URL =
-  process.env.WS_URL || "wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws";
+const WS_URL = process.env.WS_URL || "wss://your-teneo-server.com/ws";
 const PRIVATE_KEY = process.env.PRIVATE_KEY || "";
 const DEFAULT_ROOM = process.env.DEFAULT_ROOM || "general";
 
@@ -336,7 +335,7 @@ async function main() {
   // ============================================================================
 
   try {
-    console.log("📡 Connecting to Teneo network...\n");
+    console.log("📡 Connecting to Teneo Protocol...\n");
     console.log("=".repeat(80));
     console.log("Listening to all events... (will run for 30 seconds)");
     console.log("=".repeat(80) + "\n");

package/examples/usage/README.md

@@ -29,7 +29,7 @@ Create a `.env` file in the project root or export these variables:
 ```bash
 # Required
 PRIVATE_KEY=your_ethereum_private_key_here
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+WS_URL=wss://your-teneo-server.com/ws
 
 # Optional
 DEFAULT_ROOM=general

package/examples/webhook-integration.ts

@@ -103,7 +103,7 @@ async function main() {
 
   try {
     // Connect to Teneo
-    console.log("[SDK] Connecting to Teneo network...");
+    console.log("[SDK] Connecting to Teneo Protocol...");
     await sdk.connect();
 
     // Wait for ready

package/examples/x-influencer-battle-server.ts

@@ -64,7 +64,7 @@ async function initSDK() {
 
   // Set up event listeners
   sdk.on("connection:open", () => {
-    console.log("[SDK] Connected to Teneo network");
+    console.log("[SDK] Connected to Teneo Protocol");
   });
 
   sdk.on("auth:success", (state) => {
@@ -137,7 +137,7 @@ wss.on("connection", (ws: WebSocket) => {
           ws.send(
             JSON.stringify({
               type: "error",
-              message: "Not connected to Teneo network"
+              message: "Not connected to Teneo Protocol"
             })
           );
           return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teneo-protocol/sdk",
-  "version": "1.0.1",
+  "version": "2.2.0",
   "description": "TypeScript SDK for external platforms to interact with Teneo agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,13 +15,24 @@
   ],
   "author": "Teneo Protocol",
   "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TeneoProtocolAI/teneo-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/TeneoProtocolAI/teneo-sdk/issues"
+  },
+  "homepage": "https://github.com/TeneoProtocolAI/teneo-sdk#readme",
   "dependencies": {
+    "@hono/node-server": "^1.19.6",
     "eventemitter3": "^5.0.1",
+    "hono": "^4.10.4",
     "node-fetch": "^3.3.2",
     "pino": "^8.17.2",
     "uuid": "^9.0.1",
     "viem": "^2.37.11",
     "ws": "^8.16.0",
+    "x402": "^0.7.3",
     "zod": "^3.22.4"
   },
   "devDependencies": {

package/src/core/websocket-client.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
 import { WebSocketClient } from "./websocket-client";
-import { ConnectionError, AuthenticationError, TimeoutError } from "../types/events";
+import { ConnectionError } from "../types/events";
 import type { SDKConfig } from "../types/config";
 import WebSocket from "ws";
 import { privateKeyToAccount } from "viem/accounts";
@@ -21,10 +21,13 @@ vi.mock("viem/accounts", () => ({
 describe("WebSocketClient", () => {
   let client: WebSocketClient;
   let mockConfig: SDKConfig;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   let mockWs: any;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   let mockAccount: any;
 
   // Helper to simulate successful authentication
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   const simulateAuth = (client: any) => {
     // Update auth state to bypass authentication wait
     client.updateAuthState({ authenticated: true });
@@ -49,9 +52,11 @@ describe("WebSocketClient", () => {
     mockWs = {
       on: vi.fn(),
       once: vi.fn(),
-      send: vi.fn((data: any, callback?: any) => callback && callback()),
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      send: vi.fn((data: unknown, callback?: () => void) => callback && callback()),
       close: vi.fn(),
-      ping: vi.fn((callback?: any) => callback && callback()),
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      ping: vi.fn((callback?: () => void) => callback && callback()),
       terminate: vi.fn(),
       readyState: WebSocket.OPEN,
       CONNECTING: 0,

package/src/core/websocket-client.ts

@@ -55,7 +55,11 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
   private signatureVerifier?: SignatureVerifier;
   private deduplicationCache?: DeduplicationCache;
   private reconnectPolicy: RetryPolicy;
-  private roomManager?: any; // Reference to RoomManager for handler context
+  private roomManager?: import("../managers/room-manager").RoomManager; // Reference to RoomManager for handler context
+  private roomManagementManager?: import("../managers/room-management-manager").RoomManagementManager; // Reference to RoomManagementManager for handler context (v2.0.0)
+  private agentRoomManager?: import("../managers/agent-room-manager").AgentRoomManager; // Reference to AgentRoomManager for handler context (v2.0.0)
+  private adminManager?: import("../managers/admin-manager").AdminManager; // Reference to AdminManager for admin handlers
+  private agentRegistry?: import("../managers/agent-registry").AgentRegistry; // Reference to AgentRegistry for agent details handler
   private intentionalDisconnect: boolean = false; // Track intentional disconnect to prevent reconnection
 
   private connectionState: ConnectionState = {
@@ -73,6 +77,7 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
   private pendingMessages = new Map<
     string,
     {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       resolve: (value: any) => void;
       reject: (error: Error) => void;
       timeout: NodeJS.Timeout;
@@ -159,6 +164,7 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
     // Initialize signature verifier if configured (SEC-2)
     if (this.config.validateSignatures) {
       this.signatureVerifier = new SignatureVerifier({
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         trustedAddresses: this.config.trustedAgentAddresses as any[],
         requireSignaturesFor: this.config.requireSignaturesFor,
         strictMode: this.config.strictSignatureValidation
@@ -207,10 +213,46 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
    * Set the RoomManager instance for handler context
    * Called by TeneoSDK after initialization
    */
-  public setRoomManager(roomManager: any): void {
+  public setRoomManager(roomManager: import("../managers/room-manager").RoomManager): void {
     this.roomManager = roomManager;
   }
 
+  /**
+   * Sets the room management manager for room CRUD operations (v2.0.0)
+   * @internal
+   */
+  public setRoomManagementManager(
+    roomManagementManager: import("../managers/room-management-manager").RoomManagementManager
+  ): void {
+    this.roomManagementManager = roomManagementManager;
+  }
+
+  /**
+   * Sets the agent room manager for agent-room operations (v2.0.0)
+   * @internal
+   */
+  public setAgentRoomManager(
+    agentRoomManager: import("../managers/agent-room-manager").AgentRoomManager
+  ): void {
+    this.agentRoomManager = agentRoomManager;
+  }
+
+  /**
+   * Sets the admin manager for admin-only features
+   * @internal
+   */
+  public setAdminManager(adminManager: import("../managers/admin-manager").AdminManager): void {
+    this.adminManager = adminManager;
+  }
+
+  /**
+   * Sets the agent registry for agent details lookups
+   * @internal
+   */
+  public setAgentRegistry(agentRegistry: import("../managers/agent-registry").AgentRegistry): void {
+    this.agentRegistry = agentRegistry;
+  }
+
   /**
    * Establishes a WebSocket connection to the Teneo server.
    * Handles connection timeout, authentication challenge-response flow,
@@ -296,7 +338,11 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
           if (parseResult.success) {
             this.handleMessage(parseResult.data as BaseMessage);
           } else {
-            this.logger.error("Invalid message format", parseResult.error);
+            // Use warn instead of error - allows SDK to be more resilient
+            this.logger.warn("Received message with unknown or invalid format", {
+              type: rawMessage?.type,
+              error: parseResult.error?.message
+            });
             this.emit(
               "message:error",
               new ValidationError("Invalid message format", parseResult.error),
@@ -494,7 +540,7 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
           this.logger.error("Failed to send message", error);
           reject(error);
         } else {
-          this.logger.debug("Message sent", { type: validatedMessage.type });
+          this.logger.debug("Message sent", validatedMessage);
           this.emit("message:sent", validatedMessage);
           resolve();
         }
@@ -522,6 +568,7 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
    * console.log('Response received:', response);
    * ```
    */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   public async sendMessageWithResponse<T = any>(
     message: BaseMessage,
     timeout?: number
@@ -641,6 +688,7 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
    */
   private createHandlerContext(): HandlerContext {
     return {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       emit: (event: string, ...args: any[]) => this.emit(event as any, ...args),
       sendWebhook: async () => {
         // Webhooks are handled by WebhookHandler in TeneoSDK
@@ -650,9 +698,15 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
       logger: this.logger,
       getConnectionState: () => this.getConnectionState(),
       getAuthState: () => this.getAuthState(),
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       updateConnectionState: (update: any) => this.updateConnectionState(update),
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       updateAuthState: (update: any) => this.updateAuthState(update),
       roomManager: this.roomManager,
+      roomManagementManager: this.roomManagementManager,
+      agentRoomManager: this.agentRoomManager,
+      adminManager: this.adminManager,
+      agentRegistry: this.agentRegistry,
       account: this.account,
       sendMessage: (message: BaseMessage) => this.sendMessage(message)
     };

package/src/formatters/response-formatter.test.ts

@@ -29,6 +29,7 @@ describe("ResponseFormatter", () => {
     });
 
     it("should validate format option", () => {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       expect(() => new ResponseFormatter({ format: "invalid" as any })).toThrow();
     });
   });
@@ -303,6 +304,7 @@ describe("ResponseFormatter", () => {
 
     it("should handle unknown message types", () => {
       const unknown: BaseMessage = {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         type: "unknown" as any,
         content: "Unknown content",
         data: { key: "value" }

package/src/formatters/response-formatter.ts

@@ -296,7 +296,7 @@ export class ResponseFormatter {
   /**
    * Format raw message (no transformation)
    */
-  private formatRaw(message: BaseMessage): any {
+  private formatRaw(message: BaseMessage): BaseMessage {
     return message;
   }
 
@@ -467,7 +467,7 @@ export class ResponseFormatter {
   /**
    * Format JSON object for display
    */
-  private formatJSON(obj: any, indent = 0): string {
+  private formatJSON(obj: unknown, indent = 0): string {
     if (obj === null || obj === undefined) {
       return "null";
     }
@@ -497,7 +497,7 @@ export class ResponseFormatter {
   /**
    * Format array for display
    */
-  private formatArray(arr: any[], indent = 0): string {
+  private formatArray(arr: unknown[], indent = 0): string {
     if (arr.length === 0) {
       return "[]";
     }

package/src/handlers/message-handlers/agent-details-response-handler.ts

@@ -0,0 +1,42 @@
+/**
+ * Handler for agent_details_response messages
+ * Processes detailed agent information from the server
+ */
+
+import { AgentDetailsResponseMessage, AgentDetailsResponseMessageSchema } from "../../types";
+import { BaseMessageHandler } from "./base-handler";
+import { HandlerContext } from "./types";
+
+export class AgentDetailsResponseHandler extends BaseMessageHandler<AgentDetailsResponseMessage> {
+  readonly type = "agent_details_response" as const;
+  readonly schema = AgentDetailsResponseMessageSchema;
+
+  protected handleValidated(message: AgentDetailsResponseMessage, context: HandlerContext): void {
+    if (!message.data?.agent) {
+      context.logger.warn("Received agent_details_response without agent data");
+      return;
+    }
+
+    const { agent } = message.data;
+
+    context.logger.debug("Handling agent_details_response", {
+      agentId: agent.agent_id,
+      agentName: agent.agent_name
+    });
+
+    // Delegate to agent registry if available
+    const agentRegistry = context.agentRegistry;
+    if (agentRegistry && typeof agentRegistry.handleAgentDetails === "function") {
+      agentRegistry.handleAgentDetails(agent);
+    }
+
+    context.logger.info("Agent details received", {
+      agentId: agent.agent_id,
+      agentName: agent.agent_name,
+      status: agent.status
+    });
+
+    // Send webhook
+    this.sendWebhook(context, "agent_details_response", { agent });
+  }
+}

package/src/handlers/message-handlers/agent-room-operation-response-handler.ts

@@ -0,0 +1,77 @@
+/**
+ * Handler for agent_room_operation_response messages (v2.0.0)
+ * Processes responses from agent-room operations (add, remove)
+ */
+
+import { AgentRoomOperationResponse, AgentRoomOperationResponseSchema } from "../../types";
+import { BaseMessageHandler } from "./base-handler";
+import { HandlerContext } from "./types";
+import { SDKError } from "../../types/events";
+import { ErrorCode } from "../../types/error-codes";
+
+export class AgentRoomOperationResponseHandler extends BaseMessageHandler<AgentRoomOperationResponse> {
+  readonly type = "agent_room_operation_response" as const;
+  readonly schema = AgentRoomOperationResponseSchema;
+
+  protected handleValidated(message: AgentRoomOperationResponse, context: HandlerContext): void {
+    const { success, message: errorMessage, room_id, agent_id } = message.data;
+
+    context.logger.debug("Handling agent_room_operation_response", {
+      success,
+      roomId: room_id,
+      agentId: agent_id
+    });
+
+    if (!success) {
+      // Operation failed - emit error events
+      const error = new SDKError(
+        errorMessage || "Agent room operation failed",
+        ErrorCode.OPERATION_FAILED
+      );
+
+      context.logger.error("Agent room operation failed", {
+        roomId: room_id,
+        agentId: agent_id,
+        error: errorMessage
+      });
+
+      // Emit both add and remove error events - listeners will filter by room/agent ID
+      this.emit(context, "agent_room:add_error", error, room_id);
+      this.emit(context, "agent_room:remove_error", error, room_id);
+
+      // Send webhook
+      this.sendWebhook(context, "agent_room_operation_error", {
+        success: false,
+        message: errorMessage,
+        room_id,
+        agent_id
+      });
+
+      return;
+    }
+
+    // Operation succeeded
+    if (room_id && agent_id) {
+      context.logger.info("Agent room operation succeeded", {
+        roomId: room_id,
+        agentId: agent_id
+      });
+
+      // Emit success events
+      // The promise handlers in AgentRoomManager will filter by room_id and agent_id
+      this.emit(context, "agent_room:agent_added", room_id, agent_id);
+      this.emit(context, "agent_room:agent_removed", room_id, agent_id);
+
+      // Send webhook
+      this.sendWebhook(context, "agent_room_operation", {
+        success: true,
+        room_id,
+        agent_id,
+        message: "Agent room operation completed successfully"
+      });
+    } else {
+      // Unexpected: success but missing required fields
+      context.logger.warn("Agent room operation succeeded but missing room_id or agent_id");
+    }
+  }
+}

package/src/handlers/message-handlers/agent-status-update-handler.ts

@@ -0,0 +1,52 @@
+/**
+ * Handler for agent_status_update messages (v2.0.0)
+ * Processes real-time agent status updates for rooms
+ */
+
+import { AgentStatusUpdateMessage, AgentStatusUpdateMessageSchema } from "../../types";
+import { BaseMessageHandler } from "./base-handler";
+import { HandlerContext } from "./types";
+
+export class AgentStatusUpdateHandler extends BaseMessageHandler<AgentStatusUpdateMessage> {
+  readonly type = "agent_status_update" as const;
+  readonly schema = AgentStatusUpdateMessageSchema;
+
+  protected handleValidated(message: AgentStatusUpdateMessage, context: HandlerContext): void {
+    const { room_id, agent_id, status, agent } = message.data;
+
+    context.logger.debug("Handling agent_status_update", {
+      roomId: room_id,
+      agentId: agent_id,
+      status,
+      hasAgent: !!agent
+    });
+
+    // Invalidate cache for this room via agent room manager
+    const agentRoomManager = context.agentRoomManager;
+    if (agentRoomManager && typeof agentRoomManager.handleStatusUpdate === "function") {
+      agentRoomManager.handleStatusUpdate(room_id, agent_id, status);
+    }
+
+    context.logger.info("Agent status updated", {
+      roomId: room_id,
+      agentId: agent_id,
+      status
+    });
+
+    // Emit status update event
+    this.emit(context, "agent_room:status_update", {
+      roomId: room_id,
+      agentId: agent_id,
+      status,
+      agent
+    });
+
+    // Send webhook
+    this.sendWebhook(context, "agent_status_update", {
+      room_id,
+      agent_id,
+      status,
+      agent
+    });
+  }
+}

package/src/handlers/message-handlers/all-agents-response-handler.ts

@@ -0,0 +1,39 @@
+/**
+ * Handler for all_agents_response messages (Admin only)
+ * Processes paginated agent list for admin users
+ */
+
+import { AllAgentsResponse, AllAgentsResponseSchema } from "../../types";
+import { BaseMessageHandler } from "./base-handler";
+import { HandlerContext } from "./types";
+
+export class AllAgentsResponseHandler extends BaseMessageHandler<AllAgentsResponse> {
+  readonly type = "all_agents_response" as const;
+  readonly schema = AllAgentsResponseSchema;
+
+  protected handleValidated(message: AllAgentsResponse, context: HandlerContext): void {
+    const { agents, total, offset, has_more, filter } = message.data;
+
+    context.logger.debug("Handling all_agents_response", {
+      count: agents.length,
+      total,
+      offset,
+      hasMore: has_more
+    });
+
+    // Delegate to admin manager if available
+    const adminManager = context.adminManager;
+    if (adminManager && typeof adminManager.handleAllAgentsResponse === "function") {
+      adminManager.handleAllAgentsResponse(message.data, message.request_id);
+    }
+
+    context.logger.info("All agents response received", {
+      count: agents.length,
+      total,
+      filter
+    });
+
+    // Send webhook
+    this.sendWebhook(context, "all_agents_response", message.data);
+  }
+}