@kaleidorg/mind 0.0.1 → 0.2.0

package/dist/rag/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/rag/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/rag/vector-store.d.ts

@@ -0,0 +1,23 @@
+/**
+ * In-memory vector store — pure-JS cosine similarity index. Zero deps, so it
+ * bundles in Bare/RN. Good for thousands of chunks; swap in a native/SQLite
+ * store via the VectorStore interface for larger corpora.
+ */
+import type { Chunk, RetrievedChunk, VectorStore, VectorStoreIO } from './types.js';
+/** Cosine similarity of two equal-length vectors. Returns 0 on degenerate input. */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+export interface InMemoryVectorStoreOptions {
+    io?: VectorStoreIO;
+}
+export declare class InMemoryVectorStore implements VectorStore {
+    private chunks;
+    private hydrated;
+    private readonly io?;
+    constructor(opts?: InMemoryVectorStoreOptions);
+    private hydrate;
+    upsert(chunks: Chunk[]): Promise<void>;
+    query(embedding: number[], k: number): Promise<RetrievedChunk[]>;
+    size(): Promise<number>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/rag/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../src/rag/vector-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpF,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYjE;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,CAAC,EAAE,aAAa,CAAC;CACpB;AAED,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAgB;gBAExB,IAAI,GAAE,0BAA+B;YAInC,OAAO;IAYf,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAShE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/rag/vector-store.js

@@ -0,0 +1,72 @@
+/**
+ * In-memory vector store — pure-JS cosine similarity index. Zero deps, so it
+ * bundles in Bare/RN. Good for thousands of chunks; swap in a native/SQLite
+ * store via the VectorStore interface for larger corpora.
+ */
+/** Cosine similarity of two equal-length vectors. Returns 0 on degenerate input. */
+export function cosineSimilarity(a, b) {
+    const n = Math.min(a.length, b.length);
+    let dot = 0;
+    let na = 0;
+    let nb = 0;
+    for (let i = 0; i < n; i++) {
+        dot += a[i] * b[i];
+        na += a[i] * a[i];
+        nb += b[i] * b[i];
+    }
+    if (na === 0 || nb === 0)
+        return 0;
+    return dot / (Math.sqrt(na) * Math.sqrt(nb));
+}
+export class InMemoryVectorStore {
+    chunks = [];
+    hydrated = false;
+    io;
+    constructor(opts = {}) {
+        this.io = opts.io;
+    }
+    async hydrate() {
+        if (this.hydrated)
+            return;
+        this.hydrated = true;
+        if (this.io) {
+            try {
+                this.chunks = await this.io.load();
+            }
+            catch {
+                this.chunks = [];
+            }
+        }
+    }
+    async upsert(chunks) {
+        await this.hydrate();
+        for (const c of chunks) {
+            const i = this.chunks.findIndex((x) => x.id === c.id);
+            if (i >= 0)
+                this.chunks[i] = c;
+            else
+                this.chunks.push(c);
+        }
+        if (this.io)
+            await this.io.save(this.chunks);
+    }
+    async query(embedding, k) {
+        await this.hydrate();
+        return this.chunks
+            .filter((c) => c.embedding && c.embedding.length > 0)
+            .map((c) => ({ ...c, score: cosineSimilarity(embedding, c.embedding) }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, k);
+    }
+    async size() {
+        await this.hydrate();
+        return this.chunks.length;
+    }
+    async clear() {
+        await this.hydrate();
+        this.chunks = [];
+        if (this.io)
+            await this.io.save(this.chunks);
+    }
+}
+//# sourceMappingURL=vector-store.js.map

package/dist/rag/vector-store.js.map

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

package/dist/recipe/asset-send.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in "send an RGB asset" recipe — distinct from the BTC payments recipe
+ * because an asset amount must NOT be treated as fiat.
+ *
+ *   "send 10 USDT to bob"     → resolve_contact → rln_send_asset 🔒
+ *   "pay alice 5 XAUT"        → resolve_contact → rln_send_asset 🔒
+ *
+ * Fixes the bug where the payments recipe parsed "USDT" as a fiat currency and
+ * ran fiat_to_sats. Payments now excludes RGB assets; this recipe owns them.
+ */
+import type { Recipe } from './types.js';
+/** "send 10 USDT to bob" / "pay alice 5 xaut". */
+export declare function extractAssetSend(text: string): Record<string, unknown> | null;
+export declare const assetSendRecipe: Recipe;
+//# sourceMappingURL=asset-send.d.ts.map

package/dist/recipe/asset-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-send.d.ts","sourceRoot":"","sources":["../../src/recipe/asset-send.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAC;AAoBxD,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAa7E;AAED,eAAO,MAAM,eAAe,EAAE,MA+B7B,CAAC"}

package/dist/recipe/asset-send.js

@@ -0,0 +1,83 @@
+/**
+ * Built-in "send an RGB asset" recipe — distinct from the BTC payments recipe
+ * because an asset amount must NOT be treated as fiat.
+ *
+ *   "send 10 USDT to bob"     → resolve_contact → rln_send_asset 🔒
+ *   "pay alice 5 XAUT"        → resolve_contact → rln_send_asset 🔒
+ *
+ * Fixes the bug where the payments recipe parsed "USDT" as a fiat currency and
+ * ran fiat_to_sats. Payments now excludes RGB assets; this recipe owns them.
+ */
+const RGB_ASSET = /\b(usdt|tether|xaut|gold)\b/i;
+const isOnchainOrInvoice = (s) => /^(ln(bc|tb|bcrt)|bc1|tb1|lnurl|rgb:|[a-z0-9._-]+@)/i.test(s.trim());
+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 a.toUpperCase();
+}
+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;
+}
+/** "send 10 USDT to bob" / "pay alice 5 xaut". */
+export function extractAssetSend(text) {
+    const t = text.trim();
+    if (!/\b(send|pay|transfer)\b/i.test(t))
+        return null;
+    const asset = normAsset(t.match(RGB_ASSET)?.[1]);
+    if (!asset)
+        return null; // not an asset send → let the payments recipe handle it
+    const amount = parseAmount(t);
+    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) && !RGB_ASSET.test(after))
+            recipient = after;
+    }
+    if (!recipient && amount == null)
+        return null;
+    return { recipient, asset, amount };
+}
+export const assetSendRecipe = {
+    name: 'pay-asset',
+    description: 'Send an RGB asset (USDT, XAUT) to a contact or address — resolves the contact, then sends (with confirmation).',
+    match: (t) => /\b(send|pay|transfer)\b/i.test(t) && RGB_ASSET.test(t) && !/\b(invoice|receive|swap|buy|sell|for)\b/i.test(t),
+    triggers: ['send', 'pay', 'transfer'],
+    slots: [
+        { name: 'recipient', type: 'string', description: 'Contact name, address, or RGB invoice', required: true },
+        { name: 'asset', type: 'string', description: 'RGB asset: USDT or XAUT', required: true },
+        { name: 'amount', type: 'number', description: 'Asset amount' },
+    ],
+    extract: extractAssetSend,
+    confident: (s) => !!s.recipient && !!s.asset,
+    steps: [
+        {
+            tool: 'resolve_contact',
+            as: 'contact',
+            args: (ctx) => ({ name: ctx.slots.recipient }),
+            skipIf: (ctx) => !ctx.slots.recipient || isOnchainOrInvoice(String(ctx.slots.recipient)),
+        },
+    ],
+    final: {
+        tool: 'rln_send_asset',
+        args: (ctx) => {
+            const contact = ctx.results.contact;
+            return { asset: ctx.slots.asset, amount: ctx.slots.amount, to: contact?.ln_address ?? ctx.slots.recipient };
+        },
+    },
+    summary: (ctx) => {
+        const to = ctx.results.contact?.name ?? ctx.slots.recipient;
+        return `Sent ${ctx.slots.amount} ${ctx.slots.asset} to ${to}.`;
+    },
+};
+//# sourceMappingURL=asset-send.js.map

package/dist/recipe/asset-send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-send.js","sourceRoot":"","sources":["../../src/recipe/asset-send.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,CA0C3G;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"}