@teneo-protocol/sdk 2.2.2 → 3.0.0

package/src/types/config.test.ts

@@ -1,6 +1,7 @@
 import { describe, it, expect, vi } from "vitest";
 import {
   SDKConfigSchema,
+  PartialSDKConfigSchema,
   SDKConfigBuilder,
   validateConfig,
   DEFAULT_CONFIG,
@@ -31,7 +32,7 @@ describe("SDK Configuration", () => {
         messageTimeout: 15000,
         maxMessageSize: 2 * 1024 * 1024,
         logLevel: "debug" as LogLevel,
-        autoJoinRooms: ["room1", "room2"],
+        autoJoinPublicRooms: ["room1", "room2"],
         responseFormat: "humanized" as const,
         includeMetadata: true,
         webhookRetries: 5,
@@ -168,7 +169,7 @@ describe("SDK Configuration", () => {
         })
         .withReconnection(true, 3000, 15)
         .withLogging("debug")
-        .withAutoJoinRooms(["room1", "room2"])
+        .withAutoJoinPublicRooms(["room1", "room2"])
         .withResponseFormat("humanized", true)
         .withCache(true, 300000, 100)
         .build();
@@ -183,7 +184,7 @@ describe("SDK Configuration", () => {
       expect(config.reconnectDelay).toBe(3000);
       expect(config.maxReconnectAttempts).toBe(15);
       expect(config.logLevel).toBe("debug");
-      expect(config.autoJoinRooms).toEqual(["room1", "room2"]);
+      expect(config.autoJoinPublicRooms).toEqual(["room1", "room2"]);
       expect(config.responseFormat).toBe("humanized");
       expect(config.includeMetadata).toBe(true);
       expect(config.enableCache).toBe(true);
@@ -208,6 +209,25 @@ describe("SDK Configuration", () => {
       }).not.toThrow(); // Private key is not actually required if wsUrl is set in default
     });
 
+    it("should handle backward compatibility for autoJoinRooms -> autoJoinPublicRooms", () => {
+      // Test that autoJoinRooms is mapped to autoJoinPublicRooms
+      const config = PartialSDKConfigSchema.parse({
+        wsUrl: "wss://example.com/ws",
+        autoJoinRooms: ["old-room-1", "old-room-2"]
+      });
+
+      expect(config.autoJoinPublicRooms).toEqual(["old-room-1", "old-room-2"]);
+
+      // Test that new property takes precedence
+      const config2 = PartialSDKConfigSchema.parse({
+        wsUrl: "wss://example.com/ws",
+        autoJoinRooms: ["old-room"],
+        autoJoinPublicRooms: ["new-room"]
+      });
+
+      expect(config2.autoJoinPublicRooms).toEqual(["new-room"]);
+    });
+
     it("should merge with default config", () => {
       const config = new SDKConfigBuilder()
         .withWebSocketUrl("wss://example.com/ws")
@@ -309,7 +329,7 @@ describe("SDK Configuration", () => {
       expect(DEFAULT_CONFIG.maxReconnectAttempts).toBe(10);
       expect(DEFAULT_CONFIG.connectionTimeout).toBe(30000);
       expect(DEFAULT_CONFIG.messageTimeout).toBe(30000);
-      expect(DEFAULT_CONFIG.maxMessageSize).toBe(2 * 1024 * 1024);
+      expect(DEFAULT_CONFIG.maxMessageSize).toBe(10 * 1024 * 1024);
       expect(DEFAULT_CONFIG.logLevel).toBe("info");
       expect(DEFAULT_CONFIG.responseFormat).toBe("humanized");
       expect(DEFAULT_CONFIG.includeMetadata).toBe(false);

package/src/types/config.ts

@@ -32,13 +32,31 @@ export const ResponseFormatSchema = z.enum(["raw", "humanized", "both"]);
 
 // Webhook event type schema
 export const WebhookEventTypeSchema = z.enum([
+  // Core events
   "message",
   "task",
   "task_response",
   "agent_selected",
   "error",
   "connection_state",
-  "auth_state"
+  "auth_state",
+
+  // Error events
+  "agent_error",
+  "room_operation_error",
+  "agent_room_operation_error",
+
+  // Payment flow events
+  "task_quote",
+  "task_confirmed",
+  "wallet_tx_requested",
+
+  // State change events
+  "room_subscribed",
+  "room_unsubscribed",
+  "room_deleted",
+  "room_operation",
+  "agent_room_operation"
 ]);
 
 // Custom Zod schema for SecurePrivateKey or string
@@ -55,8 +73,8 @@ const PrivateKeySchema = z.union([
   )
 ]);
 
-// SDK Configuration schema
-export const SDKConfigSchema = z.object({
+// SDK Configuration base schema (without transform)
+const SDKConfigBaseSchema = z.object({
   // WebSocket configuration
   wsUrl: z
     .string()
@@ -74,6 +92,8 @@ export const SDKConfigSchema = z.object({
   clientName: z.string().optional(),
 
   // Room configuration
+  autoJoinPublicRooms: z.array(z.string()).optional(),
+  /** @deprecated Use autoJoinPublicRooms instead */
   autoJoinRooms: z.array(z.string()).optional(),
 
   // Webhook configuration
@@ -92,7 +112,7 @@ export const SDKConfigSchema = z.object({
 
   // Message settings
   messageTimeout: z.number().min(1000).max(300000).optional(),
-  maxMessageSize: z.number().min(1024).max(10485760).optional(), // 1KB to 10MB
+  maxMessageSize: z.number().min(1024).max(10 * 1024 * 1024).optional(), // 1KB to 10MB
   maxMessagesPerSecond: z.number().min(1).max(1000).optional(), // Rate limiting
 
   // Response formatting
@@ -128,14 +148,32 @@ export const SDKConfigSchema = z.object({
     .string()
     .regex(/^[a-z0-9-]+:\d+$/, "Must be valid CAIP-2 format")
     .optional(),
-  paymentAsset: z.string().optional()
+  paymentAsset: z.string().optional(),
+
+  // Multi-network support (v2.3.0)
+  network: z.string().optional(), // Network name (peaq, base, avalanche)
+  networkChainId: z.number().optional() // Or chain ID directly
+});
+
+// SDK Configuration schema with transform for backward compatibility
+export const SDKConfigSchema = SDKConfigBaseSchema.transform((config) => {
+  // Handle backward compatibility: map autoJoinRooms to autoJoinPublicRooms
+  if (config.autoJoinRooms && !config.autoJoinPublicRooms) {
+    config.autoJoinPublicRooms = config.autoJoinRooms;
+  }
+  return config;
 });
 
 // Partial config for constructor
-export const PartialSDKConfigSchema = SDKConfigSchema.partial().refine(
-  (config) => config.wsUrl !== undefined,
-  { message: "WebSocket URL is required" }
-);
+export const PartialSDKConfigSchema = SDKConfigBaseSchema.partial()
+  .refine((config) => config.wsUrl !== undefined, { message: "WebSocket URL is required" })
+  .transform((config) => {
+    // Handle backward compatibility: map autoJoinRooms to autoJoinPublicRooms
+    if (config.autoJoinRooms && !config.autoJoinPublicRooms) {
+      config.autoJoinPublicRooms = config.autoJoinRooms;
+    }
+    return config;
+  });
 
 // Connection state schema
 export const ConnectionStateSchema = z.object({
@@ -165,7 +203,13 @@ export const AuthenticationStateSchema = z.object({
   // NEW in v2.0.0: Room categorization
   privateRoomIds: z.array(z.string()).optional(), // IDs of rooms user owns
   sharedRoomIds: z.array(z.string()).optional(), // IDs of rooms user is member of
-  maxPrivateRooms: z.number().optional() // Max rooms user can create
+  maxPrivateRooms: z.number().optional(), // Max rooms user can create
+
+  // Auth enhancement fields (audit #6, #7, #9)
+  jwtToken: z.string().optional(), // JWT token for KeyVault API authentication
+  sessionToken: z.string().optional(), // 64-char hex token for fast re-auth (24h validity)
+  whitelistVerified: z.union([z.boolean(), z.string()]).optional(), // Whitelist verification status
+  userCount: z.number().optional() // Total user count (admin only)
 });
 
 // Webhook config schema
@@ -207,7 +251,7 @@ export type WebhookPayload = z.infer<typeof WebhookPayloadSchema>;
 export type { RetryStrategy };
 
 // Default configuration with validation
-export const DEFAULT_CONFIG: PartialSDKConfig = SDKConfigSchema.partial().parse({
+export const DEFAULT_CONFIG: PartialSDKConfig = SDKConfigBaseSchema.partial().parse({
   wsUrl: "ws://localhost:8080/ws",
   clientType: "user",
   reconnect: true,
@@ -215,7 +259,7 @@ export const DEFAULT_CONFIG: PartialSDKConfig = SDKConfigSchema.partial().parse(
   maxReconnectAttempts: 10,
   connectionTimeout: 30000,
   messageTimeout: 30000,
-  maxMessageSize: 2 * 1024 * 1024, // 2MB
+  maxMessageSize: 10 * 1024 * 1024, // 10MB - sufficient for room history
   maxMessagesPerSecond: 10, // Rate limit: 10 messages per second
   responseFormat: "humanized",
   includeMetadata: false,
@@ -236,9 +280,8 @@ export const DEFAULT_CONFIG: PartialSDKConfig = SDKConfigSchema.partial().parse(
 
   // Quote-Approve Payment Flow (v2.2.0)
   autoApproveQuotes: true, // Auto-approve quotes by default
-  quoteTimeout: 30000, // 30 seconds for quote responses
-  paymentNetwork: "eip155:3338", // PEAQ mainnet
-  paymentAsset: "0xbbA60da06c2c5424f03f7434542280FCAd453d10" // USDC on PEAQ
+  quoteTimeout: 30000 // 30 seconds for quote responses
+  // paymentNetwork and paymentAsset are dynamically loaded from backend via initializeNetworks()
 });
 
 // Configuration validation with custom refinements
@@ -297,7 +340,7 @@ export function safeParseConfig(config: unknown): {
  * const config = new SDKConfigBuilder()
  *   .withWebSocketUrl('wss://teneo.example.com')
  *   .withAuthentication('0x...', '0xYourWalletAddress')
- *   .withAutoJoinRooms(['general', 'announcements'])
+ *   .withAutoJoinPublicRooms(['room-id-1', 'room-id-2'])
  *   .withWebhook('https://api.example.com/webhooks', {
  *     'Authorization': 'Bearer token'
  *   })
@@ -310,11 +353,12 @@ export function safeParseConfig(config: unknown): {
  * const sdk = new TeneoSDK(config);
  *
  * // Using via TeneoSDK.builder() (recommended)
- * const sdk = TeneoSDK.builder()
+ * const config = TeneoSDK.builder()
  *   .withWebSocketUrl('wss://teneo.example.com')
  *   .withAuthentication('0x...')
- *   .withAutoJoinRooms(['general'])
+ *   .withAutoJoinPublicRooms(['room-id-1'])
  *   .build();
+ * const sdk = new TeneoSDK(config);
  * ```
  *
  * @see {@link TeneoSDK} for the main SDK class
@@ -416,23 +460,37 @@ export class SDKConfigBuilder {
   }
 
   /**
-   * Configures rooms to automatically subscribe to after authentication.
-   * These rooms will be subscribed to automatically when connection is established.
+   * Configures public rooms to automatically subscribe to after authentication.
+   * These PUBLIC rooms will be subscribed to automatically when connection is established.
+   * Note: Private rooms are automatically available after auth without needing subscription.
    *
-   * @param rooms - Array of room IDs to auto-subscribe to on connection
+   * @param rooms - Array of public room IDs to auto-subscribe to on connection
    * @returns this builder for method chaining
    * @throws {z.ZodError} If room IDs are invalid
    *
    * @example
    * ```typescript
-   * builder.withAutoJoinRooms(['general', 'announcements', 'support'])
+   * builder.withAutoJoinPublicRooms(['public-room-1', 'public-room-2'])
    * ```
    */
-  withAutoJoinRooms(rooms: string[]): this {
-    this.config.autoJoinRooms = z.array(z.string()).parse(rooms);
+  withAutoJoinPublicRooms(rooms: string[]): this {
+    this.config.autoJoinPublicRooms = z.array(z.string()).parse(rooms);
     return this;
   }
 
+  /**
+   * @deprecated Use withAutoJoinPublicRooms() instead. This method only affects public rooms.
+   * Private rooms are automatically available after authentication without subscription.
+   *
+   * Configures public rooms to automatically subscribe to after authentication.
+   *
+   * @param rooms - Array of public room IDs to auto-subscribe to on connection
+   * @returns this builder for method chaining
+   */
+  withAutoJoinRooms(rooms: string[]): this {
+    return this.withAutoJoinPublicRooms(rooms);
+  }
+
   /**
    * Configures automatic reconnection behavior for WebSocket connections.
    * When enabled, SDK will automatically attempt to reconnect on disconnection.
@@ -850,6 +908,46 @@ export class SDKConfigBuilder {
     return this;
   }
 
+  /**
+   * Sets the default network by name for payment operations (v2.3.0).
+   *
+   * Priority order for network selection:
+   * 1. Per-request network override in sendMessage options
+   * 2. This builder setting
+   * 3. TENEO_NETWORK environment variable
+   * 4. Default: PEAQ (eip155:3338)
+   *
+   * @param network - Network name (peaq, base, avalanche)
+   * @returns this builder for method chaining
+   *
+   * @example
+   * ```typescript
+   * builder.withNetwork("base") // Use Base Mainnet for payments
+   * builder.withNetwork("avalanche") // Use Avalanche Mainnet
+   * ```
+   */
+  withNetwork(network: string): this {
+    this.config.network = z.string().parse(network);
+    return this;
+  }
+
+  /**
+   * Sets the default network by chain ID for payment operations (v2.3.0).
+   *
+   * @param chainId - Chain ID (3338 for PEAQ, 8453 for Base, 43114 for Avalanche)
+   * @returns this builder for method chaining
+   *
+   * @example
+   * ```typescript
+   * builder.withNetworkChainId(8453) // Use Base Mainnet for payments
+   * builder.withNetworkChainId(43114) // Use Avalanche Mainnet
+   * ```
+   */
+  withNetworkChainId(chainId: number): this {
+    this.config.networkChainId = z.number().parse(chainId);
+    return this;
+  }
+
   /**
    * Builds and validates the final SDK configuration.
    * Performs comprehensive validation including custom refinements (e.g., webhook security).
@@ -864,7 +962,7 @@ export class SDKConfigBuilder {
    * const config = new SDKConfigBuilder()
    *   .withWebSocketUrl('wss://teneo.example.com')
    *   .withAuthentication('0x...')
-   *   .withAutoJoinRooms(['general'])
+   *   .withAutoJoinPublicRooms(['room-id-1'])
    *   .build();  // Validates and returns final config
    *
    * const sdk = new TeneoSDK(config);

package/src/types/events.ts

@@ -311,12 +311,21 @@ export interface SDKEvents {
   "agent:response": (response: AgentResponse) => void;
   "agent:list": (agents: z.infer<typeof AgentSchema>[]) => void;
   "agent:status": (agentId: string, status: "online" | "offline") => void;
+  "agent:error": (data: {
+    agentName?: string;
+    content?: string;
+    taskId?: string;
+    clientRequestId?: string;
+    room?: string;
+  }) => void;
 
   // Room events
   "room:subscribed": (data: { roomId: string; subscriptions: string[] }) => void;
   "room:unsubscribed": (data: { roomId: string; subscriptions: string[] }) => void;
   "room:message": (roomId: string, message: z.infer<typeof BaseMessageSchema>) => void;
-  "room:list": (rooms: z.infer<typeof RoomInfoSchema>[]) => void;
+
+  // Room Ping/Pong events
+  "room:pong": (data: { roomId: string; liveCount: number; timestamp: string }) => void;
 
   // Room Management events (v2.0.0)
   "room:created": (room: z.infer<typeof RoomInfoSchema>) => void;
@@ -330,7 +339,15 @@ export interface SDKEvents {
   "agent_room:agent_added": (roomId: string, agentId: string) => void;
   "agent_room:agent_removed": (roomId: string, agentId: string) => void;
   "agent_room:agents_listed": (roomId: string, agents: any[]) => void;
-  "agent_room:available_agents_listed": (agents: any[]) => void;
+  "agent_room:available_agents_listed": (
+    agents: any[],
+    paginationMeta?: {
+      total?: number;
+      offset?: number;
+      limit?: number;
+      hasMore?: boolean;
+    }
+  ) => void;
   "agent_room:status_update": (data: {
     roomId: string;
     agentId: string;
@@ -350,6 +367,12 @@ export interface SDKEvents {
   // Quote-Approve Payment events (v2.2.0)
   "quote:received": (quote: any) => void;
   "quote:expired": (taskId: string) => void;
+  "task:confirmed": (data: {
+    taskId: string;
+    agentId?: string;
+    agentName?: string;
+    clientRequestId?: string;
+  }) => void;
   "payment:blocked": (data: { agentId: string; agentPrice: number; maxPrice: number }) => void;
   "payment:attached": (data: { agentId: string; amount: number; command: string }) => void;
   "payment:error": (error: Error, agentId?: string) => void;
@@ -375,6 +398,16 @@ export interface SDKEvents {
   // User Preferences events
   "preferences:updated": (data: { maxPricePerRequest?: number | null }) => void;
 
+  // Wallet Transaction events
+  "wallet:tx_requested": (data: {
+    taskId: string;
+    agentName?: string;
+    tx: { to: string; value: string; data?: string; chainId: number };
+    description?: string;
+    optional?: boolean;
+    room?: string;
+  }) => void;
+
   // Webhook events
   "webhook:sent": (payload: any, url: string) => void;
   "webhook:success": (response: any, url: string) => void;
@@ -383,6 +416,7 @@ export interface SDKEvents {
 
   // Error events
   error: (error: SDKError) => void;
+  success: (message: string) => void;
   warning: (warning: string) => void;
 
   // Lifecycle events

package/src/types/index.ts

@@ -50,6 +50,7 @@ export {
   // System message schemas
   AgentsListMessageSchema,
   ErrorMessageSchema,
+  SuccessMessageSchema,
   PingMessageSchema,
   PongMessageSchema,
 
@@ -87,7 +88,6 @@ export {
 
   // Room Ping schemas (v2.0.0)
   RoomPingMessageSchema,
-  RoomPongResponseSchema,
 
   // Union schema
   AnyMessageSchema,
@@ -125,6 +125,7 @@ export {
   type ConfirmTaskMessage,
   type AgentsListMessage,
   type ErrorMessage,
+  type SuccessMessage,
   type PingMessage,
   type PongMessage,
   type SubscribeMessage,
@@ -160,7 +161,6 @@ export {
 
   // Room Ping types (v2.0.0)
   type RoomPingMessage,
-  type RoomPongResponse,
 
   // Admin types
   AdminAgentInfoSchema,
@@ -191,9 +191,22 @@ export {
   type SetUserPreferencesMessage,
   type UserPreferencesUpdatedData,
   type UserPreferencesUpdatedMessage,
-
   type AnyMessage,
 
+  // Task Confirmed types
+  TaskConfirmedMessageSchema,
+  type TaskConfirmedMessage,
+
+  // Agent Error types
+  AgentErrorMessageSchema,
+  type AgentErrorMessage,
+
+  // Wallet Transaction types
+  TxResultStatusSchema,
+  TriggerWalletTxMessageSchema,
+  type TxResultStatus,
+  type TriggerWalletTxMessage,
+
   // Type guards
   isAuthSuccess,
   isAuthError,