@teneo-protocol/sdk 1.0.1 → 2.2.0

package/src/types/categories.ts

@@ -0,0 +1,45 @@
+/**
+ * Agent category constants and Zod schemas
+ * Enables agents to be tagged with up to 2 categories for better discoverability
+ */
+
+import { z } from "zod";
+
+/**
+ * Predefined agent categories for classification
+ */
+export const AGENT_CATEGORIES = [
+  "Trading",
+  "Finance",
+  "Crypto",
+  "Social Media",
+  "Lead Generation",
+  "E-Commerce",
+  "SEO",
+  "News",
+  "Real Estate",
+  "Travel",
+  "Automation",
+  "Developer Tools",
+  "AI",
+  "Integrations",
+  "Open Source",
+  "Jobs",
+  "Price Lists",
+  "Other"
+] as const;
+
+/**
+ * Maximum number of categories an agent can have
+ */
+export const MAX_CATEGORIES = 2;
+
+/**
+ * Zod schema for validating a single agent category
+ */
+export const AgentCategorySchema = z.enum(AGENT_CATEGORIES);
+
+/**
+ * TypeScript type for a single agent category
+ */
+export type AgentCategory = z.infer<typeof AgentCategorySchema>;

package/src/types/config.ts

@@ -4,7 +4,7 @@
  */
 
 import { z } from "zod";
-import { ClientTypeSchema, RoomSchema, MessageTypeSchema, MessageType } from "./messages";
+import { ClientTypeSchema, RoomInfoSchema, MessageTypeSchema, MessageType } from "./messages";
 import { RetryStrategySchema, type RetryStrategy } from "../utils/retry-policy";
 import type { SecurePrivateKey } from "../utils/secure-private-key";
 
@@ -118,7 +118,17 @@ export const SDKConfigSchema = z.object({
   // Message deduplication (CB-4)
   enableMessageDeduplication: z.boolean().optional(),
   messageDedupeTtl: z.number().min(1000).max(3600000).optional(), // 1s to 1 hour
-  messageDedupMaxSize: z.number().min(1).max(100000).optional()
+  messageDedupMaxSize: z.number().min(1).max(100000).optional(),
+
+  // Quote-Approve Payment Flow (v2.2.0)
+  autoApproveQuotes: z.boolean().optional(),
+  maxPricePerRequest: z.number().min(0).optional(), // in micro-USDC
+  quoteTimeout: z.number().min(1000).max(120000).optional(), // 1s to 2 minutes
+  paymentNetwork: z
+    .string()
+    .regex(/^[a-z0-9-]+:\d+$/, "Must be valid CAIP-2 format")
+    .optional(),
+  paymentAsset: z.string().optional()
 });
 
 // Partial config for constructor
@@ -146,11 +156,16 @@ export const AuthenticationStateSchema = z.object({
   isWhitelisted: z.boolean().optional(),
   isAdmin: z.boolean().optional(),
   nftVerified: z.boolean().optional(),
-  rooms: z.array(z.string()).optional(), // Room IDs for backward compatibility
-  roomObjects: z.array(RoomSchema).optional(), // Full room objects from auth
-  privateRoomId: z.string().optional(),
+  rooms: z.array(z.string()).optional(), // Room IDs for backward compatibility (deprecated)
+  roomObjects: z.array(RoomInfoSchema).optional(), // Full room objects from auth (v2.0.0: uses RoomInfo)
+  privateRoomId: z.string().optional(), // DEPRECATED: Single room ID (use privateRoomIds instead)
   challenge: z.string().optional(),
-  challengeTimestamp: z.number().optional()
+  challengeTimestamp: z.number().optional(),
+
+  // 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
 });
 
 // Webhook config schema
@@ -217,7 +232,13 @@ export const DEFAULT_CONFIG: PartialSDKConfig = SDKConfigSchema.partial().parse(
   webhookTimeout: 10000,
   enableMessageDeduplication: true, // Enable by default to prevent duplicates
   messageDedupeTtl: 60000, // 60 seconds (1 minute)
-  messageDedupMaxSize: 10000 // 10k messages
+  messageDedupMaxSize: 10000, // 10k messages
+
+  // 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
 });
 
 // Configuration validation with custom refinements
@@ -774,6 +795,58 @@ export class SDKConfigBuilder {
     return this;
   }
 
+  /**
+   * Configures payment settings for the quote-approve flow (v2.2.0).
+   * Controls how the SDK handles task pricing and payments.
+   *
+   * @param options - Payment configuration options
+   * @param options.autoApprove - Auto-approve and pay for quotes (default: true)
+   * @param options.maxPricePerRequest - Maximum price per request in micro-USDC (1000000 = 1 USDC)
+   * @param options.quoteTimeout - Timeout for quote responses in ms (default: 30000)
+   * @param options.network - Payment network in CAIP-2 format (default: "eip155:3338")
+   * @param options.asset - Payment asset (default: "USDC")
+   * @returns this builder for method chaining
+   *
+   * @example
+   * ```typescript
+   * // Auto-approve with price limit
+   * builder.withPayments({
+   *   autoApprove: true,
+   *   maxPricePerRequest: 1000000  // Max 1 USDC per request
+   * })
+   *
+   * // Manual approval mode
+   * builder.withPayments({ autoApprove: false })
+   * ```
+   */
+  withPayments(options: {
+    autoApprove?: boolean;
+    maxPricePerRequest?: number;
+    quoteTimeout?: number;
+    network?: string;
+    asset?: string;
+  }): this {
+    if (options.autoApprove !== undefined) {
+      this.config.autoApproveQuotes = z.boolean().parse(options.autoApprove);
+    }
+    if (options.maxPricePerRequest !== undefined) {
+      this.config.maxPricePerRequest = z.number().min(0).parse(options.maxPricePerRequest);
+    }
+    if (options.quoteTimeout !== undefined) {
+      this.config.quoteTimeout = z.number().min(1000).max(120000).parse(options.quoteTimeout);
+    }
+    if (options.network !== undefined) {
+      this.config.paymentNetwork = z
+        .string()
+        .regex(/^[a-z0-9-]+:\d+$/)
+        .parse(options.network);
+    }
+    if (options.asset !== undefined) {
+      this.config.paymentAsset = z.string().parse(options.asset);
+    }
+    return this;
+  }
+
   /**
    * Builds and validates the final SDK configuration.
    * Performs comprehensive validation including custom refinements (e.g., webhook security).

package/src/types/error-codes.ts

@@ -38,6 +38,20 @@ export enum ErrorCode {
   // Rate limit
   RATE_LIMIT = "RATE_LIMIT",
 
+  // Room Management errors (v2.0.0)
+  OPERATION_FAILED = "OPERATION_FAILED",
+  PERMISSION_DENIED = "PERMISSION_DENIED",
+
+  // Quote-Approve Payment errors (v2.2.0)
+  QUOTE_EXPIRED = "QUOTE_EXPIRED",
+  QUOTE_NOT_FOUND = "QUOTE_NOT_FOUND",
+  QUOTE_TIMEOUT = "QUOTE_TIMEOUT",
+  PRICE_LIMIT_EXCEEDED = "PRICE_LIMIT_EXCEEDED",
+  INVALID_PAYMENT_NETWORK = "INVALID_PAYMENT_NETWORK",
+  INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+  PAYMENT_FAILED = "PAYMENT_FAILED",
+  PAYMENT_SIGNATURE_FAILED = "PAYMENT_SIGNATURE_FAILED",
+
   // Generic timeout (for backward compatibility)
   TIMEOUT_ERROR = "TIMEOUT_ERROR",
   TIMEOUT = "TIMEOUT"

package/src/types/events.test.ts

@@ -231,6 +231,7 @@ describe("Error Classes", () => {
       expect(isRecoverableError(regularError)).toBe(false);
 
       const customError = { message: "Not an error object" };
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
       expect(isRecoverableError(customError as any)).toBe(false);
     });
   });

package/src/types/events.ts

@@ -262,6 +262,21 @@ export class ConfigurationError extends SDKError {
   }
 }
 
+/**
+ * Error thrown when payment operations fail (v2.2.0).
+ * Can occur when:
+ * - Payment signature creation fails
+ * - Price limit is exceeded
+ * - Insufficient balance
+ * - Invalid payment network
+ */
+export class PaymentError extends SDKError {
+  constructor(message: string, code: ErrorCode, details?: any) {
+    super(message, code, details, false);
+    this.name = "PaymentError";
+  }
+}
+
 // SDK Events interface with proper typing
 export interface SDKEvents {
   // Connection events
@@ -303,11 +318,63 @@ export interface SDKEvents {
   "room:message": (roomId: string, message: z.infer<typeof BaseMessageSchema>) => void;
   "room:list": (rooms: z.infer<typeof RoomInfoSchema>[]) => void;
 
+  // Room Management events (v2.0.0)
+  "room:created": (room: z.infer<typeof RoomInfoSchema>) => void;
+  "room:updated": (room: z.infer<typeof RoomInfoSchema>) => void;
+  "room:deleted": (roomId: string) => void;
+  "room:create_error": (error: Error) => void;
+  "room:update_error": (error: Error, roomId?: string) => void;
+  "room:delete_error": (error: Error, roomId?: string) => void;
+
+  // Agent Room Management events (v2.0.0)
+  "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:status_update": (data: {
+    roomId: string;
+    agentId: string;
+    status: string;
+    agent?: any;
+  }) => void;
+  "agent_room:add_error": (error: Error, roomId?: string) => void;
+  "agent_room:remove_error": (error: Error, roomId?: string) => void;
+  "agent_room:list_error": (error: Error, roomId?: string) => void;
+  "agent_room:list_available_error": (error: Error) => void;
+
   // Coordinator events
   "coordinator:processing": (userRequest: string) => void;
   "coordinator:selected": (agentId: string, reasoning: string) => void;
   "coordinator:error": (error: string) => void;
 
+  // Quote-Approve Payment events (v2.2.0)
+  "quote:received": (quote: any) => void;
+  "quote:expired": (taskId: 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;
+
+  // Rate Limit events
+  rate_limit: (notification: {
+    title: string;
+    message: string;
+    ctaText?: string;
+    ctaLink?: string;
+    messageType: string;
+    limitType: string;
+    resetAt?: string;
+  }) => void;
+
+  // Admin events
+  "admin:user_count": (data: { count: number; timestamp?: string }) => void;
+  "admin:status_changed": (isAdmin: boolean) => void;
+
+  // User Presence events
+  "user:authenticated": (data: { wallet: string }) => void;
+
+  // User Preferences events
+  "preferences:updated": (data: { maxPricePerRequest?: number | null }) => void;
+
   // Webhook events
   "webhook:sent": (payload: any, url: string) => void;
   "webhook:success": (response: any, url: string) => void;

package/src/types/index.ts

@@ -14,6 +14,7 @@ export {
 
   // Supporting schemas
   CapabilitySchema,
+  CommandPricingSchema,
   CommandSchema,
   RoomSchema,
   AgentSchema,
@@ -40,6 +41,12 @@ export {
   TaskResponseMessageSchema,
   AgentSelectedMessageSchema,
 
+  // Quote-Approve Flow schemas (v2.2.0)
+  PricingInfoSchema,
+  RequestTaskMessageSchema,
+  TaskQuoteMessageSchema,
+  ConfirmTaskMessageSchema,
+
   // System message schemas
   AgentsListMessageSchema,
   ErrorMessageSchema,
@@ -55,6 +62,33 @@ export {
   RoomInfoSchema,
   ListRoomsResponseSchema,
 
+  // Room Management schemas (v2.0.0)
+  CreateRoomMessageSchema,
+  UpdateRoomMessageSchema,
+  DeleteRoomMessageSchema,
+  RoomOperationResponseSchema,
+  RoomMemberInfoSchema,
+  AddRoomMemberMessageSchema,
+  RemoveRoomMemberMessageSchema,
+  ListRoomMembersMessageSchema,
+  RoomMembersResponseSchema,
+  RoomMemberOperationResponseSchema,
+
+  // Agent Room Management schemas (v2.0.0)
+  AgentRoomInfoSchema,
+  AddAgentToRoomMessageSchema,
+  RemoveAgentFromRoomMessageSchema,
+  ListRoomAgentsMessageSchema,
+  ListAvailableAgentsMessageSchema,
+  AgentStatusUpdateMessageSchema,
+  RoomAgentsResponseSchema,
+  AvailableAgentsResponseSchema,
+  AgentRoomOperationResponseSchema,
+
+  // Room Ping schemas (v2.0.0)
+  RoomPingMessageSchema,
+  RoomPongResponseSchema,
+
   // Union schema
   AnyMessageSchema,
 
@@ -65,6 +99,7 @@ export {
   type AgentType,
   type AgentStatus,
   type Capability,
+  type CommandPricing,
   type Command,
   type Room,
   type Agent,
@@ -82,6 +117,12 @@ export {
   type TaskMessage,
   type TaskResponseMessage,
   type AgentSelectedMessage,
+
+  // Quote-Approve Flow types (v2.2.0)
+  type PricingInfo,
+  type RequestTaskMessage,
+  type TaskQuoteMessage,
+  type ConfirmTaskMessage,
   type AgentsListMessage,
   type ErrorMessage,
   type PingMessage,
@@ -93,6 +134,64 @@ export {
   type UnsubscribeResponse,
   type RoomInfo,
   type ListRoomsResponse,
+
+  // Room Management types (v2.0.0)
+  type CreateRoomMessage,
+  type UpdateRoomMessage,
+  type DeleteRoomMessage,
+  type RoomOperationResponse,
+  type RoomMemberInfo,
+  type AddRoomMemberMessage,
+  type RemoveRoomMemberMessage,
+  type ListRoomMembersMessage,
+  type RoomMembersResponse,
+  type RoomMemberOperationResponse,
+
+  // Agent Room Management types (v2.0.0)
+  type AgentRoomInfo,
+  type AddAgentToRoomMessage,
+  type RemoveAgentFromRoomMessage,
+  type ListRoomAgentsMessage,
+  type ListAvailableAgentsMessage,
+  type AgentStatusUpdateMessage,
+  type RoomAgentsResponse,
+  type AvailableAgentsResponse,
+  type AgentRoomOperationResponse,
+
+  // Room Ping types (v2.0.0)
+  type RoomPingMessage,
+  type RoomPongResponse,
+
+  // Admin types
+  AdminAgentInfoSchema,
+  ListAllAgentsMessageSchema,
+  AllAgentsResponseSchema,
+  UserCountDataSchema,
+  UserCountMessageSchema,
+  UserAuthenticatedMessageSchema,
+  RateLimitNotificationMessageSchema,
+  GetAgentDetailsMessageSchema,
+  AgentDetailsResponseMessageSchema,
+  type AdminAgentInfo,
+  type ListAllAgentsMessage,
+  type AllAgentsResponse,
+  type UserCountData,
+  type UserCountMessage,
+  type UserAuthenticatedMessage,
+  type RateLimitNotificationMessage,
+  type GetAgentDetailsMessage,
+  type AgentDetailsResponseMessage,
+
+  // User Preferences types
+  SetUserPreferencesDataSchema,
+  SetUserPreferencesMessageSchema,
+  UserPreferencesUpdatedDataSchema,
+  UserPreferencesUpdatedMessageSchema,
+  type SetUserPreferencesData,
+  type SetUserPreferencesMessage,
+  type UserPreferencesUpdatedData,
+  type UserPreferencesUpdatedMessage,
+
   type AnyMessage,
 
   // Type guards
@@ -114,6 +213,9 @@ export {
   createSubscribe,
   createUnsubscribe,
   createListRooms,
+  createRequestTask,
+  createConfirmTask,
+  createSetUserPreferences,
 
   // Validation helpers
   validateMessage,
@@ -186,6 +288,7 @@ export {
   ValidationError,
   TimeoutError,
   RateLimitError,
+  PaymentError,
 
   // Validation helpers
   validateEventData,
@@ -197,3 +300,11 @@ export { ErrorCode } from "./error-codes";
 
 // Health status types
 export { type HealthStatus } from "./health";
+
+// Agent category types
+export {
+  AGENT_CATEGORIES,
+  MAX_CATEGORIES,
+  AgentCategorySchema,
+  type AgentCategory
+} from "./categories";

package/src/types/messages.test.ts

@@ -20,7 +20,8 @@ import {
 describe("stringToBoolean transform", () => {
   // Test stringToBoolean indirectly through RoomSchema which uses it for is_public and is_active
 
-  const createTestRoom = (is_public: any, is_active: any) => ({
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const createTestRoom = (is_public: unknown, is_active: unknown) => ({
     id: "room-1",
     name: "Test Room",
     is_public,