@absol-labs/agent 0.12.0-rc.1 → 0.12.0-rc.3

package/dist/cli/commands/reclaim.js

@@ -27,6 +27,7 @@ export const reclaimCommand = {
     signs: true,
     async run(context) {
         const { args, config, env, out, deps } = context;
+        const setActivity = (activity) => context.progress?.setActivity(activity);
         const [streamIdArg] = args.positionals;
         if (streamIdArg === undefined) {
             throw usageError("metrik reclaim requires a <streamId>");
@@ -98,7 +99,9 @@ export const reclaimCommand = {
                 }
                 else {
                     out.note(`closed in ${closeResult.txHash} — waiting for it to land …`);
+                    setActivity(`waiting for the RPC endpoint to show the close in ${closeResult.txHash}`);
                     await awaitClosed(read, streamId, deps.sleep, closeResult.txHash);
+                    setActivity(null);
                     // A stream closed before any checkpoint covers its stop time is the
                     // ORDINARY outcome of a short trial run, not an exotic one — and it
                     // is the state `--close-first` leaves behind by construction. Say
@@ -122,7 +125,11 @@ export const reclaimCommand = {
             sleep: deps.sleep,
             isRetryable: async (error) => await isWaitingForCheckpoint(error, read, streamId, deps.nowSeconds()),
             explainFailure: async (error) => await explainReclaimFailure(error, read, streamId, deps.nowSeconds()),
-            onRetry: (attempt, reason) => out.note(`reclaim blocked: no checkpoint covers the stream's stop time yet (attempt ${attempt}/${attempts}) — ${reason}`),
+            onRetry: (attempt, reason) => {
+                out.note(`reclaim blocked: no checkpoint covers the stream's stop time yet (attempt ${attempt}/${attempts}) — ${reason}`);
+                // The heartbeat must describe THIS wait, not guess at a slow RPC.
+                setActivity(`waiting for the oracle's next checkpoint (attempt ${attempt}/${attempts} was blocked; retrying every ${interval}s)`);
+            },
             // "Retry later" is the wrong advice when the oracle is gone: every
             // attempt this command makes needs a proof FROM that oracle. So the
             // give-up message names the path that needs no proof, and says whether
@@ -132,11 +139,13 @@ export const reclaimCommand = {
         // Read the settled figure back only once the node we are reading from has
         // actually applied the reclaim. The public RPC is load-balanced, so an
         // immediate read can land on a lagged node and report `settledCumulative: 0`
-        // for a stream that just settled a non-zero amount — printing "settled to
-        // operator 0 USDC" when it was not zero. Poll for `reclaimed` (which the
+        // for a stream that just settled a non-zero amount — printing an operator
+        // entitlement of 0 USDC when it was not zero. Poll for `reclaimed` (which the
         // transaction we just landed sets) so the number beside it is from the same
         // post-reclaim state. Bounded, and falls back to the last value read.
+        setActivity("waiting for the RPC endpoint to show the reclaim");
         const stream = await readSettledStream(read, streamId, deps.sleep);
+        setActivity(null);
         // The refund comes from the reclaim's own BuyerReclaimed event, never from
         // a post-reclaim read: reclaim overwrites `deposit` with the operator's
         // entitlement, so deposit − settled reads 0 after every reclaim.
@@ -171,7 +180,14 @@ export const reclaimCommand = {
             ...(stream === null
                 ? []
                 : [
-                    ["settled to operator", formatUsdc(stream.settledCumulative)],
+                    // No USDC moves to the operator at reclaim: reclaim fixes the
+                    // operator's entitlement, the operator claims it later, and the
+                    // protocol fee comes out at that claim. "Settled to operator"
+                    // read as a payment that never happened.
+                    [
+                        "operator entitled",
+                        `${formatUsdc(stream.settledCumulative)} (claims separately; fee taken at claim)`,
+                    ],
                     ...(refunded === null
                         ? []
                         : [

package/dist/cli/commands/reclaim.js.map

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

package/dist/cli/commands/refund.d.ts

@@ -1,13 +1,33 @@
-import type { RefundClient } from "@absol-labs/sdk/x402";
+import type { RefundClient, RefundStatus } from "@absol-labs/sdk/x402";
 import type { CommandSpec } from "../context.js";
 /** Environment fallback for `--refund-url`. */
 export declare const REFUND_URL_ENV = "METRIK_AGENT_REFUND_URL";
 export declare const refundCommand: CommandSpec;
+/** `closed`, `expired` (Active on-chain but past expiresAt) or `active`. */
+export declare function stateOf(status: RefundStatus): "active" | "expired" | "closed";
+/** Why a recovery is over. */
+export type FinishedReason = "reclaimed" | "nothing-to-reclaim";
+/** Why a requested `--close` / `--reclaim` sent nothing. */
+export type SkipReason = FinishedReason | "already-closed";
+/**
+ * Whether the relay's status says nothing is left to recover. `reclaimed` is
+ * the chain's one-reclaim-per-stream flag; `next: none` with `reclaimable: 0`
+ * is the relay's "the verified delivery covers the whole deposit".
+ */
+export declare function finishedReason(status: RefundStatus): FinishedReason | null;
+export declare function describeFinished(reason: FinishedReason): string;
 /**
  * Accepts the relay's full stream URL, a `{streamId}` template, or the relay's
  * base origin (`https://relay.example` -> `https://relay.example/streams/<id>`).
  */
 export declare function resolveRefundUrl(raw: string | undefined, streamId: `0x${string}`): string;
 export declare function explainRefundFailure(error: unknown): unknown;
+/**
+ * What to do after a relay refusal. The on-chain fallback is only offered
+ * where it can still recover something: never "close it (needs gas)" for a
+ * stream that is already closed, and never any recovery at all for one with
+ * nothing left in it.
+ */
+export declare function relayRefusalHint(code: string | undefined): string;
 export type { RefundClient };
 //# sourceMappingURL=refund.d.ts.map

package/dist/cli/commands/refund.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refund.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/refund.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,sBAAsB,CAAC;AAU9B,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjE,+CAA+C;AAC/C,eAAO,MAAM,cAAc,4BAA4B,CAAC;AAKxD,eAAO,MAAM,aAAa,EAAE,WA+H3B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,EAAE,KAAK,MAAM,EAAE,GACtB,MAAM,CAmBR;AAUD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA6B5D;AA2DD,YAAY,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"refund.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/refund.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEZ,YAAY,EAEb,MAAM,sBAAsB,CAAC;AAe9B,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjE,+CAA+C;AAC/C,eAAO,MAAM,cAAc,4BAA4B,CAAC;AAcxD,eAAO,MAAM,aAAa,EAAE,WAmO3B,CAAC;AAmFF,4EAA4E;AAC5E,wBAAgB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAY7E;AAMD,8BAA8B;AAC9B,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,oBAAoB,CAAC;AAChE,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,IAAI,CAM1E;AAiDD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAI/D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,EAAE,KAAK,MAAM,EAAE,GACtB,MAAM,CAmBR;AAUD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqC5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAajE;AAoFD,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/cli/commands/refund.js

@@ -4,11 +4,20 @@ import { formatUsdc } from "../amounts.js";
 import { assertTestnetRpc, parseBytes32 } from "../config.js";
 import { CliError, configError, usageError } from "../errors.js";
 import { signRecoveryMandate } from "../mandate.js";
-import { isPrivyWalletSource, resolveCliWallet } from "../wallet.js";
+import { CDP_ENV_VARS, PRIVATE_KEY_ENV, isPrivyWalletSource, resolveCliWallet, } from "../wallet.js";
 /** Environment fallback for `--refund-url`. */
 export const REFUND_URL_ENV = "METRIK_AGENT_REFUND_URL";
 const DEFAULT_ATTEMPTS = 5;
 const DEFAULT_MAX_WAIT_SECONDS = 60;
+/**
+ * After a close/reclaim, how many times the summary re-reads the relay until
+ * it reflects the transaction just mined (a load-balanced RPC behind the relay
+ * can answer from a node that has not seen it yet), and how long it waits
+ * between reads. Bounded: past it the summary is derived from the verified
+ * receipts instead.
+ */
+const POST_ACTION_READS = 6;
+const POST_ACTION_INTERVAL_MS = 1_500;
 export const refundCommand = {
     name: "refund",
     summary: "Recover the unearned part of an x402 payment through the gasless refund relay",
@@ -19,6 +28,12 @@ export const refundCommand = {
     // permissionless and always pays `payerOf(streamId)`.
     signs: false,
     requiresKey: false,
+    walletHelp: {
+        tag: "[--close needs the payer's key]",
+        text: "Broadcasts nothing itself: the seller's refund relay broadcasts and pays the gas. Status and --reclaim need no wallet. " +
+            "--close signs the payer's off-chain EIP-712 Close message, so it needs the key that paid (no ETH or USDC needed) in the environment: " +
+            `${PRIVATE_KEY_ENV} or ${CDP_ENV_VARS.join(" + ")}. A Privy wallet cannot sign the Close.`,
+    },
     async run(context) {
         const { args, config, env, out, deps } = context;
         if (deps.x402 === undefined) {
@@ -30,6 +45,13 @@ export const refundCommand = {
             throw usageError("metrik refund requires a <streamId>");
         }
         const streamId = parseBytes32(streamIdArg, "<streamId>");
+        if (/^0x0{64}$/i.test(streamId)) {
+            // Stream id 0 = an upfront-only payment (`metrik pay` printed no stream):
+            // nothing was escrowed. A FINISHED state, not a failure — and nothing is
+            // read, requested, signed or sent for it.
+            reportNothingToRefund(context, streamId);
+            return;
+        }
         const refundUrl = resolveRefundUrl(stringFlag(args, "refund-url") ?? env[REFUND_URL_ENV], streamId);
         const doClose = booleanFlag(args, "close");
         const doReclaim = booleanFlag(args, "reclaim");
@@ -54,41 +76,109 @@ export const refundCommand = {
             maxDelayMs: maxWait * 1_000,
         });
         let closeResult = null;
+        let closeSkipped = null;
+        // Set when the relay itself says there is nothing left: the stream was
+        // already reclaimed, or the verified delivery covers the whole deposit.
+        // Those are FINISHED recoveries, not failures — a second
+        // `--close --reclaim` on a done stream must exit 0 and must never point
+        // the payer at a gas-spending on-chain recovery that cannot recover a cent.
+        let finishedByRelay = null;
         if (doClose) {
-            const wallet = await resolveCliWallet(env, {
-                purpose: "capability",
-                note: out.note,
-                rpcUrl: config.rpcUrl,
-            });
-            if (isPrivyWalletSource(wallet.source)) {
-                throw configError("metrik refund --close cannot sign with a Privy wallet", "the payer signs the opener's EIP-712 Close, which the Privy broker's typed-data policy does not allow. Use the key that paid.");
+            // Ask first: a stream that is already closed (or already finished) needs
+            // no Close, so there is nothing to sign and no wallet is needed.
+            const before = await relay(() => refunds.status());
+            const finishedBefore = finishedReason(before);
+            if (finishedBefore !== null || before.status === "closed") {
+                closeSkipped = finishedBefore ?? "already-closed";
+                finishedByRelay = finishedBefore;
+                out.note(finishedBefore === null
+                    ? "stream is already closed — no Close to sign."
+                    : `stream is already closed and ${finishedBefore === "reclaimed" ? "reclaimed" : "has nothing left to reclaim"} — no Close to sign.`);
             }
-            // Buyer recovery: authorized on the mandate OWNER's signature alone, like
-            // `metrik close` — never on caps or expiry, so nothing can strand the
-            // payer's own money. The SDK then refuses a signer that is not
-            // `payerOf(streamId)` before anything is signed for the relay.
-            const mandate = await signRecoveryMandate(wallet.account, config.chainId);
-            const decision = await verifyMandateOwnerSignature(mandate);
-            if (!decision.allowed) {
-                throw new CliError(`mandate denied: ${decision.reason}`, {
-                    exitCode: 3,
+            else {
+                const wallet = await resolveCliWallet(env, {
+                    purpose: "payer-close",
+                    note: out.note,
+                    rpcUrl: config.rpcUrl,
                 });
+                if (isPrivyWalletSource(wallet.source)) {
+                    throw configError("metrik refund --close cannot sign with a Privy wallet", "the payer signs the opener's EIP-712 Close, which the Privy broker's typed-data policy does not allow. Use the key that paid.");
+                }
+                // Buyer recovery: authorized on the mandate OWNER's signature alone,
+                // like `metrik close` — never on caps or expiry, so nothing can strand
+                // the payer's own money. The SDK then refuses a signer that is not
+                // `payerOf(streamId)` before anything is signed for the relay.
+                const mandate = await signRecoveryMandate(wallet.account, config.chainId);
+                const decision = await verifyMandateOwnerSignature(mandate);
+                if (!decision.allowed) {
+                    throw new CliError(`mandate denied: ${decision.reason}`, {
+                        exitCode: 3,
+                    });
+                }
+                try {
+                    closeResult = await relay(() => refunds.close({
+                        signer: wallet.account,
+                    }));
+                    out.note(`close relayed in ${closeResult.transaction}${closeResult.verified ? " (receipt verified on-chain)" : ""}`);
+                }
+                catch (error) {
+                    // The status read above said "active", but the stream closed in the
+                    // meantime (it reached expiresAt, or another close landed): the
+                    // state the payer asked for. Anything else is a real failure.
+                    if (relayCode(error) !== "already-closed")
+                        throw error;
+                    closeSkipped = "already-closed";
+                    out.note("stream was already closed — no Close was needed.");
+                }
             }
-            closeResult = await relay(() => refunds.close({
-                signer: wallet.account,
-            }));
-            out.note(`close relayed in ${closeResult.transaction}${closeResult.verified ? " (receipt verified on-chain)" : ""}`);
         }
         let reclaimResult = null;
+        let reclaimSkipped = null;
         if (doReclaim) {
-            reclaimResult = await relay(() => refunds.reclaim());
+            if (finishedByRelay !== null) {
+                reclaimSkipped = finishedByRelay;
+            }
+            else {
+                context.progress?.setActivity(`waiting on the refund relay's reclaim (it retries up to ${attempts} time${attempts === 1 ? "" : "s"} while the settlement window is open, at most ${maxWait}s per wait)`);
+                try {
+                    reclaimResult = await relay(() => refunds.reclaim());
+                }
+                catch (error) {
+                    const finished = finishedFromRelayCode(relayCode(error));
+                    if (finished === null)
+                        throw error;
+                    reclaimSkipped = finished;
+                    finishedByRelay = finished;
+                }
+                finally {
+                    context.progress?.setActivity(null);
+                }
+            }
         }
-        const status = await relay(() => refunds.status());
+        // The summary describes the state AFTER what this run did: re-read until
+        // the relay reflects the close/reclaim just mined (bounded), else derive
+        // it from the verified receipts. Never the pre-action state.
+        const status = await statusAfterActions(refunds, {
+            closed: closeResult !== null,
+            reclaim: reclaimResult,
+            payer: stream.payer ?? null,
+            opener,
+            streamId,
+            sleep: deps.sleep,
+        });
+        // A reclaim THIS run performed is reported as a reclaim, not as "already
+        // finished".
+        const finished = reclaimResult === null
+            ? (finishedReason(status) ?? finishedByRelay)
+            : null;
         out.result({
             streamId,
             opener,
             payer: status.payer,
+            // The escrow's own on-chain status, verbatim.
             status: status.status,
+            // What it means now: an Active stream past expiresAt is "expired".
+            state: stateOf(status),
             reclaimed: status.reclaimed,
             reclaimable: status.reclaimable,
             next: status.next,
@@ -105,14 +195,164 @@ export const refundCommand = {
                     amount: reclaimResult.amount,
                     verified: reclaimResult.verified,
                 },
+            // Why a requested `--close` / `--reclaim` sent nothing (null when it was
+            // sent, or not requested).
+            closeSkipped,
+            reclaimSkipped,
+            // True when the recovery is over: nothing is left for the payer to get
+            // back (already reclaimed, or the verified delivery covers the deposit).
+            finished: finished !== null,
+            finishedReason: finished,
+            nothingToRecover: finished !== null,
             refundIsAutomatic: false,
         });
         out.print(`x402 stream ${streamId}`);
-        out.table(statusRows(status, closeResult, reclaimResult));
+        out.table(statusRows(status, closeResult, reclaimResult, closeSkipped, finished));
         out.print("");
-        out.print(nextStep(status, streamId, refundUrl));
+        out.print(reclaimResult !== null
+            ? describeReclaimed(reclaimResult)
+            : finished === null
+                ? nextStep(status, streamId, refundUrl)
+                : describeFinished(finished));
     },
 };
+/**
+ * The relay's view of a stream AFTER this run's actions. Reads until it
+ * reflects them (closed after a close, reclaimed after a reclaim), bounded;
+ * if the relay still lags, the state those verified transactions imply is
+ * reported instead, marked as derived. With no action, one plain read.
+ */
+async function statusAfterActions(refunds, done) {
+    const reclaimed = done.reclaim !== null;
+    if (!done.closed && !reclaimed)
+        return await relay(() => refunds.status());
+    const reflects = (status) => (!done.closed || status.status === "closed" || status.reclaimed) &&
+        (!reclaimed || status.reclaimed);
+    let last = null;
+    for (let attempt = 1; attempt <= POST_ACTION_READS; attempt++) {
+        try {
+            const status = await refunds.status();
+            if (reflects(status))
+                return status;
+            last = status;
+        }
+        catch {
+            // A lagging relay (503 chain-lagging, a stale not-found, a blip): the
+            // transactions already happened, so keep going and derive if need be.
+        }
+        if (attempt < POST_ACTION_READS)
+            await done.sleep(POST_ACTION_INTERVAL_MS);
+    }
+    return derivedStatus(last, done);
+}
+/** The state this run's verified close/reclaim imply, when the relay lags. */
+function derivedStatus(last, done) {
+    const reclaimed = done.reclaim !== null;
+    const note = "derived from this run's transaction receipts; the refund relay had not caught up with them yet";
+    return {
+        streamId: done.streamId,
+        chainId: last?.chainId ?? 0,
+        opener: last?.opener ?? done.opener,
+        payer: last?.payer ?? done.payer ?? done.opener,
+        status: "closed",
+        reclaimed: reclaimed || (last?.reclaimed ?? false),
+        chainTime: last?.chainTime ?? null,
+        reclaimable: null,
+        // Both legs this run verified are on-chain facts: the stream is closed.
+        state: "closed",
+        onChainStatus: "closed",
+        maxRefund: last?.maxRefund ?? null,
+        maxRefundMeaning: last?.maxRefundMeaning ?? null,
+        reclaimableMeaning: last?.reclaimableMeaning ?? null,
+        next: reclaimed
+            ? {
+                action: "none",
+                message: "Reclaimed: the unearned remainder was returned to the payer. Nothing further to do.",
+            }
+            : {
+                action: "reclaim",
+                message: "Closed. Reclaim the unearned remainder once a checkpoint covering the close is posted (usually within a minute).",
+            },
+        raw: { derived: true, note },
+    };
+}
+/** `closed`, `expired` (Active on-chain but past expiresAt) or `active`. */
+export function stateOf(status) {
+    if (status.status === "closed" || status.reclaimed)
+        return "closed";
+    const raw = status.raw;
+    if (raw.state === "expired")
+        return "expired";
+    if (typeof raw.expiresAt === "number" &&
+        status.chainTime !== null &&
+        status.chainTime >= raw.expiresAt) {
+        return "expired";
+    }
+    return "active";
+}
+function describeReclaimed(result) {
+    return `Reclaimed: ${result.amount === null ? "the unearned remainder" : formatUsdc(result.amount)} was returned to the payer${result.verified ? " (receipt verified on-chain)" : ""}. Nothing further to do for this stream.`;
+}
+/**
+ * Whether the relay's status says nothing is left to recover. `reclaimed` is
+ * the chain's one-reclaim-per-stream flag; `next: none` with `reclaimable: 0`
+ * is the relay's "the verified delivery covers the whole deposit".
+ */
+export function finishedReason(status) {
+    if (status.reclaimed)
+        return "reclaimed";
+    if (status.next.action === "none" && status.reclaimable === 0n) {
+        return "nothing-to-reclaim";
+    }
+    return null;
+}
+/** The relay's 409 codes that mean "finished", not "failed". */
+function finishedFromRelayCode(code) {
+    if (code === "already-reclaimed")
+        return "reclaimed";
+    if (code === "nothing-to-reclaim")
+        return "nothing-to-reclaim";
+    return null;
+}
+function relayCode(error) {
+    for (let current = error, depth = 0; depth < 4; depth++) {
+        if (!(current instanceof Error))
+            return null;
+        const code = current.code;
+        if (current.name === "RefundRelayError" && typeof code === "string") {
+            return code;
+        }
+        current = current.cause;
+    }
+    return null;
+}
+/** The `metrik refund` answer for an upfront-only payment (exit 0). */
+function reportNothingToRefund(context, streamId) {
+    context.out.result({
+        streamId,
+        opener: null,
+        payer: null,
+        status: null,
+        reclaimed: false,
+        reclaimable: null,
+        next: { action: "none" },
+        close: null,
+        reclaim: null,
+        closeSkipped: null,
+        reclaimSkipped: null,
+        finished: true,
+        finishedReason: "upfront-only",
+        nothingToRecover: true,
+        nothingToRefund: true,
+        refundIsAutomatic: false,
+    });
+    context.out.print("Nothing to refund: this was an upfront-only payment. The whole price was a non-refundable per-call charge paid to the seller at settlement, no escrow stream was opened, and the payment is final. Nothing was requested, signed or sent.");
+}
+export function describeFinished(reason) {
+    return reason === "reclaimed"
+        ? "Already finished: the stream is closed and was already reclaimed — the unearned remainder went to the payer. Nothing left to recover."
+        : "Already finished: nothing to recover — the verified delivery covers the whole deposit, so none of it is unearned.";
+}
 /**
  * Accepts the relay's full stream URL, a `{streamId}` template, or the relay's
  * base origin (`https://relay.example` -> `https://relay.example/streams/<id>`).
@@ -148,6 +388,12 @@ export function explainRefundFailure(error) {
     if (!(error instanceof Error))
         return error;
     switch (error.name) {
+        case "NothingToRefundError":
+            return new CliError(error.message, {
+                exitCode: 3,
+                hint: "this is an upfront-only payment (stream id 0): nothing was escrowed and there is nothing to refund. Run `metrik refund 0x0000…0000` to confirm; it exits 0.",
+                cause: error,
+            });
         case "RefundNotReadyError": {
             const retryAt = error.retryAt;
             return new CliError(error.message, {
@@ -158,12 +404,14 @@ export function explainRefundFailure(error) {
                 cause: error,
             });
         }
-        case "RefundRelayError":
+        case "RefundRelayError": {
+            const code = error.code;
             return new CliError(error.message, {
                 exitCode: 3,
-                hint: `relay refusal${error.code === undefined ? "" : ` (${error.code})`}. The payer can always recover on-chain without the relay: \`metrik close\` (as the payer, needs gas) and \`metrik reclaim\` (anyone).`,
+                hint: relayRefusalHint(code),
                 cause: error,
             });
+        }
         case "NotStreamPayerError":
             return new CliError(error.message, {
                 exitCode: 3,
@@ -174,20 +422,59 @@ export function explainRefundFailure(error) {
             return error;
     }
 }
-function statusRows(status, closeResult, reclaimResult) {
+/**
+ * What to do after a relay refusal. The on-chain fallback is only offered
+ * where it can still recover something: never "close it (needs gas)" for a
+ * stream that is already closed, and never any recovery at all for one with
+ * nothing left in it.
+ */
+export function relayRefusalHint(code) {
+    const label = `relay refusal${code === undefined ? "" : ` (${code})`}`;
+    switch (code) {
+        case "already-reclaimed":
+        case "nothing-to-reclaim":
+            return `${label}. Nothing is left to recover for this stream, on-chain or through the relay.`;
+        case "already-closed":
+            return `${label}. The stream is already closed, so no close is needed: reclaim the unearned remainder with --reclaim (no wallet, no gas), or \`metrik reclaim\` (anyone).`;
+        case "not-closable":
+            return `${label}. The relay's next step is not a close (the stream may have reached expiresAt by itself): run without --close to see the next step.`;
+        default:
+            return `${label}. The payer can always recover on-chain without the relay: \`metrik close\` (as the payer, needs gas) and \`metrik reclaim\` (anyone).`;
+    }
+}
+function statusRows(status, closeResult, reclaimResult, closeSkipped, finished) {
+    const state = stateOf(status);
+    const derived = status.raw.derived === true;
     const rows = [
         [
             "status",
-            status.reclaimed ? `${status.status} (reclaimed)` : status.status,
+            (status.reclaimed
+                ? `${state} (reclaimed)`
+                : state === status.status
+                    ? state
+                    : `${state} (on-chain: ${status.status}; past expiresAt, accrues nothing more)`) +
+                (derived
+                    ? " — from this run's receipts; the relay is still catching up"
+                    : ""),
         ],
+        ...(finished === null
+            ? []
+            : [["recovery", "finished — nothing to recover"]]),
         ["payer", status.payer],
         ["opener", status.opener],
         [
-            "reclaimable",
-            status.reclaimable === null ? "-" : formatUsdc(status.reclaimable),
+            "reclaimable now",
+            reclaimResult !== null || status.reclaimed
+                ? "- (already reclaimed)"
+                : status.reclaimable === null
+                    ? "-"
+                    : formatUsdc(status.reclaimable),
         ],
-        ["next", status.next.action],
+        ["next", reclaimResult !== null ? "none" : status.next.action],
     ];
+    if (closeResult === null && closeSkipped !== null) {
+        rows.push(["close", "skipped — already closed"]);
+    }
     if (closeResult !== null) {
         rows.push([
             "close tx",
@@ -212,6 +499,10 @@ function nextStep(status, streamId, refundUrl) {
     const base = `metrik refund ${streamId} --refund-url ${refundUrl}`;
     switch (status.next.action) {
         case "close":
+            if (status.status === "closed") {
+                // Never "still running" for a stream the chain shows closed.
+                return `Refunds are NOT automatic. The stream is closed: reclaim the unearned remainder with  ${base} --reclaim`;
+            }
             return `Refunds are NOT automatic. The stream is still running: stop it with  ${base} --close --reclaim`;
         case "reclaim":
             return `Refunds are NOT automatic. Reclaim the unearned remainder with  ${base} --reclaim`;