@voice-kit/core 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -1,4 +1,284 @@
 'use strict';
 
+// src/errors/base.ts
+var VoiceKitError = class extends Error {
+  code;
+  callId;
+  provider;
+  retryable;
+  severity;
+  cause;
+  constructor(params) {
+    super(params.message);
+    this.name = this.constructor.name;
+    this.code = params.code;
+    this.callId = params.callId;
+    this.provider = params.provider;
+    this.retryable = params.retryable ?? false;
+    this.severity = params.severity ?? "medium";
+    this.cause = params.cause;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      callId: this.callId,
+      provider: this.provider,
+      retryable: this.retryable,
+      severity: this.severity
+    };
+  }
+};
+
+// src/errors/agents.errors.ts
+var AgentError = class extends VoiceKitError {
+};
+var TurnTransitionError = class extends AgentError {
+  fromState;
+  event;
+  constructor(fromState, toEvent, callId) {
+    super({
+      code: "AGENT_INVALID_TURN_TRANSITION",
+      message: `Invalid turn transition: state '${fromState}' cannot handle event '${toEvent}'`,
+      callId,
+      retryable: false,
+      severity: "medium"
+    });
+    this.fromState = fromState;
+    this.event = toEvent;
+  }
+};
+var AgentHandoffError = class extends AgentError {
+  constructor(capability, cause, callId) {
+    super({
+      code: "AGENT_HANDOFF_FAILED",
+      message: `Handoff to '${capability}' agent failed`,
+      callId,
+      retryable: true,
+      severity: "high",
+      cause
+    });
+  }
+};
+
+// src/errors/compliance.ts
+var ComplianceError = class extends VoiceKitError {
+  phoneNumber;
+  constructor(params) {
+    super({ ...params, provider: "trai" });
+    this.phoneNumber = params.phoneNumber;
+  }
+};
+var DNCBlockedError = class extends ComplianceError {
+  constructor(phoneNumber, callId) {
+    super({
+      code: "COMPLIANCE_DNC_BLOCKED",
+      message: `Number ${phoneNumber} is on DNC registry \u2014 call blocked`,
+      callId,
+      phoneNumber,
+      retryable: false,
+      severity: "low"
+    });
+  }
+};
+var CallingHoursError = class extends ComplianceError {
+  constructor(phoneNumber, currentTime, callId) {
+    super({
+      code: "COMPLIANCE_OUTSIDE_CALLING_HOURS",
+      message: `Call to ${phoneNumber} blocked \u2014 outside TRAI calling hours (current: ${currentTime} IST)`,
+      callId,
+      phoneNumber,
+      retryable: false,
+      severity: "low"
+    });
+  }
+};
+var ConsentMissingError = class extends ComplianceError {
+  constructor(phoneNumber, callId) {
+    super({
+      code: "COMPLIANCE_CONSENT_MISSING",
+      message: `No valid consent on record for ${phoneNumber}`,
+      callId,
+      phoneNumber,
+      retryable: false,
+      severity: "medium"
+    });
+  }
+};
+
+// src/errors/inngest.errors.ts
+var InngestError = class extends VoiceKitError {
+  taskName;
+  constructor(params) {
+    super({
+      ...params,
+      provider: "inngest",
+      retryable: true,
+      severity: "medium"
+    });
+    this.taskName = params.taskName;
+  }
+};
+
+// src/errors/stt.errors.ts
+var STTError = class extends VoiceKitError {
+  languageCode;
+  constructor(params) {
+    super(params);
+    this.languageCode = params.languageCode;
+  }
+};
+var STTConnectionError = class extends STTError {
+  constructor(provider, cause, callId) {
+    super({
+      code: "STT_CONNECTION_FAILED",
+      message: `Failed to connect to ${provider} STT service`,
+      provider,
+      callId,
+      retryable: true,
+      severity: "high",
+      cause
+    });
+  }
+};
+var STTStreamError = class extends STTError {
+  constructor(provider, cause, callId) {
+    super({
+      code: "STT_STREAM_ERROR",
+      message: `STT stream error from ${provider}`,
+      provider,
+      callId,
+      retryable: true,
+      severity: "medium",
+      cause
+    });
+  }
+};
+var STTLanguageNotSupportedError = class extends STTError {
+  constructor(provider, language) {
+    super({
+      code: "STT_LANGUAGE_NOT_SUPPORTED",
+      message: `Language '${language}' is not supported by ${provider}`,
+      provider,
+      retryable: false,
+      severity: "low",
+      languageCode: language
+    });
+  }
+};
+
+// src/errors/telephony.errors.ts
+var TelephonyError = class extends VoiceKitError {
+  to;
+  from;
+  constructor(params) {
+    super(params);
+    this.to = params.to;
+    this.from = params.from;
+  }
+};
+var CallConnectionError = class extends TelephonyError {
+  constructor(provider, to, cause) {
+    super({
+      code: "CALL_CONNECTION_FAILED",
+      message: `Failed to connect call to ${to} via ${provider}`,
+      provider,
+      to,
+      retryable: true,
+      severity: "high",
+      cause
+    });
+  }
+};
+var CallNotFoundError = class extends TelephonyError {
+  constructor(callId, provider) {
+    super({
+      code: "CALL_NOT_FOUND",
+      message: `Call '${callId}' not found on ${provider}`,
+      callId,
+      provider,
+      retryable: false,
+      severity: "low"
+    });
+  }
+};
+var AudioTransportError = class extends TelephonyError {
+  constructor(provider, cause, callId) {
+    super({
+      code: "AUDIO_TRANSPORT_ERROR",
+      message: `Audio transport error on ${provider}`,
+      provider,
+      callId,
+      retryable: true,
+      severity: "high",
+      cause
+    });
+  }
+};
+
+// src/errors/tts.errors.ts
+var TTSError = class extends VoiceKitError {
+};
+var TTSConnectionError = class extends TTSError {
+  constructor(provider, cause, callId) {
+    super({
+      code: "TTS_CONNECTION_FAILED",
+      message: `Failed to connect to ${provider} TTS service`,
+      provider,
+      callId,
+      retryable: true,
+      severity: "high",
+      cause
+    });
+  }
+};
+var TTSStreamError = class extends TTSError {
+  constructor(provider, cause, callId) {
+    super({
+      code: "TTS_STREAM_ERROR",
+      message: `TTS stream error from ${provider}`,
+      provider,
+      callId,
+      retryable: true,
+      severity: "medium",
+      cause
+    });
+  }
+};
+var TTSVoiceNotFoundError = class extends TTSError {
+  constructor(provider, voiceId) {
+    super({
+      code: "TTS_VOICE_NOT_FOUND",
+      message: `Voice '${voiceId}' not found on ${provider}`,
+      provider,
+      retryable: false,
+      severity: "low"
+    });
+  }
+};
+
+exports.AgentError = AgentError;
+exports.AgentHandoffError = AgentHandoffError;
+exports.AudioTransportError = AudioTransportError;
+exports.CallConnectionError = CallConnectionError;
+exports.CallNotFoundError = CallNotFoundError;
+exports.CallingHoursError = CallingHoursError;
+exports.ComplianceError = ComplianceError;
+exports.ConsentMissingError = ConsentMissingError;
+exports.DNCBlockedError = DNCBlockedError;
+exports.InngestError = InngestError;
+exports.STTConnectionError = STTConnectionError;
+exports.STTError = STTError;
+exports.STTLanguageNotSupportedError = STTLanguageNotSupportedError;
+exports.STTStreamError = STTStreamError;
+exports.TTSConnectionError = TTSConnectionError;
+exports.TTSError = TTSError;
+exports.TTSStreamError = TTSStreamError;
+exports.TTSVoiceNotFoundError = TTSVoiceNotFoundError;
+exports.TelephonyError = TelephonyError;
+exports.TurnTransitionError = TurnTransitionError;
+exports.VoiceKitError = VoiceKitError;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"sources":["../src/errors/base.ts","../src/errors/agents.errors.ts","../src/errors/compliance.ts","../src/errors/inngest.errors.ts","../src/errors/stt.errors.ts","../src/errors/telephony.errors.ts","../src/errors/tts.errors.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * @voice-kit/core — Typed error hierarchy\r\n *\r\n * All VoiceKit errors extend VoiceKitError. Never throw raw Error.\r\n * Every error carries: code, message, provider, callId, retryable, severity.\r\n */\r\n\r\nimport type { ErrorSeverity } from '../types'\r\n\r\n// ─── Base Error ───────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Base class for all VoiceKit errors. Provides structured context for\r\n * logging, alerting, and programmatic error handling.\r\n *\r\n * @example\r\n * ```ts\r\n * try {\r\n *   await stt.transcribeBatch(audio)\r\n * } catch (err) {\r\n *   if (err instanceof STTError) {\r\n *     console.error(err.code, err.provider, err.retryable)\r\n *   }\r\n * }\r\n * ```\r\n */\r\nexport class VoiceKitError extends Error {\r\n    readonly code: string\r\n    readonly callId?: string\r\n    readonly provider?: string\r\n    readonly retryable: boolean\r\n    readonly severity: ErrorSeverity\r\n    override readonly cause?: unknown\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        provider?: string\r\n        retryable?: boolean\r\n        severity?: ErrorSeverity\r\n        cause?: unknown\r\n    }) {\r\n        super(params.message)\r\n        this.name = this.constructor.name\r\n        this.code = params.code\r\n        this.callId = params.callId\r\n        this.provider = params.provider\r\n        this.retryable = params.retryable ?? false\r\n        this.severity = params.severity ?? 'medium'\r\n        this.cause = params.cause\r\n\r\n        // Maintains proper prototype chain for `instanceof` in transpiled code\r\n        Object.setPrototypeOf(this, new.target.prototype)\r\n    }\r\n\r\n    toJSON() {\r\n        return {\r\n            name: this.name,\r\n            code: this.code,\r\n            message: this.message,\r\n            callId: this.callId,\r\n            provider: this.provider,\r\n            retryable: this.retryable,\r\n            severity: this.severity,\r\n        }\r\n    }\r\n}","\r\n// ─── Agent Errors ─────────────────────────────────────────────────────────────\r\n\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from agent orchestration (turn engine, handoff, injection).\r\n */\r\nexport class AgentError extends VoiceKitError { }\r\n\r\nexport class TurnTransitionError extends AgentError {\r\n    readonly fromState: string\r\n    readonly event: string\r\n\r\n    constructor(fromState: string, toEvent: string, callId?: string) {\r\n        super({\r\n            code: 'AGENT_INVALID_TURN_TRANSITION',\r\n            message: `Invalid turn transition: state '${fromState}' cannot handle event '${toEvent}'`,\r\n            callId,\r\n            retryable: false,\r\n            severity: 'medium',\r\n        })\r\n        this.fromState = fromState\r\n        this.event = toEvent\r\n    }\r\n}\r\n\r\nexport class AgentHandoffError extends AgentError {\r\n    constructor(capability: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'AGENT_HANDOFF_FAILED',\r\n            message: `Handoff to '${capability}' agent failed`,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n","\r\n// ─── Compliance Errors ────────────────────────────────────────────────────────\r\n\r\nimport type { ErrorSeverity } from \"../types\"\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from compliance checks (TRAI DNC, calling hours, consent).\r\n */\r\nexport class ComplianceError extends VoiceKitError {\r\n    readonly phoneNumber?: string\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        phoneNumber?: string\r\n        retryable?: boolean\r\n        severity?: ErrorSeverity\r\n        cause?: unknown\r\n    }) {\r\n        super({ ...params, provider: 'trai' })\r\n        this.phoneNumber = params.phoneNumber\r\n    }\r\n}\r\n\r\nexport class DNCBlockedError extends ComplianceError {\r\n    constructor(phoneNumber: string, callId?: string) {\r\n        super({\r\n            code: 'COMPLIANCE_DNC_BLOCKED',\r\n            message: `Number ${phoneNumber} is on DNC registry — call blocked`,\r\n            callId,\r\n            phoneNumber,\r\n            retryable: false,\r\n            severity: 'low',\r\n        })\r\n    }\r\n}\r\n\r\nexport class CallingHoursError extends ComplianceError {\r\n    constructor(phoneNumber: string, currentTime: string, callId?: string) {\r\n        super({\r\n            code: 'COMPLIANCE_OUTSIDE_CALLING_HOURS',\r\n            message: `Call to ${phoneNumber} blocked — outside TRAI calling hours (current: ${currentTime} IST)`,\r\n            callId,\r\n            phoneNumber,\r\n            retryable: false,\r\n            severity: 'low',\r\n        })\r\n    }\r\n}\r\n\r\nexport class ConsentMissingError extends ComplianceError {\r\n    constructor(phoneNumber: string, callId?: string) {\r\n        super({\r\n            code: 'COMPLIANCE_CONSENT_MISSING',\r\n            message: `No valid consent on record for ${phoneNumber}`,\r\n            callId,\r\n            phoneNumber,\r\n            retryable: false,\r\n            severity: 'medium',\r\n        })\r\n    }\r\n}\r\n","\r\n\r\n// ─── Inngest Errors ───────────────────────────────────────────────────────────\r\n\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from Inngest background task dispatch.\r\n */\r\nexport class InngestError extends VoiceKitError {\r\n    readonly taskName?: string\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        taskName?: string\r\n        cause?: unknown\r\n    }) {\r\n        super({\r\n            ...params,\r\n            provider: 'inngest',\r\n            retryable: true,\r\n            severity: 'medium',\r\n        })\r\n        this.taskName = params.taskName\r\n    }\r\n}","\r\n// ─── STT Errors ───────────────────────────────────────────────────────────────\r\n\r\nimport type { ErrorSeverity } from \"../types\"\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from speech-to-text providers.\r\n */\r\nexport class STTError extends VoiceKitError {\r\n    readonly languageCode?: string\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        provider?: string\r\n        retryable?: boolean\r\n        severity?: ErrorSeverity\r\n        cause?: unknown\r\n        languageCode?: string\r\n    }) {\r\n        super(params)\r\n        this.languageCode = params.languageCode\r\n    }\r\n}\r\n\r\nexport class STTConnectionError extends STTError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'STT_CONNECTION_FAILED',\r\n            message: `Failed to connect to ${provider} STT service`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class STTStreamError extends STTError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'STT_STREAM_ERROR',\r\n            message: `STT stream error from ${provider}`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'medium',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class STTLanguageNotSupportedError extends STTError {\r\n    constructor(provider: string, language: string) {\r\n        super({\r\n            code: 'STT_LANGUAGE_NOT_SUPPORTED',\r\n            message: `Language '${language}' is not supported by ${provider}`,\r\n            provider,\r\n            retryable: false,\r\n            severity: 'low',\r\n            languageCode: language,\r\n        })\r\n    }\r\n}\r\n","\r\n// ─── Telephony Errors ─────────────────────────────────────────────────────────\r\n\r\nimport type { ErrorSeverity } from \"../types\"\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from telephony providers.\r\n */\r\nexport class TelephonyError extends VoiceKitError {\r\n    readonly to?: string\r\n    readonly from?: string\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        provider?: string\r\n        retryable?: boolean\r\n        severity?: ErrorSeverity\r\n        cause?: unknown\r\n        to?: string\r\n        from?: string\r\n    }) {\r\n        super(params)\r\n        this.to = params.to\r\n        this.from = params.from\r\n    }\r\n}\r\n\r\nexport class CallConnectionError extends TelephonyError {\r\n    constructor(provider: string, to: string, cause?: unknown) {\r\n        super({\r\n            code: 'CALL_CONNECTION_FAILED',\r\n            message: `Failed to connect call to ${to} via ${provider}`,\r\n            provider,\r\n            to,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class CallNotFoundError extends TelephonyError {\r\n    constructor(callId: string, provider: string) {\r\n        super({\r\n            code: 'CALL_NOT_FOUND',\r\n            message: `Call '${callId}' not found on ${provider}`,\r\n            callId,\r\n            provider,\r\n            retryable: false,\r\n            severity: 'low',\r\n        })\r\n    }\r\n}\r\n\r\nexport class AudioTransportError extends TelephonyError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'AUDIO_TRANSPORT_ERROR',\r\n            message: `Audio transport error on ${provider}`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n","\r\n// ─── TTS Errors ───────────────────────────────────────────────────────────────\r\n\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from text-to-speech providers.\r\n */\r\nexport class TTSError extends VoiceKitError { }\r\n\r\nexport class TTSConnectionError extends TTSError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'TTS_CONNECTION_FAILED',\r\n            message: `Failed to connect to ${provider} TTS service`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class TTSStreamError extends TTSError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'TTS_STREAM_ERROR',\r\n            message: `TTS stream error from ${provider}`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'medium',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class TTSVoiceNotFoundError extends TTSError {\r\n    constructor(provider: string, voiceId: string) {\r\n        super({\r\n            code: 'TTS_VOICE_NOT_FOUND',\r\n            message: `Voice '${voiceId}' not found on ${provider}`,\r\n            provider,\r\n            retryable: false,\r\n            severity: 'low',\r\n        })\r\n    }\r\n}\r\n"]}

package/dist/index.d.cts

@@ -1,319 +1,3 @@
-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 CallMemory, type CallMemoryConfig, type CallMetricsSummary, type CallPurpose, type ConsentRecord, type DNCCheckParams, type DNCCheckResult, type ErrorSeverity, type STTConfig, type STTProvider, type STTResult, type TRAIConfig, type TTSConfig, type TTSProvider, type VADConfig, type VoiceFrame, type VoiceKitErrorContext, type WordTimestamp, createCallMemory, createSTT, createTTS };
+export { a as CallMemory, C as CallMemoryConfig, d as CallMetricsSummary, i as CallPurpose, c as ConsentRecord, D as DNCCheckParams, b as DNCCheckResult, E as ErrorSeverity, g as STTConfig, S as STTProvider, h as STTResult, T as TRAIConfig, f as TTSConfig, e as TTSProvider, V as VADConfig, j as VoiceFrame, k as VoiceKitErrorContext, W as WordTimestamp, l as createCallMemory, m as createSTT, n as createTTS } from './index-CkTG6DOa.cjs';
+export { AgentError, AgentHandoffError, AudioTransportError, CallConnectionError, CallNotFoundError, CallingHoursError, ComplianceError, ConsentMissingError, DNCBlockedError, InngestError, STTConnectionError, STTError, STTLanguageNotSupportedError, STTStreamError, TTSConnectionError, TTSError, TTSStreamError, TTSVoiceNotFoundError, TelephonyError, TurnTransitionError, VoiceKitError } from './errors.cjs';
+import 'ai';