@elizaos/app-core 2.0.0-beta.2 → 2.0.11-beta.5

package/services/local-inference/voice/ffi-bindings.js

@@ -1,281 +0,0 @@
-/**
- * Node/Bun FFI binding to `libelizainference.{dylib,so,dll}`.
- *
- * The fused omnivoice + llama.cpp build (see
- * `packages/app-core/scripts/omnivoice-fuse/`) produces ONE shared
- * library that exports both `llama_*` and `omnivoice_*` symbols plus
- * the C ABI declared in `scripts/omnivoice-fuse/ffi.h`. This module is
- * the JS-side proxy for that ABI — it loads the library, binds every
- * `eliza_inference_*` symbol declared in `ffi.h`, and exposes a typed
- * handle (`ElizaInferenceFfi`) the voice lifecycle calls into.
- *
- * Runtime: production runs under Bun (Electrobun shell, Capacitor
- * bridge), so the loader uses `bun:ffi`. Tests that need to actually
- * load a `.dylib` against a stub library spawn a `bun` subprocess —
- * see `ffi-bindings.test.ts`. Calling this loader from a non-Bun
- * runtime (e.g. plain Node) throws `VoiceLifecycleError({code:
- * "missing-ffi"})` with a diagnostic explaining why.
- *
- * No defensive try/catch on the success path. Any dlopen failure,
- * symbol-resolution failure, or ABI mismatch is a structured throw
- * (AGENTS.md §3 + §9). The caller — `voice/lifecycle.ts` and
- * `voice/engine-bridge.ts` — surfaces it as a `VoiceLifecycleError` to
- * the UI.
- */
-import { VoiceLifecycleError } from "./lifecycle";
-/**
- * ABI version the JS binding was authored against. Must match the value
- * `eliza_inference_abi_version()` returns at runtime — a mismatch is a
- * hard error (AGENTS.md §3, §9: no silent compatibility shims).
- *
- * Bump in lockstep with `ELIZA_INFERENCE_ABI_VERSION` in
- * `scripts/omnivoice-fuse/ffi.h` whenever the C surface changes shape.
- */
-export const ELIZA_INFERENCE_ABI_VERSION = 1;
-/** Status codes mirrored from `ffi.h`. Negative = failure. */
-export const ELIZA_OK = 0;
-export const ELIZA_ERR_NOT_IMPLEMENTED = -1;
-export const ELIZA_ERR_INVALID_ARG = -2;
-export const ELIZA_ERR_BUNDLE_INVALID = -3;
-export const ELIZA_ERR_FFI_FAULT = -4;
-export const ELIZA_ERR_OOM = -5;
-export const ELIZA_ERR_ABI_MISMATCH = -6;
-/* ---------------------------------------------------------------- */
-/* Loader                                                           */
-/* ---------------------------------------------------------------- */
-/** Runtime detector: returns true when running under Bun. */
-function isBunRuntime() {
-    return typeof globalThis.Bun !== "undefined";
-}
-/**
- * Load `libelizainference` at `dylibPath` and bind every symbol
- * declared in `ffi.h`. The returned handle's methods delegate directly
- * to the library; they throw `VoiceLifecycleError` on any negative
- * return value or runtime fault.
- *
- * Throws synchronously (no Promise) when:
- *   - the JS runtime is not Bun (no FFI primitive available),
- *   - `dlopen` cannot find or open the library,
- *   - the library's reported ABI version does not match
- *     `ELIZA_INFERENCE_ABI_VERSION`.
- */
-export function loadElizaInferenceFfi(dylibPath) {
-    if (!isBunRuntime()) {
-        throw new VoiceLifecycleError("kernel-missing", `[ffi-bindings] Cannot load libelizainference: current runtime is not Bun. ` +
-            `The fused omnivoice FFI uses bun:ffi (production runs under Bun via Electrobun + Capacitor). ` +
-            `process.versions=${JSON.stringify(process.versions)}`);
-    }
-    if (!dylibPath || dylibPath.length === 0) {
-        throw new VoiceLifecycleError("kernel-missing", "[ffi-bindings] loadElizaInferenceFfi: dylibPath is required");
-    }
-    return bindWithBunFfi(dylibPath);
-}
-/**
- * Resolve `bun:ffi` synchronously via the Bun-injected `require`.
- * Bun exposes a CJS `require` even from ESM modules, and `bun:ffi` is
- * a built-in importable that way. Doing this dynamically (rather than a
- * static `import "bun:ffi"`) keeps the module loadable under plain Node
- * for the parts of the test suite that don't need the FFI.
- */
-function loadBunFfiModule() {
-    const req = globalThis.Bun?.__require;
-    if (typeof req === "function") {
-        return req("bun:ffi");
-    }
-    // Fallback to `module.createRequire` on the current file when running
-    // under Bun via an ESM entry without `Bun.__require`. This is rare —
-    // current Bun exposes `Bun.__require` — but we keep the path explicit
-    // so the failure mode is `MODULE_NOT_FOUND` (a real error), not a
-    // silent fall-through.
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const mod = require("node:module");
-    const r = mod.createRequire(import.meta.url);
-    return r("bun:ffi");
-}
-function bindWithBunFfi(dylibPath) {
-    let ffi;
-    try {
-        ffi = loadBunFfiModule();
-    }
-    catch (err) {
-        throw new VoiceLifecycleError("kernel-missing", `[ffi-bindings] Cannot load bun:ffi while opening ${dylibPath}: ${formatFfiError(err)}`);
-    }
-    const T = ffi.FFIType;
-    // All `char *` arguments are typed as T.ptr — Bun's `T.cstring` is a
-    // RETURN-only type for "library hands back a NUL-terminated string".
-    // For inputs we encode UTF-8 to a NUL-terminated Buffer on the JS
-    // side and pass `ffi.ptr(buffer)`.
-    let lib;
-    try {
-        lib = ffi.dlopen(dylibPath, {
-            eliza_inference_abi_version: { args: [], returns: T.cstring },
-            eliza_inference_create: {
-                args: [T.ptr, T.ptr],
-                returns: T.ptr,
-            },
-            eliza_inference_destroy: { args: [T.ptr], returns: T.void },
-            eliza_inference_mmap_acquire: {
-                args: [T.ptr, T.ptr, T.ptr],
-                returns: T.i32,
-            },
-            eliza_inference_mmap_evict: {
-                args: [T.ptr, T.ptr, T.ptr],
-                returns: T.i32,
-            },
-            eliza_inference_tts_synthesize: {
-                args: [T.ptr, T.ptr, T.usize, T.ptr, T.ptr, T.usize, T.ptr],
-                returns: T.i32,
-            },
-            eliza_inference_asr_transcribe: {
-                args: [T.ptr, T.ptr, T.usize, T.i32, T.ptr, T.usize, T.ptr],
-                returns: T.i32,
-            },
-            eliza_inference_free_string: { args: [T.ptr], returns: T.void },
-        });
-    }
-    catch (err) {
-        throw new VoiceLifecycleError("kernel-missing", `[ffi-bindings] Failed to open libelizainference at ${dylibPath}: ${formatFfiError(err)}`);
-    }
-    // ABI version check — refuse to run if the loaded library is not v1.
-    const reported = readCString(lib.symbols.eliza_inference_abi_version(), ffi);
-    if (reported !== String(ELIZA_INFERENCE_ABI_VERSION)) {
-        lib.close();
-        throw new VoiceLifecycleError("kernel-missing", `[ffi-bindings] ABI mismatch: binding expected v${ELIZA_INFERENCE_ABI_VERSION}, ` +
-            `library at ${dylibPath} reports v${reported}. The fused build was produced ` +
-            `against a different ffi.h — rebuild against the current header.`);
-    }
-    /**
-     * Read `*outErrPtr` (a `char**` that the library populated with a
-     * heap-allocated NUL-terminated string), free the underlying buffer
-     * via `eliza_inference_free_string`, and return the JS string. When
-     * the library left `*outErrPtr` as NULL, returns null.
-     */
-    function takeError(outErrPtrBuf) {
-        const ptrValue = outErrPtrBuf[0];
-        if (ptrValue === undefined || ptrValue === 0n)
-            return null;
-        const cstr = new ffi.CString(Number(ptrValue));
-        const message = cstr.toString();
-        lib.symbols.eliza_inference_free_string(Number(ptrValue));
-        return message;
-    }
-    function makeOutErr() {
-        const buf = new BigUint64Array(1);
-        return { buf, ptr: ffi.ptr(buf) };
-    }
-    /**
-     * Encode a JS string to a NUL-terminated UTF-8 buffer and return a
-     * `T.ptr`-compatible pointer suitable for `const char *` arguments.
-     * Returns null when the input is null — the C ABI accepts NULL for
-     * optional arguments like `speaker_preset_id`.
-     */
-    function cstr(value) {
-        if (value === null)
-            return { ptr: null, bytes: 0 };
-        const bytes = Buffer.from(value, "utf8");
-        const buf = Buffer.alloc(bytes.byteLength + 1);
-        bytes.copy(buf);
-        return { ptr: ffi.ptr(buf), bytes: bytes.byteLength };
-    }
-    function failureCode(rc) {
-        if (rc === ELIZA_ERR_OOM)
-            return "ram-pressure";
-        if (rc === ELIZA_ERR_FFI_FAULT)
-            return "mmap-fail";
-        if (rc === ELIZA_ERR_NOT_IMPLEMENTED)
-            return "kernel-missing";
-        if (rc === ELIZA_ERR_ABI_MISMATCH)
-            return "kernel-missing";
-        if (rc === ELIZA_ERR_BUNDLE_INVALID)
-            return "kernel-missing";
-        return "kernel-missing";
-    }
-    return {
-        libraryPath: dylibPath,
-        libraryAbiVersion: reported,
-        create(bundleDir) {
-            const err = makeOutErr();
-            const handle = lib.symbols.eliza_inference_create(cstr(bundleDir).ptr, err.ptr);
-            if (handle === 0n) {
-                const message = takeError(err.buf) ??
-                    "[ffi-bindings] eliza_inference_create returned NULL with no diagnostic";
-                throw new VoiceLifecycleError("kernel-missing", message);
-            }
-            return handle;
-        },
-        destroy(ctx) {
-            lib.symbols.eliza_inference_destroy(ctx);
-        },
-        mmapAcquire(ctx, region) {
-            const err = makeOutErr();
-            const rc = lib.symbols.eliza_inference_mmap_acquire(ctx, cstr(region).ptr, err.ptr);
-            if (rc !== ELIZA_OK) {
-                const message = takeError(err.buf) ??
-                    `[ffi-bindings] eliza_inference_mmap_acquire(${region}) rc=${rc}`;
-                throw new VoiceLifecycleError(failureCode(rc), message);
-            }
-        },
-        mmapEvict(ctx, region) {
-            const err = makeOutErr();
-            const rc = lib.symbols.eliza_inference_mmap_evict(ctx, cstr(region).ptr, err.ptr);
-            if (rc !== ELIZA_OK) {
-                const message = takeError(err.buf) ??
-                    `[ffi-bindings] eliza_inference_mmap_evict(${region}) rc=${rc}`;
-                throw new VoiceLifecycleError(failureCode(rc), message);
-            }
-        },
-        ttsSynthesize({ ctx, text, speakerPresetId, out }) {
-            const err = makeOutErr();
-            const textArg = cstr(text);
-            const speakerArg = cstr(speakerPresetId);
-            const rc = lib.symbols.eliza_inference_tts_synthesize(ctx, textArg.ptr, BigInt(textArg.bytes), speakerArg.ptr, ffi.ptr(out), BigInt(out.length), err.ptr);
-            if (rc < 0) {
-                const message = takeError(err.buf) ??
-                    `[ffi-bindings] eliza_inference_tts_synthesize rc=${rc}`;
-                throw new VoiceLifecycleError(failureCode(rc), message);
-            }
-            return rc;
-        },
-        asrTranscribe({ ctx, pcm, sampleRateHz, maxTextBytes }) {
-            const err = makeOutErr();
-            const cap = maxTextBytes ?? 4096;
-            const outText = new Uint8Array(cap);
-            const rc = lib.symbols.eliza_inference_asr_transcribe(ctx, ffi.ptr(pcm), BigInt(pcm.length), sampleRateHz, ffi.ptr(outText), BigInt(cap), err.ptr);
-            if (rc < 0) {
-                const message = takeError(err.buf) ??
-                    `[ffi-bindings] eliza_inference_asr_transcribe rc=${rc}`;
-                throw new VoiceLifecycleError(failureCode(rc), message);
-            }
-            const nul = outText.indexOf(0, 0);
-            const len = nul >= 0 ? nul : rc;
-            return Buffer.from(outText.buffer, outText.byteOffset, len).toString("utf8");
-        },
-        close() {
-            lib.close();
-        },
-    };
-}
-function formatFfiError(err) {
-    if (err instanceof Error) {
-        return err.message;
-    }
-    return String(err);
-}
-/**
- * Decode a `T.cstring` return value (Bun returns these as either a
- * lazy string-like object with `toString()` or a JS string depending
- * on version). Wrap so the caller never has to branch.
- */
-function readCString(value, ffi) {
-    if (typeof value === "string")
-        return value;
-    if (value === null || value === undefined)
-        return "";
-    if (typeof value === "object" && value !== null && "toString" in value) {
-        return value.toString();
-    }
-    if (typeof value === "number" || typeof value === "bigint") {
-        return new ffi.CString(value).toString();
-    }
-    return String(value);
-}

package/services/local-inference/voice/index.d.ts

@@ -1,51 +0,0 @@
-export * from "./types";
-export { PhraseChunker, chunkTokens } from "./phrase-chunker";
-export { RollbackQueue, type RollbackEvent } from "./rollback-queue";
-export { BargeInController, type BargeInListener, type CancelSignal, } from "./barge-in";
-export { PcmRingBuffer, InMemoryAudioSink } from "./ring-buffer";
-export { SpeakerPresetCache, type PresetBundlePaths, type LoadedPresetBundle, } from "./speaker-preset-cache";
-export { VOICE_PRESET_MAGIC, VOICE_PRESET_VERSION, VOICE_PRESET_HEADER_BYTES, VoicePresetFormatError, readVoicePresetFile, writeVoicePresetFile, type VoicePresetFile, type VoicePresetSeedPhrase, } from "./voice-preset-format";
-export { CharacterPhonemeStub, type Phoneme, type PhonemeTokenizer, } from "./phoneme-tokenizer";
-export { PhraseCache, canonicalizePhraseText, type CachedPhraseAudio, } from "./phrase-cache";
-export { VoiceScheduler, type SchedulerEvents, type SchedulerDeps, } from "./scheduler";
-export { EngineVoiceBridge, StubOmniVoiceBackend, FfiOmniVoiceBackend, VoiceStartupError, type EngineVoiceBridgeOptions, } from "./engine-bridge";
-export { SharedResourceRegistry, type DflashDrafterHandle, type KernelSet, type MmapRegionHandle, type RefCountedResource, type SchedulerSlot, type SharedTokenizer, } from "./shared-resources";
-export { VoiceLifecycle, VoiceLifecycleError, type ArmedResources, type TextResources, type VoiceLifecycleEvents, type VoiceLifecycleLoaders, type VoiceLifecycleState, } from "./lifecycle";
-/**
- * Voice on/off invariants (binding for every consumer of this module):
- *
- * 1. Voice is OFF by default — text + drafter only. TTS, ASR, the
- *    speaker preset cache, the phrase cache, the chunker, the
- *    rollback queue, the barge-in controller, and the ring buffer
- *    are NOT in RAM until `VoiceLifecycle.arm()` is called.
- *
- * 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 DFlash 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/services/local-inference/voice/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/local-inference/voice/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EACL,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,KAAK,OAAO,EACZ,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG"}

package/services/local-inference/voice/index.js

@@ -1,50 +0,0 @@
-export * from "./types";
-export { PhraseChunker, chunkTokens } from "./phrase-chunker";
-export { RollbackQueue } from "./rollback-queue";
-export { BargeInController, } from "./barge-in";
-export { PcmRingBuffer, InMemoryAudioSink } from "./ring-buffer";
-export { SpeakerPresetCache, } from "./speaker-preset-cache";
-export { VOICE_PRESET_MAGIC, VOICE_PRESET_VERSION, VOICE_PRESET_HEADER_BYTES, VoicePresetFormatError, readVoicePresetFile, writeVoicePresetFile, } from "./voice-preset-format";
-export { CharacterPhonemeStub, } from "./phoneme-tokenizer";
-export { PhraseCache, canonicalizePhraseText, } from "./phrase-cache";
-export { VoiceScheduler, } from "./scheduler";
-export { EngineVoiceBridge, StubOmniVoiceBackend, FfiOmniVoiceBackend, VoiceStartupError, } from "./engine-bridge";
-export { SharedResourceRegistry, } from "./shared-resources";
-export { VoiceLifecycle, VoiceLifecycleError, } from "./lifecycle";
-/**
- * Voice on/off invariants (binding for every consumer of this module):
- *
- * 1. Voice is OFF by default — text + drafter only. TTS, ASR, the
- *    speaker preset cache, the phrase cache, the chunker, the
- *    rollback queue, the barge-in controller, and the ring buffer
- *    are NOT in RAM until `VoiceLifecycle.arm()` is called.
- *
- * 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 DFlash 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.
- */

package/services/local-inference/voice/lifecycle.d.ts

@@ -1,135 +0,0 @@
-/**
- * Voice on/off state machine.
- *
- * Per `packages/inference/AGENTS.md` §4 + this scope's design goals,
- * voice is OFF by default. Text + drafter are hot; TTS, ASR, the
- * speaker preset cache and phrase cache, the chunker, the rollback
- * queue, the barge-in controller, and the ring buffer are NOT in RAM.
- *
- * Transitions are explicit. Illegal transitions throw — no
- * "log-and-continue" (AGENTS.md §9). The transition to `voice-off`
- * MUST issue a real page-eviction call on the TTS/ASR mmap regions
- * (see `MmapRegionHandle.evictPages()` in `shared-resources.ts`) so
- * the OS can reclaim those pages.
- *
- *   ┌──────────┐ start()  ┌──────────────┐ armed   ┌──────────┐
- *   │ voice-off│─────────▶│ voice-arming │────────▶│ voice-on │
- *   └──────────┘          └──────────────┘         └──────────┘
- *        ▲                       │ start fails           │ stop()
- *        │ disarmed              ▼                       ▼
- *  ┌──────────────────┐    ┌──────────────┐  ┌────────────────────┐
- *  │ voice-disarming  │◀───│ voice-error  │  │  voice-disarming   │
- *  └──────────────────┘    └──────────────┘  └────────────────────┘
- *        │                                            │
- *        └────────────────── disarmed ◀───────────────┘
- *
- * `voice-error` is terminal until `reset()` is called. There is no
- * automatic retry: a missing kernel, mmap fail, or RAM-pressure
- * refusal MUST surface to the caller.
- */
-import type { DflashDrafterHandle, KernelSet, MmapRegionHandle, RefCountedResource, SchedulerSlot, SharedResourceRegistry, SharedTokenizer } from "./shared-resources";
-/**
- * Discriminated union — never widened to `string`. Each state may carry
- * payload (the `armed` payload includes the loaded mmap regions so the
- * disarm path can call `evictPages()` on them).
- */
-export type VoiceLifecycleState = {
-    readonly kind: "voice-off";
-} | {
-    readonly kind: "voice-arming";
-} | {
-    readonly kind: "voice-on";
-    readonly resources: ArmedResources;
-} | {
-    readonly kind: "voice-disarming";
-    readonly resources: ArmedResources;
-} | {
-    readonly kind: "voice-error";
-    readonly error: VoiceLifecycleError;
-};
-/**
- * Resources held while voice is armed. Released in reverse order on
- * disarm; the mmap regions get an explicit `evictPages()` call before
- * `release()` so the OS reclaims pages even if the FFI keeps the file
- * descriptor open for a future re-arm.
- */
-export interface ArmedResources {
-    readonly tts: MmapRegionHandle;
-    readonly asr: MmapRegionHandle;
-    /** Speaker preset + phrase cache — kept in a small LRU after disarm. */
-    readonly voiceCaches: RefCountedResource;
-    /** Voice-specific scheduler nodes (chunker, rollback, ring buffer, barge-in). */
-    readonly voiceSchedulerNodes: RefCountedResource;
-}
-/**
- * Resources held while text is up. Acquired by the engine when the
- * bundle is activated; voice piggy-backs on these without re-loading.
- */
-export interface TextResources {
-    readonly tokenizer: SharedTokenizer;
-    readonly textWeights: MmapRegionHandle;
-    readonly kernels: KernelSet;
-    readonly scheduler: SchedulerSlot;
-    readonly drafter: DflashDrafterHandle;
-}
-/**
- * Structured failure surfaced to the caller. Never a generic `Error` —
- * the caller (engine + UI) needs to distinguish RAM pressure from a
- * missing kernel from a manifest mismatch (AGENTS.md §3).
- */
-export declare class VoiceLifecycleError extends Error {
-    readonly code: "ram-pressure" | "mmap-fail" | "kernel-missing" | "illegal-transition" | "arm-failed" | "disarm-failed";
-    constructor(code: VoiceLifecycleError["code"], message: string);
-}
-/**
- * Loader functions injected at construction. Splitting these out keeps
- * `VoiceLifecycle` independent of FFI specifics — the engine wires real
- * loaders at runtime; tests inject mocks. Each loader MUST throw on
- * failure (AGENTS.md §3 — no silent fallback).
- */
-export interface VoiceLifecycleLoaders {
-    loadTtsRegion(): Promise<MmapRegionHandle>;
-    loadAsrRegion(): Promise<MmapRegionHandle>;
-    loadVoiceCaches(): Promise<RefCountedResource>;
-    loadVoiceSchedulerNodes(): Promise<RefCountedResource>;
-}
-export interface VoiceLifecycleEvents {
-    onTransition?(prev: VoiceLifecycleState, next: VoiceLifecycleState): void;
-}
-export declare class VoiceLifecycle {
-    private state;
-    private readonly registry;
-    private readonly loaders;
-    private readonly events;
-    constructor(args: {
-        registry: SharedResourceRegistry;
-        loaders: VoiceLifecycleLoaders;
-        events?: VoiceLifecycleEvents;
-    });
-    current(): VoiceLifecycleState;
-    /**
-     * Transition `voice-off → voice-arming → voice-on`. Loads TTS + ASR
-     * mmap regions, voice caches, voice scheduler nodes. Each load throws
-     * on failure; a thrown loader transitions the state to `voice-error`
-     * and re-throws so the caller sees the structured cause. No partial
-     * arm: either all four resources are held or none are.
-     */
-    arm(): Promise<ArmedResources>;
-    /**
-     * Transition `voice-on → voice-disarming → voice-off`. Calls
-     * `evictPages()` on the TTS + ASR mmap regions before releasing them
-     * so the OS reclaims the pages even if another consumer keeps the
-     * file descriptor open. The voice caches stay in the registry as
-     * tiny (KB-scale) entries — only the heavy mmap regions get evicted.
-     */
-    disarm(): Promise<void>;
-    /**
-     * Reset from `voice-error` back to `voice-off`. Required because
-     * `voice-error` is terminal — the engine must explicitly acknowledge
-     * the failure before the user can re-attempt voice. There is no
-     * automatic retry path.
-     */
-    reset(): void;
-    private transition;
-}
-//# sourceMappingURL=lifecycle.d.ts.map

package/services/local-inference/voice/lifecycle.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/local-inference/voice/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACjC;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;CAAE,GACxE;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,iFAAiF;IACjF,QAAQ,CAAC,mBAAmB,EAAE,kBAAkB,CAAC;CAClD;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;CACvC;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EACT,cAAc,GACd,WAAW,GACX,gBAAgB,GAChB,oBAAoB,GACpB,YAAY,GACZ,eAAe,CAAC;gBAER,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;CAK/D;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3C,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3C,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/C,uBAAuB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,CAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC3E;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,IAAI,EAAE;QAChB,QAAQ,EAAE,sBAAsB,CAAC;QACjC,OAAO,EAAE,qBAAqB,CAAC;QAC/B,MAAM,CAAC,EAAE,oBAAoB,CAAC;KAC/B;IAMD,OAAO,IAAI,mBAAmB;IAI9B;;;;;;OAMG;IACG,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC;IA+CpC;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD7B;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,UAAU;CAKnB"}