@kaleidorg/mind 0.1.0 → 0.3.0

package/dist/recipe/kaleidoswap-atomic.js

@@ -0,0 +1,111 @@
+/**
+ * Built-in "atomic swap on KaleidoSwap" recipe — trust-minimised 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.
+ *
+ * Triggered only by explicit atomic-swap intent ("atomic swap", "trustless
+ * swap", "htlc swap") so it never preempts the simpler swap path for vague
+ * phrasings.
+ *
+ *   "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
+ *
+ * Two-or-three confirmation gates are intentional: each represents a distinct
+ * decision point. The host's confirm UI describes what's about to happen.
+ */
+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';
+}
+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'],
+    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' },
+    ],
+    extract: extractSwap,
+    confident: (s) => !!s.from_asset && !!s.to_asset && !!s.amount,
+    steps: [
+        // 1. Maker quotes the swap. Returns { quote_id, receive_amount, fees, ttl_ms, ... }.
+        {
+            tool: 'kaleidoswap_get_quote',
+            as: 'quote',
+            args: (ctx) => ({
+                from_asset: ctx.slots.from_asset,
+                to_asset: ctx.slots.to_asset,
+                amount: ctx.slots.amount,
+            }),
+        },
+        // 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.
+        {
+            tool: 'kaleidoswap_atomic_init',
+            as: 'atomic',
+            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,
+                };
+            },
+        },
+        // 4. User pays the maker's Lightning invoice. Spend-gated by the wallet contract.
+        {
+            tool: 'rln_pay_invoice',
+            as: 'paid',
+            args: (ctx) => {
+                const a = ctx.results.atomic;
+                return { invoice: a?.maker_invoice };
+            },
+        },
+    ],
+    // 5. Maker releases the receive asset → swap completes. Spend-gated.
+    final: {
+        tool: 'kaleidoswap_atomic_execute',
+        args: (ctx) => {
+            const a = ctx.results.atomic;
+            return { atomic_id: a?.atomic_id };
+        },
+    },
+    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}.`;
+    },
+};
+//# sourceMappingURL=kaleidoswap-atomic.js.map

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

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

package/dist/recipe/payments.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in "pay a contact" recipe — the flagship mobile multi-step flow.
+ *
+ *   "pay bob 3 EUR"  →  resolve_contact → fiat_to_sats → send_payment 🔒
+ *   "send 5000 sats to alice"  →  resolve_contact → send_payment 🔒
+ *
+ * Uses the canonical contract tools. The deterministic extractor handles most
+ * phrasings with no LLM at all (Tier-0); the runner falls back to one LLM
+ * extraction otherwise.
+ */
+import type { Recipe } from './types.js';
+/** "pay bob 3 eur", "send 5,000 sats to alice", "pay lnbc... ", "send 0.001 btc to bob" */
+export declare function extractPayment(text: string): Record<string, unknown> | null;
+export declare const paymentsRecipe: Recipe;
+//# sourceMappingURL=payments.d.ts.map

package/dist/recipe/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../src/recipe/payments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAC;AAgBxD,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAuB3E;AAgBD,eAAO,MAAM,cAAc,EAAE,MAgD5B,CAAC"}

package/dist/recipe/payments.js

@@ -0,0 +1,119 @@
+/**
+ * Built-in "pay a contact" recipe — the flagship mobile multi-step flow.
+ *
+ *   "pay bob 3 EUR"  →  resolve_contact → fiat_to_sats → send_payment 🔒
+ *   "send 5000 sats to alice"  →  resolve_contact → send_payment 🔒
+ *
+ * Uses the canonical contract tools. The deterministic extractor handles most
+ * phrasings with no LLM at all (Tier-0); the runner falls back to one LLM
+ * extraction otherwise.
+ */
+const CURRENCIES = /\b(sats?|sat|btc|usdt|xaut|eur|usd|gbp|dollars?|euros?|pounds?)\b/i;
+const isOnchainOrInvoice = (s) => /^(ln(bc|tb|bcrt)|bc1|tb1|lnurl|[a-z0-9._-]+@)/i.test(s.trim());
+function normCurrency(c) {
+    if (!c)
+        return undefined;
+    const x = c.toLowerCase();
+    if (/^sat/.test(x))
+        return 'sats';
+    if (x === 'btc')
+        return 'btc';
+    if (/dollar|^usd/.test(x))
+        return 'usd';
+    if (/euro|^eur/.test(x))
+        return 'eur';
+    if (/pound|^gbp/.test(x))
+        return 'gbp';
+    return x.toUpperCase();
+}
+/** "pay bob 3 eur", "send 5,000 sats to alice", "pay lnbc... ", "send 0.001 btc to bob" */
+export function extractPayment(text) {
+    const t = text.trim();
+    if (!/\b(pay|send|transfer)\b/i.test(t))
+        return null;
+    // Amount with optional k/m shorthand: "5k" → 5000, "2m" → 2_000_000.
+    const amtMatch = t.match(/(\d[\d.,]*)\s*([km])?\b/i);
+    let amountNum = amtMatch ? Number(amtMatch[1].replace(/,/g, '')) : undefined;
+    if (amountNum != null && amtMatch?.[2])
+        amountNum *= amtMatch[2].toLowerCase() === 'k' ? 1_000 : 1_000_000;
+    const amount = amountNum != null && !Number.isNaN(amountNum) ? String(amountNum) : undefined;
+    const currency = normCurrency(t.match(CURRENCIES)?.[1]);
+    // recipient: prefer "to <x>", else the token right after pay/send that isn't a number/currency
+    let recipient = t.match(/\bto\s+([^\s,]+)/i)?.[1];
+    if (!recipient) {
+        const after = t.match(/\b(?:pay|send|transfer)\s+([^\s,]+)/i)?.[1];
+        if (after && !/^\d/.test(after) && !CURRENCIES.test(after))
+            recipient = after;
+    }
+    if (!recipient && !amount)
+        return null;
+    return {
+        recipient,
+        amount: amount ? Number(amount) : undefined,
+        currency,
+    };
+}
+/** Compute the sats amount when no fiat conversion step is needed. */
+function directSats(ctx) {
+    const amount = Number(ctx.slots.amount);
+    if (!amount || Number.isNaN(amount))
+        return undefined;
+    const cur = String(ctx.slots.currency ?? 'sats').toLowerCase();
+    if (cur === 'btc')
+        return Math.round(amount * 1e8);
+    return Math.round(amount); // sats (default)
+}
+const isFiat = (ctx) => {
+    const c = String(ctx.slots.currency ?? '').toLowerCase();
+    return c !== '' && c !== 'sats' && c !== 'btc';
+};
+export const paymentsRecipe = {
+    name: 'pay-contact',
+    description: 'Pay a contact or address — resolves the contact, converts fiat to sats, then sends (with confirmation).',
+    // A BTC/fiat spend intent — NOT a receive/invoice, and NOT an RGB-asset send
+    // ("send 10 USDT to bob" is handled by the asset-send recipe, so USDT/XAUT
+    // amounts are never mis-parsed as fiat).
+    match: (t) => /\b(pay|send|transfer)\b/i.test(t) && !/\b(invoice|receive|request|address|qr|deposit|usdt|tether|xaut|gold)\b/i.test(t),
+    triggers: ['pay', 'send', 'transfer'],
+    slots: [
+        { name: 'recipient', type: 'string', description: 'Who to pay: a contact name, Lightning address, or invoice', required: true },
+        { name: 'amount', type: 'number', description: 'The amount to send' },
+        { name: 'currency', type: 'string', description: 'Unit of the amount: sats, btc, or a fiat code like eur/usd' },
+    ],
+    extract: extractPayment,
+    confident: (s) => !!s.recipient,
+    steps: [
+        {
+            // Resolve a contact name → payable address (skip if already an address/invoice).
+            tool: 'resolve_contact',
+            as: 'contact',
+            args: (ctx) => ({ name: ctx.slots.recipient }),
+            skipIf: (ctx) => !ctx.slots.recipient || isOnchainOrInvoice(String(ctx.slots.recipient)),
+        },
+        {
+            // Convert fiat → sats (skip when the amount is already sats/btc or absent).
+            tool: 'fiat_to_sats',
+            as: 'conv',
+            args: (ctx) => ({ amount: ctx.slots.amount, currency: ctx.slots.currency }),
+            skipIf: (ctx) => !ctx.slots.amount || !isFiat(ctx),
+        },
+    ],
+    final: {
+        tool: 'send_payment',
+        args: (ctx) => {
+            const contact = ctx.results.contact;
+            const conv = ctx.results.conv;
+            return {
+                to: contact?.ln_address ?? ctx.slots.recipient,
+                amount_sats: conv?.sats ?? directSats(ctx),
+            };
+        },
+    },
+    summary: (ctx) => {
+        const conv = ctx.results.conv;
+        const sats = conv?.sats ?? directSats(ctx);
+        const to = ctx.results.contact?.name ?? ctx.slots.recipient;
+        return sats ? `Sent ${sats.toLocaleString()} sats to ${to}.` : `Payment sent to ${to}.`;
+    },
+};
+//# sourceMappingURL=payments.js.map

package/dist/recipe/payments.js.map

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

package/dist/recipe/receive.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Built-in "receive" recipe — create an invoice/address to get paid, in sats,
+ * BTC, an RGB asset, OR a fiat amount (converted to sats deterministically so a
+ * small model never mis-parses "$2.00").
+ *
+ *   "invoice for 5000 sats"            → BTC invoice, 5000 sats
+ *   "create a payment request of $2"   → fiat_to_sats(2, USD) → BTC invoice
+ *   "invoice for 25 USDT on Liquid"    → RGB asset invoice
+ *   "an invoice"                       → BTC invoice, any amount
+ */
+import type { Recipe } from './types.js';
+export declare function extractReceive(text: string): Record<string, unknown> | null;
+export declare const receiveRecipe: Recipe;
+//# sourceMappingURL=receive.d.ts.map

package/dist/recipe/receive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receive.d.ts","sourceRoot":"","sources":["../../src/recipe/receive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AA+BzC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAO3E;AAED,eAAO,MAAM,aAAa,EAAE,MA8C3B,CAAC"}

package/dist/recipe/receive.js

@@ -0,0 +1,109 @@
+/**
+ * Built-in "receive" recipe — create an invoice/address to get paid, in sats,
+ * BTC, an RGB asset, OR a fiat amount (converted to sats deterministically so a
+ * small model never mis-parses "$2.00").
+ *
+ *   "invoice for 5000 sats"            → BTC invoice, 5000 sats
+ *   "create a payment request of $2"   → fiat_to_sats(2, USD) → BTC invoice
+ *   "invoice for 25 USDT on Liquid"    → RGB asset invoice
+ *   "an invoice"                       → BTC invoice, any amount
+ */
+const LAYER = /\b(spark|arkade|liquid|rln|lightning|rgb)\b/i;
+const RECEIVE_INTENT = /\b(invoice|receive|deposit|get paid|pay me|payment request|request (a )?payment)\b/i;
+function classify(text) {
+    if (/\$|\busd\b|dollar/i.test(text))
+        return { kind: 'fiat', code: 'USD' };
+    if (/€|\beur\b|euro/i.test(text))
+        return { kind: 'fiat', code: 'EUR' };
+    if (/£|\bgbp\b|pound/i.test(text))
+        return { kind: 'fiat', code: 'GBP' };
+    if (/usdt|tether/i.test(text))
+        return { kind: 'asset', code: 'USDT' };
+    if (/xaut|gold/i.test(text))
+        return { kind: 'asset', code: 'XAUT' };
+    if (/\bbtc\b|bitcoin/i.test(text))
+        return { kind: 'btc', code: 'BTC' };
+    return { kind: 'sats', code: 'BTC' }; // default: sats
+}
+function normLayer(l) {
+    if (!l)
+        return undefined;
+    const x = l.toLowerCase();
+    if (x === 'lightning' || x === 'rgb')
+        return 'rln';
+    if (['spark', 'arkade', 'liquid', 'rln'].includes(x))
+        return x;
+    return undefined;
+}
+function parseAmount(t) {
+    const m = t.match(/(\d[\d.,]*)\s*([km])?\b/i);
+    if (!m)
+        return undefined;
+    let n = Number(m[1].replace(/,/g, ''));
+    if (m[2])
+        n *= m[2].toLowerCase() === 'k' ? 1_000 : 1_000_000;
+    return Number.isNaN(n) ? undefined : n;
+}
+export function extractReceive(text) {
+    const t = text.trim();
+    if (!RECEIVE_INTENT.test(t))
+        return null;
+    const amount = parseAmount(t);
+    const { kind, code } = classify(t);
+    const layer = normLayer(t.match(LAYER)?.[1]);
+    return { ...(amount != null ? { amount } : {}), kind, currency: code, ...(layer ? { layer } : {}) };
+}
+export const receiveRecipe = {
+    name: 'receive',
+    description: 'Create an invoice/address to receive funds — sats, BTC, a fiat amount (converted), or an RGB asset.',
+    match: (t) => RECEIVE_INTENT.test(t) && !/\b(send|transfer|swap|buy|sell)\b/i.test(t),
+    triggers: ['invoice', 'receive', 'deposit', 'payment request'],
+    slots: [
+        { name: 'amount', type: 'number', description: 'Amount to receive (optional)' },
+        { name: 'currency', type: 'string', description: 'sats | BTC | USD | EUR | USDT | XAUT' },
+        { name: 'layer', type: 'string', description: 'Rail: spark, rln, liquid (optional)' },
+    ],
+    extract: extractReceive,
+    confident: () => true,
+    steps: [
+        {
+            // Fiat → sats, only when the amount is fiat-denominated.
+            tool: 'fiat_to_sats',
+            as: 'conv',
+            args: (ctx) => ({ amount: ctx.slots.amount, currency: ctx.slots.currency }),
+            skipIf: (ctx) => ctx.slots.kind !== 'fiat' || ctx.slots.amount == null,
+        },
+    ],
+    final: {
+        tool: 'create_invoice',
+        args: (ctx) => {
+            const kind = ctx.slots.kind;
+            const conv = ctx.results.conv;
+            let asset = 'BTC';
+            let amount = ctx.slots.amount;
+            if (kind === 'asset')
+                asset = String(ctx.slots.currency);
+            else if (kind === 'fiat')
+                amount = conv?.sats;
+            else if (kind === 'btc' && amount != null)
+                amount = Math.round(amount * 1e8); // sats
+            return { asset, amount, layer: ctx.slots.layer };
+        },
+    },
+    summary: (ctx, result) => {
+        const r = result;
+        const dest = r?.invoice ?? r?.address ?? '';
+        const kind = ctx.slots.kind;
+        const conv = ctx.results.conv;
+        let amt = 'any amount';
+        if (kind === 'fiat' && ctx.slots.amount != null)
+            amt = `${ctx.slots.currency} ${ctx.slots.amount} (${(conv?.sats ?? 0).toLocaleString()} sats)`;
+        else if (kind === 'asset' && ctx.slots.amount != null)
+            amt = `${Number(ctx.slots.amount).toLocaleString()} ${ctx.slots.currency}`;
+        else if (ctx.slots.amount != null)
+            amt = `${Number(ctx.slots.amount).toLocaleString()} ${kind === 'btc' ? 'BTC' : 'sats'}`;
+        const label = kind === 'asset' ? String(ctx.slots.currency) : 'BTC';
+        return dest ? `Here's your ${label} invoice for ${amt}:\n\n${dest}` : `Created an invoice for ${amt}.`;
+    },
+};
+//# sourceMappingURL=receive.js.map

package/dist/recipe/receive.js.map

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

package/dist/recipe/runner.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Recipe runner — executes a Recipe with ONE structured extraction (or a
+ * deterministic regex), then runs the deterministic step chain and the
+ * confirmation-gated final action. This is mobile multi-step: a tiny model
+ * fills slots; the engine does the planning.
+ */
+import type { LLMProvider } from '../providers/types.js';
+import type { ToolRegistry } from '../tools/registry.js';
+import type { ConfirmDecision } from '../types.js';
+import type { Recipe, RecipeResult } from './types.js';
+export interface RunRecipeOptions {
+    provider: LLMProvider;
+    tools: ToolRegistry;
+    /** Called before the (spend) final action when its tool is confirmation-gated. */
+    onConfirm?: (call: {
+        name: string;
+        arguments: Record<string, unknown>;
+    }) => Promise<ConfirmDecision>;
+    /** Progress hook per completed step. */
+    onStep?: (name: string, args: Record<string, unknown>, result: unknown) => void;
+    /** Skip extraction and use these slots (deterministic Tier-0 / tests). */
+    slots?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+/** Extract the recipe's slots — deterministic regex first, else ONE LLM call. */
+export declare function extractSlots(provider: LLMProvider, recipe: Recipe, text: string): Promise<{
+    slots: Record<string, unknown>;
+    inferences: number;
+}>;
+/** Run a recipe end to end. Never throws — failures come back as status:'error'. */
+export declare function runRecipe(recipe: Recipe, text: string, opts: RunRecipeOptions): Promise<RecipeResult>;
+/** Selects a recipe for a request. Use before falling back to the free agentic loop. */
+export declare class RecipeRegistry {
+    private recipes;
+    constructor(recipes?: Recipe[]);
+    add(recipe: Recipe): void;
+    list(): Recipe[];
+    get(name: string): Recipe | undefined;
+    /** First recipe whose match()/triggers fit the text, else null. */
+    select(text: string): Recipe | null;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/recipe/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/recipe/runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAC;AAItE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,kFAAkF;IAClF,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACrG,wCAAwC;IACxC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAChF,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,iFAAiF;AACjF,wBAAsB,YAAY,CAChC,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBjE;AAED,oFAAoF;AACpF,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsD3G;AAED,wFAAwF;AACxF,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAW;gBACd,OAAO,GAAE,MAAM,EAAO;IAGlC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAGzB,IAAI,IAAI,MAAM,EAAE;IAGhB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAGrC,mEAAmE;IACnE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAQpC"}

package/dist/recipe/runner.js

@@ -0,0 +1,106 @@
+/**
+ * Recipe runner — executes a Recipe with ONE structured extraction (or a
+ * deterministic regex), then runs the deterministic step chain and the
+ * confirmation-gated final action. This is mobile multi-step: a tiny model
+ * fills slots; the engine does the planning.
+ */
+const EXTRACT_TOOL = 'extract_request';
+/** Extract the recipe's slots — deterministic regex first, else ONE LLM call. */
+export async function extractSlots(provider, recipe, text) {
+    const det = recipe.extract?.(text);
+    if (det && Object.values(det).some((v) => v !== undefined && v !== null && v !== '')) {
+        return { slots: det, inferences: 0 };
+    }
+    const properties = {};
+    for (const s of recipe.slots)
+        properties[s.name] = { type: s.type ?? 'string', description: s.description };
+    const extractTool = {
+        name: EXTRACT_TOOL,
+        description: `Extract the fields from the user's request.`,
+        parameters: { type: 'object', properties, required: recipe.slots.filter((s) => s.required).map((s) => s.name) },
+    };
+    const out = await provider.runTurn({
+        system: `Call ${EXTRACT_TOOL} with the fields from the user's message. Do not call any other tool and do not add commentary.`,
+        messages: [{ role: 'user', content: text }],
+        tools: [extractTool],
+    });
+    const call = out.toolCalls?.find((c) => c.name === EXTRACT_TOOL) ?? out.toolCalls?.[0];
+    return { slots: call?.arguments ?? {}, inferences: 1 };
+}
+/** Run a recipe end to end. Never throws — failures come back as status:'error'. */
+export async function runRecipe(recipe, text, opts) {
+    const ctx = { text, slots: opts.slots ?? {}, results: {} };
+    let inferences = 0;
+    try {
+        if (!opts.slots) {
+            const ex = await extractSlots(opts.provider, recipe, text);
+            ctx.slots = ex.slots;
+            inferences = ex.inferences;
+        }
+        // Deterministic steps. Intermediate spend tools fire the same confirmation
+        // gate as the final step — recipes with multi-spend chains (e.g. atomic
+        // swaps) MUST have every money-moving call gated, never just the last one.
+        // Missing onConfirm fails closed, matching the Engine.
+        for (const step of recipe.steps) {
+            if (step.skipIf?.(ctx))
+                continue;
+            const args = step.args(ctx);
+            const def = await opts.tools.getDef(step.tool);
+            if (def?.requiresConfirmation) {
+                const decision = opts.onConfirm
+                    ? await opts.onConfirm({ name: step.tool, arguments: args })
+                    : { approved: false, reason: 'no confirmation handler available' };
+                if (!decision.approved) {
+                    return { recipe: recipe.name, slots: ctx.slots, results: ctx.results, text: 'Cancelled — nothing was sent.', status: 'cancelled', inferences };
+                }
+            }
+            const result = await opts.tools.execute(step.tool, args);
+            ctx.results[step.as ?? step.tool] = result;
+            opts.onStep?.(step.tool, args, result);
+        }
+        // Final action — confirmation-gated if the tool requires it. Like the
+        // Engine, a missing onConfirm FAILS CLOSED: the spend is declined, never
+        // silently executed.
+        const finalArgs = recipe.final.args(ctx);
+        const def = await opts.tools.getDef(recipe.final.tool);
+        if (def?.requiresConfirmation) {
+            const decision = opts.onConfirm
+                ? await opts.onConfirm({ name: recipe.final.tool, arguments: finalArgs })
+                : { approved: false, reason: 'no confirmation handler available' };
+            if (!decision.approved) {
+                return { recipe: recipe.name, slots: ctx.slots, results: ctx.results, text: 'Cancelled — nothing was sent.', status: 'cancelled', inferences };
+            }
+        }
+        const finalResult = await opts.tools.execute(recipe.final.tool, finalArgs);
+        ctx.results[recipe.final.as ?? recipe.final.tool] = finalResult;
+        opts.onStep?.(recipe.final.tool, finalArgs, finalResult);
+        const out = recipe.summary?.(ctx, finalResult) ?? 'Done.';
+        return { recipe: recipe.name, slots: ctx.slots, results: ctx.results, final: finalResult, text: out, status: 'done', inferences };
+    }
+    catch (e) {
+        const msg = e?.message ?? String(e);
+        return { recipe: recipe.name, slots: ctx.slots, results: ctx.results, text: `Couldn't complete that: ${msg}`, status: 'error', error: msg, inferences };
+    }
+}
+/** Selects a recipe for a request. Use before falling back to the free agentic loop. */
+export class RecipeRegistry {
+    recipes;
+    constructor(recipes = []) {
+        this.recipes = [...recipes];
+    }
+    add(recipe) {
+        this.recipes.push(recipe);
+    }
+    list() {
+        return [...this.recipes];
+    }
+    get(name) {
+        return this.recipes.find((r) => r.name === name);
+    }
+    /** First recipe whose match()/triggers fit the text, else null. */
+    select(text) {
+        const lc = text.toLowerCase();
+        return (this.recipes.find((r) => r.match ? r.match(text) : (r.triggers ?? []).some((t) => lc.includes(t.toLowerCase()))) ?? null);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/recipe/runner.js.map

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

package/dist/recipe/swap.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Built-in "swap" recipe — quote → (confirm) → execute, over the contract tools.
+ *
+ *   "buy 0.001 btc with usdt"   → from USDT, to BTC
+ *   "swap 10 usdt for btc"      → from USDT, to BTC
+ *   "sell 100 usdt for sats"    → from USDT, to BTC
+ *
+ * The deterministic extractor handles the common phrasings; the runner falls
+ * back to one LLM extraction otherwise. execute_swap is a spend → the engine's
+ * confirmation gate fires before it runs.
+ */
+import type { Recipe } from './types.js';
+/** "buy 0.001 btc with usdt" / "swap 10 usdt for btc" / "sell 100 usdt for sats". */
+export declare function extractSwap(text: string): Record<string, unknown> | null;
+export declare const swapRecipe: Recipe;
+//# sourceMappingURL=swap.d.ts.map

package/dist/recipe/swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../../src/recipe/swap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAczC,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAYxE;AAED,eAAO,MAAM,UAAU,EAAE,MAgCxB,CAAC"}