@signalwire/sdk 2.0.4 → 3.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +785 -0
- package/LICENSE +21 -0
- package/README.md +163 -68
- package/dist/AGENTS.md +13 -0
- package/dist/AgentBase.d.ts +550 -163
- package/dist/AgentBase.js +1640 -514
- package/dist/AgentBase.js.map +1 -1
- package/dist/AgentServer.d.ts +21 -0
- package/dist/AgentServer.js +154 -47
- package/dist/AgentServer.js.map +1 -1
- package/dist/AuthHandler.d.ts +14 -2
- package/dist/AuthHandler.js +7 -2
- package/dist/AuthHandler.js.map +1 -1
- package/dist/ConfigLoader.d.ts +5 -13
- package/dist/ConfigLoader.js +15 -29
- package/dist/ConfigLoader.js.map +1 -1
- package/dist/ContextBuilder.d.ts +202 -9
- package/dist/ContextBuilder.js +219 -36
- package/dist/ContextBuilder.js.map +1 -1
- package/dist/DataMap.d.ts +158 -45
- package/dist/DataMap.js +167 -52
- package/dist/DataMap.js.map +1 -1
- package/dist/FunctionResult.d.ts +277 -83
- package/dist/FunctionResult.js +444 -116
- package/dist/FunctionResult.js.map +1 -1
- package/dist/Logger.d.ts +30 -5
- package/dist/Logger.js +77 -19
- package/dist/Logger.js.map +1 -1
- package/dist/POM/PromptObjectModel.d.ts +163 -0
- package/dist/POM/PromptObjectModel.js +481 -0
- package/dist/POM/PromptObjectModel.js.map +1 -0
- package/dist/ParameterSchema.d.ts +306 -0
- package/dist/ParameterSchema.js +251 -0
- package/dist/ParameterSchema.js.map +1 -0
- package/dist/PlatformContracts.d.ts +21 -0
- package/dist/PlatformContracts.generated.d.ts +109 -0
- package/dist/PlatformContracts.generated.js +8 -0
- package/dist/PlatformContracts.generated.js.map +1 -0
- package/dist/PlatformContracts.js +2 -0
- package/dist/PlatformContracts.js.map +1 -0
- package/dist/PomBuilder.d.ts +28 -0
- package/dist/PomBuilder.js +81 -3
- package/dist/PomBuilder.js.map +1 -1
- package/dist/PostPrompt.d.ts +110 -0
- package/dist/PostPrompt.js +204 -0
- package/dist/PostPrompt.js.map +1 -0
- package/dist/PromptManager.d.ts +29 -1
- package/dist/PromptManager.js +37 -1
- package/dist/PromptManager.js.map +1 -1
- package/dist/PublicFetch.d.ts +132 -0
- package/dist/PublicFetch.js +311 -0
- package/dist/PublicFetch.js.map +1 -0
- package/dist/RobotsTxt.d.ts +41 -0
- package/dist/RobotsTxt.js +152 -0
- package/dist/RobotsTxt.js.map +1 -0
- package/dist/SWMLHandler.js.map +1 -1
- package/dist/SWMLService.d.ts +265 -66
- package/dist/SWMLService.js +652 -112
- package/dist/SWMLService.js.map +1 -1
- package/dist/SchemaUtils.d.ts +115 -2
- package/dist/SchemaUtils.js +444 -12
- package/dist/SchemaUtils.js.map +1 -1
- package/dist/SecurityUtils.d.ts +55 -8
- package/dist/SecurityUtils.js +162 -49
- package/dist/SecurityUtils.js.map +1 -1
- package/dist/ServerlessAdapter.d.ts +156 -7
- package/dist/ServerlessAdapter.js +399 -42
- package/dist/ServerlessAdapter.js.map +1 -1
- package/dist/SessionManager.d.ts +11 -2
- package/dist/SessionManager.js +50 -18
- package/dist/SessionManager.js.map +1 -1
- package/dist/SslConfig.d.ts +2 -1
- package/dist/SslConfig.js +4 -1
- package/dist/SslConfig.js.map +1 -1
- package/dist/SwaigActions.generated.d.ts +23 -0
- package/dist/SwaigActions.generated.js +8 -0
- package/dist/SwaigActions.generated.js.map +1 -0
- package/dist/SwaigContracts.d.ts +15 -0
- package/dist/SwaigContracts.generated.d.ts +264 -0
- package/dist/SwaigContracts.generated.js +12 -0
- package/dist/SwaigContracts.generated.js.map +1 -0
- package/dist/SwaigContracts.js +2 -0
- package/dist/SwaigContracts.js.map +1 -0
- package/dist/SwaigFunction.d.ts +110 -4
- package/dist/SwaigFunction.js +151 -19
- package/dist/SwaigFunction.js.map +1 -1
- package/dist/SwmlBuilder.d.ts +68 -19
- package/dist/SwmlBuilder.js +74 -38
- package/dist/SwmlBuilder.js.map +1 -1
- package/dist/SwmlVerbMethods.generated.d.ts +41 -4
- package/dist/SwmlVerbMethods.generated.js +1 -1
- package/dist/TypeInference.d.ts +39 -3
- package/dist/TypeInference.js +256 -16
- package/dist/TypeInference.js.map +1 -1
- package/dist/WebService.d.ts +79 -11
- package/dist/WebService.js +320 -109
- package/dist/WebService.js.map +1 -1
- package/dist/WebhookMiddleware.d.ts +119 -0
- package/dist/WebhookMiddleware.js +271 -0
- package/dist/WebhookMiddleware.js.map +1 -0
- package/dist/WebhookValidator.d.ts +92 -0
- package/dist/WebhookValidator.js +409 -0
- package/dist/WebhookValidator.js.map +1 -0
- package/dist/agents/BedrockAgent.d.ts +162 -0
- package/dist/agents/BedrockAgent.js +323 -0
- package/dist/agents/BedrockAgent.js.map +1 -0
- package/dist/ai-chat/AIChatClient.d.ts +316 -0
- package/dist/ai-chat/AIChatClient.js +535 -0
- package/dist/ai-chat/AIChatClient.js.map +1 -0
- package/dist/ai-chat/ChatGateway.d.ts +408 -0
- package/dist/ai-chat/ChatGateway.js +747 -0
- package/dist/ai-chat/ChatGateway.js.map +1 -0
- package/dist/ai-chat/HandoffRouter.d.ts +282 -0
- package/dist/ai-chat/HandoffRouter.js +518 -0
- package/dist/ai-chat/HandoffRouter.js.map +1 -0
- package/dist/ai-chat/index.d.ts +12 -0
- package/dist/ai-chat/index.js +10 -0
- package/dist/ai-chat/index.js.map +1 -0
- package/dist/capabilities.d.ts +64 -0
- package/dist/capabilities.js +95 -0
- package/dist/capabilities.js.map +1 -0
- package/dist/cli/agent-loader.d.ts +32 -6
- package/dist/cli/agent-loader.js +95 -34
- package/dist/cli/agent-loader.js.map +1 -1
- package/dist/cli/datamap-exec.d.ts +175 -0
- package/dist/cli/datamap-exec.js +1284 -0
- package/dist/cli/datamap-exec.js.map +1 -0
- package/dist/cli/function-args.d.ts +40 -0
- package/dist/cli/function-args.js +146 -0
- package/dist/cli/function-args.js.map +1 -0
- package/dist/cli/simulation.d.ts +99 -0
- package/dist/cli/simulation.js +490 -0
- package/dist/cli/simulation.js.map +1 -0
- package/dist/cli/swaig-test.d.ts +12 -25
- package/dist/cli/swaig-test.js +935 -367
- package/dist/cli/swaig-test.js.map +1 -1
- package/dist/cli/tsdocs/agentsNote.d.ts +30 -0
- package/dist/cli/tsdocs/agentsNote.js +92 -0
- package/dist/cli/tsdocs/agentsNote.js.map +1 -0
- package/dist/cli/tsdocs/api-index.json +1 -0
- package/dist/cli/tsdocs/api.d.ts +91 -0
- package/dist/cli/tsdocs/api.js +372 -0
- package/dist/cli/tsdocs/api.js.map +1 -0
- package/dist/cli/tsdocs/apiTypes.d.ts +64 -0
- package/dist/cli/tsdocs/apiTypes.js +7 -0
- package/dist/cli/tsdocs/apiTypes.js.map +1 -0
- package/dist/cli/tsdocs/bin.d.ts +6 -0
- package/dist/cli/tsdocs/bin.js +23 -0
- package/dist/cli/tsdocs/bin.js.map +1 -0
- package/dist/cli/tsdocs/files.d.ts +108 -0
- package/dist/cli/tsdocs/files.js +287 -0
- package/dist/cli/tsdocs/files.js.map +1 -0
- package/dist/cli/tsdocs/index.d.ts +28 -0
- package/dist/cli/tsdocs/index.js +307 -0
- package/dist/cli/tsdocs/index.js.map +1 -0
- package/dist/cli/tsdocs/live.d.ts +41 -0
- package/dist/cli/tsdocs/live.js +202 -0
- package/dist/cli/tsdocs/live.js.map +1 -0
- package/dist/cli/tsdocs/locate.d.ts +51 -0
- package/dist/cli/tsdocs/locate.js +75 -0
- package/dist/cli/tsdocs/locate.js.map +1 -0
- package/dist/cli/tsdocs/render.d.ts +75 -0
- package/dist/cli/tsdocs/render.js +323 -0
- package/dist/cli/tsdocs/render.js.map +1 -0
- package/dist/cli/tsdocs/topics.d.ts +43 -0
- package/dist/cli/tsdocs/topics.js +916 -0
- package/dist/cli/tsdocs/topics.js.map +1 -0
- package/dist/index.d.ts +102 -39
- package/dist/index.js +107 -30
- package/dist/index.js.map +1 -1
- package/dist/livewire/index.d.ts +229 -155
- package/dist/livewire/index.js +298 -195
- package/dist/livewire/index.js.map +1 -1
- package/dist/llms.txt +65 -0
- package/dist/prefabs/CallSessionStore.d.ts +52 -0
- package/dist/prefabs/CallSessionStore.js +72 -0
- package/dist/prefabs/CallSessionStore.js.map +1 -0
- package/dist/prefabs/ConciergeAgent.d.ts +13 -1
- package/dist/prefabs/ConciergeAgent.js +36 -31
- package/dist/prefabs/ConciergeAgent.js.map +1 -1
- package/dist/prefabs/FAQBotAgent.d.ts +9 -1
- package/dist/prefabs/FAQBotAgent.js +113 -47
- package/dist/prefabs/FAQBotAgent.js.map +1 -1
- package/dist/prefabs/InfoGathererAgent.d.ts +22 -3
- package/dist/prefabs/InfoGathererAgent.js +67 -58
- package/dist/prefabs/InfoGathererAgent.js.map +1 -1
- package/dist/prefabs/ReceptionistAgent.d.ts +16 -5
- package/dist/prefabs/ReceptionistAgent.js +39 -31
- package/dist/prefabs/ReceptionistAgent.js.map +1 -1
- package/dist/prefabs/SurveyAgent.d.ts +22 -4
- package/dist/prefabs/SurveyAgent.js +84 -68
- package/dist/prefabs/SurveyAgent.js.map +1 -1
- package/dist/relay/Action.d.ts +44 -21
- package/dist/relay/Action.js +75 -17
- package/dist/relay/Action.js.map +1 -1
- package/dist/relay/Call.d.ts +312 -47
- package/dist/relay/Call.js +369 -18
- package/dist/relay/Call.js.map +1 -1
- package/dist/relay/Deferred.js.map +1 -1
- package/dist/relay/Message.d.ts +26 -5
- package/dist/relay/Message.js +36 -6
- package/dist/relay/Message.js.map +1 -1
- package/dist/relay/RelayClient.d.ts +79 -14
- package/dist/relay/RelayClient.js +268 -61
- package/dist/relay/RelayClient.js.map +1 -1
- package/dist/relay/RelayError.d.ts +14 -0
- package/dist/relay/RelayError.js +15 -0
- package/dist/relay/RelayError.js.map +1 -1
- package/dist/relay/RelayEvent.d.ts +96 -65
- package/dist/relay/RelayEvent.js +85 -56
- package/dist/relay/RelayEvent.js.map +1 -1
- package/dist/relay/closedSets.d.ts +111 -0
- package/dist/relay/closedSets.js +83 -0
- package/dist/relay/closedSets.js.map +1 -0
- package/dist/relay/index.d.ts +3 -1
- package/dist/relay/index.js +1 -0
- package/dist/relay/index.js.map +1 -1
- package/dist/relay/normalize.js.map +1 -1
- package/dist/relay/protocol.types.generated.d.ts +1195 -0
- package/dist/relay/protocol.types.generated.js +8 -0
- package/dist/relay/protocol.types.generated.js.map +1 -0
- package/dist/relay/types.d.ts +81 -39
- package/dist/rest/HttpClient.d.ts +36 -8
- package/dist/rest/HttpClient.js +233 -40
- package/dist/rest/HttpClient.js.map +1 -1
- package/dist/rest/RequestOptions.d.ts +110 -0
- package/dist/rest/RequestOptions.js +113 -0
- package/dist/rest/RequestOptions.js.map +1 -0
- package/dist/rest/RestError.d.ts +52 -6
- package/dist/rest/RestError.js +89 -5
- package/dist/rest/RestError.js.map +1 -1
- package/dist/rest/base/CrudResource.d.ts +16 -26
- package/dist/rest/base/CrudResource.js +19 -33
- package/dist/rest/base/CrudResource.js.map +1 -1
- package/dist/rest/base/CrudWithAddresses.d.ts +3 -2
- package/dist/rest/base/CrudWithAddresses.js +2 -2
- package/dist/rest/base/CrudWithAddresses.js.map +1 -1
- package/dist/rest/base/FabricResource.d.ts +15 -0
- package/dist/rest/base/FabricResource.js +16 -0
- package/dist/rest/base/FabricResource.js.map +1 -0
- package/dist/rest/base/ReadResource.d.ts +62 -0
- package/dist/rest/base/ReadResource.js +69 -0
- package/dist/rest/base/ReadResource.js.map +1 -0
- package/dist/rest/callHandler.d.ts +63 -0
- package/dist/rest/callHandler.js +62 -0
- package/dist/rest/callHandler.js.map +1 -0
- package/dist/rest/index.d.ts +19 -76
- package/dist/rest/index.js +49 -120
- package/dist/rest/index.js.map +1 -1
- package/dist/rest/namespaces/_client_tree_generated.d.ts +103 -0
- package/dist/rest/namespaces/_client_tree_generated.js +171 -0
- package/dist/rest/namespaces/_client_tree_generated.js.map +1 -0
- package/dist/rest/namespaces/addresses.d.ts +3 -42
- package/dist/rest/namespaces/addresses.js +3 -50
- package/dist/rest/namespaces/addresses.js.map +1 -1
- package/dist/rest/namespaces/calling.d.ts +6 -378
- package/dist/rest/namespaces/calling.js +6 -473
- package/dist/rest/namespaces/calling.js.map +1 -1
- package/dist/rest/namespaces/calling.resources.generated.d.ts +165 -0
- package/dist/rest/namespaces/calling.resources.generated.js +477 -0
- package/dist/rest/namespaces/calling.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/calling.types.generated.d.ts +2917 -0
- package/dist/rest/namespaces/calling.types.generated.js +8 -0
- package/dist/rest/namespaces/calling.types.generated.js.map +1 -0
- package/dist/rest/namespaces/chat.d.ts +4 -18
- package/dist/rest/namespaces/chat.js +4 -21
- package/dist/rest/namespaces/chat.js.map +1 -1
- package/dist/rest/namespaces/chat.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/chat.resources.generated.js +29 -0
- package/dist/rest/namespaces/chat.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/chat.types.generated.d.ts +56 -0
- package/dist/rest/namespaces/chat.types.generated.js +8 -0
- package/dist/rest/namespaces/chat.types.generated.js.map +1 -0
- package/dist/rest/namespaces/datasphere.d.ts +6 -62
- package/dist/rest/namespaces/datasphere.js +6 -72
- package/dist/rest/namespaces/datasphere.js.map +1 -1
- package/dist/rest/namespaces/datasphere.resources.generated.d.ts +25 -0
- package/dist/rest/namespaces/datasphere.resources.generated.js +50 -0
- package/dist/rest/namespaces/datasphere.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/datasphere.types.generated.d.ts +180 -0
- package/dist/rest/namespaces/datasphere.types.generated.js +8 -0
- package/dist/rest/namespaces/datasphere.types.generated.js.map +1 -0
- package/dist/rest/namespaces/fabric.d.ts +11 -273
- package/dist/rest/namespaces/fabric.js +14 -363
- package/dist/rest/namespaces/fabric.js.map +1 -1
- package/dist/rest/namespaces/fabric.resources.generated.d.ts +195 -0
- package/dist/rest/namespaces/fabric.resources.generated.js +399 -0
- package/dist/rest/namespaces/fabric.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/fabric.types.generated.d.ts +4557 -0
- package/dist/rest/namespaces/fabric.types.generated.js +8 -0
- package/dist/rest/namespaces/fabric.types.generated.js.map +1 -0
- package/dist/rest/namespaces/fax.resources.generated.d.ts +6 -0
- package/dist/rest/namespaces/fax.resources.generated.js +14 -0
- package/dist/rest/namespaces/fax.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/fax.types.generated.d.ts +131 -0
- package/dist/rest/namespaces/fax.types.generated.js +8 -0
- package/dist/rest/namespaces/fax.types.generated.js.map +1 -0
- package/dist/rest/namespaces/imported-numbers.d.ts +3 -18
- package/dist/rest/namespaces/imported-numbers.js +3 -21
- package/dist/rest/namespaces/imported-numbers.js.map +1 -1
- package/dist/rest/namespaces/logs.d.ts +10 -101
- package/dist/rest/namespaces/logs.js +10 -128
- package/dist/rest/namespaces/logs.js.map +1 -1
- package/dist/rest/namespaces/logs.resources.generated.d.ts +9 -0
- package/dist/rest/namespaces/logs.resources.generated.js +17 -0
- package/dist/rest/namespaces/logs.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/logs.types.generated.d.ts +131 -0
- package/dist/rest/namespaces/logs.types.generated.js +8 -0
- package/dist/rest/namespaces/logs.types.generated.js.map +1 -0
- package/dist/rest/namespaces/lookup.d.ts +3 -25
- package/dist/rest/namespaces/lookup.js +3 -27
- package/dist/rest/namespaces/lookup.js.map +1 -1
- package/dist/rest/namespaces/message.resources.generated.d.ts +6 -0
- package/dist/rest/namespaces/message.resources.generated.js +14 -0
- package/dist/rest/namespaces/message.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/message.types.generated.d.ts +122 -0
- package/dist/rest/namespaces/message.types.generated.js +8 -0
- package/dist/rest/namespaces/message.types.generated.js.map +1 -0
- package/dist/rest/namespaces/messages.resources.generated.d.ts +18 -0
- package/dist/rest/namespaces/messages.resources.generated.js +44 -0
- package/dist/rest/namespaces/messages.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/messages.types.generated.d.ts +99 -0
- package/dist/rest/namespaces/messages.types.generated.js +8 -0
- package/dist/rest/namespaces/messages.types.generated.js.map +1 -0
- package/dist/rest/namespaces/mfa.d.ts +3 -42
- package/dist/rest/namespaces/mfa.js +3 -49
- package/dist/rest/namespaces/mfa.js.map +1 -1
- package/dist/rest/namespaces/number-groups.d.ts +3 -45
- package/dist/rest/namespaces/number-groups.js +3 -53
- package/dist/rest/namespaces/number-groups.js.map +1 -1
- package/dist/rest/namespaces/phone-numbers.d.ts +9 -57
- package/dist/rest/namespaces/phone-numbers.js +9 -63
- package/dist/rest/namespaces/phone-numbers.js.map +1 -1
- package/dist/rest/namespaces/project.d.ts +6 -42
- package/dist/rest/namespaces/project.js +6 -51
- package/dist/rest/namespaces/project.js.map +1 -1
- package/dist/rest/namespaces/project.resources.generated.d.ts +17 -0
- package/dist/rest/namespaces/project.resources.generated.js +44 -0
- package/dist/rest/namespaces/project.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/project.types.generated.d.ts +58 -0
- package/dist/rest/namespaces/project.types.generated.js +8 -0
- package/dist/rest/namespaces/project.types.generated.js.map +1 -0
- package/dist/rest/namespaces/projects.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/projects.resources.generated.js +25 -0
- package/dist/rest/namespaces/projects.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/projects.types.generated.d.ts +77 -0
- package/dist/rest/namespaces/projects.types.generated.js +8 -0
- package/dist/rest/namespaces/projects.types.generated.js.map +1 -0
- package/dist/rest/namespaces/pubsub.d.ts +4 -18
- package/dist/rest/namespaces/pubsub.js +4 -21
- package/dist/rest/namespaces/pubsub.js.map +1 -1
- package/dist/rest/namespaces/pubsub.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/pubsub.resources.generated.js +29 -0
- package/dist/rest/namespaces/pubsub.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/pubsub.types.generated.d.ts +60 -0
- package/dist/rest/namespaces/pubsub.types.generated.js +8 -0
- package/dist/rest/namespaces/pubsub.types.generated.js.map +1 -0
- package/dist/rest/namespaces/queues.d.ts +3 -38
- package/dist/rest/namespaces/queues.js +3 -44
- package/dist/rest/namespaces/queues.js.map +1 -1
- package/dist/rest/namespaces/recordings.d.ts +3 -34
- package/dist/rest/namespaces/recordings.js +3 -40
- package/dist/rest/namespaces/recordings.js.map +1 -1
- package/dist/rest/namespaces/registry.d.ts +6 -137
- package/dist/rest/namespaces/registry.js +6 -173
- package/dist/rest/namespaces/registry.js.map +1 -1
- package/dist/rest/namespaces/relay-rest.resources.generated.d.ts +168 -0
- package/dist/rest/namespaces/relay-rest.resources.generated.js +430 -0
- package/dist/rest/namespaces/relay-rest.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/relay-rest.types.generated.d.ts +1906 -0
- package/dist/rest/namespaces/relay-rest.types.generated.js +8 -0
- package/dist/rest/namespaces/relay-rest.types.generated.js.map +1 -0
- package/dist/rest/namespaces/short-codes.d.ts +3 -35
- package/dist/rest/namespaces/short-codes.js +3 -41
- package/dist/rest/namespaces/short-codes.js.map +1 -1
- package/dist/rest/namespaces/sip-profile.d.ts +3 -24
- package/dist/rest/namespaces/sip-profile.js +3 -29
- package/dist/rest/namespaces/sip-profile.js.map +1 -1
- package/dist/rest/namespaces/verified-callers.d.ts +3 -29
- package/dist/rest/namespaces/verified-callers.js +3 -34
- package/dist/rest/namespaces/verified-callers.js.map +1 -1
- package/dist/rest/namespaces/video.d.ts +10 -227
- package/dist/rest/namespaces/video.js +10 -288
- package/dist/rest/namespaces/video.js.map +1 -1
- package/dist/rest/namespaces/video.resources.generated.d.ts +81 -0
- package/dist/rest/namespaces/video.resources.generated.js +171 -0
- package/dist/rest/namespaces/video.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/video.types.generated.d.ts +771 -0
- package/dist/rest/namespaces/video.types.generated.js +8 -0
- package/dist/rest/namespaces/video.types.generated.js.map +1 -0
- package/dist/rest/namespaces/voice.resources.generated.d.ts +9 -0
- package/dist/rest/namespaces/voice.resources.generated.js +17 -0
- package/dist/rest/namespaces/voice.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/voice.types.generated.d.ts +214 -0
- package/dist/rest/namespaces/voice.types.generated.js +8 -0
- package/dist/rest/namespaces/voice.types.generated.js.map +1 -0
- package/dist/rest/pagination.d.ts +5 -1
- package/dist/rest/pagination.js +40 -20
- package/dist/rest/pagination.js.map +1 -1
- package/dist/rest/types.d.ts +21 -3
- package/dist/schema.json +299 -98
- package/dist/skills/SkillBase.d.ts +97 -20
- package/dist/skills/SkillBase.js +100 -17
- package/dist/skills/SkillBase.js.map +1 -1
- package/dist/skills/SkillManager.d.ts +66 -13
- package/dist/skills/SkillManager.js +101 -20
- package/dist/skills/SkillManager.js.map +1 -1
- package/dist/skills/SkillName.d.ts +44 -0
- package/dist/skills/SkillName.js +2 -0
- package/dist/skills/SkillName.js.map +1 -0
- package/dist/skills/SkillRegistry.d.ts +47 -7
- package/dist/skills/SkillRegistry.js +85 -13
- package/dist/skills/SkillRegistry.js.map +1 -1
- package/dist/skills/builtin/api_ninjas_trivia.d.ts +3 -1
- package/dist/skills/builtin/api_ninjas_trivia.js +24 -8
- package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -1
- package/dist/skills/builtin/ask_claude.d.ts +14 -4
- package/dist/skills/builtin/ask_claude.js +36 -14
- package/dist/skills/builtin/ask_claude.js.map +1 -1
- package/dist/skills/builtin/claude_skills.d.ts +3 -1
- package/dist/skills/builtin/claude_skills.js +19 -15
- package/dist/skills/builtin/claude_skills.js.map +1 -1
- package/dist/skills/builtin/custom_skills.d.ts +10 -3
- package/dist/skills/builtin/custom_skills.js +26 -9
- package/dist/skills/builtin/custom_skills.js.map +1 -1
- package/dist/skills/builtin/datasphere.d.ts +5 -3
- package/dist/skills/builtin/datasphere.js +34 -25
- package/dist/skills/builtin/datasphere.js.map +1 -1
- package/dist/skills/builtin/datasphere_serverless.d.ts +12 -1
- package/dist/skills/builtin/datasphere_serverless.js +17 -6
- package/dist/skills/builtin/datasphere_serverless.js.map +1 -1
- package/dist/skills/builtin/datetime.d.ts +3 -1
- package/dist/skills/builtin/datetime.js +11 -7
- package/dist/skills/builtin/datetime.js.map +1 -1
- package/dist/skills/builtin/google_maps.d.ts +29 -14
- package/dist/skills/builtin/google_maps.js +89 -269
- package/dist/skills/builtin/google_maps.js.map +1 -1
- package/dist/skills/builtin/index.d.ts +8 -6
- package/dist/skills/builtin/index.js +8 -6
- package/dist/skills/builtin/index.js.map +1 -1
- package/dist/skills/builtin/info_gatherer.d.ts +4 -2
- package/dist/skills/builtin/info_gatherer.js +20 -12
- package/dist/skills/builtin/info_gatherer.js.map +1 -1
- package/dist/skills/builtin/joke.d.ts +16 -6
- package/dist/skills/builtin/joke.js +54 -37
- package/dist/skills/builtin/joke.js.map +1 -1
- package/dist/skills/builtin/math.d.ts +3 -1
- package/dist/skills/builtin/math.js +14 -9
- package/dist/skills/builtin/math.js.map +1 -1
- package/dist/skills/builtin/mcp_gateway.d.ts +34 -5
- package/dist/skills/builtin/mcp_gateway.js +77 -46
- package/dist/skills/builtin/mcp_gateway.js.map +1 -1
- package/dist/skills/builtin/native_vector_search.d.ts +19 -5
- package/dist/skills/builtin/native_vector_search.js +179 -61
- package/dist/skills/builtin/native_vector_search.js.map +1 -1
- package/dist/skills/builtin/play_background_file.d.ts +21 -15
- package/dist/skills/builtin/play_background_file.js +43 -122
- package/dist/skills/builtin/play_background_file.js.map +1 -1
- package/dist/skills/builtin/spider.d.ts +46 -1
- package/dist/skills/builtin/spider.js +317 -101
- package/dist/skills/builtin/spider.js.map +1 -1
- package/dist/skills/builtin/swml_transfer.d.ts +14 -3
- package/dist/skills/builtin/swml_transfer.js +45 -24
- package/dist/skills/builtin/swml_transfer.js.map +1 -1
- package/dist/skills/builtin/weather_api.d.ts +24 -13
- package/dist/skills/builtin/weather_api.js +57 -31
- package/dist/skills/builtin/weather_api.js.map +1 -1
- package/dist/skills/builtin/web_search.d.ts +48 -10
- package/dist/skills/builtin/web_search.js +301 -84
- package/dist/skills/builtin/web_search.js.map +1 -1
- package/dist/skills/builtin/wikipedia_search.d.ts +4 -2
- package/dist/skills/builtin/wikipedia_search.js +32 -14
- package/dist/skills/builtin/wikipedia_search.js.map +1 -1
- package/dist/skills/index.d.ts +3 -2
- package/dist/skills/index.js +1 -1
- package/dist/skills/index.js.map +1 -1
- package/dist/swml_verbs_generated.d.ts +2824 -0
- package/dist/swml_verbs_generated.js +12 -0
- package/dist/swml_verbs_generated.js.map +1 -0
- package/dist/types.d.ts +65 -6
- package/dist/web.d.ts +27 -0
- package/dist/web.js +20 -0
- package/dist/web.js.map +1 -0
- package/docs/agent-guide.md +1034 -0
- package/docs/ai_chat.md +560 -0
- package/docs/api-reference.md +3534 -0
- package/docs/architecture.md +846 -0
- package/docs/bedrock_agent.md +411 -0
- package/docs/cli-guide.md +403 -0
- package/docs/cloud_functions_guide.md +399 -0
- package/docs/configuration.md +548 -0
- package/docs/contexts-guide.md +884 -0
- package/docs/datamap-guide.md +1160 -0
- package/docs/developer_pain_points.md +548 -0
- package/docs/llm_parameters.md +298 -0
- package/docs/mcp_gateway_reference.md +354 -0
- package/docs/mcp_integration.md +162 -0
- package/docs/pgi_agent_guide.md +1820 -0
- package/docs/prefabs-guide.md +815 -0
- package/docs/programmatically_governed_inference.md +301 -0
- package/docs/sdk_features.md +501 -0
- package/docs/security.md +559 -0
- package/docs/serverless-guide.md +520 -0
- package/docs/skills-guide.md +1223 -0
- package/docs/skills-system.md +405 -0
- package/docs/skills_parameter_schema.md +417 -0
- package/docs/swaig-reference.md +1938 -0
- package/docs/swml_service_guide.md +573 -0
- package/docs/third_party_skills.md +410 -0
- package/docs/web_service.md +666 -0
- package/examples/README.md +202 -0
- package/examples/advanced-datamap.ts +108 -0
- package/examples/advanced-dynamic-config.ts +70 -0
- package/examples/auto-vivified.ts +95 -0
- package/examples/call-flow.ts +65 -0
- package/examples/comprehensive-dynamic.ts +125 -0
- package/examples/contexts-steps.ts +65 -0
- package/examples/custom-path.ts +45 -0
- package/examples/datamap-tools.ts +51 -0
- package/examples/datasphere-multi-instance.ts +66 -0
- package/examples/datasphere-serverless-env.ts +87 -0
- package/examples/datasphere-webhook-env.ts +65 -0
- package/examples/datasphere.ts +56 -0
- package/examples/declarative.ts +100 -0
- package/examples/dynamic-config.ts +54 -0
- package/examples/dynamic-info-gatherer.ts +69 -0
- package/examples/dynamic-swml-service.ts +67 -0
- package/examples/gather-info.ts +95 -0
- package/examples/gather-per-question-functions-demo.ts +139 -0
- package/examples/joke-agent.ts +34 -0
- package/examples/kubernetes-agent.ts +45 -0
- package/examples/llm-params.ts +75 -0
- package/examples/mcp-agent.ts +89 -0
- package/examples/mcp-gateway.ts +81 -0
- package/examples/multi-agent.ts +80 -0
- package/examples/multi-endpoint.ts +79 -0
- package/examples/pgi/case-domain.ts +114 -0
- package/examples/pgi/serve.ts +16 -0
- package/examples/pgi/support-agent.ts +265 -0
- package/examples/pom-prompt.ts +70 -0
- package/examples/prefab-concierge.ts +42 -0
- package/examples/prefab-faq.ts +58 -0
- package/examples/prefab-info-gatherer.ts +33 -0
- package/examples/prefab-receptionist.ts +36 -0
- package/examples/prefab-survey.ts +69 -0
- package/examples/quickstart-agent.ts +29 -0
- package/examples/quickstart-relay.ts +25 -0
- package/examples/quickstart-rest.ts +25 -0
- package/examples/record-call.ts +65 -0
- package/examples/relay-demo.ts +33 -0
- package/examples/room-and-sip.ts +93 -0
- package/examples/serverless-lambda.ts +43 -0
- package/examples/session-state.ts +83 -0
- package/examples/simple-agent.ts +36 -0
- package/examples/simple-static.ts +29 -0
- package/examples/skills-demo.ts +41 -0
- package/examples/step-function-inheritance-demo.ts +124 -0
- package/examples/swaig-features.ts +193 -0
- package/examples/swml-service-routing.ts +66 -0
- package/examples/swml-service.ts +38 -0
- package/examples/swmlservice_ai_sidecar.ts +104 -0
- package/examples/swmlservice_swaig_standalone.ts +79 -0
- package/examples/tap.ts +67 -0
- package/examples/typed-tools.ts +68 -0
- package/examples/verb-methods.ts +45 -0
- package/examples/web-search-multi-instance.ts +75 -0
- package/examples/web-search.ts +38 -0
- package/examples/wikipedia.ts +36 -0
- package/livewire/README.md +164 -0
- package/livewire/docs/migration-guide.md +251 -0
- package/livewire/examples/livewire-basic-agent.ts +74 -0
- package/livewire/examples/livewire-handoff.ts +196 -0
- package/livewire/examples/livewire-multi-tool.ts +121 -0
- package/package.json +88 -13
- package/relay/README.md +101 -0
- package/relay/docs/call-methods.md +622 -0
- package/relay/docs/client-reference.md +281 -0
- package/relay/docs/events.md +193 -0
- package/relay/docs/getting-started.md +221 -0
- package/relay/docs/guide.md +386 -0
- package/relay/docs/messaging.md +246 -0
- package/relay/examples/relay-inbound.ts +66 -0
- package/relay/examples/relay-messaging.ts +74 -0
- package/relay/examples/relay-outbound.ts +76 -0
- package/rest/README.md +141 -0
- package/rest/docs/calling.md +313 -0
- package/rest/docs/client-reference.md +149 -0
- package/rest/docs/fabric.md +192 -0
- package/rest/docs/getting-started.md +138 -0
- package/rest/docs/guide.md +421 -0
- package/rest/docs/namespaces.md +367 -0
- package/rest/docs/phone-binding.md +116 -0
- package/rest/examples/rest-10dlc-registration.ts +177 -0
- package/rest/examples/rest-bind-phone-to-swml-webhook.ts +66 -0
- package/rest/examples/rest-calling-ivr-and-ai.ts +136 -0
- package/rest/examples/rest-calling-play-and-record.ts +98 -0
- package/rest/examples/rest-client.ts +59 -0
- package/rest/examples/rest-datasphere-search.ts +81 -0
- package/rest/examples/rest-fabric-conferences-and-routing.ts +147 -0
- package/rest/examples/rest-fabric-subscribers-and-sip.ts +106 -0
- package/rest/examples/rest-fabric-swml-and-callflows.ts +101 -0
- package/rest/examples/rest-manage-resources.ts +64 -0
- package/rest/examples/rest-phone-number-management.ts +200 -0
- package/rest/examples/rest-queues-mfa-and-recordings.ts +143 -0
- package/rest/examples/rest-video-rooms.ts +186 -0
- package/tutorial/fred/fred.ts +218 -0
- package/tutorial/fred/tutorial/01-introduction.md +141 -0
- package/tutorial/fred/tutorial/02-setup.md +304 -0
- package/tutorial/fred/tutorial/03-basic-agent.md +284 -0
- package/tutorial/fred/tutorial/04-wikipedia-skill.md +298 -0
- package/tutorial/fred/tutorial/05-custom-functions.md +347 -0
- package/tutorial/fred/tutorial/06-running-testing.md +642 -0
- package/tutorial/fred/tutorial/README.md +56 -0
- package/tutorial/fred/tutorial/appendix-complete-code.md +632 -0
- package/tutorial/fred/tutorial/appendix-docker-deployment.md +504 -0
- package/tutorial/full-guardrails-agent/handlers.ts +436 -0
- package/tutorial/full-guardrails-agent/penny.ts +305 -0
- package/tutorial/full-guardrails-agent/reservations.ts +1109 -0
- package/tutorial/full-guardrails-agent/tutorial/01-why-guardrails.md +149 -0
- package/tutorial/full-guardrails-agent/tutorial/02-design-first.md +139 -0
- package/tutorial/full-guardrails-agent/tutorial/03-rules-first.md +422 -0
- package/tutorial/full-guardrails-agent/tutorial/04-the-shell.md +238 -0
- package/tutorial/full-guardrails-agent/tutorial/05-steps-and-scoping.md +247 -0
- package/tutorial/full-guardrails-agent/tutorial/06-tools-that-decide.md +467 -0
- package/tutorial/full-guardrails-agent/tutorial/07-gather-and-projection.md +160 -0
- package/tutorial/full-guardrails-agent/tutorial/08-the-verification-gate.md +333 -0
- package/tutorial/full-guardrails-agent/tutorial/09-people-and-endings.md +313 -0
- package/tutorial/full-guardrails-agent/tutorial/10-testing-and-running.md +387 -0
- package/tutorial/full-guardrails-agent/tutorial/README.md +106 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-complete-code.md +2207 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-deployment.md +191 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-technique-map.md +117 -0
- package/tutorial/full-guardrails-agent/workflow.ts +219 -0
- package/tutorial/multi_agents/README.md +175 -0
- package/tutorial/multi_agents/advanced_agent.ts +395 -0
- package/tutorial/multi_agents/extending_agents.ts +641 -0
- package/tutorial/multi_agents/knowledge.ts +59 -0
- package/tutorial/multi_agents/lesson1_first_agent.md +368 -0
- package/tutorial/multi_agents/lesson2_knowledge_bases.md +404 -0
- package/tutorial/multi_agents/lesson3_multi_agent_systems.md +621 -0
- package/tutorial/multi_agents/lesson4_advanced_features.md +805 -0
- package/tutorial/multi_agents/lesson5_extending_agents.md +856 -0
- package/tutorial/multi_agents/pc_builder.ts +529 -0
- package/tutorial/multi_agents/sales_agent.ts +88 -0
- package/tutorial/multi_agents/sales_agent_with_search.ts +116 -0
- package/tutorial/multi_agents/sales_knowledge.md +139 -0
- package/tutorial/multi_agents/support_knowledge.md +256 -0
- package/dist/cli/mock-data.d.ts +0 -37
- package/dist/cli/mock-data.js +0 -80
- package/dist/cli/mock-data.js.map +0 -1
- package/dist/generateVerbTypes.d.ts +0 -11
- package/dist/generateVerbTypes.js +0 -265
- package/dist/generateVerbTypes.js.map +0 -1
- package/dist/rest/namespaces/compat.d.ts +0 -585
- package/dist/rest/namespaces/compat.js +0 -735
- package/dist/rest/namespaces/compat.js.map +0 -1
package/dist/SWMLService.js
CHANGED
|
@@ -8,12 +8,15 @@
|
|
|
8
8
|
import { Hono } from 'hono';
|
|
9
9
|
import { cors } from 'hono/cors';
|
|
10
10
|
import { basicAuth } from 'hono/basic-auth';
|
|
11
|
-
import { randomBytes } from 'node:crypto';
|
|
11
|
+
import { createHash, randomBytes, timingSafeEqual } from 'node:crypto';
|
|
12
|
+
import { corsOriginsFromEnv } from './SecurityUtils.js';
|
|
12
13
|
import { SwmlBuilder } from './SwmlBuilder.js';
|
|
13
14
|
import { SchemaUtils } from './SchemaUtils.js';
|
|
14
15
|
import { SslConfig } from './SslConfig.js';
|
|
15
16
|
import { ConfigLoader } from './ConfigLoader.js';
|
|
16
17
|
import { getLogger } from './Logger.js';
|
|
18
|
+
import { SwaigFunction } from './SwaigFunction.js';
|
|
19
|
+
import { FunctionResult } from './FunctionResult.js';
|
|
17
20
|
/**
|
|
18
21
|
* Registry for custom SWML verb handlers.
|
|
19
22
|
* Mirrors Python SDK's `VerbHandlerRegistry`.
|
|
@@ -51,6 +54,20 @@ export class SecurityConfig {
|
|
|
51
54
|
basicAuthUser;
|
|
52
55
|
/** Basic auth password from config, or null. */
|
|
53
56
|
basicAuthPassword;
|
|
57
|
+
/**
|
|
58
|
+
* Where {@link basicAuthPassword} came from: `'environment'`
|
|
59
|
+
* (`SWML_BASIC_AUTH_PASSWORD`), `'config file'` (which takes precedence), or
|
|
60
|
+
* `null` when neither set one.
|
|
61
|
+
*/
|
|
62
|
+
basicAuthSource;
|
|
63
|
+
/** Allowed request hosts (`['*']` = allow all). */
|
|
64
|
+
allowedHosts;
|
|
65
|
+
/** Allowed CORS origins. */
|
|
66
|
+
corsOrigins;
|
|
67
|
+
/** Whether to emit an HSTS header on HTTPS responses. */
|
|
68
|
+
useHsts;
|
|
69
|
+
/** HSTS `max-age` in seconds. */
|
|
70
|
+
hstsMaxAge;
|
|
54
71
|
sslConfig;
|
|
55
72
|
constructor(opts) {
|
|
56
73
|
// Load SSL config from env vars / options
|
|
@@ -59,14 +76,50 @@ export class SecurityConfig {
|
|
|
59
76
|
this.sslCertPath = this.sslConfig.certPath;
|
|
60
77
|
this.sslKeyPath = this.sslConfig.keyPath;
|
|
61
78
|
this.domain = this.sslConfig.domain;
|
|
62
|
-
// Auth defaults from env vars
|
|
63
|
-
this.basicAuthUser = process.env['SWML_BASIC_AUTH_USER']
|
|
64
|
-
this.basicAuthPassword = process.env['SWML_BASIC_AUTH_PASSWORD']
|
|
79
|
+
// Auth + host/CORS/HSTS defaults from env vars
|
|
80
|
+
this.basicAuthUser = process.env['SWML_BASIC_AUTH_USER'] || null;
|
|
81
|
+
this.basicAuthPassword = process.env['SWML_BASIC_AUTH_PASSWORD'] || null;
|
|
82
|
+
this.basicAuthSource = this.basicAuthPassword ? 'environment' : null;
|
|
83
|
+
this.allowedHosts = ['*'];
|
|
84
|
+
this.corsOrigins = ['*'];
|
|
85
|
+
this.useHsts = true;
|
|
86
|
+
this.hstsMaxAge = 31536000;
|
|
87
|
+
this.loadFromEnv();
|
|
65
88
|
// Load from config file if available
|
|
66
89
|
if (opts?.configFile) {
|
|
67
90
|
this.loadFromConfigFile(opts.configFile);
|
|
68
91
|
}
|
|
69
92
|
}
|
|
93
|
+
/** Split a comma-separated env value into a trimmed, non-empty list. */
|
|
94
|
+
static parseList(value) {
|
|
95
|
+
if (value === undefined)
|
|
96
|
+
return null;
|
|
97
|
+
const items = value
|
|
98
|
+
.split(',')
|
|
99
|
+
.map((s) => s.trim())
|
|
100
|
+
.filter((s) => s.length > 0);
|
|
101
|
+
return items.length > 0 ? items : null;
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
* (Re)load host/CORS/HSTS settings from environment variables. Mirrors Python
|
|
105
|
+
* SDK's `SecurityConfig.load_from_env()`. SSL/auth are loaded in the constructor
|
|
106
|
+
* from their own env vars; this refreshes the network-policy fields.
|
|
107
|
+
*/
|
|
108
|
+
loadFromEnv() {
|
|
109
|
+
const hosts = SecurityConfig.parseList(process.env['SWML_ALLOWED_HOSTS']);
|
|
110
|
+
if (hosts)
|
|
111
|
+
this.allowedHosts = hosts;
|
|
112
|
+
const cors = SecurityConfig.parseList(process.env['SWML_CORS_ORIGINS']);
|
|
113
|
+
if (cors)
|
|
114
|
+
this.corsOrigins = cors;
|
|
115
|
+
if (process.env['SWML_USE_HSTS'] !== undefined) {
|
|
116
|
+
this.useHsts = process.env['SWML_USE_HSTS'] === 'true';
|
|
117
|
+
}
|
|
118
|
+
const maxAge = process.env['SWML_HSTS_MAX_AGE'];
|
|
119
|
+
if (maxAge !== undefined && !Number.isNaN(Number(maxAge))) {
|
|
120
|
+
this.hstsMaxAge = Number(maxAge);
|
|
121
|
+
}
|
|
122
|
+
}
|
|
70
123
|
loadFromConfigFile(filePath) {
|
|
71
124
|
try {
|
|
72
125
|
const loader = new ConfigLoader(filePath);
|
|
@@ -81,22 +134,35 @@ export class SecurityConfig {
|
|
|
81
134
|
if (typeof ssl['domain'] === 'string')
|
|
82
135
|
this.domain = ssl['domain'];
|
|
83
136
|
}
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
137
|
+
// `security.auth.basic` is the reference's key; `security.basicAuth` is
|
|
138
|
+
// this SDK's earlier spelling, still read. The config file takes
|
|
139
|
+
// precedence over the environment.
|
|
140
|
+
for (const key of ['security.basicAuth', 'security.auth.basic']) {
|
|
141
|
+
const auth = loader.get(key);
|
|
142
|
+
if (!auth || typeof auth !== 'object')
|
|
143
|
+
continue;
|
|
144
|
+
// An empty value sets nothing: an empty password would otherwise
|
|
145
|
+
// erase a working one from the environment and leave the service
|
|
146
|
+
// with no configured credentials.
|
|
147
|
+
if (typeof auth['user'] === 'string' && auth['user'])
|
|
87
148
|
this.basicAuthUser = auth['user'];
|
|
88
|
-
if (typeof auth['password'] === 'string')
|
|
149
|
+
if (typeof auth['password'] === 'string' && auth['password']) {
|
|
89
150
|
this.basicAuthPassword = auth['password'];
|
|
151
|
+
this.basicAuthSource = 'config file';
|
|
152
|
+
}
|
|
90
153
|
}
|
|
91
154
|
}
|
|
92
155
|
catch {
|
|
93
156
|
// Config file load failures are non-fatal
|
|
94
157
|
}
|
|
95
158
|
}
|
|
96
|
-
/**
|
|
159
|
+
/**
|
|
160
|
+
* Get basic auth credentials from the config file or environment, or null
|
|
161
|
+
* when no password is configured. The user defaults to `signalwire`.
|
|
162
|
+
*/
|
|
97
163
|
getBasicAuth() {
|
|
98
|
-
if (this.
|
|
99
|
-
return [this.basicAuthUser, this.basicAuthPassword];
|
|
164
|
+
if (this.basicAuthPassword) {
|
|
165
|
+
return [this.basicAuthUser || 'signalwire', this.basicAuthPassword];
|
|
100
166
|
}
|
|
101
167
|
return null;
|
|
102
168
|
}
|
|
@@ -110,6 +176,85 @@ export class SecurityConfig {
|
|
|
110
176
|
return [false, 'SSL key path not configured'];
|
|
111
177
|
return this.sslConfig.isConfigured() ? [true, null] : [false, 'SSL cert or key file not found'];
|
|
112
178
|
}
|
|
179
|
+
/**
|
|
180
|
+
* Build the SSL parameters for the HTTPS server, as a plain dictionary of
|
|
181
|
+
* primitive filesystem paths. Mirrors Python's
|
|
182
|
+
* `SecurityConfig.get_ssl_context_kwargs()` verbatim: the reference targets
|
|
183
|
+
* uvicorn's `ssl_certfile`/`ssl_keyfile` kwargs, and this returns the exact
|
|
184
|
+
* same primitive path pair (the TS HTTPS server passes them to
|
|
185
|
+
* `node:https.createServer` / `readFileSync`). Returns an empty object when
|
|
186
|
+
* SSL is disabled or the cert/key files fail validation.
|
|
187
|
+
* @returns `{ ssl_certfile, ssl_keyfile }` path strings, or `{}` when unavailable.
|
|
188
|
+
*/
|
|
189
|
+
getSslContextKwargs() {
|
|
190
|
+
if (!this.sslEnabled)
|
|
191
|
+
return {};
|
|
192
|
+
const [isValid] = this.validateSslConfig();
|
|
193
|
+
if (!isValid)
|
|
194
|
+
return {};
|
|
195
|
+
return {
|
|
196
|
+
ssl_certfile: this.sslCertPath,
|
|
197
|
+
ssl_keyfile: this.sslKeyPath,
|
|
198
|
+
};
|
|
199
|
+
}
|
|
200
|
+
/** Get the URL scheme based on SSL configuration. Mirrors Python's `get_url_scheme()`. */
|
|
201
|
+
getUrlScheme() {
|
|
202
|
+
return this.sslEnabled ? 'https' : 'http';
|
|
203
|
+
}
|
|
204
|
+
/**
|
|
205
|
+
* Check whether a host is allowed. Mirrors Python's `should_allow_host()`:
|
|
206
|
+
* a wildcard `*` in the allow-list permits any host.
|
|
207
|
+
*/
|
|
208
|
+
shouldAllowHost(host) {
|
|
209
|
+
if (this.allowedHosts.includes('*'))
|
|
210
|
+
return true;
|
|
211
|
+
return this.allowedHosts.includes(host);
|
|
212
|
+
}
|
|
213
|
+
/**
|
|
214
|
+
* Get CORS configuration. Mirrors Python's `get_cors_config()`.
|
|
215
|
+
* @returns An object of CORS settings (origins, credentials, methods, headers).
|
|
216
|
+
*/
|
|
217
|
+
getCorsConfig() {
|
|
218
|
+
return {
|
|
219
|
+
allow_origins: this.corsOrigins,
|
|
220
|
+
allow_credentials: true,
|
|
221
|
+
allow_methods: ['*'],
|
|
222
|
+
allow_headers: ['*'],
|
|
223
|
+
};
|
|
224
|
+
}
|
|
225
|
+
/**
|
|
226
|
+
* Get the security headers to add to responses. Mirrors Python's
|
|
227
|
+
* `get_security_headers()`; adds an HSTS header when the request is HTTPS and
|
|
228
|
+
* HSTS is enabled.
|
|
229
|
+
* @param isHttps - Whether the connection is over HTTPS.
|
|
230
|
+
*/
|
|
231
|
+
getSecurityHeaders(isHttps = false) {
|
|
232
|
+
const headers = {
|
|
233
|
+
'X-Content-Type-Options': 'nosniff',
|
|
234
|
+
'X-Frame-Options': 'DENY',
|
|
235
|
+
'X-XSS-Protection': '1; mode=block',
|
|
236
|
+
'Referrer-Policy': 'strict-origin-when-cross-origin',
|
|
237
|
+
};
|
|
238
|
+
if (isHttps && this.useHsts) {
|
|
239
|
+
headers['Strict-Transport-Security'] = `max-age=${this.hstsMaxAge}; includeSubDomains`;
|
|
240
|
+
}
|
|
241
|
+
return headers;
|
|
242
|
+
}
|
|
243
|
+
/**
|
|
244
|
+
* Log the current security configuration. Mirrors Python's `log_config()`.
|
|
245
|
+
* @param serviceName - The service name to tag the log line with.
|
|
246
|
+
*/
|
|
247
|
+
logConfig(serviceName) {
|
|
248
|
+
getLogger('SecurityConfig').info('security_config_loaded', {
|
|
249
|
+
service: serviceName,
|
|
250
|
+
ssl_enabled: this.sslEnabled,
|
|
251
|
+
domain: this.domain,
|
|
252
|
+
allowed_hosts: this.allowedHosts,
|
|
253
|
+
cors_origins: this.corsOrigins,
|
|
254
|
+
use_hsts: this.useHsts,
|
|
255
|
+
has_basic_auth: !!(this.basicAuthUser && this.basicAuthPassword),
|
|
256
|
+
});
|
|
257
|
+
}
|
|
113
258
|
}
|
|
114
259
|
// ── SWMLService class ──────────────────────────────────────────────────
|
|
115
260
|
/**
|
|
@@ -135,6 +280,21 @@ export class SecurityConfig {
|
|
|
135
280
|
* @see {@link SwmlBuilder} — the underlying SWML document builder
|
|
136
281
|
* @see {@link AgentBase} — AI-powered alternative
|
|
137
282
|
*/
|
|
283
|
+
/**
|
|
284
|
+
* Services constructed while swaig-test imports a file (SWAIG_CLI_MODE). Kept
|
|
285
|
+
* on globalThis under a registered symbol, so it's one list even when the
|
|
286
|
+
* agent file loads its own copy of the SDK (a CommonJS file, or another
|
|
287
|
+
* build of the package) from the one swaig-test runs.
|
|
288
|
+
*/
|
|
289
|
+
const cliLoadedServices = (globalThis[Symbol.for('signalwire.swaigTest.loadedServices')] ??= []);
|
|
290
|
+
/**
|
|
291
|
+
* The services constructed since the last call, while swaig-test was
|
|
292
|
+
* importing a file, in construction order; clears the list. Internal to the
|
|
293
|
+
* CLI's loader.
|
|
294
|
+
*/
|
|
295
|
+
export function _takeCliLoadedServices() {
|
|
296
|
+
return cliLoadedServices.splice(0);
|
|
297
|
+
}
|
|
138
298
|
export class SWMLService {
|
|
139
299
|
/** Service display name. */
|
|
140
300
|
name;
|
|
@@ -158,6 +318,10 @@ export class SWMLService {
|
|
|
158
318
|
sslKeyPath;
|
|
159
319
|
/** Schema validation utilities. Mirrors Python's `self.schema_utils`. */
|
|
160
320
|
schemaUtils;
|
|
321
|
+
/** @internal The schema settings every SwmlBuilder this service creates uses. */
|
|
322
|
+
_builderSchemaOptions = {
|
|
323
|
+
enableValidation: true,
|
|
324
|
+
};
|
|
161
325
|
/** Custom verb handler registry. Mirrors Python's `self.verb_registry`. */
|
|
162
326
|
verbRegistry;
|
|
163
327
|
swmlBuilder;
|
|
@@ -165,11 +329,33 @@ export class SWMLService {
|
|
|
165
329
|
_server = null;
|
|
166
330
|
onRequestCallback;
|
|
167
331
|
authCredentials;
|
|
168
|
-
authSource = '
|
|
332
|
+
authSource = 'generated';
|
|
333
|
+
/** Validate provided basic-auth credentials against the configured ones
|
|
334
|
+
* using a constant-time comparison. (Python equivalent:
|
|
335
|
+
* ``AuthMixin.validate_basic_auth(username, password)``.) */
|
|
336
|
+
validateBasicAuth(username, password) {
|
|
337
|
+
const [u, p] = this.authCredentials ?? ['', ''];
|
|
338
|
+
if (u === '' && p === '')
|
|
339
|
+
return false;
|
|
340
|
+
return this.timingSafeEqual(username, u) && this.timingSafeEqual(password, p);
|
|
341
|
+
}
|
|
342
|
+
timingSafeEqual(a, b) {
|
|
343
|
+
// Compare digests, so neither the content nor the length leaks.
|
|
344
|
+
const digest = (v) => createHash('sha256').update(v, 'utf8').digest();
|
|
345
|
+
return timingSafeEqual(digest(a), digest(b));
|
|
346
|
+
}
|
|
169
347
|
_proxyUrlBase = process.env['SWML_PROXY_URL_BASE'] ?? null;
|
|
170
348
|
_proxyUrlBaseFromEnv = !!process.env['SWML_PROXY_URL_BASE'];
|
|
171
349
|
_routingCallbacks = new Map();
|
|
350
|
+
// SWAIG tool registry — lifted from AgentBase so any SWMLService (sidecar,
|
|
351
|
+
// non-agent verb host) can register and dispatch SWAIG functions. Stores
|
|
352
|
+
// SwaigFunction instances (the canonical rich form) or raw descriptor maps
|
|
353
|
+
// for DataMap-style functions. AgentBase reads/writes this same registry.
|
|
354
|
+
toolRegistry = new Map();
|
|
172
355
|
constructor(opts) {
|
|
356
|
+
// swaig-test finds services a file constructs without exporting them.
|
|
357
|
+
if (process.env['SWAIG_CLI_MODE'] === 'true')
|
|
358
|
+
cliLoadedServices.push(this);
|
|
173
359
|
this.name = opts?.name ?? 'swml-service';
|
|
174
360
|
this.route = opts?.route ?? '/';
|
|
175
361
|
this.host = opts?.host ?? '0.0.0.0';
|
|
@@ -192,9 +378,14 @@ export class SWMLService {
|
|
|
192
378
|
skipValidation,
|
|
193
379
|
...(opts?.schemaPath !== undefined ? { schemaPath: opts.schemaPath } : {}),
|
|
194
380
|
});
|
|
381
|
+
// The builder that renders the SWML validates verbs with the same settings.
|
|
382
|
+
this._builderSchemaOptions = {
|
|
383
|
+
enableValidation: !skipValidation,
|
|
384
|
+
...(opts?.schemaPath !== undefined ? { schemaPath: opts.schemaPath } : {}),
|
|
385
|
+
};
|
|
195
386
|
// Verb handler registry
|
|
196
387
|
this.verbRegistry = new VerbHandlerRegistry();
|
|
197
|
-
// Auth resolution: provided >
|
|
388
|
+
// Auth resolution: provided > config file > environment > generated
|
|
198
389
|
// Track whether auth was explicitly provided (enforced on HTTP) vs auto-generated (available but not enforced)
|
|
199
390
|
let enforceAuth = false;
|
|
200
391
|
if (opts?.basicAuth) {
|
|
@@ -203,30 +394,25 @@ export class SWMLService {
|
|
|
203
394
|
enforceAuth = true;
|
|
204
395
|
}
|
|
205
396
|
else {
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
this.
|
|
397
|
+
// The config file, then the environment: SecurityConfig applies that
|
|
398
|
+
// precedence and records which one supplied the password.
|
|
399
|
+
const configured = this.security.getBasicAuth();
|
|
400
|
+
if (configured) {
|
|
401
|
+
this.authCredentials = configured;
|
|
402
|
+
this.authSource = this.security.basicAuthSource ?? 'environment';
|
|
211
403
|
enforceAuth = true;
|
|
212
404
|
}
|
|
213
405
|
else {
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
}
|
|
220
|
-
else {
|
|
221
|
-
// Auto-generate credentials like AgentBase does
|
|
222
|
-
const username = this.name.replace(/[^a-zA-Z0-9_-]/g, '_');
|
|
223
|
-
this.authCredentials = [username, randomBytes(16).toString('hex')];
|
|
224
|
-
this.authSource = 'auto-generated';
|
|
225
|
-
// Not enforced on HTTP — available via getBasicAuthCredentials()
|
|
226
|
-
}
|
|
406
|
+
// Auto-generate credentials like AgentBase does
|
|
407
|
+
const username = this.name.replace(/[^a-zA-Z0-9_-]/g, '_');
|
|
408
|
+
this.authCredentials = [username, randomBytes(16).toString('hex')];
|
|
409
|
+
this.authSource = 'generated';
|
|
410
|
+
// Not enforced on HTTP — available via getBasicAuthCredentials()
|
|
227
411
|
}
|
|
228
412
|
}
|
|
229
|
-
this
|
|
413
|
+
// `service: this` is the builder's public back-reference (the reference's
|
|
414
|
+
// `SWMLBuilder(service)`), so a caller holding the builder can reach its service.
|
|
415
|
+
this.swmlBuilder = new SwmlBuilder({ service: this, ...this._builderSchemaOptions });
|
|
230
416
|
this._app = new Hono();
|
|
231
417
|
// Security headers
|
|
232
418
|
this._app.use('*', async (c, next) => {
|
|
@@ -240,56 +426,235 @@ export class SWMLService {
|
|
|
240
426
|
});
|
|
241
427
|
// CORS — credentials only when origin is explicitly configured (wildcard + credentials violates spec)
|
|
242
428
|
const corsOrigins = process.env['SWML_CORS_ORIGINS'];
|
|
243
|
-
const corsOrigin = corsOrigins
|
|
429
|
+
const corsOrigin = corsOriginsFromEnv(corsOrigins);
|
|
244
430
|
const corsCredentials = corsOrigin !== '*';
|
|
245
431
|
this._app.use('*', cors({ origin: corsOrigin, credentials: corsCredentials }));
|
|
246
432
|
// Basic auth — only enforced when explicitly provided or from env, not auto-generated
|
|
247
433
|
if (enforceAuth && this.authCredentials) {
|
|
248
|
-
|
|
249
|
-
|
|
434
|
+
this._app.use('*', basicAuth({
|
|
435
|
+
verifyUser: (username, password) => this.validateBasicAuth(username, password),
|
|
436
|
+
}));
|
|
250
437
|
}
|
|
251
438
|
// Health endpoints
|
|
252
439
|
this._app.get('/health', (c) => c.json({ status: 'ok' }));
|
|
253
440
|
this._app.get('/ready', (c) => c.json({ status: 'ready' }));
|
|
254
441
|
// Main SWML endpoint — serves on both GET and POST
|
|
255
442
|
const handler = async (c) => {
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
443
|
+
const { bodyParams, headers } = await this._readRequest(c);
|
|
444
|
+
return c.json(await this._documentForRequest(c, bodyParams, headers));
|
|
445
|
+
};
|
|
446
|
+
const routePath = this.route === '/' ? '/' : this.route;
|
|
447
|
+
const swaigPath = this.route === '/' ? '/swaig' : `${this.route}/swaig`;
|
|
448
|
+
// SWAIG endpoint — GET returns the rendered SWML doc (sidecar / non-agent
|
|
449
|
+
// services use the document as-is; AgentBase overrides via render hook),
|
|
450
|
+
// POST validates and dispatches via onFunctionCall. Subclasses may
|
|
451
|
+
// override swaigPreDispatch to add token validation / ephemeral copies.
|
|
452
|
+
const swaigHandler = async (c) => {
|
|
453
|
+
if (c.req.method === 'GET') {
|
|
454
|
+
return handler(c);
|
|
455
|
+
}
|
|
456
|
+
let payload;
|
|
457
|
+
try {
|
|
458
|
+
payload = (await c.req.json());
|
|
459
|
+
}
|
|
460
|
+
catch {
|
|
461
|
+
return c.json({ error: 'Invalid JSON' }, 400);
|
|
270
462
|
}
|
|
271
|
-
const
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
// Try onRequest() first; if it returns a SwmlBuilder use that document.
|
|
275
|
-
const hookResult = this.onRequest(queryParams, bodyParams, headers);
|
|
276
|
-
if (hookResult !== null) {
|
|
277
|
-
doc = hookResult.getDocument();
|
|
463
|
+
const fnName = payload['function'] ?? '';
|
|
464
|
+
if (!fnName) {
|
|
465
|
+
return c.json({ error: 'Missing function name' }, 400);
|
|
278
466
|
}
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
467
|
+
if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(fnName)) {
|
|
468
|
+
return c.json({ error: `Invalid function name format: '${fnName}'` }, 400);
|
|
469
|
+
}
|
|
470
|
+
// Argument extraction: nested {argument:{parsed}} OR flat {arguments}
|
|
471
|
+
let args = {};
|
|
472
|
+
const argument = payload['argument'];
|
|
473
|
+
if (argument &&
|
|
474
|
+
typeof argument === 'object' &&
|
|
475
|
+
Array.isArray(argument['parsed']) &&
|
|
476
|
+
argument['parsed'].length > 0) {
|
|
477
|
+
const first = argument['parsed'][0];
|
|
478
|
+
if (first && typeof first === 'object')
|
|
479
|
+
args = first;
|
|
282
480
|
}
|
|
283
481
|
else {
|
|
284
|
-
|
|
482
|
+
const flat = payload['arguments'];
|
|
483
|
+
if (flat && typeof flat === 'object')
|
|
484
|
+
args = flat;
|
|
485
|
+
}
|
|
486
|
+
const [target, shortCircuit] = this.swaigPreDispatch(payload, fnName);
|
|
487
|
+
if (shortCircuit !== null && shortCircuit !== undefined) {
|
|
488
|
+
return c.json(shortCircuit);
|
|
285
489
|
}
|
|
286
|
-
|
|
490
|
+
// A handler may be async: await it, or its Promise serializes as {}.
|
|
491
|
+
const result = await target.onFunctionCall(fnName, args, payload);
|
|
492
|
+
if (result === null || result === undefined) {
|
|
493
|
+
return c.json({ error: `Unknown function: ${fnName}` }, 404);
|
|
494
|
+
}
|
|
495
|
+
if (result instanceof FunctionResult)
|
|
496
|
+
return c.json(result.toDict());
|
|
497
|
+
if (typeof result === 'string')
|
|
498
|
+
return c.json(new FunctionResult(result).toDict());
|
|
499
|
+
return c.json(result);
|
|
287
500
|
};
|
|
288
|
-
|
|
501
|
+
this._app.get(swaigPath, swaigHandler);
|
|
502
|
+
this._app.post(swaigPath, swaigHandler);
|
|
503
|
+
// Subclass extension hook (AgentBase wires /post_prompt etc here).
|
|
504
|
+
this.registerAdditionalRoutes(this._app);
|
|
289
505
|
this._app.get(routePath, handler);
|
|
290
506
|
this._app.post(routePath, handler);
|
|
291
507
|
// Register routing callback endpoints dynamically in getApp/run
|
|
292
508
|
}
|
|
509
|
+
// ────────────────────────────────────────────────────────────────────
|
|
510
|
+
// SWAIG tool registry (lifted from AgentBase)
|
|
511
|
+
// ────────────────────────────────────────────────────────────────────
|
|
512
|
+
/**
|
|
513
|
+
* Define a SWAIG function the AI can call. Tool descriptions and
|
|
514
|
+
* parameter descriptions are LLM-facing prompt engineering — see
|
|
515
|
+
* PORTING_GUIDE for guidance on writing them.
|
|
516
|
+
*
|
|
517
|
+
* Generic over the `parameters` schema (`P`) and `required` list (`R`): when
|
|
518
|
+
* `parameters` is written as a FLAT inline map (`{ name: { type, … } }`), the
|
|
519
|
+
* `const` type parameters capture its literals and the handler's `args` is
|
|
520
|
+
* inferred precisely — `args.phone` typed `string`, an `enum` prop narrowed to
|
|
521
|
+
* its literal union, `required` keys present and the rest optional (see
|
|
522
|
+
* {@link ToolArgs}/{@link InferArgs}). The WRAPPED JSON-Schema object
|
|
523
|
+
* (`{ type:'object', properties }`) and a pre-built `Record` are still
|
|
524
|
+
* accepted and keep the prior open-record `args` behavior. The args type is a
|
|
525
|
+
* compile-time authoring convenience — at runtime args is the JSON the model
|
|
526
|
+
* extracted, so the handler is the ordinary {@link SwaigHandler}.
|
|
527
|
+
*/
|
|
528
|
+
defineTool(opts) {
|
|
529
|
+
const fn = new SwaigFunction({
|
|
530
|
+
...opts,
|
|
531
|
+
parameters: opts.parameters,
|
|
532
|
+
required: opts.required,
|
|
533
|
+
// Single type-erasure boundary: at runtime the handler is the ordinary
|
|
534
|
+
// (args: Record<string,unknown>, rawData) SwaigHandler; the inferred-args
|
|
535
|
+
// view is compile-time only.
|
|
536
|
+
handler: opts.handler,
|
|
537
|
+
});
|
|
538
|
+
this.toolRegistry.set(opts.name, fn);
|
|
539
|
+
return this;
|
|
540
|
+
}
|
|
541
|
+
/** Register a SwaigFunction instance or a raw function descriptor (DataMap). */
|
|
542
|
+
registerSwaigFunction(fn) {
|
|
543
|
+
if (fn instanceof SwaigFunction) {
|
|
544
|
+
this.toolRegistry.set(fn.name, fn);
|
|
545
|
+
}
|
|
546
|
+
else {
|
|
547
|
+
const name = fn['function'];
|
|
548
|
+
if (name)
|
|
549
|
+
this.toolRegistry.set(name, fn);
|
|
550
|
+
}
|
|
551
|
+
return this;
|
|
552
|
+
}
|
|
553
|
+
/**
|
|
554
|
+
* Dispatch a function call to the registered handler.
|
|
555
|
+
* Returns null when the function isn't registered or has no handler.
|
|
556
|
+
* Subclasses (AgentBase) override to add session-token validation
|
|
557
|
+
* and FunctionResult-shape normalization. Return type is wide enough
|
|
558
|
+
* to accommodate the agent override (which may also return void
|
|
559
|
+
* shapes for fire-and-forget tool calls).
|
|
560
|
+
*/
|
|
561
|
+
onFunctionCall(name, args, rawData) {
|
|
562
|
+
const fn = this.toolRegistry.get(name);
|
|
563
|
+
if (!fn)
|
|
564
|
+
return null;
|
|
565
|
+
if (fn instanceof SwaigFunction) {
|
|
566
|
+
return fn.handler(args, rawData);
|
|
567
|
+
}
|
|
568
|
+
return null;
|
|
569
|
+
}
|
|
570
|
+
/** Whether a tool with the given name is registered. */
|
|
571
|
+
hasTool(name) {
|
|
572
|
+
return this.toolRegistry.has(name);
|
|
573
|
+
}
|
|
574
|
+
/** Whether a SWAIG function with the given name is registered.
|
|
575
|
+
* (Python equivalent: ``ToolRegistry.has_function``.) */
|
|
576
|
+
hasFunction(name) {
|
|
577
|
+
return this.toolRegistry.has(name);
|
|
578
|
+
}
|
|
579
|
+
/** Get a registered SWAIG function entry, or undefined.
|
|
580
|
+
* (Python equivalent: ``ToolRegistry.get_function``.) */
|
|
581
|
+
getFunction(name) {
|
|
582
|
+
return this.toolRegistry.get(name);
|
|
583
|
+
}
|
|
584
|
+
/** Snapshot of all registered SWAIG functions keyed by name.
|
|
585
|
+
* (Python equivalent: ``ToolRegistry.get_all_functions``.) */
|
|
586
|
+
getAllFunctions() {
|
|
587
|
+
const out = {};
|
|
588
|
+
for (const [name, fn] of this.toolRegistry) {
|
|
589
|
+
out[name] = fn;
|
|
590
|
+
}
|
|
591
|
+
return out;
|
|
592
|
+
}
|
|
593
|
+
/** Remove a registered SWAIG function. Returns true when removed,
|
|
594
|
+
* false when not found. (Python equivalent:
|
|
595
|
+
* ``ToolRegistry.remove_function``.) */
|
|
596
|
+
removeFunction(name) {
|
|
597
|
+
return this.toolRegistry.delete(name);
|
|
598
|
+
}
|
|
599
|
+
/** List registered tool names in insertion order (Map preserves it). */
|
|
600
|
+
listToolNames() {
|
|
601
|
+
return Array.from(this.toolRegistry.keys());
|
|
602
|
+
}
|
|
603
|
+
/**
|
|
604
|
+
* Get a summary of all registered tools with their names, descriptions, and
|
|
605
|
+
* parameter schemas. Lifted from AgentBase so the swaig-test CLI can list
|
|
606
|
+
* tools on a non-AgentBase SWMLService target (sidecar / standalone SWAIG
|
|
607
|
+
* host).
|
|
608
|
+
*
|
|
609
|
+
* @returns Array of tool descriptors.
|
|
610
|
+
*/
|
|
611
|
+
getRegisteredTools() {
|
|
612
|
+
const tools = [];
|
|
613
|
+
for (const [name, fn] of this.toolRegistry) {
|
|
614
|
+
if (fn instanceof SwaigFunction) {
|
|
615
|
+
tools.push({ name, description: fn.description, parameters: fn.parameters });
|
|
616
|
+
}
|
|
617
|
+
else {
|
|
618
|
+
// DataMap.toSwaigFunction() writes description/parameters; a hand-built
|
|
619
|
+
// SWAIG dict may use the older purpose/argument names.
|
|
620
|
+
tools.push({
|
|
621
|
+
name,
|
|
622
|
+
description: (fn['description'] ?? fn['purpose']) ?? '',
|
|
623
|
+
parameters: (fn['parameters'] ?? fn['argument']) ?? {},
|
|
624
|
+
});
|
|
625
|
+
}
|
|
626
|
+
}
|
|
627
|
+
return tools;
|
|
628
|
+
}
|
|
629
|
+
/**
|
|
630
|
+
* Look up a registered SwaigFunction by name. Lifted from AgentBase so
|
|
631
|
+
* `swaig-test --exec <name>` works against a non-AgentBase SWMLService
|
|
632
|
+
* target.
|
|
633
|
+
*
|
|
634
|
+
* @param name - The tool name to search for.
|
|
635
|
+
* @returns The SwaigFunction instance, or undefined if not found or not a SwaigFunction.
|
|
636
|
+
*/
|
|
637
|
+
getTool(name) {
|
|
638
|
+
const fn = this.toolRegistry.get(name);
|
|
639
|
+
return fn instanceof SwaigFunction ? fn : undefined;
|
|
640
|
+
}
|
|
641
|
+
/**
|
|
642
|
+
* Extension point: invoked between argument parsing and function dispatch
|
|
643
|
+
* on POST /swaig. Returns [target, shortCircuit]: when shortCircuit is
|
|
644
|
+
* non-null, it's returned directly without dispatching. AgentBase may
|
|
645
|
+
* override to add session-token validation or ephemeral dynamic-config.
|
|
646
|
+
*/
|
|
647
|
+
swaigPreDispatch(_requestData, _funcName) {
|
|
648
|
+
return [this, null];
|
|
649
|
+
}
|
|
650
|
+
/**
|
|
651
|
+
* Extension point: register additional Hono routes after SWMLService
|
|
652
|
+
* mounts /health, /ready, /swaig, and the main route. AgentBase uses
|
|
653
|
+
* this to add /post_prompt, /check_for_input, /debug_events, /mcp.
|
|
654
|
+
*/
|
|
655
|
+
registerAdditionalRoutes(_app) {
|
|
656
|
+
// Default: no extra routes.
|
|
657
|
+
}
|
|
293
658
|
// ── Properties (getters) ─────────────────────────────────────────────
|
|
294
659
|
/**
|
|
295
660
|
* Check if full JSON Schema validation is enabled.
|
|
@@ -332,7 +697,7 @@ export class SWMLService {
|
|
|
332
697
|
* @returns This service for chaining.
|
|
333
698
|
*/
|
|
334
699
|
addSection(sectionName) {
|
|
335
|
-
const doc = this.swmlBuilder.
|
|
700
|
+
const doc = this.swmlBuilder.build();
|
|
336
701
|
if (!(sectionName in doc.sections)) {
|
|
337
702
|
doc.sections[sectionName] = [];
|
|
338
703
|
}
|
|
@@ -360,19 +725,24 @@ export class SWMLService {
|
|
|
360
725
|
return this;
|
|
361
726
|
}
|
|
362
727
|
/**
|
|
363
|
-
* Render the SWML document
|
|
364
|
-
*
|
|
728
|
+
* Render the SWML document.
|
|
729
|
+
*
|
|
730
|
+
* Subclass-override-friendly signature: AgentBase overrides this with
|
|
731
|
+
* `(callId?: string, modifications?: Record<string, unknown>): string`
|
|
732
|
+
* to return a serialized JSON string built from prompts + dynamic config.
|
|
733
|
+
* Plain SWMLService returns the in-memory document object.
|
|
734
|
+
*
|
|
735
|
+
* @returns The SWML document (object) or its serialized form (subclass).
|
|
365
736
|
*/
|
|
366
|
-
renderSwml() {
|
|
367
|
-
return this.swmlBuilder.
|
|
737
|
+
renderSwml(_callId, _modifications) {
|
|
738
|
+
return this.swmlBuilder.build();
|
|
368
739
|
}
|
|
369
740
|
/**
|
|
370
|
-
* Get the SWML document as a dictionary.
|
|
371
|
-
* Alias for `renderSwml()` that matches Python's `get_document()` name.
|
|
741
|
+
* Get the SWML document as a dictionary. Matches Python's `get_document()`.
|
|
372
742
|
* @returns The SWML document.
|
|
373
743
|
*/
|
|
374
744
|
getDocument() {
|
|
375
|
-
return this.swmlBuilder.
|
|
745
|
+
return this.swmlBuilder.build();
|
|
376
746
|
}
|
|
377
747
|
/**
|
|
378
748
|
* Render the SWML document as a JSON string.
|
|
@@ -380,7 +750,121 @@ export class SWMLService {
|
|
|
380
750
|
* @returns JSON-encoded SWML document.
|
|
381
751
|
*/
|
|
382
752
|
renderDocument() {
|
|
383
|
-
return this.swmlBuilder.
|
|
753
|
+
return this.swmlBuilder.render();
|
|
754
|
+
}
|
|
755
|
+
/**
|
|
756
|
+
* Framework-free request-dispatch core.
|
|
757
|
+
*
|
|
758
|
+
* The primitive dispatch surface the SDK ports share (mirrors Python's
|
|
759
|
+
* `SWMLService.handle_request(method, url, headers, body)` and, e.g., the
|
|
760
|
+
* dotnet `(int, Dictionary, string) HandleRequest(...)`). It performs the
|
|
761
|
+
* routing-callback check, `on_request` modification, and basic-auth exactly as
|
|
762
|
+
* the Hono handler path does, but over plain primitives instead of Hono
|
|
763
|
+
* `Context`/`Response` objects — so both paths produce identical responses.
|
|
764
|
+
*
|
|
765
|
+
* @param method HTTP method, e.g. `"GET"` or `"POST"`.
|
|
766
|
+
* @param url The full request URL (used to derive the callback path).
|
|
767
|
+
* @param headers Request headers as a plain dict.
|
|
768
|
+
* @param body The already-parsed JSON body for POST requests, or `undefined`.
|
|
769
|
+
* @returns A `[status, responseHeaders, bodyString]` triple. For a routing
|
|
770
|
+
* redirect the status is 307 with a `Location` header and an empty body; an
|
|
771
|
+
* auth failure is 401 with `WWW-Authenticate: Basic`; otherwise 200 with the
|
|
772
|
+
* SWML document as the body string.
|
|
773
|
+
*/
|
|
774
|
+
async handleRequest(method, url, headers, body) {
|
|
775
|
+
const parsedBody = body ?? {};
|
|
776
|
+
const callbackPath = this._callbackPathForUrl(url);
|
|
777
|
+
// Auth check over primitives.
|
|
778
|
+
if (!(await this._checkBasicAuthHeaders(headers))) {
|
|
779
|
+
return [401, { 'WWW-Authenticate': 'Basic' }, JSON.stringify({ error: 'Unauthorized' })];
|
|
780
|
+
}
|
|
781
|
+
// Routing callback: (body, headers) -> route | null. Only runs for a POST
|
|
782
|
+
// with a non-empty parsed body targeting a registered callback path.
|
|
783
|
+
if (method === 'POST' &&
|
|
784
|
+
Object.keys(parsedBody).length > 0 &&
|
|
785
|
+
callbackPath &&
|
|
786
|
+
this._routingCallbacks.has(callbackPath)) {
|
|
787
|
+
const callbackFn = this._routingCallbacks.get(callbackPath);
|
|
788
|
+
try {
|
|
789
|
+
const route = await callbackFn(parsedBody, headers);
|
|
790
|
+
if (route != null) {
|
|
791
|
+
this.log.info(`routing_request route=${route}`);
|
|
792
|
+
return [307, { Location: route }, ''];
|
|
793
|
+
}
|
|
794
|
+
}
|
|
795
|
+
catch (err) {
|
|
796
|
+
this.log.error(`error_in_routing_callback error=${err instanceof Error ? err.message : String(err)}`);
|
|
797
|
+
}
|
|
798
|
+
}
|
|
799
|
+
// Allow customized handling in subclasses (the SWML-builder hook analog of
|
|
800
|
+
// Python's on_request modification merge).
|
|
801
|
+
const queryParams = {};
|
|
802
|
+
try {
|
|
803
|
+
new URL(url).searchParams.forEach((v, k) => {
|
|
804
|
+
queryParams[k] = v;
|
|
805
|
+
});
|
|
806
|
+
}
|
|
807
|
+
catch {
|
|
808
|
+
/* url may be a bare path — no query params to extract */
|
|
809
|
+
}
|
|
810
|
+
const hookResult = this.buildSwmlForRequest(queryParams, parsedBody, headers, callbackPath ?? undefined);
|
|
811
|
+
if (hookResult !== null) {
|
|
812
|
+
return [200, {}, JSON.stringify(hookResult.build())];
|
|
813
|
+
}
|
|
814
|
+
return [200, {}, this.renderDocument()];
|
|
815
|
+
}
|
|
816
|
+
/**
|
|
817
|
+
* Derive the registered routing-callback path (if any) a URL targets. Mirrors
|
|
818
|
+
* Python's `_callback_path_for_url` — the primitive `handleRequest` recovers
|
|
819
|
+
* the equivalent of the router's `request.state.callback_path` by matching the
|
|
820
|
+
* URL's normalized path against the registered callbacks.
|
|
821
|
+
*/
|
|
822
|
+
_callbackPathForUrl(url) {
|
|
823
|
+
if (this._routingCallbacks.size === 0)
|
|
824
|
+
return null;
|
|
825
|
+
let path = url;
|
|
826
|
+
try {
|
|
827
|
+
path = new URL(url).pathname;
|
|
828
|
+
}
|
|
829
|
+
catch {
|
|
830
|
+
/* bare path — use as-is */
|
|
831
|
+
}
|
|
832
|
+
// Collapse repeated slashes, as the router does when it picks the route,
|
|
833
|
+
// so /agent/handoff//next finds the callback registered at /handoff/next.
|
|
834
|
+
const trimmed = path.replace(/\/{2,}/g, '/').replace(/^\/+|\/+$/g, '');
|
|
835
|
+
const normalized = trimmed ? `/${trimmed}` : path.replace(/\/+$/, '');
|
|
836
|
+
for (const cbPath of this._routingCallbacks.keys()) {
|
|
837
|
+
if (normalized === cbPath || normalized.endsWith(cbPath))
|
|
838
|
+
return cbPath;
|
|
839
|
+
}
|
|
840
|
+
return null;
|
|
841
|
+
}
|
|
842
|
+
/**
|
|
843
|
+
* Validate HTTP basic-auth from a plain headers dict (the primitive analog of
|
|
844
|
+
* the Hono `basicAuth` middleware). Returns true when auth is not enforced or
|
|
845
|
+
* the provided credentials match.
|
|
846
|
+
*/
|
|
847
|
+
async _checkBasicAuthHeaders(headers) {
|
|
848
|
+
// Auth is only enforced when credentials were explicitly provided or came
|
|
849
|
+
// from the environment; auto-generated credentials are not enforced.
|
|
850
|
+
if (!this.authCredentials || this.authSource === 'generated')
|
|
851
|
+
return true;
|
|
852
|
+
const authHeader = headers['authorization'] ?? headers['Authorization'];
|
|
853
|
+
if (!authHeader || !authHeader.startsWith('Basic '))
|
|
854
|
+
return false;
|
|
855
|
+
let decoded;
|
|
856
|
+
try {
|
|
857
|
+
decoded = Buffer.from(authHeader.slice(6), 'base64').toString('utf-8');
|
|
858
|
+
}
|
|
859
|
+
catch {
|
|
860
|
+
return false;
|
|
861
|
+
}
|
|
862
|
+
const idx = decoded.indexOf(':');
|
|
863
|
+
if (idx < 0)
|
|
864
|
+
return false;
|
|
865
|
+
const user = decoded.slice(0, idx);
|
|
866
|
+
const pass = decoded.slice(idx + 1);
|
|
867
|
+
return await this.validateBasicAuth(user, pass);
|
|
384
868
|
}
|
|
385
869
|
// ── Verb handler registration ────────────────────────────────────────
|
|
386
870
|
/**
|
|
@@ -410,28 +894,65 @@ export class SWMLService {
|
|
|
410
894
|
}
|
|
411
895
|
this.log.info(`Registering routing callback at ${normalized}`);
|
|
412
896
|
this._routingCallbacks.set(normalized, callbackFn);
|
|
413
|
-
// Install an endpoint on the Hono app for this callback path
|
|
897
|
+
// Install an endpoint on the Hono app for this callback path. It runs
|
|
898
|
+
// this callback (awaited) for a POST, redirects with 307 when it returns
|
|
899
|
+
// a route, and otherwise serves the SWML for the request as the main
|
|
900
|
+
// route does, as the reference does. Auth is the app's middleware.
|
|
414
901
|
const routeHandler = async (c) => {
|
|
415
|
-
|
|
416
|
-
if (c.req.method === 'POST') {
|
|
902
|
+
const { bodyParams, headers } = await this._readRequest(c);
|
|
903
|
+
if (c.req.method === 'POST' && Object.keys(bodyParams).length > 0) {
|
|
417
904
|
try {
|
|
418
|
-
|
|
905
|
+
const route = await callbackFn(bodyParams, headers);
|
|
906
|
+
if (route != null) {
|
|
907
|
+
this.log.info(`routing_request route=${route}`);
|
|
908
|
+
return c.redirect(route, 307);
|
|
909
|
+
}
|
|
419
910
|
}
|
|
420
|
-
catch {
|
|
421
|
-
|
|
911
|
+
catch (err) {
|
|
912
|
+
this.log.error(`error_in_routing_callback error=${err instanceof Error ? err.message : String(err)}`);
|
|
422
913
|
}
|
|
423
914
|
}
|
|
424
|
-
|
|
425
|
-
if (route !== null) {
|
|
426
|
-
return c.redirect(route, 307);
|
|
427
|
-
}
|
|
428
|
-
// No redirect — serve normal SWML
|
|
429
|
-
const doc = this.swmlBuilder.getDocument();
|
|
430
|
-
return c.json(doc);
|
|
915
|
+
return c.json(await this._documentForRequest(c, bodyParams, headers));
|
|
431
916
|
};
|
|
432
917
|
this._app.get(normalized, routeHandler);
|
|
433
918
|
this._app.post(normalized, routeHandler);
|
|
434
919
|
}
|
|
920
|
+
/** The body (for a POST) and headers of a served request. */
|
|
921
|
+
async _readRequest(c) {
|
|
922
|
+
let bodyParams = {};
|
|
923
|
+
if (c.req.method === 'POST') {
|
|
924
|
+
try {
|
|
925
|
+
bodyParams = await c.req.json();
|
|
926
|
+
}
|
|
927
|
+
catch {
|
|
928
|
+
// empty body is fine
|
|
929
|
+
}
|
|
930
|
+
}
|
|
931
|
+
const headers = {};
|
|
932
|
+
c.req.raw.headers.forEach((v, k) => {
|
|
933
|
+
headers[k] = v;
|
|
934
|
+
});
|
|
935
|
+
return { bodyParams, headers };
|
|
936
|
+
}
|
|
937
|
+
/**
|
|
938
|
+
* The SWML document for a served request: buildSwmlForRequest(), then the
|
|
939
|
+
* setOnRequestCallback() callback, then the service's own document (as
|
|
940
|
+
* Python's _handle_request does).
|
|
941
|
+
*/
|
|
942
|
+
async _documentForRequest(c, bodyParams, headers) {
|
|
943
|
+
const queryParams = {};
|
|
944
|
+
new URL(c.req.url).searchParams.forEach((v, k) => {
|
|
945
|
+
queryParams[k] = v;
|
|
946
|
+
});
|
|
947
|
+
const hookResult = this.buildSwmlForRequest(queryParams, bodyParams, headers);
|
|
948
|
+
if (hookResult !== null)
|
|
949
|
+
return hookResult.build();
|
|
950
|
+
if (this.onRequestCallback) {
|
|
951
|
+
const builder = await this.onRequestCallback(queryParams, bodyParams, headers);
|
|
952
|
+
return builder.build();
|
|
953
|
+
}
|
|
954
|
+
return this.swmlBuilder.build();
|
|
955
|
+
}
|
|
435
956
|
// ── Static utilities ─────────────────────────────────────────────────
|
|
436
957
|
/**
|
|
437
958
|
* Extract the SIP username from a request body's call.to field.
|
|
@@ -447,7 +968,7 @@ export class SWMLService {
|
|
|
447
968
|
return null;
|
|
448
969
|
// Handle SIP URIs like "sip:username@domain" or "sips:username@domain"
|
|
449
970
|
if (toField.startsWith('sip:') || toField.startsWith('sips:')) {
|
|
450
|
-
|
|
971
|
+
const uri = toField.replace(/^sips?:/, '');
|
|
451
972
|
const atIdx = uri.indexOf('@');
|
|
452
973
|
if (atIdx > 0)
|
|
453
974
|
return uri.substring(0, atIdx);
|
|
@@ -466,14 +987,18 @@ export class SWMLService {
|
|
|
466
987
|
}
|
|
467
988
|
// ── Dynamic request callback ──────────────────────────────────────
|
|
468
989
|
/**
|
|
469
|
-
*
|
|
470
|
-
*
|
|
471
|
-
*
|
|
472
|
-
*
|
|
473
|
-
*
|
|
990
|
+
* Service-side SWML-builder hook. Subclasses return a `SwmlBuilder`
|
|
991
|
+
* to fully replace the document for this request, or `null` to fall
|
|
992
|
+
* through to `setOnRequestCallback` or the static builder.
|
|
993
|
+
*
|
|
994
|
+
* This is distinct from the WebMixin `onRequest(requestData,
|
|
995
|
+
* callbackPath)` hook on AgentBase (which mirrors Python's
|
|
996
|
+
* `on_request -> on_swml_request` modification-merge contract).
|
|
997
|
+
* Use this hook when you want to swap the entire SWML builder; use
|
|
998
|
+
* `onRequest` / `onSwmlRequest` on AgentBase when you want to merge
|
|
999
|
+
* targeted modifications into the rendered document.
|
|
474
1000
|
*
|
|
475
|
-
* Default implementation returns `null` (no-op)
|
|
476
|
-
* behaviour for classes that do not override.
|
|
1001
|
+
* Default implementation returns `null` (no-op).
|
|
477
1002
|
*
|
|
478
1003
|
* @param queryParams - URL query parameters from the request.
|
|
479
1004
|
* @param bodyParams - Parsed POST body (empty object for GET requests).
|
|
@@ -482,7 +1007,7 @@ export class SWMLService {
|
|
|
482
1007
|
* @returns A `SwmlBuilder` whose document is sent as the response, or
|
|
483
1008
|
* `null` to delegate to the next handler in the chain.
|
|
484
1009
|
*/
|
|
485
|
-
|
|
1010
|
+
buildSwmlForRequest(_queryParams, _bodyParams, _headers, _callbackPath) {
|
|
486
1011
|
return null;
|
|
487
1012
|
}
|
|
488
1013
|
/**
|
|
@@ -530,23 +1055,28 @@ export class SWMLService {
|
|
|
530
1055
|
return this._app;
|
|
531
1056
|
}
|
|
532
1057
|
/**
|
|
533
|
-
*
|
|
534
|
-
*
|
|
535
|
-
* the
|
|
536
|
-
*
|
|
1058
|
+
* Get a router to embed this service's routes in a host web app.
|
|
1059
|
+
*
|
|
1060
|
+
* Returns the fully-wired Hono app as a mountable sub-app; the host mounts it
|
|
1061
|
+
* with `hostApp.route(path, service.asRouter())`. This is the TypeScript
|
|
1062
|
+
* realization of Python's `as_router()`; the named {@link HostAppRouter} type
|
|
1063
|
+
* is the cross-port "embed my routes in a host app" contract.
|
|
1064
|
+
*
|
|
1065
|
+
* @returns A mountable Hono sub-app carrying this service's routes.
|
|
537
1066
|
*/
|
|
538
1067
|
asRouter() {
|
|
539
1068
|
return this.getApp();
|
|
540
1069
|
}
|
|
541
1070
|
/**
|
|
542
|
-
* Start the HTTP server.
|
|
1071
|
+
* Start the HTTP server. Canonical entrypoint, matching Python's
|
|
1072
|
+
* `SWMLService.serve()`.
|
|
543
1073
|
*
|
|
544
1074
|
* Matches Python's `serve()` parameters including SSL options. When
|
|
545
1075
|
* `SWAIG_CLI_MODE=true` is set in the environment (e.g. while running the
|
|
546
1076
|
* `swaig-test` CLI) the call is a no-op.
|
|
547
1077
|
*
|
|
548
|
-
* @param
|
|
549
|
-
* `'0.0.0.0'`.
|
|
1078
|
+
* @param hostOrOpts - Hostname, or an options object. Defaults to `this.host`
|
|
1079
|
+
* (constructor value) or `'0.0.0.0'`.
|
|
550
1080
|
* @param port - Port. Defaults to `this.port` (constructor value) or `3000`.
|
|
551
1081
|
* @param opts - Optional SSL/TLS configuration overrides.
|
|
552
1082
|
* @param opts.sslCert - Path to the PEM certificate file.
|
|
@@ -555,11 +1085,32 @@ export class SWMLService {
|
|
|
555
1085
|
* @param opts.domain - Domain used for HSTS header configuration.
|
|
556
1086
|
* @returns Resolves once the server has begun listening.
|
|
557
1087
|
*/
|
|
558
|
-
async
|
|
1088
|
+
async serve(hostOrOpts, port, opts) {
|
|
559
1089
|
if (process.env['SWAIG_CLI_MODE'] === 'true')
|
|
560
1090
|
return;
|
|
1091
|
+
// Normalize: accept either positional (host, port, opts) or single
|
|
1092
|
+
// options-object form (matches AgentBase's `run({ host, port })` shape).
|
|
1093
|
+
let host;
|
|
1094
|
+
let resolvedOpts;
|
|
1095
|
+
if (typeof hostOrOpts === 'object' && hostOrOpts !== null) {
|
|
1096
|
+
host = hostOrOpts.host;
|
|
1097
|
+
port = hostOrOpts.port ?? port;
|
|
1098
|
+
resolvedOpts = hostOrOpts;
|
|
1099
|
+
}
|
|
1100
|
+
else {
|
|
1101
|
+
host = hostOrOpts;
|
|
1102
|
+
resolvedOpts = opts;
|
|
1103
|
+
}
|
|
1104
|
+
opts = resolvedOpts;
|
|
561
1105
|
const h = host ?? this.host;
|
|
562
1106
|
const p = port ?? this.port;
|
|
1107
|
+
// A service with generated credentials doesn't require them (a TypeScript
|
|
1108
|
+
// divergence from the reference, which always does: PORT_BEHAVIORAL_NOTES.md).
|
|
1109
|
+
if (this.authSource === 'generated') {
|
|
1110
|
+
this.log.warn(`${this.name} is serving without basic auth: its credentials were generated, and ` +
|
|
1111
|
+
'generated credentials are not enforced. Pass basicAuth, or set ' +
|
|
1112
|
+
'SWML_BASIC_AUTH_USER and SWML_BASIC_AUTH_PASSWORD, to require them.');
|
|
1113
|
+
}
|
|
563
1114
|
// Determine effective SSL state (param > instance > env)
|
|
564
1115
|
const effectiveSslEnabled = opts?.sslEnabled ?? this.sslEnabled;
|
|
565
1116
|
const effectiveSslCert = opts?.sslCert ?? this.sslCertPath;
|
|
@@ -585,17 +1136,6 @@ export class SWMLService {
|
|
|
585
1136
|
this._server = serve({ fetch: this._app.fetch, port: p, hostname: h });
|
|
586
1137
|
}
|
|
587
1138
|
}
|
|
588
|
-
/**
|
|
589
|
-
* Start the HTTP server. Alias for {@link run} provided for cross-SDK
|
|
590
|
-
* consistency with Python's `serve()` method — callers porting from
|
|
591
|
-
* Python can use this name without changes.
|
|
592
|
-
*
|
|
593
|
-
* @param args - Forwarded unchanged to {@link run}.
|
|
594
|
-
* @returns Resolves once the server has begun listening.
|
|
595
|
-
*/
|
|
596
|
-
async serve(...args) {
|
|
597
|
-
return this.run(...args);
|
|
598
|
-
}
|
|
599
1139
|
/**
|
|
600
1140
|
* Stop the HTTP server.
|
|
601
1141
|
* Mirrors Python's `stop()`.
|