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

package/dist/services/voice/diarization-error-rate.d.ts

@@ -0,0 +1,40 @@
+export interface DiarizationSegment {
+    /** Speaker label (any stable string — ground-truth and hypothesis label
+     * spaces are mapped against each other, so the raw strings need not match). */
+    speaker: string;
+    /** Segment start, milliseconds. */
+    startMs: number;
+    /** Segment end, milliseconds (must be ≥ startMs). */
+    endMs: number;
+}
+export interface DerResult {
+    /** Diarization Error Rate: (missed + falseAlarm + confusion) / referenceMs.
+     * 0 = perfect; can exceed 1 when false alarms dominate. */
+    der: number;
+    /** Reference speech the system failed to attribute to anyone (ms). */
+    missedMs: number;
+    /** System speech with no reference speaker present (ms). */
+    falseAlarmMs: number;
+    /** Reference speech attributed to the wrong (mapped) speaker (ms). */
+    confusionMs: number;
+    /** Total reference speaker-time (Σ |ref speakers in frame| · frame), the DER denominator. */
+    totalReferenceMs: number;
+    /** The chosen hypothesis→reference speaker mapping (optimal for matched time). */
+    mapping: Record<string, string>;
+}
+export interface DerOptions {
+    /** Frame size in ms (default 10). Smaller = more precise, more work. */
+    frameMs?: number;
+    /** Above this combined speaker count, fall back to a greedy mapping instead
+     * of the exact permutation search (keeps it O(n) not O(n!)). Default 7. */
+    maxExactSpeakers?: number;
+}
+/**
+ * Frame-based Diarization Error Rate between a reference (ground-truth) speaker
+ * timeline and a hypothesis (diarizer output) timeline. Returns DER plus its
+ * missed / false-alarm / confusion decomposition and the speaker mapping used.
+ */
+export declare function computeDiarizationErrorRate(reference: readonly DiarizationSegment[], hypothesis: readonly DiarizationSegment[], options?: DerOptions): DerResult;
+/** Whether a diarization hypothesis is within a scenario's `maxDer` budget. */
+export declare function diarizationWithinBudget(result: Pick<DerResult, "der">, maxDer: number): boolean;
+//# sourceMappingURL=diarization-error-rate.d.ts.map

package/dist/services/voice/diarization-error-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diarization-error-rate.d.ts","sourceRoot":"","sources":["../../../src/services/voice/diarization-error-rate.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,kBAAkB;IAClC;mFAC+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACzB;+DAC2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,gBAAgB,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IAC1B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;+EAC2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAwHD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAC1C,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,OAAO,GAAE,UAAe,GACtB,SAAS,CAgEX;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAC9B,MAAM,EAAE,MAAM,GACZ,OAAO,CAET"}

package/dist/services/voice/e2e-harness.d.ts

@@ -0,0 +1,297 @@
+/**
+ * Pure scoring and validation helpers for the local voice E2E harnesses.
+ *
+ * This file intentionally does not load models, touch the filesystem, or
+ * start servers. Hardware scripts feed it real measurements; unit tests can
+ * exercise the orchestration logic without native artifacts.
+ *
+ * Word-error-rate scoring lives in `@elizaos/shared/voice-wer` (the single
+ * source of truth shared with the headful self-test, #8785); it is re-exported
+ * here so existing `./e2e-harness` importers keep working unchanged.
+ */
+export { normalizeWerText, wordErrorRate } from "@elizaos/shared/voice-wer";
+export type VoiceE2eHarnessErrorCode = "missing-artifact" | "missing-measurement" | "invalid-measurement";
+export declare class VoiceE2eHarnessError extends Error {
+    readonly code: VoiceE2eHarnessErrorCode;
+    readonly details?: unknown;
+    constructor(code: VoiceE2eHarnessErrorCode, message: string, details?: unknown);
+}
+export interface RequiredVoiceArtifact {
+    kind: "bundle-root" | "speaker-preset" | "tts-model" | "tts-tokenizer" | "asr-model" | "asr-mmproj" | "ffi-library" | "server-binary";
+    path: string;
+    minBytes?: number;
+    magic?: string;
+}
+export interface VoiceArtifactProbe {
+    exists(path: string): boolean;
+    size(path: string): number | null;
+    readMagic?(path: string, bytes: number): string | null;
+}
+export interface VerifiedVoiceArtifact extends RequiredVoiceArtifact {
+    size: number | null;
+}
+export declare function assertRequiredVoiceArtifacts(artifacts: ReadonlyArray<RequiredVoiceArtifact>, probe: VoiceArtifactProbe): VerifiedVoiceArtifact[];
+export interface TtsAsrRoundTripInput {
+    referenceText: string;
+    hypothesisText: string;
+    maxWer?: number;
+}
+export interface TtsAsrRoundTripResult {
+    kind: "tts-asr-roundtrip";
+    referenceText: string;
+    hypothesisText: string;
+    normalizedReference: string;
+    normalizedHypothesis: string;
+    wer: number;
+    maxWer: number;
+    passed: boolean;
+}
+export declare function scoreTtsAsrRoundTrip(input: TtsAsrRoundTripInput): TtsAsrRoundTripResult;
+export interface BargeInInterruptionInput {
+    voiceDetectedAtMs: number;
+    ttsCancelledAtMs?: number | null;
+    llmCancelledAtMs?: number | null;
+    audioDrainedAtMs?: number | null;
+    maxCancelMs?: number;
+    requireLlmCancel?: boolean;
+}
+export interface BargeInInterruptionResult {
+    kind: "barge-in-interruption";
+    ttsCancelMs: number | null;
+    llmCancelMs: number | null;
+    audioDrainMs: number | null;
+    bargeInCancelMs: number;
+    maxCancelMs: number;
+    passed: boolean;
+}
+export declare function scoreBargeInInterruption(input: BargeInInterruptionInput): BargeInInterruptionResult;
+export interface PauseContinuationInput {
+    speechPauseAtMs: number;
+    continuationAtMs: number;
+    speculativeStartedAtMs?: number | null;
+    speculativeAbortedAtMs?: number | null;
+    finalRestartedAtMs?: number | null;
+    committedBeforeContinuationAtMs?: number | null;
+    maxContinuationGapMs?: number;
+    maxAbortAfterContinuationMs?: number;
+    maxRestartAfterContinuationMs?: number;
+}
+export interface PauseContinuationResult {
+    kind: "pause-continuation";
+    continuationGapMs: number;
+    speculativeStartAfterPauseMs: number | null;
+    abortAfterContinuationMs: number;
+    restartAfterContinuationMs: number;
+    maxContinuationGapMs: number;
+    passed: boolean;
+}
+export declare function scorePauseContinuation(input: PauseContinuationInput): PauseContinuationResult;
+export interface OptimisticRollbackRestartInput {
+    speechPauseAtMs: number;
+    continuationAtMs: number;
+    checkpointSavedAtMs?: number | null;
+    speculativeStartedAtMs?: number | null;
+    speculativeAbortedAtMs?: number | null;
+    checkpointRestoredAtMs?: number | null;
+    restartedAtMs?: number | null;
+    maxRestoreAfterContinuationMs?: number;
+    maxRestartAfterRestoreMs?: number;
+}
+export interface OptimisticRollbackRestartResult {
+    kind: "optimistic-rollback-restart";
+    saveAfterPauseMs: number | null;
+    abortAfterContinuationMs: number;
+    restoreAfterContinuationMs: number;
+    restartAfterRestoreMs: number;
+    passed: boolean;
+}
+export declare function scoreOptimisticRollbackRestart(input: OptimisticRollbackRestartInput): OptimisticRollbackRestartResult;
+export interface FirstResponseLatencyInput {
+    turnStartedAtMs: number;
+    asrFinalAtMs?: number | null;
+    llmFirstTokenAtMs?: number | null;
+    ttsFirstAudioAtMs?: number | null;
+    audioFirstPlayedAtMs?: number | null;
+    maxFirstAudioMs?: number;
+}
+export interface FirstResponseLatencyResult {
+    kind: "first-response-latency";
+    asrFinalMs: number | null;
+    firstTokenMs: number | null;
+    firstAudioMs: number;
+    firstPlayedMs: number | null;
+    maxFirstAudioMs: number;
+    passed: boolean;
+}
+export declare function scoreFirstResponseLatency(input: FirstResponseLatencyInput): FirstResponseLatencyResult;
+export interface EotDecisionSample {
+    /** The classifier decided end-of-turn here (the agent may jump in). */
+    decided: boolean;
+    /** Ground truth: this point WAS a real turn boundary. */
+    expected: boolean;
+    /** Optional ms from the true boundary to the decision (decided samples). */
+    latencyMs?: number;
+}
+export interface EotDecisionResult {
+    kind: "eot-decision";
+    total: number;
+    /** decided where there was no real boundary (jumped in too eagerly). */
+    falseTriggerRate: number;
+    /** missed a real boundary (held when it should have ended the turn). */
+    falseSuppressionRate: number;
+    accuracy: number;
+    latencyP50Ms: number | null;
+    latencyP95Ms: number | null;
+    maxFalseTriggerRate: number;
+    passed: boolean;
+}
+export declare function scoreEotDecision(samples: ReadonlyArray<EotDecisionSample>, opts?: {
+    maxFalseTriggerRate?: number;
+}): EotDecisionResult;
+export interface RespondDecisionSample {
+    responded: boolean;
+    expectRespond: boolean;
+}
+export interface RespondDecisionResult {
+    kind: "respond-decision";
+    total: number;
+    accuracy: number;
+    /** responded when it should NOT have (talked over / answered a bystander). */
+    falsePositiveRate: number;
+    /** stayed silent when it SHOULD have replied. */
+    falseNegativeRate: number;
+    minAccuracy: number;
+    passed: boolean;
+}
+export declare function scoreRespondDecision(samples: ReadonlyArray<RespondDecisionSample>, opts?: {
+    minAccuracy?: number;
+}): RespondDecisionResult;
+export interface DiarizationSample {
+    predictedLabel: string | null;
+    expectedLabel: string;
+}
+export interface DiarizationResult {
+    kind: "diarization";
+    total: number;
+    /** Diarization error rate: fraction of turns whose speaker was wrong/missing. */
+    der: number;
+    confusions: number;
+    misses: number;
+    maxDer: number;
+    passed: boolean;
+}
+export declare function scoreDiarization(samples: ReadonlyArray<DiarizationSample>, opts?: {
+    maxDer?: number;
+}): DiarizationResult;
+/** One scored turn for timeline DER: its speech span + predicted/true speaker. */
+export interface DiarizationTurnSample {
+    /** Ground-truth speaker label (the diarization reference). */
+    expectedLabel: string;
+    /** Predicted speaker label from a real attributor, or null when it missed. */
+    predictedLabel: string | null;
+    /** Speech-region start of this turn (ms into the stream). */
+    startMs: number;
+    /** Speech-region end of this turn (ms; must be ≥ startMs). */
+    endMs: number;
+}
+/**
+ * Score diarization with the frame-based, label-agnostic {@link
+ * computeDiarizationErrorRate} (#9147) rather than a per-turn string compare.
+ * The predicted labels are an arbitrary cluster-id space (the attributor never
+ * knows the ground-truth names) — DER finds the optimal cluster→speaker mapping,
+ * so a correct partition scores 0 no matter how clusters are named, and a merged
+ * or swapped speaker shows up as real error. `confusions`/`misses` are turn-level
+ * tallies derived from that optimal mapping, for the report.
+ */
+export declare function scoreDiarizationTimeline(turns: ReadonlyArray<DiarizationTurnSample>, opts?: {
+    maxDer?: number;
+}): DiarizationResult;
+export interface EntityExtractionInput {
+    expected: ReadonlyArray<string>;
+    inferred: ReadonlyArray<string>;
+}
+export interface EntityExtractionResult {
+    kind: "entity-extraction";
+    precision: number;
+    recall: number;
+    f1: number;
+    minF1: number;
+    passed: boolean;
+}
+export declare function scoreEntityExtraction(input: EntityExtractionInput, opts?: {
+    minF1?: number;
+}): EntityExtractionResult;
+export interface VoiceEntityMatchSample {
+    matchedEntityId: string | null;
+    expectedEntityId: string;
+}
+export interface VoiceEntityMatchResult {
+    kind: "voice-entity-match";
+    total: number;
+    matchRate: number;
+    correct: number;
+    minMatchRate: number;
+    passed: boolean;
+}
+export declare function scoreVoiceEntityMatch(samples: ReadonlyArray<VoiceEntityMatchSample>, opts?: {
+    minMatchRate?: number;
+}): VoiceEntityMatchResult;
+export interface EchoRejectionSample {
+    /** Ground truth: this turn is the agent's own TTS echoed back through the mic. */
+    isAgentEcho: boolean;
+    /** The agent responded to (i.e. failed to suppress) this turn. */
+    responded: boolean;
+}
+export interface EchoRejectionResult {
+    kind: "echo-rejection";
+    /** Number of agent-echo turns scored. */
+    total: number;
+    /** Echo turns correctly suppressed (no response). */
+    rejected: number;
+    rejectionRate: number;
+    minRejectionRate: number;
+    passed: boolean;
+}
+/**
+ * Score self-echo rejection over the agent-echo turns only: each must be
+ * suppressed (no response). Real turns are scored by {@link scoreRespondDecision}
+ * — this isolates "did the agent talk to itself?".
+ */
+export declare function scoreEchoRejection(samples: ReadonlyArray<EchoRejectionSample>, opts?: {
+    minRejectionRate?: number;
+}): EchoRejectionResult;
+export interface OwnerSecuritySample {
+    /** The system judged this turn to be the device owner. */
+    predictedOwner: boolean;
+    /** Ground truth: this turn IS the owner. */
+    expectedOwner: boolean;
+}
+export interface OwnerSecurityResult {
+    kind: "owner-security";
+    total: number;
+    accuracy: number;
+    /** Accepted a non-owner AS the owner (the dangerous false-accept). */
+    impostorAcceptRate: number;
+    /** Rejected the real owner (a friction false-reject). */
+    ownerRejectRate: number;
+    minAccuracy: number;
+    maxImpostorAcceptRate: number;
+    passed: boolean;
+}
+/**
+ * Score owner-vs-intruder gating. Passing requires both high overall accuracy
+ * AND an impostor-accept rate at/below the (strict, default 0) ceiling —
+ * letting a stranger in is the failure mode that matters for security, so it is
+ * gated separately from plain accuracy.
+ */
+export declare function scoreOwnerSecurity(samples: ReadonlyArray<OwnerSecuritySample>, opts?: {
+    minAccuracy?: number;
+    maxImpostorAcceptRate?: number;
+}): OwnerSecurityResult;
+export type VoiceE2eCaseResult = TtsAsrRoundTripResult | BargeInInterruptionResult | PauseContinuationResult | OptimisticRollbackRestartResult | FirstResponseLatencyResult | EotDecisionResult | RespondDecisionResult | DiarizationResult | EntityExtractionResult | VoiceEntityMatchResult | EchoRejectionResult | OwnerSecurityResult;
+export interface VoiceE2eSummary {
+    passed: boolean;
+    cases: VoiceE2eCaseResult[];
+}
+export declare function summarizeVoiceE2e(cases: ReadonlyArray<VoiceE2eCaseResult>): VoiceE2eSummary;
+//# sourceMappingURL=e2e-harness.d.ts.map

package/dist/services/voice/e2e-harness.d.ts.map

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

package/dist/services/voice/eager-context-builder.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Eager provider context split (C3).
+ *
+ * Splits provider context assembly into two parts so KV prefill can begin
+ * on speech-START — before ASR has produced a transcript:
+ *
+ *   1. **Deterministic part** — doesn't depend on the user's message text:
+ *        system prompt, persona, enabled skills list, conversation history
+ *        up to the last turn, tool definitions.
+ *      Built on `speech-start` (fire-and-forget via `prebuildDeterministic`).
+ *
+ *   2. **Message-dependent part** — depends on the actual transcript:
+ *        the user's message itself, any message-conditional context injected
+ *        by callers (e.g. relevant calendar/contacts snippets).
+ *      Built on `speech-end` via `complete(userMessage)`.
+ *
+ * The codebase routes context through elizaOS's provider pipeline rather than
+ * a single `buildContext` call. `EagerContextBuilder` adapts to that model by
+ * accepting two async factory functions: one for the deterministic part
+ * (returns a `ContextPartial`) and one for the message-dependent part
+ * (receives the user message, returns a `ContextPartial`). `mergeContext`
+ * combines them in a consistent order so downstream consumers always see
+ * `[deterministic parts] + [message-dependent parts]`.
+ *
+ * Staleness: the deterministic context is considered stale after 30 seconds
+ * (conversation history may have changed if the agent received a message from
+ * another surface). `complete()` rebuilds when stale.
+ *
+ * Thread-safety: all methods are async; do NOT call them concurrently from
+ * multiple async contexts — the class is designed for single-threaded use by
+ * the voice event loop.
+ */
+/**
+ * A fragment of the final prompt context. Fields are intentionally generic
+ * so the same type works regardless of whether the runtime uses raw strings,
+ * token arrays, or structured message lists.
+ *
+ * In practice callers fill `systemBlocks` with things like the system prompt,
+ * enabled skills, persona, tool definitions, and `historyBlocks` with the
+ * conversation history. `mergeContext` joins them in that order.
+ */
+export interface ContextPartial {
+    /**
+     * Ordered list of system / pre-amble text blocks. Each element is a
+     * distinct structural unit (e.g. persona block, skills block, tool-defs
+     * block). They are joined in order during `mergeContext`.
+     */
+    systemBlocks: string[];
+    /**
+     * Conversation history turns up to (but NOT including) the new user
+     * message. Stored as alternating `{role, content}` entries for
+     * compatibility with the elizaOS message format.
+     */
+    historyBlocks: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+    /**
+     * Free-form metadata for diagnostics / telemetry. Not included in the
+     * merged prompt text.
+     */
+    meta?: Record<string, unknown>;
+}
+/**
+ * Complete merged context — the full prompt assembly ready for the LLM
+ * inference call. Produced by `mergeContext` from the two halves.
+ */
+export interface FullContext {
+    /**
+     * The fully assembled system string (deterministic blocks joined by
+     * double-newline, message-dependent blocks appended after).
+     */
+    systemText: string;
+    /**
+     * Full conversation history including the new user message at the end.
+     */
+    history: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+    /** ISO timestamp of when the deterministic part was built. */
+    deterministicBuiltAt: string;
+    /** ISO timestamp of when `complete()` was called. */
+    completedAt: string;
+    /** True when the deterministic context was rebuilt inside `complete()` due to staleness. */
+    deterministicWasStale: boolean;
+}
+/**
+ * Factory function that builds the deterministic context part. Called with no
+ * arguments (it must capture its own runtime reference if it needs one).
+ */
+export type BuildDeterministicFn = () => Promise<ContextPartial>;
+/**
+ * Factory function that builds the message-dependent context part. Called with
+ * the actual user message text.
+ */
+export type BuildMessageDependentFn = (userMessage: string) => Promise<ContextPartial>;
+export interface EagerContextBuilderOptions {
+    buildDeterministic: BuildDeterministicFn;
+    buildMessageDependent: BuildMessageDependentFn;
+    /**
+     * How many milliseconds before the cached deterministic context is
+     * considered stale and must be rebuilt. Default 30 000 ms.
+     */
+    staleCutoffMs?: number;
+    /**
+     * Optional clock injection for tests. Defaults to `Date.now`.
+     */
+    now?: () => number;
+}
+/**
+ * Manages eager splitting of provider context into deterministic + message-
+ * dependent halves. Wire `prebuildDeterministic` to the `speech-start` event
+ * and `complete` to the `speech-end` path (after ASR produces the final
+ * transcript).
+ */
+export declare class EagerContextBuilder {
+    private deterministic;
+    private builtAt;
+    private readonly staleCutoffMs;
+    private readonly buildDeterministicFn;
+    private readonly buildMessageDependentFn;
+    private readonly nowFn;
+    /** In-flight prebuild promise — prevents concurrent duplicate prebuilds. */
+    private prebuildInFlight;
+    constructor(opts: EagerContextBuilderOptions);
+    /**
+     * Fire on `speech-start` (fire-and-forget). Builds and caches the
+     * deterministic context half so it is ready when `complete` is called.
+     *
+     * Concurrent calls are collapsed into a single in-flight build — safe to
+     * call multiple times without double-spending GPU/compute resources.
+     */
+    prebuildDeterministic(): void;
+    /**
+     * Call on `speech-end` with the actual final transcript. Returns the fully
+     * merged context.
+     *
+     * If the cached deterministic context is absent or stale it is rebuilt
+     * inline (blocking). The returned `deterministicWasStale` flag lets callers
+     * emit latency telemetry when the eager pre-build didn't complete in time.
+     */
+    complete(userMessage: string): Promise<FullContext>;
+    /**
+     * Returns true if the cached deterministic context is older than
+     * `staleCutoffMs`.
+     */
+    isStale(): boolean;
+    /**
+     * Discard the cached deterministic context. Useful when the conversation
+     * is reset or the runtime is re-initialised. Thread-safe — can be called
+     * from any context.
+     */
+    invalidate(): void;
+    private runPrebuild;
+}
+/**
+ * Merge deterministic and message-dependent context halves into a
+ * `FullContext`. The merged output places deterministic system blocks first,
+ * then message-dependent system blocks, and appends the user message as the
+ * last history turn.
+ *
+ * @internal Exported for tests.
+ */
+export declare function mergeContext(det: ContextPartial, msgDep: ContextPartial, timestamps: {
+    deterministicBuiltAt: string;
+    completedAt: string;
+    deterministicWasStale: boolean;
+}): FullContext;
+//# sourceMappingURL=eager-context-builder.d.ts.map

package/dist/services/voice/eager-context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eager-context-builder.d.ts","sourceRoot":"","sources":["../../../src/services/voice/eager-context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAMH;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;OAIG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB;;;;OAIG;IACH,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,8DAA8D;IAC9D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,qBAAqB,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACrC,WAAW,EAAE,MAAM,KACf,OAAO,CAAC,cAAc,CAAC,CAAC;AAQ7B,MAAM,WAAW,0BAA0B;IAC1C,kBAAkB,EAAE,oBAAoB,CAAC;IACzC,qBAAqB,EAAE,uBAAuB,CAAC;IAC/C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuB;IAC5D,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA0B;IAClE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAErC,4EAA4E;IAC5E,OAAO,CAAC,gBAAgB,CAA8B;gBAE1C,IAAI,EAAE,0BAA0B;IAO5C;;;;;;OAMG;IACH,qBAAqB,IAAI,IAAI;IAO7B;;;;;;;OAOG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAyBzD;;;OAGG;IACH,OAAO,IAAI,OAAO;IAKlB;;;;OAIG;IACH,UAAU,IAAI,IAAI;YASJ,WAAW;CAKzB;AAMD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC3B,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE;IACX,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,OAAO,CAAC;CAC/B,GACC,WAAW,CAkBb"}

package/dist/services/voice/echo-delay.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Playback→mic echo-delay calibration (#9583, follow-up to #9455).
+ *
+ * The NLMS echo canceller's adaptive taps model only the room impulse response;
+ * the bulk transport delay between TTS playback and the mic capture window
+ * (audio-HAL buffering, Bluetooth, resampling, …) should be removed FIRST so the
+ * finite tap span (and the adaptation budget) isn't spent modelling pure
+ * latency. This finds that bulk lag by normalized cross-correlation of the mic
+ * (near-end) against the playback reference (far-end): the lag that maximizes
+ * correlation is the playback→mic delay, which the caller then applies as a
+ * fixed pre-alignment before the adaptive filter.
+ *
+ * Pure DSP — no FFI, no device. The per-platform default delay still needs to be
+ * tuned on hardware, but the estimator itself is deterministic and testable.
+ */
+export interface EchoDelayEstimate {
+    /** Best playback→mic delay in samples (far leads near by this much). */
+    lagSamples: number;
+    /** Peak normalized cross-correlation at that lag, in [0, 1]. */
+    confidence: number;
+}
+export interface EchoDelayOptions {
+    /** Largest lag to search, in samples. Default 4800 (300 ms @ 16 kHz). */
+    maxLagSamples?: number;
+    /** Smallest lag to search, in samples. Default 0. */
+    minLagSamples?: number;
+}
+/**
+ * Estimate the bulk playback→mic delay: the lag `d` (in samples) that best
+ * aligns the far-end reference into the near-end mic signal, i.e.
+ * `near[n] ≈ g · far[n - d]`. Returns that lag plus its normalized
+ * cross-correlation as a `[0, 1]` confidence.
+ *
+ * Normalized correlation is scale-invariant, so the playback gain `g` does not
+ * bias the result. A low confidence (e.g. `< 0.3`) means no detectable echo
+ * (the signals are independent) — the caller should keep its previous
+ * calibration rather than trust a spurious peak.
+ */
+export declare function estimateEchoDelaySamples(near: Float32Array, far: Float32Array, options?: EchoDelayOptions): EchoDelayEstimate;
+/**
+ * Per-platform SEED playback→mic delay, in milliseconds. This is the initial
+ * pre-alignment applied *before* any echo has been observed; the adaptive
+ * {@link estimateEchoDelaySamples} cross-correlation refines it at runtime once
+ * enough playback-active audio is seen. Until then a platform-appropriate seed
+ * converges faster than starting from zero — most visibly on iOS/macOS, where
+ * the CoreAudio / AVAudioEngine transport delay is small but non-zero and a
+ * 0-sample seed leaves the first barge-in's echo un-aligned.
+ *
+ * These are conservative starting points (they still benefit from per-device
+ * tuning); the goal is only to put the adaptive filter in the right ballpark on
+ * the first turn, not to be exact.
+ */
+export declare const PLATFORM_PLAYBACK_DELAY_DEFAULTS: Readonly<Record<string, number>>;
+/** Fallback seed (ms) for an unrecognized platform id. */
+export declare const DEFAULT_PLAYBACK_DELAY_MS = 25;
+/**
+ * Seed playback→mic delay in milliseconds for a platform id (e.g.
+ * `process.platform`, or the `"ios"` / `"android"` ids the mobile shells
+ * report). Unknown ids fall back to {@link DEFAULT_PLAYBACK_DELAY_MS}.
+ */
+export declare function platformPlaybackDelayMs(platform: string): number;
+/**
+ * Seed playback→mic delay in samples for a platform id. `sampleRate` defaults to
+ * the 16 kHz voice-pipeline rate.
+ */
+export declare function platformPlaybackDelaySamples(platform: string, sampleRate?: number): number;
+//# sourceMappingURL=echo-delay.d.ts.map

package/dist/services/voice/echo-delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-delay.d.ts","sourceRoot":"","sources":["../../../src/services/voice/echo-delay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,iBAAiB;IACjC,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAChC,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,gBAAqB,GAC5B,iBAAiB,CAoCnB;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gCAAgC,EAAE,QAAQ,CACtD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYtB,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC3C,QAAQ,EAAE,MAAM,EAChB,UAAU,SAAS,GACjB,MAAM,CAER"}

package/dist/services/voice/echo-metrics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Echo-return-loss-enhancement in dB: 10*log10(sum(near^2) / sum(residual^2)).
+ * Higher is better. Returns +Infinity when the residual is silent and 0 when
+ * there is no near-end energy to enhance.
+ */
+export declare function computeErle(nearEnd: Float32Array, residual: Float32Array): number;
+//# sourceMappingURL=echo-metrics.d.ts.map

package/dist/services/voice/echo-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-metrics.d.ts","sourceRoot":"","sources":["../../../src/services/voice/echo-metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,WAAW,CAC1B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,YAAY,GACpB,MAAM,CAWR"}