@signalwire/sdk 2.0.1 → 2.0.2

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 (610) hide show
  1. package/dist/AgentBase.d.ts +1045 -0
  2. package/dist/AgentBase.js +2375 -0
  3. package/dist/AgentBase.js.map +1 -0
  4. package/dist/AgentServer.d.ts +146 -0
  5. package/dist/AgentServer.js +388 -0
  6. package/dist/AgentServer.js.map +1 -0
  7. package/dist/AuthHandler.d.ts +127 -0
  8. package/dist/AuthHandler.js +212 -0
  9. package/dist/AuthHandler.js.map +1 -0
  10. package/dist/ConfigLoader.d.ts +170 -0
  11. package/dist/ConfigLoader.js +393 -0
  12. package/dist/ConfigLoader.js.map +1 -0
  13. package/dist/ContextBuilder.d.ts +652 -0
  14. package/dist/ContextBuilder.js +1115 -0
  15. package/dist/ContextBuilder.js.map +1 -0
  16. package/dist/DataMap.d.ts +271 -0
  17. package/dist/DataMap.js +430 -0
  18. package/dist/DataMap.js.map +1 -0
  19. package/dist/FunctionResult.d.ts +481 -0
  20. package/dist/FunctionResult.js +775 -0
  21. package/dist/FunctionResult.js.map +1 -0
  22. package/dist/Logger.d.ts +113 -0
  23. package/dist/Logger.js +320 -0
  24. package/dist/Logger.js.map +1 -0
  25. package/dist/PomBuilder.d.ts +208 -0
  26. package/dist/PomBuilder.js +409 -0
  27. package/dist/PomBuilder.js.map +1 -0
  28. package/dist/PromptManager.d.ts +85 -0
  29. package/dist/PromptManager.js +108 -0
  30. package/dist/PromptManager.js.map +1 -0
  31. package/dist/SWMLHandler.d.ts +159 -0
  32. package/dist/SWMLHandler.js +229 -0
  33. package/dist/SWMLHandler.js.map +1 -0
  34. package/dist/SWMLService.d.ts +326 -0
  35. package/dist/SWMLService.js +610 -0
  36. package/dist/SWMLService.js.map +1 -0
  37. package/dist/SchemaUtils.d.ts +108 -0
  38. package/dist/SchemaUtils.js +317 -0
  39. package/dist/SchemaUtils.js.map +1 -0
  40. package/dist/SecurityUtils.d.ts +60 -0
  41. package/{src/SecurityUtils.ts → dist/SecurityUtils.js} +82 -83
  42. package/dist/SecurityUtils.js.map +1 -0
  43. package/dist/ServerlessAdapter.d.ts +119 -0
  44. package/dist/ServerlessAdapter.js +188 -0
  45. package/dist/ServerlessAdapter.js.map +1 -0
  46. package/dist/SessionManager.d.ts +142 -0
  47. package/dist/SessionManager.js +260 -0
  48. package/dist/SessionManager.js.map +1 -0
  49. package/dist/SslConfig.d.ts +77 -0
  50. package/dist/SslConfig.js +100 -0
  51. package/dist/SslConfig.js.map +1 -0
  52. package/dist/SwaigFunction.d.ts +159 -0
  53. package/dist/SwaigFunction.js +209 -0
  54. package/dist/SwaigFunction.js.map +1 -0
  55. package/dist/SwmlBuilder.d.ts +165 -0
  56. package/dist/SwmlBuilder.js +247 -0
  57. package/dist/SwmlBuilder.js.map +1 -0
  58. package/dist/SwmlVerbMethods.generated.d.ts +254 -0
  59. package/dist/SwmlVerbMethods.generated.js +9 -0
  60. package/dist/SwmlVerbMethods.generated.js.map +1 -0
  61. package/dist/TypeInference.d.ts +71 -0
  62. package/dist/TypeInference.js +164 -0
  63. package/dist/TypeInference.js.map +1 -0
  64. package/dist/WebService.d.ts +148 -0
  65. package/dist/WebService.js +532 -0
  66. package/dist/WebService.js.map +1 -0
  67. package/dist/cli/agent-loader.d.ts +22 -0
  68. package/dist/cli/agent-loader.js +144 -0
  69. package/dist/cli/agent-loader.js.map +1 -0
  70. package/dist/cli/mock-data.d.ts +37 -0
  71. package/dist/cli/mock-data.js +80 -0
  72. package/dist/cli/mock-data.js.map +1 -0
  73. package/dist/cli/swaig-test.d.ts +32 -0
  74. package/dist/cli/swaig-test.js +418 -0
  75. package/dist/cli/swaig-test.js.map +1 -0
  76. package/dist/generateVerbTypes.d.ts +11 -0
  77. package/dist/generateVerbTypes.js +265 -0
  78. package/dist/generateVerbTypes.js.map +1 -0
  79. package/{src/index.ts → dist/index.d.ts} +13 -100
  80. package/dist/index.js +152 -0
  81. package/dist/index.js.map +1 -0
  82. package/dist/livewire/index.d.ts +653 -0
  83. package/dist/livewire/index.js +992 -0
  84. package/dist/livewire/index.js.map +1 -0
  85. package/dist/prefabs/ConciergeAgent.d.ts +89 -0
  86. package/dist/prefabs/ConciergeAgent.js +245 -0
  87. package/dist/prefabs/ConciergeAgent.js.map +1 -0
  88. package/dist/prefabs/FAQBotAgent.d.ts +113 -0
  89. package/dist/prefabs/FAQBotAgent.js +329 -0
  90. package/dist/prefabs/FAQBotAgent.js.map +1 -0
  91. package/dist/prefabs/InfoGathererAgent.d.ts +126 -0
  92. package/dist/prefabs/InfoGathererAgent.js +287 -0
  93. package/dist/prefabs/InfoGathererAgent.js.map +1 -0
  94. package/dist/prefabs/ReceptionistAgent.d.ts +104 -0
  95. package/dist/prefabs/ReceptionistAgent.js +303 -0
  96. package/dist/prefabs/ReceptionistAgent.js.map +1 -0
  97. package/dist/prefabs/SurveyAgent.d.ts +148 -0
  98. package/dist/prefabs/SurveyAgent.js +540 -0
  99. package/dist/prefabs/SurveyAgent.js.map +1 -0
  100. package/{src/prefabs/index.ts → dist/prefabs/index.d.ts} +1 -15
  101. package/dist/prefabs/index.js +14 -0
  102. package/dist/prefabs/index.js.map +1 -0
  103. package/dist/relay/Action.d.ts +258 -0
  104. package/dist/relay/Action.js +402 -0
  105. package/dist/relay/Action.js.map +1 -0
  106. package/dist/relay/Call.d.ts +697 -0
  107. package/dist/relay/Call.js +1062 -0
  108. package/dist/relay/Call.js.map +1 -0
  109. package/dist/relay/Deferred.d.ts +44 -0
  110. package/dist/relay/Deferred.js +69 -0
  111. package/dist/relay/Deferred.js.map +1 -0
  112. package/dist/relay/Message.d.ts +103 -0
  113. package/dist/relay/Message.js +169 -0
  114. package/dist/relay/Message.js.map +1 -0
  115. package/dist/relay/RelayClient.d.ts +302 -0
  116. package/dist/relay/RelayClient.js +1019 -0
  117. package/dist/relay/RelayClient.js.map +1 -0
  118. package/dist/relay/RelayError.d.ts +15 -0
  119. package/dist/relay/RelayError.js +20 -0
  120. package/dist/relay/RelayError.js.map +1 -0
  121. package/dist/relay/RelayEvent.d.ts +254 -0
  122. package/dist/relay/RelayEvent.js +509 -0
  123. package/dist/relay/RelayEvent.js.map +1 -0
  124. package/dist/relay/constants.d.ts +90 -0
  125. package/{src/relay/constants.ts → dist/relay/constants.js} +11 -29
  126. package/dist/relay/constants.js.map +1 -0
  127. package/dist/relay/index.d.ts +16 -0
  128. package/dist/relay/index.js +18 -0
  129. package/dist/relay/index.js.map +1 -0
  130. package/dist/relay/types.d.ts +142 -0
  131. package/dist/relay/types.js +5 -0
  132. package/dist/relay/types.js.map +1 -0
  133. package/dist/rest/HttpClient.d.ts +80 -0
  134. package/dist/rest/HttpClient.js +148 -0
  135. package/dist/rest/HttpClient.js.map +1 -0
  136. package/dist/rest/RestError.d.ts +30 -0
  137. package/dist/rest/RestError.js +39 -0
  138. package/dist/rest/RestError.js.map +1 -0
  139. package/dist/rest/base/BaseResource.d.ts +24 -0
  140. package/dist/rest/base/BaseResource.js +29 -0
  141. package/dist/rest/base/BaseResource.js.map +1 -0
  142. package/dist/rest/base/CrudResource.d.ts +68 -0
  143. package/dist/rest/base/CrudResource.js +82 -0
  144. package/dist/rest/base/CrudResource.js.map +1 -0
  145. package/dist/rest/base/CrudWithAddresses.d.ts +22 -0
  146. package/dist/rest/base/CrudWithAddresses.js +25 -0
  147. package/dist/rest/base/CrudWithAddresses.js.map +1 -0
  148. package/dist/rest/index.d.ts +131 -0
  149. package/{src/rest/index.ts → dist/rest/index.js} +101 -136
  150. package/dist/rest/index.js.map +1 -0
  151. package/dist/rest/namespaces/addresses.d.ts +46 -0
  152. package/dist/rest/namespaces/addresses.js +55 -0
  153. package/dist/rest/namespaces/addresses.js.map +1 -0
  154. package/dist/rest/namespaces/calling.d.ts +382 -0
  155. package/dist/rest/namespaces/calling.js +478 -0
  156. package/dist/rest/namespaces/calling.js.map +1 -0
  157. package/dist/rest/namespaces/chat.d.ts +22 -0
  158. package/dist/rest/namespaces/chat.js +26 -0
  159. package/dist/rest/namespaces/chat.js.map +1 -0
  160. package/dist/rest/namespaces/compat.d.ts +585 -0
  161. package/dist/rest/namespaces/compat.js +735 -0
  162. package/dist/rest/namespaces/compat.js.map +1 -0
  163. package/dist/rest/namespaces/datasphere.d.ts +66 -0
  164. package/dist/rest/namespaces/datasphere.js +77 -0
  165. package/dist/rest/namespaces/datasphere.js.map +1 -0
  166. package/dist/rest/namespaces/fabric.d.ts +282 -0
  167. package/dist/rest/namespaces/fabric.js +373 -0
  168. package/dist/rest/namespaces/fabric.js.map +1 -0
  169. package/dist/rest/namespaces/imported-numbers.d.ts +22 -0
  170. package/dist/rest/namespaces/imported-numbers.js +26 -0
  171. package/dist/rest/namespaces/imported-numbers.js.map +1 -0
  172. package/dist/rest/namespaces/logs.d.ts +105 -0
  173. package/dist/rest/namespaces/logs.js +133 -0
  174. package/dist/rest/namespaces/logs.js.map +1 -0
  175. package/dist/rest/namespaces/lookup.d.ts +29 -0
  176. package/dist/rest/namespaces/lookup.js +32 -0
  177. package/dist/rest/namespaces/lookup.js.map +1 -0
  178. package/dist/rest/namespaces/mfa.d.ts +46 -0
  179. package/dist/rest/namespaces/mfa.js +54 -0
  180. package/dist/rest/namespaces/mfa.js.map +1 -0
  181. package/dist/rest/namespaces/number-groups.d.ts +49 -0
  182. package/dist/rest/namespaces/number-groups.js +58 -0
  183. package/dist/rest/namespaces/number-groups.js.map +1 -0
  184. package/dist/rest/namespaces/phone-numbers.d.ts +60 -0
  185. package/dist/rest/namespaces/phone-numbers.js +67 -0
  186. package/dist/rest/namespaces/phone-numbers.js.map +1 -0
  187. package/dist/rest/namespaces/project.d.ts +46 -0
  188. package/dist/rest/namespaces/project.js +56 -0
  189. package/dist/rest/namespaces/project.js.map +1 -0
  190. package/dist/rest/namespaces/pubsub.d.ts +22 -0
  191. package/dist/rest/namespaces/pubsub.js +26 -0
  192. package/dist/rest/namespaces/pubsub.js.map +1 -0
  193. package/dist/rest/namespaces/queues.d.ts +42 -0
  194. package/dist/rest/namespaces/queues.js +49 -0
  195. package/dist/rest/namespaces/queues.js.map +1 -0
  196. package/dist/rest/namespaces/recordings.d.ts +38 -0
  197. package/dist/rest/namespaces/recordings.js +45 -0
  198. package/dist/rest/namespaces/recordings.js.map +1 -0
  199. package/dist/rest/namespaces/registry.d.ts +141 -0
  200. package/dist/rest/namespaces/registry.js +178 -0
  201. package/dist/rest/namespaces/registry.js.map +1 -0
  202. package/dist/rest/namespaces/short-codes.d.ts +39 -0
  203. package/dist/rest/namespaces/short-codes.js +46 -0
  204. package/dist/rest/namespaces/short-codes.js.map +1 -0
  205. package/dist/rest/namespaces/sip-profile.d.ts +28 -0
  206. package/dist/rest/namespaces/sip-profile.js +34 -0
  207. package/dist/rest/namespaces/sip-profile.js.map +1 -0
  208. package/dist/rest/namespaces/verified-callers.d.ts +33 -0
  209. package/dist/rest/namespaces/verified-callers.js +39 -0
  210. package/dist/rest/namespaces/verified-callers.js.map +1 -0
  211. package/dist/rest/namespaces/video.d.ts +235 -0
  212. package/dist/rest/namespaces/video.js +297 -0
  213. package/dist/rest/namespaces/video.js.map +1 -0
  214. package/{src/rest/pagination.ts → dist/rest/pagination.d.ts} +2 -61
  215. package/dist/rest/pagination.js +78 -0
  216. package/dist/rest/pagination.js.map +1 -0
  217. package/dist/rest/types.d.ts +54 -0
  218. package/dist/rest/types.js +5 -0
  219. package/dist/rest/types.js.map +1 -0
  220. package/dist/skills/SkillBase.d.ts +404 -0
  221. package/dist/skills/SkillBase.js +471 -0
  222. package/dist/skills/SkillBase.js.map +1 -0
  223. package/dist/skills/SkillManager.d.ts +195 -0
  224. package/dist/skills/SkillManager.js +378 -0
  225. package/dist/skills/SkillManager.js.map +1 -0
  226. package/dist/skills/SkillRegistry.d.ts +176 -0
  227. package/dist/skills/SkillRegistry.js +310 -0
  228. package/dist/skills/SkillRegistry.js.map +1 -0
  229. package/dist/skills/builtin/api_ninjas_trivia.d.ts +47 -0
  230. package/dist/skills/builtin/api_ninjas_trivia.js +211 -0
  231. package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -0
  232. package/dist/skills/builtin/ask_claude.d.ts +37 -0
  233. package/dist/skills/builtin/ask_claude.js +162 -0
  234. package/dist/skills/builtin/ask_claude.js.map +1 -0
  235. package/dist/skills/builtin/claude_skills.d.ts +75 -0
  236. package/dist/skills/builtin/claude_skills.js +753 -0
  237. package/dist/skills/builtin/claude_skills.js.map +1 -0
  238. package/dist/skills/builtin/custom_skills.d.ts +79 -0
  239. package/dist/skills/builtin/custom_skills.js +227 -0
  240. package/dist/skills/builtin/custom_skills.js.map +1 -0
  241. package/dist/skills/builtin/datasphere.d.ts +73 -0
  242. package/dist/skills/builtin/datasphere.js +350 -0
  243. package/dist/skills/builtin/datasphere.js.map +1 -0
  244. package/dist/skills/builtin/datasphere_serverless.d.ts +89 -0
  245. package/dist/skills/builtin/datasphere_serverless.js +291 -0
  246. package/dist/skills/builtin/datasphere_serverless.js.map +1 -0
  247. package/dist/skills/builtin/datetime.d.ts +40 -0
  248. package/dist/skills/builtin/datetime.js +118 -0
  249. package/dist/skills/builtin/datetime.js.map +1 -0
  250. package/dist/skills/builtin/google_maps.d.ts +48 -0
  251. package/dist/skills/builtin/google_maps.js +470 -0
  252. package/dist/skills/builtin/google_maps.js.map +1 -0
  253. package/dist/skills/builtin/index.d.ts +31 -0
  254. package/{src/skills/builtin/index.ts → dist/skills/builtin/index.js} +30 -36
  255. package/dist/skills/builtin/index.js.map +1 -0
  256. package/dist/skills/builtin/info_gatherer.d.ts +115 -0
  257. package/dist/skills/builtin/info_gatherer.js +328 -0
  258. package/dist/skills/builtin/info_gatherer.js.map +1 -0
  259. package/dist/skills/builtin/joke.d.ts +41 -0
  260. package/dist/skills/builtin/joke.js +156 -0
  261. package/dist/skills/builtin/joke.js.map +1 -0
  262. package/dist/skills/builtin/math.d.ts +39 -0
  263. package/dist/skills/builtin/math.js +119 -0
  264. package/dist/skills/builtin/math.js.map +1 -0
  265. package/dist/skills/builtin/mcp_gateway.d.ts +82 -0
  266. package/dist/skills/builtin/mcp_gateway.js +574 -0
  267. package/dist/skills/builtin/mcp_gateway.js.map +1 -0
  268. package/dist/skills/builtin/native_vector_search.d.ts +128 -0
  269. package/dist/skills/builtin/native_vector_search.js +752 -0
  270. package/dist/skills/builtin/native_vector_search.js.map +1 -0
  271. package/dist/skills/builtin/play_background_file.d.ts +59 -0
  272. package/dist/skills/builtin/play_background_file.js +274 -0
  273. package/dist/skills/builtin/play_background_file.js.map +1 -0
  274. package/dist/skills/builtin/spider.d.ts +91 -0
  275. package/dist/skills/builtin/spider.js +758 -0
  276. package/dist/skills/builtin/spider.js.map +1 -0
  277. package/dist/skills/builtin/swml_transfer.d.ts +66 -0
  278. package/dist/skills/builtin/swml_transfer.js +475 -0
  279. package/dist/skills/builtin/swml_transfer.js.map +1 -0
  280. package/dist/skills/builtin/weather_api.d.ts +59 -0
  281. package/dist/skills/builtin/weather_api.js +196 -0
  282. package/dist/skills/builtin/weather_api.js.map +1 -0
  283. package/dist/skills/builtin/web_search.d.ts +160 -0
  284. package/dist/skills/builtin/web_search.js +894 -0
  285. package/dist/skills/builtin/web_search.js.map +1 -0
  286. package/dist/skills/builtin/wikipedia_search.d.ts +77 -0
  287. package/dist/skills/builtin/wikipedia_search.js +241 -0
  288. package/dist/skills/builtin/wikipedia_search.js.map +1 -0
  289. package/{src/skills/index.ts → dist/skills/index.d.ts} +0 -1
  290. package/dist/skills/index.js +10 -0
  291. package/dist/skills/index.js.map +1 -0
  292. package/dist/types.d.ts +118 -0
  293. package/dist/types.js +5 -0
  294. package/dist/types.js.map +1 -0
  295. package/package.json +7 -1
  296. package/.github/workflows/publish.yml +0 -27
  297. package/.github/workflows/test.yml +0 -17
  298. package/CLAUDE.md +0 -112
  299. package/docs/MIGRATION-2.0.md +0 -81
  300. package/docs/agent-guide.md +0 -869
  301. package/docs/agent_guide.md +0 -1026
  302. package/docs/api-reference.md +0 -2420
  303. package/docs/api_reference.md +0 -1301
  304. package/docs/architecture.md +0 -843
  305. package/docs/cli-guide.md +0 -579
  306. package/docs/cli_guide.md +0 -448
  307. package/docs/cloud_functions_guide.md +0 -474
  308. package/docs/configuration.md +0 -422
  309. package/docs/contexts-guide.md +0 -787
  310. package/docs/contexts_guide.md +0 -511
  311. package/docs/datamap-guide.md +0 -1141
  312. package/docs/datamap_guide.md +0 -595
  313. package/docs/llm_parameters.md +0 -239
  314. package/docs/mcp_gateway_reference.md +0 -648
  315. package/docs/mcp_integration.md +0 -108
  316. package/docs/prefabs-guide.md +0 -800
  317. package/docs/sdk_features.md +0 -477
  318. package/docs/security.md +0 -436
  319. package/docs/serverless-guide.md +0 -513
  320. package/docs/skills-guide.md +0 -857
  321. package/docs/skills-system.md +0 -301
  322. package/docs/skills_parameter_schema.md +0 -392
  323. package/docs/skills_system.md +0 -467
  324. package/docs/swaig-reference.md +0 -1627
  325. package/docs/swaig_reference.md +0 -910
  326. package/docs/swml_service_guide.md +0 -600
  327. package/docs/third_party_skills.md +0 -533
  328. package/docs/web_service.md +0 -677
  329. package/examples/README.md +0 -131
  330. package/examples/advanced-datamap.ts +0 -100
  331. package/examples/advanced-dynamic-config.ts +0 -70
  332. package/examples/auto-vivified.ts +0 -94
  333. package/examples/call-flow.ts +0 -63
  334. package/examples/comprehensive-dynamic.ts +0 -125
  335. package/examples/contexts-steps.ts +0 -65
  336. package/examples/custom-path.ts +0 -45
  337. package/examples/datamap-tools.ts +0 -55
  338. package/examples/datasphere-multi-instance.ts +0 -63
  339. package/examples/datasphere-serverless-env.ts +0 -68
  340. package/examples/datasphere-webhook-env.ts +0 -66
  341. package/examples/datasphere.ts +0 -37
  342. package/examples/declarative.ts +0 -100
  343. package/examples/dynamic-config.ts +0 -54
  344. package/examples/dynamic-info-gatherer.ts +0 -69
  345. package/examples/dynamic-swml-service.ts +0 -67
  346. package/examples/gather-info.ts +0 -71
  347. package/examples/gather-per-question-functions-demo.ts +0 -140
  348. package/examples/joke-agent.ts +0 -34
  349. package/examples/kubernetes-agent.ts +0 -45
  350. package/examples/llm-params.ts +0 -69
  351. package/examples/mcp-agent.ts +0 -84
  352. package/examples/mcp-gateway.ts +0 -35
  353. package/examples/multi-agent.ts +0 -73
  354. package/examples/multi-endpoint.ts +0 -79
  355. package/examples/pom-prompt.ts +0 -71
  356. package/examples/prefab-concierge.ts +0 -47
  357. package/examples/prefab-faq.ts +0 -54
  358. package/examples/prefab-info-gatherer.ts +0 -33
  359. package/examples/prefab-receptionist.ts +0 -36
  360. package/examples/prefab-survey.ts +0 -68
  361. package/examples/record-call.ts +0 -67
  362. package/examples/relay-demo.ts +0 -33
  363. package/examples/room-and-sip.ts +0 -94
  364. package/examples/serverless-lambda.ts +0 -35
  365. package/examples/session-state.ts +0 -83
  366. package/examples/simple-agent.ts +0 -36
  367. package/examples/simple-static.ts +0 -29
  368. package/examples/skills-demo.ts +0 -38
  369. package/examples/step-function-inheritance-demo.ts +0 -124
  370. package/examples/swaig-features.ts +0 -187
  371. package/examples/swml-service-routing.ts +0 -66
  372. package/examples/swml-service.ts +0 -38
  373. package/examples/tap.ts +0 -68
  374. package/examples/verb-methods.ts +0 -45
  375. package/examples/web-search-multi-instance.ts +0 -72
  376. package/examples/web-search.ts +0 -38
  377. package/examples/wikipedia.ts +0 -36
  378. package/livewire/README.md +0 -140
  379. package/livewire/docs/migration-guide.md +0 -228
  380. package/livewire/examples/livewire-basic-agent.ts +0 -74
  381. package/livewire/examples/livewire-handoff.ts +0 -197
  382. package/livewire/examples/livewire-multi-tool.ts +0 -117
  383. package/relay/README.md +0 -70
  384. package/relay/RELAY_IMPLEMENTATION_GUIDE.md +0 -1257
  385. package/relay/docs/call-methods.md +0 -474
  386. package/relay/docs/client-reference.md +0 -142
  387. package/relay/docs/events.md +0 -134
  388. package/relay/docs/getting-started.md +0 -134
  389. package/relay/docs/guide.md +0 -306
  390. package/relay/docs/messaging.md +0 -182
  391. package/relay/examples/relay-inbound.ts +0 -66
  392. package/relay/examples/relay-messaging.ts +0 -71
  393. package/relay/examples/relay-outbound.ts +0 -76
  394. package/rest/README.md +0 -95
  395. package/rest/docs/calling.md +0 -273
  396. package/rest/docs/client-reference.md +0 -107
  397. package/rest/docs/compat.md +0 -204
  398. package/rest/docs/fabric.md +0 -183
  399. package/rest/docs/getting-started.md +0 -110
  400. package/rest/docs/guide.md +0 -351
  401. package/rest/docs/namespaces.md +0 -285
  402. package/rest/examples/rest-10dlc-registration.ts +0 -161
  403. package/rest/examples/rest-calling-ivr-and-ai.ts +0 -102
  404. package/rest/examples/rest-calling-play-and-record.ts +0 -91
  405. package/rest/examples/rest-client.ts +0 -65
  406. package/rest/examples/rest-compat-laml.ts +0 -210
  407. package/rest/examples/rest-datasphere-search.ts +0 -82
  408. package/rest/examples/rest-fabric-conferences-and-routing.ts +0 -144
  409. package/rest/examples/rest-fabric-subscribers-and-sip.ts +0 -108
  410. package/rest/examples/rest-fabric-swml-and-callflows.ts +0 -99
  411. package/rest/examples/rest-manage-resources.ts +0 -65
  412. package/rest/examples/rest-phone-number-management.ts +0 -197
  413. package/rest/examples/rest-queues-mfa-and-recordings.ts +0 -143
  414. package/rest/examples/rest-video-rooms.ts +0 -186
  415. package/src/AgentBase.ts +0 -2598
  416. package/src/AgentServer.ts +0 -442
  417. package/src/AuthHandler.ts +0 -256
  418. package/src/ConfigLoader.ts +0 -447
  419. package/src/ContextBuilder.ts +0 -1181
  420. package/src/DataMap.ts +0 -477
  421. package/src/FunctionResult.ts +0 -903
  422. package/src/Logger.ts +0 -337
  423. package/src/PomBuilder.ts +0 -467
  424. package/src/PromptManager.ts +0 -133
  425. package/src/SWMLHandler.ts +0 -298
  426. package/src/SWMLService.ts +0 -749
  427. package/src/SchemaUtils.ts +0 -361
  428. package/src/ServerlessAdapter.ts +0 -240
  429. package/src/SessionManager.ts +0 -311
  430. package/src/SslConfig.ts +0 -118
  431. package/src/SwaigFunction.ts +0 -276
  432. package/src/SwmlBuilder.ts +0 -283
  433. package/src/SwmlVerbMethods.generated.ts +0 -234
  434. package/src/TypeInference.ts +0 -199
  435. package/src/WebService.ts +0 -641
  436. package/src/cli/agent-loader.ts +0 -166
  437. package/src/cli/mock-data.ts +0 -111
  438. package/src/cli/swaig-test.ts +0 -452
  439. package/src/generateVerbTypes.ts +0 -322
  440. package/src/livewire/index.ts +0 -1252
  441. package/src/prefabs/ConciergeAgent.ts +0 -309
  442. package/src/prefabs/FAQBotAgent.ts +0 -415
  443. package/src/prefabs/InfoGathererAgent.ts +0 -379
  444. package/src/prefabs/ReceptionistAgent.ts +0 -395
  445. package/src/prefabs/SurveyAgent.ts +0 -671
  446. package/src/relay/Action.ts +0 -482
  447. package/src/relay/Call.ts +0 -1270
  448. package/src/relay/Deferred.ts +0 -94
  449. package/src/relay/Message.ts +0 -199
  450. package/src/relay/RelayClient.ts +0 -1185
  451. package/src/relay/RelayError.ts +0 -20
  452. package/src/relay/RelayEvent.ts +0 -944
  453. package/src/relay/index.ts +0 -123
  454. package/src/relay/types.ts +0 -149
  455. package/src/rest/HttpClient.ts +0 -164
  456. package/src/rest/RestError.ts +0 -45
  457. package/src/rest/base/BaseResource.ts +0 -32
  458. package/src/rest/base/CrudResource.ts +0 -98
  459. package/src/rest/base/CrudWithAddresses.ts +0 -37
  460. package/src/rest/namespaces/addresses.ts +0 -64
  461. package/src/rest/namespaces/calling.ts +0 -534
  462. package/src/rest/namespaces/chat.ts +0 -31
  463. package/src/rest/namespaces/compat.ts +0 -812
  464. package/src/rest/namespaces/datasphere.ts +0 -88
  465. package/src/rest/namespaces/fabric.ts +0 -417
  466. package/src/rest/namespaces/imported-numbers.ts +0 -31
  467. package/src/rest/namespaces/logs.ts +0 -151
  468. package/src/rest/namespaces/lookup.ts +0 -38
  469. package/src/rest/namespaces/mfa.ts +0 -61
  470. package/src/rest/namespaces/number-groups.ts +0 -68
  471. package/src/rest/namespaces/phone-numbers.ts +0 -76
  472. package/src/rest/namespaces/project.ts +0 -65
  473. package/src/rest/namespaces/pubsub.ts +0 -31
  474. package/src/rest/namespaces/queues.ts +0 -58
  475. package/src/rest/namespaces/recordings.ts +0 -53
  476. package/src/rest/namespaces/registry.ts +0 -200
  477. package/src/rest/namespaces/short-codes.ts +0 -54
  478. package/src/rest/namespaces/sip-profile.ts +0 -40
  479. package/src/rest/namespaces/verified-callers.ts +0 -46
  480. package/src/rest/namespaces/video.ts +0 -332
  481. package/src/rest/types.ts +0 -61
  482. package/src/skills/SkillBase.ts +0 -582
  483. package/src/skills/SkillManager.ts +0 -419
  484. package/src/skills/SkillRegistry.ts +0 -367
  485. package/src/skills/builtin/api_ninjas_trivia.ts +0 -285
  486. package/src/skills/builtin/ask_claude.ts +0 -246
  487. package/src/skills/builtin/claude_skills.ts +0 -983
  488. package/src/skills/builtin/custom_skills.ts +0 -327
  489. package/src/skills/builtin/datasphere.ts +0 -447
  490. package/src/skills/builtin/datasphere_serverless.ts +0 -347
  491. package/src/skills/builtin/datetime.ts +0 -137
  492. package/src/skills/builtin/google_maps.ts +0 -656
  493. package/src/skills/builtin/info_gatherer.ts +0 -415
  494. package/src/skills/builtin/joke.ts +0 -196
  495. package/src/skills/builtin/math.ts +0 -149
  496. package/src/skills/builtin/mcp_gateway.ts +0 -685
  497. package/src/skills/builtin/native_vector_search.ts +0 -910
  498. package/src/skills/builtin/play_background_file.ts +0 -367
  499. package/src/skills/builtin/spider.ts +0 -874
  500. package/src/skills/builtin/swml_transfer.ts +0 -645
  501. package/src/skills/builtin/weather_api.ts +0 -255
  502. package/src/skills/builtin/web_search.ts +0 -1083
  503. package/src/skills/builtin/wikipedia_search.ts +0 -304
  504. package/src/types.ts +0 -132
  505. package/tests/AgentBase.test.ts +0 -1093
  506. package/tests/AgentServer.test.ts +0 -126
  507. package/tests/AuthHandler.test.ts +0 -133
  508. package/tests/ConfigLoader.test.ts +0 -151
  509. package/tests/ContextBuilder.test.ts +0 -108
  510. package/tests/DataMap.test.ts +0 -367
  511. package/tests/EphemeralSkillCopy.test.ts +0 -107
  512. package/tests/FunctionResult.test.ts +0 -298
  513. package/tests/GracefulShutdown.test.ts +0 -46
  514. package/tests/Logger.test.ts +0 -420
  515. package/tests/PomBuilder.test.ts +0 -228
  516. package/tests/ProxyDetection.test.ts +0 -228
  517. package/tests/SWMLService.test.ts +0 -320
  518. package/tests/SWMLVerbHandler.test.ts +0 -523
  519. package/tests/SchemaUtils.test.ts +0 -106
  520. package/tests/SchemaUtils.verb.test.ts +0 -206
  521. package/tests/SecurityUtils.test.ts +0 -192
  522. package/tests/ServerlessAdapter.test.ts +0 -222
  523. package/tests/SessionManager.test.ts +0 -257
  524. package/tests/SkillBaseFeatures.test.ts +0 -130
  525. package/tests/SkillMultiInstance.test.ts +0 -102
  526. package/tests/SkillParameterSchemas.test.ts +0 -134
  527. package/tests/SkillRegistrySchema.test.ts +0 -84
  528. package/tests/SslConfig.test.ts +0 -97
  529. package/tests/SwmlBuilder.test.ts +0 -400
  530. package/tests/TypeInference.test.ts +0 -165
  531. package/tests/VerbHandlerRegistry.test.ts +0 -128
  532. package/tests/cli/mock-data.test.ts +0 -113
  533. package/tests/cli/swaig-test.test.ts +0 -108
  534. package/tests/examples.test.ts +0 -194
  535. package/tests/fixtures/scrape-parity/README.md +0 -53
  536. package/tests/fixtures/scrape-parity/expected/01_simple_article.json +0 -5
  537. package/tests/fixtures/scrape-parity/expected/02_class_based_noise.json +0 -5
  538. package/tests/fixtures/scrape-parity/expected/03_nested_containers.json +0 -5
  539. package/tests/fixtures/scrape-parity/expected/04_bare_body.json +0 -5
  540. package/tests/fixtures/scrape-parity/expected/05_malformed.json +0 -5
  541. package/tests/fixtures/scrape-parity/expected/06_multi_class.json +0 -5
  542. package/tests/fixtures/scrape-parity/expected/07_anchor_pattern.json +0 -5
  543. package/tests/fixtures/scrape-parity/expected/08_inline_script.json +0 -5
  544. package/tests/fixtures/scrape-parity/expected/09_whitespace_nbsp.json +0 -5
  545. package/tests/fixtures/scrape-parity/expected/10_entity_unicode.json +0 -5
  546. package/tests/fixtures/scrape-parity/expected/11_cdata_comments.json +0 -5
  547. package/tests/fixtures/scrape-parity/expected/12_deep_nested_removals.json +0 -5
  548. package/tests/fixtures/scrape-parity/html/01_simple_article.html +0 -18
  549. package/tests/fixtures/scrape-parity/html/02_class_based_noise.html +0 -18
  550. package/tests/fixtures/scrape-parity/html/03_nested_containers.html +0 -13
  551. package/tests/fixtures/scrape-parity/html/04_bare_body.html +0 -9
  552. package/tests/fixtures/scrape-parity/html/05_malformed.html +0 -11
  553. package/tests/fixtures/scrape-parity/html/06_multi_class.html +0 -18
  554. package/tests/fixtures/scrape-parity/html/07_anchor_pattern.html +0 -12
  555. package/tests/fixtures/scrape-parity/html/08_inline_script.html +0 -17
  556. package/tests/fixtures/scrape-parity/html/09_whitespace_nbsp.html +0 -21
  557. package/tests/fixtures/scrape-parity/html/10_entity_unicode.html +0 -10
  558. package/tests/fixtures/scrape-parity/html/11_cdata_comments.html +0 -13
  559. package/tests/fixtures/scrape-parity/html/12_deep_nested_removals.html +0 -24
  560. package/tests/fixtures/scrape-parity/python_extract.py +0 -109
  561. package/tests/livewire/livewire.test.ts +0 -780
  562. package/tests/mcp.test.ts +0 -221
  563. package/tests/prefabs/prefabs.test.ts +0 -1093
  564. package/tests/relay/Action.test.ts +0 -392
  565. package/tests/relay/Call.test.ts +0 -535
  566. package/tests/relay/Deferred.test.ts +0 -71
  567. package/tests/relay/Message.test.ts +0 -164
  568. package/tests/relay/RelayClient.test.ts +0 -779
  569. package/tests/relay/RelayEvent.test.ts +0 -463
  570. package/tests/relay/helpers.ts +0 -79
  571. package/tests/rest/HttpClient.test.ts +0 -274
  572. package/tests/rest/RestError.test.ts +0 -53
  573. package/tests/rest/calling.test.ts +0 -156
  574. package/tests/rest/client.test.ts +0 -197
  575. package/tests/rest/compat.test.ts +0 -335
  576. package/tests/rest/datasphere.test.ts +0 -71
  577. package/tests/rest/fabric.test.ts +0 -186
  578. package/tests/rest/helpers.ts +0 -95
  579. package/tests/rest/logs.test.ts +0 -68
  580. package/tests/rest/pagination.test.ts +0 -133
  581. package/tests/rest/registry.test.ts +0 -94
  582. package/tests/rest/relay-rest.test.ts +0 -290
  583. package/tests/rest/video.test.ts +0 -173
  584. package/tests/setup.ts +0 -6
  585. package/tests/skills/SkillBase.test.ts +0 -108
  586. package/tests/skills/SkillManager.test.ts +0 -268
  587. package/tests/skills/SkillRegistry.test.ts +0 -176
  588. package/tests/skills/builtin.test.ts +0 -1472
  589. package/tests/skills/claude-skills.test.ts +0 -54
  590. package/tests/skills/custom-skills.test.ts +0 -53
  591. package/tests/skills/datasphere-serverless.test.ts +0 -70
  592. package/tests/skills/datasphere.test.ts +0 -107
  593. package/tests/skills/datetime.test.ts +0 -101
  594. package/tests/skills/google-maps.test.ts +0 -78
  595. package/tests/skills/info-gatherer.test.ts +0 -411
  596. package/tests/skills/joke.test.ts +0 -81
  597. package/tests/skills/math.test.ts +0 -68
  598. package/tests/skills/mcp-gateway.test.ts +0 -101
  599. package/tests/skills/play-background.test.ts +0 -54
  600. package/tests/skills/spider.test.ts +0 -108
  601. package/tests/skills/swml-transfer.test.ts +0 -178
  602. package/tests/skills/trivia.test.ts +0 -54
  603. package/tests/skills/vector-search.test.ts +0 -135
  604. package/tests/skills/weather-api.test.ts +0 -77
  605. package/tests/skills/web-search-parity.test.ts +0 -59
  606. package/tests/skills/web-search.test.ts +0 -103
  607. package/tests/skills/wikipedia.test.ts +0 -63
  608. package/tsconfig.json +0 -18
  609. package/vitest.config.ts +0 -9
  610. /package/{src → dist}/schema.json +0 -0
@@ -1,1093 +0,0 @@
1
- import { describe, it, expect, vi, beforeAll } from 'vitest';
2
- import { suppressAllLogs } from '../../src/Logger.js';
3
- import { InfoGathererAgent, createInfoGathererAgent } from '../../src/prefabs/InfoGathererAgent.js';
4
- import { SurveyAgent, createSurveyAgent } from '../../src/prefabs/SurveyAgent.js';
5
- import { FAQBotAgent, createFAQBotAgent } from '../../src/prefabs/FAQBotAgent.js';
6
- import { ConciergeAgent, createConciergeAgent } from '../../src/prefabs/ConciergeAgent.js';
7
- import { ReceptionistAgent, createReceptionistAgent } from '../../src/prefabs/ReceptionistAgent.js';
8
-
9
- beforeAll(() => {
10
- suppressAllLogs(true);
11
- });
12
-
13
- // ============================================================================
14
- // InfoGathererAgent
15
- // ============================================================================
16
-
17
- describe('InfoGathererAgent', () => {
18
- const baseQuestions = [
19
- { key_name: 'full_name', question_text: 'What is your full name?' },
20
- { key_name: 'email', question_text: 'What is your email address?', confirm: true },
21
- { key_name: 'reason', question_text: 'How can I help you today?' },
22
- ];
23
-
24
- function createAgent(overrides?: Record<string, unknown>) {
25
- return new InfoGathererAgent({
26
- questions: baseQuestions,
27
- ...overrides,
28
- });
29
- }
30
-
31
- it('creates with questions config', () => {
32
- const agent = createAgent();
33
- expect(agent).toBeInstanceOf(InfoGathererAgent);
34
- });
35
-
36
- it('renders valid SWML', () => {
37
- const agent = createAgent();
38
- const swml = agent.renderSwml('test-call');
39
- const parsed = JSON.parse(swml);
40
- expect(parsed.version).toBe('1.0.0');
41
- expect(parsed.sections.main).toBeDefined();
42
- });
43
-
44
- it('registers start_questions and submit_answer tools', () => {
45
- const agent = createAgent();
46
- expect(agent.getTool('start_questions')).toBeDefined();
47
- expect(agent.getTool('submit_answer')).toBeDefined();
48
- });
49
-
50
- it('static mode populates global_data with questions at construction', () => {
51
- const agent = createAgent();
52
- const swml = agent.renderSwml('test-call');
53
- // questions should appear in the SWML global_data surface
54
- expect(swml).toContain('full_name');
55
- expect(swml).toContain('What is your full name');
56
- });
57
-
58
- it('start_questions returns the first question instruction', async () => {
59
- const agent = createAgent();
60
- const tool = agent.getTool('start_questions')!;
61
- const rawData = {
62
- global_data: {
63
- questions: baseQuestions,
64
- question_index: 0,
65
- answers: [],
66
- },
67
- };
68
- const result = await tool.execute({}, rawData);
69
- expect(result.response).toContain('What is your full name?');
70
- expect(result.response).toContain('Make sure the answer fits');
71
- });
72
-
73
- it('start_questions uses confirmation instruction when confirm flag is true', async () => {
74
- const agent = new InfoGathererAgent({
75
- questions: [
76
- { key_name: 'email', question_text: 'Email?', confirm: true },
77
- ],
78
- });
79
- const tool = agent.getTool('start_questions')!;
80
- const rawData = {
81
- global_data: {
82
- questions: [{ key_name: 'email', question_text: 'Email?', confirm: true }],
83
- question_index: 0,
84
- answers: [],
85
- },
86
- };
87
- const result = await tool.execute({}, rawData);
88
- expect(result.response).toContain('Insist that the user confirms');
89
- });
90
-
91
- it('submit_answer advances to next question and updates global data', async () => {
92
- const agent = createAgent();
93
- const tool = agent.getTool('submit_answer')!;
94
- const rawData = {
95
- global_data: {
96
- questions: baseQuestions,
97
- question_index: 0,
98
- answers: [],
99
- },
100
- };
101
- const result = await tool.execute({ answer: 'Jane Doe' }, rawData);
102
- expect(result.response).toContain('What is your email address?');
103
- // Check global data update action is present
104
- const actions = result.action as Array<Record<string, unknown>>;
105
- const updateAction = actions.find(
106
- (a) => a['set_global_data'] !== undefined || a['update_global_data'] !== undefined,
107
- );
108
- expect(updateAction).toBeDefined();
109
- });
110
-
111
- it('submit_answer completes the flow after the last question', async () => {
112
- const agent = createAgent();
113
- const tool = agent.getTool('submit_answer')!;
114
- const rawData = {
115
- global_data: {
116
- questions: baseQuestions,
117
- question_index: 2,
118
- answers: [
119
- { key_name: 'full_name', answer: 'Jane Doe' },
120
- { key_name: 'email', answer: 'jane@example.com' },
121
- ],
122
- },
123
- };
124
- const result = await tool.execute({ answer: 'Billing issue' }, rawData);
125
- expect(result.response).toContain('All questions have been answered');
126
- });
127
-
128
- it('submit_answer handles out-of-bounds index', async () => {
129
- const agent = createAgent();
130
- const tool = agent.getTool('submit_answer')!;
131
- const rawData = {
132
- global_data: {
133
- questions: baseQuestions,
134
- question_index: 99,
135
- answers: [],
136
- },
137
- };
138
- const result = await tool.execute({ answer: 'late answer' }, rawData);
139
- expect(result.response).toContain('All questions have already been answered');
140
- });
141
-
142
- it('setQuestionCallback is callable and stored', () => {
143
- const agent = new InfoGathererAgent();
144
- const cb = vi.fn(() => []);
145
- agent.setQuestionCallback(cb);
146
- // Confirm the method returned `this` for chaining
147
- const result = agent.setQuestionCallback(cb);
148
- expect(result).toBe(agent);
149
- });
150
-
151
- it('dynamic mode: onSwmlRequest invokes the callback and sets global data', async () => {
152
- const agent = new InfoGathererAgent();
153
- const cb = vi.fn((queryParams: Record<string, string>) => {
154
- if (queryParams.mode === 'support') {
155
- return [
156
- { key_name: 'name', question_text: 'Your name?' },
157
- { key_name: 'issue', question_text: "What's the issue?" },
158
- ];
159
- }
160
- return [{ key_name: 'name', question_text: 'What is your name?' }];
161
- });
162
- agent.setQuestionCallback(cb);
163
-
164
- const mods = await agent.onSwmlRequest({ query_params: { mode: 'support' } });
165
- expect(cb).toHaveBeenCalledTimes(1);
166
-
167
- // Python parity: onSwmlRequest returns the global_data modifications dict
168
- // which the framework passes to renderSwml as the second argument.
169
- const swml = agent.renderSwml('test-call', mods || undefined);
170
- expect(swml).toContain("What's the issue?");
171
- expect(swml).toContain('issue');
172
- });
173
-
174
- it('dynamic mode: falls back to default questions when no callback is registered', async () => {
175
- const agent = new InfoGathererAgent();
176
- const mods = await agent.onSwmlRequest({});
177
- const swml = agent.renderSwml('test-call', mods || undefined);
178
- expect(swml).toContain('What is your name?');
179
- expect(swml).toContain('How can I help you today?');
180
- });
181
-
182
- it('dynamic mode: falls back when the callback throws', async () => {
183
- const agent = new InfoGathererAgent();
184
- agent.setQuestionCallback(() => {
185
- throw new Error('boom');
186
- });
187
- const mods = await agent.onSwmlRequest({});
188
- const swml = agent.renderSwml('test-call', mods || undefined);
189
- // Fallback questions should be injected via the returned modifications dict
190
- expect(swml).toContain('What is your name?');
191
- });
192
-
193
- it('questionCallback can be passed via config', async () => {
194
- const cb = vi.fn(() => [
195
- { key_name: 'company', question_text: 'What company?' },
196
- ]);
197
- const agent = new InfoGathererAgent({ questionCallback: cb });
198
- const mods = await agent.onSwmlRequest({});
199
- expect(cb).toHaveBeenCalled();
200
- const swml = agent.renderSwml('test-call', mods || undefined);
201
- expect(swml).toContain('What company?');
202
- });
203
-
204
- it('throws on missing key_name in a question', () => {
205
- expect(
206
- () =>
207
- new InfoGathererAgent({
208
- // @ts-expect-error intentionally invalid
209
- questions: [{ question_text: 'Something?' }],
210
- }),
211
- ).toThrow(/key_name/);
212
- });
213
-
214
- it('throws on missing question_text in a question', () => {
215
- expect(
216
- () =>
217
- new InfoGathererAgent({
218
- // @ts-expect-error intentionally invalid
219
- questions: [{ key_name: 'x' }],
220
- }),
221
- ).toThrow(/question_text/);
222
- });
223
-
224
- it('factory function creates agent', () => {
225
- const agent = createInfoGathererAgent({ questions: baseQuestions });
226
- expect(agent).toBeInstanceOf(InfoGathererAgent);
227
- expect(agent.getTool('start_questions')).toBeDefined();
228
- });
229
- });
230
-
231
- // ============================================================================
232
- // SurveyAgent
233
- // ============================================================================
234
-
235
- describe('SurveyAgent', () => {
236
- const baseQuestions = [
237
- {
238
- id: 'q1',
239
- text: 'How satisfied are you with our service?',
240
- type: 'rating' as const,
241
- scale: 10,
242
- points: 1,
243
- },
244
- {
245
- id: 'q2',
246
- text: 'Would you recommend us?',
247
- type: 'yes_no' as const,
248
- points: { yes: 10, no: 0 },
249
- },
250
- {
251
- id: 'q3',
252
- text: 'Which feature do you like most?',
253
- type: 'multiple_choice' as const,
254
- options: ['Speed', 'Price', 'Support'],
255
- },
256
- {
257
- id: 'q4',
258
- text: 'Any additional comments?',
259
- type: 'open_ended' as const,
260
- },
261
- ];
262
-
263
- function createAgent(overrides?: Record<string, unknown>) {
264
- return new SurveyAgent({
265
- surveyName: 'Customer Satisfaction Survey',
266
- questions: baseQuestions,
267
- ...overrides,
268
- });
269
- }
270
-
271
- it('creates with questions config', () => {
272
- const agent = createAgent();
273
- expect(agent).toBeInstanceOf(SurveyAgent);
274
- });
275
-
276
- it('renders valid SWML', () => {
277
- const agent = createAgent();
278
- const swml = agent.renderSwml('test-call');
279
- const parsed = JSON.parse(swml);
280
- expect(parsed.version).toBe('1.0.0');
281
- expect(parsed.sections.main).toBeDefined();
282
- });
283
-
284
- it('has answer_question, get_current_question, and get_survey_progress tools', () => {
285
- const agent = createAgent();
286
- expect(agent.getTool('answer_question')).toBeDefined();
287
- expect(agent.getTool('get_current_question')).toBeDefined();
288
- expect(agent.getTool('get_survey_progress')).toBeDefined();
289
- });
290
-
291
- it('get_current_question returns first question initially', async () => {
292
- const agent = createAgent();
293
- const tool = agent.getTool('get_current_question')!;
294
- const result = await tool.execute({}, { call_id: 'survey-1' });
295
- expect(result.response).toContain('q1');
296
- expect(result.response).toContain('How satisfied');
297
- });
298
-
299
- it('answer_question stores response and advances', async () => {
300
- const agent = createAgent();
301
- const tool = agent.getTool('answer_question')!;
302
- const callData = { call_id: 'survey-2' };
303
-
304
- const result = await tool.execute({ question_id: 'q1', answer: '8' }, callData);
305
- expect(result.response).toContain('Answer recorded');
306
- expect(result.response).toContain('q2');
307
-
308
- // Verify progress
309
- const progressTool = agent.getTool('get_survey_progress')!;
310
- const progress = await progressTool.execute({}, callData);
311
- expect(progress.response).toContain('1/4');
312
- expect(progress.response).toContain('q1: 8');
313
- });
314
-
315
- it('branching: conditional nextQuestion works', async () => {
316
- const branchQuestions = [
317
- {
318
- id: 'start',
319
- text: 'Do you like it?',
320
- type: 'yes_no' as const,
321
- nextQuestion: { yes: 'positive', no: 'negative' },
322
- },
323
- {
324
- id: 'positive',
325
- text: 'What do you love?',
326
- type: 'open_ended' as const,
327
- },
328
- {
329
- id: 'negative',
330
- text: 'What can we improve?',
331
- type: 'open_ended' as const,
332
- },
333
- ];
334
-
335
- const agent = new SurveyAgent({ surveyName: 'Branching Survey', questions: branchQuestions });
336
- const tool = agent.getTool('answer_question')!;
337
-
338
- // Answer "yes" should branch to "positive"
339
- const result = await tool.execute(
340
- { question_id: 'start', answer: 'yes' },
341
- { call_id: 'branch-1' },
342
- );
343
- expect(result.response).toContain('positive');
344
- expect(result.response).toContain('What do you love');
345
-
346
- // A separate call answering "no" should branch to "negative"
347
- const agent2 = new SurveyAgent({ surveyName: 'Branching Survey', questions: branchQuestions });
348
- const tool2 = agent2.getTool('answer_question')!;
349
- const result2 = await tool2.execute(
350
- { question_id: 'start', answer: 'no' },
351
- { call_id: 'branch-2' },
352
- );
353
- expect(result2.response).toContain('negative');
354
- expect(result2.response).toContain('What can we improve');
355
- });
356
-
357
- it('scoring: points accumulate', async () => {
358
- const agent = createAgent();
359
- const tool = agent.getTool('answer_question')!;
360
- const callData = { call_id: 'score-1' };
361
-
362
- // q1 has fixed points=1
363
- await tool.execute({ question_id: 'q1', answer: '7' }, callData);
364
- // q2 has per-answer: yes=10
365
- await tool.execute({ question_id: 'q2', answer: 'yes' }, callData);
366
-
367
- const progressTool = agent.getTool('get_survey_progress')!;
368
- const progress = await progressTool.execute({}, callData);
369
- expect(progress.response).toContain('Current score: 11');
370
- });
371
-
372
- it('get_survey_progress shows progress percentage', async () => {
373
- const agent = createAgent();
374
- const tool = agent.getTool('answer_question')!;
375
- const callData = { call_id: 'prog-1' };
376
-
377
- await tool.execute({ question_id: 'q1', answer: '5' }, callData);
378
- await tool.execute({ question_id: 'q2', answer: 'yes' }, callData);
379
-
380
- const progressTool = agent.getTool('get_survey_progress')!;
381
- const progress = await progressTool.execute({}, callData);
382
- expect(progress.response).toContain('2/4');
383
- expect(progress.response).toContain('50%');
384
- });
385
-
386
- it('survey completion triggers onComplete', async () => {
387
- const onComplete = vi.fn();
388
- const simpleQuestions = [
389
- { id: 'only', text: 'Rate us', type: 'rating' as const, scale: 10, points: 5 },
390
- ];
391
- const agent = new SurveyAgent({ surveyName: 'Tiny', questions: simpleQuestions, onComplete });
392
-
393
- const tool = agent.getTool('answer_question')!;
394
- await tool.execute({ question_id: 'only', answer: '9' }, { call_id: 'done-1' });
395
-
396
- expect(onComplete).toHaveBeenCalledTimes(1);
397
- expect(onComplete).toHaveBeenCalledWith({ only: '9' }, 5);
398
- });
399
-
400
- it('rating type validates range', async () => {
401
- const agent = createAgent();
402
- const tool = agent.getTool('answer_question')!;
403
-
404
- // Out of range
405
- const result = await tool.execute(
406
- { question_id: 'q1', answer: '15' },
407
- { call_id: 'val-1' },
408
- );
409
- expect(result.response).toContain('between 1 and 10');
410
-
411
- // Not a number
412
- const result2 = await tool.execute(
413
- { question_id: 'q1', answer: 'abc' },
414
- { call_id: 'val-2' },
415
- );
416
- expect(result2.response).toContain('between 1 and 10');
417
- });
418
-
419
- it('yes/no type normalizes answers', async () => {
420
- const agent = createAgent();
421
- const tool = agent.getTool('answer_question')!;
422
- const callData = { call_id: 'norm-1' };
423
-
424
- // Answer q1 first (rating)
425
- await tool.execute({ question_id: 'q1', answer: '7' }, callData);
426
-
427
- // "y" should be normalized to "yes" (matches Python's strict yes/no/y/n set)
428
- await tool.execute({ question_id: 'q2', answer: 'y' }, callData);
429
-
430
- const progressTool = agent.getTool('get_survey_progress')!;
431
- const progress = await progressTool.execute({}, callData);
432
- expect(progress.response).toContain('q2: yes');
433
- });
434
-
435
- it('multiple choice validates options', async () => {
436
- const agent = createAgent();
437
- const tool = agent.getTool('answer_question')!;
438
- const callData = { call_id: 'mc-1' };
439
-
440
- // Skip to q3 by answering q1 and q2 first
441
- await tool.execute({ question_id: 'q1', answer: '5' }, callData);
442
- await tool.execute({ question_id: 'q2', answer: 'yes' }, callData);
443
-
444
- // Invalid option
445
- const result = await tool.execute(
446
- { question_id: 'q3', answer: 'InvalidOption' },
447
- callData,
448
- );
449
- expect(result.response).toContain('Invalid choice');
450
- expect(result.response).toContain('Speed');
451
- expect(result.response).toContain('Price');
452
- expect(result.response).toContain('Support');
453
- });
454
-
455
- it('factory function creates agent', () => {
456
- const agent = createSurveyAgent({
457
- surveyName: 'Factory Survey',
458
- questions: baseQuestions,
459
- });
460
- expect(agent).toBeInstanceOf(SurveyAgent);
461
- expect(agent.getTool('answer_question')).toBeDefined();
462
- });
463
-
464
- it('exposes Python-parity public properties', () => {
465
- const agent = createAgent({
466
- brandName: 'Acme',
467
- maxRetries: 4,
468
- introduction: 'Welcome!',
469
- conclusion: 'Goodbye!',
470
- });
471
- expect(agent.surveyName).toBe('Customer Satisfaction Survey');
472
- expect(agent.brandName).toBe('Acme');
473
- expect(agent.maxRetries).toBe(4);
474
- expect(agent.introduction).toBe('Welcome!');
475
- expect(agent.conclusion).toBe('Goodbye!');
476
- expect(agent.questions).toBe(baseQuestions);
477
- });
478
-
479
- it('brandName defaults to "Our Company"', () => {
480
- const agent = createAgent();
481
- expect(agent.brandName).toBe('Our Company');
482
- });
483
-
484
- it('maxRetries defaults to 2 and appears in instructions', () => {
485
- const agent = createAgent();
486
- expect(agent.maxRetries).toBe(2);
487
- const swml = agent.renderSwml('test-call');
488
- expect(swml).toContain('retry up to 2');
489
- });
490
-
491
- it('has validate_response and log_response tools (Python parity)', () => {
492
- const agent = createAgent();
493
- expect(agent.getTool('validate_response')).toBeDefined();
494
- expect(agent.getTool('log_response')).toBeDefined();
495
- });
496
-
497
- it('validate_response flags rating out of configured scale', async () => {
498
- const agent = createAgent();
499
- const tool = agent.getTool('validate_response')!;
500
- // q1 has scale: 10 — 11 should be rejected
501
- const bad = await tool.execute({ question_id: 'q1', response: '11' }, {});
502
- expect(bad.response).toContain('between 1 and 10');
503
- // And valid
504
- const ok = await tool.execute({ question_id: 'q1', response: '7' }, {});
505
- expect(ok.response).toContain('is valid');
506
- });
507
-
508
- it('validate_response uses scale default of 5 for rating questions', async () => {
509
- const agent = new SurveyAgent({
510
- surveyName: 'Five Point',
511
- questions: [{ id: 'q', text: 'Rate', type: 'rating' }],
512
- });
513
- const tool = agent.getTool('validate_response')!;
514
- const bad = await tool.execute({ question_id: 'q', response: '6' }, {});
515
- expect(bad.response).toContain('between 1 and 5');
516
- });
517
-
518
- it('validate_response checks required=true for open_ended', async () => {
519
- const agent = new SurveyAgent({
520
- surveyName: 'Required Survey',
521
- questions: [
522
- { id: 'optional_q', text: 'Optional?', type: 'open_ended', required: false },
523
- { id: 'required_q', text: 'Required', type: 'open_ended', required: true },
524
- ],
525
- });
526
- const tool = agent.getTool('validate_response')!;
527
- // empty answer to required → error
528
- const requiredErr = await tool.execute({ question_id: 'required_q', response: '' }, {});
529
- expect(requiredErr.response).toContain('required');
530
- // empty answer to optional → valid
531
- const optionalOk = await tool.execute({ question_id: 'optional_q', response: '' }, {});
532
- expect(optionalOk.response).toContain('is valid');
533
- });
534
-
535
- it('log_response acknowledges recording a response', async () => {
536
- const agent = createAgent();
537
- const tool = agent.getTool('log_response')!;
538
- const result = await tool.execute(
539
- { question_id: 'q1', response: '7' },
540
- { call_id: 'log-1' },
541
- );
542
- expect(result.response).toContain('recorded');
543
- expect(result.response).toContain('satisfied');
544
- });
545
-
546
- it('prompt mentions surveyName, brandName, and introduction/conclusion', () => {
547
- const agent = createAgent({
548
- brandName: 'Acme Corp',
549
- introduction: 'Welcome to the Acme feedback line!',
550
- conclusion: 'Thanks for your time.',
551
- });
552
- const swml = agent.renderSwml('test-call');
553
- expect(swml).toContain('Customer Satisfaction Survey');
554
- expect(swml).toContain('Acme Corp');
555
- expect(swml).toContain('Welcome to the Acme feedback line!');
556
- expect(swml).toContain('Thanks for your time.');
557
- });
558
-
559
- it('onSummary override is callable without throwing', async () => {
560
- const agent = createAgent();
561
- const spy = vi.spyOn(console, 'log').mockImplementation(() => {});
562
- try {
563
- await agent.onSummary({ survey_name: 'Customer Satisfaction Survey' }, {});
564
- expect(spy).toHaveBeenCalled();
565
- } finally {
566
- spy.mockRestore();
567
- }
568
- });
569
- });
570
-
571
- // ============================================================================
572
- // FAQBotAgent
573
- // ============================================================================
574
-
575
- describe('FAQBotAgent', () => {
576
- const baseFaqs = [
577
- {
578
- question: 'What are your business hours?',
579
- answer: 'We are open Monday through Friday, 9am to 5pm EST.',
580
- keywords: ['hours', 'open', 'schedule', 'time'],
581
- },
582
- {
583
- question: 'How do I reset my password?',
584
- answer: 'Go to the login page, click "Forgot Password", and follow the instructions.',
585
- keywords: ['password', 'reset', 'login', 'forgot'],
586
- },
587
- {
588
- question: 'What is the return policy?',
589
- answer: 'You can return any item within 30 days of purchase for a full refund.',
590
- keywords: ['return', 'refund', 'policy'],
591
- },
592
- ];
593
-
594
- function createAgent(overrides?: Record<string, unknown>) {
595
- return new FAQBotAgent({
596
- faqs: baseFaqs,
597
- ...overrides,
598
- });
599
- }
600
-
601
- it('creates with FAQs config', () => {
602
- const agent = createAgent();
603
- expect(agent).toBeInstanceOf(FAQBotAgent);
604
- });
605
-
606
- it('renders valid SWML', () => {
607
- const agent = createAgent();
608
- const swml = agent.renderSwml('test-call');
609
- const parsed = JSON.parse(swml);
610
- expect(parsed.version).toBe('1.0.0');
611
- expect(parsed.sections.main).toBeDefined();
612
- });
613
-
614
- it('has search_faqs tool and no escalate when not configured', () => {
615
- const agent = createAgent();
616
- expect(agent.getTool('search_faqs')).toBeDefined();
617
- expect(agent.getTool('escalate')).toBeUndefined();
618
- });
619
-
620
- it('search_faqs returns matching FAQ question (Python parity: question text only)', async () => {
621
- const agent = createAgent();
622
- const tool = agent.getTool('search_faqs')!;
623
- const result = await tool.execute({ query: 'What are your business hours?' }, {});
624
- // Python's search_faqs returns a numbered list of matching question text.
625
- // The answer text is delivered to the AI via the prompt's FAQ Database section.
626
- expect(result.response).toContain('Here are the most relevant FAQs');
627
- expect(result.response).toContain('business hours');
628
- });
629
-
630
- it('returns no-match for unrelated query', async () => {
631
- const agent = createAgent({ threshold: 0.5 });
632
- const tool = agent.getTool('search_faqs')!;
633
- const result = await tool.execute({ query: 'quantum physics dark matter' }, {});
634
- expect(result.response).toBe('No matching FAQs found.');
635
- });
636
-
637
- it('threshold filtering works', async () => {
638
- // High threshold makes it hard to match
639
- const agent = createAgent({ threshold: 0.99 });
640
- const tool = agent.getTool('search_faqs')!;
641
- const result = await tool.execute({ query: 'hours open' }, {});
642
- expect(result.response).toBe('No matching FAQs found.');
643
-
644
- // Low threshold makes it easy to match
645
- const agent2 = createAgent({ threshold: 0.01 });
646
- const tool2 = agent2.getTool('search_faqs')!;
647
- const result2 = await tool2.execute({ query: 'hours open' }, {});
648
- expect(result2.response).toContain('Here are the most relevant FAQs');
649
- });
650
-
651
- it('category filter narrows the FAQ pool', async () => {
652
- const categorizedFaqs = [
653
- {
654
- question: 'What are your business hours?',
655
- answer: 'Mon-Fri, 9-5.',
656
- categories: ['general'],
657
- },
658
- {
659
- question: 'How do I reset my password?',
660
- answer: 'Click "Forgot Password" on the login page.',
661
- categories: ['account'],
662
- },
663
- ];
664
- const agent = new FAQBotAgent({ faqs: categorizedFaqs, threshold: 0.01 });
665
- const tool = agent.getTool('search_faqs')!;
666
- const result = await tool.execute(
667
- { query: 'password reset', category: 'general' },
668
- {},
669
- );
670
- // Filtered to only the "general" FAQ, so no relevant password match
671
- expect(result.response).not.toContain('Forgot Password');
672
- });
673
-
674
- it('suggestRelated=false suppresses runner-up suggestions', async () => {
675
- const agent = createAgent({ threshold: 0.01, suggestRelated: false });
676
- const tool = agent.getTool('search_faqs')!;
677
- const result = await tool.execute({ query: 'password hours open' }, {});
678
- expect(result.response).not.toContain('Also related:');
679
- });
680
-
681
- it('persona overrides the default Personality section', () => {
682
- const agent = createAgent({ persona: 'You are a terse and factual help desk.' });
683
- const swml = agent.renderSwml('test-call');
684
- expect(swml).toContain('terse and factual help desk');
685
- });
686
-
687
- it('exposes public faqs, suggestRelated, and persona properties', () => {
688
- const agent = createAgent({ persona: 'custom persona text' });
689
- expect(agent.faqs).toEqual(baseFaqs);
690
- expect(agent.suggestRelated).toBe(true);
691
- expect(agent.persona).toBe('custom persona text');
692
- });
693
-
694
- it('onSummary override is callable without throwing', async () => {
695
- const agent = createAgent();
696
- const spy = vi.spyOn(console, 'log').mockImplementation(() => {});
697
- try {
698
- await agent.onSummary({ question: 'hours' }, {});
699
- expect(spy).toHaveBeenCalled();
700
- } finally {
701
- spy.mockRestore();
702
- }
703
- });
704
-
705
- it('escalate tool is not registered without escalation number', () => {
706
- const agent = createAgent();
707
- expect(agent.getTool('escalate')).toBeUndefined();
708
- });
709
-
710
- it('escalate tool is registered when escalation number is set', () => {
711
- const agent = createAgent({ escalationNumber: '+15551234567' });
712
- expect(agent.getTool('escalate')).toBeDefined();
713
- });
714
-
715
- it('escalate tool transfers caller', async () => {
716
- const agent = createAgent({ escalationNumber: '+15551234567' });
717
- const tool = agent.getTool('escalate')!;
718
- const result = await tool.execute({ reason: 'Cannot find answer' }, {});
719
- expect(result.response).toContain('Transferring');
720
- expect(result.response).toContain('Cannot find answer');
721
- const actions = result.action as Record<string, unknown>[];
722
- expect(actions).toBeDefined();
723
- expect(actions.length).toBeGreaterThan(0);
724
- });
725
-
726
- it('search_faqs returns Python no-match message when query has no relevant FAQ', async () => {
727
- const agent = createAgent();
728
- const tool = agent.getTool('search_faqs')!;
729
- const result = await tool.execute({ query: 'completely unrelated topic xyz' }, {});
730
- // Python parity: response is exactly "No matching FAQs found." regardless
731
- // of any escalation configuration on the TS side.
732
- expect(result.response).toBe('No matching FAQs found.');
733
- });
734
-
735
- it('keywords improve matching', async () => {
736
- const agent = createAgent({ threshold: 0.3 });
737
- const tool = agent.getTool('search_faqs')!;
738
-
739
- // Query using keywords that match the password FAQ
740
- const result = await tool.execute({ query: 'forgot password reset' }, {});
741
- expect(result.response).toContain('Here are the most relevant FAQs');
742
- expect(result.response).toContain('How do I reset my password?');
743
- });
744
-
745
- it('prompt mentions FAQ topics', () => {
746
- const agent = createAgent();
747
- const swml = agent.renderSwml('test-call');
748
- expect(swml).toContain('business hours');
749
- expect(swml).toContain('password');
750
- expect(swml).toContain('return policy');
751
- });
752
-
753
- it('factory function creates agent', () => {
754
- const agent = createFAQBotAgent({ faqs: baseFaqs });
755
- expect(agent).toBeInstanceOf(FAQBotAgent);
756
- expect(agent.getTool('search_faqs')).toBeDefined();
757
- });
758
- });
759
-
760
- // ============================================================================
761
- // ConciergeAgent
762
- // ============================================================================
763
-
764
- describe('ConciergeAgent', () => {
765
- const baseAmenities = {
766
- pool: { hours: '7 AM - 10 PM', location: '2nd Floor' },
767
- gym: { hours: '24 hours', location: '3rd Floor' },
768
- };
769
- const baseServices = ['room service', 'spa bookings', 'restaurant reservations'];
770
-
771
- function createAgent(overrides?: Record<string, unknown>) {
772
- return new ConciergeAgent({
773
- venueName: 'Grand Hotel',
774
- services: baseServices,
775
- amenities: baseAmenities,
776
- ...overrides,
777
- });
778
- }
779
-
780
- it('creates with venue config', () => {
781
- const agent = createAgent();
782
- expect(agent).toBeInstanceOf(ConciergeAgent);
783
- });
784
-
785
- it('exposes public venue properties', () => {
786
- const agent = createAgent();
787
- expect(agent.venueName).toBe('Grand Hotel');
788
- expect(agent.services).toEqual(baseServices);
789
- expect(agent.amenities).toEqual(baseAmenities);
790
- expect(agent.hoursOfOperation).toEqual({ default: '9 AM - 5 PM' });
791
- expect(agent.specialInstructions).toEqual([]);
792
- });
793
-
794
- it('renders valid SWML', () => {
795
- const agent = createAgent();
796
- const swml = agent.renderSwml('test-call');
797
- const parsed = JSON.parse(swml);
798
- expect(parsed.version).toBe('1.0.0');
799
- expect(parsed.sections.main).toBeDefined();
800
- });
801
-
802
- it('has check_availability and get_directions tools', () => {
803
- const agent = createAgent();
804
- expect(agent.getTool('check_availability')).toBeDefined();
805
- expect(agent.getTool('get_directions')).toBeDefined();
806
- });
807
-
808
- it('check_availability confirms an offered service', async () => {
809
- const agent = createAgent();
810
- const tool = agent.getTool('check_availability')!;
811
- const result = await tool.execute(
812
- { service: 'spa bookings', date: '2026-01-01', time: '10:00' },
813
- {},
814
- );
815
- expect(result.response).toContain('spa bookings');
816
- expect(result.response).toContain('2026-01-01');
817
- expect(result.response).toContain('10:00');
818
- expect(result.response).toContain('reservation');
819
- });
820
-
821
- it('check_availability rejects an unknown service', async () => {
822
- const agent = createAgent();
823
- const tool = agent.getTool('check_availability')!;
824
- const result = await tool.execute(
825
- { service: 'skydiving', date: '2026-01-01', time: '10:00' },
826
- {},
827
- );
828
- expect(result.response).toContain("don't offer");
829
- expect(result.response).toContain('Grand Hotel');
830
- // Should list available services
831
- expect(result.response).toContain('spa bookings');
832
- });
833
-
834
- it('get_directions looks up an amenity by name', async () => {
835
- const agent = createAgent();
836
- const tool = agent.getTool('get_directions')!;
837
- const result = await tool.execute({ location: 'pool' }, {});
838
- expect(result.response).toContain('pool');
839
- expect(result.response).toContain('2nd Floor');
840
- });
841
-
842
- it('get_directions falls back for unknown locations', async () => {
843
- const agent = createAgent();
844
- const tool = agent.getTool('get_directions')!;
845
- const result = await tool.execute({ location: 'helipad' }, {});
846
- expect(result.response).toContain("don't have specific directions");
847
- expect(result.response).toContain('front desk');
848
- });
849
-
850
- it('prompt mentions the venue name and services', () => {
851
- const agent = createAgent();
852
- const swml = agent.renderSwml('test-call');
853
- expect(swml).toContain('Grand Hotel');
854
- expect(swml).toContain('spa bookings');
855
- });
856
-
857
- it('renders amenities as subsections', () => {
858
- const agent = createAgent();
859
- const swml = agent.renderSwml('test-call');
860
- // Python titles the amenity names; our titleCase mirrors Python str.title()
861
- expect(swml).toContain('Pool');
862
- expect(swml).toContain('Gym');
863
- expect(swml).toContain('2nd Floor');
864
- });
865
-
866
- it('renders hours of operation from default or custom map', () => {
867
- const agent = createAgent({
868
- hoursOfOperation: { weekday: '9 AM - 9 PM', weekend: '10 AM - 6 PM' },
869
- });
870
- const swml = agent.renderSwml('test-call');
871
- expect(swml).toContain('Weekday');
872
- expect(swml).toContain('9 AM - 9 PM');
873
- expect(swml).toContain('Weekend');
874
- });
875
-
876
- it('appends special instructions to the Instructions section', () => {
877
- const agent = createAgent({
878
- specialInstructions: ['Always mention the weekly wine tasting.'],
879
- });
880
- const swml = agent.renderSwml('test-call');
881
- expect(swml).toContain('wine tasting');
882
- });
883
-
884
- it('welcomeMessage sets a non-bargeable static greeting', () => {
885
- const agent = createAgent({
886
- welcomeMessage: 'Welcome to the Grand Hotel!',
887
- });
888
- const swml = agent.renderSwml('test-call');
889
- expect(swml).toContain('Welcome to the Grand Hotel!');
890
- expect(swml).toContain('static_greeting_no_barge');
891
- });
892
-
893
- it('onSummary override is callable without throwing', async () => {
894
- const agent = createAgent();
895
- const spy = vi.spyOn(console, 'log').mockImplementation(() => {});
896
- try {
897
- await agent.onSummary({ topic: 'pool hours' }, {});
898
- expect(spy).toHaveBeenCalled();
899
- } finally {
900
- spy.mockRestore();
901
- }
902
- });
903
-
904
- it('factory function creates agent', () => {
905
- const agent = createConciergeAgent({
906
- venueName: 'Seaside Inn',
907
- services: ['dining'],
908
- amenities: { patio: { location: 'Ground Floor' } },
909
- });
910
- expect(agent).toBeInstanceOf(ConciergeAgent);
911
- expect(agent.getTool('check_availability')).toBeDefined();
912
- expect(agent.getTool('get_directions')).toBeDefined();
913
- });
914
- });
915
-
916
- // ============================================================================
917
- // ReceptionistAgent
918
- // ============================================================================
919
-
920
- describe('ReceptionistAgent', () => {
921
- const baseDepartments = [
922
- { name: 'sales', description: 'Product inquiries and pricing', number: '+15551001001' },
923
- { name: 'support', description: 'Technical help and troubleshooting', number: '+15551002002' },
924
- { name: 'billing', description: 'Invoices and payments', number: '+15551003003' },
925
- ];
926
-
927
- function createAgent(overrides?: Record<string, unknown>) {
928
- return new ReceptionistAgent({
929
- departments: baseDepartments,
930
- ...overrides,
931
- });
932
- }
933
-
934
- it('creates with departments config', () => {
935
- const agent = createAgent();
936
- expect(agent).toBeInstanceOf(ReceptionistAgent);
937
- });
938
-
939
- it('renders valid SWML', () => {
940
- const agent = createAgent();
941
- const swml = agent.renderSwml('test-call');
942
- const parsed = JSON.parse(swml);
943
- expect(parsed.version).toBe('1.0.0');
944
- expect(parsed.sections.main).toBeDefined();
945
- });
946
-
947
- it('registers collect_caller_info and transfer_call (Python parity)', () => {
948
- const agent = createAgent();
949
- expect(agent.getTool('collect_caller_info')).toBeDefined();
950
- expect(agent.getTool('transfer_call')).toBeDefined();
951
- });
952
-
953
- it('collect_caller_info stores caller info via set_global_data', async () => {
954
- const agent = createAgent();
955
- const tool = agent.getTool('collect_caller_info')!;
956
- const result = await tool.execute({ name: 'Alice', reason: 'billing question' }, {});
957
- expect(result.response).toContain('Thank you, Alice');
958
- expect(result.response).toContain('billing question');
959
- const actions = result.action as Array<Record<string, unknown>>;
960
- const setGlobalData = actions.find((a) => a['set_global_data'] !== undefined);
961
- expect(setGlobalData).toBeDefined();
962
- const payload = (setGlobalData?.['set_global_data'] as Record<string, unknown>)['caller_info'];
963
- expect(payload).toEqual({ name: 'Alice', reason: 'billing question' });
964
- });
965
-
966
- it('transfer_call connects to the department phone number with final+post_process', async () => {
967
- const agent = createAgent();
968
- const tool = agent.getTool('transfer_call')!;
969
- const rawData = { global_data: { caller_info: { name: 'Bob' } } };
970
- const result = await tool.execute({ department: 'sales' }, rawData);
971
- expect(result.response).toContain('sales department');
972
- expect(result.response).toContain('Bob');
973
- const actions = result.action as Array<Record<string, unknown>>;
974
- const connectAction = actions.find((a) => a['SWML'] !== undefined);
975
- expect(connectAction).toBeDefined();
976
- // final=true manifests as transfer: "true"
977
- expect(connectAction?.['transfer']).toBe('true');
978
- // post_process flag is serialized when post_process was enabled
979
- expect(result['post_process']).toBe(true);
980
- });
981
-
982
- it('transfer_call returns an error for an unknown department', async () => {
983
- const agent = createAgent();
984
- const tool = agent.getTool('transfer_call')!;
985
- const result = await tool.execute({ department: 'nonexistent' }, {});
986
- expect(result.response).toContain("couldn't find");
987
- });
988
-
989
- it('departments enum is passed to the transfer_call parameter schema', () => {
990
- const agent = createAgent();
991
- const swml = agent.renderSwml('test-call');
992
- const parsed = JSON.parse(swml);
993
- const swmlStr = JSON.stringify(parsed);
994
- expect(swmlStr).toContain('"enum"');
995
- expect(swmlStr).toContain('"sales"');
996
- expect(swmlStr).toContain('"support"');
997
- });
998
-
999
- it('default name is lowercase "receptionist"', () => {
1000
- const agent = createAgent();
1001
- // name shows up in the SWML agent name/route surface
1002
- const swml = agent.renderSwml('test-call');
1003
- expect(swml).toContain('receptionist');
1004
- });
1005
-
1006
- it('default greeting matches Python copy', () => {
1007
- const agent = createAgent();
1008
- const swml = agent.renderSwml('test-call');
1009
- expect(swml).toContain('Thank you for calling. How can I help you today?');
1010
- });
1011
-
1012
- it('custom greeting appears in the prompt', () => {
1013
- const agent = createAgent({ greeting: 'Welcome to Acme!' });
1014
- const swml = agent.renderSwml('test-call');
1015
- expect(swml).toContain('Welcome to Acme!');
1016
- });
1017
-
1018
- it('voice defaults to rime.spore via addLanguage', () => {
1019
- const agent = createAgent();
1020
- const swml = agent.renderSwml('test-call');
1021
- expect(swml).toContain('rime.spore');
1022
- });
1023
-
1024
- it('custom voice is forwarded to addLanguage', () => {
1025
- const agent = createAgent({ voice: 'elevenlabs.rachel' });
1026
- const swml = agent.renderSwml('test-call');
1027
- expect(swml).toContain('elevenlabs.rachel');
1028
- });
1029
-
1030
- it('route defaults to /receptionist and is forwarded to super()', () => {
1031
- const agent = createAgent();
1032
- expect(agent.route).toBe('/receptionist');
1033
- });
1034
-
1035
- it('custom route overrides the default', () => {
1036
- const agent = createAgent({ route: '/front-desk' });
1037
- expect(agent.route).toBe('/front-desk');
1038
- });
1039
-
1040
- it('check_in_visitor is not registered by default', () => {
1041
- const agent = createAgent();
1042
- expect(agent.getTool('check_in_visitor')).toBeUndefined();
1043
- });
1044
-
1045
- it('check_in_visitor is registered when checkInEnabled=true', () => {
1046
- const agent = createAgent({ checkInEnabled: true });
1047
- expect(agent.getTool('check_in_visitor')).toBeDefined();
1048
- });
1049
-
1050
- it('check_in_visitor records visitor data and fires the callback', async () => {
1051
- const onVisitorCheckIn = vi.fn();
1052
- const agent = createAgent({
1053
- companyName: 'TechCo',
1054
- checkInEnabled: true,
1055
- onVisitorCheckIn,
1056
- });
1057
- const tool = agent.getTool('check_in_visitor')!;
1058
- const result = await tool.execute(
1059
- { visitor_name: 'Alice Smith', purpose: 'Interview', visiting: 'Engineering' },
1060
- { call_id: 'check-1' },
1061
- );
1062
- expect(result.response).toContain('Alice Smith');
1063
- expect(result.response).toContain('Interview');
1064
- expect(result.response).toContain('TechCo');
1065
- expect(onVisitorCheckIn).toHaveBeenCalledTimes(1);
1066
- expect(onVisitorCheckIn).toHaveBeenCalledWith(
1067
- expect.objectContaining({
1068
- visitor_name: 'Alice Smith',
1069
- purpose: 'Interview',
1070
- visiting: 'Engineering',
1071
- }),
1072
- );
1073
- });
1074
-
1075
- it('optional companyName appears in the greeting when provided', () => {
1076
- const agent = createAgent({ companyName: 'TechCo' });
1077
- const swml = agent.renderSwml('test-call');
1078
- expect(swml).toContain('TechCo');
1079
- });
1080
-
1081
- it('throws on missing department fields', () => {
1082
- // @ts-expect-error intentionally invalid (missing number)
1083
- expect(() => new ReceptionistAgent({ departments: [{ name: 'x', description: 'y' }] })).toThrow(/number/);
1084
- // @ts-expect-error intentionally invalid (missing description)
1085
- expect(() => new ReceptionistAgent({ departments: [{ name: 'x', number: '1' }] })).toThrow(/description/);
1086
- });
1087
-
1088
- it('factory function creates agent', () => {
1089
- const agent = createReceptionistAgent({ departments: baseDepartments });
1090
- expect(agent).toBeInstanceOf(ReceptionistAgent);
1091
- expect(agent.getTool('transfer_call')).toBeDefined();
1092
- });
1093
- });