@elizaos/app-core 2.0.3-beta.2 → 2.0.3-beta.4

package/runtime/bundled-fused-lib.js

@@ -0,0 +1,77 @@
+/**
+ * Locate + wire the fused `libelizainference` that ships INSIDE a packaged
+ * desktop app, so a compiled app serves local inference with no env wiring and
+ * no separate download.
+ *
+ * The desktop packaging (`packages/app-core/scripts/desktop-build.mjs` →
+ * `stage-desktop-fused-lib.mjs`) stages the fused set into
+ * `<eliza-dist>/local-inference/lib/`, and the Electrobun build copies the
+ * whole `dist` tree to `Resources/app/eliza-dist/`. At runtime this module
+ * lives at `<eliza-dist>/node_modules/@elizaos/app-core/dist/runtime/…`, so we
+ * walk up looking for a `local-inference/lib/<fused>` that actually exists.
+ */
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { logger } from "@elizaos/core";
+/**
+ * Candidate filenames for the fused library, per platform. Mirrors
+ * `plugin-local-inference`'s `resolveFusedLibraryPath` / the FFI loader so the
+ * probe and the runtime agree on what counts as "the fused lib is here".
+ */
+export function fusedLibraryFilenames() {
+    if (process.platform === "darwin")
+        return ["libelizainference.dylib"];
+    if (process.platform === "win32")
+        return ["elizainference.dll", "libelizainference.dll"];
+    return ["libelizainference.so"];
+}
+/**
+ * Walk up from `startUrl`'s directory looking for a `local-inference/lib`
+ * directory that already contains a platform fused lib. Self-validating (only
+ * matches where the artifact is), so there is no layout ambiguity. Returns null
+ * in dev (run from source, nothing staged) and on mobile (native lib ships via
+ * jniLibs / xcframework). Best-effort; never throws.
+ */
+export function findBundledFusedLibDir(startUrl = import.meta.url) {
+    try {
+        const names = fusedLibraryFilenames();
+        let dir = path.dirname(fileURLToPath(startUrl));
+        for (let depth = 0; depth < 8; depth += 1) {
+            const candidate = path.join(dir, "local-inference", "lib");
+            if (names.some((name) => existsSync(path.join(candidate, name)))) {
+                return candidate;
+            }
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        // import.meta / fs probing must never break boot.
+    }
+    return null;
+}
+/**
+ * Point the local-inference runtime at the app-bundled fused lib when one is
+ * present. Respects an explicit operator override (`ELIZA_INFERENCE_LIBRARY` /
+ * `ELIZA_INFERENCE_LIB_DIR`) and is a no-op when nothing is bundled (dev,
+ * mobile) — `resolveFusedLibraryPath` then falls back to
+ * `<stateDir>/local-inference/lib` as before. Idempotent. Returns the dir it
+ * wired (or already-set override), else null.
+ */
+export function ensureBundledFusedLibDir(env = process.env, startUrl = import.meta.url) {
+    if (env.ELIZA_INFERENCE_LIBRARY?.trim()) {
+        return path.dirname(env.ELIZA_INFERENCE_LIBRARY.trim());
+    }
+    if (env.ELIZA_INFERENCE_LIB_DIR?.trim()) {
+        return env.ELIZA_INFERENCE_LIB_DIR.trim();
+    }
+    const bundled = findBundledFusedLibDir(startUrl);
+    if (!bundled)
+        return null;
+    env.ELIZA_INFERENCE_LIB_DIR = bundled;
+    logger.info(`[eliza] Using app-bundled local-inference lib dir: ${bundled}`);
+    return bundled;
+}

package/runtime/channel-plugin-map.d.ts

@@ -1,6 +1,2 @@
-export declare const CHANNEL_PLUGIN_MAP: {
-    signal: "@elizaos/plugin-signal";
-    whatsapp: "@elizaos/plugin-whatsapp";
-    wechat: "elizaoswechat";
-};
+export declare const CHANNEL_PLUGIN_MAP: Readonly<Record<string, string>>;
 //# sourceMappingURL=channel-plugin-map.d.ts.map

package/runtime/channel-plugin-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-plugin-map.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/channel-plugin-map.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,kBAAkB;;;;CAG9B,CAAC"}
+{"version":3,"file":"channel-plugin-map.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/channel-plugin-map.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAG/D,CAAC"}

package/runtime/channel-plugin-map.js

@@ -1,38 +1,18 @@
-// CYCLE BREAK: previously imported `CHANNEL_PLUGIN_MAP` from
-// `@elizaos/agent`, creating an `agent ↔ app-core` ESM cycle that
-// surfaced as `ReferenceError: Cannot access 'upstreamChannelPluginMap'
-// before initialization` at bench-server boot. Inline the canonical
-// list (mirror of `packages/agent/src/runtime/plugin-collector.ts`'s
-// CHANNEL_PLUGIN_MAP) plus the three app-local overrides. Keep in sync
-// with that file when channels are added or renamed.
-const _upstreamChannelPluginMap = {
-    bluebubbles: "@elizaos/plugin-bluebubbles",
-    discord: "@elizaos/plugin-discord",
-    discordLocal: "@elizaos/plugin-discord-local",
-    telegram: "@elizaos/plugin-telegram",
-    slack: "@elizaos/plugin-slack",
-    x: "@elizaos/plugin-x",
-    twitter: "@elizaos/plugin-x",
-    whatsapp: "@elizaos/plugin-whatsapp",
-    signal: "@elizaos/plugin-signal",
-    imessage: "@elizaos/plugin-imessage",
-    farcaster: "@elizaos/plugin-farcaster",
-    lens: "@elizaos/plugin-lens",
-    msteams: "@elizaos/plugin-msteams",
-    feishu: "@elizaos/plugin-feishu",
-    matrix: "@elizaos/plugin-matrix",
-    nostr: "@elizaos/plugin-nostr",
-    blooio: "@elizaos/plugin-blooio",
-    twitch: "@elizaos/plugin-twitch",
-    mattermost: "@elizaos/plugin-mattermost",
-    googlechat: "@elizaos/plugin-google-chat",
+// The channel -> plugin-package map is derived at registry build time from each
+// connector entry's `channels` (see packages/registry/src/first-party). This was
+// previously a hand-maintained mirror of `@elizaos/agent`'s CHANNEL_PLUGIN_MAP
+// (kept in sync manually to avoid an `agent ↔ app-core` ESM cycle). Both now
+// statically import the same generated artifact, so the duplication and the
+// cycle are gone — neither package imports the other for this map.
+import channelPluginMap from "@elizaos/registry/first-party/channel-plugin-map.json" with {
+    type: "json"
 };
+// App-local channel not in the first-party registry (built from an internal
+// connector, not an npm package).
 const INTERNAL_CHANNEL_PLUGIN_OVERRIDES = {
-    signal: "@elizaos/plugin-signal",
-    whatsapp: "@elizaos/plugin-whatsapp",
     wechat: "elizaoswechat",
 };
 export const CHANNEL_PLUGIN_MAP = {
-    ..._upstreamChannelPluginMap,
+    ...channelPluginMap,
     ...INTERNAL_CHANNEL_PLUGIN_OVERRIDES,
 };

package/runtime/desktop/index.d.ts

@@ -1,6 +1,6 @@
-export * from "./AppWindowRenderer";
-export * from "./DesktopSurfaceNavigationRuntime";
-export * from "./DesktopTrayRuntime";
-export * from "./DetachedShellRoot";
-export * from "./tray-menu";
+export * from "./AppWindowRenderer.js";
+export * from "./DesktopSurfaceNavigationRuntime.js";
+export * from "./DesktopTrayRuntime.js";
+export * from "./DetachedShellRoot.js";
+export * from "./tray-menu.js";
 //# sourceMappingURL=index.d.ts.map

package/runtime/dev-server.js

@@ -380,6 +380,17 @@ async function main() {
             `Kill the process using port ${port} or set ELIZA_API_PORT to a free port.`);
     }
     syncResolvedApiPort(process.env, actualPort);
+    // Boot the elizaOS agent runtime without blocking server readiness. Scheduled
+    // here — before the CORS dynamic import and the cosmetic banner/pairing block
+    // below — because `scheduleRuntimeBootstrap` only queues a macrotask: the lone
+    // event-loop yield in the remaining startup tail is the `await import` of
+    // server-cors, so queueing the bootstrap first lets `createRuntime()` begin
+    // during that import (the measured win under host contention). The runtime
+    // needs seconds to become ready, so the synchronous CORS-allowlist
+    // invalidation and pairing-code setup that follow still complete long before
+    // any cross-origin request can reach the agent. The resolved API port is
+    // already synced into env above, so the runtime reads the correct port.
+    scheduleRuntimeBootstrap(0, "startup");
     // Invalidate cached CORS port set so the new port is allowed.
     // Dynamic import may be unavailable in non-server build targets (mobile); ignore.
     try {
@@ -410,8 +421,6 @@ async function main() {
     console.log(colorizeDevSettingsStartupBanner(formatApiDevSettingsBannerText(actualPort, {
         hadUserApiTokenInEnv,
     })));
-    // 2. Boot the elizaOS agent runtime without blocking server readiness.
-    scheduleRuntimeBootstrap(0, "startup");
     console.log(`${getLogPrefix()} Startup init complete in ${Date.now() - startupStart}ms, agent bootstrapping...`);
 }
 // ── Global error handlers (match CLI behavior from run-main.ts) ──

package/runtime/eliza.d.ts.map

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

package/runtime/eliza.js

@@ -16,11 +16,12 @@ import { pathToFileURL } from "node:url";
 import { CUSTOM_PLUGINS_DIRNAME, getLastFailedPluginNames, loadElizaConfig, resolveDefaultAgentWorkspaceDir, resolvePackageEntry, resolveUserPath, scanDropInPlugins, applyCloudConfigToEnv as upstreamApplyCloudConfigToEnv, bootElizaRuntime as upstreamBootElizaRuntime, collectPluginNames as upstreamCollectPluginNames, configureLocalEmbeddingPlugin as upstreamConfigureLocalEmbeddingPlugin, shutdownRuntime as upstreamShutdownRuntime, startEliza as upstreamStartEliza, } from "@elizaos/agent";
 export { CHANNEL_PLUGIN_MAP } from "./channel-plugin-map.js";
 export { CUSTOM_PLUGINS_DIRNAME, resolvePackageEntry, scanDropInPlugins };
-import { AutonomyService, ChannelType, logger, ModelType, stringToUuid, } from "@elizaos/core";
+import { AutonomyService, ChannelType, isTruthyEnvValue, logger, ModelType, stringToUuid, } from "@elizaos/core";
 import { ensureRuntimeSqlCompatibility, formatError, formatErrorWithStack, isMobilePlatform, resolveDesktopApiPort, resolveServerOnlyPort, syncAppEnvToEliza, syncElizaEnvAliases, syncResolvedApiPort, } from "@elizaos/shared";
 import { getApps, loadRegistry } from "../registry/index.js";
 import { registerCoreSensitiveRequestAdapters } from "../services/sensitive-requests/index.js";
 import { listAppRoutePluginLoaders, } from "./app-route-plugin-registry.js";
+import { ensureBundledFusedLibDir } from "./bundled-fused-lib.js";
 import { shouldWarmupVoice, warmVoiceModels } from "./voice-warmup.js";
 // plugin-local-inference loaded lazily to avoid static plugin boundary violations.
 let _localInferenceRuntime;
@@ -457,6 +458,22 @@ async function registerTrainingRuntimeHooks(runtime) {
 let latestBootTailRuntime = null;
 async function repairRuntimeAfterBoot(runtime) {
     await ensureRuntimeSqlCompatibility(runtime);
+    // Make the app-bundled fused libelizainference (staged into the desktop
+    // package) discoverable before any local-inference handler probes
+    // `supported()`. No-op in dev / on mobile and when an explicit override is
+    // set. Must run before the ensureLocalInferenceHandler calls below.
+    ensureBundledFusedLibDir();
+    // Invariant guard: the mobile voice backend selector pins phones to the
+    // Kokoro-exclusive TTS path via `mobile: isMobilePlatform()`, which keys off
+    // ELIZA_PLATFORM. The mobile local-inference gate can fire on the
+    // device-bridge / ELIZA_LOCAL_LLAMA / riscv64 triggers without ELIZA_PLATFORM
+    // being set, leaving `mobile` false in the selector — risking OmniVoice on a
+    // phone. Evaluate both predicates here (outside the mobile branch below) so
+    // the warning is actually reachable on the real mismatch.
+    (await _localInference()).warnIfMobileGateActiveWithoutPlatform({
+        mobilePlatform: isMobilePlatform(),
+        warn: logger.warn,
+    });
     // Mobile (Android / iOS) shortcut: the runtime is already serving from
     // PGlite + the AI provider plugin. The remaining boot steps either spawn
     // subprocesses (workflow runtime, telegram polling), shell
@@ -732,13 +749,6 @@ async function ensureTelegramBotPolling(runtime) {
 // then opens the now-missing file and throws ENOENT, which surfaces as an
 // uncaughtException and kills the agent.
 let warmupInFlight = null;
-function isTruthyEnvValue(value) {
-    const normalized = value?.trim().toLowerCase();
-    return (normalized === "1" ||
-        normalized === "true" ||
-        normalized === "yes" ||
-        normalized === "on");
-}
 function isLocalEmbeddingWarmupDeferredByEnv() {
     return isTruthyEnvValue(process.env.ELIZA_DEFER_LOCAL_EMBEDDING_WARMUP);
 }

package/runtime/mode/route-mode-guard.d.ts

@@ -9,7 +9,7 @@
  * Config-load failures propagate to the runtime error handler.
  */
 import type http from "node:http";
-import { type RuntimeMode } from "./runtime-mode";
+import { type RuntimeMode } from "./runtime-mode.js";
 export interface ModeGateOutcome {
     /** True when the dispatcher should stop — guard wrote a 404. */
     handled: boolean;

package/runtime/mode/route-mode-matrix.d.ts

@@ -24,7 +24,7 @@
  *     to the target. Local-inference and cloud are NOT exposed by the
  *     controller; the controller proxies to the target instead.
  */
-import type { RuntimeMode } from "./runtime-mode";
+import type { RuntimeMode } from "./runtime-mode.js";
 export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "*";
 export interface RouteModeRule {
     /**

package/runtime/voice-warmup.d.ts

@@ -11,20 +11,10 @@
  * instant — the embedding warmup's spirit, via the path voice already uses.
  * Nothing in the voice engine is touched.
  *
- * BEHAVIOR CHANGE (PR #8175): warmup now fires for **both** local and cloud
- * setups. Previously, warmup was gated on `localInferenceActive` and was
- * suppressed for cloud-configured users. The gate has been removed.
- *
- * Impact for cloud users: at every desktop boot, two tiny API calls (one
- * silent WAV for STT, one empty-string TTS) will be dispatched through the
- * runtime's model router to whichever cloud voice provider is configured
- * (e.g. ElevenLabs, Eliza Cloud TTS). These calls are billable if the
- * provider charges per-request. They are intentionally small (~100 ms WAV for
- * STT, empty string for TTS) and non-blocking (fire-and-forget). Failures are
- * non-fatal and logged at WARN level.
- *
- * To suppress warmup entirely (both local and cloud) set:
- *   ELIZA_SKIP_LOCAL_VOICE_WARMUP=1
+ * Warmup fires for both local and cloud setups; for cloud providers this means
+ * two tiny billable API calls per desktop boot (a ~100 ms silent WAV for STT
+ * and an empty-string TTS), non-blocking and non-fatal. Suppress it entirely
+ * with ELIZA_SKIP_LOCAL_VOICE_WARMUP=1.
  */
 /** Minimal runtime surface we need — avoids importing the heavy AgentRuntime. */
 export interface VoiceWarmupRuntime {
@@ -44,11 +34,6 @@ export interface VoiceWarmupGate {
      * loads on first real use. Cold boot still warms.
      */
     hotReload?: boolean;
-    /**
-     * @deprecated No longer used — warmup fires for both local and cloud.
-     * Kept for API compatibility; callers may still pass it.
-     */
-    localInferenceActive?: boolean;
 }
 /** Pure policy: should we warm voice models in the background? */
 export declare function shouldWarmupVoice(gate: VoiceWarmupGate): boolean;

package/runtime/voice-warmup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice-warmup.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/voice-warmup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAKhE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAmB7C;AAED,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,CAAC;AA8BF;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,qBAAqB,EAC5B,GAAG,GAAE,OAAiB,GACrB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}
+{"version":3,"file":"voice-warmup.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/voice-warmup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAKhE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAmB7C;AAED,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,CAAC;AA8BF;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,qBAAqB,EAC5B,GAAG,GAAE,OAAiB,GACrB,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/runtime/voice-warmup.js

@@ -11,20 +11,10 @@
  * instant — the embedding warmup's spirit, via the path voice already uses.
  * Nothing in the voice engine is touched.
  *
- * BEHAVIOR CHANGE (PR #8175): warmup now fires for **both** local and cloud
- * setups. Previously, warmup was gated on `localInferenceActive` and was
- * suppressed for cloud-configured users. The gate has been removed.
- *
- * Impact for cloud users: at every desktop boot, two tiny API calls (one
- * silent WAV for STT, one empty-string TTS) will be dispatched through the
- * runtime's model router to whichever cloud voice provider is configured
- * (e.g. ElevenLabs, Eliza Cloud TTS). These calls are billable if the
- * provider charges per-request. They are intentionally small (~100 ms WAV for
- * STT, empty string for TTS) and non-blocking (fire-and-forget). Failures are
- * non-fatal and logged at WARN level.
- *
- * To suppress warmup entirely (both local and cloud) set:
- *   ELIZA_SKIP_LOCAL_VOICE_WARMUP=1
+ * Warmup fires for both local and cloud setups; for cloud providers this means
+ * two tiny billable API calls per desktop boot (a ~100 ms silent WAV for STT
+ * and an empty-string TTS), non-blocking and non-fatal. Suppress it entirely
+ * with ELIZA_SKIP_LOCAL_VOICE_WARMUP=1.
  */
 /** Pure policy: should we warm voice models in the background? */
 export function shouldWarmupVoice(gate) {

package/scripts/aosp/README.md

@@ -65,6 +65,15 @@ Each script accepts `--app-config <PATH>` to override
 ## Hardware requirements
 
 - AOSP build: Linux x86_64, KVM, ≥30 GB RAM, ≥ 600 GB free disk.
-- libllama compile: zig 0.13+ on PATH, cmake.
+- libllama compile: zig **0.13.x** on PATH (pinned series), cmake. The
+  `aarch64-linux-musl` / `x86_64-linux-musl` cross-link is pinned to the 0.13
+  series because zig 0.16's bundled `lld` SIGSEGVs that link and aborts the
+  fused/Android build with no actionable diagnostic. `compile-libllama.mjs` and
+  `compile-shim.mjs` fail loudly (via `assertZigPinForTargets`) if the detected
+  zig is outside 0.13.x; download the 0.13.x tarball from
+  <https://ziglang.org/download/> (the package-manager `zig` is frequently
+  0.16). Override only after independently verifying your lld links
+  aarch64-linux-musl: `ELIZA_ALLOW_UNPINNED_ZIG=1`. (The riscv64 RVV build path
+  is exempt — it needs zig 0.14+, gated by `MIN_ZIG_RVV_VERSION`.)
 - Cuttlefish runtime: cuttlefish host package (`cvd`), `/dev/kvm`.
 - Boot validation: `adb` on PATH or under `$ANDROID_HOME/platform-tools/`.

package/scripts/aosp/compile-libllama-paths.mjs

@@ -0,0 +1,110 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+/**
+ * Compare two semver-ish version strings (zig follows MAJOR.MINOR.PATCH for
+ * stable releases; dev builds add `-dev.NNN+sha` which we strip).
+ * Returns negative when `a < b`, positive when `a > b`, zero on equal.
+ */
+export function compareSemver(a, b) {
+  const norm = (v) =>
+    String(v)
+      .replace(/^v/, "")
+      .split(/[-+]/)[0]
+      .split(".")
+      .map((n) => Number.parseInt(n, 10) || 0);
+  const aa = norm(a);
+  const bb = norm(b);
+  for (let i = 0; i < Math.max(aa.length, bb.length); i += 1) {
+    const x = aa[i] ?? 0;
+    const y = bb[i] ?? 0;
+    if (x !== y) return x - y;
+  }
+  return 0;
+}
+
+export function resolveAndroidNdkHostDir(
+  prebuiltRoot,
+  { platform = os.platform(), arch = os.arch(), entries } = {},
+) {
+  const dirs =
+    entries ??
+    (fs.existsSync(prebuiltRoot) ? fs.readdirSync(prebuiltRoot) : []);
+  const hostDirs = dirs
+    .filter((d) => /^(linux|darwin|windows)-(x86_64|aarch64|arm64)$/.test(d))
+    .sort();
+  const hostPrefix =
+    platform === "win32"
+      ? "windows"
+      : platform === "linux" || platform === "darwin"
+        ? platform
+        : null;
+  if (!hostPrefix) return null;
+
+  const preferredArch =
+    arch === "x64" ? "x86_64" : arch === "arm64" ? "arm64" : arch;
+  const archCandidates =
+    preferredArch === "arm64"
+      ? ["arm64", "aarch64", "x86_64"]
+      : [preferredArch, "x86_64"];
+  return (
+    archCandidates
+      .map((candidate) => `${hostPrefix}-${candidate}`)
+      .find((candidate) => hostDirs.includes(candidate)) ??
+    hostDirs.find((candidate) => candidate.startsWith(`${hostPrefix}-`)) ??
+    null
+  );
+}
+
+export function resolveHomebrewFormulaIncludeDirs(
+  formula,
+  prefixes = ["/opt/homebrew", "/usr/local"],
+) {
+  const includeDirs = [];
+  for (const prefix of prefixes) {
+    includeDirs.push(path.join(prefix, "opt", formula, "include"));
+    const cellar = path.join(prefix, "Cellar", formula);
+    if (!fs.existsSync(cellar)) continue;
+    for (const version of fs.readdirSync(cellar).sort(compareSemver)) {
+      includeDirs.push(path.join(cellar, version, "include"));
+    }
+  }
+  return includeDirs;
+}
+
+export function resolveDefaultAndroidAssetsDir({ root = process.cwd() } = {}) {
+  const appRelativeCandidates = [
+    path.join("packages", "app"),
+    path.join("apps", "app"),
+    path.join("eliza", "packages", "app"),
+  ];
+  for (const appRelative of appRelativeCandidates) {
+    const appRoot = path.join(root, appRelative);
+    if (
+      fs.existsSync(path.join(appRoot, "android")) ||
+      fs.existsSync(path.join(appRoot, "package.json"))
+    ) {
+      return path.join(
+        appRoot,
+        "android",
+        "app",
+        "src",
+        "main",
+        "assets",
+        "agent",
+      );
+    }
+  }
+  return path.join(
+    root,
+    "packages",
+    "app",
+    "android",
+    "app",
+    "src",
+    "main",
+    "assets",
+    "agent",
+  );
+}

package/scripts/aosp/compile-libllama-zig-pin.test.mjs

@@ -0,0 +1,147 @@
+import { describe, expect, it } from "bun:test";
+import {
+  ABI_TARGETS,
+  ALLOW_UNPINNED_ZIG_ENV,
+  assertZigPinForTargets,
+  PINNED_ZIG_LINK_TRIPLES,
+  PINNED_ZIG_SERIES_FOR_MUSL_LINK,
+  zigSeries,
+  zigTriplesForAbis,
+} from "./compile-libllama.mjs";
+
+// Pins zig to the 0.13.x series for the aarch64/x86_64 `*-linux-musl` link.
+// zig 0.16's bundled lld SIGSEGVs that link (a silent host-toolchain break);
+// 0.13.x links it cleanly. The riscv64 RVV path is exempt (it needs 0.14+).
+// See issue #9584.
+describe("compile-libllama zig 0.13 pin", () => {
+  describe("zigSeries", () => {
+    it("extracts MAJOR.MINOR from stable versions", () => {
+      expect(zigSeries("0.13.0")).toBe("0.13");
+      expect(zigSeries("0.13.7")).toBe("0.13");
+      expect(zigSeries("0.16.0")).toBe("0.16");
+    });
+
+    it("strips dev/build suffixes", () => {
+      expect(zigSeries("0.13.0-dev.46+abc123")).toBe("0.13");
+      expect(zigSeries("v0.13.0")).toBe("0.13");
+    });
+
+    it("returns null for unparseable input", () => {
+      expect(zigSeries("not-a-version")).toBeNull();
+      // @ts-expect-error — exercising the non-string guard at the boundary.
+      expect(zigSeries(undefined)).toBeNull();
+    });
+  });
+
+  describe("pin constants", () => {
+    it("pins the 0.13 series", () => {
+      expect(PINNED_ZIG_SERIES_FOR_MUSL_LINK).toBe("0.13");
+    });
+
+    it("covers the aarch64/x86_64 musl link triples but not riscv64", () => {
+      expect(PINNED_ZIG_LINK_TRIPLES).toContain("aarch64-linux-musl");
+      expect(PINNED_ZIG_LINK_TRIPLES).toContain("x86_64-linux-musl");
+      expect(PINNED_ZIG_LINK_TRIPLES).not.toContain("riscv64-linux-musl");
+    });
+  });
+
+  describe("zigTriplesForAbis", () => {
+    it("maps each Android ABI to its zig triple", () => {
+      expect(zigTriplesForAbis(["arm64-v8a"])).toEqual(["aarch64-linux-musl"]);
+      expect(zigTriplesForAbis(["arm64-v8a", "x86_64", "riscv64"])).toEqual([
+        "aarch64-linux-musl",
+        "x86_64-linux-musl",
+        "riscv64-linux-musl",
+      ]);
+    });
+
+    it("dedupes repeated ABIs", () => {
+      expect(zigTriplesForAbis(["arm64-v8a", "arm64-v8a"])).toEqual([
+        "aarch64-linux-musl",
+      ]);
+    });
+
+    it("stays in sync with ABI_TARGETS", () => {
+      const abis = ABI_TARGETS.map((t) => t.androidAbi);
+      expect(zigTriplesForAbis(abis)).toEqual(ABI_TARGETS.map((t) => t.zigTarget));
+    });
+
+    it("throws on an unknown ABI rather than dropping it", () => {
+      expect(() => zigTriplesForAbis(["mips"])).toThrow(/unknown Android ABI/);
+    });
+  });
+
+  describe("assertZigPinForTargets", () => {
+    const arm = ["aarch64-linux-musl"];
+    const x86 = ["x86_64-linux-musl"];
+    const riscv = ["riscv64-linux-musl"];
+
+    it("accepts zig 0.13.x for the pinned musl link triples", () => {
+      expect(() =>
+        assertZigPinForTargets({ version: "0.13.0", zigTriples: arm, env: {} }),
+      ).not.toThrow();
+      expect(() =>
+        assertZigPinForTargets({ version: "0.13.7", zigTriples: x86, env: {} }),
+      ).not.toThrow();
+    });
+
+    it("rejects zig 0.16 (lld SIGSEGV) for the pinned link", () => {
+      expect(() =>
+        assertZigPinForTargets({ version: "0.16.0", zigTriples: arm, env: {} }),
+      ).toThrow(/0\.13\.x/);
+    });
+
+    it("rejects zig 0.14 for the pinned link (series must match exactly)", () => {
+      expect(() =>
+        assertZigPinForTargets({ version: "0.14.0", zigTriples: arm, env: {} }),
+      ).toThrow();
+    });
+
+    it("exempts a riscv64-only run (RVV path needs 0.14+)", () => {
+      expect(() =>
+        assertZigPinForTargets({ version: "0.16.0", zigTriples: riscv, env: {} }),
+      ).not.toThrow();
+      expect(() =>
+        assertZigPinForTargets({ version: "0.14.0", zigTriples: riscv, env: {} }),
+      ).not.toThrow();
+    });
+
+    it("still rejects when a pinned triple is mixed with riscv64", () => {
+      expect(() =>
+        assertZigPinForTargets({
+          version: "0.16.0",
+          zigTriples: [...arm, ...riscv],
+          env: {},
+        }),
+      ).toThrow();
+    });
+
+    it("honors the explicit override env", () => {
+      expect(() =>
+        assertZigPinForTargets({
+          version: "0.16.0",
+          zigTriples: arm,
+          env: { [ALLOW_UNPINNED_ZIG_ENV]: "1" },
+        }),
+      ).not.toThrow();
+    });
+
+    it("rejects a garbage version for the pinned link", () => {
+      expect(() =>
+        assertZigPinForTargets({ version: "weird", zigTriples: arm, env: {} }),
+      ).toThrow();
+    });
+
+    it("error names the version, the lld SIGSEGV cause, and the override", () => {
+      let message = "";
+      try {
+        assertZigPinForTargets({ version: "0.16.0", zigTriples: arm, env: {} });
+      } catch (err) {
+        message = err instanceof Error ? err.message : String(err);
+      }
+      expect(message).toMatch(/0\.16\.0/);
+      expect(message).toMatch(/lld SIGSEGV/i);
+      expect(message).toContain(ALLOW_UNPINNED_ZIG_ENV);
+    });
+  });
+});