@teneo-protocol/sdk 2.2.2 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (231) hide show
  1. package/.github/ISSUE_TEMPLATE/config.yml +1 -1
  2. package/CHANGELOG.md +366 -15
  3. package/CONCEPTS.md +182 -44
  4. package/README.md +524 -94
  5. package/dist/constants.d.ts +3 -1
  6. package/dist/constants.d.ts.map +1 -1
  7. package/dist/constants.js +5 -3
  8. package/dist/constants.js.map +1 -1
  9. package/dist/core/websocket-client.d.ts.map +1 -1
  10. package/dist/core/websocket-client.js +9 -5
  11. package/dist/core/websocket-client.js.map +1 -1
  12. package/dist/formatters/response-formatter.d.ts +6 -6
  13. package/dist/handlers/message-handlers/agent-details-response-handler.d.ts +1080 -756
  14. package/dist/handlers/message-handlers/agent-details-response-handler.d.ts.map +1 -1
  15. package/dist/handlers/message-handlers/agent-details-response-handler.js +2 -2
  16. package/dist/handlers/message-handlers/agent-details-response-handler.js.map +1 -1
  17. package/dist/handlers/message-handlers/agent-error-handler.d.ts +91 -0
  18. package/dist/handlers/message-handlers/agent-error-handler.d.ts.map +1 -0
  19. package/dist/handlers/message-handlers/agent-error-handler.js +44 -0
  20. package/dist/handlers/message-handlers/agent-error-handler.js.map +1 -0
  21. package/dist/handlers/message-handlers/agent-selected-handler.d.ts +6 -0
  22. package/dist/handlers/message-handlers/agent-selected-handler.d.ts.map +1 -1
  23. package/dist/handlers/message-handlers/agent-status-update-handler.d.ts +1080 -756
  24. package/dist/handlers/message-handlers/agent-status-update-handler.d.ts.map +1 -1
  25. package/dist/handlers/message-handlers/agent-status-update-handler.js +2 -7
  26. package/dist/handlers/message-handlers/agent-status-update-handler.js.map +1 -1
  27. package/dist/handlers/message-handlers/all-agents-response-handler.d.ts +135 -54
  28. package/dist/handlers/message-handlers/all-agents-response-handler.d.ts.map +1 -1
  29. package/dist/handlers/message-handlers/all-agents-response-handler.js +2 -2
  30. package/dist/handlers/message-handlers/all-agents-response-handler.js.map +1 -1
  31. package/dist/handlers/message-handlers/auth-error-handler.d.ts +6 -0
  32. package/dist/handlers/message-handlers/auth-error-handler.d.ts.map +1 -1
  33. package/dist/handlers/message-handlers/auth-message-handler.d.ts.map +1 -1
  34. package/dist/handlers/message-handlers/auth-message-handler.js +6 -1
  35. package/dist/handlers/message-handlers/auth-message-handler.js.map +1 -1
  36. package/dist/handlers/message-handlers/auth-required-handler.d.ts +6 -0
  37. package/dist/handlers/message-handlers/auth-required-handler.d.ts.map +1 -1
  38. package/dist/handlers/message-handlers/auth-success-handler.d.ts.map +1 -1
  39. package/dist/handlers/message-handlers/auth-success-handler.js +6 -1
  40. package/dist/handlers/message-handlers/auth-success-handler.js.map +1 -1
  41. package/dist/handlers/message-handlers/base-handler.d.ts +2 -1
  42. package/dist/handlers/message-handlers/base-handler.d.ts.map +1 -1
  43. package/dist/handlers/message-handlers/base-handler.js +24 -4
  44. package/dist/handlers/message-handlers/base-handler.js.map +1 -1
  45. package/dist/handlers/message-handlers/challenge-handler.d.ts +6 -0
  46. package/dist/handlers/message-handlers/challenge-handler.d.ts.map +1 -1
  47. package/dist/handlers/message-handlers/error-message-handler.d.ts +6 -0
  48. package/dist/handlers/message-handlers/error-message-handler.d.ts.map +1 -1
  49. package/dist/handlers/message-handlers/index.d.ts +4 -0
  50. package/dist/handlers/message-handlers/index.d.ts.map +1 -1
  51. package/dist/handlers/message-handlers/index.js +23 -1
  52. package/dist/handlers/message-handlers/index.js.map +1 -1
  53. package/dist/handlers/message-handlers/list-available-agents-handler.d.ts +1116 -756
  54. package/dist/handlers/message-handlers/list-available-agents-handler.d.ts.map +1 -1
  55. package/dist/handlers/message-handlers/list-available-agents-handler.js +23 -10
  56. package/dist/handlers/message-handlers/list-available-agents-handler.js.map +1 -1
  57. package/dist/handlers/message-handlers/list-room-agents-handler.d.ts +1080 -756
  58. package/dist/handlers/message-handlers/list-room-agents-handler.d.ts.map +1 -1
  59. package/dist/handlers/message-handlers/list-room-agents-handler.js +2 -6
  60. package/dist/handlers/message-handlers/list-room-agents-handler.js.map +1 -1
  61. package/dist/handlers/message-handlers/list-rooms-response-handler.d.ts.map +1 -1
  62. package/dist/handlers/message-handlers/list-rooms-response-handler.js +2 -5
  63. package/dist/handlers/message-handlers/list-rooms-response-handler.js.map +1 -1
  64. package/dist/handlers/message-handlers/ping-pong-handler.d.ts +52 -4
  65. package/dist/handlers/message-handlers/ping-pong-handler.d.ts.map +1 -1
  66. package/dist/handlers/message-handlers/ping-pong-handler.js +23 -4
  67. package/dist/handlers/message-handlers/ping-pong-handler.js.map +1 -1
  68. package/dist/handlers/message-handlers/rate-limit-notification-handler.d.ts.map +1 -1
  69. package/dist/handlers/message-handlers/rate-limit-notification-handler.js +3 -2
  70. package/dist/handlers/message-handlers/rate-limit-notification-handler.js.map +1 -1
  71. package/dist/handlers/message-handlers/regular-message-handler.d.ts +6 -0
  72. package/dist/handlers/message-handlers/regular-message-handler.d.ts.map +1 -1
  73. package/dist/handlers/message-handlers/subscribe-response-handler.d.ts +12 -6
  74. package/dist/handlers/message-handlers/subscribe-response-handler.d.ts.map +1 -1
  75. package/dist/handlers/message-handlers/success-handler.d.ts +82 -0
  76. package/dist/handlers/message-handlers/success-handler.d.ts.map +1 -0
  77. package/dist/handlers/message-handlers/success-handler.js +24 -0
  78. package/dist/handlers/message-handlers/success-handler.js.map +1 -0
  79. package/dist/handlers/message-handlers/task-confirmed-handler.d.ts +110 -0
  80. package/dist/handlers/message-handlers/task-confirmed-handler.d.ts.map +1 -0
  81. package/dist/handlers/message-handlers/task-confirmed-handler.js +46 -0
  82. package/dist/handlers/message-handlers/task-confirmed-handler.js.map +1 -0
  83. package/dist/handlers/message-handlers/trigger-wallet-tx-handler.d.ts +244 -0
  84. package/dist/handlers/message-handlers/trigger-wallet-tx-handler.d.ts.map +1 -0
  85. package/dist/handlers/message-handlers/trigger-wallet-tx-handler.js +58 -0
  86. package/dist/handlers/message-handlers/trigger-wallet-tx-handler.js.map +1 -0
  87. package/dist/handlers/message-handlers/unsubscribe-response-handler.d.ts +12 -6
  88. package/dist/handlers/message-handlers/unsubscribe-response-handler.d.ts.map +1 -1
  89. package/dist/handlers/message-handlers/user-authenticated-handler.js +2 -2
  90. package/dist/handlers/message-handlers/user-authenticated-handler.js.map +1 -1
  91. package/dist/handlers/message-handlers/user-count-handler.js +2 -2
  92. package/dist/handlers/message-handlers/user-count-handler.js.map +1 -1
  93. package/dist/index.d.ts +3 -3
  94. package/dist/index.d.ts.map +1 -1
  95. package/dist/index.js +11 -4
  96. package/dist/index.js.map +1 -1
  97. package/dist/managers/admin-manager.d.ts +3 -1
  98. package/dist/managers/admin-manager.d.ts.map +1 -1
  99. package/dist/managers/admin-manager.js +4 -3
  100. package/dist/managers/admin-manager.js.map +1 -1
  101. package/dist/managers/agent-room-manager.d.ts +89 -11
  102. package/dist/managers/agent-room-manager.d.ts.map +1 -1
  103. package/dist/managers/agent-room-manager.js +99 -35
  104. package/dist/managers/agent-room-manager.js.map +1 -1
  105. package/dist/managers/index.d.ts +1 -1
  106. package/dist/managers/index.d.ts.map +1 -1
  107. package/dist/managers/index.js.map +1 -1
  108. package/dist/managers/message-router.d.ts +45 -5
  109. package/dist/managers/message-router.d.ts.map +1 -1
  110. package/dist/managers/message-router.js +96 -24
  111. package/dist/managers/message-router.js.map +1 -1
  112. package/dist/managers/room-manager.d.ts +29 -7
  113. package/dist/managers/room-manager.d.ts.map +1 -1
  114. package/dist/managers/room-manager.js +37 -11
  115. package/dist/managers/room-manager.js.map +1 -1
  116. package/dist/payments/index.d.ts +3 -1
  117. package/dist/payments/index.d.ts.map +1 -1
  118. package/dist/payments/index.js +17 -3
  119. package/dist/payments/index.js.map +1 -1
  120. package/dist/payments/networks.d.ts +59 -0
  121. package/dist/payments/networks.d.ts.map +1 -0
  122. package/dist/payments/networks.js +192 -0
  123. package/dist/payments/networks.js.map +1 -0
  124. package/dist/payments/payment-client.d.ts +55 -10
  125. package/dist/payments/payment-client.d.ts.map +1 -1
  126. package/dist/payments/payment-client.js +172 -51
  127. package/dist/payments/payment-client.js.map +1 -1
  128. package/dist/teneo-sdk.d.ts +215 -41
  129. package/dist/teneo-sdk.d.ts.map +1 -1
  130. package/dist/teneo-sdk.js +361 -84
  131. package/dist/teneo-sdk.js.map +1 -1
  132. package/dist/types/config.d.ts +334 -25
  133. package/dist/types/config.d.ts.map +1 -1
  134. package/dist/types/config.js +114 -22
  135. package/dist/types/config.js.map +1 -1
  136. package/dist/types/events.d.ts +60 -14
  137. package/dist/types/events.d.ts.map +1 -1
  138. package/dist/types/events.js.map +1 -1
  139. package/dist/types/index.d.ts +1 -1
  140. package/dist/types/index.d.ts.map +1 -1
  141. package/dist/types/index.js +11 -4
  142. package/dist/types/index.js.map +1 -1
  143. package/dist/types/messages.d.ts +13110 -7451
  144. package/dist/types/messages.d.ts.map +1 -1
  145. package/dist/types/messages.js +195 -44
  146. package/dist/types/messages.js.map +1 -1
  147. package/dist/utils/pricing-resolver.d.ts +1 -1
  148. package/dist/utils/pricing-resolver.d.ts.map +1 -1
  149. package/dist/utils/pricing-resolver.js +9 -1
  150. package/dist/utils/pricing-resolver.js.map +1 -1
  151. package/examples/agent-room-management-example.ts +5 -5
  152. package/examples/basic-usage.ts +26 -6
  153. package/examples/claude-agent-x-follower/index.ts +1 -1
  154. package/examples/minimal-chat.ts +4 -3
  155. package/examples/n8n-teneo/index.ts +2 -2
  156. package/examples/nestjs-dashboard/README.md +1 -1
  157. package/examples/nestjs-dashboard/src/teneo/agents.controller.ts +3 -3
  158. package/examples/nestjs-dashboard/src/teneo/rooms.controller.ts +5 -5
  159. package/examples/nestjs-dashboard/src/teneo/teneo.service.ts +8 -8
  160. package/examples/openai-teneo/index.ts +1 -1
  161. package/examples/payment-flow.ts +143 -0
  162. package/examples/production-dashboard/README.md +6 -8
  163. package/examples/production-dashboard/server.ts +22 -10
  164. package/examples/room-management-example.ts +2 -2
  165. package/examples/usage/01-connect.ts +0 -3
  166. package/examples/usage/02-list-agents.ts +0 -2
  167. package/examples/usage/03-pick-agent.ts +3 -4
  168. package/examples/usage/04-find-by-capability.ts +10 -12
  169. package/examples/usage/05-webhook-example.ts +2 -4
  170. package/examples/usage/06-simple-api-server.ts +13 -9
  171. package/examples/usage/07-event-listener.ts +1 -13
  172. package/examples/usage/README.md +33 -7
  173. package/examples/webhook-integration.ts +9 -9
  174. package/examples/x-influencer-battle-server.ts +1 -1
  175. package/package.json +1 -1
  176. package/scripts/diagnose-connection.ts +86 -0
  177. package/scripts/investigate-payload.ts +163 -0
  178. package/scripts/list-agents.ts +58 -0
  179. package/scripts/live-multi-network-test.ts +230 -0
  180. package/src/constants.ts +5 -3
  181. package/src/core/websocket-client.ts +10 -9
  182. package/src/handlers/message-handlers/agent-details-response-handler.ts +2 -2
  183. package/src/handlers/message-handlers/agent-error-handler.ts +47 -0
  184. package/src/handlers/message-handlers/agent-status-update-handler.ts +2 -7
  185. package/src/handlers/message-handlers/all-agents-response-handler.ts +2 -2
  186. package/src/handlers/message-handlers/auth-message-handler.ts +7 -1
  187. package/src/handlers/message-handlers/auth-success-handler.ts +7 -1
  188. package/src/handlers/message-handlers/base-handler.ts +24 -4
  189. package/src/handlers/message-handlers/index.ts +24 -0
  190. package/src/handlers/message-handlers/list-available-agents-handler.ts +24 -11
  191. package/src/handlers/message-handlers/list-room-agents-handler.ts +2 -6
  192. package/src/handlers/message-handlers/list-rooms-response-handler.ts +2 -5
  193. package/src/handlers/message-handlers/ping-pong-handler.ts +29 -4
  194. package/src/handlers/message-handlers/rate-limit-notification-handler.ts +3 -2
  195. package/src/handlers/message-handlers/success-handler.ts +26 -0
  196. package/src/handlers/message-handlers/task-confirmed-handler.ts +49 -0
  197. package/src/handlers/message-handlers/trigger-wallet-tx-handler.ts +62 -0
  198. package/src/handlers/message-handlers/user-authenticated-handler.ts +2 -2
  199. package/src/handlers/message-handlers/user-count-handler.ts +2 -2
  200. package/src/index.ts +12 -4
  201. package/src/managers/admin-manager.ts +6 -3
  202. package/src/managers/agent-room-manager.ts +155 -26
  203. package/src/managers/index.ts +6 -1
  204. package/src/managers/message-router.ts +122 -27
  205. package/src/managers/room-manager.ts +39 -11
  206. package/src/payments/index.ts +20 -5
  207. package/src/payments/networks.ts +208 -0
  208. package/src/payments/payment-client.ts +211 -56
  209. package/src/teneo-sdk.ts +402 -71
  210. package/src/types/config.test.ts +24 -4
  211. package/src/types/config.ts +123 -25
  212. package/src/types/events.ts +36 -2
  213. package/src/types/index.ts +16 -3
  214. package/src/types/messages.ts +235 -60
  215. package/src/utils/pricing-resolver.ts +10 -2
  216. package/tests/direct-agent-test.ts +1 -1
  217. package/tests/integration/real-server.test.ts +1 -1
  218. package/tests/integration/websocket.test.ts +3 -3
  219. package/tests/multi-network-payment.test.ts +309 -0
  220. package/tests/multi-network.test.ts +296 -0
  221. package/tests/payment-flow-test.ts +6 -4
  222. package/tests/unit/handlers/agent-error-handler.test.ts +388 -0
  223. package/tests/unit/handlers/agent-room-operation-response-handler.test.ts +9 -6
  224. package/tests/unit/handlers/agent-status-update-handler.test.ts +11 -16
  225. package/tests/unit/handlers/list-available-agents-handler.test.ts +11 -14
  226. package/tests/unit/handlers/list-room-agents-handler.test.ts +11 -15
  227. package/tests/unit/handlers/room-operation-response-handler.test.ts +9 -6
  228. package/tests/unit/handlers/trigger-wallet-tx-handler.test.ts +431 -0
  229. package/tests/unit/managers/admin-manager.test.ts +183 -0
  230. package/tests/unit/managers/agent-room-manager.test.ts +189 -33
  231. package/tests/unit/sdk-new-methods.test.ts +221 -0
@@ -15,13 +15,15 @@ export interface Logger {
15
15
  export declare const LoggerSchema: z.ZodType<Logger>;
16
16
  export declare const LogLevelSchema: z.ZodEnum<["debug", "info", "warn", "error", "silent"]>;
17
17
  export declare const ResponseFormatSchema: z.ZodEnum<["raw", "humanized", "both"]>;
18
- export declare const WebhookEventTypeSchema: z.ZodEnum<["message", "task", "task_response", "agent_selected", "error", "connection_state", "auth_state"]>;
19
- export declare const SDKConfigSchema: z.ZodObject<{
18
+ export declare const WebhookEventTypeSchema: z.ZodEnum<["message", "task", "task_response", "agent_selected", "error", "connection_state", "auth_state", "agent_error", "room_operation_error", "agent_room_operation_error", "task_quote", "task_confirmed", "wallet_tx_requested", "room_subscribed", "room_unsubscribed", "room_deleted", "room_operation", "agent_room_operation"]>;
19
+ export declare const SDKConfigSchema: z.ZodEffects<z.ZodObject<{
20
20
  wsUrl: z.ZodEffects<z.ZodString, string, string>;
21
21
  privateKey: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<SecurePrivateKey, z.ZodTypeDef, SecurePrivateKey>]>>;
22
22
  walletAddress: z.ZodOptional<z.ZodString>;
23
23
  clientType: z.ZodOptional<z.ZodEnum<["user", "agent", "coordinator"]>>;
24
24
  clientName: z.ZodOptional<z.ZodString>;
25
+ autoJoinPublicRooms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
26
+ /** @deprecated Use autoJoinPublicRooms instead */
25
27
  autoJoinRooms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
26
28
  webhookUrl: z.ZodOptional<z.ZodString>;
27
29
  webhookHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -87,7 +89,7 @@ export declare const SDKConfigSchema: z.ZodObject<{
87
89
  maxCacheSize: z.ZodOptional<z.ZodNumber>;
88
90
  validateSignatures: z.ZodOptional<z.ZodBoolean>;
89
91
  trustedAgentAddresses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
90
- requireSignaturesFor: z.ZodOptional<z.ZodArray<z.ZodEnum<["request_challenge", "challenge", "check_cached_auth", "auth", "auth_required", "auth_success", "auth_error", "register", "registration_success", "message", "task", "task_response", "agent_selected", "request_task", "task_quote", "confirm_task", "agents", "error", "ping", "pong", "capabilities", "subscribe", "unsubscribe", "list_rooms", "room_list_response", "create_room", "update_room", "delete_room", "add_room_member", "remove_room_member", "list_room_members", "room_operation_response", "room_member_operation_response", "room_members_response", "add_agent_to_room", "remove_agent_from_room", "list_room_agents", "list_available_agents", "agent_status_update", "agent_room_operation_response", "room_agents_response", "available_agents_response", "room_ping", "room_pong", "list_all_agents", "all_agents_response", "user_count", "user_authenticated", "rate_limit_notification", "get_agent_details", "agent_details_response", "set_user_preferences", "user_preferences_updated"]>, "many">>;
92
+ requireSignaturesFor: z.ZodOptional<z.ZodArray<z.ZodEnum<["request_challenge", "challenge", "check_cached_auth", "auth", "auth_required", "auth_success", "auth_error", "register", "registration_success", "message", "task", "task_response", "agent_selected", "request_task", "task_quote", "confirm_task", "task_confirmed", "agents", "error", "success", "ping", "pong", "capabilities", "subscribe", "unsubscribe", "list_rooms", "room_list_response", "create_room", "update_room", "delete_room", "add_room_member", "remove_room_member", "list_room_members", "room_operation_response", "room_member_operation_response", "room_members_response", "add_agent_to_room", "remove_agent_from_room", "list_room_agents", "list_available_agents", "agent_status_update", "agent_room_operation_response", "room_agents_response", "available_agents_response", "room_ping", "list_all_agents", "all_agents_response", "user_count", "user_authenticated", "rate_limit_notification", "get_agent_details", "agent_details_response", "set_user_preferences", "user_preferences_updated", "set_api_key_preference", "agent_error", "trigger_wallet_tx", "tx_result"]>, "many">>;
91
93
  strictSignatureValidation: z.ZodOptional<z.ZodBoolean>;
92
94
  allowInsecureWebhooks: z.ZodOptional<z.ZodBoolean>;
93
95
  enableMessageDeduplication: z.ZodOptional<z.ZodBoolean>;
@@ -98,13 +100,17 @@ export declare const SDKConfigSchema: z.ZodObject<{
98
100
  quoteTimeout: z.ZodOptional<z.ZodNumber>;
99
101
  paymentNetwork: z.ZodOptional<z.ZodString>;
100
102
  paymentAsset: z.ZodOptional<z.ZodString>;
103
+ network: z.ZodOptional<z.ZodString>;
104
+ networkChainId: z.ZodOptional<z.ZodNumber>;
101
105
  }, "strip", z.ZodTypeAny, {
102
106
  wsUrl: string;
103
107
  webhookUrl?: string | undefined;
108
+ network?: string | undefined;
104
109
  privateKey?: string | SecurePrivateKey | undefined;
105
110
  walletAddress?: string | undefined;
106
111
  clientType?: "user" | "agent" | "coordinator" | undefined;
107
112
  clientName?: string | undefined;
113
+ autoJoinPublicRooms?: string[] | undefined;
108
114
  autoJoinRooms?: string[] | undefined;
109
115
  webhookHeaders?: Record<string, string> | undefined;
110
116
  webhookRetries?: number | undefined;
@@ -141,7 +147,7 @@ export declare const SDKConfigSchema: z.ZodObject<{
141
147
  maxCacheSize?: number | undefined;
142
148
  validateSignatures?: boolean | undefined;
143
149
  trustedAgentAddresses?: string[] | undefined;
144
- requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "agents" | "error" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "room_pong" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated")[] | undefined;
150
+ requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "task_confirmed" | "agents" | "error" | "success" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated" | "set_api_key_preference" | "agent_error" | "trigger_wallet_tx" | "tx_result")[] | undefined;
145
151
  strictSignatureValidation?: boolean | undefined;
146
152
  allowInsecureWebhooks?: boolean | undefined;
147
153
  enableMessageDeduplication?: boolean | undefined;
@@ -152,13 +158,16 @@ export declare const SDKConfigSchema: z.ZodObject<{
152
158
  quoteTimeout?: number | undefined;
153
159
  paymentNetwork?: string | undefined;
154
160
  paymentAsset?: string | undefined;
161
+ networkChainId?: number | undefined;
155
162
  }, {
156
163
  wsUrl: string;
157
164
  webhookUrl?: string | undefined;
165
+ network?: string | undefined;
158
166
  privateKey?: string | SecurePrivateKey | undefined;
159
167
  walletAddress?: string | undefined;
160
168
  clientType?: "user" | "agent" | "coordinator" | undefined;
161
169
  clientName?: string | undefined;
170
+ autoJoinPublicRooms?: string[] | undefined;
162
171
  autoJoinRooms?: string[] | undefined;
163
172
  webhookHeaders?: Record<string, string> | undefined;
164
173
  webhookRetries?: number | undefined;
@@ -195,7 +204,7 @@ export declare const SDKConfigSchema: z.ZodObject<{
195
204
  maxCacheSize?: number | undefined;
196
205
  validateSignatures?: boolean | undefined;
197
206
  trustedAgentAddresses?: string[] | undefined;
198
- requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "agents" | "error" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "room_pong" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated")[] | undefined;
207
+ requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "task_confirmed" | "agents" | "error" | "success" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated" | "set_api_key_preference" | "agent_error" | "trigger_wallet_tx" | "tx_result")[] | undefined;
199
208
  strictSignatureValidation?: boolean | undefined;
200
209
  allowInsecureWebhooks?: boolean | undefined;
201
210
  enableMessageDeduplication?: boolean | undefined;
@@ -206,13 +215,129 @@ export declare const SDKConfigSchema: z.ZodObject<{
206
215
  quoteTimeout?: number | undefined;
207
216
  paymentNetwork?: string | undefined;
208
217
  paymentAsset?: string | undefined;
218
+ networkChainId?: number | undefined;
219
+ }>, {
220
+ wsUrl: string;
221
+ webhookUrl?: string | undefined;
222
+ network?: string | undefined;
223
+ privateKey?: string | SecurePrivateKey | undefined;
224
+ walletAddress?: string | undefined;
225
+ clientType?: "user" | "agent" | "coordinator" | undefined;
226
+ clientName?: string | undefined;
227
+ autoJoinPublicRooms?: string[] | undefined;
228
+ autoJoinRooms?: string[] | undefined;
229
+ webhookHeaders?: Record<string, string> | undefined;
230
+ webhookRetries?: number | undefined;
231
+ webhookTimeout?: number | undefined;
232
+ webhookRetryStrategy?: {
233
+ type: "exponential" | "linear" | "constant";
234
+ baseDelay: number;
235
+ maxDelay: number;
236
+ maxAttempts: number;
237
+ jitter: boolean;
238
+ backoffMultiplier?: number | undefined;
239
+ } | undefined;
240
+ reconnect?: boolean | undefined;
241
+ reconnectDelay?: number | undefined;
242
+ maxReconnectAttempts?: number | undefined;
243
+ connectionTimeout?: number | undefined;
244
+ reconnectStrategy?: {
245
+ type: "exponential" | "linear" | "constant";
246
+ baseDelay: number;
247
+ maxDelay: number;
248
+ maxAttempts: number;
249
+ jitter: boolean;
250
+ backoffMultiplier?: number | undefined;
251
+ } | undefined;
252
+ messageTimeout?: number | undefined;
253
+ maxMessageSize?: number | undefined;
254
+ maxMessagesPerSecond?: number | undefined;
255
+ responseFormat?: "raw" | "humanized" | "both" | undefined;
256
+ includeMetadata?: boolean | undefined;
257
+ logLevel?: "error" | "debug" | "info" | "warn" | "silent" | undefined;
258
+ logger?: Logger | undefined;
259
+ enableCache?: boolean | undefined;
260
+ cacheTimeout?: number | undefined;
261
+ maxCacheSize?: number | undefined;
262
+ validateSignatures?: boolean | undefined;
263
+ trustedAgentAddresses?: string[] | undefined;
264
+ requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "task_confirmed" | "agents" | "error" | "success" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated" | "set_api_key_preference" | "agent_error" | "trigger_wallet_tx" | "tx_result")[] | undefined;
265
+ strictSignatureValidation?: boolean | undefined;
266
+ allowInsecureWebhooks?: boolean | undefined;
267
+ enableMessageDeduplication?: boolean | undefined;
268
+ messageDedupeTtl?: number | undefined;
269
+ messageDedupMaxSize?: number | undefined;
270
+ autoApproveQuotes?: boolean | undefined;
271
+ maxPricePerRequest?: number | undefined;
272
+ quoteTimeout?: number | undefined;
273
+ paymentNetwork?: string | undefined;
274
+ paymentAsset?: string | undefined;
275
+ networkChainId?: number | undefined;
276
+ }, {
277
+ wsUrl: string;
278
+ webhookUrl?: string | undefined;
279
+ network?: string | undefined;
280
+ privateKey?: string | SecurePrivateKey | undefined;
281
+ walletAddress?: string | undefined;
282
+ clientType?: "user" | "agent" | "coordinator" | undefined;
283
+ clientName?: string | undefined;
284
+ autoJoinPublicRooms?: string[] | undefined;
285
+ autoJoinRooms?: string[] | undefined;
286
+ webhookHeaders?: Record<string, string> | undefined;
287
+ webhookRetries?: number | undefined;
288
+ webhookTimeout?: number | undefined;
289
+ webhookRetryStrategy?: {
290
+ type: "exponential" | "linear" | "constant";
291
+ baseDelay: number;
292
+ maxDelay: number;
293
+ maxAttempts: number;
294
+ jitter: boolean;
295
+ backoffMultiplier?: number | undefined;
296
+ } | undefined;
297
+ reconnect?: boolean | undefined;
298
+ reconnectDelay?: number | undefined;
299
+ maxReconnectAttempts?: number | undefined;
300
+ connectionTimeout?: number | undefined;
301
+ reconnectStrategy?: {
302
+ type: "exponential" | "linear" | "constant";
303
+ baseDelay: number;
304
+ maxDelay: number;
305
+ maxAttempts: number;
306
+ jitter: boolean;
307
+ backoffMultiplier?: number | undefined;
308
+ } | undefined;
309
+ messageTimeout?: number | undefined;
310
+ maxMessageSize?: number | undefined;
311
+ maxMessagesPerSecond?: number | undefined;
312
+ responseFormat?: "raw" | "humanized" | "both" | undefined;
313
+ includeMetadata?: boolean | undefined;
314
+ logLevel?: "error" | "debug" | "info" | "warn" | "silent" | undefined;
315
+ logger?: Logger | undefined;
316
+ enableCache?: boolean | undefined;
317
+ cacheTimeout?: number | undefined;
318
+ maxCacheSize?: number | undefined;
319
+ validateSignatures?: boolean | undefined;
320
+ trustedAgentAddresses?: string[] | undefined;
321
+ requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "task_confirmed" | "agents" | "error" | "success" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated" | "set_api_key_preference" | "agent_error" | "trigger_wallet_tx" | "tx_result")[] | undefined;
322
+ strictSignatureValidation?: boolean | undefined;
323
+ allowInsecureWebhooks?: boolean | undefined;
324
+ enableMessageDeduplication?: boolean | undefined;
325
+ messageDedupeTtl?: number | undefined;
326
+ messageDedupMaxSize?: number | undefined;
327
+ autoApproveQuotes?: boolean | undefined;
328
+ maxPricePerRequest?: number | undefined;
329
+ quoteTimeout?: number | undefined;
330
+ paymentNetwork?: string | undefined;
331
+ paymentAsset?: string | undefined;
332
+ networkChainId?: number | undefined;
209
333
  }>;
210
- export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
334
+ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
211
335
  wsUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
212
336
  privateKey: z.ZodOptional<z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodType<SecurePrivateKey, z.ZodTypeDef, SecurePrivateKey>]>>>;
213
337
  walletAddress: z.ZodOptional<z.ZodOptional<z.ZodString>>;
214
338
  clientType: z.ZodOptional<z.ZodOptional<z.ZodEnum<["user", "agent", "coordinator"]>>>;
215
339
  clientName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
340
+ autoJoinPublicRooms: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
216
341
  autoJoinRooms: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
217
342
  webhookUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
218
343
  webhookHeaders: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
@@ -278,7 +403,7 @@ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
278
403
  maxCacheSize: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
279
404
  validateSignatures: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
280
405
  trustedAgentAddresses: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
281
- requireSignaturesFor: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<["request_challenge", "challenge", "check_cached_auth", "auth", "auth_required", "auth_success", "auth_error", "register", "registration_success", "message", "task", "task_response", "agent_selected", "request_task", "task_quote", "confirm_task", "agents", "error", "ping", "pong", "capabilities", "subscribe", "unsubscribe", "list_rooms", "room_list_response", "create_room", "update_room", "delete_room", "add_room_member", "remove_room_member", "list_room_members", "room_operation_response", "room_member_operation_response", "room_members_response", "add_agent_to_room", "remove_agent_from_room", "list_room_agents", "list_available_agents", "agent_status_update", "agent_room_operation_response", "room_agents_response", "available_agents_response", "room_ping", "room_pong", "list_all_agents", "all_agents_response", "user_count", "user_authenticated", "rate_limit_notification", "get_agent_details", "agent_details_response", "set_user_preferences", "user_preferences_updated"]>, "many">>>;
406
+ requireSignaturesFor: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<["request_challenge", "challenge", "check_cached_auth", "auth", "auth_required", "auth_success", "auth_error", "register", "registration_success", "message", "task", "task_response", "agent_selected", "request_task", "task_quote", "confirm_task", "task_confirmed", "agents", "error", "success", "ping", "pong", "capabilities", "subscribe", "unsubscribe", "list_rooms", "room_list_response", "create_room", "update_room", "delete_room", "add_room_member", "remove_room_member", "list_room_members", "room_operation_response", "room_member_operation_response", "room_members_response", "add_agent_to_room", "remove_agent_from_room", "list_room_agents", "list_available_agents", "agent_status_update", "agent_room_operation_response", "room_agents_response", "available_agents_response", "room_ping", "list_all_agents", "all_agents_response", "user_count", "user_authenticated", "rate_limit_notification", "get_agent_details", "agent_details_response", "set_user_preferences", "user_preferences_updated", "set_api_key_preference", "agent_error", "trigger_wallet_tx", "tx_result"]>, "many">>>;
282
407
  strictSignatureValidation: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
283
408
  allowInsecureWebhooks: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
284
409
  enableMessageDeduplication: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
@@ -289,13 +414,17 @@ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
289
414
  quoteTimeout: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
290
415
  paymentNetwork: z.ZodOptional<z.ZodOptional<z.ZodString>>;
291
416
  paymentAsset: z.ZodOptional<z.ZodOptional<z.ZodString>>;
417
+ network: z.ZodOptional<z.ZodOptional<z.ZodString>>;
418
+ networkChainId: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
292
419
  }, "strip", z.ZodTypeAny, {
293
420
  webhookUrl?: string | undefined;
421
+ network?: string | undefined;
294
422
  wsUrl?: string | undefined;
295
423
  privateKey?: string | SecurePrivateKey | undefined;
296
424
  walletAddress?: string | undefined;
297
425
  clientType?: "user" | "agent" | "coordinator" | undefined;
298
426
  clientName?: string | undefined;
427
+ autoJoinPublicRooms?: string[] | undefined;
299
428
  autoJoinRooms?: string[] | undefined;
300
429
  webhookHeaders?: Record<string, string> | undefined;
301
430
  webhookRetries?: number | undefined;
@@ -332,7 +461,7 @@ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
332
461
  maxCacheSize?: number | undefined;
333
462
  validateSignatures?: boolean | undefined;
334
463
  trustedAgentAddresses?: string[] | undefined;
335
- requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "agents" | "error" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "room_pong" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated")[] | undefined;
464
+ requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "task_confirmed" | "agents" | "error" | "success" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated" | "set_api_key_preference" | "agent_error" | "trigger_wallet_tx" | "tx_result")[] | undefined;
336
465
  strictSignatureValidation?: boolean | undefined;
337
466
  allowInsecureWebhooks?: boolean | undefined;
338
467
  enableMessageDeduplication?: boolean | undefined;
@@ -343,13 +472,16 @@ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
343
472
  quoteTimeout?: number | undefined;
344
473
  paymentNetwork?: string | undefined;
345
474
  paymentAsset?: string | undefined;
475
+ networkChainId?: number | undefined;
346
476
  }, {
347
477
  webhookUrl?: string | undefined;
478
+ network?: string | undefined;
348
479
  wsUrl?: string | undefined;
349
480
  privateKey?: string | SecurePrivateKey | undefined;
350
481
  walletAddress?: string | undefined;
351
482
  clientType?: "user" | "agent" | "coordinator" | undefined;
352
483
  clientName?: string | undefined;
484
+ autoJoinPublicRooms?: string[] | undefined;
353
485
  autoJoinRooms?: string[] | undefined;
354
486
  webhookHeaders?: Record<string, string> | undefined;
355
487
  webhookRetries?: number | undefined;
@@ -386,7 +518,7 @@ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
386
518
  maxCacheSize?: number | undefined;
387
519
  validateSignatures?: boolean | undefined;
388
520
  trustedAgentAddresses?: string[] | undefined;
389
- requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "agents" | "error" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "room_pong" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated")[] | undefined;
521
+ requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "task_confirmed" | "agents" | "error" | "success" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated" | "set_api_key_preference" | "agent_error" | "trigger_wallet_tx" | "tx_result")[] | undefined;
390
522
  strictSignatureValidation?: boolean | undefined;
391
523
  allowInsecureWebhooks?: boolean | undefined;
392
524
  enableMessageDeduplication?: boolean | undefined;
@@ -397,13 +529,16 @@ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
397
529
  quoteTimeout?: number | undefined;
398
530
  paymentNetwork?: string | undefined;
399
531
  paymentAsset?: string | undefined;
532
+ networkChainId?: number | undefined;
400
533
  }>, {
401
534
  webhookUrl?: string | undefined;
535
+ network?: string | undefined;
402
536
  wsUrl?: string | undefined;
403
537
  privateKey?: string | SecurePrivateKey | undefined;
404
538
  walletAddress?: string | undefined;
405
539
  clientType?: "user" | "agent" | "coordinator" | undefined;
406
540
  clientName?: string | undefined;
541
+ autoJoinPublicRooms?: string[] | undefined;
407
542
  autoJoinRooms?: string[] | undefined;
408
543
  webhookHeaders?: Record<string, string> | undefined;
409
544
  webhookRetries?: number | undefined;
@@ -440,7 +575,7 @@ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
440
575
  maxCacheSize?: number | undefined;
441
576
  validateSignatures?: boolean | undefined;
442
577
  trustedAgentAddresses?: string[] | undefined;
443
- requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "agents" | "error" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "room_pong" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated")[] | undefined;
578
+ requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "task_confirmed" | "agents" | "error" | "success" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated" | "set_api_key_preference" | "agent_error" | "trigger_wallet_tx" | "tx_result")[] | undefined;
444
579
  strictSignatureValidation?: boolean | undefined;
445
580
  allowInsecureWebhooks?: boolean | undefined;
446
581
  enableMessageDeduplication?: boolean | undefined;
@@ -451,13 +586,16 @@ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
451
586
  quoteTimeout?: number | undefined;
452
587
  paymentNetwork?: string | undefined;
453
588
  paymentAsset?: string | undefined;
589
+ networkChainId?: number | undefined;
454
590
  }, {
455
591
  webhookUrl?: string | undefined;
592
+ network?: string | undefined;
456
593
  wsUrl?: string | undefined;
457
594
  privateKey?: string | SecurePrivateKey | undefined;
458
595
  walletAddress?: string | undefined;
459
596
  clientType?: "user" | "agent" | "coordinator" | undefined;
460
597
  clientName?: string | undefined;
598
+ autoJoinPublicRooms?: string[] | undefined;
461
599
  autoJoinRooms?: string[] | undefined;
462
600
  webhookHeaders?: Record<string, string> | undefined;
463
601
  webhookRetries?: number | undefined;
@@ -494,7 +632,7 @@ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
494
632
  maxCacheSize?: number | undefined;
495
633
  validateSignatures?: boolean | undefined;
496
634
  trustedAgentAddresses?: string[] | undefined;
497
- requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "agents" | "error" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "room_pong" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated")[] | undefined;
635
+ requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "task_confirmed" | "agents" | "error" | "success" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated" | "set_api_key_preference" | "agent_error" | "trigger_wallet_tx" | "tx_result")[] | undefined;
498
636
  strictSignatureValidation?: boolean | undefined;
499
637
  allowInsecureWebhooks?: boolean | undefined;
500
638
  enableMessageDeduplication?: boolean | undefined;
@@ -505,6 +643,121 @@ export declare const PartialSDKConfigSchema: z.ZodEffects<z.ZodObject<{
505
643
  quoteTimeout?: number | undefined;
506
644
  paymentNetwork?: string | undefined;
507
645
  paymentAsset?: string | undefined;
646
+ networkChainId?: number | undefined;
647
+ }>, {
648
+ webhookUrl?: string | undefined;
649
+ network?: string | undefined;
650
+ wsUrl?: string | undefined;
651
+ privateKey?: string | SecurePrivateKey | undefined;
652
+ walletAddress?: string | undefined;
653
+ clientType?: "user" | "agent" | "coordinator" | undefined;
654
+ clientName?: string | undefined;
655
+ autoJoinPublicRooms?: string[] | undefined;
656
+ autoJoinRooms?: string[] | undefined;
657
+ webhookHeaders?: Record<string, string> | undefined;
658
+ webhookRetries?: number | undefined;
659
+ webhookTimeout?: number | undefined;
660
+ webhookRetryStrategy?: {
661
+ type: "exponential" | "linear" | "constant";
662
+ baseDelay: number;
663
+ maxDelay: number;
664
+ maxAttempts: number;
665
+ jitter: boolean;
666
+ backoffMultiplier?: number | undefined;
667
+ } | undefined;
668
+ reconnect?: boolean | undefined;
669
+ reconnectDelay?: number | undefined;
670
+ maxReconnectAttempts?: number | undefined;
671
+ connectionTimeout?: number | undefined;
672
+ reconnectStrategy?: {
673
+ type: "exponential" | "linear" | "constant";
674
+ baseDelay: number;
675
+ maxDelay: number;
676
+ maxAttempts: number;
677
+ jitter: boolean;
678
+ backoffMultiplier?: number | undefined;
679
+ } | undefined;
680
+ messageTimeout?: number | undefined;
681
+ maxMessageSize?: number | undefined;
682
+ maxMessagesPerSecond?: number | undefined;
683
+ responseFormat?: "raw" | "humanized" | "both" | undefined;
684
+ includeMetadata?: boolean | undefined;
685
+ logLevel?: "error" | "debug" | "info" | "warn" | "silent" | undefined;
686
+ logger?: Logger | undefined;
687
+ enableCache?: boolean | undefined;
688
+ cacheTimeout?: number | undefined;
689
+ maxCacheSize?: number | undefined;
690
+ validateSignatures?: boolean | undefined;
691
+ trustedAgentAddresses?: string[] | undefined;
692
+ requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "task_confirmed" | "agents" | "error" | "success" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated" | "set_api_key_preference" | "agent_error" | "trigger_wallet_tx" | "tx_result")[] | undefined;
693
+ strictSignatureValidation?: boolean | undefined;
694
+ allowInsecureWebhooks?: boolean | undefined;
695
+ enableMessageDeduplication?: boolean | undefined;
696
+ messageDedupeTtl?: number | undefined;
697
+ messageDedupMaxSize?: number | undefined;
698
+ autoApproveQuotes?: boolean | undefined;
699
+ maxPricePerRequest?: number | undefined;
700
+ quoteTimeout?: number | undefined;
701
+ paymentNetwork?: string | undefined;
702
+ paymentAsset?: string | undefined;
703
+ networkChainId?: number | undefined;
704
+ }, {
705
+ webhookUrl?: string | undefined;
706
+ network?: string | undefined;
707
+ wsUrl?: string | undefined;
708
+ privateKey?: string | SecurePrivateKey | undefined;
709
+ walletAddress?: string | undefined;
710
+ clientType?: "user" | "agent" | "coordinator" | undefined;
711
+ clientName?: string | undefined;
712
+ autoJoinPublicRooms?: string[] | undefined;
713
+ autoJoinRooms?: string[] | undefined;
714
+ webhookHeaders?: Record<string, string> | undefined;
715
+ webhookRetries?: number | undefined;
716
+ webhookTimeout?: number | undefined;
717
+ webhookRetryStrategy?: {
718
+ type: "exponential" | "linear" | "constant";
719
+ baseDelay: number;
720
+ maxDelay: number;
721
+ maxAttempts: number;
722
+ jitter: boolean;
723
+ backoffMultiplier?: number | undefined;
724
+ } | undefined;
725
+ reconnect?: boolean | undefined;
726
+ reconnectDelay?: number | undefined;
727
+ maxReconnectAttempts?: number | undefined;
728
+ connectionTimeout?: number | undefined;
729
+ reconnectStrategy?: {
730
+ type: "exponential" | "linear" | "constant";
731
+ baseDelay: number;
732
+ maxDelay: number;
733
+ maxAttempts: number;
734
+ jitter: boolean;
735
+ backoffMultiplier?: number | undefined;
736
+ } | undefined;
737
+ messageTimeout?: number | undefined;
738
+ maxMessageSize?: number | undefined;
739
+ maxMessagesPerSecond?: number | undefined;
740
+ responseFormat?: "raw" | "humanized" | "both" | undefined;
741
+ includeMetadata?: boolean | undefined;
742
+ logLevel?: "error" | "debug" | "info" | "warn" | "silent" | undefined;
743
+ logger?: Logger | undefined;
744
+ enableCache?: boolean | undefined;
745
+ cacheTimeout?: number | undefined;
746
+ maxCacheSize?: number | undefined;
747
+ validateSignatures?: boolean | undefined;
748
+ trustedAgentAddresses?: string[] | undefined;
749
+ requireSignaturesFor?: ("message" | "request_challenge" | "challenge" | "check_cached_auth" | "auth" | "auth_required" | "auth_success" | "auth_error" | "register" | "registration_success" | "task" | "task_response" | "agent_selected" | "request_task" | "task_quote" | "confirm_task" | "task_confirmed" | "agents" | "error" | "success" | "ping" | "pong" | "capabilities" | "subscribe" | "unsubscribe" | "list_rooms" | "room_list_response" | "create_room" | "update_room" | "delete_room" | "add_room_member" | "remove_room_member" | "list_room_members" | "room_operation_response" | "room_member_operation_response" | "room_members_response" | "add_agent_to_room" | "remove_agent_from_room" | "list_room_agents" | "list_available_agents" | "agent_status_update" | "agent_room_operation_response" | "room_agents_response" | "available_agents_response" | "room_ping" | "list_all_agents" | "all_agents_response" | "user_count" | "user_authenticated" | "rate_limit_notification" | "get_agent_details" | "agent_details_response" | "set_user_preferences" | "user_preferences_updated" | "set_api_key_preference" | "agent_error" | "trigger_wallet_tx" | "tx_result")[] | undefined;
750
+ strictSignatureValidation?: boolean | undefined;
751
+ allowInsecureWebhooks?: boolean | undefined;
752
+ enableMessageDeduplication?: boolean | undefined;
753
+ messageDedupeTtl?: number | undefined;
754
+ messageDedupMaxSize?: number | undefined;
755
+ autoApproveQuotes?: boolean | undefined;
756
+ maxPricePerRequest?: number | undefined;
757
+ quoteTimeout?: number | undefined;
758
+ paymentNetwork?: string | undefined;
759
+ paymentAsset?: string | undefined;
760
+ networkChainId?: number | undefined;
508
761
  }>;
509
762
  export declare const ConnectionStateSchema: z.ZodObject<{
510
763
  connected: z.ZodBoolean;
@@ -573,6 +826,10 @@ export declare const AuthenticationStateSchema: z.ZodObject<{
573
826
  privateRoomIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
574
827
  sharedRoomIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
575
828
  maxPrivateRooms: z.ZodOptional<z.ZodNumber>;
829
+ jwtToken: z.ZodOptional<z.ZodString>;
830
+ sessionToken: z.ZodOptional<z.ZodString>;
831
+ whitelistVerified: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
832
+ userCount: z.ZodOptional<z.ZodNumber>;
576
833
  }, "strip", z.ZodTypeAny, {
577
834
  authenticated: boolean;
578
835
  challenge?: string | undefined;
@@ -597,6 +854,10 @@ export declare const AuthenticationStateSchema: z.ZodObject<{
597
854
  privateRoomIds?: string[] | undefined;
598
855
  sharedRoomIds?: string[] | undefined;
599
856
  maxPrivateRooms?: number | undefined;
857
+ jwtToken?: string | undefined;
858
+ sessionToken?: string | undefined;
859
+ whitelistVerified?: string | boolean | undefined;
860
+ userCount?: number | undefined;
600
861
  }, {
601
862
  authenticated: boolean;
602
863
  challenge?: string | undefined;
@@ -621,28 +882,32 @@ export declare const AuthenticationStateSchema: z.ZodObject<{
621
882
  privateRoomIds?: string[] | undefined;
622
883
  sharedRoomIds?: string[] | undefined;
623
884
  maxPrivateRooms?: number | undefined;
885
+ jwtToken?: string | undefined;
886
+ sessionToken?: string | undefined;
887
+ whitelistVerified?: string | boolean | undefined;
888
+ userCount?: number | undefined;
624
889
  }>;
625
890
  export declare const WebhookConfigSchema: z.ZodObject<{
626
891
  url: z.ZodString;
627
892
  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
628
893
  retries: z.ZodOptional<z.ZodNumber>;
629
894
  timeout: z.ZodOptional<z.ZodNumber>;
630
- events: z.ZodOptional<z.ZodArray<z.ZodEnum<["message", "task", "task_response", "agent_selected", "error", "connection_state", "auth_state"]>, "many">>;
895
+ events: z.ZodOptional<z.ZodArray<z.ZodEnum<["message", "task", "task_response", "agent_selected", "error", "connection_state", "auth_state", "agent_error", "room_operation_error", "agent_room_operation_error", "task_quote", "task_confirmed", "wallet_tx_requested", "room_subscribed", "room_unsubscribed", "room_deleted", "room_operation", "agent_room_operation"]>, "many">>;
631
896
  }, "strip", z.ZodTypeAny, {
632
897
  url: string;
633
898
  headers?: Record<string, string> | undefined;
634
899
  retries?: number | undefined;
635
900
  timeout?: number | undefined;
636
- events?: ("message" | "task" | "task_response" | "agent_selected" | "error" | "connection_state" | "auth_state")[] | undefined;
901
+ events?: ("message" | "task" | "task_response" | "agent_selected" | "task_quote" | "task_confirmed" | "error" | "agent_error" | "connection_state" | "auth_state" | "room_operation_error" | "agent_room_operation_error" | "wallet_tx_requested" | "room_subscribed" | "room_unsubscribed" | "room_deleted" | "room_operation" | "agent_room_operation")[] | undefined;
637
902
  }, {
638
903
  url: string;
639
904
  headers?: Record<string, string> | undefined;
640
905
  retries?: number | undefined;
641
906
  timeout?: number | undefined;
642
- events?: ("message" | "task" | "task_response" | "agent_selected" | "error" | "connection_state" | "auth_state")[] | undefined;
907
+ events?: ("message" | "task" | "task_response" | "agent_selected" | "task_quote" | "task_confirmed" | "error" | "agent_error" | "connection_state" | "auth_state" | "room_operation_error" | "agent_room_operation_error" | "wallet_tx_requested" | "room_subscribed" | "room_unsubscribed" | "room_deleted" | "room_operation" | "agent_room_operation")[] | undefined;
643
908
  }>;
644
909
  export declare const WebhookPayloadSchema: z.ZodObject<{
645
- event: z.ZodEnum<["message", "task", "task_response", "agent_selected", "error", "connection_state", "auth_state"]>;
910
+ event: z.ZodEnum<["message", "task", "task_response", "agent_selected", "error", "connection_state", "auth_state", "agent_error", "room_operation_error", "agent_room_operation_error", "task_quote", "task_confirmed", "wallet_tx_requested", "room_subscribed", "room_unsubscribed", "room_deleted", "room_operation", "agent_room_operation"]>;
646
911
  timestamp: z.ZodString;
647
912
  data: z.ZodAny;
648
913
  metadata: z.ZodOptional<z.ZodObject<{
@@ -663,7 +928,7 @@ export declare const WebhookPayloadSchema: z.ZodObject<{
663
928
  }>>;
664
929
  }, "strip", z.ZodTypeAny, {
665
930
  timestamp: string;
666
- event: "message" | "task" | "task_response" | "agent_selected" | "error" | "connection_state" | "auth_state";
931
+ event: "message" | "task" | "task_response" | "agent_selected" | "task_quote" | "task_confirmed" | "error" | "agent_error" | "connection_state" | "auth_state" | "room_operation_error" | "agent_room_operation_error" | "wallet_tx_requested" | "room_subscribed" | "room_unsubscribed" | "room_deleted" | "room_operation" | "agent_room_operation";
667
932
  data?: any;
668
933
  metadata?: {
669
934
  clientId?: string | undefined;
@@ -673,7 +938,7 @@ export declare const WebhookPayloadSchema: z.ZodObject<{
673
938
  } | undefined;
674
939
  }, {
675
940
  timestamp: string;
676
- event: "message" | "task" | "task_response" | "agent_selected" | "error" | "connection_state" | "auth_state";
941
+ event: "message" | "task" | "task_response" | "agent_selected" | "task_quote" | "task_confirmed" | "error" | "agent_error" | "connection_state" | "auth_state" | "room_operation_error" | "agent_room_operation_error" | "wallet_tx_requested" | "room_subscribed" | "room_unsubscribed" | "room_deleted" | "room_operation" | "agent_room_operation";
677
942
  data?: any;
678
943
  metadata?: {
679
944
  clientId?: string | undefined;
@@ -722,7 +987,7 @@ export declare function safeParseConfig(config: unknown): {
722
987
  * const config = new SDKConfigBuilder()
723
988
  * .withWebSocketUrl('wss://teneo.example.com')
724
989
  * .withAuthentication('0x...', '0xYourWalletAddress')
725
- * .withAutoJoinRooms(['general', 'announcements'])
990
+ * .withAutoJoinPublicRooms(['room-id-1', 'room-id-2'])
726
991
  * .withWebhook('https://api.example.com/webhooks', {
727
992
  * 'Authorization': 'Bearer token'
728
993
  * })
@@ -735,11 +1000,12 @@ export declare function safeParseConfig(config: unknown): {
735
1000
  * const sdk = new TeneoSDK(config);
736
1001
  *
737
1002
  * // Using via TeneoSDK.builder() (recommended)
738
- * const sdk = TeneoSDK.builder()
1003
+ * const config = TeneoSDK.builder()
739
1004
  * .withWebSocketUrl('wss://teneo.example.com')
740
1005
  * .withAuthentication('0x...')
741
- * .withAutoJoinRooms(['general'])
1006
+ * .withAutoJoinPublicRooms(['room-id-1'])
742
1007
  * .build();
1008
+ * const sdk = new TeneoSDK(config);
743
1009
  * ```
744
1010
  *
745
1011
  * @see {@link TeneoSDK} for the main SDK class
@@ -812,18 +1078,29 @@ export declare class SDKConfigBuilder {
812
1078
  */
813
1079
  withWebhook(url: string, headers?: Record<string, string>): this;
814
1080
  /**
815
- * Configures rooms to automatically subscribe to after authentication.
816
- * These rooms will be subscribed to automatically when connection is established.
1081
+ * Configures public rooms to automatically subscribe to after authentication.
1082
+ * These PUBLIC rooms will be subscribed to automatically when connection is established.
1083
+ * Note: Private rooms are automatically available after auth without needing subscription.
817
1084
  *
818
- * @param rooms - Array of room IDs to auto-subscribe to on connection
1085
+ * @param rooms - Array of public room IDs to auto-subscribe to on connection
819
1086
  * @returns this builder for method chaining
820
1087
  * @throws {z.ZodError} If room IDs are invalid
821
1088
  *
822
1089
  * @example
823
1090
  * ```typescript
824
- * builder.withAutoJoinRooms(['general', 'announcements', 'support'])
1091
+ * builder.withAutoJoinPublicRooms(['public-room-1', 'public-room-2'])
825
1092
  * ```
826
1093
  */
1094
+ withAutoJoinPublicRooms(rooms: string[]): this;
1095
+ /**
1096
+ * @deprecated Use withAutoJoinPublicRooms() instead. This method only affects public rooms.
1097
+ * Private rooms are automatically available after authentication without subscription.
1098
+ *
1099
+ * Configures public rooms to automatically subscribe to after authentication.
1100
+ *
1101
+ * @param rooms - Array of public room IDs to auto-subscribe to on connection
1102
+ * @returns this builder for method chaining
1103
+ */
827
1104
  withAutoJoinRooms(rooms: string[]): this;
828
1105
  /**
829
1106
  * Configures automatic reconnection behavior for WebSocket connections.
@@ -1102,6 +1379,38 @@ export declare class SDKConfigBuilder {
1102
1379
  network?: string;
1103
1380
  asset?: string;
1104
1381
  }): this;
1382
+ /**
1383
+ * Sets the default network by name for payment operations (v2.3.0).
1384
+ *
1385
+ * Priority order for network selection:
1386
+ * 1. Per-request network override in sendMessage options
1387
+ * 2. This builder setting
1388
+ * 3. TENEO_NETWORK environment variable
1389
+ * 4. Default: PEAQ (eip155:3338)
1390
+ *
1391
+ * @param network - Network name (peaq, base, avalanche)
1392
+ * @returns this builder for method chaining
1393
+ *
1394
+ * @example
1395
+ * ```typescript
1396
+ * builder.withNetwork("base") // Use Base Mainnet for payments
1397
+ * builder.withNetwork("avalanche") // Use Avalanche Mainnet
1398
+ * ```
1399
+ */
1400
+ withNetwork(network: string): this;
1401
+ /**
1402
+ * Sets the default network by chain ID for payment operations (v2.3.0).
1403
+ *
1404
+ * @param chainId - Chain ID (3338 for PEAQ, 8453 for Base, 43114 for Avalanche)
1405
+ * @returns this builder for method chaining
1406
+ *
1407
+ * @example
1408
+ * ```typescript
1409
+ * builder.withNetworkChainId(8453) // Use Base Mainnet for payments
1410
+ * builder.withNetworkChainId(43114) // Use Avalanche Mainnet
1411
+ * ```
1412
+ */
1413
+ withNetworkChainId(chainId: number): this;
1105
1414
  /**
1106
1415
  * Builds and validates the final SDK configuration.
1107
1416
  * Performs comprehensive validation including custom refinements (e.g., webhook security).
@@ -1116,7 +1425,7 @@ export declare class SDKConfigBuilder {
1116
1425
  * const config = new SDKConfigBuilder()
1117
1426
  * .withWebSocketUrl('wss://teneo.example.com')
1118
1427
  * .withAuthentication('0x...')
1119
- * .withAutoJoinRooms(['general'])
1428
+ * .withAutoJoinPublicRooms(['room-id-1'])
1120
1429
  * .build(); // Validates and returns final config
1121
1430
  *
1122
1431
  * const sdk = new TeneoSDK(config);