@elizaos/app-core 2.0.0-beta.3 → 2.0.11-beta.6

package/scripts/generate-onboarding-voicelines.mjs

@@ -1,194 +0,0 @@
-#!/usr/bin/env node
-/**
- * Generate static MP3 voicelines for onboarding character catchphrases.
- *
- * Usage:
- *   ELEVENLABS_API_KEY=sk_... node scripts/generate-onboarding-voicelines.mjs
- *
- * Output: packages/app/public/audio/onboarding/{characterId}-{lang}.mp3
- */
-
-import { mkdirSync, writeFileSync } from "node:fs";
-import { resolve } from "node:path";
-
-const API_KEY = process.env.ELEVENLABS_API_KEY;
-if (!API_KEY) {
-  console.error("Set ELEVENLABS_API_KEY environment variable");
-  process.exit(1);
-}
-
-const OUTPUT_DIR = resolve("packages/app/public/audio/onboarding");
-mkdirSync(OUTPUT_DIR, { recursive: true });
-
-// Voice preset ID → ElevenLabs voice ID (from PREMADE_VOICES in voice/types.ts)
-const VOICE_MAP = {
-  sarah: "EXAVITQu4vr4xnSDxMaL",
-  jin: "6IwYbsNENZgAB1dtBZDp",
-  kei: "eadgjmk4R4uojdsheG9t",
-  momo: "n7Wi4g1bhpw4Bs8HK5ph",
-  rin: "cNYrMw9glwJZXR8RwbuR",
-  ryu: "QzTKubutNn9TjrB7Xb2Q",
-  satoshi: "7cOBG34AiHrAzs842Rdi",
-  yuki: "4tRn1lSkEn13EVTuqb0g",
-};
-
-// Character definitions — catchphrases extracted from
-// eliza/packages/shared/src/onboarding-presets.characters.ts
-const CHARACTERS = [
-  {
-    id: "chen",
-    voice: "sarah",
-    catchphrases: {
-      en: "Let's get to work!",
-      "zh-CN": "你还好吗？",
-      ko: "괜찮아?",
-      es: "¿todo bien?",
-      pt: "tá tudo bem?",
-      vi: "ổn không?",
-      tl: "ayos ka?",
-    },
-  },
-  {
-    id: "jin",
-    voice: "jin",
-    catchphrases: {
-      en: "Anything you need, boss!",
-      "zh-CN": "现在做哪个？",
-      ko: "뭘 먼저 올릴까?",
-      es: "¿qué vamos a sacar?",
-      pt: "o que a gente vai lançar?",
-      vi: "mình chốt gì đây?",
-      tl: "ano'ng isi-ship natin?",
-    },
-  },
-  {
-    id: "kei",
-    voice: "kei",
-    catchphrases: {
-      en: "Hey sure. Why not?",
-      "zh-CN": "你又弄坏什么了？",
-      ko: "뭘 또 망가뜨렸어?",
-      es: "¿qué rompiste ahora?",
-      pt: "o que você quebrou agora?",
-      vi: "bạn làm hỏng gì nữa rồi?",
-      tl: "ano na namang sinira mo?",
-    },
-  },
-  {
-    id: "momo",
-    voice: "momo",
-    catchphrases: {
-      en: "I can't wait!",
-      "zh-CN": "发我吧",
-      ko: "보내줘",
-      es: "mándamelo",
-      pt: "me manda",
-      vi: "gửi mình đi",
-      tl: "send mo lang",
-    },
-  },
-  {
-    id: "rin",
-    voice: "rin",
-    catchphrases: {
-      en: "I won't let you down.",
-      "zh-CN": "等下，这个有点会",
-      ko: "잠깐, 이건 좀 귀엽다",
-      es: "ok, espera, eso está cute",
-      pt: "pera, isso ficou fofo",
-      vi: "ơ, cái này xinh đấy",
-      tl: "teka, ang cute nito",
-    },
-  },
-  {
-    id: "ryu",
-    voice: "ryu",
-    catchphrases: {
-      en: "How bad could it be?",
-      "zh-CN": "说吧",
-      ko: "말해봐",
-      es: "háblame",
-      pt: "fala comigo",
-      vi: "nói đi",
-      tl: "sabihin mo",
-    },
-  },
-  {
-    id: "satoshi",
-    voice: "satoshi",
-    catchphrases: {
-      en: "I'll handle it.",
-      "zh-CN": "现在怎么玩？",
-      ko: "지금 플랜 뭐야?",
-      es: "¿cuál es la jugada?",
-      pt: "qual é a jogada?",
-      vi: "kèo nào đây?",
-      tl: "ano play natin?",
-    },
-  },
-  {
-    id: "yuki",
-    voice: "yuki",
-    catchphrases: {
-      en: "Are you thinking what I'm thinking?",
-      "zh-CN": "先问一句",
-      ko: "잠깐, 한 가지만",
-      es: "espera, una pregunta",
-      pt: "pera, uma pergunta",
-      vi: "khoan, một câu thôi",
-      tl: "sandali, isang tanong",
-    },
-  },
-];
-
-async function generateTts(voiceId, text) {
-  const url = `https://api.elevenlabs.io/v1/text-to-speech/${voiceId}`;
-  const res = await fetch(url, {
-    method: "POST",
-    headers: {
-      "xi-api-key": API_KEY,
-      "Content-Type": "application/json",
-      Accept: "audio/mpeg",
-    },
-    body: JSON.stringify({
-      text,
-      model_id: "eleven_flash_v2_5",
-      output_format: "mp3_44100_128",
-    }),
-  });
-  if (!res.ok) {
-    const body = await res.text().catch(() => "");
-    throw new Error(`ElevenLabs ${res.status}: ${body}`);
-  }
-  return Buffer.from(await res.arrayBuffer());
-}
-
-let generated = 0;
-let failed = 0;
-
-for (const char of CHARACTERS) {
-  const voiceId = VOICE_MAP[char.voice];
-  if (!voiceId) {
-    console.error(`  No voice mapping for ${char.id} (preset: ${char.voice})`);
-    failed++;
-    continue;
-  }
-
-  for (const [lang, catchphrase] of Object.entries(char.catchphrases)) {
-    const filename = `${char.id}-${lang}.mp3`;
-    const outPath = resolve(OUTPUT_DIR, filename);
-    try {
-      console.log(`  ${filename}: "${catchphrase}" (voice: ${char.voice})`);
-      const mp3 = await generateTts(voiceId, catchphrase);
-      writeFileSync(outPath, mp3);
-      generated++;
-      // Small delay to avoid rate limiting
-      await new Promise((r) => setTimeout(r, 300));
-    } catch (err) {
-      console.error(`  FAILED ${filename}: ${err.message}`);
-      failed++;
-    }
-  }
-}
-
-console.log(`\nDone: ${generated} generated, ${failed} failed`);

package/scripts/generated/static-asset-manifest.json

@@ -1,4 +0,0 @@
-{
-  "app": [],
-  "homepage": []
-}

package/scripts/normalize-parallax-capture.ts

@@ -1,97 +0,0 @@
-import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { normalizeParallaxCapture } from "../src/benchmark/replay-capture.ts";
-
-interface CliArgs {
-  input: string;
-  output?: string;
-  glob?: string;
-}
-
-function parseArgs(argv: string[]): CliArgs {
-  const args: CliArgs = { input: "" };
-  for (let i = 0; i < argv.length; i++) {
-    const token = argv[i];
-    if (token === "--input") args.input = argv[++i] ?? "";
-    else if (token === "--output") args.output = argv[++i];
-    else if (token === "--glob") args.glob = argv[++i];
-  }
-  if (!args.input) {
-    throw new Error(
-      "Missing required --input argument. Example: --input /path/to/capture.json",
-    );
-  }
-  return args;
-}
-
-function toReplayFilename(filePath: string): string {
-  const parsed = path.parse(filePath);
-  return `${parsed.name}.replay.json`;
-}
-
-function matchesSimpleGlob(filename: string, glob: string): boolean {
-  // Minimal glob support for common patterns like *.json and *.capture.json.
-  if (!glob.includes("*")) return filename === glob;
-  const [prefix, suffix] = glob.split("*");
-  return filename.startsWith(prefix) && filename.endsWith(suffix ?? "");
-}
-
-async function normalizeFile(
-  inputPath: string,
-  outputPath: string,
-): Promise<void> {
-  const raw = await readFile(inputPath, "utf8");
-  const parsed = JSON.parse(raw) as unknown;
-  const normalized = normalizeParallaxCapture(parsed);
-  await mkdir(path.dirname(outputPath), { recursive: true });
-  await writeFile(
-    outputPath,
-    `${JSON.stringify(normalized, null, 2)}\n`,
-    "utf8",
-  );
-}
-
-async function run(): Promise<void> {
-  const args = parseArgs(process.argv.slice(2));
-  const inputPath = path.resolve(args.input);
-  const inputStat = await stat(inputPath);
-
-  if (inputStat.isFile()) {
-    const outputPath = path.resolve(
-      args.output ??
-        path.join(path.dirname(inputPath), toReplayFilename(inputPath)),
-    );
-    await normalizeFile(inputPath, outputPath);
-    console.log(outputPath);
-    return;
-  }
-
-  if (!inputStat.isDirectory()) {
-    throw new Error(`Input path is neither file nor directory: ${inputPath}`);
-  }
-
-  const glob = args.glob ?? "*.json";
-  const outDir = path.resolve(args.output ?? inputPath);
-  const fs = await import("node:fs/promises");
-  const entries = await fs.readdir(inputPath, { withFileTypes: true });
-  let normalizedCount = 0;
-
-  for (const entry of entries) {
-    if (!entry.isFile()) continue;
-    if (!matchesSimpleGlob(entry.name, glob)) continue;
-
-    const sourceFile = path.join(inputPath, entry.name);
-    const outputFile = path.join(outDir, toReplayFilename(entry.name));
-    await normalizeFile(sourceFile, outputFile);
-    normalizedCount += 1;
-  }
-
-  console.log(`${outDir} (${normalizedCount} files)`);
-}
-
-run().catch((error) => {
-  console.error(
-    `[normalize-parallax-capture] ${error instanceof Error ? error.message : String(error)}`,
-  );
-  process.exitCode = 1;
-});

package/scripts/omnivoice-fuse/Makefile

@@ -1,44 +0,0 @@
-# Builds libelizainference_stub.{dylib,so} from ffi-stub.c.
-#
-# This produces a real shared library that exports the same symbol set
-# as the (planned) fused build, so the JS FFI binding can be tested
-# end-to-end without requiring the full omnivoice + llama.cpp fusion.
-#
-# Usage:
-#   make                            # builds the platform-default artifact
-#   make libelizainference_stub.dylib   # macOS
-#   make libelizainference_stub.so      # Linux
-#   make verify                     # builds + lists exported eliza_* symbols
-#   make clean
-
-UNAME_S := $(shell uname -s)
-
-CC      ?= clang
-CFLAGS  := -Wall -Wextra -Wpedantic -Werror -O2 -fPIC -std=c11 -fvisibility=default
-LDFLAGS_DARWIN := -shared -Wl,-install_name,@rpath/libelizainference_stub.dylib
-LDFLAGS_LINUX  := -shared -Wl,-soname,libelizainference_stub.so
-
-ifeq ($(UNAME_S),Darwin)
-DEFAULT_TARGET := libelizainference_stub.dylib
-NM             := nm -gU
-else
-DEFAULT_TARGET := libelizainference_stub.so
-NM             := nm -D --defined-only
-endif
-
-.PHONY: all clean verify
-all: $(DEFAULT_TARGET)
-
-libelizainference_stub.dylib: ffi-stub.c ffi.h
-	$(CC) $(CFLAGS) $(LDFLAGS_DARWIN) -o $@ ffi-stub.c
-
-libelizainference_stub.so: ffi-stub.c ffi.h
-	$(CC) $(CFLAGS) $(LDFLAGS_LINUX) -o $@ ffi-stub.c
-
-verify: $(DEFAULT_TARGET)
-	@echo "[verify] eliza_* exports in $(DEFAULT_TARGET):"
-	@$(NM) $(DEFAULT_TARGET) | grep -E ' _?eliza_inference_' || \
-		(echo "[verify] FAILED: no eliza_inference_* symbols found" && exit 1)
-
-clean:
-	rm -f libelizainference_stub.dylib libelizainference_stub.so

package/scripts/omnivoice-fuse/README.md

@@ -1,266 +0,0 @@
-# omnivoice-fuse: source-level fusion of omnivoice.cpp into milady-ai/llama.cpp
-
-This directory contains the helpers + patch material that the build script
-`packages/app-core/scripts/build-llama-cpp-dflash.mjs` invokes when one of
-the fused targets (e.g. `darwin-arm64-metal-fused`) is requested.
-
-The fused build produces ONE shared library and ONE server binary that
-expose both `llama_*` (text + vision) and `omnivoice_*` (TTS + ASR)
-symbols. This is the "one process, one llama.cpp build, one GGML pin"
-contract from `packages/inference/AGENTS.md` §4.
-
-## Pins (binding)
-
-| Component        | Repo                                                  | Pin                                                                |
-| ---------------- | ----------------------------------------------------- | ------------------------------------------------------------------ |
-| omnivoice.cpp    | `https://github.com/ServeurpersoCom/omnivoice.cpp`    | `38f824023d12b21a7c324651b18bd90f16d8bb86` (master HEAD 2026-05-10) |
-| omnivoice ggml   | `https://github.com/ServeurpersoCom/ggml.git`         | `0e3980ef205ea3639650f59e54cfeecd7d947700` (its `ggml` submodule)  |
-| milady llama.cpp | `https://github.com/milady-ai/llama.cpp.git`          | `v0.4.0-milady` (`08032d57`) — see `build-llama-cpp-dflash.mjs`    |
-
-## GGML pin reconciliation strategy
-
-omnivoice.cpp ships its own ggml fork as a git submodule (commit
-`0e3980ef…`), and pulls it into the build with `add_subdirectory(ggml)`.
-The milady-ai/llama.cpp fork ships its own ggml in-tree (at
-`ggml/`, NOT a submodule) with the TurboQuant + QJL + PolarQuant + DFlash
-patches that the kernels in `packages/inference/{metal,vulkan}` are
-verified against.
-
-**Two ggml trees in one build tree is illegal.** The kernels in this
-repo are checked against the milady ggml only — the ServeurpersoCom ggml
-does not have TurboQuant centroids, QJL projections, PolarQuant
-centroids, or DFlash flash-attn entry points. Targeting both would
-either (a) link two different ggml libraries into the same process
-(undefined-behavior territory: duplicate `ggml_*` exports, divergent
-struct layouts) or (b) silently use whichever comes first in link order
-and lose half the contract.
-
-**Strategy chosen: graft, not submodule swap.** When we prepare the
-fused checkout we:
-
-1. Clone the milady-ai/llama.cpp fork as the build root (same as the
-   non-fused build does today).
-2. Clone omnivoice.cpp at its pin into a sibling directory.
-3. **Discard omnivoice's `ggml/` subdirectory entirely.** No
-   `git submodule update --init` for `ggml`, no `add_subdirectory(ggml)`
-   from omnivoice's CMakeLists.txt. The only ggml in the merged tree is
-   llama.cpp's.
-4. Copy omnivoice's `src/`, `tools/`, and `examples/` into the llama.cpp
-   tree under stable paths:
-   - `omnivoice/src/`     ← omnivoice `src/`
-   - `omnivoice/tools/`   ← omnivoice `tools/`
-   - `omnivoice/examples/` ← omnivoice `examples/` (data files only)
-5. Append a CMake graft block to llama.cpp's root `CMakeLists.txt` that:
-   - declares `omnivoice-core` (static archive) over the copied sources,
-   - links it against llama.cpp's existing `ggml` / `ggml-base` /
-     `ggml-cpu` / per-backend targets (so it shares one ggml ABI),
-   - emits a fused server target (`llama-omnivoice-server`) that links
-     both `llama` and `omnivoice-core` into one process,
-   - emits a fused shared library target (`libelizainference`) so
-     mobile/desktop bridges can dlopen one .so/.dylib and resolve both
-     symbol families.
-6. (When required) apply patches from `omnivoice-fuse/patches/` to
-   reconcile any compile-time API drift between omnivoice's expected
-   ggml surface (the ServeurpersoCom fork) and the milady ggml. Each
-   patch is documented at the top with the symbol/struct it touches and
-   the upstream commit that introduced the drift.
-
-This is the lowest-blast-radius approach. We do NOT rebase omnivoice
-onto a clean ggml tip and we do NOT carry the ServeurpersoCom ggml
-submodule alongside ours. If the omnivoice authors upstream changes to
-their ggml fork that we want, we cherry-pick those into milady-ai/ggml
-explicitly, and bump the omnivoice pin in this README.
-
-### Why not "swap omnivoice's ggml submodule for milady's ggml"?
-
-That sounds equivalent but creates a sharper failure mode: omnivoice's
-CMakeLists.txt expects to be the parent of `ggml/` and configures it
-with its own option set (`OMNIVOICE_*`, GGML_MAX_NAME=128, etc.). If we
-let omnivoice's CMake reconfigure milady's ggml we lose the kernel-set
-and patch hooks that `build-llama-cpp-dflash.mjs` already wires. The
-graft approach keeps llama.cpp's CMake as the single point of ggml
-configuration.
-
-### Why not "make omnivoice an external package and dlopen it"?
-
-Forbidden by §4 of `packages/inference/AGENTS.md`: "We do not run text
-and voice in two processes communicating over IPC. That regresses
-memory and adds a 1-10ms scheduling tax per turn." Even an in-process
-dlopen would still mean two distinct ggml ABIs sharing the same
-address space — same problem, masked.
-
-## How to update the omnivoice pin (runbook)
-
-1. Bring up a temp clone:
-   ```sh
-   git clone https://github.com/ServeurpersoCom/omnivoice.cpp /tmp/omnivoice-pinbump
-   cd /tmp/omnivoice-pinbump
-   git log --oneline -20
-   ```
-2. Review the diff against the current pin in the table above:
-   ```sh
-   git diff 38f824023d12b21a7c324651b18bd90f16d8bb86..master \
-     -- src/ tools/ CMakeLists.txt
-   ```
-   Pay attention to:
-   - changes to the public surface in `src/omnivoice.h` (used by
-     `cap-bridge.cpp` and the runtime), in particular any rename of
-     `omnivoice_context_*`, `omnivoice_generate_*`, `omnivoice_load_*`.
-   - changes to `src/maskgit-tts.h` / `dac-decoder.h` / `hubert-enc.h`
-     that touch the ggml graph builders — those must stay compatible
-     with the ggml exposed by milady-ai/llama.cpp at the build pin.
-   - new files added under `src/` or `tools/` — extend
-     `CMAKE_GRAFT_SOURCES` in `omnivoice-fuse/cmake-graft.mjs`.
-3. Bring up the new omnivoice ggml pin and `git diff` against the
-   current ServeurpersoCom ggml pin:
-   ```sh
-   cd /tmp/omnivoice-pinbump
-   git submodule update --init ggml
-   cd ggml
-   git log 0e3980ef205ea3639650f59e54cfeecd7d947700..HEAD --oneline
-   ```
-   For each commit that touches the ggml C API used by omnivoice's
-   `src/`, decide:
-   - is it already in milady-ai/llama.cpp's vendored ggml? (skip)
-   - is it a kernel/quant change conflicting with milady's TurboQuant /
-     QJL / PolarQuant work? (HARD STOP — escalate before bumping)
-   - is it an additive API call omnivoice now uses? (cherry-pick into
-     milady-ai/llama.cpp's `ggml/`, then bump that fork's tag, then
-     bump omnivoice here)
-4. Update the pin table at the top of this README. Update the constants
-   `OMNIVOICE_REF` / `OMNIVOICE_GGML_REF` in
-   `packages/app-core/scripts/build-llama-cpp-dflash.mjs`.
-5. Run a fused build: `node build-llama-cpp-dflash.mjs --target
-   darwin-arm64-metal-fused` (or vulkan/cpu equivalent). The build
-   MUST exit non-zero if symbol verification fails — do NOT add
-   compatibility shims to make the new pin compile.
-6. Re-run `verify/metal_verify` and `verify/vulkan_verify` (per
-   `packages/inference/README.md`) to confirm the kernel matrix still
-   reports 8/8 PASS on the previously-verified hardware. A bumped
-   omnivoice pin is NOT shippable until those are green.
-
-## Failure modes the build script must surface (no fallback)
-
-Per `packages/inference/AGENTS.md` §3 ("Mandatory optimizations") and
-§9 ("No defensive code"), any of the following cause the build script
-to exit non-zero. There is no "build the non-fused binary as a
-fallback" path.
-
-- omnivoice clone fails or pin is unreachable.
-- omnivoice's `src/`, `tools/`, or required headers are missing.
-- the GGML reconciliation removal of omnivoice's `ggml/` submodule
-  fails (e.g. it's a real directory we couldn't strip).
-- patches under `omnivoice-fuse/patches/` fail to apply.
-- the fused CMake configure or build step fails.
-- the resulting fused server binary or shared library cannot link
-  *both* `llama_*` and `omnivoice_*` symbols (verified post-link with
-  `nm`, or `objdump -T` on Linux/MinGW, or `nm -gU` on Darwin).
-
-## Files in this directory
-
-- `README.md`        — this file.
-- `cmake-graft.mjs`  — reads the omnivoice source list and emits a
-                       CMake snippet appended to llama.cpp's root
-                       `CMakeLists.txt` to declare `omnivoice-core`,
-                       `llama-omnivoice-server`, `libelizainference`.
-- `prepare.mjs`      — clones omnivoice at the pin, strips its `ggml/`
-                       submodule, copies `src/` + `tools/` into the
-                       llama.cpp tree, applies any `patches/*.patch`,
-                       and returns the omnivoice commit so the caller
-                       can record it in `CAPABILITIES.json`.
-- `verify-symbols.mjs` — post-build symbol probe. Runs `nm` (or
-                       `objdump -T` on PE) against the produced
-                       binary/library and asserts both `llama_*` and
-                       `omnivoice_*` exports are present.
-- `patches/`         — directory for `.patch` files keyed to specific
-                       omnivoice or ggml commit drifts. Each patch is
-                       applied with `git apply --check` first; a failed
-                       apply is a hard error.
-- `ffi.h`            — C ABI v1 for `libelizainference`. Single source
-                       of truth for the symbol set the fused build
-                       exposes. Consumed by the Bun FFI loader at
-                       `src/services/local-inference/voice/ffi-bindings.ts`
-                       and by future Rust / Swift / Python bridges.
-- `ffi-stub.c`       — Reference C implementation that builds into
-                       `libelizainference_stub.{dylib,so}`. Lifecycle
-                       (`create`/`destroy`) works; every entry that
-                       requires the real fused build returns
-                       `ELIZA_ERR_NOT_IMPLEMENTED`. Used by
-                       `ffi-bindings.test.ts` for end-to-end loader
-                       validation without the fused dylib.
-- `Makefile`         — Builds the stub. `make` produces the
-                       platform-default artifact; `make verify` lists
-                       the exported `eliza_inference_*` symbols.
-
-## C ABI v1 (`ffi.h`)
-
-The fused build (and the stub) export exactly these symbols. Bump
-`ELIZA_INFERENCE_ABI_VERSION` in `ffi.h` AND
-`ELIZA_INFERENCE_ABI_VERSION` in
-`packages/app-core/src/services/local-inference/voice/ffi-bindings.ts`
-in lockstep on any breaking shape change — the loader checks the
-version at `dlopen` time and refuses to bind a mismatched library.
-
-| Symbol                              | Purpose                                                     |
-| ----------------------------------- | ----------------------------------------------------------- |
-| `eliza_inference_abi_version`       | Returns the static ABI version string ("1" today).          |
-| `eliza_inference_create`            | Allocate a per-engine `EliInferenceContext` from a bundle.  |
-| `eliza_inference_destroy`           | Free a context (idempotent on NULL).                        |
-| `eliza_inference_mmap_acquire`      | Lazy-page weights for a region (`tts`/`asr`/`text`/`dflash`). |
-| `eliza_inference_mmap_evict`        | Page-evict a region (madvise MADV_DONTNEED / VirtualUnlock). |
-| `eliza_inference_tts_synthesize`    | Synchronous OmniVoice forward → fp32 PCM @ 24 kHz.          |
-| `eliza_inference_asr_transcribe`    | Synchronous ASR forward → UTF-8 transcript.                 |
-| `eliza_inference_free_string`       | Free heap strings the library handed back (errors, future transcript buffers). |
-
-All errors flow through a `char ** out_error` parameter that the
-library populates with a heap-allocated NUL-terminated message.
-Callers MUST free those messages via `eliza_inference_free_string`.
-Negative return values map to the `ELIZA_ERR_*` codes declared in
-`ffi.h` — the JS binding re-projects them onto
-`VoiceLifecycleError.code` (`ram-pressure`, `mmap-fail`,
-`kernel-missing`, `disarm-failed`).
-
-## Loading the library from JS
-
-Production loader (Bun runtime via Electrobun + Capacitor):
-
-```ts
-import { loadElizaInferenceFfi } from
-  "@elizaos/app-core/services/local-inference/voice/ffi-bindings";
-const ffi = loadElizaInferenceFfi("/path/to/libelizainference.dylib");
-const ctx = ffi.create(bundleRoot);
-ffi.mmapAcquire(ctx, "tts");
-const out = new Float32Array(24_000 * 4);
-const samples = ffi.ttsSynthesize({
-  ctx, text: "hello world", speakerPresetId: null, out,
-});
-ffi.mmapEvict(ctx, "tts");
-ffi.destroy(ctx);
-ffi.close();
-```
-
-The loader throws `VoiceLifecycleError({code:"kernel-missing"})` when
-the runtime is not Bun, when `dlopen` fails, or when the library's
-ABI version disagrees with the binding. It does NOT fall back to a
-stub on failure — per `packages/inference/AGENTS.md` §3 + §9, every
-startup precondition is a structured throw.
-
-## Building the stub for tests
-
-```sh
-make -C packages/app-core/scripts/omnivoice-fuse
-# → libelizainference_stub.dylib (macOS) or .so (linux)
-
-# Symbol verification:
-nm -gU libelizainference_stub.dylib | grep eliza_inference_
-
-# JS-side coverage (requires Bun on PATH for the integration scenarios):
-cd packages/app-core
-bunx vitest run src/services/local-inference/voice/ffi-bindings.test.ts
-```
-
-The test harness spawns a `bun -e` subprocess that loads the stub
-dylib via `bun:ffi` and exercises `create`/`destroy`/`mmapEvict`/
-`ttsSynthesize`/ABI-mismatch scenarios. The vitest worker itself runs
-on Node 22 (no `bun:ffi`), so the pure-unit cases assert that the
-loader throws structurally on the no-Bun path.