@kaleidorg/mind 0.1.0 → 0.2.0

package/dist/funnel.js

@@ -0,0 +1,175 @@
+/**
+ * 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. Use the provided tools to ' +
+    'take actions: pay invoices and contacts, create invoices, check balances. ' +
+    'Never invent a balance, address, amount or result — always call the ' +
+    'relevant tool and report what it returns. All BTC amounts are in satoshis. ' +
+    'Keep replies short and friendly.';
+/** 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 }));
+            },
+            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,44 @@ 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 { 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, 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 { 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":"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;AAClE,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGnF,OAAO,EACL,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,WAAW,EACX,UAAU,EACV,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC3E,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGnH,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,QAAQ,EACR,SAAS,GACV,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EACV,iBAAiB,EACjB,KAAK,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EACL,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACtF,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,YAAY,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGhF,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhG,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"}

package/dist/index.js

@@ -10,7 +10,35 @@
 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';
+// ── 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 { 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":"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;AAEzB,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhE,8EAA8E;AAC9E,OAAO,EACL,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,WAAW,EACX,UAAU,EACV,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAQ9B,8EAA8E;AAC9E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG3E,8EAA8E;AAC9E,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGvE,4EAA4E;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAW1D,4EAA4E;AAC5E,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAWpD,8EAA8E;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,8EAA8E;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,+EAA+E;AAC/E,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAG5D,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"}

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"}

package/dist/knowledge/bitcoin-copilot.js

@@ -0,0 +1,155 @@
+/**
+ * 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[]`.
+ */
+export const BITCOIN_COPILOT_DOCS = [
+    {
+        id: 'inbound-liquidity',
+        text: 'To RECEIVE Lightning payments you need inbound liquidity — remote balance ' +
+            'on a channel pointing at you. Brand-new wallets have none, so they can ' +
+            'send but not receive. Get inbound liquidity by buying a channel from an ' +
+            'LSP, or by receiving an on-chain deposit and swapping it into a channel.',
+        metadata: { topic: 'liquidity' },
+    },
+    {
+        id: 'outbound-liquidity',
+        text: 'Outbound liquidity is your local balance on a channel — what you can ' +
+            'spend over Lightning. You get it by funding a channel yourself or being ' +
+            'pushed funds. If you can receive but not send, you lack outbound liquidity.',
+        metadata: { topic: 'liquidity' },
+    },
+    {
+        id: 'channel-basics',
+        text: 'A Lightning channel is a 2-of-2 multisig funding output shared by two ' +
+            'peers. It lets them send instant, low-fee payments off-chain by updating ' +
+            'who owns how much, without touching the blockchain until the channel closes.',
+        metadata: { topic: 'lightning' },
+    },
+    {
+        id: 'onchain-vs-lightning',
+        text: 'On-chain Bitcoin transactions settle directly on the blockchain: final, ' +
+            'but slower and with miner fees. Lightning payments are instant and cheap ' +
+            'but require channels with liquidity. Use Lightning for spending, on-chain ' +
+            'for settlement and for funding channels.',
+        metadata: { topic: 'lightning' },
+    },
+    {
+        id: 'open-channel',
+        text: 'Opening a channel funds a 2-of-2 output on-chain; it confirms in one or ' +
+            'more blocks (or is usable immediately with 0-conf if the peer allows). ' +
+            'The funder gets outbound liquidity. To get inbound, buy a channel from an ' +
+            'LSP instead of opening your own.',
+        metadata: { topic: 'channels' },
+    },
+    {
+        id: 'lsp-lsps1',
+        text: 'An LSP (Lightning Service Provider) sells channels. With LSPS1 you place ' +
+            'a channel order: choose capacity and how much inbound liquidity you want, ' +
+            'pay the fee, and the LSP opens a channel to you — often 0-conf, so you can ' +
+            'receive right away. KaleidoSwap acts as an LSP.',
+        metadata: { topic: 'channels' },
+    },
+    {
+        id: 'atomic-swap',
+        text: 'An atomic (HTLC) swap exchanges two assets so that either both legs ' +
+            'happen or neither does — no counterparty can run off with your funds. ' +
+            'KaleidoSwap uses a 5-step HTLC taker flow for trustless swaps.',
+        metadata: { topic: 'swaps' },
+    },
+    {
+        id: 'submarine-swap',
+        text: 'A submarine swap moves value between on-chain Bitcoin and Lightning ' +
+            'atomically via an HTLC: send on-chain BTC and receive it on Lightning, or ' +
+            'vice-versa, with no custodian. Useful to refill inbound/outbound liquidity.',
+        metadata: { topic: 'swaps' },
+    },
+    {
+        id: 'rgb-assets',
+        text: 'RGB is a protocol for issuing assets — like USDT and XAUT — on top of ' +
+            'Bitcoin and Lightning. Validation is client-side, which keeps it private ' +
+            'and scalable. On KaleidoSwap you can hold and swap RGB assets.',
+        metadata: { topic: 'rgb' },
+    },
+    {
+        id: 'colored-channels',
+        text: 'A colored channel is a Lightning channel that also carries an RGB asset ' +
+            'balance, so you can send/receive USDT or XAUT over Lightning instantly. ' +
+            'Buying an asset channel from the LSP gives you inbound capacity for that asset.',
+        metadata: { topic: 'rgb' },
+    },
+    {
+        id: 'rgb-invoice',
+        text: 'An RGB invoice requests a specific asset and amount and includes a ' +
+            'blinded UTXO so the sender can transfer the asset privately. It differs ' +
+            'from a plain Lightning (BOLT11) invoice, which is for BTC.',
+        metadata: { topic: 'rgb' },
+    },
+    {
+        id: 'rfq-quote',
+        text: 'Before a swap, KaleidoSwap gives a quote via RFQ (request for quote): the ' +
+            'maker prices the pair (e.g. BTC/USDT) and returns the amount you will ' +
+            'receive and the fees. Quotes expire — re-quote if you wait.',
+        metadata: { topic: 'trading' },
+    },
+    {
+        id: 'maker-taker',
+        text: 'KaleidoSwap is maker-based: a maker provides liquidity and prices, you ' +
+            'are the taker who accepts a quote and executes the atomic swap. The maker ' +
+            'also runs the LSP that sells channels.',
+        metadata: { topic: 'trading' },
+    },
+    {
+        id: 'mpp',
+        text: 'Multi-path payments (MPP) split one Lightning payment across several ' +
+            'channels/routes so you can send more than any single channel allows. The ' +
+            'parts recombine at the destination atomically.',
+        metadata: { topic: 'lightning' },
+    },
+    {
+        id: 'lightning-fees',
+        text: 'Lightning fees are tiny: a base fee plus a proportional fee per hop, paid ' +
+            'to routing nodes. They are far smaller than on-chain miner fees, which is ' +
+            'why Lightning suits everyday spending.',
+        metadata: { topic: 'fees' },
+    },
+    {
+        id: 'zero-conf',
+        text: '0-conf (zero-confirmation) means a channel is usable before its funding ' +
+            'transaction is mined. It relies on trusting the channel partner not to ' +
+            'double-spend; LSPs commonly offer it so you can receive instantly.',
+        metadata: { topic: 'channels' },
+    },
+    {
+        id: 'seed-backup',
+        text: 'Your seed phrase (12/24 words) controls your funds. Write it down offline ' +
+            'and never share or photograph it. A KaleidoSwap node also needs channel ' +
+            'state backups: losing them can mean losing funds in open channels.',
+        metadata: { topic: 'security' },
+    },
+    {
+        id: 'receiving',
+        text: 'To receive: share a Lightning invoice (BOLT11) or an on-chain address. ' +
+            'For Lightning you need inbound liquidity first. For RGB assets, share an ' +
+            'RGB invoice. On-chain always works but is slower.',
+        metadata: { topic: 'usage' },
+    },
+    {
+        id: 'sending',
+        text: 'To send: pay a Lightning invoice or a Lightning address for BTC, or use ' +
+            'an on-chain address. You need outbound liquidity for Lightning. Always ' +
+            'check the amount and destination before paying.',
+        metadata: { topic: 'usage' },
+    },
+    {
+        id: 'dca',
+        text: 'Dollar-cost averaging (DCA) buys a fixed amount on a schedule to smooth ' +
+            'out price swings. KaleidoSwap can automate recurring swaps so you ' +
+            'accumulate BTC or an asset over time without timing the market.',
+        metadata: { topic: 'trading' },
+    },
+];
+//# sourceMappingURL=bitcoin-copilot.js.map

package/dist/knowledge/bitcoin-copilot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitcoin-copilot.js","sourceRoot":"","sources":["../../src/knowledge/bitcoin-copilot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IACjD;QACE,EAAE,EAAE,mBAAmB;QACvB,IAAI,EACF,4EAA4E;YAC5E,yEAAyE;YACzE,0EAA0E;YAC1E,0EAA0E;QAC5E,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;KACjC;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,IAAI,EACF,uEAAuE;YACvE,0EAA0E;YAC1E,6EAA6E;QAC/E,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;KACjC;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EACF,wEAAwE;YACxE,2EAA2E;YAC3E,8EAA8E;QAChF,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;KACjC;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,IAAI,EACF,0EAA0E;YAC1E,2EAA2E;YAC3E,4EAA4E;YAC5E,0CAA0C;QAC5C,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;KACjC;IACD;QACE,EAAE,EAAE,cAAc;QAClB,IAAI,EACF,0EAA0E;YAC1E,yEAAyE;YACzE,4EAA4E;YAC5E,kCAAkC;QACpC,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;KAChC;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EACF,2EAA2E;YAC3E,4EAA4E;YAC5E,6EAA6E;YAC7E,iDAAiD;QACnD,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;KAChC;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EACF,sEAAsE;YACtE,wEAAwE;YACxE,gEAAgE;QAClE,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KAC7B;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EACF,sEAAsE;YACtE,4EAA4E;YAC5E,6EAA6E;QAC/E,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KAC7B;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EACF,wEAAwE;YACxE,2EAA2E;YAC3E,gEAAgE;QAClE,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;KAC3B;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,IAAI,EACF,0EAA0E;YAC1E,0EAA0E;YAC1E,iFAAiF;QACnF,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;KAC3B;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EACF,qEAAqE;YACrE,0EAA0E;YAC1E,4DAA4D;QAC9D,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;KAC3B;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EACF,4EAA4E;YAC5E,wEAAwE;YACxE,6DAA6D;QAC/D,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;KAC/B;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EACF,yEAAyE;YACzE,4EAA4E;YAC5E,wCAAwC;QAC1C,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;KAC/B;IACD;QACE,EAAE,EAAE,KAAK;QACT,IAAI,EACF,uEAAuE;YACvE,2EAA2E;YAC3E,gDAAgD;QAClD,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;KACjC;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EACF,4EAA4E;YAC5E,4EAA4E;YAC5E,wCAAwC;QAC1C,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;KAC5B;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EACF,0EAA0E;YAC1E,yEAAyE;YACzE,oEAAoE;QACtE,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;KAChC;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EACF,4EAA4E;YAC5E,0EAA0E;YAC1E,oEAAoE;QACtE,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;KAChC;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EACF,yEAAyE;YACzE,2EAA2E;YAC3E,mDAAmD;QACrD,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KAC7B;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EACF,0EAA0E;YAC1E,yEAAyE;YACzE,iDAAiD;QACnD,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KAC7B;IACD;QACE,EAAE,EAAE,KAAK;QACT,IAAI,EACF,0EAA0E;YAC1E,oEAAoE;YACpE,iEAAiE;QACnE,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;KAC/B;CACF,CAAC"}

package/dist/knowledge/merchants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * BTC map discovery — turn a merchant directory (e.g. BTCMap / a local dataset)
+ * into `RagDocument[]` so the agent can answer "where can I spend Bitcoin for
+ * coffee near me?" with on-device semantic search over places.
+ *
+ * Pure transform over a generic Merchant shape. Coordinates are kept in
+ * metadata so the host can still pin results on a map after retrieval.
+ */
+import type { RagDocument } from '../rag/types.js';
+export interface Merchant {
+    id?: string;
+    name?: string;
+    category?: string;
+    address?: string;
+    city?: string;
+    lat?: number;
+    lng?: number;
+    /** e.g. ['onchain', 'lightning', 'rgb']. */
+    acceptedAssets?: string[];
+    description?: string;
+}
+/** One searchable doc per merchant; lat/lng preserved in metadata for mapping. */
+export declare function merchantsToDocuments(merchants: Merchant[]): RagDocument[];
+//# sourceMappingURL=merchants.d.ts.map

package/dist/knowledge/merchants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchants.d.ts","sourceRoot":"","sources":["../../src/knowledge/merchants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,CAuBzE"}

package/dist/knowledge/merchants.js

@@ -0,0 +1,34 @@
+/**
+ * BTC map discovery — turn a merchant directory (e.g. BTCMap / a local dataset)
+ * into `RagDocument[]` so the agent can answer "where can I spend Bitcoin for
+ * coffee near me?" with on-device semantic search over places.
+ *
+ * Pure transform over a generic Merchant shape. Coordinates are kept in
+ * metadata so the host can still pin results on a map after retrieval.
+ */
+/** One searchable doc per merchant; lat/lng preserved in metadata for mapping. */
+export function merchantsToDocuments(merchants) {
+    return merchants
+        .filter((m) => m.name)
+        .map((m, i) => {
+        const where = [m.address, m.city].filter(Boolean).join(', ');
+        const pays = m.acceptedAssets?.length
+            ? `Accepts ${m.acceptedAssets.join(', ')}.`
+            : 'Accepts Bitcoin.';
+        const cat = m.category ? ` (${m.category})` : '';
+        const desc = m.description ? ` ${m.description}` : '';
+        return {
+            id: m.id ?? `merchant_${m.name ?? i}`,
+            text: `${m.name}${cat}${where ? ` at ${where}` : ''}. ${pays}${desc}`.trim(),
+            metadata: {
+                kind: 'merchant',
+                name: m.name,
+                category: m.category,
+                city: m.city,
+                lat: m.lat,
+                lng: m.lng,
+            },
+        };
+    });
+}
+//# sourceMappingURL=merchants.js.map

package/dist/knowledge/merchants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchants.js","sourceRoot":"","sources":["../../src/knowledge/merchants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAAC,SAAqB;IACxD,OAAO,SAAS;SACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM;YACnC,CAAC,CAAC,WAAW,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC3C,CAAC,CAAC,kBAAkB,CAAC;QACvB,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO;YACL,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,YAAY,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE;YACrC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE;YAC5E,QAAQ,EAAE;gBACR,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,GAAG,EAAE,CAAC,CAAC,GAAG;aACX;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/knowledge/wallet.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Personal wallet knowledge — turn a user's transaction history + contacts into
+ * `RagDocument[]` so the agent can answer "what did I spend on coffee last
+ * month?", "who did I pay 50k sats to?", "summarise my swaps" — all on-device,
+ * nothing leaving the phone.
+ *
+ * Pure transforms over minimal, generic shapes (hosts map their own types in).
+ * No deps, no PII leaves: the host decides what to ingest.
+ */
+import type { RagDocument } from '../rag/types.js';
+export interface WalletTx {
+    id?: string;
+    /** 'send' | 'receive' | 'swap' | 'deposit' | 'withdraw' | … */
+    type?: string;
+    amountSats?: number;
+    asset?: string;
+    /** Who/where — a name, contact, address, or merchant. */
+    counterparty?: string;
+    memo?: string;
+    status?: string;
+    /** Epoch ms. */
+    timestamp?: number;
+}
+export interface Contact {
+    name?: string;
+    lightningAddress?: string;
+    npub?: string;
+    note?: string;
+}
+/** One short, searchable sentence per transaction. */
+export declare function walletHistoryToDocuments(txs: WalletTx[]): RagDocument[];
+/** One doc per contact, so "who is Bob?" / "pay my friend" can resolve. */
+export declare function contactsToDocuments(contacts: Contact[]): RagDocument[];
+//# sourceMappingURL=wallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/knowledge/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAYD,sDAAsD;AACtD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,CAsBvE;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CActE"}