@elizaos/plugin-local-inference 2.0.0-beta.1 → 2.0.3-beta.3

package/dist/services/voice/ffi-bindings.d.ts.map

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

package/dist/services/voice/first-line-cache.d.ts

@@ -0,0 +1,181 @@
+/**
+ * First-line LRU TTS cache (disk-tier, voice-scoped).
+ *
+ * The in-RAM `PhraseCache` is the hot tier (keyed on text alone, single voice
+ * per scheduler). This disk-tier sits behind it and is keyed on
+ *   (algoVersion, provider, voiceId, voiceRevision, sampleRate, codec,
+ *    voiceSettingsFingerprint, normalizedText)
+ * so the F3 bug in `.swarm/VOICE_WAVE_2.md` (Kokoro→ElevenLabs voice swap
+ * replaying Kokoro audio) is impossible by construction: swapping the active
+ * voice changes `voiceId` and therefore changes the cache key.
+ *
+ * Storage layout (anchored to `resolveStateDir()`):
+ *   <stateDir>/cache/tts-first-line/
+ *     ├── index.sqlite                            -- LRU manifest
+ *     └── blobs/
+ *         <provider>/<voiceId>/<voiceRevision>/<keyHash>.<ext>
+ *
+ * Index schema:
+ *   See `INDEX_SCHEMA_SQL` below.
+ *
+ * Eviction: LRU by `last_accessed_at_ms`, bounded by a configurable byte
+ * budget (default 64 MB), per-entry cap (default 256 KB), TTL (default 30 d).
+ *
+ * Safety rules (see R4 §6):
+ *   - empty `voiceRevision` rejected at insert.
+ *   - cancelled / errored synth never reaches `put`.
+ *   - non-default `voiceSettingsFingerprint` produces a different key.
+ *   - `realtime` / non-deterministic provider models live on a per-call
+ *     bypass list (callers consult `firstLineCacheBypassFromEnv`).
+ *
+ * Concurrency: SQLite is opened in WAL mode for many-readers / single-writer
+ * across the runtime, dashboard server, and any spawned coding-agent
+ * processes that emit speech. Blob writes go through a temp file + atomic
+ * rename so partials never reach the index.
+ *
+ * SQLite resolution mirrors `packages/app-core/src/api/training-benchmarks.ts`:
+ * try `node:sqlite` (Node ≥22.5), then `bun:sqlite` (Bun). Neither runtime
+ * ships both. When neither is present the cache silently no-ops (`get` returns
+ * null, `put` returns false) — the caller's fallback path (synthesize fresh)
+ * still works.
+ */
+import { FIRST_SENTENCE_MAX_WORDS, FIRST_SENTENCE_SNIP_VERSION, type FirstSentenceSnipResult, firstSentenceSnip, wordCount } from "@elizaos/shared";
+/**
+ * Logical cache key. The on-disk filename + index row are keyed on
+ * `keyHash`, computed deterministically from this record.
+ */
+export interface FirstLineCacheKey {
+    /** Pinned to `FIRST_SENTENCE_SNIP_VERSION`; bumping it invalidates every entry. */
+    readonly algoVersion: string;
+    readonly provider: string;
+    readonly voiceId: string;
+    /** sha256 of voice pack + model file (local) or `client.voices.get`
+     * settings hash (cloud-side). MUST be non-empty. */
+    readonly voiceRevision: string;
+    readonly sampleRate: number;
+    readonly codec: "opus" | "mp3" | "wav" | "pcm_f32" | "ogg" | "flac";
+    /** sha256 of `{stability, similarityBoost, style, useSpeakerBoost, speed,
+     *  pitch, ...}` JSON normalised by `fingerprintVoiceSettings`. */
+    readonly voiceSettingsFingerprint: string;
+    /** Output of `normalizeForKey(snip)`. */
+    readonly normalizedText: string;
+}
+/** Stored row + bytes. */
+export interface FirstLineCacheEntry extends FirstLineCacheKey {
+    /** Encoded payload bytes. */
+    bytes: Uint8Array;
+    /** Raw (un-normalised) snip — kept for DEBUG logs only. */
+    rawText: string;
+    /** Negotiated content-type, e.g. `audio/mpeg`, `audio/opus`. */
+    contentType: string;
+    /** Synthesized audio length, used for player buffering math. */
+    durationMs: number;
+    /** Unicode-aware word count over `normalizedText`. */
+    wordCount: number;
+    /** Epoch-ms of last access; updated on get(). */
+    lastAccessedAtMs: number;
+    /** Epoch-ms of original synthesis. */
+    generatedAtMs: number;
+    /** Diagnostic counter, incremented on every get(). */
+    hitCount: number;
+}
+export interface FirstLineCacheOptions {
+    /** Root directory; defaults to `<stateDir>/cache/tts-first-line/`. */
+    rootDir?: string;
+    /** Total byte budget on disk; defaults to 64 MB. */
+    maxBytes?: number;
+    /** Per-entry byte cap; defaults to 256 KB. */
+    maxBytesPerEntry?: number;
+    /** Soft TTL in days; defaults to 30. */
+    ttlDays?: number;
+    /** When true, get/put both no-op (used by tests + emergency kill-switch). */
+    disabled?: boolean;
+}
+export interface PutInput extends FirstLineCacheKey {
+    bytes: Uint8Array;
+    rawText: string;
+    contentType: string;
+    durationMs: number;
+    wordCount?: number;
+}
+/**
+ * Comma-separated provider names that bypass the cache entirely.
+ * Default: empty (none).
+ * Set `ELIZA_TTS_CACHE_BYPASS_PROVIDERS="omnivoice,kokoro"` to skip those.
+ */
+export declare function firstLineCacheBypassFromEnv(): ReadonlySet<string>;
+/**
+ * Deterministic hash of the cache key. Stable across processes.
+ */
+export declare function hashCacheKey(key: FirstLineCacheKey): string;
+/**
+ * Stable sha256 hex of an arbitrary settings object — used as
+ * `voiceSettingsFingerprint`. Object keys are sorted before serialisation so
+ * the order in which the caller built the object doesn't affect the hash.
+ */
+export declare function fingerprintVoiceSettings(settings: Record<string, unknown> | null | undefined): string;
+export declare function computeLocalVoiceRevision(files: ReadonlyArray<string>): Promise<string>;
+/** Test-only — clear the voice-revision memoisation. */
+export declare function _resetVoiceRevisionMemoForTesting(): void;
+export interface FirstLineCacheStats {
+    entries: number;
+    bytes: number;
+    maxBytes: number;
+    dbReady: boolean;
+}
+export declare class FirstLineCache {
+    private readonly rootDir;
+    private readonly blobsDir;
+    private readonly indexPath;
+    private readonly maxBytes;
+    private readonly maxBytesPerEntry;
+    private readonly ttlMs;
+    private readonly disabled;
+    private db;
+    private initialised;
+    private initFailed;
+    constructor(opts?: FirstLineCacheOptions);
+    get isEnabled(): boolean;
+    /**
+     * Lazy-init the SQLite index and blob directory. Returns `false` if
+     * neither `node:sqlite` nor `bun:sqlite` is available — the cache then
+     * no-ops on every call.
+     */
+    private ensureInit;
+    /**
+     * Look up a cached entry. Returns null on miss. Touches `lastAccessedAtMs`
+     * + `hitCount` on hit. Lazy-reads the blob bytes from disk.
+     */
+    get(key: FirstLineCacheKey): FirstLineCacheEntry | null;
+    has(key: FirstLineCacheKey): boolean;
+    /**
+     * Store an entry. Returns true on success, false when rejected (bad key,
+     * over-budget per-entry, sqlite unavailable, etc.).
+     *
+     * Per R4 §6: `voiceRevision` MUST be non-empty (otherwise stale bytes
+     * could survive a voice re-publish). `bytes.length === 0` is rejected
+     * too — we don't cache empty audio (likely a cancelled synthesis).
+     */
+    put(input: PutInput): boolean;
+    /**
+     * Delete one entry by key. Removes both row and blob. Idempotent.
+     */
+    delete(key: FirstLineCacheKey): boolean;
+    /**
+     * Sweep entries older than the TTL. Returns the number of entries removed.
+     */
+    sweep(now?: number): number;
+    stats(): FirstLineCacheStats;
+    close(): void;
+    private evictOverflow;
+    private resolveBlobAbs;
+}
+/**
+ * Per-process singleton. Tests should construct their own `FirstLineCache`
+ * pointing at a temp dir instead of using this one.
+ */
+export declare function getSharedFirstLineCache(): FirstLineCache;
+/** Test-only — reset the process-wide singleton. */
+export declare function _resetSharedFirstLineCacheForTesting(): void;
+export { FIRST_SENTENCE_MAX_WORDS, FIRST_SENTENCE_SNIP_VERSION, type FirstSentenceSnipResult, firstSentenceSnip, wordCount, };
+//# sourceMappingURL=first-line-cache.d.ts.map

package/dist/services/voice/first-line-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-line-cache.d.ts","sourceRoot":"","sources":["../../../src/services/voice/first-line-cache.ts"],"names":[],"mappings":"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"}

package/dist/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(`<end_of_turn>` next | partial
+ * transcript) through the single `libelizainference` handle: tokenize the
+ * Gemma-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 `<end_of_turn>` 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 `<end_of_turn>`
+ * 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 endOfTurnTokenId;
+    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 resolveEndOfTurn;
+    score(partialTranscript: string): Promise<FfiEotScoreResult>;
+}
+//# sourceMappingURL=fused-eot-scorer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fused-eot-scorer.d.ts","sourceRoot":"","sources":["../../../src/services/voice/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,kEAAkE;IAClE,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,gBAAgB,CAAuB;gBAEnC,OAAO,EAAE,mBAAmB;IAOxC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAUtE,OAAO,CAAC,gBAAgB;IAsBlB,KAAK,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA2ClE"}

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

@@ -0,0 +1,96 @@
+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 { computeDiarizationErrorRate, type DerOptions, type DerResult, type DiarizationSegment, diarizationWithinBudget, } from "./diarization-error-rate";
+export { type BuildDeterministicFn, type BuildMessageDependentFn, type ContextPartial, EagerContextBuilder, type EagerContextBuilderOptions, type FullContext, mergeContext, } from "./eager-context-builder";
+export { DEFAULT_PLAYBACK_DELAY_MS, type EchoDelayEstimate, type EchoDelayOptions, estimateEchoDelaySamples, PLATFORM_PLAYBACK_DELAY_DEFAULTS, platformPlaybackDelayMs, platformPlaybackDelaySamples, } from "./echo-delay";
+export { computeErle } from "./echo-metrics";
+export { EchoReferenceBuffer, type EchoReferenceBufferOptions, } from "./echo-reference-buffer";
+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 { applyGemmaUserTemplate, createBundledLiveKitGgmlTurnDetector, DEFAULT_LIVEKIT_TURN_DETECTOR_GGML_DIR, DEFAULT_LIVEKIT_TURN_DETECTOR_GGUF_EN, DEFAULT_LIVEKIT_TURN_DETECTOR_GGUF_INTL, EotGgmlUnavailableError, LIVEKIT_END_OF_TURN_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 { NlmsEchoCanceller, type NlmsEchoCancellerOptions, } from "./nlms-echo-canceller";
+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, type ExternalVadAdapter, GgmlSileroVad, NativeSileroVad, 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 { type ArbiterPreloader, VoicePreloadPredictor, type VoicePreloadPredictorOptions, } from "./voice-preload-predictor";
+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 { 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/dist/services/voice/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/voice/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,gCAAgC,EAChC,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,qBAAqB,EACrB,KAAK,eAAe,EACpB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,YAAY,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,KAAK,kBAAkB,EACvB,4BAA4B,EAC5B,KAAK,mCAAmC,GACxC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACN,KAAK,gBAAgB,EACrB,4BAA4B,EAC5B,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,2BAA2B,EAC3B,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,uBAAuB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,WAAW,EAChB,YAAY,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,wBAAwB,EACxB,gCAAgC,EAChC,uBAAuB,EACvB,4BAA4B,GAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EACN,mBAAmB,EACnB,KAAK,0BAA0B,GAC/B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACX,gBAAgB,IAAI,qBAAqB,EACzC,wBAAwB,IAAI,sBAAsB,EAClD,cAAc,IAAI,mBAAmB,GACrC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,eAAe,EACf,eAAe,IAAI,qBAAqB,GACxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,kBAAkB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,eAAe,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,aAAa,EAClB,sBAAsB,EACtB,iCAAiC,EACjC,mCAAmC,EACnC,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,2BAA2B,EAC3B,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,sBAAsB,EACtB,oCAAoC,EACpC,sCAAsC,EACtC,qCAAqC,EACrC,uCAAuC,EACvC,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,uBAAuB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACN,oCAAoC,EACpC,iCAAiC,EACjC,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,EAC3B,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,wBAAwB,EACxB,2BAA2B,EAC3B,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,KAAK,QAAQ,EACb,SAAS,GACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,cAAc,EACd,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,aAAa,EACb,mBAAmB,EACnB,sBAAsB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,iBAAiB,EACjB,KAAK,wBAAwB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,gCAAgC,EAChC,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,2BAA2B,EAChC,8BAA8B,EAC9B,uBAAuB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,6BAA6B,EAC7B,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,gCAAgC,GAChC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,KAAK,iBAAiB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,WAAW,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EACN,KAAK,aAAa,EAClB,uBAAuB,EACvB,KAAK,cAAc,EACnB,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,aAAa,EAClB,aAAa,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,iBAAiB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,SAAS,EACT,mCAAmC,EACnC,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,aAAa,EACb,eAAe,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,cAAc,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,sBAAsB,EACtB,KAAK,eAAe,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,KAAK,sBAAsB,EAC3B,wBAAwB,EACxB,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,GAC5B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACN,wBAAwB,EACxB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,qCAAqC,EACrC,qCAAqC,EACrC,uBAAuB,EACvB,KAAK,uBAAuB,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,aAAa,EACb,KAAK,oBAAoB,GACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,iBAAiB,EACjB,KAAK,cAAc,EACnB,8BAA8B,EAC9B,uBAAuB,EACvB,qBAAqB,EACrB,mCAAmC,EACnC,mCAAmC,EACnC,qBAAqB,EACrB,KAAK,gBAAgB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,mBAAmB,EACnB,KAAK,0BAA0B,GAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,0BAA0B,EAC1B,wBAAwB,EACxB,wBAAwB,EACxB,kCAAkC,EAClC,oBAAoB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,KAAK,0BAA0B,EAC/B,iCAAiC,EACjC,gBAAgB,EAChB,qCAAqC,EACrC,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,wBAAwB,EAC7B,0BAA0B,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,4BAA4B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,gBAAgB,EAChB,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,eAAe,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,eAAe,EACf,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,KAAK,uBAAuB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,iCAAiC,EACtC,0BAA0B,EAC1B,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,KAAK,oBAAoB,EACzB,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,OAAO,EACN,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,aAAa,EACb,eAAe,EACf,KAAK,mBAAmB,EACxB,aAAa,EACb,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,GAAG,EACH,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,mBAAmB,EACnB,gBAAgB,GAChB,MAAM,OAAO,CAAC;AACf,OAAO,EACN,KAAK,kBAAkB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,+BAA+B,EAC/B,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,mBAAmB,EACnB,0BAA0B,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,KAAK,gBAAgB,EACrB,qBAAqB,EACrB,KAAK,4BAA4B,GACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,eAAe,EACpB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,oBAAoB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,qCAAqC,EACrC,qCAAqC,EACrC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,0BAA0B,GAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,8BAA8B,EAC9B,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,wBAAwB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,sBAAsB,GACtB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG"}

package/dist/services/voice/kokoro/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Public barrel for the Kokoro-82M TTS adapter.
+ *
+ * External callers (the engine layer, the bench harness, tests) should
+ * import from `./kokoro` rather than reaching into individual files. The
+ * internal layout may change; this surface is stable.
+ */
+export type { KokoroTtsBackendDeps } from "./kokoro-backend";
+export { KokoroTtsBackend } from "./kokoro-backend";
+export type { KokoroFfiRuntimeOptions } from "./kokoro-ffi-runtime";
+export { KokoroFfiRuntime } from "./kokoro-ffi-runtime";
+export type { KokoroMockRuntimeOptions, KokoroPythonRuntimeOptions, KokoroRuntime, KokoroRuntimeChunk, KokoroRuntimeInputs, } from "./kokoro-runtime";
+export { KOKORO_GGUF_REL_PATH, KokoroMockRuntime, KokoroPythonRuntime, } from "./kokoro-runtime";
+export type { PhonemeStreamWindow, StreamPhonemesOptions, } from "./phoneme-stream";
+export { phonemizePhrase, streamPhonemes, } from "./phoneme-stream";
+export { FallbackG2PPhonemizer, KOKORO_PAD_ID, NpmPhonemizePhonemizer, resolvePhonemizer, } from "./phonemizer";
+export type { KokoroBackendDecision, KokoroBackendId, KokoroBackendInputs, } from "./pick-runtime";
+export { pickKokoroRuntimeBackend, readKokoroBackendFromEnv, } from "./pick-runtime";
+export type { VoiceBackendChoice, VoiceBackendDecision, VoiceBackendInputs, VoiceBackendMode, } from "./runtime-selection";
+export { readVoiceBackendModeFromEnv, selectVoiceBackend, } from "./runtime-selection";
+export type { KokoroBackendOptions, KokoroModelLayout, KokoroPhonemeSequence, KokoroPhonemizer, KokoroVoiceId, KokoroVoicePack, } from "./types";
+export { KokoroModelMissingError, KokoroPhonemizerError, } from "./types";
+export { findKokoroVoice, KOKORO_DEFAULT_VOICE_ID, KOKORO_VOICE_PACKS, listKokoroVoiceIds, listKokoroVoicesByLang, listKokoroVoicesByTag, resolveKokoroVoiceOrDefault, } from "./voices";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/voice/kokoro/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/voice/kokoro/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EACX,wBAAwB,EACxB,0BAA0B,EAC1B,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,eAAe,EACf,cAAc,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACN,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,iBAAiB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EACX,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,wBAAwB,EACxB,wBAAwB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACX,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,2BAA2B,EAC3B,kBAAkB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACX,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,eAAe,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACN,uBAAuB,EACvB,qBAAqB,GACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EACN,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,GAC3B,MAAM,UAAU,CAAC"}

package/dist/services/voice/kokoro/kokoro-backend.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Kokoro-82M TTS backend.
+ *
+ * Implements the same `OmniVoiceBackend + StreamingTtsBackend` seam that
+ * `FfiOmniVoiceBackend` (the OmniVoice path) satisfies, so a
+ * `VoiceScheduler` instance does not need to know which TTS family it is
+ * driving. The runtime selection layer (`runtime-selection.ts`) picks
+ * between this and `FfiOmniVoiceBackend` based on hardware tier and the
+ * caller's first-audio-latency target.
+ *
+ * The actual model inference is delegated to a `KokoroRuntime` instance
+ * (GGUF / mock) — this class owns:
+ *   - phonemizer resolution + per-phrase phonemize call,
+ *   - voice-pack resolution against `SpeakerPreset.voiceId`,
+ *   - streaming-protocol bookkeeping (cancel signal polling, final tail).
+ *
+ * No fallback sludge: if the runtime is unavailable, the backend throws
+ * on first synthesis rather than emitting silent zero PCM (AGENTS.md §3).
+ */
+import type { AudioChunk, OmniVoiceBackend, Phrase, SpeakerPreset, StreamingTtsBackend, TtsPcmChunk } from "../types";
+import type { KokoroRuntime } from "./kokoro-runtime";
+import type { KokoroBackendOptions } from "./types";
+export interface KokoroTtsBackendDeps extends KokoroBackendOptions {
+    /** The concrete model runner. Wire `KokoroFfiRuntime` (in-process fused
+     *  libelizainference) in production and `KokoroMockRuntime` in tests. */
+    runtime: KokoroRuntime;
+}
+/**
+ * Wall-clock budget for time-to-first-audio (TTFA) on the Kokoro path for a
+ * mobile-class tier (0.8b/2b/4b — where Kokoro is the *exclusive* backend per
+ * `ELIZA_1_VOICE_BACKENDS`). TTFA is measured to the first **audible** chunk:
+ * the first non-empty sub-phrase PCM slice the scheduler can begin playing,
+ * NOT the whole-phrase synthesis latency. The re-chunking in
+ * `synthesizeStream` (one runtime forward → `streamingChunkSamples` slices) is
+ * exactly what makes those two numbers differ — the listener hears audio after
+ * the first slice, well before the phrase finishes decoding.
+ *
+ * Conservative gate (catches gross regressions without CI flakiness): real
+ * Kokoro-82M first-phrase TTFB is ~97 ms on a warm desktop handle; mobile CPU
+ * plus phonemize headroom lands comfortably under this ceiling.
+ */
+export declare const KOKORO_MOBILE_TTFA_BUDGET_MS = 700;
+/**
+ * `KokoroTtsBackend` is a streaming-only TTS backend. The model produces
+ * the full waveform in one forward, but we surface it as one body chunk +
+ * tail so the scheduler protocol is identical for both backends.
+ */
+export declare class KokoroTtsBackend implements OmniVoiceBackend, StreamingTtsBackend {
+    readonly id: "kokoro";
+    private readonly runtime;
+    private readonly defaultVoiceId;
+    private readonly streamingChunkSamples;
+    private phonemizer;
+    private readonly phonemizerOverride?;
+    constructor(deps: KokoroTtsBackendDeps);
+    /** Native sample rate of the model output (24 kHz for Kokoro v1.0). */
+    get sampleRate(): number;
+    /** Always true — `KokoroTtsBackend` satisfies `StreamingTtsBackend`. */
+    supportsStreamingTts(): boolean;
+    /**
+     * One-shot synthesis. Drives the streaming path internally and
+     * concatenates chunks. Cancellation observed at chunk boundaries.
+     */
+    synthesize(args: {
+        phrase: Phrase;
+        preset: SpeakerPreset;
+        cancelSignal: {
+            cancelled: boolean;
+        };
+        onKernelTick?: () => void;
+    }): Promise<AudioChunk>;
+    synthesizeStream(args: {
+        phrase: Phrase;
+        preset: SpeakerPreset;
+        cancelSignal: {
+            cancelled: boolean;
+        };
+        onChunk: (chunk: TtsPcmChunk) => boolean | undefined;
+        onKernelTick?: () => void;
+    }): Promise<{
+        cancelled: boolean;
+    }>;
+    dispose(): void;
+    private resolveVoice;
+    private ensurePhonemizer;
+}
+//# sourceMappingURL=kokoro-backend.d.ts.map

package/dist/services/voice/kokoro/kokoro-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kokoro-backend.d.ts","sourceRoot":"","sources":["../../../../src/services/voice/kokoro/kokoro-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACX,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EACX,oBAAoB,EAGpB,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IACjE;6EACyE;IACzE,OAAO,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB,EAAE,mBAAmB;IAC7E,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAmB;gBAE3C,IAAI,EAAE,oBAAoB;IAQtC,uEAAuE;IACvE,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,wEAAwE;IACxE,oBAAoB,IAAI,OAAO;IAI/B;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,aAAa,CAAC;QACtB,YAAY,EAAE;YAAE,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC;QACrC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;KAC1B,GAAG,OAAO,CAAC,UAAU,CAAC;IAgCjB,gBAAgB,CAAC,IAAI,EAAE;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,aAAa,CAAC;QACtB,YAAY,EAAE;YAAE,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC;QACrC,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,GAAG,SAAS,CAAC;QACrD,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;KAC1B,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAkEnC,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,YAAY;YASN,gBAAgB;CAM9B"}

package/dist/services/voice/kokoro/kokoro-engine-discovery.d.ts

@@ -0,0 +1,58 @@
+/**
+ * On-disk discovery for the Kokoro-only voice mode. Probes
+ * `<stateDir>/local-inference/models/kokoro/` (or `$ELIZA_KOKORO_MODEL_DIR`)
+ * for a Kokoro GGUF model file plus at least one voice `.bin` under
+ * `voices/`. Callers can pass an explicit model root to probe bundle-local
+ * Kokoro artifacts first. Returns null when anything is missing — no
+ * auto-download (AGENTS.md §3). GGUF-only: the ONNX path has been retired
+ * (see `runtimeKind` below).
+ *
+ * TRANSPORT NOTE — Kokoro synthesizes in-process through the fused
+ * `libelizainference` handle (`eliza_inference_kokoro_*`, added at ABI v10), the same
+ * dlopen()-ed lib as OmniVoice. The fork links Kokoro's native engine
+ * (`tools/kokoro/kokoro_lib`, its own GGUF reader + iSTFT decoder) into the
+ * fused build, and `KokoroFfiRuntime` drives it via `kokoroLoad` /
+ * `kokoroSynthesize`. This is the canonical path on every platform and the
+ * only one that ships on iOS / Google Play (those forbid the app opening a
+ * local TCP socket). The legacy `KokoroGgufRuntime` — POST `/v1/audio/speech`
+ * on a Kokoro-capable llama-server (the MTP gateway launched with
+ * `--kokoro-model`) — stays as an explicit dev/desktop opt-in
+ * (`KOKORO_BACKEND=fork`) and is never resolved on the mobile path. The GGUF
+ * is produced by the fork's `tools/kokoro/convert_kokoro_pth_to_gguf.py`.
+ *
+ * Env overrides:
+ *   ELIZA_KOKORO_MODEL_DIR        — directory root
+ *   ELIZA_KOKORO_MODEL_FILE       — exact filename inside the root
+ *                                   (ONNX or GGUF; the loader auto-detects)
+ *   ELIZA_KOKORO_DEFAULT_VOICE_ID — default voice id (e.g. `af_same`, `af_bella`)
+ */
+import type { KokoroModelLayout } from "./types";
+/** Canonical Kokoro v1.0 output sample rate. */
+export declare const KOKORO_DEFAULT_SAMPLE_RATE = 24000;
+/** True iff the candidate filename routes to the fused GGUF path. */
+export declare function isKokoroGgufFile(filename: string): boolean;
+export interface KokoroEngineDiscoveryResult {
+    layout: KokoroModelLayout;
+    /**
+     * Resolved default voice id. Prefers the catalog default
+     * (`KOKORO_DEFAULT_VOICE_ID` = `af_same`, Samantha) when its preset is on
+     * disk; falls back loudly to `KOKORO_FALLBACK_VOICE_ID` (`af_bella`) when
+     * Samantha's preset has not been produced yet; otherwise picks the first
+     * voice pack whose `.bin` is actually staged.
+     */
+    defaultVoiceId: string;
+    /**
+     * Resolved runtime kind. Always `"gguf"` — only GGUF model files are
+     * accepted by the discovery (ONNX paths have been retired).
+     */
+    runtimeKind: "gguf";
+}
+/** Returns the on-disk directory the discovery probes. */
+export declare function kokoroEngineModelDir(rootOverride?: string): string;
+/**
+ * Probe disk for a usable Kokoro layout. Returns null when any required
+ * piece is missing — the engine then falls back to its existing behaviour
+ * (fused omnivoice or `StubOmniVoiceBackend`).
+ */
+export declare function resolveKokoroEngineConfig(rootOverride?: string): KokoroEngineDiscoveryResult | null;
+//# sourceMappingURL=kokoro-engine-discovery.d.ts.map

package/dist/services/voice/kokoro/kokoro-engine-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kokoro-engine-discovery.d.ts","sourceRoot":"","sources":["../../../../src/services/voice/kokoro/kokoro-engine-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,SAAS,CAAC;AAOlE,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAiBjD,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,MAAM,WAAW,2BAA2B;IAC3C,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,YAAY,CAAC,EAAE,MAAM,GACnB,2BAA2B,GAAG,IAAI,CAuBpC"}