@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/SwaigFunction.d.ts
CHANGED
|
@@ -1,14 +1,86 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* SwaigFunction - Wraps a handler function with metadata for SWAIG registration.
|
|
3
3
|
*/
|
|
4
|
-
import { FunctionResult } from './FunctionResult.js';
|
|
4
|
+
import { FunctionResult, type SwaigResultDict } from './FunctionResult.js';
|
|
5
|
+
import type { SwaigRequest } from './SwaigContracts.js';
|
|
6
|
+
import type { AgentBase } from './AgentBase.js';
|
|
7
|
+
/** @internal How many argument validators have been compiled (for tests). */
|
|
8
|
+
export declare function _compiledValidatorCount(): number;
|
|
9
|
+
/**
|
|
10
|
+
* Decide whether a `parameters` value is already a full JSON Schema object
|
|
11
|
+
* (`{ type: 'object', properties: {...} }`) versus a bare map of property
|
|
12
|
+
* definitions that must be wrapped.
|
|
13
|
+
*
|
|
14
|
+
* Robust discriminator: a value is a full schema ONLY when its `type` is the
|
|
15
|
+
* string `'object'` AND its `properties` is itself an object. The old check
|
|
16
|
+
* (`'type' in p && 'properties' in p`) misclassified a tool whose parameters
|
|
17
|
+
* are literally NAMED `type` and `properties`: for such a bare map the value of
|
|
18
|
+
* `type` is a property-definition object (not the string `'object'`), so this
|
|
19
|
+
* check correctly treats it as a bare properties map.
|
|
20
|
+
*
|
|
21
|
+
* @param parameters - The raw `parameters` value to inspect.
|
|
22
|
+
* @returns `true` if it is already a full JSON Schema object.
|
|
23
|
+
*/
|
|
24
|
+
export declare function isFullParameterSchema(parameters: Record<string, unknown>): boolean;
|
|
25
|
+
/**
|
|
26
|
+
* Normalize a tool's `parameters` into a full JSON Schema object suitable for
|
|
27
|
+
* SWAIG / MCP output.
|
|
28
|
+
*
|
|
29
|
+
* - An empty/absent map becomes `{ type: 'object', properties: {} }`.
|
|
30
|
+
* - An already-full schema (see {@link isFullParameterSchema}) is returned
|
|
31
|
+
* unchanged.
|
|
32
|
+
* - A bare properties map is wrapped as
|
|
33
|
+
* `{ type: 'object', properties: <map>, required?: <required> }`.
|
|
34
|
+
*
|
|
35
|
+
* This is the single source of truth for the `parameters` shape sniff that used
|
|
36
|
+
* to be reimplemented in SwaigFunction, AgentBase MCP tool listing, and the
|
|
37
|
+
* AgentBase SWAIG function table.
|
|
38
|
+
*
|
|
39
|
+
* @param parameters - The raw `parameters` value (bare properties map or full schema).
|
|
40
|
+
* @param required - Required-parameter names, applied only when wrapping a bare map.
|
|
41
|
+
* @returns A full JSON Schema object.
|
|
42
|
+
*/
|
|
43
|
+
export declare function normalizeParameters(parameters: Record<string, unknown> | undefined, required?: string[]): Record<string, unknown>;
|
|
5
44
|
/**
|
|
6
45
|
* Handler function for a SWAIG tool invocation.
|
|
7
46
|
* @param args - Parsed arguments extracted by the AI from user speech.
|
|
8
47
|
* @param rawData - The full raw request payload from SignalWire.
|
|
48
|
+
* @param agent - The agent running the call. With a dynamic config callback
|
|
49
|
+
* set, this is the request's configured copy, so the handler sees what the
|
|
50
|
+
* callback configured (the reference passes it as `self`). Undefined when a
|
|
51
|
+
* caller runs {@link SwaigFunction.execute} directly.
|
|
9
52
|
* @returns A FunctionResult, a plain object with a response key, a string, or a Promise of any of these.
|
|
10
53
|
*/
|
|
11
|
-
export type SwaigHandler = (args: Record<string, unknown>, rawData:
|
|
54
|
+
export type SwaigHandler = (args: Record<string, unknown>, rawData: SwaigRequest, agent?: AgentBase) => FunctionResult | Record<string, unknown> | string | Promise<FunctionResult | Record<string, unknown> | string>;
|
|
55
|
+
/**
|
|
56
|
+
* Context passed to an {@link SwaigErrorHandler} when a tool handler throws.
|
|
57
|
+
*/
|
|
58
|
+
export interface SwaigErrorContext {
|
|
59
|
+
/** Name of the tool whose handler threw. */
|
|
60
|
+
functionName: string;
|
|
61
|
+
/** The parsed arguments the handler was invoked with. */
|
|
62
|
+
args: Record<string, unknown>;
|
|
63
|
+
/** The full raw request payload (if available). */
|
|
64
|
+
rawData?: SwaigRequest;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Hook invoked when a SWAIG tool handler throws. Lets authors observe the
|
|
68
|
+
* failure (report to Sentry/Datadog, log with full context) and optionally
|
|
69
|
+
* decide the user-facing response.
|
|
70
|
+
*
|
|
71
|
+
* - Return a {@link FunctionResult} to control exactly what the AI receives.
|
|
72
|
+
* - Return `void`/`undefined` to fall back to the default error response.
|
|
73
|
+
*
|
|
74
|
+
* The error is always contained — a thrown handler never propagates to the
|
|
75
|
+
* HTTP layer (that would break the live call). This hook makes the containment
|
|
76
|
+
* *observable and configurable* instead of opaque.
|
|
77
|
+
*/
|
|
78
|
+
export type SwaigErrorHandler = (error: unknown, context: SwaigErrorContext) => FunctionResult | void | Promise<FunctionResult | void>;
|
|
79
|
+
/**
|
|
80
|
+
* Default user-facing message returned when a tool handler throws and no
|
|
81
|
+
* {@link SwaigErrorHandler} supplies its own response.
|
|
82
|
+
*/
|
|
83
|
+
export declare const DEFAULT_SWAIG_ERROR_MESSAGE = "Sorry, I couldn't complete that action. Please try again or contact support if the issue persists.";
|
|
12
84
|
/** Configuration options for creating a SwaigFunction. */
|
|
13
85
|
export interface SwaigFunctionOptions {
|
|
14
86
|
/** Unique name used to register and invoke this tool. */
|
|
@@ -19,7 +91,19 @@ export interface SwaigFunctionOptions {
|
|
|
19
91
|
description: string;
|
|
20
92
|
/** JSON Schema properties describing the tool's parameters. */
|
|
21
93
|
parameters?: Record<string, unknown>;
|
|
22
|
-
/**
|
|
94
|
+
/**
|
|
95
|
+
* Whether this tool requires session token authentication.
|
|
96
|
+
*
|
|
97
|
+
* **Defaults to `true` — secure by default.** A tool registered without an
|
|
98
|
+
* explicit `secure` requires SWAIG token validation, and its rendered SWML
|
|
99
|
+
* webhook carries a per-tool `__token`. Pass `secure: false` only to
|
|
100
|
+
* deliberately expose a tool on the unauthenticated shared webhook URL.
|
|
101
|
+
*
|
|
102
|
+
* **Python equivalent:** `define_tool(..., secure: bool = True)` — every
|
|
103
|
+
* user-facing entry point in the reference (`ToolMixin.define_tool`,
|
|
104
|
+
* `ToolRegistry.define_tool`, the `@AgentBase.tool()` decorator) defaults
|
|
105
|
+
* `secure=True`.
|
|
106
|
+
*/
|
|
23
107
|
secure?: boolean;
|
|
24
108
|
/** Language-keyed filler phrases spoken while the tool executes. */
|
|
25
109
|
fillers?: Record<string, string[]>;
|
|
@@ -52,6 +136,17 @@ export interface SwaigFunctionOptions {
|
|
|
52
136
|
extraFields?: Record<string, unknown>;
|
|
53
137
|
/** Whether this tool uses a typed handler with named parameters. */
|
|
54
138
|
isTypedHandler?: boolean;
|
|
139
|
+
/**
|
|
140
|
+
* Per-tool error hook. Invoked when this tool's handler throws, before the
|
|
141
|
+
* default error response is produced. See {@link SwaigErrorHandler}.
|
|
142
|
+
*/
|
|
143
|
+
onError?: SwaigErrorHandler;
|
|
144
|
+
/**
|
|
145
|
+
* Per-tool override for the user-facing message returned when the handler
|
|
146
|
+
* throws and no {@link onError} hook supplies a response. Defaults to
|
|
147
|
+
* {@link DEFAULT_SWAIG_ERROR_MESSAGE}.
|
|
148
|
+
*/
|
|
149
|
+
errorMessage?: string;
|
|
55
150
|
}
|
|
56
151
|
/**
|
|
57
152
|
* A SWAIG function — exactly the same concept as a "tool" in native
|
|
@@ -111,6 +206,10 @@ export declare class SwaigFunction {
|
|
|
111
206
|
isTypedHandler: boolean;
|
|
112
207
|
/** Whether this tool is externally hosted (has a webhookUrl). */
|
|
113
208
|
isExternal: boolean;
|
|
209
|
+
/** Per-tool error hook; see {@link SwaigErrorHandler}. */
|
|
210
|
+
onError?: SwaigErrorHandler;
|
|
211
|
+
/** Per-tool user-facing error message override. */
|
|
212
|
+
errorMessage?: string;
|
|
114
213
|
/**
|
|
115
214
|
* Create a new SwaigFunction.
|
|
116
215
|
*
|
|
@@ -147,7 +246,14 @@ export declare class SwaigFunction {
|
|
|
147
246
|
* @param rawData - The full raw request payload.
|
|
148
247
|
* @returns A serialized result dictionary suitable for the SWAIG response.
|
|
149
248
|
*/
|
|
150
|
-
execute(args: Record<string, unknown>, rawData?:
|
|
249
|
+
execute(args: Record<string, unknown>, rawData?: SwaigRequest, agentOnError?: SwaigErrorHandler): Promise<SwaigResultDict>;
|
|
250
|
+
/**
|
|
251
|
+
* {@link execute}, passing `agent` to the handler as its third argument: the
|
|
252
|
+
* agent running the call, which with a dynamic config callback is the
|
|
253
|
+
* request's configured copy.
|
|
254
|
+
* @internal
|
|
255
|
+
*/
|
|
256
|
+
_executeAs(agent: AgentBase | undefined, args: Record<string, unknown>, rawData?: SwaigRequest, agentOnError?: SwaigErrorHandler): Promise<SwaigResultDict>;
|
|
151
257
|
/**
|
|
152
258
|
* Serialize this function to the SWAIG wire format for inclusion in SWML.
|
|
153
259
|
* @param baseUrl - The base URL of the agent server.
|
package/dist/SwaigFunction.js
CHANGED
|
@@ -5,7 +5,93 @@ import Ajv from 'ajv';
|
|
|
5
5
|
import { FunctionResult } from './FunctionResult.js';
|
|
6
6
|
import { getLogger } from './Logger.js';
|
|
7
7
|
const ajv = new Ajv({ allErrors: true });
|
|
8
|
+
/**
|
|
9
|
+
* Compiled argument validators, keyed by the schema's JSON, so every call of
|
|
10
|
+
* a tool (and of its per-request copies) reuses one. Bounded: the oldest
|
|
11
|
+
* entry goes when it's full. Each schema is removed from Ajv's own cache
|
|
12
|
+
* once compiled, so only this map holds it.
|
|
13
|
+
*/
|
|
14
|
+
const VALIDATOR_CACHE_LIMIT = 500;
|
|
15
|
+
const compiledValidators = new Map();
|
|
16
|
+
let compileCount = 0;
|
|
17
|
+
function validatorFor(schema) {
|
|
18
|
+
const key = JSON.stringify(schema);
|
|
19
|
+
const cached = compiledValidators.get(key);
|
|
20
|
+
if (cached)
|
|
21
|
+
return cached;
|
|
22
|
+
const validate = ajv.compile(schema);
|
|
23
|
+
ajv.removeSchema(schema);
|
|
24
|
+
compileCount += 1;
|
|
25
|
+
if (compiledValidators.size >= VALIDATOR_CACHE_LIMIT) {
|
|
26
|
+
compiledValidators.delete(compiledValidators.keys().next().value);
|
|
27
|
+
}
|
|
28
|
+
compiledValidators.set(key, validate);
|
|
29
|
+
return validate;
|
|
30
|
+
}
|
|
31
|
+
/** @internal How many argument validators have been compiled (for tests). */
|
|
32
|
+
export function _compiledValidatorCount() {
|
|
33
|
+
return compileCount;
|
|
34
|
+
}
|
|
8
35
|
const log = getLogger('SwaigFunction');
|
|
36
|
+
/**
|
|
37
|
+
* Decide whether a `parameters` value is already a full JSON Schema object
|
|
38
|
+
* (`{ type: 'object', properties: {...} }`) versus a bare map of property
|
|
39
|
+
* definitions that must be wrapped.
|
|
40
|
+
*
|
|
41
|
+
* Robust discriminator: a value is a full schema ONLY when its `type` is the
|
|
42
|
+
* string `'object'` AND its `properties` is itself an object. The old check
|
|
43
|
+
* (`'type' in p && 'properties' in p`) misclassified a tool whose parameters
|
|
44
|
+
* are literally NAMED `type` and `properties`: for such a bare map the value of
|
|
45
|
+
* `type` is a property-definition object (not the string `'object'`), so this
|
|
46
|
+
* check correctly treats it as a bare properties map.
|
|
47
|
+
*
|
|
48
|
+
* @param parameters - The raw `parameters` value to inspect.
|
|
49
|
+
* @returns `true` if it is already a full JSON Schema object.
|
|
50
|
+
*/
|
|
51
|
+
export function isFullParameterSchema(parameters) {
|
|
52
|
+
const props = parameters.properties;
|
|
53
|
+
return (parameters.type === 'object' &&
|
|
54
|
+
typeof props === 'object' &&
|
|
55
|
+
props !== null);
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Normalize a tool's `parameters` into a full JSON Schema object suitable for
|
|
59
|
+
* SWAIG / MCP output.
|
|
60
|
+
*
|
|
61
|
+
* - An empty/absent map becomes `{ type: 'object', properties: {} }`.
|
|
62
|
+
* - An already-full schema (see {@link isFullParameterSchema}) is returned
|
|
63
|
+
* unchanged.
|
|
64
|
+
* - A bare properties map is wrapped as
|
|
65
|
+
* `{ type: 'object', properties: <map>, required?: <required> }`.
|
|
66
|
+
*
|
|
67
|
+
* This is the single source of truth for the `parameters` shape sniff that used
|
|
68
|
+
* to be reimplemented in SwaigFunction, AgentBase MCP tool listing, and the
|
|
69
|
+
* AgentBase SWAIG function table.
|
|
70
|
+
*
|
|
71
|
+
* @param parameters - The raw `parameters` value (bare properties map or full schema).
|
|
72
|
+
* @param required - Required-parameter names, applied only when wrapping a bare map.
|
|
73
|
+
* @returns A full JSON Schema object.
|
|
74
|
+
*/
|
|
75
|
+
export function normalizeParameters(parameters, required = []) {
|
|
76
|
+
if (!parameters || Object.keys(parameters).length === 0) {
|
|
77
|
+
return { type: 'object', properties: {} };
|
|
78
|
+
}
|
|
79
|
+
if (isFullParameterSchema(parameters)) {
|
|
80
|
+
return parameters;
|
|
81
|
+
}
|
|
82
|
+
const result = {
|
|
83
|
+
type: 'object',
|
|
84
|
+
properties: parameters,
|
|
85
|
+
};
|
|
86
|
+
if (required.length)
|
|
87
|
+
result['required'] = required;
|
|
88
|
+
return result;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Default user-facing message returned when a tool handler throws and no
|
|
92
|
+
* {@link SwaigErrorHandler} supplies its own response.
|
|
93
|
+
*/
|
|
94
|
+
export const DEFAULT_SWAIG_ERROR_MESSAGE = "Sorry, I couldn't complete that action. Please try again or contact support if the issue persists.";
|
|
9
95
|
/**
|
|
10
96
|
* A SWAIG function — exactly the same concept as a "tool" in native
|
|
11
97
|
* OpenAI / Anthropic tool calling.
|
|
@@ -64,6 +150,10 @@ export class SwaigFunction {
|
|
|
64
150
|
isTypedHandler;
|
|
65
151
|
/** Whether this tool is externally hosted (has a webhookUrl). */
|
|
66
152
|
isExternal;
|
|
153
|
+
/** Per-tool error hook; see {@link SwaigErrorHandler}. */
|
|
154
|
+
onError;
|
|
155
|
+
/** Per-tool user-facing error message override. */
|
|
156
|
+
errorMessage;
|
|
67
157
|
/**
|
|
68
158
|
* Create a new SwaigFunction.
|
|
69
159
|
*
|
|
@@ -79,7 +169,11 @@ export class SwaigFunction {
|
|
|
79
169
|
this.handler = opts.handler;
|
|
80
170
|
this.description = opts.description;
|
|
81
171
|
this.parameters = opts.parameters ?? {};
|
|
82
|
-
|
|
172
|
+
// SECURE BY DEFAULT (A1): a tool registered without an explicit `secure`
|
|
173
|
+
// requires token validation, and renderSwml mints its per-tool `__token`.
|
|
174
|
+
// Matches the reference's user-facing `define_tool(..., secure=True)`
|
|
175
|
+
// (tool_mixin.py:37 / tools/registry.py:42 / tools/decorator.py:95).
|
|
176
|
+
this.secure = opts.secure ?? true;
|
|
83
177
|
this.fillers = opts.fillers;
|
|
84
178
|
this.waitFile = opts.waitFile;
|
|
85
179
|
this.waitFileLoops = opts.waitFileLoops;
|
|
@@ -88,21 +182,11 @@ export class SwaigFunction {
|
|
|
88
182
|
this.extraFields = opts.extraFields ?? {};
|
|
89
183
|
this.isTypedHandler = opts.isTypedHandler ?? false;
|
|
90
184
|
this.isExternal = opts.webhookUrl !== undefined;
|
|
185
|
+
this.onError = opts.onError;
|
|
186
|
+
this.errorMessage = opts.errorMessage;
|
|
91
187
|
}
|
|
92
188
|
ensureParameterStructure() {
|
|
93
|
-
|
|
94
|
-
return { type: 'object', properties: {} };
|
|
95
|
-
}
|
|
96
|
-
if ('type' in this.parameters && 'properties' in this.parameters) {
|
|
97
|
-
return this.parameters;
|
|
98
|
-
}
|
|
99
|
-
const result = {
|
|
100
|
-
type: 'object',
|
|
101
|
-
properties: this.parameters,
|
|
102
|
-
};
|
|
103
|
-
if (this.required.length)
|
|
104
|
-
result['required'] = this.required;
|
|
105
|
-
return result;
|
|
189
|
+
return normalizeParameters(this.parameters, this.required);
|
|
106
190
|
}
|
|
107
191
|
/**
|
|
108
192
|
* Validate arguments against the parameter JSON schema using full
|
|
@@ -127,7 +211,7 @@ export class SwaigFunction {
|
|
|
127
211
|
if (!properties || Object.keys(properties).length === 0) {
|
|
128
212
|
return [true, []];
|
|
129
213
|
}
|
|
130
|
-
const validate =
|
|
214
|
+
const validate = validatorFor(schema);
|
|
131
215
|
const valid = validate(args);
|
|
132
216
|
if (valid) {
|
|
133
217
|
return [true, []];
|
|
@@ -146,9 +230,34 @@ export class SwaigFunction {
|
|
|
146
230
|
* @param rawData - The full raw request payload.
|
|
147
231
|
* @returns A serialized result dictionary suitable for the SWAIG response.
|
|
148
232
|
*/
|
|
149
|
-
async execute(args, rawData) {
|
|
233
|
+
async execute(args, rawData, agentOnError) {
|
|
234
|
+
return this._executeAs(undefined, args, rawData, agentOnError);
|
|
235
|
+
}
|
|
236
|
+
/**
|
|
237
|
+
* {@link execute}, passing `agent` to the handler as its third argument: the
|
|
238
|
+
* agent running the call, which with a dynamic config callback is the
|
|
239
|
+
* request's configured copy.
|
|
240
|
+
* @internal
|
|
241
|
+
*/
|
|
242
|
+
async _executeAs(agent, args, rawData, agentOnError) {
|
|
243
|
+
// Soft validation, as the reference's tool_mixin does: arguments that
|
|
244
|
+
// don't match the schema are logged, and the handler still runs.
|
|
245
|
+
if (args && Object.keys(args).length > 0) {
|
|
246
|
+
try {
|
|
247
|
+
const [valid, errors] = this.validateArgs(args);
|
|
248
|
+
if (!valid) {
|
|
249
|
+
log.warn(`Argument validation failed for function '${this.name}': ${errors.join('; ')}`);
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
catch (err) {
|
|
253
|
+
log.debug(`Argument validation error for function '${this.name}': ${err instanceof Error ? err.message : String(err)}`);
|
|
254
|
+
}
|
|
255
|
+
}
|
|
150
256
|
try {
|
|
151
|
-
|
|
257
|
+
// Runtime fallback is the empty object (unchanged); the cast is
|
|
258
|
+
// compile-time only — the backend always sends the full payload, but
|
|
259
|
+
// `execute` allows callers to omit it (e.g. CLI/test harnesses).
|
|
260
|
+
const result = await this.handler(args, rawData ?? {}, agent);
|
|
152
261
|
if (result instanceof FunctionResult) {
|
|
153
262
|
return result.toDict();
|
|
154
263
|
}
|
|
@@ -159,6 +268,8 @@ export class SwaigFunction {
|
|
|
159
268
|
return new FunctionResult('Function completed successfully').toDict();
|
|
160
269
|
}
|
|
161
270
|
if (typeof result === 'object' && result !== null) {
|
|
271
|
+
// Handler returned a plain object that already carries a `response`
|
|
272
|
+
// key — it IS the SWAIG response dict; pass it through unchanged.
|
|
162
273
|
return result;
|
|
163
274
|
}
|
|
164
275
|
// Neither a FunctionResult nor a dict — warn and fall back to
|
|
@@ -172,8 +283,29 @@ export class SwaigFunction {
|
|
|
172
283
|
return new FunctionResult(String(result)).toDict();
|
|
173
284
|
}
|
|
174
285
|
catch (err) {
|
|
175
|
-
|
|
176
|
-
|
|
286
|
+
// Preserve the stack for Error instances (plain `${err}` discards it).
|
|
287
|
+
const detail = err instanceof Error ? (err.stack ?? `${err.name}: ${err.message}`) : String(err);
|
|
288
|
+
log.error(`Error executing SWAIG function ${this.name}: ${detail}`);
|
|
289
|
+
// Give authors a programmatic surface: per-tool hook first, then the
|
|
290
|
+
// agent-level hook. Either may return a FunctionResult to control what
|
|
291
|
+
// the AI sees; if a hook itself throws, that's logged and we continue to
|
|
292
|
+
// the next fallback (the error is always contained — a thrown handler
|
|
293
|
+
// must never break the live call).
|
|
294
|
+
const ctx = { functionName: this.name, args, rawData };
|
|
295
|
+
for (const hook of [this.onError, agentOnError]) {
|
|
296
|
+
if (!hook)
|
|
297
|
+
continue;
|
|
298
|
+
try {
|
|
299
|
+
const handled = await hook(err, ctx);
|
|
300
|
+
if (handled instanceof FunctionResult) {
|
|
301
|
+
return handled.toDict();
|
|
302
|
+
}
|
|
303
|
+
}
|
|
304
|
+
catch (hookErr) {
|
|
305
|
+
log.error(`onError hook for SWAIG function ${this.name} threw: ${hookErr}`);
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
return new FunctionResult(this.errorMessage ?? DEFAULT_SWAIG_ERROR_MESSAGE).toDict();
|
|
177
309
|
}
|
|
178
310
|
}
|
|
179
311
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SwaigFunction.js","sourceRoot":"","sources":["../src/SwaigFunction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,cAAc,
|
|
1
|
+
{"version":3,"file":"SwaigFunction.js","sourceRoot":"","sources":["../src/SwaigFunction.ts"],"names":[],"mappings":"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"}
|
package/dist/SwmlBuilder.d.ts
CHANGED
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
* fluent chaining and call `addVerb()` internally.
|
|
9
9
|
*/
|
|
10
10
|
import { SchemaUtils } from './SchemaUtils.js';
|
|
11
|
+
import type { TtsGender } from './relay/closedSets.js';
|
|
11
12
|
import './SwmlVerbMethods.generated.js';
|
|
12
13
|
/** Options for constructing a SwmlBuilder. */
|
|
13
14
|
export interface SwmlBuilderOptions {
|
|
@@ -25,6 +26,26 @@ export interface SwmlBuilderOptions {
|
|
|
25
26
|
* a per-instance SchemaUtils loaded from this path instead of the bundled schema.
|
|
26
27
|
* Mirrors Python's `schema_path` constructor parameter on `SWMLService`/`AgentBase`. */
|
|
27
28
|
schemaPath?: string;
|
|
29
|
+
/** The `SWMLService` this builder belongs to, kept as a public back-reference
|
|
30
|
+
* ({@link SwmlBuilder.service}). The reference's `SWMLBuilder(service)` takes it as
|
|
31
|
+
* its sole constructor argument and keeps it as public `self.service`. Omit for a
|
|
32
|
+
* standalone builder (the common case — a builder used to hand-craft SWML has no
|
|
33
|
+
* service). */
|
|
34
|
+
service?: SWMLServiceLike;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* The `SWMLService` shape a builder holds a back-reference to.
|
|
38
|
+
*
|
|
39
|
+
* Structural (rather than a direct `SWMLService` import) because `SWMLService`
|
|
40
|
+
* constructs a `SwmlBuilder`; a value import here would close an initialization
|
|
41
|
+
* cycle. Only the identity of the service matters to the back-reference, so the
|
|
42
|
+
* members named are the ones a holder of the reference can rely on.
|
|
43
|
+
*/
|
|
44
|
+
export interface SWMLServiceLike {
|
|
45
|
+
/** The service's name. */
|
|
46
|
+
readonly name: string;
|
|
47
|
+
/** The route the service is mounted at. */
|
|
48
|
+
readonly route: string;
|
|
28
49
|
}
|
|
29
50
|
/**
|
|
30
51
|
* Builds SWML documents composed of verb instructions organized into named sections.
|
|
@@ -58,6 +79,18 @@ export declare class SwmlBuilder {
|
|
|
58
79
|
/** Per-instance SchemaUtils used when a custom `schemaPath` was supplied. */
|
|
59
80
|
private _instanceSchemaUtils;
|
|
60
81
|
private enableValidation;
|
|
82
|
+
/**
|
|
83
|
+
* The `SWMLService` this builder belongs to — the reference's public
|
|
84
|
+
* `self.service` (`core/swml_builder.py:57`) — or `undefined` for a standalone
|
|
85
|
+
* builder.
|
|
86
|
+
*
|
|
87
|
+
* In the reference the builder DELEGATES document construction to the service, so
|
|
88
|
+
* the service is a required constructor argument. TS inverts the ownership (the
|
|
89
|
+
* builder holds its own document and `SWMLService` holds the builder), which is why
|
|
90
|
+
* it is optional here. The read-back is the same: a caller holding the builder can
|
|
91
|
+
* reach the service that owns it.
|
|
92
|
+
*/
|
|
93
|
+
readonly service?: SWMLServiceLike;
|
|
61
94
|
/**
|
|
62
95
|
* Creates a new SwmlBuilder.
|
|
63
96
|
* @param opts - Optional configuration.
|
|
@@ -71,8 +104,10 @@ export declare class SwmlBuilder {
|
|
|
71
104
|
private getSchemaUtils;
|
|
72
105
|
/**
|
|
73
106
|
* Public read-only accessor for the underlying SWML document.
|
|
74
|
-
*
|
|
75
|
-
* `service`
|
|
107
|
+
*
|
|
108
|
+
* (Not the reference's `service` — that is the SWMLService back-reference, exposed
|
|
109
|
+
* as {@link service}. This is the document the builder is assembling, which the
|
|
110
|
+
* reference reaches through `self.service`.)
|
|
76
111
|
*/
|
|
77
112
|
get document(): {
|
|
78
113
|
version: string;
|
|
@@ -106,15 +141,39 @@ export declare class SwmlBuilder {
|
|
|
106
141
|
* Validates the verb config against the schema when validation is enabled.
|
|
107
142
|
* @param verbName - The SWML verb name (e.g., "answer", "ai").
|
|
108
143
|
* @param config - The verb's configuration payload.
|
|
144
|
+
* @param opts - When `opts.skipValidation` is true, the config is appended
|
|
145
|
+
* WITHOUT schema validation. Used by AgentBase for the internally-assembled
|
|
146
|
+
* `ai` verb, whose config is built from already-typed builder inputs and may
|
|
147
|
+
* carry real, server-accepted SWML that the bundled schema does not yet model
|
|
148
|
+
* (e.g. `multilingual`, `SWAIG.mcp_servers`, per-language engine/model/fillers,
|
|
149
|
+
* `debug_webhook_url`). Validating it against the closed schema would raise on
|
|
150
|
+
* those legitimate features — the strict-render contract is about rejecting
|
|
151
|
+
* MISSHAPEN direct `addVerb` input (unknown verb, misspelled/unknown key,
|
|
152
|
+
* wrong type), NOT about second-guessing trusted internal assembly. The
|
|
153
|
+
* direct/public `addVerb` path stays fully strict.
|
|
109
154
|
*/
|
|
110
|
-
addVerb(verbName: string, config: unknown
|
|
155
|
+
addVerb(verbName: string, config: unknown, opts?: {
|
|
156
|
+
skipValidation?: boolean;
|
|
157
|
+
}): void;
|
|
111
158
|
/**
|
|
112
159
|
* Appends a verb to a named section, creating the section if it does not exist.
|
|
160
|
+
*
|
|
161
|
+
* Validates exactly as {@link addVerb} does. The reference validates at BOTH
|
|
162
|
+
* add-verb sites (`core/swml_service.py:558` and `:635`, each raising
|
|
163
|
+
* `SchemaValidationError`); this path previously appended without validating, so a
|
|
164
|
+
* misshapen or unknown verb reached a non-main section silently.
|
|
165
|
+
*
|
|
113
166
|
* @param sectionName - The target section name.
|
|
114
167
|
* @param verbName - The SWML verb name.
|
|
115
168
|
* @param config - The verb's configuration payload.
|
|
169
|
+
* @param opts - When `opts.skipValidation` is true, append without validating
|
|
170
|
+
* (same trusted-internal-assembly escape hatch as {@link addVerb}).
|
|
171
|
+
* @throws {SchemaValidationError} When validation is enabled and the config does
|
|
172
|
+
* not satisfy the verb's schema (or the verb is unknown).
|
|
116
173
|
*/
|
|
117
|
-
addVerbToSection(sectionName: string, verbName: string, config: unknown
|
|
174
|
+
addVerbToSection(sectionName: string, verbName: string, config: unknown, opts?: {
|
|
175
|
+
skipValidation?: boolean;
|
|
176
|
+
}): void;
|
|
118
177
|
/**
|
|
119
178
|
* Add a 'play' verb with say: prefix for text-to-speech.
|
|
120
179
|
* Convenience wrapper matching Python SDK's `say()` method.
|
|
@@ -126,7 +185,7 @@ export declare class SwmlBuilder {
|
|
|
126
185
|
say(text: string, opts?: {
|
|
127
186
|
voice?: string;
|
|
128
187
|
language?: string;
|
|
129
|
-
gender?:
|
|
188
|
+
gender?: TtsGender;
|
|
130
189
|
volume?: number;
|
|
131
190
|
}): this;
|
|
132
191
|
/**
|
|
@@ -139,25 +198,15 @@ export declare class SwmlBuilder {
|
|
|
139
198
|
*/
|
|
140
199
|
addSection(sectionName: string): this;
|
|
141
200
|
/**
|
|
142
|
-
*
|
|
143
|
-
*
|
|
144
|
-
*/
|
|
145
|
-
getDocument(): Record<string, unknown>;
|
|
146
|
-
/**
|
|
147
|
-
* Alias for {@link getDocument}. Matches the Python SDK's `build()` method.
|
|
148
|
-
* Build and return the SWML document as a dictionary/object.
|
|
201
|
+
* Build and return the SWML document as a dictionary/object. Canonical name,
|
|
202
|
+
* matching Python's `SWMLBuilder.build()`.
|
|
149
203
|
*
|
|
150
204
|
* @returns The document with version and sections.
|
|
151
205
|
*/
|
|
152
206
|
build(): Record<string, unknown>;
|
|
153
207
|
/**
|
|
154
|
-
*
|
|
155
|
-
*
|
|
156
|
-
*/
|
|
157
|
-
renderDocument(): string;
|
|
158
|
-
/**
|
|
159
|
-
* Alias for {@link renderDocument}. Matches the Python SDK's `render()` method.
|
|
160
|
-
* Build and render the SWML document as a JSON string.
|
|
208
|
+
* Build and render the SWML document as a JSON string. Canonical name,
|
|
209
|
+
* matching Python's `SWMLBuilder.render()`.
|
|
161
210
|
*
|
|
162
211
|
* @returns The JSON-encoded SWML document.
|
|
163
212
|
*/
|