@kaleidorg/mind 0.1.0 → 0.3.0

package/dist/knowledge/bitcoin-copilot.js

@@ -0,0 +1,155 @@
+/**
+ * Bitcoin-copilot knowledge pack — a curated, on-brand corpus to RAG over so an
+ * on-device assistant can answer Bitcoin / Lightning / RGB / KaleidoSwap
+ * questions privately. Ship it, ingest it with a Retriever, done.
+ *
+ * Concise + accurate. Extend or replace with your own docs (BOLT specs, RGB
+ * docs, app help, FAQs) — the format is just `RagDocument[]`.
+ */
+export const BITCOIN_COPILOT_DOCS = [
+    {
+        id: 'inbound-liquidity',
+        text: 'To RECEIVE Lightning payments you need inbound liquidity — remote balance ' +
+            'on a channel pointing at you. Brand-new wallets have none, so they can ' +
+            'send but not receive. Get inbound liquidity by buying a channel from an ' +
+            'LSP, or by receiving an on-chain deposit and swapping it into a channel.',
+        metadata: { topic: 'liquidity' },
+    },
+    {
+        id: 'outbound-liquidity',
+        text: 'Outbound liquidity is your local balance on a channel — what you can ' +
+            'spend over Lightning. You get it by funding a channel yourself or being ' +
+            'pushed funds. If you can receive but not send, you lack outbound liquidity.',
+        metadata: { topic: 'liquidity' },
+    },
+    {
+        id: 'channel-basics',
+        text: 'A Lightning channel is a 2-of-2 multisig funding output shared by two ' +
+            'peers. It lets them send instant, low-fee payments off-chain by updating ' +
+            'who owns how much, without touching the blockchain until the channel closes.',
+        metadata: { topic: 'lightning' },
+    },
+    {
+        id: 'onchain-vs-lightning',
+        text: 'On-chain Bitcoin transactions settle directly on the blockchain: final, ' +
+            'but slower and with miner fees. Lightning payments are instant and cheap ' +
+            'but require channels with liquidity. Use Lightning for spending, on-chain ' +
+            'for settlement and for funding channels.',
+        metadata: { topic: 'lightning' },
+    },
+    {
+        id: 'open-channel',
+        text: 'Opening a channel funds a 2-of-2 output on-chain; it confirms in one or ' +
+            'more blocks (or is usable immediately with 0-conf if the peer allows). ' +
+            'The funder gets outbound liquidity. To get inbound, buy a channel from an ' +
+            'LSP instead of opening your own.',
+        metadata: { topic: 'channels' },
+    },
+    {
+        id: 'lsp-lsps1',
+        text: 'An LSP (Lightning Service Provider) sells channels. With LSPS1 you place ' +
+            'a channel order: choose capacity and how much inbound liquidity you want, ' +
+            'pay the fee, and the LSP opens a channel to you — often 0-conf, so you can ' +
+            'receive right away. KaleidoSwap acts as an LSP.',
+        metadata: { topic: 'channels' },
+    },
+    {
+        id: 'atomic-swap',
+        text: 'An atomic (HTLC) swap exchanges two assets so that either both legs ' +
+            'happen or neither does — no counterparty can run off with your funds. ' +
+            'KaleidoSwap uses a 5-step HTLC taker flow for trustless swaps.',
+        metadata: { topic: 'swaps' },
+    },
+    {
+        id: 'submarine-swap',
+        text: 'A submarine swap moves value between on-chain Bitcoin and Lightning ' +
+            'atomically via an HTLC: send on-chain BTC and receive it on Lightning, or ' +
+            'vice-versa, with no custodian. Useful to refill inbound/outbound liquidity.',
+        metadata: { topic: 'swaps' },
+    },
+    {
+        id: 'rgb-assets',
+        text: 'RGB is a protocol for issuing assets — like USDT and XAUT — on top of ' +
+            'Bitcoin and Lightning. Validation is client-side, which keeps it private ' +
+            'and scalable. On KaleidoSwap you can hold and swap RGB assets.',
+        metadata: { topic: 'rgb' },
+    },
+    {
+        id: 'colored-channels',
+        text: 'A colored channel is a Lightning channel that also carries an RGB asset ' +
+            'balance, so you can send/receive USDT or XAUT over Lightning instantly. ' +
+            'Buying an asset channel from the LSP gives you inbound capacity for that asset.',
+        metadata: { topic: 'rgb' },
+    },
+    {
+        id: 'rgb-invoice',
+        text: 'An RGB invoice requests a specific asset and amount and includes a ' +
+            'blinded UTXO so the sender can transfer the asset privately. It differs ' +
+            'from a plain Lightning (BOLT11) invoice, which is for BTC.',
+        metadata: { topic: 'rgb' },
+    },
+    {
+        id: 'rfq-quote',
+        text: 'Before a swap, KaleidoSwap gives a quote via RFQ (request for quote): the ' +
+            'maker prices the pair (e.g. BTC/USDT) and returns the amount you will ' +
+            'receive and the fees. Quotes expire — re-quote if you wait.',
+        metadata: { topic: 'trading' },
+    },
+    {
+        id: 'maker-taker',
+        text: 'KaleidoSwap is maker-based: a maker provides liquidity and prices, you ' +
+            'are the taker who accepts a quote and executes the atomic swap. The maker ' +
+            'also runs the LSP that sells channels.',
+        metadata: { topic: 'trading' },
+    },
+    {
+        id: 'mpp',
+        text: 'Multi-path payments (MPP) split one Lightning payment across several ' +
+            'channels/routes so you can send more than any single channel allows. The ' +
+            'parts recombine at the destination atomically.',
+        metadata: { topic: 'lightning' },
+    },
+    {
+        id: 'lightning-fees',
+        text: 'Lightning fees are tiny: a base fee plus a proportional fee per hop, paid ' +
+            'to routing nodes. They are far smaller than on-chain miner fees, which is ' +
+            'why Lightning suits everyday spending.',
+        metadata: { topic: 'fees' },
+    },
+    {
+        id: 'zero-conf',
+        text: '0-conf (zero-confirmation) means a channel is usable before its funding ' +
+            'transaction is mined. It relies on trusting the channel partner not to ' +
+            'double-spend; LSPs commonly offer it so you can receive instantly.',
+        metadata: { topic: 'channels' },
+    },
+    {
+        id: 'seed-backup',
+        text: 'Your seed phrase (12/24 words) controls your funds. Write it down offline ' +
+            'and never share or photograph it. A KaleidoSwap node also needs channel ' +
+            'state backups: losing them can mean losing funds in open channels.',
+        metadata: { topic: 'security' },
+    },
+    {
+        id: 'receiving',
+        text: 'To receive: share a Lightning invoice (BOLT11) or an on-chain address. ' +
+            'For Lightning you need inbound liquidity first. For RGB assets, share an ' +
+            'RGB invoice. On-chain always works but is slower.',
+        metadata: { topic: 'usage' },
+    },
+    {
+        id: 'sending',
+        text: 'To send: pay a Lightning invoice or a Lightning address for BTC, or use ' +
+            'an on-chain address. You need outbound liquidity for Lightning. Always ' +
+            'check the amount and destination before paying.',
+        metadata: { topic: 'usage' },
+    },
+    {
+        id: 'dca',
+        text: 'Dollar-cost averaging (DCA) buys a fixed amount on a schedule to smooth ' +
+            'out price swings. KaleidoSwap can automate recurring swaps so you ' +
+            'accumulate BTC or an asset over time without timing the market.',
+        metadata: { topic: 'trading' },
+    },
+];
+//# sourceMappingURL=bitcoin-copilot.js.map

package/dist/knowledge/bitcoin-copilot.js.map

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

package/dist/knowledge/btc-map.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 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.
+ */
+import type { ToolSource } from '../tools/source.js';
+import type { Merchant } from './merchants.js';
+/** A geographic point + optional human label. */
+export interface LatLng {
+    lat: number;
+    lng: number;
+    /** Optional "Lugano, Switzerland" style label for messages. */
+    label?: string;
+    /** True when the location came from the device GPS, false for a default/fallback. */
+    precise?: boolean;
+}
+/**
+ * Host-injected location resolver. Core is platform-agnostic — RN has GPS,
+ * Node typically doesn't. When omitted, `find_merchant_locations` falls back
+ * to the offline merchant list.
+ */
+export interface LocationProvider {
+    /** Resolve "near me" — the device location, or null if unavailable. */
+    getCurrent(): Promise<LatLng | null>;
+    /** Optional: geocode a free-text address ("Via Pessina 12, Lugano"). */
+    geocode?(address: string): Promise<LatLng | null>;
+}
+/** A merchant returned by a live BTC Map fetch. */
+export interface BtcMapMerchant extends Merchant {
+    /** Distance from the search centre, metres. */
+    distance_m?: number;
+    /** Free-text contact extras the model can surface to the user. */
+    phone?: string;
+    website?: string;
+    opening_hours?: string;
+}
+/**
+ * Host-injected live-fetch adapter. Receives a normalized query and returns
+ * the matching merchants. The host is responsible for the HTTP call, caching,
+ * and any rate limits — core never reaches the network.
+ */
+export type BtcMapFetch = (q: {
+    center: {
+        lat: number;
+        lng: number;
+    };
+    radiusMeters: number;
+    query?: string;
+    category?: string;
+    limit: number;
+}) => Promise<BtcMapMerchant[]>;
+export interface BtcMapToolOptions {
+    /** Resolve "near me" + geocode an address. RN hosts inject Expo Location. */
+    location?: LocationProvider;
+    /** Hit a live BTC Map (or your own cache). Host-injected — no network in core. */
+    fetch?: BtcMapFetch;
+    /** Offline list used when no location/fetch is available. Defaults to BTC_MAP_SAMPLE. */
+    offlineMerchants?: Merchant[];
+    /** Default for `limit` when the caller doesn't set one. Default 10. */
+    k?: number;
+}
+/** A tiny, hand-curated sample so the skill works offline out of the box. */
+export declare const BTC_MAP_SAMPLE: Merchant[];
+/**
+ * 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 declare function createBtcMapToolSource(opts?: BtcMapToolOptions): ToolSource;
+//# sourceMappingURL=btc-map.d.ts.map

package/dist/knowledge/btc-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"btc-map.d.ts","sourceRoot":"","sources":["../../src/knowledge/btc-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK/C,iDAAiD;AACjD,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrC,wEAAwE;IACxE,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACnD;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE;IAC5B,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;AAEhC,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,kFAAkF;IAClF,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,yFAAyF;IACzF,gBAAgB,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC9B,uEAAuE;IACvE,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,6EAA6E;AAC7E,eAAO,MAAM,cAAc,EAAE,QAAQ,EA+GpC,CAAC;AA0EF;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,iBAAsB,GAAG,UAAU,CAwK/E"}

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":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,MAAM,IAAI,GAAG,yBAAyB,CAAC;AACvC,MAAM,IAAI,GAAG,mBAAmB,CAAC;AA0DjC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC;QACE,EAAE,EAAE,2BAA2B;QAC/B,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,gBAAgB;QACzB,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,MAAM;QACX,cAAc,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;QACxC,WAAW,EAAE,gDAAgD;KAC9D;IACD;QACE,EAAE,EAAE,yBAAyB;QAC7B,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,wBAAwB;QACjC,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,MAAM;QACX,GAAG,EAAE,KAAK;QACV,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC;QAChD,WAAW,EAAE,iEAAiE;KAC/E;IACD;QACE,EAAE,EAAE,uBAAuB;QAC3B,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,MAAM;QACX,cAAc,EAAE,CAAC,WAAW,CAAC;QAC7B,WAAW,EAAE,2DAA2D;KACzE;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,mBAAmB;QAC5B,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,CAAC,KAAK;QACX,cAAc,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;QACxC,WAAW,EAAE,0DAA0D;KACxE;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,sBAAsB;QAC/B,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,CAAC,MAAM;QACZ,cAAc,EAAE,CAAC,WAAW,CAAC;QAC7B,WAAW,EAAE,oDAAoD;KAClE;IACD;QACE,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,iBAAiB;QAC1B,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,MAAM;QACX,GAAG,EAAE,CAAC,OAAO;QACb,cAAc,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;QACxC,WAAW,EAAE,4DAA4D;KAC1E;IACD;QACE,EAAE,EAAE,4BAA4B;QAChC,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,eAAe;QACxB,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,CAAC,MAAM;QACZ,cAAc,EAAE,CAAC,WAAW,CAAC;QAC7B,WAAW,EAAE,0DAA0D;KACxE;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,MAAM;QACX,GAAG,EAAE,CAAC,MAAM;QACZ,cAAc,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;QACxC,WAAW,EAAE,4DAA4D;KAC1E;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,MAAM;QACX,GAAG,EAAE,MAAM;QACX,cAAc,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC;QAClD,WAAW,EAAE,4DAA4D;KAC1E;IACD;QACE,EAAE,EAAE,2BAA2B;QAC/B,IAAI,EAAE,2BAA2B;QACjC,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,6BAA6B;QACtC,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,MAAM;QACX,GAAG,EAAE,KAAK;QACV,cAAc,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;QACxC,WAAW,EAAE,8DAA8D;KAC5E;CACF,CAAC;AAEF,iFAAiF;AACjF,SAAS,KAAK,CAAC,CAAU,EAAE,EAAU,EAAE,EAAU,EAAE,IAAY;IAC7D,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,iFAAiF;AACjF,SAAS,UAAU,CAAC,KAAa,EAAE,IAAY;IAC7C,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,IAAI,EAAE,CAAC;YACP,EAAE,EAAE,CAAC;QACP,CAAC;IACH,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;AACzB,CAAC;AAED,iFAAiF;AACjF,SAAS,GAAG,CAAC,CAAiB;IAC5B,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,eAAe,EAAE,CAAC,CAAC,cAAc,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI;QAC9D,iBAAiB,EAAE,CAAC,CAAC,cAAc,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI;KACnE,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,SAAS,aAAa,CACpB,SAAqB,EACrB,KAAyB,EACzB,QAA4B,EAC5B,KAAa;IAEb,IAAI,QAAQ,GAAG,SAAS,CAAC;IACzB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACxC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAClB,QAAQ,GAAG,QAAQ;aAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,WAAW,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;YACxF,MAAM,KAAK,GACT,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC;gBAC/B,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,CAAC;gBAClC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC;aACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC;aAC5B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA0B,EAAE;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,IAAI,cAAc,CAAC;IACxD,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAElC,MAAM,IAAI,GAAY;QACpB,IAAI,EAAE,IAAI;QACV,WAAW,EACT,yEAAyE;YACzE,yEAAyE;YACzE,uEAAuE;YACvE,wEAAwE;YACxE,sEAAsE;QACxE,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0DAA0D,EAAE;gBAClG,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0DAA0D,EAAE;gBACrG,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;gBAC9G,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;gBACtF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;aACnF;SACF;KACF,CAAC;IAEF,MAAM,IAAI,GAAY;QACpB,IAAI,EAAE,IAAI;QACV,WAAW,EACT,uEAAuE;YACvE,4DAA4D;YAC5D,2EAA2E;QAC7E,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;gBAC3G,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;aAC1F;SACF;KACF,CAAC;IAEF,KAAK,UAAU,OAAO,CACpB,MAAc,EACd,YAAoB,EACpB,KAAyB,EACzB,QAA4B,EAC5B,KAAa;QAEb,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC;gBACtB,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;gBAC5C,YAAY;gBACZ,KAAK;gBACL,QAAQ;gBACR,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,UAAU,aAAa,CAAC,YAAgC;QAC3D,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,YAAY,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC7E,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBACrD,IAAI,EAAE;oBAAE,OAAO,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,UAAU,aAAa,CAAC,IAA6B;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC;QAEtC,wCAAwC;QACxC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YACzE,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;gBAC1F,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,QAAQ;oBAChB,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO;oBAClC,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE;oBAC5C,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBACxB,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,OAAO,EACL,IAAI,CAAC,MAAM,GAAG,CAAC;wBACb,CAAC,CAAC,SAAS,IAAI,CAAC,MAAM,oBAAoB,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,cAAc,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;wBAC7H,CAAC,CAAC,qCAAqC,SAAS,UAAU,KAAK,4BAA4B;iBAChG,CAAC;YACJ,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC7D,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,SAAS;YACjB,gBAAgB,EAAE,KAAK;YACvB,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;YACzB,WAAW,EAAE,KAAK,CAAC,MAAM;YACzB,OAAO,EACL,KAAK,CAAC,MAAM,GAAG,CAAC;gBACd,CAAC,CAAC,WAAW,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,yBAAyB,KAAK,CAAC,CAAC,CAAC,cAAc,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;gBACjI,CAAC,CAAC,2CAA2C,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,kDAAkD;SAC9H,CAAC;IACJ,CAAC;IAED,KAAK,UAAU,OAAO,CAAC,IAA6B;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAuB,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAChC,CAAC;gBACC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;oBACvD,OAAO;yBACJ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;yBACvE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC;yBAC5B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,WAAW,GAAG,OAAO;gBACzB,CAAC,CAAC,OAAO;qBACJ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC;qBAC5G,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC;qBAC5B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;qBACjC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;qBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBACvB,CAAC,CAAC,EAAE,CAAC;YACP,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,0BAA0B,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;gBAC9G,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;aAC1D,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,GAAG,CAAC,CAAmB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IACpF,CAAC;IAED,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,IAA6B;QAChE,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,SAAS;QACb,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC;QAC7B,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;QAC7C,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/knowledge/merchants.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ */
+import type { RagDocument } from '../rag/types.js';
+export interface Merchant {
+    id?: string;
+    name?: string;
+    category?: string;
+    address?: string;
+    city?: string;
+    lat?: number;
+    lng?: number;
+    /** e.g. ['onchain', 'lightning', 'rgb']. */
+    acceptedAssets?: string[];
+    description?: string;
+}
+/** One searchable doc per merchant; lat/lng preserved in metadata for mapping. */
+export declare function merchantsToDocuments(merchants: Merchant[]): RagDocument[];
+//# sourceMappingURL=merchants.d.ts.map