@voice-kit/core 0.1.2 → 0.1.3

package/dist/index-D3KfRXMP.d.ts

@@ -1,319 +0,0 @@
-import * as ai from 'ai';
-
-/**
- * @voice-kit/core — Type definitions
- */
-/**
- * A single word with timing information from an STT provider.
- */
-interface WordTimestamp {
-    word: string;
-    startMs: number;
-    endMs: number;
-    confidence: number;
-}
-/**
- * The result of a speech-to-text transcription, either streaming partial
- * or final. `isFinal` distinguishes the two.
- *
- * @example
- * ```ts
- * for await (const result of stt.transcribeStream(audioIterable)) {
- *   if (result.isFinal) console.log('Final:', result.transcript)
- * }
- * ```
- */
-interface STTResult {
-    /** The transcribed text. May be a partial result if `isFinal` is false. */
-    transcript: string;
-    /** Whether this is the final result for this utterance. */
-    isFinal: boolean;
-    /** Confidence score from the provider, 0–1. */
-    confidence: number;
-    /** BCP-47 language tag, e.g. 'hi-IN', 'en-IN'. */
-    language: string;
-    /** True if a mid-sentence language switch was detected (e.g. Hinglish). */
-    languageSwitchDetected: boolean;
-    /** Word-level timestamps if supported by the provider. */
-    words?: WordTimestamp[];
-    /** Time from audio start to this result being emitted, in ms. */
-    latencyMs: number;
-}
-/**
- * Configuration for STT provider instantiation.
- */
-interface STTConfig {
-    /** BCP-47 language code. Defaults to 'en-IN'. */
-    language?: string;
-    /** Additional languages to detect for code-switching. */
-    alternateLanguages?: string[];
-    /** API key. Falls back to provider-specific env var if omitted. */
-    apiKey?: string;
-    /** Custom model name. Provider-specific. */
-    model?: string;
-    /** Enable word-level timestamps. Default false. */
-    wordTimestamps?: boolean;
-    /** Enable interim / partial results. Default true. */
-    interimResults?: boolean;
-    /** Deepgram-specific: smart formatting. Default true. */
-    smartFormat?: boolean;
-    /** Sarvam-specific: region hint. */
-    region?: string;
-}
-/**
- * The STTProvider interface. Obtained via `createSTT()` — never instantiate
- * provider classes directly.
- *
- * @example
- * ```ts
- * const stt = createSTT('deepgram', { language: 'en-IN' })
- * for await (const result of stt.transcribeStream(audioStream)) {
- *   console.log(result.transcript)
- * }
- * ```
- */
-interface STTProvider {
-    /** Stream audio in, stream STTResults out. Primary realtime path. */
-    transcribeStream(audio: AsyncIterable<Buffer>): AsyncIterable<STTResult>;
-    /** Batch transcription for recordings. Returns single final result. */
-    transcribeBatch(audio: Buffer): Promise<STTResult>;
-    /** Whether this provider supports streaming (all except Whisper). */
-    readonly supportsStreaming: boolean;
-    /** BCP-47 codes this provider can handle. */
-    readonly supportedLanguages: string[];
-    /** Human-readable provider name for logging. */
-    readonly name: string;
-}
-/**
- * Configuration for TTS provider instantiation.
- */
-interface TTSConfig {
-    /** Voice identifier. Provider-specific. */
-    voiceId?: string;
-    /** Output sample rate. Defaults to provider native rate. */
-    sampleRate?: number;
-    /** Speaking speed multiplier. Default 1.0. */
-    speed?: number;
-    /** Pitch adjustment. Provider-specific. */
-    pitch?: number;
-    /** API key. Falls back to provider-specific env var if omitted. */
-    apiKey?: string;
-    /** ElevenLabs-specific: model ID. */
-    modelId?: string;
-    /** Cartesia-specific: emotion control. */
-    emotion?: string;
-    /** Sarvam-specific: target language for Indic voices. */
-    targetLanguage?: string;
-}
-/**
- * The TTSProvider interface. Obtained via `createTTS()` — never instantiate
- * provider classes directly.
- *
- * @example
- * ```ts
- * const tts = createTTS('elevenlabs', { voiceId: 'your-voice-id' })
- * for await (const chunk of tts.synthesizeStream('Hello, how can I help?')) {
- *   socket.write(chunk)
- * }
- * ```
- */
-interface TTSProvider {
-    /** Stream synthesis — preferred for realtime. First chunk < 300ms. */
-    synthesizeStream(text: string, config?: TTSConfig): AsyncIterable<Buffer>;
-    /** Synthesize full audio — for pre-recorded prompts or caching. */
-    synthesizeFull(text: string, config?: TTSConfig): Promise<Buffer>;
-    /** Native output sample rate of this provider in Hz. */
-    readonly outputSampleRate: number;
-    /** Native output format before any resampling. */
-    readonly outputFormat: 'pcm' | 'mulaw' | 'opus' | 'mp3';
-    /** Human-readable provider name for logging. */
-    readonly name: string;
-}
-/**
- * A frame of audio classified by the VAD engine.
- * Developers subscribe to these events — never to raw VAD API.
- */
-interface VoiceFrame {
-    /** Event type. */
-    type: 'speech_start' | 'speech_end' | 'speech';
-    /** VAD confidence 0–1. */
-    confidence: number;
-    /** Raw PCM audio bytes for this frame. */
-    audioBuffer: Buffer;
-    /** Duration of audio in this frame, in ms. */
-    durationMs: number;
-}
-/**
- * Configuration for the VAD engine.
- */
-interface VADConfig {
-    /** Activation threshold 0–1. Default 0.6. */
-    threshold?: number;
-    /** Consecutive positive frames before speech_start. Default 3. */
-    positiveSpeechFrames?: number;
-    /** Consecutive negative frames before speech_end. Default 5. */
-    negativeSpeechFrames?: number;
-    /** Debounce window in ms to prevent rapid flip-flop. Default 150. */
-    debounceMs?: number;
-    /** Input sample rate. Auto-set by AudioPipeline — do not override. */
-    sampleRate?: number;
-}
-/**
- * Configuration for call memory (LRU-backed sliding window of turns).
- */
-interface CallMemoryConfig {
-    /** Maximum number of turns to retain. Default 20. */
-    maxTurns?: number;
-    /** Maximum bytes of conversation history to retain. Default 512KB. */
-    maxBytes?: number;
-    /** TTL for the entire call memory entry in ms. Default 30 minutes. */
-    ttlMs?: number;
-}
-/**
- * In-process LRU-backed call memory. Obtained via `createCallMemory()`.
- *
- * @example
- * ```ts
- * const memory = createCallMemory({ maxTurns: 20 })
- * memory.addTurn(callId, { role: 'user', content: 'Hello' })
- * const history = memory.getTurns(callId)
- * ```
- */
-interface CallMemory {
-    addTurn(callId: string, message: ai.ModelMessage): void;
-    getTurns(callId: string): ai.ModelMessage[];
-    clearCall(callId: string): void;
-    getTokenEstimate(callId: string): number;
-    /** Truncate oldest turns to stay within budget. */
-    trimToTokenBudget(callId: string, maxTokens: number): void;
-}
-/**
- * Type of call for TRAI DND classification.
- */
-type CallPurpose = 'TRANSACTIONAL' | 'PROMOTIONAL' | 'SERVICE' | 'EMERGENCY';
-/**
- * TRAI DNC check parameters.
- */
-interface DNCCheckParams {
-    /** E.164 format phone number, validated via libphonenumber-js. */
-    to: string;
-    /** Purpose category for TRAI classification. */
-    purpose: CallPurpose;
-    /** Scheduled call time. Defaults to now. */
-    scheduledAt?: Date;
-}
-/**
- * Result of a TRAI DNC check.
- */
-interface DNCCheckResult {
-    /** Whether the call is permitted. */
-    allowed: boolean;
-    /** Human-readable reason if not allowed. */
-    reason?: string;
-    /** When this result was fetched (from LRU cache). */
-    cachedAt?: Date;
-    /** Whether result came from local LRU cache. */
-    fromCache: boolean;
-}
-/**
- * Consent record stored for TRAI compliance.
- */
-interface ConsentRecord {
-    phoneNumber: string;
-    consentedAt: Date;
-    /** Channel through which consent was obtained. */
-    channel: 'voice' | 'sms' | 'web' | 'ivr';
-    /** Call purpose consent was given for. */
-    purpose: CallPurpose;
-    /** Optional reference ID (e.g. recording URL). */
-    referenceId?: string;
-}
-/**
- * TRAI compliance configuration.
- */
-interface TRAIConfig {
-    /** Disable TRAI checks entirely. Default false. */
-    disabled?: boolean;
-    /** Calling timezone override. Default 'Asia/Kolkata'. */
-    timezone?: string;
-    /** Override calling hours start (24h). Default 9. */
-    callingHoursStart?: number;
-    /** Override calling hours end (24h). Default 21. */
-    callingHoursEnd?: number;
-    /** Custom DNC API endpoint. Default: mock endpoint (must be replaced in production). */
-    dncApiEndpoint?: string;
-}
-/**
- * Aggregated metrics for a completed or in-progress call.
- */
-interface CallMetricsSummary {
-    callId: string;
-    sttFirstByteMs: number[];
-    ttsFirstByteMs: number[];
-    llmFirstTokenMs: number[];
-    turnLatencyMs: number[];
-    interruptionCount: number;
-    interruptionPositions: number[];
-    tokenCost: {
-        model: string;
-        inputTokens: number;
-        outputTokens: number;
-        estimatedUsdCost: number;
-    }[];
-    avgTurnLatencyMs: number;
-    p95TurnLatencyMs: number;
-}
-/**
- * Error severity level.
- */
-type ErrorSeverity = 'low' | 'medium' | 'high' | 'critical';
-/**
- * Base error context shared by all VoiceKit errors.
- */
-interface VoiceKitErrorContext {
-    /** Error code for programmatic handling. */
-    code: string;
-    /** Associated call ID if applicable. */
-    callId?: string;
-    /** The provider that threw (e.g. 'deepgram', 'elevenlabs'). */
-    provider?: string;
-    /** Whether this error is safe to retry. */
-    retryable: boolean;
-    /** Severity for alerting/logging. */
-    severity: ErrorSeverity;
-    /** Original upstream error if wrapping. */
-    cause?: unknown;
-}
-/**
- * Create an STT provider instance. This is the ONLY public API for STT.
- * Never instantiate provider classes directly.
- *
- * @example
- * ```ts
- * const stt = createSTT('deepgram', { language: 'hi-IN' })
- * const stt2 = createSTT('sarvam', { language: 'ta-IN' })
- * ```
- */
-declare function createSTT(provider: 'deepgram' | 'whisper' | 'assemblyai' | 'sarvam', config?: STTConfig): STTProvider;
-/**
- * Create a TTS provider instance. This is the ONLY public API for TTS.
- * Never instantiate provider classes directly.
- *
- * @example
- * ```ts
- * const tts = createTTS('elevenlabs', { voiceId: 'your-voice-id' })
- * const tts2 = createTTS('sarvam', { targetLanguage: 'hi-IN' })
- * ```
- */
-declare function createTTS(provider: 'elevenlabs' | 'cartesia' | 'sarvam', config?: TTSConfig): TTSProvider;
-/**
- * Create an LRU-backed call memory instance.
- *
- * @example
- * ```ts
- * const memory = createCallMemory({ maxTurns: 20, maxBytes: 512_000 })
- * ```
- */
-declare function createCallMemory(config?: CallMemoryConfig): CallMemory;
-
-export { type CallMemoryConfig as C, type DNCCheckParams as D, type ErrorSeverity as E, type STTProvider as S, type TRAIConfig as T, type VADConfig as V, type WordTimestamp as W, type CallMemory as a, type DNCCheckResult as b, type ConsentRecord as c, type CallMetricsSummary as d, type TTSProvider as e, type TTSConfig as f, type VoiceFrame as g, type STTConfig as h, type STTResult as i, type CallPurpose as j, type VoiceKitErrorContext as k, createCallMemory as l, createSTT as m, createTTS as n };

package/dist/memory.cjs

@@ -1,121 +0,0 @@
-'use strict';
-
-var lruCache = require('lru-cache');
-var pino = require('pino');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var pino__default = /*#__PURE__*/_interopDefault(pino);
-
-// src/memory/lru-cache/index.ts
-var logger = pino__default.default({ name: "@voice-kit/core:memory" });
-var DEFAULTS = {
-  maxTurns: 20,
-  maxBytes: 512e3,
-  // 512KB
-  ttlMs: 30 * 6e4
-  // 30 minutes
-};
-function estimateTokens(messages) {
-  let chars = 0;
-  for (const msg of messages) {
-    const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
-    chars += content.length;
-  }
-  return Math.ceil(chars / 4);
-}
-function estimateBytes(messages) {
-  return JSON.stringify(messages).length;
-}
-var LRUCallMemory = class {
-  cache;
-  config;
-  constructor(config) {
-    this.config = config;
-    this.cache = new lruCache.LRUCache({
-      max: 1e3,
-      // max concurrent calls in memory
-      ttl: config.ttlMs,
-      updateAgeOnGet: true
-      // reset TTL on access (active calls stay warm)
-    });
-  }
-  /**
-   * Add a turn to the call's conversation window.
-   * Automatically trims oldest turns when maxTurns or maxBytes is exceeded.
-   *
-   * @param callId   The call identifier
-   * @param message  ModelMessage to append
-   */
-  addTurn(callId, message) {
-    const existing = this.cache.get(callId) ?? [];
-    const updated = [...existing, message];
-    const trimmed = updated.length > this.config.maxTurns ? updated.slice(updated.length - this.config.maxTurns) : updated;
-    let bytesTrimmed = trimmed;
-    while (bytesTrimmed.length > 1 && estimateBytes(bytesTrimmed) > this.config.maxBytes) {
-      bytesTrimmed = bytesTrimmed.slice(1);
-    }
-    this.cache.set(callId, bytesTrimmed);
-    logger.debug(
-      { callId, turns: bytesTrimmed.length, bytes: estimateBytes(bytesTrimmed) },
-      "Memory: turn added"
-    );
-  }
-  /**
-   * Get all turns for a call.
-   *
-   * @param callId  The call identifier
-   * @returns       Array of ModelMessage (empty if call not found)
-   */
-  getTurns(callId) {
-    return this.cache.get(callId) ?? [];
-  }
-  /**
-   * Clear all turns for a call. Call this on call.ended to free memory.
-   *
-   * @param callId  The call identifier
-   */
-  clearCall(callId) {
-    this.cache.delete(callId);
-    logger.debug({ callId }, "Memory: call cleared");
-  }
-  /**
-   * Estimate the number of LLM tokens used by a call's history.
-   *
-   * @param callId  The call identifier
-   */
-  getTokenEstimate(callId) {
-    const messages = this.cache.get(callId) ?? [];
-    return estimateTokens(messages);
-  }
-  /**
-   * Trim oldest turns to stay within a token budget.
-   * Called by VoiceAgent before each LLM call to prevent context overflow.
-   *
-   * @param callId     The call identifier
-   * @param maxTokens  Maximum tokens to retain
-   */
-  trimToTokenBudget(callId, maxTokens) {
-    let messages = this.cache.get(callId) ?? [];
-    while (messages.length > 1 && estimateTokens(messages) > maxTokens) {
-      messages = messages.slice(1);
-    }
-    this.cache.set(callId, messages);
-    logger.debug(
-      { callId, turns: messages.length, estimatedTokens: estimateTokens(messages) },
-      "Memory: trimmed to token budget"
-    );
-  }
-};
-function createCallMemory(config) {
-  const merged = {
-    maxTurns: config?.maxTurns ?? DEFAULTS.maxTurns,
-    maxBytes: config?.maxBytes ?? DEFAULTS.maxBytes,
-    ttlMs: config?.ttlMs ?? DEFAULTS.ttlMs
-  };
-  return new LRUCallMemory(merged);
-}
-
-exports.createCallMemory = createCallMemory;
-//# sourceMappingURL=memory.cjs.map
-//# sourceMappingURL=memory.cjs.map

package/dist/memory.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/memory/lru-cache/index.ts"],"names":["pino","LRUCache"],"mappings":"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","file":"memory.cjs","sourcesContent":["/**\r\n * @voice-kit/core — LRU-backed call memory\r\n *\r\n * Provides a sliding window of conversation turns per call.\r\n * Uses lru-cache for bounded in-process storage — no Redis, no DB.\r\n * Every cache has explicit max size and TTL to prevent unbounded growth.\r\n */\r\n\r\nimport { LRUCache } from 'lru-cache'\r\nimport type { ModelMessage } from 'ai'\r\nimport type { CallMemory, CallMemoryConfig } from '../../types'\r\nimport pino from 'pino'\r\n\r\nconst logger = pino({ name: '@voice-kit/core:memory' })\r\n\r\nconst DEFAULTS: Required<CallMemoryConfig> = {\r\n    maxTurns: 20,\r\n    maxBytes: 512_000,   // 512KB\r\n    ttlMs: 30 * 60_000,  // 30 minutes\r\n}\r\n\r\n/** Rough token estimate: 1 token ≈ 4 chars */\r\nfunction estimateTokens(messages: ModelMessage[]): number {\r\n    let chars = 0\r\n    for (const msg of messages) {\r\n        const content = typeof msg.content === 'string'\r\n            ? msg.content\r\n            : JSON.stringify(msg.content)\r\n        chars += content.length\r\n    }\r\n    return Math.ceil(chars / 4)\r\n}\r\n\r\n/** Rough byte size of messages array */\r\nfunction estimateBytes(messages: ModelMessage[]): number {\r\n    return JSON.stringify(messages).length\r\n}\r\n\r\n/**\r\n * LRU-backed call memory. Maintains a sliding window of ModelMessage[]\r\n * per callId with automatic eviction.\r\n *\r\n * @internal — obtained via createCallMemory()\r\n */\r\nclass LRUCallMemory implements CallMemory {\r\n    private readonly cache: LRUCache<string, ModelMessage[]>\r\n    private readonly config: Required<CallMemoryConfig>\r\n\r\n    constructor(config: Required<CallMemoryConfig>) {\r\n        this.config = config\r\n        this.cache = new LRUCache<string, ModelMessage[]>({\r\n            max: 1_000,          // max concurrent calls in memory\r\n            ttl: config.ttlMs,\r\n            updateAgeOnGet: true, // reset TTL on access (active calls stay warm)\r\n        })\r\n    }\r\n\r\n    /**\r\n     * Add a turn to the call's conversation window.\r\n     * Automatically trims oldest turns when maxTurns or maxBytes is exceeded.\r\n     *\r\n     * @param callId   The call identifier\r\n     * @param message  ModelMessage to append\r\n     */\r\n    addTurn(callId: string, message: ModelMessage): void {\r\n        const existing = this.cache.get(callId) ?? []\r\n        const updated = [...existing, message]\r\n\r\n        // Trim to maxTurns\r\n        const trimmed = updated.length > this.config.maxTurns\r\n            ? updated.slice(updated.length - this.config.maxTurns)\r\n            : updated\r\n\r\n        // Trim to maxBytes\r\n        let bytesTrimmed = trimmed\r\n        while (bytesTrimmed.length > 1 && estimateBytes(bytesTrimmed) > this.config.maxBytes) {\r\n            bytesTrimmed = bytesTrimmed.slice(1) // Remove oldest turn\r\n        }\r\n\r\n        this.cache.set(callId, bytesTrimmed)\r\n\r\n        logger.debug(\r\n            { callId, turns: bytesTrimmed.length, bytes: estimateBytes(bytesTrimmed) },\r\n            'Memory: turn added'\r\n        )\r\n    }\r\n\r\n    /**\r\n     * Get all turns for a call.\r\n     *\r\n     * @param callId  The call identifier\r\n     * @returns       Array of ModelMessage (empty if call not found)\r\n     */\r\n    getTurns(callId: string): ModelMessage[] {\r\n        return this.cache.get(callId) ?? []\r\n    }\r\n\r\n    /**\r\n     * Clear all turns for a call. Call this on call.ended to free memory.\r\n     *\r\n     * @param callId  The call identifier\r\n     */\r\n    clearCall(callId: string): void {\r\n        this.cache.delete(callId)\r\n        logger.debug({ callId }, 'Memory: call cleared')\r\n    }\r\n\r\n    /**\r\n     * Estimate the number of LLM tokens used by a call's history.\r\n     *\r\n     * @param callId  The call identifier\r\n     */\r\n    getTokenEstimate(callId: string): number {\r\n        const messages = this.cache.get(callId) ?? []\r\n        return estimateTokens(messages)\r\n    }\r\n\r\n    /**\r\n     * Trim oldest turns to stay within a token budget.\r\n     * Called by VoiceAgent before each LLM call to prevent context overflow.\r\n     *\r\n     * @param callId     The call identifier\r\n     * @param maxTokens  Maximum tokens to retain\r\n     */\r\n    trimToTokenBudget(callId: string, maxTokens: number): void {\r\n        let messages = this.cache.get(callId) ?? []\r\n\r\n        while (messages.length > 1 && estimateTokens(messages) > maxTokens) {\r\n            messages = messages.slice(1)\r\n        }\r\n\r\n        this.cache.set(callId, messages)\r\n\r\n        logger.debug(\r\n            { callId, turns: messages.length, estimatedTokens: estimateTokens(messages) },\r\n            'Memory: trimmed to token budget'\r\n        )\r\n    }\r\n}\r\n\r\n/**\r\n * Create an LRU-backed call memory instance.\r\n * This is the ONLY in-process memory system in the SDK.\r\n *\r\n * @param config  Memory configuration\r\n *\r\n * @example\r\n * ```ts\r\n * // Default: 20 turns, 512KB, 30min TTL\r\n * const memory = createCallMemory()\r\n *\r\n * // Custom\r\n * const memory = createCallMemory({ maxTurns: 30, maxBytes: 1_000_000 })\r\n * ```\r\n */\r\nexport function createCallMemory(config?: CallMemoryConfig): CallMemory {\r\n    const merged: Required<CallMemoryConfig> = {\r\n        maxTurns: config?.maxTurns ?? DEFAULTS.maxTurns,\r\n        maxBytes: config?.maxBytes ?? DEFAULTS.maxBytes,\r\n        ttlMs: config?.ttlMs ?? DEFAULTS.ttlMs,\r\n    }\r\n    return new LRUCallMemory(merged)\r\n}"]}

package/dist/memory.d.cts

@@ -1,29 +0,0 @@
-import { C as CallMemoryConfig, a as CallMemory } from './index-D3KfRXMP.cjs';
-import 'ai';
-
-/**
- * @voice-kit/core — LRU-backed call memory
- *
- * Provides a sliding window of conversation turns per call.
- * Uses lru-cache for bounded in-process storage — no Redis, no DB.
- * Every cache has explicit max size and TTL to prevent unbounded growth.
- */
-
-/**
- * Create an LRU-backed call memory instance.
- * This is the ONLY in-process memory system in the SDK.
- *
- * @param config  Memory configuration
- *
- * @example
- * ```ts
- * // Default: 20 turns, 512KB, 30min TTL
- * const memory = createCallMemory()
- *
- * // Custom
- * const memory = createCallMemory({ maxTurns: 30, maxBytes: 1_000_000 })
- * ```
- */
-declare function createCallMemory(config?: CallMemoryConfig): CallMemory;
-
-export { createCallMemory };

package/dist/memory.d.ts

@@ -1,29 +0,0 @@
-import { C as CallMemoryConfig, a as CallMemory } from './index-D3KfRXMP.js';
-import 'ai';
-
-/**
- * @voice-kit/core — LRU-backed call memory
- *
- * Provides a sliding window of conversation turns per call.
- * Uses lru-cache for bounded in-process storage — no Redis, no DB.
- * Every cache has explicit max size and TTL to prevent unbounded growth.
- */
-
-/**
- * Create an LRU-backed call memory instance.
- * This is the ONLY in-process memory system in the SDK.
- *
- * @param config  Memory configuration
- *
- * @example
- * ```ts
- * // Default: 20 turns, 512KB, 30min TTL
- * const memory = createCallMemory()
- *
- * // Custom
- * const memory = createCallMemory({ maxTurns: 30, maxBytes: 1_000_000 })
- * ```
- */
-declare function createCallMemory(config?: CallMemoryConfig): CallMemory;
-
-export { createCallMemory };

package/dist/memory.js

@@ -1,115 +0,0 @@
-import { LRUCache } from 'lru-cache';
-import pino from 'pino';
-
-// src/memory/lru-cache/index.ts
-var logger = pino({ name: "@voice-kit/core:memory" });
-var DEFAULTS = {
-  maxTurns: 20,
-  maxBytes: 512e3,
-  // 512KB
-  ttlMs: 30 * 6e4
-  // 30 minutes
-};
-function estimateTokens(messages) {
-  let chars = 0;
-  for (const msg of messages) {
-    const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
-    chars += content.length;
-  }
-  return Math.ceil(chars / 4);
-}
-function estimateBytes(messages) {
-  return JSON.stringify(messages).length;
-}
-var LRUCallMemory = class {
-  cache;
-  config;
-  constructor(config) {
-    this.config = config;
-    this.cache = new LRUCache({
-      max: 1e3,
-      // max concurrent calls in memory
-      ttl: config.ttlMs,
-      updateAgeOnGet: true
-      // reset TTL on access (active calls stay warm)
-    });
-  }
-  /**
-   * Add a turn to the call's conversation window.
-   * Automatically trims oldest turns when maxTurns or maxBytes is exceeded.
-   *
-   * @param callId   The call identifier
-   * @param message  ModelMessage to append
-   */
-  addTurn(callId, message) {
-    const existing = this.cache.get(callId) ?? [];
-    const updated = [...existing, message];
-    const trimmed = updated.length > this.config.maxTurns ? updated.slice(updated.length - this.config.maxTurns) : updated;
-    let bytesTrimmed = trimmed;
-    while (bytesTrimmed.length > 1 && estimateBytes(bytesTrimmed) > this.config.maxBytes) {
-      bytesTrimmed = bytesTrimmed.slice(1);
-    }
-    this.cache.set(callId, bytesTrimmed);
-    logger.debug(
-      { callId, turns: bytesTrimmed.length, bytes: estimateBytes(bytesTrimmed) },
-      "Memory: turn added"
-    );
-  }
-  /**
-   * Get all turns for a call.
-   *
-   * @param callId  The call identifier
-   * @returns       Array of ModelMessage (empty if call not found)
-   */
-  getTurns(callId) {
-    return this.cache.get(callId) ?? [];
-  }
-  /**
-   * Clear all turns for a call. Call this on call.ended to free memory.
-   *
-   * @param callId  The call identifier
-   */
-  clearCall(callId) {
-    this.cache.delete(callId);
-    logger.debug({ callId }, "Memory: call cleared");
-  }
-  /**
-   * Estimate the number of LLM tokens used by a call's history.
-   *
-   * @param callId  The call identifier
-   */
-  getTokenEstimate(callId) {
-    const messages = this.cache.get(callId) ?? [];
-    return estimateTokens(messages);
-  }
-  /**
-   * Trim oldest turns to stay within a token budget.
-   * Called by VoiceAgent before each LLM call to prevent context overflow.
-   *
-   * @param callId     The call identifier
-   * @param maxTokens  Maximum tokens to retain
-   */
-  trimToTokenBudget(callId, maxTokens) {
-    let messages = this.cache.get(callId) ?? [];
-    while (messages.length > 1 && estimateTokens(messages) > maxTokens) {
-      messages = messages.slice(1);
-    }
-    this.cache.set(callId, messages);
-    logger.debug(
-      { callId, turns: messages.length, estimatedTokens: estimateTokens(messages) },
-      "Memory: trimmed to token budget"
-    );
-  }
-};
-function createCallMemory(config) {
-  const merged = {
-    maxTurns: config?.maxTurns ?? DEFAULTS.maxTurns,
-    maxBytes: config?.maxBytes ?? DEFAULTS.maxBytes,
-    ttlMs: config?.ttlMs ?? DEFAULTS.ttlMs
-  };
-  return new LRUCallMemory(merged);
-}
-
-export { createCallMemory };
-//# sourceMappingURL=memory.js.map
-//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/memory/lru-cache/index.ts"],"names":[],"mappings":"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","file":"memory.js","sourcesContent":["/**\r\n * @voice-kit/core — LRU-backed call memory\r\n *\r\n * Provides a sliding window of conversation turns per call.\r\n * Uses lru-cache for bounded in-process storage — no Redis, no DB.\r\n * Every cache has explicit max size and TTL to prevent unbounded growth.\r\n */\r\n\r\nimport { LRUCache } from 'lru-cache'\r\nimport type { ModelMessage } from 'ai'\r\nimport type { CallMemory, CallMemoryConfig } from '../../types'\r\nimport pino from 'pino'\r\n\r\nconst logger = pino({ name: '@voice-kit/core:memory' })\r\n\r\nconst DEFAULTS: Required<CallMemoryConfig> = {\r\n    maxTurns: 20,\r\n    maxBytes: 512_000,   // 512KB\r\n    ttlMs: 30 * 60_000,  // 30 minutes\r\n}\r\n\r\n/** Rough token estimate: 1 token ≈ 4 chars */\r\nfunction estimateTokens(messages: ModelMessage[]): number {\r\n    let chars = 0\r\n    for (const msg of messages) {\r\n        const content = typeof msg.content === 'string'\r\n            ? msg.content\r\n            : JSON.stringify(msg.content)\r\n        chars += content.length\r\n    }\r\n    return Math.ceil(chars / 4)\r\n}\r\n\r\n/** Rough byte size of messages array */\r\nfunction estimateBytes(messages: ModelMessage[]): number {\r\n    return JSON.stringify(messages).length\r\n}\r\n\r\n/**\r\n * LRU-backed call memory. Maintains a sliding window of ModelMessage[]\r\n * per callId with automatic eviction.\r\n *\r\n * @internal — obtained via createCallMemory()\r\n */\r\nclass LRUCallMemory implements CallMemory {\r\n    private readonly cache: LRUCache<string, ModelMessage[]>\r\n    private readonly config: Required<CallMemoryConfig>\r\n\r\n    constructor(config: Required<CallMemoryConfig>) {\r\n        this.config = config\r\n        this.cache = new LRUCache<string, ModelMessage[]>({\r\n            max: 1_000,          // max concurrent calls in memory\r\n            ttl: config.ttlMs,\r\n            updateAgeOnGet: true, // reset TTL on access (active calls stay warm)\r\n        })\r\n    }\r\n\r\n    /**\r\n     * Add a turn to the call's conversation window.\r\n     * Automatically trims oldest turns when maxTurns or maxBytes is exceeded.\r\n     *\r\n     * @param callId   The call identifier\r\n     * @param message  ModelMessage to append\r\n     */\r\n    addTurn(callId: string, message: ModelMessage): void {\r\n        const existing = this.cache.get(callId) ?? []\r\n        const updated = [...existing, message]\r\n\r\n        // Trim to maxTurns\r\n        const trimmed = updated.length > this.config.maxTurns\r\n            ? updated.slice(updated.length - this.config.maxTurns)\r\n            : updated\r\n\r\n        // Trim to maxBytes\r\n        let bytesTrimmed = trimmed\r\n        while (bytesTrimmed.length > 1 && estimateBytes(bytesTrimmed) > this.config.maxBytes) {\r\n            bytesTrimmed = bytesTrimmed.slice(1) // Remove oldest turn\r\n        }\r\n\r\n        this.cache.set(callId, bytesTrimmed)\r\n\r\n        logger.debug(\r\n            { callId, turns: bytesTrimmed.length, bytes: estimateBytes(bytesTrimmed) },\r\n            'Memory: turn added'\r\n        )\r\n    }\r\n\r\n    /**\r\n     * Get all turns for a call.\r\n     *\r\n     * @param callId  The call identifier\r\n     * @returns       Array of ModelMessage (empty if call not found)\r\n     */\r\n    getTurns(callId: string): ModelMessage[] {\r\n        return this.cache.get(callId) ?? []\r\n    }\r\n\r\n    /**\r\n     * Clear all turns for a call. Call this on call.ended to free memory.\r\n     *\r\n     * @param callId  The call identifier\r\n     */\r\n    clearCall(callId: string): void {\r\n        this.cache.delete(callId)\r\n        logger.debug({ callId }, 'Memory: call cleared')\r\n    }\r\n\r\n    /**\r\n     * Estimate the number of LLM tokens used by a call's history.\r\n     *\r\n     * @param callId  The call identifier\r\n     */\r\n    getTokenEstimate(callId: string): number {\r\n        const messages = this.cache.get(callId) ?? []\r\n        return estimateTokens(messages)\r\n    }\r\n\r\n    /**\r\n     * Trim oldest turns to stay within a token budget.\r\n     * Called by VoiceAgent before each LLM call to prevent context overflow.\r\n     *\r\n     * @param callId     The call identifier\r\n     * @param maxTokens  Maximum tokens to retain\r\n     */\r\n    trimToTokenBudget(callId: string, maxTokens: number): void {\r\n        let messages = this.cache.get(callId) ?? []\r\n\r\n        while (messages.length > 1 && estimateTokens(messages) > maxTokens) {\r\n            messages = messages.slice(1)\r\n        }\r\n\r\n        this.cache.set(callId, messages)\r\n\r\n        logger.debug(\r\n            { callId, turns: messages.length, estimatedTokens: estimateTokens(messages) },\r\n            'Memory: trimmed to token budget'\r\n        )\r\n    }\r\n}\r\n\r\n/**\r\n * Create an LRU-backed call memory instance.\r\n * This is the ONLY in-process memory system in the SDK.\r\n *\r\n * @param config  Memory configuration\r\n *\r\n * @example\r\n * ```ts\r\n * // Default: 20 turns, 512KB, 30min TTL\r\n * const memory = createCallMemory()\r\n *\r\n * // Custom\r\n * const memory = createCallMemory({ maxTurns: 30, maxBytes: 1_000_000 })\r\n * ```\r\n */\r\nexport function createCallMemory(config?: CallMemoryConfig): CallMemory {\r\n    const merged: Required<CallMemoryConfig> = {\r\n        maxTurns: config?.maxTurns ?? DEFAULTS.maxTurns,\r\n        maxBytes: config?.maxBytes ?? DEFAULTS.maxBytes,\r\n        ttlMs: config?.ttlMs ?? DEFAULTS.ttlMs,\r\n    }\r\n    return new LRUCallMemory(merged)\r\n}"]}