@elizaos/capacitor-bun-runtime 2.0.3-beta.2

package/ios/Sources/ElizaBunRuntimePlugin/kokoro/KokoroCoreMlPronunciationDicts.swift

@@ -0,0 +1,131 @@
+import Foundation
+
+/// Pronunciation dictionaries for Kokoro TTS multilingual support.
+///
+/// Large dictionaries (French, Portuguese, Hindi) are loaded from JSON resource
+/// files at runtime. Smaller ones (Spanish, Italian, German, Korean) are
+/// embedded as Swift literals. Source: ipa-dict (MIT, open-dict-data/ipa-dict)
+/// and standard phonetic references.
+enum PronunciationDicts {
+
+    // MARK: - JSON Resource Loading
+
+    private static func loadJSON(_ name: String) -> [String: String] {
+        let url = Bundle.main.url(forResource: name, withExtension: "json")
+            ?? Bundle.main.url(forResource: name, withExtension: "json", subdirectory: "KokoroTTS")
+        guard let url else { return [:] }
+        guard let data = try? Data(contentsOf: url),
+              let dict = try? JSONDecoder().decode([String: String].self, from: data) else {
+            return [:]
+        }
+        return dict
+    }
+
+    // MARK: - French (3093 entries, JSON)
+
+    static let fr: [String: String] = loadJSON("dict_fr")
+
+    // MARK: - Portuguese (2001 entries, JSON)
+
+    static let pt: [String: String] = loadJSON("dict_pt")
+
+    // MARK: - Hindi (146 entries, JSON)
+
+    static let hi: [String: String] = loadJSON("dict_hi")
+
+    // MARK: - Spanish (125 entries)
+
+    static let es: [String: String] = [
+        "adiós": "aðjˈos", "agua": "ˈaɣwa", "ahora": "aˈoɾa", "al": "ˈal",
+        "alto": "ˈalto", "amarillo": "ˌamaɾˈiʎo", "amigo": "amˈiɣo",
+        "antes": "ˈantes", "aquí": "akˈi", "azul": "aθˈul", "año": "ˈaɲo",
+        "bajo": "bˈaxo", "bien": "bjˈen", "blanco": "blˈanko", "boca": "bˈoka",
+        "brazo": "bɾˈaθo", "bueno": "bwˈeno", "buenos": "bwˈenos",
+        "cabeza": "kaβˈeθa", "café": "kafˈe", "calle": "kˈaʎe", "casa": "kˈasa",
+        "cinco": "θˈinko", "ciudad": "θjuðˈad", "comida": "komˈiða",
+        "como": "kˈomo", "con": "kˈon", "corazón": "kˌoɾaθˈon", "cosa": "kˈosa",
+        "cuando": "kwˈando", "cuatro": "kwˈatɾo", "dar": "dˈaɾ", "de": "dˈe",
+        "decir": "deθˈiɾ", "del": "dˈel", "desde": "dˈesðe", "después": "despwˈes",
+        "donde": "dˈonde", "dos": "dˈos", "día": "dˈia", "días": "dˈias",
+        "el": "ˈel", "ella": "ˈeʎa", "ellas": "ˈeʎas", "ellos": "ˈeʎos",
+        "en": "ˈen", "entre": "ˈɛntɾe", "eso": "ˈeso", "estar": "estˈaɾ",
+        "esto": "ˈesto", "familia": "famˈilja", "gracias": "ɡɾˈaθjas",
+        "grande": "ɡɾˈande", "haber": "aβˈeɾ", "hacer": "aθˈeɾ", "hasta": "ˈasta",
+        "hermana": "eɾmˈana", "hermano": "eɾmˈano", "hija": "ˈixa",
+        "hijo": "ˈixo", "hola": "ˈola", "hombre": "ˈombɾe", "ir": "ˈiɾ",
+        "joven": "xˈoβen", "la": "lˈa", "las": "lˈas", "leche": "lˈetʃe",
+        "llegar": "ʎeɣˈaɾ", "los": "lˈos", "madre": "mˈaðɾe", "malo": "mˈalo",
+        "mano": "mˈano", "mesa": "mˈesa", "mujer": "muxˈeɾ", "mundo": "mˈundo",
+        "muy": "mˈuj", "más": "mˈas", "negro": "nˈeɣɾo", "niña": "nˈiɲa",
+        "niño": "nˈiɲo", "no": "nˈo", "nosotros": "nosˈotɾos", "nuevo": "nwˈeβo",
+        "nunca": "nˈunka", "ojo": "ˈoxo", "padre": "pˈaðɾe", "pan": "pˈan",
+        "para": "pˈaɾa", "país": "paˈis", "pequeño": "pekˈeɲo",
+        "perdón": "peɾðˈon", "pero": "pˈeɾo", "pie": "pjˈe", "poder": "poðˈeɾ",
+        "por": "pˈoɾ", "porque": "pˈoɾke", "prueba": "pɾuˈeβa",
+        "puerta": "pwˈeɾta", "querer": "keɾˈeɾ", "qué": "kˈe", "rojo": "rˈoxo",
+        "saber": "saβˈeɾ", "ser": "sˈer", "siempre": "sjˈempɾe", "sin": "sˈin",
+        "sobre": "sˈoβɾe", "sí": "sˈi", "también": "tambjˈen", "tener": "tenˈeɾ",
+        "tiempo": "tjˈempo", "todo": "tˈoðo", "tres": "tɾˈes", "tú": "tˈu",
+        "un": "ˈun", "una": "ˈuna", "uno": "ˈuno", "usted": "ustˈed",
+        "ventana": "bentˈana", "ver": "bˈeɾ", "verde": "bˈeɾðe", "vida": "bˈiða",
+        "viejo": "bjˈexo", "vino": "bˈino", "yo": "ʝˈo", "él": "ˈel",
+    ]
+
+    // MARK: - Italian (174 entries)
+
+    static let it: [String: String] = [
+        "acqua": "ˈakːwa", "alto": "ˈalto", "altro": "ˈaltro", "amico": "amˈiko",
+        "anche": "ˈanke", "andare": "andˈare", "anno": "ˈanno", "avere": "avˈere",
+        "bambina": "bambˈina", "bambino": "bambˈino", "basso": "bˈasso",
+        "bella": "bˈɛlla", "bello": "bˈɛllo", "bene": "bˈɛne", "bere": "bˈere",
+        "bianco": "bjˈanko", "blu": "blˈu", "bocca": "bˈokːa",
+        "braccio": "brˈatʃːo", "brutto": "brˈutːo", "buonasera": "bwˌɔnasˈera",
+        "buongiorno": "bʊondʒˈɔrno", "buono": "bʊˈɔno", "caffè": "kaffˈɛ",
+        "caldo": "kˈaldo", "casa": "kˈaza", "cattivo": "katːˈivo", "che": "kˈe",
+        "chi": "kˈi", "ciao": "tʃˈao", "cibo": "tʃˈibo", "cinque": "tʃˈinkwe",
+        "città": "tʃitːˈa", "come": "kˈome", "cosa": "kˈɔza", "cuore": "kʊˈɔre",
+        "dal": "dˈal", "dalla": "dˈalla", "dare": "dˈare", "debole": "dˈebole",
+        "dei": "dˈeɪ", "del": "dˈel", "della": "dˈella", "delle": "dˈelle",
+        "dello": "dˈello", "di": "dˈi", "dieci": "djˈɛtʃɪ", "dire": "dˈire",
+        "domani": "domˈanɪ", "donna": "dˈɔnna", "dopo": "dˈopo",
+        "dormire": "dormˈire", "dove": "dˈove", "dovere": "dovˈere", "due": "dˈue",
+        "erano": "ˈɛrano", "essere": "ˈɛssere", "famiglia": "famˈiʎa",
+        "fare": "fˈare", "felice": "felˈitʃe", "figlia": "fˈiʎa",
+        "figlio": "fˈiʎo", "finestra": "finˈɛstra", "forte": "fˈɔrte",
+        "fratello": "fratˈɛllo", "freddo": "frˈedːo", "gamba": "ɡˈamba",
+        "giallo": "dʒˈallo", "giorno": "dʒˈorno", "giovane": "dʒˈovane",
+        "gli": "ʎˈɪ", "grande": "ɡrˈande", "grazie": "ɡrˈatsje",
+        "ieri": "jˈɛrɪ", "il": "ˈiːl", "io": "ˈio", "la": "lˈa",
+        "latte": "lˈatːe", "le": "lˈe", "leggere": "lˈɛdʒːere", "lei": "lˈɛi",
+        "lo": "lˈo", "loro": "lˈɔro", "lui": "lˈui", "lungo": "lˈuŋɡo",
+        "ma": "mˈa", "madre": "mˈadre", "mai": "mˈaj", "mangiare": "mandʒˈare",
+        "mano": "mˈano", "mattina": "matːˈina", "migliore": "miʎˈore",
+        "molto": "mˈolto", "mondo": "mˈondo", "nero": "nˈero", "noi": "nˈoi",
+        "non": "nˈon", "notte": "nˈɔtːe", "nove": "nˈɔve", "nuovo": "nʊˈɔvo",
+        "occhio": "ˈɔkːio", "oggi": "ˈɔdʒːɪ", "ogni": "ˈoɲɲɪ", "ora": "ˈora",
+        "otto": "ˈɔtːo", "padre": "pˈadre", "paese": "paˈeze", "pane": "pˈane",
+        "parlare": "parlˈare", "peggiore": "pedʒːˈore", "pensare": "pensˈare",
+        "perché": "perkˈe", "piccolo": "pˈikːolo", "piede": "pjˈɛde",
+        "più": "pjˈu", "porta": "pˈɔrta", "potere": "potˈere", "prego": "prˈɛɡo",
+        "prima": "prˈima", "primo": "prˈimo", "prova": "prˈɔva",
+        "quale": "kwˈale", "quando": "kwˈando", "quanto": "kwˈanto",
+        "quattro": "kwˈatːro", "quello": "kwˈello", "questa": "kwˈesta",
+        "questo": "kwˈesto", "qui": "kwˈi", "rosso": "rˈosso",
+        "sapere": "sapˈere", "scrivere": "skrˈivere", "scusi": "skˈuzɪ",
+        "secondo": "sekˈondo", "sedia": "sˈɛdia", "sei": "sˈɛi",
+        "sempre": "sˈɛmpre", "sentire": "sentˈire", "sera": "sˈera",
+        "sette": "sˈɛtːe", "siamo": "sjˈamo", "siete": "sjˈete",
+        "sole": "sˈole", "sono": "sˈono", "sorella": "sorˈɛlla",
+        "splende": "splˈɛnde", "stare": "stˈare", "stata": "stˈata",
+        "stato": "stˈato", "stesso": "stˈesso", "strada": "strˈada",
+        "sì": "sˈiː", "tavola": "tˈavola", "tempo": "tˈɛmpo",
+        "terzo": "tˈɛrtso", "testa": "tˈɛsta", "tre": "trˈe",
+        "triste": "trˈiste", "tu": "tˈu", "tutto": "tˈutːo",
+        "ultimo": "ˈultimo", "un": "ˈun", "una": "ˈuna", "uno": "ˈuno",
+        "uomo": "wˈɔmo", "vecchio": "vˈɛkːio", "vedere": "vedˈere",
+        "venire": "venˈire", "verde": "vˈerde", "vino": "vˈino",
+        "vita": "vˈita", "voi": "vˈoi", "volere": "volˈere", "è": "ˈɛː",
+    ]
+
+
+}

package/ios/Sources/ElizaBunRuntimePlugin/kokoro/KokoroCoreMlSupport.swift

@@ -0,0 +1,24 @@
+import Foundation
+import os
+
+enum AudioModelError: LocalizedError {
+    case modelLoadFailed(modelId: String, reason: String)
+    case inferenceFailed(operation: String, reason: String)
+    case voiceNotFound(voice: String, searchPath: String)
+
+    var errorDescription: String? {
+        switch self {
+        case let .modelLoadFailed(modelId, reason):
+            return "Kokoro CoreML model load failed for \(modelId): \(reason)"
+        case let .inferenceFailed(operation, reason):
+            return "Kokoro CoreML inference failed during \(operation): \(reason)"
+        case let .voiceNotFound(voice, searchPath):
+            return "Kokoro CoreML voice not found: \(voice). \(searchPath)"
+        }
+    }
+}
+
+enum AudioLog {
+    static let inference = Logger(subsystem: "ai.eliza.ios", category: "KokoroCoreMLInference")
+    static let modelLoading = Logger(subsystem: "ai.eliza.ios", category: "KokoroCoreMLModelLoading")
+}

package/ios/Tests/llama-bridge-smoke-main.swift

@@ -0,0 +1,92 @@
+// llama-bridge-smoke-main.swift — manual smoke test for LlamaBridgeImpl.
+//
+// This is NOT a unit test — it's a top-level Swift script for sanity-checking
+// the real backend (`LlamaBridgeImpl`) against a real GGUF model. Run after
+// `build-ios.sh` produces `LlamaCpp.xcframework` and `download-first-light.sh`
+// places a model on disk.
+//
+// The smoke does NOT exercise the JS bridge surface — that's `LlamaBridge.swift`'s
+// job. Here we just confirm that the C-API bindings, sampler chain, and decode
+// loop produce coherent text.
+//
+// Usage on an iOS device (the only platform where this can actually run,
+// since the static lib targets iOS device or simulator, not macOS):
+//
+//   1. Add this file + LlamaBridgeImpl.swift to an iOS test target inside
+//      Xcode. Set the target's "Other Linker Flags" to include the path to
+//      LlamaCpp.xcframework (or list it under Frameworks/Libraries).
+//
+//   2. Run as a unit test, or as the main entry point of an iOS test app.
+//
+//   3. Pass the model path via Info.plist (LlamaSmokeModelPath) or hardcode
+//      it for a quick manual run.
+//
+// Expected output:
+//   [smoke] Hardware: backend=metal, total_ram=8.0 GB, metal_supported=true
+//   [smoke] Loading model …
+//   [smoke] context_id=1
+//   [smoke] Generating …
+//   [smoke] >>> Hello! I'm an AI assistant. How can I help you today?
+//   [smoke] Generated 16 tokens in 234 ms.
+
+import Foundation
+
+@main
+struct LlamaSmoke {
+    static func main() {
+        guard CommandLine.arguments.count >= 2 else {
+            FileHandle.standardError.write(Data("usage: llama-bridge-smoke <model.gguf>\n".utf8))
+            exit(2)
+        }
+        let modelPath = CommandLine.arguments[1]
+
+        let impl = LlamaBridgeImpl.shared
+
+        // 1. Hardware probe.
+        let hw = impl.hardwareInfo()
+        print("[smoke] Hardware: backend=\(hw.backend), total_ram=\(String(format: "%.2f", hw.totalRamGB)) GB, metal_supported=\(hw.metalSupported), simulator=\(hw.isSimulator)")
+
+        // 2. Load model.
+        print("[smoke] Loading model from \(modelPath) …")
+        let loadResult = impl.loadModel(
+            path: modelPath,
+            contextSize: 2048,
+            useGPU: true
+        )
+        guard let contextId = loadResult.contextId else {
+            FileHandle.standardError.write(Data("[smoke] load failed: \(loadResult.error ?? "unknown")\n".utf8))
+            exit(3)
+        }
+        print("[smoke] context_id=\(contextId)")
+
+        // 3. Generate (streaming).
+        print("[smoke] Generating …")
+        print("[smoke] >>> ", terminator: "")
+        fflush(stdout)
+        let genResult = impl.generate(
+            contextId: contextId,
+            prompt: "<|im_start|>user\nSay hello in one short sentence.<|im_end|>\n<|im_start|>assistant\n",
+            maxTokens: 64,
+            temperature: 0.7,
+            topP: 0.9,
+            stopSequences: ["<|im_end|>"],
+            onToken: { tok, last in
+                if !last {
+                    print(tok, terminator: "")
+                    fflush(stdout)
+                }
+            }
+        )
+        print()  // newline after streamed tokens
+
+        if let err = genResult.error {
+            FileHandle.standardError.write(Data("[smoke] generate failed: \(err)\n".utf8))
+        } else {
+            print("[smoke] Generated \(genResult.outputTokens) tokens in \(String(format: "%.0f", genResult.durationMs)) ms (prompt was \(genResult.promptTokens) tokens).")
+        }
+
+        // 4. Free.
+        impl.free(contextId: contextId)
+        print("[smoke] Freed context \(contextId). Done.")
+    }
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@elizaos/capacitor-bun-runtime",
+  "version": "2.0.3-beta.2",
+  "description": "Embedded Bun-shape JS runtime bridge for iOS and Android",
+  "keywords": [
+    "capacitor",
+    "bun",
+    "javascriptcore",
+    "embedded-runtime",
+    "eliza"
+  ],
+  "main": "./dist/plugin.cjs.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "bun": "./src/index.ts",
+      "development": "./src/index.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/plugin.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "ios/Sources/",
+    "ios/Tests/",
+    "ElizaosCapacitorBunRuntime.podspec",
+    "dist/",
+    "src/",
+    "README.md"
+  ],
+  "author": "elizaOS",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/elizaOS/eliza.git",
+    "directory": "plugins/plugin-native-bun-runtime"
+  },
+  "scripts": {
+    "build": "node ../../packages/scripts/with-package-build-lock.mjs plugins/plugin-native-bun-runtime -- bun run build:unlocked",
+    "clean": "node ../../packages/scripts/rm-path-recursive.mjs dist",
+    "test": "vitest run",
+    "prepublishOnly": "bun run build",
+    "watch": "tsc --watch",
+    "build:unlocked": "bun run clean && tsc && bunx rollup -c rollup.config.mjs"
+  },
+  "devDependencies": {
+    "@capacitor/core": "^8.3.1",
+    "rollup": "^4.60.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.17"
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^8.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios",
+      "podName": "ElizaosCapacitorBunRuntime"
+    }
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
+}

package/src/bridge-contract.test.ts

@@ -0,0 +1,127 @@
+/**
+ * Unit tests for the ElizaBunRuntime TypeScript public surface.
+ *
+ * These tests exercise the JS-side contract only — no native plugin is
+ * loaded. They verify:
+ *   - The web fallback returns the correct unavailable shapes so callers can
+ *     detect the unavailable-on-web case without throwing.
+ *   - `StartOptions` and `StartResult` shapes are correct at the type level.
+ *   - Malformed / missing required fields produce clear rejections in the
+ *     web fallback (mirrors what native implementations must also do).
+ */
+
+import { describe, expect, it } from "vitest";
+import { ElizaBunRuntimeWeb } from "./web";
+
+describe("ElizaBunRuntimeWeb — unavailable-on-web returns", () => {
+  const web = new ElizaBunRuntimeWeb();
+
+  it("start() resolves with ok:false and an error string", async () => {
+    const result = await web.start({});
+    expect(result.ok).toBe(false);
+    expect(typeof result.error).toBe("string");
+    expect(result.error?.length).toBeGreaterThan(0);
+  });
+
+  it("getStatus() resolves with ready:false", async () => {
+    const status = await web.getStatus();
+    expect(status.ready).toBe(false);
+  });
+
+  it("stop() resolves without throwing", async () => {
+    await expect(web.stop()).resolves.toBeUndefined();
+  });
+});
+
+describe("ElizaBunRuntimeWeb — malformed-input rejection", () => {
+  const web = new ElizaBunRuntimeWeb();
+
+  it("sendMessage() rejects with an unavailable error on web", async () => {
+    await expect(web.sendMessage({ message: "hello" })).rejects.toThrow();
+  });
+
+  it("call() rejects with an unavailable error on web", async () => {
+    await expect(web.call({ method: "status" })).rejects.toThrow();
+  });
+
+  it.each([
+    { message: "" },
+    { message: "<script>alert(1)</script>", conversationId: "../escape" },
+    { message: "x".repeat(100_000) },
+  ])("does not reflect hostile sendMessage payloads %#", async (options) => {
+    await expect(web.sendMessage(options)).rejects.toThrow(
+      "ElizaBunRuntime.sendMessage is unavailable on web.",
+    );
+  });
+
+  it.each([
+    { method: "" },
+    { method: "__proto__", args: { polluted: true } },
+    { method: "status", args: { nested: { value: ["x"] } } },
+  ])("does not reflect hostile call payloads %#", async (options) => {
+    await expect(web.call(options)).rejects.toThrow(
+      "ElizaBunRuntime.call is unavailable on web.",
+    );
+  });
+});
+
+describe("ElizaBunRuntimeWeb — local TTS web fallback", () => {
+  const web = new ElizaBunRuntimeWeb();
+
+  it("reports local TTS as unavailable on web", async () => {
+    await expect(web.getLocalTtsStatus()).resolves.toEqual({
+      ready: false,
+      status: "unavailable",
+      message:
+        "ElizaBunRuntime local TTS is not available on web. Run on an iOS device or simulator.",
+    });
+  });
+
+  it("returns diagnostics without reflecting hostile options", async () => {
+    await expect(
+      web.getLocalTtsDiagnostics({
+        bundleDir: "../escape",
+        probe: true,
+        text: "<script>alert(1)</script>",
+      }),
+    ).resolves.toEqual({
+      available: false,
+      message:
+        "ElizaBunRuntime local TTS diagnostics are not available on web. Run on an iOS device or simulator.",
+    });
+  });
+
+  it("rejects synthesis with a stable unavailable error", async () => {
+    await expect(
+      web.synthesizeLocalTts({
+        text: "<script>alert(1)</script>",
+        bundleDir: "file:///etc/passwd",
+        maxSamples: Number.POSITIVE_INFINITY,
+      }),
+    ).rejects.toThrow(
+      "ElizaBunRuntime.synthesizeLocalTts is unavailable on web.",
+    );
+  });
+});
+
+describe("bridge contract — StartOptions shape", () => {
+  it("accepts engine=auto | bun | compat and optional fields", async () => {
+    const web = new ElizaBunRuntimeWeb();
+    // All option variants must be accepted at the type level (compile-time test)
+    // and produce an ok:false result at runtime (web fallback).
+    for (const engine of ["auto", "bun", "compat"] as const) {
+      const result = await web.start({
+        engine,
+        env: { FOO: "bar" },
+        argv: ["bun", "agent-bundle.js"],
+      });
+      expect(result.ok).toBe(false);
+    }
+  });
+
+  it("start() without options resolves (all fields optional)", async () => {
+    const web = new ElizaBunRuntimeWeb();
+    const result = await web.start({});
+    expect(result).toHaveProperty("ok");
+  });
+});

package/src/definitions.d.ts

@@ -0,0 +1,136 @@
+/**
+ * @elizaos/capacitor-bun-runtime — iOS embedded Bun-shape JS runtime.
+ *
+ * Hosts a JavaScriptCore JSContext on a dedicated worker thread. The native
+ * plugin either starts a bundled full Bun engine framework or installs the
+ * `__ELIZA_BRIDGE__` host functions for the compatibility JSContext path.
+ * The full-engine ABI lives in packages/native/bun-runtime/BRIDGE_CONTRACT.md.
+ *
+ * The plugin exposes a tiny surface to the React UI: start the runtime,
+ * send messages, check status, and stop it. Everything else flows over the
+ * `ui_post_message` / `ui_register_handler` channel inside the native side.
+ */
+export interface StartOptions {
+    /**
+     * Runtime engine selection:
+     * - "auto" (default): use a bundled full Bun engine when present. The
+     *   JSContext compatibility fallback is for development/sideload builds only;
+     *   iOS store local mode must request "bun" and fail if the engine is missing.
+     * - "bun": require ElizaBunEngine.framework and fail if it is missing.
+     * - "compat": force the JSContext compatibility bridge for development.
+     */
+    engine?: "auto" | "bun" | "compat";
+    /**
+     * Path to the agent bundle JavaScript file. When omitted, the runtime
+     * loads the staged iOS agent payload from `public/agent/agent-bundle.js`
+     * in the main app bundle resources. Legacy JSContext development bundles
+     * named `agent-bundle-ios.js` are still probed for compatibility.
+     * Use this only for development overrides.
+     */
+    bundlePath?: string;
+    /**
+     * Optional polyfill prefix loaded before the agent bundle. When omitted,
+     * the runtime loads `eliza-polyfill-prefix.js` from the main app bundle
+     * resources, or falls back to a minimal embedded prefix.
+     */
+    polyfillPath?: string;
+    /**
+     * Initial environment variables visible to the agent via `env_get` / `env_keys`.
+     */
+    env?: Record<string, string>;
+    /**
+     * argv vector exposed to the agent via `argv()`. Defaults to
+     * `["bun", "public/agent/agent-bundle.js"]`.
+     */
+    argv?: string[];
+}
+export interface StartResult {
+    ok: boolean;
+    error?: string;
+    /** Version string emitted by `__ELIZA_BRIDGE_VERSION__`. */
+    bridgeVersion?: string;
+}
+export interface SendMessageOptions {
+    message: string;
+    /** Optional conversation/thread identifier passed through to the agent. */
+    conversationId?: string;
+}
+export interface SendMessageResult {
+    reply: string;
+}
+export interface GetStatusResult {
+    ready: boolean;
+    /** Active runtime engine: full Bun framework or compatibility bridge. */
+    engine?: "bun" | "compat";
+    /** Currently loaded llama model path, if any. */
+    model?: string;
+    /** Last observed generation throughput. */
+    tokensPerSecond?: number;
+    /** Bridge version string, e.g. "v1". */
+    bridgeVersion?: string;
+}
+/**
+ * Generic call surface for any UI handler the agent has registered via
+ * `bridge.ui_register_handler`. The React UI passes a method name and args;
+ * the native plugin dispatches into the JSContext and returns the result.
+ */
+export interface CallOptions {
+    method: string;
+    args?: unknown;
+}
+export interface CallResult {
+    result: unknown;
+}
+export interface LocalTtsStatusResult {
+    ready: boolean;
+    status: "assets-ready" | "engine-ready" | "ready" | "missing" | "unavailable";
+    message: string;
+    modelId?: string;
+    bundleDir?: string;
+}
+export interface LocalTtsDiagnosticsOptions {
+    bundleDir?: string;
+    probe?: boolean;
+    text?: string;
+}
+export interface LocalTtsDiagnosticsResult {
+    available: boolean;
+    selectedBundleDir?: string;
+    modelId?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+export interface SynthesizeLocalTtsOptions {
+    text: string;
+    bundleDir?: string;
+    speakerPresetId?: string;
+    voice?: string;
+    voiceId?: string;
+    maxSamples?: number;
+    play?: boolean;
+}
+export interface SynthesizeLocalTtsResult {
+    audioBase64?: string;
+    contentType: "audio/wav";
+    sampleRate: number;
+    samples: number;
+    durationMs: number;
+    modelId?: string;
+    played?: boolean;
+}
+export interface ElizaBunRuntimePlugin {
+    start(options: StartOptions): Promise<StartResult>;
+    sendMessage(options: SendMessageOptions): Promise<SendMessageResult>;
+    getStatus(): Promise<GetStatusResult>;
+    stop(): Promise<void>;
+    getLocalTtsStatus(): Promise<LocalTtsStatusResult>;
+    getLocalTtsDiagnostics(options?: LocalTtsDiagnosticsOptions): Promise<LocalTtsDiagnosticsResult>;
+    synthesizeLocalTts(options: SynthesizeLocalTtsOptions): Promise<SynthesizeLocalTtsResult>;
+    /**
+     * Invoke an arbitrary UI handler that the agent has registered via
+     * `bridge.ui_register_handler`. Useful for routing arbitrary RPC-style
+     * traffic from the React UI into the agent.
+     */
+    call(options: CallOptions): Promise<CallResult>;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/src/definitions.d.ts.map

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