@teneo-protocol/sdk 1.0.1 → 2.2.0

package/dist/utils/signature-verifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"signature-verifier.js","sourceRoot":"","sources":["../../src/utils/signature-verifier.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"signature-verifier.js","sourceRoot":"","sources":["../../src/utils/signature-verifier.ts"],"names":[],"mappings":"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"}

package/examples/.env.example

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

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

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

package/examples/basic-usage.ts

@@ -6,8 +6,7 @@
 import { TeneoSDK, SDKConfigBuilder, SecurePrivateKey } from "../src";
 
 // Load configuration from environment variables
-const WS_URL =
-  process.env.WS_URL;
+const WS_URL = process.env.WS_URL;
 const PRIVATE_KEY = process.env.PRIVATE_KEY || "";
 const WALLET_ADDRESS = process.env.WALLET_ADDRESS;
 const DEFAULT_ROOM = process.env.DEFAULT_ROOM || "general";
@@ -41,8 +40,8 @@ async function main() {
   setupEventListeners(sdk);
 
   try {
-    // Connect to Teneo network
-    console.log("\n→ Connecting to Teneo network...");
+    // Connect to Teneo Protocol
+    console.log("\n→ Connecting to Teneo Protocol...");
     await sdk.connect();
     console.log("✓ SDK is connected and authenticated!");
 

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

@@ -2,13 +2,13 @@
 # Copy this file to .env and fill in your values
 
 # ============================================================================
-# REQUIRED: Teneo Network Connection
+# REQUIRED: Teneo Protocol Connection
 # ============================================================================
 
 # WebSocket URL for Teneo AI Network
 # Production: wss://your-production-server.com/ws
-# Development: wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+# Development: wss://your-teneo-server.com/ws
+WS_URL=wss://your-teneo-server.com/ws
 
 # Ethereum Private Key (with 0x prefix)
 # IMPORTANT: Never commit your actual private key to version control!

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

@@ -26,8 +26,8 @@ cp examples/claude-agent-x-follower/.env.example examples/claude-agent-x-followe
 Edit `.env` with your credentials:
 
 ```env
-# Required: Teneo Network Connection
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+# Required: Teneo Protocol Connection
+WS_URL=wss://your-teneo-server.com/ws
 PRIVATE_KEY=0x1234567890123456789012345678901234567890123456789012345678901234
 WALLET_ADDRESS=0x1234567890123456789012345678901234567890  # Optional - auto-derived
 
@@ -76,7 +76,7 @@ npx tsx examples/claude-agent-x-follower/index.ts "Get timeline for VitalikButer
 ```
 🤖 Claude Agent + Teneo SDK - X Timeline Follower
 
-📡 Connecting to Teneo network...
+📡 Connecting to Teneo Protocol...
 ✅ Connected to Teneo
 
 💬 Prompt: "Get timeline for elonmusk and summarize the latest 5 tweets"

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

@@ -69,8 +69,8 @@ cp examples/claude-agent-x-follower/.env.example examples/claude-agent-x-followe
 ### Required Configuration
 
 ```env
-# Teneo Network Connection
-WS_URL=wss://dev-rooms-websocket-ai-core-o9fmb.ondigitalocean.app/ws
+# Teneo Protocol Connection
+WS_URL=wss://your-teneo-server.com/ws
 PRIVATE_KEY=0x1234567890123456789012345678901234567890123456789012345678901234
 WALLET_ADDRESS=0x1234567890123456789012345678901234567890  # Optional - auto-derived from private key
 
@@ -142,7 +142,7 @@ npx tsx examples/claude-agent-x-follower/index.ts "Get timeline for OpenAI and s
 ```
 🤖 Claude Agent + Teneo SDK - X Timeline Follower
 
-📡 Connecting to Teneo network...
+📡 Connecting to Teneo Protocol...
 ✅ Connected to Teneo
 
 💬 Prompt: "Get timeline for elonmusk and summarize the latest 5 tweets"