@kaleidorg/mind 0.0.1 → 0.2.0

package/dist/recipe/runner.js

@@ -0,0 +1,94 @@
+/**
+ * Recipe runner — executes a Recipe with ONE structured extraction (or a
+ * deterministic regex), then runs the deterministic step chain and the
+ * confirmation-gated final action. This is mobile multi-step: a tiny model
+ * fills slots; the engine does the planning.
+ */
+const EXTRACT_TOOL = 'extract_request';
+/** Extract the recipe's slots — deterministic regex first, else ONE LLM call. */
+export async function extractSlots(provider, recipe, text) {
+    const det = recipe.extract?.(text);
+    if (det && Object.values(det).some((v) => v !== undefined && v !== null && v !== '')) {
+        return { slots: det, inferences: 0 };
+    }
+    const properties = {};
+    for (const s of recipe.slots)
+        properties[s.name] = { type: s.type ?? 'string', description: s.description };
+    const extractTool = {
+        name: EXTRACT_TOOL,
+        description: `Extract the fields from the user's request.`,
+        parameters: { type: 'object', properties, required: recipe.slots.filter((s) => s.required).map((s) => s.name) },
+    };
+    const out = await provider.runTurn({
+        system: `Call ${EXTRACT_TOOL} with the fields from the user's message. Do not call any other tool and do not add commentary.`,
+        messages: [{ role: 'user', content: text }],
+        tools: [extractTool],
+    });
+    const call = out.toolCalls?.find((c) => c.name === EXTRACT_TOOL) ?? out.toolCalls?.[0];
+    return { slots: call?.arguments ?? {}, inferences: 1 };
+}
+/** Run a recipe end to end. Never throws — failures come back as status:'error'. */
+export async function runRecipe(recipe, text, opts) {
+    const ctx = { text, slots: opts.slots ?? {}, results: {} };
+    let inferences = 0;
+    try {
+        if (!opts.slots) {
+            const ex = await extractSlots(opts.provider, recipe, text);
+            ctx.slots = ex.slots;
+            inferences = ex.inferences;
+        }
+        // Deterministic steps.
+        for (const step of recipe.steps) {
+            if (step.skipIf?.(ctx))
+                continue;
+            const args = step.args(ctx);
+            const result = await opts.tools.execute(step.tool, args);
+            ctx.results[step.as ?? step.tool] = result;
+            opts.onStep?.(step.tool, args, result);
+        }
+        // Final action — confirmation-gated if the tool requires it. Like the
+        // Engine, a missing onConfirm FAILS CLOSED: the spend is declined, never
+        // silently executed.
+        const finalArgs = recipe.final.args(ctx);
+        const def = await opts.tools.getDef(recipe.final.tool);
+        if (def?.requiresConfirmation) {
+            const decision = opts.onConfirm
+                ? await opts.onConfirm({ name: recipe.final.tool, arguments: finalArgs })
+                : { approved: false, reason: 'no confirmation handler available' };
+            if (!decision.approved) {
+                return { recipe: recipe.name, slots: ctx.slots, results: ctx.results, text: 'Cancelled — nothing was sent.', status: 'cancelled', inferences };
+            }
+        }
+        const finalResult = await opts.tools.execute(recipe.final.tool, finalArgs);
+        ctx.results[recipe.final.as ?? recipe.final.tool] = finalResult;
+        opts.onStep?.(recipe.final.tool, finalArgs, finalResult);
+        const out = recipe.summary?.(ctx, finalResult) ?? 'Done.';
+        return { recipe: recipe.name, slots: ctx.slots, results: ctx.results, final: finalResult, text: out, status: 'done', inferences };
+    }
+    catch (e) {
+        const msg = e?.message ?? String(e);
+        return { recipe: recipe.name, slots: ctx.slots, results: ctx.results, text: `Couldn't complete that: ${msg}`, status: 'error', error: msg, inferences };
+    }
+}
+/** Selects a recipe for a request. Use before falling back to the free agentic loop. */
+export class RecipeRegistry {
+    recipes;
+    constructor(recipes = []) {
+        this.recipes = [...recipes];
+    }
+    add(recipe) {
+        this.recipes.push(recipe);
+    }
+    list() {
+        return [...this.recipes];
+    }
+    get(name) {
+        return this.recipes.find((r) => r.name === name);
+    }
+    /** First recipe whose match()/triggers fit the text, else null. */
+    select(text) {
+        const lc = text.toLowerCase();
+        return (this.recipes.find((r) => r.match ? r.match(text) : (r.triggers ?? []).some((t) => lc.includes(t.toLowerCase()))) ?? null);
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/recipe/runner.js.map

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

package/dist/recipe/swap.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Built-in "swap" recipe — quote → (confirm) → execute, over the contract tools.
+ *
+ *   "buy 0.001 btc with usdt"   → from USDT, to BTC
+ *   "swap 10 usdt for btc"      → from USDT, to BTC
+ *   "sell 100 usdt for sats"    → from USDT, to BTC
+ *
+ * The deterministic extractor handles the common phrasings; the runner falls
+ * back to one LLM extraction otherwise. execute_swap is a spend → the engine's
+ * confirmation gate fires before it runs.
+ */
+import type { Recipe } from './types.js';
+/** "buy 0.001 btc with usdt" / "swap 10 usdt for btc" / "sell 100 usdt for sats". */
+export declare function extractSwap(text: string): Record<string, unknown> | null;
+export declare const swapRecipe: Recipe;
+//# sourceMappingURL=swap.d.ts.map

package/dist/recipe/swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.d.ts","sourceRoot":"","sources":["../../src/recipe/swap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAczC,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAYxE;AAED,eAAO,MAAM,UAAU,EAAE,MAgCxB,CAAC"}

package/dist/recipe/swap.js

@@ -0,0 +1,73 @@
+/**
+ * Built-in "swap" recipe — quote → (confirm) → execute, over the contract tools.
+ *
+ *   "buy 0.001 btc with usdt"   → from USDT, to BTC
+ *   "swap 10 usdt for btc"      → from USDT, to BTC
+ *   "sell 100 usdt for sats"    → from USDT, to BTC
+ *
+ * The deterministic extractor handles the common phrasings; the runner falls
+ * back to one LLM extraction otherwise. execute_swap is a spend → the engine's
+ * confirmation gate fires before it runs.
+ */
+const ASSET = /\b(btc|bitcoin|sats?|usdt|tether|xaut|gold)\b/i;
+function normAsset(a) {
+    if (!a)
+        return undefined;
+    const x = a.toLowerCase();
+    if (/btc|bitcoin|sat/.test(x))
+        return 'BTC';
+    if (/usdt|tether/.test(x))
+        return 'USDT';
+    if (/xaut|gold/.test(x))
+        return 'XAUT';
+    return a.toUpperCase();
+}
+const num = (s) => (s ? Number(s.replace(/,/g, '')) : undefined);
+/** "buy 0.001 btc with usdt" / "swap 10 usdt for btc" / "sell 100 usdt for sats". */
+export function extractSwap(text) {
+    const t = text.trim();
+    let m;
+    // buy <amt> <to> with/using <from>  (amount is of the asset being bought)
+    if ((m = t.match(/buy\s+([\d.,]+)\s*([a-z]+)\s+(?:with|using|for)\s+([a-z]+)/i))) {
+        return { amount: num(m[1]), to_asset: normAsset(m[2]), from_asset: normAsset(m[3]) };
+    }
+    // swap/sell/convert/exchange/trade <amt> <from> for/to/into <to>
+    if ((m = t.match(/(?:swap|sell|convert|exchange|trade)\s+([\d.,]+)\s*([a-z]+)\s+(?:for|to|into)\s+([a-z]+)/i))) {
+        return { amount: num(m[1]), from_asset: normAsset(m[2]), to_asset: normAsset(m[3]) };
+    }
+    return null;
+}
+export const swapRecipe = {
+    name: 'swap',
+    description: 'Swap between BTC and an RGB asset — quote, then execute (with confirmation).',
+    // A crypto swap intent — but NOT buying a gift card (that's commerce) or an invoice.
+    match: (t) => /\b(swap|exchange|convert|trade)\b/i.test(t) || (/\b(buy|sell)\b/i.test(t) && ASSET.test(t) && !/\b(gift\s?card|top-?up|esim|voucher|invoice|address)\b/i.test(t)),
+    triggers: ['swap', 'exchange', 'convert', 'trade'],
+    slots: [
+        { name: 'from_asset', type: 'string', description: 'Asset to spend (e.g. USDT, BTC)', required: true },
+        { name: 'to_asset', type: 'string', description: 'Asset to receive (e.g. BTC, USDT)', required: true },
+        { name: 'amount', type: 'number', description: 'Amount to swap' },
+    ],
+    extract: extractSwap,
+    confident: (s) => !!s.from_asset && !!s.to_asset,
+    steps: [
+        {
+            tool: 'get_swap_quote',
+            as: 'quote',
+            args: (ctx) => ({ from_asset: ctx.slots.from_asset, to_asset: ctx.slots.to_asset, amount: ctx.slots.amount }),
+        },
+    ],
+    final: {
+        tool: 'execute_swap',
+        args: (ctx) => {
+            const q = ctx.results.quote;
+            return { quote_id: q?.quote_id, from_asset: ctx.slots.from_asset, to_asset: ctx.slots.to_asset, amount: ctx.slots.amount };
+        },
+    },
+    summary: (ctx) => {
+        const q = ctx.results.quote;
+        const tail = q?.receive_amount ? ` (~${q.receive_amount} ${ctx.slots.to_asset})` : '';
+        return `Swapped ${ctx.slots.amount} ${ctx.slots.from_asset} → ${ctx.slots.to_asset}${tail}.`;
+    },
+};
+//# sourceMappingURL=swap.js.map

package/dist/recipe/swap.js.map

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

package/dist/recipe/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Recipes — multi-step that works on a tiny model. "Recipes, not planning."
+ *
+ * A small model can't reliably PLAN a chain ("pay bob 3 EUR" = resolve → price
+ * → convert → send) from scratch. So a Recipe carries the plan; the model is
+ * used for ONE thing — extracting the request's slots (recipient, amount, …).
+ * The engine then runs the deterministic steps and the (confirmation-gated)
+ * final action. ~1 inference instead of 5; reliable on 0.6–4B.
+ *
+ * Pure data + interfaces — no deps. The provider + tools are injected.
+ */
+export interface RecipeSlot {
+    name: string;
+    type?: 'string' | 'number' | 'boolean';
+    description: string;
+    required?: boolean;
+}
+export interface RecipeContext {
+    /** The original user text. */
+    text: string;
+    /** Extracted slots (deterministic regex, else one LLM call). */
+    slots: Record<string, unknown>;
+    /** Results of completed steps, keyed by `as` (or tool name). */
+    results: Record<string, unknown>;
+}
+export interface RecipeStep {
+    /** Tool to call. */
+    tool: string;
+    /** Build the tool args from the accumulated context. */
+    args: (ctx: RecipeContext) => Record<string, unknown>;
+    /** Store the result under this key (default: the tool name). */
+    as?: string;
+    /** Skip this step when true (e.g. recipient is already an address). */
+    skipIf?: (ctx: RecipeContext) => boolean;
+}
+export interface Recipe {
+    name: string;
+    description?: string;
+    /** Selection: a predicate or trigger phrases. */
+    match?: (text: string) => boolean;
+    triggers?: string[];
+    /** Fields the model (or regex) extracts from the request. */
+    slots: RecipeSlot[];
+    /** Optional deterministic extractor tried BEFORE the LLM (Tier-0 fast-path). */
+    extract?: (text: string) => Record<string, unknown> | null;
+    /**
+     * Whether the recipe is confident enough to RUN deterministically given the
+     * extracted slots (vs falling back to the agentic loop). e.g. payments needs a
+     * recipient; receive needs an amount or asset. Default: any slot extracted.
+     */
+    confident?: (slots: Record<string, unknown>) => boolean;
+    /** Deterministic steps, run in order, results threaded into `ctx`. */
+    steps: RecipeStep[];
+    /** The terminal action (usually a spend → confirmation-gated by its tool). */
+    final: RecipeStep;
+    /** Render the outcome for the user. */
+    summary?: (ctx: RecipeContext, finalResult: unknown) => string;
+}
+export type RecipeStatus = 'done' | 'cancelled' | 'error';
+export interface RecipeResult {
+    recipe: string;
+    slots: Record<string, unknown>;
+    results: Record<string, unknown>;
+    final?: unknown;
+    text: string;
+    status: RecipeStatus;
+    error?: string;
+    /** Number of LLM inferences used (0 if extraction was deterministic). */
+    inferences: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/recipe/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,IAAI,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3D;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IACxD,sEAAsE;IACtE,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,8EAA8E;IAC9E,KAAK,EAAE,UAAU,CAAC;IAClB,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,KAAK,MAAM,CAAC;CAChE;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/recipe/types.js

@@ -0,0 +1,13 @@
+/**
+ * Recipes — multi-step that works on a tiny model. "Recipes, not planning."
+ *
+ * A small model can't reliably PLAN a chain ("pay bob 3 EUR" = resolve → price
+ * → convert → send) from scratch. So a Recipe carries the plan; the model is
+ * used for ONE thing — extracting the request's slots (recipient, amount, …).
+ * The engine then runs the deterministic steps and the (confirmation-gated)
+ * final action. ~1 inference instead of 5; reliable on 0.6–4B.
+ *
+ * Pure data + interfaces — no deps. The provider + tools are injected.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/recipe/types.js.map

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

package/dist/skills/bundle.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Skill bundle — the RN-safe counterpart to the Node fs loader.
+ *
+ * React Native has no filesystem, so a skill folder can't be read at runtime.
+ * Instead a build step serialises the skills into a `SkillBundle` (plain JSON:
+ * each skill's raw SKILL.md text + its reference files), and the app rehydrates
+ * them here with `skillsFromBundle()`. Same skills, same SKILL.md authoring —
+ * just delivered as data instead of files.
+ *
+ * Pure, dependency-free, no fs/url imports — safe to import from the package's
+ * main entry on any host.
+ */
+import type { Skill, SkillReference } from './types.js';
+/** One serialised skill: the SKILL.md text + its reference files. */
+export interface BundledSkill {
+    /** Folder name (informational; the real name comes from the frontmatter). */
+    dir?: string;
+    /** Raw SKILL.md contents. */
+    markdown: string;
+    /** references/*.md files. */
+    references?: SkillReference[];
+}
+/** A bundle of skills produced by the bundler script. */
+export interface SkillBundle {
+    version: 1;
+    skills: BundledSkill[];
+}
+/** Rehydrate Skills from a bundle (RN-safe — no filesystem). */
+export declare function skillsFromBundle(bundle: SkillBundle): Skill[];
+//# sourceMappingURL=bundle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/skills/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGxD,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,EAAE,CAQ7D"}

package/dist/skills/bundle.js

@@ -0,0 +1,24 @@
+/**
+ * Skill bundle — the RN-safe counterpart to the Node fs loader.
+ *
+ * React Native has no filesystem, so a skill folder can't be read at runtime.
+ * Instead a build step serialises the skills into a `SkillBundle` (plain JSON:
+ * each skill's raw SKILL.md text + its reference files), and the app rehydrates
+ * them here with `skillsFromBundle()`. Same skills, same SKILL.md authoring —
+ * just delivered as data instead of files.
+ *
+ * Pure, dependency-free, no fs/url imports — safe to import from the package's
+ * main entry on any host.
+ */
+import { parseSkill } from './registry.js';
+/** Rehydrate Skills from a bundle (RN-safe — no filesystem). */
+export function skillsFromBundle(bundle) {
+    if (!bundle || bundle.version !== 1 || !Array.isArray(bundle.skills)) {
+        throw new Error('skillsFromBundle: not a valid v1 SkillBundle');
+    }
+    return bundle.skills.map((b) => ({
+        ...parseSkill(b.markdown, b.references),
+        dir: b.dir,
+    }));
+}
+//# sourceMappingURL=bundle.js.map

package/dist/skills/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../src/skills/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAkB3C,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/B,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC;QACvC,GAAG,EAAE,CAAC,CAAC,GAAG;KACX,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Skill loader — reads Claude-style Agent Skill folders from disk. NODE ONLY.
+ *
+ * Import from `@kaleidorg/mind/skills` on Node hosts (desktop sidecar,
+ * kaleidoagent). React Native has no filesystem — there, build skills with
+ * `SkillRegistry.addMarkdown(text, references)` from bundled strings instead.
+ *
+ * Layout (Anthropic Agent Skills spec, e.g. bitrefill/agents):
+ *
+ *   skills/
+ *     bitrefill/
+ *       SKILL.md
+ *       references/
+ *         mcp.md
+ *         cli.md
+ *         …
+ *
+ * `loadSkillsDir(root)` returns one Skill per SKILL.md found, with every
+ * reference markdown read into `skill.references` for progressive disclosure.
+ */
+import type { Skill } from './types.js';
+/**
+ * Absolute path to the skills shipped inside this package
+ * (`@kaleidorg/mind/skills`). Resolves relative to the compiled loader, so it
+ * works from any host that installs the package. Override with an explicit dir
+ * when you keep skills elsewhere.
+ */
+export declare function packagedSkillsDir(): string;
+/** Load one skill folder containing a SKILL.md (+ optional references/). */
+export declare function loadSkillFromDir(dir: string): Skill;
+/** Load every skill folder under `root` (each a dir with a SKILL.md). */
+export declare function loadSkillsDir(root: string): Skill[];
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAC;AAGxD;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAcnD;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CAMnD"}

package/dist/skills/loader.js

@@ -0,0 +1,59 @@
+/**
+ * Skill loader — reads Claude-style Agent Skill folders from disk. NODE ONLY.
+ *
+ * Import from `@kaleidorg/mind/skills` on Node hosts (desktop sidecar,
+ * kaleidoagent). React Native has no filesystem — there, build skills with
+ * `SkillRegistry.addMarkdown(text, references)` from bundled strings instead.
+ *
+ * Layout (Anthropic Agent Skills spec, e.g. bitrefill/agents):
+ *
+ *   skills/
+ *     bitrefill/
+ *       SKILL.md
+ *       references/
+ *         mcp.md
+ *         cli.md
+ *         …
+ *
+ * `loadSkillsDir(root)` returns one Skill per SKILL.md found, with every
+ * reference markdown read into `skill.references` for progressive disclosure.
+ */
+import { readdirSync, readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseSkill } from './registry.js';
+/**
+ * Absolute path to the skills shipped inside this package
+ * (`@kaleidorg/mind/skills`). Resolves relative to the compiled loader, so it
+ * works from any host that installs the package. Override with an explicit dir
+ * when you keep skills elsewhere.
+ */
+export function packagedSkillsDir() {
+    // dist/skills/loader.js → ../../skills == <package root>/skills
+    return fileURLToPath(new URL('../../skills/', import.meta.url));
+}
+/** Load one skill folder containing a SKILL.md (+ optional references/). */
+export function loadSkillFromDir(dir) {
+    const skillFile = join(dir, 'SKILL.md');
+    if (!existsSync(skillFile))
+        throw new Error(`No SKILL.md in ${dir}`);
+    const markdown = readFileSync(skillFile, 'utf8');
+    const refDir = join(dir, 'references');
+    const references = existsSync(refDir)
+        ? readdirSync(refDir)
+            .filter((f) => f.endsWith('.md'))
+            .sort()
+            .map((name) => ({ name, content: readFileSync(join(refDir, name), 'utf8') }))
+        : [];
+    return { ...parseSkill(markdown, references), dir };
+}
+/** Load every skill folder under `root` (each a dir with a SKILL.md). */
+export function loadSkillsDir(root) {
+    if (!existsSync(root))
+        return [];
+    return readdirSync(root, { withFileTypes: true })
+        .filter((e) => e.isDirectory() && existsSync(join(root, e.name, 'SKILL.md')))
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .map((e) => loadSkillFromDir(join(root, e.name)));
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,gEAAgE;IAChE,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAEjD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACvC,MAAM,UAAU,GAAqB,UAAU,CAAC,MAAM,CAAC;QACrD,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;aAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;aAChC,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACjF,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,EAAE,GAAG,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;AACtD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC9C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;SAC5E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/skills/reference-source.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Skill reference tool source — the read-side of Agent-Skills progressive
+ * disclosure.
+ *
+ * Exposes one tool, `read_skill_reference({ file, skill? })`, that returns the
+ * contents of a `references/*.md` file bundled with a skill. The brain enters a
+ * skill (its SKILL.md playbook lists the reference files), then pulls in only
+ * the reference it needs for the current step — instead of every doc being in
+ * context at once.
+ *
+ * Pure in-process: it reads from the SkillRegistry's already-loaded reference
+ * strings, so it works on every host (React Native included) once the skills
+ * are loaded. No filesystem, no network.
+ */
+import type { ToolSource } from '../tools/source.js';
+import { SkillRegistry } from './registry.js';
+export declare function createSkillReferenceToolSource(registry: SkillRegistry): ToolSource;
+//# sourceMappingURL=reference-source.d.ts.map

package/dist/skills/reference-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-source.d.ts","sourceRoot":"","sources":["../../src/skills/reference-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAuB,MAAM,eAAe,CAAC;AAEnE,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,aAAa,GAAG,UAAU,CAwClF"}

package/dist/skills/reference-source.js

@@ -0,0 +1,53 @@
+/**
+ * Skill reference tool source — the read-side of Agent-Skills progressive
+ * disclosure.
+ *
+ * Exposes one tool, `read_skill_reference({ file, skill? })`, that returns the
+ * contents of a `references/*.md` file bundled with a skill. The brain enters a
+ * skill (its SKILL.md playbook lists the reference files), then pulls in only
+ * the reference it needs for the current step — instead of every doc being in
+ * context at once.
+ *
+ * Pure in-process: it reads from the SkillRegistry's already-loaded reference
+ * strings, so it works on every host (React Native included) once the skills
+ * are loaded. No filesystem, no network.
+ */
+import { READ_REFERENCE_TOOL } from './registry.js';
+export function createSkillReferenceToolSource(registry) {
+    const tool = {
+        name: READ_REFERENCE_TOOL,
+        description: 'Read a reference document bundled with the active skill (its SKILL.md ' +
+            'lists the available files). Use this to pull in the detailed instructions ' +
+            'for a step — e.g. the MCP, CLI, or API guide — before acting.',
+        parameters: {
+            type: 'object',
+            properties: {
+                file: { type: 'string', description: 'Reference filename, e.g. "mcp.md"' },
+                skill: { type: 'string', description: 'Optional skill name to scope the lookup' },
+            },
+            required: ['file'],
+        },
+    };
+    async function execute(_name, args) {
+        const file = String(args.file ?? '').trim();
+        if (!file)
+            throw new Error('read_skill_reference: file is required');
+        const skill = args.skill ? String(args.skill) : undefined;
+        const ref = registry.reference(file, skill);
+        if (!ref) {
+            const available = registry
+                .references()
+                .map((r) => `${r.skill}/${r.name}`)
+                .join(', ');
+            throw new Error(`read_skill_reference: "${file}" not found. Available: ${available || '(none)'}`);
+        }
+        return ref.content;
+    }
+    return {
+        id: 'skill-references',
+        listTools: () => [tool],
+        has: (name) => name === READ_REFERENCE_TOOL,
+        execute,
+    };
+}
+//# sourceMappingURL=reference-source.js.map

package/dist/skills/reference-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-source.js","sourceRoot":"","sources":["../../src/skills/reference-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAiB,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEnE,MAAM,UAAU,8BAA8B,CAAC,QAAuB;IACpE,MAAM,IAAI,GAAY;QACpB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EACT,wEAAwE;YACxE,4EAA4E;YAC5E,+DAA+D;QACjE,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;gBAC1E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;aAClF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF,CAAC;IAEF,KAAK,UAAU,OAAO,CAAC,KAAa,EAAE,IAA6B;QACjE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,SAAS,GAAG,QAAQ;iBACvB,UAAU,EAAE;iBACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;iBAClC,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,2BAA2B,SAAS,IAAI,QAAQ,EAAE,CACjF,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,OAAO;QACL,EAAE,EAAE,kBAAkB;QACtB,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC;QACvB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,mBAAmB;QAC3C,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/skills/registry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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.
+ */
+import type { Skill, SkillReference, SkillSelector } from './types.js';
+/** Tool name the reference source exposes for progressive disclosure. */
+export declare const READ_REFERENCE_TOOL = "read_skill_reference";
+export declare function parseSkill(markdown: string, references?: SkillReference[]): Skill;
+/** Default selector: score by meaningful keyword overlap; triggers weigh most. */
+export declare const keywordSelector: SkillSelector;
+export declare class SkillRegistry {
+    private readonly skills;
+    private readonly selector;
+    constructor(skills?: Skill[], selector?: SkillSelector);
+    add(skill: Skill): this;
+    /** Add a skill from raw SKILL.md text (+ optional reference files). */
+    addMarkdown(markdown: string, references?: SkillReference[]): this;
+    /** All reference files across skills, tagged with their owning skill. */
+    references(): Array<SkillReference & {
+        skill: string;
+    }>;
+    /** Look up a reference file by name (optionally scoped to one skill). */
+    reference(file: string, skill?: string): SkillReference | undefined;
+    list(): Skill[];
+    get(name: string): Skill | undefined;
+    /** Pick the most relevant skill for a query (null = none). */
+    select(query: string): Skill | null;
+    /**
+     * 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: string, skill: Skill | null): {
+        system: string;
+        allowedTools?: string[];
+    };
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvE,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAuB1D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,EAAE,GAAG,KAAK,CAkCjF;AASD,kFAAkF;AAClF,eAAO,MAAM,eAAe,EAAE,aAuB7B,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,MAAM,GAAE,KAAK,EAAO,EAAE,QAAQ,GAAE,aAA+B;IAK3E,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAKvB,uEAAuE;IACvE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI;IAIlE,yEAAyE;IACzE,UAAU,IAAI,KAAK,CAAC,cAAc,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAMvD,yEAAyE;IACzE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAUnE,IAAI,IAAI,KAAK,EAAE;IAIf,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC,8DAA8D;IAC9D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI;IAInC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAwBxF"}