@kaleidorg/mind 0.0.1

package/dist/engine.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Engine — the agentic loop, provider- and tool-source-agnostic.
+ *
+ * This is the shared "brain" logic, lifted out of rate's QVACService so the
+ * mobile app, the desktop app and the agent all run the SAME loop:
+ *
+ *   reason → (tool calls?) → execute / confirm → feed results back → repeat
+ *   → natural-language answer.
+ *
+ * Follows the QVAC multi-turn pattern: push the raw assistant frame plus
+ * `{role:'tool'}` results into history each round, loop until the model stops
+ * calling tools. Money tools pause for an `onConfirm` gate; their handlers run
+ * wherever the ToolSource lives (on the phone for the wallet), even when
+ * inference is delegated to a remote provider.
+ */
+import type { ConfirmDecision, Message, ToolResult } from './types.js';
+import type { LLMProvider } from './providers/types.js';
+import type { ToolRegistry } from './tools/registry.js';
+export interface EngineOptions {
+    provider: LLMProvider;
+    tools: ToolRegistry;
+    /** Prepended as a system message when the caller didn't supply one. */
+    defaultSystem?: string;
+    /** Max reasoning↔tool rounds before forcing a stop. Default 5. */
+    defaultMaxTurns?: number;
+}
+export interface AgenticOptions {
+    maxTurns?: number;
+    /** Visible content tokens as they stream, tagged with the current turn. */
+    onToken?: (token: string, turn: number) => void;
+    /** The live requestId for the current turn (so a stop button can cancel it). */
+    onStart?: (requestId: string, turn: number) => void;
+    /** Fired when the model requests a tool, before it executes. */
+    onToolCall?: (call: {
+        name: string;
+        arguments: Record<string, unknown>;
+    }, turn: number) => void;
+    /** Human-in-the-loop gate for tools flagged requiresConfirmation. */
+    onConfirm?: (call: {
+        name: string;
+        arguments: Record<string, unknown>;
+    }) => Promise<ConfirmDecision>;
+    signal?: AbortSignal;
+}
+export interface AgenticResult {
+    text: string;
+    turns: number;
+    toolCalls: ToolResult[];
+    requestId?: string;
+}
+export declare class Engine {
+    private readonly provider;
+    private readonly registry;
+    private readonly defaultSystem?;
+    private readonly defaultMaxTurns;
+    constructor(opts: EngineOptions);
+    runAgentic(messages: Message[], opts?: AgenticOptions): Promise<AgenticResult>;
+    cancel(requestId: string): Promise<void>;
+    private safeExecute;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,gEAAgE;IAChE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChG,qEAAqE;IACrE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACrG,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,IAAI,EAAE,aAAa;IAOzB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAmElF,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAIhC,WAAW;CAO1B"}

package/dist/engine.js

@@ -0,0 +1,99 @@
+/**
+ * Engine — the agentic loop, provider- and tool-source-agnostic.
+ *
+ * This is the shared "brain" logic, lifted out of rate's QVACService so the
+ * mobile app, the desktop app and the agent all run the SAME loop:
+ *
+ *   reason → (tool calls?) → execute / confirm → feed results back → repeat
+ *   → natural-language answer.
+ *
+ * Follows the QVAC multi-turn pattern: push the raw assistant frame plus
+ * `{role:'tool'}` results into history each round, loop until the model stops
+ * calling tools. Money tools pause for an `onConfirm` gate; their handlers run
+ * wherever the ToolSource lives (on the phone for the wallet), even when
+ * inference is delegated to a remote provider.
+ */
+export class Engine {
+    provider;
+    registry;
+    defaultSystem;
+    defaultMaxTurns;
+    constructor(opts) {
+        this.provider = opts.provider;
+        this.registry = opts.tools;
+        this.defaultSystem = opts.defaultSystem;
+        this.defaultMaxTurns = opts.defaultMaxTurns ?? 5;
+    }
+    async runAgentic(messages, opts = {}) {
+        const maxTurns = opts.maxTurns ?? this.defaultMaxTurns;
+        const hasSystem = messages.some((m) => m.role === 'system');
+        const system = hasSystem ? undefined : this.defaultSystem;
+        const history = [...messages];
+        const allTools = await this.registry.listTools();
+        const executed = [];
+        let lastRequestId;
+        let finalText = '';
+        let turns = 0;
+        for (let turn = 1; turn <= maxTurns; turn++) {
+            turns = turn;
+            if (opts.signal?.aborted)
+                break;
+            const out = await this.provider.runTurn({
+                messages: history,
+                tools: allTools,
+                system,
+                onToken: opts.onToken ? (t) => opts.onToken(t, turn) : undefined,
+                signal: opts.signal,
+            });
+            lastRequestId = out.requestId;
+            if (out.requestId)
+                opts.onStart?.(out.requestId, turn);
+            finalText = (out.text || '').trim();
+            // No tool calls ⇒ the model produced its final answer.
+            if (!out.toolCalls || out.toolCalls.length === 0)
+                break;
+            // Anchor the next turn with the raw assistant frame.
+            history.push({ role: 'assistant', content: out.rawContent || finalText });
+            for (const call of out.toolCalls) {
+                opts.onToolCall?.({ name: call.name, arguments: call.arguments }, turn);
+                const def = await this.registry.getDef(call.name);
+                let result;
+                if (def?.requiresConfirmation) {
+                    const decision = opts.onConfirm
+                        ? await opts.onConfirm({ name: call.name, arguments: call.arguments })
+                        : { approved: false, reason: 'no confirmation handler available' };
+                    if (decision.approved) {
+                        result = await this.safeExecute(call.name, call.arguments);
+                    }
+                    else {
+                        result = { declined: true, reason: decision.reason ?? 'user declined' };
+                    }
+                }
+                else {
+                    result = await this.safeExecute(call.name, call.arguments);
+                }
+                executed.push({ name: call.name, arguments: call.arguments, result });
+                history.push({
+                    role: 'tool',
+                    content: typeof result === 'string' ? result : JSON.stringify(result),
+                });
+            }
+            if (turn === maxTurns && !finalText) {
+                finalText = 'I had to stop after several steps — please try a more specific request.';
+            }
+        }
+        return { text: finalText, turns, toolCalls: executed, requestId: lastRequestId };
+    }
+    async cancel(requestId) {
+        await this.provider.cancel?.(requestId);
+    }
+    async safeExecute(name, args) {
+        try {
+            return await this.registry.execute(name, args);
+        }
+        catch (err) {
+            return { error: err instanceof Error ? err.message : String(err) };
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @kaleido/mind — shared local-AI reasoning engine for KaleidoSwap.
+ *
+ * Pure TypeScript, zero runtime dependencies. Hosts inject:
+ *   - an LLMProvider (wrapping @qvac/sdk, Anthropic, …)
+ *   - one or more ToolSources (in-process wallet tools, MCP servers, …)
+ *
+ * and get the shared agentic loop, identical on mobile / desktop / agent.
+ */
+export type { Role, Message, ToolDef, ToolCall, ToolResult, ConfirmDecision, } from './types.js';
+export type { LLMProvider, TurnInput, TurnOutput } from './providers/types.js';
+export type { ToolSource } from './tools/source.js';
+export { InProcessToolSource } from './tools/in-process.js';
+export type { InProcessTool } from './tools/in-process.js';
+export { ToolRegistry } from './tools/registry.js';
+export { Engine } from './engine.js';
+export type { EngineOptions, AgenticOptions, AgenticResult } from './engine.js';
+export { TurnLogger, defaultMask } from './logger.js';
+export type { TurnLog, Device, LoggerIO, LoggerOptions } from './logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,IAAI,EACJ,OAAO,EACP,OAAO,EACP,QAAQ,EACR,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE/E,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @kaleido/mind — shared local-AI reasoning engine for KaleidoSwap.
+ *
+ * Pure TypeScript, zero runtime dependencies. Hosts inject:
+ *   - an LLMProvider (wrapping @qvac/sdk, Anthropic, …)
+ *   - one or more ToolSources (in-process wallet tools, MCP servers, …)
+ *
+ * and get the shared agentic loop, identical on mobile / desktop / agent.
+ */
+export { InProcessToolSource } from './tools/in-process.js';
+export { ToolRegistry } from './tools/registry.js';
+export { Engine } from './engine.js';
+export { TurnLogger, defaultMask } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Structured turn logger — JSONL output, designed for future fine-tuning
+ * datasets. Format is compatible with Salesforce/APIGen-MT-5k so KaleidoMind
+ * records can be concatenated with public data and fed to SFT pipelines.
+ *
+ * Privacy posture: amounts/addresses/contacts are HASHED at log time.
+ * Raw values are kept in a separate local store and only re-attached at
+ * export with explicit --include-pii.
+ */
+import type { Message, ToolCall, ToolResult } from './types.js';
+export type Device = 'rate-ios' | 'rate-android' | 'kaleido-agent' | 'rate-extension' | 'kaleido-cli' | 'playground';
+export interface TurnLog {
+    id: string;
+    ts: string;
+    session_id: string;
+    device: Device;
+    model: {
+        provider: string;
+        name: string;
+        version?: string;
+    };
+    /** Hash-based identifier for the system prompt — same hash = same prompt. */
+    system_hash: string;
+    /** Names + schema hashes only, never raw schemas with semantic data. */
+    tools: {
+        name: string;
+        schema_hash: string;
+    }[];
+    messages: Message[];
+    decision: {
+        tool_calls: ToolCall[];
+        final_text: string | null;
+        reasoning_tokens?: number;
+    };
+    results: ToolResult[];
+    feedback?: {
+        thumbs?: 'up' | 'down';
+        edited_args?: Record<string, unknown>;
+        retry_count?: number;
+    };
+    latency_ms: {
+        transcribe?: number;
+        reason: number;
+        tools?: number;
+        total: number;
+    };
+    meta?: Record<string, unknown>;
+}
+export interface LoggerOptions {
+    /** Absolute path where YYYY-MM-DD/session-<id>.jsonl files are written. */
+    dir: string;
+    device: Device;
+    /** Pluggable IO so the same logger works in Node + RN + tests. */
+    io: LoggerIO;
+    /** PII masker — defaults to hashing common fields. */
+    mask?: (log: TurnLog) => TurnLog;
+}
+export interface LoggerIO {
+    ensureDir(path: string): Promise<void>;
+    appendLine(filePath: string, line: string): Promise<void>;
+    hash(value: unknown): string;
+    now(): Date;
+}
+export declare class TurnLogger {
+    private readonly opts;
+    constructor(opts: LoggerOptions);
+    log(input: Omit<TurnLog, 'id' | 'ts' | 'device'>): Promise<void>;
+}
+/**
+ * Default masking — hashes amounts, addresses, invoices, contact names.
+ * Tools without these fields pass through unchanged.
+ */
+export declare function defaultMask(io: LoggerIO): (log: TurnLog) => TurnLog;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,MAAM,MAAM,GACd,UAAU,GACV,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE;QACR,UAAU,EAAE,QAAQ,EAAE,CAAC;QACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,UAAU,EAAE;QACV,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,EAAE,EAAE,QAAQ,CAAC;IACb,sDAAsD;IACtD,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,GAAG,IAAI,IAAI,CAAC;CACb;AAED,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAE1C,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAcvE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CA+BnE"}

package/dist/logger.js

@@ -0,0 +1,63 @@
+/**
+ * Structured turn logger — JSONL output, designed for future fine-tuning
+ * datasets. Format is compatible with Salesforce/APIGen-MT-5k so KaleidoMind
+ * records can be concatenated with public data and fed to SFT pipelines.
+ *
+ * Privacy posture: amounts/addresses/contacts are HASHED at log time.
+ * Raw values are kept in a separate local store and only re-attached at
+ * export with explicit --include-pii.
+ */
+export class TurnLogger {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async log(input) {
+        const ts = this.opts.io.now().toISOString();
+        const id = `${input.session_id}-${this.opts.io.hash({ ts, n: Math.random() }).slice(0, 8)}`;
+        let entry = { ...input, id, ts, device: this.opts.device };
+        if (this.opts.mask)
+            entry = this.opts.mask(entry);
+        const day = ts.slice(0, 10);
+        const dir = `${this.opts.dir}/${day}`;
+        await this.opts.io.ensureDir(dir);
+        await this.opts.io.appendLine(`${dir}/session-${input.session_id}.jsonl`, JSON.stringify(entry));
+    }
+}
+/**
+ * Default masking — hashes amounts, addresses, invoices, contact names.
+ * Tools without these fields pass through unchanged.
+ */
+export function defaultMask(io) {
+    const FIELDS_TO_HASH = new Set([
+        'amount', 'amount_msat', 'amount_sat',
+        'address', 'invoice', 'bolt11', 'pubkey', 'node_id',
+        'contact', 'contact_name', 'recipient',
+    ]);
+    const walk = (v) => {
+        if (v === null || v === undefined)
+            return v;
+        if (Array.isArray(v))
+            return v.map(walk);
+        if (typeof v === 'object') {
+            const out = {};
+            for (const [k, val] of Object.entries(v)) {
+                out[k] = FIELDS_TO_HASH.has(k) ? `h:${io.hash(val).slice(0, 8)}` : walk(val);
+            }
+            return out;
+        }
+        return v;
+    };
+    return (log) => ({
+        ...log,
+        decision: {
+            ...log.decision,
+            tool_calls: log.decision.tool_calls.map((c) => ({
+                ...c,
+                arguments: walk(c.arguments),
+            })),
+        },
+        results: log.results.map((r) => ({ ...r, result: walk(r.result) })),
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/providers/qvac.d.ts

@@ -0,0 +1,89 @@
+/**
+ * QVAC provider — primary, on-device.
+ *
+ * Wraps the QVAC SDK's llamacpp-completion plugin. The actual binding
+ * differs slightly per host (RN vs Node vs browser worker), so the heavy
+ * lifting is delegated to a `QvacBinding` injected by the adapter packages.
+ *
+ * Node (kaleido-agent):       binding = await import('@qvac/sdk/node')
+ * React Native (rate):        binding from @kaleido/mind-rn → wraps QVACService
+ * Browser (rate-extension):   binding from @kaleido/mind-browser → talks to worker
+ */
+import type { LLMProvider, ProviderConfig, ProviderRunOptions, ProviderRunResult } from './types.js';
+import type { Message, ToolDef, TurnEvent } from '../types.js';
+/**
+ * Host-injected binding. Each adapter package supplies its own.
+ * We keep this duck-typed (not an abstract class) so adapters
+ * don't have to extend anything heavy.
+ */
+export interface QvacBinding {
+    load(modelPath: string, opts: {
+        contextSize: number;
+        backend?: 'metal' | 'cpu' | 'auto';
+    }): Promise<void>;
+    unload(): Promise<void>;
+    isReady(): boolean;
+    /** Synchronous completion. The adapter handles the QVAC SDK plumbing. */
+    complete(prompt: string, opts: {
+        maxTokens?: number;
+        temperature?: number;
+        topP?: number;
+        stop?: string[];
+        signal?: AbortSignal;
+    }): Promise<{
+        text: string;
+        usage?: {
+            prompt: number;
+            completion: number;
+        };
+    }>;
+    /** Streaming completion — yields token strings. */
+    stream(prompt: string, opts: {
+        maxTokens?: number;
+        temperature?: number;
+        topP?: number;
+        stop?: string[];
+        signal?: AbortSignal;
+    }): AsyncIterable<string>;
+}
+export interface QvacProviderOpts extends ProviderConfig {
+    binding: QvacBinding;
+    /**
+     * Chat template family. Auto-detect from model name when omitted.
+     *   'qwen3' — Qwen 3 family (thinking-mode aware)
+     *   'hermes' — Hermes 3/4 family
+     *   'llama3' — Llama 3.x Instruct
+     *   'chatml' — generic ChatML
+     */
+    template?: 'qwen3' | 'hermes' | 'llama3' | 'chatml';
+    backend?: 'metal' | 'cpu' | 'auto';
+}
+export declare class QvacProvider implements LLMProvider {
+    readonly name = "qvac";
+    readonly modelId: string;
+    private readonly binding;
+    private readonly contextSize;
+    private readonly temperature;
+    private readonly topP;
+    private readonly template;
+    private readonly backend;
+    constructor(opts: QvacProviderOpts);
+    load(): Promise<void>;
+    unload(): Promise<void>;
+    isReady(): boolean;
+    run(messages: Message[], tools: ToolDef[], opts?: ProviderRunOptions): Promise<ProviderRunResult>;
+    stream(messages: Message[], tools: ToolDef[], opts?: ProviderRunOptions): AsyncIterable<TurnEvent>;
+    private detectTemplate;
+    /**
+     * Render messages + tools into the model's chat template.
+     * TODO: full implementations per family. This stub uses a minimal
+     * tool-aware ChatML rendering that works for Qwen3 / Hermes / Llama 3.
+     */
+    private formatPrompt;
+    /**
+     * Parse the model's text output into (text, tool_calls).
+     * Recognises <tool_call>{...}</tool_call> blocks.
+     */
+    private parseCompletion;
+}
+//# sourceMappingURL=qvac.d.ts.map

package/dist/providers/qvac.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qvac.d.ts","sourceRoot":"","sources":["../../src/providers/qvac.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,OAAO,EAAY,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1G,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,IAAI,OAAO,CAAC;IACnB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC9E,mDAAmD;IACnD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,OAAO,EAAE,WAAW,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpD,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;CACpC;AAED,qBAAa,YAAa,YAAW,WAAW;IAC9C,SAAgB,IAAI,UAAU;IAC9B,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;gBAEvD,IAAI,EAAE,gBAAgB;IAU5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,OAAO,IAAI,OAAO;IAIZ,GAAG,CACP,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,OAAO,EAAE,EAChB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,iBAAiB,CAAC;IAYtB,MAAM,CACX,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,OAAO,EAAE,EAChB,IAAI,GAAE,kBAAuB,GAC5B,aAAa,CAAC,SAAS,CAAC;IAoB3B,OAAO,CAAC,cAAc;IAQtB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA+BpB;;;OAGG;IACH,OAAO,CAAC,eAAe;CAwBxB"}

package/dist/providers/qvac.js

@@ -0,0 +1,150 @@
+/**
+ * QVAC provider — primary, on-device.
+ *
+ * Wraps the QVAC SDK's llamacpp-completion plugin. The actual binding
+ * differs slightly per host (RN vs Node vs browser worker), so the heavy
+ * lifting is delegated to a `QvacBinding` injected by the adapter packages.
+ *
+ * Node (kaleido-agent):       binding = await import('@qvac/sdk/node')
+ * React Native (rate):        binding from @kaleido/mind-rn → wraps QVACService
+ * Browser (rate-extension):   binding from @kaleido/mind-browser → talks to worker
+ */
+export class QvacProvider {
+    name = 'qvac';
+    modelId;
+    binding;
+    contextSize;
+    temperature;
+    topP;
+    template;
+    backend;
+    constructor(opts) {
+        this.modelId = opts.model;
+        this.binding = opts.binding;
+        this.contextSize = opts.contextSize ?? 32768;
+        this.temperature = opts.temperature ?? 0.2;
+        this.topP = opts.topP ?? 0.9;
+        this.template = opts.template ?? this.detectTemplate(opts.model);
+        this.backend = opts.backend ?? 'auto';
+    }
+    async load() {
+        if (this.binding.isReady())
+            return;
+        await this.binding.load(this.modelId, {
+            contextSize: this.contextSize,
+            backend: this.backend,
+        });
+    }
+    async unload() {
+        await this.binding.unload();
+    }
+    isReady() {
+        return this.binding.isReady();
+    }
+    async run(messages, tools, opts = {}) {
+        await this.load();
+        const prompt = this.formatPrompt(messages, tools, opts);
+        const { text, usage } = await this.binding.complete(prompt, {
+            temperature: this.temperature,
+            topP: this.topP,
+            stop: opts.stop,
+            signal: opts.signal,
+        });
+        return this.parseCompletion(text, usage);
+    }
+    async *stream(messages, tools, opts = {}) {
+        await this.load();
+        const prompt = this.formatPrompt(messages, tools, opts);
+        let buffer = '';
+        for await (const chunk of this.binding.stream(prompt, {
+            temperature: this.temperature,
+            topP: this.topP,
+            stop: opts.stop,
+            signal: opts.signal,
+        })) {
+            buffer += chunk;
+            yield { type: 'token', text: chunk };
+        }
+        const parsed = this.parseCompletion(buffer);
+        for (const call of parsed.tool_calls) {
+            yield { type: 'tool_call', call };
+        }
+        yield { type: 'done', final: parsed.text };
+    }
+    detectTemplate(model) {
+        const m = model.toLowerCase();
+        if (m.includes('qwen3') || m.includes('qwen-3'))
+            return 'qwen3';
+        if (m.includes('hermes'))
+            return 'hermes';
+        if (m.includes('llama-3') || m.includes('llama3'))
+            return 'llama3';
+        return 'chatml';
+    }
+    /**
+     * Render messages + tools into the model's chat template.
+     * TODO: full implementations per family. This stub uses a minimal
+     * tool-aware ChatML rendering that works for Qwen3 / Hermes / Llama 3.
+     */
+    formatPrompt(messages, tools, opts) {
+        const toolDescriptions = tools.length
+            ? `\n\n<tools>\n${tools.map(t => JSON.stringify({
+                name: t.name,
+                description: t.description,
+                parameters: '<schema:' + t.name + '>',
+            })).join('\n')}\n</tools>\n\n` +
+                `When you need to call a tool, emit a single line of JSON wrapped in <tool_call></tool_call> tags. ` +
+                `Wait for the tool result before continuing.`
+            : '';
+        const sys = (opts.system ?? '') + toolDescriptions;
+        let prompt = sys ? `<|im_start|>system\n${sys}<|im_end|>\n` : '';
+        for (const m of messages) {
+            if (m.role === 'system')
+                continue;
+            prompt += `<|im_start|>${m.role}\n${m.content ?? ''}`;
+            if (m.tool_calls?.length) {
+                for (const c of m.tool_calls) {
+                    prompt += `\n<tool_call>${JSON.stringify({ name: c.name, arguments: c.args })}</tool_call>`;
+                }
+            }
+            prompt += `<|im_end|>\n`;
+        }
+        prompt += `<|im_start|>assistant\n`;
+        if (this.template === 'qwen3' && !opts.thinking) {
+            prompt += `<think>\n</think>\n`;
+        }
+        return prompt;
+    }
+    /**
+     * Parse the model's text output into (text, tool_calls).
+     * Recognises <tool_call>{...}</tool_call> blocks.
+     */
+    parseCompletion(text, usage) {
+        const tool_calls = [];
+        const callRegex = /<tool_call>\s*([\s\S]*?)\s*<\/tool_call>/g;
+        let match;
+        let i = 0;
+        while ((match = callRegex.exec(text)) !== null) {
+            const raw = match[1];
+            if (!raw)
+                continue;
+            try {
+                const parsed = JSON.parse(raw);
+                tool_calls.push({
+                    id: `c-${i++}`,
+                    name: parsed.name,
+                    args: parsed.arguments ?? {},
+                });
+            }
+            catch {
+                // Ignore malformed — the engine's retry loop will reprompt.
+            }
+        }
+        const cleaned = text.replace(callRegex, '').trim();
+        const result = { text: cleaned, tool_calls };
+        if (usage)
+            result.usage = usage;
+        return result;
+    }
+}
+//# sourceMappingURL=qvac.js.map

package/dist/providers/qvac.js.map

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