@kaleidorg/mind 0.5.1 → 0.6.1

package/dist/autonomy/task-store.js

@@ -0,0 +1,139 @@
+/**
+ * TaskStore implementation — in-memory, with optional injected persistence.
+ * Pure TS, zero deps. Port of kaleidoagent's tasks-store.ts, but storage-agnostic
+ * (host injects IO: fs on a Node sidecar, SQLite on the desktop, AsyncStorage on RN).
+ *
+ *   const store = new InMemoryTaskStore();          // ephemeral
+ *   const store = new InMemoryTaskStore({ io });     // persisted
+ */
+import { ZERO_ALLOCATION, } from './types.js';
+export class InMemoryTaskStore {
+    tasks = [];
+    hydrated = false;
+    counter = 0;
+    io;
+    now;
+    constructor(opts = {}) {
+        this.io = opts.io;
+        this.now = opts.now ?? (() => Date.now());
+    }
+    async hydrate() {
+        if (this.hydrated)
+            return;
+        this.hydrated = true;
+        if (this.io) {
+            try {
+                this.tasks = await this.io.load();
+                this.counter = this.tasks.length;
+            }
+            catch {
+                this.tasks = [];
+            }
+        }
+    }
+    async persist() {
+        if (this.io)
+            await this.io.save(this.tasks);
+    }
+    async list() {
+        await this.hydrate();
+        return [...this.tasks];
+    }
+    async get(id) {
+        await this.hydrate();
+        return this.tasks.find((t) => t.id === id) ?? null;
+    }
+    async create(input) {
+        await this.hydrate();
+        const task = this.materialize(input);
+        this.tasks.push(task);
+        await this.persist();
+        return task;
+    }
+    async update(id, patch) {
+        await this.hydrate();
+        const existing = this.tasks.find((t) => t.id === id);
+        if (!existing)
+            return null;
+        // id + createdAt are immutable; strip them defensively even if cast in.
+        const { id: _id, createdAt: _createdAt, ...safe } = patch;
+        const updated = { ...existing, ...safe };
+        this.tasks = this.tasks.map((t) => (t.id === id ? updated : t));
+        await this.persist();
+        return updated;
+    }
+    async remove(id) {
+        await this.hydrate();
+        const before = this.tasks.length;
+        this.tasks = this.tasks.filter((t) => t.id !== id);
+        const removed = this.tasks.length < before;
+        if (removed)
+            await this.persist();
+        return removed;
+    }
+    async seedDefaults(seeds) {
+        await this.hydrate();
+        const present = new Set(this.tasks.map((t) => t.id));
+        const added = seeds
+            .filter((s) => !present.has(s.id))
+            .map((s) => this.materialize(s));
+        if (added.length) {
+            // Seeds first, so the default loops sort to the top of the list.
+            this.tasks = [...added, ...this.tasks];
+            await this.persist();
+        }
+        return added;
+    }
+    /** Fill defaults + assign id/createdAt for a new or seed task. */
+    materialize(input) {
+        return {
+            id: input.id ?? `task_${this.now()}_${++this.counter}`,
+            name: input.name,
+            description: input.description,
+            skill: input.skill,
+            scheduleSec: input.scheduleSec,
+            runOnStartup: input.runOnStartup ?? false,
+            allocation: input.allocation ?? { ...ZERO_ALLOCATION },
+            enabled: input.enabled,
+            createdAt: input.createdAt ?? this.now(),
+            lastRunAt: input.lastRunAt ?? null,
+        };
+    }
+}
+/**
+ * The three default loops nanobot seeded — ready to pass to `seedDefaults`.
+ * Disabled by default: a wallet agent must be turned on deliberately, never
+ * auto-arm itself on first launch.
+ */
+export function defaultTaskSeeds(opts = {}) {
+    return [
+        {
+            id: 'heartbeat',
+            name: 'Heartbeat',
+            description: 'Node health check, channel audit, RGB transfer flush',
+            skill: 'channel-manager',
+            scheduleSec: opts.heartbeatSec ?? 300,
+            runOnStartup: true,
+            enabled: false,
+        },
+        {
+            id: 'rebalance',
+            name: 'Portfolio Rebalance',
+            description: 'Detect allocation drift and execute rebalancing swaps',
+            skill: 'portfolio-manager',
+            scheduleSec: opts.rebalanceSec ?? 3600,
+            runOnStartup: false,
+            enabled: false,
+        },
+        {
+            id: 'daily_summary',
+            name: 'Daily Summary',
+            description: 'Full portfolio snapshot and market report',
+            skill: 'portfolio-manager',
+            scheduleSec: opts.dailySummarySec ?? 86_400,
+            runOnStartup: false,
+            enabled: false,
+        },
+    ];
+}
+//# sourceMappingURL=task-store.js.map

package/dist/autonomy/task-store.js.map

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

package/dist/autonomy/types.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Autonomy — the agent's task brain.
+ *
+ * This is the half of "the agent's memory" the {@link ../memory/types MemoryStore}
+ * (soul + facts) does NOT cover: the *operational* state nanobot kept across
+ * `tasks.json` + `cron/jobs.json` + its run history. Lifted into core so every
+ * host (desktop sidecar, agent, cli) runs the same autonomous loop — storage
+ * and timers are injected (fs/SQLite on Node, AsyncStorage on RN), the logic is
+ * pure TS with zero runtime deps.
+ *
+ * Three pieces:
+ *   - TaskStore   — the registry of scheduled/manual tasks (was tasks-store.ts)
+ *   - TaskRunLog  — what each task did, when, and what it cost (was agent-state.ts)
+ *   - Scheduler   — fires due tasks on their interval (was nanobot cron)
+ *
+ * Spend safety lives alongside in {@link ./risk}.
+ */
+/** Capital earmarked for a task — isolates how much a single task may touch. */
+export interface TaskAllocation {
+    /** Satoshis of BTC the task may spend. */
+    btcSat: number;
+    /** USDT (display units) the task may spend. */
+    usdt: number;
+    /** XAUT (display units) the task may spend. */
+    xaut: number;
+}
+/** A zero allocation — the default for read-only / monitoring tasks. */
+export declare const ZERO_ALLOCATION: TaskAllocation;
+/**
+ * A scheduled (or manual) autonomous task — the unit nanobot stored in
+ * `tasks.json`. A task names a skill to run on an interval, with an optional
+ * capital budget and an enable switch.
+ */
+export interface AgentTask {
+    id: string;
+    name: string;
+    description: string;
+    /** Skill that scopes the run, e.g. 'portfolio-manager'. */
+    skill: string;
+    /** Seconds between runs. 0 = manual-only (never auto-fires). */
+    scheduleSec: number;
+    /** Run once immediately when the scheduler starts. */
+    runOnStartup: boolean;
+    /** Capital this task is allowed to move. */
+    allocation: TaskAllocation;
+    enabled: boolean;
+    /** Epoch ms. */
+    createdAt: number;
+    /** Epoch ms of the last run, or null if never run. */
+    lastRunAt: number | null;
+}
+/**
+ * What `create` accepts — id/createdAt/lastRunAt are filled by the store, and
+ * allocation/runOnStartup default when omitted.
+ */
+export type NewTask = Omit<AgentTask, 'id' | 'createdAt' | 'lastRunAt' | 'allocation' | 'runOnStartup'> & Partial<Pick<AgentTask, 'id' | 'createdAt' | 'lastRunAt' | 'allocation' | 'runOnStartup'>>;
+/** A default/seed task — carries a stable id so seeding is idempotent. */
+export type TaskSeed = NewTask & {
+    id: string;
+};
+/** The task registry. Mirrors {@link ../memory/types.MemoryStore}'s shape. */
+export interface TaskStore {
+    list(): Promise<AgentTask[]>;
+    get(id: string): Promise<AgentTask | null>;
+    create(input: NewTask): Promise<AgentTask>;
+    /** Patch a task. id/createdAt are immutable. Returns null if not found. */
+    update(id: string, patch: Partial<Omit<AgentTask, 'id' | 'createdAt'>>): Promise<AgentTask | null>;
+    remove(id: string): Promise<boolean>;
+    /** Insert any seed whose id isn't already present. Returns the ones added. */
+    seedDefaults(seeds: TaskSeed[]): Promise<AgentTask[]>;
+}
+/** Injected persistence — load once, save on every mutation. */
+export interface TaskStoreIO {
+    load(): Promise<AgentTask[]>;
+    save(tasks: AgentTask[]): Promise<void>;
+}
+/** Token + dollar cost of a single run. */
+export interface TaskRunCost {
+    usd: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+/** Aggregated stats for one task across all its runs. */
+export interface TaskStats {
+    runs: number;
+    errors: number;
+    lastRunAt: number | null;
+    lastDurationMs: number | null;
+    lastToolCalls: number | null;
+    lastError: string | null;
+    /** First ~800 chars of the last final response. */
+    lastText: string | null;
+}
+/** One completed run, newest-first in the recent ring buffer. */
+export interface TaskRunRecord {
+    taskId: string;
+    taskName: string;
+    /** Epoch ms the run started. */
+    startedAt: number;
+    durationMs: number;
+    toolCalls: number;
+    ok: boolean;
+    error: string | null;
+    /** Final response text (truncated by the log). */
+    text: string;
+    cost: TaskRunCost;
+}
+/** A serializable point-in-time view of the run log, for persistence. */
+export interface RunLogSnapshot {
+    stats: Record<string, TaskStats>;
+    recent: TaskRunRecord[];
+    cumulative: TaskRunCost;
+}
+/** Injected persistence for the run log. */
+export interface RunLogIO {
+    load(): Promise<RunLogSnapshot | null>;
+    save(snapshot: RunLogSnapshot): Promise<void>;
+}
+/** The result of running a task once. The host's `run` callback returns this. */
+export interface TaskRunOutcome {
+    ok: boolean;
+    text?: string;
+    toolCalls?: number;
+    error?: string;
+    cost?: Partial<TaskRunCost>;
+}
+/** Host-provided runner — typically wraps `Funnel.runTurn(buildTaskPrompt(task))`. */
+export type RunTask = (task: AgentTask) => Promise<TaskRunOutcome>;
+/** Opaque timer handle so the scheduler stays platform-agnostic. */
+export type TimerHandle = unknown;
+export interface SchedulerOptions {
+    store: TaskStore;
+    /** Runs a task and resolves with its outcome. Errors are caught by the scheduler. */
+    run: RunTask;
+    /** Notified after every run (success or error) — wire to a {@link TaskRunLog}. */
+    onOutcome?: (task: AgentTask, outcome: TaskRunOutcome, durationMs: number) => void;
+    /** Diagnostics sink. Default: silent. */
+    log?: (msg: string) => void;
+    /** Injectable clock. Default: Date.now. */
+    now?: () => number;
+    /** How often `start()` evaluates due tasks, ms. Default 30_000. */
+    tickMs?: number;
+    /** Max tasks running at once. Default 1 (serial — safest for a wallet). */
+    concurrency?: number;
+    /** Injectable timer. Default: setInterval. */
+    setTimer?: (fn: () => void, ms: number) => TimerHandle;
+    /** Injectable timer-clear. Default: clearInterval. */
+    clearTimer?: (handle: TimerHandle) => void;
+}
+export interface TaskScheduler {
+    /** Begin firing due tasks; runs `runOnStartup` tasks immediately. Idempotent. */
+    start(): void;
+    /** Stop firing. In-flight runs finish; no new ones start. */
+    stop(): void;
+    /** Evaluate all tasks once and run those that are due. Safe to call directly (tests). */
+    tick(): Promise<void>;
+    /** Force-run a task now regardless of schedule/enabled. Null if unknown/already running. */
+    runNow(id: string): Promise<TaskRunOutcome | null>;
+    /** Ids of tasks currently running. */
+    active(): string[];
+    /** Whether `start()` is in effect. */
+    isRunning(): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/autonomy/types.js

@@ -0,0 +1,20 @@
+/**
+ * Autonomy — the agent's task brain.
+ *
+ * This is the half of "the agent's memory" the {@link ../memory/types MemoryStore}
+ * (soul + facts) does NOT cover: the *operational* state nanobot kept across
+ * `tasks.json` + `cron/jobs.json` + its run history. Lifted into core so every
+ * host (desktop sidecar, agent, cli) runs the same autonomous loop — storage
+ * and timers are injected (fs/SQLite on Node, AsyncStorage on RN), the logic is
+ * pure TS with zero runtime deps.
+ *
+ * Three pieces:
+ *   - TaskStore   — the registry of scheduled/manual tasks (was tasks-store.ts)
+ *   - TaskRunLog  — what each task did, when, and what it cost (was agent-state.ts)
+ *   - Scheduler   — fires due tasks on their interval (was nanobot cron)
+ *
+ * Spend safety lives alongside in {@link ./risk}.
+ */
+/** A zero allocation — the default for read-only / monitoring tasks. */
+export const ZERO_ALLOCATION = { btcSat: 0, usdt: 0, xaut: 0 };
+//# sourceMappingURL=types.js.map

package/dist/autonomy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/autonomy/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAmB,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC"}

package/dist/bitrefill/contract.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Canonical Bitrefill tool contract — gift cards, mobile top-ups, eSIMs.
+ *
+ * Same pattern as the LSPS1 contract: the tool *names + schemas* live here so
+ * every host (CLI REST adapter, desktop MCP, mobile WDK adapter) exposes the
+ * exact same surface to the agent. Only the transport differs.
+ *
+ *   - CLI / desktop server → REST against `https://api.bitrefill.com/v2`
+ *     (see `apps/cli/src/bitrefillTools.ts`).
+ *   - Desktop sidecar      → the remote MCP at `api.bitrefill.com/mcp` already
+ *     exposes equivalent tools under different names; a binder there can
+ *     rename them to this contract for parity.
+ *
+ * `bitrefill_create_invoice` is the spend — confirmation-gated by the contract.
+ * Everything else is read-only (search, product details, balance, invoice/order
+ * status). Invoice creation supports `payment_method:"balance"` (instant, pulls
+ * from pre-funded account) or `lightning|bitcoin|usdc_base|...` (the response
+ * carries a payment URI/invoice; the user pays out-of-band, then the order is
+ * fulfilled).
+ *
+ * Pure data — no deps, no fetch, RN-safe.
+ */
+import type { ToolDef } from '../types.js';
+import { InProcessToolSource } from '../tools/in-process.js';
+export interface BitrefillToolDef extends ToolDef {
+    /** Moves real money → confirmation-gated. */
+    spend?: boolean;
+}
+/**
+ * The canonical Bitrefill tool list. Each host's binder translates these
+ * args into the Bitrefill REST body (CLI) or MCP/CLI call (other hosts).
+ */
+export declare const BITREFILL_TOOLS: BitrefillToolDef[];
+/** All Bitrefill tool names that move money (confirmation-gated). */
+export declare const BITREFILL_SPEND_TOOLS: Set<string>;
+export declare function isBitrefillSpendTool(name: string): boolean;
+export declare function getBitrefillTool(name: string): BitrefillToolDef | undefined;
+/** A handler bound to one Bitrefill tool. */
+export type BitrefillHandler = (args: Record<string, unknown>) => Promise<unknown>;
+export interface BindBitrefillOptions {
+    /** Skip tools without a handler instead of throwing (default false). */
+    allowMissing?: boolean;
+    /** ToolSource id for the registry (default 'bitrefill'). */
+    id?: string;
+}
+/**
+ * Bind Bitrefill contract tools to in-process handlers → an InProcessToolSource.
+ *
+ *   const source = bindBitrefillTools({
+ *     bitrefill_search:         async (args) => api.search(args),
+ *     bitrefill_get_product:    async ({ product_id }) => api.product(product_id),
+ *     bitrefill_get_balance:    async () => api.balance(),
+ *     bitrefill_create_invoice: async (args) => api.createInvoice(args),
+ *     bitrefill_get_invoice:    async ({ invoice_id }) => api.invoice(invoice_id),
+ *     bitrefill_get_order:      async ({ order_id }) => api.order(order_id),
+ *   });
+ *   tools.register(source);
+ */
+export declare function bindBitrefillTools(handlers: Record<string, BitrefillHandler>, opts?: BindBitrefillOptions): InProcessToolSource;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/bitrefill/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,WAAW,gBAAiB,SAAQ,OAAO;IAC/C,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAuBD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,gBAAgB,EA0E7C,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAE7C,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE3E;AAED,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC1C,IAAI,GAAE,oBAAyB,GAC9B,mBAAmB,CAiBrB"}

package/dist/bitrefill/contract.js

@@ -0,0 +1,119 @@
+/**
+ * Canonical Bitrefill tool contract — gift cards, mobile top-ups, eSIMs.
+ *
+ * Same pattern as the LSPS1 contract: the tool *names + schemas* live here so
+ * every host (CLI REST adapter, desktop MCP, mobile WDK adapter) exposes the
+ * exact same surface to the agent. Only the transport differs.
+ *
+ *   - CLI / desktop server → REST against `https://api.bitrefill.com/v2`
+ *     (see `apps/cli/src/bitrefillTools.ts`).
+ *   - Desktop sidecar      → the remote MCP at `api.bitrefill.com/mcp` already
+ *     exposes equivalent tools under different names; a binder there can
+ *     rename them to this contract for parity.
+ *
+ * `bitrefill_create_invoice` is the spend — confirmation-gated by the contract.
+ * Everything else is read-only (search, product details, balance, invoice/order
+ * status). Invoice creation supports `payment_method:"balance"` (instant, pulls
+ * from pre-funded account) or `lightning|bitcoin|usdc_base|...` (the response
+ * carries a payment URI/invoice; the user pays out-of-band, then the order is
+ * fulfilled).
+ *
+ * Pure data — no deps, no fetch, RN-safe.
+ */
+import { InProcessToolSource } from '../tools/in-process.js';
+function t(name, description, properties = {}, required = [], spend = false) {
+    return {
+        name,
+        description,
+        spend,
+        requiresConfirmation: spend,
+        parameters: { type: 'object', properties, required },
+    };
+}
+/**
+ * The canonical Bitrefill tool list. Each host's binder translates these
+ * args into the Bitrefill REST body (CLI) or MCP/CLI call (other hosts).
+ */
+export const BITREFILL_TOOLS = [
+    t('bitrefill_search', "Search Bitrefill's product catalog by keyword (brand, country, type). Returns up to ~20 matches with `id`, `name`, `country`, `category` and `denominations`. The model picks the right product id and then calls `bitrefill_get_product` for the package list.", {
+        query: { type: 'string', description: 'Search keyword. e.g. "amazon", "steam", "vodafone uk", "esim europe".' },
+        country: { type: 'string', description: 'OPTIONAL — ISO country code to scope results (e.g. "US", "GB", "DE"). Many brands are country-specific.' },
+        limit: { type: 'number', description: 'OPTIONAL — max results (1–25, default 10).' },
+    }, ['query']),
+    t('bitrefill_get_product', "Get full details for one product, including its `packages` array (each package = a denomination with `id`, `value`, `price`, `currency`). Use the package `id` (NOT the bare value) when creating an invoice.", {
+        product_id: { type: 'string', description: 'Product slug from bitrefill_search, e.g. "amazon-us", "steam-us".' },
+    }, ['product_id']),
+    t('bitrefill_get_balance', "Get the user's Bitrefill account balance (the pre-funded pool used by `payment_method:\"balance\"`). Returns `{ balance, currency }`. No args."),
+    t('bitrefill_create_invoice', "SPEND: confirmation-gated. Create an invoice for one or more products. Pass `payment_method:\"balance\"` + `auto_pay:true` for instant fulfillment from the account balance (lowest blast radius). For Lightning/on-chain, omit `auto_pay`, set `payment_method:\"lightning\"` (etc.) and `refund_address` — the response carries the payment URI; poll `bitrefill_get_invoice` until status=\"complete\" and then read the order. Up to 20 line items per invoice.", {
+        products: {
+            type: 'array',
+            description: 'Line items. Each: { product_id, package_id, quantity }. Get `package_id` from bitrefill_get_product (NOT the bare denomination value).',
+            items: {
+                type: 'object',
+                properties: {
+                    product_id: { type: 'string' },
+                    package_id: { type: 'string' },
+                    quantity: { type: 'number' },
+                },
+                required: ['product_id', 'package_id', 'quantity'],
+            },
+        },
+        payment_method: {
+            type: 'string',
+            description: 'How to pay: "balance" (account balance, instant), "lightning", "bitcoin", "usdc_base" (x402), "usdc_polygon", "usdt_tron", etc.',
+            enum: ['balance', 'lightning', 'bitcoin', 'usdc_base', 'usdc_polygon', 'usdc_ethereum', 'usdt_tron', 'usdt_ethereum'],
+        },
+        auto_pay: { type: 'boolean', description: 'Required true with `payment_method:"balance"` for instant settlement. Omit for crypto methods.' },
+        refund_address: { type: 'string', description: 'REQUIRED for non-balance crypto methods — refund destination if the invoice expires or partially pays.' },
+        email: { type: 'string', description: 'OPTIONAL — delivery / receipt email. Defaults to the account email when authenticated.' },
+        webhook_url: { type: 'string', description: 'OPTIONAL — URL Bitrefill calls when the order is delivered.' },
+    }, ['products', 'payment_method'], 
+    /* spend */ true),
+    t('bitrefill_get_invoice', "Get the invoice's current status: `unpaid`, `pending`, `paid`, `complete`, `expired`, `failed`. For crypto payment methods, poll this until `complete`; then call `bitrefill_get_order` for redemption details.", {
+        invoice_id: { type: 'string', description: 'Invoice id returned by bitrefill_create_invoice.' },
+    }, ['invoice_id']),
+    t('bitrefill_get_order', "Get an order's redemption details once delivered. Returns `redemption_info` containing the code, PIN (for prepaid cards), redemption link, instructions. ONLY call after the corresponding invoice status is `complete`. Treat the returned code as cash — never paste it in shared chats.", {
+        order_id: { type: 'string', description: 'Order id from a completed invoice (`order_id` on the invoice or in its `orders[]`).' },
+    }, ['order_id']),
+];
+/** All Bitrefill tool names that move money (confirmation-gated). */
+export const BITREFILL_SPEND_TOOLS = new Set(BITREFILL_TOOLS.filter((t) => t.spend).map((t) => t.name));
+export function isBitrefillSpendTool(name) {
+    return BITREFILL_SPEND_TOOLS.has(name);
+}
+export function getBitrefillTool(name) {
+    return BITREFILL_TOOLS.find((t) => t.name === name);
+}
+/**
+ * Bind Bitrefill contract tools to in-process handlers → an InProcessToolSource.
+ *
+ *   const source = bindBitrefillTools({
+ *     bitrefill_search:         async (args) => api.search(args),
+ *     bitrefill_get_product:    async ({ product_id }) => api.product(product_id),
+ *     bitrefill_get_balance:    async () => api.balance(),
+ *     bitrefill_create_invoice: async (args) => api.createInvoice(args),
+ *     bitrefill_get_invoice:    async ({ invoice_id }) => api.invoice(invoice_id),
+ *     bitrefill_get_order:      async ({ order_id }) => api.order(order_id),
+ *   });
+ *   tools.register(source);
+ */
+export function bindBitrefillTools(handlers, opts = {}) {
+    const bound = [];
+    for (const def of BITREFILL_TOOLS) {
+        const handler = handlers[def.name];
+        if (!handler) {
+            if (opts.allowMissing)
+                continue;
+            throw new Error(`bindBitrefillTools: 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 ?? 'bitrefill', bound);
+}
+//# sourceMappingURL=contract.js.map

package/dist/bitrefill/contract.js.map

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

package/dist/context/compress.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Tool-output compression — the "fit more into a tiny window" part.
+ *
+ * Tool results are the single biggest, most repetitive thing the engine pushes
+ * into a small on-device model's context. A merchant search returns 40 near
+ * identical rows; a tx history returns hundreds; a swap quote nests config the
+ * model never reads. Every round, the *raw* `JSON.stringify(result)` is fed back
+ * into history — so on a 2k-window 0.6B model the conversation drowns in JSON
+ * the model didn't need, crowding out the system prompt, the skill, and the
+ * actual question.
+ *
+ * `compressToolResult` is a structural crusher (the idea behind Headroom's
+ * SmartCrusher/ToolCrusher, reimplemented natively — no dependency, no network,
+ * no proxy, so it stays on-device and private). It walks the JSON and:
+ *
+ *   • dedupes identical array items, then keeps the first/last few and replaces
+ *     the middle with an honest `{ "__elided__": N }` marker,
+ *   • caps nesting depth (deep config → a one-line summary),
+ *   • truncates long *prose* strings (logs, descriptions),
+ *
+ * and never regresses: if crushing doesn't actually save tokens, the original
+ * is returned untouched.
+ *
+ * SAFETY: it never touches numbers, never elides whole objects, never truncates
+ * whitespace-free strings (addresses, BOLT11 invoices, txids, pubkeys), and
+ * never touches a value under a money/identity key (see DEFAULT_PRESERVE_KEYS).
+ * Amounts and recipients reach the model intact — the confirm readback is built
+ * deterministically from the resolved call anyway, but this keeps the model's
+ * own view honest too. Small results (below `minTokens`) are passed through
+ * verbatim so nothing changes for the common case.
+ */
+/** Keys whose values are never elided or truncated — amounts, ids, recipients. */
+export declare const DEFAULT_PRESERVE_KEYS: readonly string[];
+export interface ToolCrushOptions {
+    /** Don't compress results estimated below this many tokens. Default 200. */
+    minTokens?: number;
+    /** Max items kept in any array before the middle is elided. Default 8. */
+    maxArrayItems?: number;
+    /** Max nesting depth kept verbatim; deeper is summarized. Default 6. */
+    maxDepth?: number;
+    /** Max chars for a single prose string before truncation (0 disables). Default 600. */
+    maxStringLength?: number;
+    /** Dedupe identical array items before eliding. Default true. */
+    dedupe?: boolean;
+    /** Keys whose values are never elided/truncated (defaults to DEFAULT_PRESERVE_KEYS). */
+    preserveKeys?: readonly string[];
+}
+export interface CrushResult {
+    /** Serialized, compressed content — ready to push into history. */
+    content: string;
+    /** Estimated tokens of the original serialization. */
+    originalTokens: number;
+    /** Estimated tokens after crushing. */
+    compressedTokens: number;
+    /** Total array items dropped across the whole structure. */
+    elided: number;
+    /** False when the original was returned untouched (too small, or no win). */
+    changed: boolean;
+}
+/**
+ * Crush a tool result for inclusion in model context. Returns the original,
+ * verbatim, when it's small or when crushing wouldn't save tokens.
+ */
+export declare function compressToolResult(value: unknown, opts?: ToolCrushOptions): CrushResult;
+//# sourceMappingURL=compress.d.ts.map

package/dist/context/compress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["../../src/context/compress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAiClD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wFAAwF;IACxF,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;CAClB;AA4BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,gBAAqB,GAAG,WAAW,CA+B3F"}