@elizaos/plugin-capacitor-bridge 2.0.0-beta.1 → 2.0.3-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,87 @@
+# @elizaos/plugin-capacitor-bridge
+
+Agent-side bridge that enables stock iOS and Android Eliza builds to run local GGUF inference through the device's native Capacitor llama.cpp plugin.
+
+## What it does
+
+AOSP builds run llama.cpp directly inside the agent process via `bun:ffi`. Stock Capacitor builds (App Store iOS, standard Android APK) cannot do that — llama.cpp is exposed to the WebView through a native Capacitor plugin instead. This package is the agent-side half of that path:
+
+- **Android**: accepts a loopback WebSocket from the Capacitor WebView, delegates `TEXT_SMALL`, `TEXT_LARGE`, and `TEXT_EMBEDDING` model requests to the connected device, and lets the normal elizaOS model-handler system work unchanged.
+- **iOS**: runs the elizaOS runtime inside the Bun binary bundled into the iOS app and dispatches API calls in-process over native Bun host IPC (no HTTP loopback).
+
+Both paths install a sandboxed virtual filesystem (`installMobileFsShim`) that confines all `node:fs` operations to the app's writable workspace directory, enforcing App Store and Play Store code-execution policies.
+
+## Capabilities added
+
+- `TEXT_SMALL` model handler — routes to the connected Capacitor device.
+- `TEXT_LARGE` model handler — routes to the connected Capacitor device.
+- `TEXT_EMBEDDING` model handler — routes to the connected Capacitor device.
+- Automatic GGUF model download from `elizaos/eliza-1` on HuggingFace when no local model is found (unless `ELIZA_DISABLE_MODEL_AUTO_DOWNLOAD=1`).
+- WebSocket endpoint `/api/local-inference/device-bridge` for Capacitor WebView registration and inference RPC.
+
+## Installation
+
+This package is used by the elizaOS agent bundle. It is not a standard elizaOS plugin and cannot be added to `character.plugins`. The agent bundle entry point imports and calls its bootstrap functions directly.
+
+```
+@elizaos/plugin-capacitor-bridge
+```
+
+## Configuration
+
+### Android (WebSocket device bridge)
+
+| Env var | Required | Description |
+|---|---|---|
+| `ELIZA_DEVICE_BRIDGE_ENABLED=1` | Yes | Enables the WebSocket bridge. |
+| `ELIZA_DEVICE_PAIRING_TOKEN` | Yes | Shared secret — must match the token sent by the Capacitor WebView. |
+| `ELIZA_DEVICE_BRIDGE_TOKEN` | Alias | Fallback for `ELIZA_DEVICE_PAIRING_TOKEN`. |
+
+### Model path (both platforms)
+
+| Env var | Description |
+|---|---|
+| `ELIZA_LOCAL_CHAT_MODEL_PATH` | Absolute path to a GGUF for chat (TEXT_SMALL / TEXT_LARGE). |
+| `ELIZA_LOCAL_EMBEDDING_MODEL_PATH` | Absolute path to an embedding GGUF. |
+| `ELIZA_LOCAL_MODEL_PATH` | Fallback when neither slot-specific var is set. |
+| `ELIZA_DISABLE_MODEL_AUTO_DOWNLOAD=1` | Disables auto-download from HuggingFace. |
+
+If no model path is set and auto-download is enabled, the bridge downloads recommended eliza-1 GGUFs from `elizaos/eliza-1` on HuggingFace into `$ELIZA_STATE_DIR/local-inference/models/`.
+
+### Timeouts (all optional, default 600000 ms)
+
+- `ELIZA_DEVICE_LOAD_TIMEOUT_MS`
+- `ELIZA_DEVICE_GENERATE_TIMEOUT_MS`
+- `ELIZA_DEVICE_EMBED_TIMEOUT_MS`
+
+## Filesystem sandbox
+
+Both platforms install a deny-by-default `node:fs` interceptor (`installMobileFsShim`) before booting the runtime:
+
+- All paths are resolved relative to the app's writable workspace root (`MOBILE_WORKSPACE_ROOT` on iOS, `HOME` on Android).
+- Path traversal outside the root throws `EACCES`.
+- System directories (`/etc`, `/usr`, `/System`, `/proc`, etc.) are blocked unconditionally.
+- Writes to native binary extensions (`.so`, `.dylib`, `.node`) are blocked.
+- `require()` of file paths is blocked — all code must be bundled.
+
+## WebSocket protocol (Android)
+
+The Capacitor WebView connects to `ws://127.0.0.1:<port>/api/local-inference/device-bridge?token=<ELIZA_DEVICE_PAIRING_TOKEN>`.
+
+Connection flow:
+1. WebView sends `{ type: "register", payload: { deviceId, pairingToken, capabilities, loadedPath } }`.
+2. Agent sends `{ type: "load", correlationId, modelPath, ... }` → device replies `{ type: "loadResult", correlationId, ok, loadedPath }`.
+3. Agent sends `{ type: "generate", correlationId, prompt, ... }` → device replies `{ type: "generateResult", correlationId, ok, text }`.
+4. Agent sends `{ type: "embed", correlationId, input }` → device replies `{ type: "embedResult", correlationId, ok, embedding }`.
+5. Agent sends `{ type: "formatChat", correlationId, messages }` → device replies `{ type: "formatChatResult", correlationId, ok, prompt }` (invokes native Jinja chat template).
+6. Agent pings every 15 s; device replies `{ type: "pong" }`.
+
+Note: iOS connections are rejected with close code `4003`. iOS uses native IPC, not this WebSocket path.
+
+## Recommended default models
+
+| Slot | Model ID | HuggingFace path |
+|---|---|---|
+| TEXT_SMALL | `eliza-1-0_8b` | `elizaos/eliza-1` — `bundles/0_8b/text/eliza-1-0_8b-128k.gguf` |
+| TEXT_LARGE | `eliza-1-2b` | `elizaos/eliza-1` — `bundles/2b/text/eliza-1-2b-128k.gguf` |
+| TEXT_EMBEDDING | `eliza-1-embedding` | `elizaos/eliza-1` — `bundles/4b/embedding/eliza-1-embedding.gguf` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-capacitor-bridge",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.3-beta.2",
   "description": "Capacitor WebSocket bridge to device llama for stock mobile (non-AOSP) Eliza builds.",
   "type": "module",
   "main": "dist/index.js",
@@ -10,36 +10,67 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./android/bridge": {
+      "types": "./dist/android/bridge.d.ts",
+      "import": "./dist/android/bridge.js",
+      "default": "./dist/android/bridge.js"
+    },
+    "./ios/bridge": {
+      "types": "./dist/ios/bridge.d.ts",
+      "import": "./dist/ios/bridge.js",
+      "default": "./dist/ios/bridge.js"
+    },
+    "./mobile-device-bridge-bootstrap": {
+      "types": "./dist/mobile-device-bridge-bootstrap.d.ts",
+      "import": "./dist/mobile-device-bridge-bootstrap.js",
+      "default": "./dist/mobile-device-bridge-bootstrap.js"
+    },
+    "./shared/fs-shim": {
+      "types": "./dist/shared/fs-shim.d.ts",
+      "import": "./dist/shared/fs-shim.js",
+      "default": "./dist/shared/fs-shim.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "build": "bun run check:android-manifest && NODE_OPTIONS='--max-old-space-size=8192' tsup",
+    "check:android-manifest": "node scripts/check-android-manifest.mjs",
+    "dev": "tsup --watch",
     "clean": "rm -rf dist .turbo node_modules",
     "lint": "bunx @biomejs/biome check --write --unsafe .",
     "lint:check": "bunx @biomejs/biome check .",
     "format": "bunx @biomejs/biome format --write .",
     "format:check": "bunx @biomejs/biome format .",
+    "test": "vitest run --config vitest.config.ts",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@elizaos/core": "2.0.0-beta.1",
+    "@elizaos/core": "2.0.3-beta.2",
     "ws": "^8.18.0"
   },
   "peerDependencies": {
-    "@elizaos/core": "2.0.0-beta.1"
+    "@elizaos/core": "2.0.3-beta.2"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
+    "@types/bun": "^1.3.12",
     "@types/node": "24.12.2",
     "@types/ws": "^8.5.13",
     "tsup": "8.5.1",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.18"
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
 }

package/dist/index.d.ts

@@ -1,85 +0,0 @@
-import { Server } from 'node:http';
-import { AgentRuntime } from '@elizaos/core';
-
-/**
- * Stock Capacitor mobile local-inference bridge.
- *
- * AOSP builds run llama.cpp inside the agent process via bun:ffi. Stock
- * Capacitor Android/iOS builds cannot do that: llama.cpp is exposed to the
- * WebView through the native Capacitor plugin. This module is the agent-side
- * half of that path. It accepts a loopback WebSocket from the WebView,
- * forwards TEXT_SMALL / TEXT_LARGE requests to the device, and lets the
- * normal conversation routes keep using runtime model handlers.
- */
-
-interface LocalInferenceLoadArgs {
-    modelPath: string;
-    contextSize?: number;
-    useGpu?: boolean;
-    maxThreads?: number;
-    draftModelPath?: string;
-    draftContextSize?: number;
-    draftMin?: number;
-    draftMax?: number;
-    speculativeSamples?: number;
-    mobileSpeculative?: boolean;
-    cacheTypeK?: string;
-    cacheTypeV?: string;
-    disableThinking?: boolean;
-}
-interface DeviceCapabilities {
-    platform: "ios" | "android" | "web";
-    deviceModel: string;
-    totalRamGb: number;
-    cpuCores: number;
-    gpu: {
-        backend: "metal" | "vulkan" | "gpu-delegate";
-        available: boolean;
-    } | null;
-}
-interface MobileDeviceBridgeStatus {
-    enabled: boolean;
-    connected: boolean;
-    devices: Array<{
-        deviceId: string;
-        capabilities: DeviceCapabilities;
-        loadedPath: string | null;
-        connectedSince: string;
-    }>;
-    primaryDeviceId: string | null;
-    pendingRequests: number;
-    modelPath: string | null;
-}
-declare class MobileDeviceBridge {
-    private wss;
-    private readonly devices;
-    private readonly pendingLoads;
-    private readonly pendingUnloads;
-    private readonly pendingGenerates;
-    private readonly pendingEmbeds;
-    status(): MobileDeviceBridgeStatus;
-    attachToHttpServer(server: Server): Promise<void>;
-    private handleConnection;
-    private handleDeviceMessage;
-    private primaryDevice;
-    private sendToPrimary;
-    loadModel(args: LocalInferenceLoadArgs): Promise<void>;
-    unloadModel(): Promise<void>;
-    generate(args: {
-        prompt: string;
-        stopSequences?: string[];
-        maxTokens?: number;
-        temperature?: number;
-    }): Promise<string>;
-    embed(args: {
-        input: string;
-    }): Promise<number[]>;
-}
-declare const mobileDeviceBridge: MobileDeviceBridge;
-declare function getMobileDeviceBridgeStatus(): MobileDeviceBridgeStatus;
-declare function loadMobileDeviceBridgeModel(modelPath: string, modelId?: string): Promise<void>;
-declare function unloadMobileDeviceBridgeModel(): Promise<void>;
-declare function attachMobileDeviceBridgeToServer(server: Server): Promise<void>;
-declare function ensureMobileDeviceBridgeInferenceHandlers(runtime: AgentRuntime): Promise<boolean>;
-
-export { type MobileDeviceBridgeStatus, attachMobileDeviceBridgeToServer, ensureMobileDeviceBridgeInferenceHandlers, getMobileDeviceBridgeStatus, loadMobileDeviceBridgeModel, mobileDeviceBridge, unloadMobileDeviceBridgeModel };

package/dist/index.js

@@ -1,639 +0,0 @@
-// src/mobile-device-bridge-bootstrap.ts
-import { randomUUID } from "crypto";
-import {
-  createWriteStream,
-  existsSync,
-  mkdirSync,
-  readdirSync,
-  readFileSync,
-  renameSync,
-  statSync,
-  unlinkSync
-} from "fs";
-import path from "path";
-import { Readable } from "stream";
-import { pipeline } from "stream/promises";
-import {
-  logger,
-  ModelType,
-  resolveStateDir
-} from "@elizaos/core";
-var DEVICE_BRIDGE_PATH = "/api/local-inference/device-bridge";
-var PROVIDER = "capacitor-llama";
-var LOCAL_INFERENCE_PRIORITY = 0;
-var DEFAULT_CALL_TIMEOUT_MS = 12e4;
-var DEFAULT_LOAD_TIMEOUT_MS = 18e4;
-var SERVICE_ENABLED = process.env.ELIZA_DEVICE_BRIDGE_ENABLED?.trim() === "1";
-var registeredRuntimes = /* @__PURE__ */ new WeakSet();
-var KNOWN_EMBEDDING_DIMENSIONS = {
-  "eliza-1-lite-0_6b": 1024,
-  "eliza-1-mobile-1_7b": 2048
-};
-var ELIZA_1_LOAD_METADATA = {
-  "eliza-1-lite-0_6b": { contextSize: 32768 },
-  "eliza-1-mobile-1_7b": { contextSize: 32768 },
-  "eliza-1-desktop-9b": { contextSize: 65536 },
-  "eliza-1-pro-27b": { contextSize: 131072 },
-  "eliza-1-server-h200": { contextSize: 262144 }
-};
-function isWsModule(value) {
-  return typeof value === "object" && value !== null && typeof value.WebSocketServer === "function" && typeof value.WebSocket === "function";
-}
-var MobileDeviceBridge = class {
-  wss = null;
-  devices = /* @__PURE__ */ new Map();
-  pendingLoads = /* @__PURE__ */ new Map();
-  pendingUnloads = /* @__PURE__ */ new Map();
-  pendingGenerates = /* @__PURE__ */ new Map();
-  pendingEmbeds = /* @__PURE__ */ new Map();
-  status() {
-    const devices = [...this.devices.values()].map((device) => ({
-      deviceId: device.deviceId,
-      capabilities: device.capabilities,
-      loadedPath: device.loadedPath,
-      connectedSince: new Date(device.connectedAt).toISOString()
-    }));
-    return {
-      enabled: SERVICE_ENABLED,
-      connected: devices.length > 0,
-      devices,
-      primaryDeviceId: devices[0]?.deviceId ?? null,
-      pendingRequests: this.pendingLoads.size + this.pendingUnloads.size + this.pendingGenerates.size + this.pendingEmbeds.size,
-      modelPath: resolveLocalModelPath("TEXT_LARGE")
-    };
-  }
-  async attachToHttpServer(server) {
-    if (!SERVICE_ENABLED || this.wss) return;
-    const wsModule = await import("ws");
-    if (!isWsModule(wsModule)) {
-      throw new Error("ws module did not expose WebSocketServer/WebSocket");
-    }
-    const ws = wsModule;
-    const wss = new ws.WebSocketServer({
-      noServer: true,
-      maxPayload: 1024 * 1024
-    });
-    this.wss = wss;
-    wss.on("error", (err) => {
-      logger.warn("[mobile-device-bridge] WSS error:", err.message);
-    });
-    server.on("upgrade", (request, socket, head) => {
-      const url = new URL(request.url ?? "/", "http://localhost");
-      if (url.pathname !== DEVICE_BRIDGE_PATH) return;
-      wss.handleUpgrade(request, socket, head, (client) => {
-        this.handleConnection(client, ws.WebSocket);
-      });
-    });
-    logger.info(
-      `[mobile-device-bridge] Listening for Capacitor device bridge at ${DEVICE_BRIDGE_PATH}`
-    );
-  }
-  handleConnection(socket, WsCtor) {
-    let registeredDeviceId = null;
-    socket.on("message", (raw) => {
-      let msg;
-      try {
-        const text = typeof raw === "string" ? raw : raw.toString("utf8");
-        msg = JSON.parse(text);
-      } catch {
-        logger.warn("[mobile-device-bridge] Ignoring non-JSON frame");
-        return;
-      }
-      if (!registeredDeviceId) {
-        if (msg.type !== "register") {
-          socket.close(4002, "must-register-first");
-          return;
-        }
-        registeredDeviceId = msg.payload.deviceId;
-        this.devices.set(registeredDeviceId, {
-          deviceId: registeredDeviceId,
-          socket,
-          capabilities: msg.payload.capabilities,
-          loadedPath: msg.payload.loadedPath,
-          connectedAt: Date.now()
-        });
-        logger.info(
-          `[mobile-device-bridge] Device connected: ${registeredDeviceId} (${msg.payload.capabilities.platform})`
-        );
-        return;
-      }
-      this.handleDeviceMessage(msg);
-    });
-    socket.on("close", () => {
-      if (!registeredDeviceId) return;
-      const current = this.devices.get(registeredDeviceId);
-      if (current?.socket === socket) {
-        this.devices.delete(registeredDeviceId);
-        logger.info(
-          `[mobile-device-bridge] Device disconnected: ${registeredDeviceId}`
-        );
-      }
-    });
-    socket.on("error", (err) => {
-      logger.warn("[mobile-device-bridge] Socket error:", err.message);
-    });
-    const heartbeat = setInterval(() => {
-      if (!registeredDeviceId || socket.readyState !== WsCtor.OPEN) return;
-      try {
-        socket.send(JSON.stringify({ type: "ping", at: Date.now() }));
-      } catch {
-        clearInterval(heartbeat);
-      }
-    }, 15e3);
-    if (typeof heartbeat === "object" && "unref" in heartbeat) {
-      heartbeat.unref();
-    }
-  }
-  handleDeviceMessage(msg) {
-    if (msg.type === "pong" || msg.type === "register") return;
-    if (msg.type === "loadResult") {
-      const pending = this.pendingLoads.get(msg.correlationId);
-      if (!pending) return;
-      clearTimeout(pending.timeout);
-      this.pendingLoads.delete(msg.correlationId);
-      if (msg.ok === true) {
-        const device = this.devices.get(pending.routedDeviceId);
-        if (device) device.loadedPath = msg.loadedPath;
-        pending.resolve(void 0);
-      } else {
-        pending.reject(new Error(msg.error));
-      }
-      return;
-    }
-    if (msg.type === "unloadResult") {
-      const pending = this.pendingUnloads.get(msg.correlationId);
-      if (!pending) return;
-      clearTimeout(pending.timeout);
-      this.pendingUnloads.delete(msg.correlationId);
-      if (msg.ok === true) {
-        const device = this.devices.get(pending.routedDeviceId);
-        if (device) device.loadedPath = null;
-        pending.resolve(void 0);
-      } else {
-        pending.reject(new Error(msg.error));
-      }
-      return;
-    }
-    if (msg.type === "generateResult") {
-      const pending = this.pendingGenerates.get(msg.correlationId);
-      if (!pending) return;
-      clearTimeout(pending.timeout);
-      this.pendingGenerates.delete(msg.correlationId);
-      if (msg.ok === true) {
-        pending.resolve(msg.text);
-      } else {
-        pending.reject(new Error(msg.error));
-      }
-      return;
-    }
-    if (msg.type === "embedResult") {
-      const pending = this.pendingEmbeds.get(msg.correlationId);
-      if (!pending) return;
-      clearTimeout(pending.timeout);
-      this.pendingEmbeds.delete(msg.correlationId);
-      if (msg.ok === true) {
-        pending.resolve(msg.embedding);
-      } else {
-        pending.reject(new Error(msg.error));
-      }
-    }
-  }
-  primaryDevice() {
-    return this.devices.values().next().value ?? null;
-  }
-  sendToPrimary(pendingMap, makeMessage, timeoutMs, timeoutMessage) {
-    const device = this.primaryDevice();
-    if (!device) {
-      return Promise.reject(
-        new Error(
-          "DEVICE_DISCONNECTED: no Capacitor llama device bridge attached"
-        )
-      );
-    }
-    const correlationId = randomUUID();
-    const message = makeMessage(correlationId);
-    return new Promise((resolve, reject) => {
-      const timeout = setTimeout(() => {
-        pendingMap.delete(correlationId);
-        reject(new Error(timeoutMessage));
-      }, timeoutMs);
-      if (typeof timeout === "object" && "unref" in timeout) {
-        timeout.unref();
-      }
-      pendingMap.set(correlationId, {
-        resolve,
-        reject,
-        timeout,
-        routedDeviceId: device.deviceId
-      });
-      try {
-        device.socket.send(JSON.stringify(message));
-      } catch (err) {
-        clearTimeout(timeout);
-        pendingMap.delete(correlationId);
-        reject(err instanceof Error ? err : new Error(String(err)));
-      }
-    });
-  }
-  async loadModel(args) {
-    const device = this.primaryDevice();
-    if (device?.loadedPath === args.modelPath) return;
-    return this.sendToPrimary(
-      this.pendingLoads,
-      (correlationId) => ({
-        type: "load",
-        correlationId,
-        ...args
-      }),
-      readTimeoutMs("ELIZA_DEVICE_LOAD_TIMEOUT_MS", DEFAULT_LOAD_TIMEOUT_MS),
-      "DEVICE_TIMEOUT: model load exceeded deadline"
-    );
-  }
-  async unloadModel() {
-    const device = this.primaryDevice();
-    if (!device?.loadedPath) return;
-    return this.sendToPrimary(
-      this.pendingUnloads,
-      (correlationId) => ({ type: "unload", correlationId }),
-      readTimeoutMs(
-        "ELIZA_DEVICE_GENERATE_TIMEOUT_MS",
-        DEFAULT_CALL_TIMEOUT_MS
-      ),
-      "DEVICE_TIMEOUT: unload exceeded deadline"
-    );
-  }
-  generate(args) {
-    return this.sendToPrimary(
-      this.pendingGenerates,
-      (correlationId) => ({
-        type: "generate",
-        correlationId,
-        prompt: args.prompt,
-        stopSequences: args.stopSequences,
-        maxTokens: args.maxTokens,
-        temperature: args.temperature
-      }),
-      readTimeoutMs(
-        "ELIZA_DEVICE_GENERATE_TIMEOUT_MS",
-        DEFAULT_CALL_TIMEOUT_MS
-      ),
-      "DEVICE_TIMEOUT: no device responded within deadline"
-    );
-  }
-  embed(args) {
-    return this.sendToPrimary(
-      this.pendingEmbeds,
-      (correlationId) => ({
-        type: "embed",
-        correlationId,
-        input: args.input
-      }),
-      readTimeoutMs("ELIZA_DEVICE_EMBED_TIMEOUT_MS", DEFAULT_CALL_TIMEOUT_MS),
-      "DEVICE_TIMEOUT: no device returned embeddings within deadline"
-    );
-  }
-};
-var mobileDeviceBridge = new MobileDeviceBridge();
-function readTimeoutMs(envKey, fallback) {
-  const parsed = Number.parseInt(process.env[envKey]?.trim() ?? "", 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
-}
-function modelsDir() {
-  return path.join(resolveStateDir(), "local-inference", "models");
-}
-function registryPath() {
-  return path.join(resolveStateDir(), "local-inference", "registry.json");
-}
-function assignmentsPath() {
-  return path.join(resolveStateDir(), "local-inference", "assignments.json");
-}
-function readJsonFile(filePath) {
-  try {
-    return JSON.parse(readFileSync(filePath, "utf8"));
-  } catch {
-    return null;
-  }
-}
-function positiveInteger(value) {
-  const numeric = typeof value === "number" ? value : typeof value === "string" ? Number.parseInt(value, 10) : Number.NaN;
-  return Number.isInteger(numeric) && numeric > 0 ? numeric : null;
-}
-function resolveFromEnv(slot) {
-  const key = slot === "TEXT_EMBEDDING" ? "ELIZA_LOCAL_EMBEDDING_MODEL_PATH" : "ELIZA_LOCAL_CHAT_MODEL_PATH";
-  const specific = process.env[key]?.trim();
-  if (specific && existsSync(specific)) return specific;
-  const fallback = process.env.ELIZA_LOCAL_MODEL_PATH?.trim();
-  if (fallback && existsSync(fallback)) return fallback;
-  return null;
-}
-function resolveFromRegistry(slot) {
-  const assignments = readJsonFile(
-    assignmentsPath()
-  )?.assignments;
-  const assigned = assignments?.[slot];
-  if (typeof assigned !== "string" || !assigned.trim()) return null;
-  const models = readRegistryModels();
-  const matched = models.find((model) => model.id === assigned);
-  return typeof matched?.path === "string" && existsSync(matched.path) ? matched.path : null;
-}
-function readRegistryModels() {
-  return readJsonFile(registryPath())?.models ?? [];
-}
-function resolveAssignedRegistryModel(slot) {
-  const assignments = readJsonFile(
-    assignmentsPath()
-  )?.assignments;
-  const assigned = assignments?.[slot];
-  if (typeof assigned !== "string" || !assigned.trim()) return null;
-  const models = readRegistryModels();
-  const matched = models.find((model) => model.id === assigned);
-  if (typeof matched?.path !== "string" || !existsSync(matched.path)) {
-    return null;
-  }
-  return {
-    id: assigned,
-    path: matched.path,
-    dimensions: matched.dimensions,
-    embeddingDimension: matched.embeddingDimension,
-    embeddingDimensions: matched.embeddingDimensions
-  };
-}
-function resolveFromManifest(slot) {
-  const manifest = readJsonFile(
-    path.join(modelsDir(), "manifest.json")
-  );
-  const targetRole = slot === "TEXT_EMBEDDING" ? "embedding" : "chat";
-  for (const entry of manifest?.models ?? []) {
-    if (entry.role !== targetRole) continue;
-    const fileName = entry.ggufFile ?? entry.filename;
-    if (!fileName) continue;
-    const absolute = path.join(modelsDir(), fileName);
-    if (existsSync(absolute)) return absolute;
-  }
-  return null;
-}
-function resolveFirstGguf() {
-  const dir = modelsDir();
-  if (!existsSync(dir)) return null;
-  for (const name of readdirSync(dir)) {
-    if (!name.toLowerCase().endsWith(".gguf")) continue;
-    const absolute = path.join(dir, name);
-    if (existsSync(absolute)) return absolute;
-  }
-  return null;
-}
-function resolveLocalModelPath(slot) {
-  return resolveFromEnv(slot) ?? resolveFromRegistry(slot) ?? resolveFromManifest(slot) ?? resolveFirstGguf();
-}
-function buildLoadArgsFromRegistryModel(model) {
-  const args = { modelPath: model.path };
-  const eliza1 = ELIZA_1_LOAD_METADATA[model.id];
-  if (eliza1) args.contextSize = eliza1.contextSize;
-  return args;
-}
-function resolveLocalLoadArgs(slot) {
-  const envPath = resolveFromEnv(slot);
-  if (envPath) return { modelPath: envPath };
-  const registryModel = resolveAssignedRegistryModel(slot);
-  if (registryModel) return buildLoadArgsFromRegistryModel(registryModel);
-  const manifestPath = resolveFromManifest(slot);
-  if (manifestPath) return { modelPath: manifestPath };
-  const firstGguf = resolveFirstGguf();
-  return firstGguf ? { modelPath: firstGguf } : null;
-}
-var RECOMMENDED_MODELS = {
-  TEXT_SMALL: {
-    id: "eliza-1-lite-0_6b",
-    hfRepo: "elizaos/eliza-1-lite-0_6b",
-    ggufFile: "text/eliza-1-lite-0_6b-32k.gguf",
-    localFile: "eliza-1-lite-0_6b-32k.gguf"
-  },
-  TEXT_LARGE: {
-    id: "eliza-1-mobile-1_7b",
-    hfRepo: "elizaos/eliza-1-mobile-1_7b",
-    ggufFile: "text/eliza-1-mobile-1_7b-32k.gguf",
-    localFile: "eliza-1-mobile-1_7b-32k.gguf"
-  },
-  TEXT_EMBEDDING: {
-    id: "eliza-1-lite-0_6b",
-    hfRepo: "elizaos/eliza-1-lite-0_6b",
-    ggufFile: "text/eliza-1-lite-0_6b-32k.gguf",
-    localFile: "eliza-1-lite-0_6b-32k.gguf"
-  }
-};
-var inflightDownloads = /* @__PURE__ */ new Map();
-function buildHfResolveUrl(model) {
-  const encodedPath = model.ggufFile.split("/").map((segment) => encodeURIComponent(segment)).join("/");
-  return `https://huggingface.co/${model.hfRepo}/resolve/main/${encodedPath}?download=true`;
-}
-function buildRecommendedLoadArgs(slot, modelPath) {
-  const model = RECOMMENDED_MODELS[slot];
-  return buildLoadArgsFromRegistryModel({ id: model.id, path: modelPath });
-}
-async function downloadRecommendedModelFor(slot) {
-  const model = RECOMMENDED_MODELS[slot];
-  const dir = modelsDir();
-  mkdirSync(dir, { recursive: true });
-  const finalPath = path.join(
-    dir,
-    model.localFile ?? path.basename(model.ggufFile)
-  );
-  if (existsSync(finalPath)) {
-    const sz = statSync(finalPath).size;
-    if (!model.expectedSizeBytes || sz === model.expectedSizeBytes) {
-      return finalPath;
-    }
-    logger.warn(
-      `[mobile-device-bridge] ${model.ggufFile} present but size ${sz} != expected ${model.expectedSizeBytes}; re-downloading.`
-    );
-    try {
-      unlinkSync(finalPath);
-    } catch {
-    }
-  }
-  const dedupKey = model.id;
-  const existing = inflightDownloads.get(dedupKey);
-  if (existing) return existing;
-  const promise = (async () => {
-    const url = buildHfResolveUrl(model);
-    const stagingPath = `${finalPath}.part`;
-    try {
-      unlinkSync(stagingPath);
-    } catch {
-    }
-    logger.info(
-      `[mobile-device-bridge] Auto-downloading recommended ${slot} model ${model.id} from ${url}`
-    );
-    const response = await fetch(url, { redirect: "follow" });
-    if (!response.ok || !response.body) {
-      throw new Error(
-        `[mobile-device-bridge] Recommended-model download failed (${slot}): HTTP ${response.status} ${response.statusText} from ${url}`
-      );
-    }
-    await pipeline(
-      Readable.fromWeb(response.body),
-      createWriteStream(stagingPath)
-    );
-    const stagedSize = statSync(stagingPath).size;
-    if (model.expectedSizeBytes && stagedSize !== model.expectedSizeBytes) {
-      try {
-        unlinkSync(stagingPath);
-      } catch {
-      }
-      throw new Error(
-        `[mobile-device-bridge] Downloaded ${model.ggufFile} size ${stagedSize} != expected ${model.expectedSizeBytes}; aborting and removing partial file.`
-      );
-    }
-    renameSync(stagingPath, finalPath);
-    logger.info(
-      `[mobile-device-bridge] Auto-download complete: ${finalPath} (${stagedSize} bytes)`
-    );
-    return finalPath;
-  })();
-  inflightDownloads.set(dedupKey, promise);
-  try {
-    return await promise;
-  } finally {
-    inflightDownloads.delete(dedupKey);
-  }
-}
-async function resolveLoadArgsWithAutoDownload(slot) {
-  const existing = resolveLocalLoadArgs(slot);
-  if (existing) return existing;
-  if (process.env.ELIZA_DISABLE_MODEL_AUTO_DOWNLOAD?.trim() === "1") {
-    return null;
-  }
-  const downloaded = await downloadRecommendedModelFor(slot);
-  return buildRecommendedLoadArgs(slot, downloaded);
-}
-function resolveEmbeddingDimension() {
-  const assigned = resolveAssignedRegistryModel("TEXT_EMBEDDING");
-  return positiveInteger(process.env.ELIZA_LOCAL_EMBEDDING_DIMENSIONS) ?? positiveInteger(process.env.TEXT_EMBEDDING_DIMENSIONS) ?? positiveInteger(assigned?.dimensions) ?? positiveInteger(assigned?.embeddingDimension) ?? positiveInteger(assigned?.embeddingDimensions) ?? (assigned?.id ? KNOWN_EMBEDDING_DIMENSIONS[assigned.id] : null) ?? KNOWN_EMBEDDING_DIMENSIONS[RECOMMENDED_MODELS.TEXT_EMBEDDING.id] ?? 1024;
-}
-function makeGenerateHandler(slot) {
-  return async (_runtime, params) => {
-    const loadArgs = await resolveLoadArgsWithAutoDownload(slot);
-    if (!loadArgs) {
-      throw new Error(
-        `[mobile-device-bridge] No local GGUF model installed under ${modelsDir()} and auto-download is disabled (ELIZA_DISABLE_MODEL_AUTO_DOWNLOAD=1). Install a model or unset the disable flag.`
-      );
-    }
-    await mobileDeviceBridge.loadModel(loadArgs);
-    return mobileDeviceBridge.generate({
-      prompt: params.prompt ?? "",
-      stopSequences: params.stopSequences,
-      maxTokens: params.maxTokens,
-      temperature: params.temperature
-    });
-  };
-}
-function extractEmbeddingText(params) {
-  if (params === null) return "";
-  if (typeof params === "string") return params;
-  return params.text;
-}
-function makeEmbeddingHandler() {
-  return async (_runtime, params) => {
-    if (params === null) {
-      return new Array(resolveEmbeddingDimension()).fill(0);
-    }
-    let modelPath = resolveLocalModelPath("TEXT_EMBEDDING");
-    let loadArgs = modelPath ? { modelPath } : null;
-    if (!modelPath) {
-      if (process.env.ELIZA_DISABLE_MODEL_AUTO_DOWNLOAD?.trim() === "1") {
-        throw new Error(
-          `[mobile-device-bridge] No local GGUF embedding model installed under ${modelsDir()} and auto-download is disabled.`
-        );
-      }
-      modelPath = await downloadRecommendedModelFor("TEXT_EMBEDDING");
-      loadArgs = buildRecommendedLoadArgs("TEXT_EMBEDDING", modelPath);
-    }
-    if (!loadArgs) {
-      throw new Error(
-        `[mobile-device-bridge] No local GGUF embedding model resolved for ${modelsDir()}.`
-      );
-    }
-    await mobileDeviceBridge.loadModel(loadArgs);
-    return mobileDeviceBridge.embed({
-      input: extractEmbeddingText(params)
-    });
-  };
-}
-function getMobileDeviceBridgeStatus() {
-  return mobileDeviceBridge.status();
-}
-async function loadMobileDeviceBridgeModel(modelPath, modelId) {
-  await mobileDeviceBridge.loadModel(
-    modelId ? buildLoadArgsFromRegistryModel({ id: modelId, path: modelPath }) : { modelPath }
-  );
-}
-async function unloadMobileDeviceBridgeModel() {
-  await mobileDeviceBridge.unloadModel();
-}
-async function attachMobileDeviceBridgeToServer(server) {
-  await mobileDeviceBridge.attachToHttpServer(server);
-}
-async function ensureMobileDeviceBridgeInferenceHandlers(runtime) {
-  logger.debug("[mobile-device-bridge] Bootstrap entered");
-  if (!SERVICE_ENABLED || process.env.ELIZA_LOCAL_LLAMA?.trim() === "1") {
-    logger.debug("[mobile-device-bridge] Disabled or AOSP local llama active");
-    return false;
-  }
-  if (registeredRuntimes.has(runtime)) {
-    logger.debug("[mobile-device-bridge] Handlers already registered");
-    return true;
-  }
-  const runtimeWithRegistration = runtime;
-  if (typeof runtimeWithRegistration.getModel !== "function" || typeof runtimeWithRegistration.registerModel !== "function") {
-    logger.error(
-      "[mobile-device-bridge] Runtime is missing getModel/registerModel; cannot wire handlers."
-    );
-    return false;
-  }
-  runtimeWithRegistration.registerModel(
-    ModelType.TEXT_SMALL,
-    makeGenerateHandler("TEXT_SMALL"),
-    PROVIDER,
-    LOCAL_INFERENCE_PRIORITY
-  );
-  runtimeWithRegistration.registerModel(
-    ModelType.TEXT_LARGE,
-    makeGenerateHandler("TEXT_LARGE"),
-    PROVIDER,
-    LOCAL_INFERENCE_PRIORITY
-  );
-  if (!resolveLocalLoadArgs("TEXT_SMALL") && process.env.ELIZA_DISABLE_MODEL_AUTO_DOWNLOAD?.trim() !== "1") {
-    downloadRecommendedModelFor("TEXT_SMALL").catch(
-      (err) => logger.warn(
-        `[mobile-device-bridge] Background chat-model download failed: ${err.message}`
-      )
-    );
-  }
-  runtimeWithRegistration.registerModel(
-    ModelType.TEXT_EMBEDDING,
-    makeEmbeddingHandler(),
-    PROVIDER,
-    LOCAL_INFERENCE_PRIORITY
-  );
-  const embeddingModelPath = resolveLocalModelPath("TEXT_EMBEDDING");
-  if (!embeddingModelPath && process.env.ELIZA_DISABLE_MODEL_AUTO_DOWNLOAD?.trim() !== "1") {
-    downloadRecommendedModelFor("TEXT_EMBEDDING").catch(
-      (err) => logger.warn(
-        `[mobile-device-bridge] Background embedding-model download failed: ${err.message}`
-      )
-    );
-  }
-  logger.info(
-    `[mobile-device-bridge] Registered ${PROVIDER} handlers for TEXT_SMALL / TEXT_LARGE${embeddingModelPath ? " / TEXT_EMBEDDING" : ""} at priority ${LOCAL_INFERENCE_PRIORITY}`
-  );
-  registeredRuntimes.add(runtime);
-  return true;
-}
-export {
-  attachMobileDeviceBridgeToServer,
-  ensureMobileDeviceBridgeInferenceHandlers,
-  getMobileDeviceBridgeStatus,
-  loadMobileDeviceBridgeModel,
-  mobileDeviceBridge,
-  unloadMobileDeviceBridgeModel
-};