@kaleidorg/mind 0.1.0 → 0.3.0

package/dist/memory/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Memory — the agent's persistent identity + what it has learned.
+ *
+ * Two layers, mirroring how nanobot splits SOUL.md / AGENTS.md / memory:
+ *   - AgentProfile  — static identity ("who am I, how do I behave"). Injected.
+ *   - MemoryStore   — durable, growing facts/preferences/events the agent
+ *                     remembers across sessions. Pluggable storage.
+ *
+ * Pure data + interfaces — no storage or embedding deps. The host injects
+ * persistence (AsyncStorage on RN, fs/SQLite on Node) and, optionally, an
+ * EmbeddingProvider for semantic recall.
+ */
+/** Static agent identity, composed into the system prompt every turn. */
+export interface AgentProfile {
+    /** Display name, e.g. "KaleidoMind". */
+    name: string;
+    /** Persona / identity — the "soul". Who the agent is, its voice, its values. */
+    soul: string;
+    /** Operating instructions / house rules (optional). */
+    instructions?: string;
+}
+export type MemoryKind = 'fact' | 'preference' | 'event' | 'note';
+export interface MemoryItem {
+    id: string;
+    text: string;
+    kind: MemoryKind;
+    /** Epoch ms. */
+    createdAt: number;
+    tags?: string[];
+    /** Optional embedding for semantic recall (set when an embedder is wired). */
+    embedding?: number[];
+}
+/** What to add — id/createdAt/embedding are filled in by the store. */
+export type NewMemory = Omit<MemoryItem, 'id' | 'createdAt' | 'embedding'> & Partial<Pick<MemoryItem, 'id' | 'createdAt' | 'embedding'>>;
+export interface MemoryQuery {
+    /** Free text to match (semantic if embeddings are available, else substring). */
+    text?: string;
+    kind?: MemoryKind;
+    tags?: string[];
+    /** Max items to return (default 5). */
+    limit?: number;
+}
+export interface MemoryStore {
+    add(item: NewMemory): Promise<MemoryItem>;
+    all(): Promise<MemoryItem[]>;
+    /** Best-matching items for the query (recency-ranked, or semantic if embedded). */
+    search(query: MemoryQuery): Promise<MemoryItem[]>;
+    remove(id: string): Promise<void>;
+    clear(): Promise<void>;
+}
+/** Injected persistence — load once, save on every mutation. RN/Node provide it. */
+export interface MemoryIO {
+    load(): Promise<MemoryItem[]>;
+    save(items: MemoryItem[]): Promise<void>;
+}
+/**
+ * Consolidation — fold same-kind near-duplicate memories into one item instead
+ * of bloating with "user likes EUR" ×5. Needs embeddings (the dup check is
+ * cosine). Omit for append-only. Two tiers: embedding-only dedup (zero
+ * inference, mobile-safe) and, when `merge` is set, an LLM rewrite.
+ */
+export interface MemoryConsolidation {
+    /** Cosine threshold above which two same-kind memories are "the same". Default 0.92. */
+    threshold?: number;
+    /** Optional LLM merger; without it the newer item simply supersedes the older. */
+    merge?: (existing: string, incoming: string) => Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GACxE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,GAAG,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7B,mFAAmF;IACnF,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjE"}

package/dist/memory/types.js

@@ -0,0 +1,14 @@
+/**
+ * Memory — the agent's persistent identity + what it has learned.
+ *
+ * Two layers, mirroring how nanobot splits SOUL.md / AGENTS.md / memory:
+ *   - AgentProfile  — static identity ("who am I, how do I behave"). Injected.
+ *   - MemoryStore   — durable, growing facts/preferences/events the agent
+ *                     remembers across sessions. Pluggable storage.
+ *
+ * Pure data + interfaces — no storage or embedding deps. The host injects
+ * persistence (AsyncStorage on RN, fs/SQLite on Node) and, optionally, an
+ * EmbeddingProvider for semantic recall.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

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

package/dist/rag/retriever.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Retriever — ties an injected EmbeddingProvider to a VectorStore: ingest
+ * documents (chunk → embed → upsert) and search (embed query → top-k). Pure
+ * TS; the embedding model is the host's (QVAC `embed()` on device).
+ */
+import type { EmbeddingProvider, RagDocument, RetrievedChunk, VectorStore } from './types.js';
+export interface RetrieverOptions {
+    embeddings: EmbeddingProvider;
+    /** Vector index (defaults to a fresh in-memory cosine store). */
+    store?: VectorStore;
+    /** Approx chars per chunk (default 800 ≈ 200 tokens). */
+    chunkSize?: number;
+    /** Chars of overlap between chunks (default 100). */
+    chunkOverlap?: number;
+}
+/** Split text into overlapping chunks, preferring paragraph/sentence breaks. */
+export declare function chunkText(text: string, size?: number, overlap?: number): string[];
+export declare class Retriever {
+    private readonly embeddings;
+    private readonly store;
+    private readonly chunkSize;
+    private readonly chunkOverlap;
+    constructor(opts: RetrieverOptions);
+    /** Chunk, embed, and index documents. Returns the number of chunks stored. */
+    ingest(docs: RagDocument[]): Promise<number>;
+    /** Embed the query and return the top-k most similar chunks. */
+    search(query: string, k?: number): Promise<RetrievedChunk[]>;
+    vectorStore(): VectorStore;
+}
+//# sourceMappingURL=retriever.d.ts.map

package/dist/rag/retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retriever.d.ts","sourceRoot":"","sources":["../../src/rag/retriever.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,iEAAiE;IACjE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAM,EAAE,OAAO,SAAM,GAAG,MAAM,EAAE,CAwB3E;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,IAAI,EAAE,gBAAgB;IAOlC,8EAA8E;IACxE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBlD,gEAAgE;IAC1D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAO7D,WAAW,IAAI,WAAW;CAG3B"}

package/dist/rag/retriever.js

@@ -0,0 +1,72 @@
+/**
+ * Retriever — ties an injected EmbeddingProvider to a VectorStore: ingest
+ * documents (chunk → embed → upsert) and search (embed query → top-k). Pure
+ * TS; the embedding model is the host's (QVAC `embed()` on device).
+ */
+import { InMemoryVectorStore } from './vector-store.js';
+/** Split text into overlapping chunks, preferring paragraph/sentence breaks. */
+export function chunkText(text, size = 800, overlap = 100) {
+    const clean = text.replace(/\r\n/g, '\n').trim();
+    if (clean.length <= size)
+        return clean ? [clean] : [];
+    const chunks = [];
+    let start = 0;
+    while (start < clean.length) {
+        let end = Math.min(start + size, clean.length);
+        if (end < clean.length) {
+            // Back up to the nearest paragraph/sentence/space boundary.
+            const slice = clean.slice(start, end);
+            const brk = Math.max(slice.lastIndexOf('\n\n'), slice.lastIndexOf('\n'), slice.lastIndexOf('. '), slice.lastIndexOf(' '));
+            if (brk > size * 0.5)
+                end = start + brk + 1;
+        }
+        const piece = clean.slice(start, end).trim();
+        if (piece)
+            chunks.push(piece);
+        if (end >= clean.length)
+            break;
+        start = Math.max(end - overlap, start + 1);
+    }
+    return chunks;
+}
+export class Retriever {
+    embeddings;
+    store;
+    chunkSize;
+    chunkOverlap;
+    constructor(opts) {
+        this.embeddings = opts.embeddings;
+        this.store = opts.store ?? new InMemoryVectorStore();
+        this.chunkSize = opts.chunkSize ?? 800;
+        this.chunkOverlap = opts.chunkOverlap ?? 100;
+    }
+    /** Chunk, embed, and index documents. Returns the number of chunks stored. */
+    async ingest(docs) {
+        const pending = [];
+        for (const doc of docs) {
+            const pieces = chunkText(doc.text, this.chunkSize, this.chunkOverlap);
+            pieces.forEach((text, i) => {
+                const baseId = doc.id ?? `doc_${pending.length}`;
+                pending.push({ id: `${baseId}#${i}`, text, metadata: doc.metadata });
+            });
+        }
+        if (pending.length === 0)
+            return 0;
+        const vectors = await this.embeddings.embed(pending.map((p) => p.text));
+        await this.store.upsert(pending.map((p, i) => ({ ...p, embedding: vectors[i] })));
+        return pending.length;
+    }
+    /** Embed the query and return the top-k most similar chunks. */
+    async search(query, k = 4) {
+        if (!query.trim())
+            return [];
+        const [qv] = await this.embeddings.embed([query]);
+        if (!qv)
+            return [];
+        return this.store.query(qv, k);
+    }
+    vectorStore() {
+        return this.store;
+    }
+}
+//# sourceMappingURL=retriever.js.map

package/dist/rag/retriever.js.map

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

package/dist/rag/tool.d.ts

@@ -0,0 +1,15 @@
+/**
+ * RAG tool source — exposes `search_knowledge` so the model can pull in
+ * relevant context on demand (agentic RAG). Preferred over always-injecting
+ * retrieved text, which burns the small-model context window.
+ */
+import type { ToolSource } from '../tools/source.js';
+import type { Retriever } from './retriever.js';
+export interface RagToolOptions {
+    /** Chunks to return (default 4). */
+    k?: number;
+    /** Override the tool description for your corpus, e.g. "Search the docs." */
+    description?: string;
+}
+export declare function createRagToolSource(retriever: Retriever, opts?: RagToolOptions): ToolSource;
+//# sourceMappingURL=tool.d.ts.map

package/dist/rag/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/rag/tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,GAAE,cAAmB,GAAG,UAAU,CAmC/F"}

package/dist/rag/tool.js

@@ -0,0 +1,42 @@
+/**
+ * RAG tool source — exposes `search_knowledge` so the model can pull in
+ * relevant context on demand (agentic RAG). Preferred over always-injecting
+ * retrieved text, which burns the small-model context window.
+ */
+const SEARCH = 'search_knowledge';
+export function createRagToolSource(retriever, opts = {}) {
+    const tool = {
+        name: SEARCH,
+        description: opts.description ??
+            'Search the knowledge base for passages relevant to a question and return ' +
+                'the best matches. Use this before answering when the answer might be in ' +
+                'ingested documents.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'What to look up' },
+                k: { type: 'number', description: 'How many passages (default 4)' },
+            },
+            required: ['query'],
+        },
+    };
+    async function execute(_name, args) {
+        const query = String(args.query ?? '').trim();
+        if (!query)
+            throw new Error('search_knowledge: query is required');
+        const k = Number(args.k) > 0 ? Number(args.k) : (opts.k ?? 4);
+        const hits = await retriever.search(query, k);
+        if (hits.length === 0)
+            return 'No relevant passages found.';
+        return hits
+            .map((h, i) => `[${i + 1}] (score ${h.score.toFixed(2)}) ${h.text}`)
+            .join('\n\n');
+    }
+    return {
+        id: 'rag',
+        listTools: () => [tool],
+        has: (name) => name === SEARCH,
+        execute,
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/rag/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/rag/tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,GAAG,kBAAkB,CAAC;AASlC,MAAM,UAAU,mBAAmB,CAAC,SAAoB,EAAE,OAAuB,EAAE;IACjF,MAAM,IAAI,GAAY;QACpB,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,IAAI,CAAC,WAAW;YAChB,2EAA2E;gBACzE,0EAA0E;gBAC1E,qBAAqB;QACzB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;gBACzD,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;aACpE;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF,CAAC;IAEF,KAAK,UAAU,OAAO,CAAC,KAAa,EAAE,IAA6B;QACjE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACnE,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,6BAA6B,CAAC;QAC5D,OAAO,IAAI;aACR,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;aACnE,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED,OAAO;QACL,EAAE,EAAE,KAAK;QACT,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC;QACvB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,MAAM;QAC9B,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/rag/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * RAG types — retrieval-augmented generation primitives.
+ *
+ * The heavy parts (the embedding model, the vector index) are interfaces the
+ * host injects. On QVAC the EmbeddingProvider wraps the SDK `embed()` API
+ * (on-device); a server host could inject a remote embedder. The default
+ * VectorStore is a pure-JS in-memory cosine index (good for thousands of
+ * chunks); a host can swap in SQLite/native for more.
+ */
+/** Turns text into vectors. Injected — QVAC `embed()` on device, etc. */
+export interface EmbeddingProvider {
+    embed(texts: string[]): Promise<number[][]>;
+    /** Vector dimension, when known (informational). */
+    dimension?: number;
+}
+export interface Chunk {
+    id: string;
+    text: string;
+    metadata?: Record<string, unknown>;
+    embedding?: number[];
+}
+export interface RetrievedChunk extends Chunk {
+    /** Similarity score in [-1, 1] (cosine). */
+    score: number;
+}
+/** A document to ingest; chunked + embedded by the Retriever. */
+export interface RagDocument {
+    id?: string;
+    text: string;
+    metadata?: Record<string, unknown>;
+}
+export interface VectorStore {
+    upsert(chunks: Chunk[]): Promise<void>;
+    /** Top-k by cosine similarity to `embedding`. */
+    query(embedding: number[], k: number): Promise<RetrievedChunk[]>;
+    size(): Promise<number>;
+    clear(): Promise<void>;
+}
+/** Injected persistence for the vector store (optional). */
+export interface VectorStoreIO {
+    load(): Promise<Chunk[]>;
+    save(chunks: Chunk[]): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rag/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,KAAK;IAC3C,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,iDAAiD;IACjD,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACjE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACzB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC"}

package/dist/rag/types.js

@@ -0,0 +1,11 @@
+/**
+ * RAG types — retrieval-augmented generation primitives.
+ *
+ * The heavy parts (the embedding model, the vector index) are interfaces the
+ * host injects. On QVAC the EmbeddingProvider wraps the SDK `embed()` API
+ * (on-device); a server host could inject a remote embedder. The default
+ * VectorStore is a pure-JS in-memory cosine index (good for thousands of
+ * chunks); a host can swap in SQLite/native for more.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/rag/types.js.map

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

package/dist/rag/vector-store.d.ts

@@ -0,0 +1,23 @@
+/**
+ * In-memory vector store — pure-JS cosine similarity index. Zero deps, so it
+ * bundles in Bare/RN. Good for thousands of chunks; swap in a native/SQLite
+ * store via the VectorStore interface for larger corpora.
+ */
+import type { Chunk, RetrievedChunk, VectorStore, VectorStoreIO } from './types.js';
+/** Cosine similarity of two equal-length vectors. Returns 0 on degenerate input. */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+export interface InMemoryVectorStoreOptions {
+    io?: VectorStoreIO;
+}
+export declare class InMemoryVectorStore implements VectorStore {
+    private chunks;
+    private hydrated;
+    private readonly io?;
+    constructor(opts?: InMemoryVectorStoreOptions);
+    private hydrate;
+    upsert(chunks: Chunk[]): Promise<void>;
+    query(embedding: number[], k: number): Promise<RetrievedChunk[]>;
+    size(): Promise<number>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/rag/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../src/rag/vector-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpF,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAYjE;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,CAAC,EAAE,aAAa,CAAC;CACpB;AAED,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAgB;gBAExB,IAAI,GAAE,0BAA+B;YAInC,OAAO;IAYf,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAShE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/rag/vector-store.js

@@ -0,0 +1,72 @@
+/**
+ * In-memory vector store — pure-JS cosine similarity index. Zero deps, so it
+ * bundles in Bare/RN. Good for thousands of chunks; swap in a native/SQLite
+ * store via the VectorStore interface for larger corpora.
+ */
+/** Cosine similarity of two equal-length vectors. Returns 0 on degenerate input. */
+export function cosineSimilarity(a, b) {
+    const n = Math.min(a.length, b.length);
+    let dot = 0;
+    let na = 0;
+    let nb = 0;
+    for (let i = 0; i < n; i++) {
+        dot += a[i] * b[i];
+        na += a[i] * a[i];
+        nb += b[i] * b[i];
+    }
+    if (na === 0 || nb === 0)
+        return 0;
+    return dot / (Math.sqrt(na) * Math.sqrt(nb));
+}
+export class InMemoryVectorStore {
+    chunks = [];
+    hydrated = false;
+    io;
+    constructor(opts = {}) {
+        this.io = opts.io;
+    }
+    async hydrate() {
+        if (this.hydrated)
+            return;
+        this.hydrated = true;
+        if (this.io) {
+            try {
+                this.chunks = await this.io.load();
+            }
+            catch {
+                this.chunks = [];
+            }
+        }
+    }
+    async upsert(chunks) {
+        await this.hydrate();
+        for (const c of chunks) {
+            const i = this.chunks.findIndex((x) => x.id === c.id);
+            if (i >= 0)
+                this.chunks[i] = c;
+            else
+                this.chunks.push(c);
+        }
+        if (this.io)
+            await this.io.save(this.chunks);
+    }
+    async query(embedding, k) {
+        await this.hydrate();
+        return this.chunks
+            .filter((c) => c.embedding && c.embedding.length > 0)
+            .map((c) => ({ ...c, score: cosineSimilarity(embedding, c.embedding) }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, k);
+    }
+    async size() {
+        await this.hydrate();
+        return this.chunks.length;
+    }
+    async clear() {
+        await this.hydrate();
+        this.chunks = [];
+        if (this.io)
+            await this.io.save(this.chunks);
+    }
+}
+//# sourceMappingURL=vector-store.js.map

package/dist/rag/vector-store.js.map

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

package/dist/recipe/asset-send.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Built-in "send an RGB asset" recipe — distinct from the BTC payments recipe
+ * because an asset amount must NOT be treated as fiat.
+ *
+ *   "send 10 USDT to bob"     → resolve_contact → rln_send_asset 🔒
+ *   "pay alice 5 XAUT"        → resolve_contact → rln_send_asset 🔒
+ *
+ * Fixes the bug where the payments recipe parsed "USDT" as a fiat currency and
+ * ran fiat_to_sats. Payments now excludes RGB assets; this recipe owns them.
+ */
+import type { Recipe } from './types.js';
+/** "send 10 USDT to bob" / "pay alice 5 xaut". */
+export declare function extractAssetSend(text: string): Record<string, unknown> | null;
+export declare const assetSendRecipe: Recipe;
+//# sourceMappingURL=asset-send.d.ts.map

package/dist/recipe/asset-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-send.d.ts","sourceRoot":"","sources":["../../src/recipe/asset-send.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAC;AAoBxD,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAa7E;AAED,eAAO,MAAM,eAAe,EAAE,MA+B7B,CAAC"}

package/dist/recipe/asset-send.js

@@ -0,0 +1,83 @@
+/**
+ * Built-in "send an RGB asset" recipe — distinct from the BTC payments recipe
+ * because an asset amount must NOT be treated as fiat.
+ *
+ *   "send 10 USDT to bob"     → resolve_contact → rln_send_asset 🔒
+ *   "pay alice 5 XAUT"        → resolve_contact → rln_send_asset 🔒
+ *
+ * Fixes the bug where the payments recipe parsed "USDT" as a fiat currency and
+ * ran fiat_to_sats. Payments now excludes RGB assets; this recipe owns them.
+ */
+const RGB_ASSET = /\b(usdt|tether|xaut|gold)\b/i;
+const isOnchainOrInvoice = (s) => /^(ln(bc|tb|bcrt)|bc1|tb1|lnurl|rgb:|[a-z0-9._-]+@)/i.test(s.trim());
+function normAsset(a) {
+    if (!a)
+        return undefined;
+    const x = a.toLowerCase();
+    if (/usdt|tether/.test(x))
+        return 'USDT';
+    if (/xaut|gold/.test(x))
+        return 'XAUT';
+    return a.toUpperCase();
+}
+function parseAmount(t) {
+    const m = t.match(/(\d[\d.,]*)\s*([km])?\b/i);
+    if (!m)
+        return undefined;
+    let n = Number(m[1].replace(/,/g, ''));
+    if (m[2])
+        n *= m[2].toLowerCase() === 'k' ? 1_000 : 1_000_000;
+    return Number.isNaN(n) ? undefined : n;
+}
+/** "send 10 USDT to bob" / "pay alice 5 xaut". */
+export function extractAssetSend(text) {
+    const t = text.trim();
+    if (!/\b(send|pay|transfer)\b/i.test(t))
+        return null;
+    const asset = normAsset(t.match(RGB_ASSET)?.[1]);
+    if (!asset)
+        return null; // not an asset send → let the payments recipe handle it
+    const amount = parseAmount(t);
+    let recipient = t.match(/\bto\s+([^\s,]+)/i)?.[1];
+    if (!recipient) {
+        const after = t.match(/\b(?:pay|send|transfer)\s+([^\s,]+)/i)?.[1];
+        if (after && !/^\d/.test(after) && !RGB_ASSET.test(after))
+            recipient = after;
+    }
+    if (!recipient && amount == null)
+        return null;
+    return { recipient, asset, amount };
+}
+export const assetSendRecipe = {
+    name: 'pay-asset',
+    description: 'Send an RGB asset (USDT, XAUT) to a contact or address — resolves the contact, then sends (with confirmation).',
+    match: (t) => /\b(send|pay|transfer)\b/i.test(t) && RGB_ASSET.test(t) && !/\b(invoice|receive|swap|buy|sell|for)\b/i.test(t),
+    triggers: ['send', 'pay', 'transfer'],
+    slots: [
+        { name: 'recipient', type: 'string', description: 'Contact name, address, or RGB invoice', required: true },
+        { name: 'asset', type: 'string', description: 'RGB asset: USDT or XAUT', required: true },
+        { name: 'amount', type: 'number', description: 'Asset amount' },
+    ],
+    extract: extractAssetSend,
+    confident: (s) => !!s.recipient && !!s.asset,
+    steps: [
+        {
+            tool: 'resolve_contact',
+            as: 'contact',
+            args: (ctx) => ({ name: ctx.slots.recipient }),
+            skipIf: (ctx) => !ctx.slots.recipient || isOnchainOrInvoice(String(ctx.slots.recipient)),
+        },
+    ],
+    final: {
+        tool: 'rln_send_asset',
+        args: (ctx) => {
+            const contact = ctx.results.contact;
+            return { asset: ctx.slots.asset, amount: ctx.slots.amount, to: contact?.ln_address ?? ctx.slots.recipient };
+        },
+    },
+    summary: (ctx) => {
+        const to = ctx.results.contact?.name ?? ctx.slots.recipient;
+        return `Sent ${ctx.slots.amount} ${ctx.slots.asset} to ${to}.`;
+    },
+};
+//# sourceMappingURL=asset-send.js.map

package/dist/recipe/asset-send.js.map

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

package/dist/recipe/kaleidoswap-atomic.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Built-in "atomic swap on KaleidoSwap" recipe — trust-minimised chain.
+ *
+ * Most users want the simple market-order swap (`swapRecipe` over generic
+ * `get_swap_quote` / `execute_swap`). This recipe is the EXPLICIT atomic path:
+ * the user creates an RGB/LN receive invoice, the maker locks the swap, the
+ * user pays the maker's Lightning invoice, and the maker releases.
+ *
+ * Triggered only by explicit atomic-swap intent ("atomic swap", "trustless
+ * swap", "htlc swap") so it never preempts the simpler swap path for vague
+ * phrasings.
+ *
+ *   "atomic swap 100000 sats for usdt"
+ *     ↓ 1 model inference (slot extraction)
+ *   kaleidoswap_get_quote        ← maker prices the swap
+ *   rln_create_rgb_invoice       ← user's node prepares receive (if to_asset is RGB)
+ *   rln_create_ln_invoice        ← (alt) if to_asset is BTC
+ *   kaleidoswap_atomic_init  🔒 ← maker locks the swap, returns its invoice
+ *   rln_pay_invoice          🔒 ← user pays the maker
+ *   kaleidoswap_atomic_execute 🔒 ← (final) maker releases the asset
+ *
+ * Two-or-three confirmation gates are intentional: each represents a distinct
+ * decision point. The host's confirm UI describes what's about to happen.
+ */
+import type { Recipe } from './types.js';
+export declare const kaleidoswapAtomicRecipe: Recipe;
+//# sourceMappingURL=kaleidoswap-atomic.d.ts.map

package/dist/recipe/kaleidoswap-atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kaleidoswap-atomic.d.ts","sourceRoot":"","sources":["../../src/recipe/kaleidoswap-atomic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAUzC,eAAO,MAAM,uBAAuB,EAAE,MAiFrC,CAAC"}