@kaleidorg/mind 0.2.0 → 0.3.0

package/src/wallet/confirm.ts

@@ -0,0 +1,74 @@
+/**
+ * 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: Record<string, string> = {
+  spark: 'Spark',
+  rln: 'RLN',
+  arkade: 'Arkade',
+  liquid: 'Liquid',
+};
+
+/** Group an integer with thousands separators, locale-independently (test-stable). */
+function fmtNum(n: number): string {
+  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: string): boolean {
+  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: string): string {
+  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: string, args: Record<string, unknown>): string {
+  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: unknown) => `${fmtNum(Number(v))} sats`;
+const asset = (amount: unknown, ticker: unknown) => `${fmtNum(Number(amount))} ${String(ticker)}`;
+
+/** A spoken confirmation ending in "Confirm?", or null for non-spend tools. */
+export function confirmReadback(call: { name: string; arguments: Record<string, unknown> }): string | null {
+  const { name, arguments: a } = call;
+  const to = (k = 'to') => shortRef(String(a[k] ?? ''));
+  const ask = (s: string) => `${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;
+  }
+}

package/skills/kaleido-wallet/SKILL.md

@@ -1,28 +0,0 @@
----
-name: kaleido-wallet
-description: "Manage a KaleidoSwap Lightning + RGB wallet: check BTC and asset balances, get a receive address, create or pay Lightning invoices, send on-chain BTC, open or list channels. Triggers when the user asks about their balance, wants to receive or send funds, pay an invoice, or manage Lightning channels."
-tools: wdk_get_balances, wdk_get_asset_balance, wdk_get_address, wdk_create_ln_invoice, wdk_pay_invoice, wdk_send_btc, wdk_list_channels, wdk_open_channel, wdk_get_node_info
-triggers: balance, receive, address, send, pay, invoice, channel, deposit, withdraw, funds
-metadata:
-  author: kaleidoswap
-  version: "0.1.0"
-  surface: "kaleido-mcp (WDK node)"
----
-
-# KaleidoSwap wallet
-
-Operate the user's KaleidoSwap node (Lightning + RGB assets) through the
-`wdk_*` MCP tools.
-
-## Rules
-
-- **Read before you write.** Check the balance (`wdk_get_balances`) before any
-  send or channel open, and confirm the node is healthy (`wdk_get_node_info`).
-- **Confirm every spend.** State the amount, destination, and resulting balance,
-  then wait for explicit approval before calling `wdk_send_btc`,
-  `wdk_pay_invoice`, or `wdk_open_channel`.
-- **Match the rail to the asset.** Lightning for fast BTC/asset payments,
-  on-chain for settlement or channel funding. Use `wdk_get_asset_balance` for
-  RGB assets (USDT, XAUT, …).
-- Never reveal seeds or private keys — this skill operates a node, it is not a
-  key vault.