@signalwire/sdk 2.0.0 → 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 (612) 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/dist/index.d.ts +146 -0
  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/{src/rest/index.ts → dist/rest/index.d.ts} +53 -122
  149. package/dist/rest/index.js +195 -0
  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/dist/rest/pagination.d.ts +39 -0
  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 -2489
  416. package/src/AgentServer.ts +0 -415
  417. package/src/AuthHandler.ts +0 -256
  418. package/src/ConfigLoader.ts +0 -447
  419. package/src/ContextBuilder.ts +0 -1150
  420. package/src/DataMap.ts +0 -449
  421. package/src/FunctionResult.ts +0 -866
  422. package/src/Logger.ts +0 -337
  423. package/src/PomBuilder.ts +0 -439
  424. package/src/PromptManager.ts +0 -133
  425. package/src/SWMLHandler.ts +0 -298
  426. package/src/SWMLService.ts +0 -717
  427. package/src/SchemaUtils.ts +0 -361
  428. package/src/ServerlessAdapter.ts +0 -221
  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 -258
  433. package/src/SwmlVerbMethods.generated.ts +0 -234
  434. package/src/TypeInference.ts +0 -181
  435. package/src/WebService.ts +0 -619
  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/index.ts +0 -167
  441. package/src/livewire/index.ts +0 -950
  442. package/src/prefabs/ConciergeAgent.ts +0 -287
  443. package/src/prefabs/FAQBotAgent.ts +0 -384
  444. package/src/prefabs/InfoGathererAgent.ts +0 -339
  445. package/src/prefabs/ReceptionistAgent.ts +0 -366
  446. package/src/prefabs/SurveyAgent.ts +0 -646
  447. package/src/relay/Action.ts +0 -314
  448. package/src/relay/Call.ts +0 -854
  449. package/src/relay/Deferred.ts +0 -71
  450. package/src/relay/Message.ts +0 -148
  451. package/src/relay/RelayClient.ts +0 -1036
  452. package/src/relay/RelayError.ts +0 -14
  453. package/src/relay/RelayEvent.ts +0 -892
  454. package/src/relay/index.ts +0 -123
  455. package/src/relay/types.ts +0 -149
  456. package/src/rest/HttpClient.ts +0 -103
  457. package/src/rest/RestError.ts +0 -31
  458. package/src/rest/base/BaseResource.ts +0 -19
  459. package/src/rest/base/CrudResource.ts +0 -51
  460. package/src/rest/base/CrudWithAddresses.ts +0 -26
  461. package/src/rest/namespaces/addresses.ts +0 -32
  462. package/src/rest/namespaces/calling.ts +0 -187
  463. package/src/rest/namespaces/chat.ts +0 -20
  464. package/src/rest/namespaces/compat.ts +0 -352
  465. package/src/rest/namespaces/datasphere.ts +0 -45
  466. package/src/rest/namespaces/fabric.ts +0 -222
  467. package/src/rest/namespaces/imported-numbers.ts +0 -20
  468. package/src/rest/namespaces/logs.ts +0 -84
  469. package/src/rest/namespaces/lookup.ts +0 -21
  470. package/src/rest/namespaces/mfa.ts +0 -30
  471. package/src/rest/namespaces/number-groups.ts +0 -38
  472. package/src/rest/namespaces/phone-numbers.ts +0 -44
  473. package/src/rest/namespaces/project.ts +0 -36
  474. package/src/rest/namespaces/pubsub.ts +0 -20
  475. package/src/rest/namespaces/queues.ts +0 -33
  476. package/src/rest/namespaces/recordings.ts +0 -28
  477. package/src/rest/namespaces/registry.ts +0 -101
  478. package/src/rest/namespaces/short-codes.ts +0 -28
  479. package/src/rest/namespaces/sip-profile.ts +0 -25
  480. package/src/rest/namespaces/verified-callers.ts +0 -27
  481. package/src/rest/namespaces/video.ts +0 -165
  482. package/src/rest/pagination.ts +0 -84
  483. package/src/rest/types.ts +0 -61
  484. package/src/skills/SkillBase.ts +0 -547
  485. package/src/skills/SkillManager.ts +0 -415
  486. package/src/skills/SkillRegistry.ts +0 -367
  487. package/src/skills/builtin/api_ninjas_trivia.ts +0 -280
  488. package/src/skills/builtin/ask_claude.ts +0 -241
  489. package/src/skills/builtin/claude_skills.ts +0 -978
  490. package/src/skills/builtin/custom_skills.ts +0 -312
  491. package/src/skills/builtin/datasphere.ts +0 -438
  492. package/src/skills/builtin/datasphere_serverless.ts +0 -339
  493. package/src/skills/builtin/datetime.ts +0 -130
  494. package/src/skills/builtin/google_maps.ts +0 -651
  495. package/src/skills/builtin/info_gatherer.ts +0 -405
  496. package/src/skills/builtin/joke.ts +0 -191
  497. package/src/skills/builtin/math.ts +0 -142
  498. package/src/skills/builtin/mcp_gateway.ts +0 -677
  499. package/src/skills/builtin/native_vector_search.ts +0 -901
  500. package/src/skills/builtin/play_background_file.ts +0 -358
  501. package/src/skills/builtin/spider.ts +0 -869
  502. package/src/skills/builtin/swml_transfer.ts +0 -635
  503. package/src/skills/builtin/weather_api.ts +0 -248
  504. package/src/skills/builtin/web_search.ts +0 -1074
  505. package/src/skills/builtin/wikipedia_search.ts +0 -299
  506. package/src/types.ts +0 -132
  507. package/tests/AgentBase.test.ts +0 -1093
  508. package/tests/AgentServer.test.ts +0 -126
  509. package/tests/AuthHandler.test.ts +0 -133
  510. package/tests/ConfigLoader.test.ts +0 -151
  511. package/tests/ContextBuilder.test.ts +0 -108
  512. package/tests/DataMap.test.ts +0 -367
  513. package/tests/EphemeralSkillCopy.test.ts +0 -107
  514. package/tests/FunctionResult.test.ts +0 -298
  515. package/tests/GracefulShutdown.test.ts +0 -46
  516. package/tests/Logger.test.ts +0 -420
  517. package/tests/PomBuilder.test.ts +0 -228
  518. package/tests/ProxyDetection.test.ts +0 -228
  519. package/tests/SWMLService.test.ts +0 -320
  520. package/tests/SWMLVerbHandler.test.ts +0 -523
  521. package/tests/SchemaUtils.test.ts +0 -106
  522. package/tests/SchemaUtils.verb.test.ts +0 -206
  523. package/tests/SecurityUtils.test.ts +0 -192
  524. package/tests/ServerlessAdapter.test.ts +0 -222
  525. package/tests/SessionManager.test.ts +0 -257
  526. package/tests/SkillBaseFeatures.test.ts +0 -130
  527. package/tests/SkillMultiInstance.test.ts +0 -102
  528. package/tests/SkillParameterSchemas.test.ts +0 -134
  529. package/tests/SkillRegistrySchema.test.ts +0 -84
  530. package/tests/SslConfig.test.ts +0 -97
  531. package/tests/SwmlBuilder.test.ts +0 -400
  532. package/tests/TypeInference.test.ts +0 -165
  533. package/tests/VerbHandlerRegistry.test.ts +0 -128
  534. package/tests/cli/mock-data.test.ts +0 -113
  535. package/tests/cli/swaig-test.test.ts +0 -108
  536. package/tests/examples.test.ts +0 -194
  537. package/tests/fixtures/scrape-parity/README.md +0 -53
  538. package/tests/fixtures/scrape-parity/expected/01_simple_article.json +0 -5
  539. package/tests/fixtures/scrape-parity/expected/02_class_based_noise.json +0 -5
  540. package/tests/fixtures/scrape-parity/expected/03_nested_containers.json +0 -5
  541. package/tests/fixtures/scrape-parity/expected/04_bare_body.json +0 -5
  542. package/tests/fixtures/scrape-parity/expected/05_malformed.json +0 -5
  543. package/tests/fixtures/scrape-parity/expected/06_multi_class.json +0 -5
  544. package/tests/fixtures/scrape-parity/expected/07_anchor_pattern.json +0 -5
  545. package/tests/fixtures/scrape-parity/expected/08_inline_script.json +0 -5
  546. package/tests/fixtures/scrape-parity/expected/09_whitespace_nbsp.json +0 -5
  547. package/tests/fixtures/scrape-parity/expected/10_entity_unicode.json +0 -5
  548. package/tests/fixtures/scrape-parity/expected/11_cdata_comments.json +0 -5
  549. package/tests/fixtures/scrape-parity/expected/12_deep_nested_removals.json +0 -5
  550. package/tests/fixtures/scrape-parity/html/01_simple_article.html +0 -18
  551. package/tests/fixtures/scrape-parity/html/02_class_based_noise.html +0 -18
  552. package/tests/fixtures/scrape-parity/html/03_nested_containers.html +0 -13
  553. package/tests/fixtures/scrape-parity/html/04_bare_body.html +0 -9
  554. package/tests/fixtures/scrape-parity/html/05_malformed.html +0 -11
  555. package/tests/fixtures/scrape-parity/html/06_multi_class.html +0 -18
  556. package/tests/fixtures/scrape-parity/html/07_anchor_pattern.html +0 -12
  557. package/tests/fixtures/scrape-parity/html/08_inline_script.html +0 -17
  558. package/tests/fixtures/scrape-parity/html/09_whitespace_nbsp.html +0 -21
  559. package/tests/fixtures/scrape-parity/html/10_entity_unicode.html +0 -10
  560. package/tests/fixtures/scrape-parity/html/11_cdata_comments.html +0 -13
  561. package/tests/fixtures/scrape-parity/html/12_deep_nested_removals.html +0 -24
  562. package/tests/fixtures/scrape-parity/python_extract.py +0 -109
  563. package/tests/livewire/livewire.test.ts +0 -780
  564. package/tests/mcp.test.ts +0 -221
  565. package/tests/prefabs/prefabs.test.ts +0 -1093
  566. package/tests/relay/Action.test.ts +0 -392
  567. package/tests/relay/Call.test.ts +0 -535
  568. package/tests/relay/Deferred.test.ts +0 -71
  569. package/tests/relay/Message.test.ts +0 -164
  570. package/tests/relay/RelayClient.test.ts +0 -779
  571. package/tests/relay/RelayEvent.test.ts +0 -463
  572. package/tests/relay/helpers.ts +0 -79
  573. package/tests/rest/HttpClient.test.ts +0 -274
  574. package/tests/rest/RestError.test.ts +0 -53
  575. package/tests/rest/calling.test.ts +0 -156
  576. package/tests/rest/client.test.ts +0 -197
  577. package/tests/rest/compat.test.ts +0 -335
  578. package/tests/rest/datasphere.test.ts +0 -71
  579. package/tests/rest/fabric.test.ts +0 -186
  580. package/tests/rest/helpers.ts +0 -95
  581. package/tests/rest/logs.test.ts +0 -68
  582. package/tests/rest/pagination.test.ts +0 -133
  583. package/tests/rest/registry.test.ts +0 -94
  584. package/tests/rest/relay-rest.test.ts +0 -290
  585. package/tests/rest/video.test.ts +0 -173
  586. package/tests/setup.ts +0 -6
  587. package/tests/skills/SkillBase.test.ts +0 -108
  588. package/tests/skills/SkillManager.test.ts +0 -268
  589. package/tests/skills/SkillRegistry.test.ts +0 -176
  590. package/tests/skills/builtin.test.ts +0 -1472
  591. package/tests/skills/claude-skills.test.ts +0 -54
  592. package/tests/skills/custom-skills.test.ts +0 -53
  593. package/tests/skills/datasphere-serverless.test.ts +0 -70
  594. package/tests/skills/datasphere.test.ts +0 -107
  595. package/tests/skills/datetime.test.ts +0 -101
  596. package/tests/skills/google-maps.test.ts +0 -78
  597. package/tests/skills/info-gatherer.test.ts +0 -411
  598. package/tests/skills/joke.test.ts +0 -81
  599. package/tests/skills/math.test.ts +0 -68
  600. package/tests/skills/mcp-gateway.test.ts +0 -101
  601. package/tests/skills/play-background.test.ts +0 -54
  602. package/tests/skills/spider.test.ts +0 -108
  603. package/tests/skills/swml-transfer.test.ts +0 -178
  604. package/tests/skills/trivia.test.ts +0 -54
  605. package/tests/skills/vector-search.test.ts +0 -135
  606. package/tests/skills/weather-api.test.ts +0 -77
  607. package/tests/skills/web-search-parity.test.ts +0 -59
  608. package/tests/skills/web-search.test.ts +0 -103
  609. package/tests/skills/wikipedia.test.ts +0 -63
  610. package/tsconfig.json +0 -18
  611. package/vitest.config.ts +0 -9
  612. /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
- });