@kaleidorg/mind 0.6.4 → 0.8.0

package/dist/skills/select.js

@@ -0,0 +1,32 @@
+/**
+ * Tool-aware skill selection: pick a skill that can actually act with the tools
+ * a host has, before any inference runs.
+ */
+import { READ_REFERENCE_TOOL, SkillRegistry } from './registry.js';
+/**
+ * Whether a skill can act given the live tool names. A `requires-tools`
+ * frontmatter list must be fully live; otherwise at least one of the skill's
+ * scoped tools must be.
+ */
+export function skillAvailable(skill, present) {
+    const required = skill.metadata?.['requires-tools'];
+    if (required) {
+        return required.split(',').map((t) => t.trim()).filter(Boolean).every((t) => present.has(t));
+    }
+    if (!skill.tools?.length)
+        return true;
+    return skill.tools.some((t) => t !== READ_REFERENCE_TOOL && present.has(t));
+}
+/**
+ * Select the best skill for `query` among those that can act with `liveTools`.
+ * Skills whose `requires-tools` are missing are never picked; a skill with zero
+ * live tools is only a last resort.
+ */
+export function selectAvailableSkill(skills, query, liveTools) {
+    const list = skills instanceof SkillRegistry ? skills.list() : [...skills];
+    const present = new Set([...liveTools].map((t) => (typeof t === 'string' ? t : t.name)));
+    const usable = list.filter((s) => skillAvailable(s, present));
+    return (new SkillRegistry(usable).select(query) ??
+        new SkillRegistry(list.filter((s) => !s.metadata?.['requires-tools'] && !usable.includes(s))).select(query));
+}
+//# sourceMappingURL=select.js.map

package/dist/skills/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/skills/select.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,OAA4B;IACvE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,CAAC;IACpD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAwC,EACxC,KAAa,EACb,SAAmD;IAEnD,MAAM,IAAI,GAAG,MAAM,YAAY,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,OAAO,CACL,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACvC,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAC5G,CAAC;AACJ,CAAC"}

package/dist/submarine/contract.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Canonical submarine-swap tool contract — pay a Lightning invoice from Liquid
+ * funds through the KaleidoSwap Boltz /v2 maker (kaleidoswap-maker-rs).
+ *
+ * The names match kaleido-mcp, which implements them over @kaleidorg/swap-sdk.
+ * Hosts with the SDK in-process (desktop sidecar, React Native) bind the same
+ * names with `bindSubmarineTools`.
+ *
+ * Keys and preimages never cross this contract: the host derives the refund key
+ * from its wallet mnemonic and persists the swap. `kaleidoswap_submarine_fund`
+ * — the only spend — takes nothing but the swap id, so the model cannot alter
+ * the amount, asset or lockup address it pays.
+ *
+ * Pure data — no deps, no fetch, RN-safe.
+ */
+import type { ToolDef } from '../types.js';
+import { InProcessToolSource } from '../tools/in-process.js';
+export interface SubmarineToolDef extends ToolDef {
+    /** Moves funds → confirmation-gated. */
+    spend?: boolean;
+}
+/** Assets a submarine swap can be paid from, as the maker names them. */
+export declare const SUBMARINE_FROM_ASSETS: readonly ['L-USDT', 'L-BTC'];
+export type SubmarineFromAsset = typeof SUBMARINE_FROM_ASSETS[number];
+/** Smallest-unit decimals of each source asset (L-USDT: 8, L-BTC: sats). */
+export declare const SUBMARINE_ASSET_DECIMALS: Record<SubmarineFromAsset, number>;
+export declare const SUBMARINE_TOOLS: SubmarineToolDef[];
+export declare const SUBMARINE_SPEND_TOOLS: Set<string>;
+export declare function isSubmarineSpendTool(name: string): boolean;
+export declare function getSubmarineTool(name: string): SubmarineToolDef | undefined;
+/** Format a smallest-unit amount of a source asset for display ("52.3 L-USDT", "1,200 sats"). */
+export declare function formatSubmarineAmount(asset: string, smallestUnits: unknown): string;
+export type SubmarineHandler = (args: Record<string, unknown>) => Promise<unknown>;
+export interface BindSubmarineOptions {
+    /** Skip tools without a handler instead of throwing (default false). */
+    allowMissing?: boolean;
+    /** ToolSource id for the registry (default 'submarine'). */
+    id?: string;
+}
+/** Bind the submarine contract to in-process handlers → an InProcessToolSource. */
+export declare function bindSubmarineTools(handlers: Record<string, SubmarineHandler>, opts?: BindSubmarineOptions): InProcessToolSource;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/submarine/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;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,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAQD,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,YAAI,QAAQ,EAAE,OAAO,CAAU,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAEtE,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAA+B,CAAC;AAIxG,eAAO,MAAM,eAAe,EAAE,gBAAgB,EAsB7C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAsE,CAAC;AAErH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE3E;AAED,iGAAiG;AACjG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,MAAM,CAOnF;AAED,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,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,IAAI,GAAE,oBAAyB,GAAG,mBAAmB,CAiBnI"}

package/dist/submarine/contract.js

@@ -0,0 +1,73 @@
+/**
+ * Canonical submarine-swap tool contract — pay a Lightning invoice from Liquid
+ * funds through the KaleidoSwap Boltz /v2 maker (kaleidoswap-maker-rs).
+ *
+ * The names match kaleido-mcp, which implements them over @kaleidorg/swap-sdk.
+ * Hosts with the SDK in-process (desktop sidecar, React Native) bind the same
+ * names with `bindSubmarineTools`.
+ *
+ * Keys and preimages never cross this contract: the host derives the refund key
+ * from its wallet mnemonic and persists the swap. `kaleidoswap_submarine_fund`
+ * — the only spend — takes nothing but the swap id, so the model cannot alter
+ * the amount, asset or lockup address it pays.
+ *
+ * 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 } };
+}
+/** Assets a submarine swap can be paid from, as the maker names them. */
+export const SUBMARINE_FROM_ASSETS = ['L-USDT', 'L-BTC'];
+/** Smallest-unit decimals of each source asset (L-USDT: 8, L-BTC: sats). */
+export const SUBMARINE_ASSET_DECIMALS = { 'L-USDT': 8, 'L-BTC': 8 };
+const swapId = { type: 'string', description: 'Swap id returned by kaleidoswap_submarine_create' };
+export const SUBMARINE_TOOLS = [
+    t('kaleidoswap_submarine_pairs', 'List what can pay a Lightning invoice through a submarine swap (e.g. L-USDT on Liquid → Lightning BTC): rate, min/max, fees. No args.'),
+    t('kaleidoswap_submarine_create', 'Open a submarine swap that pays a Lightning (BOLT11) invoice from Liquid funds. No funds move: returns swap_id and expected_amount (source asset smallest unit). Then confirm with the user and call kaleidoswap_submarine_fund.', {
+        invoice: { type: 'string', description: 'BOLT11 Lightning invoice to pay (must carry an amount)' },
+        from_asset: { type: 'string', enum: [...SUBMARINE_FROM_ASSETS], description: 'Asset to pay with (default L-USDT)' },
+    }, ['invoice']),
+    t('kaleidoswap_submarine_fund', 'SPEND: lock the funds for a swap from kaleidoswap_submarine_create. Takes only the swap id — amount, asset and address come from the stored swap. The maker then pays the invoice.', { swap_id: swapId }, ['swap_id'], 
+    /* spend */ true),
+    t('kaleidoswap_submarine_status', 'Status of a submarine swap. "transaction.claimed" = invoice paid, done. A failed funded swap needs a refund.', { swap_id: swapId }, ['swap_id']),
+];
+export const SUBMARINE_SPEND_TOOLS = new Set(SUBMARINE_TOOLS.filter((d) => d.spend).map((d) => d.name));
+export function isSubmarineSpendTool(name) {
+    return SUBMARINE_SPEND_TOOLS.has(name);
+}
+export function getSubmarineTool(name) {
+    return SUBMARINE_TOOLS.find((d) => d.name === name);
+}
+/** Format a smallest-unit amount of a source asset for display ("52.3 L-USDT", "1,200 sats"). */
+export function formatSubmarineAmount(asset, smallestUnits) {
+    const n = Number(smallestUnits);
+    if (!Number.isFinite(n))
+        return `${String(smallestUnits)} ${asset}`;
+    if (asset === 'L-BTC')
+        return `${n.toLocaleString('en-US')} sats of L-BTC`;
+    const decimals = SUBMARINE_ASSET_DECIMALS[asset] ?? 0;
+    const value = n / 10 ** decimals;
+    return `${value.toLocaleString('en-US', { maximumFractionDigits: decimals })} ${asset}`;
+}
+/** Bind the submarine contract to in-process handlers → an InProcessToolSource. */
+export function bindSubmarineTools(handlers, opts = {}) {
+    const bound = [];
+    for (const def of SUBMARINE_TOOLS) {
+        const handler = handlers[def.name];
+        if (!handler) {
+            if (opts.allowMissing)
+                continue;
+            throw new Error(`bindSubmarineTools: 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 ?? 'submarine', bound);
+}
+//# sourceMappingURL=contract.js.map

package/dist/submarine/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/submarine/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAU7D,SAAS,CAAC,CAAC,IAAY,EAAE,WAAmB,EAAE,UAAU,GAAU,EAAE,EAAE,QAAQ,GAAa,EAAE,EAAE,KAAK,GAAG,KAAK;IAC1G,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC;AACzH,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAU,CAAC;AAGlE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAuC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AAExG,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAW,CAAC;AAE5G,MAAM,CAAC,MAAM,eAAe,GAAuB;IACjD,CAAC,CAAC,6BAA6B,EAC7B,uIAAuI,CAAC;IAE1I,CAAC,CAAC,8BAA8B,EAC9B,kOAAkO,EAClO;QACE,OAAO,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;QACrG,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,qBAAqB,CAAC,EAAE,WAAW,EAAE,oCAAoC,EAAE;KACpH,EACD,CAAC,SAAS,CAAC,CAAC;IAEd,CAAC,CAAC,4BAA4B,EAC5B,oLAAoL,EACpL,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,CAAC,SAAS,CAAC;IACX,WAAW,CAAC,IAAI,CAAC;IAEnB,CAAC,CAAC,8BAA8B,EAC9B,8GAA8G,EAC9G,EAAE,OAAO,EAAE,MAAM,EAAE,EACnB,CAAC,SAAS,CAAC,CAAC;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAgB,IAAI,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAErH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,aAAsB;IACzE,MAAM,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,EAAE,CAAC;IACpE,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,GAAG,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAC3E,MAAM,QAAQ,GAAG,wBAAwB,CAAC,KAA2B,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC;IACjC,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;AAC1F,CAAC;AAWD,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,QAA0C,EAAE,IAAI,GAAyB,EAAE;IAC5G,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,YAAY;gBAAE,SAAS;YAChC,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,oBAAoB,EAAE,GAAG,CAAC,oBAAoB;YAC9C,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,IAAI,WAAW,EAAE,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @kaleidorg/mind/testing — build and demo an agent with no node, no funds and
+ * no model: a stateful mock wallet bound to the canonical contract, plus a
+ * scripted provider.
+ *
+ *   import { MockWallet, scriptedProvider } from '@kaleidorg/mind/testing';
+ *   const wallet = new MockWallet();
+ *   const funnel = new Funnel({ provider: scriptedProvider(), tools: wallet.registry(), … });
+ */
+export { MockWallet } from './mock-wallet.js';
+export type { MockWalletOptions, MockContact, MockRgbAsset, MockTransfer, SendRecord } from './mock-wallet.js';
+export { scriptedProvider } from './scripted-provider.js';
+export type { ScriptedTurn } from './scripted-provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/G,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,12 @@
+/**
+ * @kaleidorg/mind/testing — build and demo an agent with no node, no funds and
+ * no model: a stateful mock wallet bound to the canonical contract, plus a
+ * scripted provider.
+ *
+ *   import { MockWallet, scriptedProvider } from '@kaleidorg/mind/testing';
+ *   const wallet = new MockWallet();
+ *   const funnel = new Funnel({ provider: scriptedProvider(), tools: wallet.registry(), … });
+ */
+export { MockWallet } from './mock-wallet.js';
+export { scriptedProvider } from './scripted-provider.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/testing/mock-wallet.d.ts

@@ -0,0 +1,103 @@
+/**
+ * A stateful mock wallet — balances per layer, contacts (incl. ambiguous +
+ * injectable), a price, validation (insufficient funds, no route, unknown
+ * contact, no colored UTXOs), RGB issuance, and a record of what actually got
+ * "sent". The canonical contract tools bind to it, so the agent sees real
+ * schemas and real failure modes — not trivial canned stubs.
+ *
+ * Used by the eval harness and exported as `@kaleidorg/mind/testing` so hosts
+ * can build and demo an agent with no node, no funds and no network.
+ */
+import { type WalletHandler } from '../wallet/contract.js';
+import { ToolRegistry } from '../tools/registry.js';
+import { type SubmarineHandler } from '../submarine/contract.js';
+export interface SendRecord {
+    tool: string;
+    to: string;
+    amount_sats?: number;
+    asset?: string;
+    amount?: number;
+}
+export interface MockContact {
+    name: string;
+    ln_address: string;
+    note?: string;
+}
+export interface MockWalletOptions {
+    priceUsd?: number;
+    failRoute?: boolean;
+    contacts?: MockContact[];
+    balances?: {
+        spark: number;
+        rln: number;
+        arkade: number;
+    };
+    assets?: Record<string, number>;
+    /** Free colored UTXOs on the RLN node (issuance / RGB receive consume one). */
+    utxos?: number;
+    /** Liquid balances in smallest units (L-USDT: 8 decimals, L-BTC: sats) for submarine swaps. */
+    liquid?: {
+        'L-USDT': number;
+        'L-BTC': number;
+    };
+}
+export interface MockRgbAsset {
+    asset_id: string;
+    ticker: string;
+    name: string;
+    precision: number;
+    schema: 'NIA' | 'CFA' | 'UDA';
+    issued_supply: number;
+}
+export interface MockTransfer {
+    idx: number;
+    asset_id: string;
+    kind: 'Issuance' | 'Send' | 'ReceiveBlind';
+    status: 'Settled' | 'WaitingCounterparty';
+    amount: number;
+}
+export declare class MockWallet {
+    priceUsd: number;
+    failRoute: boolean;
+    balances: {
+        spark: number;
+        rln: number;
+        arkade: number;
+    };
+    assets: Record<string, number>;
+    contacts: MockContact[];
+    utxos: number;
+    liquid: {
+        'L-USDT': number;
+        'L-BTC': number;
+    };
+    /** Submarine swaps opened against the mock /v2 maker, by id. */
+    submarineSwaps: Record<string, {
+        from: 'L-USDT' | 'L-BTC';
+        invoice: string;
+        expected: number;
+        funded: boolean;
+    }>;
+    /** RGB assets the node knows about (seeded USDT/XAUT + anything issued). */
+    rgbAssets: MockRgbAsset[];
+    transfers: MockTransfer[];
+    sends: SendRecord[];
+    private readonly opts;
+    constructor(o?: MockWalletOptions);
+    private findAsset;
+    /** Issue a new RGB asset — mirrors the node: needs a free colored UTXO. */
+    issueAsset(args: Record<string, unknown>): MockRgbAsset;
+    totalSats(): number;
+    /** Back to the constructor state: balances, contacts, UTXOs, issued assets, history. */
+    reset(): void;
+    private send;
+    handlers(): Record<string, WalletHandler>;
+    /**
+     * The KaleidoSwap /v2 submarine contract against a toy maker: 0.5% fee, the
+     * invoice amount read from its BOLT11 human-readable part, L-USDT at `priceUsd`.
+     */
+    submarineHandlers(): Record<string, SubmarineHandler>;
+    /** Bind the contract tools to this wallet (optionally overriding some — e.g. to inject). */
+    registry(overrides?: Partial<Record<string, WalletHandler>>): ToolRegistry;
+}
+//# sourceMappingURL=mock-wallet.d.ts.map

package/dist/testing/mock-wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-wallet.d.ts","sourceRoot":"","sources":["../../src/testing/mock-wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAErF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAChF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AACD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,cAAc,CAAC;IAC3C,MAAM,EAAE,SAAS,GAAG,qBAAqB,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAU;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAM;IACtH,4EAA4E;IAC5E,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,SAAS,EAAE,YAAY,EAAE,CAAM;IAC/B,KAAK,EAAE,UAAU,EAAE,CAAM;IAEzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IAEzC,YAAY,CAAC,GAAE,iBAAsB,EAuBpC;IAED,OAAO,CAAC,SAAS;IAKjB,2EAA2E;IAC3E,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAsBtD;IAED,SAAS,IAAI,MAAM,CAElB;IACD,wFAAwF;IACxF,KAAK,IAAI,IAAI,CAEZ;IAED,OAAO,CAAC,IAAI;IASZ,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAoExC;IAED;;;OAGG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAoCpD;IAED,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,GAAG,YAAY,CAOzE;CACF"}

package/dist/testing/mock-wallet.js

@@ -0,0 +1,249 @@
+/**
+ * A stateful mock wallet — balances per layer, contacts (incl. ambiguous +
+ * injectable), a price, validation (insufficient funds, no route, unknown
+ * contact, no colored UTXOs), RGB issuance, and a record of what actually got
+ * "sent". The canonical contract tools bind to it, so the agent sees real
+ * schemas and real failure modes — not trivial canned stubs.
+ *
+ * Used by the eval harness and exported as `@kaleidorg/mind/testing` so hosts
+ * can build and demo an agent with no node, no funds and no network.
+ */
+import { bindWalletTools } from '../wallet/contract.js';
+import { ToolRegistry } from '../tools/registry.js';
+import { bindSubmarineTools } from '../submarine/contract.js';
+export class MockWallet {
+    priceUsd;
+    failRoute;
+    balances;
+    assets;
+    contacts;
+    utxos;
+    liquid;
+    /** Submarine swaps opened against the mock /v2 maker, by id. */
+    submarineSwaps = {};
+    /** RGB assets the node knows about (seeded USDT/XAUT + anything issued). */
+    rgbAssets;
+    transfers = [];
+    sends = [];
+    opts;
+    constructor(o = {}) {
+        this.opts = o;
+        this.priceUsd = o.priceUsd ?? 65_000;
+        this.failRoute = o.failRoute ?? false;
+        // Copies: the wallet mutates its state, and reset() rebuilds from `o`.
+        this.balances = { ...(o.balances ?? { spark: 500_000, rln: 300_000, arkade: 200_000 }) };
+        this.assets = { ...(o.assets ?? { USDT: 25_000_000, XAUT: 0 }) };
+        this.contacts = o.contacts ? [...o.contacts] : [
+            { name: 'bob', ln_address: 'bob@kaleidoswap.com' },
+            { name: 'alice', ln_address: 'alice@kaleidoswap.com' },
+            { name: 'john', ln_address: 'john.smith@kaleidoswap.com' },
+            { name: 'john', ln_address: 'john.doe@kaleidoswap.com' }, // ambiguous on purpose
+        ];
+        this.utxos = o.utxos ?? 5;
+        this.liquid = { ...(o.liquid ?? { 'L-USDT': 100 * 1e8, 'L-BTC': 200_000 }) };
+        this.rgbAssets = Object.keys(this.assets).map((ticker) => ({
+            asset_id: mockAssetId(ticker),
+            ticker,
+            name: ticker === 'USDT' ? 'Tether USD' : ticker === 'XAUT' ? 'Tether Gold' : ticker,
+            precision: 0,
+            schema: 'NIA',
+            issued_supply: this.assets[ticker],
+        }));
+    }
+    findAsset(ref) {
+        const q = String(ref ?? '');
+        return this.rgbAssets.find((a) => a.asset_id === q || a.ticker.toUpperCase() === q.toUpperCase());
+    }
+    /** Issue a new RGB asset — mirrors the node: needs a free colored UTXO. */
+    issueAsset(args) {
+        if (this.utxos < 1)
+            throw new Error('No available colored UTXOs — call rln_create_utxos first.');
+        const schema = (['NIA', 'CFA', 'UDA'].includes(String(args.schema)) ? args.schema : 'NIA');
+        const ticker = String(args.ticker ?? '').toUpperCase();
+        if (!/^[A-Z0-9]{1,8}$/.test(ticker))
+            throw new Error('ticker must be 1-8 uppercase letters/digits.');
+        if (this.findAsset(ticker))
+            throw new Error(`An asset with ticker ${ticker} already exists.`);
+        const supply = schema === 'UDA' ? 1 : Number(args.amount);
+        if (!(supply > 0))
+            throw new Error('amount must be positive.');
+        const asset = {
+            asset_id: mockAssetId(ticker),
+            ticker,
+            name: String(args.name ?? ticker),
+            precision: Number(args.precision ?? 0),
+            schema,
+            issued_supply: supply,
+        };
+        this.utxos -= 1;
+        this.rgbAssets.push(asset);
+        this.assets[ticker] = supply;
+        this.transfers.push({ idx: this.transfers.length + 1, asset_id: asset.asset_id, kind: 'Issuance', status: 'Settled', amount: supply });
+        this.sends.push({ tool: 'rln_issue_asset', to: 'self', asset: ticker, amount: supply });
+        return asset;
+    }
+    totalSats() {
+        return this.balances.spark + this.balances.rln + this.balances.arkade;
+    }
+    /** Back to the constructor state: balances, contacts, UTXOs, issued assets, history. */
+    reset() {
+        Object.assign(this, new MockWallet(this.opts));
+    }
+    send(tool, rec) {
+        if (this.failRoute)
+            throw new Error('No route to destination.');
+        if (rec.amount_sats != null && rec.amount_sats > this.totalSats()) {
+            throw new Error(`Insufficient funds: have ${this.totalSats()} sats, need ${rec.amount_sats}.`);
+        }
+        this.sends.push({ tool, ...rec });
+        return { status: 'SUCCESS', payment_hash: 'mock' + this.sends.length };
+    }
+    handlers() {
+        return {
+            get_balances: async () => ({
+                total_sats: this.totalSats(),
+                layers: [
+                    { layer: 'spark', btc_sats: this.balances.spark, assets: [] },
+                    { layer: 'rln', btc_sats: this.balances.rln, assets: Object.entries(this.assets).filter(([, v]) => v > 0).map(([ticker, amount]) => ({ ticker, amount })) },
+                    { layer: 'arkade', btc_sats: this.balances.arkade, assets: [] },
+                ],
+            }),
+            spark_get_balance: async () => ({ btc_sats: this.balances.spark }),
+            rln_get_balances: async () => ({ btc_sats: this.balances.rln, assets: this.assets }),
+            arkade_get_balance: async () => ({ btc_sats: this.balances.arkade }),
+            spark_get_address: async () => ({ address: 'bc1qspark0mockreceiveaddr' }),
+            arkade_get_address: async () => ({ address: 'ark1q0mockreceiveaddr' }),
+            get_price: async ({ fiat }) => ({ asset: 'BTC', price_usd: this.priceUsd, fiat: fiat ?? 'USD' }),
+            fiat_to_sats: async ({ amount }) => ({ sats: Math.round((Number(amount) / this.priceUsd) * 1e8) }),
+            resolve_contact: async ({ name }) => {
+                const q = String(name).toLowerCase();
+                const matches = this.contacts.filter((c) => c.name.toLowerCase() === q);
+                if (matches.length === 0)
+                    throw new Error(`No contact named "${name}".`);
+                if (matches.length > 1)
+                    throw new Error(`Ambiguous: ${matches.length} contacts named "${name}" — ask the user which one.`);
+                return matches[0];
+            },
+            rln_create_ln_invoice: async ({ amount_sats }) => ({ invoice: `lnbcmock${amount_sats ?? ''}` }),
+            rln_create_rgb_invoice: async ({ asset, amount }) => ({ invoice: 'rgb:mockinvoice', asset, amount }),
+            send_payment: async ({ to, amount_sats }) => this.send('send_payment', { to: String(to), amount_sats: amount_sats != null ? Number(amount_sats) : undefined }),
+            rln_pay_invoice: async ({ invoice }) => this.send('rln_pay_invoice', { to: String(invoice) }),
+            rln_send_asset: async ({ asset, amount, to }) => {
+                const a = String(asset);
+                if ((this.assets[a] ?? 0) < Number(amount))
+                    throw new Error(`Insufficient ${a} balance.`);
+                const res = this.send('rln_send_asset', { to: String(to), asset: a, amount: Number(amount) });
+                const found = this.findAsset(a);
+                if (found)
+                    this.transfers.push({ idx: this.transfers.length + 1, asset_id: found.asset_id, kind: 'Send', status: 'Settled', amount: Number(amount) });
+                return res;
+            },
+            rln_list_assets: async () => ({
+                assets: this.rgbAssets.map((a) => ({ ...a, balance: { spendable: this.assets[a.ticker] ?? 0 } })),
+            }),
+            rln_list_transfers: async ({ asset_id, asset }) => {
+                const ref = asset_id ?? asset;
+                const found = this.findAsset(ref);
+                if (!found)
+                    throw new Error(`Unknown asset "${String(ref)}".`);
+                return { transfers: this.transfers.filter((x) => x.asset_id === found.asset_id) };
+            },
+            rln_create_utxos: async ({ num }) => {
+                const n = Number(num ?? 5);
+                this.utxos += n;
+                this.sends.push({ tool: 'rln_create_utxos', to: 'self', amount: n });
+                return { created: true, num: n, free_utxos: this.utxos };
+            },
+            rln_issue_asset: async (args) => {
+                const a = this.issueAsset(args);
+                return { issued: true, asset_id: a.asset_id, ticker: a.ticker, name: a.name, schema: a.schema, issued_supply: a.issued_supply };
+            },
+            get_swap_quote: async ({ from_asset, to_asset, amount }) => ({
+                quote_id: 'quote-mock',
+                from_asset,
+                to_asset,
+                amount: Number(amount),
+                // toy rate: 1 USDT ≈ 1538 sats at $65k; otherwise echo.
+                receive_amount: String(from_asset).toUpperCase() === 'USDT' ? Math.round(Number(amount) * (1e8 / this.priceUsd)) : Number(amount),
+            }),
+            execute_swap: async ({ from_asset, to_asset, amount }) => {
+                this.sends.push({ tool: 'execute_swap', to: `${from_asset}->${to_asset}`, amount: Number(amount) });
+                return { status: 'SUCCESS', swap_id: 'swap' + this.sends.length };
+            },
+        };
+    }
+    /**
+     * The KaleidoSwap /v2 submarine contract against a toy maker: 0.5% fee, the
+     * invoice amount read from its BOLT11 human-readable part, L-USDT at `priceUsd`.
+     */
+    submarineHandlers() {
+        return {
+            kaleidoswap_submarine_pairs: async () => ({
+                pairs: [
+                    { from: 'L-USDT', to: 'BTC', fees: { percentage: 0.5 }, limits: { minimal: 10 * 1e8, maximal: 1_000 * 1e8 } },
+                    { from: 'L-BTC', to: 'BTC', fees: { percentage: 0.5 }, limits: { minimal: 10_000, maximal: 1_000_000 } },
+                ],
+            }),
+            kaleidoswap_submarine_create: async ({ invoice, from_asset }) => {
+                const from = (from_asset ?? 'L-USDT');
+                if (from !== 'L-USDT' && from !== 'L-BTC')
+                    throw new Error(`Unsupported from_asset "${String(from_asset)}".`);
+                const sats = bolt11Sats(String(invoice));
+                if (sats == null)
+                    throw new Error('invalid_invoice: the invoice must be BOLT11 with an amount.');
+                const withFee = sats * 1.005;
+                const expected = Math.ceil(from === 'L-USDT' ? (withFee / 1e8) * this.priceUsd * 1e8 : withFee);
+                const id = `sub${Object.keys(this.submarineSwaps).length + 1}`;
+                this.submarineSwaps[id] = { from, invoice: String(invoice), expected, funded: false };
+                return { swap_id: id, from_asset: from, expected_amount: String(expected), lockup_address: `tlq1qmock${id}` };
+            },
+            kaleidoswap_submarine_fund: async ({ swap_id }) => {
+                const swap = this.submarineSwaps[String(swap_id)];
+                if (!swap)
+                    throw new Error(`No submarine swap "${String(swap_id)}" was created by this server.`);
+                if (swap.funded)
+                    throw new Error(`Swap ${String(swap_id)} is already funded.`);
+                if (this.liquid[swap.from] < swap.expected)
+                    throw new Error(`Insufficient ${swap.from} balance.`);
+                this.liquid[swap.from] -= swap.expected;
+                swap.funded = true;
+                this.sends.push({ tool: 'kaleidoswap_submarine_fund', to: swap.invoice, asset: swap.from, amount: swap.expected });
+                return { funded: true, swap_id, asset: swap.from, amount: String(swap.expected), txid: `mocktx${String(swap_id)}` };
+            },
+            kaleidoswap_submarine_status: async ({ swap_id }) => {
+                const swap = this.submarineSwaps[String(swap_id)];
+                if (!swap)
+                    throw new Error(`invalid_swap_id: "${String(swap_id)}" is not a swap id`);
+                const status = swap.funded ? 'transaction.claimed' : 'swap.created';
+                return { swap_id, status, done: swap.funded, failed: false, funded: swap.funded };
+            },
+        };
+    }
+    /** Bind the contract tools to this wallet (optionally overriding some — e.g. to inject). */
+    registry(overrides) {
+        const h = { ...this.handlers(), ...(overrides ?? {}) };
+        const sub = { ...this.submarineHandlers(), ...(overrides ?? {}) };
+        return new ToolRegistry([
+            bindWalletTools(h, { layers: ['spark', 'rln', 'arkade', 'core'], allowMissing: true }),
+            bindSubmarineTools(sub, { allowMissing: true }),
+        ]);
+    }
+}
+/** Deterministic fake RGB contract id per ticker (stable across runs). */
+function mockAssetId(ticker) {
+    let h = 0;
+    for (const c of ticker)
+        h = (h * 31 + c.charCodeAt(0)) >>> 0;
+    return `rgb:mock-${ticker.toLowerCase()}-${h.toString(36)}`;
+}
+/** Amount in sats from a BOLT11 human-readable part ("lntbs10u…" → 1000), or null. */
+function bolt11Sats(invoice) {
+    const m = invoice.toLowerCase().match(/^ln(?:bcrt|tbs|bc|tb)(\d+)([munp])?1/);
+    if (!m)
+        return null;
+    const n = Number(m[1]);
+    const mult = { m: 1e5, u: 100, n: 0.1, p: 0.0001 }[m[2] ?? ''] ?? 1e8;
+    const sats = n * mult;
+    return sats >= 1 ? Math.round(sats) : null;
+}
+//# sourceMappingURL=mock-wallet.js.map

package/dist/testing/mock-wallet.js.map

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

package/dist/testing/scripted-provider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A scripted LLMProvider — replays planned turns instead of running a model.
+ *
+ * Lets hosts wire the full Engine / Funnel (skills, recipes, confirm gate) in
+ * unit tests, CI and demos without loading a QVAC model. Deterministic tiers
+ * (fast-path, recipes with regex extraction) never call it at all.
+ */
+import type { LLMProvider } from '../providers/types.js';
+export interface ScriptedTurn {
+    /** Assistant text for this turn. */
+    text?: string;
+    /** Tool to call — ignored when the tool is not in the turn's scoped tool list. */
+    tool?: string;
+    args?: Record<string, unknown>;
+}
+export declare function scriptedProvider(turns?: ScriptedTurn[], fallback?: string): LLMProvider;
+//# sourceMappingURL=scripted-provider.d.ts.map

package/dist/testing/scripted-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted-provider.d.ts","sourceRoot":"","sources":["../../src/testing/scripted-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,YAAY,EAAO,EAAE,QAAQ,SAA6B,GAAG,WAAW,CAiB/G"}

package/dist/testing/scripted-provider.js

@@ -0,0 +1,26 @@
+/**
+ * A scripted LLMProvider — replays planned turns instead of running a model.
+ *
+ * Lets hosts wire the full Engine / Funnel (skills, recipes, confirm gate) in
+ * unit tests, CI and demos without loading a QVAC model. Deterministic tiers
+ * (fast-path, recipes with regex extraction) never call it at all.
+ */
+export function scriptedProvider(turns = [], fallback = 'I need more information.') {
+    let index = 0;
+    return {
+        name: 'scripted',
+        async runTurn(input) {
+            const planned = turns[index++] ?? { text: fallback };
+            const call = planned.tool && input.tools.some((t) => t.name === planned.tool)
+                ? { id: `scripted-${index}`, name: planned.tool, arguments: planned.args ?? {} }
+                : undefined;
+            return {
+                text: planned.text ?? '',
+                rawContent: planned.text ?? '',
+                toolCalls: call ? [call] : [],
+                inference: { durationMs: 0, status: 'completed' },
+            };
+        },
+    };
+}
+//# sourceMappingURL=scripted-provider.js.map