@kaleidorg/mind 0.4.0 → 0.5.1

package/dist/qvac/parse.js

@@ -5,22 +5,85 @@
  * desktop, and the eval harness.
  */
 import { cleanAssistantVisibleText } from './text.js';
+/** Parse the first balanced `{…}` from a string as a `{name, arguments}` call. */
+function parseCallObject(s) {
+    const start = s.indexOf('{');
+    if (start < 0)
+        return null;
+    let depth = 0;
+    for (let i = start; i < s.length; i++) {
+        const ch = s[i];
+        if (ch === '{')
+            depth++;
+        else if (ch === '}' && --depth === 0) {
+            try {
+                const obj = JSON.parse(s.slice(start, i + 1));
+                if (obj && typeof obj.name === 'string') {
+                    const args = obj.arguments && typeof obj.arguments === 'object'
+                        ? obj.arguments
+                        : {};
+                    return { name: obj.name, arguments: args };
+                }
+            }
+            catch {
+                /* malformed JSON — give up on this fragment */
+            }
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Recover tool calls a model emitted as PLAIN TEXT instead of structured frames
+ * — `<tool_call>{"name":…,"arguments":…}</tool_call>` (Qwen/Hermes) or a bare
+ * leading `{"name":…,"arguments":…}`. Small local models (and SDK builds that
+ * don't apply the tool grammar) do this; without recovery the call leaks into
+ * the visible answer and never runs.
+ */
+export function extractTextToolCalls(text) {
+    const calls = [];
+    for (const m of text.matchAll(/<tool_call\b[^>]*>([\s\S]*?)<\/tool_call>/gi)) {
+        const c = parseCallObject(m[1] ?? '');
+        if (c)
+            calls.push(c);
+    }
+    if (calls.length)
+        return calls;
+    // No tags — accept a bare tool-call object only at the very start of the
+    // text (so we don't misread JSON the model is merely talking about).
+    if (/^\s*\{?\s*"name"\s*:/i.test(text)) {
+        const c = parseCallObject(text);
+        if (c)
+            calls.push(c);
+    }
+    return calls;
+}
 /**
  * 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.
+ *
+ * When the SDK reports no structured tool calls, we re-scan the raw text for
+ * tool calls the model emitted inline (see `extractTextToolCalls`) so they still
+ * execute instead of leaking into the chat.
  */
 export function finalToTurn(final, streamed = '') {
     const rawText = final.contentText || streamed;
     const text = cleanAssistantVisibleText(rawText);
+    let toolCalls = (final.toolCalls ?? []).map((c) => ({
+        id: c.id,
+        name: c.name,
+        arguments: c.arguments ?? {},
+    }));
+    if (toolCalls.length === 0) {
+        const recovered = extractTextToolCalls(final.raw?.fullText ?? rawText);
+        if (recovered.length)
+            toolCalls = recovered.map((c) => ({ id: undefined, ...c }));
+    }
     return {
         text,
         rawContent: final.raw?.fullText ?? rawText,
-        toolCalls: (final.toolCalls ?? []).map((c) => ({
-            id: c.id,
-            name: c.name,
-            arguments: c.arguments ?? {},
-        })),
+        toolCalls,
         truncated: final.stopReason === 'length',
         stopReason: final.stopReason,
     };

package/dist/qvac/parse.js.map

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

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

@@ -1 +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"}
+{"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,CAsB9D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsB1D"}

package/dist/qvac/text.js

@@ -14,6 +14,10 @@ export function cleanAssistantVisibleText(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, ' ')
+        // Tool calls some models emit as text (<tool_call>{…}</tool_call>) are
+        // extracted + executed by the Engine (see parse.ts); never show the tags.
+        .replace(/<tool_call\b[^>]*>[\s\S]*?<\/tool_call>/gi, ' ')
+        .replace(/<tool_call\b[^>]*>[\s\S]*$/gi, ' ')
         .replace(/\s+/g, ' ')
         .trim();
     // Some small local models emit a tool-call object as plain text. Drop the

package/dist/qvac/text.js.map

@@ -1 +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"}
+{"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;QACnC,uEAAuE;QACvE,0EAA0E;SACzE,OAAO,CAAC,2CAA2C,EAAE,GAAG,CAAC;SACzD,OAAO,CAAC,8BAA8B,EAAE,GAAG,CAAC;SAC5C,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/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":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,sFAAsF;AACtF,MAAM,SAAS,GAAG,8BAA8B,CAAC;AACjD,sEAAsE;AACtE,MAAM,UAAU,GAAG,gFAAgF,CAAC;AACpG,8EAA8E;AAC9E,MAAM,OAAO,GAAG,8CAA8C,CAAC;AAC/D,oDAAoD;AACpD,MAAM,QAAQ,GAAG,mDAAmD,CAAC;AAErE,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1B,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,GAAG,GAAG,CAAC,CAAU,EAAsB,EAAE;IAC7C,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;AAEtF,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,sDAAsD;IACtD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAC1G,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAW;IAC3C,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,yMAAyM;IAC3M,iFAAiF;IACjF,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9F,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC;IAC/C,KAAK,EAAE;QACL,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE,QAAQ,EAAE,IAAI,EAAE;QACrG,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wEAAwE,EAAE,QAAQ,EAAE,IAAI,EAAE;KAChJ;IACD,OAAO,EAAE,eAAe;IACxB,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,YAAY,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC;IACzF,KAAK,EAAE;QACL,2CAA2C;QAC3C,iFAAiF;QACjF;YACE,IAAI,EAAE,qCAAqC;YAC3C,EAAE,EAAE,OAAO;YACX,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;SAClF;KACF;IACD,0EAA0E;IAC1E,4EAA4E;IAC5E,6EAA6E;IAC7E,KAAK,EAAE;QACL,IAAI,EAAE,sCAAsC;QAC5C,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;YACZ,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAMjC,CAAC;YACF,OAAO;gBACL,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK;gBACtB,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY;gBACpC,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,cAAc,EAAE,CAAC,CAAC,cAAc;gBAChC,eAAe,EAAE,CAAC,CAAC,eAAe;gBAClC,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC;QACJ,CAAC;KACF;IACD,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,KAA2C,CAAC;QAClE,MAAM,CAAC,GAAG,WAAgD,CAAC;QAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,oCAAoC,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,gDAAgD,CAAC;IACnJ,CAAC;CACF,CAAC"}

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

package/dist/recipe/kaleidoswap-atomic.js

@@ -1,46 +1,77 @@
 /**
- * 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 { extractSwap } from './swap.js';
-const ATOMIC_INTENT = /\b(atomic|trustless|htlc)\b.*\b(swap|exchange|convert|trade)\b|\b(swap|exchange|convert|trade)\b.*\b(atomic|trustless|htlc)\b/i;
-function isBtc(asset) {
-    return String(asset ?? '').toUpperCase() === 'BTC';
-}
+// Fire on swap intent — "swap/exchange/convert/trade", or "buy/sell/get" when a
+// crypto asset is named (so "buy one usdt" routes here, but "buy a gift card"
+// does not). PRICE / rate / "how much" questions are read-only and go to
+// `kaleidoswapPriceRecipe` instead — keep them out of this match.
+const ASSET = /\b(btc|bitcoin|sats?|usdt|tether|xaut|gold)\b/i;
+const SWAP_INTENT = (t) => {
+    // Explanatory / educational questions → route to RAG-backed agentic answer,
+    // not the deterministic spend chain.
+    if (/\b(why|how|what|when|explain|tell\s+me|do\s+I\s+need|should\s+I|can\s+I)\b/i.test(t))
+        return false;
+    if (/\b(swap|exchange|convert|trade)\b/i.test(t))
+        return true;
+    if (/\b(buy|sell|get|purchase|acquire)\b/i.test(t) &&
+        ASSET.test(t) &&
+        // Exclude commerce / receive / LSPS1 channel-order phrasings that share
+        // the buy/get verb. "Buy a USDT channel" is a channel order, not a swap.
+        !/\b(gift\s?card|top-?up|esim|voucher|invoice|address|channel|inbound|liquidity|lsps?\b)\b/i.test(t))
+        return true;
+    return false;
+};
 export const kaleidoswapAtomicRecipe = {
     name: 'kaleidoswap-atomic',
-    description: 'Trust-minimised atomic swap on KaleidoSwap: quote, prepare a receive invoice on the user\'s node, lock the swap with the maker, pay, and execute.',
-    match: (t) => ATOMIC_INTENT.test(t),
-    triggers: ['atomic swap', 'trustless swap', 'htlc swap'],
+    description: 'Swap between BTC and an RGB asset on KaleidoSwap: quote, confirm once, then init (maker) → whitelist (node) → execute (maker).',
+    match: (t) => SWAP_INTENT(t),
+    triggers: ['swap', 'exchange', 'convert', 'trade', 'buy', 'sell'],
     slots: [
         { name: 'from_asset', type: 'string', description: 'Asset to spend (BTC / USDT / XAUT)', required: true },
         { name: 'to_asset', type: 'string', description: 'Asset to receive (BTC / USDT / XAUT)', required: true },
-        { name: 'amount', type: 'number', description: 'Amount of from_asset to swap' },
+        { name: 'amount', type: 'number', description: 'The amount the user named' },
+        { name: 'amount_side', type: 'string', description: "Which leg the amount is on: 'from' (sell/swap) or 'to' (buy)" },
     ],
+    // Keep the fast `extract` for the Funnel's cheap pre-filter (so "buy 1 usdt"
+    // reliably enters the recipe branch instead of falling to free agentic).
+    // `forceModelExtract` makes runRecipe ignore the deterministic result and
+    // always ask the model to produce the actual slots used for execution.
     extract: extractSwap,
+    forceModelExtract: true,
     confident: (s) => !!s.from_asset && !!s.to_asset && !!s.amount,
     steps: [
-        // 1. Maker quotes the swap. Returns { quote_id, receive_amount, fees, ttl_ms, ... }.
+        // 1. MAKER quotes the swap (read-only). Returns rfq_id + full asset specs
+        //    (echoes the rgb: asset ids and maker-unit amounts) + *_display strings.
         {
             tool: 'kaleidoswap_get_quote',
             as: 'quote',
@@ -48,64 +79,71 @@ export const kaleidoswapAtomicRecipe = {
                 from_asset: ctx.slots.from_asset,
                 to_asset: ctx.slots.to_asset,
                 amount: ctx.slots.amount,
+                // 'to' for buy ("buy 1 USDT" → amount is what you RECEIVE); default
+                // 'from' for sell/swap. The host puts the amount on the right leg.
+                amount_side: ctx.slots.amount_side ?? 'from',
             }),
         },
-        // 2a. User's node creates an RGB receive invoice (when to_asset is an RGB asset).
-        {
-            tool: 'rln_create_rgb_invoice',
-            as: 'receive_rgb',
-            args: (ctx) => {
-                const q = ctx.results.quote;
-                return { asset: ctx.slots.to_asset, amount: q?.receive_amount };
-            },
-            skipIf: (ctx) => isBtc(ctx.slots.to_asset),
-        },
-        // 2b. User's node creates an LN receive invoice (when to_asset is BTC).
-        {
-            tool: 'rln_create_ln_invoice',
-            as: 'receive_ln',
-            args: (ctx) => {
-                const q = ctx.results.quote;
-                return { amount_sats: q?.receive_amount };
-            },
-            skipIf: (ctx) => !isBtc(ctx.slots.to_asset),
-        },
-        // 3. Maker locks the swap. Returns { atomic_id, maker_invoice }. Spend-gated.
+        // 2. MAKER locks the swap. SwapRequest is flat (asset ids + maker-unit
+        //    amounts) — sourced straight from the quote result, no re-scaling.
+        //    First spend step → the recipe-level confirm gate fires just before it.
         {
             tool: 'kaleidoswap_atomic_init',
-            as: 'atomic',
+            as: 'init',
             args: (ctx) => {
-                const rgb = ctx.results.receive_rgb;
-                const ln = ctx.results.receive_ln;
                 const q = ctx.results.quote;
                 return {
-                    quote_id: q?.quote_id,
-                    receive_invoice: rgb?.invoice ?? ln?.invoice,
+                    rfq_id: q?.rfq_id,
+                    from_asset: q?.from_asset?.asset_id,
+                    from_amount: q?.from_asset?.amount,
+                    to_asset: q?.to_asset?.asset_id,
+                    to_amount: q?.to_asset?.amount,
                 };
             },
         },
-        // 4. User pays the maker's Lightning invoice. Spend-gated by the wallet contract.
+        // 3. NODE: read our pubkey — the maker needs it as taker_pubkey for execute.
         {
-            tool: 'rln_pay_invoice',
-            as: 'paid',
+            tool: 'rln_get_node_info',
+            as: 'node',
+            args: () => ({}),
+        },
+        // 4. NODE: whitelist the maker's swapstring (accept the swap). Ungated —
+        //    covered by the single confirm above.
+        {
+            tool: 'rln_whitelist_swap',
+            as: 'whitelist',
             args: (ctx) => {
-                const a = ctx.results.atomic;
-                return { invoice: a?.maker_invoice };
+                const init = ctx.results.init;
+                return { swapstring: init?.swapstring };
             },
         },
     ],
-    // 5. Maker releases the receive asset → swap completes. Spend-gated.
+    // 5. MAKER settles the swap. Needs swapstring + taker_pubkey + payment_hash.
     final: {
         tool: 'kaleidoswap_atomic_execute',
         args: (ctx) => {
-            const a = ctx.results.atomic;
-            return { atomic_id: a?.atomic_id };
+            const init = ctx.results.init;
+            const node = ctx.results.node;
+            return {
+                swapstring: init?.swapstring,
+                taker_pubkey: node?.pubkey,
+                payment_hash: init?.payment_hash,
+            };
         },
     },
+    // ONE confirmation, fired after the quote / before init, with the real numbers.
+    confirm: (ctx) => {
+        const q = ctx.results.quote;
+        const from = q?.from_amount_display ?? `${ctx.slots.amount} ${ctx.slots.from_asset}`;
+        const to = q?.to_amount_display ?? String(ctx.slots.to_asset);
+        const fee = q?.fee_display ? ` · fee ${q.fee_display}` : '';
+        return `Swap ${from} → ${to}${fee} on KaleidoSwap. Proceed?`;
+    },
     summary: (ctx) => {
         const q = ctx.results.quote;
-        const tail = q?.receive_amount ? ` ≈ ${q.receive_amount} ${ctx.slots.to_asset}` : '';
-        return `Atomic swap: ${ctx.slots.amount} ${ctx.slots.from_asset} → ${ctx.slots.to_asset}${tail}.`;
+        const from = q?.from_amount_display ?? `${ctx.slots.amount} ${ctx.slots.from_asset}`;
+        const to = q?.to_amount_display ?? String(ctx.slots.to_asset);
+        return `Swap submitted: ${from} → ${to}. Settling now — ask me to check the status.`;
     },
 };
 //# sourceMappingURL=kaleidoswap-atomic.js.map

package/dist/recipe/kaleidoswap-atomic.js.map

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

package/dist/recipe/kaleidoswap-channel-order.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Built-in "buy inbound channel capacity from the LSP" recipe (LSPS1).
+ *
+ *   "buy a 500k inbound channel"
+ *   "I need 200000 sats of inbound liquidity"
+ *   "open a channel from the LSP, 1M inbound for 30 days"
+ *     ↓ heuristic pre-filter (0 inf) decides to enter the recipe branch
+ *     ↓ 1 model inference (forced LLM slot extraction)
+ *   lsp_get_info             ← LSP   options + assets (read-only)
+ *   lsp_estimate_fees        ← LSP   fee preview     (read-only)
+ *   rln_get_node_info        ← NODE  client_pubkey   (read-only)
+ *     ↓ [ONE confirmation gate — shows estimated total fee + channel terms]
+ *   lsp_create_order         ← LSP   creates the order → bolt11 invoice
+ *   rln_pay_invoice          ← NODE  pays the LSP invoice → channel opens
+ *
+ * Mirrors the single-confirm pattern from kaleidoswapAtomicRecipe: the user
+ * decides ONCE on the fee, then create_order + pay_invoice run as one
+ * approved unit. The channel's actual opening is asynchronous — the recipe
+ * reports "order placed and paid, channel opening" and leaves polling to a
+ * follow-up turn (lsp_get_order) so the chat isn't blocked.
+ *
+ * forceModelExtract: a small model can't reliably regex out a fuzzy phrasing
+ * like "I want a channel from the LSP, 500k inbound for a month, no push" —
+ * so the recipe still owns the chain + the single confirm, but lets the LLM
+ * do the natural-language understanding for slot extraction.
+ */
+import type { Recipe } from './types.js';
+/**
+ * Deterministic extractor — fast pre-filter for the Funnel to decide whether
+ * to enter the recipe branch. The model still runs (forceModelExtract) for
+ * the slots actually used in execution.
+ */
+export declare function extractChannelOrder(text: string): Record<string, unknown> | null;
+export declare const kaleidoswapChannelOrderRecipe: Recipe;
+//# sourceMappingURL=kaleidoswap-channel-order.d.ts.map

package/dist/recipe/kaleidoswap-channel-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kaleidoswap-channel-order.d.ts","sourceRoot":"","sources":["../../src/recipe/kaleidoswap-channel-order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAC;AAuCxD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgKhF;AAwED,eAAO,MAAM,6BAA6B,EAAE,MAoP3C,CAAC"}