@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
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PostPrompt - post-prompt normalization.
|
|
3
|
+
*
|
|
4
|
+
* One conversation can run over voice and over text chat, and both engines
|
|
5
|
+
* deliver "the post-prompt", but not in the same shape. This module absorbs
|
|
6
|
+
* the differences, so an application sees one result whichever engine
|
|
7
|
+
* finished the conversation.
|
|
8
|
+
*
|
|
9
|
+
* | field | voice | chat |
|
|
10
|
+
* | ------------------- | ----------------------------------- | ------------------------------------- |
|
|
11
|
+
* | `app_name` | `"swml app"` | `"ai_chat"` |
|
|
12
|
+
* | `conversation_id` | absent | present at top level |
|
|
13
|
+
* | full log | `raw_call_log` | `raw_messages` |
|
|
14
|
+
* | summary arrives as | a `summarize_conversation` tool call | a bare `role: assistant` turn in `call_log` |
|
|
15
|
+
* | `post_prompt_data` | parsed object | `{ "raw": "```json ...```" }` |
|
|
16
|
+
*
|
|
17
|
+
* `conversation_type` tells them apart on both. The voice engine also sends a
|
|
18
|
+
* third `post_prompt_data` shape, the object wrapped in a list under `parsed`
|
|
19
|
+
* (`{ "parsed": [ {...} ], "raw": "..." }`), which misses every field lookup
|
|
20
|
+
* unless handled.
|
|
21
|
+
*
|
|
22
|
+
* Parsing is schema-agnostic: what a summary contains is whatever the
|
|
23
|
+
* application's post-prompt asked the model for, returned as found. Nothing
|
|
24
|
+
* here throws; the conversation that produced the input is already over.
|
|
25
|
+
* Mirrors signalwire-python's `signalwire.core.post_prompt`.
|
|
26
|
+
*/
|
|
27
|
+
/**
|
|
28
|
+
* Roles that are actual dialogue. Everything else in a call log is machinery:
|
|
29
|
+
* `system` is the prompt, `system-log` is lifecycle and step tracing, `tool` is
|
|
30
|
+
* function output, and `assistant-manual` is filler speech.
|
|
31
|
+
*/
|
|
32
|
+
export const DIALOGUE_ROLES = Object.freeze(['user', 'assistant']);
|
|
33
|
+
/** One finished conversation leg, in a shape that doesn't vary by engine. */
|
|
34
|
+
export class NormalizedPostPrompt {
|
|
35
|
+
/** `conversation_type` as reported, e.g. `voice` or `chat`; '' when the engine didn't say. */
|
|
36
|
+
medium = '';
|
|
37
|
+
/**
|
|
38
|
+
* Present on chat, absent on voice; null when the engine didn't supply one.
|
|
39
|
+
* Callers that need a stable key should fall back to their own (global
|
|
40
|
+
* data, the call id) rather than treat this as authoritative.
|
|
41
|
+
*/
|
|
42
|
+
conversationId = null;
|
|
43
|
+
/**
|
|
44
|
+
* The parsed `post_prompt_data`, with whatever keys the post-prompt asked
|
|
45
|
+
* for; `{}` when there was none or it couldn't be parsed. A model that
|
|
46
|
+
* answered in prose instead of JSON yields `{ summary: '<the prose>' }`.
|
|
47
|
+
*/
|
|
48
|
+
summary = {};
|
|
49
|
+
/** User and assistant turns only, with tool calls and the chat engine's summary echo removed. */
|
|
50
|
+
dialogue = [];
|
|
51
|
+
/** The platform call id, when present. */
|
|
52
|
+
callId = null;
|
|
53
|
+
/** The complete request body, untouched. */
|
|
54
|
+
raw = {};
|
|
55
|
+
/**
|
|
56
|
+
* @param fields - Field values; any left out take the empty defaults above.
|
|
57
|
+
* {@link normalizePostPrompt} is the usual way to get one.
|
|
58
|
+
*/
|
|
59
|
+
constructor(fields = {}) {
|
|
60
|
+
Object.assign(this, fields);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
function isPlainObject(value) {
|
|
64
|
+
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
65
|
+
}
|
|
66
|
+
/** Whether a JSON value carries anything: an empty array or object counts as absent. */
|
|
67
|
+
function present(value) {
|
|
68
|
+
if (Array.isArray(value))
|
|
69
|
+
return value.length > 0;
|
|
70
|
+
if (isPlainObject(value))
|
|
71
|
+
return Object.keys(value).length > 0;
|
|
72
|
+
return Boolean(value);
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Unwrap ```` ```json ... ``` ```` fencing. The chat engine hands the model's
|
|
76
|
+
* answer back verbatim, fence and all, where the voice engine parses it first.
|
|
77
|
+
* @param text - The text to unwrap.
|
|
78
|
+
* @returns The text without a surrounding code fence.
|
|
79
|
+
*/
|
|
80
|
+
export function stripJsonFence(text) {
|
|
81
|
+
let stripped = (text ?? '').trim();
|
|
82
|
+
if (stripped.startsWith('```')) {
|
|
83
|
+
stripped = stripped.replace(/^```[a-zA-Z]*\s*/, '').replace(/\s*```$/, '');
|
|
84
|
+
}
|
|
85
|
+
return stripped.trim();
|
|
86
|
+
}
|
|
87
|
+
/** The object inside a `{ parsed: [...] }` wrapper, if there is one. */
|
|
88
|
+
function unwrapParsed(data) {
|
|
89
|
+
const parsed = data['parsed'];
|
|
90
|
+
if (isPlainObject(parsed))
|
|
91
|
+
return parsed;
|
|
92
|
+
if (Array.isArray(parsed)) {
|
|
93
|
+
for (const item of parsed) {
|
|
94
|
+
if (isPlainObject(item) && Object.keys(item).length > 0)
|
|
95
|
+
return item;
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
return null;
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* `post_prompt_data` as a plain object, whichever shape it arrived in. Never
|
|
102
|
+
* throws: a malformed summary degrades to `{}` rather than failing the request
|
|
103
|
+
* that delivered it.
|
|
104
|
+
* @param data - The `post_prompt_data` value from a post-prompt body.
|
|
105
|
+
* @returns The summary object, or `{}` when there's nothing usable.
|
|
106
|
+
*/
|
|
107
|
+
export function parsePostPromptData(data) {
|
|
108
|
+
if (!isPlainObject(data))
|
|
109
|
+
return {};
|
|
110
|
+
const unwrapped = unwrapParsed(data);
|
|
111
|
+
if (unwrapped && Object.keys(unwrapped).length > 0)
|
|
112
|
+
return unwrapped;
|
|
113
|
+
// Flat shape: real keys already present (anything but raw/parsed).
|
|
114
|
+
const flat = Object.fromEntries(Object.entries(data).filter(([k]) => k !== 'raw' && k !== 'parsed'));
|
|
115
|
+
if (Object.keys(flat).length > 0)
|
|
116
|
+
return flat;
|
|
117
|
+
const raw = data['raw'];
|
|
118
|
+
if (typeof raw !== 'string' || !raw.trim())
|
|
119
|
+
return {};
|
|
120
|
+
const unfenced = stripJsonFence(raw);
|
|
121
|
+
let loaded;
|
|
122
|
+
try {
|
|
123
|
+
loaded = JSON.parse(unfenced);
|
|
124
|
+
}
|
|
125
|
+
catch {
|
|
126
|
+
// Prose instead of JSON. Still a summary.
|
|
127
|
+
return { summary: unfenced };
|
|
128
|
+
}
|
|
129
|
+
if (isPlainObject(loaded))
|
|
130
|
+
return loaded;
|
|
131
|
+
// A JSON string is the summary itself; any other value (a list, a number)
|
|
132
|
+
// is kept as its JSON text rather than lost to String()'s "[object Object]".
|
|
133
|
+
return { summary: typeof loaded === 'string' ? loaded : JSON.stringify(loaded) };
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* The real dialogue from a call log: turns in `roles` with content, dropping
|
|
137
|
+
* entries that carry `tool_calls`.
|
|
138
|
+
*
|
|
139
|
+
* `dropEcho` is for one engine behavior: the chat engine appends its own
|
|
140
|
+
* post-prompt output to `call_log` as a bare `role: assistant` turn with no
|
|
141
|
+
* `tool_calls`, indistinguishable from real speech by role. It's identifiable
|
|
142
|
+
* only by content (identical to `post_prompt_data.raw`), which is what this
|
|
143
|
+
* compares against. The voice engine sends the same thing as a
|
|
144
|
+
* `summarize_conversation` tool call, which the `tool_calls` check removes.
|
|
145
|
+
*
|
|
146
|
+
* @param callLog - The log (`call_log`, `raw_call_log` or `raw_messages`).
|
|
147
|
+
* @param opts - `roles` to keep (default {@link DIALOGUE_ROLES}); `dropEcho`,
|
|
148
|
+
* exact content to treat as the summary echo and drop.
|
|
149
|
+
* @returns The turns, in order.
|
|
150
|
+
*/
|
|
151
|
+
export function dialogueTurns(callLog, opts = {}) {
|
|
152
|
+
if (!Array.isArray(callLog))
|
|
153
|
+
return [];
|
|
154
|
+
const roles = opts.roles ?? DIALOGUE_ROLES;
|
|
155
|
+
const echo = (opts.dropEcho ?? '').trim();
|
|
156
|
+
const out = [];
|
|
157
|
+
for (const entry of callLog) {
|
|
158
|
+
if (!isPlainObject(entry))
|
|
159
|
+
continue;
|
|
160
|
+
const role = entry['role'];
|
|
161
|
+
if (typeof role !== 'string' || !roles.includes(role))
|
|
162
|
+
continue;
|
|
163
|
+
if (present(entry['tool_calls']))
|
|
164
|
+
continue;
|
|
165
|
+
const content = entry['content'];
|
|
166
|
+
if (typeof content !== 'string' || !content.trim())
|
|
167
|
+
continue;
|
|
168
|
+
if (echo && content.trim() === echo)
|
|
169
|
+
continue;
|
|
170
|
+
out.push({ role, content });
|
|
171
|
+
}
|
|
172
|
+
return out;
|
|
173
|
+
}
|
|
174
|
+
/**
|
|
175
|
+
* Normalize a post-prompt body from either engine. Never throws; a body it
|
|
176
|
+
* can't make sense of yields a result with empty fields.
|
|
177
|
+
* @param body - The complete post-prompt request body.
|
|
178
|
+
* @returns The normalized leg.
|
|
179
|
+
*
|
|
180
|
+
* @example
|
|
181
|
+
* ```ts
|
|
182
|
+
* const leg = normalizePostPrompt(rawData);
|
|
183
|
+
* if (leg.dialogue.length) store(leg.conversationId, leg.medium, leg.summary, leg.dialogue);
|
|
184
|
+
* ```
|
|
185
|
+
*/
|
|
186
|
+
export function normalizePostPrompt(body) {
|
|
187
|
+
if (!isPlainObject(body))
|
|
188
|
+
return Object.freeze(new NormalizedPostPrompt());
|
|
189
|
+
const ppd = body['post_prompt_data'];
|
|
190
|
+
// The echo is the RAW string the engine returned (the turn carries the fence too).
|
|
191
|
+
const rawSummary = isPlainObject(ppd) && typeof ppd['raw'] === 'string' ? ppd['raw'] : '';
|
|
192
|
+
// An empty log counts as absent, so the next key is tried.
|
|
193
|
+
const log = ['call_log', 'raw_call_log', 'raw_messages'].map((k) => body[k]).find(present);
|
|
194
|
+
const text = (v) => (typeof v === 'string' && v ? v : null);
|
|
195
|
+
return Object.freeze(new NormalizedPostPrompt({
|
|
196
|
+
medium: body['conversation_type'] ? String(body['conversation_type']) : '',
|
|
197
|
+
conversationId: text(body['conversation_id']),
|
|
198
|
+
summary: parsePostPromptData(ppd),
|
|
199
|
+
dialogue: dialogueTurns(log, { dropEcho: rawSummary || null }),
|
|
200
|
+
callId: text(body['call_id']),
|
|
201
|
+
raw: body,
|
|
202
|
+
}));
|
|
203
|
+
}
|
|
204
|
+
//# sourceMappingURL=PostPrompt.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PostPrompt.js","sourceRoot":"","sources":["../src/PostPrompt.ts"],"names":[],"mappings":"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"}
|
package/dist/PromptManager.d.ts
CHANGED
|
@@ -4,17 +4,38 @@
|
|
|
4
4
|
* Holds either raw prompt text or a PomBuilder for structured prompts.
|
|
5
5
|
*/
|
|
6
6
|
import { PomBuilder } from './PomBuilder.js';
|
|
7
|
+
import type { AgentBase } from './AgentBase.js';
|
|
7
8
|
/** Manages agent prompt text, supporting both raw text and structured POM-based prompts. */
|
|
8
9
|
export declare class PromptManager {
|
|
9
10
|
private rawText;
|
|
10
11
|
private postPrompt;
|
|
11
12
|
private pom;
|
|
12
13
|
private usePom;
|
|
14
|
+
/**
|
|
15
|
+
* The agent this manager belongs to (the reference's public `self.agent`,
|
|
16
|
+
* `core/agent/prompt/manager.py:32`), or `undefined` for standalone use.
|
|
17
|
+
*
|
|
18
|
+
* The reference takes the parent agent as its sole constructor argument and keeps
|
|
19
|
+
* it as a public back-reference. A caller holding the manager can therefore walk
|
|
20
|
+
* back to its owner; this is the read-back of that same value.
|
|
21
|
+
*/
|
|
22
|
+
readonly agent?: AgentBase;
|
|
13
23
|
/**
|
|
14
24
|
* Creates a new PromptManager.
|
|
15
25
|
* @param usePom - Whether to use structured POM sections (default true).
|
|
26
|
+
* @param agent - Optional parent agent, kept as a public back-reference
|
|
27
|
+
* (the reference's `PromptManager(agent)`). Omit for standalone use.
|
|
28
|
+
*/
|
|
29
|
+
constructor(usePom?: boolean, agent?: AgentBase);
|
|
30
|
+
/**
|
|
31
|
+
* A copy of this manager's prompt state (raw text, post-prompt and POM
|
|
32
|
+
* sections) owned by `agent`, for a per-request copy of the agent. The POM
|
|
33
|
+
* sections are deep-copied (every depth, every bullet list), not rendered to
|
|
34
|
+
* text, so the copy still emits a structured prompt, and nothing the copy
|
|
35
|
+
* changes reaches this manager.
|
|
36
|
+
* @internal
|
|
16
37
|
*/
|
|
17
|
-
|
|
38
|
+
_copyFor(agent?: AgentBase): PromptManager;
|
|
18
39
|
/**
|
|
19
40
|
* Sets the raw prompt text, bypassing POM rendering.
|
|
20
41
|
* @param text - The raw prompt string.
|
|
@@ -82,4 +103,11 @@ export declare class PromptManager {
|
|
|
82
103
|
* @returns The PomBuilder, or null if POM is not in use.
|
|
83
104
|
*/
|
|
84
105
|
getPomBuilder(): PomBuilder | null;
|
|
106
|
+
/**
|
|
107
|
+
* Returns the raw prompt text whatever `setPromptText` stored, or null
|
|
108
|
+
* when no raw prompt has been set. Mirrors Python's
|
|
109
|
+
* `PromptManager.get_raw_prompt`.
|
|
110
|
+
* @returns The raw prompt string, or null if not set.
|
|
111
|
+
*/
|
|
112
|
+
getRawPrompt(): string | null;
|
|
85
113
|
}
|
package/dist/PromptManager.js
CHANGED
|
@@ -10,16 +10,43 @@ export class PromptManager {
|
|
|
10
10
|
postPrompt = null;
|
|
11
11
|
pom = null;
|
|
12
12
|
usePom;
|
|
13
|
+
/**
|
|
14
|
+
* The agent this manager belongs to (the reference's public `self.agent`,
|
|
15
|
+
* `core/agent/prompt/manager.py:32`), or `undefined` for standalone use.
|
|
16
|
+
*
|
|
17
|
+
* The reference takes the parent agent as its sole constructor argument and keeps
|
|
18
|
+
* it as a public back-reference. A caller holding the manager can therefore walk
|
|
19
|
+
* back to its owner; this is the read-back of that same value.
|
|
20
|
+
*/
|
|
21
|
+
agent;
|
|
13
22
|
/**
|
|
14
23
|
* Creates a new PromptManager.
|
|
15
24
|
* @param usePom - Whether to use structured POM sections (default true).
|
|
25
|
+
* @param agent - Optional parent agent, kept as a public back-reference
|
|
26
|
+
* (the reference's `PromptManager(agent)`). Omit for standalone use.
|
|
16
27
|
*/
|
|
17
|
-
constructor(usePom = true) {
|
|
28
|
+
constructor(usePom = true, agent) {
|
|
18
29
|
this.usePom = usePom;
|
|
30
|
+
this.agent = agent;
|
|
19
31
|
if (usePom) {
|
|
20
32
|
this.pom = new PomBuilder();
|
|
21
33
|
}
|
|
22
34
|
}
|
|
35
|
+
/**
|
|
36
|
+
* A copy of this manager's prompt state (raw text, post-prompt and POM
|
|
37
|
+
* sections) owned by `agent`, for a per-request copy of the agent. The POM
|
|
38
|
+
* sections are deep-copied (every depth, every bullet list), not rendered to
|
|
39
|
+
* text, so the copy still emits a structured prompt, and nothing the copy
|
|
40
|
+
* changes reaches this manager.
|
|
41
|
+
* @internal
|
|
42
|
+
*/
|
|
43
|
+
_copyFor(agent) {
|
|
44
|
+
const copy = new PromptManager(this.usePom, agent);
|
|
45
|
+
copy.rawText = this.rawText;
|
|
46
|
+
copy.postPrompt = this.postPrompt;
|
|
47
|
+
copy.pom = this.pom ? this.pom._clone() : null;
|
|
48
|
+
return copy;
|
|
49
|
+
}
|
|
23
50
|
/**
|
|
24
51
|
* Sets the raw prompt text, bypassing POM rendering.
|
|
25
52
|
* @param text - The raw prompt string.
|
|
@@ -104,5 +131,14 @@ export class PromptManager {
|
|
|
104
131
|
getPomBuilder() {
|
|
105
132
|
return this.pom;
|
|
106
133
|
}
|
|
134
|
+
/**
|
|
135
|
+
* Returns the raw prompt text whatever `setPromptText` stored, or null
|
|
136
|
+
* when no raw prompt has been set. Mirrors Python's
|
|
137
|
+
* `PromptManager.get_raw_prompt`.
|
|
138
|
+
* @returns The raw prompt string, or null if not set.
|
|
139
|
+
*/
|
|
140
|
+
getRawPrompt() {
|
|
141
|
+
return this.rawText;
|
|
142
|
+
}
|
|
107
143
|
}
|
|
108
144
|
//# sourceMappingURL=PromptManager.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"PromptManager.js","sourceRoot":"","sources":["../src/PromptManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"PromptManager.js","sourceRoot":"","sources":["../src/PromptManager.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PublicFetch - fetch a user-supplied URL without reaching private or
|
|
3
|
+
* internal addresses.
|
|
4
|
+
*
|
|
5
|
+
* Checking a URL before fetching it isn't enough on its own. The server can
|
|
6
|
+
* redirect to an internal address, such as a cloud metadata service, and the
|
|
7
|
+
* hostname can resolve to a different address when the connection is made
|
|
8
|
+
* (DNS rebinding). {@link _publicFetch} follows redirects itself and checks
|
|
9
|
+
* every hop, and connects through a DNS lookup that refuses private and
|
|
10
|
+
* internal addresses, so the address it connects to is the one it checked.
|
|
11
|
+
*
|
|
12
|
+
* It connects directly, ignoring any environment proxy, because through a
|
|
13
|
+
* proxy the connection check can't apply. With `SWML_URL_FETCH_USE_PROXY` set,
|
|
14
|
+
* a request that Node's global `fetch` would send through a proxy (Node's
|
|
15
|
+
* proxy support on, a proxy set for the scheme, the host not in `NO_PROXY`)
|
|
16
|
+
* goes through it instead; use a proxy that restricts destinations itself.
|
|
17
|
+
* Every other request still connects directly through the guarded lookup.
|
|
18
|
+
* `SWML_ALLOW_PRIVATE_URLS` turns the address checks off.
|
|
19
|
+
*
|
|
20
|
+
* The `insecureTls` option skips TLS certificate verification (for a trusted
|
|
21
|
+
* gateway with a self-signed certificate) and nothing else: every hop is still
|
|
22
|
+
* checked and every connection still goes through the guarded lookup.
|
|
23
|
+
*
|
|
24
|
+
* Internal to the SDK: the skills that fetch URLs a caller or the model
|
|
25
|
+
* supplied (spider, web_search, mcp_gateway) use it. Mirrors signalwire-python's
|
|
26
|
+
* `_PublicSession` (signalwire/utils/url_validator.py).
|
|
27
|
+
*/
|
|
28
|
+
/** Options for {@link _publicFetch}. */
|
|
29
|
+
export interface _PublicFetchInit {
|
|
30
|
+
/** HTTP method (default `GET`). */
|
|
31
|
+
method?: string;
|
|
32
|
+
/** Request headers. */
|
|
33
|
+
headers?: Record<string, string>;
|
|
34
|
+
/** Request body, for methods that send one. */
|
|
35
|
+
body?: string;
|
|
36
|
+
/** Aborts the request, including any redirect in progress. */
|
|
37
|
+
signal?: AbortSignal;
|
|
38
|
+
/** Skip the address checks, as `SWML_ALLOW_PRIVATE_URLS` does. */
|
|
39
|
+
allowPrivate?: boolean;
|
|
40
|
+
/**
|
|
41
|
+
* Called with each redirect's target before it's requested; returning false
|
|
42
|
+
* stops the fetch with a {@link _RedirectRefused} error. The address checks
|
|
43
|
+
* still apply to a target it allows.
|
|
44
|
+
*/
|
|
45
|
+
allowRedirect?: (target: string) => boolean | Promise<boolean>;
|
|
46
|
+
/**
|
|
47
|
+
* Accept any TLS certificate (no verification) on every hop. The address
|
|
48
|
+
* checks still apply. Such a request always connects directly, through the
|
|
49
|
+
* guarded lookup, even with `SWML_URL_FETCH_USE_PROXY` set, since the proxy
|
|
50
|
+
* transport can't skip verification. Default `false`.
|
|
51
|
+
*/
|
|
52
|
+
insecureTls?: boolean;
|
|
53
|
+
/**
|
|
54
|
+
* How redirects are followed. `browser` (the default) follows 301, 302,
|
|
55
|
+
* 303, 307 and 308, up to 10 of them, and turns a 303, or a 301 or 302
|
|
56
|
+
* answering a POST, into a GET without a body. `curl` follows them as
|
|
57
|
+
* libcurl does with `CURLOPT_FOLLOWLOCATION`, `CURLOPT_MAXREDIRS` 15 and
|
|
58
|
+
* `CURLOPT_POSTREDIR` `CURL_REDIR_POST_ALL`, the settings the platform
|
|
59
|
+
* requests a DataMap webhook with: any 3xx with a `Location`, up to 15 of
|
|
60
|
+
* them, a POST sent again with its body after any of them, and only a 303
|
|
61
|
+
* answering a method other than GET, HEAD or POST turned into a GET. Both
|
|
62
|
+
* modes check every hop's address and drop credentials on a change of
|
|
63
|
+
* origin.
|
|
64
|
+
*/
|
|
65
|
+
redirectMode?: 'browser' | 'curl';
|
|
66
|
+
/**
|
|
67
|
+
* Called with each response's status as it arrives, redirects included,
|
|
68
|
+
* so a caller can report the last status received when a later hop fails,
|
|
69
|
+
* as curl's `CURLINFO_RESPONSE_CODE` does.
|
|
70
|
+
*/
|
|
71
|
+
onStatus?: (status: number) => void;
|
|
72
|
+
}
|
|
73
|
+
/** Thrown by {@link _publicFetch} when `allowRedirect` refuses a redirect. */
|
|
74
|
+
export declare class _RedirectRefused extends Error {
|
|
75
|
+
/** The redirect target that was refused. */
|
|
76
|
+
readonly target: string;
|
|
77
|
+
/** @param target - The redirect target that was refused. */
|
|
78
|
+
constructor(target: string);
|
|
79
|
+
}
|
|
80
|
+
/** Sends one request without following redirects. Tests replace it. */
|
|
81
|
+
export type _PublicFetchTransport = (url: string, init: {
|
|
82
|
+
method: string;
|
|
83
|
+
headers: Record<string, string>;
|
|
84
|
+
body?: string;
|
|
85
|
+
signal?: AbortSignal;
|
|
86
|
+
/** Skip TLS certificate verification (the address checks still apply). */
|
|
87
|
+
insecureTls?: boolean;
|
|
88
|
+
}, guard: boolean) => Promise<Response>;
|
|
89
|
+
/**
|
|
90
|
+
* Send one request with node:http(s). With `guard`, the connection resolves
|
|
91
|
+
* the hostname through {@link guardedLookup}, so a hostname that resolves to a
|
|
92
|
+
* private address at connect time is refused even if it resolved to a public
|
|
93
|
+
* one when the URL was checked. An IP-literal host skips DNS; {@link
|
|
94
|
+
* _publicFetch} has already checked it. With `init.insecureTls`, an HTTPS
|
|
95
|
+
* connection accepts any certificate; the lookup is guarded all the same.
|
|
96
|
+
*/
|
|
97
|
+
export declare const _nodeTransport: _PublicFetchTransport;
|
|
98
|
+
/**
|
|
99
|
+
* Replace the transport {@link _publicFetch} sends each request with, or
|
|
100
|
+
* restore the default with `null`. For tests only.
|
|
101
|
+
*/
|
|
102
|
+
export declare function _setPublicFetchTransport(transport: _PublicFetchTransport | null): void;
|
|
103
|
+
/**
|
|
104
|
+
* Whether Node's global fetch would send a request for `url` through an
|
|
105
|
+
* environment proxy: Node's proxy support is on (`NODE_USE_ENV_PROXY` or
|
|
106
|
+
* `--use-env-proxy`), a proxy is set for the URL's scheme, and `NO_PROXY`
|
|
107
|
+
* doesn't exclude the host. When it wouldn't, the connection is direct and
|
|
108
|
+
* must go through the guarded transport. `NO_PROXY` is matched loosely (any
|
|
109
|
+
* entry that could cover the host counts), which errs toward the guard.
|
|
110
|
+
*/
|
|
111
|
+
export declare function _proxiedByNode(url: string): boolean;
|
|
112
|
+
/**
|
|
113
|
+
* Fetch a user-supplied URL, refusing private and internal addresses.
|
|
114
|
+
*
|
|
115
|
+
* Checks the URL, then each redirect's target, before requesting it (up to
|
|
116
|
+
* {@link MAX_REDIRECTS} redirects), and connects through a lookup that refuses
|
|
117
|
+
* a private or internal address. A redirect to another origin drops the
|
|
118
|
+
* `Authorization`, `Cookie` and `Proxy-Authorization` headers. A 303, or a
|
|
119
|
+
* 301/302 answering a POST, is followed with a GET, as browsers do. With
|
|
120
|
+
* `redirectMode: 'curl'`, redirects follow curl's rules instead (see
|
|
121
|
+
* {@link _PublicFetchInit.redirectMode}); the checks are the same.
|
|
122
|
+
*
|
|
123
|
+
* @param url - The URL to fetch.
|
|
124
|
+
* @param init - Method, headers, body, abort signal, `allowPrivate`,
|
|
125
|
+
* `allowRedirect`, `insecureTls`, `redirectMode` and `onStatus`.
|
|
126
|
+
* @returns The final response, which is not a redirect unless it had no
|
|
127
|
+
* `Location` header.
|
|
128
|
+
* @throws If the URL or a redirect is refused ({@link _RedirectRefused} when
|
|
129
|
+
* `allowRedirect` refuses it), there are too many redirects, or the
|
|
130
|
+
* request fails.
|
|
131
|
+
*/
|
|
132
|
+
export declare function _publicFetch(url: string, init?: _PublicFetchInit): Promise<Response>;
|