@teneo-protocol/sdk 1.0.1 → 2.2.0

package/dist/teneo-sdk.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TeneoSDK = exports.AgentCommandSchema = exports.SendMessageOptionsSchema = void 0;
 const eventemitter3_1 = require("eventemitter3");
 const zod_1 = require("zod");
+const accounts_1 = require("viem/accounts");
 const types_1 = require("./types");
 const events_1 = require("./types/events");
 const error_codes_1 = require("./types/error-codes");
@@ -17,6 +18,7 @@ const response_formatter_1 = require("./formatters/response-formatter");
 const managers_1 = require("./managers");
 const logger_1 = require("./utils/logger");
 const validation_1 = require("./types/validation");
+const secure_private_key_1 = require("./utils/secure-private-key");
 // Zod schemas for SDK-specific interfaces
 exports.SendMessageOptionsSchema = zod_1.z.object({
     room: validation_1.RoomIdSchema.optional(),
@@ -31,6 +33,22 @@ exports.AgentCommandSchema = zod_1.z.object({
     room: validation_1.RoomIdSchema.optional()
 });
 class TeneoSDK extends eventemitter3_1.EventEmitter {
+    config;
+    logger;
+    isDestroyed = false;
+    secureKey;
+    // Core components
+    wsClient;
+    webhookHandler;
+    responseFormatter;
+    // Managers
+    connection;
+    rooms;
+    roomManagement;
+    agentRoom;
+    agents;
+    messages;
+    _admin;
     /**
      * Creates a new instance of the Teneo Protocol SDK.
      * Initializes all core components, managers, and validates the provided configuration.
@@ -81,7 +99,6 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
      */
     constructor(config) {
         super();
-        this.isDestroyed = false;
         try {
             // Validate partial config first
             const partialConfig = types_1.PartialSDKConfigSchema.parse(config);
@@ -91,6 +108,15 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
             this.config = (0, types_1.validateConfig)(fullConfig);
             // Initialize logger
             this.logger = this.config.logger ?? this.createDefaultLogger();
+            // Store secure key for payment client
+            if (config.privateKey) {
+                if (typeof config.privateKey === "object" && "use" in config.privateKey) {
+                    this.secureKey = config.privateKey;
+                }
+                else {
+                    this.secureKey = new secure_private_key_1.SecurePrivateKey(config.privateKey);
+                }
+            }
             // Initialize core components
             this.wsClient = new websocket_client_1.WebSocketClient(this.config);
             this.webhookHandler = new webhook_handler_1.WebhookHandler(this.config, this.logger);
@@ -101,12 +127,34 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
             // Initialize managers
             this.connection = new managers_1.ConnectionManager(this.wsClient, this.logger);
             this.rooms = new managers_1.RoomManager(this.wsClient, this.logger);
+            this.roomManagement = new managers_1.RoomManagementManager(this.wsClient, this.logger);
+            this.agentRoom = new managers_1.AgentRoomManager(this.wsClient, this.logger, this.roomManagement);
             this.wsClient.setRoomManager(this.rooms); // Enable subscription tracking in handlers
+            this.wsClient.setRoomManagementManager(this.roomManagement); // Enable room CRUD in handlers (v2.0.0)
+            this.wsClient.setAgentRoomManager(this.agentRoom); // Enable agent-room operations in handlers (v2.0.0)
             this.agents = new managers_1.AgentRegistry(this.logger);
+            this.agents.setWebSocketClient(this.wsClient); // Enable getAgentDetails requests
+            this._admin = new managers_1.AdminManager(this.wsClient, this.logger);
+            this.wsClient.setAdminManager(this._admin); // Enable admin handlers
+            this.wsClient.setAgentRegistry(this.agents); // Enable agent details handler
             this.messages = new managers_1.MessageRouter(this.wsClient, this.webhookHandler, this.responseFormatter, this.logger, {
                 messageTimeout: this.config.messageTimeout,
-                responseFormat: this.config.responseFormat
+                responseFormat: this.config.responseFormat,
+                autoApproveQuotes: this.config.autoApproveQuotes,
+                maxPricePerRequest: this.config.maxPricePerRequest,
+                quoteTimeout: this.config.quoteTimeout,
+                wsUrl: this.config.wsUrl,
+                paymentNetwork: this.config.paymentNetwork,
+                paymentAsset: this.config.paymentAsset
             });
+            // Set up payment client if private key is configured (v2.2.0)
+            if (this.config.privateKey) {
+                const secureKey = this.config.privateKey instanceof secure_private_key_1.SecurePrivateKey
+                    ? this.config.privateKey
+                    : new secure_private_key_1.SecurePrivateKey(this.config.privateKey);
+                const walletAddress = this.config.walletAddress || this.deriveWalletAddress(this.config.privateKey);
+                this.messages.setPaymentClient(secureKey, walletAddress);
+            }
             // Set up event forwarding
             this.setupEventForwarding();
             this.logger.info("TeneoSDK initialized", { wsUrl: this.config.wsUrl });
@@ -119,7 +167,7 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
         }
     }
     /**
-     * Establishes a connection to the Teneo network via WebSocket.
+     * Establishes a connection to the Teneo Protocol via WebSocket.
      * Handles authentication automatically and joins any configured auto-join rooms.
      * Emits 'connection:open', 'auth:success', and 'ready' events on successful connection.
      *
@@ -132,7 +180,7 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
      * ```typescript
      * const sdk = new TeneoSDK({ wsUrl: 'wss://example.com', privateKey: '0x...' });
      * await sdk.connect();
-     * console.log('Connected to Teneo network');
+     * console.log('Connected to Teneo Protocol');
      * ```
      */
     async connect() {
@@ -140,7 +188,7 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
             throw new events_1.SDKError("SDK has been destroyed", error_codes_1.ErrorCode.SDK_DESTROYED, null, false);
         }
         try {
-            this.logger.info("Connecting to Teneo network");
+            this.logger.info("Connecting to Teneo Protocol");
             await this.connection.connect();
             // Auto-join rooms if configured
             if (this.config.autoJoinRooms && this.config.autoJoinRooms.length > 0) {
@@ -148,26 +196,26 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
                     await this.rooms.subscribeToRoom(room);
                 }
             }
-            this.logger.info("Successfully connected to Teneo network");
+            this.logger.info("Successfully connected to Teneo Protocol");
         }
         catch (error) {
-            this.logger.error("Failed to connect to Teneo network", error);
+            this.logger.error("Failed to connect to Teneo Protocol", error);
             throw error;
         }
     }
     /**
-     * Disconnects from the Teneo network and cleans up all active connections.
+     * Disconnects from the Teneo Protocol and cleans up all active connections.
      * Clears all timers, pending messages, and stops automatic reconnection attempts.
      * Emits 'disconnect' event after disconnection is complete.
      *
      * @example
      * ```typescript
      * sdk.disconnect();
-     * console.log('Disconnected from Teneo network');
+     * console.log('Disconnected from Teneo Protocol');
      * ```
      */
     disconnect() {
-        this.logger.info("Disconnecting from Teneo network");
+        this.logger.info("Disconnecting from Teneo Protocol");
         this.connection.disconnect();
     }
     /**
@@ -230,38 +278,64 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
         return this.messages.sendDirectCommand(command, waitForResponse);
     }
     /**
-     * Subscribes to a specified room in the Teneo network.
-     * Agents in the room will be able to see and respond to your messages.
+     * Requests a quote for a task from the coordinator.
+     * The quote includes agent selection, pricing, and expiration.
+     * Does NOT auto-approve - use confirmQuote() to execute.
+     */
+    async requestQuote(content, room) {
+        return this.messages.requestQuote(content, room);
+    }
+    /**
+     * Confirms a pending quote and executes the task with payment.
+     * Attaches x402 payment header if payment client is configured.
+     */
+    async confirmQuote(taskId, options) {
+        return this.messages.confirmQuote(taskId, options);
+    }
+    /**
+     * Gets a pending quote by task ID.
+     */
+    getPendingQuote(taskId) {
+        return this.messages.getPendingQuote(taskId);
+    }
+    /**
+     * Subscribes to a public room in the Teneo Protocol.
+     * This is only needed for public rooms - private rooms are automatically subscribed.
      * Emits 'room:subscribed' event when successfully subscribed.
      *
-     * @param roomId - The ID of the room to subscribe to
+     * @param roomId - The ID of the public room to subscribe to
      * @returns Promise that resolves when the room has been subscribed
      * @throws {SDKError} If not connected to the network (ErrorCode.NOT_CONNECTED)
      * @throws {ValidationError} If roomId is empty or invalid
      *
      * @example
      * ```typescript
-     * await sdk.subscribeToRoom('general');
-     * console.log('Subscribed to general room');
+     * // Subscribe to a public room
+     * await sdk.subscribeToRoom('public-announcements');
+     * console.log('Subscribed to public room');
+     *
+     * // Note: Private rooms don't need subscription - you're always subscribed
      * ```
      */
     async subscribeToRoom(roomId) {
         return this.rooms.subscribeToRoom(roomId);
     }
     /**
-     * Unsubscribes from a specified room in the Teneo network.
-     * You will no longer receive messages from agents in this room.
+     * Unsubscribes from a public room in the Teneo Protocol.
+     * You will no longer receive messages from this public room.
      * Emits 'room:unsubscribed' event when successfully unsubscribed.
      *
-     * @param roomId - The ID of the room to unsubscribe from
+     * Note: This only applies to public rooms. Private rooms cannot be unsubscribed from.
+     *
+     * @param roomId - The ID of the public room to unsubscribe from
      * @returns Promise that resolves when the room has been unsubscribed
      * @throws {SDKError} If not connected to the network (ErrorCode.NOT_CONNECTED)
      * @throws {ValidationError} If roomId is empty or invalid
      *
      * @example
      * ```typescript
-     * await sdk.unsubscribeFromRoom('general');
-     * console.log('Unsubscribed from general room');
+     * await sdk.unsubscribeFromRoom('public-announcements');
+     * console.log('Unsubscribed from public room');
      * ```
      */
     async unsubscribeFromRoom(roomId) {
@@ -304,7 +378,7 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
         return this.rooms.getSubscribedRooms();
     }
     /**
-     * Gets a list of all available agents in the Teneo network.
+     * Gets a list of all available agents in the Teneo Protocol.
      * The list is automatically updated when new agents join or leave.
      * Returns a read-only array to prevent external modification.
      *
@@ -409,7 +483,80 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
         return this.agents.findByStatus(status);
     }
     /**
-     * Gets a list of all available rooms in the Teneo network.
+     * Fetches detailed information about a specific agent from the server.
+     * Makes a request to the server for full agent details including capabilities,
+     * commands, pricing, and more.
+     *
+     * @param agentId - The unique identifier of the agent
+     * @returns Promise that resolves with full agent details
+     * @throws {SDKError} If not connected or request times out
+     * @throws {ValidationError} If agentId is invalid
+     *
+     * @example
+     * ```typescript
+     * const details = await sdk.getAgentDetails('weather-agent-001');
+     * console.log(`Agent: ${details.agent_name}`);
+     * console.log(`Capabilities: ${details.capabilities?.length}`);
+     * console.log(`Status: ${details.status}`);
+     * ```
+     */
+    async getAgentDetails(agentId) {
+        return this.agents.getAgentDetails(agentId);
+    }
+    // ============================================================================
+    // ADMIN API (Admin-Only Features)
+    // ============================================================================
+    /**
+     * Gets the admin manager for admin-only features.
+     * Returns undefined if the current user is not an admin.
+     * Use this to access admin APIs like listing all agents, user counts, etc.
+     *
+     * @returns The AdminManager instance if user is admin, undefined otherwise
+     *
+     * @example
+     * ```typescript
+     * if (sdk.admin?.isAdmin) {
+     *   // List all agents in the network
+     *   const result = await sdk.admin.listAllAgents({ limit: 20 });
+     *   console.log(`Found ${result.total} agents`);
+     *
+     *   result.agents.forEach(agent => {
+     *     console.log(`${agent.agent_name}: verified=${agent.is_verified}, banned=${agent.is_banned}`);
+     *   });
+     *
+     *   // Get user count
+     *   const userCount = sdk.admin.getLastUserCount();
+     *   console.log(`Online users: ${userCount?.count}`);
+     *
+     *   // Listen for user count updates
+     *   sdk.admin.on('user_count', (data) => {
+     *     console.log(`User count updated: ${data.count}`);
+     *   });
+     * }
+     * ```
+     */
+    get admin() {
+        return this._admin.isAdmin ? this._admin : undefined;
+    }
+    /**
+     * Lists all agents in the network (admin only, convenience method).
+     * Returns paginated list of agents with full admin information.
+     *
+     * @param options - Pagination and filter options
+     * @returns Promise that resolves with agents list
+     * @throws {SDKError} If not connected or not an admin
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.listAllAgents({ limit: 50, filter: 'weather' });
+     * console.log(`Found ${result.total} agents matching 'weather'`);
+     * ```
+     */
+    async listAllAgents(options = {}) {
+        return this._admin.listAllAgents(options);
+    }
+    /**
+     * Gets a list of all available rooms in the Teneo Protocol.
      * Includes rooms you have access to based on your authentication.
      * Returns a read-only array to prevent external modification.
      *
@@ -448,6 +595,418 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
     getRoom(roomId) {
         return this.rooms.getRoom(roomId);
     }
+    // ============================================================================
+    // ROOM MANAGEMENT API (v2.0.0)
+    // ============================================================================
+    /**
+     * Creates a new private or public room.
+     * Checks room limit before creating (for private rooms).
+     * Emits 'room:created' event on success, 'room:create_error' on failure.
+     *
+     * @param options - Room creation options
+     * @param options.name - Room name (1-100 characters)
+     * @param options.description - Optional room description (max 500 characters)
+     * @param options.isPublic - Whether room is public (default: false)
+     * @returns Promise that resolves with created room info
+     * @throws {SDKError} If not connected, over limit, or validation fails
+     *
+     * @example
+     * ```typescript
+     * const room = await sdk.createRoom({
+     *   name: 'My Project Room',
+     *   description: 'Collaboration space for my project',
+     *   isPublic: false
+     * });
+     * console.log(`Created room: ${room.id}`);
+     * ```
+     */
+    async createRoom(options) {
+        return this.roomManagement.createRoom(options);
+    }
+    /**
+     * Updates an existing room's name and/or description.
+     * User must own the room to update it.
+     * Emits 'room:updated' event on success, 'room:update_error' on failure.
+     *
+     * @param roomId - ID of room to update
+     * @param updates - Fields to update
+     * @param updates.name - New room name (1-100 characters)
+     * @param updates.description - New room description (max 500 characters)
+     * @returns Promise that resolves with updated room info
+     * @throws {SDKError} If not connected, not owner, or validation fails
+     *
+     * @example
+     * ```typescript
+     * const room = await sdk.updateRoom('room-123', {
+     *   name: 'Updated Room Name',
+     *   description: 'New description'
+     * });
+     * ```
+     */
+    async updateRoom(roomId, updates) {
+        return this.roomManagement.updateRoom(roomId, updates);
+    }
+    /**
+     * Deletes a room permanently.
+     * User must own the room to delete it.
+     * Emits 'room:deleted' event on success, 'room:delete_error' on failure.
+     *
+     * @param roomId - ID of room to delete
+     * @returns Promise that resolves when room is deleted
+     * @throws {SDKError} If not connected or not owner
+     *
+     * @example
+     * ```typescript
+     * await sdk.deleteRoom('room-123');
+     * console.log('Room deleted successfully');
+     * ```
+     */
+    async deleteRoom(roomId) {
+        return this.roomManagement.deleteRoom(roomId);
+    }
+    /**
+     * Gets all rooms owned by the current user.
+     * Synchronous method that returns cached data from authentication.
+     *
+     * @returns Array of owned room info
+     *
+     * @example
+     * ```typescript
+     * const myRooms = sdk.getOwnedRooms();
+     * console.log(`I own ${myRooms.length} rooms`);
+     * myRooms.forEach(room => {
+     *   console.log(`- ${room.name} (${room.id})`);
+     * });
+     * ```
+     */
+    getOwnedRooms() {
+        return this.roomManagement.getOwnedRooms();
+    }
+    /**
+     * Gets all rooms the user is a member of (but doesn't own).
+     * Synchronous method that returns cached data from authentication.
+     *
+     * @returns Array of shared room info
+     *
+     * @example
+     * ```typescript
+     * const sharedRooms = sdk.getSharedRooms();
+     * console.log(`I'm a member of ${sharedRooms.length} shared rooms`);
+     * ```
+     */
+    getSharedRooms() {
+        return this.roomManagement.getSharedRooms();
+    }
+    /**
+     * Gets all rooms the user has access to (both owned and shared).
+     * Convenience method that combines getOwnedRooms() and getSharedRooms().
+     * Synchronous method that returns cached data from authentication.
+     *
+     * @returns Array of all room info (owned + shared)
+     *
+     * @example
+     * ```typescript
+     * const allRooms = sdk.getAllRooms();
+     * console.log(`I have access to ${allRooms.length} total rooms`);
+     *
+     * // You can filter by ownership if needed
+     * const myRooms = allRooms.filter(r => r.is_owner);
+     * const sharedWithMe = allRooms.filter(r => !r.is_owner);
+     * ```
+     */
+    getAllRooms() {
+        return this.roomManagement.getAllRooms();
+    }
+    /**
+     * Gets the maximum number of private rooms the user can create.
+     * Based on user's subscription/plan.
+     *
+     * @returns Maximum private room limit
+     *
+     * @example
+     * ```typescript
+     * const limit = sdk.getRoomLimit();
+     * const current = sdk.getOwnedRoomCount();
+     * console.log(`Using ${current}/${limit} room slots`);
+     * ```
+     */
+    getRoomLimit() {
+        return this.roomManagement.getRoomLimit();
+    }
+    /**
+     * Gets the current count of owned private rooms.
+     *
+     * @returns Number of rooms user owns
+     *
+     * @example
+     * ```typescript
+     * const count = sdk.getOwnedRoomCount();
+     * if (sdk.canCreateRoom()) {
+     *   console.log(`Can create ${sdk.getRoomLimit() - count} more rooms`);
+     * }
+     * ```
+     */
+    getOwnedRoomCount() {
+        return this.roomManagement.getOwnedRoomCount();
+    }
+    /**
+     * Checks if user can create another private room.
+     * Compares current owned room count against limit.
+     *
+     * @returns True if under limit, false otherwise
+     *
+     * @example
+     * ```typescript
+     * if (sdk.canCreateRoom()) {
+     *   await sdk.createRoom({ name: 'New Room' });
+     * } else {
+     *   console.log('Room limit reached! Upgrade your plan.');
+     * }
+     * ```
+     */
+    canCreateRoom() {
+        return this.roomManagement.canCreateRoom();
+    }
+    // ============================================================================
+    // AGENT ROOM MANAGEMENT API (v2.0.0)
+    // ============================================================================
+    /**
+     * Adds an agent to a room. Only room owners can add agents.
+     * Emits 'agent_room:agent_added' on success, 'agent_room:add_error' on failure.
+     *
+     * @param roomId - ID of the room to add the agent to
+     * @param agentId - ID of the agent to add
+     * @returns Promise that resolves when agent is added
+     * @throws {SDKError} If not connected, not owner, or agent already in room
+     *
+     * @example
+     * ```typescript
+     * await sdk.addAgentToRoom('room-123', 'weather-agent');
+     * console.log('Agent added to room');
+     * ```
+     */
+    async addAgentToRoom(roomId, agentId) {
+        return this.agentRoom.addAgentToRoom(roomId, agentId);
+    }
+    /**
+     * Removes an agent from a room. Only room owners can remove agents.
+     * Emits 'agent_room:agent_removed' on success, 'agent_room:remove_error' on failure.
+     *
+     * @param roomId - ID of the room to remove the agent from
+     * @param agentId - ID of the agent to remove
+     * @returns Promise that resolves when agent is removed
+     * @throws {SDKError} If not connected, not owner, or agent not in room
+     *
+     * @example
+     * ```typescript
+     * await sdk.removeAgentFromRoom('room-123', 'weather-agent');
+     * console.log('Agent removed from room');
+     * ```
+     */
+    async removeAgentFromRoom(roomId, agentId) {
+        return this.agentRoom.removeAgentFromRoom(roomId, agentId);
+    }
+    /**
+     * Lists all agents in a room.
+     * Results are cached for 5 minutes for performance.
+     * Emits 'agent_room:agents_listed' when list is received.
+     *
+     * @param roomId - ID of the room to list agents for
+     * @param useCache - Whether to use cached data if available (default: true)
+     * @returns Promise that resolves to array of agents in the room
+     * @throws {SDKError} If not connected
+     *
+     * @example
+     * ```typescript
+     * const agents = await sdk.listRoomAgents('room-123');
+     * console.log(`Room has ${agents.length} agents`);
+     * agents.forEach(agent => {
+     *   console.log(`- ${agent.agent_name} (${agent.status})`);
+     * });
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async listRoomAgents(roomId, useCache = true) {
+        return this.agentRoom.listRoomAgents(roomId, useCache);
+    }
+    /**
+     * Lists all agents available to be added to a room.
+     * Shows agents not currently in the room.
+     * Results are cached for 5 minutes for performance.
+     * Emits 'agent_room:available_agents_listed' when list is received.
+     *
+     * @param roomId - ID of the room to check available agents for
+     * @param useCache - Whether to use cached data if available (default: true)
+     * @returns Promise that resolves to array of available agents
+     * @throws {SDKError} If not connected
+     *
+     * @example
+     * ```typescript
+     * const available = await sdk.listAvailableAgents('room-123');
+     * console.log(`${available.length} agents available to add`);
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async listAvailableAgents(roomId, useCache = true) {
+        return this.agentRoom.listAvailableAgents(roomId, useCache);
+    }
+    /**
+     * Gets agents in a room from cache (synchronous).
+     * Returns undefined if not cached. Use listRoomAgents() to fetch.
+     *
+     * @param roomId - ID of the room
+     * @returns Array of agents if cached, undefined otherwise
+     *
+     * @example
+     * ```typescript
+     * const agents = sdk.getRoomAgents('room-123');
+     * if (agents) {
+     *   console.log(`${agents.length} agents (cached)`);
+     * } else {
+     *   await sdk.listRoomAgents('room-123'); // Fetch from server
+     * }
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getRoomAgents(roomId) {
+        return this.agentRoom.getRoomAgents(roomId);
+    }
+    /**
+     * Gets available agents for a room from cache (synchronous).
+     * Returns undefined if not cached. Use listAvailableAgents() to fetch.
+     *
+     * @param roomId - ID of the room
+     * @returns Array of available agents if cached, undefined otherwise
+     *
+     * @example
+     * ```typescript
+     * const available = sdk.getAvailableAgents('room-123');
+     * if (available) {
+     *   console.log(`${available.length} agents available (cached)`);
+     * }
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getAvailableAgents(roomId) {
+        return this.agentRoom.getAvailableAgents(roomId);
+    }
+    /**
+     * Checks if an agent is in a room (synchronous, from cache).
+     * Returns undefined if room data not cached.
+     *
+     * @param roomId - ID of the room
+     * @param agentId - ID of the agent
+     * @returns True if agent is in room, false if not, undefined if not cached
+     *
+     * @example
+     * ```typescript
+     * const inRoom = sdk.isAgentInRoom('room-123', 'weather-agent');
+     * if (inRoom === true) {
+     *   console.log('Agent is in room');
+     * } else if (inRoom === false) {
+     *   console.log('Agent is not in room');
+     * } else {
+     *   console.log('Room data not cached');
+     * }
+     * ```
+     */
+    isAgentInRoom(roomId, agentId) {
+        return this.agentRoom.isAgentInRoom(roomId, agentId);
+    }
+    /**
+     * Gets the count of agents in a room (synchronous, from cache).
+     * Returns undefined if room data not cached.
+     *
+     * @param roomId - ID of the room
+     * @returns Number of agents in room, or undefined if not cached
+     *
+     * @example
+     * ```typescript
+     * const count = sdk.getRoomAgentCount('room-123');
+     * if (count !== undefined) {
+     *   console.log(`Room has ${count} agents`);
+     * }
+     * ```
+     */
+    getRoomAgentCount(roomId) {
+        return this.agentRoom.getRoomAgentCount(roomId);
+    }
+    /**
+     * Invalidates the agent-room cache for a specific room.
+     * Forces the next listRoomAgents() or listAvailableAgents() call to fetch fresh data.
+     * Useful after bulk operations or when you know the cache is stale.
+     *
+     * @param roomId - ID of the room to invalidate cache for
+     *
+     * @example
+     * ```typescript
+     * // After adding/removing agents
+     * await sdk.addAgentToRoom('room-123', 'agent-456');
+     * sdk.invalidateAgentRoomCache('room-123');
+     * const freshAgents = await sdk.listRoomAgents('room-123');
+     * ```
+     */
+    invalidateAgentRoomCache(roomId) {
+        this.agentRoom.invalidateCache(roomId);
+    }
+    /**
+     * Updates user preferences on the server.
+     * Server-side enforcement of max price per request - prevents quotes/payments exceeding the limit.
+     *
+     * @param preferences - User preferences to update
+     * @param preferences.maxPricePerRequest - Max price per request in USDC (e.g., 0.01 = $0.01), or null to remove limit
+     * @returns Promise that resolves when preferences are updated
+     * @throws {SDKError} If update fails or times out
+     *
+     * @example
+     * ```typescript
+     * // Set a spending limit of $0.05 per request
+     * await sdk.setUserPreferences({ maxPricePerRequest: 0.05 });
+     *
+     * // Remove the spending limit
+     * await sdk.setUserPreferences({ maxPricePerRequest: null });
+     * ```
+     */
+    async setUserPreferences(preferences) {
+        if (this.isDestroyed) {
+            throw new events_1.SDKError("SDK has been destroyed", error_codes_1.ErrorCode.SDK_DESTROYED, null, false);
+        }
+        const message = {
+            type: "set_user_preferences",
+            data: {
+                max_price_per_request: preferences.maxPricePerRequest
+            }
+        };
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                cleanup();
+                reject(new events_1.SDKError("Set user preferences request timed out", error_codes_1.ErrorCode.TIMEOUT_ERROR));
+            }, 30000);
+            const handleResponse = (msg) => {
+                if (msg.type === "user_preferences_updated") {
+                    cleanup();
+                    if (msg.data?.success) {
+                        this.emit("preferences:updated", {
+                            maxPricePerRequest: msg.data.max_price_per_request
+                        });
+                        resolve();
+                    }
+                    else {
+                        reject(new events_1.SDKError(msg.data?.message || "Failed to update preferences", error_codes_1.ErrorCode.MESSAGE_ERROR));
+                    }
+                }
+            };
+            const cleanup = () => {
+                clearTimeout(timeout);
+                this.wsClient.off("message:received", handleResponse);
+            };
+            this.wsClient.on("message:received", handleResponse);
+            this.wsClient.sendMessage(message).catch((error) => {
+                cleanup();
+                reject(error);
+            });
+        });
+    }
     /**
      * Configures webhook URL and headers for receiving real-time event notifications.
      * Webhooks allow you to receive events at your server endpoint via HTTP POST requests.
@@ -534,7 +1093,7 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
      * This is a convenience getter that returns only the connection status.
      * For detailed state information, use getConnectionState().
      *
-     * @returns True if connected to the Teneo network, false otherwise
+     * @returns True if connected to the Teneo Protocol, false otherwise
      *
      * @example
      * ```typescript
@@ -554,7 +1113,7 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
      * This is a convenience getter that returns only the authentication status.
      * For detailed auth information, use getAuthState().
      *
-     * @returns True if authenticated with the Teneo network, false otherwise
+     * @returns True if authenticated with the Teneo Protocol, false otherwise
      *
      * @example
      * ```typescript
@@ -828,6 +1387,7 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
         this.rooms.destroy();
         this.agents.destroy();
         this.messages.destroy();
+        this._admin.destroy();
         // Destroy other components
         this.webhookHandler.destroy();
         this.removeAllListeners();
@@ -849,12 +1409,28 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
         this.connection.on("auth:success", (state) => {
             this.logger.debug("Received auth:success event in SDK", {
                 authenticated: state?.authenticated,
-                hasRooms: !!state?.roomObjects
+                hasRooms: !!state?.roomObjects,
+                ownedRooms: state?.privateRoomIds?.length || 0,
+                sharedRooms: state?.sharedRoomIds?.length || 0
             });
             // Update rooms from auth state
             if (state.roomObjects) {
                 this.rooms.updateRoomsFromAuth(state.roomObjects);
             }
+            // Ensure RoomManagementManager is synced with auth state
+            if (state.roomObjects && state.roomObjects.length > 0) {
+                const ownedRooms = state.roomObjects.filter((r) => r.is_owner);
+                const sharedRooms = state.roomObjects.filter((r) => !r.is_owner);
+                this.roomManagement.setOwnedRooms(ownedRooms);
+                this.roomManagement.setSharedRooms(sharedRooms);
+                if (state.maxPrivateRooms) {
+                    this.roomManagement.setRoomLimit(state.maxPrivateRooms);
+                }
+            }
+            // Set up payment client for x402 payments
+            if (this.secureKey && state.walletAddress) {
+                this.messages.setPaymentClient(this.secureKey, state.walletAddress);
+            }
             this.emit("auth:success", state);
         });
         this.connection.on("auth:error", (error) => this.emit("auth:error", error));
@@ -866,6 +1442,11 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
         // Forward agent events from MessageRouter
         this.messages.on("agent:selected", (data) => this.emit("agent:selected", data));
         this.messages.on("agent:response", (response) => this.emit("agent:response", response));
+        // Forward quote and payment events from MessageRouter (v2.2.0)
+        this.messages.on("quote:received", (quote) => this.emit("quote:received", quote));
+        this.messages.on("payment:blocked", (data) => this.emit("payment:blocked", data));
+        this.messages.on("payment:attached", (data) => this.emit("payment:attached", data));
+        this.messages.on("payment:error", (error) => this.emit("payment:error", error));
         // Forward coordinator events from MessageRouter
         this.messages.on("coordinator:processing", (request) => this.emit("coordinator:processing", request));
         this.messages.on("coordinator:selected", (agentId, reasoning) => this.emit("coordinator:selected", agentId, reasoning));
@@ -877,6 +1458,121 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
         // Forward room events from WebSocketClient (emitted by room subscription handlers)
         this.wsClient.on("room:subscribed", (data) => this.emit("room:subscribed", data));
         this.wsClient.on("room:unsubscribed", (data) => this.emit("room:unsubscribed", data));
+        // Forward room management events from WebSocketClient (emitted by handlers) (v2.0.0)
+        // These events are emitted by message handlers, so we listen on wsClient
+        // We forward to RoomManagementManager first (for promise resolution), then emit on SDK
+        this.wsClient.on("room:created", (room) => {
+            // Update RoomManagementManager cache
+            this.roomManagement.upsertRoom(room);
+            // Emit on RoomManagementManager for promise resolution (see createRoom method)
+            this.roomManagement.emit("room:created", room);
+            // Emit on SDK for external listeners
+            this.emit("room:created", room);
+        });
+        this.wsClient.on("room:updated", (room) => {
+            // Update RoomManagementManager cache
+            this.roomManagement.upsertRoom(room);
+            // Emit on RoomManagementManager for promise resolution (see updateRoom method)
+            this.roomManagement.emit("room:updated", room);
+            // Emit on SDK for external listeners
+            this.emit("room:updated", room);
+        });
+        this.wsClient.on("room:deleted", (roomId) => {
+            // Remove from RoomManagementManager cache
+            this.roomManagement.removeRoom(roomId);
+            // Emit on RoomManagementManager for promise resolution (see deleteRoom method)
+            this.roomManagement.emit("room:deleted", roomId);
+            // Emit on SDK for external listeners
+            this.emit("room:deleted", roomId);
+        });
+        this.wsClient.on("room:create_error", (error) => {
+            // Emit on RoomManagementManager for promise rejection
+            this.roomManagement.emit("room:create_error", error);
+            // Emit on SDK for external listeners
+            this.emit("room:create_error", error);
+        });
+        this.wsClient.on("room:update_error", (error, roomId) => {
+            // Emit on RoomManagementManager for promise rejection
+            this.roomManagement.emit("room:update_error", error, roomId);
+            // Emit on SDK for external listeners
+            this.emit("room:update_error", error, roomId);
+        });
+        this.wsClient.on("room:delete_error", (error, roomId) => {
+            // Emit on RoomManagementManager for promise rejection
+            this.roomManagement.emit("room:delete_error", error, roomId);
+            // Emit on SDK for external listeners
+            this.emit("room:delete_error", error, roomId);
+        });
+        // Forward agent room management events from WebSocketClient (emitted by handlers) (v2.0.0)
+        // These events are emitted by message handlers, so we listen on wsClient
+        // We forward to AgentRoomManager first (for promise resolution), then emit on SDK
+        this.wsClient.on("agent_room:agent_added", (roomId, agentId) => {
+            // Emit on AgentRoomManager for promise resolution (see addAgentToRoom method)
+            this.agentRoom.emit("agent_room:agent_added", roomId, agentId);
+            // Emit on SDK for external listeners
+            this.emit("agent_room:agent_added", roomId, agentId);
+        });
+        this.wsClient.on("agent_room:agent_removed", (roomId, agentId) => {
+            // Emit on AgentRoomManager for promise resolution (see removeAgentFromRoom method)
+            this.agentRoom.emit("agent_room:agent_removed", roomId, agentId);
+            // Emit on SDK for external listeners
+            this.emit("agent_room:agent_removed", roomId, agentId);
+        });
+        this.wsClient.on("agent_room:agents_listed", (roomId, agents) => {
+            // Emit on AgentRoomManager for promise resolution
+            this.agentRoom.emit("agent_room:agents_listed", roomId, agents);
+            // Emit on SDK for external listeners
+            this.emit("agent_room:agents_listed", roomId, agents);
+        });
+        this.wsClient.on("agent_room:available_agents_listed", (agents) => {
+            // Emit on AgentRoomManager for promise resolution
+            this.agentRoom.emit("agent_room:available_agents_listed", agents);
+            // Emit on SDK for external listeners
+            this.emit("agent_room:available_agents_listed", agents);
+        });
+        this.wsClient.on("agent_room:status_update", (data) => {
+            // Emit on SDK for external listeners
+            this.emit("agent_room:status_update", data);
+        });
+        this.wsClient.on("agent_room:add_error", (error, roomId) => {
+            // Emit on AgentRoomManager for promise rejection
+            this.agentRoom.emit("agent_room:add_error", error, roomId);
+            // Emit on SDK for external listeners
+            this.emit("agent_room:add_error", error, roomId);
+        });
+        this.wsClient.on("agent_room:remove_error", (error, roomId) => {
+            // Emit on AgentRoomManager for promise rejection
+            this.agentRoom.emit("agent_room:remove_error", error, roomId);
+            // Emit on SDK for external listeners
+            this.emit("agent_room:remove_error", error, roomId);
+        });
+        this.wsClient.on("agent_room:list_error", (error, roomId) => {
+            // Emit on AgentRoomManager for promise rejection
+            this.agentRoom.emit("agent_room:list_error", error, roomId);
+            // Emit on SDK for external listeners
+            this.emit("agent_room:list_error", error, roomId);
+        });
+        this.wsClient.on("agent_room:list_available_error", (error) => {
+            // Emit on AgentRoomManager for promise rejection
+            this.agentRoom.emit("agent_room:list_available_error", error);
+            // Emit on SDK for external listeners
+            this.emit("agent_room:list_available_error", error);
+        });
+        // Forward admin events from AdminManager
+        this._admin.on("user_count", (data) => {
+            this.emit("admin:user_count", data);
+        });
+        this._admin.on("status_changed", (isAdmin) => {
+            this.emit("admin:status_changed", isAdmin);
+        });
+        // Forward rate limit notifications from WebSocketClient (emitted by handlers)
+        this.wsClient.on("rate_limit", (notification) => {
+            this.emit("rate_limit", notification);
+        });
+        // Forward user authenticated events from WebSocketClient (emitted by handlers)
+        this.wsClient.on("user:authenticated", (data) => {
+            this.emit("user:authenticated", data);
+        });
         // Forward webhook events from WebhookHandler
         this.webhookHandler.on("webhook:sent", (payload, url) => this.emit("webhook:sent", payload, url));
         this.webhookHandler.on("webhook:success", (response, url) => this.emit("webhook:success", response, url));
@@ -886,8 +1582,12 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
         this.connection.on("error", (error) => {
             this.emit("error", error);
             // Fire and forget - don't block event emission
+            // Defensive check: ensure error has toJSON method (SDKError instances do)
+            const errorPayload = typeof error.toJSON === "function"
+                ? error.toJSON()
+                : { message: error.message, name: error.name, code: error.code };
             this.webhookHandler
-                .sendWebhook("error", error, { code: error.code })
+                .sendWebhook("error", errorPayload, { code: error.code })
                 .catch((webhookError) => {
                 this.logger.error("Failed to send webhook for error event", webhookError);
             });
@@ -902,6 +1602,15 @@ class TeneoSDK extends eventemitter3_1.EventEmitter {
     createDefaultLogger() {
         return (0, logger_1.createPinoLogger)(this.config.logLevel ?? "info", "TeneoSDK");
     }
+    /**
+     * Derive wallet address from private key
+     */
+    deriveWalletAddress(privateKey) {
+        if (privateKey instanceof secure_private_key_1.SecurePrivateKey) {
+            return privateKey.use((key) => (0, accounts_1.privateKeyToAccount)(key).address);
+        }
+        return (0, accounts_1.privateKeyToAccount)(privateKey).address;
+    }
     /**
      * Creates a new SDK configuration builder for fluent configuration.
      * The builder pattern provides a more intuitive way to configure the SDK