@signalwire/sdk 2.0.4 → 3.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +785 -0
- package/LICENSE +21 -0
- package/README.md +163 -68
- package/dist/AGENTS.md +13 -0
- package/dist/AgentBase.d.ts +550 -163
- package/dist/AgentBase.js +1640 -514
- package/dist/AgentBase.js.map +1 -1
- package/dist/AgentServer.d.ts +21 -0
- package/dist/AgentServer.js +154 -47
- package/dist/AgentServer.js.map +1 -1
- package/dist/AuthHandler.d.ts +14 -2
- package/dist/AuthHandler.js +7 -2
- package/dist/AuthHandler.js.map +1 -1
- package/dist/ConfigLoader.d.ts +5 -13
- package/dist/ConfigLoader.js +15 -29
- package/dist/ConfigLoader.js.map +1 -1
- package/dist/ContextBuilder.d.ts +202 -9
- package/dist/ContextBuilder.js +219 -36
- package/dist/ContextBuilder.js.map +1 -1
- package/dist/DataMap.d.ts +158 -45
- package/dist/DataMap.js +167 -52
- package/dist/DataMap.js.map +1 -1
- package/dist/FunctionResult.d.ts +277 -83
- package/dist/FunctionResult.js +444 -116
- package/dist/FunctionResult.js.map +1 -1
- package/dist/Logger.d.ts +30 -5
- package/dist/Logger.js +77 -19
- package/dist/Logger.js.map +1 -1
- package/dist/POM/PromptObjectModel.d.ts +163 -0
- package/dist/POM/PromptObjectModel.js +481 -0
- package/dist/POM/PromptObjectModel.js.map +1 -0
- package/dist/ParameterSchema.d.ts +306 -0
- package/dist/ParameterSchema.js +251 -0
- package/dist/ParameterSchema.js.map +1 -0
- package/dist/PlatformContracts.d.ts +21 -0
- package/dist/PlatformContracts.generated.d.ts +109 -0
- package/dist/PlatformContracts.generated.js +8 -0
- package/dist/PlatformContracts.generated.js.map +1 -0
- package/dist/PlatformContracts.js +2 -0
- package/dist/PlatformContracts.js.map +1 -0
- package/dist/PomBuilder.d.ts +28 -0
- package/dist/PomBuilder.js +81 -3
- package/dist/PomBuilder.js.map +1 -1
- package/dist/PostPrompt.d.ts +110 -0
- package/dist/PostPrompt.js +204 -0
- package/dist/PostPrompt.js.map +1 -0
- package/dist/PromptManager.d.ts +29 -1
- package/dist/PromptManager.js +37 -1
- package/dist/PromptManager.js.map +1 -1
- package/dist/PublicFetch.d.ts +132 -0
- package/dist/PublicFetch.js +311 -0
- package/dist/PublicFetch.js.map +1 -0
- package/dist/RobotsTxt.d.ts +41 -0
- package/dist/RobotsTxt.js +152 -0
- package/dist/RobotsTxt.js.map +1 -0
- package/dist/SWMLHandler.js.map +1 -1
- package/dist/SWMLService.d.ts +265 -66
- package/dist/SWMLService.js +652 -112
- package/dist/SWMLService.js.map +1 -1
- package/dist/SchemaUtils.d.ts +115 -2
- package/dist/SchemaUtils.js +444 -12
- package/dist/SchemaUtils.js.map +1 -1
- package/dist/SecurityUtils.d.ts +55 -8
- package/dist/SecurityUtils.js +162 -49
- package/dist/SecurityUtils.js.map +1 -1
- package/dist/ServerlessAdapter.d.ts +156 -7
- package/dist/ServerlessAdapter.js +399 -42
- package/dist/ServerlessAdapter.js.map +1 -1
- package/dist/SessionManager.d.ts +11 -2
- package/dist/SessionManager.js +50 -18
- package/dist/SessionManager.js.map +1 -1
- package/dist/SslConfig.d.ts +2 -1
- package/dist/SslConfig.js +4 -1
- package/dist/SslConfig.js.map +1 -1
- package/dist/SwaigActions.generated.d.ts +23 -0
- package/dist/SwaigActions.generated.js +8 -0
- package/dist/SwaigActions.generated.js.map +1 -0
- package/dist/SwaigContracts.d.ts +15 -0
- package/dist/SwaigContracts.generated.d.ts +264 -0
- package/dist/SwaigContracts.generated.js +12 -0
- package/dist/SwaigContracts.generated.js.map +1 -0
- package/dist/SwaigContracts.js +2 -0
- package/dist/SwaigContracts.js.map +1 -0
- package/dist/SwaigFunction.d.ts +110 -4
- package/dist/SwaigFunction.js +151 -19
- package/dist/SwaigFunction.js.map +1 -1
- package/dist/SwmlBuilder.d.ts +68 -19
- package/dist/SwmlBuilder.js +74 -38
- package/dist/SwmlBuilder.js.map +1 -1
- package/dist/SwmlVerbMethods.generated.d.ts +41 -4
- package/dist/SwmlVerbMethods.generated.js +1 -1
- package/dist/TypeInference.d.ts +39 -3
- package/dist/TypeInference.js +256 -16
- package/dist/TypeInference.js.map +1 -1
- package/dist/WebService.d.ts +79 -11
- package/dist/WebService.js +320 -109
- package/dist/WebService.js.map +1 -1
- package/dist/WebhookMiddleware.d.ts +119 -0
- package/dist/WebhookMiddleware.js +271 -0
- package/dist/WebhookMiddleware.js.map +1 -0
- package/dist/WebhookValidator.d.ts +92 -0
- package/dist/WebhookValidator.js +409 -0
- package/dist/WebhookValidator.js.map +1 -0
- package/dist/agents/BedrockAgent.d.ts +162 -0
- package/dist/agents/BedrockAgent.js +323 -0
- package/dist/agents/BedrockAgent.js.map +1 -0
- package/dist/ai-chat/AIChatClient.d.ts +316 -0
- package/dist/ai-chat/AIChatClient.js +535 -0
- package/dist/ai-chat/AIChatClient.js.map +1 -0
- package/dist/ai-chat/ChatGateway.d.ts +408 -0
- package/dist/ai-chat/ChatGateway.js +747 -0
- package/dist/ai-chat/ChatGateway.js.map +1 -0
- package/dist/ai-chat/HandoffRouter.d.ts +282 -0
- package/dist/ai-chat/HandoffRouter.js +518 -0
- package/dist/ai-chat/HandoffRouter.js.map +1 -0
- package/dist/ai-chat/index.d.ts +12 -0
- package/dist/ai-chat/index.js +10 -0
- package/dist/ai-chat/index.js.map +1 -0
- package/dist/capabilities.d.ts +64 -0
- package/dist/capabilities.js +95 -0
- package/dist/capabilities.js.map +1 -0
- package/dist/cli/agent-loader.d.ts +32 -6
- package/dist/cli/agent-loader.js +95 -34
- package/dist/cli/agent-loader.js.map +1 -1
- package/dist/cli/datamap-exec.d.ts +175 -0
- package/dist/cli/datamap-exec.js +1284 -0
- package/dist/cli/datamap-exec.js.map +1 -0
- package/dist/cli/function-args.d.ts +40 -0
- package/dist/cli/function-args.js +146 -0
- package/dist/cli/function-args.js.map +1 -0
- package/dist/cli/simulation.d.ts +99 -0
- package/dist/cli/simulation.js +490 -0
- package/dist/cli/simulation.js.map +1 -0
- package/dist/cli/swaig-test.d.ts +12 -25
- package/dist/cli/swaig-test.js +935 -367
- package/dist/cli/swaig-test.js.map +1 -1
- package/dist/cli/tsdocs/agentsNote.d.ts +30 -0
- package/dist/cli/tsdocs/agentsNote.js +92 -0
- package/dist/cli/tsdocs/agentsNote.js.map +1 -0
- package/dist/cli/tsdocs/api-index.json +1 -0
- package/dist/cli/tsdocs/api.d.ts +91 -0
- package/dist/cli/tsdocs/api.js +372 -0
- package/dist/cli/tsdocs/api.js.map +1 -0
- package/dist/cli/tsdocs/apiTypes.d.ts +64 -0
- package/dist/cli/tsdocs/apiTypes.js +7 -0
- package/dist/cli/tsdocs/apiTypes.js.map +1 -0
- package/dist/cli/tsdocs/bin.d.ts +6 -0
- package/dist/cli/tsdocs/bin.js +23 -0
- package/dist/cli/tsdocs/bin.js.map +1 -0
- package/dist/cli/tsdocs/files.d.ts +108 -0
- package/dist/cli/tsdocs/files.js +287 -0
- package/dist/cli/tsdocs/files.js.map +1 -0
- package/dist/cli/tsdocs/index.d.ts +28 -0
- package/dist/cli/tsdocs/index.js +307 -0
- package/dist/cli/tsdocs/index.js.map +1 -0
- package/dist/cli/tsdocs/live.d.ts +41 -0
- package/dist/cli/tsdocs/live.js +202 -0
- package/dist/cli/tsdocs/live.js.map +1 -0
- package/dist/cli/tsdocs/locate.d.ts +51 -0
- package/dist/cli/tsdocs/locate.js +75 -0
- package/dist/cli/tsdocs/locate.js.map +1 -0
- package/dist/cli/tsdocs/render.d.ts +75 -0
- package/dist/cli/tsdocs/render.js +323 -0
- package/dist/cli/tsdocs/render.js.map +1 -0
- package/dist/cli/tsdocs/topics.d.ts +43 -0
- package/dist/cli/tsdocs/topics.js +916 -0
- package/dist/cli/tsdocs/topics.js.map +1 -0
- package/dist/index.d.ts +102 -39
- package/dist/index.js +107 -30
- package/dist/index.js.map +1 -1
- package/dist/livewire/index.d.ts +229 -155
- package/dist/livewire/index.js +298 -195
- package/dist/livewire/index.js.map +1 -1
- package/dist/llms.txt +65 -0
- package/dist/prefabs/CallSessionStore.d.ts +52 -0
- package/dist/prefabs/CallSessionStore.js +72 -0
- package/dist/prefabs/CallSessionStore.js.map +1 -0
- package/dist/prefabs/ConciergeAgent.d.ts +13 -1
- package/dist/prefabs/ConciergeAgent.js +36 -31
- package/dist/prefabs/ConciergeAgent.js.map +1 -1
- package/dist/prefabs/FAQBotAgent.d.ts +9 -1
- package/dist/prefabs/FAQBotAgent.js +113 -47
- package/dist/prefabs/FAQBotAgent.js.map +1 -1
- package/dist/prefabs/InfoGathererAgent.d.ts +22 -3
- package/dist/prefabs/InfoGathererAgent.js +67 -58
- package/dist/prefabs/InfoGathererAgent.js.map +1 -1
- package/dist/prefabs/ReceptionistAgent.d.ts +16 -5
- package/dist/prefabs/ReceptionistAgent.js +39 -31
- package/dist/prefabs/ReceptionistAgent.js.map +1 -1
- package/dist/prefabs/SurveyAgent.d.ts +22 -4
- package/dist/prefabs/SurveyAgent.js +84 -68
- package/dist/prefabs/SurveyAgent.js.map +1 -1
- package/dist/relay/Action.d.ts +44 -21
- package/dist/relay/Action.js +75 -17
- package/dist/relay/Action.js.map +1 -1
- package/dist/relay/Call.d.ts +312 -47
- package/dist/relay/Call.js +369 -18
- package/dist/relay/Call.js.map +1 -1
- package/dist/relay/Deferred.js.map +1 -1
- package/dist/relay/Message.d.ts +26 -5
- package/dist/relay/Message.js +36 -6
- package/dist/relay/Message.js.map +1 -1
- package/dist/relay/RelayClient.d.ts +79 -14
- package/dist/relay/RelayClient.js +268 -61
- package/dist/relay/RelayClient.js.map +1 -1
- package/dist/relay/RelayError.d.ts +14 -0
- package/dist/relay/RelayError.js +15 -0
- package/dist/relay/RelayError.js.map +1 -1
- package/dist/relay/RelayEvent.d.ts +96 -65
- package/dist/relay/RelayEvent.js +85 -56
- package/dist/relay/RelayEvent.js.map +1 -1
- package/dist/relay/closedSets.d.ts +111 -0
- package/dist/relay/closedSets.js +83 -0
- package/dist/relay/closedSets.js.map +1 -0
- package/dist/relay/index.d.ts +3 -1
- package/dist/relay/index.js +1 -0
- package/dist/relay/index.js.map +1 -1
- package/dist/relay/normalize.js.map +1 -1
- package/dist/relay/protocol.types.generated.d.ts +1195 -0
- package/dist/relay/protocol.types.generated.js +8 -0
- package/dist/relay/protocol.types.generated.js.map +1 -0
- package/dist/relay/types.d.ts +81 -39
- package/dist/rest/HttpClient.d.ts +36 -8
- package/dist/rest/HttpClient.js +233 -40
- package/dist/rest/HttpClient.js.map +1 -1
- package/dist/rest/RequestOptions.d.ts +110 -0
- package/dist/rest/RequestOptions.js +113 -0
- package/dist/rest/RequestOptions.js.map +1 -0
- package/dist/rest/RestError.d.ts +52 -6
- package/dist/rest/RestError.js +89 -5
- package/dist/rest/RestError.js.map +1 -1
- package/dist/rest/base/CrudResource.d.ts +16 -26
- package/dist/rest/base/CrudResource.js +19 -33
- package/dist/rest/base/CrudResource.js.map +1 -1
- package/dist/rest/base/CrudWithAddresses.d.ts +3 -2
- package/dist/rest/base/CrudWithAddresses.js +2 -2
- package/dist/rest/base/CrudWithAddresses.js.map +1 -1
- package/dist/rest/base/FabricResource.d.ts +15 -0
- package/dist/rest/base/FabricResource.js +16 -0
- package/dist/rest/base/FabricResource.js.map +1 -0
- package/dist/rest/base/ReadResource.d.ts +62 -0
- package/dist/rest/base/ReadResource.js +69 -0
- package/dist/rest/base/ReadResource.js.map +1 -0
- package/dist/rest/callHandler.d.ts +63 -0
- package/dist/rest/callHandler.js +62 -0
- package/dist/rest/callHandler.js.map +1 -0
- package/dist/rest/index.d.ts +19 -76
- package/dist/rest/index.js +49 -120
- package/dist/rest/index.js.map +1 -1
- package/dist/rest/namespaces/_client_tree_generated.d.ts +103 -0
- package/dist/rest/namespaces/_client_tree_generated.js +171 -0
- package/dist/rest/namespaces/_client_tree_generated.js.map +1 -0
- package/dist/rest/namespaces/addresses.d.ts +3 -42
- package/dist/rest/namespaces/addresses.js +3 -50
- package/dist/rest/namespaces/addresses.js.map +1 -1
- package/dist/rest/namespaces/calling.d.ts +6 -378
- package/dist/rest/namespaces/calling.js +6 -473
- package/dist/rest/namespaces/calling.js.map +1 -1
- package/dist/rest/namespaces/calling.resources.generated.d.ts +165 -0
- package/dist/rest/namespaces/calling.resources.generated.js +477 -0
- package/dist/rest/namespaces/calling.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/calling.types.generated.d.ts +2917 -0
- package/dist/rest/namespaces/calling.types.generated.js +8 -0
- package/dist/rest/namespaces/calling.types.generated.js.map +1 -0
- package/dist/rest/namespaces/chat.d.ts +4 -18
- package/dist/rest/namespaces/chat.js +4 -21
- package/dist/rest/namespaces/chat.js.map +1 -1
- package/dist/rest/namespaces/chat.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/chat.resources.generated.js +29 -0
- package/dist/rest/namespaces/chat.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/chat.types.generated.d.ts +56 -0
- package/dist/rest/namespaces/chat.types.generated.js +8 -0
- package/dist/rest/namespaces/chat.types.generated.js.map +1 -0
- package/dist/rest/namespaces/datasphere.d.ts +6 -62
- package/dist/rest/namespaces/datasphere.js +6 -72
- package/dist/rest/namespaces/datasphere.js.map +1 -1
- package/dist/rest/namespaces/datasphere.resources.generated.d.ts +25 -0
- package/dist/rest/namespaces/datasphere.resources.generated.js +50 -0
- package/dist/rest/namespaces/datasphere.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/datasphere.types.generated.d.ts +180 -0
- package/dist/rest/namespaces/datasphere.types.generated.js +8 -0
- package/dist/rest/namespaces/datasphere.types.generated.js.map +1 -0
- package/dist/rest/namespaces/fabric.d.ts +11 -273
- package/dist/rest/namespaces/fabric.js +14 -363
- package/dist/rest/namespaces/fabric.js.map +1 -1
- package/dist/rest/namespaces/fabric.resources.generated.d.ts +195 -0
- package/dist/rest/namespaces/fabric.resources.generated.js +399 -0
- package/dist/rest/namespaces/fabric.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/fabric.types.generated.d.ts +4557 -0
- package/dist/rest/namespaces/fabric.types.generated.js +8 -0
- package/dist/rest/namespaces/fabric.types.generated.js.map +1 -0
- package/dist/rest/namespaces/fax.resources.generated.d.ts +6 -0
- package/dist/rest/namespaces/fax.resources.generated.js +14 -0
- package/dist/rest/namespaces/fax.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/fax.types.generated.d.ts +131 -0
- package/dist/rest/namespaces/fax.types.generated.js +8 -0
- package/dist/rest/namespaces/fax.types.generated.js.map +1 -0
- package/dist/rest/namespaces/imported-numbers.d.ts +3 -18
- package/dist/rest/namespaces/imported-numbers.js +3 -21
- package/dist/rest/namespaces/imported-numbers.js.map +1 -1
- package/dist/rest/namespaces/logs.d.ts +10 -101
- package/dist/rest/namespaces/logs.js +10 -128
- package/dist/rest/namespaces/logs.js.map +1 -1
- package/dist/rest/namespaces/logs.resources.generated.d.ts +9 -0
- package/dist/rest/namespaces/logs.resources.generated.js +17 -0
- package/dist/rest/namespaces/logs.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/logs.types.generated.d.ts +131 -0
- package/dist/rest/namespaces/logs.types.generated.js +8 -0
- package/dist/rest/namespaces/logs.types.generated.js.map +1 -0
- package/dist/rest/namespaces/lookup.d.ts +3 -25
- package/dist/rest/namespaces/lookup.js +3 -27
- package/dist/rest/namespaces/lookup.js.map +1 -1
- package/dist/rest/namespaces/message.resources.generated.d.ts +6 -0
- package/dist/rest/namespaces/message.resources.generated.js +14 -0
- package/dist/rest/namespaces/message.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/message.types.generated.d.ts +122 -0
- package/dist/rest/namespaces/message.types.generated.js +8 -0
- package/dist/rest/namespaces/message.types.generated.js.map +1 -0
- package/dist/rest/namespaces/messages.resources.generated.d.ts +18 -0
- package/dist/rest/namespaces/messages.resources.generated.js +44 -0
- package/dist/rest/namespaces/messages.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/messages.types.generated.d.ts +99 -0
- package/dist/rest/namespaces/messages.types.generated.js +8 -0
- package/dist/rest/namespaces/messages.types.generated.js.map +1 -0
- package/dist/rest/namespaces/mfa.d.ts +3 -42
- package/dist/rest/namespaces/mfa.js +3 -49
- package/dist/rest/namespaces/mfa.js.map +1 -1
- package/dist/rest/namespaces/number-groups.d.ts +3 -45
- package/dist/rest/namespaces/number-groups.js +3 -53
- package/dist/rest/namespaces/number-groups.js.map +1 -1
- package/dist/rest/namespaces/phone-numbers.d.ts +9 -57
- package/dist/rest/namespaces/phone-numbers.js +9 -63
- package/dist/rest/namespaces/phone-numbers.js.map +1 -1
- package/dist/rest/namespaces/project.d.ts +6 -42
- package/dist/rest/namespaces/project.js +6 -51
- package/dist/rest/namespaces/project.js.map +1 -1
- package/dist/rest/namespaces/project.resources.generated.d.ts +17 -0
- package/dist/rest/namespaces/project.resources.generated.js +44 -0
- package/dist/rest/namespaces/project.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/project.types.generated.d.ts +58 -0
- package/dist/rest/namespaces/project.types.generated.js +8 -0
- package/dist/rest/namespaces/project.types.generated.js.map +1 -0
- package/dist/rest/namespaces/projects.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/projects.resources.generated.js +25 -0
- package/dist/rest/namespaces/projects.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/projects.types.generated.d.ts +77 -0
- package/dist/rest/namespaces/projects.types.generated.js +8 -0
- package/dist/rest/namespaces/projects.types.generated.js.map +1 -0
- package/dist/rest/namespaces/pubsub.d.ts +4 -18
- package/dist/rest/namespaces/pubsub.js +4 -21
- package/dist/rest/namespaces/pubsub.js.map +1 -1
- package/dist/rest/namespaces/pubsub.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/pubsub.resources.generated.js +29 -0
- package/dist/rest/namespaces/pubsub.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/pubsub.types.generated.d.ts +60 -0
- package/dist/rest/namespaces/pubsub.types.generated.js +8 -0
- package/dist/rest/namespaces/pubsub.types.generated.js.map +1 -0
- package/dist/rest/namespaces/queues.d.ts +3 -38
- package/dist/rest/namespaces/queues.js +3 -44
- package/dist/rest/namespaces/queues.js.map +1 -1
- package/dist/rest/namespaces/recordings.d.ts +3 -34
- package/dist/rest/namespaces/recordings.js +3 -40
- package/dist/rest/namespaces/recordings.js.map +1 -1
- package/dist/rest/namespaces/registry.d.ts +6 -137
- package/dist/rest/namespaces/registry.js +6 -173
- package/dist/rest/namespaces/registry.js.map +1 -1
- package/dist/rest/namespaces/relay-rest.resources.generated.d.ts +168 -0
- package/dist/rest/namespaces/relay-rest.resources.generated.js +430 -0
- package/dist/rest/namespaces/relay-rest.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/relay-rest.types.generated.d.ts +1906 -0
- package/dist/rest/namespaces/relay-rest.types.generated.js +8 -0
- package/dist/rest/namespaces/relay-rest.types.generated.js.map +1 -0
- package/dist/rest/namespaces/short-codes.d.ts +3 -35
- package/dist/rest/namespaces/short-codes.js +3 -41
- package/dist/rest/namespaces/short-codes.js.map +1 -1
- package/dist/rest/namespaces/sip-profile.d.ts +3 -24
- package/dist/rest/namespaces/sip-profile.js +3 -29
- package/dist/rest/namespaces/sip-profile.js.map +1 -1
- package/dist/rest/namespaces/verified-callers.d.ts +3 -29
- package/dist/rest/namespaces/verified-callers.js +3 -34
- package/dist/rest/namespaces/verified-callers.js.map +1 -1
- package/dist/rest/namespaces/video.d.ts +10 -227
- package/dist/rest/namespaces/video.js +10 -288
- package/dist/rest/namespaces/video.js.map +1 -1
- package/dist/rest/namespaces/video.resources.generated.d.ts +81 -0
- package/dist/rest/namespaces/video.resources.generated.js +171 -0
- package/dist/rest/namespaces/video.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/video.types.generated.d.ts +771 -0
- package/dist/rest/namespaces/video.types.generated.js +8 -0
- package/dist/rest/namespaces/video.types.generated.js.map +1 -0
- package/dist/rest/namespaces/voice.resources.generated.d.ts +9 -0
- package/dist/rest/namespaces/voice.resources.generated.js +17 -0
- package/dist/rest/namespaces/voice.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/voice.types.generated.d.ts +214 -0
- package/dist/rest/namespaces/voice.types.generated.js +8 -0
- package/dist/rest/namespaces/voice.types.generated.js.map +1 -0
- package/dist/rest/pagination.d.ts +5 -1
- package/dist/rest/pagination.js +40 -20
- package/dist/rest/pagination.js.map +1 -1
- package/dist/rest/types.d.ts +21 -3
- package/dist/schema.json +299 -98
- package/dist/skills/SkillBase.d.ts +97 -20
- package/dist/skills/SkillBase.js +100 -17
- package/dist/skills/SkillBase.js.map +1 -1
- package/dist/skills/SkillManager.d.ts +66 -13
- package/dist/skills/SkillManager.js +101 -20
- package/dist/skills/SkillManager.js.map +1 -1
- package/dist/skills/SkillName.d.ts +44 -0
- package/dist/skills/SkillName.js +2 -0
- package/dist/skills/SkillName.js.map +1 -0
- package/dist/skills/SkillRegistry.d.ts +47 -7
- package/dist/skills/SkillRegistry.js +85 -13
- package/dist/skills/SkillRegistry.js.map +1 -1
- package/dist/skills/builtin/api_ninjas_trivia.d.ts +3 -1
- package/dist/skills/builtin/api_ninjas_trivia.js +24 -8
- package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -1
- package/dist/skills/builtin/ask_claude.d.ts +14 -4
- package/dist/skills/builtin/ask_claude.js +36 -14
- package/dist/skills/builtin/ask_claude.js.map +1 -1
- package/dist/skills/builtin/claude_skills.d.ts +3 -1
- package/dist/skills/builtin/claude_skills.js +19 -15
- package/dist/skills/builtin/claude_skills.js.map +1 -1
- package/dist/skills/builtin/custom_skills.d.ts +10 -3
- package/dist/skills/builtin/custom_skills.js +26 -9
- package/dist/skills/builtin/custom_skills.js.map +1 -1
- package/dist/skills/builtin/datasphere.d.ts +5 -3
- package/dist/skills/builtin/datasphere.js +34 -25
- package/dist/skills/builtin/datasphere.js.map +1 -1
- package/dist/skills/builtin/datasphere_serverless.d.ts +12 -1
- package/dist/skills/builtin/datasphere_serverless.js +17 -6
- package/dist/skills/builtin/datasphere_serverless.js.map +1 -1
- package/dist/skills/builtin/datetime.d.ts +3 -1
- package/dist/skills/builtin/datetime.js +11 -7
- package/dist/skills/builtin/datetime.js.map +1 -1
- package/dist/skills/builtin/google_maps.d.ts +29 -14
- package/dist/skills/builtin/google_maps.js +89 -269
- package/dist/skills/builtin/google_maps.js.map +1 -1
- package/dist/skills/builtin/index.d.ts +8 -6
- package/dist/skills/builtin/index.js +8 -6
- package/dist/skills/builtin/index.js.map +1 -1
- package/dist/skills/builtin/info_gatherer.d.ts +4 -2
- package/dist/skills/builtin/info_gatherer.js +20 -12
- package/dist/skills/builtin/info_gatherer.js.map +1 -1
- package/dist/skills/builtin/joke.d.ts +16 -6
- package/dist/skills/builtin/joke.js +54 -37
- package/dist/skills/builtin/joke.js.map +1 -1
- package/dist/skills/builtin/math.d.ts +3 -1
- package/dist/skills/builtin/math.js +14 -9
- package/dist/skills/builtin/math.js.map +1 -1
- package/dist/skills/builtin/mcp_gateway.d.ts +34 -5
- package/dist/skills/builtin/mcp_gateway.js +77 -46
- package/dist/skills/builtin/mcp_gateway.js.map +1 -1
- package/dist/skills/builtin/native_vector_search.d.ts +19 -5
- package/dist/skills/builtin/native_vector_search.js +179 -61
- package/dist/skills/builtin/native_vector_search.js.map +1 -1
- package/dist/skills/builtin/play_background_file.d.ts +21 -15
- package/dist/skills/builtin/play_background_file.js +43 -122
- package/dist/skills/builtin/play_background_file.js.map +1 -1
- package/dist/skills/builtin/spider.d.ts +46 -1
- package/dist/skills/builtin/spider.js +317 -101
- package/dist/skills/builtin/spider.js.map +1 -1
- package/dist/skills/builtin/swml_transfer.d.ts +14 -3
- package/dist/skills/builtin/swml_transfer.js +45 -24
- package/dist/skills/builtin/swml_transfer.js.map +1 -1
- package/dist/skills/builtin/weather_api.d.ts +24 -13
- package/dist/skills/builtin/weather_api.js +57 -31
- package/dist/skills/builtin/weather_api.js.map +1 -1
- package/dist/skills/builtin/web_search.d.ts +48 -10
- package/dist/skills/builtin/web_search.js +301 -84
- package/dist/skills/builtin/web_search.js.map +1 -1
- package/dist/skills/builtin/wikipedia_search.d.ts +4 -2
- package/dist/skills/builtin/wikipedia_search.js +32 -14
- package/dist/skills/builtin/wikipedia_search.js.map +1 -1
- package/dist/skills/index.d.ts +3 -2
- package/dist/skills/index.js +1 -1
- package/dist/skills/index.js.map +1 -1
- package/dist/swml_verbs_generated.d.ts +2824 -0
- package/dist/swml_verbs_generated.js +12 -0
- package/dist/swml_verbs_generated.js.map +1 -0
- package/dist/types.d.ts +65 -6
- package/dist/web.d.ts +27 -0
- package/dist/web.js +20 -0
- package/dist/web.js.map +1 -0
- package/docs/agent-guide.md +1034 -0
- package/docs/ai_chat.md +560 -0
- package/docs/api-reference.md +3534 -0
- package/docs/architecture.md +846 -0
- package/docs/bedrock_agent.md +411 -0
- package/docs/cli-guide.md +403 -0
- package/docs/cloud_functions_guide.md +399 -0
- package/docs/configuration.md +548 -0
- package/docs/contexts-guide.md +884 -0
- package/docs/datamap-guide.md +1160 -0
- package/docs/developer_pain_points.md +548 -0
- package/docs/llm_parameters.md +298 -0
- package/docs/mcp_gateway_reference.md +354 -0
- package/docs/mcp_integration.md +162 -0
- package/docs/pgi_agent_guide.md +1820 -0
- package/docs/prefabs-guide.md +815 -0
- package/docs/programmatically_governed_inference.md +301 -0
- package/docs/sdk_features.md +501 -0
- package/docs/security.md +559 -0
- package/docs/serverless-guide.md +520 -0
- package/docs/skills-guide.md +1223 -0
- package/docs/skills-system.md +405 -0
- package/docs/skills_parameter_schema.md +417 -0
- package/docs/swaig-reference.md +1938 -0
- package/docs/swml_service_guide.md +573 -0
- package/docs/third_party_skills.md +410 -0
- package/docs/web_service.md +666 -0
- package/examples/README.md +202 -0
- package/examples/advanced-datamap.ts +108 -0
- package/examples/advanced-dynamic-config.ts +70 -0
- package/examples/auto-vivified.ts +95 -0
- package/examples/call-flow.ts +65 -0
- package/examples/comprehensive-dynamic.ts +125 -0
- package/examples/contexts-steps.ts +65 -0
- package/examples/custom-path.ts +45 -0
- package/examples/datamap-tools.ts +51 -0
- package/examples/datasphere-multi-instance.ts +66 -0
- package/examples/datasphere-serverless-env.ts +87 -0
- package/examples/datasphere-webhook-env.ts +65 -0
- package/examples/datasphere.ts +56 -0
- package/examples/declarative.ts +100 -0
- package/examples/dynamic-config.ts +54 -0
- package/examples/dynamic-info-gatherer.ts +69 -0
- package/examples/dynamic-swml-service.ts +67 -0
- package/examples/gather-info.ts +95 -0
- package/examples/gather-per-question-functions-demo.ts +139 -0
- package/examples/joke-agent.ts +34 -0
- package/examples/kubernetes-agent.ts +45 -0
- package/examples/llm-params.ts +75 -0
- package/examples/mcp-agent.ts +89 -0
- package/examples/mcp-gateway.ts +81 -0
- package/examples/multi-agent.ts +80 -0
- package/examples/multi-endpoint.ts +79 -0
- package/examples/pgi/case-domain.ts +114 -0
- package/examples/pgi/serve.ts +16 -0
- package/examples/pgi/support-agent.ts +265 -0
- package/examples/pom-prompt.ts +70 -0
- package/examples/prefab-concierge.ts +42 -0
- package/examples/prefab-faq.ts +58 -0
- package/examples/prefab-info-gatherer.ts +33 -0
- package/examples/prefab-receptionist.ts +36 -0
- package/examples/prefab-survey.ts +69 -0
- package/examples/quickstart-agent.ts +29 -0
- package/examples/quickstart-relay.ts +25 -0
- package/examples/quickstart-rest.ts +25 -0
- package/examples/record-call.ts +65 -0
- package/examples/relay-demo.ts +33 -0
- package/examples/room-and-sip.ts +93 -0
- package/examples/serverless-lambda.ts +43 -0
- package/examples/session-state.ts +83 -0
- package/examples/simple-agent.ts +36 -0
- package/examples/simple-static.ts +29 -0
- package/examples/skills-demo.ts +41 -0
- package/examples/step-function-inheritance-demo.ts +124 -0
- package/examples/swaig-features.ts +193 -0
- package/examples/swml-service-routing.ts +66 -0
- package/examples/swml-service.ts +38 -0
- package/examples/swmlservice_ai_sidecar.ts +104 -0
- package/examples/swmlservice_swaig_standalone.ts +79 -0
- package/examples/tap.ts +67 -0
- package/examples/typed-tools.ts +68 -0
- package/examples/verb-methods.ts +45 -0
- package/examples/web-search-multi-instance.ts +75 -0
- package/examples/web-search.ts +38 -0
- package/examples/wikipedia.ts +36 -0
- package/livewire/README.md +164 -0
- package/livewire/docs/migration-guide.md +251 -0
- package/livewire/examples/livewire-basic-agent.ts +74 -0
- package/livewire/examples/livewire-handoff.ts +196 -0
- package/livewire/examples/livewire-multi-tool.ts +121 -0
- package/package.json +88 -13
- package/relay/README.md +101 -0
- package/relay/docs/call-methods.md +622 -0
- package/relay/docs/client-reference.md +281 -0
- package/relay/docs/events.md +193 -0
- package/relay/docs/getting-started.md +221 -0
- package/relay/docs/guide.md +386 -0
- package/relay/docs/messaging.md +246 -0
- package/relay/examples/relay-inbound.ts +66 -0
- package/relay/examples/relay-messaging.ts +74 -0
- package/relay/examples/relay-outbound.ts +76 -0
- package/rest/README.md +141 -0
- package/rest/docs/calling.md +313 -0
- package/rest/docs/client-reference.md +149 -0
- package/rest/docs/fabric.md +192 -0
- package/rest/docs/getting-started.md +138 -0
- package/rest/docs/guide.md +421 -0
- package/rest/docs/namespaces.md +367 -0
- package/rest/docs/phone-binding.md +116 -0
- package/rest/examples/rest-10dlc-registration.ts +177 -0
- package/rest/examples/rest-bind-phone-to-swml-webhook.ts +66 -0
- package/rest/examples/rest-calling-ivr-and-ai.ts +136 -0
- package/rest/examples/rest-calling-play-and-record.ts +98 -0
- package/rest/examples/rest-client.ts +59 -0
- package/rest/examples/rest-datasphere-search.ts +81 -0
- package/rest/examples/rest-fabric-conferences-and-routing.ts +147 -0
- package/rest/examples/rest-fabric-subscribers-and-sip.ts +106 -0
- package/rest/examples/rest-fabric-swml-and-callflows.ts +101 -0
- package/rest/examples/rest-manage-resources.ts +64 -0
- package/rest/examples/rest-phone-number-management.ts +200 -0
- package/rest/examples/rest-queues-mfa-and-recordings.ts +143 -0
- package/rest/examples/rest-video-rooms.ts +186 -0
- package/tutorial/fred/fred.ts +218 -0
- package/tutorial/fred/tutorial/01-introduction.md +141 -0
- package/tutorial/fred/tutorial/02-setup.md +304 -0
- package/tutorial/fred/tutorial/03-basic-agent.md +284 -0
- package/tutorial/fred/tutorial/04-wikipedia-skill.md +298 -0
- package/tutorial/fred/tutorial/05-custom-functions.md +347 -0
- package/tutorial/fred/tutorial/06-running-testing.md +642 -0
- package/tutorial/fred/tutorial/README.md +56 -0
- package/tutorial/fred/tutorial/appendix-complete-code.md +632 -0
- package/tutorial/fred/tutorial/appendix-docker-deployment.md +504 -0
- package/tutorial/full-guardrails-agent/handlers.ts +436 -0
- package/tutorial/full-guardrails-agent/penny.ts +305 -0
- package/tutorial/full-guardrails-agent/reservations.ts +1109 -0
- package/tutorial/full-guardrails-agent/tutorial/01-why-guardrails.md +149 -0
- package/tutorial/full-guardrails-agent/tutorial/02-design-first.md +139 -0
- package/tutorial/full-guardrails-agent/tutorial/03-rules-first.md +422 -0
- package/tutorial/full-guardrails-agent/tutorial/04-the-shell.md +238 -0
- package/tutorial/full-guardrails-agent/tutorial/05-steps-and-scoping.md +247 -0
- package/tutorial/full-guardrails-agent/tutorial/06-tools-that-decide.md +467 -0
- package/tutorial/full-guardrails-agent/tutorial/07-gather-and-projection.md +160 -0
- package/tutorial/full-guardrails-agent/tutorial/08-the-verification-gate.md +333 -0
- package/tutorial/full-guardrails-agent/tutorial/09-people-and-endings.md +313 -0
- package/tutorial/full-guardrails-agent/tutorial/10-testing-and-running.md +387 -0
- package/tutorial/full-guardrails-agent/tutorial/README.md +106 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-complete-code.md +2207 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-deployment.md +191 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-technique-map.md +117 -0
- package/tutorial/full-guardrails-agent/workflow.ts +219 -0
- package/tutorial/multi_agents/README.md +175 -0
- package/tutorial/multi_agents/advanced_agent.ts +395 -0
- package/tutorial/multi_agents/extending_agents.ts +641 -0
- package/tutorial/multi_agents/knowledge.ts +59 -0
- package/tutorial/multi_agents/lesson1_first_agent.md +368 -0
- package/tutorial/multi_agents/lesson2_knowledge_bases.md +404 -0
- package/tutorial/multi_agents/lesson3_multi_agent_systems.md +621 -0
- package/tutorial/multi_agents/lesson4_advanced_features.md +805 -0
- package/tutorial/multi_agents/lesson5_extending_agents.md +856 -0
- package/tutorial/multi_agents/pc_builder.ts +529 -0
- package/tutorial/multi_agents/sales_agent.ts +88 -0
- package/tutorial/multi_agents/sales_agent_with_search.ts +116 -0
- package/tutorial/multi_agents/sales_knowledge.md +139 -0
- package/tutorial/multi_agents/support_knowledge.md +256 -0
- package/dist/cli/mock-data.d.ts +0 -37
- package/dist/cli/mock-data.js +0 -80
- package/dist/cli/mock-data.js.map +0 -1
- package/dist/generateVerbTypes.d.ts +0 -11
- package/dist/generateVerbTypes.js +0 -265
- package/dist/generateVerbTypes.js.map +0 -1
- package/dist/rest/namespaces/compat.d.ts +0 -585
- package/dist/rest/namespaces/compat.js +0 -735
- package/dist/rest/namespaces/compat.js.map +0 -1
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
* additive features.
|
|
8
8
|
*/
|
|
9
9
|
import { AgentBase } from '../AgentBase.js';
|
|
10
|
+
import { CallSessionStore } from './CallSessionStore.js';
|
|
10
11
|
import { FunctionResult } from '../FunctionResult.js';
|
|
11
12
|
// ── Agent ───────────────────────────────────────────────────────────────────
|
|
12
13
|
/**
|
|
@@ -20,6 +21,10 @@ import { FunctionResult } from '../FunctionResult.js';
|
|
|
20
21
|
* ```ts
|
|
21
22
|
* import { ReceptionistAgent } from '@signalwire/sdk';
|
|
22
23
|
*
|
|
24
|
+
* const notifyFrontDesk = async (visitor: Record<string, string>) => {
|
|
25
|
+
* console.log('visitor checked in', visitor);
|
|
26
|
+
* };
|
|
27
|
+
*
|
|
23
28
|
* const agent = new ReceptionistAgent({
|
|
24
29
|
* companyName: 'Acme Co',
|
|
25
30
|
* greeting: 'Thanks for calling Acme! How can I direct your call?',
|
|
@@ -43,7 +48,8 @@ export class ReceptionistAgent extends AgentBase {
|
|
|
43
48
|
companyName;
|
|
44
49
|
checkInEnabled;
|
|
45
50
|
onVisitorCheckInCallback;
|
|
46
|
-
|
|
51
|
+
/** Per-call check-in state, dropped on the call's summary or after an hour idle. */
|
|
52
|
+
sessions = new CallSessionStore();
|
|
47
53
|
/**
|
|
48
54
|
* Create a ReceptionistAgent with the specified departments.
|
|
49
55
|
* @param config - Configuration including departments (name/description/number), greeting, and voice.
|
|
@@ -71,7 +77,7 @@ export class ReceptionistAgent extends AgentBase {
|
|
|
71
77
|
this.buildPrompt();
|
|
72
78
|
this.configureAgentSettings(config.voice ?? 'rime.spore');
|
|
73
79
|
// Register tools after all fields are initialized
|
|
74
|
-
this.
|
|
80
|
+
this.ensureToolsDefined();
|
|
75
81
|
}
|
|
76
82
|
static validateDepartments(departments) {
|
|
77
83
|
if (!Array.isArray(departments) || departments.length === 0) {
|
|
@@ -114,7 +120,7 @@ export class ReceptionistAgent extends AgentBase {
|
|
|
114
120
|
'Use the collect_caller_info function when you have their name and reason for calling.',
|
|
115
121
|
'Use the transfer_call function to transfer them to the appropriate department.',
|
|
116
122
|
"Before transferring, always confirm with the caller that they're being transferred to the right department.",
|
|
117
|
-
|
|
123
|
+
"If a caller's request does not clearly match a department, ask follow-up questions to clarify.",
|
|
118
124
|
];
|
|
119
125
|
if (this.checkInEnabled) {
|
|
120
126
|
instructions.push('If a caller wants to check in as a visitor, collect their full name, purpose of visit, and who they are visiting, then use the check_in_visitor tool.');
|
|
@@ -152,17 +158,12 @@ export class ReceptionistAgent extends AgentBase {
|
|
|
152
158
|
// ── Session helpers ───────────────────────────────────────────────────
|
|
153
159
|
getSession(rawData) {
|
|
154
160
|
const callId = rawData['call_id'] ?? 'default';
|
|
155
|
-
|
|
156
|
-
if (!session) {
|
|
157
|
-
session = { visitors: [] };
|
|
158
|
-
this.sessions.set(callId, session);
|
|
159
|
-
}
|
|
160
|
-
return session;
|
|
161
|
+
return this.sessions.getOrCreate(callId, () => ({ visitors: [] }));
|
|
161
162
|
}
|
|
162
163
|
// ── Tool registration ─────────────────────────────────────────────────
|
|
163
164
|
/**
|
|
164
165
|
* Register the `collect_caller_info` and `transfer_call` SWAIG tools
|
|
165
|
-
* (Python
|
|
166
|
+
* (matching the Python SDK). When `checkInEnabled` is `true`, also registers the
|
|
166
167
|
* TS-specific `check_in_visitor` tool.
|
|
167
168
|
*/
|
|
168
169
|
defineTools() {
|
|
@@ -184,8 +185,8 @@ export class ReceptionistAgent extends AgentBase {
|
|
|
184
185
|
},
|
|
185
186
|
},
|
|
186
187
|
handler: (args) => {
|
|
187
|
-
const name = args
|
|
188
|
-
const reason = args
|
|
188
|
+
const name = args.name ?? '';
|
|
189
|
+
const reason = args.reason ?? '';
|
|
189
190
|
const result = new FunctionResult(`Thank you, ${name}. I've noted that you're calling about ${reason}.`);
|
|
190
191
|
result.addActions([
|
|
191
192
|
{
|
|
@@ -212,12 +213,12 @@ export class ReceptionistAgent extends AgentBase {
|
|
|
212
213
|
},
|
|
213
214
|
},
|
|
214
215
|
},
|
|
215
|
-
handler: (args, rawData) => {
|
|
216
|
-
const departmentName = (args
|
|
216
|
+
handler: this._onCallAgent((self, args, rawData) => {
|
|
217
|
+
const departmentName = (args.department ?? '').trim();
|
|
217
218
|
const globalData = rawData['global_data'] ?? {};
|
|
218
219
|
const callerInfo = globalData['caller_info'] ?? {};
|
|
219
220
|
const name = callerInfo['name'] ?? 'the caller';
|
|
220
|
-
const dept =
|
|
221
|
+
const dept = self.departments.find((d) => d.name === departmentName);
|
|
221
222
|
if (!dept) {
|
|
222
223
|
return new FunctionResult(`Sorry, I couldn't find the ${departmentName} department.`);
|
|
223
224
|
}
|
|
@@ -226,7 +227,7 @@ export class ReceptionistAgent extends AgentBase {
|
|
|
226
227
|
const result = new FunctionResult(`I'll transfer you to our ${departmentName} department now. Thank you for calling, ${name}!`, true);
|
|
227
228
|
result.connect(dept.number, true);
|
|
228
229
|
return result;
|
|
229
|
-
},
|
|
230
|
+
}),
|
|
230
231
|
});
|
|
231
232
|
// Tool: check_in_visitor (TS-specific; only if checkInEnabled)
|
|
232
233
|
if (this.checkInEnabled) {
|
|
@@ -251,10 +252,10 @@ export class ReceptionistAgent extends AgentBase {
|
|
|
251
252
|
},
|
|
252
253
|
required: ['visitor_name', 'purpose', 'visiting'],
|
|
253
254
|
},
|
|
254
|
-
handler: async (args, rawData) => {
|
|
255
|
-
const visitorName = args
|
|
256
|
-
const purpose = args
|
|
257
|
-
const visiting = args
|
|
255
|
+
handler: this._onCallAgent(async (self, args, rawData) => {
|
|
256
|
+
const visitorName = args.visitor_name;
|
|
257
|
+
const purpose = args.purpose;
|
|
258
|
+
const visiting = args.visiting;
|
|
258
259
|
if (!visitorName || !purpose || !visiting) {
|
|
259
260
|
return new FunctionResult("Please provide the visitor's name, purpose of visit, and who they are visiting.");
|
|
260
261
|
}
|
|
@@ -264,30 +265,37 @@ export class ReceptionistAgent extends AgentBase {
|
|
|
264
265
|
visiting,
|
|
265
266
|
checked_in_at: new Date().toISOString(),
|
|
266
267
|
};
|
|
267
|
-
const session =
|
|
268
|
+
const session = self.getSession(rawData);
|
|
268
269
|
session.visitors.push(visitorRecord);
|
|
269
|
-
if (
|
|
270
|
+
if (self.onVisitorCheckInCallback) {
|
|
270
271
|
try {
|
|
271
|
-
await
|
|
272
|
+
await self.onVisitorCheckInCallback(visitorRecord);
|
|
272
273
|
}
|
|
273
274
|
catch (err) {
|
|
274
|
-
|
|
275
|
+
self.log.error(`onVisitorCheckIn callback error: ${err}`);
|
|
275
276
|
}
|
|
276
277
|
}
|
|
277
|
-
const companyPart =
|
|
278
|
+
const companyPart = self.companyName ? ` Welcome to ${self.companyName}!` : '';
|
|
278
279
|
return new FunctionResult(`Visitor checked in successfully! Name: ${visitorName}, Purpose: ${purpose}, Visiting: ${visiting}.${companyPart}`);
|
|
279
|
-
},
|
|
280
|
+
}),
|
|
280
281
|
});
|
|
281
282
|
}
|
|
282
283
|
}
|
|
283
284
|
// ── Lifecycle hooks ───────────────────────────────────────────────────
|
|
284
285
|
/**
|
|
285
|
-
* Python-style receptionist summary hook
|
|
286
|
-
*
|
|
287
|
-
*
|
|
286
|
+
* Python-style receptionist summary hook; subclasses may override to
|
|
287
|
+
* persist the summary. Mirrors Python `on_summary` (receptionist.py lines
|
|
288
|
+
* 278-287), which does nothing.
|
|
289
|
+
*
|
|
290
|
+
* The summary marks the end of the call, so this drops the call's check-in
|
|
291
|
+
* state. A subclass that overrides this hook should call
|
|
292
|
+
* `super.onSummary(summary, rawData)`; otherwise the state is dropped after
|
|
293
|
+
* the call has been idle for an hour.
|
|
288
294
|
*/
|
|
289
|
-
onSummary(_summary,
|
|
290
|
-
|
|
295
|
+
onSummary(_summary, rawData) {
|
|
296
|
+
const callId = rawData?.['call_id'];
|
|
297
|
+
if (typeof callId === 'string')
|
|
298
|
+
this.sessions.delete(callId);
|
|
291
299
|
}
|
|
292
300
|
}
|
|
293
301
|
// ── Factory function ────────────────────────────────────────────────────────
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ReceptionistAgent.js","sourceRoot":"","sources":["../../src/prefabs/ReceptionistAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"ReceptionistAgent.js","sourceRoot":"","sources":["../../src/prefabs/ReceptionistAgent.ts"],"names":[],"mappings":"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"}
|
|
@@ -7,7 +7,9 @@
|
|
|
7
7
|
* `nextQuestion`, answer scoring via `points`) alongside the Python surface.
|
|
8
8
|
*/
|
|
9
9
|
import { AgentBase } from '../AgentBase.js';
|
|
10
|
+
import { FunctionResult } from '../FunctionResult.js';
|
|
10
11
|
import type { AgentOptions } from '../types.js';
|
|
12
|
+
import type { PostPrompt } from '../SwaigContracts.js';
|
|
11
13
|
/** A single survey question consumed by {@link SurveyAgent}. */
|
|
12
14
|
export interface SurveyQuestion {
|
|
13
15
|
/** Unique question identifier. */
|
|
@@ -81,8 +83,8 @@ export interface SurveyConfig {
|
|
|
81
83
|
* brandName: 'Acme Co',
|
|
82
84
|
* questions: [
|
|
83
85
|
* { id: 'q1', text: 'How satisfied were you with our service?', type: 'rating', scale: 5 },
|
|
84
|
-
* { id: 'q2', text: 'Would you recommend us to a friend?', type: '
|
|
85
|
-
* { id: 'q3', text: 'Anything else you want to share?', type: '
|
|
86
|
+
* { id: 'q2', text: 'Would you recommend us to a friend?', type: 'yes_no' },
|
|
87
|
+
* { id: 'q3', text: 'Anything else you want to share?', type: 'open_ended' },
|
|
86
88
|
* ],
|
|
87
89
|
* });
|
|
88
90
|
*
|
|
@@ -104,6 +106,7 @@ export declare class SurveyAgent extends AgentBase {
|
|
|
104
106
|
conclusion: string;
|
|
105
107
|
private questionMap;
|
|
106
108
|
private onCompleteCallback?;
|
|
109
|
+
/** Per-call state, dropped on the call's summary or after an hour idle. */
|
|
107
110
|
private sessions;
|
|
108
111
|
/**
|
|
109
112
|
* Create a SurveyAgent with the specified questions and callbacks.
|
|
@@ -124,10 +127,20 @@ export declare class SurveyAgent extends AgentBase {
|
|
|
124
127
|
private normalizeAnswer;
|
|
125
128
|
/**
|
|
126
129
|
* Register SWAIG tools:
|
|
127
|
-
* - Python
|
|
130
|
+
* - Tools matching the Python SDK: `validate_response`, `log_response`
|
|
128
131
|
* - TS-specific session tools: `answer_question`, `get_current_question`, `get_survey_progress`
|
|
129
132
|
*/
|
|
130
133
|
protected defineTools(): void;
|
|
134
|
+
/**
|
|
135
|
+
* SWAIG handler for `validate_response`: check whether a response satisfies a
|
|
136
|
+
* question's type/constraints. Mirrors Python `SurveyAgent.validate_response`.
|
|
137
|
+
*/
|
|
138
|
+
validateResponse(args: Record<string, unknown>, _rawData: Record<string, unknown>): FunctionResult;
|
|
139
|
+
/**
|
|
140
|
+
* SWAIG handler for `log_response`: record a validated response on the per-call
|
|
141
|
+
* session. Mirrors Python `SurveyAgent.log_response`.
|
|
142
|
+
*/
|
|
143
|
+
logResponse(args: Record<string, unknown>, rawData: Record<string, unknown>): FunctionResult;
|
|
131
144
|
/**
|
|
132
145
|
* Process the survey results summary returned at the end of a call.
|
|
133
146
|
* Mirrors Python `on_summary`: structured (dict-like) summaries are logged
|
|
@@ -136,8 +149,13 @@ export declare class SurveyAgent extends AgentBase {
|
|
|
136
149
|
* The parameter type widens the base `AgentBase.onSummary` signature to
|
|
137
150
|
* accept string payloads as well, matching Python's `isinstance(summary, dict)`
|
|
138
151
|
* branch even though the current framework only surfaces object summaries.
|
|
152
|
+
*
|
|
153
|
+
* The summary marks the end of the call, so this also drops the call's
|
|
154
|
+
* per-call survey state. A subclass that overrides this hook should call
|
|
155
|
+
* `super.onSummary(summary, rawData)`; otherwise the state is dropped after
|
|
156
|
+
* the call has been idle for an hour.
|
|
139
157
|
*/
|
|
140
|
-
onSummary(summary: Record<string, unknown> | string | null,
|
|
158
|
+
onSummary(summary: Record<string, unknown> | string | null, rawData: PostPrompt): void | Promise<void>;
|
|
141
159
|
}
|
|
142
160
|
/**
|
|
143
161
|
* Factory function that creates and returns a new SurveyAgent.
|
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
* `nextQuestion`, answer scoring via `points`) alongside the Python surface.
|
|
8
8
|
*/
|
|
9
9
|
import { AgentBase } from '../AgentBase.js';
|
|
10
|
+
import { CallSessionStore } from './CallSessionStore.js';
|
|
10
11
|
import { FunctionResult } from '../FunctionResult.js';
|
|
11
12
|
// ── Agent ───────────────────────────────────────────────────────────────────
|
|
12
13
|
/**
|
|
@@ -25,8 +26,8 @@ import { FunctionResult } from '../FunctionResult.js';
|
|
|
25
26
|
* brandName: 'Acme Co',
|
|
26
27
|
* questions: [
|
|
27
28
|
* { id: 'q1', text: 'How satisfied were you with our service?', type: 'rating', scale: 5 },
|
|
28
|
-
* { id: 'q2', text: 'Would you recommend us to a friend?', type: '
|
|
29
|
-
* { id: 'q3', text: 'Anything else you want to share?', type: '
|
|
29
|
+
* { id: 'q2', text: 'Would you recommend us to a friend?', type: 'yes_no' },
|
|
30
|
+
* { id: 'q3', text: 'Anything else you want to share?', type: 'open_ended' },
|
|
30
31
|
* ],
|
|
31
32
|
* });
|
|
32
33
|
*
|
|
@@ -48,7 +49,8 @@ export class SurveyAgent extends AgentBase {
|
|
|
48
49
|
conclusion;
|
|
49
50
|
questionMap;
|
|
50
51
|
onCompleteCallback;
|
|
51
|
-
|
|
52
|
+
/** Per-call state, dropped on the call's summary or after an hour idle. */
|
|
53
|
+
sessions = new CallSessionStore();
|
|
52
54
|
/**
|
|
53
55
|
* Create a SurveyAgent with the specified questions and callbacks.
|
|
54
56
|
* @param config - Configuration including questions, messages, and completion callback.
|
|
@@ -67,7 +69,8 @@ export class SurveyAgent extends AgentBase {
|
|
|
67
69
|
this.brandName = config.brandName ?? 'Our Company';
|
|
68
70
|
this.maxRetries = config.maxRetries ?? 2;
|
|
69
71
|
this.introduction =
|
|
70
|
-
config.introduction ??
|
|
72
|
+
config.introduction ??
|
|
73
|
+
`Welcome to our ${config.surveyName}. We appreciate your participation.`;
|
|
71
74
|
this.conclusion =
|
|
72
75
|
config.conclusion ?? 'Thank you for completing our survey. Your feedback is valuable to us.';
|
|
73
76
|
this.onCompleteCallback = config.onComplete;
|
|
@@ -76,13 +79,13 @@ export class SurveyAgent extends AgentBase {
|
|
|
76
79
|
this.questionMap = new Map(this.questions.map((q) => [q.id, q]));
|
|
77
80
|
this.setupSurveyAgent();
|
|
78
81
|
// Register tools after all fields are initialized
|
|
79
|
-
this.
|
|
82
|
+
this.ensureToolsDefined();
|
|
80
83
|
}
|
|
81
84
|
// ── Question validation (mirrors Python _validate_questions) ──────────
|
|
82
85
|
validateQuestions() {
|
|
83
86
|
const validTypes = new Set(['rating', 'multiple_choice', 'yes_no', 'open_ended']);
|
|
84
87
|
for (let i = 0; i < this.questions.length; i++) {
|
|
85
|
-
const q = this.questions[i];
|
|
88
|
+
const q = this.questions[i]; // i < length, so always in-bounds
|
|
86
89
|
if (!q.id)
|
|
87
90
|
q.id = `question_${i + 1}`;
|
|
88
91
|
if (!q.text)
|
|
@@ -193,25 +196,22 @@ export class SurveyAgent extends AgentBase {
|
|
|
193
196
|
// ── Session helpers ───────────────────────────────────────────────────
|
|
194
197
|
getSession(rawData) {
|
|
195
198
|
const callId = rawData['call_id'] ?? 'default';
|
|
196
|
-
|
|
197
|
-
if (!session) {
|
|
199
|
+
return this.sessions.getOrCreate(callId, () => {
|
|
198
200
|
const firstQuestion = this.questions[0];
|
|
199
|
-
|
|
201
|
+
return {
|
|
200
202
|
currentQuestionIndex: 0,
|
|
201
203
|
currentQuestionId: firstQuestion ? firstQuestion.id : '',
|
|
202
204
|
responses: {},
|
|
203
205
|
score: 0,
|
|
204
206
|
completed: false,
|
|
205
207
|
};
|
|
206
|
-
|
|
207
|
-
}
|
|
208
|
-
return session;
|
|
208
|
+
});
|
|
209
209
|
}
|
|
210
210
|
resolveNextQuestion(question, answer) {
|
|
211
211
|
if (!question.nextQuestion) {
|
|
212
212
|
const idx = this.questions.findIndex((q) => q.id === question.id);
|
|
213
213
|
if (idx >= 0 && idx < this.questions.length - 1) {
|
|
214
|
-
return this.questions[idx + 1].id;
|
|
214
|
+
return this.questions[idx + 1].id; // idx+1 < length, in-bounds
|
|
215
215
|
}
|
|
216
216
|
return null;
|
|
217
217
|
}
|
|
@@ -229,7 +229,7 @@ export class SurveyAgent extends AgentBase {
|
|
|
229
229
|
}
|
|
230
230
|
const idx = this.questions.findIndex((q) => q.id === question.id);
|
|
231
231
|
if (idx >= 0 && idx < this.questions.length - 1) {
|
|
232
|
-
return this.questions[idx + 1].id;
|
|
232
|
+
return this.questions[idx + 1].id; // idx+1 < length, in-bounds
|
|
233
233
|
}
|
|
234
234
|
return null;
|
|
235
235
|
}
|
|
@@ -302,7 +302,7 @@ export class SurveyAgent extends AgentBase {
|
|
|
302
302
|
// ── Tool registration ─────────────────────────────────────────────────
|
|
303
303
|
/**
|
|
304
304
|
* Register SWAIG tools:
|
|
305
|
-
* - Python
|
|
305
|
+
* - Tools matching the Python SDK: `validate_response`, `log_response`
|
|
306
306
|
* - TS-specific session tools: `answer_question`, `get_current_question`, `get_survey_progress`
|
|
307
307
|
*/
|
|
308
308
|
defineTools() {
|
|
@@ -323,18 +323,7 @@ export class SurveyAgent extends AgentBase {
|
|
|
323
323
|
},
|
|
324
324
|
},
|
|
325
325
|
},
|
|
326
|
-
handler: (args) =>
|
|
327
|
-
const questionId = args['question_id'] ?? '';
|
|
328
|
-
const response = args['response'] ?? '';
|
|
329
|
-
const question = this.questionMap.get(questionId);
|
|
330
|
-
if (!question) {
|
|
331
|
-
return new FunctionResult(`Error: Question with ID '${questionId}' not found.`);
|
|
332
|
-
}
|
|
333
|
-
const error = this.validateAnswer(question, response);
|
|
334
|
-
if (error)
|
|
335
|
-
return new FunctionResult(error);
|
|
336
|
-
return new FunctionResult(`Response to '${questionId}' is valid.`);
|
|
337
|
-
},
|
|
326
|
+
handler: this._onCallAgent((self, args, rawData) => self.validateResponse(args, rawData)),
|
|
338
327
|
});
|
|
339
328
|
// Tool: log_response (Python parity — acknowledge recording)
|
|
340
329
|
this.defineTool({
|
|
@@ -353,18 +342,7 @@ export class SurveyAgent extends AgentBase {
|
|
|
353
342
|
},
|
|
354
343
|
},
|
|
355
344
|
},
|
|
356
|
-
handler: (args, rawData) =>
|
|
357
|
-
const questionId = args['question_id'] ?? '';
|
|
358
|
-
const response = args['response'] ?? '';
|
|
359
|
-
const question = this.questionMap.get(questionId);
|
|
360
|
-
const questionText = question ? question.text : '';
|
|
361
|
-
// Record on the per-call session for observability.
|
|
362
|
-
const session = this.getSession(rawData);
|
|
363
|
-
if (question) {
|
|
364
|
-
session.responses[questionId] = this.normalizeAnswer(question, response);
|
|
365
|
-
}
|
|
366
|
-
return new FunctionResult(`Response to '${questionText}' has been recorded.`);
|
|
367
|
-
},
|
|
345
|
+
handler: this._onCallAgent((self, args, rawData) => self.logResponse(args, rawData)),
|
|
368
346
|
});
|
|
369
347
|
// Tool: answer_question (TS-specific atomic validate+record+advance)
|
|
370
348
|
this.defineTool({
|
|
@@ -384,45 +362,45 @@ export class SurveyAgent extends AgentBase {
|
|
|
384
362
|
},
|
|
385
363
|
required: ['question_id', 'answer'],
|
|
386
364
|
},
|
|
387
|
-
handler: async (args, rawData) => {
|
|
388
|
-
const questionId = args
|
|
389
|
-
const answer = args
|
|
365
|
+
handler: this._onCallAgent(async (self, args, rawData) => {
|
|
366
|
+
const questionId = args.question_id;
|
|
367
|
+
const answer = args.answer;
|
|
390
368
|
if (!questionId || !answer) {
|
|
391
369
|
return new FunctionResult('Both question_id and answer are required.');
|
|
392
370
|
}
|
|
393
|
-
const question =
|
|
371
|
+
const question = self.questionMap.get(questionId);
|
|
394
372
|
if (!question) {
|
|
395
373
|
return new FunctionResult(`Unknown question ID "${questionId}".`);
|
|
396
374
|
}
|
|
397
|
-
const session =
|
|
375
|
+
const session = self.getSession(rawData);
|
|
398
376
|
if (session.completed) {
|
|
399
377
|
return new FunctionResult('The survey has already been completed.');
|
|
400
378
|
}
|
|
401
|
-
const validationError =
|
|
379
|
+
const validationError = self.validateAnswer(question, answer);
|
|
402
380
|
if (validationError) {
|
|
403
381
|
return new FunctionResult(validationError);
|
|
404
382
|
}
|
|
405
|
-
const normalizedAnswer =
|
|
383
|
+
const normalizedAnswer = self.normalizeAnswer(question, answer);
|
|
406
384
|
session.responses[questionId] = normalizedAnswer;
|
|
407
|
-
const points =
|
|
385
|
+
const points = self.calculatePoints(question, normalizedAnswer);
|
|
408
386
|
session.score += points;
|
|
409
|
-
const nextId =
|
|
410
|
-
if (!nextId || !
|
|
387
|
+
const nextId = self.resolveNextQuestion(question, normalizedAnswer);
|
|
388
|
+
if (!nextId || !self.questionMap.has(nextId)) {
|
|
411
389
|
session.completed = true;
|
|
412
|
-
if (
|
|
390
|
+
if (self.onCompleteCallback) {
|
|
413
391
|
try {
|
|
414
|
-
await
|
|
392
|
+
await self.onCompleteCallback({ ...session.responses }, session.score);
|
|
415
393
|
}
|
|
416
394
|
catch (err) {
|
|
417
|
-
|
|
395
|
+
self.log.error(`onComplete callback error: ${err}`);
|
|
418
396
|
}
|
|
419
397
|
}
|
|
420
398
|
const answeredCount = Object.keys(session.responses).length;
|
|
421
|
-
return new FunctionResult(`Answer recorded. The survey is now complete! ${answeredCount} questions answered, total score: ${session.score}. ${
|
|
399
|
+
return new FunctionResult(`Answer recorded. The survey is now complete! ${answeredCount} questions answered, total score: ${session.score}. ${self.conclusion}`);
|
|
422
400
|
}
|
|
423
401
|
session.currentQuestionId = nextId;
|
|
424
|
-
const nextQ =
|
|
425
|
-
const nextIdx =
|
|
402
|
+
const nextQ = self.questionMap.get(nextId);
|
|
403
|
+
const nextIdx = self.questions.findIndex((q) => q.id === nextId);
|
|
426
404
|
if (nextIdx >= 0)
|
|
427
405
|
session.currentQuestionIndex = nextIdx;
|
|
428
406
|
let nextInfo = `Answer recorded. Next question [${nextQ.id}]: "${nextQ.text}"`;
|
|
@@ -436,7 +414,7 @@ export class SurveyAgent extends AgentBase {
|
|
|
436
414
|
nextInfo += ' (Yes/No)';
|
|
437
415
|
}
|
|
438
416
|
return new FunctionResult(nextInfo);
|
|
439
|
-
},
|
|
417
|
+
}),
|
|
440
418
|
});
|
|
441
419
|
// Tool: get_current_question
|
|
442
420
|
this.defineTool({
|
|
@@ -446,12 +424,12 @@ export class SurveyAgent extends AgentBase {
|
|
|
446
424
|
type: 'object',
|
|
447
425
|
properties: {},
|
|
448
426
|
},
|
|
449
|
-
handler: (_args, rawData) => {
|
|
450
|
-
const session =
|
|
427
|
+
handler: this._onCallAgent((self, _args, rawData) => {
|
|
428
|
+
const session = self.getSession(rawData);
|
|
451
429
|
if (session.completed) {
|
|
452
430
|
return new FunctionResult('The survey has been completed. No more questions.');
|
|
453
431
|
}
|
|
454
|
-
const question =
|
|
432
|
+
const question = self.questionMap.get(session.currentQuestionId);
|
|
455
433
|
if (!question) {
|
|
456
434
|
return new FunctionResult('No current question available.');
|
|
457
435
|
}
|
|
@@ -466,7 +444,7 @@ export class SurveyAgent extends AgentBase {
|
|
|
466
444
|
info += ' (Caller should answer yes or no)';
|
|
467
445
|
}
|
|
468
446
|
return new FunctionResult(info);
|
|
469
|
-
},
|
|
447
|
+
}),
|
|
470
448
|
});
|
|
471
449
|
// Tool: get_survey_progress
|
|
472
450
|
this.defineTool({
|
|
@@ -476,10 +454,10 @@ export class SurveyAgent extends AgentBase {
|
|
|
476
454
|
type: 'object',
|
|
477
455
|
properties: {},
|
|
478
456
|
},
|
|
479
|
-
handler: (_args, rawData) => {
|
|
480
|
-
const session =
|
|
457
|
+
handler: this._onCallAgent((self, _args, rawData) => {
|
|
458
|
+
const session = self.getSession(rawData);
|
|
481
459
|
const answeredCount = Object.keys(session.responses).length;
|
|
482
|
-
const totalCount =
|
|
460
|
+
const totalCount = self.questions.length;
|
|
483
461
|
const percentage = totalCount > 0 ? Math.round((answeredCount / totalCount) * 100) : 0;
|
|
484
462
|
let progress = `Survey progress: ${answeredCount}/${totalCount} questions answered (${percentage}%). Current score: ${session.score}.`;
|
|
485
463
|
if (session.completed) {
|
|
@@ -495,9 +473,42 @@ export class SurveyAgent extends AgentBase {
|
|
|
495
473
|
progress += ` Answers so far: ${answered}`;
|
|
496
474
|
}
|
|
497
475
|
return new FunctionResult(progress);
|
|
498
|
-
},
|
|
476
|
+
}),
|
|
499
477
|
});
|
|
500
478
|
}
|
|
479
|
+
// ── SWAIG tool handlers (named methods, mirroring the Python prefab) ───
|
|
480
|
+
/**
|
|
481
|
+
* SWAIG handler for `validate_response`: check whether a response satisfies a
|
|
482
|
+
* question's type/constraints. Mirrors Python `SurveyAgent.validate_response`.
|
|
483
|
+
*/
|
|
484
|
+
validateResponse(args, _rawData) {
|
|
485
|
+
const questionId = args['question_id'] ?? '';
|
|
486
|
+
const response = args['response'] ?? '';
|
|
487
|
+
const question = this.questionMap.get(questionId);
|
|
488
|
+
if (!question) {
|
|
489
|
+
return new FunctionResult(`Error: Question with ID '${questionId}' not found.`);
|
|
490
|
+
}
|
|
491
|
+
const error = this.validateAnswer(question, response);
|
|
492
|
+
if (error)
|
|
493
|
+
return new FunctionResult(error);
|
|
494
|
+
return new FunctionResult(`Response to '${questionId}' is valid.`);
|
|
495
|
+
}
|
|
496
|
+
/**
|
|
497
|
+
* SWAIG handler for `log_response`: record a validated response on the per-call
|
|
498
|
+
* session. Mirrors Python `SurveyAgent.log_response`.
|
|
499
|
+
*/
|
|
500
|
+
logResponse(args, rawData) {
|
|
501
|
+
const questionId = args['question_id'] ?? '';
|
|
502
|
+
const response = args['response'] ?? '';
|
|
503
|
+
const question = this.questionMap.get(questionId);
|
|
504
|
+
const questionText = question ? question.text : '';
|
|
505
|
+
// Record on the per-call session for observability.
|
|
506
|
+
const session = this.getSession(rawData);
|
|
507
|
+
if (question) {
|
|
508
|
+
session.responses[questionId] = this.normalizeAnswer(question, response);
|
|
509
|
+
}
|
|
510
|
+
return new FunctionResult(`Response to '${questionText}' has been recorded.`);
|
|
511
|
+
}
|
|
501
512
|
// ── Lifecycle hooks ───────────────────────────────────────────────────
|
|
502
513
|
/**
|
|
503
514
|
* Process the survey results summary returned at the end of a call.
|
|
@@ -507,21 +518,26 @@ export class SurveyAgent extends AgentBase {
|
|
|
507
518
|
* The parameter type widens the base `AgentBase.onSummary` signature to
|
|
508
519
|
* accept string payloads as well, matching Python's `isinstance(summary, dict)`
|
|
509
520
|
* branch even though the current framework only surfaces object summaries.
|
|
521
|
+
*
|
|
522
|
+
* The summary marks the end of the call, so this also drops the call's
|
|
523
|
+
* per-call survey state. A subclass that overrides this hook should call
|
|
524
|
+
* `super.onSummary(summary, rawData)`; otherwise the state is dropped after
|
|
525
|
+
* the call has been idle for an hour.
|
|
510
526
|
*/
|
|
511
|
-
onSummary(summary,
|
|
527
|
+
onSummary(summary, rawData) {
|
|
528
|
+
const callId = rawData?.['call_id'];
|
|
529
|
+
if (typeof callId === 'string')
|
|
530
|
+
this.sessions.delete(callId);
|
|
512
531
|
if (summary) {
|
|
513
532
|
try {
|
|
514
533
|
if (typeof summary === 'string') {
|
|
515
|
-
// eslint-disable-next-line no-console
|
|
516
534
|
console.log(`Survey summary (unstructured): ${summary}`);
|
|
517
535
|
}
|
|
518
536
|
else {
|
|
519
|
-
// eslint-disable-next-line no-console
|
|
520
537
|
console.log(`Survey completed: ${JSON.stringify(summary, null, 2)}`);
|
|
521
538
|
}
|
|
522
539
|
}
|
|
523
540
|
catch (err) {
|
|
524
|
-
// eslint-disable-next-line no-console
|
|
525
541
|
console.log(`Error processing survey summary: ${String(err)}`);
|
|
526
542
|
}
|
|
527
543
|
}
|