@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
@@ -7,6 +7,7 @@
7
7
  * additive features.
8
8
  */
9
9
  import { AgentBase } from '../AgentBase.js';
10
+ import { CallSessionStore } from './CallSessionStore.js';
10
11
  import { FunctionResult } from '../FunctionResult.js';
11
12
  // ── Agent ───────────────────────────────────────────────────────────────────
12
13
  /**
@@ -20,6 +21,10 @@ import { FunctionResult } from '../FunctionResult.js';
20
21
  * ```ts
21
22
  * import { ReceptionistAgent } from '@signalwire/sdk';
22
23
  *
24
+ * const notifyFrontDesk = async (visitor: Record<string, string>) => {
25
+ * console.log('visitor checked in', visitor);
26
+ * };
27
+ *
23
28
  * const agent = new ReceptionistAgent({
24
29
  * companyName: 'Acme Co',
25
30
  * greeting: 'Thanks for calling Acme! How can I direct your call?',
@@ -43,7 +48,8 @@ export class ReceptionistAgent extends AgentBase {
43
48
  companyName;
44
49
  checkInEnabled;
45
50
  onVisitorCheckInCallback;
46
- sessions = new Map();
51
+ /** Per-call check-in state, dropped on the call's summary or after an hour idle. */
52
+ sessions = new CallSessionStore();
47
53
  /**
48
54
  * Create a ReceptionistAgent with the specified departments.
49
55
  * @param config - Configuration including departments (name/description/number), greeting, and voice.
@@ -71,7 +77,7 @@ export class ReceptionistAgent extends AgentBase {
71
77
  this.buildPrompt();
72
78
  this.configureAgentSettings(config.voice ?? 'rime.spore');
73
79
  // Register tools after all fields are initialized
74
- this.defineTools();
80
+ this.ensureToolsDefined();
75
81
  }
76
82
  static validateDepartments(departments) {
77
83
  if (!Array.isArray(departments) || departments.length === 0) {
@@ -114,7 +120,7 @@ export class ReceptionistAgent extends AgentBase {
114
120
  'Use the collect_caller_info function when you have their name and reason for calling.',
115
121
  'Use the transfer_call function to transfer them to the appropriate department.',
116
122
  "Before transferring, always confirm with the caller that they're being transferred to the right department.",
117
- 'If a caller\'s request does not clearly match a department, ask follow-up questions to clarify.',
123
+ "If a caller's request does not clearly match a department, ask follow-up questions to clarify.",
118
124
  ];
119
125
  if (this.checkInEnabled) {
120
126
  instructions.push('If a caller wants to check in as a visitor, collect their full name, purpose of visit, and who they are visiting, then use the check_in_visitor tool.');
@@ -152,17 +158,12 @@ export class ReceptionistAgent extends AgentBase {
152
158
  // ── Session helpers ───────────────────────────────────────────────────
153
159
  getSession(rawData) {
154
160
  const callId = rawData['call_id'] ?? 'default';
155
- let session = this.sessions.get(callId);
156
- if (!session) {
157
- session = { visitors: [] };
158
- this.sessions.set(callId, session);
159
- }
160
- return session;
161
+ return this.sessions.getOrCreate(callId, () => ({ visitors: [] }));
161
162
  }
162
163
  // ── Tool registration ─────────────────────────────────────────────────
163
164
  /**
164
165
  * Register the `collect_caller_info` and `transfer_call` SWAIG tools
165
- * (Python parity). When `checkInEnabled` is `true`, also registers the
166
+ * (matching the Python SDK). When `checkInEnabled` is `true`, also registers the
166
167
  * TS-specific `check_in_visitor` tool.
167
168
  */
168
169
  defineTools() {
@@ -184,8 +185,8 @@ export class ReceptionistAgent extends AgentBase {
184
185
  },
185
186
  },
186
187
  handler: (args) => {
187
- const name = args['name'] ?? '';
188
- const reason = args['reason'] ?? '';
188
+ const name = args.name ?? '';
189
+ const reason = args.reason ?? '';
189
190
  const result = new FunctionResult(`Thank you, ${name}. I've noted that you're calling about ${reason}.`);
190
191
  result.addActions([
191
192
  {
@@ -212,12 +213,12 @@ export class ReceptionistAgent extends AgentBase {
212
213
  },
213
214
  },
214
215
  },
215
- handler: (args, rawData) => {
216
- const departmentName = (args['department'] ?? '').trim();
216
+ handler: this._onCallAgent((self, args, rawData) => {
217
+ const departmentName = (args.department ?? '').trim();
217
218
  const globalData = rawData['global_data'] ?? {};
218
219
  const callerInfo = globalData['caller_info'] ?? {};
219
220
  const name = callerInfo['name'] ?? 'the caller';
220
- const dept = this.departments.find((d) => d.name === departmentName);
221
+ const dept = self.departments.find((d) => d.name === departmentName);
221
222
  if (!dept) {
222
223
  return new FunctionResult(`Sorry, I couldn't find the ${departmentName} department.`);
223
224
  }
@@ -226,7 +227,7 @@ export class ReceptionistAgent extends AgentBase {
226
227
  const result = new FunctionResult(`I'll transfer you to our ${departmentName} department now. Thank you for calling, ${name}!`, true);
227
228
  result.connect(dept.number, true);
228
229
  return result;
229
- },
230
+ }),
230
231
  });
231
232
  // Tool: check_in_visitor (TS-specific; only if checkInEnabled)
232
233
  if (this.checkInEnabled) {
@@ -251,10 +252,10 @@ export class ReceptionistAgent extends AgentBase {
251
252
  },
252
253
  required: ['visitor_name', 'purpose', 'visiting'],
253
254
  },
254
- handler: async (args, rawData) => {
255
- const visitorName = args['visitor_name'];
256
- const purpose = args['purpose'];
257
- const visiting = args['visiting'];
255
+ handler: this._onCallAgent(async (self, args, rawData) => {
256
+ const visitorName = args.visitor_name;
257
+ const purpose = args.purpose;
258
+ const visiting = args.visiting;
258
259
  if (!visitorName || !purpose || !visiting) {
259
260
  return new FunctionResult("Please provide the visitor's name, purpose of visit, and who they are visiting.");
260
261
  }
@@ -264,30 +265,37 @@ export class ReceptionistAgent extends AgentBase {
264
265
  visiting,
265
266
  checked_in_at: new Date().toISOString(),
266
267
  };
267
- const session = this.getSession(rawData);
268
+ const session = self.getSession(rawData);
268
269
  session.visitors.push(visitorRecord);
269
- if (this.onVisitorCheckInCallback) {
270
+ if (self.onVisitorCheckInCallback) {
270
271
  try {
271
- await this.onVisitorCheckInCallback(visitorRecord);
272
+ await self.onVisitorCheckInCallback(visitorRecord);
272
273
  }
273
274
  catch (err) {
274
- this.log.error(`onVisitorCheckIn callback error: ${err}`);
275
+ self.log.error(`onVisitorCheckIn callback error: ${err}`);
275
276
  }
276
277
  }
277
- const companyPart = this.companyName ? ` Welcome to ${this.companyName}!` : '';
278
+ const companyPart = self.companyName ? ` Welcome to ${self.companyName}!` : '';
278
279
  return new FunctionResult(`Visitor checked in successfully! Name: ${visitorName}, Purpose: ${purpose}, Visiting: ${visiting}.${companyPart}`);
279
- },
280
+ }),
280
281
  });
281
282
  }
282
283
  }
283
284
  // ── Lifecycle hooks ───────────────────────────────────────────────────
284
285
  /**
285
- * Python-style receptionist summary hook. Default is a no-op; subclasses
286
- * may override to persist the summary. Mirrors Python `on_summary`
287
- * (receptionist.py lines 278–287).
286
+ * Python-style receptionist summary hook; subclasses may override to
287
+ * persist the summary. Mirrors Python `on_summary` (receptionist.py lines
288
+ * 278-287), which does nothing.
289
+ *
290
+ * The summary marks the end of the call, so this drops the call's check-in
291
+ * state. A subclass that overrides this hook should call
292
+ * `super.onSummary(summary, rawData)`; otherwise the state is dropped after
293
+ * the call has been idle for an hour.
288
294
  */
289
- onSummary(_summary, _rawData) {
290
- // Intentional no-op pass-through; subclasses override to handle the summary.
295
+ onSummary(_summary, rawData) {
296
+ const callId = rawData?.['call_id'];
297
+ if (typeof callId === 'string')
298
+ this.sessions.delete(callId);
291
299
  }
292
300
  }
293
301
  // ── Factory function ────────────────────────────────────────────────────────
@@ -1 +1 @@
1
- {"version":3,"file":"ReceptionistAgent.js","sourceRoot":"","sources":["../../src/prefabs/ReceptionistAgent.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ReceptionistAgent.js","sourceRoot":"","sources":["../../src/prefabs/ReceptionistAgent.ts"],"names":[],"mappings":"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"}
@@ -7,7 +7,9 @@
7
7
  * `nextQuestion`, answer scoring via `points`) alongside the Python surface.
8
8
  */
9
9
  import { AgentBase } from '../AgentBase.js';
10
+ import { FunctionResult } from '../FunctionResult.js';
10
11
  import type { AgentOptions } from '../types.js';
12
+ import type { PostPrompt } from '../SwaigContracts.js';
11
13
  /** A single survey question consumed by {@link SurveyAgent}. */
12
14
  export interface SurveyQuestion {
13
15
  /** Unique question identifier. */
@@ -81,8 +83,8 @@ export interface SurveyConfig {
81
83
  * brandName: 'Acme Co',
82
84
  * questions: [
83
85
  * { id: 'q1', text: 'How satisfied were you with our service?', type: 'rating', scale: 5 },
84
- * { id: 'q2', text: 'Would you recommend us to a friend?', type: 'yesno' },
85
- * { id: 'q3', text: 'Anything else you want to share?', type: 'open' },
86
+ * { id: 'q2', text: 'Would you recommend us to a friend?', type: 'yes_no' },
87
+ * { id: 'q3', text: 'Anything else you want to share?', type: 'open_ended' },
86
88
  * ],
87
89
  * });
88
90
  *
@@ -104,6 +106,7 @@ export declare class SurveyAgent extends AgentBase {
104
106
  conclusion: string;
105
107
  private questionMap;
106
108
  private onCompleteCallback?;
109
+ /** Per-call state, dropped on the call's summary or after an hour idle. */
107
110
  private sessions;
108
111
  /**
109
112
  * Create a SurveyAgent with the specified questions and callbacks.
@@ -124,10 +127,20 @@ export declare class SurveyAgent extends AgentBase {
124
127
  private normalizeAnswer;
125
128
  /**
126
129
  * Register SWAIG tools:
127
- * - Python-parity tools: `validate_response`, `log_response`
130
+ * - Tools matching the Python SDK: `validate_response`, `log_response`
128
131
  * - TS-specific session tools: `answer_question`, `get_current_question`, `get_survey_progress`
129
132
  */
130
133
  protected defineTools(): void;
134
+ /**
135
+ * SWAIG handler for `validate_response`: check whether a response satisfies a
136
+ * question's type/constraints. Mirrors Python `SurveyAgent.validate_response`.
137
+ */
138
+ validateResponse(args: Record<string, unknown>, _rawData: Record<string, unknown>): FunctionResult;
139
+ /**
140
+ * SWAIG handler for `log_response`: record a validated response on the per-call
141
+ * session. Mirrors Python `SurveyAgent.log_response`.
142
+ */
143
+ logResponse(args: Record<string, unknown>, rawData: Record<string, unknown>): FunctionResult;
131
144
  /**
132
145
  * Process the survey results summary returned at the end of a call.
133
146
  * Mirrors Python `on_summary`: structured (dict-like) summaries are logged
@@ -136,8 +149,13 @@ export declare class SurveyAgent extends AgentBase {
136
149
  * The parameter type widens the base `AgentBase.onSummary` signature to
137
150
  * accept string payloads as well, matching Python's `isinstance(summary, dict)`
138
151
  * branch even though the current framework only surfaces object summaries.
152
+ *
153
+ * The summary marks the end of the call, so this also drops the call's
154
+ * per-call survey state. A subclass that overrides this hook should call
155
+ * `super.onSummary(summary, rawData)`; otherwise the state is dropped after
156
+ * the call has been idle for an hour.
139
157
  */
140
- onSummary(summary: Record<string, unknown> | string | null, _rawData: Record<string, unknown>): void | Promise<void>;
158
+ onSummary(summary: Record<string, unknown> | string | null, rawData: PostPrompt): void | Promise<void>;
141
159
  }
142
160
  /**
143
161
  * Factory function that creates and returns a new SurveyAgent.
@@ -7,6 +7,7 @@
7
7
  * `nextQuestion`, answer scoring via `points`) alongside the Python surface.
8
8
  */
9
9
  import { AgentBase } from '../AgentBase.js';
10
+ import { CallSessionStore } from './CallSessionStore.js';
10
11
  import { FunctionResult } from '../FunctionResult.js';
11
12
  // ── Agent ───────────────────────────────────────────────────────────────────
12
13
  /**
@@ -25,8 +26,8 @@ import { FunctionResult } from '../FunctionResult.js';
25
26
  * brandName: 'Acme Co',
26
27
  * questions: [
27
28
  * { id: 'q1', text: 'How satisfied were you with our service?', type: 'rating', scale: 5 },
28
- * { id: 'q2', text: 'Would you recommend us to a friend?', type: 'yesno' },
29
- * { id: 'q3', text: 'Anything else you want to share?', type: 'open' },
29
+ * { id: 'q2', text: 'Would you recommend us to a friend?', type: 'yes_no' },
30
+ * { id: 'q3', text: 'Anything else you want to share?', type: 'open_ended' },
30
31
  * ],
31
32
  * });
32
33
  *
@@ -48,7 +49,8 @@ export class SurveyAgent extends AgentBase {
48
49
  conclusion;
49
50
  questionMap;
50
51
  onCompleteCallback;
51
- sessions = new Map();
52
+ /** Per-call state, dropped on the call's summary or after an hour idle. */
53
+ sessions = new CallSessionStore();
52
54
  /**
53
55
  * Create a SurveyAgent with the specified questions and callbacks.
54
56
  * @param config - Configuration including questions, messages, and completion callback.
@@ -67,7 +69,8 @@ export class SurveyAgent extends AgentBase {
67
69
  this.brandName = config.brandName ?? 'Our Company';
68
70
  this.maxRetries = config.maxRetries ?? 2;
69
71
  this.introduction =
70
- config.introduction ?? `Welcome to our ${config.surveyName}. We appreciate your participation.`;
72
+ config.introduction ??
73
+ `Welcome to our ${config.surveyName}. We appreciate your participation.`;
71
74
  this.conclusion =
72
75
  config.conclusion ?? 'Thank you for completing our survey. Your feedback is valuable to us.';
73
76
  this.onCompleteCallback = config.onComplete;
@@ -76,13 +79,13 @@ export class SurveyAgent extends AgentBase {
76
79
  this.questionMap = new Map(this.questions.map((q) => [q.id, q]));
77
80
  this.setupSurveyAgent();
78
81
  // Register tools after all fields are initialized
79
- this.defineTools();
82
+ this.ensureToolsDefined();
80
83
  }
81
84
  // ── Question validation (mirrors Python _validate_questions) ──────────
82
85
  validateQuestions() {
83
86
  const validTypes = new Set(['rating', 'multiple_choice', 'yes_no', 'open_ended']);
84
87
  for (let i = 0; i < this.questions.length; i++) {
85
- const q = this.questions[i];
88
+ const q = this.questions[i]; // i < length, so always in-bounds
86
89
  if (!q.id)
87
90
  q.id = `question_${i + 1}`;
88
91
  if (!q.text)
@@ -193,25 +196,22 @@ export class SurveyAgent extends AgentBase {
193
196
  // ── Session helpers ───────────────────────────────────────────────────
194
197
  getSession(rawData) {
195
198
  const callId = rawData['call_id'] ?? 'default';
196
- let session = this.sessions.get(callId);
197
- if (!session) {
199
+ return this.sessions.getOrCreate(callId, () => {
198
200
  const firstQuestion = this.questions[0];
199
- session = {
201
+ return {
200
202
  currentQuestionIndex: 0,
201
203
  currentQuestionId: firstQuestion ? firstQuestion.id : '',
202
204
  responses: {},
203
205
  score: 0,
204
206
  completed: false,
205
207
  };
206
- this.sessions.set(callId, session);
207
- }
208
- return session;
208
+ });
209
209
  }
210
210
  resolveNextQuestion(question, answer) {
211
211
  if (!question.nextQuestion) {
212
212
  const idx = this.questions.findIndex((q) => q.id === question.id);
213
213
  if (idx >= 0 && idx < this.questions.length - 1) {
214
- return this.questions[idx + 1].id;
214
+ return this.questions[idx + 1].id; // idx+1 < length, in-bounds
215
215
  }
216
216
  return null;
217
217
  }
@@ -229,7 +229,7 @@ export class SurveyAgent extends AgentBase {
229
229
  }
230
230
  const idx = this.questions.findIndex((q) => q.id === question.id);
231
231
  if (idx >= 0 && idx < this.questions.length - 1) {
232
- return this.questions[idx + 1].id;
232
+ return this.questions[idx + 1].id; // idx+1 < length, in-bounds
233
233
  }
234
234
  return null;
235
235
  }
@@ -302,7 +302,7 @@ export class SurveyAgent extends AgentBase {
302
302
  // ── Tool registration ─────────────────────────────────────────────────
303
303
  /**
304
304
  * Register SWAIG tools:
305
- * - Python-parity tools: `validate_response`, `log_response`
305
+ * - Tools matching the Python SDK: `validate_response`, `log_response`
306
306
  * - TS-specific session tools: `answer_question`, `get_current_question`, `get_survey_progress`
307
307
  */
308
308
  defineTools() {
@@ -323,18 +323,7 @@ export class SurveyAgent extends AgentBase {
323
323
  },
324
324
  },
325
325
  },
326
- handler: (args) => {
327
- const questionId = args['question_id'] ?? '';
328
- const response = args['response'] ?? '';
329
- const question = this.questionMap.get(questionId);
330
- if (!question) {
331
- return new FunctionResult(`Error: Question with ID '${questionId}' not found.`);
332
- }
333
- const error = this.validateAnswer(question, response);
334
- if (error)
335
- return new FunctionResult(error);
336
- return new FunctionResult(`Response to '${questionId}' is valid.`);
337
- },
326
+ handler: this._onCallAgent((self, args, rawData) => self.validateResponse(args, rawData)),
338
327
  });
339
328
  // Tool: log_response (Python parity — acknowledge recording)
340
329
  this.defineTool({
@@ -353,18 +342,7 @@ export class SurveyAgent extends AgentBase {
353
342
  },
354
343
  },
355
344
  },
356
- handler: (args, rawData) => {
357
- const questionId = args['question_id'] ?? '';
358
- const response = args['response'] ?? '';
359
- const question = this.questionMap.get(questionId);
360
- const questionText = question ? question.text : '';
361
- // Record on the per-call session for observability.
362
- const session = this.getSession(rawData);
363
- if (question) {
364
- session.responses[questionId] = this.normalizeAnswer(question, response);
365
- }
366
- return new FunctionResult(`Response to '${questionText}' has been recorded.`);
367
- },
345
+ handler: this._onCallAgent((self, args, rawData) => self.logResponse(args, rawData)),
368
346
  });
369
347
  // Tool: answer_question (TS-specific atomic validate+record+advance)
370
348
  this.defineTool({
@@ -384,45 +362,45 @@ export class SurveyAgent extends AgentBase {
384
362
  },
385
363
  required: ['question_id', 'answer'],
386
364
  },
387
- handler: async (args, rawData) => {
388
- const questionId = args['question_id'];
389
- const answer = args['answer'];
365
+ handler: this._onCallAgent(async (self, args, rawData) => {
366
+ const questionId = args.question_id;
367
+ const answer = args.answer;
390
368
  if (!questionId || !answer) {
391
369
  return new FunctionResult('Both question_id and answer are required.');
392
370
  }
393
- const question = this.questionMap.get(questionId);
371
+ const question = self.questionMap.get(questionId);
394
372
  if (!question) {
395
373
  return new FunctionResult(`Unknown question ID "${questionId}".`);
396
374
  }
397
- const session = this.getSession(rawData);
375
+ const session = self.getSession(rawData);
398
376
  if (session.completed) {
399
377
  return new FunctionResult('The survey has already been completed.');
400
378
  }
401
- const validationError = this.validateAnswer(question, answer);
379
+ const validationError = self.validateAnswer(question, answer);
402
380
  if (validationError) {
403
381
  return new FunctionResult(validationError);
404
382
  }
405
- const normalizedAnswer = this.normalizeAnswer(question, answer);
383
+ const normalizedAnswer = self.normalizeAnswer(question, answer);
406
384
  session.responses[questionId] = normalizedAnswer;
407
- const points = this.calculatePoints(question, normalizedAnswer);
385
+ const points = self.calculatePoints(question, normalizedAnswer);
408
386
  session.score += points;
409
- const nextId = this.resolveNextQuestion(question, normalizedAnswer);
410
- if (!nextId || !this.questionMap.has(nextId)) {
387
+ const nextId = self.resolveNextQuestion(question, normalizedAnswer);
388
+ if (!nextId || !self.questionMap.has(nextId)) {
411
389
  session.completed = true;
412
- if (this.onCompleteCallback) {
390
+ if (self.onCompleteCallback) {
413
391
  try {
414
- await this.onCompleteCallback({ ...session.responses }, session.score);
392
+ await self.onCompleteCallback({ ...session.responses }, session.score);
415
393
  }
416
394
  catch (err) {
417
- this.log.error(`onComplete callback error: ${err}`);
395
+ self.log.error(`onComplete callback error: ${err}`);
418
396
  }
419
397
  }
420
398
  const answeredCount = Object.keys(session.responses).length;
421
- return new FunctionResult(`Answer recorded. The survey is now complete! ${answeredCount} questions answered, total score: ${session.score}. ${this.conclusion}`);
399
+ return new FunctionResult(`Answer recorded. The survey is now complete! ${answeredCount} questions answered, total score: ${session.score}. ${self.conclusion}`);
422
400
  }
423
401
  session.currentQuestionId = nextId;
424
- const nextQ = this.questionMap.get(nextId);
425
- const nextIdx = this.questions.findIndex((q) => q.id === nextId);
402
+ const nextQ = self.questionMap.get(nextId);
403
+ const nextIdx = self.questions.findIndex((q) => q.id === nextId);
426
404
  if (nextIdx >= 0)
427
405
  session.currentQuestionIndex = nextIdx;
428
406
  let nextInfo = `Answer recorded. Next question [${nextQ.id}]: "${nextQ.text}"`;
@@ -436,7 +414,7 @@ export class SurveyAgent extends AgentBase {
436
414
  nextInfo += ' (Yes/No)';
437
415
  }
438
416
  return new FunctionResult(nextInfo);
439
- },
417
+ }),
440
418
  });
441
419
  // Tool: get_current_question
442
420
  this.defineTool({
@@ -446,12 +424,12 @@ export class SurveyAgent extends AgentBase {
446
424
  type: 'object',
447
425
  properties: {},
448
426
  },
449
- handler: (_args, rawData) => {
450
- const session = this.getSession(rawData);
427
+ handler: this._onCallAgent((self, _args, rawData) => {
428
+ const session = self.getSession(rawData);
451
429
  if (session.completed) {
452
430
  return new FunctionResult('The survey has been completed. No more questions.');
453
431
  }
454
- const question = this.questionMap.get(session.currentQuestionId);
432
+ const question = self.questionMap.get(session.currentQuestionId);
455
433
  if (!question) {
456
434
  return new FunctionResult('No current question available.');
457
435
  }
@@ -466,7 +444,7 @@ export class SurveyAgent extends AgentBase {
466
444
  info += ' (Caller should answer yes or no)';
467
445
  }
468
446
  return new FunctionResult(info);
469
- },
447
+ }),
470
448
  });
471
449
  // Tool: get_survey_progress
472
450
  this.defineTool({
@@ -476,10 +454,10 @@ export class SurveyAgent extends AgentBase {
476
454
  type: 'object',
477
455
  properties: {},
478
456
  },
479
- handler: (_args, rawData) => {
480
- const session = this.getSession(rawData);
457
+ handler: this._onCallAgent((self, _args, rawData) => {
458
+ const session = self.getSession(rawData);
481
459
  const answeredCount = Object.keys(session.responses).length;
482
- const totalCount = this.questions.length;
460
+ const totalCount = self.questions.length;
483
461
  const percentage = totalCount > 0 ? Math.round((answeredCount / totalCount) * 100) : 0;
484
462
  let progress = `Survey progress: ${answeredCount}/${totalCount} questions answered (${percentage}%). Current score: ${session.score}.`;
485
463
  if (session.completed) {
@@ -495,9 +473,42 @@ export class SurveyAgent extends AgentBase {
495
473
  progress += ` Answers so far: ${answered}`;
496
474
  }
497
475
  return new FunctionResult(progress);
498
- },
476
+ }),
499
477
  });
500
478
  }
479
+ // ── SWAIG tool handlers (named methods, mirroring the Python prefab) ───
480
+ /**
481
+ * SWAIG handler for `validate_response`: check whether a response satisfies a
482
+ * question's type/constraints. Mirrors Python `SurveyAgent.validate_response`.
483
+ */
484
+ validateResponse(args, _rawData) {
485
+ const questionId = args['question_id'] ?? '';
486
+ const response = args['response'] ?? '';
487
+ const question = this.questionMap.get(questionId);
488
+ if (!question) {
489
+ return new FunctionResult(`Error: Question with ID '${questionId}' not found.`);
490
+ }
491
+ const error = this.validateAnswer(question, response);
492
+ if (error)
493
+ return new FunctionResult(error);
494
+ return new FunctionResult(`Response to '${questionId}' is valid.`);
495
+ }
496
+ /**
497
+ * SWAIG handler for `log_response`: record a validated response on the per-call
498
+ * session. Mirrors Python `SurveyAgent.log_response`.
499
+ */
500
+ logResponse(args, rawData) {
501
+ const questionId = args['question_id'] ?? '';
502
+ const response = args['response'] ?? '';
503
+ const question = this.questionMap.get(questionId);
504
+ const questionText = question ? question.text : '';
505
+ // Record on the per-call session for observability.
506
+ const session = this.getSession(rawData);
507
+ if (question) {
508
+ session.responses[questionId] = this.normalizeAnswer(question, response);
509
+ }
510
+ return new FunctionResult(`Response to '${questionText}' has been recorded.`);
511
+ }
501
512
  // ── Lifecycle hooks ───────────────────────────────────────────────────
502
513
  /**
503
514
  * Process the survey results summary returned at the end of a call.
@@ -507,21 +518,26 @@ export class SurveyAgent extends AgentBase {
507
518
  * The parameter type widens the base `AgentBase.onSummary` signature to
508
519
  * accept string payloads as well, matching Python's `isinstance(summary, dict)`
509
520
  * branch even though the current framework only surfaces object summaries.
521
+ *
522
+ * The summary marks the end of the call, so this also drops the call's
523
+ * per-call survey state. A subclass that overrides this hook should call
524
+ * `super.onSummary(summary, rawData)`; otherwise the state is dropped after
525
+ * the call has been idle for an hour.
510
526
  */
511
- onSummary(summary, _rawData) {
527
+ onSummary(summary, rawData) {
528
+ const callId = rawData?.['call_id'];
529
+ if (typeof callId === 'string')
530
+ this.sessions.delete(callId);
512
531
  if (summary) {
513
532
  try {
514
533
  if (typeof summary === 'string') {
515
- // eslint-disable-next-line no-console
516
534
  console.log(`Survey summary (unstructured): ${summary}`);
517
535
  }
518
536
  else {
519
- // eslint-disable-next-line no-console
520
537
  console.log(`Survey completed: ${JSON.stringify(summary, null, 2)}`);
521
538
  }
522
539
  }
523
540
  catch (err) {
524
- // eslint-disable-next-line no-console
525
541
  console.log(`Error processing survey summary: ${String(err)}`);
526
542
  }
527
543
  }