@kaleidorg/mind 0.3.0 → 0.5.0

package/dist/qvac/stream.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Consume a QVAC `completion()` run: drain the event stream (forwarding visible
+ * + thinking tokens) and fold the `final` frame into a ParsedTurn.
+ *
+ * Defined over a structural `CompletionRunLike` (not the SDK type) so it stays
+ * SDK-free and unit-testable with a fake run — the real `CompletionRun` is
+ * assignable to it. The actual `@qvac/sdk` import lives in `provider.ts`.
+ */
+import { type ParsedTurn, type QvacFinalLike } from './parse.js';
+/** Minimal shape of a QVAC completion event we react to. */
+export interface CompletionEventLike {
+    type: string;
+    /** Present on `contentDelta` / `thinkingDelta` / `rawDelta`. */
+    text?: string;
+}
+/** Structural subset of `completion()`'s return we depend on. */
+export interface CompletionRunLike {
+    requestId: string;
+    events: AsyncIterable<CompletionEventLike>;
+    final: Promise<QvacFinalLike>;
+}
+export interface StreamHandlers {
+    /** Visible assistant tokens (excludes `<think>` reasoning). */
+    onToken?: (token: string) => void;
+    /** The model's `<think>` reasoning, streamed separately. */
+    onThinking?: (token: string) => void;
+}
+export interface ConsumedTurn extends ParsedTurn {
+    requestId: string;
+}
+/**
+ * Stream a run to completion. `contentDelta` → onToken (and the streamed
+ * fallback text), `thinkingDelta` → onThinking. Returns the parsed turn plus the
+ * run's `requestId` (for cancellation bookkeeping by the caller).
+ */
+export declare function consumeRun(run: CompletionRunLike, handlers?: StreamHandlers): Promise<ConsumedTurn>;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/qvac/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAe,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9E,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,iBAAiB,EACtB,QAAQ,GAAE,cAAmB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAYvB"}

package/dist/qvac/stream.js

@@ -0,0 +1,29 @@
+/**
+ * Consume a QVAC `completion()` run: drain the event stream (forwarding visible
+ * + thinking tokens) and fold the `final` frame into a ParsedTurn.
+ *
+ * Defined over a structural `CompletionRunLike` (not the SDK type) so it stays
+ * SDK-free and unit-testable with a fake run — the real `CompletionRun` is
+ * assignable to it. The actual `@qvac/sdk` import lives in `provider.ts`.
+ */
+import { finalToTurn } from './parse.js';
+/**
+ * Stream a run to completion. `contentDelta` → onToken (and the streamed
+ * fallback text), `thinkingDelta` → onThinking. Returns the parsed turn plus the
+ * run's `requestId` (for cancellation bookkeeping by the caller).
+ */
+export async function consumeRun(run, handlers = {}) {
+    let streamed = '';
+    for await (const event of run.events) {
+        if (event.type === 'contentDelta' && typeof event.text === 'string') {
+            streamed += event.text;
+            handlers.onToken?.(event.text);
+        }
+        else if (event.type === 'thinkingDelta' && typeof event.text === 'string') {
+            handlers.onThinking?.(event.text);
+        }
+    }
+    const final = await run.final;
+    return { ...finalToTurn(final, streamed), requestId: run.requestId };
+}
+//# sourceMappingURL=stream.js.map

package/dist/qvac/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/qvac/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAuC,MAAM,YAAY,CAAC;AA2B9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAsB,EACtB,WAA2B,EAAE;IAE7B,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpE,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC;YACvB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5E,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC;IAC9B,OAAO,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;AACvE,CAAC"}

package/dist/qvac/text.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure text helpers for QVAC output. No SDK, no platform — safe to run and test
+ * anywhere. Lifted verbatim from rate's QVACService so every host shares one
+ * implementation instead of drifting copies.
+ */
+/**
+ * Clean a raw assistant completion into user-visible text:
+ *  - drop `<think>…</think>` reasoning (small models leak it into content),
+ *  - drop a leading `{"name":…,"arguments":…}` tool-call object some tiny models
+ *    emit as plain text, keeping any natural-language sentence that follows.
+ */
+export declare function cleanAssistantVisibleText(text: string): string;
+/**
+ * Make text safe for the SUPERTONIC TTS model: redact payment strings (so they
+ * are never read aloud), strip markdown/code, normalize smart punctuation, and
+ * drop any non-ASCII or backtick (U+0060) the model can't synthesize.
+ */
+export declare function sanitizeForSupertonic(text: string): string;
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/qvac/text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB9D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsB1D"}

package/dist/qvac/text.js

@@ -0,0 +1,56 @@
+/**
+ * Pure text helpers for QVAC output. No SDK, no platform — safe to run and test
+ * anywhere. Lifted verbatim from rate's QVACService so every host shares one
+ * implementation instead of drifting copies.
+ */
+/**
+ * Clean a raw assistant completion into user-visible text:
+ *  - drop `<think>…</think>` reasoning (small models leak it into content),
+ *  - drop a leading `{"name":…,"arguments":…}` tool-call object some tiny models
+ *    emit as plain text, keeping any natural-language sentence that follows.
+ */
+export function cleanAssistantVisibleText(text) {
+    let cleaned = text
+        // Qwen-style reasoning sometimes arrives in contentText. Never show/speak it.
+        .replace(/<think\b[\s\S]*?<\/think>/gi, ' ')
+        .replace(/<think\b[\s\S]*$/gi, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+    // Some small local models emit a tool-call object as plain text. Drop the
+    // leading fragment and keep any natural-language sentence that follows.
+    const toolPrefix = cleaned.match(/^\s*\{?\s*"name"\s*:\s*"[^"]+"\s*,\s*"arguments"\s*:\s*/i);
+    if (toolPrefix) {
+        cleaned = cleaned.slice(toolPrefix[0].length).replace(/^\s*\{?\s*/, '').trim();
+    }
+    return cleaned
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Make text safe for the SUPERTONIC TTS model: redact payment strings (so they
+ * are never read aloud), strip markdown/code, normalize smart punctuation, and
+ * drop any non-ASCII or backtick (U+0060) the model can't synthesize.
+ */
+export function sanitizeForSupertonic(text) {
+    const normalized = text
+        .replace(/\b(?:lightning:)?ln(?:bc|tb|bcrt)[a-z0-9]{40,}\b/gi, 'Lightning invoice')
+        .replace(/\blnurl[0-9a-z]{40,}\b/gi, 'Lightning payment link')
+        .replace(/```[\s\S]*?```/g, ' ')
+        .replace(/`([^`]*)`/g, '$1')
+        .replace(/[`´ˋ′*_~#<>|[\]{}]/g, ' ')
+        .replace(/[“”]/g, '"')
+        .replace(/[‘’]/g, "'")
+        .replace(/[•·]/g, '. ')
+        .replace(/[^\x09\x0A\x0D\x20-\x7E]/g, ' ')
+        .replace(/\s+/g, ' ');
+    return Array.from(normalized)
+        .filter((ch) => {
+        const code = ch.charCodeAt(0);
+        return (code === 0x09 || code === 0x0A || code === 0x0D || (code >= 0x20 && code <= 0x7E)) &&
+            code !== 0x60;
+    })
+        .join('')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=text.js.map

package/dist/qvac/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/qvac/text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,IAAI,OAAO,GAAG,IAAI;QAChB,8EAA8E;SAC7E,OAAO,CAAC,6BAA6B,EAAE,GAAG,CAAC;SAC3C,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC;SAClC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IAEV,0EAA0E;IAC1E,wEAAwE;IACxE,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC7F,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjF,CAAC;IAED,OAAO,OAAO;SACX,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,UAAU,GAAG,IAAI;SACpB,OAAO,CAAC,oDAAoD,EAAE,mBAAmB,CAAC;SAClF,OAAO,CAAC,0BAA0B,EAAE,wBAAwB,CAAC;SAC7D,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;SAC3B,OAAO,CAAC,qBAAqB,EAAE,GAAG,CAAC;SACnC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,2BAA2B,EAAE,GAAG,CAAC;SACzC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAExB,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;SAC1B,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC;YACxF,IAAI,KAAK,IAAI,CAAC;IAClB,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC;SACR,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/qvac/voice.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Voice runtime ops shared across hosts: one-shot transcription (Whisper) and
+ * speech synthesis (SUPERTONIC TTS). Like the provider, the SDK functions are
+ * injected (type-only `@qvac/sdk` import, erased at build) so this carries no
+ * runtime SDK dependency and is unit-testable with fakes.
+ *
+ * The host still owns model lifecycle (download, load, local-vs-delegated) and
+ * audio I/O (mic capture, playback). It passes the loaded model-id resolvers;
+ * this module does the SDK calls + the text gating that must be identical
+ * everywhere (payment-string redaction, U+0060 refusal, file:// stripping).
+ *
+ * The streaming voice-assistant loop (transcribeStream + VAD) builds on top of
+ * these in a later pass.
+ */
+import type * as QvacSdk from '@qvac/sdk';
+import type { VoiceTranscriptEvent } from './assistant.js';
+type TranscribeFn = typeof QvacSdk.transcribe;
+type TextToSpeechFn = typeof QvacSdk.textToSpeech;
+type TranscribeStreamFn = typeof QvacSdk.transcribeStream;
+/** 16-bit PCM samples plus their sample rate, ready for the host to play. */
+export interface PcmAudio {
+    pcm: number[];
+    sampleRate: number;
+}
+/**
+ * A live VAD transcription session: feed mic audio with `write()`, iterate to
+ * receive `text`/`vad`/`endOfTurn` events, `end()` when audio stops. Pass it
+ * straight to `runVoiceAssistant`.
+ */
+export interface VoiceSession {
+    write(audioChunk: Uint8Array): void;
+    end(): void;
+    destroy(): void;
+    [Symbol.asyncIterator](): AsyncIterator<VoiceTranscriptEvent>;
+}
+export interface QvacVoiceOptions {
+    /** The SDK's `transcribe` (injected). */
+    transcribe: TranscribeFn;
+    /** The SDK's `textToSpeech` (injected). */
+    textToSpeech: TextToSpeechFn;
+    /** The SDK's `transcribeStream` (injected) — only needed for `openVoiceSession`. */
+    transcribeStream?: TranscribeStreamFn;
+    /** Resolve the loaded Whisper model id (null ⇒ not loaded → throws). */
+    getWhisperModelId: () => string | null;
+    /** Resolve the loaded TTS model id (null ⇒ not loaded → returns null). */
+    getTtsModelId: () => string | null;
+    /** TTS output sample rate; defaults to SUPERTONIC-2's 44.1 kHz. */
+    ttsSampleRate?: number;
+}
+export interface QvacVoice {
+    /** Transcribe an audio file (path or `file://` URI) to text. */
+    transcribeAudio(audioUri: string): Promise<string>;
+    /**
+     * Synthesize speech for `text`. Returns PCM + sample rate, or `null` when TTS
+     * is unavailable or the text is empty after sanitization (host falls back to
+     * the system voice). Payment strings are redacted so they're never read aloud.
+     */
+    synthesizeSpeech(text: string): Promise<PcmAudio | null>;
+    /**
+     * Open a hands-free VAD transcription session (continuous voice). Requires
+     * `transcribeStream` to have been provided. Merge in `paramsOverride` to tune
+     * the defaults ({@link DEFAULT_VOICE_STREAM_PARAMS}). Feed the returned session
+     * to `runVoiceAssistant`.
+     */
+    openVoiceSession(paramsOverride?: Record<string, unknown>): Promise<VoiceSession>;
+}
+export declare function createQvacVoice(options: QvacVoiceOptions): QvacVoice;
+export {};
+//# sourceMappingURL=voice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/qvac/voice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,KAAK,OAAO,MAAM,WAAW,CAAC;AAG1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,KAAK,YAAY,GAAG,OAAO,OAAO,CAAC,UAAU,CAAC;AAC9C,KAAK,cAAc,GAAG,OAAO,OAAO,CAAC,YAAY,CAAC;AAClD,KAAK,kBAAkB,GAAG,OAAO,OAAO,CAAC,gBAAgB,CAAC;AAE1D,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,GAAG,IAAI,IAAI,CAAC;IACZ,OAAO,IAAI,IAAI,CAAC;IAChB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,oBAAoB,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,UAAU,EAAE,YAAY,CAAC;IACzB,2CAA2C;IAC3C,YAAY,EAAE,cAAc,CAAC;IAC7B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;IACtC,wEAAwE;IACxE,iBAAiB,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACvC,0EAA0E;IAC1E,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACzD;;;;;OAKG;IACH,gBAAgB,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA+CpE"}

package/dist/qvac/voice.js

@@ -0,0 +1,51 @@
+import { sanitizeForSupertonic } from './text.js';
+import { TTS_SAMPLE_RATE, DEFAULT_VOICE_STREAM_PARAMS } from './config.js';
+export function createQvacVoice(options) {
+    const sampleRate = options.ttsSampleRate ?? TTS_SAMPLE_RATE;
+    return {
+        async transcribeAudio(audioUri) {
+            const modelId = options.getWhisperModelId();
+            if (!modelId)
+                throw new Error('Whisper model not loaded');
+            // The SDK's native file reader wants a plain filesystem path, not a
+            // `file://` URI — the URI raises AUDIO_FILE_NOT_FOUND even when present.
+            const audioChunk = audioUri.replace('file://', '');
+            return await options.transcribe({ modelId, audioChunk });
+        },
+        async synthesizeSpeech(text) {
+            const modelId = options.getTtsModelId();
+            if (!modelId)
+                return null;
+            const trimmed = sanitizeForSupertonic(text);
+            if (!trimmed)
+                return null;
+            // Belt-and-suspenders: SUPERTONIC chokes on U+0060; sanitize already
+            // strips it, so refuse if any slipped through rather than crash the voice.
+            if (Array.from(trimmed).some((ch) => ch.charCodeAt(0) === 0x60))
+                return null;
+            const result = options.textToSpeech({
+                modelId,
+                text: trimmed,
+                inputType: 'text',
+                stream: false,
+            });
+            const pcm = await result.buffer;
+            return { pcm, sampleRate };
+        },
+        async openVoiceSession(paramsOverride = {}) {
+            if (!options.transcribeStream) {
+                throw new Error('transcribeStream not provided — pass it in QvacVoiceOptions for voice sessions');
+            }
+            const modelId = options.getWhisperModelId();
+            if (!modelId)
+                throw new Error('Whisper model not loaded');
+            const session = await options.transcribeStream({
+                modelId,
+                ...DEFAULT_VOICE_STREAM_PARAMS,
+                ...paramsOverride,
+            });
+            return session;
+        },
+    };
+}
+//# sourceMappingURL=voice.js.map

package/dist/qvac/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../src/qvac/voice.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AA0D3E,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,IAAI,eAAe,CAAC;IAE5D,OAAO;QACL,KAAK,CAAC,eAAe,CAAC,QAAgB;YACpC,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC1D,oEAAoE;YACpE,yEAAyE;YACzE,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACnD,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,UAAU,EAAiC,CAAC,CAAC;QAC1F,CAAC;QAED,KAAK,CAAC,gBAAgB,CAAC,IAAY;YACjC,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;YACxC,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAE1B,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAC1B,qEAAqE;YACrE,2EAA2E;YAC3E,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YAE7E,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;gBAClC,OAAO;gBACP,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,KAAK;aACmB,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YAChC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,gBAAgB,CAAC,iBAA0C,EAAE;YACjE,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;YACpG,CAAC;YACD,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC;gBAC7C,OAAO;gBACP,GAAG,2BAA2B;gBAC9B,GAAG,cAAc;aACmB,CAAC,CAAC;YACxC,OAAO,OAAkC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/recipe/buy-asset-channel.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Built-in "buy an asset channel" recipe — the onboarding buy.
+ *
+ * The user has on-chain BTC but no Lightning channel yet, and wants to HOLD an
+ * RGB asset (USDT, XAUT). They can't swap (no channel to swap inside), so they
+ * buy a NEW channel from the maker LSP pre-loaded with the asset. One quote,
+ * one spend:
+ *
+ *   "buy 100 usdt"  /  "get me 50 xaut"  /  "i want 200 usdt"
+ *     ↓ 1 model inference (slot extraction; 0 when the regex hits)
+ *   kaleidoswap_lsp_quote_asset_channel    ← maker prices the asset + channel
+ *   kaleidoswap_lsp_create_asset_channel 🔒 ← (final) order it; pay to open
+ *
+ * Distinct from `swapRecipe`: a swap names a source asset ("swap 10 usdt FOR
+ * btc", "buy btc WITH usdt") and needs an existing channel. This is the
+ * no-source, no-channel onboarding path — "buy <amount> <asset>" with nothing
+ * to spend it from — so it must be SELECTED BEFORE swap for that phrasing.
+ *
+ * Opt-in: register via `Funnel.recipes` (like `kaleidoswapAtomicRecipe`). The
+ * host binds `kaleidoswap_lsp_*` to its transport (maker REST / MCP / WDK).
+ */
+import type { Recipe } from './types.js';
+/** "buy 100 usdt" / "get me 50 xaut" / "i want 200 usdt" / "purchase 10 xaut". */
+export declare function extractBuyAsset(text: string): Record<string, unknown> | null;
+export declare const buyAssetChannelRecipe: Recipe;
+//# sourceMappingURL=buy-asset-channel.d.ts.map

package/dist/recipe/buy-asset-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buy-asset-channel.d.ts","sourceRoot":"","sources":["../../src/recipe/buy-asset-channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AA4BzC,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAW5E;AAED,eAAO,MAAM,qBAAqB,EAAE,MAqDnC,CAAC"}

package/dist/recipe/buy-asset-channel.js

@@ -0,0 +1,112 @@
+/**
+ * Built-in "buy an asset channel" recipe — the onboarding buy.
+ *
+ * The user has on-chain BTC but no Lightning channel yet, and wants to HOLD an
+ * RGB asset (USDT, XAUT). They can't swap (no channel to swap inside), so they
+ * buy a NEW channel from the maker LSP pre-loaded with the asset. One quote,
+ * one spend:
+ *
+ *   "buy 100 usdt"  /  "get me 50 xaut"  /  "i want 200 usdt"
+ *     ↓ 1 model inference (slot extraction; 0 when the regex hits)
+ *   kaleidoswap_lsp_quote_asset_channel    ← maker prices the asset + channel
+ *   kaleidoswap_lsp_create_asset_channel 🔒 ← (final) order it; pay to open
+ *
+ * Distinct from `swapRecipe`: a swap names a source asset ("swap 10 usdt FOR
+ * btc", "buy btc WITH usdt") and needs an existing channel. This is the
+ * no-source, no-channel onboarding path — "buy <amount> <asset>" with nothing
+ * to spend it from — so it must be SELECTED BEFORE swap for that phrasing.
+ *
+ * Opt-in: register via `Funnel.recipes` (like `kaleidoswapAtomicRecipe`). The
+ * host binds `kaleidoswap_lsp_*` to its transport (maker REST / MCP / WDK).
+ */
+/** RGB assets the maker sells as an asset channel. BTC is never "bought" this way. */
+const RGB_ASSET = /\b(usdt|tether|xaut|gold)\b/i;
+/** A named funding source ⇒ this is a swap, not an onboarding buy. */
+const HAS_SOURCE = /\b(?:with|using|from)\b|\bfor\s+(?:btc|bitcoin|sats?|usdt|xaut|tether|gold)\b/i;
+/** Verbs other intents own (swap / sell / send) — never an onboarding buy. */
+const NOT_BUY = /\b(swap|exchange|convert|trade|sell|send)\b/i;
+/** Acquire verbs that DO mean an onboarding buy. */
+const BUY_VERB = /\b(buy|get|acquire|want|purchase|onboard|need)\b/i;
+function normAsset(a) {
+    if (!a)
+        return undefined;
+    const x = a.toLowerCase();
+    if (/usdt|tether/.test(x))
+        return 'USDT';
+    if (/xaut|gold/.test(x))
+        return 'XAUT';
+    return undefined;
+}
+const num = (s) => {
+    if (!s)
+        return undefined;
+    const n = Number(s.replace(/,/g, ''));
+    return Number.isFinite(n) ? n : undefined;
+};
+/** Thousands separators, locale-independent (deterministic for tests). */
+const commas = (n) => String(n).replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+/** "buy 100 usdt" / "get me 50 xaut" / "i want 200 usdt" / "purchase 10 xaut". */
+export function extractBuyAsset(text) {
+    const t = text.trim();
+    if (NOT_BUY.test(t) || HAS_SOURCE.test(t))
+        return null;
+    if (!RGB_ASSET.test(t))
+        return null;
+    // buy/get/want/acquire/purchase [me] <amount> <asset>
+    const m = t.match(/\b(?:buy|get|acquire|want|purchase|onboard|need)\b(?:\s+me)?\s+([\d.,]+)\s*([a-z]+)/i);
+    if (!m)
+        return null;
+    const asset = normAsset(m[2]);
+    const amount = num(m[1]);
+    if (!asset || amount === undefined)
+        return null;
+    return { asset, asset_amount: amount };
+}
+export const buyAssetChannelRecipe = {
+    name: 'buy-asset-channel',
+    description: 'Onboarding buy: purchase a new Lightning channel pre-loaded with an RGB asset (USDT, XAUT) from the maker LSP — for a user with on-chain BTC but no channel yet. Quote, then order (with confirmation).',
+    // "buy/get/want N <rgb-asset>" with NO named source asset and NO swap/send verb.
+    match: (t) => !NOT_BUY.test(t) && !HAS_SOURCE.test(t) && RGB_ASSET.test(t) && BUY_VERB.test(t),
+    triggers: ['buy', 'get', 'purchase', 'acquire'],
+    slots: [
+        { name: 'asset', type: 'string', description: 'RGB asset to acquire (USDT or XAUT)', required: true },
+        { name: 'asset_amount', type: 'number', description: 'Amount of the asset to load into the channel (display units, e.g. 100)', required: true },
+    ],
+    extract: extractBuyAsset,
+    confident: (s) => !!s.asset && s.asset_amount !== undefined && Number(s.asset_amount) > 0,
+    steps: [
+        // 1. Maker prices the asset + the channel.
+        //    Returns { rfq_id, btc_amount_sat, channel_fee_sat, total_sat, expires_at }.
+        {
+            tool: 'kaleidoswap_lsp_quote_asset_channel',
+            as: 'quote',
+            args: (ctx) => ({ asset: ctx.slots.asset, asset_amount: ctx.slots.asset_amount }),
+        },
+    ],
+    // 2. Order the channel with the fresh rfq_id. Spend → confirmation-gated.
+    //    The quote's cost fields ride along so the host's confirm card can show
+    //    the price before approval; the create tool treats them as display-only.
+    final: {
+        tool: 'kaleidoswap_lsp_create_asset_channel',
+        args: (ctx) => {
+            const q = (ctx.results.quote ?? {});
+            return {
+                asset: ctx.slots.asset,
+                asset_amount: ctx.slots.asset_amount,
+                rfq_id: q.rfq_id,
+                total_sat: q.total_sat,
+                btc_amount_sat: q.btc_amount_sat,
+                channel_fee_sat: q.channel_fee_sat,
+                expires_at: q.expires_at,
+            };
+        },
+    },
+    summary: (ctx, finalResult) => {
+        const q = ctx.results.quote;
+        const o = finalResult;
+        const cost = typeof q?.total_sat === 'number' ? ` for ${commas(q.total_sat)} sats` : '';
+        const id = o?.order_id ? ` (order ${o.order_id})` : '';
+        return `Ordered a Lightning channel with ${ctx.slots.asset_amount} ${ctx.slots.asset}${cost}${id}. Pay the returned invoice/address to open it.`;
+    },
+};
+//# sourceMappingURL=buy-asset-channel.js.map

package/dist/recipe/buy-asset-channel.js.map

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

package/dist/recipe/kaleidoswap-atomic.d.ts

@@ -1,26 +1,34 @@
 /**
- * Built-in "atomic swap on KaleidoSwap" recipe — trust-minimised chain.
+ * Built-in "swap on KaleidoSwap" recipe — the real atomic-swap chain.
  *
- * Most users want the simple market-order swap (`swapRecipe` over generic
- * `get_swap_quote` / `execute_swap`). This recipe is the EXPLICIT atomic path:
- * the user creates an RGB/LN receive invoice, the maker locks the swap, the
- * user pays the maker's Lightning invoice, and the maker releases.
+ * A swap (especially the full maker + RLN atomic) is a 6-step, two-service flow
+ * no small model can plan reliably, so the recipe carries the plan. The model
+ * is used for natural-language understanding of the request (slot extraction).
  *
- * Triggered only by explicit atomic-swap intent ("atomic swap", "trustless
- * swap", "htlc swap") so it never preempts the simpler swap path for vague
- * phrasings.
+ *   "buy 1 usdt"  (or "swap 10 usdt to btc")
+ *     ↓ heuristic pre-filter (0 inf) decides to enter the reliable recipe branch
+ *     ↓ 1 model inference (forced LLM slot extraction — the model parses intent)
+ *   kaleidoswap_get_quote        ← MAKER  prices the swap (read-only)
+ *     ↓ [ONE confirmation gate — shows the real quote numbers]
+ *   kaleidoswap_atomic_init      ← MAKER  locks the swap → swapstring, payment_hash
+ *   rln_get_node_info            ← NODE   read pubkey (= taker_pubkey)
+ *   rln_whitelist_swap           ← NODE   accept the swapstring
+ *   kaleidoswap_atomic_execute   ← MAKER  settle (final)
  *
- *   "atomic swap 100000 sats for usdt"
- *     ↓ 1 model inference (slot extraction)
- *   kaleidoswap_get_quote        ← maker prices the swap
- *   rln_create_rgb_invoice       ← user's node prepares receive (if to_asset is RGB)
- *   rln_create_ln_invoice        ← (alt) if to_asset is BTC
- *   kaleidoswap_atomic_init  🔒 ← maker locks the swap, returns its invoice
- *   rln_pay_invoice          🔒 ← user pays the maker
- *   kaleidoswap_atomic_execute 🔒 ← (final) maker releases the asset
+ * `forceModelExtract` ensures the model is always consulted for slot parsing
+ * (1 inference) so natural language like "buy 1 usdt" is interpreted by the LLM.
+ * A safety fallback in the runner uses the deterministic extractor if the model
+ * returns incomplete slots. The execution sequence + single-confirm gate remain
+ * fully deterministic and reliable.
  *
- * Two-or-three confirmation gates are intentional: each represents a distinct
- * decision point. The host's confirm UI describes what's about to happen.
+ * Status is NOT polled here — settlement takes seconds-to-minutes and blocking
+ * the chat is bad UX. The recipe reports "submitted, settling"; the user (or a
+ * follow-up turn) calls `kaleidoswap_atomic_status` on demand.
+ *
+ * Confirmation: the single decision a user makes is "given this quote, proceed?"
+ * — so the recipe declares ONE `confirm(ctx)` summary, fired after the quote and
+ * before init. init/whitelist/execute then run as one approved unit. (The
+ * runner's recipe-level confirm path handles this; see recipe/runner.ts.)
  */
 import type { Recipe } from './types.js';
 export declare const kaleidoswapAtomicRecipe: Recipe;

package/dist/recipe/kaleidoswap-atomic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kaleidoswap-atomic.d.ts","sourceRoot":"","sources":["../../src/recipe/kaleidoswap-atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAUzC,eAAO,MAAM,uBAAuB,EAAE,MAiFrC,CAAC"}
+{"version":3,"file":"kaleidoswap-atomic.d.ts","sourceRoot":"","sources":["../../src/recipe/kaleidoswap-atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAC;AAkCxD,eAAO,MAAM,uBAAuB,EAAE,MA+FrC,CAAC"}