@kaleidorg/mind 0.0.1 → 0.2.0

package/dist/skills/registry.js

@@ -0,0 +1,167 @@
+/**
+ * SkillRegistry — holds skills, parses SKILL.md files, selects per query, and
+ * composes the system prompt for the selected skill.
+ *
+ * Selection is pluggable. The default is a fast keyword heuristic (no model
+ * call); a host can inject a model-driven or embedding selector instead.
+ */
+/** Tool name the reference source exposes for progressive disclosure. */
+export const READ_REFERENCE_TOOL = 'read_skill_reference';
+/**
+ * Parse a SKILL.md file: a YAML-ish frontmatter block (name/description/tools/
+ * triggers) followed by the instruction body.
+ *
+ *   ---
+ *   name: portfolio-manager
+ *   description: Rebalance BTC/USDT/XAUT to target allocations.
+ *   tools: get_balance, kaleidoswap_get_quote, kaleidoswap_place_order
+ *   triggers: rebalance, allocation, portfolio
+ *   ---
+ *   <instructions…>
+ */
+/** Strip wrapping single/double quotes from a frontmatter value. */
+function unquote(v) {
+    const t = v.trim();
+    if ((t.startsWith('"') && t.endsWith('"')) || (t.startsWith("'") && t.endsWith("'"))) {
+        return t.slice(1, -1);
+    }
+    return t;
+}
+export function parseSkill(markdown, references) {
+    const fm = markdown.match(/^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/);
+    const meta = {};
+    let body = markdown;
+    if (fm) {
+        body = fm[2] ?? '';
+        for (const line of (fm[1] ?? '').split('\n')) {
+            // Flat `key: value` lines (incl. indented keys under a nested `metadata:`
+            // block, which fold into the same map — we don't need YAML nesting here).
+            const m = line.match(/^\s*([A-Za-z_][\w-]*)\s*:\s*(.+?)\s*$/);
+            if (m && m[1])
+                meta[m[1].toLowerCase()] = unquote(m[2] ?? '');
+        }
+    }
+    const list = (v) => v
+        ? v.split(',').map((s) => s.trim()).filter(Boolean)
+        : undefined;
+    if (!meta.name)
+        throw new Error('SKILL.md missing `name` in frontmatter');
+    // Everything that isn't a first-class field becomes metadata.
+    const KNOWN = new Set(['name', 'description', 'tools', 'triggers']);
+    const metadata = {};
+    for (const [k, v] of Object.entries(meta))
+        if (!KNOWN.has(k))
+            metadata[k] = v;
+    return {
+        name: meta.name,
+        description: meta.description ?? '',
+        instructions: body.trim(),
+        tools: list(meta.tools),
+        triggers: list(meta.triggers),
+        metadata: Object.keys(metadata).length ? metadata : undefined,
+        references: references && references.length ? references : undefined,
+    };
+}
+// Common words that shouldn't count toward a skill match.
+const STOPWORDS = new Set([
+    'the', 'and', 'for', 'you', 'your', 'what', 'this', 'that', 'with', 'from',
+    'have', 'has', 'are', 'was', 'can', 'will', 'please', 'today', 'now', 'get',
+    'show', 'tell', 'how', 'much', 'many', 'about', 'into', 'over',
+]);
+/** Default selector: score by meaningful keyword overlap; triggers weigh most. */
+export const keywordSelector = {
+    select(query, skills) {
+        const q = query.toLowerCase();
+        const words = new Set(q.split(/\W+/).filter((w) => w.length > 2 && !STOPWORDS.has(w)));
+        let best = null;
+        let bestScore = 0;
+        for (const skill of skills) {
+            const haystack = `${skill.description} ${(skill.triggers ?? []).join(' ')}`.toLowerCase();
+            const hayWords = haystack.split(/\W+/).filter((w) => w.length > 2 && !STOPWORDS.has(w));
+            let score = 0;
+            for (const w of hayWords)
+                if (words.has(w))
+                    score += 1;
+            // Strong boost for an explicit trigger appearing in the query.
+            for (const t of skill.triggers ?? [])
+                if (q.includes(t.toLowerCase()))
+                    score += 3;
+            if (score > bestScore) {
+                bestScore = score;
+                best = skill;
+            }
+        }
+        // Require a real signal, not a single incidental word overlap.
+        return bestScore >= 2 ? best : null;
+    },
+};
+export class SkillRegistry {
+    skills = [];
+    selector;
+    constructor(skills = [], selector = keywordSelector) {
+        this.skills = [...skills];
+        this.selector = selector;
+    }
+    add(skill) {
+        this.skills.push(skill);
+        return this;
+    }
+    /** Add a skill from raw SKILL.md text (+ optional reference files). */
+    addMarkdown(markdown, references) {
+        return this.add(parseSkill(markdown, references));
+    }
+    /** All reference files across skills, tagged with their owning skill. */
+    references() {
+        return this.skills.flatMap((s) => (s.references ?? []).map((r) => ({ ...r, skill: s.name })));
+    }
+    /** Look up a reference file by name (optionally scoped to one skill). */
+    reference(file, skill) {
+        const base = file.replace(/^references\//, '');
+        for (const s of this.skills) {
+            if (skill && s.name !== skill)
+                continue;
+            const hit = (s.references ?? []).find((r) => r.name === base || r.name === file);
+            if (hit)
+                return hit;
+        }
+        return undefined;
+    }
+    list() {
+        return [...this.skills];
+    }
+    get(name) {
+        return this.skills.find((s) => s.name === name);
+    }
+    /** Pick the most relevant skill for a query (null = none). */
+    select(query) {
+        return this.selector.select(query, this.skills);
+    }
+    /**
+     * Compose the effective system prompt for a skill: the base prompt + the
+     * skill's playbook. The returned `allowedTools` should be passed to
+     * `engine.runAgentic(..., { allowedTools })` for progressive tool disclosure.
+     */
+    compose(base, skill) {
+        if (!skill)
+            return { system: base };
+        let system = `${base}\n\n## Active skill: ${skill.name}\n${skill.instructions}`.trim();
+        // Progressive disclosure: tell the model the reference files exist and how
+        // to pull one in, rather than dumping them all into context.
+        const refs = skill.references ?? [];
+        if (refs.length) {
+            const names = refs.map((r) => r.name).join(', ');
+            system +=
+                `\n\n## Reference files\nThis skill has detailed reference docs: ${names}. ` +
+                    `When you need the detail for a step, call \`${READ_REFERENCE_TOOL}\` with the ` +
+                    `filename (e.g. {"file":"${refs[0].name}"}) to read it before acting.`;
+        }
+        // When the skill scopes tools, keep the reference reader reachable too.
+        const allowedTools = skill.tools
+            ? refs.length
+                ? [...skill.tools, READ_REFERENCE_TOOL]
+                : skill.tools
+            : undefined;
+        return { system, allowedTools };
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/skills/registry.js.map

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

package/dist/skills/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Skills — Claude-style Agent Skills the brain can "enter".
+ *
+ * A skill is the top layer of tool use: a folder with a `SKILL.md` (YAML
+ * frontmatter + a markdown playbook) and optional `references/*.md` files that
+ * are loaded on demand. Entering a skill injects its playbook into the system
+ * prompt and (optionally) scopes the agent to a subset of tools. The tools are
+ * still invoked via function calling and may be backed by in-process handlers
+ * or MCP servers — skills don't replace those, they *direct* them.
+ *
+ * This is progressive disclosure, the core idea behind Anthropic's Agent Skills:
+ * a small local model never sees every tool or instruction at once — only the
+ * selected skill's playbook, and it can pull a reference file in when it needs
+ * the detail. The format is compatible with skills published for Claude (e.g.
+ * `bitrefill/agents`), so the same SKILL.md runs the QVAC brain unchanged.
+ */
+/** A reference file (references/*.md) the agent can read on demand. */
+export interface SkillReference {
+    /** Filename, e.g. "mcp.md". */
+    name: string;
+    /** Markdown contents. */
+    content: string;
+}
+export interface Skill {
+    /** Stable id, e.g. "bitrefill" / "portfolio-manager". */
+    name: string;
+    /**
+     * "When to use this" — the spec's selection signal. May be long and embed the
+     * trigger phrases ("…Triggers when the user mentions gift cards, eSIM…").
+     */
+    description: string;
+    /** The playbook: markdown instructions injected into the system prompt. */
+    instructions: string;
+    /**
+     * Tool names this skill is allowed to use. When set, the engine exposes only
+     * these tools while the skill is active (progressive disclosure). Omit to
+     * allow all registered tools (the default for capability-routing skills).
+     */
+    tools?: string[];
+    /** Optional trigger keywords to boost selection (in addition to description). */
+    triggers?: string[];
+    /** Remaining frontmatter (compatibility, author, version, homepage, …). */
+    metadata?: Record<string, string>;
+    /** Reference files (references/*.md) for progressive disclosure. */
+    references?: SkillReference[];
+    /** Source folder, when loaded from disk (Node). */
+    dir?: string;
+}
+/** Picks the most relevant skill for a query (or null for none). */
+export interface SkillSelector {
+    select(query: string, skills: Skill[]): Skill | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,oEAAoE;IACpE,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC;CACtD"}

package/dist/skills/types.js

@@ -0,0 +1,18 @@
+/**
+ * Skills — Claude-style Agent Skills the brain can "enter".
+ *
+ * A skill is the top layer of tool use: a folder with a `SKILL.md` (YAML
+ * frontmatter + a markdown playbook) and optional `references/*.md` files that
+ * are loaded on demand. Entering a skill injects its playbook into the system
+ * prompt and (optionally) scopes the agent to a subset of tools. The tools are
+ * still invoked via function calling and may be backed by in-process handlers
+ * or MCP servers — skills don't replace those, they *direct* them.
+ *
+ * This is progressive disclosure, the core idea behind Anthropic's Agent Skills:
+ * a small local model never sees every tool or instruction at once — only the
+ * selected skill's playbook, and it can pull a reference file in when it needs
+ * the detail. The format is compatible with skills published for Claude (e.g.
+ * `bitrefill/agents`), so the same SKILL.md runs the QVAC brain unchanged.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

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

package/dist/tools/cli.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CLI tool source — the fourth tool mechanism (alongside in-process function
+ * calling, MCP, and skills). Lets the agent run shell commands, e.g. a skill's
+ * documented CLI path (`@bitrefill/cli`, `kaleido`, `git`, …).
+ *
+ * Command execution is INJECTED (`CommandRunner`) so this file has no Node
+ * dependency and stays RN-safe — a Node host provides the runner (ideally via a
+ * non-shell `execFile`-style helper); React Native simply never provides one.
+ * Guarded by a required allowlist of command prefixes, and confirmation-gated
+ * by default since it runs real commands.
+ */
+import type { ToolSource } from './source.js';
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+/** Injected shell runner. The Node host supplies a safe implementation. */
+export interface CommandRunner {
+    run(command: string, opts?: {
+        cwd?: string;
+        timeoutMs?: number;
+    }): Promise<CommandResult>;
+}
+export interface CliToolOptions {
+    runner: CommandRunner;
+    /**
+     * Allowed command prefixes (REQUIRED — no empty allowlist). A command runs
+     * only if it starts with one of these tokens, e.g. ['kaleido', 'git status',
+     * 'npx @bitrefill/cli'].
+     */
+    allow: string[];
+    cwd?: string;
+    timeoutMs?: number;
+    /** Confirmation gate (default true — it executes real commands). */
+    requiresConfirmation?: boolean;
+    /** Tool description override (e.g. name the specific CLI). */
+    description?: string;
+}
+/** True if `command` is permitted by the allowlist (prefix match on tokens). */
+export declare function isAllowed(command: string, allow: string[]): boolean;
+export declare function createCliToolSource(opts: CliToolOptions): ToolSource;
+//# sourceMappingURL=cli.d.ts.map

package/dist/tools/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/tools/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAMnE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CA4CpE"}

package/dist/tools/cli.js

@@ -0,0 +1,61 @@
+/**
+ * CLI tool source — the fourth tool mechanism (alongside in-process function
+ * calling, MCP, and skills). Lets the agent run shell commands, e.g. a skill's
+ * documented CLI path (`@bitrefill/cli`, `kaleido`, `git`, …).
+ *
+ * Command execution is INJECTED (`CommandRunner`) so this file has no Node
+ * dependency and stays RN-safe — a Node host provides the runner (ideally via a
+ * non-shell `execFile`-style helper); React Native simply never provides one.
+ * Guarded by a required allowlist of command prefixes, and confirmation-gated
+ * by default since it runs real commands.
+ */
+const RUN = 'run_command';
+/** True if `command` is permitted by the allowlist (prefix match on tokens). */
+export function isAllowed(command, allow) {
+    const cmd = command.trim();
+    return allow.some((prefix) => {
+        const p = prefix.trim();
+        return p.length > 0 && (cmd === p || cmd.startsWith(p + ' '));
+    });
+}
+export function createCliToolSource(opts) {
+    if (!opts.allow || opts.allow.length === 0) {
+        throw new Error('createCliToolSource: a non-empty `allow` allowlist is required');
+    }
+    const tool = {
+        name: RUN,
+        description: opts.description ??
+            `Run an allowed shell command and return its output. Allowed commands start ` +
+                `with: ${opts.allow.join(', ')}. Use for documented CLI tools.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                command: { type: 'string', description: 'The full command line to run' },
+            },
+            required: ['command'],
+        },
+        requiresConfirmation: opts.requiresConfirmation ?? true,
+    };
+    async function execute(_name, args) {
+        const command = String(args.command ?? '').trim();
+        if (!command)
+            throw new Error('run_command: command is required');
+        if (!isAllowed(command, opts.allow)) {
+            throw new Error(`run_command: "${command.split(' ')[0]}" is not allowed. Allowed: ${opts.allow.join(', ')}`);
+        }
+        const res = await opts.runner.run(command, { cwd: opts.cwd, timeoutMs: opts.timeoutMs });
+        const out = (res.stdout || '').trim();
+        const err = (res.stderr || '').trim();
+        if (res.code !== 0) {
+            return `exit ${res.code}${err ? `\n${err}` : ''}${out ? `\n${out}` : ''}`.trim();
+        }
+        return out || '(no output)';
+    }
+    return {
+        id: 'cli',
+        listTools: () => [tool],
+        has: (name) => name === RUN,
+        execute,
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/tools/cli.js.map

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

package/dist/tools/l402.d.ts

@@ -0,0 +1,47 @@
+/**
+ * L402 tool source — lets the agent pay for paywalled HTTP resources in sats.
+ *
+ * Exposes one tool, `fetch_paid_resource(url)`, that runs the L402 flow:
+ *   GET url → 402 with an L402 challenge (macaroon + Lightning invoice)
+ *   → pay the invoice (via the injected `payInvoice`, e.g. the on-device wallet)
+ *   → re-GET with `Authorization: L402 <macaroon>:<preimage>` → return the body.
+ *
+ * This is the "agent pays for a tool in sats" capability: any KaleidoMind agent
+ * (mobile or desktop) can buy premium data / inference autonomously. Payment
+ * runs through the host's wallet, so it stays on-device; the engine's
+ * confirmation gate can wrap the spend if desired.
+ *
+ * No dependencies — uses global fetch (Node ≥18, React Native). The fetch impl
+ * is injectable for testing.
+ */
+import type { ToolSource } from './source.js';
+export interface L402PayResult {
+    /** Payment preimage (hex) — proves the invoice was paid. */
+    preimage: string;
+}
+export interface L402Options {
+    /** Pay a BOLT11 invoice, resolve with the preimage. Wallet on device; mock in tests. */
+    payInvoice: (invoice: string, amountSats: number) => Promise<L402PayResult>;
+    /** Override fetch (tests). Defaults to global fetch. */
+    fetchImpl?: typeof fetch;
+    /** Optional progress logging. */
+    log?: (msg: string) => void;
+    /**
+     * Gate the tool behind the engine's confirmation (default true). The catch:
+     * the invoice amount is only known DURING execution (the 402 challenge), so a
+     * pre-execution confirmation can't show it. On hosts without a dedicated L402
+     * confirmation UX, set this false and bound spending with `maxAutoPaySats`.
+     */
+    requiresConfirmation?: boolean;
+    /** Auto-pay only invoices up to this many sats; reject larger ones. */
+    maxAutoPaySats?: number;
+}
+/** Parse an L402 (or legacy LSAT) WWW-Authenticate challenge. */
+export declare function parseL402Challenge(header: string): {
+    macaroon: string;
+    invoice: string;
+} | null;
+/** Rough BOLT11 amount → sats (for logging / spend caps). 0 if unparseable. */
+export declare function bolt11AmountSats(invoice: string): number;
+export declare function createL402ToolSource(opts: L402Options): ToolSource;
+//# sourceMappingURL=l402.d.ts.map

package/dist/tools/l402.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l402.d.ts","sourceRoot":"","sources":["../../src/tools/l402.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,wFAAwF;IACxF,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5E,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI/F;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CA6DlE"}

package/dist/tools/l402.js

@@ -0,0 +1,84 @@
+/**
+ * L402 tool source — lets the agent pay for paywalled HTTP resources in sats.
+ *
+ * Exposes one tool, `fetch_paid_resource(url)`, that runs the L402 flow:
+ *   GET url → 402 with an L402 challenge (macaroon + Lightning invoice)
+ *   → pay the invoice (via the injected `payInvoice`, e.g. the on-device wallet)
+ *   → re-GET with `Authorization: L402 <macaroon>:<preimage>` → return the body.
+ *
+ * This is the "agent pays for a tool in sats" capability: any KaleidoMind agent
+ * (mobile or desktop) can buy premium data / inference autonomously. Payment
+ * runs through the host's wallet, so it stays on-device; the engine's
+ * confirmation gate can wrap the spend if desired.
+ *
+ * No dependencies — uses global fetch (Node ≥18, React Native). The fetch impl
+ * is injectable for testing.
+ */
+/** Parse an L402 (or legacy LSAT) WWW-Authenticate challenge. */
+export function parseL402Challenge(header) {
+    const macaroon = header.match(/macaroon="([^"]+)"/i)?.[1];
+    const invoice = header.match(/invoice="([^"]+)"/i)?.[1];
+    return macaroon && invoice ? { macaroon, invoice } : null;
+}
+/** Rough BOLT11 amount → sats (for logging / spend caps). 0 if unparseable. */
+export function bolt11AmountSats(invoice) {
+    const m = invoice.match(/^ln(?:bc|tb|bcrt)(\d+)([munp]?)/i);
+    if (!m)
+        return 0;
+    const n = Number(m[1]);
+    const mult = (m[2] || '').toLowerCase();
+    const btc = mult === 'm' ? n / 1e3 : mult === 'u' ? n / 1e6 : mult === 'n' ? n / 1e9 : mult === 'p' ? n / 1e12 : n;
+    return Math.round(btc * 1e8);
+}
+export function createL402ToolSource(opts) {
+    const doFetch = opts.fetchImpl ?? fetch;
+    const tool = {
+        name: 'fetch_paid_resource',
+        description: 'Fetch a paywalled (L402) HTTP resource, automatically paying the required ' +
+            'Lightning invoice in sats. Use this for premium or paid APIs (market data, ' +
+            'inference, etc.). Pass the resource URL.',
+        parameters: {
+            type: 'object',
+            properties: { url: { type: 'string', description: 'The resource URL to fetch' } },
+            required: ['url'],
+        },
+        requiresConfirmation: opts.requiresConfirmation ?? true,
+    };
+    async function execute(_name, args) {
+        const url = String(args.url ?? '');
+        if (!url)
+            throw new Error('fetch_paid_resource: url is required');
+        let res = await doFetch(url);
+        if (res.status === 402) {
+            const challenge = parseL402Challenge(res.headers.get('www-authenticate') ?? '');
+            if (!challenge)
+                throw new Error('402 Payment Required but no L402 challenge present');
+            const amountSats = bolt11AmountSats(challenge.invoice) || Number(res.headers.get('x-amount-sats') ?? 0);
+            if (opts.maxAutoPaySats != null && amountSats > opts.maxAutoPaySats) {
+                throw new Error(`L402 invoice is ${amountSats} sats, above the ${opts.maxAutoPaySats} sat auto-pay cap — declined`);
+            }
+            opts.log?.(`L402: ${url} requires ${amountSats} sats — paying…`);
+            const { preimage } = await opts.payInvoice(challenge.invoice, amountSats);
+            res = await doFetch(url, {
+                headers: { Authorization: `L402 ${challenge.macaroon}:${preimage}` },
+            });
+            opts.log?.(`L402: paid ${amountSats} sats → ${res.status}`);
+        }
+        if (!res.ok)
+            throw new Error(`fetch_paid_resource: ${res.status} ${res.statusText}`);
+        const body = await res.text();
+        try {
+            return JSON.parse(body);
+        }
+        catch {
+            return body;
+        }
+    }
+    return {
+        id: 'l402',
+        listTools: () => [tool],
+        has: (name) => name === tool.name,
+        execute,
+    };
+}
+//# sourceMappingURL=l402.js.map

package/dist/tools/l402.js.map

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

package/dist/tools/mcp.d.ts

@@ -13,8 +13,9 @@
  * file type-checks and ships even where the SDK isn't installed; constructing
  * an McpToolSource without it throws a clear error.
  *
- * STATUS: skeleton for the desktop pass. The shape is final; the connect()
- * body is wired when we integrate desktop-app.
+ * Wired end-to-end: connect() (stdio + HTTP transports), listTools() and
+ * execute() are implemented. Used by the desktop sidecar (kaleido-mcp +
+ * Bitrefill MCP) and verified against the remote Bitrefill MCP.
  */
 import type { ToolDef } from '../types.js';
 import type { ToolSource } from './source.js';

package/dist/tools/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/tools/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,YAAY,CAAC;IACxB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAc,YAAW,UAAU;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAiB;gBAElB,IAAI,EAAE,oBAAoB;IAKtC,+EAA+E;IACzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC9B,SAAS,IAAI,OAAO,EAAE;IAItB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/tools/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,YAAY,CAAC;IACxB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAc,YAAW,UAAU;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAiB;gBAElB,IAAI,EAAE,oBAAoB;IAKtC,+EAA+E;IACzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC9B,SAAS,IAAI,OAAO,EAAE;IAItB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/tools/mcp.js

@@ -13,8 +13,9 @@
  * file type-checks and ships even where the SDK isn't installed; constructing
  * an McpToolSource without it throws a clear error.
  *
- * STATUS: skeleton for the desktop pass. The shape is final; the connect()
- * body is wired when we integrate desktop-app.
+ * Wired end-to-end: connect() (stdio + HTTP transports), listTools() and
+ * execute() are implemented. Used by the desktop sidecar (kaleido-mcp +
+ * Bitrefill MCP) and verified against the remote Bitrefill MCP.
  */
 export class McpToolSource {
     id;

package/dist/tools/mcp.js.map

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

package/dist/wallet/contract.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Canonical multi-L2 wallet tool contract — the single source of truth for
+ * KaleidoMind's wallet tools (names + JSON schemas + spend flags).
+ *
+ * Every surface implements THESE EXACT tools, only the transport differs:
+ *   - mobile  → in-process handlers over the WDK adapters (`bindWalletTools`)
+ *   - desktop → kaleido-mcp (tools namespaced per layer) + a `kaleido` CLI
+ *   - eval    → stub handlers
+ *
+ * Because the schemas are identical everywhere, skills are portable and the
+ * model comparison is honest. Tools are namespaced per layer (`spark_*`,
+ * `rln_*`, `arkade_*`, `liquid_*`); cross-cutting router/helpers are unprefixed.
+ *
+ * Spend tools (move funds) carry `spend: true` → `requiresConfirmation: true`,
+ * so the Engine always pauses for the host's confirm gate before executing.
+ *
+ * Pure data — no deps, RN-safe.
+ */
+import type { ToolDef } from '../types.js';
+import { InProcessToolSource } from '../tools/in-process.js';
+export type WalletLayer = 'spark' | 'rln' | 'arkade' | 'liquid' | 'core';
+export interface WalletToolDef extends ToolDef {
+    /** Which L2 (or 'core' for cross-cutting router/helpers). */
+    layer: WalletLayer;
+    /** Moves funds → confirmation-gated. */
+    spend?: boolean;
+}
+/** The full contract. Keep descriptions terse — small models read every word. */
+export declare const WALLET_TOOLS: WalletToolDef[];
+export declare const WALLET_LAYERS: WalletLayer[];
+/** Names of all spend (fund-moving) tools — these are confirmation-gated. */
+export declare const SPEND_TOOLS: ReadonlySet<string>;
+export declare function isSpendTool(name: string): boolean;
+export declare function getWalletTool(name: string): WalletToolDef | undefined;
+/** Pick the contract tools for the given layers (core helpers included by default). */
+export declare function walletTools(opts?: {
+    layers?: WalletLayer[];
+    includeCore?: boolean;
+}): WalletToolDef[];
+/** Strip to plain ToolDefs (drop the layer/spend metadata). */
+export declare function toToolDefs(tools: WalletToolDef[]): ToolDef[];
+/** A handler bound to one contract tool. */
+export type WalletHandler = (args: Record<string, unknown>) => Promise<unknown>;
+export interface BindWalletOptions {
+    layers?: WalletLayer[];
+    includeCore?: boolean;
+    /** Skip tools that have no handler instead of throwing (default false). */
+    allowMissing?: boolean;
+    id?: string;
+}
+/**
+ * Bind contract tools to in-process handlers → an InProcessToolSource. The
+ * mobile (and eval) binding: pass a map of `{ toolName: handler }` and you get a
+ * ToolSource implementing the canonical schemas with spend flags preserved.
+ */
+export declare function bindWalletTools(handlers: Record<string, WalletHandler>, opts?: BindWalletOptions): InProcessToolSource;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/wallet/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzE,MAAM,WAAW,aAAc,SAAQ,OAAO;IAC5C,6DAA6D;IAC7D,KAAK,EAAE,WAAW,CAAC;IACnB,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyBD,iFAAiF;AACjF,eAAO,MAAM,YAAY,EAAE,aAAa,EAqCvC,CAAC;AAIF,eAAO,MAAM,aAAa,EAAE,WAAW,EAAiD,CAAC;AAEzF,6EAA6E;AAC7E,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAAmE,CAAC;AAEhH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAErE;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,aAAa,EAAE,CAIzG;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAE5D;AAED,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,IAAI,GAAE,iBAAsB,GAAG,mBAAmB,CAkB1H"}