@kaleidorg/mind 0.2.0 → 0.4.0

package/dist/skills/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvE,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAuB1D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,EAAE,GAAG,KAAK,CAkCjF;AASD,kFAAkF;AAClF,eAAO,MAAM,eAAe,EAAE,aAuB7B,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,MAAM,GAAE,KAAK,EAAO,EAAE,QAAQ,GAAE,aAA+B;IAK3E,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAKvB,uEAAuE;IACvE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI;IAIlE,yEAAyE;IACzE,UAAU,IAAI,KAAK,CAAC,cAAc,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAMvD,yEAAyE;IACzE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAUnE,IAAI,IAAI,KAAK,EAAE;IAIf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC,8DAA8D;IAC9D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAInC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAwBxF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvE,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAuB1D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,EAAE,GAAG,KAAK,CAkCjF;AA0BD,kFAAkF;AAClF,eAAO,MAAM,eAAe,EAAE,aAyB7B,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,MAAM,GAAE,KAAK,EAAO,EAAE,QAAQ,GAAE,aAA+B;IAK3E,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAKvB,uEAAuE;IACvE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI;IAIlE,yEAAyE;IACzE,UAAU,IAAI,KAAK,CAAC,cAAc,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAMvD,yEAAyE;IACzE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAUnE,IAAI,IAAI,KAAK,EAAE;IAIf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC,8DAA8D;IAC9D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAInC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAwBxF"}

package/dist/skills/registry.js

@@ -68,6 +68,22 @@ const STOPWORDS = new Set([
     'have', 'has', 'are', 'was', 'can', 'will', 'please', 'today', 'now', 'get',
     'show', 'tell', 'how', 'much', 'many', 'about', 'into', 'over',
 ]);
+/** Escape a string for safe inclusion in a regex. */
+function reEscape(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Match a trigger phrase in the query with WORD BOUNDARIES — so the
+ * `usd` trigger on a wallet skill doesn't fire on `usdt`/`usdc`, and
+ * `cafe` doesn't fire on `cafeteria`. Multi-word triggers ("near me")
+ * still work because spaces are already word boundaries.
+ */
+function triggerMatches(query, trigger) {
+    const t = trigger.toLowerCase().trim();
+    if (!t)
+        return false;
+    return new RegExp(`\\b${reEscape(t)}\\b`).test(query);
+}
 /** Default selector: score by meaningful keyword overlap; triggers weigh most. */
 export const keywordSelector = {
     select(query, skills) {
@@ -82,9 +98,11 @@ export const keywordSelector = {
             for (const w of hayWords)
                 if (words.has(w))
                     score += 1;
-            // Strong boost for an explicit trigger appearing in the query.
+            // Strong boost for an explicit trigger appearing in the query — at a
+            // word boundary, so short triggers (`usd`, `eur`, `cafe`) don't leak
+            // into longer words (`usdt`, `europe`, `cafeteria`).
             for (const t of skill.triggers ?? [])
-                if (q.includes(t.toLowerCase()))
+                if (triggerMatches(q, t))
                     score += 3;
             if (score > bestScore) {
                 bestScore = score;

package/dist/skills/registry.js.map

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

package/dist/wallet/confirm.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Confirm-sheet readback — a deterministic, voice-first summary of a spend that
+ * the host speaks before executing it ("Send 4,800 sats to bob over Spark.
+ * Confirm?"). Built from the resolved tool call, not the model: zero inference,
+ * identical on every surface, and impossible for the model to phrase around.
+ */
+/** A spoken confirmation ending in "Confirm?", or null for non-spend tools. */
+export declare function confirmReadback(call: {
+    name: string;
+    arguments: Record<string, unknown>;
+}): string | null;
+//# sourceMappingURL=confirm.d.ts.map

package/dist/wallet/confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../src/wallet/confirm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyCH,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CA0BzG"}

package/dist/wallet/confirm.js

@@ -0,0 +1,67 @@
+/**
+ * Confirm-sheet readback — a deterministic, voice-first summary of a spend that
+ * the host speaks before executing it ("Send 4,800 sats to bob over Spark.
+ * Confirm?"). Built from the resolved tool call, not the model: zero inference,
+ * identical on every surface, and impossible for the model to phrase around.
+ */
+import { getWalletTool } from './contract.js';
+const LAYER_LABEL = {
+    spark: 'Spark',
+    rln: 'RLN',
+    arkade: 'Arkade',
+    liquid: 'Liquid',
+};
+/** Group an integer with thousands separators, locale-independently (test-stable). */
+function fmtNum(n) {
+    if (!Number.isFinite(n))
+        return String(n);
+    const neg = n < 0;
+    const [int, frac] = Math.abs(n).toString().split('.');
+    const grouped = int.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+    return (neg ? '-' : '') + (frac ? `${grouped}.${frac}` : grouped);
+}
+/** Looks like an address/invoice/lnurl (vs a human contact name). */
+function isRef(s) {
+    return /^(ln(bc|tb|bcrt)|bc1|tb1|lq1|lnurl)/i.test(s) || (s.length > 20 && !/\s/.test(s));
+}
+/** Shorten an address/invoice for speech; leave contact names intact. */
+function shortRef(s) {
+    const v = s.trim();
+    return isRef(v) ? `${v.slice(0, 6)}…${v.slice(-4)}` : v;
+}
+/** " over Spark" suffix for the call's layer (explicit arg wins, else the tool's). */
+function over(name, args) {
+    const layer = typeof args.layer === 'string' ? args.layer : getWalletTool(name)?.layer;
+    const label = layer ? LAYER_LABEL[layer] : undefined;
+    return label ? ` over ${label}` : '';
+}
+const sats = (v) => `${fmtNum(Number(v))} sats`;
+const asset = (amount, ticker) => `${fmtNum(Number(amount))} ${String(ticker)}`;
+/** A spoken confirmation ending in "Confirm?", or null for non-spend tools. */
+export function confirmReadback(call) {
+    const { name, arguments: a } = call;
+    const to = (k = 'to') => shortRef(String(a[k] ?? ''));
+    const ask = (s) => `${s}. Confirm?`;
+    switch (name) {
+        case 'send_payment': {
+            const amt = a.amount_sats != null ? sats(a.amount_sats)
+                : a.asset != null && a.amount != null ? asset(a.amount, a.asset)
+                    : undefined;
+            return ask(amt ? `Send ${amt} to ${to()}${over(name, a)}` : `Send a payment to ${to()}${over(name, a)}`);
+        }
+        case 'spark_send':
+        case 'arkade_send':
+            return ask(`Send ${sats(a.amount_sats)} to ${to()}${over(name, a)}`);
+        case 'rln_send_asset':
+        case 'liquid_send':
+            return ask(`Send ${asset(a.amount, a.asset)} to ${to()}${over(name, a)}`);
+        case 'rln_pay_invoice':
+            return ask(`Pay Lightning invoice ${shortRef(String(a.invoice ?? ''))}${over(name, a)}`);
+        case 'execute_swap':
+            return ask(`Swap ${fmtNum(Number(a.amount))} ${String(a.from_asset)} for ${String(a.to_asset)}`);
+        default:
+            // Unknown but spend-flagged tool → a generic, still-honest readback.
+            return getWalletTool(name)?.spend ? ask(`Confirm ${name.replace(/_/g, ' ')}`) : null;
+    }
+}
+//# sourceMappingURL=confirm.js.map

package/dist/wallet/confirm.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaleidorg/mind",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Local-first reasoning + function-calling engine for KaleidoSwap. QVAC-powered.",
   "license": "Apache-2.0",
   "type": "module",
@@ -34,6 +34,11 @@
       "types": "./dist/logger.d.ts",
       "import": "./dist/logger.js",
       "default": "./dist/logger.js"
+    },
+    "./qvac": {
+      "types": "./dist/qvac/index.d.ts",
+      "import": "./dist/qvac/index.js",
+      "default": "./dist/qvac/index.js"
     }
   },
   "files": [
@@ -51,7 +56,17 @@
     "lint": "eslint src",
     "bundle-skills": "node scripts/bundle-skills.mjs"
   },
+  "peerDependencies": {
+    "@qvac/sdk": ">=0.12.2"
+  },
+  "peerDependenciesMeta": {
+    "@qvac/sdk": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@qvac/sdk": "^0.13.1",
+    "@types/node": "^20.0.0",
     "vitest": "^1.6.0"
   }
 }

package/skills/README.md

@@ -70,5 +70,10 @@ Then per query: `const skill = registry.select(query)` →
   `https://api.bitrefill.com/mcp` (needs `BITREFILL_API_KEY` — anonymous = 401).
   Source: https://github.com/bitrefill/agents (MIT). Update with
   `npx skills add bitrefill/agents` or re-vendor the folder.
-- **kaleido-wallet/** — balances, receive, pay, channels over `kaleido-mcp`.
+- **wallet-assistant/** — everyday wallet tasks (balance, receive, send, pay,
+  price, fiat→sats, resolve a contact). Resolves to host-bound `wallet/contract.ts`
+  tools (in-process WDK on mobile, MCP on desktop).
+- **merchant-finder/** — find Bitcoin-accepting merchants via BTC Map. Live
+  data when the host injects a fetch + location; bundled offline list otherwise.
+- **paid-data/** — fetch L402-paywalled resources via `fetch_paid_resource`.
 - **kaleido-trading/** — prices, quotes, atomic swaps, LSP channels.

package/skills/kaleido-lsps/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: kaleido-lsps
+description: "Buy inbound Lightning channel capacity from a Lightning Service Provider (LSPS1). Quote, estimate fees, and create a channel order. Triggers when the user wants inbound liquidity, can't receive a payment, needs a channel, or asks about LSP fees."
+tools: lsp_get_info, lsp_get_network_info, lsp_estimate_fees, lsp_create_order, lsp_get_order
+triggers: inbound, liquidity, channel order, lsp, lsps1, receive limit, can't receive, open channel
+metadata:
+  author: kaleidoswap
+  version: "0.1.0"
+---
+
+# Lightning channel orders (LSPS1)
+
+Buy inbound Lightning channel capacity from a Lightning Service Provider when
+the user can't receive a payment (no inbound liquidity) or wants a bigger
+receive limit. The host binds these to whichever LSP it talks to — the
+KaleidoSwap maker by default, but the contract is LSP-agnostic (`lsp_*`).
+
+## Critical rules
+
+You have **no knowledge of LSP fees, channel sizes, or order status**. Every
+number, capacity, fee, or order id in your reply MUST come from a tool result
+returned in the CURRENT turn. Never quote a fee from memory. Never claim an
+order completed without calling `lsp_get_order`. Never reuse a number from a
+previous turn.
+
+**Calling the tool IS the answer.** Don't write "the LSP info is fetched with
+`lsp_get_info`" — call it.
+
+If a tool needs a required argument the user didn't give (e.g. an `order_id`
+when polling), ASK. Don't loop the same failing call.
+
+## Flow
+
+1. **Check the LSP first.** Call `lsp_get_info` once per session to learn the
+   min/max channel size and the fee structure. Use those numbers to validate
+   the user's request (e.g. "200k sats" against `min_channel_sat`).
+2. **Estimate before ordering.** Call `lsp_estimate_fees` with the desired
+   `lsp_balance_sat`. Surface the total cost explicitly — never hide it.
+3. **Show + confirm.** State: inbound capacity requested, total fee, expiry
+   (if applicable), and the LSP node URI from `lsp_get_network_info` (so the
+   user knows the counterparty). The next step is spend-gated.
+4. **Create the order.** Call `lsp_create_order` with the same parameters.
+   The host pauses for explicit confirmation. Returns an `order_id` and a
+   Lightning invoice the user must pay to lock the order.
+5. **Track it.** Poll `lsp_get_order` until the channel opens (status
+   `completed`) or fails. Report the outcome plainly.
+
+## Rules
+
+- **Re-estimate when parameters change.** Don't reuse an estimate across
+  different channel sizes or expiries.
+- **Never invent capacity / fees / pubkeys.** Tool results are the truth.
+- **Lightning over on-chain for ordering.** LSPS1 orders are paid by
+  Lightning invoice; if Lightning isn't available, say so and stop.
+- **A channel order is not the same as a payment.** Make this explicit when
+  the user confuses them.

package/skills/kaleido-trading/SKILL.md

@@ -1,31 +1,98 @@
 ---
 name: kaleido-trading
-description: "Trade and manage a portfolio on KaleidoSwap: get live prices and market data, quote and place atomic swaps between BTC and RGB assets (USDT, XAUT), acquire inbound liquidity from the LSP, and check positions. Triggers when the user wants a price, a quote, to swap or trade assets, to rebalance a portfolio, or to acquire a Lightning channel from the LSP."
-tools: get_price, get_market_data, kaleidoswap_get_pairs, kaleidoswap_get_quote, kaleidoswap_place_order, kaleidoswap_get_order_status, kaleidoswap_get_position, kaleidoswap_lsp_get_info, kaleidoswap_lsp_create_order
-triggers: price, quote, swap, trade, rebalance, portfolio, market, slippage, liquidity, channel order
+description: "Trade on KaleidoSwap — quote and execute swaps between BTC and RGB assets (USDT, XAUT). Get assets and pairs, pull an executable quote, place a market order, or track an atomic swap end-to-end. Triggers when the user wants a price, a quote, to swap or trade assets, or to rebalance between BTC and stablecoins."
+tools: get_price, fiat_to_sats, kaleidoswap_get_assets, kaleidoswap_get_pairs, kaleidoswap_get_quote, kaleidoswap_get_nodeinfo, kaleidoswap_place_order, kaleidoswap_get_order_status, kaleidoswap_get_order_history
+triggers: quote, swap, trade, rebalance, slippage, pair, pairs, usdt, xaut, kaleidoswap, rfq
 metadata:
   author: kaleidoswap
-  version: "0.1.0"
-  surface: "kaleido-mcp (KaleidoSwap maker + market data)"
+  version: "0.3.0"
 ---
 
 # KaleidoSwap trading
 
-Quote, swap, and manage a portfolio through the KaleidoSwap maker and market
-data MCP tools.
+Quote and execute swaps on the KaleidoSwap maker. The model picks tools by
+name; the host binds them through whichever transport it runs over (WDK on
+mobile, HTTP/MCP/CLI on desktop).
+
+## Critical rules — these override everything else
+
+You have **no knowledge** of any price, quote, fee, pair, or order. Every
+number, pair, or quote id in your reply MUST come from a tool result returned
+in the CURRENT turn:
+
+- "What's the BTC price?" → call `get_price` and state the number it returns.
+- "What pairs are listed?" → call `kaleidoswap_get_pairs` and list them.
+- "Quote 100k sats to USDT" → call `kaleidoswap_get_quote(BTC, USDT, 100000)`,
+  then state the receive amount + fees from the result.
+
+**Calling the tool IS the answer.** Never write "the pairs are listed using
+kaleidoswap_get_pairs" or "the function returns the quote" — just call it.
+
+**Never reuse a number across turns.** If the user asks a new question, the
+previous turn's quote, price, or fee is irrelevant — fetch fresh.
+
+**Never invent a quote.** Without a `quote_id` and `receive_amount` returned
+this turn, you do not have a quote. Say so and re-quote.
+
+## Asset codes (canonical)
+
+Only these codes are accepted:
+
+- `BTC` (Bitcoin, amounts always in satoshis)
+- `USDT` (Tether) — **not** `USD`, **not** `tether`
+- `XAUT` (Tether Gold) — **not** `XAU`, **not** `gold`
+
+When the user types `USD` they almost always mean `USDT` — confirm before
+quoting. Same for `gold` → `XAUT`. Don't silently substitute.
+
+## Tools
+
+### `kaleidoswap_get_pairs` — no args
+Use when the user asks "what can I trade", "list pairs", "what's available",
+or before quoting an unfamiliar pair.
+
+### `kaleidoswap_get_quote` — REQUIRES `amount`
+Required args: `from_asset` AND `to_asset` AND `amount`. The maker rejects
+calls missing any of these.
+
+**If the user didn't give an amount, ASK for it. Do not call the tool with
+from/to alone.**
+
+Examples:
+- "Quote 100k sats to USDT" → `{from_asset: "BTC", to_asset: "USDT", amount: 100000}`
+- "What's the USDT/BTC rate?" → ask: "How many USDT do you want to swap?"
+  (no amount → no quote possible).
+- "Buy 50 USDT of BTC" → `{from_asset: "USDT", to_asset: "BTC", amount: 50}`
+  (USDT is what's being spent).
+
+### `kaleidoswap_place_order(quote_id)` 🔒 spend
+Only after `kaleidoswap_get_quote` returned a `quote_id` THIS turn, and only
+when the user has explicitly approved the amount + direction.
+
+### `kaleidoswap_get_order_status(order_id)`
+Poll after placing an order. Report status plainly — pending, settling,
+completed, failed.
 
 ## Flow
 
-1. **Price first.** Use `get_price` / `get_market_data` for context and
-   `kaleidoswap_get_quote` for an executable price before proposing a trade.
-2. **Confirm the trade.** Show pair, direction, amount in, expected amount out,
-   and fees. Wait for explicit approval before `kaleidoswap_place_order`.
-3. **Track it.** After placing, poll `kaleidoswap_get_order_status` until the
-   swap settles, then report the result and the new `kaleidoswap_get_position`.
-4. **Need inbound liquidity?** If a swap can't route for lack of a channel, use
-   `kaleidoswap_lsp_get_info` then `kaleidoswap_lsp_create_order` to buy one.
+1. **Pick a pair** — skip when obvious (`BTC/USDT`, `BTC/XAUT`).
+2. **Quote** — `kaleidoswap_get_quote`. REQUIRES amount.
+3. **Show + confirm** — surface pair, direction, amount in, expected out,
+   fees, slippage. **Never hide cost** — a small model must not abbreviate
+   fees out of the message.
+4. **Place** — spend-gated by the engine. The host pauses for the user.
+5. **Track** — poll `kaleidoswap_get_order_status` until it terminates.
+
+## Don'ts
 
-## Rules
+- Don't invent prices, quotes, quote_ids, or order_ids.
+- Don't reuse a number from a previous turn.
+- Don't describe how a tool works — call it.
+- Don't call `kaleidoswap_get_quote` with from/to only — ask for the amount.
+- Don't accept `XAU` as `XAUT` or `USD` as `USDT` silently — confirm.
+- Don't retry the same failing tool call in a loop. If a call fails, read the
+  error and either ask the user, fix the args, or stop.
 
-- Never trade on a stale quote — re-quote if the user hesitates.
-- Surface slippage and fees explicitly; small local models must not hide cost.
+For the atomic-swap flow (trust-minimised cross-asset swap that the maker
+can't settle from balance), use the `kaleido-trading` atomic recipe — the
+agentic chain is not safe to plan on a 0.6B model.

package/skills/merchant-finder/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: merchant-finder
+description: "Find Bitcoin-accepting merchants near the user using live BTC Map data and the device's real location. Triggers when the user asks where to spend Bitcoin, for a shop, store, restaurant, cafe, bar, or ATM that accepts Bitcoin, or for merchants nearby."
+tools: find_merchant_locations, get_merchant_info
+triggers: merchant, merchants, shop, shops, store, stores, restaurant, restaurants, cafe, cafes, bar, bars, atm, atms, accept, accepts, accepting, nearby, near me, around, place, places, spend, find, pizza, food, coffee, bitcoin map, btcmap
+metadata:
+  author: kaleidoswap
+  version: "0.2.0"
+  homepage: "https://btcmap.org"
+---
+
+# Merchant finder
+
+Discover places that accept Bitcoin payments — cafés, restaurants, bars, shops,
+and ATMs. Live BTC Map data when the host injects a fetcher + location;
+otherwise a small offline list keeps the skill answerable.
+
+## Critical rule — never answer from memory
+
+You have **no knowledge of any merchant**. Every place, name, address and
+distance in your reply MUST come from a `find_merchant_locations` result
+returned in the CURRENT turn. **Call `find_merchant_locations` for every
+place question**, even if a similar question was answered earlier — do NOT
+reuse or adapt a previous answer. Never invent a merchant.
+
+## How to call the tools
+
+1. **Start with `find_merchant_locations`.** Pass ONLY the fields the user
+   actually named — do not invent constraints:
+
+   - `query` — a specific thing the user named (e.g. `"tapas"`, `"coffee"`,
+     `"pizza"`). Omit when they only said "near me" or only named a place.
+
+   - `category` — must be EXACTLY one of: `restaurant`, `cafe`, `bar`, `shop`,
+     `grocery`, `lodging`, `atm`. **Anything else is invalid — leave it empty.**
+     The words "merchant", "merchants", "place", "places", "store", "stores"
+     are NOT categories — they're the generic noun for what you're searching
+     for, so they belong in `query` at best, never in `category`.
+
+   - `near_address` — a city, neighbourhood, or address (e.g. `"Milan"`,
+     `"Bitcoin Beach, El Salvador"`). Use this any time the user names a
+     location instead of "near me".
+
+   - `radius_km` — **omit unless the user names a specific number.** The
+     default (5 km) is a sensible search radius for a city. Don't pick a
+     small radius (1, 2, 3) yourself — city-wide searches need 5+.
+
+   - `limit` — 1–20, default 10. Omit unless the user names a count.
+
+   Examples (positive):
+   - "where can I spend btc near me" → `find_merchant_locations({})`
+   - "find merchants in Milan" → `find_merchant_locations({ near_address: "Milan" })`
+     ↑ no `category` — "merchants" is NOT a category.
+   - "cafes in Lisbon" → `find_merchant_locations({ category: "cafe", near_address: "Lisbon" })`
+   - "pizza places in Switzerland that take bitcoin" →
+     `find_merchant_locations({ query: "pizza", near_address: "Switzerland" })`
+     ↑ "places" is NOT a category — pizza goes in `query`.
+   - "lightning bars in NYC, within 2 km" →
+     `find_merchant_locations({ category: "bar", near_address: "New York", radius_km: 2 })`
+     ↑ user explicitly said "2 km" → set radius_km.
+
+   Examples (anti — do NOT do these):
+   - ❌ `category: "merchant"` (not a category)
+   - ❌ `category: "place"` (not a category)
+   - ❌ `radius_km: 2` when the user didn't say "2 km" — you're picking a
+     too-small radius and the result will be empty.
+
+2. **Present the results.** Each row carries:
+   - `name`, `category`, `address`
+   - `distance_m` when present — show in metres or km
+   - `accepts_bitcoin` / `accepts_lightning` — relevant because Lightning is
+     fastest for small payments
+   - `phone`, `website`, `opening_hours` when present — surface if asked
+
+3. **Use `get_merchant_info` only when** the user asks for more detail on one
+   specific result. Pass `merchant_id` (preferred) or `merchant_name`.
+
+## Reply style
+
+- Be concise. One line per merchant works:
+  `Name — category, address (X m away, accepts: lightning, onchain)`.
+- If the result `source` is `offline`, say so plainly — it means the live
+  BTC Map fetch wasn't available, so the list is limited.
+- If `find_merchant_locations` returns zero merchants, say so — don't invent
+  places. Suggest widening `radius_km` or trying `near_address`.
+- When the user says "near me" and `precise_location` is false, mention which
+  fallback location was used so they know it's not their actual GPS.

package/skills/paid-data/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: paid-data
+description: Fetch premium or paywalled data that requires a small Lightning (L402) payment — paid feeds, gated APIs, unlockable resources. Triggers when the user wants premium, paid, or unlockable data behind an L402 paywall.
+tools: fetch_paid_resource
+triggers: premium, paid, l402, feed, subscription, unlock, paywall
+---
+
+# Paid data
+
+Fetch L402-paywalled resources, paying small Lightning invoices automatically
+with `fetch_paid_resource`. Small amounts pay without prompting (capped);
+anything larger is declined. Tell the user what was paid and what was returned.

package/skills/wallet-assistant/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: wallet-assistant
+description: Everyday wallet tasks on this phone — check the BTC/asset balance, create an invoice to receive, send a payment, look up a contact, get the BTC price, or convert a fiat amount to sats. Triggers when the user asks about their balance, wants to receive or send money, pay an invoice, or pay a contact.
+tools: get_balances, get_price, fiat_to_sats, resolve_contact, send_payment, rln_pay_invoice, rln_create_ln_invoice, spark_create_invoice
+triggers: balance, pay, send, receive, address, invoice, transactions, contact, funds, money, price, sats, eur, gbp
+---
+
+# Wallet assistant
+
+You operate the user's on-device multi-L2 Bitcoin wallet. ALWAYS use a tool to
+get real data — NEVER invent a balance, address, amount, price, or result.
+
+## Critical rules
+
+You have no knowledge of balances, prices, addresses, or invoices. Every value
+in your reply MUST come from a tool result returned in the CURRENT turn — do
+not reuse a number from a previous turn.
+
+When a tool returns multiple fields, **report all the load-bearing ones**:
+- `get_balances` may return `{confirmed, pending, total}` — when `pending`
+  is non-zero, report BOTH. `confirmed` is spendable; `pending` is settling
+  and is NOT spendable yet. The user needs to know the difference.
+- `fiat_to_sats` returns `{sats}` plus a `note` when the currency was an
+  approximation — surface the note.
+
+## Rules
+
+- Balance / "how much do I have" → call `get_balances`, then state the number.
+- Receive / "an invoice for N sats" → call `rln_create_ln_invoice` (or
+  `spark_create_invoice`) with the amount.
+- Price → `get_price`. "How many sats is 3 EUR" → `fiat_to_sats`.
+- Pay a Lightning invoice → `rln_pay_invoice`.
+- Send to a person/amount → first `resolve_contact` (and `fiat_to_sats` if the
+  amount is in fiat), then `send_payment` with the amount in sats and the
+  recipient. State the amount and destination; the app asks the user to confirm
+  before it sends.
+
+Keep replies short, but never drop a balance component or a fee.

package/src/capabilities.ts

@@ -25,6 +25,10 @@ export interface MindCapabilities {
   memory: boolean;
   /** Semantic recall for memory (needs embeddings). */
   semanticMemory: boolean;
+  /** Embedding-only dedup of near-duplicate memories (zero inference — mobile-safe). */
+  dedupeMemory: boolean;
+  /** LLM merge of near-duplicate memories (an extra inference — capable/delegated only). */
+  mergeMemory: boolean;
   /** Retrieval-augmented generation (needs embeddings + enough RAM/context). */
   rag: boolean;
   /** Token budget for injected system context. */
@@ -48,6 +52,12 @@ export function capabilityProfile(input: CapabilityInput): MindCapabilities {
   const memory = budget >= 256;
   const semanticMemory = memory && hasEmb;
 
+  // Consolidation: embedding-only dedup is cheap (no inference) — on wherever
+  // semantic memory is. The LLM merge costs an extra inference, so reserve it
+  // for delegated or roomy on-device setups; never run it on a tiny phone model.
+  const dedupeMemory = semanticMemory;
+  const mergeMemory = dedupeMemory && (input.delegated || (ramGb >= 4 && ctx >= 4096));
+
   // RAG is the expensive one: needs embeddings, a non-tiny context window, and
   // (on-device) enough RAM to hold an embedding model + index.
   const rag = hasEmb && ctx >= 4096 && (input.delegated || ramGb >= 3);
@@ -59,6 +69,8 @@ export function capabilityProfile(input: CapabilityInput): MindCapabilities {
   return {
     memory,
     semanticMemory,
+    dedupeMemory,
+    mergeMemory,
     rag,
     contextBudgetTokens: budget,
     topKMemory,

package/src/context/context.test.ts

@@ -60,18 +60,22 @@ describe('ContextBuilder', () => {
 });
 
 describe('capabilityProfile', () => {
-  it('low-end phone: memory yes, RAG no', () => {
+  it('low-end phone: memory yes, RAG no, dedup yes but no LLM merge', () => {
     const c = capabilityProfile({ ramBytes: 2 * 1024 ** 3, modelCtxTokens: 2048, hasEmbeddings: true });
     expect(c.memory).toBe(true);
     expect(c.rag).toBe(false); // ctx too small + low RAM
     expect(c.topKRag).toBe(0);
+    expect(c.dedupeMemory).toBe(true); // embedding-only dedup is mobile-safe
+    expect(c.mergeMemory).toBe(false); // never run merge inference on a tiny phone
   });
 
-  it('desktop / delegated: RAG on', () => {
+  it('desktop / delegated: RAG on, memory merge on', () => {
     const c = capabilityProfile({ modelCtxTokens: 8192, hasEmbeddings: true, delegated: true });
     expect(c.rag).toBe(true);
     expect(c.topKRag).toBeGreaterThan(0);
     expect(c.semanticMemory).toBe(true);
+    expect(c.dedupeMemory).toBe(true);
+    expect(c.mergeMemory).toBe(true);
   });
 
   it('no embeddings → no RAG, no semantic memory', () => {

package/src/engine.ts

@@ -35,6 +35,11 @@ export interface AgenticOptions {
   onStart?: (requestId: string, turn: number) => void;
   /** Fired when the model requests a tool, before it executes. */
   onToolCall?: (call: { name: string; arguments: Record<string, unknown> }, turn: number) => void;
+  /**
+   * Fired after a tool returns (success OR error — errors arrive as `{error}`).
+   * Useful for surfacing the raw response back to the user in a debug UI.
+   */
+  onToolResult?: (event: { name: string; arguments: Record<string, unknown>; result: unknown }, turn: number) => void;
   /** Human-in-the-loop gate for tools flagged requiresConfirmation. */
   onConfirm?: (call: { name: string; arguments: Record<string, unknown> }) => Promise<ConfirmDecision>;
   /**
@@ -127,6 +132,7 @@ export class Engine {
         }
 
         executed.push({ name: call.name, arguments: call.arguments, result });
+        opts.onToolResult?.({ name: call.name, arguments: call.arguments, result }, turn);
         history.push({
           role: 'tool',
           content: typeof result === 'string' ? result : JSON.stringify(result),