@teneo-protocol/sdk 1.0.0 → 2.0.0

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

@@ -0,0 +1,334 @@
+/**
+ * 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 network...");
+    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/claude-agent-x-follower/.env.example

@@ -0,0 +1,117 @@
+# Claude Agent X Follower - Environment Configuration
+# Copy this file to .env and fill in your values
+
+# ============================================================================
+# REQUIRED: Teneo Network Connection
+# ============================================================================
+
+# WebSocket URL for Teneo AI Network
+# Production: wss://your-production-server.com/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!
+PRIVATE_KEY=0x1234567890123456789012345678901234567890123456789012345678901234
+
+# Ethereum Wallet Address (with 0x prefix)
+# If not provided, will be automatically derived from the private key
+WALLET_ADDRESS=
+
+# ============================================================================
+# REQUIRED: Claude Configuration
+# ============================================================================
+
+# Anthropic API Key (Optional - only needed if Claude Code CLI is not authenticated)
+# If you're using Claude Code, the example uses your local ~/.claude/.credentials.json
+# If not, get an API key from: https://console.anthropic.com/
+ANTHROPIC_API_KEY=sk-ant-your-api-key-here
+
+# ============================================================================
+# OPTIONAL: Room Configuration
+# ============================================================================
+
+# Default room to join on connection
+# X-Agent room for KOL tracking and Twitter timeline features
+DEFAULT_ROOM=x-agent-enterprise-v2
+
+# ============================================================================
+# OPTIONAL: Security Features
+# ============================================================================
+
+# Enable message signature verification (true | false)
+# Verifies Ethereum signatures on incoming messages from agents
+# Recommended: true for production
+ENABLE_SIGNATURE_VERIFICATION=false
+
+# Comma-separated list of trusted agent Ethereum addresses
+# Only messages signed by these addresses will be accepted (if verification enabled)
+# Leave empty to allow all signed messages
+# Example: 0xAgent1...,0xAgent2...,0xAgent3...
+TRUSTED_ADDRESSES=
+
+# ============================================================================
+# OPTIONAL: SDK Performance Tuning
+# ============================================================================
+
+# Enable agent caching (true | false)
+ENABLE_CACHE=true
+
+# Cache timeout in milliseconds (default: 300000 = 5 minutes)
+CACHE_TIMEOUT=300000
+
+# Maximum cache size (default: 100)
+MAX_CACHE_SIZE=100
+
+# ============================================================================
+# OPTIONAL: Connection Settings
+# ============================================================================
+
+# Enable automatic reconnection (true | false)
+ENABLE_RECONNECTION=true
+
+# Reconnection delay in milliseconds (100-60000)
+RECONNECT_DELAY=5000
+
+# Maximum reconnection attempts (0-100, 0 = infinite)
+MAX_RECONNECT_ATTEMPTS=10
+
+# ============================================================================
+# OPTIONAL: Logging
+# ============================================================================
+
+# Log level (debug | info | warn | error | silent)
+# debug: Very verbose, shows all SDK operations
+# info: Normal operations and important events
+# warn: Warnings and potential issues
+# error: Errors only
+# silent: No logging
+LOG_LEVEL=info
+
+# ============================================================================
+# NOTES
+# ============================================================================
+
+# 1. Environment Precedence:
+#    - Environment variables override .env file values
+#    - .env file overrides default SDK values
+#
+# 2. Security Best Practices:
+#    - Never commit .env file to git (already in .gitignore)
+#    - Use different private keys for dev/prod
+#    - Enable signature verification in production
+#    - Wallet address is auto-derived if not provided
+#
+# 3. Development Tips:
+#    - Set LOG_LEVEL=debug for troubleshooting
+#    - Disable signature verification for local testing
+#    - Use the x-agent-enterprise-v2 room for X/Twitter features
+#
+# 4. Production Checklist:
+#    ✓ Use production WebSocket URL
+#    ✓ Use secure private key (from secrets manager)
+#    ✓ Enable signature verification
+#    ✓ Set trusted agent addresses
+#    ✓ Set LOG_LEVEL=info or warn
+#    ✓ Enable all security features
+#    ✓ Use environment variables (not .env file)

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

@@ -0,0 +1,243 @@
+# Quick Start Guide
+
+Get up and running with Claude Agent + Teneo SDK in 5 minutes.
+
+## Step 1: Install Dependencies
+
+```bash
+# Install Claude Agent SDK
+npm install @anthropic-ai/claude-agent-sdk
+
+# Install tsx for running TypeScript
+npm install -g tsx
+
+# Ensure Teneo SDK is built
+npm run build
+```
+
+## Step 2: Configure Environment
+
+Copy the example environment file:
+
+```bash
+cp examples/claude-agent-x-follower/.env.example examples/claude-agent-x-follower/.env
+```
+
+Edit `.env` with your credentials:
+
+```env
+# Required: Teneo Network Connection
+WS_URL=wss://your-teneo-server.com/ws
+PRIVATE_KEY=0x1234567890123456789012345678901234567890123456789012345678901234
+WALLET_ADDRESS=0x1234567890123456789012345678901234567890  # Optional - auto-derived
+
+# Required: Room Configuration
+DEFAULT_ROOM=general  # or x-agent-enterprise-v2 for X features
+
+# Optional: Claude API Key (if not using Claude Code CLI)
+ANTHROPIC_API_KEY=sk-ant-your-key-here
+
+# Optional: Advanced Configuration (defaults shown)
+ENABLE_SIGNATURE_VERIFICATION=false
+TRUSTED_ADDRESSES=
+ENABLE_CACHE=true
+ENABLE_RECONNECTION=true
+LOG_LEVEL=info
+```
+
+**Key Configuration Notes:**
+- `WALLET_ADDRESS` is optional - automatically derived from `PRIVATE_KEY` if not provided
+- `ANTHROPIC_API_KEY` only needed if Claude Code CLI is not authenticated
+- `DEFAULT_ROOM` set to `general` for basic use, `x-agent-enterprise-v2` for X/Twitter features
+- All performance and security settings have sensible defaults
+
+## Step 3: Run the Example
+
+### Using npm script:
+
+```bash
+npm run example:claude
+```
+
+### Using tsx directly:
+
+```bash
+npx tsx examples/claude-agent-x-follower/index.ts
+```
+
+### With custom prompt:
+
+```bash
+npx tsx examples/claude-agent-x-follower/index.ts "Get timeline for VitalikButerin and analyze sentiment"
+```
+
+## Expected Output
+
+```
+🤖 Claude Agent + Teneo SDK - X Timeline Follower
+
+📡 Connecting to Teneo network...
+✅ Connected to Teneo
+
+💬 Prompt: "Get timeline for elonmusk and summarize the latest 5 tweets"
+
+🧠 Claude is processing...
+
+🔧 Tool called: get_x_timeline
+📥 Input: { username: 'elonmusk', count: 20 }
+
+🔍 Fetching timeline for @elonmusk (20 tweets)...
+
+✅ Tool result: Success
+
+============================================================
+📝 CLAUDE RESPONSE:
+============================================================
+I've retrieved the timeline for @elonmusk. Here's a summary...
+============================================================
+
+✅ Done!
+```
+
+## Troubleshooting
+
+### Issue: Module not found
+
+```bash
+# Make sure Claude Agent SDK is installed
+npm install @anthropic-ai/claude-agent-sdk
+
+# Ensure SDK is built
+npm run build
+```
+
+### Issue: Cannot connect to Teneo
+
+```bash
+# Check your environment variables
+cat examples/claude-agent-x-follower/.env | grep WS_URL
+cat examples/claude-agent-x-follower/.env | grep PRIVATE_KEY
+
+# Verify the WebSocket URL is accessible
+# Ensure your PRIVATE_KEY starts with 0x
+```
+
+### Issue: Wallet not whitelisted
+
+If you see: `"🔒 Access restricted: Your wallet is not whitelisted"`
+
+**Solution:** Contact your Teneo administrator to whitelist your wallet address for the room you're trying to access.
+
+### Issue: "Agents should use TypeTaskResponse instead of TypeMessage"
+
+This is a **server-side protocol error** (not a configuration issue).
+
+**Solutions:**
+1. Try `DEFAULT_ROOM=general` instead of `x-agent-enterprise-v2`
+2. Contact your Teneo administrator about room configuration
+3. Verify your wallet has correct permissions
+
+### Issue: Claude API error
+
+```bash
+# Verify your API key
+cat examples/claude-agent-x-follower/.env | grep ANTHROPIC_API_KEY
+
+# Check API key has credits at: https://console.anthropic.com/
+```
+
+**Alternative:** Use Claude Code CLI authentication (no API key needed):
+- Already configured via `pathToClaudeCodeExecutable` in the code
+- Uses your local `~/.claude/.credentials.json`
+
+## Next Steps
+
+- ✅ Read the [full README](./README.md) for detailed documentation
+- ✅ Modify prompts to analyze different X users
+- ✅ Add more tools to the Claude agent
+- ✅ Integrate with your own application
+
+## Example Prompts to Try
+
+```bash
+# General information (works in 'general' room)
+npx tsx examples/claude-agent-x-follower/index.ts "Give me information about Teneo Protocol"
+
+# X/Twitter analysis (requires x-agent-enterprise-v2 room and whitelisting)
+npx tsx examples/claude-agent-x-follower/index.ts "Get timeline for elonmusk and analyze sentiment"
+
+# Topic research
+npx tsx examples/claude-agent-x-follower/index.ts "What is the latest news about AI agents?"
+
+# Compare users (X-Agent features)
+npx tsx examples/claude-agent-x-follower/index.ts "Compare tweet styles of elonmusk and VitalikButerin"
+
+# Engagement analysis (X-Agent features)
+npx tsx examples/claude-agent-x-follower/index.ts "Which of AndrewYNg's recent tweets got most engagement?"
+```
+
+**Note:** X/Twitter timeline features (`get_x_timeline` tool) require:
+- Room set to `x-agent-enterprise-v2`
+- Wallet whitelisted for X-Agent access
+- Active X-Agent running in the room
+
+For general testing, use `DEFAULT_ROOM=general` and non-timeline prompts.
+
+## Architecture Overview
+
+```
+You (Prompt) → Claude Agent → get_x_timeline (Tool) → Teneo SDK → X-Agent → Twitter/X
+                    ↓
+              Analysis & Response
+```
+
+## What's New in This Version
+
+This example now uses the **modern SDKConfigBuilder pattern** with enhanced features:
+
+### ✨ Key Features
+
+1. **Automatic Wallet Derivation**
+   - No need to manually provide wallet address
+   - Automatically derived from your private key using viem
+
+2. **Auto-Reconnection**
+   - Automatic reconnection with exponential backoff
+   - Configurable retry attempts and delays
+   - Handles network interruptions gracefully
+
+3. **Response Caching**
+   - Agent response caching for better performance
+   - Configurable cache timeout and size
+   - Reduces redundant queries
+
+4. **Security Features**
+   - Optional SEC-2 message signature verification
+   - Trusted address whitelisting
+   - Configurable security policies
+
+5. **Flexible Configuration**
+   - Environment-based configuration
+   - Sensible defaults for all settings
+   - Easy to customize per environment
+
+### 🔧 Configuration Pattern
+
+The example uses `SDKConfigBuilder` for clean, type-safe configuration:
+
+```typescript
+const config = new SDKConfigBuilder()
+  .withWebSocketUrl(WS_URL)
+  .withAuthentication(PRIVATE_KEY, WALLET_ADDRESS)  // Wallet auto-derived
+  .withRoom(DEFAULT_ROOM)
+  .withReconnection({ enabled: true, delay: 5000, maxAttempts: 10 })
+  .withCache(true, 300000, 100)
+  .withSignatureVerification({ enabled: false, trustedAddresses: [] })
+  .build();
+```
+
+This replaces the old direct object initialization pattern and provides better IDE support and validation.
+
+---
+
+That's it! You're ready to build AI-powered tools with Claude Agent and Teneo SDK.