@kaleidorg/mind 0.1.0 → 0.3.0

package/dist/knowledge/merchants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchants.d.ts","sourceRoot":"","sources":["../../src/knowledge/merchants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,CAuBzE"}

package/dist/knowledge/merchants.js

@@ -0,0 +1,34 @@
+/**
+ * BTC map discovery — turn a merchant directory (e.g. BTCMap / a local dataset)
+ * into `RagDocument[]` so the agent can answer "where can I spend Bitcoin for
+ * coffee near me?" with on-device semantic search over places.
+ *
+ * Pure transform over a generic Merchant shape. Coordinates are kept in
+ * metadata so the host can still pin results on a map after retrieval.
+ */
+/** One searchable doc per merchant; lat/lng preserved in metadata for mapping. */
+export function merchantsToDocuments(merchants) {
+    return merchants
+        .filter((m) => m.name)
+        .map((m, i) => {
+        const where = [m.address, m.city].filter(Boolean).join(', ');
+        const pays = m.acceptedAssets?.length
+            ? `Accepts ${m.acceptedAssets.join(', ')}.`
+            : 'Accepts Bitcoin.';
+        const cat = m.category ? ` (${m.category})` : '';
+        const desc = m.description ? ` ${m.description}` : '';
+        return {
+            id: m.id ?? `merchant_${m.name ?? i}`,
+            text: `${m.name}${cat}${where ? ` at ${where}` : ''}. ${pays}${desc}`.trim(),
+            metadata: {
+                kind: 'merchant',
+                name: m.name,
+                category: m.category,
+                city: m.city,
+                lat: m.lat,
+                lng: m.lng,
+            },
+        };
+    });
+}
+//# sourceMappingURL=merchants.js.map

package/dist/knowledge/merchants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchants.js","sourceRoot":"","sources":["../../src/knowledge/merchants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAAC,SAAqB;IACxD,OAAO,SAAS;SACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM;YACnC,CAAC,CAAC,WAAW,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YAC3C,CAAC,CAAC,kBAAkB,CAAC;QACvB,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO;YACL,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,YAAY,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE;YACrC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE;YAC5E,QAAQ,EAAE;gBACR,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,GAAG,EAAE,CAAC,CAAC,GAAG;aACX;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/knowledge/wallet.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Personal wallet knowledge — turn a user's transaction history + contacts into
+ * `RagDocument[]` so the agent can answer "what did I spend on coffee last
+ * month?", "who did I pay 50k sats to?", "summarise my swaps" — all on-device,
+ * nothing leaving the phone.
+ *
+ * Pure transforms over minimal, generic shapes (hosts map their own types in).
+ * No deps, no PII leaves: the host decides what to ingest.
+ */
+import type { RagDocument } from '../rag/types.js';
+export interface WalletTx {
+    id?: string;
+    /** 'send' | 'receive' | 'swap' | 'deposit' | 'withdraw' | … */
+    type?: string;
+    amountSats?: number;
+    asset?: string;
+    /** Who/where — a name, contact, address, or merchant. */
+    counterparty?: string;
+    memo?: string;
+    status?: string;
+    /** Epoch ms. */
+    timestamp?: number;
+}
+export interface Contact {
+    name?: string;
+    lightningAddress?: string;
+    npub?: string;
+    note?: string;
+}
+/** One short, searchable sentence per transaction. */
+export declare function walletHistoryToDocuments(txs: WalletTx[]): RagDocument[];
+/** One doc per contact, so "who is Bob?" / "pay my friend" can resolve. */
+export declare function contactsToDocuments(contacts: Contact[]): RagDocument[];
+//# sourceMappingURL=wallet.d.ts.map

package/dist/knowledge/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/knowledge/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAYD,sDAAsD;AACtD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,WAAW,EAAE,CAsBvE;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CActE"}

package/dist/knowledge/wallet.js

@@ -0,0 +1,63 @@
+/**
+ * Personal wallet knowledge — turn a user's transaction history + contacts into
+ * `RagDocument[]` so the agent can answer "what did I spend on coffee last
+ * month?", "who did I pay 50k sats to?", "summarise my swaps" — all on-device,
+ * nothing leaving the phone.
+ *
+ * Pure transforms over minimal, generic shapes (hosts map their own types in).
+ * No deps, no PII leaves: the host decides what to ingest.
+ */
+function isoDate(ts) {
+    if (!ts)
+        return 'an unknown date';
+    // Avoid Date formatting differences — just YYYY-MM-DD from the ISO string.
+    try {
+        return new Date(ts).toISOString().slice(0, 10);
+    }
+    catch {
+        return 'an unknown date';
+    }
+}
+/** One short, searchable sentence per transaction. */
+export function walletHistoryToDocuments(txs) {
+    return txs.map((tx, i) => {
+        const date = isoDate(tx.timestamp);
+        const asset = tx.asset ?? 'sats';
+        const amount = tx.amountSats != null ? `${tx.amountSats} ${asset === 'BTC' ? 'sats' : asset}` : 'an amount';
+        const verb = tx.type === 'receive' || tx.type === 'deposit'
+            ? 'received'
+            : tx.type === 'swap'
+                ? 'swapped'
+                : tx.type === 'withdraw'
+                    ? 'withdrew'
+                    : 'sent';
+        const who = tx.counterparty ? ` ${verb === 'received' ? 'from' : 'to'} ${tx.counterparty}` : '';
+        const memo = tx.memo ? ` — "${tx.memo}"` : '';
+        const status = tx.status && tx.status !== 'complete' ? ` (${tx.status})` : '';
+        return {
+            id: tx.id ?? `tx_${i}`,
+            text: `On ${date} you ${verb} ${amount}${who}${memo}${status}.`,
+            metadata: { kind: 'transaction', type: tx.type, asset: tx.asset, timestamp: tx.timestamp },
+        };
+    });
+}
+/** One doc per contact, so "who is Bob?" / "pay my friend" can resolve. */
+export function contactsToDocuments(contacts) {
+    return contacts
+        .filter((c) => c.name || c.lightningAddress || c.npub)
+        .map((c, i) => {
+        const parts = [];
+        if (c.lightningAddress)
+            parts.push(`Lightning address ${c.lightningAddress}`);
+        if (c.npub)
+            parts.push(`Nostr ${c.npub}`);
+        if (c.note)
+            parts.push(c.note);
+        return {
+            id: `contact_${c.name ?? c.lightningAddress ?? i}`,
+            text: `Contact: ${c.name ?? 'unnamed'}${parts.length ? ` — ${parts.join(', ')}` : ''}.`,
+            metadata: { kind: 'contact', name: c.name },
+        };
+    });
+}
+//# sourceMappingURL=wallet.js.map

package/dist/knowledge/wallet.js.map

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

package/dist/lsps1/contract.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Canonical LSPS1 tool contract — Lightning Service Provider channel orders.
+ *
+ * LSPS1 is a transport-agnostic protocol for buying inbound channel liquidity
+ * from a Lightning Service Provider. The maker happens to implement it, but a
+ * different LSP could too — so the tool names are LSP-agnostic (`lsp_*`),
+ * not `kaleidoswap_*`. The host's binder decides which LSP they reach.
+ *
+ * Every surface implements THESE EXACT tools, only the transport differs:
+ *   - mobile  → in-process handlers over the WDK LSP adapter
+ *   - desktop → HTTP / MCP / CLI handlers
+ *   - eval    → stub handlers
+ *
+ * `lsp_create_order` is a spend → confirmation-gated.
+ *
+ * Pure data — no deps, no fetch, RN-safe.
+ */
+import type { ToolDef } from '../types.js';
+import { InProcessToolSource } from '../tools/in-process.js';
+export interface Lsps1ToolDef extends ToolDef {
+    /** Moves funds → confirmation-gated. */
+    spend?: boolean;
+}
+/**
+ * The canonical LSPS1 tool list — agent-facing schemas. Each host's binder
+ * translates these args into the LSP's request body (LSPS1 JSON-RPC, the
+ * KaleidoSwap maker's REST routes, MCP, or a WDK adapter call).
+ */
+export declare const LSPS1_TOOLS: Lsps1ToolDef[];
+/** All LSPS1 tool names that move funds (confirmation-gated). */
+export declare const LSPS1_SPEND_TOOLS: Set<string>;
+export declare function isLsps1SpendTool(name: string): boolean;
+export declare function getLsps1Tool(name: string): Lsps1ToolDef | undefined;
+/** A handler bound to one LSPS1 tool. */
+export type Lsps1Handler = (args: Record<string, unknown>) => Promise<unknown>;
+export interface BindLsps1Options {
+    /** Skip tools without a handler instead of throwing (default false). */
+    allowMissing?: boolean;
+    /** ToolSource id for the registry (default 'lsps1'). */
+    id?: string;
+}
+/**
+ * Bind LSPS1 contract tools to in-process handlers → an InProcessToolSource.
+ *
+ *   const source = bindLsps1Tools({
+ *     lsp_get_info:        async () => makerLsp.getInfo(),
+ *     lsp_estimate_fees:   async (args) => makerLsp.estimateFees(args),
+ *     lsp_create_order:    async (args) => makerLsp.createOrder(args),
+ *     lsp_get_order:       async ({ order_id }) => makerLsp.getOrder(order_id),
+ *     lsp_get_network_info:async () => makerLsp.networkInfo(),
+ *   });
+ *   tools.register(source);
+ */
+export declare function bindLsps1Tools(handlers: Record<string, Lsps1Handler>, opts?: BindLsps1Options): InProcessToolSource;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/lsps1/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,WAAW,YAAa,SAAQ,OAAO;IAC3C,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAcD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,YAAY,EAiCrC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAEzC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEnE;AAED,yCAAyC;AACzC,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,IAAI,GAAE,gBAAqB,GAAG,mBAAmB,CAiBvH"}

package/dist/lsps1/contract.js

@@ -0,0 +1,91 @@
+/**
+ * Canonical LSPS1 tool contract — Lightning Service Provider channel orders.
+ *
+ * LSPS1 is a transport-agnostic protocol for buying inbound channel liquidity
+ * from a Lightning Service Provider. The maker happens to implement it, but a
+ * different LSP could too — so the tool names are LSP-agnostic (`lsp_*`),
+ * not `kaleidoswap_*`. The host's binder decides which LSP they reach.
+ *
+ * Every surface implements THESE EXACT tools, only the transport differs:
+ *   - mobile  → in-process handlers over the WDK LSP adapter
+ *   - desktop → HTTP / MCP / CLI handlers
+ *   - eval    → stub handlers
+ *
+ * `lsp_create_order` is a spend → confirmation-gated.
+ *
+ * Pure data — no deps, no fetch, RN-safe.
+ */
+import { InProcessToolSource } from '../tools/in-process.js';
+function t(name, description, properties = {}, required = [], spend = false) {
+    return {
+        name,
+        description,
+        spend,
+        requiresConfirmation: spend,
+        parameters: { type: 'object', properties, required },
+    };
+}
+/**
+ * The canonical LSPS1 tool list — agent-facing schemas. Each host's binder
+ * translates these args into the LSP's request body (LSPS1 JSON-RPC, the
+ * KaleidoSwap maker's REST routes, MCP, or a WDK adapter call).
+ */
+export const LSPS1_TOOLS = [
+    t('lsp_get_info', "Get the LSP's capabilities: minimum/maximum channel size, supported expiries, fee structure, accepted payment options. Use this before estimating or ordering a channel. No args."),
+    t('lsp_get_network_info', "Get the LSP's Lightning network info: pubkey, host, port, connect URI. Useful to display the counterparty or pre-connect a peer. No args."),
+    t('lsp_estimate_fees', "Estimate the fee for a channel order BEFORE committing. Returns the total cost in sats plus any LSP routing fee. Re-estimate rather than reusing a stale value.", {
+        lsp_balance_sat: { type: 'number', description: "Sats the LSP commits on their side (inbound capacity for the user)." },
+        client_balance_sat: { type: 'number', description: "Sats the user pre-funds into the channel (push amount). Often 0." },
+        channel_expiry_blocks: { type: 'number', description: 'Optional minimum lease in blocks. Defaults to the LSP minimum.' },
+    }, ['lsp_balance_sat']),
+    t('lsp_create_order', "Create a channel order. SPEND: confirmation-gated. Returns an order id + a Lightning invoice the user pays to lock the order. The channel opens only after payment.", {
+        lsp_balance_sat: { type: 'number', description: "Sats the LSP commits on their side (inbound capacity for the user)." },
+        client_balance_sat: { type: 'number', description: 'Sats the user pre-funds. Often 0.' },
+        channel_expiry_blocks: { type: 'number', description: 'Minimum lease in blocks. Defaults to LSP minimum from lsp_get_info.' },
+        refund_onchain_address: { type: 'string', description: 'Optional on-chain refund address if the LSP cannot open the channel.' },
+    }, ['lsp_balance_sat'], 
+    /* spend */ true),
+    t('lsp_get_order', 'Check the status of an LSPS1 order — pending / paid / opening / completed / failed. Poll after creating an order until the channel opens.', {
+        order_id: { type: 'string', description: 'The order id from lsp_create_order.' },
+    }, ['order_id']),
+];
+/** All LSPS1 tool names that move funds (confirmation-gated). */
+export const LSPS1_SPEND_TOOLS = new Set(LSPS1_TOOLS.filter((t) => t.spend).map((t) => t.name));
+export function isLsps1SpendTool(name) {
+    return LSPS1_SPEND_TOOLS.has(name);
+}
+export function getLsps1Tool(name) {
+    return LSPS1_TOOLS.find((t) => t.name === name);
+}
+/**
+ * Bind LSPS1 contract tools to in-process handlers → an InProcessToolSource.
+ *
+ *   const source = bindLsps1Tools({
+ *     lsp_get_info:        async () => makerLsp.getInfo(),
+ *     lsp_estimate_fees:   async (args) => makerLsp.estimateFees(args),
+ *     lsp_create_order:    async (args) => makerLsp.createOrder(args),
+ *     lsp_get_order:       async ({ order_id }) => makerLsp.getOrder(order_id),
+ *     lsp_get_network_info:async () => makerLsp.networkInfo(),
+ *   });
+ *   tools.register(source);
+ */
+export function bindLsps1Tools(handlers, opts = {}) {
+    const bound = [];
+    for (const def of LSPS1_TOOLS) {
+        const handler = handlers[def.name];
+        if (!handler) {
+            if (opts.allowMissing)
+                continue;
+            throw new Error(`bindLsps1Tools: no handler for "${def.name}"`);
+        }
+        bound.push({
+            name: def.name,
+            description: def.description,
+            parameters: def.parameters,
+            requiresConfirmation: def.requiresConfirmation,
+            handler,
+        });
+    }
+    return new InProcessToolSource(opts.id ?? 'lsps1', bound);
+}
+//# sourceMappingURL=contract.js.map

package/dist/lsps1/contract.js.map

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

package/dist/memory/store.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MemoryStore implementation — in-memory, with optional injected persistence
+ * and optional semantic ranking. Pure TS, zero deps.
+ *
+ *   const store = new InMemoryMemoryStore();                // ephemeral
+ *   const store = new InMemoryMemoryStore({ io });          // persisted (RN/Node)
+ *   const store = new InMemoryMemoryStore({ io, embed });   // + semantic recall
+ */
+import type { MemoryConsolidation, MemoryIO, MemoryItem, MemoryQuery, MemoryStore, NewMemory } from './types.js';
+export interface MemoryStoreOptions {
+    /** Persistence (load on first use, save on writes). Omit for ephemeral memory. */
+    io?: MemoryIO;
+    /** Embed text for semantic recall. Omit to fall back to substring matching. */
+    embed?: (text: string) => Promise<number[]>;
+    /**
+     * Fold near-duplicate writes into one item instead of appending. Needs `embed`.
+     * Omit for append-only. See {@link MemoryConsolidation}.
+     */
+    consolidate?: MemoryConsolidation;
+    /** Clock — injectable for deterministic tests. */
+    now?: () => number;
+}
+export declare class InMemoryMemoryStore implements MemoryStore {
+    private items;
+    private hydrated;
+    private counter;
+    private readonly io?;
+    private readonly embed?;
+    private readonly consolidate?;
+    private readonly now;
+    constructor(opts?: MemoryStoreOptions);
+    private hydrate;
+    private persist;
+    add(item: NewMemory): Promise<MemoryItem>;
+    all(): Promise<MemoryItem[]>;
+    search(query: MemoryQuery): Promise<MemoryItem[]>;
+    remove(id: string): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACV,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,+EAA+E;IAC/E,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C;;;OAGG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAW;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,IAAI,GAAE,kBAAuB;YAO3B,OAAO;YAaP,OAAO;IAIf,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IA8CzC,GAAG,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAK5B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAqCjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/memory/store.js

@@ -0,0 +1,143 @@
+/**
+ * MemoryStore implementation — in-memory, with optional injected persistence
+ * and optional semantic ranking. Pure TS, zero deps.
+ *
+ *   const store = new InMemoryMemoryStore();                // ephemeral
+ *   const store = new InMemoryMemoryStore({ io });          // persisted (RN/Node)
+ *   const store = new InMemoryMemoryStore({ io, embed });   // + semantic recall
+ */
+import { cosineSimilarity } from '../rag/vector-store.js';
+const DEFAULT_DEDUP_THRESHOLD = 0.92;
+export class InMemoryMemoryStore {
+    items = [];
+    hydrated = false;
+    counter = 0;
+    io;
+    embed;
+    consolidate;
+    now;
+    constructor(opts = {}) {
+        this.io = opts.io;
+        this.embed = opts.embed;
+        this.consolidate = opts.consolidate;
+        this.now = opts.now ?? (() => Date.now());
+    }
+    async hydrate() {
+        if (this.hydrated)
+            return;
+        this.hydrated = true;
+        if (this.io) {
+            try {
+                this.items = await this.io.load();
+                this.counter = this.items.length;
+            }
+            catch {
+                this.items = [];
+            }
+        }
+    }
+    async persist() {
+        if (this.io)
+            await this.io.save(this.items);
+    }
+    async add(item) {
+        await this.hydrate();
+        let text = item.text;
+        let embedding = item.embedding ?? (this.embed ? await this.embed(text).catch(() => undefined) : undefined);
+        let tags = item.tags;
+        let supersedeId;
+        // Consolidation: fold a same-kind near-duplicate into this write instead of
+        // appending — embedding-only by default, LLM rewrite when `merge` is set.
+        if (this.consolidate && embedding) {
+            const threshold = this.consolidate.threshold ?? DEFAULT_DEDUP_THRESHOLD;
+            let best;
+            for (const m of this.items) {
+                if (m.kind !== item.kind || !m.embedding)
+                    continue;
+                const score = cosineSimilarity(embedding, m.embedding);
+                if (!best || score > best.score)
+                    best = { item: m, score };
+            }
+            if (best && best.score >= threshold) {
+                supersedeId = best.item.id;
+                tags = unionTags(best.item.tags, item.tags);
+                if (this.consolidate.merge) {
+                    const merged = await this.consolidate.merge(best.item.text, text).catch(() => null);
+                    if (merged && merged.trim()) {
+                        text = merged.trim();
+                        if (this.embed)
+                            embedding = await this.embed(text).catch(() => embedding);
+                    }
+                }
+                // No merger → the incoming (newer) text supersedes the older item as-is.
+            }
+        }
+        const full = {
+            id: item.id ?? `mem_${this.now()}_${++this.counter}`,
+            text,
+            kind: item.kind,
+            tags,
+            createdAt: item.createdAt ?? this.now(),
+            ...(embedding ? { embedding } : {}),
+        };
+        if (supersedeId)
+            this.items = this.items.filter((m) => m.id !== supersedeId);
+        this.items.push(full);
+        await this.persist();
+        return full;
+    }
+    async all() {
+        await this.hydrate();
+        return [...this.items];
+    }
+    async search(query) {
+        await this.hydrate();
+        const limit = query.limit ?? 5;
+        let pool = this.items;
+        if (query.kind)
+            pool = pool.filter((m) => m.kind === query.kind);
+        if (query.tags?.length) {
+            pool = pool.filter((m) => query.tags.every((t) => m.tags?.includes(t)));
+        }
+        const text = query.text?.trim();
+        if (!text) {
+            // No query text → most recent first.
+            return [...pool].sort((a, b) => b.createdAt - a.createdAt).slice(0, limit);
+        }
+        // Semantic ranking when both the query and items are embedded.
+        if (this.embed && pool.some((m) => m.embedding)) {
+            const qv = await this.embed(text).catch(() => null);
+            if (qv) {
+                return [...pool]
+                    .map((m) => ({ m, score: m.embedding ? cosineSimilarity(qv, m.embedding) : -1 }))
+                    .sort((a, b) => b.score - a.score)
+                    .slice(0, limit)
+                    .map((x) => x.m);
+            }
+        }
+        // Fallback: substring score + recency.
+        const q = text.toLowerCase();
+        return [...pool]
+            .map((m) => ({ m, hit: m.text.toLowerCase().includes(q) ? 1 : 0 }))
+            .sort((a, b) => b.hit - a.hit || b.m.createdAt - a.m.createdAt)
+            .slice(0, limit)
+            .map((x) => x.m);
+    }
+    async remove(id) {
+        await this.hydrate();
+        this.items = this.items.filter((m) => m.id !== id);
+        await this.persist();
+    }
+    async clear() {
+        await this.hydrate();
+        this.items = [];
+        await this.persist();
+    }
+}
+/** Merge two optional tag lists, de-duplicated. Returns undefined when both empty. */
+function unionTags(a, b) {
+    if (!a?.length && !b?.length)
+        return undefined;
+    return [...new Set([...(a ?? []), ...(b ?? [])])];
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAU1D,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAgBrC,MAAM,OAAO,mBAAmB;IACtB,KAAK,GAAiB,EAAE,CAAC;IACzB,QAAQ,GAAG,KAAK,CAAC;IACjB,OAAO,GAAG,CAAC,CAAC;IACH,EAAE,CAAY;IACd,KAAK,CAAuC;IAC5C,WAAW,CAAuB;IAClC,GAAG,CAAe;IAEnC,YAAY,OAA2B,EAAE;QACvC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5C,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;gBAClC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAe;QACvB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,IAAI,SAAS,GACX,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC7F,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,IAAI,WAA+B,CAAC;QAEpC,4EAA4E;QAC5E,0EAA0E;QAC1E,IAAI,IAAI,CAAC,WAAW,IAAI,SAAS,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,IAAI,uBAAuB,CAAC;YACxE,IAAI,IAAqD,CAAC;YAC1D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC3B,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS;oBAAE,SAAS;gBACnD,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;gBACvD,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK;oBAAE,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;YAC7D,CAAC;YACD,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;gBACpC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5C,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;oBAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;oBACpF,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;wBAC5B,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;wBACrB,IAAI,IAAI,CAAC,KAAK;4BAAE,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBAC5E,CAAC;gBACH,CAAC;gBACD,yEAAyE;YAC3E,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAe;YACvB,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;YACpD,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;YACvC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpC,CAAC;QACF,IAAI,WAAW;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;QAC7E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAkB;QAC7B,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QAE/B,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACtB,IAAI,KAAK,CAAC,IAAI;YAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YACvB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,qCAAqC;YACrC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC7E,CAAC;QAED,+DAA+D;QAC/D,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,EAAE,EAAE,CAAC;gBACP,OAAO,CAAC,GAAG,IAAI,CAAC;qBACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;qBAChF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;qBACjC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;qBACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,IAAI,CAAC;aACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aAClE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;aAC9D,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;CACF;AAED,sFAAsF;AACtF,SAAS,SAAS,CAAC,CAAY,EAAE,CAAY;IAC3C,IAAI,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM;QAAE,OAAO,SAAS,CAAC;IAC/C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/memory/tool.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Memory tool source — lets the agent persist and recall things across
+ * sessions (`remember`, `recall`). Pairs with auto-recall in the
+ * ContextBuilder; this is the explicit, agent-driven side.
+ */
+import type { ToolSource } from '../tools/source.js';
+import type { MemoryStore } from './types.js';
+export declare function createMemoryToolSource(store: MemoryStore): ToolSource;
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/memory/tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,YAAY,CAAC;AAM1D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CA6DrE"}

package/dist/memory/tool.js

@@ -0,0 +1,70 @@
+/**
+ * Memory tool source — lets the agent persist and recall things across
+ * sessions (`remember`, `recall`). Pairs with auto-recall in the
+ * ContextBuilder; this is the explicit, agent-driven side.
+ */
+const REMEMBER = 'remember';
+const RECALL = 'recall';
+const KINDS = ['fact', 'preference', 'event', 'note'];
+export function createMemoryToolSource(store) {
+    const tools = [
+        {
+            name: REMEMBER,
+            description: 'Save something to long-term memory so you recall it in future sessions ' +
+                '— a user preference, a fact, or an event. Use sparingly for durable info.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    text: { type: 'string', description: 'What to remember (a short sentence)' },
+                    kind: { type: 'string', enum: KINDS, description: 'fact | preference | event | note' },
+                    tags: { type: 'array', items: { type: 'string' }, description: 'Optional tags' },
+                },
+                required: ['text'],
+            },
+        },
+        {
+            name: RECALL,
+            description: 'Search your long-term memory for what you know about something before answering.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'What to recall' },
+                    limit: { type: 'number', description: 'Max items (default 5)' },
+                },
+                required: ['query'],
+            },
+        },
+    ];
+    async function execute(name, args) {
+        if (name === REMEMBER) {
+            const text = String(args.text ?? '').trim();
+            if (!text)
+                throw new Error('remember: text is required');
+            const kind = KINDS.includes(String(args.kind))
+                ? args.kind
+                : 'note';
+            const tags = Array.isArray(args.tags) ? args.tags.map(String) : undefined;
+            const item = await store.add({ text, kind, tags });
+            return `Remembered (${item.kind}): ${item.text}`;
+        }
+        if (name === RECALL) {
+            const query = String(args.query ?? '').trim();
+            if (!query)
+                throw new Error('recall: query is required');
+            const limit = Number(args.limit) > 0 ? Number(args.limit) : 5;
+            const items = await store.search({ text: query, limit });
+            if (items.length === 0)
+                return 'Nothing relevant in memory.';
+            return items.map((m) => `- (${m.kind}) ${m.text}`).join('\n');
+        }
+        throw new Error(`memory: unknown tool ${name}`);
+    }
+    const names = new Set([REMEMBER, RECALL]);
+    return {
+        id: 'memory',
+        listTools: () => tools,
+        has: (name) => names.has(name),
+        execute,
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/memory/tool.js.map

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