@kaleidorg/mind 0.1.0 → 0.3.0

package/dist/funnel.js

@@ -0,0 +1,195 @@
+/**
+ * Funnel — the tiered agent loop (T0 fast-path → T2 recipe → T1 agentic).
+ *
+ * This is the mobile-optimized funnel from the roadmap, lifted out of the
+ * hosts so every surface (rate chat + voice, desktop provider, agent) runs
+ * the SAME routing:
+ *
+ *   request
+ *     ├─ T0  deterministic fast-path  (no LLM)        balance / address / price
+ *     ├─ T2  recipe multi-step        (~1 inference)  "pay bob 3 EUR"
+ *     └─ T1  skill-scoped agentic loop                everything else
+ *
+ * Hosts inject the provider, the tool registry, and a `getSettings` closure
+ * read fresh each turn — so user-tunable settings (persona, history length,
+ * memory/RAG toggles, disabled skills) never require rebuilding the funnel
+ * or dropping host state like an embedded RAG index.
+ *
+ * Safety is unchanged from the Engine: spend tools are confirmation-gated by
+ * the contract; with no `onConfirm` the gate fails closed.
+ */
+import { Engine } from './engine.js';
+import { FastPath, WALLET_FAST_INTENTS } from './fastpath/fastpath.js';
+import { RecipeRegistry, runRecipe } from './recipe/runner.js';
+import { paymentsRecipe } from './recipe/payments.js';
+import { receiveRecipe } from './recipe/receive.js';
+import { assetSendRecipe } from './recipe/asset-send.js';
+import { SkillRegistry } from './skills/registry.js';
+/** Base system prompt for the wallet assistant. Hosts may override. */
+export const DEFAULT_WALLET_SYSTEM = [
+    'You are KaleidoSwap, a concise, privacy-first assistant running inside a',
+    'non-custodial Bitcoin, Lightning and RGB wallet.',
+    '',
+    'CORE RULES (these override every skill instruction):',
+    "1. If a tool can answer the user's question, CALL IT. Never describe how a",
+    "   tool works (\"the pairs are listed using kaleidoswap_get_pairs\") — calling",
+    '   the tool IS the answer.',
+    '2. Never invent a balance, address, amount, price, quote, fee, pair, or any',
+    "   other value. Every number or identifier in your reply MUST come from a tool",
+    '   result returned in the CURRENT turn.',
+    '3. Never reuse a number, name, or detail from a previous turn unless the user',
+    '   is explicitly asking about that earlier result. Each new question gets a',
+    '   fresh tool call.',
+    '4. If a tool needs a required argument the user did not give (e.g. an amount',
+    "   for a quote), ASK for it. Do not invent values. Do not call the tool with",
+    '   the required field missing.',
+    '5. All BTC amounts are in satoshis. Asset codes are case-insensitive but the',
+    '   canonical forms are BTC, USDT, XAUT — do not silently shorten to USD, XAU.',
+    '',
+    'Keep replies short and friendly. When a tool returns multiple fields, surface',
+    "the ones that matter — never collapse a structured result to a single number",
+    'when other fields are non-zero or safety-relevant (e.g. pending balances,',
+    'fees, slippage).',
+].join('\n');
+/** Tools that stay available even when a skill narrows the set. */
+const AMBIENT_MEMORY = ['remember', 'recall'];
+const AMBIENT_RAG = ['search_knowledge'];
+const DEFAULT_HISTORY = 8;
+function defaultRenderFast(intent, r) {
+    if (intent === 'balance') {
+        const sats = Number(r?.total_sats ?? 0);
+        const n = r?.layers?.length ?? 0;
+        return `You have ${sats.toLocaleString()} sats${n > 1 ? ` across ${n} layers` : ''}.`;
+    }
+    if (intent === 'address') {
+        return r?.address ? `Here's your receive address:\n\n\`${r.address}\`` : 'No address available right now.';
+    }
+    return `Bitcoin is $${Number(r?.price_usd ?? 0).toLocaleString()}.`;
+}
+export class Funnel {
+    provider;
+    registry;
+    engine;
+    fastPath;
+    recipes;
+    allSkills;
+    system;
+    getSettings;
+    renderFast;
+    log;
+    /** Skill registry, rebuilt only when the disabled-skills set changes. */
+    skillsCache = null;
+    constructor(opts) {
+        this.provider = opts.provider;
+        this.registry = opts.tools;
+        this.engine = new Engine({
+            provider: opts.provider,
+            tools: opts.tools,
+            defaultMaxTurns: opts.maxTurns ?? 5,
+        });
+        this.fastPath = new FastPath(opts.fastIntents ?? WALLET_FAST_INTENTS);
+        this.recipes = new RecipeRegistry(opts.recipes ?? [assetSendRecipe, paymentsRecipe, receiveRecipe]);
+        this.allSkills = opts.skills ?? [];
+        this.system = opts.system ?? DEFAULT_WALLET_SYSTEM;
+        this.getSettings = opts.getSettings ?? (() => ({}));
+        this.renderFast = opts.renderFast ?? defaultRenderFast;
+        this.log = opts.log ?? (() => { });
+    }
+    /** Skills currently enabled (e.g. for a skills sheet). */
+    listSkills() {
+        return this.skillsFor(this.getSettings().disabledSkills).list();
+    }
+    skillsFor(disabled = []) {
+        const key = [...disabled].sort().join(',');
+        if (this.skillsCache?.key !== key) {
+            this.skillsCache = {
+                key,
+                reg: new SkillRegistry(this.allSkills.filter((s) => !disabled.includes(s.name))),
+            };
+        }
+        return this.skillsCache.reg;
+    }
+    async runTurn(text, cbs = {}) {
+        const settings = this.getSettings();
+        // ── T0: deterministic fast-path (no LLM) ──
+        // Only fires when the host's registry actually implements the intent's
+        // tool — a partial tool surface (e.g. desktop without the core aggregate
+        // helpers) falls through to the agentic tier instead of erroring.
+        const fast = this.fastPath.select(text);
+        if (fast && (await this.registry.getDef(fast.tool))) {
+            this.log(`tier=fast-path → ${fast.tool}`);
+            const r = await this.registry.execute(fast.tool, fast.args);
+            return { text: this.renderFast(fast.intent.name, r), tier: 'fast', intent: fast.intent.name, data: r };
+        }
+        // ── T2: recipe multi-step — fires only when the recipe is confident given
+        // its extracted slots (payments need a recipient; receive always fires),
+        // and the registry implements the recipe's final action.
+        const recipe = this.recipes.select(text);
+        const slots = recipe?.extract?.(text) ?? null;
+        const fires = !!recipe &&
+            !!slots &&
+            (recipe.confident ? recipe.confident(slots) : Object.keys(slots).length > 0) &&
+            !!(await this.registry.getDef(recipe.final.tool));
+        if (recipe && fires) {
+            this.log(`tier=recipe:${recipe.name} slots=${JSON.stringify(slots)}`);
+            const res = await runRecipe(recipe, text, {
+                provider: this.provider,
+                tools: this.registry,
+                onConfirm: cbs.onConfirm,
+                onStep: (name) => {
+                    this.log(`step ${name}`);
+                    cbs.onStep?.(name);
+                },
+            });
+            return { text: res.text, tier: 'recipe' };
+        }
+        // ── T1: skill-scoped agentic loop ──
+        const skills = this.skillsFor(settings.disabledSkills);
+        const skill = skills.select(text);
+        const base = settings.persona ? `${this.system}\n\n## Your persona\n${settings.persona}` : this.system;
+        const { system, allowedTools } = skills.compose(base, skill);
+        // Ambient tools stay available even when a skill narrows the set — gated
+        // by the user's memory/knowledge toggles (default on).
+        const memoryOn = settings.memoryEnabled !== false;
+        const ragOn = settings.ragEnabled !== false;
+        const ambient = [...(memoryOn ? AMBIENT_MEMORY : []), ...(ragOn ? AMBIENT_RAG : [])];
+        const disabledAmbient = [...(memoryOn ? [] : AMBIENT_MEMORY), ...(ragOn ? [] : AMBIENT_RAG)];
+        let scoped;
+        if (allowedTools) {
+            scoped = [...new Set([...allowedTools, ...ambient])];
+        }
+        else if (disabledAmbient.length) {
+            // No skill matched but a toggle is off: expose everything except the
+            // disabled ambient tools (the sources stay mounted — no rebuild).
+            const all = (await this.registry.listTools()).map((t) => t.name);
+            scoped = all.filter((n) => !disabledAmbient.includes(n));
+        }
+        // Trim history so the prompt (system + skill + tools + history) stays
+        // within the small on-device model's context window.
+        const keep = settings.historyLength ?? DEFAULT_HISTORY;
+        const history = (cbs.history ?? []).slice(-keep);
+        const messages = [
+            { role: 'system', content: system },
+            ...history,
+            { role: 'user', content: text },
+        ];
+        this.log(`tier=agentic skill=${skill?.name ?? 'none'} tools=[${(scoped ?? ['all']).join(',')}]`);
+        const res = await this.engine.runAgentic(messages, {
+            allowedTools: scoped,
+            onStart: (requestId) => cbs.onStart?.(requestId),
+            onToken: cbs.onToken,
+            onToolCall: (call) => {
+                this.log(`tool ${call.name} ${JSON.stringify(call.arguments)}`);
+                // getDef is async; fire-and-forget so the loop is never blocked on UI.
+                void this.registry
+                    .getDef(call.name)
+                    .then((def) => cbs.onToolCall?.(call, { requiresConfirmation: !!def?.requiresConfirmation }))
+                    .catch(() => cbs.onToolCall?.(call, { requiresConfirmation: false }));
+            },
+            onToolResult: cbs.onToolResult,
+            onConfirm: cbs.onConfirm,
+        });
+        return { text: res.text ?? '', tier: 'agentic', toolCalls: res.toolCalls, turns: res.turns };
+    }
+}
+//# sourceMappingURL=funnel.js.map

package/dist/funnel.js.map

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

package/dist/index.d.ts

@@ -15,8 +15,52 @@ export type { InProcessTool } from './tools/in-process.js';
 export { ToolRegistry } from './tools/registry.js';
 export { createL402ToolSource, parseL402Challenge, bolt11AmountSats, } from './tools/l402.js';
 export type { L402Options, L402PayResult } from './tools/l402.js';
+export { createCliToolSource, isAllowed } from './tools/cli.js';
+export type { CliToolOptions, CommandRunner, CommandResult } from './tools/cli.js';
+export { WALLET_TOOLS, WALLET_LAYERS, SPEND_TOOLS, isSpendTool, getWalletTool, walletTools, toToolDefs, bindWalletTools, } from './wallet/contract.js';
+export type { WalletLayer, WalletToolDef, WalletHandler, BindWalletOptions, } from './wallet/contract.js';
+export { confirmReadback } from './wallet/confirm.js';
+export { KALEIDOSWAP_TOOLS, KALEIDOSWAP_SPEND_TOOLS, isKaleidoswapSpendTool, getKaleidoswapTool, kaleidoswapTools, bindKaleidoswapTools, } from './kaleidoswap/contract.js';
+export type { KaleidoswapGroup, KaleidoswapToolDef, KaleidoswapHandler, BindKaleidoswapOptions, } from './kaleidoswap/contract.js';
+export { LSPS1_TOOLS, LSPS1_SPEND_TOOLS, isLsps1SpendTool, getLsps1Tool, bindLsps1Tools, } from './lsps1/contract.js';
+export type { Lsps1ToolDef, Lsps1Handler, BindLsps1Options, } from './lsps1/contract.js';
+export { kaleidoswapAtomicRecipe } from './recipe/kaleidoswap-atomic.js';
+export { runRecipe, extractSlots, RecipeRegistry } from './recipe/runner.js';
+export type { RunRecipeOptions } from './recipe/runner.js';
+export { paymentsRecipe, extractPayment } from './recipe/payments.js';
+export { swapRecipe, extractSwap } from './recipe/swap.js';
+export { receiveRecipe, extractReceive } from './recipe/receive.js';
+export { assetSendRecipe, extractAssetSend } from './recipe/asset-send.js';
+export type { Recipe, RecipeStep, RecipeSlot, RecipeContext, RecipeResult, RecipeStatus } from './recipe/types.js';
+export { FastPath, WALLET_FAST_INTENTS } from './fastpath/fastpath.js';
+export type { FastIntent, FastHit } from './fastpath/fastpath.js';
+export { InMemoryMemoryStore } from './memory/store.js';
+export type { MemoryStoreOptions } from './memory/store.js';
+export { createMemoryToolSource } from './memory/tool.js';
+export type { AgentProfile, MemoryConsolidation, MemoryItem, MemoryKind, MemoryQuery, MemoryStore, MemoryIO, NewMemory, } from './memory/types.js';
+export { Retriever, chunkText } from './rag/retriever.js';
+export type { RetrieverOptions } from './rag/retriever.js';
+export { InMemoryVectorStore, cosineSimilarity } from './rag/vector-store.js';
+export { createRagToolSource } from './rag/tool.js';
+export type { RagToolOptions } from './rag/tool.js';
+export type { EmbeddingProvider, Chunk, RetrievedChunk, RagDocument, VectorStore, VectorStoreIO, } from './rag/types.js';
+export { ContextBuilder } from './context/builder.js';
+export type { ContextBuilderOptions, BuildInput } from './context/builder.js';
+export { estimateTokens, clampToTokens, contextBudgetTokens, } from './context/budget.js';
+export type { BudgetReserves } from './context/budget.js';
+export { capabilityProfile } from './capabilities.js';
+export type { CapabilityInput, MindCapabilities } from './capabilities.js';
+export { BITCOIN_COPILOT_DOCS } from './knowledge/bitcoin-copilot.js';
+export { walletHistoryToDocuments, contactsToDocuments } from './knowledge/wallet.js';
+export type { WalletTx, Contact } from './knowledge/wallet.js';
+export { merchantsToDocuments } from './knowledge/merchants.js';
+export type { Merchant } from './knowledge/merchants.js';
+export { createBtcMapToolSource, BTC_MAP_SAMPLE } from './knowledge/btc-map.js';
+export type { BtcMapToolOptions, BtcMapMerchant, BtcMapFetch, LocationProvider, LatLng, } from './knowledge/btc-map.js';
 export { Engine } from './engine.js';
 export type { EngineOptions, AgenticOptions, AgenticResult } from './engine.js';
+export { Funnel, DEFAULT_WALLET_SYSTEM } from './funnel.js';
+export type { FunnelOptions, FunnelSettings, FunnelCallbacks, FunnelResult } from './funnel.js';
 export { SkillRegistry, parseSkill, keywordSelector, READ_REFERENCE_TOOL, } from './skills/registry.js';
 export { createSkillReferenceToolSource } from './skills/reference-source.js';
 export { skillsFromBundle } from './skills/bundle.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,IAAI,EACJ,OAAO,EACP,OAAO,EACP,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE/E,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EACL,aAAa,EACb,UAAU,EACV,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -10,7 +10,43 @@
 export { InProcessToolSource } from './tools/in-process.js';
 export { ToolRegistry } from './tools/registry.js';
 export { createL402ToolSource, parseL402Challenge, bolt11AmountSats, } from './tools/l402.js';
+export { createCliToolSource, isAllowed } from './tools/cli.js';
+// ── Multi-L2 wallet tool contract (single source of truth) ─────────────────
+export { WALLET_TOOLS, WALLET_LAYERS, SPEND_TOOLS, isSpendTool, getWalletTool, walletTools, toToolDefs, bindWalletTools, } from './wallet/contract.js';
+export { confirmReadback } from './wallet/confirm.js';
+// ── KaleidoSwap maker tool contract (single source of truth) ────────────────
+export { KALEIDOSWAP_TOOLS, KALEIDOSWAP_SPEND_TOOLS, isKaleidoswapSpendTool, getKaleidoswapTool, kaleidoswapTools, bindKaleidoswapTools, } from './kaleidoswap/contract.js';
+// ── LSPS1 (Lightning Service Provider channel orders) ───────────────────────
+export { LSPS1_TOOLS, LSPS1_SPEND_TOOLS, isLsps1SpendTool, getLsps1Tool, bindLsps1Tools, } from './lsps1/contract.js';
+// ── KaleidoSwap atomic-swap recipe (opt-in — register via Funnel.recipes) ──
+export { kaleidoswapAtomicRecipe } from './recipe/kaleidoswap-atomic.js';
+// ── Recipes (mobile multi-step: "recipes, not planning") ───────────────────
+export { runRecipe, extractSlots, RecipeRegistry } from './recipe/runner.js';
+export { paymentsRecipe, extractPayment } from './recipe/payments.js';
+export { swapRecipe, extractSwap } from './recipe/swap.js';
+export { receiveRecipe, extractReceive } from './recipe/receive.js';
+export { assetSendRecipe, extractAssetSend } from './recipe/asset-send.js';
+// ── Tier-0 deterministic fast-path (no LLM) ────────────────────────────────
+export { FastPath, WALLET_FAST_INTENTS } from './fastpath/fastpath.js';
+// ── Memory (soul + recall) ───────────────────────────────────────────────
+export { InMemoryMemoryStore } from './memory/store.js';
+export { createMemoryToolSource } from './memory/tool.js';
+// ── RAG ──────────────────────────────────────────────────────────────────
+export { Retriever, chunkText } from './rag/retriever.js';
+export { InMemoryVectorStore, cosineSimilarity } from './rag/vector-store.js';
+export { createRagToolSource } from './rag/tool.js';
+// ── Context assembly + hardware budget ─────────────────────────────────────
+export { ContextBuilder } from './context/builder.js';
+export { estimateTokens, clampToTokens, contextBudgetTokens, } from './context/budget.js';
+export { capabilityProfile } from './capabilities.js';
+// ── Knowledge packs + corpus adapters (for RAG) ────────────────────────────
+export { BITCOIN_COPILOT_DOCS } from './knowledge/bitcoin-copilot.js';
+export { walletHistoryToDocuments, contactsToDocuments } from './knowledge/wallet.js';
+export { merchantsToDocuments } from './knowledge/merchants.js';
+export { createBtcMapToolSource, BTC_MAP_SAMPLE } from './knowledge/btc-map.js';
 export { Engine } from './engine.js';
+// ── Funnel (T0 fast-path → T2 recipe → T1 agentic — the tiered agent) ───────
+export { Funnel, DEFAULT_WALLET_SYSTEM } from './funnel.js';
 export { SkillRegistry, parseSkill, keywordSelector, READ_REFERENCE_TOOL, } from './skills/registry.js';
 export { createSkillReferenceToolSource } from './skills/reference-source.js';
 export { skillsFromBundle } from './skills/bundle.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EACL,aAAa,EACb,UAAU,EACV,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/kaleidoswap/contract.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Canonical KaleidoSwap tool contract — the single source of truth for the
+ * agent-facing tools that drive the KaleidoSwap maker.
+ *
+ * Every surface implements THESE EXACT tools, only the transport differs:
+ *   - mobile  → in-process handlers over the WDK protocol package
+ *               (`@kaleidorg/wdk-protocol-swap-kaleidoswap`) via `bindKaleidoswapTools`
+ *   - desktop → HTTP / kaleido-mcp / kaleido-cli, also via `bindKaleidoswapTools`
+ *   - eval    → stub handlers, also via `bindKaleidoswapTools`
+ *
+ * Because the schemas are identical everywhere, skills are portable and the
+ * model comparison is honest. Tools are grouped (`market`, `orders`, `atomic`)
+ * so a host can expose a read-only subset for sandbox/eval modes.
+ *
+ * Spend tools (place an order, init/execute an atomic swap) carry
+ * `spend: true` → `requiresConfirmation: true`, so the Engine always pauses
+ * for the host's confirm gate before executing.
+ *
+ * Pure data — no deps, no fetch, RN-safe.
+ */
+import type { ToolDef } from '../types.js';
+import { InProcessToolSource } from '../tools/in-process.js';
+/** Functional grouping for selective binding (e.g. read-only sandbox). */
+export type KaleidoswapGroup = 'market' | 'orders' | 'atomic';
+export interface KaleidoswapToolDef extends ToolDef {
+    /** Functional group — lets a host expose a subset. */
+    group: KaleidoswapGroup;
+    /** Moves funds → confirmation-gated. */
+    spend?: boolean;
+}
+/**
+ * The canonical KaleidoSwap tool list. Schema is intentionally agent-facing —
+ * each host's adapter translates these args into the underlying transport's
+ * request body (maker REST JSON, WDK protocol calls, MCP, etc.).
+ */
+export declare const KALEIDOSWAP_TOOLS: KaleidoswapToolDef[];
+/** All tool names that move funds (confirmation-gated). */
+export declare const KALEIDOSWAP_SPEND_TOOLS: Set<string>;
+/** Quick lookup. */
+export declare function isKaleidoswapSpendTool(name: string): boolean;
+/** Quick lookup. */
+export declare function getKaleidoswapTool(name: string): KaleidoswapToolDef | undefined;
+/** Pick the contract tools for the given groups (all by default). */
+export declare function kaleidoswapTools(opts?: {
+    groups?: KaleidoswapGroup[];
+}): KaleidoswapToolDef[];
+/** A handler bound to one contract tool. Args validated by JSON schema upstream. */
+export type KaleidoswapHandler = (args: Record<string, unknown>) => Promise<unknown>;
+export interface BindKaleidoswapOptions {
+    /** Restrict the surface to a subset (e.g. read-only on eval). */
+    groups?: KaleidoswapGroup[];
+    /** Skip tools that have no handler instead of throwing (default false). */
+    allowMissing?: boolean;
+    /** ToolSource id for the registry (default 'kaleidoswap'). */
+    id?: string;
+}
+/**
+ * Bind contract tools to in-process handlers → an InProcessToolSource.
+ *
+ * The host is responsible for the actual transport (HTTP/WDK/CLI/MCP) — this
+ * function is a pure shape adapter that preserves names, descriptions,
+ * parameter schemas, and the spend gate.
+ *
+ *   const source = bindKaleidoswapTools({
+ *     kaleidoswap_get_quote: async (args) => makerSdk.quote(args),
+ *     kaleidoswap_place_order: async ({ quote_id }) => makerSdk.placeOrder({ quoteId: quote_id }),
+ *     // …
+ *   });
+ *   tools.register(source);
+ */
+export declare function bindKaleidoswapTools(handlers: Record<string, KaleidoswapHandler>, opts?: BindKaleidoswapOptions): InProcessToolSource;
+//# sourceMappingURL=contract.d.ts.map

package/dist/kaleidoswap/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/kaleidoswap/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IACjD,sDAAsD;IACtD,KAAK,EAAE,gBAAgB,CAAC;IACxB,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAsBD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAAkB,EA8EjD,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB,EAAE,GAAG,CAAC,MAAM,CAE/C,CAAC;AAEF,oBAAoB;AACpB,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,oBAAoB;AACpB,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE/E;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAC9B,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAAO,GACzC,kBAAkB,EAAE,CAItB;AAED,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAErF,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC5C,IAAI,GAAE,sBAA2B,GAChC,mBAAmB,CAkBrB"}

package/dist/kaleidoswap/contract.js

@@ -0,0 +1,125 @@
+/**
+ * Canonical KaleidoSwap tool contract — the single source of truth for the
+ * agent-facing tools that drive the KaleidoSwap maker.
+ *
+ * Every surface implements THESE EXACT tools, only the transport differs:
+ *   - mobile  → in-process handlers over the WDK protocol package
+ *               (`@kaleidorg/wdk-protocol-swap-kaleidoswap`) via `bindKaleidoswapTools`
+ *   - desktop → HTTP / kaleido-mcp / kaleido-cli, also via `bindKaleidoswapTools`
+ *   - eval    → stub handlers, also via `bindKaleidoswapTools`
+ *
+ * Because the schemas are identical everywhere, skills are portable and the
+ * model comparison is honest. Tools are grouped (`market`, `orders`, `atomic`)
+ * so a host can expose a read-only subset for sandbox/eval modes.
+ *
+ * Spend tools (place an order, init/execute an atomic swap) carry
+ * `spend: true` → `requiresConfirmation: true`, so the Engine always pauses
+ * for the host's confirm gate before executing.
+ *
+ * Pure data — no deps, no fetch, RN-safe.
+ */
+import { InProcessToolSource } from '../tools/in-process.js';
+function t(group, name, description, properties = {}, required = [], spend = false) {
+    return {
+        group,
+        name,
+        description,
+        spend,
+        requiresConfirmation: spend,
+        parameters: { type: 'object', properties, required },
+    };
+}
+/**
+ * The canonical KaleidoSwap tool list. Schema is intentionally agent-facing —
+ * each host's adapter translates these args into the underlying transport's
+ * request body (maker REST JSON, WDK protocol calls, MCP, etc.).
+ */
+export const KALEIDOSWAP_TOOLS = [
+    // ─── market (read) ─────────────────────────────────────────────────────
+    t('market', 'kaleidoswap_get_assets', 'List the assets KaleidoSwap supports — BTC plus the RGB assets the maker has inventory for (e.g. USDT, XAUT). Returns symbol, precision, and issuer/contract id. No args.'),
+    t('market', 'kaleidoswap_get_pairs', 'List the trading pairs currently quoted by the maker, with the latest bid/ask and the minimum/maximum executable size on each side. Use this before quoting to pick a valid pair. No args.'),
+    t('market', 'kaleidoswap_get_quote', 'Get an executable quote for swapping a specific amount on one pair. Returns a quote id (use it with place_order or atomic_init), the expected receive amount, fees, slippage, and how long the quote is valid for. Re-quote rather than reusing a stale id.', {
+        from_asset: { type: 'string', description: 'Asset to spend, e.g. "BTC" or "USDT".' },
+        to_asset: { type: 'string', description: 'Asset to receive, e.g. "USDT" or "BTC".' },
+        amount: { type: 'number', description: 'Amount of from_asset to swap. BTC is in satoshis; RGB assets use their asset-defined precision.' },
+        side: { type: 'string', enum: ['buy', 'sell'], description: 'Default "sell" (you sell from_asset). Use "buy" only when from_asset is the quote currency you spend to acquire to_asset.' },
+    }, ['from_asset', 'to_asset', 'amount']),
+    t('market', 'kaleidoswap_get_nodeinfo', "Get info about the maker's Lightning node — pubkey, host, port, connect URI. Useful before opening a channel or when the user wants to see the counterparty. No args."),
+    // ─── orders (orderbook / market-order flow) ─────────────────────────────
+    t('orders', 'kaleidoswap_place_order', 'Place an order using an executable quote. Returns an order id. SPEND: the host pauses for user confirmation before the maker is called. Use only after kaleidoswap_get_quote and only when the user has explicitly approved the amount + destination.', {
+        quote_id: { type: 'string', description: 'The quote id returned by kaleidoswap_get_quote (must still be valid).' },
+    }, ['quote_id'], 
+    /* spend */ true),
+    t('orders', 'kaleidoswap_get_order_status', 'Check the status of an order by id — pending / settling / completed / failed. Poll this after place_order until the order settles.', {
+        order_id: { type: 'string', description: 'The order id returned by kaleidoswap_place_order.' },
+    }, ['order_id']),
+    t('orders', 'kaleidoswap_get_order_history', "Get the user's recent KaleidoSwap orders for context (last N, paginated). Read-only.", {
+        limit: { type: 'number', description: 'Max rows (default 20, max 100).' },
+        cursor: { type: 'string', description: 'Pagination cursor from a previous call.' },
+    }),
+    // ─── atomic (the trust-minimised swap chain — used by the recipe) ───────
+    t('atomic', 'kaleidoswap_atomic_init', "Initialise an atomic swap from a quote. Requires the receiver's RGB/LN invoice so the maker can lock the outgoing leg. SPEND: confirmation-gated. Returns the maker's invoice for the user to pay and an atomic id to track.", {
+        quote_id: { type: 'string', description: 'The quote id from kaleidoswap_get_quote.' },
+        receive_invoice: { type: 'string', description: "The user's RGB or Lightning invoice for to_asset, created on the user's own node." },
+    }, ['quote_id', 'receive_invoice'], 
+    /* spend */ true),
+    t('atomic', 'kaleidoswap_atomic_execute', "Tell the maker to release the receive leg now that the user has paid the maker's invoice. SPEND: confirmation-gated (committing the swap). Returns an updated atomic status.", {
+        atomic_id: { type: 'string', description: 'The atomic id from kaleidoswap_atomic_init.' },
+    }, ['atomic_id'], 
+    /* spend */ true),
+    t('atomic', 'kaleidoswap_atomic_status', 'Poll the status of an atomic swap — pending_payment / paid / settling / completed / failed / expired. Use this in a loop after execute until it terminates.', {
+        atomic_id: { type: 'string', description: 'The atomic id from kaleidoswap_atomic_init.' },
+    }, ['atomic_id']),
+];
+/** All tool names that move funds (confirmation-gated). */
+export const KALEIDOSWAP_SPEND_TOOLS = new Set(KALEIDOSWAP_TOOLS.filter((t) => t.spend).map((t) => t.name));
+/** Quick lookup. */
+export function isKaleidoswapSpendTool(name) {
+    return KALEIDOSWAP_SPEND_TOOLS.has(name);
+}
+/** Quick lookup. */
+export function getKaleidoswapTool(name) {
+    return KALEIDOSWAP_TOOLS.find((t) => t.name === name);
+}
+/** Pick the contract tools for the given groups (all by default). */
+export function kaleidoswapTools(opts = {}) {
+    if (!opts.groups)
+        return [...KALEIDOSWAP_TOOLS];
+    const groups = new Set(opts.groups);
+    return KALEIDOSWAP_TOOLS.filter((x) => groups.has(x.group));
+}
+/**
+ * Bind contract tools to in-process handlers → an InProcessToolSource.
+ *
+ * The host is responsible for the actual transport (HTTP/WDK/CLI/MCP) — this
+ * function is a pure shape adapter that preserves names, descriptions,
+ * parameter schemas, and the spend gate.
+ *
+ *   const source = bindKaleidoswapTools({
+ *     kaleidoswap_get_quote: async (args) => makerSdk.quote(args),
+ *     kaleidoswap_place_order: async ({ quote_id }) => makerSdk.placeOrder({ quoteId: quote_id }),
+ *     // …
+ *   });
+ *   tools.register(source);
+ */
+export function bindKaleidoswapTools(handlers, opts = {}) {
+    const defs = kaleidoswapTools(opts);
+    const bound = [];
+    for (const def of defs) {
+        const handler = handlers[def.name];
+        if (!handler) {
+            if (opts.allowMissing)
+                continue;
+            throw new Error(`bindKaleidoswapTools: no handler for "${def.name}"`);
+        }
+        bound.push({
+            name: def.name,
+            description: def.description,
+            parameters: def.parameters,
+            requiresConfirmation: def.requiresConfirmation,
+            handler,
+        });
+    }
+    return new InProcessToolSource(opts.id ?? 'kaleidoswap', bound);
+}
+//# sourceMappingURL=contract.js.map

package/dist/kaleidoswap/contract.js.map

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

package/dist/knowledge/bitcoin-copilot.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Bitcoin-copilot knowledge pack — a curated, on-brand corpus to RAG over so an
+ * on-device assistant can answer Bitcoin / Lightning / RGB / KaleidoSwap
+ * questions privately. Ship it, ingest it with a Retriever, done.
+ *
+ * Concise + accurate. Extend or replace with your own docs (BOLT specs, RGB
+ * docs, app help, FAQs) — the format is just `RagDocument[]`.
+ */
+import type { RagDocument } from '../rag/types.js';
+export declare const BITCOIN_COPILOT_DOCS: RagDocument[];
+//# sourceMappingURL=bitcoin-copilot.d.ts.map

package/dist/knowledge/bitcoin-copilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin-copilot.d.ts","sourceRoot":"","sources":["../../src/knowledge/bitcoin-copilot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,eAAO,MAAM,oBAAoB,EAAE,WAAW,EAqK7C,CAAC"}