@signalwire/sdk 2.0.1 → 2.0.3
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/{src/index.ts → dist/index.d.ts} +13 -100
- 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 +1026 -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/dist/rest/index.d.ts +131 -0
- package/{src/rest/index.ts → dist/rest/index.js} +101 -136
- 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/{src/rest/pagination.ts → dist/rest/pagination.d.ts} +2 -61
- 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 -2598
- package/src/AgentServer.ts +0 -442
- package/src/AuthHandler.ts +0 -256
- package/src/ConfigLoader.ts +0 -447
- package/src/ContextBuilder.ts +0 -1181
- package/src/DataMap.ts +0 -477
- package/src/FunctionResult.ts +0 -903
- package/src/Logger.ts +0 -337
- package/src/PomBuilder.ts +0 -467
- package/src/PromptManager.ts +0 -133
- package/src/SWMLHandler.ts +0 -298
- package/src/SWMLService.ts +0 -749
- package/src/SchemaUtils.ts +0 -361
- package/src/ServerlessAdapter.ts +0 -240
- package/src/SessionManager.ts +0 -311
- package/src/SslConfig.ts +0 -118
- package/src/SwaigFunction.ts +0 -276
- package/src/SwmlBuilder.ts +0 -283
- package/src/SwmlVerbMethods.generated.ts +0 -234
- package/src/TypeInference.ts +0 -199
- package/src/WebService.ts +0 -641
- 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/livewire/index.ts +0 -1252
- package/src/prefabs/ConciergeAgent.ts +0 -309
- package/src/prefabs/FAQBotAgent.ts +0 -415
- package/src/prefabs/InfoGathererAgent.ts +0 -379
- package/src/prefabs/ReceptionistAgent.ts +0 -395
- package/src/prefabs/SurveyAgent.ts +0 -671
- package/src/relay/Action.ts +0 -482
- package/src/relay/Call.ts +0 -1270
- package/src/relay/Deferred.ts +0 -94
- package/src/relay/Message.ts +0 -199
- package/src/relay/RelayClient.ts +0 -1185
- package/src/relay/RelayError.ts +0 -20
- package/src/relay/RelayEvent.ts +0 -944
- package/src/relay/index.ts +0 -123
- package/src/relay/types.ts +0 -149
- package/src/rest/HttpClient.ts +0 -164
- package/src/rest/RestError.ts +0 -45
- package/src/rest/base/BaseResource.ts +0 -32
- package/src/rest/base/CrudResource.ts +0 -98
- package/src/rest/base/CrudWithAddresses.ts +0 -37
- package/src/rest/namespaces/addresses.ts +0 -64
- package/src/rest/namespaces/calling.ts +0 -534
- package/src/rest/namespaces/chat.ts +0 -31
- package/src/rest/namespaces/compat.ts +0 -812
- package/src/rest/namespaces/datasphere.ts +0 -88
- package/src/rest/namespaces/fabric.ts +0 -417
- package/src/rest/namespaces/imported-numbers.ts +0 -31
- package/src/rest/namespaces/logs.ts +0 -151
- package/src/rest/namespaces/lookup.ts +0 -38
- package/src/rest/namespaces/mfa.ts +0 -61
- package/src/rest/namespaces/number-groups.ts +0 -68
- package/src/rest/namespaces/phone-numbers.ts +0 -76
- package/src/rest/namespaces/project.ts +0 -65
- package/src/rest/namespaces/pubsub.ts +0 -31
- package/src/rest/namespaces/queues.ts +0 -58
- package/src/rest/namespaces/recordings.ts +0 -53
- package/src/rest/namespaces/registry.ts +0 -200
- package/src/rest/namespaces/short-codes.ts +0 -54
- package/src/rest/namespaces/sip-profile.ts +0 -40
- package/src/rest/namespaces/verified-callers.ts +0 -46
- package/src/rest/namespaces/video.ts +0 -332
- package/src/rest/types.ts +0 -61
- package/src/skills/SkillBase.ts +0 -582
- package/src/skills/SkillManager.ts +0 -419
- package/src/skills/SkillRegistry.ts +0 -367
- package/src/skills/builtin/api_ninjas_trivia.ts +0 -285
- package/src/skills/builtin/ask_claude.ts +0 -246
- package/src/skills/builtin/claude_skills.ts +0 -983
- package/src/skills/builtin/custom_skills.ts +0 -327
- package/src/skills/builtin/datasphere.ts +0 -447
- package/src/skills/builtin/datasphere_serverless.ts +0 -347
- package/src/skills/builtin/datetime.ts +0 -137
- package/src/skills/builtin/google_maps.ts +0 -656
- package/src/skills/builtin/info_gatherer.ts +0 -415
- package/src/skills/builtin/joke.ts +0 -196
- package/src/skills/builtin/math.ts +0 -149
- package/src/skills/builtin/mcp_gateway.ts +0 -685
- package/src/skills/builtin/native_vector_search.ts +0 -910
- package/src/skills/builtin/play_background_file.ts +0 -367
- package/src/skills/builtin/spider.ts +0 -874
- package/src/skills/builtin/swml_transfer.ts +0 -645
- package/src/skills/builtin/weather_api.ts +0 -255
- package/src/skills/builtin/web_search.ts +0 -1083
- package/src/skills/builtin/wikipedia_search.ts +0 -304
- 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
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* DataSphere Serverless Skill - Searches SignalWire DataSphere using a DataMap.
|
|
3
|
+
*
|
|
4
|
+
* Tier 3 built-in skill. Matches the Python SDK's param-driven design: all
|
|
5
|
+
* credentials (`space_name`, `project_id`, `token`) are supplied via skill
|
|
6
|
+
* params. At `setup()` time the skill resolves these params, composes the
|
|
7
|
+
* full DataSphere API URL and a base64 Basic-auth header, and bakes both as
|
|
8
|
+
* literal values into the emitted DataMap SWAIG JSON (mirrors Python
|
|
9
|
+
* `skills/datasphere_serverless/skill.py:152-157, 182-201`).
|
|
10
|
+
*/
|
|
11
|
+
import { SkillBase } from '../SkillBase.js';
|
|
12
|
+
import { FunctionResult } from '../../FunctionResult.js';
|
|
13
|
+
import { DataMap } from '../../DataMap.js';
|
|
14
|
+
import { getLogger } from '../../Logger.js';
|
|
15
|
+
const log = getLogger('DataSphereServerlessSkill');
|
|
16
|
+
const DEFAULT_NO_RESULTS_MESSAGE = "I couldn't find any relevant information for '{query}' in the knowledge base. " +
|
|
17
|
+
'Try rephrasing your question or asking about a different topic.';
|
|
18
|
+
/**
|
|
19
|
+
* Searches SignalWire DataSphere using a server-side DataMap for serverless execution.
|
|
20
|
+
*
|
|
21
|
+
* Tier 3 built-in skill that generates a DataMap configuration SignalWire
|
|
22
|
+
* executes directly, without a webhook endpoint. Supports `document_id`,
|
|
23
|
+
* `count`, `distance`, `tags`, `language`, `pos_to_expand`, `max_synonyms`,
|
|
24
|
+
* and `no_results_message` config options.
|
|
25
|
+
*
|
|
26
|
+
* @example
|
|
27
|
+
* ```ts
|
|
28
|
+
* agent.addSkill('datasphere_serverless', {
|
|
29
|
+
* document_id: 'doc_abc123',
|
|
30
|
+
* count: 3,
|
|
31
|
+
* });
|
|
32
|
+
* ```
|
|
33
|
+
*/
|
|
34
|
+
export class DataSphereServerlessSkill extends SkillBase {
|
|
35
|
+
// Python ground truth: skills/datasphere_serverless/skill.py:20-28
|
|
36
|
+
static SKILL_NAME = 'datasphere_serverless';
|
|
37
|
+
static SKILL_DESCRIPTION = 'Search knowledge using SignalWire DataSphere with serverless DataMap execution';
|
|
38
|
+
static SKILL_VERSION = '1.0.0';
|
|
39
|
+
static REQUIRED_PACKAGES = [];
|
|
40
|
+
static REQUIRED_ENV_VARS = [];
|
|
41
|
+
static SUPPORTS_MULTIPLE_INSTANCES = true;
|
|
42
|
+
static getParameterSchema() {
|
|
43
|
+
return {
|
|
44
|
+
...super.getParameterSchema(),
|
|
45
|
+
tool_name: {
|
|
46
|
+
type: 'string',
|
|
47
|
+
description: 'Custom tool name for this DataSphere Serverless instance.',
|
|
48
|
+
default: 'search_knowledge',
|
|
49
|
+
},
|
|
50
|
+
space_name: {
|
|
51
|
+
type: 'string',
|
|
52
|
+
description: "SignalWire space name (e.g., 'mycompany' from mycompany.signalwire.com)",
|
|
53
|
+
required: true,
|
|
54
|
+
},
|
|
55
|
+
project_id: {
|
|
56
|
+
type: 'string',
|
|
57
|
+
description: 'SignalWire project ID',
|
|
58
|
+
required: true,
|
|
59
|
+
env_var: 'SIGNALWIRE_PROJECT_ID',
|
|
60
|
+
},
|
|
61
|
+
token: {
|
|
62
|
+
type: 'string',
|
|
63
|
+
description: 'SignalWire API token',
|
|
64
|
+
required: true,
|
|
65
|
+
hidden: true,
|
|
66
|
+
env_var: 'SIGNALWIRE_TOKEN',
|
|
67
|
+
},
|
|
68
|
+
document_id: {
|
|
69
|
+
type: 'string',
|
|
70
|
+
description: 'DataSphere document ID to search within',
|
|
71
|
+
required: true,
|
|
72
|
+
},
|
|
73
|
+
count: {
|
|
74
|
+
type: 'integer',
|
|
75
|
+
description: 'Number of search results to return',
|
|
76
|
+
default: 1,
|
|
77
|
+
min: 1,
|
|
78
|
+
max: 10,
|
|
79
|
+
},
|
|
80
|
+
distance: {
|
|
81
|
+
type: 'number',
|
|
82
|
+
description: 'Maximum distance threshold for results (lower is more relevant)',
|
|
83
|
+
default: 3.0,
|
|
84
|
+
min: 0,
|
|
85
|
+
max: 10,
|
|
86
|
+
},
|
|
87
|
+
tags: {
|
|
88
|
+
type: 'array',
|
|
89
|
+
description: 'Tags to filter search results',
|
|
90
|
+
items: { type: 'string' },
|
|
91
|
+
},
|
|
92
|
+
language: {
|
|
93
|
+
type: 'string',
|
|
94
|
+
description: "Language code for query expansion (e.g., 'en', 'es')",
|
|
95
|
+
},
|
|
96
|
+
pos_to_expand: {
|
|
97
|
+
type: 'array',
|
|
98
|
+
description: 'Parts of speech to expand with synonyms',
|
|
99
|
+
items: { type: 'string', enum: ['NOUN', 'VERB', 'ADJ', 'ADV'] },
|
|
100
|
+
},
|
|
101
|
+
max_synonyms: {
|
|
102
|
+
type: 'integer',
|
|
103
|
+
description: 'Maximum number of synonyms to use for query expansion',
|
|
104
|
+
min: 1,
|
|
105
|
+
max: 10,
|
|
106
|
+
},
|
|
107
|
+
no_results_message: {
|
|
108
|
+
type: 'string',
|
|
109
|
+
description: 'Message to return when no results are found',
|
|
110
|
+
default: DEFAULT_NO_RESULTS_MESSAGE,
|
|
111
|
+
},
|
|
112
|
+
};
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* Instance key for the SkillManager. Defaults to
|
|
116
|
+
* `datasphere_serverless_search_knowledge`, matching the Python SDK default.
|
|
117
|
+
* When `tool_name` is set, uses `datasphere_serverless_<tool_name>`.
|
|
118
|
+
*/
|
|
119
|
+
getInstanceKey() {
|
|
120
|
+
const toolName = this.getConfig('tool_name', 'search_knowledge');
|
|
121
|
+
return `${this.skillName}_${toolName}`;
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Validate required configuration parameters before the skill becomes active.
|
|
125
|
+
*
|
|
126
|
+
* Mirrors Python's `setup()` which checks `space_name`, `project_id`, `token`,
|
|
127
|
+
* and `document_id` and returns `False` (logging an error) if any are absent.
|
|
128
|
+
* @returns `true` if all required params are present, `false` otherwise.
|
|
129
|
+
*/
|
|
130
|
+
async setup() {
|
|
131
|
+
const requiredParams = ['space_name', 'project_id', 'token', 'document_id'];
|
|
132
|
+
const missing = requiredParams.filter((param) => !this.getConfig(param, undefined));
|
|
133
|
+
if (missing.length > 0) {
|
|
134
|
+
log.error('datasphere_serverless: missing required parameters', { missing });
|
|
135
|
+
return false;
|
|
136
|
+
}
|
|
137
|
+
return true;
|
|
138
|
+
}
|
|
139
|
+
/**
|
|
140
|
+
* Global data injected into the agent's SWML/SWAIG context. Matches
|
|
141
|
+
* Python's `get_global_data()` shape so downstream consumers can
|
|
142
|
+
* detect DataSphere availability.
|
|
143
|
+
*/
|
|
144
|
+
getGlobalData() {
|
|
145
|
+
return {
|
|
146
|
+
datasphere_serverless_enabled: true,
|
|
147
|
+
document_id: this.getConfig('document_id', undefined),
|
|
148
|
+
knowledge_provider: 'SignalWire DataSphere (Serverless)',
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* Resolve the tool name used in DataMap registration. Defaults to
|
|
153
|
+
* `search_knowledge` to match the Python SDK default.
|
|
154
|
+
*/
|
|
155
|
+
getToolName() {
|
|
156
|
+
return this.getConfig('tool_name', 'search_knowledge');
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* Build the DataMap-based SWAIG function definition for server-side
|
|
160
|
+
* DataSphere search. This generates a data_map configuration that
|
|
161
|
+
* SignalWire executes directly, without needing a webhook callback.
|
|
162
|
+
*/
|
|
163
|
+
buildDataMapFunction() {
|
|
164
|
+
const count = this.getConfig('count', 1);
|
|
165
|
+
const distance = this.getConfig('distance', 3.0);
|
|
166
|
+
const documentId = this.getConfig('document_id', '');
|
|
167
|
+
const tags = this.getConfig('tags', undefined);
|
|
168
|
+
const language = this.getConfig('language', undefined);
|
|
169
|
+
const posToExpand = this.getConfig('pos_to_expand', undefined);
|
|
170
|
+
const maxSynonyms = this.getConfig('max_synonyms', undefined);
|
|
171
|
+
const noResultsMessage = this.getConfig('no_results_message', DEFAULT_NO_RESULTS_MESSAGE);
|
|
172
|
+
// Match Python skills/datasphere_serverless/skill.py:152-157: bake the API URL
|
|
173
|
+
// and Basic-auth header directly from skill params. setup() has already
|
|
174
|
+
// validated that space_name/project_id/token/document_id are all present.
|
|
175
|
+
const spaceName = this.getConfig('space_name', '');
|
|
176
|
+
const projectId = this.getConfig('project_id', '');
|
|
177
|
+
const token = this.getConfig('token', '');
|
|
178
|
+
const apiUrl = `https://${spaceName}.signalwire.com/api/datasphere/documents/search`;
|
|
179
|
+
const authHeader = Buffer.from(`${projectId}:${token}`).toString('base64');
|
|
180
|
+
const dm = new DataMap(this.getToolName());
|
|
181
|
+
dm.purpose('Search the SignalWire DataSphere knowledge base for relevant information. ' +
|
|
182
|
+
'Returns the most relevant text chunks from uploaded documents.');
|
|
183
|
+
dm.parameter('query', 'string', "The search query — what information you're looking for in the knowledge base.", { required: true });
|
|
184
|
+
// Build the request body, mirroring Python's webhook params ordering.
|
|
185
|
+
// document_id first (Python skill.py:165-170); conditional params last.
|
|
186
|
+
const requestBody = {
|
|
187
|
+
document_id: documentId,
|
|
188
|
+
query_string: '${args.query}',
|
|
189
|
+
count,
|
|
190
|
+
distance,
|
|
191
|
+
};
|
|
192
|
+
if (tags !== undefined) {
|
|
193
|
+
requestBody['tags'] = tags;
|
|
194
|
+
}
|
|
195
|
+
if (language !== undefined) {
|
|
196
|
+
requestBody['language'] = language;
|
|
197
|
+
}
|
|
198
|
+
if (posToExpand !== undefined) {
|
|
199
|
+
requestBody['pos_to_expand'] = posToExpand;
|
|
200
|
+
}
|
|
201
|
+
if (maxSynonyms !== undefined) {
|
|
202
|
+
requestBody['max_synonyms'] = maxSynonyms;
|
|
203
|
+
}
|
|
204
|
+
dm.webhook('POST', apiUrl, {
|
|
205
|
+
headers: {
|
|
206
|
+
'Content-Type': 'application/json',
|
|
207
|
+
Authorization: `Basic ${authHeader}`,
|
|
208
|
+
},
|
|
209
|
+
});
|
|
210
|
+
dm.params(requestBody);
|
|
211
|
+
// Match Python's foreach formatter so callers receive a consistent
|
|
212
|
+
// multi-result concatenation rather than only the top three entries.
|
|
213
|
+
dm.foreach({
|
|
214
|
+
input_key: 'chunks',
|
|
215
|
+
output_key: 'formatted_results',
|
|
216
|
+
max: count,
|
|
217
|
+
append: '=== RESULT ===\n${this.text}\n' + '='.repeat(50) + '\n\n',
|
|
218
|
+
});
|
|
219
|
+
dm.output(new FunctionResult('I found results for "${args.query}":\n\n${formatted_results}'));
|
|
220
|
+
dm.errorKeys(['error']);
|
|
221
|
+
// Python replaces `{query}` with `${args.query}` at registration time so
|
|
222
|
+
// the platform can substitute the original user query into the fallback.
|
|
223
|
+
dm.fallbackOutput(new FunctionResult(noResultsMessage.replace('{query}', '${args.query}')));
|
|
224
|
+
// Python skill.py:207 applies swaig_fields via swaig_function.update(self.swaig_fields)
|
|
225
|
+
// after building the DataMap. Match that merge — caller overrides win.
|
|
226
|
+
const fn = dm.toSwaigFunction();
|
|
227
|
+
return Object.keys(this.swaigFields).length > 0
|
|
228
|
+
? { ...fn, ...this.swaigFields }
|
|
229
|
+
: fn;
|
|
230
|
+
}
|
|
231
|
+
/**
|
|
232
|
+
* Return a stub tool definition since this skill uses DataMap-based execution.
|
|
233
|
+
* The actual DataMap function is provided by getDataMapTools().
|
|
234
|
+
* @returns A single stub tool (named via `tool_name`) that explains its DataMap nature.
|
|
235
|
+
*/
|
|
236
|
+
getTools() {
|
|
237
|
+
const toolName = this.getToolName();
|
|
238
|
+
return [
|
|
239
|
+
{
|
|
240
|
+
name: toolName,
|
|
241
|
+
description: 'Search the SignalWire DataSphere knowledge base for relevant information. (Serverless DataMap mode)',
|
|
242
|
+
parameters: {
|
|
243
|
+
query: {
|
|
244
|
+
type: 'string',
|
|
245
|
+
description: 'The question or topic to search for in the knowledge base.',
|
|
246
|
+
},
|
|
247
|
+
},
|
|
248
|
+
required: ['query'],
|
|
249
|
+
handler: () => {
|
|
250
|
+
return new FunctionResult('This tool is configured for serverless DataMap execution. ' +
|
|
251
|
+
'It should be registered as a data_map function, not invoked via webhook.');
|
|
252
|
+
},
|
|
253
|
+
},
|
|
254
|
+
];
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
* Get DataMap-based tool definitions for server-side execution.
|
|
258
|
+
* These are registered directly in the SWML output as data_map functions
|
|
259
|
+
* rather than as webhook-backed SWAIG tools.
|
|
260
|
+
* @returns Array containing the DataSphere search DataMap function definition.
|
|
261
|
+
*/
|
|
262
|
+
getDataMapTools() {
|
|
263
|
+
return [this.buildDataMapFunction()];
|
|
264
|
+
}
|
|
265
|
+
/** @returns Prompt section describing serverless DataSphere search capabilities. */
|
|
266
|
+
_getPromptSections() {
|
|
267
|
+
const toolName = this.getToolName();
|
|
268
|
+
return [
|
|
269
|
+
{
|
|
270
|
+
title: 'Knowledge Search Capability (Serverless)',
|
|
271
|
+
body: `You can search a knowledge base for information using the ${toolName} tool.`,
|
|
272
|
+
bullets: [
|
|
273
|
+
`Use the ${toolName} tool when users ask for information that might be in the knowledge base`,
|
|
274
|
+
'Search for relevant information using clear, specific queries',
|
|
275
|
+
'Summarize search results in a clear, helpful way',
|
|
276
|
+
'If no results are found, suggest the user try rephrasing their question',
|
|
277
|
+
'This tool executes on SignalWire servers for optimal performance',
|
|
278
|
+
],
|
|
279
|
+
},
|
|
280
|
+
];
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
/**
|
|
284
|
+
* Factory function for creating DataSphereServerlessSkill instances.
|
|
285
|
+
* @param config - Optional skill configuration.
|
|
286
|
+
* @returns A new DataSphereServerlessSkill instance.
|
|
287
|
+
*/
|
|
288
|
+
export function createSkill(config) {
|
|
289
|
+
return new DataSphereServerlessSkill(config);
|
|
290
|
+
}
|
|
291
|
+
//# sourceMappingURL=datasphere_serverless.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"datasphere_serverless.js","sourceRoot":"","sources":["../../../src/skills/builtin/datasphere_serverless.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* DateTime Skill - Provides current date/time with optional timezone support.
|
|
3
|
+
*
|
|
4
|
+
* Tier 1 built-in skill: no external dependencies required.
|
|
5
|
+
*/
|
|
6
|
+
import { SkillBase } from '../SkillBase.js';
|
|
7
|
+
import type { SkillToolDefinition, SkillPromptSection, SkillConfig, ParameterSchemaEntry } from '../SkillBase.js';
|
|
8
|
+
/**
|
|
9
|
+
* Provides the current date and time with optional timezone support.
|
|
10
|
+
*
|
|
11
|
+
* Tier 1 built-in skill with no external dependencies. Supports all IANA
|
|
12
|
+
* timezone identifiers via the Intl.DateTimeFormat API.
|
|
13
|
+
*
|
|
14
|
+
* Registers two SWAIG tools: `get_current_time` and `get_current_date`.
|
|
15
|
+
*
|
|
16
|
+
* @example
|
|
17
|
+
* ```ts
|
|
18
|
+
* agent.addSkill('datetime');
|
|
19
|
+
* ```
|
|
20
|
+
*/
|
|
21
|
+
export declare class DateTimeSkill extends SkillBase {
|
|
22
|
+
static SKILL_NAME: string;
|
|
23
|
+
static SKILL_DESCRIPTION: string;
|
|
24
|
+
static SKILL_VERSION: string;
|
|
25
|
+
static REQUIRED_PACKAGES: readonly string[];
|
|
26
|
+
static REQUIRED_ENV_VARS: readonly string[];
|
|
27
|
+
static getParameterSchema(): Record<string, ParameterSchemaEntry>;
|
|
28
|
+
/**
|
|
29
|
+
* @returns Two tools: `get_current_time` and `get_current_date`, each
|
|
30
|
+
* accepting an optional IANA timezone and defaulting to UTC.
|
|
31
|
+
*/
|
|
32
|
+
getTools(): SkillToolDefinition[];
|
|
33
|
+
protected _getPromptSections(): SkillPromptSection[];
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Factory function for creating DateTimeSkill instances.
|
|
37
|
+
* @param config - Optional skill configuration.
|
|
38
|
+
* @returns A new DateTimeSkill instance.
|
|
39
|
+
*/
|
|
40
|
+
export declare function createSkill(config?: SkillConfig): DateTimeSkill;
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* DateTime Skill - Provides current date/time with optional timezone support.
|
|
3
|
+
*
|
|
4
|
+
* Tier 1 built-in skill: no external dependencies required.
|
|
5
|
+
*/
|
|
6
|
+
import { SkillBase } from '../SkillBase.js';
|
|
7
|
+
import { FunctionResult } from '../../FunctionResult.js';
|
|
8
|
+
/**
|
|
9
|
+
* Provides the current date and time with optional timezone support.
|
|
10
|
+
*
|
|
11
|
+
* Tier 1 built-in skill with no external dependencies. Supports all IANA
|
|
12
|
+
* timezone identifiers via the Intl.DateTimeFormat API.
|
|
13
|
+
*
|
|
14
|
+
* Registers two SWAIG tools: `get_current_time` and `get_current_date`.
|
|
15
|
+
*
|
|
16
|
+
* @example
|
|
17
|
+
* ```ts
|
|
18
|
+
* agent.addSkill('datetime');
|
|
19
|
+
* ```
|
|
20
|
+
*/
|
|
21
|
+
export class DateTimeSkill extends SkillBase {
|
|
22
|
+
// Python ground truth: skills/datetime/skill.py
|
|
23
|
+
// REQUIRED_PACKAGES = ["pytz"] in Python; TS uses Intl + Date built-ins so [].
|
|
24
|
+
static SKILL_NAME = 'datetime';
|
|
25
|
+
static SKILL_DESCRIPTION = 'Get current date, time, and timezone information';
|
|
26
|
+
static SKILL_VERSION = '1.0.0';
|
|
27
|
+
static REQUIRED_PACKAGES = [];
|
|
28
|
+
static REQUIRED_ENV_VARS = [];
|
|
29
|
+
static getParameterSchema() {
|
|
30
|
+
return { ...super.getParameterSchema() };
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* @returns Two tools: `get_current_time` and `get_current_date`, each
|
|
34
|
+
* accepting an optional IANA timezone and defaulting to UTC.
|
|
35
|
+
*/
|
|
36
|
+
getTools() {
|
|
37
|
+
return [
|
|
38
|
+
{
|
|
39
|
+
name: 'get_current_time',
|
|
40
|
+
description: "Get the current time, optionally in a specific timezone",
|
|
41
|
+
parameters: {
|
|
42
|
+
timezone: {
|
|
43
|
+
type: 'string',
|
|
44
|
+
description: "Timezone name (e.g., 'America/New_York', 'Europe/London'). Defaults to UTC.",
|
|
45
|
+
},
|
|
46
|
+
},
|
|
47
|
+
handler: (args) => {
|
|
48
|
+
const timezone = args.timezone ?? 'UTC';
|
|
49
|
+
const now = new Date();
|
|
50
|
+
try {
|
|
51
|
+
const timeFormatter = new Intl.DateTimeFormat('en-US', {
|
|
52
|
+
timeZone: timezone,
|
|
53
|
+
hour: '2-digit',
|
|
54
|
+
minute: '2-digit',
|
|
55
|
+
second: '2-digit',
|
|
56
|
+
hour12: true,
|
|
57
|
+
timeZoneName: 'short',
|
|
58
|
+
});
|
|
59
|
+
return new FunctionResult(`The current time is ${timeFormatter.format(now)}`);
|
|
60
|
+
}
|
|
61
|
+
catch {
|
|
62
|
+
return new FunctionResult(`Invalid timezone "${timezone}". Please use a valid IANA timezone identifier.`);
|
|
63
|
+
}
|
|
64
|
+
},
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
name: 'get_current_date',
|
|
68
|
+
description: 'Get the current date',
|
|
69
|
+
parameters: {
|
|
70
|
+
timezone: {
|
|
71
|
+
type: 'string',
|
|
72
|
+
description: 'Timezone name for the date. Defaults to UTC.',
|
|
73
|
+
},
|
|
74
|
+
},
|
|
75
|
+
handler: (args) => {
|
|
76
|
+
const timezone = args.timezone ?? 'UTC';
|
|
77
|
+
const now = new Date();
|
|
78
|
+
try {
|
|
79
|
+
const dateFormatter = new Intl.DateTimeFormat('en-US', {
|
|
80
|
+
timeZone: timezone,
|
|
81
|
+
weekday: 'long',
|
|
82
|
+
year: 'numeric',
|
|
83
|
+
month: 'long',
|
|
84
|
+
day: 'numeric',
|
|
85
|
+
});
|
|
86
|
+
return new FunctionResult(`Today's date is ${dateFormatter.format(now)}`);
|
|
87
|
+
}
|
|
88
|
+
catch {
|
|
89
|
+
return new FunctionResult(`Invalid timezone "${timezone}". Please use a valid IANA timezone identifier.`);
|
|
90
|
+
}
|
|
91
|
+
},
|
|
92
|
+
},
|
|
93
|
+
];
|
|
94
|
+
}
|
|
95
|
+
_getPromptSections() {
|
|
96
|
+
return [
|
|
97
|
+
{
|
|
98
|
+
title: 'Date and Time Information',
|
|
99
|
+
body: 'You can provide current date and time information.',
|
|
100
|
+
bullets: [
|
|
101
|
+
'Use get_current_time to tell users what time it is.',
|
|
102
|
+
"Use get_current_date to tell users today's date.",
|
|
103
|
+
'Both tools support different timezones via IANA identifiers (e.g., America/New_York, Europe/London, Asia/Tokyo).',
|
|
104
|
+
'If no timezone is specified, UTC is used by default.',
|
|
105
|
+
],
|
|
106
|
+
},
|
|
107
|
+
];
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Factory function for creating DateTimeSkill instances.
|
|
112
|
+
* @param config - Optional skill configuration.
|
|
113
|
+
* @returns A new DateTimeSkill instance.
|
|
114
|
+
*/
|
|
115
|
+
export function createSkill(config) {
|
|
116
|
+
return new DateTimeSkill(config);
|
|
117
|
+
}
|
|
118
|
+
//# sourceMappingURL=datetime.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"datetime.js","sourceRoot":"","sources":["../../../src/skills/builtin/datetime.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Google Maps Skill - Provides directions and place search via Google Maps APIs.
|
|
3
|
+
*
|
|
4
|
+
* Tier 3 built-in skill: requires GOOGLE_MAPS_API_KEY environment variable.
|
|
5
|
+
* Uses Google Directions API for route information and Google Places API
|
|
6
|
+
* for place search and discovery.
|
|
7
|
+
*/
|
|
8
|
+
import { SkillBase } from '../SkillBase.js';
|
|
9
|
+
import type { SkillToolDefinition, SkillPromptSection, SkillConfig, ParameterSchemaEntry } from '../SkillBase.js';
|
|
10
|
+
/**
|
|
11
|
+
* Provides driving/walking/transit directions and place search via Google Maps APIs.
|
|
12
|
+
*
|
|
13
|
+
* Tier 3 built-in skill. Requires the `GOOGLE_MAPS_API_KEY` environment variable.
|
|
14
|
+
* Supports a `default_mode` config option ("driving"|"walking"|"bicycling"|"transit").
|
|
15
|
+
*
|
|
16
|
+
* @example
|
|
17
|
+
* ```ts
|
|
18
|
+
* agent.addSkill('google_maps', { default_mode: 'driving' });
|
|
19
|
+
* ```
|
|
20
|
+
*/
|
|
21
|
+
export declare class GoogleMapsSkill extends SkillBase {
|
|
22
|
+
static SKILL_NAME: string;
|
|
23
|
+
static SKILL_DESCRIPTION: string;
|
|
24
|
+
static SKILL_VERSION: string;
|
|
25
|
+
static REQUIRED_PACKAGES: readonly string[];
|
|
26
|
+
static REQUIRED_ENV_VARS: readonly string[];
|
|
27
|
+
static getParameterSchema(): Record<string, ParameterSchemaEntry>;
|
|
28
|
+
/**
|
|
29
|
+
* Fail-fast when GOOGLE_MAPS_API_KEY is not set, mirroring Python's
|
|
30
|
+
* `setup()` validation. The env var is the only credential source for
|
|
31
|
+
* this skill, so loading it without the key would produce runtime
|
|
32
|
+
* errors on every tool call.
|
|
33
|
+
* @returns `true` if the API key is present, `false` otherwise.
|
|
34
|
+
*/
|
|
35
|
+
setup(): Promise<boolean>;
|
|
36
|
+
/** @returns Speech recognition hints for maps/directions keywords. */
|
|
37
|
+
getHints(): string[];
|
|
38
|
+
/** @returns Two tools: `get_directions` for route info and `find_place` for place discovery. */
|
|
39
|
+
getTools(): SkillToolDefinition[];
|
|
40
|
+
/** @returns Prompt section describing directions and place search capabilities. */
|
|
41
|
+
protected _getPromptSections(): SkillPromptSection[];
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Factory function for creating GoogleMapsSkill instances.
|
|
45
|
+
* @param config - Optional skill configuration.
|
|
46
|
+
* @returns A new GoogleMapsSkill instance.
|
|
47
|
+
*/
|
|
48
|
+
export declare function createSkill(config?: SkillConfig): GoogleMapsSkill;
|