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

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.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"}

package/dist/services/voice/echo-reference-buffer.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Echo-reference alignment buffer (#9583, follow-up to #9455/#9586).
+ *
+ * The NLMS echo canceller's `process(nearEnd, farEnd)` needs the far-end
+ * (the agent's TTS playback) **time-aligned** to the current mic frame: the
+ * echo in `nearEnd[t]` is the room-filtered playback from `t − delay`, where
+ * `delay` is the bulk playback→mic transport delay (estimated by
+ * {@link estimateEchoDelaySamples} in `echo-delay.ts`).
+ *
+ * The caller renders playback PCM in real time and `push()`es it here as it goes;
+ * per mic frame it then asks for the aligned far-end slice. This is the
+ * "caller must supply the reference" primitive the consumer seam was missing —
+ * a fixed-capacity delay line, pure logic (no FFI, no device, no audio I/O).
+ * Samples not yet rendered, or already evicted past capacity, are zero-filled
+ * (no echo reference ⇒ the adaptive filter simply has nothing to cancel there).
+ */
+export interface EchoReferenceBufferOptions {
+    /**
+     * Ring-buffer capacity in samples. Must comfortably exceed
+     * `maxDelaySamples + frameLength`. Default 24000 (1.5 s @ 16 kHz).
+     */
+    capacitySamples?: number;
+    /** Sample rate for timestamp-based push/read helpers. Default 16000. */
+    sampleRateHz?: number;
+}
+export declare class EchoReferenceBuffer {
+    private readonly buffer;
+    private readonly valid;
+    private readonly capacity;
+    private readonly sampleRateHz;
+    /** Total samples ever pushed (monotonic); the logical "now" cursor. */
+    private pushed;
+    /** Timestamp mapped to absolute sample 0 for timestamp-aware playback. */
+    private originMs;
+    constructor(options?: EchoReferenceBufferOptions);
+    /** Append rendered playback (far-end) PCM as it is produced. */
+    push(playback: Float32Array): void;
+    /**
+     * Store rendered playback at its capture/render timestamp. This preserves
+     * real gaps between playback bursts instead of treating chunks as contiguous.
+     */
+    pushAt(timestampMs: number, playback: Float32Array): void;
+    /**
+     * The far-end reference frame aligned to a mic frame of `length` samples
+     * captured `delaySamples` after the corresponding playback. Returns the
+     * playback window `[pushed − delaySamples − length, pushed − delaySamples)`.
+     * Indices before the retained window (not yet pushed, or evicted past
+     * capacity) are zero-filled.
+     */
+    referenceFor(length: number, delaySamples: number): Float32Array;
+    /**
+     * Reference aligned to a mic frame starting at `timestampMs`.
+     * Returns playback `[timestampMs - delay, timestampMs - delay + length)`.
+     */
+    referenceAt(timestampMs: number, length: number, delaySamples: number): Float32Array;
+    /** Samples pushed so far (the monotonic stream position). */
+    get position(): number;
+    /** Drop all buffered playback (e.g. on a new turn / barge-in flush). */
+    reset(): void;
+    private sampleIndexFor;
+    private writeAt;
+    private clearRange;
+    private readWindow;
+}
+//# sourceMappingURL=echo-reference-buffer.d.ts.map

package/dist/services/voice/echo-reference-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-reference-buffer.d.ts","sourceRoot":"","sources":["../../../src/services/voice/echo-reference-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,0BAA0B;IAC1C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,uEAAuE;IACvE,OAAO,CAAC,MAAM,CAAK;IACnB,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,OAAO,GAAE,0BAA+B;IAOpD,gEAAgE;IAChE,IAAI,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAKlC;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAgBzD;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY;IAQhE;;;OAGG;IACH,WAAW,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAClB,YAAY;IAUf,6DAA6D;IAC7D,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,wEAAwE;IACxE,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,UAAU;CAYlB"}

package/{src → dist}/services/voice/eliza1-eot-scorer.d.ts

@@ -1,14 +1,14 @@
 /**
  * Eliza-1 EOT scorer — reuses the already-loaded text model to compute
- * P(`<|im_end|>` next | conversation_so_far) without shipping a separate
+ * P(`<end_of_turn>` next | conversation_so_far) without shipping a separate
  * detector ONNX.
  *
  * The runtime keeps a `LlamaModel` resident for chat generation. Voice
- * EOT scoring is a single forward pass over the formatted Qwen chat
- * prompt with the trailing `<|im_end|>` removed. `capacitor-llama`'s
+ * EOT scoring is a single forward pass over the formatted Gemma chat
+ * prompt with the trailing `<end_of_turn>` removed. `capacitor-llama`'s
  * `LlamaContextSequence.controlledEvaluate()` returns the next-token
  * probability distribution, so we simply read the entry for the
- * `<|im_end|>` token id — no sampling loop, no KV-cache growth on the
+ * `<end_of_turn>` token id — no sampling loop, no KV-cache growth on the
  * chat session.
  *
  * A dedicated `LlamaContext` is held just for this scorer so we do not
@@ -76,7 +76,7 @@ export interface Eliza1EotScorerOptions {
     modelLabel?: string;
 }
 export interface Eliza1EotScoreResult {
-    /** Probability of `<|im_end|>` as the next token, ∈ [0, 1]. */
+    /** Probability of `<end_of_turn>` as the next token, ∈ [0, 1]. */
     probability: number;
     /** Wall-clock model latency for this scoring call. */
     latencyMs: number;
@@ -97,7 +97,7 @@ export declare class Eliza1EotScorer {
     readonly modelLabel: string;
     private context;
     private sequence;
-    private imEndTokenId;
+    private endOfTurnTokenId;
     private initPromise;
     /** Serializes concurrent calls — controlledEvaluate is not thread-safe per-sequence. */
     private inflight;
@@ -110,8 +110,8 @@ export declare class Eliza1EotScorer {
     private runOnce;
 }
 /**
- * Format the partial transcript using the Qwen chat template, with the
- * trailing `<|im_end|>` removed so the next predicted token *is* the
+ * Format the partial transcript using the Gemma chat template, with the
+ * trailing `<end_of_turn>` removed so the next predicted token *is* the
  * EOT signal we want to measure.
  *
  * Matches the formatting LiveKit's turn-detector uses (single user turn,

package/dist/services/voice/eliza1-eot-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eliza1-eot-scorer.d.ts","sourceRoot":"","sources":["../../../src/services/voice/eliza1-eot-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAAC;IACnE,aAAa,CAAC,OAAO,EAAE;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,GAAG;YAAE,QAAQ,EAAE,KAAK,CAAC;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KAC1E,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAChC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAAC;IACxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACxC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,kBAAkB,CACjB,KAAK,EAAE,2BAA2B,EAAE,EACpC,OAAO,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,GACvC,OAAO,CAAC,KAAK,CAAC,4BAA4B,GAAG,SAAS,CAAC,CAAC,CAAC;CAC5D;AAED,MAAM,MAAM,2BAA2B,GACpC,MAAM,GACN;IACA,KAAK,EAAE,MAAM;IACb,OAAO,EAAE;QACR,YAAY,CAAC,EAAE;YACd,aAAa,CAAC,EAAE,OAAO,CAAC;YACxB,UAAU,CAAC,EAAE,OAAO,CAAC;SACrB,CAAC;KACF;CACA,CAAC;AAEL,MAAM,WAAW,4BAA4B;IAC5C,IAAI,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;CACF;AAKD,MAAM,WAAW,sBAAsB;IACtC,uDAAuD;IACvD,KAAK,EAAE,cAAc,CAAC;IACtB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACpC,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,WAAW,CAA8B;IACjD,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAuC;gBAE3C,OAAO,EAAE,sBAAsB;IAarC,KAAK,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsB/D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAShB,WAAW;YAMX,UAAU;IA6BxB,OAAO,CAAC,cAAc;YAOR,OAAO;CAoBrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG1D"}

package/dist/services/voice/embedding-server.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Lazy embedding `llama-server` sidecar for Eliza-1 bundles.
+ *
+ * The route resolver decides which GGUF backs embeddings. This class owns the
+ * process boundary: validate the GGUF at construction, start the sidecar only
+ * on first non-empty `embed()`, and return Matryoshka-truncated vectors.
+ */
+import { type LocalEmbeddingRoute } from "./embedding";
+interface EmbeddingServerConfig {
+    /** GGUF the sidecar mmaps. For the dedicated-region mode this is the `embedding/` file. */
+    modelPath: string;
+    /** Extra `llama-server` flags — the route's `embeddingServerFlags` (`--embeddings --pooling last`). */
+    serverFlags: ReadonlyArray<string>;
+    /** GPU offload: `"auto"` (= all layers) for CPU/Vulkan/CUDA hosts, `0` to force CPU. */
+    gpuLayers?: number | "auto";
+    /** Thread count for the embedding forward pass. Defaults to the host's logical core count. */
+    threads?: number;
+}
+export declare class EmbeddingServer {
+    private readonly config;
+    private child;
+    private baseUrl;
+    private starting;
+    constructor(config: EmbeddingServerConfig);
+    isRunning(): boolean;
+    embed(texts: string[], dim?: number): Promise<number[][]>;
+    private ensureStarted;
+    private start;
+    private waitUntilReady;
+    stop(): Promise<void>;
+}
+export declare function embeddingServerForRoute(route: LocalEmbeddingRoute, opts?: {
+    gpuLayers?: number | "auto";
+    threads?: number;
+}): EmbeddingServer;
+export {};
+//# sourceMappingURL=embedding-server.d.ts.map

package/dist/services/voice/embedding-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-server.d.ts","sourceRoot":"","sources":["../../../src/services/voice/embedding-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAEN,KAAK,mBAAmB,EAExB,MAAM,aAAa,CAAC;AAGrB,UAAU,qBAAqB;IAC9B,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAC;IAClB,uGAAuG;IACvG,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAA8B;gBAElC,MAAM,EAAE,qBAAqB;IAUzC,SAAS,IAAI,OAAO;IAId,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,SAAO,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAoC/C,aAAa;YAQb,KAAK;YAuCL,cAAc;IAuBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAa3B;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,mBAAmB,EAC1B,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1D,eAAe,CAWjB"}

package/{src → dist}/services/voice/embedding.d.ts

@@ -64,9 +64,8 @@ export type LocalEmbeddingSource = {
     /**
      * The dedicated model already ships a contrastive `last`-token
      * pooling head — `--pooling last` is still passed so llama-server
-     * doesn't fall back to the GGUF's metadata default (which for a raw
-     * Qwen3 base is `mean`). The model's own pooling layer dominates;
-     * this just pins the read.
+     * doesn't fall back to the GGUF's metadata default. The model's own
+     * pooling layer dominates; this just pins the read.
      */
     readonly poolingType: "last";
 };

package/dist/services/voice/embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../../src/services/voice/embedding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAElD,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,EAAG,IAAa,CAAC;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAEtD,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,SAAS,MAAM,EAAE,EACtB,GAAG,EAAE,MAAM,GACT,MAAM,EAAE,CAiBV;AAYD,MAAM,MAAM,oBAAoB,GAC7B;IACA,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC5B,GACD;IACA,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,OAAO,kBAAkB,CAAC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC5B,CAAC;AAaL;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,YAAY,CAEhE,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACtB,GAAG,oBAAoB,CA4BvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,EAAE,OAAO,kBAAkB,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5C;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,mBAAmB,CAoBtB"}

package/dist/services/voice/emotion-attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emotion-attribution.d.ts","sourceRoot":"","sources":["../../../src/services/voice/emotion-attribution.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,iBAAiB,EAGtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACX,4BAA4B,EAC5B,eAAe,EACf,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,6BAA6B,GACtC,MAAM,GACN,UAAU,GACV,sBAAsB,GACtB,uBAAuB,GACvB,gBAAgB,GAChB,qBAAqB,CAAC;AAEzB,MAAM,WAAW,yBAAyB;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,4BAA4B,CAAC;IACrC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,uBAAuB,CAAC;IAC9B,KAAK,CAAC,EAAE,yBAAyB,CAAC;IAClC;;;;OAIG;IACH,KAAK,CAAC,EAAE,sBAAsB,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACpC,MAAM,EACH,qBAAqB,GACrB,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,sBAAsB,GACtB,8BAA8B,GAC9B,gBAAgB,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,6BAA6B,CAAC;IACtC,kBAAkB,EAAE,KAAK,CAAC;IAC1B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,GAAG,CAAC,EAAE,eAAe,CAAC;CACtB;AAoGD,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,4BAA4B,GACjC,uBAAuB,CAgKzB"}