@kaleidorg/mind 0.0.1

package/dist/providers/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * LLMProvider — the only thing the Engine talks to for inference.
+ *
+ * Each host implements this over its own LLM transport:
+ *   - rate (mobile): wraps @qvac/sdk completion() (local or P2P-delegated)
+ *   - desktop-app:   wraps @qvac/sdk completion() in Node
+ *   - kaleidoagent:  could wrap Anthropic/OpenAI
+ *
+ * The core package never imports any LLM SDK — it only depends on this
+ * interface, so it stays pure TS and bundles anywhere.
+ */
+import type { Message, ToolCall, ToolDef } from '../types.js';
+export interface TurnInput {
+    messages: Message[];
+    tools: ToolDef[];
+    /** System prompt, when not already present as a message. */
+    system?: string;
+    /** Visible content tokens as they stream. */
+    onToken?: (token: string) => void;
+    signal?: AbortSignal;
+}
+export interface TurnOutput {
+    /** Cleaned assistant content for display. */
+    text: string;
+    /**
+     * Raw assistant frame to push back into history for the next turn. For
+     * tool-calling models this includes the tool-call framing the model needs
+     * to anchor continuation (e.g. QVAC's `final.raw.fullText`). Falls back to
+     * `text` when a provider has no separate raw form.
+     */
+    rawContent: string;
+    /** Tool calls the model requested this turn (empty ⇒ final answer). */
+    toolCalls: ToolCall[];
+    /** Provider request id, for cancellation. */
+    requestId?: string;
+}
+export interface LLMProvider {
+    readonly name: string;
+    /** Run one completion turn. */
+    runTurn(input: TurnInput): Promise<TurnOutput>;
+    /** Cancel an in-flight turn by request id, if the provider supports it. */
+    cancel?(requestId: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,2EAA2E;IAC3E,MAAM,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/providers/types.js

@@ -0,0 +1,13 @@
+/**
+ * LLMProvider — the only thing the Engine talks to for inference.
+ *
+ * Each host implements this over its own LLM transport:
+ *   - rate (mobile): wraps @qvac/sdk completion() (local or P2P-delegated)
+ *   - desktop-app:   wraps @qvac/sdk completion() in Node
+ *   - kaleidoagent:  could wrap Anthropic/OpenAI
+ *
+ * The core package never imports any LLM SDK — it only depends on this
+ * interface, so it stays pure TS and bundles anywhere.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

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

package/dist/tools/in-process.d.ts

@@ -0,0 +1,27 @@
+/**
+ * InProcessToolSource — tools whose handlers run in the same process.
+ *
+ * Used by the mobile wallet: the handlers call the device's wallet adapters
+ * (Spark / Arkade / RGB) directly, so signing happens on the phone even when
+ * the model's inference is delegated to a desktop over P2P.
+ */
+import type { ToolDef } from '../types.js';
+import type { ToolSource } from './source.js';
+export interface InProcessTool<Args = Record<string, unknown>> {
+    name: string;
+    description: string;
+    /** Zod schema (or any shape the provider understands). */
+    parameters: unknown;
+    /** When true, the engine pauses for confirmation before executing. */
+    requiresConfirmation?: boolean;
+    handler: (args: Args) => Promise<unknown>;
+}
+export declare class InProcessToolSource implements ToolSource {
+    readonly id: string;
+    private readonly tools;
+    constructor(id: string, tools: InProcessTool[]);
+    listTools(): ToolDef[];
+    has(name: string): boolean;
+    execute(name: string, args: Record<string, unknown>): Promise<unknown>;
+}
+//# sourceMappingURL=in-process.d.ts.map

package/dist/tools/in-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process.d.ts","sourceRoot":"","sources":["../../src/tools/in-process.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED,qBAAa,mBAAoB,YAAW,UAAU;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBAE9C,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE;IAK9C,SAAS,IAAI,OAAO,EAAE;IAStB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAK7E"}

package/dist/tools/in-process.js

@@ -0,0 +1,34 @@
+/**
+ * InProcessToolSource — tools whose handlers run in the same process.
+ *
+ * Used by the mobile wallet: the handlers call the device's wallet adapters
+ * (Spark / Arkade / RGB) directly, so signing happens on the phone even when
+ * the model's inference is delegated to a desktop over P2P.
+ */
+export class InProcessToolSource {
+    id;
+    tools = new Map();
+    constructor(id, tools) {
+        this.id = id;
+        for (const t of tools)
+            this.tools.set(t.name, t);
+    }
+    listTools() {
+        return Array.from(this.tools.values()).map((t) => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters,
+            requiresConfirmation: t.requiresConfirmation,
+        }));
+    }
+    has(name) {
+        return this.tools.has(name);
+    }
+    async execute(name, args) {
+        const tool = this.tools.get(name);
+        if (!tool)
+            throw new Error(`Tool "${name}" not found in source "${this.id}"`);
+        return tool.handler(args);
+    }
+}
+//# sourceMappingURL=in-process.js.map

package/dist/tools/in-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process.js","sourceRoot":"","sources":["../../src/tools/in-process.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,MAAM,OAAO,mBAAmB;IACrB,EAAE,CAAS;IACH,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE1D,YAAY,EAAU,EAAE,KAAsB;QAC5C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAkB,CAAC,CAAC;IACpE,CAAC;IAED,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,oBAAoB,EAAE,CAAC,CAAC,oBAAoB;SAC7C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAA6B;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,0BAA0B,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/tools/mcp.d.ts

@@ -0,0 +1,52 @@
+/**
+ * McpToolSource — exposes an MCP server's tools to the engine. NODE ONLY.
+ *
+ * Not exported from the package's main entry (`@kaleido/mind`) — import it
+ * explicitly from `@kaleido/mind/mcp` on Node hosts (desktop-app, kaleidoagent)
+ * so React Native never bundles the MCP SDK or any subprocess machinery.
+ *
+ * Connects to a server like `kaleido-mcp` (Spark + RLN + KaleidoSwap DEX +
+ * MPP/L402 + market data, ~64 tools) over stdio or HTTP, lists its tools, and
+ * routes execute() calls through the MCP client.
+ *
+ * The `@modelcontextprotocol/sdk` dependency is imported dynamically so this
+ * file type-checks and ships even where the SDK isn't installed; constructing
+ * an McpToolSource without it throws a clear error.
+ *
+ * STATUS: skeleton for the desktop pass. The shape is final; the connect()
+ * body is wired when we integrate desktop-app.
+ */
+import type { ToolDef } from '../types.js';
+import type { ToolSource } from './source.js';
+export type McpTransport = {
+    kind: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+} | {
+    kind: 'http';
+    url: string;
+    headers?: Record<string, string>;
+};
+export interface McpToolSourceOptions {
+    id: string;
+    transport: McpTransport;
+    /** Optional allowlist — only expose these tool names if provided. */
+    allow?: string[];
+    /** Per-call timeout (ms). Default 60_000. */
+    timeoutMs?: number;
+}
+export declare class McpToolSource implements ToolSource {
+    readonly id: string;
+    private readonly opts;
+    private client;
+    private tools;
+    constructor(opts: McpToolSourceOptions);
+    /** Connect to the MCP server and cache its tool list. Call once at startup. */
+    connect(): Promise<void>;
+    listTools(): ToolDef[];
+    has(name: string): boolean;
+    execute(name: string, args: Record<string, unknown>): Promise<unknown>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/tools/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/tools/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,YAAY,CAAC;IACxB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAc,YAAW,UAAU;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAC5C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAiB;gBAElB,IAAI,EAAE,oBAAoB;IAKtC,+EAA+E;IACzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC9B,SAAS,IAAI,OAAO,EAAE;IAItB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/tools/mcp.js

@@ -0,0 +1,81 @@
+/**
+ * McpToolSource — exposes an MCP server's tools to the engine. NODE ONLY.
+ *
+ * Not exported from the package's main entry (`@kaleido/mind`) — import it
+ * explicitly from `@kaleido/mind/mcp` on Node hosts (desktop-app, kaleidoagent)
+ * so React Native never bundles the MCP SDK or any subprocess machinery.
+ *
+ * Connects to a server like `kaleido-mcp` (Spark + RLN + KaleidoSwap DEX +
+ * MPP/L402 + market data, ~64 tools) over stdio or HTTP, lists its tools, and
+ * routes execute() calls through the MCP client.
+ *
+ * The `@modelcontextprotocol/sdk` dependency is imported dynamically so this
+ * file type-checks and ships even where the SDK isn't installed; constructing
+ * an McpToolSource without it throws a clear error.
+ *
+ * STATUS: skeleton for the desktop pass. The shape is final; the connect()
+ * body is wired when we integrate desktop-app.
+ */
+export class McpToolSource {
+    id;
+    opts;
+    client = null;
+    tools = [];
+    constructor(opts) {
+        this.id = opts.id;
+        this.opts = opts;
+    }
+    /** Connect to the MCP server and cache its tool list. Call once at startup. */
+    async connect() {
+        // Dynamic import keeps the MCP SDK out of bundles that never call connect().
+        const { Client } = await import('@modelcontextprotocol/sdk/client/index.js');
+        const t = this.opts.transport;
+        let transport;
+        if (t.kind === 'stdio') {
+            const { StdioClientTransport } = await import('@modelcontextprotocol/sdk/client/stdio.js');
+            transport = new StdioClientTransport({ command: t.command, args: t.args ?? [], env: t.env });
+        }
+        else {
+            const { StreamableHTTPClientTransport } = await import('@modelcontextprotocol/sdk/client/streamableHttp.js');
+            transport = new StreamableHTTPClientTransport(new URL(t.url), {
+                requestInit: t.headers ? { headers: t.headers } : undefined,
+            });
+        }
+        this.client = new Client({ name: `kaleido-mind:${this.id}`, version: '0.0.1' }, { capabilities: {} });
+        await this.client.connect(transport);
+        const listed = await this.client.listTools();
+        const allow = this.opts.allow ? new Set(this.opts.allow) : null;
+        this.tools = (listed.tools ?? [])
+            .filter((t) => !allow || allow.has(t.name))
+            .map((t) => ({
+            name: t.name,
+            description: t.description ?? '',
+            parameters: t.inputSchema ?? { type: 'object', properties: {} },
+        }));
+    }
+    listTools() {
+        return this.tools;
+    }
+    has(name) {
+        return this.tools.some((t) => t.name === name);
+    }
+    async execute(name, args) {
+        if (!this.client)
+            throw new Error(`McpToolSource "${this.id}" not connected — call connect() first`);
+        const res = await this.client.callTool({ name, arguments: args }, undefined, { timeout: this.opts.timeoutMs ?? 60_000 });
+        // MCP returns content blocks; surface text content as the tool result.
+        if (Array.isArray(res?.content)) {
+            const text = res.content
+                .filter((c) => c.type === 'text')
+                .map((c) => c.text)
+                .join('\n');
+            return text || res.content;
+        }
+        return res;
+    }
+    async close() {
+        await this.client?.close?.();
+        this.client = null;
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/tools/mcp.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ToolRegistry — merges multiple ToolSources into one tool list for the model
+ * and routes each tool call back to the source that owns it.
+ *
+ * Name-clash policy: first source wins (sources are consulted in registration
+ * order), so a host can layer a high-priority source over a broader one.
+ */
+import type { ToolDef } from '../types.js';
+import type { ToolSource } from './source.js';
+export declare class ToolRegistry {
+    private readonly sources;
+    constructor(sources?: ToolSource[]);
+    add(source: ToolSource): this;
+    /** Merged, de-duplicated tool list across all sources. */
+    listTools(): Promise<ToolDef[]>;
+    /** The first source that owns a tool by name. */
+    private ownerOf;
+    /** Execute a tool, routing to its owning source. */
+    execute(name: string, args: Record<string, unknown>): Promise<unknown>;
+    /** Look up a tool definition (e.g. to check requiresConfirmation). */
+    getDef(name: string): Promise<ToolDef | undefined>;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,OAAO,GAAE,UAAU,EAAO;IAItC,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAK7B,0DAA0D;IACpD,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAcrC,iDAAiD;IACjD,OAAO,CAAC,OAAO;IAIf,oDAAoD;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5E,sEAAsE;IAChE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;CAIzD"}

package/dist/tools/registry.js

@@ -0,0 +1,49 @@
+/**
+ * ToolRegistry — merges multiple ToolSources into one tool list for the model
+ * and routes each tool call back to the source that owns it.
+ *
+ * Name-clash policy: first source wins (sources are consulted in registration
+ * order), so a host can layer a high-priority source over a broader one.
+ */
+export class ToolRegistry {
+    sources = [];
+    constructor(sources = []) {
+        this.sources = [...sources];
+    }
+    add(source) {
+        this.sources.push(source);
+        return this;
+    }
+    /** Merged, de-duplicated tool list across all sources. */
+    async listTools() {
+        const out = [];
+        const seen = new Set();
+        for (const source of this.sources) {
+            const tools = await source.listTools();
+            for (const t of tools) {
+                if (seen.has(t.name))
+                    continue; // first source wins
+                seen.add(t.name);
+                out.push(t);
+            }
+        }
+        return out;
+    }
+    /** The first source that owns a tool by name. */
+    ownerOf(name) {
+        return this.sources.find((s) => s.has(name));
+    }
+    /** Execute a tool, routing to its owning source. */
+    async execute(name, args) {
+        const owner = this.ownerOf(name);
+        if (!owner)
+            throw new Error(`No tool source owns "${name}"`);
+        return owner.execute(name, args);
+    }
+    /** Look up a tool definition (e.g. to check requiresConfirmation). */
+    async getDef(name) {
+        const tools = await this.listTools();
+        return tools.find((t) => t.name === name);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,OAAO,YAAY;IACN,OAAO,GAAiB,EAAE,CAAC;IAE5C,YAAY,UAAwB,EAAE;QACpC,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,MAAkB;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,SAAS;QACb,MAAM,GAAG,GAAc,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;oBAAE,SAAS,CAAC,oBAAoB;gBACpD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACjB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,iDAAiD;IACzC,OAAO,CAAC,IAAY;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAA6B;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,GAAG,CAAC,CAAC;QAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/tools/source.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ToolSource — anything that exposes a set of tools and can execute them.
+ *
+ * This is the seam that makes the engine modular. Two implementations cover
+ * every surface:
+ *   - InProcessToolSource — Zod tools + local handlers (works on React Native;
+ *     used by the mobile wallet — handlers run on-device so keys never leave)
+ *   - McpToolSource       — connects an MCP server over stdio/HTTP (Node only;
+ *     used on desktop for the full kaleido-mcp toolset)
+ *
+ * The engine merges N sources into one tool list for the model and routes each
+ * tool call back to the source that owns it.
+ */
+import type { ToolDef } from '../types.js';
+export interface ToolSource {
+    /** Stable identifier (for logging / debugging). */
+    readonly id: string;
+    /** The tools this source exposes. May be async (e.g. MCP listTools). */
+    listTools(): ToolDef[] | Promise<ToolDef[]>;
+    /** Whether this source owns a tool by name. */
+    has(name: string): boolean;
+    /** Execute a tool this source owns. */
+    execute(name: string, args: Record<string, unknown>): Promise<unknown>;
+}
+//# sourceMappingURL=source.d.ts.map

package/dist/tools/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/tools/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,SAAS,IAAI,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,+CAA+C;IAC/C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,uCAAuC;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxE"}

package/dist/tools/source.js

@@ -0,0 +1,15 @@
+/**
+ * ToolSource — anything that exposes a set of tools and can execute them.
+ *
+ * This is the seam that makes the engine modular. Two implementations cover
+ * every surface:
+ *   - InProcessToolSource — Zod tools + local handlers (works on React Native;
+ *     used by the mobile wallet — handlers run on-device so keys never leave)
+ *   - McpToolSource       — connects an MCP server over stdio/HTTP (Node only;
+ *     used on desktop for the full kaleido-mcp toolset)
+ *
+ * The engine merges N sources into one tool list for the model and routes each
+ * tool call back to the source that owns it.
+ */
+export {};
+//# sourceMappingURL=source.js.map

package/dist/tools/source.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Core types for the kaleido-mind engine.
+ *
+ * Pure data shapes — no runtime dependencies. The engine, tool sources and
+ * providers are all defined in terms of these, so the core package bundles
+ * cleanly on any host (React Native / Node / browser) without dragging in
+ * @qvac/sdk or any native code.
+ */
+export type Role = 'system' | 'user' | 'assistant' | 'tool';
+export interface Message {
+    role: Role;
+    content: string;
+}
+/**
+ * A tool the model can call. `parameters` is intentionally `unknown` — it may
+ * be a Zod schema (in-process tools) or a JSON Schema (MCP tools). Each
+ * provider converts it to whatever its SDK expects.
+ */
+export interface ToolDef {
+    name: string;
+    description: string;
+    parameters: unknown;
+    /** When true, the engine pauses for `onConfirm` before executing (e.g. payments). */
+    requiresConfirmation?: boolean;
+}
+export interface ToolCall {
+    /** Provider-assigned id, when available. */
+    id?: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolResult {
+    name: string;
+    arguments: Record<string, unknown>;
+    result: unknown;
+}
+export interface ConfirmDecision {
+    approved: boolean;
+    reason?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,qFAAqF;IACrF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,QAAQ;IACvB,4CAA4C;IAC5C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Core types for the kaleido-mind engine.
+ *
+ * Pure data shapes — no runtime dependencies. The engine, tool sources and
+ * providers are all defined in terms of these, so the core package bundles
+ * cleanly on any host (React Native / Node / browser) without dragging in
+ * @qvac/sdk or any native code.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@kaleidorg/mind",
+  "version": "0.0.1",
+  "description": "Local-first reasoning + function-calling engine for KaleidoSwap. QVAC-powered.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kaleidoswap/kaleido-mind.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./mcp": {
+      "import": "./dist/tools/mcp.js",
+      "types": "./dist/tools/mcp.d.ts"
+    },
+    "./logger": {
+      "import": "./dist/logger.js",
+      "types": "./dist/logger.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src"
+  },
+  "devDependencies": {
+    "vitest": "^1.6.0"
+  }
+}