elseid-mcp 0.2.1

package/dist/src/nostr/filter.d.ts

@@ -0,0 +1,11 @@
+export interface NostrFilter {
+    kinds: number[];
+    limit?: number;
+    since?: number;
+    until?: number;
+    /** Tag filters: #<tag_name>: [values] */
+    [key: `#${string}`]: string[] | undefined;
+}
+export declare function buildDrifterFilter(limit?: number): NostrFilter;
+export declare function buildFeedingFilter(drifterId: string, limit?: number): NostrFilter;
+export declare function newSubId(): string;

package/dist/src/nostr/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/nostr/filter.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAG,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,CAAC,GAAG,EAAE,IAAI,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CAAC,KAAK,SAAK,GAAG,WAAW,CAM1D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,WAAW,CAO7E;AAED,wBAAgB,QAAQ,IAAI,MAAM,CAEjC"}

package/dist/src/nostr/filter.js

@@ -0,0 +1,23 @@
+// ElseID — src/nostr/filter.ts
+// Builds Nostr REQ subscription filters for drifters and feedings.
+import { DRIFTER_KIND } from "../../types/index.js";
+import crypto from "node:crypto";
+export function buildDrifterFilter(limit = 20) {
+    return {
+        kinds: [DRIFTER_KIND],
+        limit,
+        "#type": ["drifter"],
+    };
+}
+export function buildFeedingFilter(drifterId, limit = 50) {
+    return {
+        kinds: [DRIFTER_KIND],
+        limit,
+        "#e": [drifterId],
+        "#type": ["feeding"],
+    };
+}
+export function newSubId() {
+    return crypto.randomBytes(8).toString("hex");
+}
+//# sourceMappingURL=filter.js.map

package/dist/src/nostr/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/nostr/filter.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,mEAAmE;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,MAAM,MAAM,aAAa,CAAC;AAWjC,MAAM,UAAU,kBAAkB,CAAC,KAAK,GAAG,EAAE;IAC3C,OAAO;QACL,KAAK,EAAE,CAAC,YAAY,CAAC;QACrB,KAAK;QACL,OAAO,EAAE,CAAC,SAAS,CAAC;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,KAAK,GAAG,EAAE;IAC9D,OAAO;QACL,KAAK,EAAG,CAAC,YAAY,CAAC;QACtB,KAAK;QACL,IAAI,EAAI,CAAC,SAAS,CAAC;QACnB,OAAO,EAAE,CAAC,SAAS,CAAC;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC"}

package/dist/src/nostr/ws_pool.d.ts

@@ -0,0 +1,15 @@
+import type { NostrEvent } from "../../types/index.js";
+import type { NostrFilter } from "./filter.js";
+export declare function closeAll(): void;
+export declare function subscribe(relayUrl: string, filter: NostrFilter, timeoutMs?: number): Promise<{
+    event: NostrEvent;
+    relay: string;
+}[]>;
+export declare function subscribeMany(relayUrls: string[], filter: NostrFilter): Promise<{
+    event: NostrEvent;
+    relay: string;
+}[]>;
+export declare function subscribeRaceFirst(relayUrls: string[], filter: NostrFilter, predicate: (event: NostrEvent) => boolean | Promise<boolean>, timeoutMs?: number): Promise<{
+    event: NostrEvent;
+    relay: string;
+} | null>;

package/dist/src/nostr/ws_pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws_pool.d.ts","sourceRoot":"","sources":["../../../src/nostr/ws_pool.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgD/C,wBAAgB,QAAQ,IAAI,IAAI,CAK/B;AAID,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,SAAS,SAAoB,GAC5B,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAoEjD;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAmBjD;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC5D,SAAS,SAAoB,GAC5B,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CA0HtD"}

package/dist/src/nostr/ws_pool.js

@@ -0,0 +1,291 @@
+// ElseID — src/nostr/ws_pool.ts
+// WebSocket connection pool. Manages relay connections and
+// handles REQ/EOSE/EVENT/CLOSE Nostr protocol messages.
+import WebSocket from "ws";
+import { WS_TIMEOUT_MS, FETCH_LIMIT } from "../../config/relays.js";
+import { newSubId } from "./filter.js";
+import { verifySignature } from "./event_signer.js";
+// Pool state
+const _connections = new Map();
+const _connecting = new Map();
+function getOrOpen(relayUrl) {
+    const existing = _connections.get(relayUrl);
+    if (existing) {
+        if (existing.readyState === 1) { // 1: WebSocket.OPEN
+            return Promise.resolve(existing);
+        }
+        // 2: CLOSING, 3: CLOSED - remove and re-open
+        if (existing.readyState === 2 || existing.readyState === 3) {
+            _connections.delete(relayUrl);
+        }
+    }
+    const inProgress = _connecting.get(relayUrl);
+    if (inProgress)
+        return inProgress;
+    const promise = new Promise((resolve, reject) => {
+        const ws = new WebSocket(relayUrl);
+        const timer = setTimeout(() => {
+            ws.terminate();
+            _connecting.delete(relayUrl);
+            reject(new Error(`Connection timeout: ${relayUrl}`));
+        }, WS_TIMEOUT_MS);
+        ws.once("open", () => {
+            clearTimeout(timer);
+            _connections.set(relayUrl, ws);
+            _connecting.delete(relayUrl);
+            resolve(ws);
+        });
+        ws.once("error", (err) => {
+            clearTimeout(timer);
+            _connections.delete(relayUrl);
+            _connecting.delete(relayUrl);
+            reject(err);
+        });
+        ws.once("close", () => {
+            clearTimeout(timer);
+            _connections.delete(relayUrl);
+            _connecting.delete(relayUrl);
+        });
+    });
+    _connecting.set(relayUrl, promise);
+    return promise;
+}
+export function closeAll() {
+    for (const [url, ws] of _connections.entries()) {
+        ws.close();
+        _connections.delete(url);
+    }
+    _connecting.clear();
+}
+// Subscribe
+export async function subscribe(relayUrl, filter, timeoutMs = WS_TIMEOUT_MS * 2) {
+    let ws;
+    try {
+        ws = await getOrOpen(relayUrl);
+    }
+    catch {
+        return [];
+    }
+    const subId = newSubId();
+    const results = [];
+    const now = Math.floor(Date.now() / 1000);
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            cleanup();
+            resolve(results);
+        }, timeoutMs);
+        function cleanup() {
+            clearTimeout(timer);
+            ws.removeListener("message", onMessage);
+            ws.removeListener("close", onAbort);
+            ws.removeListener("error", onAbort);
+            try {
+                ws.send(JSON.stringify(["CLOSE", subId]));
+            }
+            catch (err) {
+                console.warn(`[ws_pool] Failed to send CLOSE for ${subId}:`, err);
+            }
+        }
+        function onAbort() {
+            cleanup();
+            resolve(results);
+        }
+        function onMessage(raw) {
+            let msg;
+            try {
+                msg = JSON.parse(raw.toString());
+            }
+            catch (err) {
+                console.warn("[ws_pool] Failed to parse message:", err);
+                return;
+            }
+            const [type, id, payload] = msg;
+            if (type === "EOSE" && id === subId) {
+                cleanup();
+                resolve(results);
+                return;
+            }
+            if (type === "EVENT" && id === subId && isNostrEvent(payload)) {
+                const event = payload;
+                if (!verifySignature(event))
+                    return;
+                const ttlTag = event.tags.find(([k]) => k === "ttl")?.[1];
+                if (ttlTag && ttlTag !== "0") {
+                    const ttlSec = parseInt(ttlTag, 10);
+                    if (!isNaN(ttlSec) && event.created_at + ttlSec < now)
+                        return;
+                }
+                results.push({ event, relay: relayUrl });
+                if (results.length >= (filter.limit ?? FETCH_LIMIT)) {
+                    cleanup();
+                    resolve(results);
+                }
+            }
+        }
+        ws.on("message", onMessage);
+        ws.on("close", onAbort);
+        ws.on("error", onAbort);
+        try {
+            ws.send(JSON.stringify(["REQ", subId, filter]));
+        }
+        catch (err) {
+            cleanup();
+            resolve(results);
+        }
+    });
+}
+export async function subscribeMany(relayUrls, filter) {
+    const results = await Promise.allSettled(relayUrls.map((url) => subscribe(url, filter)));
+    const seen = new Set();
+    const merged = [];
+    for (const r of results) {
+        if (r.status !== "fulfilled")
+            continue;
+        for (const item of r.value) {
+            if (!seen.has(item.event.id)) {
+                seen.add(item.event.id);
+                merged.push(item);
+            }
+        }
+    }
+    return merged.sort((a, b) => b.event.created_at - a.event.created_at);
+}
+export async function subscribeRaceFirst(relayUrls, filter, predicate, timeoutMs = WS_TIMEOUT_MS * 2) {
+    const abortController = new AbortController();
+    const now = Math.floor(Date.now() / 1000);
+    return new Promise((resolve) => {
+        let resolved = false;
+        let pending = relayUrls.length;
+        const timer = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                abortController.abort();
+                resolve(null);
+            }
+        }, timeoutMs);
+        const finishRelay = () => {
+            pending -= 1;
+            if (pending <= 0 && !resolved) {
+                resolved = true;
+                clearTimeout(timer);
+                abortController.abort();
+                resolve(null);
+            }
+        };
+        const checkEvent = async (event, relay) => {
+            if (resolved)
+                return;
+            try {
+                const pass = await predicate(event);
+                if (pass && !resolved) {
+                    resolved = true;
+                    clearTimeout(timer);
+                    abortController.abort();
+                    resolve({ event, relay });
+                }
+            }
+            catch {
+                // predicate failed
+            }
+        };
+        if (relayUrls.length === 0) {
+            clearTimeout(timer);
+            resolve(null);
+            return;
+        }
+        for (const relayUrl of relayUrls) {
+            const subId = newSubId();
+            let ws;
+            try {
+                getOrOpen(relayUrl).then((opened) => {
+                    ws = opened;
+                    if (resolved) {
+                        finishRelay();
+                        return;
+                    }
+                    let finished = false;
+                    const cleanup = () => {
+                        ws.removeListener("message", onMessage);
+                        ws.removeListener("close", onAbort);
+                        ws.removeListener("error", onAbort);
+                        abortController.signal.removeEventListener("abort", onAbort);
+                        try {
+                            ws.send(JSON.stringify(["CLOSE", subId]));
+                        }
+                        catch (err) {
+                            console.warn(`[ws_pool] Failed to send CLOSE (race) for ${subId}:`, err);
+                        }
+                    };
+                    const closeRelay = () => {
+                        if (finished)
+                            return;
+                        finished = true;
+                        cleanup();
+                        finishRelay();
+                    };
+                    const onAbort = () => closeRelay();
+                    const onMessage = (raw) => {
+                        if (resolved) {
+                            closeRelay();
+                            return;
+                        }
+                        let msg;
+                        try {
+                            msg = JSON.parse(raw.toString());
+                        }
+                        catch (err) {
+                            console.warn("[ws_pool] Failed to parse message (race):", err);
+                            return;
+                        }
+                        const [type, id, payload] = msg;
+                        if (type === "EOSE" && id === subId) {
+                            closeRelay();
+                            return;
+                        }
+                        if (type === "EVENT" && id === subId && isNostrEvent(payload)) {
+                            const event = payload;
+                            if (!verifySignature(event))
+                                return;
+                            const ttlTag = event.tags.find(([k]) => k === "ttl")?.[1];
+                            if (ttlTag && ttlTag !== "0") {
+                                const ttlSec = parseInt(ttlTag, 10);
+                                if (!isNaN(ttlSec) && event.created_at + ttlSec < now)
+                                    return;
+                            }
+                            checkEvent(event, relayUrl);
+                        }
+                    };
+                    ws.on("message", onMessage);
+                    ws.on("close", onAbort);
+                    ws.on("error", onAbort);
+                    abortController.signal.addEventListener("abort", onAbort);
+                    try {
+                        ws.send(JSON.stringify(["REQ", subId, filter]));
+                    }
+                    catch (err) {
+                        closeRelay();
+                    }
+                }).catch(() => {
+                    finishRelay();
+                });
+            }
+            catch {
+                finishRelay();
+            }
+        }
+    });
+}
+// Type guard
+function isNostrEvent(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const e = v;
+    return (typeof e.id === "string" &&
+        typeof e.pubkey === "string" &&
+        typeof e.created_at === "number" &&
+        typeof e.kind === "number" &&
+        Array.isArray(e.tags) &&
+        typeof e.content === "string" &&
+        typeof e.sig === "string");
+}
+//# sourceMappingURL=ws_pool.js.map

package/dist/src/nostr/ws_pool.js.map

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

package/dist/src/relay/broadcaster.d.ts

@@ -0,0 +1,8 @@
+import type { NostrEvent } from "../../types/index.js";
+export interface BroadcastResult {
+    success: boolean;
+    relay: string;
+    eventId: string;
+    message?: string;
+}
+export declare function broadcast(event: NostrEvent, relayUrl: string): Promise<BroadcastResult>;

package/dist/src/relay/broadcaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcaster.d.ts","sourceRoot":"","sources":["../../../src/relay/broadcaster.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKvD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC,CAmB1B"}

package/dist/src/relay/broadcaster.js

@@ -0,0 +1,85 @@
+// ElseID — src/relay/broadcaster.ts
+// Broadcasts a signed Nostr event to a single relay via
+// WebSocket. Retries on transient failures with backoff.
+import WebSocket from "ws";
+import { WS_TIMEOUT_MS } from "../../config/relays.js";
+import { redactSecrets } from "../utils/redact.js";
+const MAX_RETRIES = 3;
+const RETRY_DELAY_MS = 1_500;
+export async function broadcast(event, relayUrl) {
+    let lastError = "";
+    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            const result = await sendOnce(event, relayUrl);
+            if (result.success)
+                return result;
+            lastError = result.message ?? "relay rejected event";
+            // Non-retriable relay rejection (e.g. content policy) — stop early
+            break;
+        }
+        catch (err) {
+            lastError = err?.message ?? "unknown error";
+            if (attempt < MAX_RETRIES) {
+                await sleep(RETRY_DELAY_MS * attempt);
+            }
+        }
+    }
+    return { success: false, relay: relayUrl, eventId: event.id, message: lastError };
+}
+// Internal
+function sendOnce(event, relayUrl) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(relayUrl);
+        let settled = false;
+        const done = (result) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                ws.close();
+                resolve(result);
+            }
+        };
+        const timer = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                ws.terminate();
+                reject(new Error("WebSocket timeout"));
+            }
+        }, WS_TIMEOUT_MS);
+        ws.once("open", () => {
+            ws.send(JSON.stringify(["EVENT", event]));
+        });
+        ws.on("message", (raw) => {
+            try {
+                const msg = JSON.parse(raw.toString());
+                const [type, subscriptionIdOrEventId, ...rest] = msg;
+                // ["OK", <event_id>, <accepted>, <message>]
+                if (type === "OK" && subscriptionIdOrEventId === event.id) {
+                    const accepted = rest[0] === true || rest[0] === "true";
+                    const message = typeof rest[1] === "string" ? rest[1] : undefined;
+                    done({ success: accepted, relay: relayUrl, eventId: event.id, message });
+                    return;
+                }
+                // ["NOTICE", <message>] — informational, not final
+                if (type === "NOTICE") {
+                    console.warn(`[broadcaster] NOTICE from ${relayUrl}:`, redactSecrets(rest[0]));
+                }
+            }
+            catch (err) {
+                console.warn(`[broadcaster] Failed to parse message from ${relayUrl}:`, err);
+            }
+        });
+        ws.once("error", (err) => {
+            reject(err);
+        });
+        ws.once("close", () => {
+            if (!settled) {
+                reject(new Error("WebSocket closed before OK received"));
+            }
+        });
+    });
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+//# sourceMappingURL=broadcaster.js.map

package/dist/src/relay/broadcaster.js.map

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

package/dist/src/relay/health.d.ts

@@ -0,0 +1,5 @@
+import type { RelayInfo } from "../../types/index.js";
+export declare function checkRelay(url: string): Promise<RelayInfo>;
+export declare function checkAllRelays(): Promise<RelayInfo[]>;
+export declare function getCachedRelayInfo(): Promise<RelayInfo[]>;
+export declare function getHealthyRelays(): Promise<RelayInfo[]>;

package/dist/src/relay/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/relay/health.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAItD,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA0ChE;AAID,wBAAsB,cAAc,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAU3D;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAiB/D;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAkB7D"}

package/dist/src/relay/health.js

@@ -0,0 +1,118 @@
+// ElseID — src/relay/health.ts
+// Relay health checks: online status, latency, writability.
+// Persists results to relay_stats table for use by selector.
+import WebSocket from "ws";
+import { getDb } from "../storage/db.js";
+import { DEFAULT_RELAYS, WS_TIMEOUT_MS, HEALTH_CHECK_INTERVAL_MS } from "../../config/relays.js";
+// Single relay check
+export async function checkRelay(url) {
+    return new Promise((resolve) => {
+        const start = Date.now();
+        let settled = false;
+        const timeout = setTimeout(async () => {
+            if (!settled) {
+                settled = true;
+                ws.terminate();
+                await persist({ url, online: false, latencyMs: null, writable: false });
+                resolve({ url, online: false, latencyMs: null, writable: false });
+            }
+        }, WS_TIMEOUT_MS);
+        const ws = new WebSocket(url);
+        ws.once("open", () => {
+            const latencyMs = Date.now() - start;
+            ws.send(JSON.stringify(["REQ", "health-probe", { kinds: [7777], limit: 1 }]));
+            setTimeout(async () => {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timeout);
+                    try {
+                        ws.send(JSON.stringify(["CLOSE", "health-probe"]));
+                    }
+                    catch (err) {
+                        console.warn(`[health] Failed to close health-probe for ${url}:`, err);
+                    }
+                    ws.close();
+                    const info = { url, online: true, latencyMs, writable: true };
+                    await persist(info);
+                    resolve(info);
+                }
+            }, 1_000);
+        });
+        ws.once("error", async (err) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timeout);
+                const info = { url, online: false, latencyMs: null, writable: false };
+                await persist(info);
+                resolve(info);
+            }
+        });
+    });
+}
+// Batch check
+export async function checkAllRelays() {
+    const urls = DEFAULT_RELAYS.map((r) => r.url);
+    const results = await Promise.all(urls.map(checkRelay));
+    return results.sort((a, b) => {
+        if (a.online !== b.online)
+            return a.online ? -1 : 1;
+        if (a.latencyMs === null)
+            return 1;
+        if (b.latencyMs === null)
+            return -1;
+        return a.latencyMs - b.latencyMs;
+    });
+}
+export async function getCachedRelayInfo() {
+    const db = getDb();
+    const rows = await db.all(`
+    SELECT url, online, latency_ms, writable, last_check
+    FROM relay_stats
+    ORDER BY online DESC, latency_ms ASC
+  `);
+    return rows.map((r) => ({
+        url: r.url,
+        online: r.online === 1,
+        latencyMs: r.latency_ms,
+        writable: r.writable === 1,
+    }));
+}
+export async function getHealthyRelays() {
+    const cached = await getCachedRelayInfo();
+    const db = getDb();
+    const staleThreshold = Math.floor(Date.now() / 1000) - HEALTH_CHECK_INTERVAL_MS / 1000;
+    const row = await db.get(`SELECT MAX(last_check) AS lc FROM relay_stats`);
+    if (!row?.lc || row.lc < staleThreshold) {
+        checkAllRelays().catch((err) => {
+            console.warn("⚠️ Background relay health check failed:", err);
+        });
+    }
+    const healthy = cached.filter((r) => r.online && r.writable);
+    if (healthy.length === 0) {
+        return DEFAULT_RELAYS
+            .filter((r) => r.writable)
+            .map((r) => ({ url: r.url, online: true, latencyMs: null, writable: true, region: r.region }));
+    }
+    return healthy;
+}
+// Persistence
+async function persist(info) {
+    const db = getDb();
+    const now = Math.floor(Date.now() / 1000);
+    await db.run(`
+    INSERT INTO relay_stats (url, online, latency_ms, writable, last_check)
+    VALUES (?, ?, ?, ?, ?)
+    ON CONFLICT(url) DO UPDATE SET
+      online     = excluded.online,
+      latency_ms = excluded.latency_ms,
+      writable   = excluded.writable,
+      last_check = excluded.last_check
+  `, [
+        info.url,
+        info.online ? 1 : 0,
+        info.latencyMs ?? null,
+        info.writable ? 1 : 0,
+        now
+    ]);
+}
+//# sourceMappingURL=health.js.map

package/dist/src/relay/health.js.map

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

package/dist/src/relay/selector.d.ts

@@ -0,0 +1,4 @@
+import type { FuzzyLocation } from "../../types/index.js";
+export declare function pickRelayByGeo(location: FuzzyLocation): Promise<string>;
+export declare function pickRelay(preferredUrl?: string): Promise<string>;
+export declare function pickRelaysForFetch(location: FuzzyLocation, count?: number): Promise<string[]>;

package/dist/src/relay/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../../src/relay/selector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,wBAAsB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAO7E;AAED,wBAAsB,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBtE;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAU9F"}