indelible-mcp 5.8.1 → 5.8.2

package/LICENSE

@@ -15,7 +15,7 @@ Additional Use Grant: You may make use of the Licensed Work for personal,
                       commercial blockchain storage, session saving, or
                       encrypted vault service without written permission
                       from the Licensor.
-Change Date:          August 18, 2030
+Change Date:          August 19, 2030
 Change License:       MIT License
 
 Terms

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "indelible-mcp",
-  "version": "5.8.1",
+  "version": "5.8.2",
   "description": "Blockchain-backed memory and code storage for Claude Code. Save AI conversations and source code permanently on BSV.",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -1025,7 +1025,8 @@ function claimRefusalMessage(claim2) {
   if (r === "WALLET_VIEW_DEGRADED") {
     const seen = Number.isFinite(claim2.visibleSats) ? `${claim2.visibleSats} sats` : "the coins known locally";
     const needs = Number.isFinite(claim2.need) ? ` (needs about ${claim2.need} sats)` : "";
-    return `Cannot reach the network to see your full wallet right now. The locally-known coins (${seen}) cannot fund this save${needs}, but your wallet may hold more that is not visible offline. Nothing was spent. Retry when the connection recovers \u2014 do not add funds based on this message.`;
+    const opener = claim2.operator_reason === "INDEX_PARTIAL" ? "The network's view of your wallet is temporarily incomplete (the index is catching up)." : "Cannot reach the network to see your full wallet right now.";
+    return `${opener} The currently-visible coins (${seen}) cannot fund this save${needs}, but your wallet may hold more that is not visible yet. Nothing was spent. Retry in a few minutes \u2014 do not add funds based on this message.`;
   }
   if (r === "NO_COINS") return "No UTXOs available. Fund your wallet.";
   return "No UTXOs available. Fund your wallet.";
@@ -1100,11 +1101,13 @@ async function claimSpendableUtxos(address, bridgeFallback, opts = {}) {
       }
     }
     let _bridgeDegraded = false;
+    let _bridgePartial = null;
     const bridgeView = async () => {
       if (!bridgeFallback) return [];
       try {
         const v = await bridgeFallback(address);
         _bridgeDegraded = false;
+        _bridgePartial = v?.coverage?.known && v.coverage.partial ? v.coverage : null;
         return v;
       } catch {
         _bridgeDegraded = true;
@@ -1121,6 +1124,17 @@ async function claimSpendableUtxos(address, bridgeFallback, opts = {}) {
     } else {
       candidates = unionCandidates(address, await bridgeView());
     }
+    if (_phase === "union" && candidates.length === 0 && (_bridgeDegraded || _bridgePartial)) {
+      return {
+        refused: true,
+        reason: "WALLET_VIEW_DEGRADED",
+        operator_reason: _bridgeDegraded ? "BRIDGE_UNREACHABLE" : "INDEX_PARTIAL",
+        ..._bridgePartial ? { index_holes: _bridgePartial.holes, index_source: _bridgePartial.source } : {},
+        underlying: "NO_COINS",
+        visibleSats: 0,
+        reservedSats: 0
+      };
+    }
     const claimed = await withFileLock(LOCK_PATH, async () => {
       const store = readReservations();
       releaseDeadPreSign(store, now);
@@ -1137,8 +1151,17 @@ async function claimSpendableUtxos(address, bridgeFallback, opts = {}) {
         if (wholeWallet.ok) return { busy: true };
         const { ok: _ok, ...evidence } = selected;
         const reservedSats = (candidates || []).filter((u) => reserved.has(inputKey(u))).reduce((s, u) => s + (u?.value || 0), 0);
-        if (_bridgeDegraded && evidence.reason !== "TX_TOO_LARGE") {
-          return { refused: true, reason: "WALLET_VIEW_DEGRADED", underlying: evidence.reason, need: evidence.need, visibleSats: evidence.available, reservedSats };
+        if ((_bridgeDegraded || _bridgePartial) && evidence.reason !== "TX_TOO_LARGE") {
+          return {
+            refused: true,
+            reason: "WALLET_VIEW_DEGRADED",
+            operator_reason: _bridgeDegraded ? "BRIDGE_UNREACHABLE" : "INDEX_PARTIAL",
+            ..._bridgePartial ? { index_holes: _bridgePartial.holes, index_source: _bridgePartial.source } : {},
+            underlying: evidence.reason,
+            need: evidence.need,
+            visibleSats: evidence.available,
+            reservedSats
+          };
         }
         return { refused: true, ...evidence, reservedSats };
       }
@@ -1597,14 +1620,27 @@ async function checkHealth() {
     return false;
   }
 }
+function coverageFromHeaders(headers) {
+  try {
+    const src = headers?.get?.("x-utxo-source") || null;
+    const holesRaw = headers?.get?.("x-utxo-holes");
+    if (src === null && (holesRaw === null || holesRaw === void 0)) return { known: false, partial: false, source: null, holes: 0 };
+    const holes = Number.parseInt(holesRaw || "0", 10) || 0;
+    const partial = holes > 0 || /partial/i.test(src || "");
+    return { known: true, partial, source: src, holes };
+  } catch {
+    return { known: false, partial: false, source: null, holes: 0 };
+  }
+}
 async function getUtxos(address) {
   const path = `/api/address/${address}/unspent`;
   const res = await spvFetch(path);
   const first = await res.json();
+  const firstCoverage = coverageFromHeaders(res.headers);
   if (Array.isArray(first) && first.length > 0) {
     process.stderr.write(`[MCP] UTXOs from bridge: ${first.length}
 `);
-    return first;
+    return withCoverage(first, firstCoverage);
   }
   let reached = 0;
   try {
@@ -1615,8 +1651,9 @@ async function getUtxos(address) {
         headers: { "X-API-Key": bridge.apiKey }
       });
       if (!r.ok) throw new Error(`HTTP ${r.status}`);
-      return { name: bridge.name, utxos: await r.json() };
+      return { name: bridge.name, utxos: await r.json(), coverage: coverageFromHeaders(r.headers) };
     }));
+    let anyPartial = null;
     for (const s of settled) {
       if (s.status !== "fulfilled") continue;
       reached++;
@@ -1624,8 +1661,14 @@ async function getUtxos(address) {
       if (Array.isArray(u) && u.length > 0) {
         process.stderr.write(`[MCP] UTXOs recovered via fan-out from ${s.value.name}: ${u.length}
 `);
-        return u;
+        return withCoverage(u, s.value.coverage);
       }
+      if (s.value.coverage?.known && s.value.coverage.partial) anyPartial = s.value.coverage;
+    }
+    if (anyPartial) {
+      process.stderr.write(`[MCP] UTXOs: 0 across ${reached} bridge(s), but a bridge reports a PARTIAL index (holes=${anyPartial.holes})
+`);
+      return withCoverage([], anyPartial);
     }
   } catch (e) {
     process.stderr.write(`[MCP] UTXO fan-out error: ${e.message}
@@ -1633,7 +1676,7 @@ async function getUtxos(address) {
   }
   process.stderr.write(`[MCP] UTXOs: 0 across ${reached} bridge(s)
 `);
-  return Array.isArray(first) ? first : [];
+  return withCoverage(Array.isArray(first) ? first : [], firstCoverage);
 }
 async function getAddressHistory(address) {
   const res = await spvFetch(`/api/address/${address}/history`);
@@ -2169,7 +2212,7 @@ function extractEncryptedFromTx(tx) {
   const match = str.match(/([A-Za-z0-9+/=]{12,}):([A-Za-z0-9+/=]{20,}):([A-Za-z0-9+/=]{20,})/);
   return match ? match[0] : null;
 }
-var SEED_BRIDGES, OLD_BRIDGE_IPS, bridgeHealth, HEALTH_CHECK_INTERVAL, MAX_FAILURES, migrationDone, SOURCE_FETCH_CONCURRENCY, ARC_NETWORK_STATUSES, StoredError, _stickyBridge, STICKY_WINDOW_MS;
+var SEED_BRIDGES, OLD_BRIDGE_IPS, bridgeHealth, HEALTH_CHECK_INTERVAL, MAX_FAILURES, migrationDone, withCoverage, SOURCE_FETCH_CONCURRENCY, ARC_NETWORK_STATUSES, StoredError, _stickyBridge, STICKY_WINDOW_MS;
 var init_spv = __esm({
   "mcp-server/lib/spv.js"() {
     init_config_customer();
@@ -2196,6 +2239,13 @@ var init_spv = __esm({
     HEALTH_CHECK_INTERVAL = 6e4;
     MAX_FAILURES = 3;
     migrationDone = false;
+    withCoverage = (utxos, coverage) => {
+      try {
+        Object.defineProperty(utxos, "coverage", { value: coverage, enumerable: false });
+      } catch {
+      }
+      return utxos;
+    };
     SOURCE_FETCH_CONCURRENCY = 8;
     ARC_NETWORK_STATUSES = /* @__PURE__ */ new Set([
       // Tightened 2026-06-17 to match the relay-federation bridge: a node must have
@@ -17454,7 +17504,7 @@ Answer THAT message and nothing else \u2014 the wire also carries unrelated conv
 }
 function printHelp() {
   console.log(`
-Indelible MCP \u2014 Blockchain memory for Claude Code (v5.8.1)
+Indelible MCP \u2014 Blockchain memory for Claude Code (v5.8.2)
 
 Setup:
   indelible-mcp                              Set up interactively (recommended \u2014 your key is never written to shell history)
@@ -17783,7 +17833,7 @@ function readStdin() {
 }
 var SERVER_INFO = {
   name: "indelible",
-  version: "5.8.1",
+  version: "5.8.2",
   description: "Blockchain-backed memory and code storage for Claude Code"
 };
 var TOOLS = [