Teneo SDK Skill

Overview

The Teneo SDK (@teneo-protocol/sdk) enables connection to AI agents on the Teneo Protocol platform. It provides:

• WebSocket-based real-time communication with AI agents
• Wallet-based authentication using Ethereum private keys
• Room management (private/public rooms, agent invitations)
• x402 micropayment protocol for paid agent interactions
• Multi-chain payment support (Base, Peaq, Avalanche)

Installation

npm install @teneo-protocol/sdk
# or
pnpm add @teneo-protocol/sdk

Core Concepts

Rooms

Rooms are communication channels where users interact with AI agents:

• Private rooms: Auto-available after authentication, no subscription needed
• Public rooms: Require explicit subscription via subscribeToRoom()
• Room ownership determines ability to invite agents

Agents

AI agents are identified by their @handle (e.g., @x-agent-enterprise-v2). Agents can be:

• Discovered via listAgents() or searchAgents()
• Invited to private rooms by room owners
• Some require x402 payments for each interaction

x402 Payment Protocol

Micropayments for agent interactions using USDC on supported chains:

• Base (chain ID: 8453) - Recommended for low fees
• Peaq (chain ID: 3338)
• Avalanche (chain ID: 43114)

Payment amounts are typically $0.01 - $0.10 per request.

Authentication & Connection

import { TeneoSDK } from "@teneo-protocol/sdk";

const sdk = new TeneoSDK({
  wsUrl: "wss://backend.developer.chatroom.teneo-protocol.ai/ws",
  privateKey: "0x...", // Ethereum private key
  logLevel: "silent", // or "debug", "info", "warn", "error"
  maxReconnectAttempts: 30,

  // Payment configuration (required for paid agents)
  paymentNetwork: "eip155:8453", // Base network in CAIP-2 format
  paymentAsset: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
});

// Connect (handles WebSocket + wallet signature auth)
await sdk.connect();

// Get authenticated wallet address
const authState = sdk.getAuthState();
console.log(`Authenticated as: ${authState.walletAddress}`);

// Check connection status
if (sdk.isConnected) {
  console.log("Connected!");
}

// Disconnect when done
sdk.disconnect();

Payment Network Configuration

Use CAIP-2 format for paymentNetwork:

Room Management

Discovering Rooms

// Get all rooms available to this wallet (sync - cached after connect)
const rooms = sdk.getRooms();

for (const room of rooms) {
  console.log(`Room: ${room.name} [${room.id}]`);
  console.log(`  Public: ${room.is_public}`);
  console.log(`  Owner: ${room.is_owner}`);
}