@kodelyth/voice-call 2026.5.42 → 2026.6.1

package/src/core-bridge.ts

@@ -1,14 +0,0 @@
-import type { KlawPluginApi } from "../api.js";
-import type { VoiceCallTtsConfig } from "./config.js";
-
-export type CoreConfig = {
-  session?: {
-    store?: string;
-  };
-  messages?: {
-    tts?: VoiceCallTtsConfig;
-  };
-  [key: string]: unknown;
-};
-
-export type CoreAgentDeps = KlawPluginApi["runtime"]["agent"];

package/src/deep-merge.test.ts

@@ -1,40 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { deepMergeDefined } from "./deep-merge.js";
-
-describe("deepMergeDefined", () => {
-  it("deep merges nested plain objects and preserves base values for undefined overrides", () => {
-    expect(
-      deepMergeDefined(
-        {
-          provider: { voice: "alloy", language: "en" },
-          enabled: true,
-        },
-        {
-          provider: { voice: "echo", language: undefined },
-          enabled: undefined,
-        },
-      ),
-    ).toEqual({
-      provider: { voice: "echo", language: "en" },
-      enabled: true,
-    });
-  });
-
-  it("replaces non-objects directly and blocks dangerous prototype keys", () => {
-    expect(deepMergeDefined(["a"], ["b"])).toEqual(["b"]);
-    expect(deepMergeDefined("base", undefined)).toBe("base");
-    expect(
-      deepMergeDefined(
-        { safe: { keep: true } },
-        {
-          safe: { next: true },
-          __proto__: { polluted: true },
-          constructor: { polluted: true },
-          prototype: { polluted: true },
-        },
-      ),
-    ).toEqual({
-      safe: { keep: true, next: true },
-    });
-  });
-});

package/src/deep-merge.ts

@@ -1,23 +0,0 @@
-const BLOCKED_MERGE_KEYS = new Set(["__proto__", "prototype", "constructor"]);
-
-export function deepMergeDefined(base: unknown, override: unknown): unknown {
-  if (!isPlainObject(base) || !isPlainObject(override)) {
-    return override === undefined ? base : override;
-  }
-
-  const result: Record<string, unknown> = { ...base };
-  for (const [key, value] of Object.entries(override)) {
-    if (BLOCKED_MERGE_KEYS.has(key) || value === undefined) {
-      continue;
-    }
-
-    const existing = result[key];
-    result[key] = key in result ? deepMergeDefined(existing, value) : value;
-  }
-
-  return result;
-}
-
-function isPlainObject(value: unknown): value is Record<string, unknown> {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}

package/src/gateway-continue-operation.ts

@@ -1,200 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { formatErrorMessage } from "klaw/plugin-sdk/error-runtime";
-import type { VoiceCallConfig } from "./config.js";
-import type { CoreConfig } from "./core-bridge.js";
-import type { VoiceCallRuntime } from "./runtime.js";
-import { TELEPHONY_DEFAULT_TTS_TIMEOUT_MS } from "./telephony-tts.js";
-
-const VOICE_CALL_CONTINUE_OPERATION_BUFFER_MS = 30000;
-const VOICE_CALL_CONTINUE_OPERATION_CLEANUP_MS = 5 * 60 * 1000;
-
-type VoiceCallContinueOperation =
-  | {
-      operationId: string;
-      status: "pending";
-      callId: string;
-      startedAtMs: number;
-      pollTimeoutMs: number;
-    }
-  | {
-      operationId: string;
-      status: "completed";
-      callId: string;
-      startedAtMs: number;
-      completedAtMs: number;
-      pollTimeoutMs: number;
-      result: { success: true; transcript?: string };
-    }
-  | {
-      operationId: string;
-      status: "failed";
-      callId: string;
-      startedAtMs: number;
-      completedAtMs: number;
-      pollTimeoutMs: number;
-      error: string;
-    };
-
-type VoiceCallContinueOperationStartPayload = {
-  operationId: string;
-  status: "pending";
-  pollTimeoutMs: number;
-};
-
-type VoiceCallContinueOperationResultPayload =
-  | {
-      operationId: string;
-      status: "pending";
-      pollTimeoutMs: number;
-    }
-  | {
-      operationId: string;
-      status: "completed";
-      result: { success: true; transcript?: string };
-    }
-  | {
-      operationId: string;
-      status: "failed";
-      error: string;
-    };
-
-type VoiceCallContinueOperationRequest = {
-  rt: VoiceCallRuntime;
-  callId: string;
-  message: string;
-};
-
-export function createVoiceCallContinueOperationStore(params: {
-  config: VoiceCallConfig;
-  coreConfig: CoreConfig;
-}) {
-  const operations = new Map<string, VoiceCallContinueOperation>();
-
-  const resolvePollTimeoutMs = (rt: VoiceCallRuntime): number => {
-    const ttsTimeoutMs =
-      rt.config.tts?.timeoutMs ??
-      params.config.tts?.timeoutMs ??
-      params.coreConfig.messages?.tts?.timeoutMs ??
-      TELEPHONY_DEFAULT_TTS_TIMEOUT_MS;
-    return (
-      (rt.config.transcriptTimeoutMs ?? params.config.transcriptTimeoutMs) +
-      ttsTimeoutMs +
-      VOICE_CALL_CONTINUE_OPERATION_BUFFER_MS
-    );
-  };
-
-  const scheduleCleanup = (operationId: string) => {
-    const timer = setTimeout(() => {
-      operations.delete(operationId);
-    }, VOICE_CALL_CONTINUE_OPERATION_CLEANUP_MS);
-    timer.unref?.();
-  };
-
-  const start = (
-    request: VoiceCallContinueOperationRequest,
-  ): VoiceCallContinueOperationStartPayload => {
-    const operationId = randomUUID();
-    const startedAtMs = Date.now();
-    const pollTimeoutMs = resolvePollTimeoutMs(request.rt);
-    operations.set(operationId, {
-      operationId,
-      status: "pending",
-      callId: request.callId,
-      startedAtMs,
-      pollTimeoutMs,
-    });
-
-    void request.rt.manager
-      .continueCall(request.callId, request.message)
-      .then((result) => {
-        const current = operations.get(operationId);
-        if (!current || current.status !== "pending") {
-          return;
-        }
-        if (!result.success) {
-          operations.set(operationId, {
-            operationId,
-            status: "failed",
-            callId: request.callId,
-            startedAtMs,
-            completedAtMs: Date.now(),
-            pollTimeoutMs,
-            error: result.error || "continue failed",
-          });
-          return;
-        }
-        operations.set(operationId, {
-          operationId,
-          status: "completed",
-          callId: request.callId,
-          startedAtMs,
-          completedAtMs: Date.now(),
-          pollTimeoutMs,
-          result: { success: true, transcript: result.transcript },
-        });
-      })
-      .catch((err) => {
-        const current = operations.get(operationId);
-        if (!current || current.status !== "pending") {
-          return;
-        }
-        operations.set(operationId, {
-          operationId,
-          status: "failed",
-          callId: request.callId,
-          startedAtMs,
-          completedAtMs: Date.now(),
-          pollTimeoutMs,
-          error: formatErrorMessage(err),
-        });
-      })
-      .finally(() => {
-        scheduleCleanup(operationId);
-      });
-
-    return { operationId, status: "pending", pollTimeoutMs };
-  };
-
-  const read = (
-    operationId: string,
-  ):
-    | { ok: true; payload: VoiceCallContinueOperationResultPayload }
-    | { ok: false; error: string } => {
-    const operation = operations.get(operationId);
-    if (!operation) {
-      return { ok: false, error: "operation not found" };
-    }
-    if (operation.status === "pending") {
-      return {
-        ok: true,
-        payload: {
-          operationId,
-          status: "pending",
-          pollTimeoutMs: operation.pollTimeoutMs,
-        },
-      };
-    }
-    if (operation.status === "failed") {
-      operations.delete(operationId);
-      return {
-        ok: true,
-        payload: {
-          operationId,
-          status: "failed",
-          error: operation.error,
-        },
-      };
-    }
-    operations.delete(operationId);
-    return {
-      ok: true,
-      payload: {
-        operationId,
-        status: "completed",
-        result: operation.result,
-      },
-    };
-  };
-
-  return { start, read };
-}

package/src/http-headers.test.ts

@@ -1,16 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { getHeader } from "./http-headers.js";
-
-describe("getHeader", () => {
-  it("returns first value when header is an array", () => {
-    expect(getHeader({ "x-test": ["first", "second"] }, "x-test")).toBe("first");
-  });
-
-  it("matches headers case-insensitively", () => {
-    expect(getHeader({ "X-Twilio-Signature": "sig-1" }, "x-twilio-signature")).toBe("sig-1");
-  });
-
-  it("returns undefined for missing header", () => {
-    expect(getHeader({ host: "example.com" }, "x-missing")).toBeUndefined();
-  });
-});

package/src/http-headers.ts

@@ -1,15 +0,0 @@
-import { normalizeLowercaseStringOrEmpty } from "klaw/plugin-sdk/string-coerce-runtime";
-
-type HttpHeaderMap = Record<string, string | string[] | undefined>;
-
-export function getHeader(headers: HttpHeaderMap, name: string): string | undefined {
-  const target = normalizeLowercaseStringOrEmpty(name);
-  const direct = headers[target];
-  const value =
-    direct ??
-    Object.entries(headers).find(([key]) => normalizeLowercaseStringOrEmpty(key) === target)?.[1];
-  if (Array.isArray(value)) {
-    return value[0];
-  }
-  return value;
-}

package/src/manager/context.ts

@@ -1,50 +0,0 @@
-import type { VoiceCallConfig } from "../config.js";
-import type { VoiceCallProvider } from "../providers/base.js";
-import type { CallId, CallRecord } from "../types.js";
-
-type TranscriptWaiter = {
-  resolve: (text: string) => void;
-  reject: (err: Error) => void;
-  timeout: NodeJS.Timeout;
-  turnToken?: string;
-};
-
-type CallManagerRuntimeState = {
-  activeCalls: Map<CallId, CallRecord>;
-  providerCallIdMap: Map<string, CallId>;
-  processedEventIds: Set<string>;
-  /** Provider call IDs we already sent a reject hangup for; avoids duplicate hangup calls. */
-  rejectedProviderCallIds: Set<string>;
-};
-
-type CallManagerRuntimeDeps = {
-  provider: VoiceCallProvider | null;
-  config: VoiceCallConfig;
-  storePath: string;
-  webhookUrl: string | null;
-};
-
-type CallManagerTransientState = {
-  activeTurnCalls: Set<CallId>;
-  transcriptWaiters: Map<CallId, TranscriptWaiter>;
-  maxDurationTimers: Map<CallId, NodeJS.Timeout>;
-  initialMessageInFlight: Set<CallId>;
-};
-
-export type StreamSessionIssuer = (request: {
-  providerName: "twilio" | "telnyx";
-  callId: CallId;
-  from?: string;
-  to?: string;
-  direction: "inbound" | "outbound";
-}) => { token: string; streamUrl: string } | undefined;
-
-type CallManagerHooks = {
-  onCallAnswered?: (call: CallRecord) => void;
-  streamSessionIssuer?: StreamSessionIssuer;
-};
-
-export type CallManagerContext = CallManagerRuntimeState &
-  CallManagerRuntimeDeps &
-  CallManagerTransientState &
-  CallManagerHooks;