@teneo-protocol/sdk 2.2.2 → 3.0.0

package/examples/payment-flow.ts

@@ -0,0 +1,143 @@
+/**
+ * Payment Flow Example - Quote-Approve payment flow with Teneo SDK
+ * Demonstrates manual quote approval: request a quote, inspect pricing, then confirm.
+ * Shows multi-network payment support with x402 v2.5 settlement router integration.
+ *
+ * Usage:
+ *   PRIVATE_KEY=0x... pnpm tsx examples/payment-flow.ts
+ */
+
+import { TeneoSDK, SDKConfigBuilder, SecurePrivateKey, getSupportedNetworks } from "../src";
+
+const WS_URL = process.env.WS_URL;
+const PRIVATE_KEY = process.env.PRIVATE_KEY || "";
+
+async function main() {
+  if (!PRIVATE_KEY) {
+    console.error("Missing PRIVATE_KEY. Run with: PRIVATE_KEY=0x... pnpm tsx examples/payment-flow.ts");
+    process.exit(1);
+  }
+
+  const secureKey = new SecurePrivateKey(PRIVATE_KEY);
+
+  // Configure SDK with manual quote approval
+  const config = new SDKConfigBuilder()
+    .withWebSocketUrl(WS_URL)
+    .withAuthentication(secureKey)
+    .withPayments({
+      autoApprove: false,           // Manual approval — we'll inspect quotes first
+      maxPricePerRequest: 1000000   // Max 1 USDC (in micro-units)
+    })
+    .withReconnection({ enabled: false })
+    .withLogging("warn")
+    .build();
+
+  const sdk = new TeneoSDK(config);
+
+  // --- Payment events ---
+
+  sdk.on("quote:received", (quote) => {
+    console.log(`[quote:received] Agent: ${quote.agentName}, Price: ${quote.pricing?.pricePerUnit} micro-USDC`);
+  });
+
+  sdk.on("payment:attached", (data) => {
+    console.log(`[payment:attached] Agent: ${data.agentId}, Amount: ${data.amount}, Command: ${data.command}`);
+  });
+
+  sdk.on("payment:blocked", (data) => {
+    console.log(`[payment:blocked] Agent ${data.agentId} wants ${data.agentPrice} but max is ${data.maxPrice}`);
+  });
+
+  sdk.on("payment:error", (err, agentId) => {
+    console.error(`[payment:error] Agent: ${agentId}, Error: ${err.message}`);
+  });
+
+  // --- General events ---
+
+  sdk.on("agent:response", (r) => {
+    console.log(`\n[agent:response] ${r.agentName || "Agent"}: ${r.humanized || r.content || JSON.stringify(r.raw)}`);
+  });
+
+  sdk.on("error", (e) => console.error("[error]", e.message));
+
+  try {
+    console.log("Connecting...");
+    await sdk.connect();
+    console.log("Connected!\n");
+
+    // Show supported networks (dynamically loaded from backend)
+    const networks = getSupportedNetworks();
+    console.log(`Supported payment networks: ${networks.join(", ")}\n`);
+
+    // Pick a room
+    const rooms = sdk.getRooms();
+    if (!rooms.length) {
+      console.log("No rooms available.");
+      return;
+    }
+
+    const roomId = rooms[0].id;
+    console.log(`Using room: ${rooms[0].name || roomId}\n`);
+
+    // --- Step 1: Request a quote ---
+    console.log("Requesting quote...");
+    const quote = await sdk.requestQuote(
+      "Analyze Bitcoin trends for the past week",
+      roomId
+    );
+
+    console.log("\nQuote received:");
+    console.log(`  Task ID:  ${quote.taskId}`);
+    console.log(`  Agent:    ${quote.agentName} (${quote.agentId})`);
+    console.log(`  Price:    ${quote.pricing.pricePerUnit} micro-USDC (${quote.pricing.priceType})`);
+    console.log(`  Network:  ${quote.pricing.network || "default"}`);
+    console.log(`  Expires:  ${quote.expiresAt}`);
+
+    // Show x402 v2.5 settlement router fields
+    if (quote.raw?.data) {
+      const data = quote.raw.data as any;
+      console.log("\nSettlement Router (x402 v2.5):");
+      console.log(`  Router:   ${data.settlement_router || "N/A"}`);
+      console.log(`  Salt:     ${data.salt || "N/A"}`);
+      console.log(`  Fee:      ${data.facilitator_fee || "N/A"}`);
+      console.log(`  Hook:     ${data.hook || "N/A"}`);
+    }
+
+    // --- Step 2: Decide whether to confirm ---
+    const MAX_ACCEPTABLE = 500000; // 0.5 USDC in micro-units
+
+    if (quote.pricing.pricePerUnit > MAX_ACCEPTABLE) {
+      console.log(`\nPrice ${quote.pricing.pricePerUnit} exceeds limit of ${MAX_ACCEPTABLE}. Skipping.`);
+      return;
+    }
+
+    // --- Step 3: Confirm the quote and wait for the response ---
+    console.log("\nConfirming quote and waiting for response...");
+    const response = await sdk.confirmQuote(quote.taskId, {
+      waitForResponse: true,
+      timeout: 60000
+    });
+
+    if (response?.humanized) {
+      console.log(`\nAgent response: ${response.humanized}`);
+    } else if (response?.raw) {
+      console.log(`\nAgent response (raw): ${JSON.stringify(response.raw, null, 2)}`);
+    } else {
+      console.log("\n(No response content)");
+    }
+
+    // --- Alternative: Check pending quote before confirming ---
+    // const pending = sdk.getPendingQuote(quote.taskId);
+    // if (pending) {
+    //   console.log(`Still pending: ${pending.agentName}`);
+    // }
+
+  } catch (err) {
+    console.error("Error:", err);
+  } finally {
+    sdk.disconnect();
+    sdk.destroy();
+  }
+}
+
+main();

package/examples/production-dashboard/README.md

@@ -125,7 +125,6 @@ PRIVATE_KEY=0x...your-private-key
 WALLET_ADDRESS=0x...your-wallet-address
 
 # Optional
-DEFAULT_ROOM=general
 PORT=3000
 
 # Security Features
@@ -147,7 +146,6 @@ const secureKey = new SecurePrivateKey(PRIVATE_KEY);
 const config = new SDKConfigBuilder()
   .withWebSocketUrl(WS_URL)
   .withAuthentication(secureKey, WALLET_ADDRESS) // Use encrypted key
-  .withAutoJoinRooms([DEFAULT_ROOM])
   .withReconnection({ enabled: true, delay: 5000, maxAttempts: 10 })
   // REL-3: Custom retry strategies for production
   .withReconnectionStrategy({
@@ -208,7 +206,7 @@ const config = new SDKConfigBuilder()
   {
     "agent": "weather-agent",
     "command": "weather New York",
-    "room": "general"
+    "room": "your-room-id"
   }
   ```
 
@@ -223,7 +221,7 @@ const config = new SDKConfigBuilder()
 - `POST /api/room/subscribe` - Subscribe to a room (v1)
   ```json
   {
-    "roomId": "tech-support"
+    "roomId": "your-room-id"
   }
   ```
 - `POST /api/room/unsubscribe` - Unsubscribe from a room (v1)
@@ -415,13 +413,13 @@ curl http://localhost:3000/api/agents/search/status/online
 
 ```typescript
 // Fast capability search
-const weatherAgents = sdk.findAgentsByCapability("weather-forecast");
+const weatherAgents = sdk.findAvailableAgentsByCapability("weather-forecast");
 
 // Fast partial name search
-const agentsWithWeather = sdk.findAgentsByName("weather");
+const agentsWithWeather = sdk.findAvailableAgentsByName("weather");
 
 // Fast status filtering
-const onlineAgents = sdk.findAgentsByStatus("online");
+const onlineAgents = sdk.findAvailableAgentsByStatus("online");
 ```
 
 ### Configurable Retry Strategies (REL-3)
@@ -536,7 +534,7 @@ The `/health` endpoint returns comprehensive status:
   },
   "rooms": {
     "count": 3,
-    "subscribedRooms": ["general", "announcements"]
+    "subscribedRooms": ["room-id-1", "room-id-2"]
   }
 }
 ```

package/examples/production-dashboard/server.ts

@@ -100,7 +100,7 @@ async function initializeSDK() {
         backoffMultiplier: 2
       })
       .withResponseFormat({ format: "both", includeMetadata: true })
-      .withLogging("debug")
+      .withLogging("info")
       .withCache(true, 300000, 100)
       // CB-4: Message deduplication to prevent duplicate processing
       .withMessageDeduplication(
@@ -495,7 +495,19 @@ app.get("/api/deduplication", (c) => {
 app.post("/webhook", async (c) => {
   const payload = await c.req.json();
 
-  console.log("[WEBHOOK] Received:", payload.event);
+  // Filter out spammy admin broadcast events
+  const ignoredEvents = [
+    'user_count',           // Admin-only: User count updates
+    'user_authenticated',   // Broadcast when ANY user connects
+    'rate_limit_notification', // Rate limit warnings (usually not needed in webhooks)
+  ];
+  
+  if (ignoredEvents.includes(payload.event)) {
+    // Silently ignore these events - don't log, don't store, just return OK
+    return c.json({ status: "ignored" });
+  }
+
+  console.log("[WEBHOOK] Received:", payload.event, "| Data:", JSON.stringify(payload.data).slice(0, 100));
 
   // Store webhook for display
   recentWebhooks.unshift({
@@ -615,7 +627,7 @@ app.get("/api/agents/search/capability/:capability", (c) => {
 
   try {
     const capability = c.req.param("capability");
-    const agents = sdk.findAgentsByCapability(capability);
+    const agents = sdk.findAvailableAgentsByCapability(capability);
     return c.json({
       capability,
       count: agents.length,
@@ -634,7 +646,7 @@ app.get("/api/agents/search/name/:name", (c) => {
 
   try {
     const name = c.req.param("name");
-    const agents = sdk.findAgentsByName(name);
+    const agents = sdk.findAvailableAgentsByName(name);
     return c.json({
       query: name,
       count: agents.length,
@@ -653,7 +665,7 @@ app.get("/api/agents/search/status/:status", (c) => {
 
   try {
     const status = c.req.param("status");
-    const agents = sdk.findAgentsByStatus(status);
+    const agents = sdk.findAvailableAgentsByStatus(status);
     return c.json({
       status,
       count: agents.length,
@@ -788,7 +800,7 @@ app.post("/api/room/join", async (c) => {
       return c.json({ error: "Room ID is required" }, 400);
     }
 
-    await sdk.subscribeToRoom(roomId);
+    await sdk.subscribeToPublicRoom(roomId);
     return c.json({ success: true });
   } catch (error: any) {
     return c.json({ error: error.message }, 500);
@@ -808,7 +820,7 @@ app.post("/api/room/leave", async (c) => {
       return c.json({ error: "Room ID is required" }, 400);
     }
 
-    await sdk.unsubscribeFromRoom(roomId);
+    await sdk.unsubscribeFromPublicRoom(roomId);
     return c.json({ success: true });
   } catch (error: any) {
     return c.json({ error: error.message }, 500);
@@ -1004,12 +1016,12 @@ app.get("/api/v2/rooms/:roomId/agents/:agentId/check", (c) => {
 
   const roomId = c.req.param("roomId");
   const agentId = c.req.param("agentId");
-  const isInRoom = sdk.isAgentInRoom(roomId, agentId);
+  const inRoom = sdk.checkAgentInRoom(roomId, agentId);
 
   return c.json({
     roomId,
     agentId,
-    inRoom: isInRoom,
+    inRoom: inRoom,
     cached: true
   });
 });
@@ -1021,7 +1033,7 @@ app.get("/api/v2/rooms/:id/agents/count", (c) => {
   }
 
   const roomId = c.req.param("id");
-  const count = sdk.getRoomAgentCount(roomId);
+  const count = sdk.getCachedRoomAgentCount(roomId);
 
   return c.json({
     roomId,

package/examples/room-management-example.ts

@@ -84,7 +84,7 @@ async function main() {
       console.log("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
       console.log("🔍 Querying Specific Room");
       console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
-      const room = sdk.getRoomById(newRooms[0].id);
+      const room = sdk.getRoom(newRooms[0].id);
       if (room) {
         console.log(`Room ID: ${room.id}`);
         console.log(`Name: ${room.name}`);
@@ -236,7 +236,7 @@ async function createSampleRooms(sdk: TeneoSDK) {
 
 async function updateRoomExample(sdk: TeneoSDK, roomId: string) {
   try {
-    const originalRoom = sdk.getRoomById(roomId);
+    const originalRoom = sdk.getRoom(roomId);
     if (!originalRoom) {
       console.log("  ⚠️  Room not found");
       return;

package/examples/usage/01-connect.ts

@@ -16,7 +16,6 @@ import { TeneoSDK, SDKConfigBuilder } from "../../dist/index.js";
 // Load configuration from environment
 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";
 
 async function main() {
   console.log("🚀 Example 1: Basic SDK Connection\n");
@@ -30,7 +29,6 @@ async function main() {
 
   console.log("📋 Configuration:");
   console.log(`   WebSocket URL: ${WS_URL}`);
-  console.log(`   Default Room: ${DEFAULT_ROOM}`);
   console.log(`   Private Key: ${PRIVATE_KEY.substring(0, 10)}...`);
   console.log("");
 
@@ -39,7 +37,6 @@ async function main() {
   const config = new SDKConfigBuilder()
     .withWebSocketUrl(WS_URL)
     .withAuthentication(PRIVATE_KEY)
-    // .withAutoJoinRooms([DEFAULT_ROOM])
     .withLogging("info")
     .withReconnection({ enabled: true, delay: 5000, maxAttempts: 3 })
     .build();

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

@@ -16,7 +16,6 @@ import { TeneoSDK, SDKConfigBuilder } from "../../dist/index.js";
 // Load configuration from environment
 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";
 
 async function main() {
   console.log("🚀 Example 2: List Available Agents\n");
@@ -30,7 +29,6 @@ async function main() {
   const config = new SDKConfigBuilder()
     .withWebSocketUrl(WS_URL)
     .withAuthentication(PRIVATE_KEY)
-    // .withAutoJoinRooms([DEFAULT_ROOM])
     .withLogging("info")
     .build();
 

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

@@ -3,7 +3,8 @@
  *
  * This example demonstrates:
  * - Finding a specific agent by ID or name
- * - Sending a direct command to an agent (bypassing coordinator)
+ * - Sending a direct command to an agent
+ * - Direct commands work in all environments (required when no coordinator)
  * - Waiting for and receiving agent responses
  * - Handling response formats (raw, humanized, both)
  *
@@ -17,7 +18,6 @@ import { TeneoSDK, SDKConfigBuilder, FormattedResponse } from "../../dist/index.
 // Load configuration from environment
 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";
 
 async function main() {
   console.log("🚀 Example 3: Pick and Communicate with Specific Agent\n");
@@ -34,7 +34,6 @@ async function main() {
   const config = new SDKConfigBuilder()
     .withWebSocketUrl(WS_URL)
     .withAuthentication(PRIVATE_KEY)
-    // .withAutoJoinRooms([DEFAULT_ROOM])
     .withResponseFormat({ format: "both", includeMetadata: true })
     .withLogging("info")
     .build();
@@ -143,7 +142,7 @@ async function main() {
       {
         agent: selectedAgent.id,
         command: command,
-        room: DEFAULT_ROOM
+        room: "room-id"
       },
       true
     ); // waitForResponse = true

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

@@ -17,7 +17,6 @@ import { TeneoSDK, SDKConfigBuilder } from "../../dist/index.js";
 // Load configuration from environment
 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";
 
 async function main() {
   console.log("🚀 Example 4: Find Agents by Capability\n");
@@ -31,7 +30,6 @@ async function main() {
   const config = new SDKConfigBuilder()
     .withWebSocketUrl(WS_URL)
     .withAuthentication(PRIVATE_KEY)
-    // .withAutoJoinRooms([DEFAULT_ROOM])
     .withLogging("info")
     .build();
 
@@ -96,7 +94,7 @@ async function main() {
       for (const capability of testCapabilities) {
         console.log(`\n🔍 Searching for capability: "${capability}"`);
         const startTime = performance.now();
-        const agentsWithCap = sdk.findAgentsByCapability(capability);
+        const agentsWithCap = sdk.findAvailableAgentsByCapability(capability);
         const duration = performance.now() - startTime;
 
         if (agentsWithCap.length > 0) {
@@ -121,7 +119,7 @@ async function main() {
 
     console.log("\n🔍 Online agents:");
     const startTimeOnline = performance.now();
-    const onlineAgents = sdk.findAgentsByStatus("online");
+    const onlineAgents = sdk.findAvailableAgentsByStatus("online");
     const durationOnline = performance.now() - startTimeOnline;
     console.log(`✅ Found ${onlineAgents.length} online agents (${durationOnline.toFixed(3)}ms):`);
     onlineAgents.forEach((agent) => {
@@ -130,7 +128,7 @@ async function main() {
 
     console.log("\n🔍 Offline agents:");
     const startTimeOffline = performance.now();
-    const offlineAgents = sdk.findAgentsByStatus("offline");
+    const offlineAgents = sdk.findAvailableAgentsByStatus("offline");
     const durationOffline = performance.now() - startTimeOffline;
     console.log(
       `✅ Found ${offlineAgents.length} offline agents (${durationOffline.toFixed(3)}ms):`
@@ -147,7 +145,7 @@ async function main() {
     for (const term of searchTerms) {
       console.log(`\n🔍 Searching for name containing: "${term}"`);
       const startTime = performance.now();
-      const foundAgents = sdk.findAgentsByName(term);
+      const foundAgents = sdk.findAvailableAgentsByName(term);
       const duration = performance.now() - startTime;
 
       if (foundAgents.length > 0) {
@@ -176,12 +174,12 @@ async function main() {
     console.log("Strategy: Find online agents with social-media or twitter capabilities\n");
 
     // First, try to find by specific capabilities
-    let candidates = sdk.findAgentsByCapability("social-media");
+    let candidates = sdk.findAvailableAgentsByCapability("social-media");
     if (candidates.length === 0) {
-      candidates = sdk.findAgentsByCapability("twitter");
+      candidates = sdk.findAvailableAgentsByCapability("twitter");
     }
     if (candidates.length === 0) {
-      candidates = sdk.findAgentsByCapability("x-platform");
+      candidates = sdk.findAvailableAgentsByCapability("x-platform");
     }
 
     // Filter to only online agents
@@ -191,9 +189,9 @@ async function main() {
     if (candidates.length === 0) {
       console.log("⚠️  No capability match, trying name search...");
       const nameResults = sdk
-        .findAgentsByName("twitter")
-        .concat(sdk.findAgentsByName("x platform"))
-        .concat(sdk.findAgentsByName("social"));
+        .findAvailableAgentsByName("twitter")
+        .concat(sdk.findAvailableAgentsByName("x platform"))
+        .concat(sdk.findAvailableAgentsByName("social"));
 
       // Remove duplicates and filter online
       const uniqueIds = new Set<string>();

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

@@ -28,7 +28,6 @@ import type { Request, Response } from "express";
 // Load configuration from environment
 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");
 const WEBHOOK_SINK_PORT = parseInt(process.env.WEBHOOK_SINK_PORT || "3000");
 
@@ -130,7 +129,6 @@ async function main() {
   const config = new SDKConfigBuilder()
     .withWebSocketUrl(WS_URL)
     .withAuthentication(PRIVATE_KEY)
-    // .withAutoJoinRooms([DEFAULT_ROOM])
     .withResponseFormat({ format: "both", includeMetadata: true })
     .withLogging("info")
     .build();
@@ -206,7 +204,7 @@ async function main() {
         {
           agent: agent.id,
           command: "hello webhook test",
-          room: DEFAULT_ROOM
+          room: "room-id"
         },
         false
       ); // Don't wait for response
@@ -243,7 +241,7 @@ async function main() {
         {
           agent: testAgents[0].id,
           command: "test retry",
-          room: DEFAULT_ROOM
+          room: "room-id"
         },
         false
       );

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

@@ -23,7 +23,6 @@ import { TeneoSDK, SDKConfigBuilder } from "../../dist/index.js";
 // Load configuration from environment
 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");
 
 // Validate configuration
@@ -40,13 +39,11 @@ app.use(express.json());
 console.log("🚀 Initializing Teneo API Server\n");
 console.log("📋 Configuration:");
 console.log(`   WebSocket: ${WS_URL}`);
-console.log(`   Room: ${DEFAULT_ROOM}`);
 console.log(`   Port: ${PORT}\n`);
 
 const config = new SDKConfigBuilder()
   .withWebSocketUrl(WS_URL)
   .withAuthentication(PRIVATE_KEY)
-  // .withAutoJoinRooms([DEFAULT_ROOM])
   .withResponseFormat({ format: "both", includeMetadata: true })
   .withReconnection({ enabled: true, delay: 5000, maxAttempts: 10 })
   .withLogging("info")
@@ -182,7 +179,7 @@ app.get("/agents/:id", (req: Request, res: Response) => {
 app.get("/agents/capability/:capability", (req: Request, res: Response) => {
   try {
     const { capability } = req.params;
-    const agents = sdk.findAgentsByCapability(capability);
+    const agents = sdk.findAvailableAgentsByCapability(capability);
 
     res.json({
       success: true,
@@ -206,6 +203,13 @@ app.get("/agents/capability/:capability", (req: Request, res: Response) => {
  * POST /message
  * Send a message to an agent
  * Body: { message: string, agent?: string, waitForResponse?: boolean, timeout?: number }
+ *
+ * Two approaches:
+ * 1. WITH AGENT: Direct command (required in non-coordinator environments)
+ *    Example: { "message": "search bitcoin 5", "agent": "X Platform Agent" }
+ *
+ * 2. WITHOUT AGENT: Coordinator routing (only works in coordinator environments)
+ *    Example: { "message": "Get bitcoin info" }
  */
 app.post("/message", async (req: Request, res: Response) => {
   try {
@@ -228,12 +232,12 @@ app.post("/message", async (req: Request, res: Response) => {
     const startTime = Date.now();
 
     if (agent) {
-      // Send to specific agent
+      // Send to specific agent (direct command)
       const response = await sdk.sendDirectCommand(
         {
           agent,
           command: message,
-          room: DEFAULT_ROOM
+          room: "room-id"
         },
         waitForResponse
       );
@@ -260,7 +264,7 @@ app.post("/message", async (req: Request, res: Response) => {
     } else {
       // Send via coordinator (will auto-select agent)
       const response = await sdk.sendMessage(message, {
-        room: DEFAULT_ROOM,
+        room: "room-id",
         waitForResponse,
         timeout
       });
@@ -318,7 +322,7 @@ app.get("/rooms", (_req: Request, res: Response) => {
 app.post("/rooms/:roomId/subscribe", async (req: Request, res: Response) => {
   try {
     const { roomId } = req.params;
-    await sdk.subscribeToRoom(roomId);
+    await sdk.subscribeToPublicRoom(roomId);
 
     res.json({
       success: true,
@@ -340,7 +344,7 @@ app.post("/rooms/:roomId/subscribe", async (req: Request, res: Response) => {
 app.post("/rooms/:roomId/unsubscribe", async (req: Request, res: Response) => {
   try {
     const { roomId } = req.params;
-    await sdk.unsubscribeFromRoom(roomId);
+    await sdk.unsubscribeFromPublicRoom(roomId);
 
     res.json({
       success: true,

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

@@ -17,7 +17,6 @@ import { TeneoSDK, SDKConfigBuilder } from "../../dist/index.js";
 // Load configuration from environment
 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";
 
 // Event counters for statistics
 const eventStats = {
@@ -57,7 +56,6 @@ async function main() {
   const config = new SDKConfigBuilder()
     .withWebSocketUrl(WS_URL)
     .withAuthentication(PRIVATE_KEY)
-    // .withAutoJoinRooms([DEFAULT_ROOM])
     .withResponseFormat({ format: "both", includeMetadata: true })
     .withLogging("info")
     .build();
@@ -213,11 +211,6 @@ async function main() {
     console.log(`🏠 [ROOM] Unsubscribed from room: ${data.roomId}`);
   });
 
-  sdk.on("room:list", (rooms) => {
-    eventStats.room++;
-    console.log(`🏠 [ROOM] Room list received: ${rooms.length} rooms`);
-  });
-
   // ============================================================================
   // WEBHOOK EVENTS
   // ============================================================================
@@ -325,11 +318,6 @@ async function main() {
     }
   });
 
-  sdk.on("warning", (warning) => {
-    eventStats.error++;
-    console.warn("⚠️  [WARNING]", warning);
-  });
-
   // ============================================================================
   // CONNECT AND TRIGGER EVENTS
   // ============================================================================
@@ -361,7 +349,7 @@ async function main() {
         {
           agent: testAgent.id,
           command: "hello event listener test",
-          room: DEFAULT_ROOM
+          room: "room-id"
         },
         false
       );