@haven_ai/mcp 0.9.0-alpha.0 → 0.10.0-alpha.0

package/dist/index.cjs

@@ -727,6 +727,10 @@ function createToolHandlers(haven) {
           price_atomic: entry.priceAtomic,
           asset: entry.asset,
           network: entry.network,
+          // #3839: same hint the hosted surface emits — a catalog hint, the
+          // live quote stays authoritative; "unknown" when nothing is recorded.
+          asset_transfer_methods: entry.assetTransferMethods ?? null,
+          funding_leg_expected: sdk.catalogFundingLegExpected(entry.assetTransferMethods),
           status: entry.status,
           verified_at: entry.verifiedAt,
           source: entry.source,
@@ -992,17 +996,26 @@ function parseMaybeJson(text) {
     return text;
   }
 }
+var MERCHANT_OUT_OF_GAS_REASON = "settlement_wallet_out_of_gas";
+function merchantOutOfGasMessage(settlementsRemaining, failFloor) {
+  const remaining = typeof settlementsRemaining === "number" ? settlementsRemaining : null;
+  const floor = typeof failFloor === "number" ? failFloor : null;
+  const figures = remaining !== null && floor !== null ? ` It has gas for ${remaining} more settlement${remaining === 1 ? "" : "s"} and refuses new payments below ${floor} (settlements_remaining: ${remaining}, fail_floor: ${floor}).` : remaining !== null ? ` settlements_remaining: ${remaining}.` : "";
+  return `The merchant refused this call: its settlement wallet is out of gas (reason_code: ${MERCHANT_OUT_OF_GAS_REASON}).` + figures + " No payment was created. The merchant's operator must top up its settlement wallet; until then every retry is refused again. Tell the user, and re-quote once the merchant has been topped up.";
+}
 var MerchantNotReadyError = class extends Error {
+  constructor(message, nextToolOmittedReason = "the merchant needs to recover first; re-quote after the retry_after_s in the message") {
+    super(message);
+    this.nextToolOmittedReason = nextToolOmittedReason;
+    this.name = "MerchantNotReadyError";
+  }
+  nextToolOmittedReason;
   code = sdk.AgentPaymentFailureCode.MerchantNotReady;
   statusCode = 503;
   nextAction = sdk.AgentPaymentNextAction.StopAndTellUser;
   // Genuinely retryable — unlike a rejection, nothing about THIS call was
   // wrong; the merchant's own wallet needs to recover first.
   retryWithNewQuote = true;
-  constructor(message) {
-    super(message);
-    this.name = "MerchantNotReadyError";
-  }
 };
 async function merchantNotReadyErrorFor(response) {
   if (response.status !== 503) return null;
@@ -1015,7 +1028,14 @@ async function merchantNotReadyErrorFor(response) {
   if (!body || typeof body !== "object" || body.error !== "merchant_not_ready") {
     return null;
   }
-  const { reason_code, settlements_remaining, retry_after_s } = body;
+  const { reason_code, settlements_remaining, fail_floor, retry_after_s } = body;
+  if (reason_code === MERCHANT_OUT_OF_GAS_REASON) {
+    return new MerchantNotReadyError(
+      merchantOutOfGasMessage(settlements_remaining, fail_floor),
+      // Same reason the hosted runtime returns (support/mcp-context.ts).
+      "the merchant's operator must top up its settlement wallet first; re-quote after that"
+    );
+  }
   return new MerchantNotReadyError(
     "The merchant refused this call: it cannot settle a payment right now" + (typeof reason_code === "string" ? ` (reason_code: ${reason_code})` : "") + (typeof settlements_remaining === "number" ? `, settlements_remaining: ${settlements_remaining}` : "") + ". No payment was created." + (typeof retry_after_s === "number" ? ` Retry after approximately ${retry_after_s}s.` : " This is often transient; retry later.")
   );
@@ -1036,8 +1056,10 @@ function normalizeError(err) {
       next_action: err.nextAction,
       retry_with_new_quote: err.retryWithNewQuote,
       // #3103: the local runtime's one decision site — no tool can act until
-      // the merchant recovers; the message carries retry_after_s.
-      next_tool_omitted_reason: "the merchant needs to recover first; re-quote after the retry_after_s in the message"
+      // the merchant recovers. The reason rides the error (#3834): the
+      // generic one points at the message's retry_after_s, the out-of-gas
+      // one at the operator top-up.
+      next_tool_omitted_reason: err.nextToolOmittedReason
     };
   }
   if (err instanceof sdk.HavenPaymentStateError) {
@@ -1323,7 +1345,7 @@ async function createHavenMcpServer(options = {}) {
   return buildMcpServer(haven);
 }
 var MCP_NAME = "@haven_ai/mcp";
-var MCP_VERSION = "0.9.0-alpha.0";
+var MCP_VERSION = "0.10.0-alpha.0";
 var MCP_INSTRUCTIONS = [
   "Haven local MCP server: signs in-process with the delegate key it holds on",
   "this machine \u2014 the key never leaves this process. Call haven_get_agent",