@teneo-protocol/sdk 2.0.0 → 2.2.1

package/src/types/config.ts

@@ -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
@@ -222,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
@@ -779,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

@@ -42,6 +42,16 @@ export enum ErrorCode {
   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
@@ -332,6 +347,34 @@ export interface SDKEvents {
   "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,
@@ -92,6 +99,7 @@ export {
   type AgentType,
   type AgentStatus,
   type Capability,
+  type CommandPricing,
   type Command,
   type Room,
   type Agent,
@@ -109,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,
@@ -148,6 +162,36 @@ export {
   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
@@ -169,6 +213,9 @@ export {
   createSubscribe,
   createUnsubscribe,
   createListRooms,
+  createRequestTask,
+  createConfirmTask,
+  createSetUserPreferences,
 
   // Validation helpers
   validateMessage,
@@ -241,6 +288,7 @@ export {
   ValidationError,
   TimeoutError,
   RateLimitError,
+  PaymentError,
 
   // Validation helpers
   validateEventData,
@@ -252,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,

package/src/types/messages.ts

@@ -4,6 +4,7 @@
  */
 
 import { z } from "zod";
+import { AgentCategorySchema, MAX_CATEGORIES } from "./categories";
 
 /**
  * Coerces string booleans to actual booleans with strict validation.
@@ -63,6 +64,11 @@ export const MessageTypeSchema = z.enum([
   "task_response",
   "agent_selected",
 
+  // Quote-Approve Flow (v2.2.0)
+  "request_task",
+  "task_quote",
+  "confirm_task",
+
   // System
   "agents",
   "error",
@@ -74,6 +80,7 @@ export const MessageTypeSchema = z.enum([
   "subscribe",
   "unsubscribe",
   "list_rooms",
+  "room_list_response",
 
   // === NEW IN v2.0.0 ===
 
@@ -104,7 +111,20 @@ export const MessageTypeSchema = z.enum([
 
   // Room Ping System (2 types)
   "room_ping",
-  "room_pong"
+  "room_pong",
+
+  // Admin Messages (7 types)
+  "list_all_agents",
+  "all_agents_response",
+  "user_count",
+  "user_authenticated",
+  "rate_limit_notification",
+  "get_agent_details",
+  "agent_details_response",
+
+  // User Preferences (2 types)
+  "set_user_preferences",
+  "user_preferences_updated"
 ]);
 
 export const ContentTypeSchema = z.enum([
@@ -131,10 +151,20 @@ export const CapabilitySchema = z.object({
   description: z.string().optional()
 });
 
+export const CommandPricingSchema = z.object({
+  priceType: z.string().optional(),
+  pricePerUnit: z.number().optional(),
+  taskUnit: z.string().optional(),
+  timeUnit: z.enum(["hour", "day"]).optional()
+});
+
+export type CommandPricing = z.infer<typeof CommandPricingSchema>;
+
 export const CommandSchema = z.object({
   trigger: z.string(),
   argument: z.string().optional(),
-  description: z.string().optional()
+  description: z.string().optional(),
+  pricing: CommandPricingSchema.optional()
 });
 
 export const RoomSchema = z.object({
@@ -174,7 +204,8 @@ export const AgentSchema = z.object({
   image: z.string().optional(),
   agentType: AgentTypeSchema.optional(),
   nlpFallback: stringToBoolean.optional(),
-  webhookUrl: z.string().url().optional()
+  webhookUrl: z.string().url().optional(),
+  categories: z.array(AgentCategorySchema).max(MAX_CATEGORIES).optional()
 });
 
 // Base message schema
@@ -354,6 +385,62 @@ export const AgentSelectedMessageSchema = BaseMessageSchema.extend({
   })
 });
 
+// ============================================================================
+// QUOTE-APPROVE FLOW SCHEMAS (v2.2.0)
+// ============================================================================
+
+// Pricing information schema (flexible to handle server variations)
+export const PricingInfoSchema = z
+  .object({
+    pricePerUnit: z.number().optional(),
+    price_per_unit: z.number().optional(),
+    priceType: z.string().optional(),
+    price_type: z.string().optional(),
+    timeUnit: z.string().optional(),
+    time_unit: z.string().optional(),
+    currency: z.string().optional().default("USDC"),
+    network: z.string().optional()
+  })
+  .transform((data) => ({
+    // Normalize to camelCase
+    pricePerUnit: data.pricePerUnit ?? data.price_per_unit ?? 0,
+    priceType: data.priceType ?? data.price_type,
+    timeUnit: data.timeUnit ?? data.time_unit,
+    currency: data.currency,
+    network: data.network
+  }));
+
+// Request task message (initiates quote-approve flow)
+export const RequestTaskMessageSchema = BaseMessageSchema.extend({
+  type: z.literal("request_task"),
+  content: z.string(),
+  room: z.string()
+});
+
+// Task quote message (server response with pricing)
+export const TaskQuoteMessageSchema = BaseMessageSchema.extend({
+  type: z.literal("task_quote"),
+  from: z.literal("coordinator"),
+  data: z.object({
+    task_id: z.string(),
+    agent_id: z.string(),
+    agent_name: z.string(),
+    agent_wallet: z.string(),
+    command: z.string(),
+    pricing: PricingInfoSchema,
+    expires_at: z.string()
+  })
+});
+
+// Confirm task message (with payment at top level - backend expects msg.payment)
+export const ConfirmTaskMessageSchema = BaseMessageSchema.extend({
+  type: z.literal("confirm_task"),
+  data: z.object({
+    task_id: z.string()
+  }),
+  payment: z.string().optional() // x402 payment at top level (backend checks msg.Payment)
+});
+
 // System message schemas
 export const AgentsListMessageSchema = BaseMessageSchema.extend({
   type: z.literal("agents"),
@@ -420,7 +507,7 @@ export const UnsubscribeResponseSchema = BaseMessageSchema.extend({
 });
 
 export const ListRoomsResponseSchema = BaseMessageSchema.extend({
-  type: z.literal("list_rooms"),
+  type: z.literal("room_list_response"),
   data: z.object({
     rooms: z.array(RoomInfoSchema)
   })
@@ -548,7 +635,8 @@ export const AgentRoomInfoSchema = z
     image: z.string().optional(),
     status: z.string().optional(),
     added_by: z.string().optional(),
-    added_at: z.string().optional()
+    added_at: z.string().optional(),
+    categories: z.array(AgentCategorySchema).max(MAX_CATEGORIES).optional()
   })
   .passthrough();
 
@@ -655,6 +743,171 @@ export const RoomPongResponseSchema = z
   })
   .passthrough();
 
+// Admin agent info (admin only)
+export const AdminAgentInfoSchema = z
+  .object({
+    agent_id: z.string(),
+    agent_name: z.string(),
+    creator: z.string(),
+    creator_name: z.string().optional().nullable(),
+    description: z.string().optional().nullable(),
+    image_url: z.string().optional().nullable(),
+    is_online: z.boolean().optional(),
+    is_active: z.boolean().optional(),
+    is_verified: z.boolean().optional(),
+    is_public: z.boolean().optional(),
+    is_banned: z.boolean().optional(),
+    created_at: z.string().optional().nullable()
+  })
+  .passthrough();
+
+export type AdminAgentInfo = z.infer<typeof AdminAgentInfoSchema>;
+
+// List all agents request (client → server, admin only)
+export const ListAllAgentsMessageSchema = z
+  .object({
+    type: z.literal("list_all_agents"),
+    request_id: z.string().optional(),
+    filter: z.string().optional(),
+    offset: z.number().optional(),
+    limit: z.number().optional()
+  })
+  .passthrough();
+
+export type ListAllAgentsMessage = z.infer<typeof ListAllAgentsMessageSchema>;
+
+// All agents response (server → client, admin only)
+export const AllAgentsResponseSchema = z
+  .object({
+    type: z.literal("all_agents_response"),
+    request_id: z.string().optional(),
+    data: z
+      .object({
+        agents: z.array(AdminAgentInfoSchema),
+        total: z.number(),
+        offset: z.number(),
+        limit: z.number(),
+        has_more: z.boolean(),
+        filter: z.string().optional()
+      })
+      .passthrough()
+  })
+  .passthrough();
+
+export type AllAgentsResponse = z.infer<typeof AllAgentsResponseSchema>;
+
+// User count data schema
+export const UserCountDataSchema = z.object({
+  count: z.number(),
+  timestamp: z.string()
+});
+
+export type UserCountData = z.infer<typeof UserCountDataSchema>;
+
+// User count message (server → client, admin only)
+export const UserCountMessageSchema = z
+  .object({
+    type: z.literal("user_count"),
+    data: UserCountDataSchema.passthrough()
+  })
+  .passthrough();
+
+export type UserCountMessage = z.infer<typeof UserCountMessageSchema>;
+
+// User authenticated message (server → client)
+export const UserAuthenticatedMessageSchema = z
+  .object({
+    type: z.literal("user_authenticated"),
+    data: z
+      .object({
+        wallet: z.string()
+      })
+      .passthrough()
+  })
+  .passthrough();
+
+export type UserAuthenticatedMessage = z.infer<typeof UserAuthenticatedMessageSchema>;
+
+// Rate limit notification (server → client)
+export const RateLimitNotificationMessageSchema = z
+  .object({
+    type: z.literal("rate_limit_notification"),
+    data: z
+      .object({
+        title: z.string(),
+        message: z.string(),
+        cta_text: z.string().optional(),
+        cta_link: z.string().optional(),
+        message_type: z.string(),
+        limit_type: z.string(),
+        reset_at: z.string().optional()
+      })
+      .passthrough()
+  })
+  .passthrough();
+
+export type RateLimitNotificationMessage = z.infer<typeof RateLimitNotificationMessageSchema>;
+
+// Agent details request (client → server)
+export const GetAgentDetailsMessageSchema = z
+  .object({
+    type: z.literal("get_agent_details"),
+    agent_id: z.string(),
+    request_id: z.string().optional()
+  })
+  .passthrough();
+
+export type GetAgentDetailsMessage = z.infer<typeof GetAgentDetailsMessageSchema>;
+
+// Agent details response (server → client)
+export const AgentDetailsResponseMessageSchema = z
+  .object({
+    type: z.literal("agent_details_response"),
+    request_id: z.string().optional(),
+    data: z
+      .object({
+        agent: AgentRoomInfoSchema
+      })
+      .passthrough()
+      .optional(),
+    error: z.string().optional()
+  })
+  .passthrough();
+
+export type AgentDetailsResponseMessage = z.infer<typeof AgentDetailsResponseMessageSchema>;
+
+// User Preferences (set_user_preferences)
+export const SetUserPreferencesDataSchema = z.object({
+  max_price_per_request: z.number().min(0).optional().nullable()
+});
+
+export const SetUserPreferencesMessageSchema = z
+  .object({
+    type: z.literal("set_user_preferences"),
+    data: SetUserPreferencesDataSchema
+  })
+  .passthrough();
+
+export type SetUserPreferencesData = z.infer<typeof SetUserPreferencesDataSchema>;
+export type SetUserPreferencesMessage = z.infer<typeof SetUserPreferencesMessageSchema>;
+
+// User Preferences Response (user_preferences_updated)
+export const UserPreferencesUpdatedDataSchema = z.object({
+  success: z.boolean(),
+  message: z.string(),
+  max_price_per_request: z.number().optional().nullable()
+});
+
+export const UserPreferencesUpdatedMessageSchema = z
+  .object({
+    type: z.literal("user_preferences_updated"),
+    data: UserPreferencesUpdatedDataSchema
+  })
+  .passthrough();
+
+export type UserPreferencesUpdatedData = z.infer<typeof UserPreferencesUpdatedDataSchema>;
+export type UserPreferencesUpdatedMessage = z.infer<typeof UserPreferencesUpdatedMessageSchema>;
+
 // Union of all INCOMING message schemas for validation
 // Note: Outgoing message schemas (Subscribe, Unsubscribe, ListRooms) are excluded
 // as they share the same type values with their response counterparts
@@ -677,6 +930,9 @@ export const AnyMessageSchema = z.discriminatedUnion("type", [
   AgentSelectedMessageSchema,
   AgentsListMessageSchema,
 
+  // Quote-Approve Flow (v2.2.0)
+  TaskQuoteMessageSchema,
+
   // System
   ErrorMessageSchema,
   PingMessageSchema,
@@ -699,7 +955,17 @@ export const AnyMessageSchema = z.discriminatedUnion("type", [
   AgentStatusUpdateMessageSchema,
 
   // Room Ping System (v2.0.0)
-  RoomPongResponseSchema
+  RoomPongResponseSchema,
+
+  // Admin Messages
+  AllAgentsResponseSchema,
+  UserCountMessageSchema,
+  UserAuthenticatedMessageSchema,
+  RateLimitNotificationMessageSchema,
+  AgentDetailsResponseMessageSchema,
+
+  // User Preferences
+  UserPreferencesUpdatedMessageSchema
 ]);
 
 // Type inference from schemas
@@ -729,6 +995,13 @@ export type TaskMessage = z.infer<typeof TaskMessageSchema>;
 export type TaskResponseMessage = z.infer<typeof TaskResponseMessageSchema>;
 export type AgentSelectedMessage = z.infer<typeof AgentSelectedMessageSchema>;
 export type AgentsListMessage = z.infer<typeof AgentsListMessageSchema>;
+
+// Quote-Approve Flow Types (v2.2.0)
+export type PricingInfo = z.infer<typeof PricingInfoSchema>;
+export type RequestTaskMessage = z.infer<typeof RequestTaskMessageSchema>;
+export type TaskQuoteMessage = z.infer<typeof TaskQuoteMessageSchema>;
+export type ConfirmTaskMessage = z.infer<typeof ConfirmTaskMessageSchema>;
+
 export type ErrorMessage = z.infer<typeof ErrorMessageSchema>;
 export type PingMessage = z.infer<typeof PingMessageSchema>;
 export type PongMessage = z.infer<typeof PongMessageSchema>;
@@ -875,6 +1148,36 @@ export function createListRooms(): ListRoomsMessage {
   });
 }
 
+// Quote-Approve Flow factory functions (v2.2.0)
+export function createRequestTask(content: string, room: string): RequestTaskMessage {
+  return RequestTaskMessageSchema.parse({
+    type: "request_task",
+    content,
+    room
+  });
+}
+
+export function createConfirmTask(taskId: string, x402Payment?: string): ConfirmTaskMessage {
+  return ConfirmTaskMessageSchema.parse({
+    type: "confirm_task",
+    data: {
+      task_id: taskId
+    },
+    ...(x402Payment && { payment: x402Payment }) // payment at top level for backend
+  });
+}
+
+export function createSetUserPreferences(
+  maxPricePerRequest?: number | null
+): SetUserPreferencesMessage {
+  return SetUserPreferencesMessageSchema.parse({
+    type: "set_user_preferences",
+    data: {
+      max_price_per_request: maxPricePerRequest
+    }
+  });
+}
+
 // Validation helper
 export function validateMessage(message: unknown): AnyMessage {
   return AnyMessageSchema.parse(message);