shinjuku-shield 0.3.101 → 0.3.103

package/README.md

@@ -6,13 +6,13 @@ answers privately, in a terminal chat or for your agent app. Its `mcp`
 command runs a local MCP server (stdio) for your agent. Your keys never
 leave your machine.
 
-This is version 0.3.101. The npm packages `shinjuku-shield` and
+This is version 0.3.103. The npm packages `shinjuku-shield` and
 `shinjuku-shielded` hold the same files. The command is `shinjuku`.
 
 ## Set up
 
 ```sh
-npx -y --no-audit --no-fund shinjuku-shield@0.3.101 setup
+npx -y --no-audit --no-fund shinjuku-shield@0.3.103 setup
 ```
 
 Setup makes the wallet on this machine, a private passphrase file, and the
@@ -24,7 +24,7 @@ server to that host's config.
 ## The `shinjuku` command
 
 ```sh
-npm install -g --no-audit --no-fund shinjuku@0.3.101
+npm install -g --no-audit --no-fund shinjuku@0.3.103
 shinjuku help
 ```
 
@@ -36,13 +36,13 @@ Every wallet command works after `shinjuku`, for example `shinjuku balance`,
 Claude Code:
 
 ```sh
-claude mcp add --scope user shinjuku -- npx -y --no-audit --no-fund shinjuku-shield@0.3.101 mcp
+claude mcp add --scope user shinjuku -- npx -y --no-audit --no-fund shinjuku-shield@0.3.103 mcp
 ```
 
 Claude Desktop (`claude_desktop_config.json`) or Cursor (`~/.cursor/mcp.json`):
 
 ```json
-{ "mcpServers": { "shinjuku": { "command": "npx", "args": ["-y", "--no-audit", "--no-fund", "shinjuku-shield@0.3.101", "mcp"] } } }
+{ "mcpServers": { "shinjuku": { "command": "npx", "args": ["-y", "--no-audit", "--no-fund", "shinjuku-shield@0.3.103", "mcp"] } } }
 ```
 
 On native Windows, if the host cannot find `npx`, use `"command": "cmd"` and

package/manifest.json

@@ -1,9 +1,9 @@
 {
   "schema": "carbon-shielded-wallet/bundle-manifest/v1",
   "file": "shinjuku-wallet.mjs",
-  "sha256": "1c3d204e7ba114b9d80654035efb4a244ac607f038e1961f23663b7af9b45dc5",
-  "bytes": 12794106,
-  "sourceCommit": "9e761632116ec38e2adb92828c85cc1793b45c90",
+  "sha256": "b5da74cb566cf4df5a7381cbb3eb28797aff16377f170472b6fcefce230db2a2",
+  "bytes": 12800520,
+  "sourceCommit": "b5ed9d0ff1a26115297f6e4dc56473ca9b053446",
   "sourceDirty": false,
   "installRecordMatchesLockfile": true,
   "releaseRule": "valid only when two fresh npm ci --ignore-scripts builds on different OSes give the same sha256; installRecordMatchesLockfile true means every entry npm installed equals its package-lock.json entry and every entry not marked optional, devOptional included, is installed: an optional entry (a package for another platform) may be absent",
@@ -1297,5 +1297,5 @@
       "version": "1.8.0"
     }
   ],
-  "publishedAt": "2026-10-24T13:59:01.418Z"
+  "publishedAt": "2026-10-24T16:04:06.349Z"
 }

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "shinjuku-shield",
-  "version": "0.3.101",
+  "version": "0.3.103",
   "mcpName": "io.github.ShinjukuStaition/shinjuku-mcp",
   "description": "Shinjuku Shielded, the private x402 facilitator on Solana: the self-custody wallet CLI and its MCP server. Shield, pay, and unshield USDC from any MCP agent, under caps you set.",
-  "shinjukuRelease": "1c3d204e",
-  "shinjukuSha256": "1c3d204e7ba114b9d80654035efb4a244ac607f038e1961f23663b7af9b45dc5",
+  "shinjukuRelease": "b5da74cb",
+  "shinjukuSha256": "b5da74cb566cf4df5a7381cbb3eb28797aff16377f170472b6fcefce230db2a2",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "Shinjuku Shielded",
   "homepage": "https://github.com/ShinjukuStaition/shinjuku-shield#readme",

package/shinjuku-wallet.mjs

@@ -50123,6 +50123,7 @@ function whenRequestsSent(match, { count: count2 = 1, maxMs = 40, settled } = {}
       }
     }
     timer = setTimeout(() => done(false), maxMs);
+    timer.unref?.();
     sent.subscribe(onSent);
     failed.subscribe(onFailed);
     settled?.then(() => done(false), () => done(false));
@@ -96324,8 +96325,12 @@ function returnArrivedFloatRefundBudgets(store, snapshot) {
   for (const name of store.listWal()) {
     if (!name.startsWith(FLOAT_PAYMENT_WAL_PREFIX)) continue;
     const record = store.readWal(name);
-    if (record?.schema !== FLOAT_PAYMENT_SCHEMA) continue;
-    if (record.state !== "refund_pending" || typeof record.innerRequestId !== "string") continue;
+    if (record?.schema !== FLOAT_PAYMENT_SCHEMA || typeof record.innerRequestId !== "string") continue;
+    if (record.state === "submitted") {
+      if (refundArrived(snapshot, record.refundTo)) releaseRefundedReservation({ store, requestId: record.innerRequestId });
+      continue;
+    }
+    if (record.state !== "refund_pending") continue;
     const arrivedNow = refundArrived(snapshot, record.refundTo);
     if (arrivedNow) releaseRefundedReservation({ store, requestId: record.innerRequestId });
     const outcome = arrivedNow ? "refund_arrived" : record.refundOutcome === void 0 && refundCountStopped(record, refreshedAtMs, knowsRecipients) ? "refund_not_seen" : void 0;
@@ -105409,6 +105414,16 @@ function lazyProofEntry(store, name) {
     return String(read()?.state);
   } };
 }
+function floatRefundNoteHeld(snapshot, refundTo) {
+  const outputs = Array.isArray(snapshot?.outputs) ? snapshot.outputs : [];
+  let address5;
+  try {
+    address5 = decodeShieldedSolanaP03Address(String(refundTo));
+  } catch {
+    return false;
+  }
+  return outputs.some((output2) => output2?.kind === "note" && output2.diversifier === address5.diversifier.toString() && output2.recipientX === address5.recipientX.toString());
+}
 function classify(name, record) {
   const state = String(record?.state);
   if (name.startsWith("deposit-") && record?.schema === DEPOSIT_WAL_SCHEMA) {
@@ -105481,8 +105496,10 @@ function computeBalance({ store, snapshotRead, source = "local", now = Date.now(
     ...entry.record.relay?.approvedOnChain ? { approvalStanding: true } : {}
   }));
   const receipts = records.filter((entry) => entry.type === "payment" && entry.phase === "done");
-  const refunded = new Set(records.filter((entry) => entry.type === "float-payment" && entry.state === "refund_pending").map((entry) => entry.record.innerRequestId).filter((id) => typeof id === "string"));
-  const paid = receipts.filter((entry) => !String(entry.record.url ?? "").startsWith(SELF_PAY_ORIGIN2) && !String(entry.record.url ?? "").includes(POOL_MOVE_PATH2) && !refunded.has(entry.record.requestId));
+  const refunded = new Set(records.filter((entry) => entry.type === "float-payment" && (entry.state === "refund_pending" || entry.state === "submitted" && floatRefundNoteHeld(snapshotRead?.snapshot, entry.record.refundTo))).map((entry) => entry.record.innerRequestId).filter((id) => typeof id === "string"));
+  const sellerReceipts = receipts.filter((entry) => !String(entry.record.url ?? "").startsWith(SELF_PAY_ORIGIN2) && !String(entry.record.url ?? "").includes(POOL_MOVE_PATH2));
+  const paid = sellerReceipts.filter((entry) => !refunded.has(entry.record.requestId));
+  const refundedPaid = sellerReceipts.filter((entry) => refunded.has(entry.record.requestId));
   const sum2 = (values) => values.reduce((total, value) => total + BigInt(value ?? "0"), 0n);
   const config = state.config ?? {};
   const capOrNone = (value) => String(value) === NO_LIMIT_ATOMIC2 ? "none" : value;
@@ -105506,6 +105523,8 @@ function computeBalance({ store, snapshotRead, source = "local", now = Date.now(
     pendingDeposits,
     paidAtomic: sum2(paid.map((entry) => paymentAmount(entry.record))).toString(),
     paidReceipts: paid.length,
+    refundedAtomic: sum2(refundedPaid.map((entry) => paymentAmount(entry.record))).toString(),
+    refundedPayments: refundedPaid.length,
     unshieldedAtomic: sum2(records.filter((entry) => entry.type === "unshield" && entry.phase === "done" && !entry.name.startsWith(POCKET_FILL_RECORD) && !entry.name.startsWith(MERGE_RECORD)).map((entry) => entry.record.amountAtomic)).toString(),
     ...budget ? { budget } : {},
     lastRefresh: null
@@ -105833,6 +105852,7 @@ var init_balance = __esm({
     init_config();
     init_commandName();
     init_requestId();
+    init_ShieldedSolanaP03QuoteCrypto();
     PAY_ME_WAL_SCHEMA = "carbon-shielded-wallet/pay-me/v1";
     BALANCE_SNAPSHOT_SCHEMA = "carbon-shielded-wallet/balance-snapshot/v1";
     BALANCE_SNAPSHOT_FILE = "balance-snapshot.json";
@@ -120441,7 +120461,7 @@ function paidMessage(error, code2, paid, requestId, key) {
   const floatId = error?.floatId ?? error?.cause?.floatId;
   const sellerSaid = error?.sellerReason ?? error?.cause?.sellerReason;
   const reason = code2 === "p03_float_seller_kept_payment" ? `The AI provider received the payment but did not serve the request${typeof sellerSaid === "string" ? ` (${JSON.stringify(sellerSaid)})` : ""}; no refund comes. ` : typeof sellerSaid === "string" ? `The AI provider refused the payment: ${JSON.stringify(sellerSaid)}. ` : "";
-  return `this call was paid ${usdcWords(paid)} and returned no answer${floatId ? ` (float ${floatId})` : ""}. Do not resend it without the same Idempotency-Key: a new request pays again. ${reason}Request id ${requestId}` + (key ? `; a resend with header Idempotency-Key: ${key} returns this same result and pays nothing more. ` : ". ") + (refund && ambiguous ? "An earlier send of it may have reached the seller; if it did not, Shinjuku refunds the amount in about 7 minutes. Check shinjuku balance" : refund ? "Shinjuku refunds the amount to the wallet by itself in about 7 minutes; shinjuku balance shows it back" : "Check the wallet with shinjuku balance");
+  return `this call was paid ${usdcWords(paid)} and returned no answer${floatId ? ` (Shinjuku payment ${floatId})` : ""}. Do not resend it without the same Idempotency-Key: a new request pays again. ${reason}Request id ${requestId}` + (key ? `; a resend with header Idempotency-Key: ${key} returns this same result and pays nothing more. ` : ". ") + (refund && ambiguous ? "An earlier send of it may have reached the seller; if it did not, Shinjuku refunds the amount in about 7 minutes. Check shinjuku balance" : refund ? "Shinjuku refunds the amount to the wallet by itself in about 7 minutes; shinjuku balance shows it back" : "Check the wallet with shinjuku balance");
 }
 function unknownMessage(code2, counted, requestId, key) {
   return `request ${requestId} may already have paid (${code2 ?? "the payment failed with no code"}), and its outcome is not known yet. This server counted ${usdcWords(counted)} (its limit per request) of its limit per run for it. ` + (key ? `Do not send it as a new request: resend the same body with header Idempotency-Key: ${key} to finish that same payment; it never pays twice` : "This request had no Idempotency-Key, so infer serve cannot resume that payment, and a resend pays again. Check the wallet with shinjuku balance before you send it again, and send an Idempotency-Key header with each request so a resend finishes the same payment");
@@ -128665,7 +128685,9 @@ ${canonical5}`;
       const sellerTransaction = view2.sellerTransaction ?? knownSellerTransfer(record) ?? (SIGNATURE_TEXT.test(String(read ?? "")) ? read : null);
       row(name.slice(FLOAT_PAYMENT_WAL_PREFIX.length), record, { ...view2, sellerTransaction }, {
         scheme: "exact",
-        ...sellerTransaction === null ? { note: "the seller served this request, so it was paid and no refund comes; it sent no transfer signature, and Shinjuku has not reported the landed transfer yet (a later wallet_receipts shows it)" } : {}
+        // RC1 (mcp56 pass of 0.3.102, hypernatt): this said "a later wallet_receipts shows it", but Shinjuku drops a final
+        // row's link fields, landedTransaction too (float.mjs retain, owner decision 4), about 1 s after the settle.
+        ...sellerTransaction === null ? { note: "the seller served this request, so it was paid and no refund comes; the seller sent no transfer signature, and Shinjuku keeps no link between this payment and its transfer once the payment is final, so this receipt has no seller transaction to show" } : {}
       });
     }
     for (const name of names) {
@@ -134319,7 +134341,7 @@ var init_tools = __esm({
     capRaiseText = (flag3) => {
       if (capFlagFromLaunchLine(flag3)) {
         const both = flag3 === "--max-payment" ? " (raise the 24-hour payment limit there too when it is below the new amount: the wallet does not start with it lower)" : "";
-        return `The ${capName(flag3)} is set in this app's wallet entry; only the user (your owner) can change it there${both}, with amounts in USDC like 0.5, then reconnect the wallet (restart the agent host). Where the entry is: Claude Desktop: claude_desktop_config.json; Cursor: ~/.cursor/mcp.json; Claude Code: claude mcp get shinjuku-shielded shows the entry, then claude mcp remove shinjuku-shielded and claude mcp add it again with the new value; Hermes: config.yaml. Running setup does not change this limit: the value in the entry wins over the limit setup records.`;
+        return `The ${capName(flag3)} is set in this app's wallet entry; only the user (your owner) can change it there${both}, with amounts in USDC like 0.5, then reconnect the wallet (restart the agent host). Where the entry is: Claude Desktop: claude_desktop_config.json; Cursor: ~/.cursor/mcp.json; Claude Code: claude mcp get ${MCP_SERVER_NAME} shows the entry (an entry added by hand can have another name: claude mcp list shows it), then claude mcp remove ${MCP_SERVER_NAME} and claude mcp add it again with the new value; Hermes: config.yaml. Running setup does not change this limit: the value in the entry wins over the limit setup records.`;
       }
       return `The ${capName(flag3)} comes from the wallet's settings. To change it, the user runs ${terminalCommand2("limits")} in a terminal: it asks each limit as a question (amounts in USDC like 0.5, or Enter for no limit). Then the user restarts the agent host.`;
     };
@@ -136052,6 +136074,7 @@ __export(chat_exports, {
   DEFAULT_MODEL: () => DEFAULT_MODEL2,
   chatCaps: () => chatCaps,
   hideProgressLines: () => hideProgressLines,
+  holdProgressLines: () => holdProgressLines,
   isProgressLine: () => isProgressLine,
   knownPrivateBalance: () => knownPrivateBalance,
   leastAnswerAtomic: () => leastAnswerAtomic,
@@ -136151,6 +136174,33 @@ function hideProgressLines(stream = process.stderr) {
     stream.write = original;
   };
 }
+function holdProgressLines(stream = process.stderr) {
+  const original = stream.write;
+  const held = [];
+  stream.write = function write(chunk, encoding, callback) {
+    const text3 = typeof chunk === "string" ? chunk : Buffer.from(chunk).toString(typeof encoding === "string" ? encoding : "utf8");
+    let passed = "";
+    let kept2 = 0;
+    for (const line of text3.split(/(?<=\n)/)) {
+      if (line.endsWith("\n") && PROGRESS_LINE.test(line)) {
+        held.push(line);
+        kept2 += 1;
+      } else passed += line;
+    }
+    if (kept2 === 0) return original.call(stream, chunk, encoding, callback);
+    const done = typeof encoding === "function" ? encoding : callback;
+    if (passed) return original.call(stream, passed, done);
+    if (typeof done === "function") done();
+    return true;
+  };
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    stream.write = original;
+    if (held.length) original.call(stream, held.join(""));
+  };
+}
 function errorCodeOf(error) {
   if (error?.name === "InferenceError" && typeof error.code === "string") return error.code;
   if (error?.name === "SpendRefusalError" && typeof error.error === "string") return error.error;
@@ -136463,6 +136513,11 @@ async function runChat({ io, values, deps = {} }) {
         say6(`No AI provider serves ${turn.model} at this price right now. ${paidWords} Try another model (/model ${models.find((entry) => entry.id !== turn.model)?.id ?? DEFAULT_MODEL2}), or ${again} later.`);
       } else if (NO_ANSWER_CODES.test(code2 ?? "")) {
         say6(`The AI provider did not send a chat answer. ${paidWords} Wait a moment and ${again}, or try another model (/model).`);
+      } else if (FLOAT_WAIT_WORDS[code2]) {
+        state.pending = turn;
+        const named = error?.retryAfterSeconds ?? error?.cause?.retryAfterSeconds;
+        const seconds2 = Number.isFinite(named) && named > 0 ? Math.ceil(named) : FLOAT_WAIT_WORDS[code2].seconds;
+        say6(`Nothing was paid: ${FLOAT_WAIT_WORDS[code2].what}. Ask again in about ${seconds2 >= 60 ? `${Math.round(seconds2 / 60)} minute${seconds2 >= 120 ? "s" : ""}` : `${seconds2} seconds`} (or /retry).`);
       } else if (WAIT_CODES.test(code2 ?? "")) {
         say6(`The payment did not finish yet (the wallet or the network is busy). ${paidWords} Wait a moment, then ${again}.`);
       } else {
@@ -136548,7 +136603,7 @@ async function runChat({ io, values, deps = {} }) {
     await session.close();
   }
 }
-var DEFAULT_MODEL2, CHAT_DEFAULT_MODEL, CHAT_MAX_TOKENS, CHAT_SHORT_TOKENS, DEFAULT_ANSWER_CAP_ATOMIC, DEFAULT_CHAT_CAP_ATOMIC, CHEAPEST_MODEL, STILL_WAITING_MS, providerKept, higherCap, POSITIVE_ATOMIC9, SHINJUKU_FEE_ATOMIC, SHORT_QUESTION_TOKENS, PASTE_JOIN_MS, INSUFFICIENT2, CAP_CODES, WAIT_CODES, NO_ANSWER_CODES, NOTHING_PAID, CAP_FROM, PROGRESS_LINE, SHOWN_PROGRESS, SELF_PAY_LINE, isProgressLine, fail46, nothingPaid;
+var DEFAULT_MODEL2, CHAT_DEFAULT_MODEL, CHAT_MAX_TOKENS, CHAT_SHORT_TOKENS, DEFAULT_ANSWER_CAP_ATOMIC, DEFAULT_CHAT_CAP_ATOMIC, CHEAPEST_MODEL, STILL_WAITING_MS, providerKept, higherCap, POSITIVE_ATOMIC9, SHINJUKU_FEE_ATOMIC, SHORT_QUESTION_TOKENS, PASTE_JOIN_MS, INSUFFICIENT2, CAP_CODES, WAIT_CODES, NO_ANSWER_CODES, FLOAT_WAIT_WORDS, NOTHING_PAID, CAP_FROM, PROGRESS_LINE, SHOWN_PROGRESS, SELF_PAY_LINE, isProgressLine, fail46, nothingPaid;
 var init_chat = __esm({
   "wallet/src/inference/chat.mjs"() {
     "use strict";
@@ -136581,6 +136636,11 @@ var init_chat = __esm({
     CAP_CODES = /^(spend_payment_cap_exceeded|mcp_session_cap_exceeded|mcp_cap_argument_above_launch_cap|p03_float_over_maximum)$/;
     WAIT_CODES = /_retry_same_request$|_retry_same_payment$|_retry_later$|^wallet_locked$|another_request_unresolved$/;
     NO_ANSWER_CODES = /^inference_(upstream_failed|response_invalid)$/;
+    FLOAT_WAIT_WORDS = Object.freeze({
+      p03_float_not_ready_retry_later: { what: "Shinjuku's payment service is not ready right now", seconds: 60 },
+      p03_float_busy_retry_later: { what: "Shinjuku's payment service is busy right now", seconds: 30 },
+      p03_float_payment_in_flight_retry_later: { what: "an earlier quote for this answer is still open at Shinjuku", seconds: 60 }
+    });
     NOTHING_PAID = /\bnothing was (?:sent or )?paid\b|\bnothing was paid or signed\b/i;
     CAP_FROM = { line: "from this command line", setup: "set in setup", default: "the default" };
     PROGRESS_LINE = /^(?:tor|rpc|history|memo service): |^reading \d+ memos? from the memo service|^reading your private balance again\b|^getting your balance ready: moving \S+ USDC of one deposit\b/;
@@ -161715,9 +161775,16 @@ async function addFunds(values, deps) {
     plan.status = { ...plan.status ?? { stage: currentStage(store, plan) }, ended: iso2(deps.now()) };
     save2();
     const view2 = fundsView(store, plan, { now: deps.now(), running: false });
-    io.err(`${ctx.quiet ? "add-funds stopped" : `add-funds ${plan.fundsId} stopped at ${view2.stage}`}: nothing is lost. Run the same command again to continue.
+    if (ctx.quiet) {
+      const waits = view2.stages.find((entry) => entry.stage === view2.stage)?.waitsFor;
+      io.err(`add-funds stopped: nothing is lost.${waits ? ` It was waiting for ${waits}.` : ""} To continue, run:
+  ${commandLine("add-funds")}
 `);
-    printEnd(deps, view2, ctx.terminal);
+    } else {
+      io.err(`add-funds ${plan.fundsId} stopped at ${view2.stage}: nothing is lost. Run the same command again to continue.
+`);
+      printEnd(deps, view2, ctx.terminal);
+    }
   } finally {
     process.off("SIGINT", onSignal);
     process.off("SIGTERM", onSignal);
@@ -162176,6 +162243,12 @@ var UsageError = class extends Error {
 };
 var PublicFailure = class extends Error {
 };
+var AnswerDeclined = class extends PublicFailure {
+  constructor(code2, plain) {
+    super(`${code2}: ${plain}`);
+    this.plain = plain;
+  }
+};
 var QuestionCancelled = class extends PublicFailure {
   // Every terminal question comes before a payment or a send, so this is true at each one.
   constructor(interrupted) {
@@ -162536,13 +162609,13 @@ async function runCurl(values, deps) {
 ${CURL_USEPOD_NEXT}`, { cause: error });
       else throw curlFailure(error);
     } finally {
-      await session.close();
+      await closeTimed(session, "curl-price");
     }
   }
   if (response) return curlOutput(response, values, deps, probeId);
   const answer = String(await deps.ask(`Pay ${usdcText3(priceAtomic)} USDC for ${values.get("--url")}? [y/N] `)).trim();
   if (!/^y(es)?$/i.test(answer)) {
-    throw new PublicFailure("curl_payment_declined: you did not answer y, so nothing was paid. To pay, run the same command again and answer y");
+    throw new AnswerDeclined("curl_payment_declined", "you did not answer y, so nothing was paid. To pay, run the same command again and answer y");
   }
   values.set("--max-payment", priceAtomic);
   return runCurlPaid(values, deps, { requestId });
@@ -162574,10 +162647,31 @@ ${CURL_USEPOD_NEXT}`, { cause: error });
       }
       throw curlFailure(error);
     }
+    sessionMark(session)("curl-paid-returned");
+    return await curlOutput(response, values, deps, requestId);
   } finally {
-    await session.close();
+    await closeTimed(session, "curl");
+  }
+}
+function sessionMark(session) {
+  let mark = () => {
+  };
+  try {
+    if (typeof session.timing === "function") mark = session.timing();
+  } catch {
   }
-  return curlOutput(response, values, deps, requestId);
+  return (phase) => {
+    try {
+      mark(phase);
+    } catch {
+    }
+  };
+}
+async function closeTimed(session, what) {
+  const mark = sessionMark(session);
+  mark(`${what}-close-start`);
+  await session.close();
+  mark(`${what}-closed`);
 }
 async function curlOutput(response, values, deps, requestId) {
   const io = deps.io;
@@ -162622,8 +162716,18 @@ var INFER_STDIN_MAX_BYTES = 1024 * 1024;
 var INFER_STDIN_EXAMPLE = `echo "Summarize x402 in one line" | ${CLI_WORD} infer - --model qwen3-8-flash`;
 var CURL_USEPOD_NEXT = `use \`${CLI_WORD} infer\` for the AI provider: it sends the prompt only through --tor or --proxy`;
 function unshieldArgs(command2, args) {
-  if (args.length === 0 || args.includes("--amount") || !/^(all|[0-9]+(\.[0-9]+)?)$/i.test(args[0])) return args;
-  return ["--amount", /^all$/i.test(args[0]) ? "all" : args[0], ...args.slice(1)];
+  if (args.includes("--amount")) return args;
+  const known = new Map(command2.flags.map((entry) => [entry.name, entry]));
+  for (let index = 0; index < args.length; index += 1) {
+    const token = args[index];
+    if (token.startsWith("--")) {
+      if (known.has(token) && !known.get(token).boolean) index += 1;
+      continue;
+    }
+    if (!/^(all|[0-9]+(\.[0-9]+)?)$/i.test(token)) return args;
+    return ["--amount", /^all$/i.test(token) ? "all" : token, ...args.slice(0, index), ...args.slice(index + 1)];
+  }
+  return args;
 }
 function inferArgs(command2, args) {
   const known = new Map(command2.flags.map((entry) => [entry.name, entry]));
@@ -162790,11 +162894,19 @@ async function runInfer(values, deps) {
     }
   } catch (error) {
     if (quiet && !given && !NOTHING_PAID_TEXT.test(String(error?.message ?? ""))) values.set(INFER_STOPPED_ID, requestId);
+    stopWatch();
+    await closeTimed(session, "infer");
     throw error;
+  }
+  stopWatch();
+  try {
+    sessionMark(session)("infer-paid-returned");
+    inferOutput(result, { values, io, model, quiet, requestId });
   } finally {
-    stopWatch();
-    await session.close();
+    await closeTimed(session, "infer");
   }
+}
+function inferOutput(result, { values, io, model, quiet, requestId }) {
   const paid = String(result.paidAtomic ?? "?");
   const paidText = usdcOr(result.paidAtomic);
   const stopped = result.finishReason === "length" ? " (the answer stopped at --max-tokens)" : "";
@@ -163671,10 +163783,10 @@ function agentAppLines({ home, deps, npmVersion, skip = /* @__PURE__ */ new Set(
   }
   return lines.join("\n");
 }
-function setupNextText({ home, deps, npmVersion, config, fundAsked, rerun, inferenceNow, targets = [], added = /* @__PURE__ */ new Set() }) {
+function setupNextText({ home, deps, npmVersion, config, fundAsked, rerun, targets = [], added = /* @__PURE__ */ new Set() }) {
   const parts = [];
   if (!fundAsked && !rerun) parts.push(fundingStepText());
-  if (!rerun || inferenceNow) parts.push(privateInferencePath(config));
+  parts.push(privateInferencePath(config));
   if (targets.some((target) => !added.has(target))) {
     const byHand = hostConfigText({ home, env: deps.env, platform: deps.platform ?? process.platform, npmVersion, skip: added });
     if (byHand) parts.push(`Or add it by hand:
@@ -163682,8 +163794,7 @@ ${byHand}
 `);
   } else if (rerun && !targets.length) {
     parts.push([
-      "Your agent app keeps its MCP entry.",
-      "To add the wallet to another agent app, run one of these:",
+      "To add the wallet to an agent app, run one of these:",
       ...HOST_TARGETS.map((target) => `  ${cli2()} setup --add-to ${target}`),
       ""
     ].join("\n"));
@@ -163723,10 +163834,21 @@ function recordOwnAddress(home, address5, deps) {
     return [`  note         your own address was not saved: ${why}`];
   }
 }
-async function offerFundNow(deps, { tor }) {
+async function offerFundNow(deps, { tor, created }) {
+  const io = deps.io;
+  try {
+    await askFundNow(deps, { tor, created });
+  } catch (error) {
+    if (!(error instanceof QuestionCancelled)) throw error;
+    io.out(`Setup is done; no money was added. To add money later, ask your agent to add funds, or run:
+  ${FUND_COMMAND}
+`);
+  }
+}
+async function askFundNow(deps, { tor, created }) {
   const io = deps.io;
   for (let attempt = 0; attempt < 3; attempt += 1) {
-    const answer = String(await deps.ask(attempt === 0 ? "The wallet starts empty. Add money now? Amount in USDC, from 0.01 (press Enter to skip): " : "Add money now? Amount in USDC, from 0.01 (press Enter to skip): ")).trim();
+    const answer = String(await deps.ask(attempt === 0 && created ? "The wallet starts empty. Add money now? Amount in USDC, from 0.01 (press Enter to skip): " : "Add money now? Amount in USDC, from 0.01 (press Enter to skip): ")).trim();
     if (!answer || /^(n|no|skip)$/i.test(answer)) break;
     const atomic4 = usdcToAtomic(answer);
     if (!atomic4 || BigInt(atomic4) < PAY_ME_MIN_ATOMIC) {
@@ -164158,7 +164280,7 @@ async function runSetupCommand(values, deps) {
 
 `);
     const config2 = setupConfigOf(home);
-    await offerFundNow(deps, { tor: config2?.tor === true });
+    await offerFundNow(deps, { tor: config2?.tor === true, created: !old });
     const targets2 = values.get("--add-to") ?? [];
     io.out(setupNextText({
       home,
@@ -164167,7 +164289,6 @@ async function runSetupCommand(values, deps) {
       config: config2,
       fundAsked: true,
       rerun: values.get(SETUP_RERUN) === "settings",
-      inferenceNow: privateInference === true && (!old || old.inference?.enabled !== true),
       targets: targets2,
       added: new Set(targets2)
     }));
@@ -164228,15 +164349,14 @@ Copy it to two offline places now; it is the only way to restore this wallet.
   const targets = values.get("--add-to") ?? [];
   const added = targets.length ? addToHosts(targets, home, deps, { force: values.has("--force"), npmVersion }) : /* @__PURE__ */ new Set();
   const config = setupConfigOf(home);
-  const inferenceNow = summary.privateInference === true && (!rerun || old?.inference?.enabled !== true);
   if (inProxiedRun(deps.env) && deps.env[SETUP_NEXT_BY_PARENT_ENV] === "1") {
     if (targets.some((target) => !added.has(target))) {
-      io.out(setupNextText({ home, deps, npmVersion, config, fundAsked: true, rerun: true, inferenceNow: false, targets, added }));
+      io.out(setupNextText({ home, deps, npmVersion, config, fundAsked: true, rerun: true, targets, added }));
     }
     return void 0;
   }
-  if (interactive) await offerFundNow(deps, { tor: config?.tor === true });
-  io.out(setupNextText({ home, deps, npmVersion, config, fundAsked: interactive, rerun, inferenceNow, targets, added }));
+  if (interactive) await offerFundNow(deps, { tor: config?.tor === true, created: !old });
+  io.out(setupNextText({ home, deps, npmVersion, config, fundAsked: interactive, rerun, targets, added }));
 }
 async function confirmAboveBalanceCap(deps, atomic4) {
   if (BigInt(atomic4) <= MAX_SHIELDED_BALANCE_ATOMIC) return true;
@@ -164881,6 +165001,8 @@ var COMMANDS = [
       flag2("--data-file", "<file>", "the request body from a file (POST)"),
       flag2("--out", "<file>", "-o: write the answer to this private file (mode 600) instead of stdout"),
       bool2("--include", "-i: print the HTTP status line and headers before the body (a paid answer has status 200 and the x-shinjuku-payment receipt header)"),
+      // CU1 (mcp56, published 0.3.101): a terminal curl printed the 4-line "history: ..." paragraph before the pay question.
+      bool2("--verbose", "in a terminal, also show the wallet's own progress lines (Tor, the RPC relay, the pool history, the memo reads); without it a terminal shows only the price question, the answer, and what it paid"),
       flag2("--request-id", "<id>", "your stable name for this request; default curl-<random>, printed on stderr before any payment. Rerun with the same id to resume a stopped run: it never pays twice"),
       ...payerSessionFlags()
     ],
@@ -164903,6 +165025,7 @@ var COMMANDS = [
     nextInOutput: true,
     normalizeArgs: curlArgs,
     validate: validateCurl,
+    quietProgress: (values, deps) => terminalQuiet(values, deps),
     run: (args, values, deps, io) => deps.curlMain(values, { ...deps, io })
   },
   {
@@ -165171,8 +165294,10 @@ var COMMANDS = [
     next: SETUP_NEXT,
     // Printed as "Next: ..." after a run (the runner's label), as the help page prints it.
     nextLabel: "Next",
-    // A rerun of a complete setup (SETUP_RERUN): the agent app already has the entry.
-    nextAfterRun: (values) => values.get(SETUP_RERUN) === "settings" ? 'close and open your agent app so it starts the wallet with these settings, then ask "what is my balance".' : values.get(SETUP_RERUN) === "own-address" ? "ask your agent to send money to your own address: it sends without asking you each time." : SETUP_NEXT,
+    // A rerun of a complete setup (SETUP_RERUN): it cannot tell whether an agent app has the entry (0.3.101 live pass).
+    nextAfterRun: (values) => values.get(SETUP_RERUN) === "settings" ? `chat privately with an AI in this terminal:
+  ${CLI_WORD} chat
+If an agent app already runs the wallet, close and open it so it reads these settings.` : values.get(SETUP_RERUN) === "own-address" ? "ask your agent to send money to your own address: it sends without asking you each time." : SETUP_NEXT,
     // In a terminal its progress lines (tor:, rpc:, history:) show only with --verbose; Tor trouble shows in plain words
     // (inference/chat.mjs hideProgressLines). Live run 2026-10-24 08:26 UTC (npm 0.3.97, laptop, Tor on): setup printed
     // the raw onion line "tor: the onion ... gave no answer (the stream failed); its requests move to ...". The Tor run's
@@ -166179,7 +166304,7 @@ async function askUnshield(args, values, deps) {
       deps.io.err(`${why}
 `);
     }
-    throw new PublicFailure(`unshield_declined: three answers were not usable, so nothing was sent. To send, run:
+    throw new AnswerDeclined("unshield_declined", `three answers were not usable, so nothing was sent. To send, run:
   ${cli2()} unshield`);
   };
   const out = [...args];
@@ -166206,16 +166331,31 @@ async function askUnshield(args, values, deps) {
   }
   let whole;
   if (values.get("--amount") === "all") {
+    const open4 = () => (deps.openWalletStore ?? openWalletStore)(resolve39(values.get("--wallet")), payerPassphrase(values, deps));
+    let store;
     try {
-      whole = savedBalance((deps.openWalletStore ?? openWalletStore)(resolve39(values.get("--wallet")), payerPassphrase(values, deps)));
+      store = open4();
+      whole = savedBalance(store);
     } catch {
       whole = void 0;
     }
+    const refreshArgs = !whole && store ? homeRefreshArgs(store, deps) : void 0;
+    if (refreshArgs) {
+      deps.io.err("Reading your private balance from the chain, so the question names the amount...\n");
+      const silent = { out: () => {
+      }, err: () => {
+      } };
+      try {
+        if (await runShinjukuWallet(["balance", ...refreshArgs], { ...deps, io: silent }) === 0) whole = savedBalance(open4());
+      } catch {
+        whole = void 0;
+      }
+    }
   }
-  const wholeWords = !whole ? "" : whole.current ? ` (${usdcOr(whole.atomic.toString())})` : ` (about ${usdcOr(whole.atomic.toString())} at its last read)`;
+  const wholeWords = !whole ? ` (its amount could not be read now; answer n and run ${cli2()} balance to see it)` : whole.current ? ` (${usdcOr(whole.atomic.toString())})` : ` (about ${usdcOr(whole.atomic.toString())} at its last read)`;
   const what = values.get("--amount") === "all" ? `your whole private balance${wholeWords}` : `${usdcText3(values.get("--amount"))} USDC`;
   const answer = String(await deps.ask(`Send ${what} to ${values.get("--to")}? [y/N] `)).trim();
-  if (!/^y(es)?$/i.test(answer)) throw new PublicFailure(`unshield_declined: you did not answer y, so nothing was sent. To send, run:
+  if (!/^y(es)?$/i.test(answer)) throw new AnswerDeclined("unshield_declined", `you did not answer y, so nothing was sent. To send, run:
   ${cli2()} unshield`);
   return out;
 }
@@ -167651,8 +167791,8 @@ function floatFailureHint(reason, floatError) {
   if (/p03_float_answer_invalid_refund_pending/.test(reason)) {
     return "Shinjuku was paid, but its answer held no valid payment for this seller, so nothing went to the seller. Refund of the amount paid (price + fee) on the way (up to about 7 min). Nothing more to do";
   }
-  if (/p03_float_busy_retry_later/.test(reason)) return "nothing was paid: Shinjuku's shared float is busy right now. Rerun the same command in about 30 seconds";
-  if (/p03_float_not_ready_retry_later/.test(reason)) return "nothing was paid: Shinjuku's shared float is not ready yet (it is being filled). Rerun the same command in about a minute";
+  if (/p03_float_busy_retry_later/.test(reason)) return "nothing was paid: Shinjuku's payment service is busy right now. Rerun the same command in about 30 seconds";
+  if (/p03_float_not_ready_retry_later/.test(reason)) return "nothing was paid: Shinjuku's payment service is not ready right now. Rerun the same command in about a minute";
   if (/p03_float_payment_in_flight_retry_later/.test(reason)) return "nothing was paid: an earlier quote for this payment is still open at Shinjuku. Rerun the same command in about a minute";
   if (/p03_float_price_above_capacity/.test(reason)) {
     return `nothing was paid: the seller's price is above the largest price Shinjuku pays for one request now (largestAtomic in ${config}). Pay a cheaper seller, or try again later`;
@@ -167661,10 +167801,10 @@ function floatFailureHint(reason, floatError) {
     return `nothing was paid: the seller's price plus the Shinjuku fee (feeAtomic in ${config}; 1000 = 0.001 USDC) is above your maximum (--maximum-atomic or --max-payment). Rerun with a maximum of at least price + fee`;
   }
   if (/p03_float_seller_uses_our_facilitator/.test(reason)) {
-    return "nothing was paid: this seller's exact offer settles through Shinjuku's own pocket facilitator, which cannot take a payment from the shared float. Ask the seller for its shielded-exact offer: the wallet pays that one first";
+    return "nothing was paid: this seller's exact offer settles through Shinjuku's own pocket facilitator, which cannot take a payment from Shinjuku's payment service. Ask the seller for its shielded-exact offer: the wallet pays that one first";
   }
   if (/p03_float_not_offered/.test(reason)) {
-    return "nothing was paid: the facilitator (--memo-service) does not run float pay, so a seller that takes only standard exact cannot be paid through it. Use the facilitator of this wallet's pool";
+    return "nothing was paid: the facilitator (--memo-service) does not run Shinjuku's payment service, so a seller that takes only standard exact cannot be paid through it. Use the facilitator of this wallet's pool";
   }
   if (/p03_float_config_unreadable/.test(reason)) return `nothing was paid: ${config} did not answer, or its answer is not valid. Rerun the same command later`;
   if (/p03_float_config_mismatch/.test(reason)) return "nothing was paid: the facilitator's float runs on another network or token than this wallet's pool. Use the facilitator of this wallet's pool";
@@ -167840,6 +167980,7 @@ function defaultDependencies() {
      * what happened. Ctrl-C, or an input that ends, now stops the command with QuestionCancelled (one plain line).
      */
     ask: (question) => new Promise((resolveAnswer, rejectAnswer) => {
+      const releaseProgress = holdProgressLines(process.stderr);
       const prompt = createInterface2({ input: process.stdin, output: process.stderr, terminal: true });
       let answered2 = false;
       let interrupted = false;
@@ -167849,6 +167990,7 @@ function defaultDependencies() {
         prompt.close();
       });
       prompt.on("close", () => {
+        releaseProgress();
         if (!answered2) rejectAnswer(new QuestionCancelled(interrupted));
       });
       prompt.question(question, (answer) => {
@@ -167957,6 +168099,7 @@ function strayWordIn(command2, args) {
 }
 async function runShinjukuWallet(argv2, overrides = {}) {
   const deps = { ...defaultDependencies(), ...overrides };
+  const endsProcess = Object.keys(overrides).length === 0;
   setCommandVersionSource(() => deps.walletVersion().npm);
   const rawIo = deps.io;
   deps.io = { ...rawIo, out: (text3) => rawIo.out(fillCommandWords(text3)), err: (text3) => rawIo.err(fillCommandWords(text3)) };
@@ -168080,6 +168223,8 @@ This copy: ${walletVersionLine(deps.walletVersion())}
     writeRunResult(deps, command2, 0);
     return 0;
   } catch (error) {
+    if (endsProcess) showProgressAgain = () => {
+    };
     if (error instanceof RanBehindTorFailed) return error.exitCode;
     if (error instanceof UsageError) {
       let setUp = false;
@@ -168108,6 +168253,11 @@ This copy: ${walletVersionLine(deps.walletVersion())}
     }
     if (error instanceof QuestionCancelled) {
       io.err(`${CLI} ${command2.name} ${error.message}
+`);
+      return 1;
+    }
+    if (error instanceof AnswerDeclined) {
+      io.err(`${CLI} ${command2.name} stopped: ${error.plain}
 `);
       return 1;
     }