@elizaos/shared 2.0.0-alpha.538 → 2.0.11-beta.7

package/voice/first-sentence-snip.js

@@ -0,0 +1,284 @@
+/**
+ * First-sentence snip helper for the TTS first-line cache.
+ *
+ * Pure, deterministic, no I/O. Both the local runtime and the Eliza Cloud
+ * `/api/v1/voice/tts` route call into this module so that byte-equal sentence
+ * text on either side maps to byte-equal cache keys.
+ *
+ * Algorithm summary (see R4 §2 in `.swarm/research/R4-tts-cache.md`):
+ *   1. Trim leading whitespace.
+ *   2. Walk char-by-char, tracking quote depth (skip terminators inside
+ *      `"..."`/`'...'`/`“...”`), decimal context (digit-`.`-digit isn't a
+ *      boundary), and abbreviation context (e.g. `Mr.`, `e.g.`, `U.S.`).
+ *   3. First surviving terminator (`.`/`!`/`?`/`…`/`。`/`！`/`？`) or `\n`
+ *      ends the sentence. Consume any contiguous run of terminators that
+ *      follow (so `"Wait..."` stays intact).
+ *   4. If no terminator and no newline → null (don't cache unterminated text).
+ *   5. Apply ≤10-word filter on the normalised form. If wordCount > 10,
+ *      return null (don't cache).
+ *
+ * `FIRST_SENTENCE_SNIP_VERSION` is part of the cache key — bumping it
+ * invalidates every existing cached entry.
+ */
+/**
+ * Cache-key algorithm version. Bump when the snip/normalise logic changes
+ * in a way that would produce different keys for the same input. Local and
+ * cloud caches re-key off this constant, so a bump rolls the entire cache.
+ */
+export const FIRST_SENTENCE_SNIP_VERSION = "1";
+/**
+ * Maximum word count (Unicode-aware) for a cacheable first-sentence snip.
+ * Beyond this the bytes won't repeat often enough to amortise the cache.
+ */
+export const FIRST_SENTENCE_MAX_WORDS = 10;
+const ABBREVIATIONS = new Set([
+    "mr",
+    "mrs",
+    "ms",
+    "mx",
+    "dr",
+    "st",
+    "jr",
+    "sr",
+    "prof",
+    "vs",
+    "etc",
+    "eg",
+    "ie",
+    "fig",
+    "no",
+    "vol",
+    "ch",
+    "pt",
+    "co",
+    "inc",
+    "ltd",
+    "us",
+    "uk",
+    "usa",
+]);
+/**
+ * Terminator chars that end a sentence. Includes CJK `。！？` so multilingual
+ * inputs aren't refused.
+ */
+const TERMINATOR_REGEX = /[.!?…。！？]/u;
+const QUOTE_PAIRS = new Map([
+    ['"', '"'],
+    ["'", "'"],
+    ["“", "”"],
+    ["‘", "’"],
+    ["«", "»"],
+    ["「", "」"],
+    ["『", "』"],
+]);
+const CLOSE_QUOTES = new Set(QUOTE_PAIRS.values());
+function isDigit(ch) {
+    return ch >= "0" && ch <= "9";
+}
+function isAlpha(ch) {
+    if (!ch)
+        return false;
+    const code = ch.charCodeAt(0);
+    return ((code >= 65 && code <= 90) || // A-Z
+        (code >= 97 && code <= 122) // a-z
+    );
+}
+/**
+ * Lower-case + strip dots from a token to compare against `ABBREVIATIONS`.
+ * Used to detect things like `Mr.` / `U.S.` / `e.g.` where the dot is part of
+ * an abbreviation rather than a sentence terminator.
+ */
+function isAbbrevToken(token) {
+    if (token.length === 0 || token.length > 6)
+        return false;
+    const lower = token.toLowerCase().replace(/\./g, "");
+    if (!lower)
+        return false;
+    return ABBREVIATIONS.has(lower);
+}
+/**
+ * Walk the input forwards looking for the first sentence-terminating position.
+ * Returns the *inclusive* end index of the terminator run (so the snip is
+ * `text.slice(start, endInclusive + 1)`), or -1 if no terminator was found.
+ *
+ * `start` is the position after any leading whitespace.
+ */
+function findTerminatorEnd(text, start) {
+    let i = start;
+    const quoteStack = [];
+    while (i < text.length) {
+        const ch = text[i] ?? "";
+        // Newline acts as a soft terminator (e.g. message body broken into lines).
+        if (ch === "\n") {
+            // Strip trailing whitespace from the run by returning index of \n.
+            return i;
+        }
+        // Open / close quotes for skipping terminators inside.
+        const closer = QUOTE_PAIRS.get(ch);
+        if (closer && closer !== ch) {
+            // Asymmetric pair → push the expected closer.
+            quoteStack.push(closer);
+            i++;
+            continue;
+        }
+        if (quoteStack.length > 0 && ch === quoteStack[quoteStack.length - 1]) {
+            quoteStack.pop();
+            i++;
+            continue;
+        }
+        // Symmetric ASCII quotes: toggle stack only when not already inside an
+        // asymmetric quote.
+        //
+        // Apostrophes (`'`) are NEVER treated as quote delimiters when they sit
+        // between two letters (contractions like `it's`, possessives like
+        // `Eliza's`) — otherwise a stray apostrophe would swallow the rest of
+        // the input and we'd never find a terminator.
+        if (ch === "'" && quoteStack.length === 0) {
+            const prev = i > 0 ? text[i - 1] : "";
+            const next = i + 1 < text.length ? text[i + 1] : "";
+            if (!(isAlpha(prev) && isAlpha(next))) {
+                quoteStack.push(ch);
+            }
+            i++;
+            continue;
+        }
+        if (ch === '"' && quoteStack.length === 0) {
+            quoteStack.push(ch);
+            i++;
+            continue;
+        }
+        if (quoteStack.length > 0 &&
+            CLOSE_QUOTES.has(quoteStack[quoteStack.length - 1] ?? "") &&
+            ch === quoteStack[quoteStack.length - 1]) {
+            quoteStack.pop();
+            i++;
+            continue;
+        }
+        // Skip everything inside quotes.
+        if (quoteStack.length > 0) {
+            i++;
+            continue;
+        }
+        if (!TERMINATOR_REGEX.test(ch)) {
+            i++;
+            continue;
+        }
+        // Candidate terminator. Apply guards.
+        if (ch === ".") {
+            // Decimal context: digit . digit
+            const prev = i > 0 ? text[i - 1] : "";
+            const next = i + 1 < text.length ? text[i + 1] : "";
+            if (isDigit(prev) && isDigit(next)) {
+                i++;
+                continue;
+            }
+            // Abbreviation context: look backwards for an alpha run, possibly
+            // with internal dots (e.g. `U.S.`). Bound the look-back to 6 chars.
+            let j = i - 1;
+            let token = "";
+            while (j >= 0 && j >= i - 6) {
+                const tj = text[j] ?? "";
+                if (isAlpha(tj) || tj === ".") {
+                    token = tj + token;
+                    j--;
+                    continue;
+                }
+                break;
+            }
+            if (token && isAbbrevToken(token)) {
+                i++;
+                continue;
+            }
+            // Also: avoid treating mid-word dot as terminator if followed
+            // immediately by alpha and no whitespace (e.g. "foo.bar"
+            // shouldn't terminate). Cache hit rate is more important than
+            // being clever here — conservative: skip.
+            if (isAlpha(next)) {
+                i++;
+                continue;
+            }
+        }
+        // Valid terminator. Consume any contiguous run of terminator chars so
+        // `Wait...` stays intact, then return the inclusive end.
+        let end = i;
+        while (end + 1 < text.length) {
+            const nxt = text[end + 1] ?? "";
+            if (TERMINATOR_REGEX.test(nxt)) {
+                end++;
+                continue;
+            }
+            break;
+        }
+        return end;
+    }
+    return -1;
+}
+/**
+ * Unicode-aware word count. Hyphenated words and apostrophe-internal words
+ * count as one (e.g. "twenty-three" → 1, "it's" → 1). Dotted acronyms with
+ * single-letter segments (e.g. "U.S.", "U.S.A.") count as one word. Decimal
+ * numbers like "3.14" count as one word.
+ */
+export function wordCount(s) {
+    if (!s)
+        return 0;
+    const matches = s.match(
+    // In priority order:
+    //   - decimal number (digits . digits, possibly multi-segment)
+    //   - dotted acronym (≥2 single-letter dot pairs)
+    //   - regular word with optional hyphen/apostrophe internal joiners
+    /\p{N}+(?:\.\p{N}+)+|(?:\p{L}\.){2,}|[\p{L}\p{N}]+(?:[’'-][\p{L}\p{N}]+)*/gu);
+    return matches ? matches.length : 0;
+}
+/**
+ * Normalise a snip for cache-key purposes. NFC + lower-case + collapse
+ * whitespace + strip trailing terminators/whitespace. Apostrophes preserved.
+ */
+export function normalizeForKey(snip) {
+    let s = snip.normalize("NFC");
+    // Trim leading whitespace including zero-width space (U+200B).
+    s = s.replace(/^[\s​]+/u, "").replace(/[\s​]+$/u, "");
+    s = s.toLowerCase();
+    s = s.replace(/\s+/gu, " ");
+    // Strip trailing terminator/whitespace run. CJK terminators included.
+    s = s.replace(/[\s​.!?…。！？]+$/gu, "");
+    return s;
+}
+/**
+ * Attempt to snip the first sentence from `text`. Returns `null` if:
+ *   - input is empty / whitespace only
+ *   - no sentence-terminator found
+ *   - normalised snip has > 10 words
+ *   - normalised snip is empty after stripping terminators
+ *
+ * Otherwise returns a `FirstSentenceSnipResult` carrying the raw and
+ * normalised forms plus the word count.
+ */
+export function firstSentenceSnip(text) {
+    if (typeof text !== "string" || text.length === 0)
+        return null;
+    // Find start after leading whitespace (incl. zero-width space).
+    const trimMatch = /^[\s​]+/u.exec(text);
+    const start = trimMatch ? trimMatch[0].length : 0;
+    if (start >= text.length)
+        return null;
+    const end = findTerminatorEnd(text, start);
+    if (end < 0)
+        return null;
+    const raw = text.slice(start, end + 1);
+    const normalized = normalizeForKey(raw);
+    if (!normalized)
+        return null;
+    const wc = wordCount(normalized);
+    if (wc === 0)
+        return null;
+    if (wc > FIRST_SENTENCE_MAX_WORDS)
+        return null;
+    return {
+        raw,
+        normalized,
+        wordCount: wc,
+        endOffset: end + 1,
+    };
+}
+//# sourceMappingURL=first-sentence-snip.js.map

package/voice/first-sentence-snip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-sentence-snip.js","sourceRoot":"","sources":["../../src/voice/first-sentence-snip.ts"],"names":[],"mappings":"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"}

package/voice/voice-cancellation-token.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Canonical voice cancellation token.
+ *
+ * Wave 3 W3-9 — one token per voice turn, fanned out to every layer that can
+ * cancel: VAD start-of-speech (barge-in), turn-detector EOT revocation,
+ * planner-loop / message-handler yield points, MtpLlamaServer slot abort,
+ * TTS playback. Built on top of `AbortController` so any consumer that
+ * already understands `AbortSignal` (fetch / FFI / model calls) gets cancel
+ * for free.
+ *
+ * Invariants:
+ *   - One token per `runId` (one utterance).
+ *   - `abort()` is idempotent. The first reason wins; subsequent calls are
+ *     ignored and leave the recorded reason unchanged.
+ *   - `signal.aborted === true` after the first `abort()`.
+ *   - Token is forward-compatible with the legacy `BargeInCancelToken`
+ *     shape (`cancelled`, `reason`, `signal`) so existing voice pipeline
+ *     consumers can adopt the canonical type without a wider refactor.
+ *
+ * This file deliberately has no runtime imports (no `@elizaos/core`, no
+ * voice-engine imports). It is the bottom of the cancellation stack — every
+ * layer above (runtime, plugin, app) imports this type, never the reverse.
+ */
+/** Why a voice turn was cancelled. Stable enum — telemetry depends on it. */
+export type VoiceCancellationReason = "barge-in" | "eot-revoked" | "user-cancel" | "timeout" | "external";
+/**
+ * Listener fired exactly once when the token transitions from active →
+ * aborted. Listeners added after abort fire synchronously with the recorded
+ * reason.
+ */
+export type VoiceCancellationListener = (reason: VoiceCancellationReason) => void;
+/**
+ * Per-turn cancellation handle. Carries a stable `runId`, the optional slot
+ * id the LM is running against (for slot-abort), and a standard `AbortSignal`
+ * for fetch / model layers.
+ */
+export interface VoiceCancellationToken {
+    /** Stable per-utterance id. Mirrors the voice state machine's turn id. */
+    readonly runId: string;
+    /**
+     * The MtpLlamaServer slot the optimistic LM is running on, when known.
+     * `abort()` fans this out to the slot-abort path on the inference server.
+     */
+    readonly slot?: number;
+    /** True once `abort()` has fired. Cheap polling field. */
+    readonly aborted: boolean;
+    /** Set when `abort()` fires; null while active. */
+    readonly reason: VoiceCancellationReason | null;
+    /** Standard `AbortSignal` for fetch / model / FFI consumers. */
+    readonly signal: AbortSignal;
+    /**
+     * Trip the token. Idempotent. First call wins; subsequent calls are
+     * ignored. Fires every registered `onAbort` listener synchronously.
+     */
+    abort(reason: VoiceCancellationReason): void;
+    /**
+     * Subscribe to abort. Returns an unsubscribe function. Listeners
+     * registered after the token has aborted fire synchronously with the
+     * recorded reason.
+     */
+    onAbort(listener: VoiceCancellationListener): () => void;
+}
+export interface CreateVoiceCancellationTokenOptions {
+    runId: string;
+    slot?: number;
+    /**
+     * Optional pre-existing `AbortSignal` to also honor. When this signal
+     * aborts (e.g. the runtime's per-turn signal from
+     * `TurnControllerRegistry`), the voice token aborts with reason
+     * `"external"` so the voice loop sees the runtime abort.
+     */
+    linkSignal?: AbortSignal;
+}
+/**
+ * Construct a fresh voice cancellation token.
+ *
+ * Implementation note: a single `AbortController` backs the public `signal`.
+ * Listener bookkeeping lives next to the controller (rather than via the
+ * `AbortSignal`'s native `addEventListener`) because we want to:
+ *   1. Guarantee listeners fire even when the abort was triggered by a
+ *      linked signal (the native `addEventListener` path also works, but
+ *      this is cheaper and gives us synchronous semantics for
+ *      after-abort `onAbort` registrations).
+ *   2. Surface the `reason` enum, not a raw `DOMException` from the
+ *      AbortSignal.
+ */
+export declare function createVoiceCancellationToken(opts: CreateVoiceCancellationTokenOptions): VoiceCancellationToken;
+/**
+ * Already-aborted token. Useful as a zero-cost default for code paths that
+ * have no live voice session but still want to type-thread a token through.
+ * The `runId` is the empty string — callers that depend on a stable id must
+ * pass their own.
+ */
+export declare function createAbortedVoiceCancellationToken(reason?: VoiceCancellationReason): VoiceCancellationToken;
+/**
+ * Per-room registry. Keeps the active voice token for each `roomId` so
+ * unrelated layers (the message handler, an HTTP route, the audio sink)
+ * can fetch the live token without holding a reference. Mirrors the shape
+ * of `TurnControllerRegistry` in `@elizaos/core/runtime/turn-controller`.
+ */
+export declare class VoiceCancellationRegistry {
+    private readonly byRoom;
+    /**
+     * Replace the active token for `roomId`. The previous token (if any) is
+     * aborted with `"external"` so any orphaned background work cleans up.
+     * Returns the new token.
+     */
+    arm(roomId: string, opts: CreateVoiceCancellationTokenOptions): VoiceCancellationToken;
+    /** Fetch the active token for `roomId`, or null. */
+    current(roomId: string): VoiceCancellationToken | null;
+    /**
+     * Abort the active token for `roomId`. Returns true if a live token was
+     * aborted. Returns false when there is no active token or it's already aborted.
+     */
+    abort(roomId: string, reason: VoiceCancellationReason): boolean;
+    /**
+     * Abort every active token. Used by lifecycle shutdown (the runtime's
+     * `abortInflightInference` hook fires this so the voice loop drops in
+     * sync with the runtime).
+     */
+    abortAll(reason: VoiceCancellationReason): string[];
+    /** Snapshot of live room ids. Diagnostic. */
+    activeRoomIds(): string[];
+    /** Test seam: drop everything. */
+    clear(): void;
+}
+//# sourceMappingURL=voice-cancellation-token.d.ts.map

package/voice/voice-cancellation-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-cancellation-token.d.ts","sourceRoot":"","sources":["../../src/voice/voice-cancellation-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,uBAAuB,GAC/B,UAAU,GACV,aAAa,GACb,aAAa,GACb,SAAS,GACT,UAAU,CAAC;AAEf;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,MAAM,EAAE,uBAAuB,KAC5B,IAAI,CAAC;AAEV;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAChD,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC7C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,mCAAmC;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,mCAAmC,GACxC,sBAAsB,CAgExB;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,GAAE,uBAAoC,GAC3C,sBAAsB,CAIxB;AAED;;;;;GAKG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IAEpE;;;;OAIG;IACH,GAAG,CACD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,mCAAmC,GACxC,sBAAsB;IAkBzB,oDAAoD;IACpD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAItD;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO;IAO/D;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,EAAE;IAWnD,6CAA6C;IAC7C,aAAa,IAAI,MAAM,EAAE;IAOzB,kCAAkC;IAClC,KAAK,IAAI,IAAI;CAGd"}

package/voice/voice-cancellation-token.js

@@ -0,0 +1,186 @@
+/**
+ * Canonical voice cancellation token.
+ *
+ * Wave 3 W3-9 — one token per voice turn, fanned out to every layer that can
+ * cancel: VAD start-of-speech (barge-in), turn-detector EOT revocation,
+ * planner-loop / message-handler yield points, MtpLlamaServer slot abort,
+ * TTS playback. Built on top of `AbortController` so any consumer that
+ * already understands `AbortSignal` (fetch / FFI / model calls) gets cancel
+ * for free.
+ *
+ * Invariants:
+ *   - One token per `runId` (one utterance).
+ *   - `abort()` is idempotent. The first reason wins; subsequent calls are
+ *     ignored and leave the recorded reason unchanged.
+ *   - `signal.aborted === true` after the first `abort()`.
+ *   - Token is forward-compatible with the legacy `BargeInCancelToken`
+ *     shape (`cancelled`, `reason`, `signal`) so existing voice pipeline
+ *     consumers can adopt the canonical type without a wider refactor.
+ *
+ * This file deliberately has no runtime imports (no `@elizaos/core`, no
+ * voice-engine imports). It is the bottom of the cancellation stack — every
+ * layer above (runtime, plugin, app) imports this type, never the reverse.
+ */
+/**
+ * Construct a fresh voice cancellation token.
+ *
+ * Implementation note: a single `AbortController` backs the public `signal`.
+ * Listener bookkeeping lives next to the controller (rather than via the
+ * `AbortSignal`'s native `addEventListener`) because we want to:
+ *   1. Guarantee listeners fire even when the abort was triggered by a
+ *      linked signal (the native `addEventListener` path also works, but
+ *      this is cheaper and gives us synchronous semantics for
+ *      after-abort `onAbort` registrations).
+ *   2. Surface the `reason` enum, not a raw `DOMException` from the
+ *      AbortSignal.
+ */
+export function createVoiceCancellationToken(opts) {
+    const controller = new AbortController();
+    const listeners = new Set();
+    const state = { aborted: false, reason: null };
+    const trip = (reason) => {
+        if (state.aborted)
+            return;
+        state.aborted = true;
+        state.reason = reason;
+        // Call listeners BEFORE aborting the controller so a listener that
+        // itself awaits the signal sees the same reason this token recorded
+        // (otherwise listeners that observe `signal.aborted` could race).
+        for (const listener of Array.from(listeners)) {
+            try {
+                listener(reason);
+            }
+            catch {
+                // Listener errors are swallowed; telemetry should not affect
+                // cancellation propagation.
+            }
+        }
+        controller.abort();
+    };
+    if (opts.linkSignal) {
+        if (opts.linkSignal.aborted) {
+            trip("external");
+        }
+        else {
+            const onLinkAbort = () => trip("external");
+            opts.linkSignal.addEventListener("abort", onLinkAbort, { once: true });
+        }
+    }
+    const token = {
+        runId: opts.runId,
+        ...(opts.slot !== undefined ? { slot: opts.slot } : {}),
+        get aborted() {
+            return state.aborted;
+        },
+        get reason() {
+            return state.reason;
+        },
+        signal: controller.signal,
+        abort(reason) {
+            trip(reason);
+        },
+        onAbort(listener) {
+            if (state.aborted) {
+                // Synchronous after-abort fan-out. Caller may still want the
+                // hook even though the token already aborted — fire once.
+                const reason = state.reason ?? "external";
+                try {
+                    listener(reason);
+                }
+                catch {
+                    // see above
+                }
+                return () => undefined;
+            }
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+    return token;
+}
+/**
+ * Already-aborted token. Useful as a zero-cost default for code paths that
+ * have no live voice session but still want to type-thread a token through.
+ * The `runId` is the empty string — callers that depend on a stable id must
+ * pass their own.
+ */
+export function createAbortedVoiceCancellationToken(reason = "external") {
+    const t = createVoiceCancellationToken({ runId: "" });
+    t.abort(reason);
+    return t;
+}
+/**
+ * Per-room registry. Keeps the active voice token for each `roomId` so
+ * unrelated layers (the message handler, an HTTP route, the audio sink)
+ * can fetch the live token without holding a reference. Mirrors the shape
+ * of `TurnControllerRegistry` in `@elizaos/core/runtime/turn-controller`.
+ */
+export class VoiceCancellationRegistry {
+    byRoom = new Map();
+    /**
+     * Replace the active token for `roomId`. The previous token (if any) is
+     * aborted with `"external"` so any orphaned background work cleans up.
+     * Returns the new token.
+     */
+    arm(roomId, opts) {
+        const previous = this.byRoom.get(roomId);
+        if (previous && !previous.aborted) {
+            previous.abort("external");
+        }
+        const token = createVoiceCancellationToken(opts);
+        this.byRoom.set(roomId, token);
+        // Self-clean: when the token aborts, drop it from the map IF it is
+        // still the active one. (Tokens that have been replaced via a later
+        // `arm()` will already be evicted.)
+        token.onAbort(() => {
+            if (this.byRoom.get(roomId) === token) {
+                this.byRoom.delete(roomId);
+            }
+        });
+        return token;
+    }
+    /** Fetch the active token for `roomId`, or null. */
+    current(roomId) {
+        return this.byRoom.get(roomId) ?? null;
+    }
+    /**
+     * Abort the active token for `roomId`. Returns true if a live token was
+     * aborted. Returns false when there is no active token or it's already aborted.
+     */
+    abort(roomId, reason) {
+        const token = this.byRoom.get(roomId);
+        if (!token || token.aborted)
+            return false;
+        token.abort(reason);
+        return true;
+    }
+    /**
+     * Abort every active token. Used by lifecycle shutdown (the runtime's
+     * `abortInflightInference` hook fires this so the voice loop drops in
+     * sync with the runtime).
+     */
+    abortAll(reason) {
+        const aborted = [];
+        for (const [roomId, token] of Array.from(this.byRoom.entries())) {
+            if (!token.aborted) {
+                token.abort(reason);
+                aborted.push(roomId);
+            }
+        }
+        return aborted;
+    }
+    /** Snapshot of live room ids. Diagnostic. */
+    activeRoomIds() {
+        return Array.from(this.byRoom.keys()).filter((roomId) => {
+            const token = this.byRoom.get(roomId);
+            return token !== undefined && !token.aborted;
+        });
+    }
+    /** Test seam: drop everything. */
+    clear() {
+        this.byRoom.clear();
+    }
+}
+//# sourceMappingURL=voice-cancellation-token.js.map

package/voice/voice-cancellation-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-cancellation-token.js","sourceRoot":"","sources":["../../src/voice/voice-cancellation-token.ts"],"names":[],"mappings":"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"}

package/voice-wer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Word-error-rate scoring — the single source of truth (#8785).
+ *
+ * Both the headless metric library (plugin-local-inference `e2e-harness.ts`) and
+ * the headful self-test (ui `voice-selftest-harness.ts`) need WER; this used to
+ * be implemented twice with subtly different normalization. It lives in
+ * `@elizaos/shared` (which both already depend on) so there is exactly one
+ * definition. Pure + browser-safe (no Node deps), so it ships in the UI bundle
+ * via the `@elizaos/shared/voice-wer` subpath without pulling the whole barrel.
+ */
+/** Lowercase, strip punctuation (keep letters/numbers/apostrophes), collapse WS. */
+export declare function normalizeWerText(text: string): string;
+/**
+ * Levenshtein word-error-rate of `hypothesis` against `reference`
+ * (substitutions + insertions + deletions, divided by reference word count).
+ * An empty reference scores 0 against an empty hypothesis, else 1.
+ */
+export declare function wordErrorRate(reference: string, hypothesis: string): number;
+//# sourceMappingURL=voice-wer.d.ts.map

package/voice-wer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-wer.d.ts","sourceRoot":"","sources":["../src/voice-wer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAgB3E"}