@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.
- package/dist/AgentBase.d.ts +1045 -0
- package/dist/AgentBase.js +2375 -0
- package/dist/AgentBase.js.map +1 -0
- package/dist/AgentServer.d.ts +146 -0
- package/dist/AgentServer.js +388 -0
- package/dist/AgentServer.js.map +1 -0
- package/dist/AuthHandler.d.ts +127 -0
- package/dist/AuthHandler.js +212 -0
- package/dist/AuthHandler.js.map +1 -0
- package/dist/ConfigLoader.d.ts +170 -0
- package/dist/ConfigLoader.js +393 -0
- package/dist/ConfigLoader.js.map +1 -0
- package/dist/ContextBuilder.d.ts +652 -0
- package/dist/ContextBuilder.js +1115 -0
- package/dist/ContextBuilder.js.map +1 -0
- package/dist/DataMap.d.ts +271 -0
- package/dist/DataMap.js +430 -0
- package/dist/DataMap.js.map +1 -0
- package/dist/FunctionResult.d.ts +481 -0
- package/dist/FunctionResult.js +775 -0
- package/dist/FunctionResult.js.map +1 -0
- package/dist/Logger.d.ts +113 -0
- package/dist/Logger.js +320 -0
- package/dist/Logger.js.map +1 -0
- package/dist/PomBuilder.d.ts +208 -0
- package/dist/PomBuilder.js +409 -0
- package/dist/PomBuilder.js.map +1 -0
- package/dist/PromptManager.d.ts +85 -0
- package/dist/PromptManager.js +108 -0
- package/dist/PromptManager.js.map +1 -0
- package/dist/SWMLHandler.d.ts +159 -0
- package/dist/SWMLHandler.js +229 -0
- package/dist/SWMLHandler.js.map +1 -0
- package/dist/SWMLService.d.ts +326 -0
- package/dist/SWMLService.js +610 -0
- package/dist/SWMLService.js.map +1 -0
- package/dist/SchemaUtils.d.ts +108 -0
- package/dist/SchemaUtils.js +317 -0
- package/dist/SchemaUtils.js.map +1 -0
- package/dist/SecurityUtils.d.ts +60 -0
- package/{src/SecurityUtils.ts → dist/SecurityUtils.js} +82 -83
- package/dist/SecurityUtils.js.map +1 -0
- package/dist/ServerlessAdapter.d.ts +119 -0
- package/dist/ServerlessAdapter.js +188 -0
- package/dist/ServerlessAdapter.js.map +1 -0
- package/dist/SessionManager.d.ts +142 -0
- package/dist/SessionManager.js +260 -0
- package/dist/SessionManager.js.map +1 -0
- package/dist/SslConfig.d.ts +77 -0
- package/dist/SslConfig.js +100 -0
- package/dist/SslConfig.js.map +1 -0
- package/dist/SwaigFunction.d.ts +159 -0
- package/dist/SwaigFunction.js +209 -0
- package/dist/SwaigFunction.js.map +1 -0
- package/dist/SwmlBuilder.d.ts +165 -0
- package/dist/SwmlBuilder.js +247 -0
- package/dist/SwmlBuilder.js.map +1 -0
- package/dist/SwmlVerbMethods.generated.d.ts +254 -0
- package/dist/SwmlVerbMethods.generated.js +9 -0
- package/dist/SwmlVerbMethods.generated.js.map +1 -0
- package/dist/TypeInference.d.ts +71 -0
- package/dist/TypeInference.js +164 -0
- package/dist/TypeInference.js.map +1 -0
- package/dist/WebService.d.ts +148 -0
- package/dist/WebService.js +532 -0
- package/dist/WebService.js.map +1 -0
- package/dist/cli/agent-loader.d.ts +22 -0
- package/dist/cli/agent-loader.js +144 -0
- package/dist/cli/agent-loader.js.map +1 -0
- package/dist/cli/mock-data.d.ts +37 -0
- package/dist/cli/mock-data.js +80 -0
- package/dist/cli/mock-data.js.map +1 -0
- package/dist/cli/swaig-test.d.ts +32 -0
- package/dist/cli/swaig-test.js +418 -0
- package/dist/cli/swaig-test.js.map +1 -0
- package/dist/generateVerbTypes.d.ts +11 -0
- package/dist/generateVerbTypes.js +265 -0
- package/dist/generateVerbTypes.js.map +1 -0
- package/dist/index.d.ts +146 -0
- package/dist/index.js +152 -0
- package/dist/index.js.map +1 -0
- package/dist/livewire/index.d.ts +653 -0
- package/dist/livewire/index.js +992 -0
- package/dist/livewire/index.js.map +1 -0
- package/dist/prefabs/ConciergeAgent.d.ts +89 -0
- package/dist/prefabs/ConciergeAgent.js +245 -0
- package/dist/prefabs/ConciergeAgent.js.map +1 -0
- package/dist/prefabs/FAQBotAgent.d.ts +113 -0
- package/dist/prefabs/FAQBotAgent.js +329 -0
- package/dist/prefabs/FAQBotAgent.js.map +1 -0
- package/dist/prefabs/InfoGathererAgent.d.ts +126 -0
- package/dist/prefabs/InfoGathererAgent.js +287 -0
- package/dist/prefabs/InfoGathererAgent.js.map +1 -0
- package/dist/prefabs/ReceptionistAgent.d.ts +104 -0
- package/dist/prefabs/ReceptionistAgent.js +303 -0
- package/dist/prefabs/ReceptionistAgent.js.map +1 -0
- package/dist/prefabs/SurveyAgent.d.ts +148 -0
- package/dist/prefabs/SurveyAgent.js +540 -0
- package/dist/prefabs/SurveyAgent.js.map +1 -0
- package/{src/prefabs/index.ts → dist/prefabs/index.d.ts} +1 -15
- package/dist/prefabs/index.js +14 -0
- package/dist/prefabs/index.js.map +1 -0
- package/dist/relay/Action.d.ts +258 -0
- package/dist/relay/Action.js +402 -0
- package/dist/relay/Action.js.map +1 -0
- package/dist/relay/Call.d.ts +697 -0
- package/dist/relay/Call.js +1062 -0
- package/dist/relay/Call.js.map +1 -0
- package/dist/relay/Deferred.d.ts +44 -0
- package/dist/relay/Deferred.js +69 -0
- package/dist/relay/Deferred.js.map +1 -0
- package/dist/relay/Message.d.ts +103 -0
- package/dist/relay/Message.js +169 -0
- package/dist/relay/Message.js.map +1 -0
- package/dist/relay/RelayClient.d.ts +302 -0
- package/dist/relay/RelayClient.js +1019 -0
- package/dist/relay/RelayClient.js.map +1 -0
- package/dist/relay/RelayError.d.ts +15 -0
- package/dist/relay/RelayError.js +20 -0
- package/dist/relay/RelayError.js.map +1 -0
- package/dist/relay/RelayEvent.d.ts +254 -0
- package/dist/relay/RelayEvent.js +509 -0
- package/dist/relay/RelayEvent.js.map +1 -0
- package/dist/relay/constants.d.ts +90 -0
- package/{src/relay/constants.ts → dist/relay/constants.js} +11 -29
- package/dist/relay/constants.js.map +1 -0
- package/dist/relay/index.d.ts +16 -0
- package/dist/relay/index.js +18 -0
- package/dist/relay/index.js.map +1 -0
- package/dist/relay/types.d.ts +142 -0
- package/dist/relay/types.js +5 -0
- package/dist/relay/types.js.map +1 -0
- package/dist/rest/HttpClient.d.ts +80 -0
- package/dist/rest/HttpClient.js +148 -0
- package/dist/rest/HttpClient.js.map +1 -0
- package/dist/rest/RestError.d.ts +30 -0
- package/dist/rest/RestError.js +39 -0
- package/dist/rest/RestError.js.map +1 -0
- package/dist/rest/base/BaseResource.d.ts +24 -0
- package/dist/rest/base/BaseResource.js +29 -0
- package/dist/rest/base/BaseResource.js.map +1 -0
- package/dist/rest/base/CrudResource.d.ts +68 -0
- package/dist/rest/base/CrudResource.js +82 -0
- package/dist/rest/base/CrudResource.js.map +1 -0
- package/dist/rest/base/CrudWithAddresses.d.ts +22 -0
- package/dist/rest/base/CrudWithAddresses.js +25 -0
- package/dist/rest/base/CrudWithAddresses.js.map +1 -0
- package/{src/rest/index.ts → dist/rest/index.d.ts} +53 -122
- package/dist/rest/index.js +195 -0
- package/dist/rest/index.js.map +1 -0
- package/dist/rest/namespaces/addresses.d.ts +46 -0
- package/dist/rest/namespaces/addresses.js +55 -0
- package/dist/rest/namespaces/addresses.js.map +1 -0
- package/dist/rest/namespaces/calling.d.ts +382 -0
- package/dist/rest/namespaces/calling.js +478 -0
- package/dist/rest/namespaces/calling.js.map +1 -0
- package/dist/rest/namespaces/chat.d.ts +22 -0
- package/dist/rest/namespaces/chat.js +26 -0
- package/dist/rest/namespaces/chat.js.map +1 -0
- package/dist/rest/namespaces/compat.d.ts +585 -0
- package/dist/rest/namespaces/compat.js +735 -0
- package/dist/rest/namespaces/compat.js.map +1 -0
- package/dist/rest/namespaces/datasphere.d.ts +66 -0
- package/dist/rest/namespaces/datasphere.js +77 -0
- package/dist/rest/namespaces/datasphere.js.map +1 -0
- package/dist/rest/namespaces/fabric.d.ts +282 -0
- package/dist/rest/namespaces/fabric.js +373 -0
- package/dist/rest/namespaces/fabric.js.map +1 -0
- package/dist/rest/namespaces/imported-numbers.d.ts +22 -0
- package/dist/rest/namespaces/imported-numbers.js +26 -0
- package/dist/rest/namespaces/imported-numbers.js.map +1 -0
- package/dist/rest/namespaces/logs.d.ts +105 -0
- package/dist/rest/namespaces/logs.js +133 -0
- package/dist/rest/namespaces/logs.js.map +1 -0
- package/dist/rest/namespaces/lookup.d.ts +29 -0
- package/dist/rest/namespaces/lookup.js +32 -0
- package/dist/rest/namespaces/lookup.js.map +1 -0
- package/dist/rest/namespaces/mfa.d.ts +46 -0
- package/dist/rest/namespaces/mfa.js +54 -0
- package/dist/rest/namespaces/mfa.js.map +1 -0
- package/dist/rest/namespaces/number-groups.d.ts +49 -0
- package/dist/rest/namespaces/number-groups.js +58 -0
- package/dist/rest/namespaces/number-groups.js.map +1 -0
- package/dist/rest/namespaces/phone-numbers.d.ts +60 -0
- package/dist/rest/namespaces/phone-numbers.js +67 -0
- package/dist/rest/namespaces/phone-numbers.js.map +1 -0
- package/dist/rest/namespaces/project.d.ts +46 -0
- package/dist/rest/namespaces/project.js +56 -0
- package/dist/rest/namespaces/project.js.map +1 -0
- package/dist/rest/namespaces/pubsub.d.ts +22 -0
- package/dist/rest/namespaces/pubsub.js +26 -0
- package/dist/rest/namespaces/pubsub.js.map +1 -0
- package/dist/rest/namespaces/queues.d.ts +42 -0
- package/dist/rest/namespaces/queues.js +49 -0
- package/dist/rest/namespaces/queues.js.map +1 -0
- package/dist/rest/namespaces/recordings.d.ts +38 -0
- package/dist/rest/namespaces/recordings.js +45 -0
- package/dist/rest/namespaces/recordings.js.map +1 -0
- package/dist/rest/namespaces/registry.d.ts +141 -0
- package/dist/rest/namespaces/registry.js +178 -0
- package/dist/rest/namespaces/registry.js.map +1 -0
- package/dist/rest/namespaces/short-codes.d.ts +39 -0
- package/dist/rest/namespaces/short-codes.js +46 -0
- package/dist/rest/namespaces/short-codes.js.map +1 -0
- package/dist/rest/namespaces/sip-profile.d.ts +28 -0
- package/dist/rest/namespaces/sip-profile.js +34 -0
- package/dist/rest/namespaces/sip-profile.js.map +1 -0
- package/dist/rest/namespaces/verified-callers.d.ts +33 -0
- package/dist/rest/namespaces/verified-callers.js +39 -0
- package/dist/rest/namespaces/verified-callers.js.map +1 -0
- package/dist/rest/namespaces/video.d.ts +235 -0
- package/dist/rest/namespaces/video.js +297 -0
- package/dist/rest/namespaces/video.js.map +1 -0
- package/dist/rest/pagination.d.ts +39 -0
- package/dist/rest/pagination.js +78 -0
- package/dist/rest/pagination.js.map +1 -0
- package/dist/rest/types.d.ts +54 -0
- package/dist/rest/types.js +5 -0
- package/dist/rest/types.js.map +1 -0
- package/dist/skills/SkillBase.d.ts +404 -0
- package/dist/skills/SkillBase.js +471 -0
- package/dist/skills/SkillBase.js.map +1 -0
- package/dist/skills/SkillManager.d.ts +195 -0
- package/dist/skills/SkillManager.js +378 -0
- package/dist/skills/SkillManager.js.map +1 -0
- package/dist/skills/SkillRegistry.d.ts +176 -0
- package/dist/skills/SkillRegistry.js +310 -0
- package/dist/skills/SkillRegistry.js.map +1 -0
- package/dist/skills/builtin/api_ninjas_trivia.d.ts +47 -0
- package/dist/skills/builtin/api_ninjas_trivia.js +211 -0
- package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -0
- package/dist/skills/builtin/ask_claude.d.ts +37 -0
- package/dist/skills/builtin/ask_claude.js +162 -0
- package/dist/skills/builtin/ask_claude.js.map +1 -0
- package/dist/skills/builtin/claude_skills.d.ts +75 -0
- package/dist/skills/builtin/claude_skills.js +753 -0
- package/dist/skills/builtin/claude_skills.js.map +1 -0
- package/dist/skills/builtin/custom_skills.d.ts +79 -0
- package/dist/skills/builtin/custom_skills.js +227 -0
- package/dist/skills/builtin/custom_skills.js.map +1 -0
- package/dist/skills/builtin/datasphere.d.ts +73 -0
- package/dist/skills/builtin/datasphere.js +350 -0
- package/dist/skills/builtin/datasphere.js.map +1 -0
- package/dist/skills/builtin/datasphere_serverless.d.ts +89 -0
- package/dist/skills/builtin/datasphere_serverless.js +291 -0
- package/dist/skills/builtin/datasphere_serverless.js.map +1 -0
- package/dist/skills/builtin/datetime.d.ts +40 -0
- package/dist/skills/builtin/datetime.js +118 -0
- package/dist/skills/builtin/datetime.js.map +1 -0
- package/dist/skills/builtin/google_maps.d.ts +48 -0
- package/dist/skills/builtin/google_maps.js +470 -0
- package/dist/skills/builtin/google_maps.js.map +1 -0
- package/dist/skills/builtin/index.d.ts +31 -0
- package/{src/skills/builtin/index.ts → dist/skills/builtin/index.js} +30 -36
- package/dist/skills/builtin/index.js.map +1 -0
- package/dist/skills/builtin/info_gatherer.d.ts +115 -0
- package/dist/skills/builtin/info_gatherer.js +328 -0
- package/dist/skills/builtin/info_gatherer.js.map +1 -0
- package/dist/skills/builtin/joke.d.ts +41 -0
- package/dist/skills/builtin/joke.js +156 -0
- package/dist/skills/builtin/joke.js.map +1 -0
- package/dist/skills/builtin/math.d.ts +39 -0
- package/dist/skills/builtin/math.js +119 -0
- package/dist/skills/builtin/math.js.map +1 -0
- package/dist/skills/builtin/mcp_gateway.d.ts +82 -0
- package/dist/skills/builtin/mcp_gateway.js +574 -0
- package/dist/skills/builtin/mcp_gateway.js.map +1 -0
- package/dist/skills/builtin/native_vector_search.d.ts +128 -0
- package/dist/skills/builtin/native_vector_search.js +752 -0
- package/dist/skills/builtin/native_vector_search.js.map +1 -0
- package/dist/skills/builtin/play_background_file.d.ts +59 -0
- package/dist/skills/builtin/play_background_file.js +274 -0
- package/dist/skills/builtin/play_background_file.js.map +1 -0
- package/dist/skills/builtin/spider.d.ts +91 -0
- package/dist/skills/builtin/spider.js +758 -0
- package/dist/skills/builtin/spider.js.map +1 -0
- package/dist/skills/builtin/swml_transfer.d.ts +66 -0
- package/dist/skills/builtin/swml_transfer.js +475 -0
- package/dist/skills/builtin/swml_transfer.js.map +1 -0
- package/dist/skills/builtin/weather_api.d.ts +59 -0
- package/dist/skills/builtin/weather_api.js +196 -0
- package/dist/skills/builtin/weather_api.js.map +1 -0
- package/dist/skills/builtin/web_search.d.ts +160 -0
- package/dist/skills/builtin/web_search.js +894 -0
- package/dist/skills/builtin/web_search.js.map +1 -0
- package/dist/skills/builtin/wikipedia_search.d.ts +77 -0
- package/dist/skills/builtin/wikipedia_search.js +241 -0
- package/dist/skills/builtin/wikipedia_search.js.map +1 -0
- package/{src/skills/index.ts → dist/skills/index.d.ts} +0 -1
- package/dist/skills/index.js +10 -0
- package/dist/skills/index.js.map +1 -0
- package/dist/types.d.ts +118 -0
- package/dist/types.js +5 -0
- package/dist/types.js.map +1 -0
- package/package.json +7 -1
- package/.github/workflows/publish.yml +0 -27
- package/.github/workflows/test.yml +0 -17
- package/CLAUDE.md +0 -112
- package/docs/MIGRATION-2.0.md +0 -81
- package/docs/agent-guide.md +0 -869
- package/docs/agent_guide.md +0 -1026
- package/docs/api-reference.md +0 -2420
- package/docs/api_reference.md +0 -1301
- package/docs/architecture.md +0 -843
- package/docs/cli-guide.md +0 -579
- package/docs/cli_guide.md +0 -448
- package/docs/cloud_functions_guide.md +0 -474
- package/docs/configuration.md +0 -422
- package/docs/contexts-guide.md +0 -787
- package/docs/contexts_guide.md +0 -511
- package/docs/datamap-guide.md +0 -1141
- package/docs/datamap_guide.md +0 -595
- package/docs/llm_parameters.md +0 -239
- package/docs/mcp_gateway_reference.md +0 -648
- package/docs/mcp_integration.md +0 -108
- package/docs/prefabs-guide.md +0 -800
- package/docs/sdk_features.md +0 -477
- package/docs/security.md +0 -436
- package/docs/serverless-guide.md +0 -513
- package/docs/skills-guide.md +0 -857
- package/docs/skills-system.md +0 -301
- package/docs/skills_parameter_schema.md +0 -392
- package/docs/skills_system.md +0 -467
- package/docs/swaig-reference.md +0 -1627
- package/docs/swaig_reference.md +0 -910
- package/docs/swml_service_guide.md +0 -600
- package/docs/third_party_skills.md +0 -533
- package/docs/web_service.md +0 -677
- package/examples/README.md +0 -131
- package/examples/advanced-datamap.ts +0 -100
- package/examples/advanced-dynamic-config.ts +0 -70
- package/examples/auto-vivified.ts +0 -94
- package/examples/call-flow.ts +0 -63
- package/examples/comprehensive-dynamic.ts +0 -125
- package/examples/contexts-steps.ts +0 -65
- package/examples/custom-path.ts +0 -45
- package/examples/datamap-tools.ts +0 -55
- package/examples/datasphere-multi-instance.ts +0 -63
- package/examples/datasphere-serverless-env.ts +0 -68
- package/examples/datasphere-webhook-env.ts +0 -66
- package/examples/datasphere.ts +0 -37
- package/examples/declarative.ts +0 -100
- package/examples/dynamic-config.ts +0 -54
- package/examples/dynamic-info-gatherer.ts +0 -69
- package/examples/dynamic-swml-service.ts +0 -67
- package/examples/gather-info.ts +0 -71
- package/examples/gather-per-question-functions-demo.ts +0 -140
- package/examples/joke-agent.ts +0 -34
- package/examples/kubernetes-agent.ts +0 -45
- package/examples/llm-params.ts +0 -69
- package/examples/mcp-agent.ts +0 -84
- package/examples/mcp-gateway.ts +0 -35
- package/examples/multi-agent.ts +0 -73
- package/examples/multi-endpoint.ts +0 -79
- package/examples/pom-prompt.ts +0 -71
- package/examples/prefab-concierge.ts +0 -47
- package/examples/prefab-faq.ts +0 -54
- package/examples/prefab-info-gatherer.ts +0 -33
- package/examples/prefab-receptionist.ts +0 -36
- package/examples/prefab-survey.ts +0 -68
- package/examples/record-call.ts +0 -67
- package/examples/relay-demo.ts +0 -33
- package/examples/room-and-sip.ts +0 -94
- package/examples/serverless-lambda.ts +0 -35
- package/examples/session-state.ts +0 -83
- package/examples/simple-agent.ts +0 -36
- package/examples/simple-static.ts +0 -29
- package/examples/skills-demo.ts +0 -38
- package/examples/step-function-inheritance-demo.ts +0 -124
- package/examples/swaig-features.ts +0 -187
- package/examples/swml-service-routing.ts +0 -66
- package/examples/swml-service.ts +0 -38
- package/examples/tap.ts +0 -68
- package/examples/verb-methods.ts +0 -45
- package/examples/web-search-multi-instance.ts +0 -72
- package/examples/web-search.ts +0 -38
- package/examples/wikipedia.ts +0 -36
- package/livewire/README.md +0 -140
- package/livewire/docs/migration-guide.md +0 -228
- package/livewire/examples/livewire-basic-agent.ts +0 -74
- package/livewire/examples/livewire-handoff.ts +0 -197
- package/livewire/examples/livewire-multi-tool.ts +0 -117
- package/relay/README.md +0 -70
- package/relay/RELAY_IMPLEMENTATION_GUIDE.md +0 -1257
- package/relay/docs/call-methods.md +0 -474
- package/relay/docs/client-reference.md +0 -142
- package/relay/docs/events.md +0 -134
- package/relay/docs/getting-started.md +0 -134
- package/relay/docs/guide.md +0 -306
- package/relay/docs/messaging.md +0 -182
- package/relay/examples/relay-inbound.ts +0 -66
- package/relay/examples/relay-messaging.ts +0 -71
- package/relay/examples/relay-outbound.ts +0 -76
- package/rest/README.md +0 -95
- package/rest/docs/calling.md +0 -273
- package/rest/docs/client-reference.md +0 -107
- package/rest/docs/compat.md +0 -204
- package/rest/docs/fabric.md +0 -183
- package/rest/docs/getting-started.md +0 -110
- package/rest/docs/guide.md +0 -351
- package/rest/docs/namespaces.md +0 -285
- package/rest/examples/rest-10dlc-registration.ts +0 -161
- package/rest/examples/rest-calling-ivr-and-ai.ts +0 -102
- package/rest/examples/rest-calling-play-and-record.ts +0 -91
- package/rest/examples/rest-client.ts +0 -65
- package/rest/examples/rest-compat-laml.ts +0 -210
- package/rest/examples/rest-datasphere-search.ts +0 -82
- package/rest/examples/rest-fabric-conferences-and-routing.ts +0 -144
- package/rest/examples/rest-fabric-subscribers-and-sip.ts +0 -108
- package/rest/examples/rest-fabric-swml-and-callflows.ts +0 -99
- package/rest/examples/rest-manage-resources.ts +0 -65
- package/rest/examples/rest-phone-number-management.ts +0 -197
- package/rest/examples/rest-queues-mfa-and-recordings.ts +0 -143
- package/rest/examples/rest-video-rooms.ts +0 -186
- package/src/AgentBase.ts +0 -2489
- package/src/AgentServer.ts +0 -415
- package/src/AuthHandler.ts +0 -256
- package/src/ConfigLoader.ts +0 -447
- package/src/ContextBuilder.ts +0 -1150
- package/src/DataMap.ts +0 -449
- package/src/FunctionResult.ts +0 -866
- package/src/Logger.ts +0 -337
- package/src/PomBuilder.ts +0 -439
- package/src/PromptManager.ts +0 -133
- package/src/SWMLHandler.ts +0 -298
- package/src/SWMLService.ts +0 -717
- package/src/SchemaUtils.ts +0 -361
- package/src/ServerlessAdapter.ts +0 -221
- package/src/SessionManager.ts +0 -311
- package/src/SslConfig.ts +0 -118
- package/src/SwaigFunction.ts +0 -276
- package/src/SwmlBuilder.ts +0 -258
- package/src/SwmlVerbMethods.generated.ts +0 -234
- package/src/TypeInference.ts +0 -181
- package/src/WebService.ts +0 -619
- package/src/cli/agent-loader.ts +0 -166
- package/src/cli/mock-data.ts +0 -111
- package/src/cli/swaig-test.ts +0 -452
- package/src/generateVerbTypes.ts +0 -322
- package/src/index.ts +0 -167
- package/src/livewire/index.ts +0 -950
- package/src/prefabs/ConciergeAgent.ts +0 -287
- package/src/prefabs/FAQBotAgent.ts +0 -384
- package/src/prefabs/InfoGathererAgent.ts +0 -339
- package/src/prefabs/ReceptionistAgent.ts +0 -366
- package/src/prefabs/SurveyAgent.ts +0 -646
- package/src/relay/Action.ts +0 -314
- package/src/relay/Call.ts +0 -854
- package/src/relay/Deferred.ts +0 -71
- package/src/relay/Message.ts +0 -148
- package/src/relay/RelayClient.ts +0 -1036
- package/src/relay/RelayError.ts +0 -14
- package/src/relay/RelayEvent.ts +0 -892
- package/src/relay/index.ts +0 -123
- package/src/relay/types.ts +0 -149
- package/src/rest/HttpClient.ts +0 -103
- package/src/rest/RestError.ts +0 -31
- package/src/rest/base/BaseResource.ts +0 -19
- package/src/rest/base/CrudResource.ts +0 -51
- package/src/rest/base/CrudWithAddresses.ts +0 -26
- package/src/rest/namespaces/addresses.ts +0 -32
- package/src/rest/namespaces/calling.ts +0 -187
- package/src/rest/namespaces/chat.ts +0 -20
- package/src/rest/namespaces/compat.ts +0 -352
- package/src/rest/namespaces/datasphere.ts +0 -45
- package/src/rest/namespaces/fabric.ts +0 -222
- package/src/rest/namespaces/imported-numbers.ts +0 -20
- package/src/rest/namespaces/logs.ts +0 -84
- package/src/rest/namespaces/lookup.ts +0 -21
- package/src/rest/namespaces/mfa.ts +0 -30
- package/src/rest/namespaces/number-groups.ts +0 -38
- package/src/rest/namespaces/phone-numbers.ts +0 -44
- package/src/rest/namespaces/project.ts +0 -36
- package/src/rest/namespaces/pubsub.ts +0 -20
- package/src/rest/namespaces/queues.ts +0 -33
- package/src/rest/namespaces/recordings.ts +0 -28
- package/src/rest/namespaces/registry.ts +0 -101
- package/src/rest/namespaces/short-codes.ts +0 -28
- package/src/rest/namespaces/sip-profile.ts +0 -25
- package/src/rest/namespaces/verified-callers.ts +0 -27
- package/src/rest/namespaces/video.ts +0 -165
- package/src/rest/pagination.ts +0 -84
- package/src/rest/types.ts +0 -61
- package/src/skills/SkillBase.ts +0 -547
- package/src/skills/SkillManager.ts +0 -415
- package/src/skills/SkillRegistry.ts +0 -367
- package/src/skills/builtin/api_ninjas_trivia.ts +0 -280
- package/src/skills/builtin/ask_claude.ts +0 -241
- package/src/skills/builtin/claude_skills.ts +0 -978
- package/src/skills/builtin/custom_skills.ts +0 -312
- package/src/skills/builtin/datasphere.ts +0 -438
- package/src/skills/builtin/datasphere_serverless.ts +0 -339
- package/src/skills/builtin/datetime.ts +0 -130
- package/src/skills/builtin/google_maps.ts +0 -651
- package/src/skills/builtin/info_gatherer.ts +0 -405
- package/src/skills/builtin/joke.ts +0 -191
- package/src/skills/builtin/math.ts +0 -142
- package/src/skills/builtin/mcp_gateway.ts +0 -677
- package/src/skills/builtin/native_vector_search.ts +0 -901
- package/src/skills/builtin/play_background_file.ts +0 -358
- package/src/skills/builtin/spider.ts +0 -869
- package/src/skills/builtin/swml_transfer.ts +0 -635
- package/src/skills/builtin/weather_api.ts +0 -248
- package/src/skills/builtin/web_search.ts +0 -1074
- package/src/skills/builtin/wikipedia_search.ts +0 -299
- package/src/types.ts +0 -132
- package/tests/AgentBase.test.ts +0 -1093
- package/tests/AgentServer.test.ts +0 -126
- package/tests/AuthHandler.test.ts +0 -133
- package/tests/ConfigLoader.test.ts +0 -151
- package/tests/ContextBuilder.test.ts +0 -108
- package/tests/DataMap.test.ts +0 -367
- package/tests/EphemeralSkillCopy.test.ts +0 -107
- package/tests/FunctionResult.test.ts +0 -298
- package/tests/GracefulShutdown.test.ts +0 -46
- package/tests/Logger.test.ts +0 -420
- package/tests/PomBuilder.test.ts +0 -228
- package/tests/ProxyDetection.test.ts +0 -228
- package/tests/SWMLService.test.ts +0 -320
- package/tests/SWMLVerbHandler.test.ts +0 -523
- package/tests/SchemaUtils.test.ts +0 -106
- package/tests/SchemaUtils.verb.test.ts +0 -206
- package/tests/SecurityUtils.test.ts +0 -192
- package/tests/ServerlessAdapter.test.ts +0 -222
- package/tests/SessionManager.test.ts +0 -257
- package/tests/SkillBaseFeatures.test.ts +0 -130
- package/tests/SkillMultiInstance.test.ts +0 -102
- package/tests/SkillParameterSchemas.test.ts +0 -134
- package/tests/SkillRegistrySchema.test.ts +0 -84
- package/tests/SslConfig.test.ts +0 -97
- package/tests/SwmlBuilder.test.ts +0 -400
- package/tests/TypeInference.test.ts +0 -165
- package/tests/VerbHandlerRegistry.test.ts +0 -128
- package/tests/cli/mock-data.test.ts +0 -113
- package/tests/cli/swaig-test.test.ts +0 -108
- package/tests/examples.test.ts +0 -194
- package/tests/fixtures/scrape-parity/README.md +0 -53
- package/tests/fixtures/scrape-parity/expected/01_simple_article.json +0 -5
- package/tests/fixtures/scrape-parity/expected/02_class_based_noise.json +0 -5
- package/tests/fixtures/scrape-parity/expected/03_nested_containers.json +0 -5
- package/tests/fixtures/scrape-parity/expected/04_bare_body.json +0 -5
- package/tests/fixtures/scrape-parity/expected/05_malformed.json +0 -5
- package/tests/fixtures/scrape-parity/expected/06_multi_class.json +0 -5
- package/tests/fixtures/scrape-parity/expected/07_anchor_pattern.json +0 -5
- package/tests/fixtures/scrape-parity/expected/08_inline_script.json +0 -5
- package/tests/fixtures/scrape-parity/expected/09_whitespace_nbsp.json +0 -5
- package/tests/fixtures/scrape-parity/expected/10_entity_unicode.json +0 -5
- package/tests/fixtures/scrape-parity/expected/11_cdata_comments.json +0 -5
- package/tests/fixtures/scrape-parity/expected/12_deep_nested_removals.json +0 -5
- package/tests/fixtures/scrape-parity/html/01_simple_article.html +0 -18
- package/tests/fixtures/scrape-parity/html/02_class_based_noise.html +0 -18
- package/tests/fixtures/scrape-parity/html/03_nested_containers.html +0 -13
- package/tests/fixtures/scrape-parity/html/04_bare_body.html +0 -9
- package/tests/fixtures/scrape-parity/html/05_malformed.html +0 -11
- package/tests/fixtures/scrape-parity/html/06_multi_class.html +0 -18
- package/tests/fixtures/scrape-parity/html/07_anchor_pattern.html +0 -12
- package/tests/fixtures/scrape-parity/html/08_inline_script.html +0 -17
- package/tests/fixtures/scrape-parity/html/09_whitespace_nbsp.html +0 -21
- package/tests/fixtures/scrape-parity/html/10_entity_unicode.html +0 -10
- package/tests/fixtures/scrape-parity/html/11_cdata_comments.html +0 -13
- package/tests/fixtures/scrape-parity/html/12_deep_nested_removals.html +0 -24
- package/tests/fixtures/scrape-parity/python_extract.py +0 -109
- package/tests/livewire/livewire.test.ts +0 -780
- package/tests/mcp.test.ts +0 -221
- package/tests/prefabs/prefabs.test.ts +0 -1093
- package/tests/relay/Action.test.ts +0 -392
- package/tests/relay/Call.test.ts +0 -535
- package/tests/relay/Deferred.test.ts +0 -71
- package/tests/relay/Message.test.ts +0 -164
- package/tests/relay/RelayClient.test.ts +0 -779
- package/tests/relay/RelayEvent.test.ts +0 -463
- package/tests/relay/helpers.ts +0 -79
- package/tests/rest/HttpClient.test.ts +0 -274
- package/tests/rest/RestError.test.ts +0 -53
- package/tests/rest/calling.test.ts +0 -156
- package/tests/rest/client.test.ts +0 -197
- package/tests/rest/compat.test.ts +0 -335
- package/tests/rest/datasphere.test.ts +0 -71
- package/tests/rest/fabric.test.ts +0 -186
- package/tests/rest/helpers.ts +0 -95
- package/tests/rest/logs.test.ts +0 -68
- package/tests/rest/pagination.test.ts +0 -133
- package/tests/rest/registry.test.ts +0 -94
- package/tests/rest/relay-rest.test.ts +0 -290
- package/tests/rest/video.test.ts +0 -173
- package/tests/setup.ts +0 -6
- package/tests/skills/SkillBase.test.ts +0 -108
- package/tests/skills/SkillManager.test.ts +0 -268
- package/tests/skills/SkillRegistry.test.ts +0 -176
- package/tests/skills/builtin.test.ts +0 -1472
- package/tests/skills/claude-skills.test.ts +0 -54
- package/tests/skills/custom-skills.test.ts +0 -53
- package/tests/skills/datasphere-serverless.test.ts +0 -70
- package/tests/skills/datasphere.test.ts +0 -107
- package/tests/skills/datetime.test.ts +0 -101
- package/tests/skills/google-maps.test.ts +0 -78
- package/tests/skills/info-gatherer.test.ts +0 -411
- package/tests/skills/joke.test.ts +0 -81
- package/tests/skills/math.test.ts +0 -68
- package/tests/skills/mcp-gateway.test.ts +0 -101
- package/tests/skills/play-background.test.ts +0 -54
- package/tests/skills/spider.test.ts +0 -108
- package/tests/skills/swml-transfer.test.ts +0 -178
- package/tests/skills/trivia.test.ts +0 -54
- package/tests/skills/vector-search.test.ts +0 -135
- package/tests/skills/weather-api.test.ts +0 -77
- package/tests/skills/web-search-parity.test.ts +0 -59
- package/tests/skills/web-search.test.ts +0 -103
- package/tests/skills/wikipedia.test.ts +0 -63
- package/tsconfig.json +0 -18
- package/vitest.config.ts +0 -9
- /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
|
-
});
|