@signalwire/sdk 2.0.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/.github/workflows/publish.yml +27 -0
- package/.github/workflows/test.yml +17 -0
- package/CLAUDE.md +112 -0
- package/README.md +254 -0
- package/docs/MIGRATION-2.0.md +81 -0
- package/docs/agent-guide.md +869 -0
- package/docs/agent_guide.md +1026 -0
- package/docs/api-reference.md +2420 -0
- package/docs/api_reference.md +1301 -0
- package/docs/architecture.md +843 -0
- package/docs/cli-guide.md +579 -0
- package/docs/cli_guide.md +448 -0
- package/docs/cloud_functions_guide.md +474 -0
- package/docs/configuration.md +422 -0
- package/docs/contexts-guide.md +787 -0
- package/docs/contexts_guide.md +511 -0
- package/docs/datamap-guide.md +1141 -0
- package/docs/datamap_guide.md +595 -0
- package/docs/llm_parameters.md +239 -0
- package/docs/mcp_gateway_reference.md +648 -0
- package/docs/mcp_integration.md +108 -0
- package/docs/prefabs-guide.md +800 -0
- package/docs/sdk_features.md +477 -0
- package/docs/security.md +436 -0
- package/docs/serverless-guide.md +513 -0
- package/docs/skills-guide.md +857 -0
- package/docs/skills-system.md +301 -0
- package/docs/skills_parameter_schema.md +392 -0
- package/docs/skills_system.md +467 -0
- package/docs/swaig-reference.md +1627 -0
- package/docs/swaig_reference.md +910 -0
- package/docs/swml_service_guide.md +600 -0
- package/docs/third_party_skills.md +533 -0
- package/docs/web_service.md +677 -0
- package/examples/README.md +131 -0
- package/examples/advanced-datamap.ts +100 -0
- package/examples/advanced-dynamic-config.ts +70 -0
- package/examples/auto-vivified.ts +94 -0
- package/examples/call-flow.ts +63 -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 +55 -0
- package/examples/datasphere-multi-instance.ts +63 -0
- package/examples/datasphere-serverless-env.ts +68 -0
- package/examples/datasphere-webhook-env.ts +66 -0
- package/examples/datasphere.ts +37 -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 +71 -0
- package/examples/gather-per-question-functions-demo.ts +140 -0
- package/examples/joke-agent.ts +34 -0
- package/examples/kubernetes-agent.ts +45 -0
- package/examples/llm-params.ts +69 -0
- package/examples/mcp-agent.ts +84 -0
- package/examples/mcp-gateway.ts +35 -0
- package/examples/multi-agent.ts +73 -0
- package/examples/multi-endpoint.ts +79 -0
- package/examples/pom-prompt.ts +71 -0
- package/examples/prefab-concierge.ts +47 -0
- package/examples/prefab-faq.ts +54 -0
- package/examples/prefab-info-gatherer.ts +33 -0
- package/examples/prefab-receptionist.ts +36 -0
- package/examples/prefab-survey.ts +68 -0
- package/examples/record-call.ts +67 -0
- package/examples/relay-demo.ts +33 -0
- package/examples/room-and-sip.ts +94 -0
- package/examples/serverless-lambda.ts +35 -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 +38 -0
- package/examples/step-function-inheritance-demo.ts +124 -0
- package/examples/swaig-features.ts +187 -0
- package/examples/swml-service-routing.ts +66 -0
- package/examples/swml-service.ts +38 -0
- package/examples/tap.ts +68 -0
- package/examples/verb-methods.ts +45 -0
- package/examples/web-search-multi-instance.ts +72 -0
- package/examples/web-search.ts +38 -0
- package/examples/wikipedia.ts +36 -0
- package/livewire/README.md +140 -0
- package/livewire/docs/migration-guide.md +228 -0
- package/livewire/examples/livewire-basic-agent.ts +74 -0
- package/livewire/examples/livewire-handoff.ts +197 -0
- package/livewire/examples/livewire-multi-tool.ts +117 -0
- package/package.json +38 -0
- package/relay/README.md +70 -0
- package/relay/RELAY_IMPLEMENTATION_GUIDE.md +1257 -0
- package/relay/docs/call-methods.md +474 -0
- package/relay/docs/client-reference.md +142 -0
- package/relay/docs/events.md +134 -0
- package/relay/docs/getting-started.md +134 -0
- package/relay/docs/guide.md +306 -0
- package/relay/docs/messaging.md +182 -0
- package/relay/examples/relay-inbound.ts +66 -0
- package/relay/examples/relay-messaging.ts +71 -0
- package/relay/examples/relay-outbound.ts +76 -0
- package/rest/README.md +95 -0
- package/rest/docs/calling.md +273 -0
- package/rest/docs/client-reference.md +107 -0
- package/rest/docs/compat.md +204 -0
- package/rest/docs/fabric.md +183 -0
- package/rest/docs/getting-started.md +110 -0
- package/rest/docs/guide.md +351 -0
- package/rest/docs/namespaces.md +285 -0
- package/rest/examples/rest-10dlc-registration.ts +161 -0
- package/rest/examples/rest-calling-ivr-and-ai.ts +102 -0
- package/rest/examples/rest-calling-play-and-record.ts +91 -0
- package/rest/examples/rest-client.ts +65 -0
- package/rest/examples/rest-compat-laml.ts +210 -0
- package/rest/examples/rest-datasphere-search.ts +82 -0
- package/rest/examples/rest-fabric-conferences-and-routing.ts +144 -0
- package/rest/examples/rest-fabric-subscribers-and-sip.ts +108 -0
- package/rest/examples/rest-fabric-swml-and-callflows.ts +99 -0
- package/rest/examples/rest-manage-resources.ts +65 -0
- package/rest/examples/rest-phone-number-management.ts +197 -0
- package/rest/examples/rest-queues-mfa-and-recordings.ts +143 -0
- package/rest/examples/rest-video-rooms.ts +186 -0
- package/src/AgentBase.ts +2489 -0
- package/src/AgentServer.ts +415 -0
- package/src/AuthHandler.ts +256 -0
- package/src/ConfigLoader.ts +447 -0
- package/src/ContextBuilder.ts +1150 -0
- package/src/DataMap.ts +449 -0
- package/src/FunctionResult.ts +866 -0
- package/src/Logger.ts +337 -0
- package/src/PomBuilder.ts +439 -0
- package/src/PromptManager.ts +133 -0
- package/src/SWMLHandler.ts +298 -0
- package/src/SWMLService.ts +717 -0
- package/src/SchemaUtils.ts +361 -0
- package/src/SecurityUtils.ts +153 -0
- package/src/ServerlessAdapter.ts +221 -0
- package/src/SessionManager.ts +311 -0
- package/src/SslConfig.ts +118 -0
- package/src/SwaigFunction.ts +276 -0
- package/src/SwmlBuilder.ts +258 -0
- package/src/SwmlVerbMethods.generated.ts +234 -0
- package/src/TypeInference.ts +181 -0
- package/src/WebService.ts +619 -0
- package/src/cli/agent-loader.ts +166 -0
- package/src/cli/mock-data.ts +111 -0
- package/src/cli/swaig-test.ts +452 -0
- package/src/generateVerbTypes.ts +322 -0
- package/src/index.ts +167 -0
- package/src/livewire/index.ts +950 -0
- package/src/prefabs/ConciergeAgent.ts +287 -0
- package/src/prefabs/FAQBotAgent.ts +384 -0
- package/src/prefabs/InfoGathererAgent.ts +339 -0
- package/src/prefabs/ReceptionistAgent.ts +366 -0
- package/src/prefabs/SurveyAgent.ts +646 -0
- package/src/prefabs/index.ts +27 -0
- package/src/relay/Action.ts +314 -0
- package/src/relay/Call.ts +854 -0
- package/src/relay/Deferred.ts +71 -0
- package/src/relay/Message.ts +148 -0
- package/src/relay/RelayClient.ts +1036 -0
- package/src/relay/RelayError.ts +14 -0
- package/src/relay/RelayEvent.ts +892 -0
- package/src/relay/constants.ts +132 -0
- package/src/relay/index.ts +123 -0
- package/src/relay/types.ts +149 -0
- package/src/rest/HttpClient.ts +103 -0
- package/src/rest/RestError.ts +31 -0
- package/src/rest/base/BaseResource.ts +19 -0
- package/src/rest/base/CrudResource.ts +51 -0
- package/src/rest/base/CrudWithAddresses.ts +26 -0
- package/src/rest/index.ts +200 -0
- package/src/rest/namespaces/addresses.ts +32 -0
- package/src/rest/namespaces/calling.ts +187 -0
- package/src/rest/namespaces/chat.ts +20 -0
- package/src/rest/namespaces/compat.ts +352 -0
- package/src/rest/namespaces/datasphere.ts +45 -0
- package/src/rest/namespaces/fabric.ts +222 -0
- package/src/rest/namespaces/imported-numbers.ts +20 -0
- package/src/rest/namespaces/logs.ts +84 -0
- package/src/rest/namespaces/lookup.ts +21 -0
- package/src/rest/namespaces/mfa.ts +30 -0
- package/src/rest/namespaces/number-groups.ts +38 -0
- package/src/rest/namespaces/phone-numbers.ts +44 -0
- package/src/rest/namespaces/project.ts +36 -0
- package/src/rest/namespaces/pubsub.ts +20 -0
- package/src/rest/namespaces/queues.ts +33 -0
- package/src/rest/namespaces/recordings.ts +28 -0
- package/src/rest/namespaces/registry.ts +101 -0
- package/src/rest/namespaces/short-codes.ts +28 -0
- package/src/rest/namespaces/sip-profile.ts +25 -0
- package/src/rest/namespaces/verified-callers.ts +27 -0
- package/src/rest/namespaces/video.ts +165 -0
- package/src/rest/pagination.ts +84 -0
- package/src/rest/types.ts +61 -0
- package/src/schema.json +12250 -0
- package/src/skills/SkillBase.ts +547 -0
- package/src/skills/SkillManager.ts +415 -0
- package/src/skills/SkillRegistry.ts +367 -0
- package/src/skills/builtin/api_ninjas_trivia.ts +280 -0
- package/src/skills/builtin/ask_claude.ts +241 -0
- package/src/skills/builtin/claude_skills.ts +978 -0
- package/src/skills/builtin/custom_skills.ts +312 -0
- package/src/skills/builtin/datasphere.ts +438 -0
- package/src/skills/builtin/datasphere_serverless.ts +339 -0
- package/src/skills/builtin/datetime.ts +130 -0
- package/src/skills/builtin/google_maps.ts +651 -0
- package/src/skills/builtin/index.ts +88 -0
- package/src/skills/builtin/info_gatherer.ts +405 -0
- package/src/skills/builtin/joke.ts +191 -0
- package/src/skills/builtin/math.ts +142 -0
- package/src/skills/builtin/mcp_gateway.ts +677 -0
- package/src/skills/builtin/native_vector_search.ts +901 -0
- package/src/skills/builtin/play_background_file.ts +358 -0
- package/src/skills/builtin/spider.ts +869 -0
- package/src/skills/builtin/swml_transfer.ts +635 -0
- package/src/skills/builtin/weather_api.ts +248 -0
- package/src/skills/builtin/web_search.ts +1074 -0
- package/src/skills/builtin/wikipedia_search.ts +299 -0
- package/src/skills/index.ts +12 -0
- package/src/types.ts +132 -0
- package/tests/AgentBase.test.ts +1093 -0
- package/tests/AgentServer.test.ts +126 -0
- package/tests/AuthHandler.test.ts +133 -0
- package/tests/ConfigLoader.test.ts +151 -0
- package/tests/ContextBuilder.test.ts +108 -0
- package/tests/DataMap.test.ts +367 -0
- package/tests/EphemeralSkillCopy.test.ts +107 -0
- package/tests/FunctionResult.test.ts +298 -0
- package/tests/GracefulShutdown.test.ts +46 -0
- package/tests/Logger.test.ts +420 -0
- package/tests/PomBuilder.test.ts +228 -0
- package/tests/ProxyDetection.test.ts +228 -0
- package/tests/SWMLService.test.ts +320 -0
- package/tests/SWMLVerbHandler.test.ts +523 -0
- package/tests/SchemaUtils.test.ts +106 -0
- package/tests/SchemaUtils.verb.test.ts +206 -0
- package/tests/SecurityUtils.test.ts +192 -0
- package/tests/ServerlessAdapter.test.ts +222 -0
- package/tests/SessionManager.test.ts +257 -0
- package/tests/SkillBaseFeatures.test.ts +130 -0
- package/tests/SkillMultiInstance.test.ts +102 -0
- package/tests/SkillParameterSchemas.test.ts +134 -0
- package/tests/SkillRegistrySchema.test.ts +84 -0
- package/tests/SslConfig.test.ts +97 -0
- package/tests/SwmlBuilder.test.ts +400 -0
- package/tests/TypeInference.test.ts +165 -0
- package/tests/VerbHandlerRegistry.test.ts +128 -0
- package/tests/cli/mock-data.test.ts +113 -0
- package/tests/cli/swaig-test.test.ts +108 -0
- package/tests/examples.test.ts +194 -0
- package/tests/fixtures/scrape-parity/README.md +53 -0
- package/tests/fixtures/scrape-parity/expected/01_simple_article.json +5 -0
- package/tests/fixtures/scrape-parity/expected/02_class_based_noise.json +5 -0
- package/tests/fixtures/scrape-parity/expected/03_nested_containers.json +5 -0
- package/tests/fixtures/scrape-parity/expected/04_bare_body.json +5 -0
- package/tests/fixtures/scrape-parity/expected/05_malformed.json +5 -0
- package/tests/fixtures/scrape-parity/expected/06_multi_class.json +5 -0
- package/tests/fixtures/scrape-parity/expected/07_anchor_pattern.json +5 -0
- package/tests/fixtures/scrape-parity/expected/08_inline_script.json +5 -0
- package/tests/fixtures/scrape-parity/expected/09_whitespace_nbsp.json +5 -0
- package/tests/fixtures/scrape-parity/expected/10_entity_unicode.json +5 -0
- package/tests/fixtures/scrape-parity/expected/11_cdata_comments.json +5 -0
- package/tests/fixtures/scrape-parity/expected/12_deep_nested_removals.json +5 -0
- package/tests/fixtures/scrape-parity/html/01_simple_article.html +18 -0
- package/tests/fixtures/scrape-parity/html/02_class_based_noise.html +18 -0
- package/tests/fixtures/scrape-parity/html/03_nested_containers.html +13 -0
- package/tests/fixtures/scrape-parity/html/04_bare_body.html +9 -0
- package/tests/fixtures/scrape-parity/html/05_malformed.html +11 -0
- package/tests/fixtures/scrape-parity/html/06_multi_class.html +18 -0
- package/tests/fixtures/scrape-parity/html/07_anchor_pattern.html +12 -0
- package/tests/fixtures/scrape-parity/html/08_inline_script.html +17 -0
- package/tests/fixtures/scrape-parity/html/09_whitespace_nbsp.html +21 -0
- package/tests/fixtures/scrape-parity/html/10_entity_unicode.html +10 -0
- package/tests/fixtures/scrape-parity/html/11_cdata_comments.html +13 -0
- package/tests/fixtures/scrape-parity/html/12_deep_nested_removals.html +24 -0
- package/tests/fixtures/scrape-parity/python_extract.py +109 -0
- package/tests/livewire/livewire.test.ts +780 -0
- package/tests/mcp.test.ts +221 -0
- package/tests/prefabs/prefabs.test.ts +1093 -0
- package/tests/relay/Action.test.ts +392 -0
- package/tests/relay/Call.test.ts +535 -0
- package/tests/relay/Deferred.test.ts +71 -0
- package/tests/relay/Message.test.ts +164 -0
- package/tests/relay/RelayClient.test.ts +779 -0
- package/tests/relay/RelayEvent.test.ts +463 -0
- package/tests/relay/helpers.ts +79 -0
- package/tests/rest/HttpClient.test.ts +274 -0
- package/tests/rest/RestError.test.ts +53 -0
- package/tests/rest/calling.test.ts +156 -0
- package/tests/rest/client.test.ts +197 -0
- package/tests/rest/compat.test.ts +335 -0
- package/tests/rest/datasphere.test.ts +71 -0
- package/tests/rest/fabric.test.ts +186 -0
- package/tests/rest/helpers.ts +95 -0
- package/tests/rest/logs.test.ts +68 -0
- package/tests/rest/pagination.test.ts +133 -0
- package/tests/rest/registry.test.ts +94 -0
- package/tests/rest/relay-rest.test.ts +290 -0
- package/tests/rest/video.test.ts +173 -0
- package/tests/setup.ts +6 -0
- package/tests/skills/SkillBase.test.ts +108 -0
- package/tests/skills/SkillManager.test.ts +268 -0
- package/tests/skills/SkillRegistry.test.ts +176 -0
- package/tests/skills/builtin.test.ts +1472 -0
- package/tests/skills/claude-skills.test.ts +54 -0
- package/tests/skills/custom-skills.test.ts +53 -0
- package/tests/skills/datasphere-serverless.test.ts +70 -0
- package/tests/skills/datasphere.test.ts +107 -0
- package/tests/skills/datetime.test.ts +101 -0
- package/tests/skills/google-maps.test.ts +78 -0
- package/tests/skills/info-gatherer.test.ts +411 -0
- package/tests/skills/joke.test.ts +81 -0
- package/tests/skills/math.test.ts +68 -0
- package/tests/skills/mcp-gateway.test.ts +101 -0
- package/tests/skills/play-background.test.ts +54 -0
- package/tests/skills/spider.test.ts +108 -0
- package/tests/skills/swml-transfer.test.ts +178 -0
- package/tests/skills/trivia.test.ts +54 -0
- package/tests/skills/vector-search.test.ts +135 -0
- package/tests/skills/weather-api.test.ts +77 -0
- package/tests/skills/web-search-parity.test.ts +59 -0
- package/tests/skills/web-search.test.ts +103 -0
- package/tests/skills/wikipedia.test.ts +63 -0
- package/tsconfig.json +18 -0
- package/vitest.config.ts +9 -0
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import { parseFunctionParams, inferSchema, createTypedHandlerWrapper } from '../src/TypeInference.js';
|
|
3
|
+
import { FunctionResult } from '../src/FunctionResult.js';
|
|
4
|
+
|
|
5
|
+
describe('parseFunctionParams', () => {
|
|
6
|
+
it('parses arrow function with defaults', () => {
|
|
7
|
+
const fn = (city: string, count = 5) => { return city + count; };
|
|
8
|
+
const params = parseFunctionParams(fn.toString());
|
|
9
|
+
expect(params.length).toBe(2);
|
|
10
|
+
expect(params[0].name).toBe('city');
|
|
11
|
+
expect(params[0].defaultValue).toBeUndefined();
|
|
12
|
+
expect(params[1].name).toBe('count');
|
|
13
|
+
expect(params[1].defaultValue).toBe('5');
|
|
14
|
+
});
|
|
15
|
+
|
|
16
|
+
it('parses regular function', () => {
|
|
17
|
+
function myFunc(city: string, count: number) { return city + count; }
|
|
18
|
+
const params = parseFunctionParams(myFunc.toString());
|
|
19
|
+
expect(params.length).toBe(2);
|
|
20
|
+
expect(params[0].name).toBe('city');
|
|
21
|
+
expect(params[1].name).toBe('count');
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
it('parses function with no params', () => {
|
|
25
|
+
const fn = () => 'hello';
|
|
26
|
+
const params = parseFunctionParams(fn.toString());
|
|
27
|
+
expect(params.length).toBe(0);
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
it('parses function with string default', () => {
|
|
31
|
+
const fn = (name = 'world') => name;
|
|
32
|
+
const params = parseFunctionParams(fn.toString());
|
|
33
|
+
expect(params.length).toBe(1);
|
|
34
|
+
expect(params[0].name).toBe('name');
|
|
35
|
+
// JS runtime may use single or double quotes in Function.toString()
|
|
36
|
+
expect(params[0].defaultValue).toMatch(/^['"]world['"]$/);
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
it('parses function with boolean default', () => {
|
|
40
|
+
const fn = (verbose = true) => verbose;
|
|
41
|
+
const params = parseFunctionParams(fn.toString());
|
|
42
|
+
expect(params.length).toBe(1);
|
|
43
|
+
expect(params[0].name).toBe('verbose');
|
|
44
|
+
expect(params[0].defaultValue).toBe('true');
|
|
45
|
+
});
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
describe('inferSchema', () => {
|
|
49
|
+
it('infers schema from arrow function with defaults', () => {
|
|
50
|
+
const fn = (city: string, count = 5, verbose = true) => {};
|
|
51
|
+
const schema = inferSchema(fn);
|
|
52
|
+
expect(schema).not.toBeNull();
|
|
53
|
+
expect(schema!.paramNames).toEqual(['city', 'count', 'verbose']);
|
|
54
|
+
expect(schema!.parameters['city'].type).toBe('string');
|
|
55
|
+
expect(schema!.parameters['count'].type).toBe('integer');
|
|
56
|
+
expect(schema!.parameters['verbose'].type).toBe('boolean');
|
|
57
|
+
expect(schema!.required).toEqual(['city']);
|
|
58
|
+
});
|
|
59
|
+
|
|
60
|
+
it('returns null for old-style (args, rawData) handler', () => {
|
|
61
|
+
const fn = (args: Record<string, unknown>, rawData: Record<string, unknown>) => {};
|
|
62
|
+
const schema = inferSchema(fn);
|
|
63
|
+
expect(schema).toBeNull();
|
|
64
|
+
});
|
|
65
|
+
|
|
66
|
+
it('returns null for old-style (args) handler', () => {
|
|
67
|
+
const fn = (args: Record<string, unknown>) => {};
|
|
68
|
+
const schema = inferSchema(fn);
|
|
69
|
+
expect(schema).toBeNull();
|
|
70
|
+
});
|
|
71
|
+
|
|
72
|
+
it('detects rawData parameter and excludes from schema', () => {
|
|
73
|
+
const fn = (city: string, count = 5, rawData: Record<string, unknown>) => {};
|
|
74
|
+
const schema = inferSchema(fn);
|
|
75
|
+
expect(schema).not.toBeNull();
|
|
76
|
+
expect(schema!.hasRawData).toBe(true);
|
|
77
|
+
expect(schema!.paramNames).toEqual(['city', 'count']);
|
|
78
|
+
expect(schema!.parameters['rawData']).toBeUndefined();
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
it('no rawData when last param is not rawData', () => {
|
|
82
|
+
const fn = (city: string, count = 5) => {};
|
|
83
|
+
const schema = inferSchema(fn);
|
|
84
|
+
expect(schema).not.toBeNull();
|
|
85
|
+
expect(schema!.hasRawData).toBe(false);
|
|
86
|
+
expect(schema!.paramNames).toEqual(['city', 'count']);
|
|
87
|
+
});
|
|
88
|
+
|
|
89
|
+
it('returns empty schema for no-param function', () => {
|
|
90
|
+
const fn = () => {};
|
|
91
|
+
const schema = inferSchema(fn);
|
|
92
|
+
expect(schema).not.toBeNull();
|
|
93
|
+
expect(schema!.paramNames).toEqual([]);
|
|
94
|
+
expect(schema!.required).toEqual([]);
|
|
95
|
+
});
|
|
96
|
+
|
|
97
|
+
it('infers string type from string default', () => {
|
|
98
|
+
const fn = (greeting = 'hello') => greeting;
|
|
99
|
+
const schema = inferSchema(fn);
|
|
100
|
+
expect(schema).not.toBeNull();
|
|
101
|
+
expect(schema!.parameters['greeting'].type).toBe('string');
|
|
102
|
+
expect(schema!.required).toEqual([]);
|
|
103
|
+
});
|
|
104
|
+
|
|
105
|
+
it('infers number type from float default', () => {
|
|
106
|
+
const fn = (temp = 98.6) => temp;
|
|
107
|
+
const schema = inferSchema(fn);
|
|
108
|
+
expect(schema).not.toBeNull();
|
|
109
|
+
expect(schema!.parameters['temp'].type).toBe('number');
|
|
110
|
+
});
|
|
111
|
+
|
|
112
|
+
it('params without defaults are required', () => {
|
|
113
|
+
const fn = (city: string, state: string) => {};
|
|
114
|
+
const schema = inferSchema(fn);
|
|
115
|
+
expect(schema).not.toBeNull();
|
|
116
|
+
expect(schema!.required).toEqual(['city', 'state']);
|
|
117
|
+
});
|
|
118
|
+
});
|
|
119
|
+
|
|
120
|
+
describe('createTypedHandlerWrapper', () => {
|
|
121
|
+
it('unpacks args dict into positional params', () => {
|
|
122
|
+
const captured: unknown[] = [];
|
|
123
|
+
const fn = (city: string, count: number) => {
|
|
124
|
+
captured.push(city, count);
|
|
125
|
+
return new FunctionResult('ok');
|
|
126
|
+
};
|
|
127
|
+
const wrapper = createTypedHandlerWrapper(fn, ['city', 'count'], false);
|
|
128
|
+
wrapper({ city: 'NYC', count: 3 }, {});
|
|
129
|
+
expect(captured).toEqual(['NYC', 3]);
|
|
130
|
+
});
|
|
131
|
+
|
|
132
|
+
it('passes rawData when hasRawData is true', () => {
|
|
133
|
+
const captured: unknown[] = [];
|
|
134
|
+
const fn = (city: string, rawData: Record<string, unknown>) => {
|
|
135
|
+
captured.push(city, rawData);
|
|
136
|
+
return new FunctionResult('ok');
|
|
137
|
+
};
|
|
138
|
+
const wrapper = createTypedHandlerWrapper(fn, ['city'], true);
|
|
139
|
+
const rawData = { call_id: '123' };
|
|
140
|
+
wrapper({ city: 'LA' }, rawData);
|
|
141
|
+
expect(captured).toEqual(['LA', rawData]);
|
|
142
|
+
});
|
|
143
|
+
|
|
144
|
+
it('missing args default to undefined', () => {
|
|
145
|
+
const captured: unknown[] = [];
|
|
146
|
+
const fn = (city: string, count: number) => {
|
|
147
|
+
captured.push(city, count);
|
|
148
|
+
return new FunctionResult('ok');
|
|
149
|
+
};
|
|
150
|
+
const wrapper = createTypedHandlerWrapper(fn, ['city', 'count'], false);
|
|
151
|
+
wrapper({ city: 'SF' }, {});
|
|
152
|
+
expect(captured).toEqual(['SF', undefined]);
|
|
153
|
+
});
|
|
154
|
+
|
|
155
|
+
it('does not pass rawData when hasRawData is false', () => {
|
|
156
|
+
const captured: unknown[] = [];
|
|
157
|
+
const fn = (...allArgs: unknown[]) => {
|
|
158
|
+
captured.push(...allArgs);
|
|
159
|
+
return new FunctionResult('ok');
|
|
160
|
+
};
|
|
161
|
+
const wrapper = createTypedHandlerWrapper(fn, ['city'], false);
|
|
162
|
+
wrapper({ city: 'Boston' }, { call_id: 'abc' });
|
|
163
|
+
expect(captured).toEqual(['Boston']);
|
|
164
|
+
});
|
|
165
|
+
});
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { describe, it, expect, beforeEach } from 'vitest';
|
|
2
|
+
import { VerbHandlerRegistry, SWMLVerbHandler, AIVerbHandler } from '../src/SWMLHandler.js';
|
|
3
|
+
|
|
4
|
+
/** Minimal custom handler for testing registry operations. */
|
|
5
|
+
class CustomVerbHandler extends SWMLVerbHandler {
|
|
6
|
+
private name: string;
|
|
7
|
+
|
|
8
|
+
constructor(name: string) {
|
|
9
|
+
super();
|
|
10
|
+
this.name = name;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
getVerbName(): string {
|
|
14
|
+
return this.name;
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
validateConfig(config: Record<string, unknown>): [boolean, string[]] {
|
|
18
|
+
return [true, []];
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
buildConfig(opts: Record<string, unknown>): Record<string, unknown> {
|
|
22
|
+
return opts;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
describe('VerbHandlerRegistry', () => {
|
|
27
|
+
let registry: VerbHandlerRegistry;
|
|
28
|
+
|
|
29
|
+
beforeEach(() => {
|
|
30
|
+
registry = new VerbHandlerRegistry();
|
|
31
|
+
});
|
|
32
|
+
|
|
33
|
+
describe('default registration', () => {
|
|
34
|
+
it('registers AIVerbHandler on construction', () => {
|
|
35
|
+
expect(registry.hasHandler('ai')).toBe(true);
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
it('returns an AIVerbHandler instance for "ai"', () => {
|
|
39
|
+
const handler = registry.getHandler('ai');
|
|
40
|
+
expect(handler).toBeDefined();
|
|
41
|
+
expect(handler).toBeInstanceOf(AIVerbHandler);
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
it('reports the correct verb name from default handler', () => {
|
|
45
|
+
const handler = registry.getHandler('ai');
|
|
46
|
+
expect(handler!.getVerbName()).toBe('ai');
|
|
47
|
+
});
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
describe('registerHandler', () => {
|
|
51
|
+
it('registers a custom handler', () => {
|
|
52
|
+
const custom = new CustomVerbHandler('play');
|
|
53
|
+
registry.registerHandler(custom);
|
|
54
|
+
|
|
55
|
+
expect(registry.hasHandler('play')).toBe(true);
|
|
56
|
+
expect(registry.getHandler('play')).toBe(custom);
|
|
57
|
+
});
|
|
58
|
+
|
|
59
|
+
it('replaces an existing handler for the same verb', () => {
|
|
60
|
+
const first = new CustomVerbHandler('ai');
|
|
61
|
+
const second = new CustomVerbHandler('ai');
|
|
62
|
+
|
|
63
|
+
registry.registerHandler(first);
|
|
64
|
+
expect(registry.getHandler('ai')).toBe(first);
|
|
65
|
+
|
|
66
|
+
registry.registerHandler(second);
|
|
67
|
+
expect(registry.getHandler('ai')).toBe(second);
|
|
68
|
+
});
|
|
69
|
+
|
|
70
|
+
it('supports multiple handlers for different verbs', () => {
|
|
71
|
+
const play = new CustomVerbHandler('play');
|
|
72
|
+
const record = new CustomVerbHandler('record');
|
|
73
|
+
|
|
74
|
+
registry.registerHandler(play);
|
|
75
|
+
registry.registerHandler(record);
|
|
76
|
+
|
|
77
|
+
expect(registry.hasHandler('play')).toBe(true);
|
|
78
|
+
expect(registry.hasHandler('record')).toBe(true);
|
|
79
|
+
expect(registry.getHandler('play')).toBe(play);
|
|
80
|
+
expect(registry.getHandler('record')).toBe(record);
|
|
81
|
+
});
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
describe('getHandler', () => {
|
|
85
|
+
it('returns undefined for an unregistered verb', () => {
|
|
86
|
+
expect(registry.getHandler('nonexistent')).toBeUndefined();
|
|
87
|
+
});
|
|
88
|
+
|
|
89
|
+
it('returns the registered handler', () => {
|
|
90
|
+
const handler = new CustomVerbHandler('tap');
|
|
91
|
+
registry.registerHandler(handler);
|
|
92
|
+
expect(registry.getHandler('tap')).toBe(handler);
|
|
93
|
+
});
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
describe('hasHandler', () => {
|
|
97
|
+
it('returns false for an unregistered verb', () => {
|
|
98
|
+
expect(registry.hasHandler('nonexistent')).toBe(false);
|
|
99
|
+
});
|
|
100
|
+
|
|
101
|
+
it('returns true for a registered verb', () => {
|
|
102
|
+
expect(registry.hasHandler('ai')).toBe(true);
|
|
103
|
+
});
|
|
104
|
+
|
|
105
|
+
it('returns true after registering a custom handler', () => {
|
|
106
|
+
registry.registerHandler(new CustomVerbHandler('connect'));
|
|
107
|
+
expect(registry.hasHandler('connect')).toBe(true);
|
|
108
|
+
});
|
|
109
|
+
});
|
|
110
|
+
|
|
111
|
+
describe('integration with SWMLVerbHandler', () => {
|
|
112
|
+
it('can validate config through a registered handler', () => {
|
|
113
|
+
const handler = registry.getHandler('ai')!;
|
|
114
|
+
const [valid, errors] = handler.validateConfig({
|
|
115
|
+
prompt: { text: 'Hello' },
|
|
116
|
+
});
|
|
117
|
+
expect(valid).toBe(true);
|
|
118
|
+
expect(errors).toHaveLength(0);
|
|
119
|
+
});
|
|
120
|
+
|
|
121
|
+
it('can build config through a registered handler', () => {
|
|
122
|
+
const handler = registry.getHandler('ai')!;
|
|
123
|
+
const config = handler.buildConfig({ promptText: 'Hello there' });
|
|
124
|
+
expect(config).toHaveProperty('prompt');
|
|
125
|
+
expect((config['prompt'] as Record<string, unknown>)['text']).toBe('Hello there');
|
|
126
|
+
});
|
|
127
|
+
});
|
|
128
|
+
});
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import { generateFakePostData, generateMinimalPostData } from '../../src/cli/mock-data.js';
|
|
3
|
+
|
|
4
|
+
describe('mock-data', () => {
|
|
5
|
+
describe('generateFakePostData', () => {
|
|
6
|
+
it('generates data with defaults', () => {
|
|
7
|
+
const data = generateFakePostData();
|
|
8
|
+
expect(data.call_id).toBeDefined();
|
|
9
|
+
expect(data.call_type).toBe('webrtc');
|
|
10
|
+
expect(data.call_direction).toBe('inbound');
|
|
11
|
+
expect(data.caller_id_number).toBe('+15551234567');
|
|
12
|
+
expect(data.channel_type).toBe('web');
|
|
13
|
+
});
|
|
14
|
+
|
|
15
|
+
it('generates SIP call data', () => {
|
|
16
|
+
const data = generateFakePostData({ callType: 'sip' });
|
|
17
|
+
expect(data.call_type).toBe('sip');
|
|
18
|
+
expect(data.channel_type).toBe('phone');
|
|
19
|
+
expect(data.sip_headers).toBeDefined();
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
it('respects custom options', () => {
|
|
23
|
+
const data = generateFakePostData({
|
|
24
|
+
callType: 'sip',
|
|
25
|
+
callDirection: 'outbound',
|
|
26
|
+
fromNumber: '+18005551212',
|
|
27
|
+
toExtension: 'my-agent',
|
|
28
|
+
});
|
|
29
|
+
expect(data.call_type).toBe('sip');
|
|
30
|
+
expect(data.call_direction).toBe('outbound');
|
|
31
|
+
expect(data.from).toBe('+18005551212');
|
|
32
|
+
expect(data.to).toBe('my-agent');
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
it('generates unique call IDs', () => {
|
|
36
|
+
const data1 = generateFakePostData();
|
|
37
|
+
const data2 = generateFakePostData();
|
|
38
|
+
expect(data1.call_id).not.toBe(data2.call_id);
|
|
39
|
+
});
|
|
40
|
+
|
|
41
|
+
it('webrtc calls have no sip_headers', () => {
|
|
42
|
+
const data = generateFakePostData({ callType: 'webrtc' });
|
|
43
|
+
expect(data.sip_headers).toBeUndefined();
|
|
44
|
+
});
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
describe('generateMinimalPostData', () => {
|
|
48
|
+
it('generates minimal data for function execution', () => {
|
|
49
|
+
const data = generateMinimalPostData('get_time');
|
|
50
|
+
expect(data.function).toBe('get_time');
|
|
51
|
+
expect(data.argument).toEqual({});
|
|
52
|
+
expect(data.call_id).toBeDefined();
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
it('includes provided arguments', () => {
|
|
56
|
+
const data = generateMinimalPostData('search', { query: 'test' });
|
|
57
|
+
expect(data.function).toBe('search');
|
|
58
|
+
expect(data.argument).toEqual({ query: 'test' });
|
|
59
|
+
});
|
|
60
|
+
|
|
61
|
+
it('generates unique call IDs each time', () => {
|
|
62
|
+
const data1 = generateMinimalPostData('fn');
|
|
63
|
+
const data2 = generateMinimalPostData('fn');
|
|
64
|
+
expect(data1.call_id).not.toBe(data2.call_id);
|
|
65
|
+
});
|
|
66
|
+
|
|
67
|
+
it('accepts callId override', () => {
|
|
68
|
+
const data = generateMinimalPostData('fn', {}, { callId: 'my-call-id' });
|
|
69
|
+
expect(data.call_id).toBe('my-call-id');
|
|
70
|
+
});
|
|
71
|
+
|
|
72
|
+
it('accepts overrides', () => {
|
|
73
|
+
const data = generateMinimalPostData('fn', {}, { overrides: { custom_field: 'custom_value' } });
|
|
74
|
+
expect(data['custom_field']).toBe('custom_value');
|
|
75
|
+
});
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
describe('generateFakePostData - extended', () => {
|
|
79
|
+
it('includes call_state', () => {
|
|
80
|
+
const data = generateFakePostData({ callState: 'ringing' });
|
|
81
|
+
expect(data.call_state).toBe('ringing');
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
it('accepts callId override', () => {
|
|
85
|
+
const data = generateFakePostData({ callId: 'fixed-call-id' });
|
|
86
|
+
expect(data.call_id).toBe('fixed-call-id');
|
|
87
|
+
});
|
|
88
|
+
|
|
89
|
+
it('applies overrides to post data', () => {
|
|
90
|
+
const data = generateFakePostData({ overrides: { custom: 'value' } });
|
|
91
|
+
expect(data['custom']).toBe('value');
|
|
92
|
+
});
|
|
93
|
+
|
|
94
|
+
it('overrides with __proto__ do NOT pollute Object prototype', () => {
|
|
95
|
+
const data = generateFakePostData({
|
|
96
|
+
overrides: { '__proto__': { polluted: true } } as any,
|
|
97
|
+
});
|
|
98
|
+
// @ts-expect-error - checking prototype pollution
|
|
99
|
+
expect(({} as any).polluted).toBeUndefined();
|
|
100
|
+
// The data object itself should NOT have __proto__ as own property from pollution
|
|
101
|
+
});
|
|
102
|
+
});
|
|
103
|
+
|
|
104
|
+
describe('generateMinimalPostData - prototype pollution', () => {
|
|
105
|
+
it('overrides with __proto__ do NOT pollute Object prototype', () => {
|
|
106
|
+
const data = generateMinimalPostData('fn', {}, {
|
|
107
|
+
overrides: { '__proto__': { polluted: true } } as any,
|
|
108
|
+
});
|
|
109
|
+
// @ts-expect-error - checking prototype pollution
|
|
110
|
+
expect(({} as any).polluted).toBeUndefined();
|
|
111
|
+
});
|
|
112
|
+
});
|
|
113
|
+
});
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import { describe, it, expect } from 'vitest';
|
|
2
|
+
import { AgentBase } from '../../src/AgentBase.js';
|
|
3
|
+
import { FunctionResult } from '../../src/FunctionResult.js';
|
|
4
|
+
|
|
5
|
+
describe('agent introspection', () => {
|
|
6
|
+
function createAgent() {
|
|
7
|
+
const agent = new AgentBase({ name: 'test-agent', route: '/test' });
|
|
8
|
+
agent.setPromptText('Hello from test agent');
|
|
9
|
+
agent.defineTool({
|
|
10
|
+
name: 'greet',
|
|
11
|
+
description: 'Say hello',
|
|
12
|
+
parameters: { name: { type: 'string', description: 'Name' } },
|
|
13
|
+
handler: (args) => new FunctionResult('Hello ' + (args['name'] || 'world')),
|
|
14
|
+
});
|
|
15
|
+
agent.defineTool({
|
|
16
|
+
name: 'get_time',
|
|
17
|
+
description: 'Get current time',
|
|
18
|
+
parameters: {},
|
|
19
|
+
handler: () => new FunctionResult('12:00 PM'),
|
|
20
|
+
});
|
|
21
|
+
return agent;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
it('getRegisteredTools returns all tool info', () => {
|
|
25
|
+
const agent = createAgent();
|
|
26
|
+
const tools = agent.getRegisteredTools();
|
|
27
|
+
expect(tools).toHaveLength(2);
|
|
28
|
+
expect(tools[0].name).toBe('greet');
|
|
29
|
+
expect(tools[0].description).toBe('Say hello');
|
|
30
|
+
expect(tools[0].parameters).toHaveProperty('name');
|
|
31
|
+
expect(tools[1].name).toBe('get_time');
|
|
32
|
+
});
|
|
33
|
+
|
|
34
|
+
it('getRegisteredTools returns empty for no tools', () => {
|
|
35
|
+
const agent = new AgentBase({ name: 'empty', route: '/test' });
|
|
36
|
+
expect(agent.getRegisteredTools()).toHaveLength(0);
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
it('getTool returns a specific SwaigFunction', () => {
|
|
40
|
+
const agent = createAgent();
|
|
41
|
+
const tool = agent.getTool('greet');
|
|
42
|
+
expect(tool).toBeDefined();
|
|
43
|
+
expect(tool!.name).toBe('greet');
|
|
44
|
+
expect(tool!.description).toBe('Say hello');
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
it('getTool returns undefined for missing tool', () => {
|
|
48
|
+
const agent = createAgent();
|
|
49
|
+
expect(agent.getTool('nonexistent')).toBeUndefined();
|
|
50
|
+
});
|
|
51
|
+
|
|
52
|
+
it('can execute tool via getTool', async () => {
|
|
53
|
+
const agent = createAgent();
|
|
54
|
+
const tool = agent.getTool('greet')!;
|
|
55
|
+
const result = await tool.execute({ name: 'Alice' }, {});
|
|
56
|
+
expect(result.response).toBe('Hello Alice');
|
|
57
|
+
});
|
|
58
|
+
|
|
59
|
+
it('can execute tool with no args', async () => {
|
|
60
|
+
const agent = createAgent();
|
|
61
|
+
const tool = agent.getTool('get_time')!;
|
|
62
|
+
const result = await tool.execute({}, {});
|
|
63
|
+
expect(result.response).toBe('12:00 PM');
|
|
64
|
+
});
|
|
65
|
+
|
|
66
|
+
it('renderSwml produces valid SWML with tools', () => {
|
|
67
|
+
const agent = createAgent();
|
|
68
|
+
const swml = agent.renderSwml('test-call-id');
|
|
69
|
+
const parsed = JSON.parse(swml);
|
|
70
|
+
expect(parsed.version).toBe('1.0.0');
|
|
71
|
+
expect(parsed.sections.main).toBeDefined();
|
|
72
|
+
const ai = parsed.sections.main[1].ai;
|
|
73
|
+
expect(ai.SWAIG.functions).toHaveLength(2);
|
|
74
|
+
});
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
describe('agent-loader file extension validation', () => {
|
|
78
|
+
it('rejects unsupported file extensions', async () => {
|
|
79
|
+
const { loadAgent } = await import('../../src/cli/agent-loader.js');
|
|
80
|
+
await expect(loadAgent('/tmp/agent.txt')).rejects.toThrow('Unsupported file extension');
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
it('rejects .json files', async () => {
|
|
84
|
+
const { loadAgent } = await import('../../src/cli/agent-loader.js');
|
|
85
|
+
await expect(loadAgent('/tmp/agent.json')).rejects.toThrow('Unsupported file extension');
|
|
86
|
+
});
|
|
87
|
+
});
|
|
88
|
+
|
|
89
|
+
describe('agent-loader duck typing', () => {
|
|
90
|
+
it('AgentBase instances pass duck-type check', () => {
|
|
91
|
+
const agent = new AgentBase({ name: 'test', route: '/test' });
|
|
92
|
+
// The duck-type check used by agent-loader
|
|
93
|
+
expect(typeof (agent as any).renderSwml).toBe('function');
|
|
94
|
+
expect(typeof (agent as any).defineTool).toBe('function');
|
|
95
|
+
expect(typeof (agent as any).getPrompt).toBe('function');
|
|
96
|
+
});
|
|
97
|
+
|
|
98
|
+
it('plain objects do not pass duck-type check', () => {
|
|
99
|
+
const obj = { renderSwml: 'not a function' };
|
|
100
|
+
expect(typeof obj.renderSwml).not.toBe('function');
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
it('AgentBase class prototype has required methods', () => {
|
|
104
|
+
expect(typeof AgentBase.prototype.renderSwml).toBe('function');
|
|
105
|
+
expect(typeof AgentBase.prototype.defineTool).toBe('function');
|
|
106
|
+
expect(typeof AgentBase.prototype.getPrompt).toBe('function');
|
|
107
|
+
});
|
|
108
|
+
});
|