@elizaos/plugin-local-inference 2.0.0-beta.1 → 2.0.3-beta.3

package/dist/routes/live-diarization-route.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `/api/voice/audio-frames` — WebView → agent transport for live on-device
+ * speaker diarization.
+ *
+ * The Android `audioFrame` PCM stream is captured in the Capacitor WebView but
+ * the bun:ffi voice libs run in the agent process. The WebView batches frames
+ * (~49 fps) and POSTs them here; this route feeds them to the single
+ * {@link LiveDiarizationSession}, which runs the real ggml VAD / encoder /
+ * diarizer / attribution pipeline and emits VOICE_TURN_OBSERVED.
+ *
+ * Routes:
+ *   POST /api/voice/audio-frames        body: { frames: AudioFrameEvent[],
+ *                                               flush?: boolean }
+ *                                       → { ok, framesReceived, turnsObserved }
+ *   POST /api/voice/playback-frames     body: { frames?: AudioFrameEvent[],
+ *                                               reset?: boolean }
+ *                                       → { ok, framesPushed }
+ *     The agent's own TTS playback (far-end) in the same base64 LE-s16 16 kHz
+ *     mono wire format, streamed in real time so the session's NLMS canceller
+ *     removes the agent's echo before VAD/attribution (#9455/#9583). Send
+ *     `reset: true` when playback stops / on barge-in.
+ *   GET  /api/voice/audio-frames/status → LiveDiarizationStatus (device evidence)
+ *
+ * Auth follows the compat pattern: trusted-loopback OR the compat API token.
+ * The WebView reaches this over 127.0.0.1 (trusted local), matching the rest of
+ * the on-device agent surface.
+ */
+import type http from "node:http";
+import { type CompatRuntimeState } from "./compat-helpers.js";
+/** Reset the module-level session (tests + capture teardown). */
+export declare function resetLiveDiarizationSession(): Promise<void>;
+export declare function handleLiveDiarizationRoute(req: http.IncomingMessage, res: http.ServerResponse, state: CompatRuntimeState): Promise<boolean>;
+//# sourceMappingURL=live-diarization-route.d.ts.map

package/dist/routes/live-diarization-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-diarization-route.d.ts","sourceRoot":"","sources":["../../src/routes/live-diarization-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AASlC,OAAO,EACN,KAAK,kBAAkB,EAKvB,MAAM,qBAAqB,CAAC;AA2C7B,iEAAiE;AACjE,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjE;AAgBD,wBAAsB,0BAA0B,CAC/C,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CAsFlB"}

package/dist/routes/local-inference-asr-route.d.ts

@@ -0,0 +1,4 @@
+import type http from "node:http";
+import { type CompatRuntimeState } from "./compat-helpers";
+export declare function handleLocalInferenceAsrRoute(req: http.IncomingMessage, res: http.ServerResponse, state: CompatRuntimeState): Promise<boolean>;
+//# sourceMappingURL=local-inference-asr-route.d.ts.map

package/dist/routes/local-inference-asr-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-inference-asr-route.d.ts","sourceRoot":"","sources":["../../src/routes/local-inference-asr-route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EACN,KAAK,kBAAkB,EAIvB,MAAM,kBAAkB,CAAC;AA4E1B,wBAAsB,4BAA4B,CACjD,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CA6ElB"}

package/dist/routes/local-inference-asr-transcribe.d.ts

@@ -0,0 +1,20 @@
+import { type AgentRuntime } from "@elizaos/core";
+import { type AsrWordTiming } from "../services/voice";
+/** A transcript plus optional per-word timings (ms from audio start). */
+export interface LocalAsrTranscript {
+    text: string;
+    words: AsrWordTiming[];
+}
+/**
+ * Transcribe WAV audio to text + per-word timings.
+ *
+ * The primary path is the single fused libelizainference FFI pipe
+ * (`transcribePcmTimed`, ASR ABI v12) — the cross-platform on-device runtime
+ * that emits per-word `[startMs,endMs)` timings the transcript player
+ * highlights against. When the in-process engine is not the active local
+ * backend (a device-bridge / capacitor / AOSP topology owns transcription),
+ * fall back to the `useModel` provider chain for the transcript text; word
+ * timings are unavailable on that path (`words: []`).
+ */
+export declare function transcribeWavWithWords(runtime: AgentRuntime, audioWav: Uint8Array, signal?: AbortSignal): Promise<LocalAsrTranscript>;
+//# sourceMappingURL=local-inference-asr-transcribe.d.ts.map

package/dist/routes/local-inference-asr-transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-inference-asr-transcribe.d.ts","sourceRoot":"","sources":["../../src/routes/local-inference-asr-transcribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAa,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,mBAAmB,CAAC;AAE3E,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,EAAE,CAAC;CACvB;AA+BD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,UAAU,EACpB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,kBAAkB,CAAC,CAc7B"}

package/dist/routes/local-inference-compat-routes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * HTTP routes for the local-inference / model management feature.
+ *
+ * Route shape and auth follow the established `*-compat-routes.ts` pattern:
+ *   - `handleLocalInferenceCompatRoutes` returns `true` when it handles a
+ *     request and `false` to pass through to the next handler.
+ *   - Regular reads use `ensureCompatApiAuthorized`.
+ *   - Mutating routes (download start/cancel, active switch, uninstall)
+ *     use `ensureCompatSensitiveRouteAuthorized`.
+ *   - SSE allows `?token=...` as an alternative to the auth header, via
+ *     `isStreamAuthorized`.
+ */
+import type http from "node:http";
+import { type CompatRuntimeState } from "./compat-helpers";
+export declare function handleLocalInferenceCompatRoutes(req: http.IncomingMessage, res: http.ServerResponse, state: CompatRuntimeState): Promise<boolean>;
+//# sourceMappingURL=local-inference-compat-routes.d.ts.map

package/dist/routes/local-inference-compat-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-inference-compat-routes.d.ts","sourceRoot":"","sources":["../../src/routes/local-inference-compat-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AA2BlC,OAAO,EACN,KAAK,kBAAkB,EASvB,MAAM,kBAAkB,CAAC;AAoK1B,wBAAsB,gCAAgC,CACrD,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CA4iBlB"}

package/dist/routes/local-inference-tts-route.d.ts

@@ -0,0 +1,7 @@
+import type http from "node:http";
+import { type CompatRuntimeState } from "./compat-helpers";
+export declare function sanitizeLocalInferenceSpeechText(input: string): string;
+export declare function normalizeAudioBytes(value: unknown): Uint8Array;
+export declare function sniffAudioContentType(bytes: Uint8Array): string;
+export declare function handleLocalInferenceTtsRoute(req: http.IncomingMessage, res: http.ServerResponse, state: CompatRuntimeState): Promise<boolean>;
+//# sourceMappingURL=local-inference-tts-route.d.ts.map

package/dist/routes/local-inference-tts-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-inference-tts-route.d.ts","sourceRoot":"","sources":["../../src/routes/local-inference-tts-route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EACN,KAAK,kBAAkB,EAIvB,MAAM,kBAAkB,CAAC;AAS1B,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAatE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAW9D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CA0B/D;AA0DD,wBAAsB,4BAA4B,CACjD,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CAiGlB"}

package/dist/routes/native-pcm-turn-route.d.ts

@@ -0,0 +1,3 @@
+import type http from "node:http";
+export declare function handleNativePcmTurnRoute(req: http.IncomingMessage, res: http.ServerResponse): Promise<boolean>;
+//# sourceMappingURL=native-pcm-turn-route.d.ts.map

package/dist/routes/native-pcm-turn-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-pcm-turn-route.d.ts","sourceRoot":"","sources":["../../src/routes/native-pcm-turn-route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAyElC,wBAAsB,wBAAwB,CAC7C,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CA4ClB"}

package/dist/routes/transcript-audio-store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Transcript audio persistence (#8789).
+ *
+ * The transcript create route runs in plugin-local-inference, which cannot
+ * import the agent-internal media store (`packages/agent/src/api/media-store.ts`
+ * is not exported). But that store is just a content-addressed write under
+ * `<stateDir>/media/<sha256>.<ext>`, served by the agent's `serveMediaFile` at
+ * `/api/media/<sha256>.<ext>` (with HTTP Range, so `<audio>` scrubbing works).
+ * Writing the session WAV the same way — via core's `resolveStateDir` — lands it
+ * in the exact dir the agent already serves, so transcript audio plays back
+ * with zero extra wiring. Idempotent (sha256 filename).
+ */
+/** Persist mono PCM16 WAV bytes; returns the served `/api/media/<hash>.wav` URL. */
+export declare function persistTranscriptAudioWav(wav: Buffer): string;
+//# sourceMappingURL=transcript-audio-store.d.ts.map

package/dist/routes/transcript-audio-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-audio-store.d.ts","sourceRoot":"","sources":["../../src/routes/transcript-audio-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO7D"}

package/dist/routes/transcripts-routes.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Transcript HTTP routes (#8789) — `/api/transcripts*`, served as rawPath plugin
+ * routes (on `runtime.routes`, dispatched by both the upstream agent server and
+ * app-core) so the Transcripts view + the recording pipeline have a backend.
+ * Audio is served by the existing content-addressed media store via each
+ * record's `audioUrl`, so no separate audio route is needed.
+ *
+ * Private routes: the host dispatcher answers 401 for unauthenticated callers.
+ */
+import type { Route, UUID } from "@elizaos/core";
+import { type Transcript, type TranscriptScope, type TranscriptSegment, type TranscriptSource } from "@elizaos/shared/transcripts";
+/** The body a recording session POSTs to create a transcript record. */
+export interface CreateTranscriptRequest {
+    /** Optional — the route derives these from the agent context when absent (the
+     *  shell client doesn't carry world/room/entity ids). */
+    worldId?: UUID;
+    roomId?: UUID;
+    entityId?: UUID;
+    title?: string;
+    source?: TranscriptSource;
+    scope?: TranscriptScope;
+    segments: TranscriptSegment[];
+    audioUrl?: string;
+    audioContentType?: string;
+    /** Base64 WAV bytes — persisted to the media store; sets audioUrl. */
+    audioBase64?: string;
+    createdAt?: number;
+}
+/**
+ * Build a full {@link Transcript} from a create request — derives duration +
+ * speaker count from the segments, defaults title/scope/status. Pure (id + now
+ * injected) so it is unit-testable.
+ */
+export declare function buildTranscriptFromRequest(body: CreateTranscriptRequest, id: string, now: number): Transcript;
+/** The body a transcript editor PUTs to persist a user edit. */
+export interface UpdateTranscriptRequest {
+    worldId?: UUID;
+    roomId?: UUID;
+    entityId?: UUID;
+    title?: string;
+    segments?: TranscriptSegment[];
+}
+export declare const transcriptsRoutes: Route[];
+//# sourceMappingURL=transcripts-routes.d.ts.map

package/dist/routes/transcripts-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcripts-routes.d.ts","sourceRoot":"","sources":["../../src/routes/transcripts-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACX,KAAK,EAGL,IAAI,EACJ,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAGrB,MAAM,6BAA6B,CAAC;AAWrC,wEAAwE;AACxE,MAAM,WAAW,uBAAuB;IACvC;6DACyD;IACzD,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,uBAAuB,EAC7B,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,GACT,UAAU,CAiBZ;AAsCD,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACvC,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AA6DD,eAAO,MAAM,iBAAiB,EAAE,KAAK,EAMpC,CAAC"}

package/dist/routes/voice-first-run-routes.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Voice first-run HTTP routes.
+ *
+ * The flow (R2-speaker.md §6):
+ *
+ *   POST /api/voice/first-run/profile/start
+ *     → { sessionId, script: ScriptStep[], embeddingModel }
+ *
+ *   POST /api/voice/first-run/profile/append?id=<sessionId>
+ *     Content-Type: application/octet-stream
+ *     Body: PCM (Float32, 16 kHz, mono) for one capture window
+ *     → { sessionId, samplesReceived, totalSamples, durationMs }
+ *
+ *   POST /api/voice/first-run/profile/finalize?id=<sessionId>&entityId=<id>
+ *     → { profileId, entityId, samples, durationMs }
+ *
+ *   POST /api/voice/first-run/complete
+ *     Body: { entityId: string }
+ *     → { ownerEntityId, settingsWritten: ["ELIZA_ADMIN_ENTITY_ID"] }
+ *
+ * Sessions are in-memory. They expire after 30 minutes of inactivity.
+ * The encoder is loaded lazily; the route handlers return a structured
+ * 503 if the native GGML library is missing.
+ *
+ * Audio storage: when the user grants `audioRefs` consent, sample WAVs
+ * land under `$ELIZA_STATE_DIR/voice-profiles/audio/<profileId>/...`.
+ * Otherwise nothing is written to disk except the centroid + variance.
+ */
+import type * as http from "node:http";
+import { VoiceProfileStore } from "../services/voice/profile-store";
+import { type SpeakerEncoder } from "../services/voice/speaker/encoder";
+/** Verbatim first-run script (R2-speaker.md §6.2). */
+export interface FirstRunScriptStep {
+    id: string;
+    role: "consent" | "calibration" | "phonetic" | "prosody" | "quiet" | "open";
+    prompt: string;
+    expectedDurationMs: number;
+    requiresUserSpeech: boolean;
+}
+export declare const FIRST_RUN_SCRIPT: ReadonlyArray<FirstRunScriptStep>;
+/**
+ * Encoder factory. By default the route handlers load the WeSpeaker
+ * ResNet34-LM speaker encoder through the fused `libelizainference`
+ * `eliza_inference_speaker_*` ABI — the sole on-device speaker runtime.
+ * Tests inject a fake encoder via `setVoiceFirstRunEncoderFactory()`.
+ */
+export type EncoderFactory = () => Promise<SpeakerEncoder>;
+export declare function setVoiceFirstRunEncoderFactory(factory: EncoderFactory | null): void;
+export declare function setVoiceFirstRunProfileStore(store: VoiceProfileStore | null): void;
+/** Settings-write hook. The runtime overrides this with `runtime.setSetting`. */
+type SettingsWriter = (key: string, value: string) => void | Promise<void>;
+export declare function setVoiceFirstRunSettingsWriter(writer: SettingsWriter | null): void;
+/**
+ * Mount-point: returns `true` if the request was handled, `false` if
+ * the path is not one of the voice-first-run routes (so the caller
+ * can fall through to the next handler).
+ */
+export declare function handleVoiceFirstRunRoutes(req: http.IncomingMessage, res: http.ServerResponse): Promise<boolean>;
+/** Test helper: clear in-memory sessions so a test starts clean. */
+export declare function __resetVoiceFirstRunSessions(): void;
+export {};
+//# sourceMappingURL=voice-first-run-routes.d.ts.map

package/dist/routes/voice-first-run-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-first-run-routes.d.ts","sourceRoot":"","sources":["../../src/routes/voice-first-run-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAC;AAWvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAEN,KAAK,cAAc,EAMnB,MAAM,mCAAmC,CAAC;AAG3C,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,kBAAkB,CA4E9D,CAAC;AA2BF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;AAK3D,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,cAAc,GAAG,IAAI,GAC5B,IAAI,CAGN;AAyCD,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAC7B,IAAI,CAEN;AAWD,iFAAiF;AACjF,KAAK,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAG3E,wBAAgB,8BAA8B,CAC7C,MAAM,EAAE,cAAc,GAAG,IAAI,GAC3B,IAAI,CAEN;AAyCD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC9C,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CAgOlB;AAED,oEAAoE;AACpE,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}

package/dist/routes/voice-models-routes.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Local-runtime compat routes for the voice sub-model auto-updater
+ * (R5-versioning §3 + §4 + §5).
+ *
+ * Mirrors the signed Cloud catalog endpoint
+ * (`cloud/apps/api/v1/voice-models/catalog/route.ts`) for the on-device
+ * surface so the UI can talk to the local runtime without depending on
+ * Cloud being reachable. The endpoints expose:
+ *
+ *   GET  /api/local-inference/voice-models
+ *     → { installations: VoiceModelInstallationView[] }
+ *     Resolves currently-installed versions by reading the bundle voice
+ *     directory (`<state-dir>/models/voice/`) and matching filenames
+ *     against `VOICE_MODEL_VERSIONS`.
+ *
+ *   GET  /api/local-inference/voice-models/check
+ *     → { lastCheckedAt, statuses: VoiceModelStatus[] }
+ *     Invokes `VoiceModelUpdater.check()` which walks the cascade
+ *     (Cloud → GitHub → HF) and returns a per-id decision.
+ *
+ *   POST /api/local-inference/voice-models/:id/update
+ *     → { ok: true, finalPath, sha256, sizeBytes }
+ *     Triggers `downloadVoiceModel()` for the named id, gated on
+ *     `NetworkPolicy` evaluation per R5 §4. Refuses when the policy
+ *     decision is not `allow=true`.
+ *
+ *   POST /api/local-inference/voice-models/:id/pin
+ *     Body: { pinned: boolean }
+ *     → { ok: true, id, pinned }
+ *     Toggles the on-disk pin file so the auto-updater skips this id.
+ *
+ *   GET  /api/local-inference/voice-models/preferences
+ *     → { preferences: NetworkPolicyPreferences, isOwner: boolean }
+ *
+ *   POST /api/local-inference/voice-models/preferences
+ *     Body: Partial<NetworkPolicyPreferences>
+ *     → { ok: true, preferences }
+ *     Writes the user's Wi-Fi/cellular/metered policy preferences.
+ *     Per R5 §5.4 the cellular + metered toggles are OWNER-only — the
+ *     route returns 403 if a non-OWNER caller tries to flip them.
+ *
+ * Preferences land at
+ * `<state-dir>/local-inference/voice-update-prefs.json`; the pin set is
+ * stored as a sibling `voice-update-pins.json`.
+ */
+import type * as http from "node:http";
+import { type VoiceModelId } from "@elizaos/shared";
+import { downloadVoiceModel, VoiceModelUpdater } from "../services/voice-model-updater";
+export interface VoiceModelInstallationView {
+    readonly id: VoiceModelId;
+    readonly installedVersion: string | null;
+    readonly pinned: boolean;
+    readonly lastError: string | null;
+}
+export declare function resolveInstalledVersions(dir?: string): Promise<Map<VoiceModelId, string>>;
+export declare function setVoiceModelsUpdater(updater: VoiceModelUpdater | null): void;
+type DownloadFn = typeof downloadVoiceModel;
+export declare function setVoiceModelDownloader(fn: DownloadFn | null): void;
+export declare function setVoiceModelsBundleVersionForTest(bundleVersion: string | null): void;
+export declare function handleVoiceModelsRoutes(req: http.IncomingMessage, res: http.ServerResponse): Promise<boolean>;
+export {};
+//# sourceMappingURL=voice-models-routes.d.ts.map

package/dist/routes/voice-models-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-models-routes.d.ts","sourceRoot":"","sources":["../../src/routes/voice-models-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAGH,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAC;AAQvC,OAAO,EAIN,KAAK,YAAY,EAEjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,kBAAkB,EAGlB,iBAAiB,EACjB,MAAM,iCAAiC,CAAC;AAUzC,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAgKD,wBAAsB,wBAAwB,CAC7C,GAAG,GAAE,MAAyB,GAC5B,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAmBpC;AAQD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAE7E;AAYD,KAAK,UAAU,GAAG,OAAO,kBAAkB,CAAC;AAG5C,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAEnE;AAYD,wBAAgB,kCAAkC,CACjD,aAAa,EAAE,MAAM,GAAG,IAAI,GAC1B,IAAI,CAEN;AAWD,wBAAsB,uBAAuB,CAC5C,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CAsNlB"}

package/dist/routes/voice-profile-plugin-routes.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Plugin-route registration for the voice-profile HTTP surface (issue #8234).
+ *
+ * `handleVoiceSpeakerProfileRoutes` (bind/unbind a recognized voice to an
+ * elizaOS entity) and `handleVoiceProfilesManagementRoutes` (the server half
+ * of the `VoiceProfileSection` management UI) are prefix dispatchers, but the
+ * only server mount of `handleLocalInferenceRoutes` is gated behind
+ * `/api/local-inference*` path prefixes — so neither the `/v1/voice/
+ * speaker-profiles` nor the `/api/voice/profiles` namespace was reachable
+ * over HTTP. Registering them as `rawPath` routes on the plugin object puts
+ * them on `runtime.routes`, which both the upstream agent server and the
+ * app-core dashboard server dispatch.
+ *
+ * Every route is private: the host dispatcher answers 401 for
+ * unauthenticated callers before the handler runs.
+ */
+import { type Route } from "@elizaos/core";
+export declare const voiceProfilePluginRoutes: Route[];
+//# sourceMappingURL=voice-profile-plugin-routes.d.ts.map

package/dist/routes/voice-profile-plugin-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-profile-plugin-routes.d.ts","sourceRoot":"","sources":["../../src/routes/voice-profile-plugin-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,KAAK,KAAK,EAAiB,MAAM,eAAe,CAAC;AAqC1D,eAAO,MAAM,wBAAwB,EAAE,KAAK,EAkF3C,CAAC"}

package/dist/routes/voice-profiles-management-routes.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Voice-profile management routes — `/api/voice/profiles*`.
+ *
+ * These back the `VoiceProfilesClient` / `VoiceProfileSection` UI: list,
+ * rename / relationship / retention edits, delete, bulk delete, merge, split,
+ * export, sample-audio preview, and entity binding. They operate on the
+ * `VoiceProfileStore` (recognized-speaker centroids), mapping each record to
+ * the UI's `VoiceProfile` DTO.
+ *
+ * Distinct from `/v1/voice/profiles` (the OmniVoice TTS preset catalog in
+ * `services/voice/voice-profile-routes.ts`). The OWNER is the profile bound to
+ * `ELIZA_ADMIN_ENTITY_ID`.
+ *
+ * Routes:
+ *   GET    /api/voice/profiles                 → { profiles: VoiceProfileDto[] }
+ *   PATCH  /api/voice/profiles/:id             { displayName?, relationshipLabel?, retentionDays? }
+ *   DELETE /api/voice/profiles/:id             → { deleted }
+ *   DELETE /api/voice/profiles[?includeOwner=] → { deleted: number }
+ *   POST   /api/voice/profiles/:id/merge       { intoId }
+ *   POST   /api/voice/profiles/:id/split       { utteranceIds }
+ *   POST   /api/voice/profiles/:id/bind        { entityId, label? }
+ *   POST   /api/voice/profiles/:id/unbind
+ *   POST   /api/voice/profiles/export          → { downloadUrl }
+ *   GET    /api/voice/profiles/:id/sample      → audio/wav (consent-gated; 404 if absent)
+ *
+ * Route handlers in this plugin do not hold an `IAgentRuntime`, so bind here
+ * persists `entityId` at the profile level. The relationship-graph edge is
+ * materialised separately via the `VOICE_TURN_OBSERVED` → merge-engine seam
+ * (see runtime/voice-entity-binding.ts and the IDENTIFY_SPEAKER action).
+ */
+import type * as http from "node:http";
+import { VoiceProfileStore } from "../services/voice/profile-store.js";
+export declare function setVoiceProfilesManagementStore(store: VoiceProfileStore | null): void;
+type Cohort = "owner" | "family" | "guest" | "unknown";
+type Source = "first-run" | "auto-clustered" | "manual";
+export interface VoiceProfileDto {
+    id: string;
+    entityId: string | null;
+    displayName: string;
+    relationshipLabel: string | null;
+    isOwner: boolean;
+    embeddingCount: number;
+    firstHeardAtMs: number;
+    lastHeardAtMs: number;
+    cohort: Cohort;
+    source: Source;
+    retentionDays: number | null;
+    samplePreviewUri: string | null;
+}
+export declare function handleVoiceProfilesManagementRoutes(req: http.IncomingMessage, res: http.ServerResponse): Promise<boolean>;
+export {};
+//# sourceMappingURL=voice-profiles-management-routes.d.ts.map

package/dist/routes/voice-profiles-management-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-profiles-management-routes.d.ts","sourceRoot":"","sources":["../../src/routes/voice-profiles-management-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAC;AASvC,OAAO,EAEN,iBAAiB,EACjB,MAAM,oCAAoC,CAAC;AAQ5C,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAC7B,IAAI,CAEN;AAsBD,KAAK,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AACvD,KAAK,MAAM,GAAG,WAAW,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAyFD,wBAAsB,mCAAmC,CACxD,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CAuClB"}

package/dist/routes/voice-speaker-profile-routes.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Speaker voice-profile binding routes.
+ *
+ * These operate on the `VoiceProfileStore` — the content-addressed store of
+ * WeSpeaker centroids that the attribution pipeline matches against (one
+ * `vp_<sha>` record per recognized voice). This is a *different* surface from
+ * the OmniVoice preset catalog in `services/voice/voice-profile-routes.ts`
+ * (which manages TTS preset `.bin` files under `/v1/voice/profiles`).
+ *
+ * The attribution pipeline can resolve *which* voice is speaking, but a freshly
+ * clustered profile carries `entityId: null` until something binds it to a real
+ * elizaOS `Entity`. Without a binding the speaker is never persisted to the
+ * relationship graph and the OWNER-crown in the UI never lights up outside
+ * tests. The store already supports `bindEntity` / `unbindEntity`; these routes
+ * are the runtime path that calls them.
+ *
+ * Routes:
+ *   GET  /v1/voice/speaker-profiles
+ *     → { profiles: SpeakerProfileSummary[] }
+ *
+ *   POST /v1/voice/speaker-profiles/:id/bind
+ *     Body (JSON): { entityId: string, label?: string }
+ *     → SpeakerProfileSummary  (entityId now non-null)
+ *
+ *   POST /v1/voice/speaker-profiles/:id/unbind
+ *     → SpeakerProfileSummary  (entityId now null)
+ *
+ * The caller supplies the `entityId` of an existing elizaOS entity (e.g. a
+ * contact the user picks in the voice-management UI, or the OWNER entity from
+ * first-run). These handlers do not mint entities or relationship rows: route
+ * handlers in this plugin do not hold an `IAgentRuntime` reference (see
+ * `family-member-route.ts`). They bind the speaker centroid to an entity id the
+ * store persists, which the attribution pipeline then resolves on the next
+ * recognition.
+ */
+import type * as http from "node:http";
+import { VoiceProfileStore } from "../services/voice/profile-store.js";
+export declare function setVoiceSpeakerProfileStore(store: VoiceProfileStore | null): void;
+export interface SpeakerProfileSummary {
+    profileId: string;
+    entityId: string | null;
+    label: string | null;
+    embeddingModel: string;
+    sampleCount: number;
+    confidence: number;
+    firstObservedAt: string;
+    lastObservedAt: string;
+}
+/**
+ * Handle `/v1/voice/speaker-profiles*` requests.
+ *
+ * Returns `true` when the request was handled (success or error response
+ * written), `false` when the path does not match so the caller can fall
+ * through to the next handler.
+ */
+export declare function handleVoiceSpeakerProfileRoutes(req: http.IncomingMessage, res: http.ServerResponse): Promise<boolean>;
+//# sourceMappingURL=voice-speaker-profile-routes.d.ts.map

package/dist/routes/voice-speaker-profile-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-speaker-profile-routes.d.ts","sourceRoot":"","sources":["../../src/routes/voice-speaker-profile-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAC;AASvC,OAAO,EAEN,iBAAiB,EACjB,MAAM,oCAAoC,CAAC;AAQ5C,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAC7B,IAAI,CAEN;AAeD,MAAM,WAAW,qBAAqB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACvB;AAyBD;;;;;;GAMG;AACH,wBAAsB,+BAA+B,CACpD,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,GACtB,OAAO,CAAC,OAAO,CAAC,CA+ElB"}

package/dist/runtime/embedding-manager-support.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Callback for reporting download/init progress.
+ * @param phase - Current phase: "checking", "downloading", "loading", "ready"
+ * @param detail - Human-readable detail (e.g. "45% of 95 MB")
+ */
+export type EmbeddingProgressCallback = (phase: "checking" | "downloading" | "loading" | "ready", detail?: string) => void;
+/**
+ * Callback for raw download byte progress.
+ * @param downloaded - Bytes received so far
+ * @param total - Total bytes expected (null if Content-Length unavailable)
+ */
+export type DownloadProgressCallback = (downloaded: number, total: number | null) => void;
+export interface EmbeddingManagerConfig {
+    /** GGUF model filename (default: detected hardware preset) */
+    model?: string;
+    /** HuggingFace repo for auto-download (default: detected hardware preset repo) */
+    modelRepo?: string;
+    /** Embedding dimensions (default: detected hardware preset dimensions) */
+    dimensions?: number;
+    /** GPU layers: "auto" | "max" | number (default: detected hardware preset gpuLayers) */
+    gpuLayers?: "auto" | "max" | number;
+    /** Model context window in tokens (default: detected hardware preset contextSize) */
+    contextSize?: number;
+    /** Idle timeout in ms before unloading model (default: 1800000 = 30 min, 0 = never unload) */
+    idleTimeoutMs?: number;
+    /** Models directory (default: <stateDir>/models) */
+    modelsDir?: string;
+    /** Optional callback for reporting initialization progress phases. */
+    onProgress?: EmbeddingProgressCallback;
+}
+export interface EmbeddingManagerStats {
+    lastUsedAt: number | null;
+    isLoaded: boolean;
+    model: string;
+    gpuLayers: string | number;
+    dimensions: number;
+}
+export declare const DEFAULT_IDLE_TIMEOUT_MS: number;
+export declare const DEFAULT_MODELS_DIR: string;
+export declare const EMBEDDING_META_PATH: string;
+export declare function getLogger(): {
+    info: (...a: unknown[]) => void;
+    warn: (...a: unknown[]) => void;
+    error: (...a: unknown[]) => void;
+    debug: (...a: unknown[]) => void;
+};
+interface EmbeddingMeta {
+    model: string;
+    dimensions: number;
+    lastChanged: string;
+}
+export declare function readEmbeddingMeta(): EmbeddingMeta | null;
+export declare function checkDimensionMigration(model: string, dimensions: number): void;
+export declare function safeUnlink(filepath: string): void;
+export declare function getErrorMessage(error: unknown): string;
+export declare function isCorruptedModelLoadError(error: unknown): boolean;
+/** Known TEXT_EMBEDDING GGUFs the framework may warm up (same filenames as HuggingFace repos). */
+export interface WarmupReuseEmbeddingCandidate {
+    readonly model: string;
+    readonly modelRepo: string;
+    readonly dimensions: number;
+    readonly contextSize: number;
+    readonly gpuLayers: string;
+}
+/** True if a sanitized GGUF with this basename exists under `modelsDir`. */
+export declare function embeddingGgufFilePresent(modelsDir: string, filename: string): boolean;
+/**
+ * When the configured embedding file is missing, reuse only the compact,
+ * SQL-safe embedding GGUF already on disk. The framework intentionally avoids
+ * reviving legacy larger defaults from MODELS_DIR because they would reintroduce
+ * dimension mismatches and unnecessary RAM/download cost.
+ */
+export declare function findExistingEmbeddingModelForWarmupReuse(modelsDir: string): WarmupReuseEmbeddingCandidate | null;
+export declare function isEmbeddingWarmupReuseDisabled(): boolean;
+export declare function ensureModel(modelsDir: string, repo: string, filename: string, force?: boolean, onProgress?: EmbeddingProgressCallback): Promise<string>;
+export {};
+//# sourceMappingURL=embedding-manager-support.d.ts.map

package/dist/runtime/embedding-manager-support.d.ts.map

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

package/dist/runtime/embedding-presets.d.ts

@@ -0,0 +1,16 @@
+export type EmbeddingTier = "fallback" | "standard" | "performance";
+export interface EmbeddingPreset {
+    tier: EmbeddingTier;
+    label: string;
+    description: string;
+    model: string;
+    modelRepo: string;
+    dimensions: number;
+    gpuLayers: "auto" | 0;
+    contextSize: number;
+    downloadSizeMB: number;
+}
+export declare const EMBEDDING_PRESETS: Record<EmbeddingTier, EmbeddingPreset>;
+export declare function detectEmbeddingTier(): EmbeddingTier;
+export declare function detectEmbeddingPreset(): EmbeddingPreset;
+//# sourceMappingURL=embedding-presets.d.ts.map

package/dist/runtime/embedding-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-presets.d.ts","sourceRoot":"","sources":["../../src/runtime/embedding-presets.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACvB;AAaD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,eAAe,CAqCpE,CAAC;AAIF,wBAAgB,mBAAmB,IAAI,aAAa,CAQnD;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/runtime/embedding-warmup-policy.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Whether to prefetch the local GGUF embedding model before runtime boot.
+ *
+ * Chat/inference provider (what you pick in first-run) is separate from
+ * **embeddings** (vector memory / RAG). By default the framework keeps
+ * `@elizaos/plugin-local-inference` loaded because API-based model plugins do
+ * not implement TEXT_EMBEDDING — so a local model was historically always
+ * warmed up. When Eliza Cloud is connected with **cloud embeddings** enabled,
+ * the cloud plugin handles embeddings instead; skipping warmup avoids a large
+ * download unrelated to “local inference” for chat.
+ */
+export declare function isLocalEmbeddingDisabledByEnv(): boolean;
+export declare function shouldWarmupLocalEmbeddingModel(): boolean;
+//# sourceMappingURL=embedding-warmup-policy.d.ts.map

package/dist/runtime/embedding-warmup-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-warmup-policy.d.ts","sourceRoot":"","sources":["../../src/runtime/embedding-warmup-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,wBAAgB,6BAA6B,IAAI,OAAO,CAEvD;AAED,wBAAgB,+BAA+B,IAAI,OAAO,CAuBzD"}