@signalwire/sdk 2.0.4 → 3.5.0

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 (656) hide show
  1. package/CHANGELOG.md +785 -0
  2. package/LICENSE +21 -0
  3. package/README.md +163 -68
  4. package/dist/AGENTS.md +13 -0
  5. package/dist/AgentBase.d.ts +550 -163
  6. package/dist/AgentBase.js +1640 -514
  7. package/dist/AgentBase.js.map +1 -1
  8. package/dist/AgentServer.d.ts +21 -0
  9. package/dist/AgentServer.js +154 -47
  10. package/dist/AgentServer.js.map +1 -1
  11. package/dist/AuthHandler.d.ts +14 -2
  12. package/dist/AuthHandler.js +7 -2
  13. package/dist/AuthHandler.js.map +1 -1
  14. package/dist/ConfigLoader.d.ts +5 -13
  15. package/dist/ConfigLoader.js +15 -29
  16. package/dist/ConfigLoader.js.map +1 -1
  17. package/dist/ContextBuilder.d.ts +202 -9
  18. package/dist/ContextBuilder.js +219 -36
  19. package/dist/ContextBuilder.js.map +1 -1
  20. package/dist/DataMap.d.ts +158 -45
  21. package/dist/DataMap.js +167 -52
  22. package/dist/DataMap.js.map +1 -1
  23. package/dist/FunctionResult.d.ts +277 -83
  24. package/dist/FunctionResult.js +444 -116
  25. package/dist/FunctionResult.js.map +1 -1
  26. package/dist/Logger.d.ts +30 -5
  27. package/dist/Logger.js +77 -19
  28. package/dist/Logger.js.map +1 -1
  29. package/dist/POM/PromptObjectModel.d.ts +163 -0
  30. package/dist/POM/PromptObjectModel.js +481 -0
  31. package/dist/POM/PromptObjectModel.js.map +1 -0
  32. package/dist/ParameterSchema.d.ts +306 -0
  33. package/dist/ParameterSchema.js +251 -0
  34. package/dist/ParameterSchema.js.map +1 -0
  35. package/dist/PlatformContracts.d.ts +21 -0
  36. package/dist/PlatformContracts.generated.d.ts +109 -0
  37. package/dist/PlatformContracts.generated.js +8 -0
  38. package/dist/PlatformContracts.generated.js.map +1 -0
  39. package/dist/PlatformContracts.js +2 -0
  40. package/dist/PlatformContracts.js.map +1 -0
  41. package/dist/PomBuilder.d.ts +28 -0
  42. package/dist/PomBuilder.js +81 -3
  43. package/dist/PomBuilder.js.map +1 -1
  44. package/dist/PostPrompt.d.ts +110 -0
  45. package/dist/PostPrompt.js +204 -0
  46. package/dist/PostPrompt.js.map +1 -0
  47. package/dist/PromptManager.d.ts +29 -1
  48. package/dist/PromptManager.js +37 -1
  49. package/dist/PromptManager.js.map +1 -1
  50. package/dist/PublicFetch.d.ts +132 -0
  51. package/dist/PublicFetch.js +311 -0
  52. package/dist/PublicFetch.js.map +1 -0
  53. package/dist/RobotsTxt.d.ts +41 -0
  54. package/dist/RobotsTxt.js +152 -0
  55. package/dist/RobotsTxt.js.map +1 -0
  56. package/dist/SWMLHandler.js.map +1 -1
  57. package/dist/SWMLService.d.ts +265 -66
  58. package/dist/SWMLService.js +652 -112
  59. package/dist/SWMLService.js.map +1 -1
  60. package/dist/SchemaUtils.d.ts +115 -2
  61. package/dist/SchemaUtils.js +444 -12
  62. package/dist/SchemaUtils.js.map +1 -1
  63. package/dist/SecurityUtils.d.ts +55 -8
  64. package/dist/SecurityUtils.js +162 -49
  65. package/dist/SecurityUtils.js.map +1 -1
  66. package/dist/ServerlessAdapter.d.ts +156 -7
  67. package/dist/ServerlessAdapter.js +399 -42
  68. package/dist/ServerlessAdapter.js.map +1 -1
  69. package/dist/SessionManager.d.ts +11 -2
  70. package/dist/SessionManager.js +50 -18
  71. package/dist/SessionManager.js.map +1 -1
  72. package/dist/SslConfig.d.ts +2 -1
  73. package/dist/SslConfig.js +4 -1
  74. package/dist/SslConfig.js.map +1 -1
  75. package/dist/SwaigActions.generated.d.ts +23 -0
  76. package/dist/SwaigActions.generated.js +8 -0
  77. package/dist/SwaigActions.generated.js.map +1 -0
  78. package/dist/SwaigContracts.d.ts +15 -0
  79. package/dist/SwaigContracts.generated.d.ts +264 -0
  80. package/dist/SwaigContracts.generated.js +12 -0
  81. package/dist/SwaigContracts.generated.js.map +1 -0
  82. package/dist/SwaigContracts.js +2 -0
  83. package/dist/SwaigContracts.js.map +1 -0
  84. package/dist/SwaigFunction.d.ts +110 -4
  85. package/dist/SwaigFunction.js +151 -19
  86. package/dist/SwaigFunction.js.map +1 -1
  87. package/dist/SwmlBuilder.d.ts +68 -19
  88. package/dist/SwmlBuilder.js +74 -38
  89. package/dist/SwmlBuilder.js.map +1 -1
  90. package/dist/SwmlVerbMethods.generated.d.ts +41 -4
  91. package/dist/SwmlVerbMethods.generated.js +1 -1
  92. package/dist/TypeInference.d.ts +39 -3
  93. package/dist/TypeInference.js +256 -16
  94. package/dist/TypeInference.js.map +1 -1
  95. package/dist/WebService.d.ts +79 -11
  96. package/dist/WebService.js +320 -109
  97. package/dist/WebService.js.map +1 -1
  98. package/dist/WebhookMiddleware.d.ts +119 -0
  99. package/dist/WebhookMiddleware.js +271 -0
  100. package/dist/WebhookMiddleware.js.map +1 -0
  101. package/dist/WebhookValidator.d.ts +92 -0
  102. package/dist/WebhookValidator.js +409 -0
  103. package/dist/WebhookValidator.js.map +1 -0
  104. package/dist/agents/BedrockAgent.d.ts +162 -0
  105. package/dist/agents/BedrockAgent.js +323 -0
  106. package/dist/agents/BedrockAgent.js.map +1 -0
  107. package/dist/ai-chat/AIChatClient.d.ts +316 -0
  108. package/dist/ai-chat/AIChatClient.js +535 -0
  109. package/dist/ai-chat/AIChatClient.js.map +1 -0
  110. package/dist/ai-chat/ChatGateway.d.ts +408 -0
  111. package/dist/ai-chat/ChatGateway.js +747 -0
  112. package/dist/ai-chat/ChatGateway.js.map +1 -0
  113. package/dist/ai-chat/HandoffRouter.d.ts +282 -0
  114. package/dist/ai-chat/HandoffRouter.js +518 -0
  115. package/dist/ai-chat/HandoffRouter.js.map +1 -0
  116. package/dist/ai-chat/index.d.ts +12 -0
  117. package/dist/ai-chat/index.js +10 -0
  118. package/dist/ai-chat/index.js.map +1 -0
  119. package/dist/capabilities.d.ts +64 -0
  120. package/dist/capabilities.js +95 -0
  121. package/dist/capabilities.js.map +1 -0
  122. package/dist/cli/agent-loader.d.ts +32 -6
  123. package/dist/cli/agent-loader.js +95 -34
  124. package/dist/cli/agent-loader.js.map +1 -1
  125. package/dist/cli/datamap-exec.d.ts +175 -0
  126. package/dist/cli/datamap-exec.js +1284 -0
  127. package/dist/cli/datamap-exec.js.map +1 -0
  128. package/dist/cli/function-args.d.ts +40 -0
  129. package/dist/cli/function-args.js +146 -0
  130. package/dist/cli/function-args.js.map +1 -0
  131. package/dist/cli/simulation.d.ts +99 -0
  132. package/dist/cli/simulation.js +490 -0
  133. package/dist/cli/simulation.js.map +1 -0
  134. package/dist/cli/swaig-test.d.ts +12 -25
  135. package/dist/cli/swaig-test.js +935 -367
  136. package/dist/cli/swaig-test.js.map +1 -1
  137. package/dist/cli/tsdocs/agentsNote.d.ts +30 -0
  138. package/dist/cli/tsdocs/agentsNote.js +92 -0
  139. package/dist/cli/tsdocs/agentsNote.js.map +1 -0
  140. package/dist/cli/tsdocs/api-index.json +1 -0
  141. package/dist/cli/tsdocs/api.d.ts +91 -0
  142. package/dist/cli/tsdocs/api.js +372 -0
  143. package/dist/cli/tsdocs/api.js.map +1 -0
  144. package/dist/cli/tsdocs/apiTypes.d.ts +64 -0
  145. package/dist/cli/tsdocs/apiTypes.js +7 -0
  146. package/dist/cli/tsdocs/apiTypes.js.map +1 -0
  147. package/dist/cli/tsdocs/bin.d.ts +6 -0
  148. package/dist/cli/tsdocs/bin.js +23 -0
  149. package/dist/cli/tsdocs/bin.js.map +1 -0
  150. package/dist/cli/tsdocs/files.d.ts +108 -0
  151. package/dist/cli/tsdocs/files.js +287 -0
  152. package/dist/cli/tsdocs/files.js.map +1 -0
  153. package/dist/cli/tsdocs/index.d.ts +28 -0
  154. package/dist/cli/tsdocs/index.js +307 -0
  155. package/dist/cli/tsdocs/index.js.map +1 -0
  156. package/dist/cli/tsdocs/live.d.ts +41 -0
  157. package/dist/cli/tsdocs/live.js +202 -0
  158. package/dist/cli/tsdocs/live.js.map +1 -0
  159. package/dist/cli/tsdocs/locate.d.ts +51 -0
  160. package/dist/cli/tsdocs/locate.js +75 -0
  161. package/dist/cli/tsdocs/locate.js.map +1 -0
  162. package/dist/cli/tsdocs/render.d.ts +75 -0
  163. package/dist/cli/tsdocs/render.js +323 -0
  164. package/dist/cli/tsdocs/render.js.map +1 -0
  165. package/dist/cli/tsdocs/topics.d.ts +43 -0
  166. package/dist/cli/tsdocs/topics.js +916 -0
  167. package/dist/cli/tsdocs/topics.js.map +1 -0
  168. package/dist/index.d.ts +102 -39
  169. package/dist/index.js +107 -30
  170. package/dist/index.js.map +1 -1
  171. package/dist/livewire/index.d.ts +229 -155
  172. package/dist/livewire/index.js +298 -195
  173. package/dist/livewire/index.js.map +1 -1
  174. package/dist/llms.txt +65 -0
  175. package/dist/prefabs/CallSessionStore.d.ts +52 -0
  176. package/dist/prefabs/CallSessionStore.js +72 -0
  177. package/dist/prefabs/CallSessionStore.js.map +1 -0
  178. package/dist/prefabs/ConciergeAgent.d.ts +13 -1
  179. package/dist/prefabs/ConciergeAgent.js +36 -31
  180. package/dist/prefabs/ConciergeAgent.js.map +1 -1
  181. package/dist/prefabs/FAQBotAgent.d.ts +9 -1
  182. package/dist/prefabs/FAQBotAgent.js +113 -47
  183. package/dist/prefabs/FAQBotAgent.js.map +1 -1
  184. package/dist/prefabs/InfoGathererAgent.d.ts +22 -3
  185. package/dist/prefabs/InfoGathererAgent.js +67 -58
  186. package/dist/prefabs/InfoGathererAgent.js.map +1 -1
  187. package/dist/prefabs/ReceptionistAgent.d.ts +16 -5
  188. package/dist/prefabs/ReceptionistAgent.js +39 -31
  189. package/dist/prefabs/ReceptionistAgent.js.map +1 -1
  190. package/dist/prefabs/SurveyAgent.d.ts +22 -4
  191. package/dist/prefabs/SurveyAgent.js +84 -68
  192. package/dist/prefabs/SurveyAgent.js.map +1 -1
  193. package/dist/relay/Action.d.ts +44 -21
  194. package/dist/relay/Action.js +75 -17
  195. package/dist/relay/Action.js.map +1 -1
  196. package/dist/relay/Call.d.ts +312 -47
  197. package/dist/relay/Call.js +369 -18
  198. package/dist/relay/Call.js.map +1 -1
  199. package/dist/relay/Deferred.js.map +1 -1
  200. package/dist/relay/Message.d.ts +26 -5
  201. package/dist/relay/Message.js +36 -6
  202. package/dist/relay/Message.js.map +1 -1
  203. package/dist/relay/RelayClient.d.ts +79 -14
  204. package/dist/relay/RelayClient.js +268 -61
  205. package/dist/relay/RelayClient.js.map +1 -1
  206. package/dist/relay/RelayError.d.ts +14 -0
  207. package/dist/relay/RelayError.js +15 -0
  208. package/dist/relay/RelayError.js.map +1 -1
  209. package/dist/relay/RelayEvent.d.ts +96 -65
  210. package/dist/relay/RelayEvent.js +85 -56
  211. package/dist/relay/RelayEvent.js.map +1 -1
  212. package/dist/relay/closedSets.d.ts +111 -0
  213. package/dist/relay/closedSets.js +83 -0
  214. package/dist/relay/closedSets.js.map +1 -0
  215. package/dist/relay/index.d.ts +3 -1
  216. package/dist/relay/index.js +1 -0
  217. package/dist/relay/index.js.map +1 -1
  218. package/dist/relay/normalize.js.map +1 -1
  219. package/dist/relay/protocol.types.generated.d.ts +1195 -0
  220. package/dist/relay/protocol.types.generated.js +8 -0
  221. package/dist/relay/protocol.types.generated.js.map +1 -0
  222. package/dist/relay/types.d.ts +81 -39
  223. package/dist/rest/HttpClient.d.ts +36 -8
  224. package/dist/rest/HttpClient.js +233 -40
  225. package/dist/rest/HttpClient.js.map +1 -1
  226. package/dist/rest/RequestOptions.d.ts +110 -0
  227. package/dist/rest/RequestOptions.js +113 -0
  228. package/dist/rest/RequestOptions.js.map +1 -0
  229. package/dist/rest/RestError.d.ts +52 -6
  230. package/dist/rest/RestError.js +89 -5
  231. package/dist/rest/RestError.js.map +1 -1
  232. package/dist/rest/base/CrudResource.d.ts +16 -26
  233. package/dist/rest/base/CrudResource.js +19 -33
  234. package/dist/rest/base/CrudResource.js.map +1 -1
  235. package/dist/rest/base/CrudWithAddresses.d.ts +3 -2
  236. package/dist/rest/base/CrudWithAddresses.js +2 -2
  237. package/dist/rest/base/CrudWithAddresses.js.map +1 -1
  238. package/dist/rest/base/FabricResource.d.ts +15 -0
  239. package/dist/rest/base/FabricResource.js +16 -0
  240. package/dist/rest/base/FabricResource.js.map +1 -0
  241. package/dist/rest/base/ReadResource.d.ts +62 -0
  242. package/dist/rest/base/ReadResource.js +69 -0
  243. package/dist/rest/base/ReadResource.js.map +1 -0
  244. package/dist/rest/callHandler.d.ts +63 -0
  245. package/dist/rest/callHandler.js +62 -0
  246. package/dist/rest/callHandler.js.map +1 -0
  247. package/dist/rest/index.d.ts +19 -76
  248. package/dist/rest/index.js +49 -120
  249. package/dist/rest/index.js.map +1 -1
  250. package/dist/rest/namespaces/_client_tree_generated.d.ts +103 -0
  251. package/dist/rest/namespaces/_client_tree_generated.js +171 -0
  252. package/dist/rest/namespaces/_client_tree_generated.js.map +1 -0
  253. package/dist/rest/namespaces/addresses.d.ts +3 -42
  254. package/dist/rest/namespaces/addresses.js +3 -50
  255. package/dist/rest/namespaces/addresses.js.map +1 -1
  256. package/dist/rest/namespaces/calling.d.ts +6 -378
  257. package/dist/rest/namespaces/calling.js +6 -473
  258. package/dist/rest/namespaces/calling.js.map +1 -1
  259. package/dist/rest/namespaces/calling.resources.generated.d.ts +165 -0
  260. package/dist/rest/namespaces/calling.resources.generated.js +477 -0
  261. package/dist/rest/namespaces/calling.resources.generated.js.map +1 -0
  262. package/dist/rest/namespaces/calling.types.generated.d.ts +2917 -0
  263. package/dist/rest/namespaces/calling.types.generated.js +8 -0
  264. package/dist/rest/namespaces/calling.types.generated.js.map +1 -0
  265. package/dist/rest/namespaces/chat.d.ts +4 -18
  266. package/dist/rest/namespaces/chat.js +4 -21
  267. package/dist/rest/namespaces/chat.js.map +1 -1
  268. package/dist/rest/namespaces/chat.resources.generated.d.ts +12 -0
  269. package/dist/rest/namespaces/chat.resources.generated.js +29 -0
  270. package/dist/rest/namespaces/chat.resources.generated.js.map +1 -0
  271. package/dist/rest/namespaces/chat.types.generated.d.ts +56 -0
  272. package/dist/rest/namespaces/chat.types.generated.js +8 -0
  273. package/dist/rest/namespaces/chat.types.generated.js.map +1 -0
  274. package/dist/rest/namespaces/datasphere.d.ts +6 -62
  275. package/dist/rest/namespaces/datasphere.js +6 -72
  276. package/dist/rest/namespaces/datasphere.js.map +1 -1
  277. package/dist/rest/namespaces/datasphere.resources.generated.d.ts +25 -0
  278. package/dist/rest/namespaces/datasphere.resources.generated.js +50 -0
  279. package/dist/rest/namespaces/datasphere.resources.generated.js.map +1 -0
  280. package/dist/rest/namespaces/datasphere.types.generated.d.ts +180 -0
  281. package/dist/rest/namespaces/datasphere.types.generated.js +8 -0
  282. package/dist/rest/namespaces/datasphere.types.generated.js.map +1 -0
  283. package/dist/rest/namespaces/fabric.d.ts +11 -273
  284. package/dist/rest/namespaces/fabric.js +14 -363
  285. package/dist/rest/namespaces/fabric.js.map +1 -1
  286. package/dist/rest/namespaces/fabric.resources.generated.d.ts +195 -0
  287. package/dist/rest/namespaces/fabric.resources.generated.js +399 -0
  288. package/dist/rest/namespaces/fabric.resources.generated.js.map +1 -0
  289. package/dist/rest/namespaces/fabric.types.generated.d.ts +4557 -0
  290. package/dist/rest/namespaces/fabric.types.generated.js +8 -0
  291. package/dist/rest/namespaces/fabric.types.generated.js.map +1 -0
  292. package/dist/rest/namespaces/fax.resources.generated.d.ts +6 -0
  293. package/dist/rest/namespaces/fax.resources.generated.js +14 -0
  294. package/dist/rest/namespaces/fax.resources.generated.js.map +1 -0
  295. package/dist/rest/namespaces/fax.types.generated.d.ts +131 -0
  296. package/dist/rest/namespaces/fax.types.generated.js +8 -0
  297. package/dist/rest/namespaces/fax.types.generated.js.map +1 -0
  298. package/dist/rest/namespaces/imported-numbers.d.ts +3 -18
  299. package/dist/rest/namespaces/imported-numbers.js +3 -21
  300. package/dist/rest/namespaces/imported-numbers.js.map +1 -1
  301. package/dist/rest/namespaces/logs.d.ts +10 -101
  302. package/dist/rest/namespaces/logs.js +10 -128
  303. package/dist/rest/namespaces/logs.js.map +1 -1
  304. package/dist/rest/namespaces/logs.resources.generated.d.ts +9 -0
  305. package/dist/rest/namespaces/logs.resources.generated.js +17 -0
  306. package/dist/rest/namespaces/logs.resources.generated.js.map +1 -0
  307. package/dist/rest/namespaces/logs.types.generated.d.ts +131 -0
  308. package/dist/rest/namespaces/logs.types.generated.js +8 -0
  309. package/dist/rest/namespaces/logs.types.generated.js.map +1 -0
  310. package/dist/rest/namespaces/lookup.d.ts +3 -25
  311. package/dist/rest/namespaces/lookup.js +3 -27
  312. package/dist/rest/namespaces/lookup.js.map +1 -1
  313. package/dist/rest/namespaces/message.resources.generated.d.ts +6 -0
  314. package/dist/rest/namespaces/message.resources.generated.js +14 -0
  315. package/dist/rest/namespaces/message.resources.generated.js.map +1 -0
  316. package/dist/rest/namespaces/message.types.generated.d.ts +122 -0
  317. package/dist/rest/namespaces/message.types.generated.js +8 -0
  318. package/dist/rest/namespaces/message.types.generated.js.map +1 -0
  319. package/dist/rest/namespaces/messages.resources.generated.d.ts +18 -0
  320. package/dist/rest/namespaces/messages.resources.generated.js +44 -0
  321. package/dist/rest/namespaces/messages.resources.generated.js.map +1 -0
  322. package/dist/rest/namespaces/messages.types.generated.d.ts +99 -0
  323. package/dist/rest/namespaces/messages.types.generated.js +8 -0
  324. package/dist/rest/namespaces/messages.types.generated.js.map +1 -0
  325. package/dist/rest/namespaces/mfa.d.ts +3 -42
  326. package/dist/rest/namespaces/mfa.js +3 -49
  327. package/dist/rest/namespaces/mfa.js.map +1 -1
  328. package/dist/rest/namespaces/number-groups.d.ts +3 -45
  329. package/dist/rest/namespaces/number-groups.js +3 -53
  330. package/dist/rest/namespaces/number-groups.js.map +1 -1
  331. package/dist/rest/namespaces/phone-numbers.d.ts +9 -57
  332. package/dist/rest/namespaces/phone-numbers.js +9 -63
  333. package/dist/rest/namespaces/phone-numbers.js.map +1 -1
  334. package/dist/rest/namespaces/project.d.ts +6 -42
  335. package/dist/rest/namespaces/project.js +6 -51
  336. package/dist/rest/namespaces/project.js.map +1 -1
  337. package/dist/rest/namespaces/project.resources.generated.d.ts +17 -0
  338. package/dist/rest/namespaces/project.resources.generated.js +44 -0
  339. package/dist/rest/namespaces/project.resources.generated.js.map +1 -0
  340. package/dist/rest/namespaces/project.types.generated.d.ts +58 -0
  341. package/dist/rest/namespaces/project.types.generated.js +8 -0
  342. package/dist/rest/namespaces/project.types.generated.js.map +1 -0
  343. package/dist/rest/namespaces/projects.resources.generated.d.ts +12 -0
  344. package/dist/rest/namespaces/projects.resources.generated.js +25 -0
  345. package/dist/rest/namespaces/projects.resources.generated.js.map +1 -0
  346. package/dist/rest/namespaces/projects.types.generated.d.ts +77 -0
  347. package/dist/rest/namespaces/projects.types.generated.js +8 -0
  348. package/dist/rest/namespaces/projects.types.generated.js.map +1 -0
  349. package/dist/rest/namespaces/pubsub.d.ts +4 -18
  350. package/dist/rest/namespaces/pubsub.js +4 -21
  351. package/dist/rest/namespaces/pubsub.js.map +1 -1
  352. package/dist/rest/namespaces/pubsub.resources.generated.d.ts +12 -0
  353. package/dist/rest/namespaces/pubsub.resources.generated.js +29 -0
  354. package/dist/rest/namespaces/pubsub.resources.generated.js.map +1 -0
  355. package/dist/rest/namespaces/pubsub.types.generated.d.ts +60 -0
  356. package/dist/rest/namespaces/pubsub.types.generated.js +8 -0
  357. package/dist/rest/namespaces/pubsub.types.generated.js.map +1 -0
  358. package/dist/rest/namespaces/queues.d.ts +3 -38
  359. package/dist/rest/namespaces/queues.js +3 -44
  360. package/dist/rest/namespaces/queues.js.map +1 -1
  361. package/dist/rest/namespaces/recordings.d.ts +3 -34
  362. package/dist/rest/namespaces/recordings.js +3 -40
  363. package/dist/rest/namespaces/recordings.js.map +1 -1
  364. package/dist/rest/namespaces/registry.d.ts +6 -137
  365. package/dist/rest/namespaces/registry.js +6 -173
  366. package/dist/rest/namespaces/registry.js.map +1 -1
  367. package/dist/rest/namespaces/relay-rest.resources.generated.d.ts +168 -0
  368. package/dist/rest/namespaces/relay-rest.resources.generated.js +430 -0
  369. package/dist/rest/namespaces/relay-rest.resources.generated.js.map +1 -0
  370. package/dist/rest/namespaces/relay-rest.types.generated.d.ts +1906 -0
  371. package/dist/rest/namespaces/relay-rest.types.generated.js +8 -0
  372. package/dist/rest/namespaces/relay-rest.types.generated.js.map +1 -0
  373. package/dist/rest/namespaces/short-codes.d.ts +3 -35
  374. package/dist/rest/namespaces/short-codes.js +3 -41
  375. package/dist/rest/namespaces/short-codes.js.map +1 -1
  376. package/dist/rest/namespaces/sip-profile.d.ts +3 -24
  377. package/dist/rest/namespaces/sip-profile.js +3 -29
  378. package/dist/rest/namespaces/sip-profile.js.map +1 -1
  379. package/dist/rest/namespaces/verified-callers.d.ts +3 -29
  380. package/dist/rest/namespaces/verified-callers.js +3 -34
  381. package/dist/rest/namespaces/verified-callers.js.map +1 -1
  382. package/dist/rest/namespaces/video.d.ts +10 -227
  383. package/dist/rest/namespaces/video.js +10 -288
  384. package/dist/rest/namespaces/video.js.map +1 -1
  385. package/dist/rest/namespaces/video.resources.generated.d.ts +81 -0
  386. package/dist/rest/namespaces/video.resources.generated.js +171 -0
  387. package/dist/rest/namespaces/video.resources.generated.js.map +1 -0
  388. package/dist/rest/namespaces/video.types.generated.d.ts +771 -0
  389. package/dist/rest/namespaces/video.types.generated.js +8 -0
  390. package/dist/rest/namespaces/video.types.generated.js.map +1 -0
  391. package/dist/rest/namespaces/voice.resources.generated.d.ts +9 -0
  392. package/dist/rest/namespaces/voice.resources.generated.js +17 -0
  393. package/dist/rest/namespaces/voice.resources.generated.js.map +1 -0
  394. package/dist/rest/namespaces/voice.types.generated.d.ts +214 -0
  395. package/dist/rest/namespaces/voice.types.generated.js +8 -0
  396. package/dist/rest/namespaces/voice.types.generated.js.map +1 -0
  397. package/dist/rest/pagination.d.ts +5 -1
  398. package/dist/rest/pagination.js +40 -20
  399. package/dist/rest/pagination.js.map +1 -1
  400. package/dist/rest/types.d.ts +21 -3
  401. package/dist/schema.json +299 -98
  402. package/dist/skills/SkillBase.d.ts +97 -20
  403. package/dist/skills/SkillBase.js +100 -17
  404. package/dist/skills/SkillBase.js.map +1 -1
  405. package/dist/skills/SkillManager.d.ts +66 -13
  406. package/dist/skills/SkillManager.js +101 -20
  407. package/dist/skills/SkillManager.js.map +1 -1
  408. package/dist/skills/SkillName.d.ts +44 -0
  409. package/dist/skills/SkillName.js +2 -0
  410. package/dist/skills/SkillName.js.map +1 -0
  411. package/dist/skills/SkillRegistry.d.ts +47 -7
  412. package/dist/skills/SkillRegistry.js +85 -13
  413. package/dist/skills/SkillRegistry.js.map +1 -1
  414. package/dist/skills/builtin/api_ninjas_trivia.d.ts +3 -1
  415. package/dist/skills/builtin/api_ninjas_trivia.js +24 -8
  416. package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -1
  417. package/dist/skills/builtin/ask_claude.d.ts +14 -4
  418. package/dist/skills/builtin/ask_claude.js +36 -14
  419. package/dist/skills/builtin/ask_claude.js.map +1 -1
  420. package/dist/skills/builtin/claude_skills.d.ts +3 -1
  421. package/dist/skills/builtin/claude_skills.js +19 -15
  422. package/dist/skills/builtin/claude_skills.js.map +1 -1
  423. package/dist/skills/builtin/custom_skills.d.ts +10 -3
  424. package/dist/skills/builtin/custom_skills.js +26 -9
  425. package/dist/skills/builtin/custom_skills.js.map +1 -1
  426. package/dist/skills/builtin/datasphere.d.ts +5 -3
  427. package/dist/skills/builtin/datasphere.js +34 -25
  428. package/dist/skills/builtin/datasphere.js.map +1 -1
  429. package/dist/skills/builtin/datasphere_serverless.d.ts +12 -1
  430. package/dist/skills/builtin/datasphere_serverless.js +17 -6
  431. package/dist/skills/builtin/datasphere_serverless.js.map +1 -1
  432. package/dist/skills/builtin/datetime.d.ts +3 -1
  433. package/dist/skills/builtin/datetime.js +11 -7
  434. package/dist/skills/builtin/datetime.js.map +1 -1
  435. package/dist/skills/builtin/google_maps.d.ts +29 -14
  436. package/dist/skills/builtin/google_maps.js +89 -269
  437. package/dist/skills/builtin/google_maps.js.map +1 -1
  438. package/dist/skills/builtin/index.d.ts +8 -6
  439. package/dist/skills/builtin/index.js +8 -6
  440. package/dist/skills/builtin/index.js.map +1 -1
  441. package/dist/skills/builtin/info_gatherer.d.ts +4 -2
  442. package/dist/skills/builtin/info_gatherer.js +20 -12
  443. package/dist/skills/builtin/info_gatherer.js.map +1 -1
  444. package/dist/skills/builtin/joke.d.ts +16 -6
  445. package/dist/skills/builtin/joke.js +54 -37
  446. package/dist/skills/builtin/joke.js.map +1 -1
  447. package/dist/skills/builtin/math.d.ts +3 -1
  448. package/dist/skills/builtin/math.js +14 -9
  449. package/dist/skills/builtin/math.js.map +1 -1
  450. package/dist/skills/builtin/mcp_gateway.d.ts +34 -5
  451. package/dist/skills/builtin/mcp_gateway.js +77 -46
  452. package/dist/skills/builtin/mcp_gateway.js.map +1 -1
  453. package/dist/skills/builtin/native_vector_search.d.ts +19 -5
  454. package/dist/skills/builtin/native_vector_search.js +179 -61
  455. package/dist/skills/builtin/native_vector_search.js.map +1 -1
  456. package/dist/skills/builtin/play_background_file.d.ts +21 -15
  457. package/dist/skills/builtin/play_background_file.js +43 -122
  458. package/dist/skills/builtin/play_background_file.js.map +1 -1
  459. package/dist/skills/builtin/spider.d.ts +46 -1
  460. package/dist/skills/builtin/spider.js +317 -101
  461. package/dist/skills/builtin/spider.js.map +1 -1
  462. package/dist/skills/builtin/swml_transfer.d.ts +14 -3
  463. package/dist/skills/builtin/swml_transfer.js +45 -24
  464. package/dist/skills/builtin/swml_transfer.js.map +1 -1
  465. package/dist/skills/builtin/weather_api.d.ts +24 -13
  466. package/dist/skills/builtin/weather_api.js +57 -31
  467. package/dist/skills/builtin/weather_api.js.map +1 -1
  468. package/dist/skills/builtin/web_search.d.ts +48 -10
  469. package/dist/skills/builtin/web_search.js +301 -84
  470. package/dist/skills/builtin/web_search.js.map +1 -1
  471. package/dist/skills/builtin/wikipedia_search.d.ts +4 -2
  472. package/dist/skills/builtin/wikipedia_search.js +32 -14
  473. package/dist/skills/builtin/wikipedia_search.js.map +1 -1
  474. package/dist/skills/index.d.ts +3 -2
  475. package/dist/skills/index.js +1 -1
  476. package/dist/skills/index.js.map +1 -1
  477. package/dist/swml_verbs_generated.d.ts +2824 -0
  478. package/dist/swml_verbs_generated.js +12 -0
  479. package/dist/swml_verbs_generated.js.map +1 -0
  480. package/dist/types.d.ts +65 -6
  481. package/dist/web.d.ts +27 -0
  482. package/dist/web.js +20 -0
  483. package/dist/web.js.map +1 -0
  484. package/docs/agent-guide.md +1034 -0
  485. package/docs/ai_chat.md +560 -0
  486. package/docs/api-reference.md +3534 -0
  487. package/docs/architecture.md +846 -0
  488. package/docs/bedrock_agent.md +411 -0
  489. package/docs/cli-guide.md +403 -0
  490. package/docs/cloud_functions_guide.md +399 -0
  491. package/docs/configuration.md +548 -0
  492. package/docs/contexts-guide.md +884 -0
  493. package/docs/datamap-guide.md +1160 -0
  494. package/docs/developer_pain_points.md +548 -0
  495. package/docs/llm_parameters.md +298 -0
  496. package/docs/mcp_gateway_reference.md +354 -0
  497. package/docs/mcp_integration.md +162 -0
  498. package/docs/pgi_agent_guide.md +1820 -0
  499. package/docs/prefabs-guide.md +815 -0
  500. package/docs/programmatically_governed_inference.md +301 -0
  501. package/docs/sdk_features.md +501 -0
  502. package/docs/security.md +559 -0
  503. package/docs/serverless-guide.md +520 -0
  504. package/docs/skills-guide.md +1223 -0
  505. package/docs/skills-system.md +405 -0
  506. package/docs/skills_parameter_schema.md +417 -0
  507. package/docs/swaig-reference.md +1938 -0
  508. package/docs/swml_service_guide.md +573 -0
  509. package/docs/third_party_skills.md +410 -0
  510. package/docs/web_service.md +666 -0
  511. package/examples/README.md +202 -0
  512. package/examples/advanced-datamap.ts +108 -0
  513. package/examples/advanced-dynamic-config.ts +70 -0
  514. package/examples/auto-vivified.ts +95 -0
  515. package/examples/call-flow.ts +65 -0
  516. package/examples/comprehensive-dynamic.ts +125 -0
  517. package/examples/contexts-steps.ts +65 -0
  518. package/examples/custom-path.ts +45 -0
  519. package/examples/datamap-tools.ts +51 -0
  520. package/examples/datasphere-multi-instance.ts +66 -0
  521. package/examples/datasphere-serverless-env.ts +87 -0
  522. package/examples/datasphere-webhook-env.ts +65 -0
  523. package/examples/datasphere.ts +56 -0
  524. package/examples/declarative.ts +100 -0
  525. package/examples/dynamic-config.ts +54 -0
  526. package/examples/dynamic-info-gatherer.ts +69 -0
  527. package/examples/dynamic-swml-service.ts +67 -0
  528. package/examples/gather-info.ts +95 -0
  529. package/examples/gather-per-question-functions-demo.ts +139 -0
  530. package/examples/joke-agent.ts +34 -0
  531. package/examples/kubernetes-agent.ts +45 -0
  532. package/examples/llm-params.ts +75 -0
  533. package/examples/mcp-agent.ts +89 -0
  534. package/examples/mcp-gateway.ts +81 -0
  535. package/examples/multi-agent.ts +80 -0
  536. package/examples/multi-endpoint.ts +79 -0
  537. package/examples/pgi/case-domain.ts +114 -0
  538. package/examples/pgi/serve.ts +16 -0
  539. package/examples/pgi/support-agent.ts +265 -0
  540. package/examples/pom-prompt.ts +70 -0
  541. package/examples/prefab-concierge.ts +42 -0
  542. package/examples/prefab-faq.ts +58 -0
  543. package/examples/prefab-info-gatherer.ts +33 -0
  544. package/examples/prefab-receptionist.ts +36 -0
  545. package/examples/prefab-survey.ts +69 -0
  546. package/examples/quickstart-agent.ts +29 -0
  547. package/examples/quickstart-relay.ts +25 -0
  548. package/examples/quickstart-rest.ts +25 -0
  549. package/examples/record-call.ts +65 -0
  550. package/examples/relay-demo.ts +33 -0
  551. package/examples/room-and-sip.ts +93 -0
  552. package/examples/serverless-lambda.ts +43 -0
  553. package/examples/session-state.ts +83 -0
  554. package/examples/simple-agent.ts +36 -0
  555. package/examples/simple-static.ts +29 -0
  556. package/examples/skills-demo.ts +41 -0
  557. package/examples/step-function-inheritance-demo.ts +124 -0
  558. package/examples/swaig-features.ts +193 -0
  559. package/examples/swml-service-routing.ts +66 -0
  560. package/examples/swml-service.ts +38 -0
  561. package/examples/swmlservice_ai_sidecar.ts +104 -0
  562. package/examples/swmlservice_swaig_standalone.ts +79 -0
  563. package/examples/tap.ts +67 -0
  564. package/examples/typed-tools.ts +68 -0
  565. package/examples/verb-methods.ts +45 -0
  566. package/examples/web-search-multi-instance.ts +75 -0
  567. package/examples/web-search.ts +38 -0
  568. package/examples/wikipedia.ts +36 -0
  569. package/livewire/README.md +164 -0
  570. package/livewire/docs/migration-guide.md +251 -0
  571. package/livewire/examples/livewire-basic-agent.ts +74 -0
  572. package/livewire/examples/livewire-handoff.ts +196 -0
  573. package/livewire/examples/livewire-multi-tool.ts +121 -0
  574. package/package.json +88 -13
  575. package/relay/README.md +101 -0
  576. package/relay/docs/call-methods.md +622 -0
  577. package/relay/docs/client-reference.md +281 -0
  578. package/relay/docs/events.md +193 -0
  579. package/relay/docs/getting-started.md +221 -0
  580. package/relay/docs/guide.md +386 -0
  581. package/relay/docs/messaging.md +246 -0
  582. package/relay/examples/relay-inbound.ts +66 -0
  583. package/relay/examples/relay-messaging.ts +74 -0
  584. package/relay/examples/relay-outbound.ts +76 -0
  585. package/rest/README.md +141 -0
  586. package/rest/docs/calling.md +313 -0
  587. package/rest/docs/client-reference.md +149 -0
  588. package/rest/docs/fabric.md +192 -0
  589. package/rest/docs/getting-started.md +138 -0
  590. package/rest/docs/guide.md +421 -0
  591. package/rest/docs/namespaces.md +367 -0
  592. package/rest/docs/phone-binding.md +116 -0
  593. package/rest/examples/rest-10dlc-registration.ts +177 -0
  594. package/rest/examples/rest-bind-phone-to-swml-webhook.ts +66 -0
  595. package/rest/examples/rest-calling-ivr-and-ai.ts +136 -0
  596. package/rest/examples/rest-calling-play-and-record.ts +98 -0
  597. package/rest/examples/rest-client.ts +59 -0
  598. package/rest/examples/rest-datasphere-search.ts +81 -0
  599. package/rest/examples/rest-fabric-conferences-and-routing.ts +147 -0
  600. package/rest/examples/rest-fabric-subscribers-and-sip.ts +106 -0
  601. package/rest/examples/rest-fabric-swml-and-callflows.ts +101 -0
  602. package/rest/examples/rest-manage-resources.ts +64 -0
  603. package/rest/examples/rest-phone-number-management.ts +200 -0
  604. package/rest/examples/rest-queues-mfa-and-recordings.ts +143 -0
  605. package/rest/examples/rest-video-rooms.ts +186 -0
  606. package/tutorial/fred/fred.ts +218 -0
  607. package/tutorial/fred/tutorial/01-introduction.md +141 -0
  608. package/tutorial/fred/tutorial/02-setup.md +304 -0
  609. package/tutorial/fred/tutorial/03-basic-agent.md +284 -0
  610. package/tutorial/fred/tutorial/04-wikipedia-skill.md +298 -0
  611. package/tutorial/fred/tutorial/05-custom-functions.md +347 -0
  612. package/tutorial/fred/tutorial/06-running-testing.md +642 -0
  613. package/tutorial/fred/tutorial/README.md +56 -0
  614. package/tutorial/fred/tutorial/appendix-complete-code.md +632 -0
  615. package/tutorial/fred/tutorial/appendix-docker-deployment.md +504 -0
  616. package/tutorial/full-guardrails-agent/handlers.ts +436 -0
  617. package/tutorial/full-guardrails-agent/penny.ts +305 -0
  618. package/tutorial/full-guardrails-agent/reservations.ts +1109 -0
  619. package/tutorial/full-guardrails-agent/tutorial/01-why-guardrails.md +149 -0
  620. package/tutorial/full-guardrails-agent/tutorial/02-design-first.md +139 -0
  621. package/tutorial/full-guardrails-agent/tutorial/03-rules-first.md +422 -0
  622. package/tutorial/full-guardrails-agent/tutorial/04-the-shell.md +238 -0
  623. package/tutorial/full-guardrails-agent/tutorial/05-steps-and-scoping.md +247 -0
  624. package/tutorial/full-guardrails-agent/tutorial/06-tools-that-decide.md +467 -0
  625. package/tutorial/full-guardrails-agent/tutorial/07-gather-and-projection.md +160 -0
  626. package/tutorial/full-guardrails-agent/tutorial/08-the-verification-gate.md +333 -0
  627. package/tutorial/full-guardrails-agent/tutorial/09-people-and-endings.md +313 -0
  628. package/tutorial/full-guardrails-agent/tutorial/10-testing-and-running.md +387 -0
  629. package/tutorial/full-guardrails-agent/tutorial/README.md +106 -0
  630. package/tutorial/full-guardrails-agent/tutorial/appendix-complete-code.md +2207 -0
  631. package/tutorial/full-guardrails-agent/tutorial/appendix-deployment.md +191 -0
  632. package/tutorial/full-guardrails-agent/tutorial/appendix-technique-map.md +117 -0
  633. package/tutorial/full-guardrails-agent/workflow.ts +219 -0
  634. package/tutorial/multi_agents/README.md +175 -0
  635. package/tutorial/multi_agents/advanced_agent.ts +395 -0
  636. package/tutorial/multi_agents/extending_agents.ts +641 -0
  637. package/tutorial/multi_agents/knowledge.ts +59 -0
  638. package/tutorial/multi_agents/lesson1_first_agent.md +368 -0
  639. package/tutorial/multi_agents/lesson2_knowledge_bases.md +404 -0
  640. package/tutorial/multi_agents/lesson3_multi_agent_systems.md +621 -0
  641. package/tutorial/multi_agents/lesson4_advanced_features.md +805 -0
  642. package/tutorial/multi_agents/lesson5_extending_agents.md +856 -0
  643. package/tutorial/multi_agents/pc_builder.ts +529 -0
  644. package/tutorial/multi_agents/sales_agent.ts +88 -0
  645. package/tutorial/multi_agents/sales_agent_with_search.ts +116 -0
  646. package/tutorial/multi_agents/sales_knowledge.md +139 -0
  647. package/tutorial/multi_agents/support_knowledge.md +256 -0
  648. package/dist/cli/mock-data.d.ts +0 -37
  649. package/dist/cli/mock-data.js +0 -80
  650. package/dist/cli/mock-data.js.map +0 -1
  651. package/dist/generateVerbTypes.d.ts +0 -11
  652. package/dist/generateVerbTypes.js +0 -265
  653. package/dist/generateVerbTypes.js.map +0 -1
  654. package/dist/rest/namespaces/compat.d.ts +0 -585
  655. package/dist/rest/namespaces/compat.js +0 -735
  656. package/dist/rest/namespaces/compat.js.map +0 -1
@@ -0,0 +1,621 @@
1
+ # Lesson 3: Building Multi-Agent Systems
2
+
3
+ This lesson builds the complete PC Builder Pro system: three agents on one server. Alex answers every call and transfers the caller to Morgan in sales or Sam in support, with the caller's name and a summary of the conversation.
4
+
5
+ ## Table of Contents
6
+
7
+ 1. [How a multi-agent system fits together](#how-a-multi-agent-system-fits-together)
8
+ 2. [The AgentServer class](#the-agentserver-class)
9
+ 3. [Dynamic configuration](#dynamic-configuration)
10
+ 4. [Agent-to-agent transfers](#agent-to-agent-transfers)
11
+ 5. [Building the complete system](#building-the-complete-system)
12
+ 6. [Testing multi-agent flows](#testing-multi-agent-flows)
13
+ 7. [Production considerations](#production-considerations)
14
+ 8. [Summary](#summary)
15
+
16
+ ---
17
+
18
+ ## How a multi-agent system fits together
19
+
20
+ Several specialized agents, each with a short prompt and a few tools, are easier to write and test than one agent that does everything. Each agent can change without touching the others, and a new specialist is one more route.
21
+
22
+ The caller always starts with the triage agent, which hands the call to one specialist:
23
+
24
+ ```text
25
+ Caller --> Triage agent (Alex, /) --+--> Sales agent (Morgan, /sales)
26
+ |
27
+ +--> Support agent (Sam, /support)
28
+ ```
29
+
30
+ The system has four parts:
31
+
32
+ 1. **AgentServer**: serves all three agents on one port
33
+ 2. **Routes**: each agent answers on its own path: `/`, `/sales` and `/support`
34
+ 3. **Transfers**: the `swml_transfer` skill gives the triage agent a tool that moves the call to another agent's URL
35
+ 4. **Context**: the caller's name and a summary travel with the call, in global data
36
+
37
+ ## The AgentServer class
38
+
39
+ `AgentServer` hosts several agents in one process, each under its own route.
40
+
41
+ ### Basic usage
42
+
43
+ This example creates a server, registers two agents on their routes, and runs it:
44
+
45
+ <!-- snippet: no-run starts an HTTP server on port 3001 -->
46
+ ```typescript
47
+ import { AgentBase, AgentServer } from '@signalwire/sdk';
48
+
49
+ const triage = new AgentBase({ name: 'Triage', route: '/' });
50
+ triage.promptAddSection('AI Role', { body: 'You are Alex, the front desk assistant.' });
51
+
52
+ const sales = new AgentBase({ name: 'Sales', route: '/sales' });
53
+ sales.promptAddSection('AI Role', { body: 'You are Morgan, a sales specialist.' });
54
+
55
+ const server = new AgentServer({ host: '0.0.0.0', port: 3001, logLevel: 'info' });
56
+ server.register(triage, '/');
57
+ server.register(sales, '/sales');
58
+
59
+ await server.run();
60
+ ```
61
+
62
+ `register()` takes the route as its second argument, or uses the agent's own route when you leave it out. It throws when two agents claim the same route.
63
+
64
+ ### Server features
65
+
66
+ The server adds these to the agents' own routes:
67
+
68
+ - `/health` and `/ready`, which answer without credentials, for load balancers and container health checks
69
+ - The same security headers on every response
70
+ - A `GET /` listing of the agents, when no agent is registered at `/`
71
+ - HTTPS from the same `SWML_SSL_ENABLED`, `SWML_SSL_CERT_PATH` and `SWML_SSL_KEY_PATH` variables a single agent reads
72
+
73
+ Each agent keeps its own basic auth credentials. When `SWML_BASIC_AUTH_USER` and `SWML_BASIC_AUTH_PASSWORD` are set, every agent reads the same ones. Without them, each agent generates its own password. [Creating the server](#6-creating-the-server) shows why PC Builder Pro gives all three the same credentials.
74
+
75
+ The constructor's options are `host`, `port` and `logLevel`. `new AgentServer()` sets the SDK's global log level to `logLevel`, which is `info` unless you pass another.
76
+
77
+ ## Dynamic configuration
78
+
79
+ A dynamic configuration callback changes an agent for one request. Requests for the SWML, for a SWAIG function and for the end-of-call summary all run it. The SDK copies the agent, calls the callback with the request and the copy, and serves the request from the copy. Changes to the copy never reach the next caller.
80
+
81
+ The callback receives four arguments:
82
+
83
+ - `query`: the request's query parameters
84
+ - `body`: the parsed request body
85
+ - `headers`: the request headers, with the credential-bearing ones removed
86
+ - `agent`: the per-request copy to configure
87
+
88
+ The callback can be `async`. `setDynamicConfigCallback()` sets the agent's callback, and replaces any set before. `addPerCallConfig()` adds one, and keeps the others.
89
+
90
+ PC Builder Pro uses callbacks for two jobs:
91
+
92
+ - The triage agent builds its transfer URLs from the URL the request reached it on, which depends on the proxy in front of it.
93
+ - The specialists check a `transfer=true` query parameter, and greet a transferred caller differently from a direct one.
94
+
95
+ ### Building URLs with getFullUrl()
96
+
97
+ `agent.getFullUrl(true)` returns the agent's public URL with its basic auth credentials in it, ready to use as a transfer target. It finds the public address in this order:
98
+
99
+ 1. `SWML_PROXY_URL_BASE`, when it's set
100
+ 2. The `X-Forwarded-Host` and `Forwarded` headers of the request, when `SWML_TRUST_PROXY_HEADERS` is `true`
101
+ 3. On a serverless platform such as AWS Lambda, the function URL its environment describes
102
+ 4. The agent's host and port, with `https` and `SWML_SSL_DOMAIN` when the agent serves HTTPS
103
+
104
+ The triage agent is at `/`, so its URL is the server's. With `SWML_PROXY_URL_BASE=https://pcbuilder.example.com`, the support transfer goes here:
105
+
106
+ ```text
107
+ https://devuser:devpassword@pcbuilder.example.com/support?transfer=true
108
+ ```
109
+
110
+ ## Agent-to-agent transfers
111
+
112
+ The `swml_transfer` skill gives an agent one tool. The model calls it with a destination, and the tool's result moves the call there. Each destination has a pattern to match and a `url` (another agent's SWML) or an `address` (a phone number or SIP address).
113
+
114
+ ### How swml_transfer works
115
+
116
+ The PC Builder Pro configuration names the tool, its destination parameter, the fields the model must collect, and the two destinations:
117
+
118
+ - `tool_name`: `transfer_to_specialist`
119
+ - `parameter_name`: `specialist_type`, the argument that picks the destination
120
+ - `required_fields`: `user_name` and `summary`. The model must fill them in before it can call the tool.
121
+ - `transfers`: `/sales/i` and `/support/i`, regular expressions matched against `specialist_type`. The `i` makes them case-insensitive, so "Technical Support" matches `/support/i`.
122
+
123
+ When the model calls the tool, the skill tries each pattern in order. On a match, its result does three things:
124
+
125
+ 1. It says the destination's `message` to the caller.
126
+ 2. It saves the required fields in global data, under `call_data`.
127
+ 3. It transfers the call to the destination's `url`, a SWML transfer. The `return_message` is what the triage agent says if the call comes back to it.
128
+
129
+ When nothing matches, the tool returns `default_message` and doesn't transfer. The skill also adds two sections to the triage agent's prompt, which list the destinations and the required fields.
130
+
131
+ ### Accessing transfer data
132
+
133
+ The saved fields travel with the call. Every SWAIG request the receiving agent gets carries them in `global_data.call_data`, so its tool handlers can read `rawData.global_data?.call_data`. The sales and support prompts name them as `${call_data.user_name}` and `${call_data.summary}`, placeholders for SignalWire to fill in from global data when it runs the prompt. Check on a test call that the specialist greets the caller by name before you rely on the placeholders.
134
+
135
+ ## Building the complete system
136
+
137
+ The complete system is `tutorial/multi_agents/pc_builder.ts`. Each agent comes from a function that creates and configures it, and a factory registers the three on one server.
138
+
139
+ ### 1. Triage agent (Alex)
140
+
141
+ The triage agent has the energetic `rime.spore` voice, and adds its transfer tool per request:
142
+
143
+ <!-- snippet: no-compile a region of tutorial/multi_agents/pc_builder.ts; the file itself is type-checked --> <!-- include: tutorial/multi_agents/pc_builder.ts#triage-agent -->
144
+ ```typescript
145
+ /** Alex, the triage agent at the root route. */
146
+ export function createTriageAgent(options: AgentOptions): AgentBase {
147
+ const agent = new AgentBase({ name: 'PC Builder Triage Agent', route: '/', ...options });
148
+
149
+ configureTriagePrompt(agent);
150
+ agent.addLanguage({ name: 'English', code: 'en-US', voice: 'rime.spore' });
151
+
152
+ // The transfer URLs depend on the request (proxy detection), so the
153
+ // transfer tool is added to each request's copy of the agent
154
+ agent.setDynamicConfigCallback(configureTransferTools);
155
+ return agent;
156
+ }
157
+ ```
158
+
159
+ `options` carries the server's host and port, and the credentials all three agents share. `configureTriagePrompt` adds Alex's prompt sections: the role, the triage tasks, the voice instructions, the rules and an example summary.
160
+
161
+ ### 2. Dynamic transfer configuration
162
+
163
+ The callback builds each destination URL from the triage agent's own URL, then adds `swml_transfer` to the copy:
164
+
165
+ <!-- snippet: no-compile a region of tutorial/multi_agents/pc_builder.ts; the file itself is type-checked --> <!-- include: tutorial/multi_agents/pc_builder.ts#transfer-tools -->
166
+ ```typescript
167
+ /**
168
+ * Runs for every request to the triage agent, on that request's copy of it,
169
+ * and adds the swml_transfer skill with URLs built for this request.
170
+ */
171
+ export async function configureTransferTools(
172
+ _query: Record<string, string>,
173
+ _body: unknown,
174
+ _headers: Record<string, string>,
175
+ agent: AgentBase,
176
+ ): Promise<void> {
177
+ // The triage agent's own URL, with its credentials, is the base for the others
178
+ const base = agent.getFullUrl(true).replace(/\/+$/, '');
179
+ const salesUrl = `${base}/sales?transfer=true`;
180
+ const supportUrl = `${base}/support?transfer=true`;
181
+
182
+ await agent.addSkill(
183
+ new SwmlTransferSkill({
184
+ tool_name: 'transfer_to_specialist',
185
+ description: 'Transfer to sales or support specialist with conversation summary',
186
+ parameter_name: 'specialist_type',
187
+ parameter_description: 'The type of specialist to transfer to (sales or support)',
188
+ required_fields: {
189
+ user_name: "The customer's name",
190
+ summary:
191
+ 'A comprehensive summary of the conversation so far, including what the customer needs help with',
192
+ },
193
+ transfers: {
194
+ '/sales/i': {
195
+ url: salesUrl,
196
+ message: 'Perfect! Let me transfer you to our sales specialist right away.',
197
+ return_message:
198
+ 'The call with the sales specialist is complete. How else can I help you?',
199
+ },
200
+ '/support/i': {
201
+ url: supportUrl,
202
+ message: "I'll connect you with our technical support specialist right away.",
203
+ return_message:
204
+ 'The call with the support specialist is complete. How else can I help you?',
205
+ },
206
+ },
207
+ default_message:
208
+ 'I can transfer you to either our sales or support specialist. Which would you prefer?',
209
+ }),
210
+ );
211
+ }
212
+ ```
213
+
214
+ The tool is a SWAIG function that runs in the triage agent. The callback runs for the SWAIG request too, so the copy that handles the call to `transfer_to_specialist` has the tool.
215
+
216
+ ### 3. Sales agent (Morgan)
217
+
218
+ The sales agent has Lesson 2's search tool, two sales tools, and a callback for its greeting:
219
+
220
+ <!-- snippet: no-compile a region of tutorial/multi_agents/pc_builder.ts; the file itself is type-checked --> <!-- include: tutorial/multi_agents/pc_builder.ts#sales-agent -->
221
+ ```typescript
222
+ /** Morgan, the sales specialist at /sales. */
223
+ export async function createSalesAgent(options: AgentOptions): Promise<AgentBase> {
224
+ const agent = new AgentBase({ name: 'PC Builder Sales Specialist', route: '/sales', ...options });
225
+
226
+ // Greet a transferred caller by name, and a direct caller normally
227
+ agent.setDynamicConfigCallback(configureSalesGreeting);
228
+
229
+ configureSalesPrompt(agent);
230
+ agent.addLanguage({ name: 'English', code: 'en-US', voice: 'rime.marsh' });
231
+
232
+ await agent.addSkill(
233
+ new NativeVectorSearchSkill({
234
+ tool_name: 'search_sales_knowledge',
235
+ description: 'Search sales and product information',
236
+ documents: loadKnowledge(knowledgeFile('sales_knowledge.md')),
237
+ count: 3,
238
+ }),
239
+ );
240
+
241
+ agent.defineTool({
242
+ name: 'create_build_recommendation',
243
+ description: 'Create a custom PC build recommendation',
244
+ parameters: {
245
+ budget: { type: 'string', description: "The customer's budget in dollars" },
246
+ use_case: { type: 'string', description: 'What the PC will be used for' },
247
+ preferences: { type: 'string', description: 'Brand, size or style preferences' },
248
+ },
249
+ required: ['budget', 'use_case', 'preferences'],
250
+ handler: ({ budget, use_case, preferences }) =>
251
+ new FunctionResult(
252
+ `Based on your $${budget} budget for ${use_case}, I recommend: ` +
253
+ '[Custom build details would be generated here based on current ' +
254
+ `market data and your preferences: ${preferences}]`,
255
+ ),
256
+ });
257
+
258
+ agent.defineTool({
259
+ name: 'check_component_compatibility',
260
+ description: 'Check if PC components are compatible',
261
+ parameters: {
262
+ components: { type: 'string', description: 'The components to check, as a list' },
263
+ },
264
+ required: ['components'],
265
+ handler: ({ components }) =>
266
+ new FunctionResult(
267
+ `Compatibility check for: ${components} - ` +
268
+ '[Detailed compatibility analysis would be performed here]',
269
+ ),
270
+ });
271
+
272
+ return agent;
273
+ }
274
+ ```
275
+
276
+ The two sales tools return placeholder text. Lesson 4 covers writing tools that do real work. The support agent, `createSupportAgent`, has the same shape: the `rime.cove` voice, a search tool over `support_knowledge.md`, and the tools `diagnose_hardware_issue` and `create_support_ticket`.
277
+
278
+ ### 4. Transfer detection
279
+
280
+ The sales agent's callback adds a greeting section that depends on how the caller arrived:
281
+
282
+ <!-- snippet: no-compile a region of tutorial/multi_agents/pc_builder.ts; the file itself is type-checked --> <!-- include: tutorial/multi_agents/pc_builder.ts#sales-greeting -->
283
+ ```typescript
284
+ /** Runs for every request to the sales agent, on that request's copy of it. */
285
+ export function configureSalesGreeting(
286
+ query: Record<string, string>,
287
+ _body: unknown,
288
+ _headers: Record<string, string>,
289
+ agent: AgentBase,
290
+ ): void {
291
+ if (query['transfer'] === 'true') {
292
+ agent.promptAddSection('Call Transfer Information', {
293
+ body: 'This call has been transferred to you from the triage agent.',
294
+ bullets: [
295
+ "The customer's name is ${call_data.user_name} - greet them by name",
296
+ 'They were transferred because: ${call_data.summary}',
297
+ 'Start by greeting them by name and acknowledging why they were transferred',
298
+ "Example: 'Hi ${call_data.user_name}, I'm Morgan! I understand " +
299
+ "you're looking to build a gaming PC with a $2000 budget. I'm " +
300
+ "excited to help you build the perfect system!'",
301
+ ],
302
+ });
303
+ } else {
304
+ agent.promptAddSection('Initial Greeting', {
305
+ body: 'This is a direct call to the sales department.',
306
+ bullets: [
307
+ 'Greet the customer warmly and professionally',
308
+ 'Introduce yourself as a PC building sales specialist',
309
+ 'Ask for their name',
310
+ 'Ask how you can help them today',
311
+ "Example: 'Hello! Welcome to PC Builder Pro sales. I'm Morgan, " +
312
+ 'your PC building specialist. May I have your name, and how can ' +
313
+ "I help you build something amazing today?'",
314
+ ],
315
+ });
316
+ }
317
+ }
318
+ ```
319
+
320
+ The placeholders are in ordinary single-quoted strings, not template literals, so TypeScript leaves `${call_data.user_name}` as text for SignalWire.
321
+
322
+ ### 5. The server factory
323
+
324
+ `createPcBuilderApp` creates the server and the three agents, and adds an `/info` route of the server's own:
325
+
326
+ <!-- snippet: no-compile a region of tutorial/multi_agents/pc_builder.ts; the file itself is type-checked --> <!-- include: tutorial/multi_agents/pc_builder.ts#server -->
327
+ ```typescript
328
+ /** Create the AgentServer with the three agents registered on their routes. */
329
+ export async function createPcBuilderApp(opts: PcBuilderOptions = {}): Promise<AgentServer> {
330
+ const host = opts.host ?? '0.0.0.0';
331
+ const port = opts.port ?? Number(process.env['PORT'] ?? 3001);
332
+ // AgentServer sets the global log level, so pass SIGNALWIRE_LOG_LEVEL through
333
+ const logLevel = opts.logLevel ?? process.env['SIGNALWIRE_LOG_LEVEL'] ?? 'info';
334
+ const server = new AgentServer({ host, port, logLevel });
335
+
336
+ // The triage agent puts its own credentials in the transfer URLs, so all
337
+ // three agents must accept the same ones
338
+ const agentOptions = { host, port, basicAuth: opts.basicAuth ?? sharedCredentials() };
339
+
340
+ server.register(createTriageAgent(agentOptions), '/');
341
+ server.register(await createSalesAgent(agentOptions), '/sales');
342
+ server.register(await createSupportAgent(agentOptions), '/support');
343
+
344
+ // A route of the server's own, beside the agents'
345
+ server.getApp().get('/info', (c) => c.json(serviceInfo(host, port)));
346
+ return server;
347
+ }
348
+ ```
349
+
350
+ Each agent gets the server's host and port, because `getFullUrl()` builds URLs from the agent's own settings. `/info` is added last: the server rebuilds its app when an agent is registered, and a route added before that would be lost.
351
+
352
+ ### 6. Creating the server
353
+
354
+ The transfer URL carries the triage agent's credentials, and the sales agent checks them. If each agent generated its own password, every transfer would fail with `401`. `sharedCredentials` makes sure the three agents agree:
355
+
356
+ <!-- snippet: no-compile a region of tutorial/multi_agents/pc_builder.ts; the file itself is type-checked --> <!-- include: tutorial/multi_agents/pc_builder.ts#credentials -->
357
+ ```typescript
358
+ /**
359
+ * The credentials to give all three agents: undefined when
360
+ * SWML_BASIC_AUTH_PASSWORD is set (each agent reads the same variables),
361
+ * otherwise one generated password for all of them.
362
+ */
363
+ function sharedCredentials(): [string, string] | undefined {
364
+ if (process.env['SWML_BASIC_AUTH_PASSWORD']) return undefined;
365
+ const user = process.env['SWML_BASIC_AUTH_USER'] || 'pc_builder';
366
+ return [user, randomBytes(16).toString('hex')];
367
+ }
368
+ ```
369
+
370
+ The end of the file creates the server when the module loads, and starts it only when you run the file:
371
+
372
+ <!-- snippet: no-compile a region of tutorial/multi_agents/pc_builder.ts; the file itself is type-checked --> <!-- include: tutorial/multi_agents/pc_builder.ts#main -->
373
+ ```typescript
374
+ export const server = await createPcBuilderApp();
375
+
376
+ // Start the server only when this file is run, not when it's imported
377
+ if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
378
+ const url = `http://localhost:${server.port}`;
379
+ log.info('Starting PC Builder Pro Multi-Agent Service');
380
+ log.info(`Triage Agent (Alex): ${url}/`);
381
+ log.info(`Sales Agent (Morgan): ${url}/sales`);
382
+ log.info(`Support Agent (Sam): ${url}/support`);
383
+ log.info(`Service Info: ${url}/info`);
384
+ await server.run();
385
+ }
386
+ ```
387
+
388
+ Creating the agents at load time lets `swaig-test` find them, as [Testing transfers without a call](#testing-transfers-without-a-call) shows.
389
+
390
+ ## Testing multi-agent flows
391
+
392
+ Test each agent over HTTP, then test the transfer without placing a call.
393
+
394
+ ### Starting the system
395
+
396
+ Set the credentials, then run the file:
397
+
398
+ ```bash
399
+ export SWML_BASIC_AUTH_USER=devuser
400
+ export SWML_BASIC_AUTH_PASSWORD=devpassword
401
+ npx tsx tutorial/multi_agents/pc_builder.ts
402
+ ```
403
+
404
+ The log lists each agent and its route. This output is shortened, without the timestamps:
405
+
406
+ ```text
407
+ [WARN] [AgentBase] [signalwire] webhook signature validation is disabled — set signingKey or SIGNALWIRE_SIGNING_KEY to enable
408
+ [INFO] [AgentServer] Registered 'PC Builder Triage Agent' at /
409
+ [INFO] [AgentServer] Registered 'PC Builder Sales Specialist' at /sales
410
+ [INFO] [AgentServer] Registered 'PC Builder Support Specialist' at /support
411
+ [INFO] [pc_builder] Starting PC Builder Pro Multi-Agent Service
412
+ [INFO] [pc_builder] Triage Agent (Alex): http://localhost:3001/
413
+ [INFO] [pc_builder] Sales Agent (Morgan): http://localhost:3001/sales
414
+ [INFO] [pc_builder] Support Agent (Sam): http://localhost:3001/support
415
+ [INFO] [pc_builder] Service Info: http://localhost:3001/info
416
+ [INFO] [AgentServer] Starting on http://0.0.0.0:3001
417
+ [INFO] [AgentServer] / -> PC Builder Triage Agent (auth: devuser:****)
418
+ [INFO] [AgentServer] /sales -> PC Builder Sales Specialist (auth: devuser:****)
419
+ [INFO] [AgentServer] /support -> PC Builder Support Specialist (auth: devuser:****)
420
+ ```
421
+
422
+ ### Testing individual agents
423
+
424
+ Request each agent's SWML, and add the transfer flag to see the transferred-call prompt:
425
+
426
+ ```bash
427
+ curl -u devuser:devpassword http://localhost:3001/
428
+ curl -u devuser:devpassword http://localhost:3001/sales
429
+ curl -u devuser:devpassword "http://localhost:3001/sales?transfer=true"
430
+ ```
431
+
432
+ `jq` shows which prompt sections an agent serves. The transferred call gets `Call Transfer Information`:
433
+
434
+ ```bash
435
+ curl -s -u devuser:devpassword "http://localhost:3001/sales?transfer=true" \
436
+ | jq '.sections.main[1].ai.prompt.pom[].title'
437
+ ```
438
+
439
+ The output lists the sales prompt, the search skill's section and the transfer section:
440
+
441
+ ```text
442
+ "AI Role"
443
+ "Your Expertise"
444
+ "Your Tasks"
445
+ "Voice Instructions"
446
+ "Tools Available"
447
+ "Important"
448
+ "Knowledge Search"
449
+ "Call Transfer Information"
450
+ ```
451
+
452
+ Without `?transfer=true`, the last section is `Initial Greeting`. `/health` and `/info` answer without credentials, and the agents' routes answer `401` without them.
453
+
454
+ ### Testing transfers without a call
455
+
456
+ `swaig-test` loads the file, and `--route` picks the agent. Call the triage agent's transfer tool with the arguments the model would send:
457
+
458
+ ```bash
459
+ npx tsx src/cli/swaig-test.ts tutorial/multi_agents/pc_builder.ts --route / \
460
+ --exec transfer_to_specialist --specialist_type sales \
461
+ --user_name 'Jane Doe' --summary 'Jane wants a gaming PC for about $1500.'
462
+ ```
463
+
464
+ The result has the message, the `call_data` saved in global data, and the SWML that transfers the call to the sales agent:
465
+
466
+ ```text
467
+ RESULT:
468
+ Response: Perfect! Let me transfer you to our sales specialist right away.
469
+
470
+ Actions:
471
+ {
472
+ "set_global_data": {
473
+ "call_data": {
474
+ "user_name": "Jane Doe",
475
+ "summary": "Jane wants a gaming PC for about $1500."
476
+ }
477
+ }
478
+ }
479
+ {
480
+ "SWML": {
481
+ "version": "1.0.0",
482
+ "sections": {
483
+ "main": [
484
+ {
485
+ "set": {
486
+ "ai_response": "The call with the sales specialist is complete. How else can I help you?"
487
+ }
488
+ },
489
+ {
490
+ "transfer": {
491
+ "dest": "http://devuser:devpassword@localhost:3001/sales?transfer=true"
492
+ }
493
+ }
494
+ ]
495
+ }
496
+ },
497
+ "transfer": "true"
498
+ }
499
+
500
+ Post-process: true
501
+ ```
502
+
503
+ `Post-process: true` means the model speaks the message before SignalWire runs the actions. To see what happens next, request the `dest` URL with curl, as SignalWire does.
504
+
505
+ ### Testing the transfer flow on a call
506
+
507
+ On a real call, a transfer moves through four stages:
508
+
509
+ 1. **Call the triage agent**: Alex greets you.
510
+ 2. **Give your name and describe what you need**: Alex asks until it has both.
511
+ 3. **Ask for sales or support**: "I want to buy a gaming PC."
512
+ 4. **Hear the handoff**: Alex says the transfer message, and Morgan answers.
513
+
514
+ ### Monitoring transfers
515
+
516
+ The triage agent's log records each call to the transfer tool:
517
+
518
+ ```text
519
+ [INFO] [AgentBase] function_executed_successfully endpoint=/swaig function=transfer_to_specialist call_id=...
520
+ ```
521
+
522
+ Set `SIGNALWIRE_LOG_LEVEL=debug` for each request's details, including token checks.
523
+
524
+ ## Production considerations
525
+
526
+ These settings matter once real callers reach the system.
527
+
528
+ ### Security
529
+
530
+ Set the credentials, and the signing key that lets the agents verify a request came from SignalWire:
531
+
532
+ ```bash
533
+ export SWML_BASIC_AUTH_USER=pcbuilder
534
+ export SWML_BASIC_AUTH_PASSWORD=a-long-random-password
535
+ export SIGNALWIRE_SIGNING_KEY=your-signing-key
536
+ ```
537
+
538
+ Without the credentials, `pc_builder.ts` generates one password for the three agents and doesn't log it. The server serves HTTPS from the same variables Lesson 1 used:
539
+
540
+ ```bash
541
+ SWML_SSL_ENABLED=true \
542
+ SWML_SSL_CERT_PATH=/path/to/cert.pem \
543
+ SWML_SSL_KEY_PATH=/path/to/key.pem \
544
+ SWML_SSL_DOMAIN=pcbuilder.example.com \
545
+ npx tsx tutorial/multi_agents/pc_builder.ts
546
+ ```
547
+
548
+ The transfer URLs and webhook URLs contain the basic auth credentials, because SignalWire needs them to call back. Anyone who can read the SWML can read the password, so serve it over HTTPS. For more information, see the [security guide](../../docs/security.md).
549
+
550
+ ### Deployment patterns
551
+
552
+ The same agents can be deployed three ways:
553
+
554
+ 1. **One server**: all agents on one `AgentServer`, as in this lesson. One process to run and monitor, and one set of credentials.
555
+ 2. **Separate servers**: each agent serves itself with `agent.run()`, and scales on its own. The transfer URLs then point at other hosts, so build them from configuration instead of from the triage agent's URL.
556
+ 3. **Serverless**: an AWS Lambda function serves the whole system through `ServerlessAdapter`.
557
+
558
+ The file exports a Lambda handler for the third pattern:
559
+
560
+ <!-- snippet: no-compile a region of tutorial/multi_agents/pc_builder.ts; the file itself is type-checked --> <!-- include: tutorial/multi_agents/pc_builder.ts#lambda -->
561
+ ```typescript
562
+ /** AWS Lambda entry point: the same three agents, through ServerlessAdapter. */
563
+ export const lambdaHandler: (event: ServerlessEvent) => Promise<unknown> =
564
+ ServerlessAdapter.createLambdaHandler(server.getApp());
565
+ ```
566
+
567
+ On Lambda, set `SWML_BASIC_AUTH_PASSWORD`: a generated password changes with every cold start. For more information, see the [serverless guide](../../docs/serverless-guide.md).
568
+
569
+ ### Monitoring
570
+
571
+ Point your load balancer or container health check at `/health`, which needs no credentials:
572
+
573
+ ```bash
574
+ curl http://localhost:3001/health
575
+ ```
576
+
577
+ It answers `{"status":"ok"}`. Set `SIGNALWIRE_LOG_LEVEL` to `debug` for more detail, or pass `logLevel` to `createPcBuilderApp`.
578
+
579
+ These are worth tracking in production:
580
+
581
+ - Transfers per destination, and transfers that end in the default message
582
+ - Response times of each agent's tools
583
+ - Errors by agent
584
+ - Calls where the specialist had to ask for the caller's name again
585
+
586
+ ## Summary
587
+
588
+ This lesson built a complete multi-agent system. The main points:
589
+
590
+ - `AgentServer` hosts several agents on one port, each on its own route
591
+ - A dynamic configuration callback configures a per-request copy of an agent
592
+ - `getFullUrl(true)` builds proxy-aware URLs with the credentials in them
593
+ - `swml_transfer` transfers the call, and saves its required fields in global data as `call_data`
594
+ - A query parameter tells the receiving agent that the call was transferred
595
+ - Agents that transfer to each other must accept the same credentials
596
+
597
+ ### Practice exercises
598
+
599
+ Try these before you move on:
600
+
601
+ 1. **Add a fourth agent**: create a billing agent at `/billing`, and add a transfer pattern for it.
602
+ 2. **Customize the transfer messages**: change what Alex says for each destination.
603
+ 3. **Transfer to a person**: add a destination with an `address`, a phone number, instead of a `url`.
604
+ 4. **Add a language**: give each agent a Spanish language entry.
605
+
606
+ ### Troubleshooting
607
+
608
+ These problems come up most often in this lesson:
609
+
610
+ - **Transfers go to the wrong host**: set `SWML_PROXY_URL_BASE` to the URL SignalWire reaches the server on.
611
+ - **The specialist answers `401` after a transfer**: the agents have different credentials. Create them through `createPcBuilderApp`, or give them the same `basicAuth`.
612
+ - **The model doesn't transfer**: check that the prompt tells it to collect the name and summary, which the tool requires.
613
+ - **Port conflicts**: only one server can listen on a port. Set `PORT` to move this one.
614
+
615
+ ### Next steps
616
+
617
+ Next, write tools that do real work, and deploy the system. Continue with [Lesson 4: Advanced Features and Best Practices](lesson4_advanced_features.md).
618
+
619
+ ---
620
+
621
+ [Previous: Lesson 2 - Adding Intelligence with Knowledge Bases](lesson2_knowledge_bases.md) | [Tutorial Overview](README.md) | [Next: Lesson 4 - Advanced Features](lesson4_advanced_features.md)