@kaleidorg/mind 0.2.0 → 0.4.0

package/dist/knowledge/btc-map.js

@@ -0,0 +1,365 @@
+/**
+ * BTC Map tool source — exposes `find_merchant_locations` and
+ * `get_merchant_info` so the agent can answer "where can I spend Bitcoin
+ * near me?" using the SAME tool names on every surface.
+ *
+ *   - mobile  → injects device GPS + a live BTC Map fetch
+ *   - desktop → injects a live fetch (or a server-side cache)
+ *   - eval / playground → no injection, falls back to the bundled offline list
+ *
+ * Pure data + orchestration — NO network in core. The host injects the
+ * `location` resolver and the `fetch` adapter; without them the source still
+ * runs against an offline `Merchant[]` so the skill is never dead on arrival.
+ *
+ * The result shape mirrors what rate's host returns today, so a mobile host
+ * can swap its bespoke merchant tools for this factory verbatim.
+ */
+const FIND = 'find_merchant_locations';
+const INFO = 'get_merchant_info';
+/** A tiny, hand-curated sample so the skill works offline out of the box. */
+export const BTC_MAP_SAMPLE = [
+    {
+        id: 'lugano-bitcoinpeople-cafe',
+        name: 'Bitcoin People Café',
+        category: 'cafe',
+        address: 'Via Pessina 12',
+        city: 'Lugano',
+        lat: 46.0037,
+        lng: 8.9511,
+        acceptedAssets: ['lightning', 'onchain'],
+        description: 'Specialty espresso bar; Plan ₿ Lugano partner.',
+    },
+    {
+        id: 'lugano-bistro-libertine',
+        name: 'Bistro Libertine',
+        category: 'restaurant',
+        address: 'Piazza della Riforma 3',
+        city: 'Lugano',
+        lat: 46.004,
+        lng: 8.952,
+        acceptedAssets: ['lightning', 'usdt', 'onchain'],
+        description: 'Italian-Swiss bistro, lunch + dinner. Accepts Tether on Liquid.',
+    },
+    {
+        id: 'lugano-bookshop-volta',
+        name: 'Libreria Volta',
+        category: 'shop',
+        address: 'Via Cattedrale 8',
+        city: 'Lugano',
+        lat: 46.0055,
+        lng: 8.9499,
+        acceptedAssets: ['lightning'],
+        description: 'Independent bookshop; Italian, English and German titles.',
+    },
+    {
+        id: 'lisbon-meson-andaluz',
+        name: 'Mesón Andaluz',
+        category: 'restaurant',
+        address: 'Rua das Flores 42',
+        city: 'Lisbon',
+        lat: 38.71,
+        lng: -9.143,
+        acceptedAssets: ['lightning', 'onchain'],
+        description: 'Andalusian tapas in Chiado. Bitcoin accepted since 2022.',
+    },
+    {
+        id: 'lisbon-surf-bitcoin',
+        name: 'Surf & Sats',
+        category: 'shop',
+        address: 'Av. da Liberdade 180',
+        city: 'Lisbon',
+        lat: 38.7211,
+        lng: -9.1466,
+        acceptedAssets: ['lightning'],
+        description: 'Surfboard rental and lessons in Costa da Caparica.',
+    },
+    {
+        id: 'sansalvador-elzonte-hope',
+        name: 'Hope House El Zonte',
+        category: 'cafe',
+        address: 'Calle Principal',
+        city: 'El Zonte',
+        lat: 13.492,
+        lng: -89.4395,
+        acceptedAssets: ['lightning', 'onchain'],
+        description: 'Bitcoin Beach hub. Coffee, community, and a Lightning ATM.',
+    },
+    {
+        id: 'sansalvador-elzonte-garten',
+        name: 'Garten Restaurante',
+        category: 'restaurant',
+        address: 'Bitcoin Beach',
+        city: 'El Zonte',
+        lat: 13.4925,
+        lng: -89.438,
+        acceptedAssets: ['lightning'],
+        description: 'Beachfront restaurant, full Bitcoin payments since 2021.',
+    },
+    {
+        id: 'nyc-pubkey',
+        name: 'PubKey',
+        category: 'bar',
+        address: '85 Washington Pl',
+        city: 'New York',
+        lat: 40.732,
+        lng: -73.999,
+        acceptedAssets: ['lightning', 'onchain'],
+        description: 'Bitcoin bar in Greenwich Village — meetups, Lightning tap.',
+    },
+    {
+        id: 'prague-paralelni-polis',
+        name: 'Paralelní Polis',
+        category: 'cafe',
+        address: 'Dělnická 43',
+        city: 'Prague',
+        lat: 50.105,
+        lng: 14.448,
+        acceptedAssets: ['lightning', 'onchain', 'monero'],
+        description: 'Crypto-only café and hackerspace — no fiat accepted, ever.',
+    },
+    {
+        id: 'amsterdam-bitcoin-embassy',
+        name: 'Bitcoin Embassy Amsterdam',
+        category: 'cafe',
+        address: 'Nieuwezijds Voorburgwal 162',
+        city: 'Amsterdam',
+        lat: 52.374,
+        lng: 4.893,
+        acceptedAssets: ['lightning', 'onchain'],
+        description: 'Co-working café and meetup hub, Lightning tap on draft beer.',
+    },
+];
+/** Clamp a value to a numeric range, returning the default when input is bad. */
+function clamp(n, lo, hi, dflt) {
+    const v = Number(n);
+    if (!Number.isFinite(v))
+        return dflt;
+    return Math.min(hi, Math.max(lo, v));
+}
+/** Substring scoring used by the offline fallback (matches the old behavior). */
+function fuzzyScore(query, text) {
+    const q = query.toLowerCase();
+    const t = text.toLowerCase();
+    if (!q)
+        return 1;
+    if (t.includes(q))
+        return 1;
+    let hits = 0;
+    let qi = 0;
+    for (let i = 0; i < t.length && qi < q.length; i++) {
+        if (t[i] === q[qi]) {
+            hits++;
+            qi++;
+        }
+    }
+    return hits / q.length;
+}
+/** Map a Merchant → the response row the model sees (stable for rate parity). */
+function row(m) {
+    return {
+        id: m.id,
+        name: m.name,
+        address: m.address,
+        category: m.category,
+        lat: m.lat,
+        lng: m.lng,
+        distance_m: m.distance_m,
+        phone: m.phone,
+        website: m.website,
+        opening_hours: m.opening_hours,
+        accepts_bitcoin: m.acceptedAssets?.includes('onchain') ?? true,
+        accepts_lightning: m.acceptedAssets?.includes('lightning') ?? true,
+    };
+}
+/** Offline search: substring + optional category over the bundled list. */
+function searchOffline(merchants, query, category, limit) {
+    let filtered = merchants;
+    if (category) {
+        const c = category.toLowerCase().trim();
+        filtered = filtered.filter((m) => (m.category ?? '').toLowerCase() === c);
+    }
+    const q = (query ?? '').trim();
+    if (q.length >= 2) {
+        filtered = filtered
+            .map((m) => {
+            const hay = `${m.name ?? ''} ${m.description ?? ''} ${m.address ?? ''} ${m.city ?? ''}`;
+            const score = fuzzyScore(q, m.name ?? '') * 3 +
+                fuzzyScore(q, m.address ?? '') * 2 +
+                fuzzyScore(q, hay) * 1;
+            return { m, score };
+        })
+            .filter((x) => x.score > 0.3)
+            .sort((a, b) => b.score - a.score)
+            .map((x) => x.m);
+    }
+    return filtered.slice(0, limit);
+}
+/**
+ * Build a ToolSource exposing `find_merchant_locations` + `get_merchant_info`.
+ *
+ * Resolution order for `find_merchant_locations`:
+ *   1. `near_address` provided → opts.location.geocode → opts.fetch (live)
+ *   2. opts.location.getCurrent → opts.fetch (live)
+ *   3. fall through to offline substring search over opts.offlineMerchants
+ *
+ * Any step that fails silently falls through to the next, so the skill is
+ * always answerable.
+ */
+export function createBtcMapToolSource(opts = {}) {
+    const offline = opts.offlineMerchants ?? BTC_MAP_SAMPLE;
+    const defaultLimit = opts.k ?? 10;
+    const find = {
+        name: FIND,
+        description: "Find Bitcoin-accepting merchants near the user using live BTC Map data " +
+            "and the device's real location when available. Use when the user wants " +
+            'merchants, shops, restaurants, cafes, bars, ATMs, or places to spend ' +
+            'Bitcoin nearby. Pass ONLY the fields the user actually named — do not ' +
+            'invent constraints (e.g. omit `query` when they just say "near me").',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Optional filter for merchant name or type, e.g. "coffee"' },
+                category: { type: 'string', description: 'restaurant | cafe | bar | shop | grocery | lodging | atm' },
+                near_address: { type: 'string', description: 'Address/city to search around instead of the current location' },
+                radius_km: { type: 'number', description: 'Search radius in km (0.25–50, default 5)' },
+                limit: { type: 'number', description: 'Max number of results (1–20, default 10)' },
+            },
+        },
+    };
+    const info = {
+        name: INFO,
+        description: 'Get detailed information about one specific merchant by id or name — ' +
+            'full address, accepted assets, contact details. Use after ' +
+            'find_merchant_locations when the user asks for more on a specific result.',
+        parameters: {
+            type: 'object',
+            properties: {
+                merchant_id: { type: 'string', description: 'Merchant id from find_merchant_locations (string or number)' },
+                merchant_name: { type: 'string', description: 'Merchant name (used when id is unknown)' },
+            },
+        },
+    };
+    async function tryLive(center, radiusMeters, query, category, limit) {
+        if (!opts.fetch)
+            return null;
+        try {
+            return await opts.fetch({
+                center: { lat: center.lat, lng: center.lng },
+                radiusMeters,
+                query,
+                category,
+                limit,
+            });
+        }
+        catch {
+            return null;
+        }
+    }
+    async function resolveCenter(near_address) {
+        if (!opts.location)
+            return null;
+        if (near_address && near_address.trim().length >= 2 && opts.location.geocode) {
+            try {
+                const pt = await opts.location.geocode(near_address);
+                if (pt)
+                    return { ...pt, label: near_address, precise: false };
+            }
+            catch {
+                /* fall through */
+            }
+        }
+        try {
+            return await opts.location.getCurrent();
+        }
+        catch {
+            return null;
+        }
+    }
+    async function findLocations(args) {
+        const query = args.query ? String(args.query) : undefined;
+        const category = args.category ? String(args.category) : undefined;
+        const near_address = args.near_address ? String(args.near_address) : undefined;
+        const radius_km = clamp(args.radius_km, 0.25, 50, 5);
+        const limit = clamp(args.limit, 1, 20, defaultLimit);
+        const radiusMeters = radius_km * 1000;
+        // 1 + 2. Try the live path when we can.
+        const center = await resolveCenter(near_address);
+        if (center) {
+            const live = await tryLive(center, radiusMeters, query, category, limit);
+            if (live) {
+                const where = center.label || (center.precise ? 'your location' : 'the default location');
+                return {
+                    success: true,
+                    source: 'btcmap',
+                    precise_location: !!center.precise,
+                    center: { lat: center.lat, lng: center.lng },
+                    merchants: live.map(row),
+                    total_found: live.length,
+                    message: live.length > 0
+                        ? `Found ${live.length} Bitcoin merchant${live.length === 1 ? '' : 's'} near ${where}${query ? ` matching "${query}"` : ''}.`
+                        : `No Bitcoin merchants found within ${radius_km} km of ${where}. Try widening the radius.`,
+                };
+            }
+        }
+        // 3. Offline fallback.
+        const found = searchOffline(offline, query, category, limit);
+        return {
+            success: true,
+            source: 'offline',
+            precise_location: false,
+            merchants: found.map(row),
+            total_found: found.length,
+            message: found.length > 0
+                ? `Showing ${found.length} merchant${found.length === 1 ? '' : 's'} from the offline list${query ? ` matching "${query}"` : ''}.`
+                : `No merchants in the offline list matched${query ? ` "${query}"` : ''}. The host hasn't injected a live BTC Map fetch.`,
+        };
+    }
+    async function getInfo(args) {
+        const idArg = args.merchant_id;
+        const nameArg = args.merchant_name ? String(args.merchant_name).trim() : '';
+        let m;
+        if (idArg !== undefined && idArg !== null && idArg !== '') {
+            const want = String(idArg);
+            m = offline.find((x) => String(x.id) === want);
+        }
+        if (!m && nameArg.length >= 2) {
+            const q = nameArg.toLowerCase();
+            m =
+                offline.find((x) => (x.name ?? '').toLowerCase() === q) ??
+                    offline
+                        .map((x) => ({ x, score: fuzzyScore(q, (x.name ?? '').toLowerCase()) }))
+                        .filter((r) => r.score > 0.5)
+                        .sort((a, b) => b.score - a.score)[0]?.x;
+        }
+        if (!m) {
+            const suggestions = nameArg
+                ? offline
+                    .map((x) => ({ name: x.name ?? '', score: fuzzyScore(nameArg.toLowerCase(), (x.name ?? '').toLowerCase()) }))
+                    .filter((r) => r.score > 0.3)
+                    .sort((a, b) => b.score - a.score)
+                    .slice(0, 3)
+                    .map((r) => r.name)
+                : [];
+            return {
+                success: false,
+                error: `Could not find merchant${nameArg ? ` "${nameArg}"` : idArg !== undefined ? ` with id ${idArg}` : ''}.`,
+                suggestions: suggestions.length ? suggestions : undefined,
+            };
+        }
+        return { success: true, merchant: { ...row(m), city: m.city } };
+    }
+    async function execute(name, args) {
+        if (name === FIND)
+            return findLocations(args);
+        if (name === INFO)
+            return getInfo(args);
+        throw new Error(`btc-map: unknown tool "${name}"`);
+    }
+    return {
+        id: 'btc-map',
+        listTools: () => [find, info],
+        has: (name) => name === FIND || name === INFO,
+        execute,
+    };
+}
+//# sourceMappingURL=btc-map.js.map

package/dist/knowledge/btc-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"btc-map.js","sourceRoot":"","sources":["../../src/knowledge/btc-map.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

@@ -6,12 +6,17 @@
  *   const store = new InMemoryMemoryStore({ io });          // persisted (RN/Node)
  *   const store = new InMemoryMemoryStore({ io, embed });   // + semantic recall
  */
-import type { MemoryIO, MemoryItem, MemoryQuery, MemoryStore, NewMemory } from './types.js';
+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;
 }
@@ -21,6 +26,7 @@ export declare class InMemoryMemoryStore implements MemoryStore {
     private counter;
     private readonly io?;
     private readonly embed?;
+    private readonly consolidate?;
     private readonly now;
     constructor(opts?: MemoryStoreOptions);
     private hydrate;

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,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,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,GAAG,CAAe;gBAEvB,IAAI,GAAE,kBAAuB;YAM3B,OAAO;YAaP,OAAO;IAIf,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBzC,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"}
+{"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

@@ -7,16 +7,19 @@
  *   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() {
@@ -39,15 +42,46 @@ export class InMemoryMemoryStore {
     }
     async add(item) {
         await this.hydrate();
-        const embedding = item.embedding ?? (this.embed ? await this.embed(item.text).catch(() => undefined) : undefined);
+        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: item.text,
+            text,
             kind: item.kind,
-            tags: item.tags,
+            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;
@@ -100,4 +134,10 @@ export class InMemoryMemoryStore {
         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