@kaleidorg/mind 0.3.0 → 0.4.0

package/dist/qvac/assistant.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Hands-free voice-assistant loop — the transcribe → reason → speak cycle that
+ * QVAC's `transcribeStream()` makes possible, lifted into shared code so mobile
+ * and desktop run the same orchestration.
+ *
+ * The host owns the I/O: it opens the SDK session (`transcribeStream` with
+ * `DEFAULT_VOICE_STREAM_PARAMS`), feeds mic audio via `session.write()`, and
+ * supplies `respond` (LLM/funnel turn → reply text) + `speak` (synth + play).
+ * This loop does the parts that must be identical everywhere: filter Whisper's
+ * silence hallucinations, and gate the mic during playback so the assistant
+ * never transcribes its own voice (QVAC's reference uses a mic-gate, not
+ * barge-in — we mirror that).
+ */
+/** A transcript event from a `transcribeStream` conversation session. */
+export interface VoiceTranscriptEvent {
+    type: string;
+    /** Present on `text` events — a committed utterance. */
+    text?: string;
+}
+/** The host's transcription session (the SDK's conversation session fits). */
+export type VoiceAssistantSession = AsyncIterable<VoiceTranscriptEvent>;
+export type VoiceAssistantState = 'listening' | 'thinking' | 'speaking';
+export interface VoiceAssistantHandlers {
+    /** Produce an assistant reply for a user utterance (wraps the LLM/funnel). */
+    respond: (transcript: string) => Promise<string>;
+    /** Speak the reply: synth + playback. Resolves when playback finishes. */
+    speak: (text: string) => Promise<void>;
+    /**
+     * Gate mic capture so the assistant doesn't hear itself. The host should drop
+     * (not buffer) audio while gated. Called `true` before speaking, `false` after
+     * the post-playback cooldown.
+     */
+    setMicGated?: (gated: boolean) => void;
+    /** A user utterance passed the filter and is about to be handled. */
+    onUserText?: (text: string) => void;
+    /** The assistant's reply, before it is spoken. */
+    onReply?: (text: string) => void;
+    /** UI state transitions. */
+    onState?: (state: VoiceAssistantState) => void;
+}
+export interface VoiceAssistantOptions {
+    /** Minimum utterance length to handle (drops "you", ".", etc.). Default 3. */
+    minChars?: number;
+    /** Utterances to ignore (case-insensitive, trailing punctuation stripped). */
+    ignoredUtterances?: Iterable<string>;
+    /** Pause after playback so speaker reverb settles before listening. Default 300ms. */
+    postPlaybackCooldownMs?: number;
+    /** Injected for tests; defaults to setTimeout. */
+    sleep?: (ms: number) => Promise<void>;
+    /** Stop the loop early. */
+    signal?: AbortSignal;
+}
+/**
+ * Whisper frequently hallucinates these from silence — drop them so the
+ * assistant doesn't answer phantom turns. (QVAC docs cite "you", ".", "Thanks.")
+ */
+export declare const DEFAULT_IGNORED_UTTERANCES: readonly string[];
+/**
+ * Should this utterance be handled? False for too-short text or a known Whisper
+ * hallucination. Pure + exported so it's directly testable.
+ */
+export declare function shouldHandleUtterance(text: string, options?: {
+    minChars?: number;
+    ignoredUtterances?: Iterable<string>;
+}): boolean;
+/**
+ * Run the hands-free loop until the session ends or `signal` aborts. Only `text`
+ * events drive a turn; `vad`/`segment`/`endOfTurn` events are ignored here (the
+ * host can read them off the session separately for UI). Always leaves the mic
+ * un-gated on exit.
+ */
+export declare function runVoiceAssistant(session: VoiceAssistantSession, handlers: VoiceAssistantHandlers, options?: VoiceAssistantOptions): Promise<void>;
+//# sourceMappingURL=assistant.d.ts.map

package/dist/qvac/assistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.d.ts","sourceRoot":"","sources":["../../src/qvac/assistant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;AAExE,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,0EAA0E;IAC1E,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,kDAAkD;IAClD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,sFAAsF;IACtF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kDAAkD;IAClD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,2BAA2B;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAEvD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;CAAO,GACxE,OAAO,CAST;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAmDf"}

package/dist/qvac/assistant.js

@@ -0,0 +1,97 @@
+/**
+ * Hands-free voice-assistant loop — the transcribe → reason → speak cycle that
+ * QVAC's `transcribeStream()` makes possible, lifted into shared code so mobile
+ * and desktop run the same orchestration.
+ *
+ * The host owns the I/O: it opens the SDK session (`transcribeStream` with
+ * `DEFAULT_VOICE_STREAM_PARAMS`), feeds mic audio via `session.write()`, and
+ * supplies `respond` (LLM/funnel turn → reply text) + `speak` (synth + play).
+ * This loop does the parts that must be identical everywhere: filter Whisper's
+ * silence hallucinations, and gate the mic during playback so the assistant
+ * never transcribes its own voice (QVAC's reference uses a mic-gate, not
+ * barge-in — we mirror that).
+ */
+/**
+ * Whisper frequently hallucinates these from silence — drop them so the
+ * assistant doesn't answer phantom turns. (QVAC docs cite "you", ".", "Thanks.")
+ */
+export const DEFAULT_IGNORED_UTTERANCES = [
+    'you', 'thank you', 'thanks', 'bye', 'okay', '.',
+];
+/**
+ * Should this utterance be handled? False for too-short text or a known Whisper
+ * hallucination. Pure + exported so it's directly testable.
+ */
+export function shouldHandleUtterance(text, options = {}) {
+    const trimmed = text.trim();
+    if (trimmed.length < (options.minChars ?? 3))
+        return false;
+    const norm = trimmed.toLowerCase().replace(/[.!?,]+$/, '').trim();
+    if (!norm)
+        return false;
+    const ignored = new Set([...(options.ignoredUtterances ?? DEFAULT_IGNORED_UTTERANCES)].map((s) => s.toLowerCase()));
+    return !ignored.has(norm);
+}
+/**
+ * Run the hands-free loop until the session ends or `signal` aborts. Only `text`
+ * events drive a turn; `vad`/`segment`/`endOfTurn` events are ignored here (the
+ * host can read them off the session separately for UI). Always leaves the mic
+ * un-gated on exit.
+ */
+export async function runVoiceAssistant(session, handlers, options = {}) {
+    const sleep = options.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    const cooldown = options.postPlaybackCooldownMs ?? 300;
+    let speaking = false;
+    handlers.onState?.('listening');
+    try {
+        for await (const event of session) {
+            if (options.signal?.aborted)
+                break;
+            if (event.type !== 'text' || typeof event.text !== 'string')
+                continue;
+            // Defensive: ignore anything heard mid-playback (host also gates the mic).
+            if (speaking)
+                continue;
+            const transcript = event.text.trim();
+            if (!shouldHandleUtterance(transcript, options))
+                continue;
+            handlers.onUserText?.(transcript);
+            handlers.onState?.('thinking');
+            let reply;
+            try {
+                reply = await handlers.respond(transcript);
+            }
+            catch {
+                handlers.onState?.('listening');
+                continue;
+            }
+            if (options.signal?.aborted)
+                break;
+            if (!reply || !reply.trim()) {
+                handlers.onState?.('listening');
+                continue;
+            }
+            handlers.onReply?.(reply);
+            speaking = true;
+            handlers.setMicGated?.(true);
+            handlers.onState?.('speaking');
+            try {
+                await handlers.speak(reply);
+            }
+            catch {
+                /* keep the loop alive on a playback error */
+            }
+            finally {
+                await sleep(cooldown);
+                speaking = false;
+                handlers.setMicGated?.(false);
+                handlers.onState?.('listening');
+            }
+        }
+    }
+    finally {
+        // Never leave the mic gated if the loop exits mid-turn.
+        handlers.setMicGated?.(false);
+    }
+}
+//# sourceMappingURL=assistant.js.map

package/dist/qvac/assistant.js.map

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

package/dist/qvac/config.d.ts

@@ -0,0 +1,64 @@
+/**
+ * QVAC model-load configs and constants, shared across every host. These are
+ * plain data (no SDK import) so they stay portable and testable; callers merge
+ * in SDK-specific bits like `verbosity: VERBOSITY.ERROR` at load time.
+ */
+/**
+ * CPU baseline for the local llamacpp model. Used as the GPU fallback and as the
+ * base the GPU attempt overrides (device + gpu_layers).
+ */
+export declare const LOCAL_LLM_CONFIG: {
+    readonly device: "cpu";
+    readonly gpu_layers: 0;
+    readonly ctx_size: 2048;
+    readonly tools: true;
+};
+/**
+ * GPU (Metal on iPhone) offload — far faster than CPU when llamacpp can init the
+ * Metal context in the worklet. Fall back to {@link LOCAL_LLM_CONFIG} if the GPU
+ * load throws. ctx 4096 fits the agentic prompt (system + tools + skills + a
+ * little history); 2048 overflowed immediately ("prompt exceeds context").
+ */
+export declare const LOCAL_LLM_CONFIG_GPU: {
+    readonly device: "gpu";
+    readonly gpu_layers: 99;
+    readonly ctx_size: 4096;
+    readonly tools: true;
+};
+/**
+ * Delegated to a desktop provider — it has the RAM to run a big context, so give
+ * the agentic prompt plenty of room (Qwen3-600M supports up to 32k). 2048
+ * overflowed with the system prompt + tool/skill definitions alone.
+ */
+export declare const DELEGATE_LLM_CONFIG: {
+    readonly ctx_size: 16384;
+    readonly device: "gpu";
+    readonly gpu_layers: 99;
+    readonly tools: true;
+};
+/** SUPERTONIC-2 TTS output sample rate (Hz). Used to build the WAV for playback. */
+export declare const TTS_SAMPLE_RATE = 44100;
+/**
+ * Default params for a hands-free `transcribeStream()` voice session (Whisper).
+ * `emitVadEvents` turns the session into a conversation stream (text + vad +
+ * endOfTurn events); `endOfTurnSilenceMs` is how long a pause must last before
+ * an utterance is committed — conservative so it doesn't cut speakers off mid
+ * sentence or trigger on TTS reverb. Hosts merge in `modelId` + spread these.
+ */
+export declare const DEFAULT_VOICE_STREAM_PARAMS: {
+    readonly emitVadEvents: true;
+    readonly endOfTurnSilenceMs: 700;
+};
+/**
+ * Whisper languages we request directly from the device locale. whisper.cpp
+ * supports more, but the QVAC handler rejects "auto"/detect_language for these
+ * tiny models, so we pass a concrete code (and fall back to 'en').
+ */
+export declare const WHISPER_LANGS: ReadonlySet<string>;
+/**
+ * Best-effort 2-letter Whisper language code from an OS locale string
+ * (e.g. "it-IT" → "it"), restricted to codes Whisper handles well. Falls back to
+ * 'en'. Pure: the host reads the locale (NativeModules etc.) and passes it here.
+ */
+export declare function normalizeWhisperLang(locale: string | null | undefined): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/qvac/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/qvac/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;;;;;CAGtB,CAAC;AAEX,oFAAoF;AACpF,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAI5C,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAI9E"}

package/dist/qvac/config.js

@@ -0,0 +1,71 @@
+/**
+ * QVAC model-load configs and constants, shared across every host. These are
+ * plain data (no SDK import) so they stay portable and testable; callers merge
+ * in SDK-specific bits like `verbosity: VERBOSITY.ERROR` at load time.
+ */
+/**
+ * CPU baseline for the local llamacpp model. Used as the GPU fallback and as the
+ * base the GPU attempt overrides (device + gpu_layers).
+ */
+export const LOCAL_LLM_CONFIG = {
+    device: 'cpu',
+    gpu_layers: 0,
+    ctx_size: 2048,
+    tools: true,
+};
+/**
+ * GPU (Metal on iPhone) offload — far faster than CPU when llamacpp can init the
+ * Metal context in the worklet. Fall back to {@link LOCAL_LLM_CONFIG} if the GPU
+ * load throws. ctx 4096 fits the agentic prompt (system + tools + skills + a
+ * little history); 2048 overflowed immediately ("prompt exceeds context").
+ */
+export const LOCAL_LLM_CONFIG_GPU = {
+    ...LOCAL_LLM_CONFIG,
+    device: 'gpu',
+    gpu_layers: 99, // offload all layers; llamacpp clamps to the model's count
+    ctx_size: 4096,
+};
+/**
+ * Delegated to a desktop provider — it has the RAM to run a big context, so give
+ * the agentic prompt plenty of room (Qwen3-600M supports up to 32k). 2048
+ * overflowed with the system prompt + tool/skill definitions alone.
+ */
+export const DELEGATE_LLM_CONFIG = {
+    ...LOCAL_LLM_CONFIG_GPU,
+    ctx_size: 16384,
+};
+/** SUPERTONIC-2 TTS output sample rate (Hz). Used to build the WAV for playback. */
+export const TTS_SAMPLE_RATE = 44100;
+/**
+ * Default params for a hands-free `transcribeStream()` voice session (Whisper).
+ * `emitVadEvents` turns the session into a conversation stream (text + vad +
+ * endOfTurn events); `endOfTurnSilenceMs` is how long a pause must last before
+ * an utterance is committed — conservative so it doesn't cut speakers off mid
+ * sentence or trigger on TTS reverb. Hosts merge in `modelId` + spread these.
+ */
+export const DEFAULT_VOICE_STREAM_PARAMS = {
+    emitVadEvents: true,
+    endOfTurnSilenceMs: 700,
+};
+/**
+ * Whisper languages we request directly from the device locale. whisper.cpp
+ * supports more, but the QVAC handler rejects "auto"/detect_language for these
+ * tiny models, so we pass a concrete code (and fall back to 'en').
+ */
+export const WHISPER_LANGS = new Set([
+    'en', 'it', 'es', 'fr', 'de', 'pt', 'nl', 'ru', 'pl', 'uk', 'tr', 'ar',
+    'zh', 'ja', 'ko', 'hi', 'id', 'sv', 'no', 'da', 'fi', 'cs', 'ro', 'el',
+    'he', 'th', 'vi', 'hu', 'ca',
+]);
+/**
+ * Best-effort 2-letter Whisper language code from an OS locale string
+ * (e.g. "it-IT" → "it"), restricted to codes Whisper handles well. Falls back to
+ * 'en'. Pure: the host reads the locale (NativeModules etc.) and passes it here.
+ */
+export function normalizeWhisperLang(locale) {
+    if (!locale)
+        return 'en';
+    const code = String(locale).split(/[-_]/)[0]?.toLowerCase() ?? 'en';
+    return WHISPER_LANGS.has(code) ? code : 'en';
+}
+//# sourceMappingURL=config.js.map

package/dist/qvac/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/qvac/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,KAAK;IACb,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;CACH,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG,gBAAgB;IACnB,MAAM,EAAE,KAAK;IACb,UAAU,EAAE,EAAE,EAAE,2DAA2D;IAC3E,QAAQ,EAAE,IAAI;CACN,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,oBAAoB;IACvB,QAAQ,EAAE,KAAK;CACP,CAAC;AAEX,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,aAAa,EAAE,IAAI;IACnB,kBAAkB,EAAE,GAAG;CACf,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC;IACxD,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IACtE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IACtE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC7B,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiC;IACpE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC;IACpE,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC"}

package/dist/qvac/delegate.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Delegation helpers — the provider firewall (who may connect) and the
+ * consumer-side delegate config. Pure data builders (no `@qvac/sdk` import) so
+ * they stay shared + testable; the host passes the result to
+ * `startQVACProvider({ firewall })` / `loadModel({ delegate })`.
+ *
+ * Security note: a QVAC provider is reachable by anyone who learns its
+ * Hyperswarm public key. Advertising with no firewall means any such peer can
+ * run inference on your machine. Use {@link allowListFirewall} so a desktop
+ * provider serves ONLY its paired phone(s).
+ */
+/** Firewall for `startQVACProvider` — restrict who may delegate to this provider. */
+export interface ProviderFirewall {
+    mode: 'allow' | 'deny';
+    publicKeys: string[];
+}
+/**
+ * Allow ONLY these consumer public keys to delegate (zero-trust). Pass the
+ * paired phone(s)' public keys so no one else can use the desktop brain even if
+ * they learn its public key.
+ */
+export declare function allowListFirewall(consumerPublicKeys: Iterable<string>): ProviderFirewall;
+/** Deny these consumer public keys; everyone else may connect. */
+export declare function denyListFirewall(consumerPublicKeys: Iterable<string>): ProviderFirewall;
+/**
+ * Parse a comma/space/newline-separated key list (e.g. from an env var or a
+ * pairing store) into an allow-list firewall, or `undefined` when none are
+ * configured — the caller then advertises openly and should warn.
+ */
+export declare function firewallFromKeyList(raw: string | null | undefined): ProviderFirewall | undefined;
+/** Consumer-side config for `loadModel({ delegate })`. */
+export interface DelegateConfig {
+    providerPublicKey: string;
+    fallbackToLocal: boolean;
+    timeout?: number;
+    forceNewConnection?: boolean;
+}
+/**
+ * Build the `delegate` config for a delegated `loadModel`. `fallbackToLocal`
+ * defaults to false (the host owns recovery), matching rate's existing
+ * LLM/Whisper/TTS delegated loads.
+ */
+export declare function buildDelegateConfig(providerPublicKey: string, opts?: {
+    fallbackToLocal?: boolean;
+    timeout?: number;
+    forceNewConnection?: boolean;
+}): DelegateConfig;
+//# sourceMappingURL=delegate.d.ts.map

package/dist/qvac/delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/qvac/delegate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAExF;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAIhG;AAED,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,iBAAiB,EAAE,MAAM,EACzB,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,GACvF,cAAc,CAOhB"}

package/dist/qvac/delegate.js

@@ -0,0 +1,51 @@
+/**
+ * Delegation helpers — the provider firewall (who may connect) and the
+ * consumer-side delegate config. Pure data builders (no `@qvac/sdk` import) so
+ * they stay shared + testable; the host passes the result to
+ * `startQVACProvider({ firewall })` / `loadModel({ delegate })`.
+ *
+ * Security note: a QVAC provider is reachable by anyone who learns its
+ * Hyperswarm public key. Advertising with no firewall means any such peer can
+ * run inference on your machine. Use {@link allowListFirewall} so a desktop
+ * provider serves ONLY its paired phone(s).
+ */
+function normalizeKeys(keys) {
+    return [...new Set([...keys].map((k) => k.trim()).filter(Boolean))];
+}
+/**
+ * Allow ONLY these consumer public keys to delegate (zero-trust). Pass the
+ * paired phone(s)' public keys so no one else can use the desktop brain even if
+ * they learn its public key.
+ */
+export function allowListFirewall(consumerPublicKeys) {
+    return { mode: 'allow', publicKeys: normalizeKeys(consumerPublicKeys) };
+}
+/** Deny these consumer public keys; everyone else may connect. */
+export function denyListFirewall(consumerPublicKeys) {
+    return { mode: 'deny', publicKeys: normalizeKeys(consumerPublicKeys) };
+}
+/**
+ * Parse a comma/space/newline-separated key list (e.g. from an env var or a
+ * pairing store) into an allow-list firewall, or `undefined` when none are
+ * configured — the caller then advertises openly and should warn.
+ */
+export function firewallFromKeyList(raw) {
+    if (!raw)
+        return undefined;
+    const keys = raw.split(/[\s,]+/).map((k) => k.trim()).filter(Boolean);
+    return keys.length ? allowListFirewall(keys) : undefined;
+}
+/**
+ * Build the `delegate` config for a delegated `loadModel`. `fallbackToLocal`
+ * defaults to false (the host owns recovery), matching rate's existing
+ * LLM/Whisper/TTS delegated loads.
+ */
+export function buildDelegateConfig(providerPublicKey, opts = {}) {
+    return {
+        providerPublicKey: providerPublicKey.trim(),
+        fallbackToLocal: opts.fallbackToLocal ?? false,
+        ...(opts.timeout != null ? { timeout: opts.timeout } : {}),
+        ...(opts.forceNewConnection != null ? { forceNewConnection: opts.forceNewConnection } : {}),
+    };
+}
+//# sourceMappingURL=delegate.js.map

package/dist/qvac/delegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../src/qvac/delegate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,SAAS,aAAa,CAAC,IAAsB;IAC3C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,kBAAoC;IACpE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,kBAAoC;IACnE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,EAAE,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAA8B;IAChE,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,iBAAyB,EACzB,OAAsF,EAAE;IAExF,OAAO;QACL,iBAAiB,EAAE,iBAAiB,CAAC,IAAI,EAAE;QAC3C,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,KAAK;QAC9C,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5F,CAAC;AACJ,CAAC"}

package/dist/qvac/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @kaleidorg/mind-qvac — the single home for all @qvac/sdk logic behind
+ * @kaleidorg/mind. Hosts (rate mobile, desktop provider, cli) supply @qvac/sdk
+ * as a peer dependency; this package owns the orchestration so the logic lives
+ * in one place instead of drifting copies per host.
+ *
+ * This first slice exports the platform-agnostic core (pure text helpers, model
+ * configs, completion parsing). The QVAC-calling provider/voice/host wrappers
+ * land next, on top of these.
+ */
+export { cleanAssistantVisibleText, sanitizeForSupertonic, } from './text.js';
+export { LOCAL_LLM_CONFIG, LOCAL_LLM_CONFIG_GPU, DELEGATE_LLM_CONFIG, TTS_SAMPLE_RATE, DEFAULT_VOICE_STREAM_PARAMS, WHISPER_LANGS, normalizeWhisperLang, } from './config.js';
+export { finalToTurn, type QvacFinalLike, type ParsedTurn, } from './parse.js';
+export { consumeRun, type CompletionEventLike, type CompletionRunLike, type StreamHandlers, type ConsumedTurn, } from './stream.js';
+export { createQvacProvider, type QvacProviderOptions, type QvacTurnInput, } from './provider.js';
+export { createQvacVoice, type QvacVoice, type QvacVoiceOptions, type VoiceSession, type PcmAudio, } from './voice.js';
+export { runVoiceAssistant, shouldHandleUtterance, DEFAULT_IGNORED_UTTERANCES, type VoiceAssistantSession, type VoiceAssistantHandlers, type VoiceAssistantOptions, type VoiceAssistantState, type VoiceTranscriptEvent, } from './assistant.js';
+export { allowListFirewall, denyListFirewall, firewallFromKeyList, buildDelegateConfig, type ProviderFirewall, type DelegateConfig, } from './delegate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/qvac/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/qvac/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC3B,aAAa,EACb,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EACV,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,QAAQ,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC"}

package/dist/qvac/index.js

@@ -0,0 +1,19 @@
+/**
+ * @kaleidorg/mind-qvac — the single home for all @qvac/sdk logic behind
+ * @kaleidorg/mind. Hosts (rate mobile, desktop provider, cli) supply @qvac/sdk
+ * as a peer dependency; this package owns the orchestration so the logic lives
+ * in one place instead of drifting copies per host.
+ *
+ * This first slice exports the platform-agnostic core (pure text helpers, model
+ * configs, completion parsing). The QVAC-calling provider/voice/host wrappers
+ * land next, on top of these.
+ */
+export { cleanAssistantVisibleText, sanitizeForSupertonic, } from './text.js';
+export { LOCAL_LLM_CONFIG, LOCAL_LLM_CONFIG_GPU, DELEGATE_LLM_CONFIG, TTS_SAMPLE_RATE, DEFAULT_VOICE_STREAM_PARAMS, WHISPER_LANGS, normalizeWhisperLang, } from './config.js';
+export { finalToTurn, } from './parse.js';
+export { consumeRun, } from './stream.js';
+export { createQvacProvider, } from './provider.js';
+export { createQvacVoice, } from './voice.js';
+export { runVoiceAssistant, shouldHandleUtterance, DEFAULT_IGNORED_UTTERANCES, } from './assistant.js';
+export { allowListFirewall, denyListFirewall, firewallFromKeyList, buildDelegateConfig, } from './delegate.js';
+//# sourceMappingURL=index.js.map

package/dist/qvac/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/qvac/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,2BAA2B,EAC3B,aAAa,EACb,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,GAGZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,GAKX,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,GAGnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,GAKhB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,GAM3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,eAAe,CAAC"}

package/dist/qvac/parse.d.ts

@@ -0,0 +1,44 @@
+/** Structural subset of a QVAC `completion().final` we depend on. */
+export interface QvacFinalLike {
+    /** Visible assistant text (excludes `<think>` reasoning). */
+    contentText?: string;
+    /** Raw assistant frame, incl. tool-call framing, for history push-back. */
+    raw?: {
+        fullText?: string;
+    };
+    /** Tool calls the model requested this turn (empty ⇒ final answer). */
+    toolCalls?: Array<{
+        id?: string;
+        name: string;
+        arguments?: Record<string, unknown>;
+    }>;
+    /**
+     * Why generation stopped. QVAC 0.13 emits `"length"` when the token budget is
+     * exhausted, `"cancelled"` on abort, `undefined` on a natural stop. We surface
+     * it so the funnel can tell a truncated tool-call from a complete one.
+     */
+    stopReason?: 'length' | 'cancelled' | string;
+}
+export interface ParsedTurn {
+    /** Cleaned assistant content for display. */
+    text: string;
+    /** Raw assistant frame to push back into history for the next turn. */
+    rawContent: string;
+    /** Tool calls the model requested (arguments defaulted to `{}`). */
+    toolCalls: Array<{
+        id?: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+    /** True when generation was cut off by the token budget (incomplete output). */
+    truncated: boolean;
+    /** Raw stop reason from the SDK, when provided. */
+    stopReason?: string;
+}
+/**
+ * Map a completion `final` (plus the streamed fallback text) into a ParsedTurn.
+ * `rawContent` prefers the SDK's framed `raw.fullText` so the Engine can anchor
+ * the next turn; falls back to the visible text when a provider has no raw form.
+ */
+export declare function finalToTurn(final: QvacFinalLike, streamed?: string): ParsedTurn;
+//# sourceMappingURL=parse.d.ts.map

package/dist/qvac/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/qvac/parse.ts"],"names":[],"mappings":"AAQA,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,uEAAuE;IACvE,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACtF;;;;OAIG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;CAC9C;AAED,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACpF,gFAAgF;IAChF,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,SAAK,GAAG,UAAU,CAc3E"}

package/dist/qvac/parse.js

@@ -0,0 +1,28 @@
+/**
+ * Pure mapping from a QVAC completion `final` frame to the shape the shared
+ * @kaleidorg/mind Engine consumes. Kept SDK-free (structural input type) so it
+ * is testable without loading a model, and so the same mapping runs on mobile,
+ * desktop, and the eval harness.
+ */
+import { cleanAssistantVisibleText } from './text.js';
+/**
+ * Map a completion `final` (plus the streamed fallback text) into a ParsedTurn.
+ * `rawContent` prefers the SDK's framed `raw.fullText` so the Engine can anchor
+ * the next turn; falls back to the visible text when a provider has no raw form.
+ */
+export function finalToTurn(final, streamed = '') {
+    const rawText = final.contentText || streamed;
+    const text = cleanAssistantVisibleText(rawText);
+    return {
+        text,
+        rawContent: final.raw?.fullText ?? rawText,
+        toolCalls: (final.toolCalls ?? []).map((c) => ({
+            id: c.id,
+            name: c.name,
+            arguments: c.arguments ?? {},
+        })),
+        truncated: final.stopReason === 'length',
+        stopReason: final.stopReason,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/dist/qvac/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/qvac/parse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AA+BtD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAoB,EAAE,QAAQ,GAAG,EAAE;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC;IAC9C,MAAM,IAAI,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO;QACL,IAAI;QACJ,UAAU,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,IAAI,OAAO;QAC1C,SAAS,EAAE,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;SAC7B,CAAC,CAAC;QACH,SAAS,EAAE,KAAK,CAAC,UAAU,KAAK,QAAQ;QACxC,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC"}

package/dist/qvac/provider.d.ts

@@ -0,0 +1,49 @@
+/**
+ * createQvacProvider — turns `@qvac/sdk` `completion()` into the shared
+ * `@kaleidorg/mind` `LLMProvider` the Engine/Funnel consumes. This is the one
+ * place the SDK is called for inference; every host (rate, desktop provider,
+ * cli) uses it instead of hand-rolling its own completion wrapper.
+ *
+ * The SDK functions are *injected*, not imported, so this package carries no
+ * runtime dependency on `@qvac/sdk` (the import below is type-only and erased).
+ * Hosts pass their own `completion`/`cancel` — rate the static RN import, the
+ * desktop sidecar its lazily-loaded SDK facade — which also makes this provider
+ * unit-testable with a fake completion.
+ *
+ * The host owns model lifecycle (load/unload, local-vs-delegated) and passes
+ * `getModelId()` so a turn always runs against the currently-loaded model.
+ * Tools are forwarded by schema only; the Engine executes them via its
+ * ToolSources, so signing/spending stays on the host even when inference is
+ * delegated to a desktop peer.
+ */
+import type * as QvacSdk from '@qvac/sdk';
+import type { LLMProvider, TurnInput } from '../providers/types.js';
+type CompletionFn = typeof QvacSdk.completion;
+type CancelFn = typeof QvacSdk.cancel;
+export interface QvacProviderOptions {
+    /** The SDK's `completion` (injected — see module docs). */
+    completion: CompletionFn;
+    /** The SDK's `cancel` (injected). */
+    cancel: CancelFn;
+    /** Resolve the loaded model id for this turn (null ⇒ not loaded → throws). */
+    getModelId: () => string | null;
+    /**
+     * Default sampling temperature. Omit to leave it to the SDK/model default —
+     * `generationParams` is only sent when a temperature or max-tokens is set, so
+     * a host that passes neither preserves the SDK's own defaults.
+     */
+    defaultTemperature?: number;
+    /** Default max output tokens — caps a turn so it can't ramble. Omit for uncapped. */
+    defaultMaxTokens?: number;
+    /** Stream the model's `<think>` reasoning, when a host wants to surface it. */
+    onThinking?: (token: string) => void;
+}
+/** TurnInput plus the per-call knobs the funnel/voice paths pass through. */
+export interface QvacTurnInput extends TurnInput {
+    temperature?: number;
+    maxTokens?: number;
+    onThinking?: (token: string) => void;
+}
+export declare function createQvacProvider(options: QvacProviderOptions): LLMProvider;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/qvac/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/qvac/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,KAAK,OAAO,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAc,MAAM,uBAAuB,CAAC;AAGhF,KAAK,YAAY,GAAG,OAAO,OAAO,CAAC,UAAU,CAAC;AAC9C,KAAK,QAAQ,GAAG,OAAO,OAAO,CAAC,MAAM,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,UAAU,EAAE,YAAY,CAAC;IACzB,qCAAqC;IACrC,MAAM,EAAE,QAAQ,CAAC;IACjB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,CAwE5E"}