@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
|
@@ -1,685 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* MCP Gateway Skill - Bridge MCP servers with SWAIG functions.
|
|
3
|
-
*
|
|
4
|
-
* Port of the Python `MCPGatewaySkill`. Connects SignalWire agents to a
|
|
5
|
-
* Model Context Protocol gateway HTTP service and dynamically registers
|
|
6
|
-
* SWAIG tools for every MCP tool exposed by the configured services.
|
|
7
|
-
*
|
|
8
|
-
* Authentication: Bearer token (via `auth_token`) or HTTP Basic auth
|
|
9
|
-
* (via `auth_user` + `auth_password`). Supports configurable timeouts,
|
|
10
|
-
* retry attempts, and SSL verification.
|
|
11
|
-
*/
|
|
12
|
-
|
|
13
|
-
import { SkillBase } from '../SkillBase.js';
|
|
14
|
-
import type {
|
|
15
|
-
SkillToolDefinition,
|
|
16
|
-
SkillPromptSection,
|
|
17
|
-
SkillConfig,
|
|
18
|
-
ParameterSchemaEntry,
|
|
19
|
-
} from '../SkillBase.js';
|
|
20
|
-
import { FunctionResult } from '../../FunctionResult.js';
|
|
21
|
-
import { getLogger } from '../../Logger.js';
|
|
22
|
-
import { validateUrl } from '../../SecurityUtils.js';
|
|
23
|
-
import { Agent as UndiciAgent } from 'undici';
|
|
24
|
-
|
|
25
|
-
const log = getLogger('McpGatewaySkill');
|
|
26
|
-
|
|
27
|
-
/** Configuration entry for a single MCP service to expose. */
|
|
28
|
-
interface McpServiceConfig {
|
|
29
|
-
/** Service name as registered on the gateway. */
|
|
30
|
-
name: string;
|
|
31
|
-
/** Tools to expose: '*' for all, array of names to filter, or undefined. */
|
|
32
|
-
tools?: string | string[];
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
/** MCP tool definition returned by the gateway's /services/<name>/tools endpoint. */
|
|
36
|
-
interface McpToolDefinition {
|
|
37
|
-
name: string;
|
|
38
|
-
description?: string;
|
|
39
|
-
inputSchema?: {
|
|
40
|
-
properties?: Record<string, { type?: string; description?: string; enum?: unknown[]; default?: unknown }>;
|
|
41
|
-
required?: string[];
|
|
42
|
-
};
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
/**
|
|
46
|
-
* Bridge MCP (Model Context Protocol) servers with SWAIG functions.
|
|
47
|
-
*
|
|
48
|
-
* When configured, calls a gateway's `/services` endpoint to discover MCP
|
|
49
|
-
* services, enumerates each service's tools, and registers them as SWAIG
|
|
50
|
-
* tools prefixed with `tool_prefix` (default `mcp_`). A hidden hangup hook
|
|
51
|
-
* tool cleans up MCP sessions when the call ends.
|
|
52
|
-
*
|
|
53
|
-
* @example
|
|
54
|
-
* ```ts
|
|
55
|
-
* agent.addSkill('mcp_gateway', {
|
|
56
|
-
* gateway_url: 'https://mcp-gateway.example.com',
|
|
57
|
-
* tool_prefix: 'mcp_',
|
|
58
|
-
* });
|
|
59
|
-
* ```
|
|
60
|
-
*/
|
|
61
|
-
export class McpGatewaySkill extends SkillBase {
|
|
62
|
-
// Python ground truth: skills/mcp_gateway/skill.py:~70-76
|
|
63
|
-
// REQUIRED_PACKAGES = ["requests"] in Python; TS uses undici for SSL dispatch.
|
|
64
|
-
// Python does not set SUPPORTS_MULTIPLE_INSTANCES so it inherits the default (False).
|
|
65
|
-
static override SKILL_NAME = 'mcp_gateway';
|
|
66
|
-
static override SKILL_DESCRIPTION = 'Bridge MCP servers with SWAIG functions';
|
|
67
|
-
static override SKILL_VERSION = '1.0.0';
|
|
68
|
-
static override REQUIRED_PACKAGES: readonly string[] = ['undici'];
|
|
69
|
-
static override REQUIRED_ENV_VARS: readonly string[] = [];
|
|
70
|
-
|
|
71
|
-
static override getParameterSchema(): Record<string, ParameterSchemaEntry> {
|
|
72
|
-
return {
|
|
73
|
-
...super.getParameterSchema(),
|
|
74
|
-
gateway_url: {
|
|
75
|
-
type: 'string',
|
|
76
|
-
description: 'URL of the MCP Gateway service',
|
|
77
|
-
required: true,
|
|
78
|
-
},
|
|
79
|
-
auth_token: {
|
|
80
|
-
type: 'string',
|
|
81
|
-
description:
|
|
82
|
-
'Bearer token for authentication (alternative to basic auth)',
|
|
83
|
-
required: false,
|
|
84
|
-
hidden: true,
|
|
85
|
-
env_var: 'MCP_GATEWAY_AUTH_TOKEN',
|
|
86
|
-
},
|
|
87
|
-
auth_user: {
|
|
88
|
-
type: 'string',
|
|
89
|
-
description:
|
|
90
|
-
'Username for basic authentication (required if auth_token not provided)',
|
|
91
|
-
required: false,
|
|
92
|
-
env_var: 'MCP_GATEWAY_AUTH_USER',
|
|
93
|
-
},
|
|
94
|
-
auth_password: {
|
|
95
|
-
type: 'string',
|
|
96
|
-
description:
|
|
97
|
-
'Password for basic authentication (required if auth_token not provided)',
|
|
98
|
-
required: false,
|
|
99
|
-
hidden: true,
|
|
100
|
-
env_var: 'MCP_GATEWAY_AUTH_PASSWORD',
|
|
101
|
-
},
|
|
102
|
-
services: {
|
|
103
|
-
type: 'array',
|
|
104
|
-
description:
|
|
105
|
-
'List of MCP services to connect to (empty for all available)',
|
|
106
|
-
default: [],
|
|
107
|
-
required: false,
|
|
108
|
-
items: {
|
|
109
|
-
type: 'object',
|
|
110
|
-
properties: {
|
|
111
|
-
name: { type: 'string', description: 'Service name' },
|
|
112
|
-
tools: {
|
|
113
|
-
type: ['string', 'array'],
|
|
114
|
-
description:
|
|
115
|
-
"Tools to expose ('*' for all, or list of tool names)",
|
|
116
|
-
},
|
|
117
|
-
},
|
|
118
|
-
},
|
|
119
|
-
},
|
|
120
|
-
session_timeout: {
|
|
121
|
-
type: 'integer',
|
|
122
|
-
description: 'Session timeout in seconds',
|
|
123
|
-
default: 300,
|
|
124
|
-
required: false,
|
|
125
|
-
},
|
|
126
|
-
tool_prefix: {
|
|
127
|
-
type: 'string',
|
|
128
|
-
description: 'Prefix for registered SWAIG function names',
|
|
129
|
-
default: 'mcp_',
|
|
130
|
-
required: false,
|
|
131
|
-
},
|
|
132
|
-
retry_attempts: {
|
|
133
|
-
type: 'integer',
|
|
134
|
-
description: 'Number of retry attempts for failed requests',
|
|
135
|
-
default: 3,
|
|
136
|
-
required: false,
|
|
137
|
-
},
|
|
138
|
-
request_timeout: {
|
|
139
|
-
type: 'integer',
|
|
140
|
-
description: 'Request timeout in seconds',
|
|
141
|
-
default: 30,
|
|
142
|
-
required: false,
|
|
143
|
-
},
|
|
144
|
-
verify_ssl: {
|
|
145
|
-
type: 'boolean',
|
|
146
|
-
description: 'Verify SSL certificates',
|
|
147
|
-
default: true,
|
|
148
|
-
required: false,
|
|
149
|
-
},
|
|
150
|
-
};
|
|
151
|
-
}
|
|
152
|
-
|
|
153
|
-
// Runtime state populated in setup()
|
|
154
|
-
private gatewayUrl = '';
|
|
155
|
-
private authToken: string | undefined;
|
|
156
|
-
private authUser: string | undefined;
|
|
157
|
-
private authPassword: string | undefined;
|
|
158
|
-
private services: McpServiceConfig[] = [];
|
|
159
|
-
private sessionTimeout = 300;
|
|
160
|
-
private toolPrefix = 'mcp_';
|
|
161
|
-
private retryAttempts = 3;
|
|
162
|
-
private requestTimeout = 30;
|
|
163
|
-
private verifySsl = true;
|
|
164
|
-
private _discoveredTools: SkillToolDefinition[] = [];
|
|
165
|
-
private _ready = false;
|
|
166
|
-
/**
|
|
167
|
-
* Cached undici Agent used when `verify_ssl=false`. Created once in
|
|
168
|
-
* `setup()` and reused across every `_makeRequest` call to avoid
|
|
169
|
-
* connection-pool churn (Python reuses `requests.Session` implicitly).
|
|
170
|
-
*/
|
|
171
|
-
private _undiciAgent: UndiciAgent | undefined;
|
|
172
|
-
|
|
173
|
-
override async setup(): Promise<boolean> {
|
|
174
|
-
this.authToken =
|
|
175
|
-
this.getConfig<string | undefined>('auth_token', undefined) ??
|
|
176
|
-
process.env['MCP_GATEWAY_AUTH_TOKEN'];
|
|
177
|
-
|
|
178
|
-
const gatewayUrl = this.getConfig<string | undefined>('gateway_url', undefined);
|
|
179
|
-
if (!gatewayUrl) {
|
|
180
|
-
log.error('mcp_gateway: missing required parameter: gateway_url');
|
|
181
|
-
return false;
|
|
182
|
-
}
|
|
183
|
-
|
|
184
|
-
if (!this.authToken) {
|
|
185
|
-
this.authUser =
|
|
186
|
-
this.getConfig<string | undefined>('auth_user', undefined) ??
|
|
187
|
-
process.env['MCP_GATEWAY_AUTH_USER'];
|
|
188
|
-
this.authPassword =
|
|
189
|
-
this.getConfig<string | undefined>('auth_password', undefined) ??
|
|
190
|
-
process.env['MCP_GATEWAY_AUTH_PASSWORD'];
|
|
191
|
-
if (!this.authUser || !this.authPassword) {
|
|
192
|
-
log.error(
|
|
193
|
-
'mcp_gateway: missing required parameters: auth_token or (auth_user + auth_password)',
|
|
194
|
-
);
|
|
195
|
-
return false;
|
|
196
|
-
}
|
|
197
|
-
}
|
|
198
|
-
|
|
199
|
-
this.gatewayUrl = gatewayUrl.replace(/\/+$/, '');
|
|
200
|
-
|
|
201
|
-
// SSRF protection — match Python skills/mcp_gateway/skill.py:147-148 which
|
|
202
|
-
// calls validate_url(self.gateway_url) before the health check. Reject
|
|
203
|
-
// private/loopback/metadata-endpoint URLs in multi-tenant deployments.
|
|
204
|
-
if (!(await validateUrl(this.gatewayUrl))) {
|
|
205
|
-
log.error('mcp_gateway: gateway_url rejected by SSRF protection', {
|
|
206
|
-
url: this.gatewayUrl,
|
|
207
|
-
});
|
|
208
|
-
return false;
|
|
209
|
-
}
|
|
210
|
-
|
|
211
|
-
this.services =
|
|
212
|
-
this.getConfig<McpServiceConfig[]>('services', []) ?? [];
|
|
213
|
-
this.sessionTimeout = this.getConfig<number>('session_timeout', 300);
|
|
214
|
-
this.toolPrefix = this.getConfig<string>('tool_prefix', 'mcp_');
|
|
215
|
-
this.retryAttempts = this.getConfig<number>('retry_attempts', 3);
|
|
216
|
-
this.requestTimeout = this.getConfig<number>('request_timeout', 30);
|
|
217
|
-
this.verifySsl = this.getConfig<boolean>('verify_ssl', true);
|
|
218
|
-
|
|
219
|
-
// Cache a single undici Agent for SSL-bypass mode so each request reuses
|
|
220
|
-
// the same connection pool (parity with Python requests.Session behavior).
|
|
221
|
-
if (!this.verifySsl) {
|
|
222
|
-
this._undiciAgent = new UndiciAgent({
|
|
223
|
-
connect: { rejectUnauthorized: false },
|
|
224
|
-
});
|
|
225
|
-
}
|
|
226
|
-
|
|
227
|
-
// Validate gateway connectivity
|
|
228
|
-
try {
|
|
229
|
-
const health = await this._makeRequest('GET', `${this.gatewayUrl}/health`);
|
|
230
|
-
if (!health.ok) {
|
|
231
|
-
log.error('mcp_gateway: gateway health check failed', {
|
|
232
|
-
status: health.status,
|
|
233
|
-
});
|
|
234
|
-
return false;
|
|
235
|
-
}
|
|
236
|
-
log.info('mcp_gateway: connected', { url: this.gatewayUrl });
|
|
237
|
-
} catch (err) {
|
|
238
|
-
log.error('mcp_gateway: failed to connect to gateway', {
|
|
239
|
-
error: err instanceof Error ? err.message : String(err),
|
|
240
|
-
});
|
|
241
|
-
return false;
|
|
242
|
-
}
|
|
243
|
-
|
|
244
|
-
// Discover tools (equivalent of Python register_tools())
|
|
245
|
-
try {
|
|
246
|
-
await this._discoverTools();
|
|
247
|
-
this._ready = true;
|
|
248
|
-
return true;
|
|
249
|
-
} catch (err) {
|
|
250
|
-
log.error('mcp_gateway: tool discovery failed', {
|
|
251
|
-
error: err instanceof Error ? err.message : String(err),
|
|
252
|
-
});
|
|
253
|
-
return false;
|
|
254
|
-
}
|
|
255
|
-
}
|
|
256
|
-
|
|
257
|
-
override getHints(): string[] {
|
|
258
|
-
const hints = ['MCP', 'gateway'];
|
|
259
|
-
const services =
|
|
260
|
-
this.services.length > 0
|
|
261
|
-
? this.services
|
|
262
|
-
: (this.getConfig<McpServiceConfig[]>('services', []) ?? []);
|
|
263
|
-
for (const service of services) {
|
|
264
|
-
if (service && typeof service === 'object' && service.name) {
|
|
265
|
-
hints.push(service.name);
|
|
266
|
-
}
|
|
267
|
-
}
|
|
268
|
-
return hints;
|
|
269
|
-
}
|
|
270
|
-
|
|
271
|
-
override getGlobalData(): Record<string, unknown> {
|
|
272
|
-
if (!this._ready) return {};
|
|
273
|
-
// Python skill.py emits mcp_session_id = self.session_id, which Python
|
|
274
|
-
// initializes to None in setup() and never updates. Per-call session IDs
|
|
275
|
-
// live in local scope inside _call_mcp_tool — never mutate shared state.
|
|
276
|
-
return {
|
|
277
|
-
mcp_gateway_url: this.gatewayUrl,
|
|
278
|
-
mcp_session_id: null,
|
|
279
|
-
mcp_services: this.services.map((s) =>
|
|
280
|
-
typeof s === 'object' && s !== null ? s.name : String(s),
|
|
281
|
-
),
|
|
282
|
-
};
|
|
283
|
-
}
|
|
284
|
-
|
|
285
|
-
/**
|
|
286
|
-
* @returns Dynamically discovered MCP tools plus an internal hangup-cleanup
|
|
287
|
-
* tool. If discovery has not completed, returns a single fallback
|
|
288
|
-
* `mcp_invoke` tool that explains configuration is missing.
|
|
289
|
-
*/
|
|
290
|
-
getTools(): SkillToolDefinition[] {
|
|
291
|
-
if (!this._ready || this._discoveredTools.length === 0) {
|
|
292
|
-
return [
|
|
293
|
-
{
|
|
294
|
-
name: 'mcp_invoke',
|
|
295
|
-
description:
|
|
296
|
-
'MCP gateway is not configured. Provide gateway_url and credentials to enable this skill.',
|
|
297
|
-
parameters: {
|
|
298
|
-
server: {
|
|
299
|
-
type: 'string',
|
|
300
|
-
description: 'The MCP server/service name.',
|
|
301
|
-
},
|
|
302
|
-
method: {
|
|
303
|
-
type: 'string',
|
|
304
|
-
description: 'The method/tool name to invoke.',
|
|
305
|
-
},
|
|
306
|
-
params: {
|
|
307
|
-
type: 'object',
|
|
308
|
-
description: 'Parameters to pass to the MCP method.',
|
|
309
|
-
},
|
|
310
|
-
},
|
|
311
|
-
required: ['server', 'method'],
|
|
312
|
-
handler: () =>
|
|
313
|
-
new FunctionResult(
|
|
314
|
-
'MCP gateway is not configured. Set gateway_url and an auth method (auth_token or auth_user/auth_password) on the skill config.',
|
|
315
|
-
),
|
|
316
|
-
},
|
|
317
|
-
];
|
|
318
|
-
}
|
|
319
|
-
|
|
320
|
-
// Append hangup hook tool — isHangupHook causes the platform to auto-fire
|
|
321
|
-
// this on call hangup (Python: is_hangup_hook=True in define_tool).
|
|
322
|
-
const tools = [...this._discoveredTools];
|
|
323
|
-
tools.push({
|
|
324
|
-
name: '_mcp_gateway_hangup',
|
|
325
|
-
description: 'Internal cleanup function for MCP sessions',
|
|
326
|
-
parameters: {},
|
|
327
|
-
handler: (args: Record<string, unknown>, rawData: Record<string, unknown>) =>
|
|
328
|
-
this._hangupHandler(args, rawData),
|
|
329
|
-
isHangupHook: true,
|
|
330
|
-
});
|
|
331
|
-
return tools;
|
|
332
|
-
}
|
|
333
|
-
|
|
334
|
-
/** @returns Prompt section listing configured MCP services. */
|
|
335
|
-
protected override _getPromptSections(): SkillPromptSection[] {
|
|
336
|
-
// Prefer runtime-resolved services (after setup); fall back to config.
|
|
337
|
-
const services =
|
|
338
|
-
this.services.length > 0
|
|
339
|
-
? this.services
|
|
340
|
-
: (this.getConfig<McpServiceConfig[]>('services', []) ?? []);
|
|
341
|
-
const gatewayUrl = this.gatewayUrl || this.getConfig<string>('gateway_url', '');
|
|
342
|
-
const toolPrefix = this.toolPrefix || this.getConfig<string>('tool_prefix', 'mcp_');
|
|
343
|
-
const serviceDescriptions: string[] = [];
|
|
344
|
-
for (const service of services) {
|
|
345
|
-
if (typeof service !== 'object' || service === null) continue;
|
|
346
|
-
const name = service.name ?? 'Unknown';
|
|
347
|
-
const tools = service.tools ?? '*';
|
|
348
|
-
if (tools === '*') {
|
|
349
|
-
serviceDescriptions.push(`${name} (all tools)`);
|
|
350
|
-
} else if (Array.isArray(tools)) {
|
|
351
|
-
serviceDescriptions.push(`${name} (${tools.length} tools)`);
|
|
352
|
-
} else {
|
|
353
|
-
serviceDescriptions.push(String(name));
|
|
354
|
-
}
|
|
355
|
-
}
|
|
356
|
-
|
|
357
|
-
if (serviceDescriptions.length === 0) {
|
|
358
|
-
return [];
|
|
359
|
-
}
|
|
360
|
-
|
|
361
|
-
return [
|
|
362
|
-
{
|
|
363
|
-
title: 'MCP Gateway Integration',
|
|
364
|
-
body: 'You have access to external MCP (Model Context Protocol) services through a gateway.',
|
|
365
|
-
bullets: [
|
|
366
|
-
`Connected to gateway at ${gatewayUrl}`,
|
|
367
|
-
`Available services: ${serviceDescriptions.join(', ')}`,
|
|
368
|
-
`Functions are prefixed with '${toolPrefix}' followed by service name`,
|
|
369
|
-
'Each service maintains its own session state throughout the call',
|
|
370
|
-
],
|
|
371
|
-
},
|
|
372
|
-
];
|
|
373
|
-
}
|
|
374
|
-
|
|
375
|
-
// ---------------------------------------------------------------------------
|
|
376
|
-
// Internal helpers
|
|
377
|
-
// ---------------------------------------------------------------------------
|
|
378
|
-
|
|
379
|
-
/** Build auth + timeout-bearing fetch request to the gateway. */
|
|
380
|
-
private async _makeRequest(
|
|
381
|
-
method: string,
|
|
382
|
-
url: string,
|
|
383
|
-
options: { body?: unknown; headers?: Record<string, string> } = {},
|
|
384
|
-
): Promise<Response> {
|
|
385
|
-
const headers: Record<string, string> = {
|
|
386
|
-
Accept: 'application/json',
|
|
387
|
-
...(options.headers ?? {}),
|
|
388
|
-
};
|
|
389
|
-
|
|
390
|
-
if (this.authToken) {
|
|
391
|
-
headers['Authorization'] = `Bearer ${this.authToken}`;
|
|
392
|
-
} else if (this.authUser && this.authPassword) {
|
|
393
|
-
const creds = Buffer.from(`${this.authUser}:${this.authPassword}`).toString(
|
|
394
|
-
'base64',
|
|
395
|
-
);
|
|
396
|
-
headers['Authorization'] = `Basic ${creds}`;
|
|
397
|
-
}
|
|
398
|
-
|
|
399
|
-
const init: RequestInit & { dispatcher?: unknown } = { method, headers };
|
|
400
|
-
if (options.body !== undefined) {
|
|
401
|
-
headers['Content-Type'] = 'application/json';
|
|
402
|
-
init.body = JSON.stringify(options.body);
|
|
403
|
-
}
|
|
404
|
-
|
|
405
|
-
const controller = new AbortController();
|
|
406
|
-
const timer = setTimeout(
|
|
407
|
-
() => controller.abort(),
|
|
408
|
-
this.requestTimeout * 1000,
|
|
409
|
-
);
|
|
410
|
-
init.signal = controller.signal;
|
|
411
|
-
|
|
412
|
-
// Mirror Python `requests.request(..., verify=self.verify_ssl)`. Node's
|
|
413
|
-
// built-in fetch has no SSL toggle, so reuse the undici Agent cached in
|
|
414
|
-
// setup() rather than spinning up a fresh one on every call.
|
|
415
|
-
if (this._undiciAgent) {
|
|
416
|
-
init.dispatcher = this._undiciAgent;
|
|
417
|
-
}
|
|
418
|
-
|
|
419
|
-
try {
|
|
420
|
-
return await fetch(url, init as RequestInit);
|
|
421
|
-
} finally {
|
|
422
|
-
clearTimeout(timer);
|
|
423
|
-
}
|
|
424
|
-
}
|
|
425
|
-
|
|
426
|
-
/** Discover available services and register each MCP tool as a SWAIG tool. */
|
|
427
|
-
private async _discoverTools(): Promise<void> {
|
|
428
|
-
this._discoveredTools = [];
|
|
429
|
-
|
|
430
|
-
// If no services configured, fetch all available
|
|
431
|
-
let services = this.services;
|
|
432
|
-
if (services.length === 0) {
|
|
433
|
-
const response = await this._makeRequest(
|
|
434
|
-
'GET',
|
|
435
|
-
`${this.gatewayUrl}/services`,
|
|
436
|
-
);
|
|
437
|
-
if (!response.ok) {
|
|
438
|
-
log.error('mcp_gateway: failed to list services', {
|
|
439
|
-
status: response.status,
|
|
440
|
-
});
|
|
441
|
-
return;
|
|
442
|
-
}
|
|
443
|
-
const allServices = (await response.json()) as Record<string, unknown>;
|
|
444
|
-
services = Object.keys(allServices).map((name) => ({ name }));
|
|
445
|
-
this.services = services;
|
|
446
|
-
}
|
|
447
|
-
|
|
448
|
-
for (const serviceConfig of services) {
|
|
449
|
-
const serviceName = serviceConfig?.name;
|
|
450
|
-
if (!serviceName) continue;
|
|
451
|
-
|
|
452
|
-
try {
|
|
453
|
-
const response = await this._makeRequest(
|
|
454
|
-
'GET',
|
|
455
|
-
`${this.gatewayUrl}/services/${encodeURIComponent(serviceName)}/tools`,
|
|
456
|
-
);
|
|
457
|
-
if (!response.ok) {
|
|
458
|
-
log.error('mcp_gateway: failed to get tools for service', {
|
|
459
|
-
service: serviceName,
|
|
460
|
-
status: response.status,
|
|
461
|
-
});
|
|
462
|
-
continue;
|
|
463
|
-
}
|
|
464
|
-
const data = (await response.json()) as { tools?: McpToolDefinition[] };
|
|
465
|
-
let tools = data.tools ?? [];
|
|
466
|
-
|
|
467
|
-
// Filter tools if specified
|
|
468
|
-
const toolFilter = serviceConfig.tools ?? '*';
|
|
469
|
-
if (toolFilter !== '*' && Array.isArray(toolFilter)) {
|
|
470
|
-
tools = tools.filter((t) => toolFilter.includes(t.name));
|
|
471
|
-
}
|
|
472
|
-
|
|
473
|
-
for (const toolDef of tools) {
|
|
474
|
-
const registered = this._registerMcpTool(serviceName, toolDef);
|
|
475
|
-
if (registered) this._discoveredTools.push(registered);
|
|
476
|
-
}
|
|
477
|
-
} catch (err) {
|
|
478
|
-
log.error('mcp_gateway: error fetching tools for service', {
|
|
479
|
-
service: serviceName,
|
|
480
|
-
error: err instanceof Error ? err.message : String(err),
|
|
481
|
-
});
|
|
482
|
-
}
|
|
483
|
-
}
|
|
484
|
-
}
|
|
485
|
-
|
|
486
|
-
/** Convert an MCP tool definition into a SWAIG-compatible `SkillToolDefinition`. */
|
|
487
|
-
private _registerMcpTool(
|
|
488
|
-
serviceName: string,
|
|
489
|
-
toolDef: McpToolDefinition,
|
|
490
|
-
): SkillToolDefinition | null {
|
|
491
|
-
const toolName = toolDef.name;
|
|
492
|
-
if (!toolName) return null;
|
|
493
|
-
|
|
494
|
-
const swaigName = `${this.toolPrefix}${serviceName}_${toolName}`;
|
|
495
|
-
|
|
496
|
-
const inputSchema = toolDef.inputSchema ?? {};
|
|
497
|
-
const properties = inputSchema.properties ?? {};
|
|
498
|
-
const required = inputSchema.required ?? [];
|
|
499
|
-
|
|
500
|
-
const swaigParams: Record<string, Record<string, unknown>> = {};
|
|
501
|
-
for (const [propName, propDef] of Object.entries(properties)) {
|
|
502
|
-
const paramDef: Record<string, unknown> = {
|
|
503
|
-
type: propDef.type ?? 'string',
|
|
504
|
-
description: propDef.description ?? '',
|
|
505
|
-
};
|
|
506
|
-
if (propDef.enum !== undefined) paramDef['enum'] = propDef.enum;
|
|
507
|
-
if (propDef.default !== undefined && !required.includes(propName)) {
|
|
508
|
-
paramDef['default'] = propDef.default;
|
|
509
|
-
}
|
|
510
|
-
swaigParams[propName] = paramDef;
|
|
511
|
-
}
|
|
512
|
-
|
|
513
|
-
log.info('mcp_gateway: registering SWAIG tool', { name: swaigName });
|
|
514
|
-
|
|
515
|
-
return {
|
|
516
|
-
name: swaigName,
|
|
517
|
-
description: `[${serviceName}] ${toolDef.description ?? toolName}`,
|
|
518
|
-
parameters: swaigParams,
|
|
519
|
-
required,
|
|
520
|
-
handler: async (
|
|
521
|
-
args: Record<string, unknown>,
|
|
522
|
-
rawData: Record<string, unknown>,
|
|
523
|
-
) => this._callMcpTool(serviceName, toolName, args, rawData),
|
|
524
|
-
};
|
|
525
|
-
}
|
|
526
|
-
|
|
527
|
-
/** Call an MCP tool through the gateway, with retries. */
|
|
528
|
-
private async _callMcpTool(
|
|
529
|
-
serviceName: string,
|
|
530
|
-
toolName: string,
|
|
531
|
-
args: Record<string, unknown>,
|
|
532
|
-
rawData: Record<string, unknown>,
|
|
533
|
-
): Promise<FunctionResult> {
|
|
534
|
-
const globalData = (rawData['global_data'] as Record<string, unknown>) ?? {};
|
|
535
|
-
log.debug('mcp_gateway: raw_data keys', { keys: Object.keys(rawData) });
|
|
536
|
-
log.debug('mcp_gateway: global_data keys', { keys: Object.keys(globalData) });
|
|
537
|
-
let sessionId: string;
|
|
538
|
-
if (typeof globalData['mcp_call_id'] === 'string') {
|
|
539
|
-
sessionId = globalData['mcp_call_id'] as string;
|
|
540
|
-
log.info('mcp_gateway: using session ID from global_data.mcp_call_id', {
|
|
541
|
-
sessionId,
|
|
542
|
-
});
|
|
543
|
-
} else {
|
|
544
|
-
sessionId = (rawData['call_id'] as string) ?? 'unknown';
|
|
545
|
-
log.info('mcp_gateway: using session ID from call_id', { sessionId });
|
|
546
|
-
}
|
|
547
|
-
// NB: do NOT mutate this.sessionId here — Python leaves self.session_id
|
|
548
|
-
// untouched after setup(). Per-call IDs stay local so concurrent tool
|
|
549
|
-
// calls don't race and overwrite each other's session metadata.
|
|
550
|
-
|
|
551
|
-
const requestData: Record<string, unknown> = {
|
|
552
|
-
tool: toolName,
|
|
553
|
-
arguments: args,
|
|
554
|
-
session_id: sessionId,
|
|
555
|
-
timeout: this.sessionTimeout,
|
|
556
|
-
metadata: {
|
|
557
|
-
// Python sends self.agent.name; mirror that and fall back to the
|
|
558
|
-
// skill name when agent is not yet bound. No hardcoded SDK literal.
|
|
559
|
-
agent_id: this.agent?.name ?? this.skillName,
|
|
560
|
-
timestamp: rawData['timestamp'],
|
|
561
|
-
call_id: rawData['call_id'],
|
|
562
|
-
},
|
|
563
|
-
};
|
|
564
|
-
|
|
565
|
-
let lastError: string | undefined;
|
|
566
|
-
for (let attempt = 0; attempt < this.retryAttempts; attempt++) {
|
|
567
|
-
try {
|
|
568
|
-
const response = await this._makeRequest(
|
|
569
|
-
'POST',
|
|
570
|
-
`${this.gatewayUrl}/services/${encodeURIComponent(serviceName)}/call`,
|
|
571
|
-
{ body: requestData },
|
|
572
|
-
);
|
|
573
|
-
|
|
574
|
-
if (response.status === 200) {
|
|
575
|
-
const resultData = (await response.json()) as {
|
|
576
|
-
result?: unknown;
|
|
577
|
-
};
|
|
578
|
-
// Python returns result_data.get('result', 'No response') which yields
|
|
579
|
-
// the raw string 'No response' when the key is missing. Preserve that:
|
|
580
|
-
// only stringify when the value is defined and non-string.
|
|
581
|
-
let resultText: string;
|
|
582
|
-
if (typeof resultData.result === 'string') {
|
|
583
|
-
resultText = resultData.result;
|
|
584
|
-
} else if (resultData.result != null) {
|
|
585
|
-
resultText = JSON.stringify(resultData.result);
|
|
586
|
-
} else {
|
|
587
|
-
resultText = 'No response';
|
|
588
|
-
}
|
|
589
|
-
return new FunctionResult(resultText);
|
|
590
|
-
}
|
|
591
|
-
|
|
592
|
-
let errorMsg: string;
|
|
593
|
-
try {
|
|
594
|
-
const errorData = (await response.json()) as { error?: string };
|
|
595
|
-
errorMsg = errorData.error ?? `HTTP ${response.status}`;
|
|
596
|
-
} catch {
|
|
597
|
-
// Python includes the first 200 chars of the response body when the
|
|
598
|
-
// payload isn't valid JSON (skill.py error handler). Match that.
|
|
599
|
-
const bodyText = await response.text().catch(() => '');
|
|
600
|
-
errorMsg = bodyText
|
|
601
|
-
? `HTTP ${response.status}: ${bodyText.slice(0, 200)}`
|
|
602
|
-
: `HTTP ${response.status}`;
|
|
603
|
-
}
|
|
604
|
-
lastError = errorMsg;
|
|
605
|
-
|
|
606
|
-
if (response.status >= 500) {
|
|
607
|
-
log.warn('mcp_gateway: server error, retrying', {
|
|
608
|
-
attempt: attempt + 1,
|
|
609
|
-
error: errorMsg,
|
|
610
|
-
});
|
|
611
|
-
continue;
|
|
612
|
-
}
|
|
613
|
-
// Client error — don't retry
|
|
614
|
-
break;
|
|
615
|
-
} catch (err) {
|
|
616
|
-
lastError = err instanceof Error ? err.message : String(err);
|
|
617
|
-
// Distinguish network/timeout errors (retriable) from programming
|
|
618
|
-
// errors like JSON parse failures on success responses (fatal).
|
|
619
|
-
// Python aborts the retry loop on non-network exceptions; mirror that.
|
|
620
|
-
const isNetwork =
|
|
621
|
-
err instanceof Error &&
|
|
622
|
-
(err.name === 'AbortError' ||
|
|
623
|
-
err.name === 'TypeError' ||
|
|
624
|
-
err.message.includes('fetch'));
|
|
625
|
-
if (!isNetwork) {
|
|
626
|
-
log.error('mcp_gateway: unexpected error, aborting retry', {
|
|
627
|
-
attempt: attempt + 1,
|
|
628
|
-
error: lastError,
|
|
629
|
-
});
|
|
630
|
-
break;
|
|
631
|
-
}
|
|
632
|
-
log.warn('mcp_gateway: request error', {
|
|
633
|
-
attempt: attempt + 1,
|
|
634
|
-
error: lastError,
|
|
635
|
-
});
|
|
636
|
-
}
|
|
637
|
-
}
|
|
638
|
-
|
|
639
|
-
const errorMsg = `Failed to call ${serviceName}.${toolName}: ${lastError ?? 'unknown error'}`;
|
|
640
|
-
log.error('mcp_gateway: call failed', { error: errorMsg });
|
|
641
|
-
return new FunctionResult(errorMsg);
|
|
642
|
-
}
|
|
643
|
-
|
|
644
|
-
/** Handle call hangup — clean up any MCP session on the gateway. */
|
|
645
|
-
private async _hangupHandler(
|
|
646
|
-
_args: Record<string, unknown>,
|
|
647
|
-
rawData: Record<string, unknown>,
|
|
648
|
-
): Promise<FunctionResult> {
|
|
649
|
-
const globalData = (rawData['global_data'] as Record<string, unknown>) ?? {};
|
|
650
|
-
const sessionId =
|
|
651
|
-
(globalData['mcp_call_id'] as string | undefined) ??
|
|
652
|
-
(rawData['call_id'] as string | undefined) ??
|
|
653
|
-
'unknown';
|
|
654
|
-
|
|
655
|
-
try {
|
|
656
|
-
const response = await this._makeRequest(
|
|
657
|
-
'DELETE',
|
|
658
|
-
`${this.gatewayUrl}/sessions/${encodeURIComponent(sessionId)}`,
|
|
659
|
-
);
|
|
660
|
-
|
|
661
|
-
if (response.status === 200 || response.status === 404) {
|
|
662
|
-
log.info('mcp_gateway: cleaned up MCP session', { sessionId });
|
|
663
|
-
} else {
|
|
664
|
-
log.warn('mcp_gateway: session cleanup returned non-ok status', {
|
|
665
|
-
status: response.status,
|
|
666
|
-
});
|
|
667
|
-
}
|
|
668
|
-
} catch (err) {
|
|
669
|
-
log.error('mcp_gateway: error cleaning up session', {
|
|
670
|
-
error: err instanceof Error ? err.message : String(err),
|
|
671
|
-
});
|
|
672
|
-
}
|
|
673
|
-
|
|
674
|
-
return new FunctionResult('Session cleanup complete');
|
|
675
|
-
}
|
|
676
|
-
}
|
|
677
|
-
|
|
678
|
-
/**
|
|
679
|
-
* Factory function for creating McpGatewaySkill instances.
|
|
680
|
-
* @param config - Optional skill configuration.
|
|
681
|
-
* @returns A new McpGatewaySkill instance.
|
|
682
|
-
*/
|
|
683
|
-
export function createSkill(config?: SkillConfig): McpGatewaySkill {
|
|
684
|
-
return new McpGatewaySkill(config);
|
|
685
|
-
}
|