@kodelyth/voice-call 2026.5.39 → 2026.5.42

package/klaw.plugin.json

@@ -1,20 +1,12 @@
 {
   "id": "voice-call",
-  "commandAliases": [
-    {
-      "name": "voicecall"
-    }
-  ],
+  "commandAliases": [{ "name": "voicecall" }],
   "activation": {
     "onStartup": true,
-    "onCommands": [
-      "voicecall"
-    ]
+    "onCommands": ["voicecall"]
   },
   "contracts": {
-    "tools": [
-      "voice_call"
-    ]
+    "tools": ["voice_call"]
   },
   "channelEnvVars": {
     "voice-call": [
@@ -269,12 +261,7 @@
       },
       "provider": {
         "type": "string",
-        "enum": [
-          "telnyx",
-          "twilio",
-          "plivo",
-          "mock"
-        ]
+        "enum": ["telnyx", "twilio", "plivo", "mock"]
       },
       "telnyx": {
         "type": "object",
@@ -299,10 +286,7 @@
             "type": "string"
           },
           "authToken": {
-            "type": [
-              "string",
-              "object"
-            ]
+            "type": ["string", "object"]
           }
         }
       },
@@ -328,12 +312,7 @@
       },
       "inboundPolicy": {
         "type": "string",
-        "enum": [
-          "disabled",
-          "allowlist",
-          "pairing",
-          "open"
-        ]
+        "enum": ["disabled", "allowlist", "pairing", "open"]
       },
       "allowFrom": {
         "type": "array",
@@ -383,10 +362,7 @@
         "properties": {
           "defaultMode": {
             "type": "string",
-            "enum": [
-              "notify",
-              "conversation"
-            ]
+            "enum": ["notify", "conversation"]
           },
           "notifyHangupDelaySec": {
             "type": "integer",
@@ -440,11 +416,7 @@
         "properties": {
           "mode": {
             "type": "string",
-            "enum": [
-              "off",
-              "serve",
-              "funnel"
-            ]
+            "enum": ["off", "serve", "funnel"]
           },
           "path": {
             "type": "string"
@@ -457,12 +429,7 @@
         "properties": {
           "provider": {
             "type": "string",
-            "enum": [
-              "none",
-              "ngrok",
-              "tailscale-serve",
-              "tailscale-funnel"
-            ]
+            "enum": ["none", "ngrok", "tailscale-serve", "tailscale-funnel"]
           },
           "ngrokAuthToken": {
             "type": "string"
@@ -552,32 +519,15 @@
           },
           "toolPolicy": {
             "type": "string",
-            "enum": [
-              "safe-read-only",
-              "owner",
-              "none"
-            ]
+            "enum": ["safe-read-only", "owner", "none"]
           },
           "consultPolicy": {
             "type": "string",
-            "enum": [
-              "auto",
-              "substantive",
-              "always"
-            ]
+            "enum": ["auto", "substantive", "always"]
           },
           "consultThinkingLevel": {
             "type": "string",
-            "enum": [
-              "off",
-              "minimal",
-              "low",
-              "medium",
-              "high",
-              "xhigh",
-              "adaptive",
-              "max"
-            ]
+            "enum": ["off", "minimal", "low", "medium", "high", "xhigh", "adaptive", "max"]
           },
           "consultFastMode": {
             "type": "boolean"
@@ -590,9 +540,7 @@
               "properties": {
                 "type": {
                   "type": "string",
-                  "enum": [
-                    "function"
-                  ]
+                  "enum": ["function"]
                 },
                 "name": {
                   "type": "string"
@@ -606,9 +554,7 @@
                   "properties": {
                     "type": {
                       "type": "string",
-                      "enum": [
-                        "object"
-                      ]
+                      "enum": ["object"]
                     },
                     "properties": {
                       "type": "object",
@@ -621,18 +567,10 @@
                       }
                     }
                   },
-                  "required": [
-                    "type",
-                    "properties"
-                  ]
+                  "required": ["type", "properties"]
                 }
               },
-              "required": [
-                "type",
-                "name",
-                "description",
-                "parameters"
-              ]
+              "required": ["type", "name", "description", "parameters"]
             }
           },
           "fastContext": {
@@ -655,10 +593,7 @@
                 "minItems": 1,
                 "items": {
                   "type": "string",
-                  "enum": [
-                    "memory",
-                    "sessions"
-                  ]
+                  "enum": ["memory", "sessions"]
                 }
               },
               "fallbackToConsult": {
@@ -716,22 +651,14 @@
         "properties": {
           "auto": {
             "type": "string",
-            "enum": [
-              "off",
-              "always",
-              "inbound",
-              "tagged"
-            ]
+            "enum": ["off", "always", "inbound", "tagged"]
           },
           "enabled": {
             "type": "boolean"
           },
           "mode": {
             "type": "string",
-            "enum": [
-              "final",
-              "all"
-            ]
+            "enum": ["final", "all"]
           },
           "provider": {
             "type": "string"
@@ -777,10 +704,7 @@
                 "additionalProperties": false,
                 "properties": {
                   "apiKey": {
-                    "type": [
-                      "string",
-                      "object"
-                    ]
+                    "type": ["string", "object"]
                   },
                   "baseUrl": {
                     "type": "string"
@@ -794,7 +718,7 @@
                   "speed": {
                     "type": "number",
                     "minimum": 0.25,
-                    "maximum": 4
+                    "maximum": 4.0
                   },
                   "instructions": {
                     "type": "string"
@@ -806,10 +730,7 @@
                 "additionalProperties": false,
                 "properties": {
                   "apiKey": {
-                    "type": [
-                      "string",
-                      "object"
-                    ]
+                    "type": ["string", "object"]
                   },
                   "baseUrl": {
                     "type": "string"
@@ -827,11 +748,7 @@
                   },
                   "applyTextNormalization": {
                     "type": "string",
-                    "enum": [
-                      "auto",
-                      "on",
-                      "off"
-                    ]
+                    "enum": ["auto", "on", "off"]
                   },
                   "languageCode": {
                     "type": "string"
@@ -948,10 +865,7 @@
               "type": "object",
               "properties": {
                 "apiKey": {
-                  "type": [
-                    "string",
-                    "object"
-                  ]
+                  "type": ["string", "object"]
                 }
               },
               "additionalProperties": true
@@ -976,10 +890,7 @@
       },
       "sessionScope": {
         "type": "string",
-        "enum": [
-          "per-phone",
-          "per-call"
-        ]
+        "enum": ["per-phone", "per-call"]
       },
       "responseModel": {
         "type": "string"
@@ -994,27 +905,13 @@
     }
   },
   "configContracts": {
-    "compatibilityMigrationPaths": [
-      "plugins.entries.voice-call.config"
-    ],
+    "compatibilityMigrationPaths": ["plugins.entries.voice-call.config"],
     "secretInputs": {
       "paths": [
-        {
-          "path": "twilio.authToken",
-          "expected": "string"
-        },
-        {
-          "path": "realtime.providers.*.apiKey",
-          "expected": "string"
-        },
-        {
-          "path": "streaming.providers.*.apiKey",
-          "expected": "string"
-        },
-        {
-          "path": "tts.providers.*.apiKey",
-          "expected": "string"
-        }
+        { "path": "twilio.authToken", "expected": "string" },
+        { "path": "realtime.providers.*.apiKey", "expected": "string" },
+        { "path": "streaming.providers.*.apiKey", "expected": "string" },
+        { "path": "tts.providers.*.apiKey", "expected": "string" }
       ]
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodelyth/voice-call",
-  "version": "2026.5.39",
+  "version": "2026.5.42",
   "description": "Klaw voice-call plugin",
   "repository": {
     "type": "git",
@@ -15,7 +15,7 @@
   },
   "devDependencies": {
     "@kodelyth/plugin-sdk": "1.0.1",
-    "@kodelyth/klaw": "2026.5.41"
+    "@kodelyth/klaw": "2026.5.42"
   },
   "peerDependencies": {
     "@kodelyth/klaw": ">=2026.5.19"
@@ -27,7 +27,7 @@
   },
   "klaw": {
     "extensions": [
-      "./index.js"
+      "./index.ts"
     ],
     "install": {
       "npmSpec": "@kodelyth/voice-call",

package/runtime-api.ts

@@ -0,0 +1,20 @@
+// Private runtime barrel for the bundled Voice Call extension.
+// Keep this barrel thin and aligned with the local extension surface.
+
+export { definePluginEntry } from "klaw/plugin-sdk/plugin-entry";
+export type { KlawPluginApi } from "klaw/plugin-sdk/plugin-entry";
+export type { GatewayRequestHandlerOptions } from "klaw/plugin-sdk/gateway-runtime";
+export {
+  isRequestBodyLimitError,
+  readRequestBodyWithLimit,
+  requestBodyErrorToText,
+} from "klaw/plugin-sdk/webhook-request-guards";
+export { fetchWithSsrFGuard, isBlockedHostnameOrIp } from "klaw/plugin-sdk/ssrf-runtime";
+export type { SessionEntry } from "klaw/plugin-sdk/session-store-runtime";
+export {
+  TtsAutoSchema,
+  TtsConfigSchema,
+  TtsModeSchema,
+  TtsProviderSchema,
+} from "klaw/plugin-sdk/tts-runtime";
+export { sleep } from "klaw/plugin-sdk/runtime-env";

package/runtime-entry.ts

@@ -0,0 +1 @@
+export { createVoiceCallRuntime, type VoiceCallRuntime } from "./src/runtime.js";

package/setup-api.ts

@@ -0,0 +1,47 @@
+import type { KlawConfig } from "klaw/plugin-sdk/plugin-entry";
+import { definePluginEntry } from "klaw/plugin-sdk/plugin-entry";
+import { isRecord } from "klaw/plugin-sdk/string-coerce-runtime";
+import { migrateVoiceCallLegacyConfigInput } from "./config-api.js";
+
+function migrateVoiceCallPluginConfig(config: KlawConfig): {
+  config: KlawConfig;
+  changes: string[];
+} | null {
+  const rawVoiceCallConfig = config.plugins?.entries?.["voice-call"]?.config;
+  if (!isRecord(rawVoiceCallConfig)) {
+    return null;
+  }
+  const migration = migrateVoiceCallLegacyConfigInput({
+    value: rawVoiceCallConfig,
+    configPathPrefix: "plugins.entries.voice-call.config",
+  });
+  if (migration.changes.length === 0) {
+    return null;
+  }
+  const plugins = structuredClone(config.plugins ?? {});
+  const entries = { ...plugins.entries };
+  const existingVoiceCallEntry = isRecord(entries["voice-call"])
+    ? (entries["voice-call"] as Record<string, unknown>)
+    : {};
+  entries["voice-call"] = {
+    ...existingVoiceCallEntry,
+    config: migration.config,
+  };
+  plugins.entries = entries;
+  return {
+    config: {
+      ...config,
+      plugins,
+    },
+    changes: migration.changes,
+  };
+}
+
+export default definePluginEntry({
+  id: "voice-call",
+  name: "Voice Call Setup",
+  description: "Lightweight Voice Call setup hooks",
+  register(api) {
+    api.registerConfigMigration((config) => migrateVoiceCallPluginConfig(config));
+  },
+});

package/src/allowlist.test.ts

@@ -0,0 +1,18 @@
+import { describe, expect, it } from "vitest";
+import { isAllowlistedCaller, normalizePhoneNumber } from "./allowlist.js";
+
+describe("voice-call allowlist", () => {
+  it("normalizes phone numbers by stripping non-digits", () => {
+    expect(normalizePhoneNumber("+1 (415) 555-0123")).toBe("14155550123");
+    expect(normalizePhoneNumber("  020-7946-0958  ")).toBe("02079460958");
+    expect(normalizePhoneNumber("")).toBe("");
+    expect(normalizePhoneNumber()).toBe("");
+  });
+
+  it("matches normalized allowlist entries and rejects blank callers", () => {
+    expect(isAllowlistedCaller("14155550123", ["+1 (415) 555-0123", " 020-7946-0958 "])).toBe(true);
+    expect(isAllowlistedCaller("02079460958", ["+1 (415) 555-0123", " 020-7946-0958 "])).toBe(true);
+    expect(isAllowlistedCaller("", ["+1 (415) 555-0123"])).toBe(false);
+    expect(isAllowlistedCaller("14155550123", ["", "abc"])).toBe(false);
+  });
+});

package/src/allowlist.ts

@@ -0,0 +1,19 @@
+export function normalizePhoneNumber(input?: string): string {
+  if (!input) {
+    return "";
+  }
+  return input.replace(/\D/g, "");
+}
+
+export function isAllowlistedCaller(
+  normalizedFrom: string,
+  allowFrom: string[] | undefined,
+): boolean {
+  if (!normalizedFrom) {
+    return false;
+  }
+  return (allowFrom ?? []).some((num) => {
+    const normalizedAllow = normalizePhoneNumber(num);
+    return normalizedAllow !== "" && normalizedAllow === normalizedFrom;
+  });
+}

package/src/cli.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, it } from "vitest";
+import { testing } from "./cli.js";
+
+describe("voice-call CLI gateway fallback", () => {
+  it("treats abnormal local gateway closes as standalone-runtime fallback candidates", () => {
+    expect(
+      testing.isGatewayUnavailableForLocalFallback(
+        new Error("gateway closed (1006 abnormal closure (no close frame)): no close reason"),
+      ),
+    ).toBe(true);
+  });
+});