@kodelyth/voice-call 2026.5.42 → 2026.6.2

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.
Files changed (111) hide show
  1. package/package.json +18 -6
  2. package/api.ts +0 -16
  3. package/cli-metadata.ts +0 -10
  4. package/config-api.ts +0 -12
  5. package/index.test.ts +0 -1075
  6. package/index.ts +0 -863
  7. package/runtime-api.ts +0 -20
  8. package/runtime-entry.ts +0 -1
  9. package/setup-api.ts +0 -47
  10. package/src/allowlist.test.ts +0 -18
  11. package/src/allowlist.ts +0 -19
  12. package/src/cli.test.ts +0 -12
  13. package/src/cli.ts +0 -866
  14. package/src/config-compat.test.ts +0 -130
  15. package/src/config-compat.ts +0 -227
  16. package/src/config.test.ts +0 -542
  17. package/src/config.ts +0 -883
  18. package/src/core-bridge.ts +0 -14
  19. package/src/deep-merge.test.ts +0 -40
  20. package/src/deep-merge.ts +0 -23
  21. package/src/gateway-continue-operation.ts +0 -200
  22. package/src/http-headers.test.ts +0 -16
  23. package/src/http-headers.ts +0 -15
  24. package/src/manager/context.ts +0 -50
  25. package/src/manager/events.test.ts +0 -578
  26. package/src/manager/events.ts +0 -332
  27. package/src/manager/lifecycle.ts +0 -53
  28. package/src/manager/lookup.test.ts +0 -52
  29. package/src/manager/lookup.ts +0 -35
  30. package/src/manager/outbound.test.ts +0 -629
  31. package/src/manager/outbound.ts +0 -508
  32. package/src/manager/state.ts +0 -48
  33. package/src/manager/store.ts +0 -107
  34. package/src/manager/timers.test.ts +0 -127
  35. package/src/manager/timers.ts +0 -113
  36. package/src/manager/twiml.test.ts +0 -13
  37. package/src/manager/twiml.ts +0 -17
  38. package/src/manager.closed-loop.test.ts +0 -259
  39. package/src/manager.inbound-allowlist.test.ts +0 -183
  40. package/src/manager.notify.test.ts +0 -390
  41. package/src/manager.restore.test.ts +0 -310
  42. package/src/manager.test-harness.ts +0 -127
  43. package/src/manager.ts +0 -441
  44. package/src/media-stream.test.ts +0 -953
  45. package/src/media-stream.ts +0 -876
  46. package/src/providers/base.ts +0 -99
  47. package/src/providers/mock.test.ts +0 -86
  48. package/src/providers/mock.ts +0 -185
  49. package/src/providers/plivo.test.ts +0 -93
  50. package/src/providers/plivo.ts +0 -601
  51. package/src/providers/shared/call-status.test.ts +0 -24
  52. package/src/providers/shared/call-status.ts +0 -24
  53. package/src/providers/shared/guarded-json-api.test.ts +0 -127
  54. package/src/providers/shared/guarded-json-api.ts +0 -49
  55. package/src/providers/telnyx.test.ts +0 -489
  56. package/src/providers/telnyx.ts +0 -419
  57. package/src/providers/twilio/api.test.ts +0 -184
  58. package/src/providers/twilio/api.ts +0 -100
  59. package/src/providers/twilio/twiml-policy.test.ts +0 -84
  60. package/src/providers/twilio/twiml-policy.ts +0 -87
  61. package/src/providers/twilio/webhook.ts +0 -34
  62. package/src/providers/twilio.test.ts +0 -607
  63. package/src/providers/twilio.ts +0 -861
  64. package/src/providers/twilio.types.ts +0 -17
  65. package/src/realtime-agent-context.test.ts +0 -101
  66. package/src/realtime-agent-context.ts +0 -149
  67. package/src/realtime-defaults.ts +0 -3
  68. package/src/realtime-fast-context.test.ts +0 -74
  69. package/src/realtime-fast-context.ts +0 -27
  70. package/src/realtime-transcription.runtime.ts +0 -4
  71. package/src/realtime-voice.runtime.ts +0 -5
  72. package/src/response-generator.test.ts +0 -385
  73. package/src/response-generator.ts +0 -348
  74. package/src/response-model.test.ts +0 -71
  75. package/src/response-model.ts +0 -23
  76. package/src/runtime.test.ts +0 -625
  77. package/src/runtime.ts +0 -528
  78. package/src/telephony-audio.test.ts +0 -61
  79. package/src/telephony-audio.ts +0 -12
  80. package/src/telephony-tts.test.ts +0 -196
  81. package/src/telephony-tts.ts +0 -235
  82. package/src/test-fixtures.ts +0 -82
  83. package/src/tts-provider-voice.test.ts +0 -34
  84. package/src/tts-provider-voice.ts +0 -21
  85. package/src/tunnel.test.ts +0 -173
  86. package/src/tunnel.ts +0 -314
  87. package/src/types.ts +0 -311
  88. package/src/utils.test.ts +0 -17
  89. package/src/utils.ts +0 -14
  90. package/src/voice-mapping.test.ts +0 -32
  91. package/src/voice-mapping.ts +0 -65
  92. package/src/webhook/realtime-audio-pacer.test.ts +0 -146
  93. package/src/webhook/realtime-audio-pacer.ts +0 -204
  94. package/src/webhook/realtime-handler.test.ts +0 -1450
  95. package/src/webhook/realtime-handler.ts +0 -1382
  96. package/src/webhook/stale-call-reaper.test.ts +0 -89
  97. package/src/webhook/stale-call-reaper.ts +0 -38
  98. package/src/webhook/stream-frame-adapter.test.ts +0 -187
  99. package/src/webhook/stream-frame-adapter.ts +0 -219
  100. package/src/webhook/tailscale.test.ts +0 -216
  101. package/src/webhook/tailscale.ts +0 -129
  102. package/src/webhook-exposure.test.ts +0 -33
  103. package/src/webhook-exposure.ts +0 -84
  104. package/src/webhook-security.test.ts +0 -813
  105. package/src/webhook-security.ts +0 -982
  106. package/src/webhook.hangup-once.lifecycle.test.ts +0 -179
  107. package/src/webhook.test.ts +0 -1615
  108. package/src/webhook.ts +0 -933
  109. package/src/webhook.types.ts +0 -5
  110. package/src/websocket-test-support.ts +0 -72
  111. package/tsconfig.json +0 -16
@@ -1,84 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
- import type { WebhookContext } from "../../types.js";
3
- import { decideTwimlResponse, readTwimlRequestView } from "./twiml-policy.js";
4
-
5
- function createContext(rawBody: string, query?: WebhookContext["query"]): WebhookContext {
6
- return {
7
- headers: {},
8
- rawBody,
9
- url: "https://example.ngrok.app/voice/twilio",
10
- method: "POST",
11
- query,
12
- };
13
- }
14
-
15
- describe("twiml policy", () => {
16
- it("returns stored twiml decision for initial notify callback", () => {
17
- const view = readTwimlRequestView(
18
- createContext("CallStatus=initiated&Direction=outbound-api&CallSid=CA123", {
19
- callId: "call-1",
20
- }),
21
- );
22
-
23
- const decision = decideTwimlResponse({
24
- ...view,
25
- hasStoredTwiml: true,
26
- isNotifyCall: true,
27
- hasActiveStreams: false,
28
- canStream: true,
29
- });
30
-
31
- expect(decision.kind).toBe("stored");
32
- });
33
-
34
- it("returns queue for inbound when another stream is active", () => {
35
- const view = readTwimlRequestView(
36
- createContext("CallStatus=ringing&Direction=inbound&CallSid=CA456"),
37
- );
38
-
39
- const decision = decideTwimlResponse({
40
- ...view,
41
- hasStoredTwiml: false,
42
- isNotifyCall: false,
43
- hasActiveStreams: true,
44
- canStream: true,
45
- });
46
-
47
- expect(decision.kind).toBe("queue");
48
- });
49
-
50
- it("returns stream + activation for inbound call when available", () => {
51
- const view = readTwimlRequestView(
52
- createContext("CallStatus=ringing&Direction=inbound&CallSid=CA789"),
53
- );
54
-
55
- const decision = decideTwimlResponse({
56
- ...view,
57
- hasStoredTwiml: false,
58
- isNotifyCall: false,
59
- hasActiveStreams: false,
60
- canStream: true,
61
- });
62
-
63
- expect(decision.kind).toBe("stream");
64
- expect(decision.activateStreamCallSid).toBe("CA789");
65
- });
66
-
67
- it("returns empty for status callbacks", () => {
68
- const view = readTwimlRequestView(
69
- createContext("CallStatus=completed&Direction=inbound&CallSid=CA123", {
70
- type: "status",
71
- }),
72
- );
73
-
74
- const decision = decideTwimlResponse({
75
- ...view,
76
- hasStoredTwiml: false,
77
- isNotifyCall: false,
78
- hasActiveStreams: false,
79
- canStream: true,
80
- });
81
-
82
- expect(decision.kind).toBe("empty");
83
- });
84
- });
@@ -1,87 +0,0 @@
1
- import { normalizeOptionalString } from "klaw/plugin-sdk/string-coerce-runtime";
2
- import type { WebhookContext } from "../../types.js";
3
-
4
- type TwimlRequestView = {
5
- callStatus: string | null;
6
- direction: string | null;
7
- isStatusCallback: boolean;
8
- callSid?: string;
9
- callIdFromQuery?: string;
10
- };
11
-
12
- type TwimlPolicyInput = TwimlRequestView & {
13
- hasStoredTwiml: boolean;
14
- isNotifyCall: boolean;
15
- hasActiveStreams: boolean;
16
- canStream: boolean;
17
- };
18
-
19
- type TwimlDecision =
20
- | {
21
- kind: "empty" | "pause" | "queue";
22
- consumeStoredTwimlCallId?: string;
23
- activateStreamCallSid?: string;
24
- }
25
- | {
26
- kind: "stored";
27
- consumeStoredTwimlCallId: string;
28
- activateStreamCallSid?: string;
29
- }
30
- | {
31
- kind: "stream";
32
- consumeStoredTwimlCallId?: string;
33
- activateStreamCallSid?: string;
34
- };
35
-
36
- function isOutboundDirection(direction: string | null): boolean {
37
- return direction?.startsWith("outbound") ?? false;
38
- }
39
-
40
- export function readTwimlRequestView(ctx: WebhookContext): TwimlRequestView {
41
- const params = new URLSearchParams(ctx.rawBody);
42
- const type = normalizeOptionalString(ctx.query?.type);
43
- const callIdFromQuery = normalizeOptionalString(ctx.query?.callId);
44
-
45
- return {
46
- callStatus: params.get("CallStatus"),
47
- direction: params.get("Direction"),
48
- isStatusCallback: type === "status",
49
- callSid: params.get("CallSid") || undefined,
50
- callIdFromQuery,
51
- };
52
- }
53
-
54
- export function decideTwimlResponse(input: TwimlPolicyInput): TwimlDecision {
55
- if (input.callIdFromQuery && !input.isStatusCallback) {
56
- if (input.hasStoredTwiml) {
57
- return { kind: "stored", consumeStoredTwimlCallId: input.callIdFromQuery };
58
- }
59
- if (input.isNotifyCall) {
60
- return { kind: "empty" };
61
- }
62
-
63
- if (isOutboundDirection(input.direction)) {
64
- return input.canStream ? { kind: "stream" } : { kind: "pause" };
65
- }
66
- }
67
-
68
- if (input.isStatusCallback) {
69
- return { kind: "empty" };
70
- }
71
-
72
- if (input.direction === "inbound") {
73
- if (input.hasActiveStreams) {
74
- return { kind: "queue" };
75
- }
76
- if (input.canStream && input.callSid) {
77
- return { kind: "stream", activateStreamCallSid: input.callSid };
78
- }
79
- return { kind: "pause" };
80
- }
81
-
82
- if (input.callStatus !== "in-progress") {
83
- return { kind: "empty" };
84
- }
85
-
86
- return input.canStream ? { kind: "stream" } : { kind: "pause" };
87
- }
@@ -1,34 +0,0 @@
1
- import type { WebhookContext, WebhookVerificationResult } from "../../types.js";
2
- import { verifyTwilioWebhook } from "../../webhook-security.js";
3
- import type { TwilioProviderOptions } from "../twilio.types.js";
4
-
5
- export function verifyTwilioProviderWebhook(params: {
6
- ctx: WebhookContext;
7
- authToken: string;
8
- currentPublicUrl?: string | null;
9
- options: TwilioProviderOptions;
10
- }): WebhookVerificationResult {
11
- const result = verifyTwilioWebhook(params.ctx, params.authToken, {
12
- publicUrl: params.currentPublicUrl || undefined,
13
- allowNgrokFreeTierLoopbackBypass: params.options.allowNgrokFreeTierLoopbackBypass ?? false,
14
- skipVerification: params.options.skipVerification,
15
- allowedHosts: params.options.webhookSecurity?.allowedHosts,
16
- trustForwardingHeaders: params.options.webhookSecurity?.trustForwardingHeaders,
17
- trustedProxyIPs: params.options.webhookSecurity?.trustedProxyIPs,
18
- remoteIP: params.ctx.remoteAddress,
19
- });
20
-
21
- if (!result.ok) {
22
- console.warn(`[twilio] Webhook verification failed: ${result.reason}`);
23
- if (result.verificationUrl) {
24
- console.warn(`[twilio] Verification URL: ${result.verificationUrl}`);
25
- }
26
- }
27
-
28
- return {
29
- ok: result.ok,
30
- reason: result.reason,
31
- isReplay: result.isReplay,
32
- verifiedRequestKey: result.verifiedRequestKey,
33
- };
34
- }