@teneo-protocol/sdk 2.0.0 → 2.2.0

package/src/core/websocket-client.ts

@@ -55,9 +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 roomManagementManager?: any; // Reference to RoomManagementManager for handler context (v2.0.0)
-  private agentRoomManager?: any; // Reference to AgentRoomManager for handler context (v2.0.0)
+  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 = {
@@ -75,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;
@@ -161,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
@@ -209,7 +213,7 @@ 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;
   }
 
@@ -217,7 +221,9 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
    * Sets the room management manager for room CRUD operations (v2.0.0)
    * @internal
    */
-  public setRoomManagementManager(roomManagementManager: any): void {
+  public setRoomManagementManager(
+    roomManagementManager: import("../managers/room-management-manager").RoomManagementManager
+  ): void {
     this.roomManagementManager = roomManagementManager;
   }
 
@@ -225,10 +231,28 @@ export class WebSocketClient extends EventEmitter<SDKEvents> {
    * Sets the agent room manager for agent-room operations (v2.0.0)
    * @internal
    */
-  public setAgentRoomManager(agentRoomManager: any): void {
+  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,
@@ -544,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
@@ -663,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
@@ -672,11 +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

@@ -3,10 +3,7 @@
  * Processes responses from agent-room operations (add, remove)
  */
 
-import {
-  AgentRoomOperationResponse,
-  AgentRoomOperationResponseSchema
-} from "../../types";
+import { AgentRoomOperationResponse, AgentRoomOperationResponseSchema } from "../../types";
 import { BaseMessageHandler } from "./base-handler";
 import { HandlerContext } from "./types";
 import { SDKError } from "../../types/events";
@@ -16,10 +13,7 @@ export class AgentRoomOperationResponseHandler extends BaseMessageHandler<AgentR
   readonly type = "agent_room_operation_response" as const;
   readonly schema = AgentRoomOperationResponseSchema;
 
-  protected handleValidated(
-    message: AgentRoomOperationResponse,
-    context: HandlerContext
-  ): void {
+  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", {

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

@@ -3,10 +3,7 @@
  * Processes real-time agent status updates for rooms
  */
 
-import {
-  AgentStatusUpdateMessage,
-  AgentStatusUpdateMessageSchema
-} from "../../types";
+import { AgentStatusUpdateMessage, AgentStatusUpdateMessageSchema } from "../../types";
 import { BaseMessageHandler } from "./base-handler";
 import { HandlerContext } from "./types";
 
@@ -14,10 +11,7 @@ export class AgentStatusUpdateHandler extends BaseMessageHandler<AgentStatusUpda
   readonly type = "agent_status_update" as const;
   readonly schema = AgentStatusUpdateMessageSchema;
 
-  protected handleValidated(
-    message: AgentStatusUpdateMessage,
-    context: HandlerContext
-  ): void {
+  protected handleValidated(message: AgentStatusUpdateMessage, context: HandlerContext): void {
     const { room_id, agent_id, status, agent } = message.data;
 
     context.logger.debug("Handling agent_status_update", {
@@ -28,7 +22,7 @@ export class AgentStatusUpdateHandler extends BaseMessageHandler<AgentStatusUpda
     });
 
     // Invalidate cache for this room via agent room manager
-    const agentRoomManager = (context as any).agentRoomManager;
+    const agentRoomManager = context.agentRoomManager;
     if (agentRoomManager && typeof agentRoomManager.handleStatusUpdate === "function") {
       agentRoomManager.handleStatusUpdate(room_id, agent_id, status);
     }

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);
+  }
+}

package/src/handlers/message-handlers/auth-message-handler.ts

@@ -93,6 +93,11 @@ export class AuthMessageHandler extends BaseMessageHandler<AuthMessage> {
       // Get updated auth state
       const authState = context.getAuthState();
 
+      // Update admin manager with admin status
+      if (context.adminManager) {
+        context.adminManager.setAdminStatus(message.data?.is_admin_whitelisted ?? false);
+      }
+
       // Emit events
       this.emit(context, "auth:success", authState);
       this.emit(context, "ready");

package/src/handlers/message-handlers/auth-success-handler.ts

@@ -48,8 +48,13 @@ export class AuthSuccessHandler extends BaseMessageHandler<AuthSuccessMessage> {
     // Get updated auth state
     const authState = context.getAuthState();
 
+    // Update admin manager with admin status
+    if (context.adminManager) {
+      context.adminManager.setAdminStatus(message.data.is_admin_whitelisted ?? false);
+    }
+
     // Initialize room management manager with room data (v2.0.0)
-    const roomMgmt = (context as any).roomManagementManager;
+    const roomMgmt = context.roomManagementManager;
     if (roomMgmt) {
       // Set room limit
       if (message.data.max_private_rooms) {

package/src/handlers/message-handlers/base-handler.ts

@@ -71,31 +71,44 @@ export abstract class BaseMessageHandler<T extends BaseMessage = BaseMessage>
   /**
    * Helper: emit event
    */
-  protected emit(context: HandlerContext, event: string, ...args: any[]): void {
+  protected emit(context: HandlerContext, event: string, ...args: unknown[]): void {
     context.emit(event, ...args);
   }
 
   /**
    * Helper: send webhook (fire-and-forget pattern)
    */
-  protected sendWebhook(context: HandlerContext, type: string, data: any, metadata?: any): void {
+  protected sendWebhook(
+    context: HandlerContext,
+    type: string,
+    data: Record<string, unknown>,
+    metadata?: Record<string, unknown>
+  ): void {
     // Fire and forget - don't block event emission
-    context.sendWebhook(type as any, data, metadata).catch((error) => {
-      context.logger.error(`Failed to send webhook for ${this.type}`, error);
-    });
+    context
+      .sendWebhook(type as Parameters<typeof context.sendWebhook>[0], data, metadata)
+      .catch((error) => {
+        context.logger.error(`Failed to send webhook for ${this.type}`, error);
+      });
   }
 
   /**
    * Helper: update connection state
    */
-  protected updateConnectionState(context: HandlerContext, update: any): void {
+  protected updateConnectionState(
+    context: HandlerContext,
+    update: Partial<import("./types").ConnectionState>
+  ): void {
     context.updateConnectionState(update);
   }
 
   /**
    * Helper: update auth state
    */
-  protected updateAuthState(context: HandlerContext, update: any): void {
+  protected updateAuthState(
+    context: HandlerContext,
+    update: Partial<import("./types").AuthState>
+  ): void {
     context.updateAuthState(update);
   }
 }

package/src/handlers/message-handlers/index.ts

@@ -9,6 +9,7 @@ export * from "./base-handler";
 
 // Export all handlers
 export { TaskResponseHandler } from "./task-response-handler";
+export { TaskQuoteHandler } from "./task-quote-handler";
 export { AgentSelectedHandler } from "./agent-selected-handler";
 export { ChallengeHandler } from "./challenge-handler";
 export { AuthMessageHandler } from "./auth-message-handler";
@@ -28,8 +29,22 @@ export { ListRoomAgentsHandler } from "./list-room-agents-handler";
 export { ListAvailableAgentsHandler } from "./list-available-agents-handler";
 export { AgentStatusUpdateHandler } from "./agent-status-update-handler";
 
+// Agent Details handler
+export { AgentDetailsResponseHandler } from "./agent-details-response-handler";
+
+// Rate Limit handler
+export { RateLimitNotificationHandler } from "./rate-limit-notification-handler";
+
+// Admin handlers
+export { AllAgentsResponseHandler } from "./all-agents-response-handler";
+export { UserCountHandler } from "./user-count-handler";
+
+// Presence handler
+export { UserAuthenticatedHandler } from "./user-authenticated-handler";
+
 // Import for convenience function
 import { TaskResponseHandler } from "./task-response-handler";
+import { TaskQuoteHandler } from "./task-quote-handler";
 import { AgentSelectedHandler } from "./agent-selected-handler";
 import { ChallengeHandler } from "./challenge-handler";
 import { AuthMessageHandler } from "./auth-message-handler";
@@ -48,6 +63,11 @@ import { AgentRoomOperationResponseHandler } from "./agent-room-operation-respon
 import { ListRoomAgentsHandler } from "./list-room-agents-handler";
 import { ListAvailableAgentsHandler } from "./list-available-agents-handler";
 import { AgentStatusUpdateHandler } from "./agent-status-update-handler";
+import { AgentDetailsResponseHandler } from "./agent-details-response-handler";
+import { RateLimitNotificationHandler } from "./rate-limit-notification-handler";
+import { AllAgentsResponseHandler } from "./all-agents-response-handler";
+import { UserCountHandler } from "./user-count-handler";
+import { UserAuthenticatedHandler } from "./user-authenticated-handler";
 import { MessageHandler } from "./types";
 
 /**
@@ -68,6 +88,7 @@ export function getDefaultHandlers(
 
     // Agent/coordinator handlers
     new TaskResponseHandler(),
+    new TaskQuoteHandler(),
     new AgentSelectedHandler(),
     new AgentsListHandler(),
 
@@ -89,6 +110,19 @@ export function getDefaultHandlers(
     new ListAvailableAgentsHandler(),
     new AgentStatusUpdateHandler(),
 
+    // Agent Details handler
+    new AgentDetailsResponseHandler(),
+
+    // Rate Limit handler
+    new RateLimitNotificationHandler(),
+
+    // Admin handlers
+    new AllAgentsResponseHandler(),
+    new UserCountHandler(),
+
+    // Presence handler
+    new UserAuthenticatedHandler(),
+
     // Keepalive handlers
     new PingHandler(),
     new PongHandler()

package/src/handlers/message-handlers/list-room-agents-handler.ts

@@ -14,10 +14,7 @@ export class ListRoomAgentsHandler extends BaseMessageHandler<RoomAgentsResponse
   readonly type = "room_agents_response" as const;
   readonly schema = RoomAgentsResponseSchema;
 
-  protected handleValidated(
-    message: RoomAgentsResponse,
-    context: HandlerContext
-  ): void {
+  protected handleValidated(message: RoomAgentsResponse, context: HandlerContext): void {
     const { room_id, agents } = message.data;
 
     context.logger.debug("Handling room_agents_response", {
@@ -43,7 +40,7 @@ export class ListRoomAgentsHandler extends BaseMessageHandler<RoomAgentsResponse
     });
 
     // Cache via agent room manager if available
-    const agentRoomManager = (context as any).agentRoomManager;
+    const agentRoomManager = context.agentRoomManager;
     if (agentRoomManager && typeof agentRoomManager.cacheRoomAgents === "function") {
       agentRoomManager.cacheRoomAgents(room_id, agentList);
     }

package/src/handlers/message-handlers/list-rooms-response-handler.ts

@@ -3,16 +3,18 @@
  * Processes room list from server
  */
 
+import { z } from "zod";
 import { ListRoomsResponse, ListRoomsResponseSchema } from "../../types";
 import { BaseMessageHandler } from "./base-handler";
 import { HandlerContext } from "./types";
 
 export class ListRoomsResponseHandler extends BaseMessageHandler<ListRoomsResponse> {
   readonly type = "list_rooms" as const;
-  readonly schema = ListRoomsResponseSchema;
+  // Cast needed due to Zod transform creating input/output type mismatch
+  readonly schema = ListRoomsResponseSchema as z.ZodType<ListRoomsResponse>;
 
   protected handleValidated(message: ListRoomsResponse, context: HandlerContext): void {
-    context.logger.debug("Handling list_rooms response", {
+    context.logger.debug("Handling list_rooms", {
       roomCount: message.data.rooms.length
     });
 

package/src/handlers/message-handlers/rate-limit-notification-handler.ts

@@ -0,0 +1,45 @@
+/**
+ * Handler for rate_limit_notification messages
+ * Processes rate limit notifications from the server
+ */
+
+import { RateLimitNotificationMessage, RateLimitNotificationMessageSchema } from "../../types";
+import { BaseMessageHandler } from "./base-handler";
+import { HandlerContext } from "./types";
+
+export class RateLimitNotificationHandler extends BaseMessageHandler<RateLimitNotificationMessage> {
+  readonly type = "rate_limit_notification" as const;
+  readonly schema = RateLimitNotificationMessageSchema;
+
+  protected handleValidated(message: RateLimitNotificationMessage, context: HandlerContext): void {
+    const {
+      title,
+      message: msg,
+      cta_text,
+      cta_link,
+      message_type,
+      limit_type,
+      reset_at
+    } = message.data;
+
+    context.logger.warn("Rate limit notification received", {
+      title,
+      limitType: limit_type,
+      resetAt: reset_at
+    });
+
+    // Emit rate limit event with camelCase conversion
+    this.emit(context, "rate_limit", {
+      title,
+      message: msg,
+      ctaText: cta_text,
+      ctaLink: cta_link,
+      messageType: message_type,
+      limitType: limit_type,
+      resetAt: reset_at
+    });
+
+    // Send webhook
+    this.sendWebhook(context, "rate_limit_notification", message.data);
+  }
+}

package/src/handlers/message-handlers/regular-message-handler.ts

@@ -3,7 +3,7 @@
  * Processes messages from agents (when they send 'message' instead of 'task_response')
  */
 
-import { UserMessage, UserMessageSchema } from "../../types";
+import { UserMessage, UserMessageSchema, TaskResponseMessage } from "../../types";
 import { AgentResponse } from "../../types/events";
 import { BaseMessageHandler } from "./base-handler";
 import { HandlerContext } from "./types";
@@ -54,7 +54,8 @@ export class RegularMessageHandler extends BaseMessageHandler<UserMessage> {
         contentType: message.content_type || "text/plain",
         success: true,
         timestamp: new Date(),
-        raw: message as any, // Include raw message for request correlation
+        // Cast to TaskResponseMessage for request correlation (message format is compatible)
+        raw: message as unknown as TaskResponseMessage,
         humanized:
           typeof message.content === "string" ? message.content : JSON.stringify(message.content)
       };

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

@@ -13,10 +13,7 @@ export class RoomOperationResponseHandler extends BaseMessageHandler<RoomOperati
   readonly type = "room_operation_response" as const;
   readonly schema = RoomOperationResponseSchema;
 
-  protected handleValidated(
-    message: RoomOperationResponse,
-    context: HandlerContext
-  ): void {
+  protected handleValidated(message: RoomOperationResponse, context: HandlerContext): void {
     const { success, message: errorMessage, room_id, room } = message.data;
 
     context.logger.debug("Handling room_operation_response", {
@@ -62,7 +59,7 @@ export class RoomOperationResponseHandler extends BaseMessageHandler<RoomOperati
       // For now, handlers will emit both and listeners filter by room_id
 
       // Update cache via room management manager if available
-      const roomManager = (context as any).roomManagementManager;
+      const roomManager = context.roomManagementManager;
       if (roomManager && typeof roomManager.upsertRoom === "function") {
         roomManager.upsertRoom(room);
       }
@@ -83,7 +80,7 @@ export class RoomOperationResponseHandler extends BaseMessageHandler<RoomOperati
       context.logger.info("Room deleted", { roomId: room_id });
 
       // Remove from cache
-      const roomManager = (context as any).roomManagementManager;
+      const roomManager = context.roomManagementManager;
       if (roomManager && typeof roomManager.removeRoom === "function") {
         roomManager.removeRoom(room_id);
       }

package/src/handlers/message-handlers/subscribe-response-handler.ts

@@ -3,7 +3,8 @@
  * Processes room subscription confirmations
  */
 
-import { SubscribeResponse, SubscribeResponseSchema } from "../../types";
+import { SubscribeResponse, SubscribeResponseSchema, ErrorCode } from "../../types";
+import { SDKError } from "../../types/events";
 import { BaseMessageHandler } from "./base-handler";
 import { HandlerContext } from "./types";
 
@@ -41,7 +42,16 @@ export class SubscribeResponseHandler extends BaseMessageHandler<SubscribeRespon
       });
 
       // Emit error event
-      this.emit(context, "error", new Error(`Subscription failed: ${message.data.message}`));
+      this.emit(
+        context,
+        "error",
+        new SDKError(
+          `Subscription failed: ${message.data.message}`,
+          ErrorCode.OPERATION_FAILED,
+          { roomId: message.data.room_id },
+          true
+        )
+      );
     }
   }
 }

package/src/handlers/message-handlers/task-quote-handler.ts

@@ -0,0 +1,31 @@
+/**
+ * Handler for task_quote messages (v2.2.0)
+ * Processes quotes from the coordinator for the quote-approve payment flow
+ */
+
+import { z } from "zod";
+import { TaskQuoteMessage, TaskQuoteMessageSchema } from "../../types";
+import { BaseMessageHandler } from "./base-handler";
+import { HandlerContext } from "./types";
+
+export class TaskQuoteHandler extends BaseMessageHandler<TaskQuoteMessage> {
+  readonly type = "task_quote" as const;
+  readonly schema = TaskQuoteMessageSchema as z.ZodSchema<TaskQuoteMessage>;
+
+  protected handleValidated(message: TaskQuoteMessage, context: HandlerContext): void {
+    context.logger.debug("Handling task_quote message", {
+      taskId: message.data.task_id,
+      agentId: message.data.agent_id,
+      price: message.data.pricing?.pricePerUnit
+    });
+
+    // Emit quote:received event for MessageRouter to pick up
+    this.emit(context, "quote:received", message);
+
+    // Send webhook (fire-and-forget)
+    this.sendWebhook(context, "task_quote", message.data, {
+      taskId: message.data.task_id,
+      agentId: message.data.agent_id
+    });
+  }
+}