@elizaos/plugin-local-inference 2.0.0-beta.1 → 2.0.11-beta.7

package/src/services/voice/fused-eot-scorer.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Fused FFI end-of-turn scorer (ABI v11).
+ *
+ * The fused replacement for the retired node-llama-cpp `controlledEvaluate()`
+ * path the EOT classifiers depended on. Computes P(`<|im_end|>` next | partial
+ * transcript) through the single `libelizainference` handle: tokenize the
+ * Qwen-formatted partial transcript, then one causal forward pass
+ * (`eliza_inference_llm_eot_score`) reads the next-token probability of the
+ * end-of-turn marker. No separate model weights, no sampling loop, and no KV
+ * growth on the chat session — the dedicated native scoring context clears its
+ * KV per call so scores are independent.
+ */
+import type { ElizaInferenceContextHandle, ElizaInferenceFfi } from "./ffi-bindings";
+export interface FfiEotScorerOptions {
+    /** The loaded fused inference binding (must expose the v11 EOT symbols). */
+    ffi: ElizaInferenceFfi;
+    /** Resolves the live inference context handle (the loaded text bundle). */
+    getContext: () => ElizaInferenceContextHandle;
+    /** Max prompt tokens kept (tail-truncated). LiveKit's recipe uses 128. */
+    maxHistoryTokens?: number;
+    /** Model label for telemetry. */
+    modelLabel?: string;
+}
+export interface FfiEotScoreResult {
+    /** Probability of `<|im_end|>` as the next token, ∈ [0, 1]. */
+    probability: number;
+    /** Wall-clock model latency for this scoring call. */
+    latencyMs: number;
+    /** Number of prompt tokens evaluated. */
+    promptTokens: number;
+}
+/**
+ * Stateful EOT scorer bound to a loaded fused text model. The `<|im_end|>`
+ * token id is resolved once and cached. Safe to keep across many voice turns.
+ */
+export declare class FfiEotScorer {
+    private readonly ffi;
+    private readonly getContext;
+    private readonly maxHistoryTokens;
+    readonly modelLabel: string;
+    private imEndTokenId;
+    constructor(options: FfiEotScorerOptions);
+    /**
+     * True only when the fused build wires the v11 EOT scorer AND the tokenizer
+     * it depends on. A v10 (or older) library returns false.
+     */
+    static isSupported(ffi: ElizaInferenceFfi | null | undefined): boolean;
+    private resolveImEnd;
+    score(partialTranscript: string): Promise<FfiEotScoreResult>;
+}
+//# sourceMappingURL=fused-eot-scorer.d.ts.map

package/src/services/voice/fused-eot-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fused-eot-scorer.d.ts","sourceRoot":"","sources":["fused-eot-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EACX,2BAA2B,EAC3B,iBAAiB,EACjB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,mBAAmB;IACnC,4EAA4E;IAC5E,GAAG,EAAE,iBAAiB,CAAC;IACvB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,2BAA2B,CAAC;IAC9C,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IACjC,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,YAAY,CAAuB;gBAE/B,OAAO,EAAE,mBAAmB;IAOxC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAUtE,OAAO,CAAC,YAAY;IAsBd,KAAK,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAuClE"}

package/src/services/voice/fused-eot-scorer.ts

@@ -0,0 +1,135 @@
+/**
+ * Fused FFI end-of-turn scorer (ABI v11).
+ *
+ * The fused replacement for the retired node-llama-cpp `controlledEvaluate()`
+ * path the EOT classifiers depended on. Computes P(`<|im_end|>` next | partial
+ * transcript) through the single `libelizainference` handle: tokenize the
+ * Qwen-formatted partial transcript, then one causal forward pass
+ * (`eliza_inference_llm_eot_score`) reads the next-token probability of the
+ * end-of-turn marker. No separate model weights, no sampling loop, and no KV
+ * growth on the chat session — the dedicated native scoring context clears its
+ * KV per call so scores are independent.
+ */
+
+import { formatEotPrompt } from "./eliza1-eot-scorer";
+import type {
+	ElizaInferenceContextHandle,
+	ElizaInferenceFfi,
+} from "./ffi-bindings";
+
+const IM_END_TOKEN = "<|im_end|>";
+
+export interface FfiEotScorerOptions {
+	/** The loaded fused inference binding (must expose the v11 EOT symbols). */
+	ffi: ElizaInferenceFfi;
+	/** Resolves the live inference context handle (the loaded text bundle). */
+	getContext: () => ElizaInferenceContextHandle;
+	/** Max prompt tokens kept (tail-truncated). LiveKit's recipe uses 128. */
+	maxHistoryTokens?: number;
+	/** Model label for telemetry. */
+	modelLabel?: string;
+}
+
+export interface FfiEotScoreResult {
+	/** Probability of `<|im_end|>` as the next token, ∈ [0, 1]. */
+	probability: number;
+	/** Wall-clock model latency for this scoring call. */
+	latencyMs: number;
+	/** Number of prompt tokens evaluated. */
+	promptTokens: number;
+}
+
+/**
+ * Stateful EOT scorer bound to a loaded fused text model. The `<|im_end|>`
+ * token id is resolved once and cached. Safe to keep across many voice turns.
+ */
+export class FfiEotScorer {
+	private readonly ffi: ElizaInferenceFfi;
+	private readonly getContext: () => ElizaInferenceContextHandle;
+	private readonly maxHistoryTokens: number;
+	readonly modelLabel: string;
+	private imEndTokenId: number | null = null;
+
+	constructor(options: FfiEotScorerOptions) {
+		this.ffi = options.ffi;
+		this.getContext = options.getContext;
+		this.maxHistoryTokens = options.maxHistoryTokens ?? 128;
+		this.modelLabel = options.modelLabel ?? "eliza-1-fused-eot";
+	}
+
+	/**
+	 * True only when the fused build wires the v11 EOT scorer AND the tokenizer
+	 * it depends on. A v10 (or older) library returns false.
+	 */
+	static isSupported(ffi: ElizaInferenceFfi | null | undefined): boolean {
+		return (
+			!!ffi &&
+			typeof ffi.eotSupported === "function" &&
+			ffi.eotSupported() &&
+			typeof ffi.eotScore === "function" &&
+			typeof ffi.tokenize === "function"
+		);
+	}
+
+	private resolveImEnd(ctx: ElizaInferenceContextHandle): number {
+		if (this.imEndTokenId !== null) return this.imEndTokenId;
+		const tokenize = this.ffi.tokenize;
+		if (!tokenize) {
+			throw new Error("[voice] FfiEotScorer: fused tokenizer is unavailable.");
+		}
+		const ids = tokenize({
+			ctx,
+			text: IM_END_TOKEN,
+			addSpecial: false,
+			parseSpecial: true,
+		});
+		const first = ids[0];
+		if (ids.length !== 1 || first === undefined || !Number.isInteger(first)) {
+			throw new Error(
+				`[voice] FfiEotScorer: tokenizer did not resolve <|im_end|> to a single special token (got ${JSON.stringify([...ids])}). The text bundle must be Qwen-template compatible.`,
+			);
+		}
+		this.imEndTokenId = first;
+		return first;
+	}
+
+	async score(partialTranscript: string): Promise<FfiEotScoreResult> {
+		const start = performance.now();
+		const ctx = this.getContext();
+		const tokenize = this.ffi.tokenize;
+		const eotScore = this.ffi.eotScore;
+		if (!tokenize || !eotScore) {
+			throw new Error(
+				"[voice] FfiEotScorer: fused EOT symbols are unavailable.",
+			);
+		}
+		const imEndId = this.resolveImEnd(ctx);
+		const formatted = formatEotPrompt(partialTranscript);
+		const all = tokenize({
+			ctx,
+			text: formatted,
+			addSpecial: false,
+			parseSpecial: true,
+		});
+		const tokens =
+			all.length > this.maxHistoryTokens
+				? all.slice(all.length - this.maxHistoryTokens)
+				: all;
+		if (tokens.length === 0) {
+			return {
+				probability: 0.5,
+				latencyMs: performance.now() - start,
+				promptTokens: 0,
+			};
+		}
+		const { targetProb } = eotScore({ ctx, tokens, targetTokenId: imEndId });
+		const probability = Number.isFinite(targetProb)
+			? Math.max(0, Math.min(1, targetProb))
+			: 0.5;
+		return {
+			probability,
+			latencyMs: performance.now() - start,
+			promptTokens: tokens.length,
+		};
+	}
+}

package/src/services/voice/index.d.ts

@@ -0,0 +1,91 @@
+export { type AttributedTurn, type AttributedTurnListener, type AttributionPipelineLike, AUDIO_FRAME_PIPELINE_SAMPLE_RATE, AudioFrameConsumer, type AudioFrameConsumerConfig, type AudioFrameConsumerDeps, AudioFrameDecodeError, type AudioFrameEvent, decodeAudioFramePcm, type RuntimeEventSink, type VadSegmenter, } from "./audio-frame-consumer";
+export { BargeInController, type BargeInControllerConfig, type BargeInListener, type CancelSignal, } from "./barge-in";
+export { type CoordinatorRuntime, VoiceCancellationCoordinator, type VoiceCancellationCoordinatorOptions, } from "./cancellation-coordinator";
+export { type CheckpointHandle, CheckpointHandleInvalidError, CheckpointManager, type CheckpointManagerLike, type CheckpointManagerOptions, MockCheckpointManager, type MockCheckpointSnapshot, type MockSnapshotSource, } from "./checkpoint-manager";
+export { type BuildDeterministicFn, type BuildMessageDependentFn, type ContextPartial, EagerContextBuilder, type EagerContextBuilderOptions, type FullContext, mergeContext, } from "./eager-context-builder";
+export type { LlamaContextLike as Eliza1EotLlamaContext, LlamaContextSequenceLike as Eliza1EotLlamaSequence, LlamaModelLike as Eliza1EotLlamaModel, } from "./eliza1-eot-scorer";
+export { Eliza1EotScorer, formatEotPrompt as formatEliza1EotPrompt, } from "./eliza1-eot-scorer";
+export { buildLocalEmbeddingRoute, EMBEDDING_DIR_REL_PATH, EMBEDDING_FULL_DIM, EMBEDDING_MATRYOSHKA_DIMS, isValidEmbeddingDim, type LocalEmbeddingRoute, type LocalEmbeddingSource, POOLED_TEXT_EMBEDDING_TIERS, resolveLocalEmbeddingSource, truncateMatryoshka, } from "./embedding";
+export { attributeVoiceEmotion, type VoiceEmotionAsrFeatures, type VoiceEmotionAttribution, type VoiceEmotionAttributionInput, type VoiceEmotionAttributionMethod, type VoiceEmotionAudioFeatures, type VoiceEmotionEvidence, } from "./emotion-attribution";
+export { decodeMonoPcm16Wav, defaultLifecycleLoaders, EngineVoiceBridge, type EngineVoiceBridgeOptions, encodeMonoPcm16Wav, FfiOmniVoiceBackend, StubOmniVoiceBackend, type VoiceTurnEvents, } from "./engine-bridge";
+export { Eliza1EotClassifier, type Eliza1EotScoreResult, type Eliza1EotScorerOptions, EOT_COMMIT_SILENCE_MS, EOT_COMMIT_THRESHOLD, EOT_HANGOVER_EXTENSION_MS, EOT_MID_CLAUSE_THRESHOLD, EOT_TENTATIVE_SILENCE_MS, EOT_TENTATIVE_THRESHOLD, type EotClassifier, HeuristicEotClassifier, LIVEKIT_TURN_DETECTOR_EN_REVISION, LIVEKIT_TURN_DETECTOR_INTL_REVISION, RemoteEotClassifier, type RemoteEotClassifierOptions, turnDetectorRevisionForTier, turnSignalFromProbability, type VoiceNextSpeaker, type VoiceTurnSignal, } from "./eot-classifier";
+export { applyQwenUserTemplate, createBundledLiveKitGgmlTurnDetector, DEFAULT_LIVEKIT_TURN_DETECTOR_GGML_DIR, DEFAULT_LIVEKIT_TURN_DETECTOR_GGUF_EN, DEFAULT_LIVEKIT_TURN_DETECTOR_GGUF_INTL, EotGgmlUnavailableError, LIVEKIT_IM_END_TOKEN, LiveKitGgmlTurnDetector, type LiveKitGgmlTurnDetectorOptions, turnDetectorGgufForTier, } from "./eot-classifier-ggml";
+export { VoiceStartupError } from "./errors";
+export * from "./ffi-bindings";
+export { _resetSharedFirstLineCacheForTesting, _resetVoiceRevisionMemoForTesting, computeLocalVoiceRevision, FIRST_SENTENCE_MAX_WORDS, FIRST_SENTENCE_SNIP_VERSION, FirstLineCache, type FirstLineCacheEntry, type FirstLineCacheKey, type FirstLineCacheOptions, type FirstLineCacheStats, type FirstSentenceSnipResult, fingerprintVoiceSettings, firstLineCacheBypassFromEnv, firstSentenceSnip, getSharedFirstLineCache, hashCacheKey, type PutInput, wordCount, } from "./first-line-cache";
+export { type ArmedResources, type TextResources, VoiceLifecycle, VoiceLifecycleError, type VoiceLifecycleEvents, type VoiceLifecycleLoaders, type VoiceLifecycleState, } from "./lifecycle";
+export { DesktopMicSource, type DesktopMicSourceOptions, PushMicSource, pipeMicToRingBuffer, resolveDesktopRecorder, } from "./mic-source";
+export { DEFAULT_OPTIMISTIC_EOT_THRESHOLD, OptimisticGenerationPolicy, type OptimisticPolicyOptions, type PowerSourceState, type ResolveOptimisticPolicyArgs, resolveOptimisticPolicyEnabled, resolvePowerSourceState, } from "./optimistic-policy";
+export { createDefaultPhonemeTokenizer, type Phoneme, type PhonemeTokenizer, RuleBasedEnglishPhonemeTokenizer, } from "./phoneme-tokenizer";
+export { type CachedPhraseAudio, canonicalizePhraseText, DEFAULT_PHRASE_CACHE_SEED, FIRST_AUDIO_FILLERS, PhraseCache, } from "./phrase-cache";
+export { chunkTokens, PhraseChunker } from "./phrase-chunker";
+export { type DraftProposer, splitTranscriptToTokens, type TargetVerifier, VoicePipeline, type VoicePipelineConfig, type VoicePipelineDeps, type VoicePipelineEvents, } from "./pipeline";
+export { MissingAsrTranscriber, MtpDraftProposer, MtpTargetVerifier, type MtpTextRunner, mtpTextRunner, } from "./pipeline-impls";
+export { type PrefillOptimisticArgs, type PrefillOptimisticOptions, type PrefillOptimisticResult, prefillOptimistic, } from "./prefill-client";
+export { PrefixPreservingQueue, type RollbackResult, type TaggedAudioChunk, } from "./prefix-preserving-queue";
+export { isOutlier, VOICE_PROFILE_RECORD_SCHEMA_VERSION, type VoiceImprintMatchHandle, type VoiceProfileAudioRef, type VoiceProfileConsentState, type VoiceProfileObservation, type VoiceProfileRecord, VoiceProfileStore, type VoiceProfileStoreOptions, welfordUpdate, welfordVariance, } from "./profile-store";
+export { InMemoryAudioSink, PcmRingBuffer } from "./ring-buffer";
+export { type RollbackEvent, RollbackQueue } from "./rollback-queue";
+export { type SchedulerDeps, type SchedulerEvents, VoiceScheduler, } from "./scheduler";
+export { createMtpDraftHandle, type KernelSet, type MmapRegionHandle, type MtpDraftHandle, type RefCountedResource, type SchedulerSlot, SharedResourceRegistry, type SharedTokenizer, } from "./shared-resources";
+export { type VoiceAttributionOutput, VoiceAttributionPipeline, type VoiceAttributionPipelineDeps, type VoiceAttributionRequest, } from "./speaker/attribution-pipeline";
+export { classifyFramesToSegments, type Diarizer, type DiarizerOutput, DiarizerUnavailableError, type LocalSpeakerSegment, PYANNOTE_CLASS_COUNT, PYANNOTE_CLASS_TO_SPEAKERS, PYANNOTE_FRAME_STRIDE_MS, PYANNOTE_FRAMES_PER_WINDOW, PYANNOTE_SAMPLE_RATE, PYANNOTE_SEGMENTATION_3_FP32_MODEL_ID, PYANNOTE_SEGMENTATION_3_INT8_MODEL_ID, PYANNOTE_WINDOW_SECONDS, type PyannoteDiarizerModelId, } from "./speaker/diarizer";
+export { FusedDiarizer, type FusedDiarizerOptions, } from "./speaker/diarizer-fused";
+export { averageEmbeddings, type SpeakerEncoder, SpeakerEncoderUnavailableError, WESPEAKER_EMBEDDING_DIM, WESPEAKER_MIN_SAMPLES, WESPEAKER_RESNET34_LM_FP32_MODEL_ID, WESPEAKER_RESNET34_LM_INT8_MODEL_ID, WESPEAKER_SAMPLE_RATE, type WespeakerModelId, } from "./speaker/encoder";
+export { FusedSpeakerEncoder, type FusedSpeakerEncoderOptions, } from "./speaker/encoder-fused";
+export { SPEAKER_GGML_EMBEDDING_DIM, SPEAKER_GGML_MIN_SAMPLES, SPEAKER_GGML_SAMPLE_RATE, SpeakerEncoderGgmlUnavailableError, voiceSpeakerDistance, } from "./speaker/encoder-ggml";
+export { type AttributedVoiceObservation, attributeVoiceImprintObservations, cosineSimilarity, DEFAULT_VOICE_IMPRINT_MATCH_THRESHOLD, matchVoiceImprint, normalizeVoiceEmbedding, type SpeakerAttributionResult, updateVoiceImprintCentroid, type VoiceImprintCentroidUpdate, type VoiceImprintMatch, type VoiceImprintObservationInput, type VoiceImprintProfile, voiceSpeakerFromImprintMatch, } from "./speaker-imprint";
+export { DEFAULT_VOICE_ID, DEFAULT_VOICE_PRESET_REL_PATH, type LoadedPresetBundle, type PresetBundlePaths, SpeakerPresetCache, type SpeakerPresetCacheOptions, voicePresetPath, } from "./speaker-preset-cache";
+export { SystemAudioSink, type SystemAudioSinkOptions, WavFileAudioSink, type WavFileAudioSinkOptions, } from "./system-audio-sink";
+export { ASR_SAMPLE_RATE, AsrUnavailableError, BaseStreamingTranscriber, type CreateStreamingTranscriberOptions, createStreamingTranscriber, FfiBatchTranscriber, type FfiBatchTranscriberOptions, FfiStreamingTranscriber, ffiSupportsStreamingAsr, resampleLinear, } from "./transcriber";
+export { type VoiceGenerateRequest, VoiceTurnController, type VoiceTurnControllerConfig, type VoiceTurnControllerDeps, type VoiceTurnControllerEvents, type VoiceTurnOutcome, } from "./turn-controller";
+export * from "./types";
+export { createSileroVadDetector, createVadDetector, GgmlSileroVad, NativeSileroVad, type QwenToolkitVadAdapter, type ResolvedVadProvider, RmsEnergyGate, type RmsEnergyGateConfig, resolveSileroVadPath, resolveVadProvider, rms, VadDetector, type VadDetectorConfig, type VadLike, type VadProviderId, type VadProviderPreference, VadUnavailableError, vadProviderOrder, } from "./vad";
+export { type AllocationPriority, assessVoiceBundleFits, BudgetExhaustedError, type BudgetReservation, createVoiceBudget, createVoiceBudgetForTest, DEFAULT_VOICE_BUNDLE_RESERVE_MB, pickVoiceTierSlot, priorityClassForRole, type ReservationSnapshot, VOICE_ENSEMBLE_BUDGETS, type VoiceBudget, type VoiceBundleFitDecision, type VoiceEnsembleBudget, type VoiceTierSlot, voiceEnsemblePeakMb, voiceEnsembleSteadyStateMb, } from "./voice-budget";
+export { readVoicePresetFile, VOICE_PRESET_MAGIC, type VoicePresetFile, VoicePresetFormatError, type VoicePresetSeedPhrase, writeVoicePresetFile, } from "./voice-preset-format";
+export { analyzeVoiceProfileWav, canonicalVoiceProfileJson, createVoiceProfileArtifact, VOICE_PROFILE_ARTIFACT_SCHEMA_VERSION, VOICE_PROFILE_FEATURE_EMBEDDING_MODEL, type VoiceProfileArtifact, type VoiceProfileArtifactSample, type VoiceProfileArtifactStatus, type VoiceProfileArtifactVerification, type VoiceProfileAudioFeatures, type VoiceProfileConsent, type VoiceProfileReferenceMetadata, type VoiceProfileSampleInput, verifyVoiceProfileArtifact, } from "./voice-profile-artifact";
+export { DEFAULT_VOICE_SETTINGS, effectiveBackendMode, qualityPresetQuantizationRanking, resolveVoiceSettings, type VoiceBackendMode, type VoiceModelQualityPreset, type VoiceSettings, } from "./voice-settings";
+export { type DrafterAbortReason, type DrafterHandle, type StartDrafterFn, type VoiceState, type VoiceStateEvent, VoiceStateMachine, type VoiceStateMachineEvents, type VoiceStateMachineOptions, } from "./voice-state-machine";
+export { GgmlWakeWordModel, isPlaceholderWakeWordHead, loadBundledWakeWordModel, OPENWAKEWORD_DEFAULT_HEAD, OPENWAKEWORD_DIR_REL_PATH, OPENWAKEWORD_GGUF_REL_PATH, OPENWAKEWORD_PLACEHOLDER_HEADS, OpenWakeWordDetector, resolveWakeWordModel, type WakeWordConfig, type WakeWordModel, type WakeWordModelPaths, WakeWordUnavailableError, } from "./wake-word";
+export { type TtsBytes, type TtsHandler, type TtsHandlerInput, type TtsHandlerOutput, type TtsResolvedContext, type WrapOptions, wrapWithFirstLineCache, } from "./wrap-with-first-line-cache";
+/**
+ * Voice on/off invariants (binding for every consumer of this module):
+ *
+ * 1. Voice is OFF by default — text + drafter only. Before
+ *    `EngineVoiceBridge.start()` there are no voice resources in RAM.
+ *    After `start()` but before `VoiceLifecycle.arm()`, only the tiny
+ *    default speaker preset, phrase seed metadata, and scheduler
+ *    scaffolding are live. TTS/ASR weight regions are NOT mapped or
+ *    re-paged until `VoiceLifecycle.arm()` calls the fused ABI's
+ *    `mmap_acquire`.
+ *
+ * 2. Shared resources between text and voice (one instance each per
+ *    engine, refcounted by `SharedResourceRegistry`):
+ *      - tokenizer (Eliza-1/OmniVoice share a vocabulary)
+ *      - mmap regions for weights (deduplicated by absolute path)
+ *      - the fused kernel set (TurboQuant/QJL/Polar live in the
+ *        same shipped llama.cpp library after the fusion build)
+ *      - the scheduler queue (one queue, prioritised across surfaces)
+ *      - the MTP drafter (always wired — see AGENTS.md §3 #4)
+ *
+ *    Text and voice keep SEPARATE KV caches (different layer counts,
+ *    different head configs, different quantizations — AGENTS.md §4
+ *    "shared KV cache scheduling, not shared KV memory").
+ *
+ * 3. `arm()` lazily loads TTS + ASR via mmap; `disarm()` issues a real
+ *    page-eviction call (`madvise(MADV_DONTNEED)` on Linux/Android,
+ *    `madvise(MADV_FREE_REUSABLE)` on Apple, `VirtualUnlock` +
+ *    `OfferVirtualMemory` on Windows). The speaker preset and phrase
+ *    cache stay in a small LRU after disarm — they're KB-scale.
+ *
+ * 4. Hardware-resource exhaustion (RAM pressure, OS page eviction
+ *    refusal, mmap fail, kernel missing) MUST surface as a
+ *    `VoiceLifecycleError` with a structured `code`. There is NO
+ *    silent fallback to text-only and NO automatic downgrade to a
+ *    smaller voice model — see AGENTS.md §3.
+ *
+ * 5. Illegal lifecycle transitions throw `VoiceLifecycleError` with
+ *    code `"illegal-transition"`. The state is a discriminated
+ *    union, never a string.
+ */
+//# sourceMappingURL=index.d.ts.map

package/src/services/voice/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}