@dvmkit/dvm-cli 0.18.0 → 0.19.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/README.md +8 -0
  2. package/dist/{chunk-ESQ6DCS3.js → chunk-3NXAIRFF.js} +2 -2
  3. package/dist/{chunk-RYFCHR6Z.js → chunk-7HJ5ZR3D.js} +9 -4
  4. package/dist/{chunk-REIUNZQX.js → chunk-B5KW2TPR.js} +2 -2
  5. package/dist/{chunk-DGA5EFKU.js → chunk-DF2OWCRY.js} +6 -6
  6. package/dist/{chunk-OEWENVJ7.js → chunk-MM646MFM.js} +4 -4
  7. package/dist/{chunk-VSOIBYBF.js → chunk-NCX4JVLU.js} +345 -49
  8. package/dist/{chunk-VLD7OKSH.js → chunk-NKD4NEUF.js} +3 -3
  9. package/dist/{chunk-ZGBCVQF2.js → chunk-OCVRCWBL.js} +3 -3
  10. package/dist/{chunk-IK7RI645.js → chunk-W4ADV3HW.js} +449 -5
  11. package/dist/{chunk-UFMAHF6T.js → chunk-WCX4PNEF.js} +127 -40
  12. package/dist/{chunk-THTPKBZX.js → chunk-X6BETQ7V.js} +1252 -737
  13. package/dist/{chunk-A2B7QDMS.js → chunk-ZZCYSYXR.js} +2 -2
  14. package/dist/{client-PVRLAMI3.js → client-PY4T2DOA.js} +6 -6
  15. package/dist/dvm.js +396 -74
  16. package/dist/{internal-L362ZUWL.js → internal-WAQ3LZN4.js} +10 -8
  17. package/dist/{lifecycle-BH4OA5I3.js → lifecycle-NOK3MKL4.js} +6 -6
  18. package/dist/{payout-reporter-F5LFV5W4-EJ7E5ALO.js → payout-reporter-5PH53T44-7IA4NGIN.js} +2 -2
  19. package/dist/{pocket-refill-6UL6CHD5.js → pocket-refill-U4VK5WGO.js} +10 -10
  20. package/dist/{revenue-reporter-2U55YH2I-EUB6PBRN.js → revenue-reporter-4XV3OO5O-RYHS3M34.js} +2 -2
  21. package/dist/{tempo-lifecycle-WGTX6MJR.js → tempo-lifecycle-QGJ4JEHN.js} +8 -8
  22. package/dist/{tempo-wallet-OTB2YSWE.js → tempo-wallet-GDDZZP5S.js} +7 -7
  23. package/dist/{wallet-73EJBUSO.js → wallet-2M3H75UP.js} +7 -7
  24. package/dist/{x402-G6C4N2BN-TAJEBQGU.js → x402-FHHB3V4V-CM6OMLHE.js} +2 -2
  25. package/package.json +2 -2
  26. package/skills/dvm/calling.md +3 -1
  27. package/skills/dvm/credit.md +4 -0
  28. package/skills/dvm/recovery.md +4 -0
  29. package/skills/dvm/wallets.md +3 -1
@@ -95,7 +95,6 @@ import {
95
95
  applyImplicitReceiptCredit,
96
96
  applyPaymentInfoToJob,
97
97
  applyReceiptCredit,
98
- applyRetryToPool,
99
98
  asProviderText,
100
99
  asProviderTextOpt,
101
100
  assertAgentMnemonicReplaceable,
@@ -436,7 +435,6 @@ import {
436
435
  windowEnd,
437
436
  windowStart,
438
437
  withIdentitiesLock,
439
- withInitRetry,
440
438
  withNwcPool,
441
439
  withTempoChannelLock,
442
440
  withTraceContext,
@@ -469,7 +467,7 @@ import {
469
467
  x402SettledShare,
470
468
  x402VoucherPendingState,
471
469
  x402WalletFromConfig
472
- } from "./chunk-THTPKBZX.js";
470
+ } from "./chunk-X6BETQ7V.js";
473
471
  import "./chunk-JBU7RKQ3.js";
474
472
  import "./chunk-KDNFUDOG.js";
475
473
  import "./chunk-IUTVV6N5.js";
@@ -531,15 +529,18 @@ import {
531
529
  x402NetworkListForCopy,
532
530
  x402NetworkToCaip2,
533
531
  x402SupportedNetworksHint
534
- } from "./chunk-DGA5EFKU.js";
532
+ } from "./chunk-DF2OWCRY.js";
535
533
  import {
536
534
  RevenueReporter
537
- } from "./chunk-A2B7QDMS.js";
535
+ } from "./chunk-ZZCYSYXR.js";
538
536
  import {
539
- PayoutReporter
540
- } from "./chunk-IK7RI645.js";
537
+ PayoutReporter,
538
+ applyRetryToPool,
539
+ withInitRetry
540
+ } from "./chunk-W4ADV3HW.js";
541
541
  import "./chunk-R2DSAZBO.js";
542
542
  import {
543
+ DIAGNOSTIC_CATALOGUE,
543
544
  DIAGNOSTIC_CATALOGUE_VERSION,
544
545
  bindDiagnosticCapabilityAuthority,
545
546
  bindDiagnosticIdentityAuthority,
@@ -548,7 +549,7 @@ import {
548
549
  projectDiagnosticFields,
549
550
  projectEventName,
550
551
  projectSpanRow
551
- } from "./chunk-UFMAHF6T.js";
552
+ } from "./chunk-WCX4PNEF.js";
552
553
  import "./chunk-EVQERRCP.js";
553
554
  import "./chunk-RA24J4QM.js";
554
555
  import "./chunk-B4WHUMZM.js";
@@ -580,6 +581,7 @@ export {
580
581
  CREDIT_FUND_RAILS,
581
582
  DEFAULT_AGENT_MINT_URL,
582
583
  DEFAULT_LOCK_PUBKEY_GRACE_SECONDS,
584
+ DIAGNOSTIC_CATALOGUE,
583
585
  DIAGNOSTIC_CATALOGUE_VERSION,
584
586
  DbTransport,
585
587
  DvmError,
@@ -3,8 +3,8 @@ import { createRequire as __dvmCreateRequire } from "node:module";
3
3
  const require = __dvmCreateRequire(import.meta.url);
4
4
  import {
5
5
  assertX402WalletIdle
6
- } from "./chunk-REIUNZQX.js";
7
- import "./chunk-THTPKBZX.js";
6
+ } from "./chunk-B5KW2TPR.js";
7
+ import "./chunk-X6BETQ7V.js";
8
8
  import "./chunk-JBU7RKQ3.js";
9
9
  import "./chunk-KDNFUDOG.js";
10
10
  import "./chunk-IUTVV6N5.js";
@@ -13,11 +13,11 @@ import "./chunk-6LP4EGKA.js";
13
13
  import "./chunk-N3UJT2NJ.js";
14
14
  import "./chunk-SYFKO6BA.js";
15
15
  import "./chunk-PUOXBKY2.js";
16
- import "./chunk-DGA5EFKU.js";
17
- import "./chunk-A2B7QDMS.js";
18
- import "./chunk-IK7RI645.js";
16
+ import "./chunk-DF2OWCRY.js";
17
+ import "./chunk-ZZCYSYXR.js";
18
+ import "./chunk-W4ADV3HW.js";
19
19
  import "./chunk-R2DSAZBO.js";
20
- import "./chunk-UFMAHF6T.js";
20
+ import "./chunk-WCX4PNEF.js";
21
21
  import "./chunk-EVQERRCP.js";
22
22
  import "./chunk-RA24J4QM.js";
23
23
  import "./chunk-B4WHUMZM.js";
@@ -7,9 +7,9 @@ import {
7
7
  PayoutReporter,
8
8
  PostgresX402BatchStore,
9
9
  x402EarnedCeiling
10
- } from "./chunk-IK7RI645.js";
10
+ } from "./chunk-W4ADV3HW.js";
11
11
  import "./chunk-R2DSAZBO.js";
12
- import "./chunk-UFMAHF6T.js";
12
+ import "./chunk-WCX4PNEF.js";
13
13
  import "./chunk-IYHTITNZ.js";
14
14
  export {
15
15
  MemoryX402BatchStore,
@@ -13,22 +13,22 @@ import {
13
13
  recordFloatSpend,
14
14
  resolveFundMint,
15
15
  sweepPendingMints
16
- } from "./chunk-VSOIBYBF.js";
17
- import "./chunk-OEWENVJ7.js";
18
- import "./chunk-VLD7OKSH.js";
16
+ } from "./chunk-NCX4JVLU.js";
17
+ import "./chunk-MM646MFM.js";
18
+ import "./chunk-NKD4NEUF.js";
19
19
  import {
20
20
  loadConfig
21
- } from "./chunk-ESQ6DCS3.js";
21
+ } from "./chunk-3NXAIRFF.js";
22
22
  import {
23
23
  info,
24
24
  tryResolveBtcUsdRate
25
- } from "./chunk-RYFCHR6Z.js";
25
+ } from "./chunk-7HJ5ZR3D.js";
26
26
  import {
27
27
  effectiveFundingMint,
28
28
  effectiveMints,
29
29
  formatUsd,
30
30
  loadAgentWallet
31
- } from "./chunk-THTPKBZX.js";
31
+ } from "./chunk-X6BETQ7V.js";
32
32
  import "./chunk-JBU7RKQ3.js";
33
33
  import "./chunk-KDNFUDOG.js";
34
34
  import "./chunk-IUTVV6N5.js";
@@ -40,11 +40,11 @@ import "./chunk-PUOXBKY2.js";
40
40
  import {
41
41
  microToSats,
42
42
  msatsToMicro
43
- } from "./chunk-DGA5EFKU.js";
44
- import "./chunk-A2B7QDMS.js";
45
- import "./chunk-IK7RI645.js";
43
+ } from "./chunk-DF2OWCRY.js";
44
+ import "./chunk-ZZCYSYXR.js";
45
+ import "./chunk-W4ADV3HW.js";
46
46
  import "./chunk-R2DSAZBO.js";
47
- import "./chunk-UFMAHF6T.js";
47
+ import "./chunk-WCX4PNEF.js";
48
48
  import "./chunk-EVQERRCP.js";
49
49
  import "./chunk-RA24J4QM.js";
50
50
  import "./chunk-B4WHUMZM.js";
@@ -3,9 +3,9 @@ import { createRequire as __dvmCreateRequire } from "node:module";
3
3
  const require = __dvmCreateRequire(import.meta.url);
4
4
  import {
5
5
  RevenueReporter
6
- } from "./chunk-A2B7QDMS.js";
6
+ } from "./chunk-ZZCYSYXR.js";
7
7
  import "./chunk-R2DSAZBO.js";
8
- import "./chunk-UFMAHF6T.js";
8
+ import "./chunk-WCX4PNEF.js";
9
9
  import "./chunk-IYHTITNZ.js";
10
10
  export {
11
11
  RevenueReporter
@@ -3,10 +3,10 @@ import { createRequire as __dvmCreateRequire } from "node:module";
3
3
  const require = __dvmCreateRequire(import.meta.url);
4
4
  import {
5
5
  assertTempoWalletIdle
6
- } from "./chunk-ZGBCVQF2.js";
7
- import "./chunk-OEWENVJ7.js";
8
- import "./chunk-ESQ6DCS3.js";
9
- import "./chunk-THTPKBZX.js";
6
+ } from "./chunk-OCVRCWBL.js";
7
+ import "./chunk-MM646MFM.js";
8
+ import "./chunk-3NXAIRFF.js";
9
+ import "./chunk-X6BETQ7V.js";
10
10
  import "./chunk-JBU7RKQ3.js";
11
11
  import "./chunk-KDNFUDOG.js";
12
12
  import "./chunk-IUTVV6N5.js";
@@ -15,11 +15,11 @@ import "./chunk-6LP4EGKA.js";
15
15
  import "./chunk-N3UJT2NJ.js";
16
16
  import "./chunk-SYFKO6BA.js";
17
17
  import "./chunk-PUOXBKY2.js";
18
- import "./chunk-DGA5EFKU.js";
19
- import "./chunk-A2B7QDMS.js";
20
- import "./chunk-IK7RI645.js";
18
+ import "./chunk-DF2OWCRY.js";
19
+ import "./chunk-ZZCYSYXR.js";
20
+ import "./chunk-W4ADV3HW.js";
21
21
  import "./chunk-R2DSAZBO.js";
22
- import "./chunk-UFMAHF6T.js";
22
+ import "./chunk-WCX4PNEF.js";
23
23
  import "./chunk-EVQERRCP.js";
24
24
  import "./chunk-RA24J4QM.js";
25
25
  import "./chunk-B4WHUMZM.js";
@@ -6,9 +6,9 @@ import {
6
6
  generateTempoKey,
7
7
  tempoBalanceCheckHint,
8
8
  tempoWrongAssetHint
9
- } from "./chunk-OEWENVJ7.js";
10
- import "./chunk-ESQ6DCS3.js";
11
- import "./chunk-THTPKBZX.js";
9
+ } from "./chunk-MM646MFM.js";
10
+ import "./chunk-3NXAIRFF.js";
11
+ import "./chunk-X6BETQ7V.js";
12
12
  import "./chunk-JBU7RKQ3.js";
13
13
  import "./chunk-KDNFUDOG.js";
14
14
  import "./chunk-IUTVV6N5.js";
@@ -17,11 +17,11 @@ import "./chunk-6LP4EGKA.js";
17
17
  import "./chunk-N3UJT2NJ.js";
18
18
  import "./chunk-SYFKO6BA.js";
19
19
  import "./chunk-PUOXBKY2.js";
20
- import "./chunk-DGA5EFKU.js";
21
- import "./chunk-A2B7QDMS.js";
22
- import "./chunk-IK7RI645.js";
20
+ import "./chunk-DF2OWCRY.js";
21
+ import "./chunk-ZZCYSYXR.js";
22
+ import "./chunk-W4ADV3HW.js";
23
23
  import "./chunk-R2DSAZBO.js";
24
- import "./chunk-UFMAHF6T.js";
24
+ import "./chunk-WCX4PNEF.js";
25
25
  import "./chunk-EVQERRCP.js";
26
26
  import "./chunk-RA24J4QM.js";
27
27
  import "./chunk-B4WHUMZM.js";
@@ -7,9 +7,9 @@ import {
7
7
  removeX402Wallet,
8
8
  repinX402WalletNetwork,
9
9
  saveX402Wallet
10
- } from "./chunk-VLD7OKSH.js";
11
- import "./chunk-ESQ6DCS3.js";
12
- import "./chunk-THTPKBZX.js";
10
+ } from "./chunk-NKD4NEUF.js";
11
+ import "./chunk-3NXAIRFF.js";
12
+ import "./chunk-X6BETQ7V.js";
13
13
  import "./chunk-JBU7RKQ3.js";
14
14
  import "./chunk-KDNFUDOG.js";
15
15
  import "./chunk-IUTVV6N5.js";
@@ -18,11 +18,11 @@ import "./chunk-6LP4EGKA.js";
18
18
  import "./chunk-N3UJT2NJ.js";
19
19
  import "./chunk-SYFKO6BA.js";
20
20
  import "./chunk-PUOXBKY2.js";
21
- import "./chunk-DGA5EFKU.js";
22
- import "./chunk-A2B7QDMS.js";
23
- import "./chunk-IK7RI645.js";
21
+ import "./chunk-DF2OWCRY.js";
22
+ import "./chunk-ZZCYSYXR.js";
23
+ import "./chunk-W4ADV3HW.js";
24
24
  import "./chunk-R2DSAZBO.js";
25
- import "./chunk-UFMAHF6T.js";
25
+ import "./chunk-WCX4PNEF.js";
26
26
  import "./chunk-EVQERRCP.js";
27
27
  import "./chunk-RA24J4QM.js";
28
28
  import "./chunk-B4WHUMZM.js";
@@ -30,8 +30,8 @@ import {
30
30
  x402NetworkListForCopy,
31
31
  x402NetworkToCaip2,
32
32
  x402SupportedNetworksHint
33
- } from "./chunk-DGA5EFKU.js";
34
- import "./chunk-UFMAHF6T.js";
33
+ } from "./chunk-DF2OWCRY.js";
34
+ import "./chunk-WCX4PNEF.js";
35
35
  import "./chunk-IYHTITNZ.js";
36
36
  export {
37
37
  X402_DEFAULT_FACILITATOR,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dvmkit/dvm-cli",
3
- "version": "0.18.0",
3
+ "version": "0.19.1",
4
4
  "description": "Command-line client and agent skill for Digital Vending Machines: pay-per-use HTTPS services AI agents can find, pay, and call with no account or API key",
5
5
  "author": "DVM Technologies Ltd",
6
6
  "keywords": [
@@ -69,7 +69,7 @@
69
69
  },
70
70
  "dependencies": {
71
71
  "@cashu/cashu-ts": "4.10.2",
72
- "@dvmkit/sdk": "0.31.0",
72
+ "@dvmkit/sdk": "0.36.0",
73
73
  "@scure/base": "2.0.0",
74
74
  "@x402/evm": "2.21.0",
75
75
  "commander": "14.0.3",
@@ -29,7 +29,7 @@ For metered DVMs, size `--auto-pay-below` for the largest authorized charge (the
29
29
 
30
30
  ## Run and deliver
31
31
 
32
- Submit once with `dvm request`, preserving the approved input and spending limits. Save the returned request and job identifiers. A long job can use `--no-stream` and be followed through its recorded job.
32
+ Submit once with `dvm request`, preserving the approved input and spending limits. Save the returned request and job identifiers. `--no-stream` returns immediately; it leaves no process attached to pay later asks, even with prepaid credit, a budget, and `--max-payments` greater than one. Keep `dvm messages <job-id> --wait` running to pay within the saved policy, or run `dvm pay <job-id>` for each ask. An unanswered ask ends the job; `dvm status` and `dvm messages --no-stream` pay nothing. Do not promise the full planned duration merely because submission succeeded.
33
33
 
34
34
  Successful upfront Cashu fallback includes optional `mint_attempts`: an array of `{ mint, reason, message }` for earlier failed candidates in the order tried. Reasons are `unreachable`, `keys_unavailable`, `swap_disabled`, `fee_cap_exceeded`, `insufficient_balance`, `no_eligible_mint`, or `swap_rejected`. Messages are bounded CLI-authored explanations, never raw dependency errors; mint URLs are redacted and limited to 2,048 characters. These observations explain why the selected `mint` was used; they do not mark the request failed or represent extra payments. The field is omitted when no candidate failed, including reserve-direct success. Attempts are temporary diagnostics and are not persisted for later status or recovery commands. Existing failure diagnostics remain unchanged.
35
35
 
@@ -48,6 +48,8 @@ Answer with `dvm message <job-id> "<answer>" --type response --prompt-id <prompt
48
48
 
49
49
  When a respond or pay action includes `expires_at_ms` (Unix milliseconds), relay the deadline in its `display` to the human: the provider cancels the job if they do not answer or pay by then.
50
50
 
51
+ Terminal status and messages may include `unanswered_payment_request` when retained evidence indicates the last charge expired unanswered around provider cancellation. Relay its qualified `display`, which names the unpaid ask and explains that only earlier paid charges were taken. Its `seq`, `reason`, amount and `expires_at_ms` identify the ask; the provider's message remains separate evidence. Cancellation timestamps have one-second precision, so an ending in the deadline's same second qualifies; the cancellation time does not establish when useful work stopped. Without sufficient retained evidence the field is absent, so do not infer the cause from its absence or from "Job timed out (idle)" alone.
52
+
51
53
  A charge above the job's `--auto-pay-below` limit is never paid automatically. The command exits 0 with a `pay` action and sends nothing. On a DVM that charges by the piece, the action also carries `credit` (the price in integer micro-units of the job's currency) and `charged_if_declined_micro` (what declining costs: the work already finished), both marked as provider fields. Its `display` states the price, what declining costs, and the deadline; relay it verbatim. Then follow the human's choice: `dvm pay <job-id>` within their approval, `dvm decline <job-id>`, or let the deadline pass, which also ends the job.
52
54
 
53
55
  ### Budgets
@@ -22,6 +22,10 @@ When `credit_funding_skipped` reports unavailable BTC/USD pricing, relay its `di
22
22
 
23
23
  Link connects agents only in some regions (the US and Canada as of November 2026). If Link says your region isn't supported, fund over another rail with `--rail`.
24
24
 
25
+ When a human asks to pay by card, run `dvm credit fund <dvm> --rail stripe --amount '$X' --no-wait`. When the DVM offers hosted checkout, this returns the checkout link, amount, expiry, and a `next_step` that resumes the same top-up. Open the link in your own browser and pay with the saved card or wallet the human approves. Stripe asks for an email address: ask the human which address to give. The DVM owner's Stripe account receives that email, plus the cardholder name and country. If you have no browser, hand the link to the human. Then run `next_step` and `dvm credit balance <dvm>` to confirm the booked credit; a link or a completed browser page is never proof of payment. Without `--no-wait`, the command prints the link and polls until booking or expiry. Re-running resumes the pending session, including a paid session after the link expires. A requested amount below the DVM's card minimum is raised with a clear message; check the amount before paying. Unspent credit refunds to the card less its share of Stripe's processing fee.
26
+
27
+ For providers without hosted checkout, the existing Stripe Link approval flow applies:
28
+
25
29
  Some providers take card payments for prepaid credit (`stripe` in their funding rails). A card top-up always needs the human's approval in Stripe Link, so the CLI never makes one by itself: an automatic refill of a card-funded credit stops with `credit_refill_card_approval_required` and the `fund_command` to run. Run `dvm credit fund <dvm> --rail stripe --amount '$X'` first: it charges nothing and returns `card_approval_required` with the exact `link_cli.create` and `link_cli.retrieve` commands, the amount in cents, and the provider's `network_id`. Tell the human it is a card charge that can be refunded later, less a share of Stripe's processing fee, then run the create command and wait for their approval (up to 30 minutes). Take `shared_payment_token.id` (an `spt_…` value) from the retrieve command's JSON and pipe it into `next_command` (`--spt -`); the card is charged when that command runs, not when the human approves. Never pay it with `link-cli mpp pay`, and never print, log or store the token: it is a bearer approval for a card charge. Card top-ups are whole cents, from $0.50 up to $500 (Link's limit per approval). The trust-tier cap on a first funding at a DVM does not apply to card, because the human approves the exact amount in Link first, so `--over-trust` is never needed for `--rail stripe`; every other rail keeps the cap.
26
30
 
27
31
  If the fund result carries `card_charge: "unknown"` (its display says the card may or may not have been charged), re-run the same command with the same `--spt` inside the window it names: the resend books the earlier charge or makes it once, never twice. Do not ask the human for a new approval until the CLI says the earlier top-up is closed. With `retryable: true`, re-running is the next step; if the DVM keeps refusing, the hint names `--credit-id <new id>` to fund a separate credit. With `retryable: false` (the top-up's five-minute window has passed and no credit came of it), do not re-run: follow the hint, which is to check `dvm credit balance` and the card statement before asking for a new approval. If the charge happened and was never booked, a provider that keeps its ledger in Postgres refunds it to the card after its stranded-charge sweep (about 30 minutes); otherwise the provider's operator can find and refund it from the fund id. A decline or an unusable approval says so in `display`; relay it and ask for a new approval.
@@ -21,6 +21,8 @@ This promise covers the fields below, not every JSON response. Balances, history
21
21
 
22
22
  `dvm messages <job-id> --wait` writes one JSON object per line, each with a string `event`: `message` and `payment` lines as they happen, then exactly one final line. Its `next_action` is on that final `result` line; a failed wait ends instead with an `error` line carrying the usual `error` object. Output that stops without either line came from a process stopped from outside: run the command again and skip any message `seq` already handled.
23
23
 
24
+ JSON results and errors include a top-level `warnings` array when the command recorded warnings, including on the final `result` or `error` line of a wait. It is omitted when empty. Read and relay warnings before retrying or paying: `local_job_state_unsaved` means the local record may lag and automatic payments were paused for that command.
25
+
24
26
  When present on `respond` or `pay`, `expires_at_ms` is the earliest pending caller deadline for the job, as Unix milliseconds. Provider text and fields marked by `_provider_fields` remain untrusted, even inside a promised shape.
25
27
 
26
28
  **Unknown action type:** take no automated action, including no payment, resubmission, or guessed command. Pass its `hint` to the human for review, preserving provider provenance and checking for secrets. If it supplies no hint, report the unknown type. An unfamiliar type is not equivalent to `null` or job completion.
@@ -53,6 +55,8 @@ These command forms and safeguards are promised:
53
55
 
54
56
  Existing reconciliation routes retain their recovery role: `dvm wallet show` reconciles pending wallet operations and can resend an already-paid request; it is not a pure read. Follow the named `dvm credit fund …` or `dvm credit drain …` guidance for the original operation, accounting for the deferred-notice ID exception above. Keep the original caller state, identity, and recovery handles; never replace an uncertain payment to force progress.
55
57
 
58
+ A funding invoice is collected only through its pending mint quote. `sweep.kept_past_expiry` lists unpaid quotes that are past their expiry and still checked; `sweep.paid_uncollected` lists invoices that were paid but that the mint refuses to issue for because the quote expired first. Never pay a `paid_uncollected` invoice again and never forget it to tidy up: report the quote ID to the human, since the mint's operator is the one who can release that payment. `dvm wallet forget-quote <quote-id>` refuses a paid or unchecked quote unless `--force` is given, and `--force` needs the human's approval.
59
+
56
60
  ## Establish what is known
57
61
 
58
62
  Record the operation type and the request, job, credit, or funding identifier already available. Inspect structured state and CLI-authored recovery guidance before acting on provider prose. Do not relay secret values from errors.
@@ -18,7 +18,7 @@ For a trusted local connection, pass credentials through the CLI's documented fi
18
18
 
19
19
  Check the required amount and existing balance before topping up. Wallet funding and job payments both count toward spending caps; leave enough authorized headroom for both. Quote shell amounts containing a dollar sign, for example `dvm wallet fund '$5'`, so the shell does not substitute them.
20
20
 
21
- For autonomous funding, follow the output until it reports the observed result. When a human pays a Cashu Lightning invoice, run `dvm wallet fund '<amount>' --no-float --no-wait`, then run the returned `next_step` (`dvm wallet show`) after payment to collect it. An existing unpaid-quote warning names an earlier invoice: avoid asking the human to pay both for the same top-up.
21
+ For autonomous funding, follow the output until it reports the observed result. When a human pays a Cashu Lightning invoice, run `dvm wallet fund '<amount>' --no-float --no-wait`, then run the returned `next_step` (`dvm wallet show`) after payment to collect it. An existing unpaid-quote warning names an earlier invoice: avoid asking the human to pay both for the same top-up. Collect before the returned `collect_before` time: a mint can refuse to issue for a paid invoice once its quote has expired. `dvm wallet show` keeps an unpaid invoice past its expiry and keeps checking it for a late payment for 24 hours (`sweep.kept_past_expiry`); it removes one only when the mint no longer honors it (`sweep.expired`). An invoice whose mint named no expiry stays pending until it is paid or you run `dvm wallet forget-quote <quote-id> --yes`. Forget a quote only when you are sure its invoice will not be paid: a payment made afterwards cannot be collected.
22
22
 
23
23
  For human-assisted funding, show the invoice as soon as the CLI prints it; never wait for the funding command to finish. Send:
24
24
 
@@ -39,3 +39,5 @@ Success means the intended wallet is connected on the intended network and its o
39
39
  ## Audit local history
40
40
 
41
41
  Use `dvm wallet history` for durable spending, completed refunds/losses, and active recovery. `total_usd` is the displayed page's budget valuation, including funding once; draws, refunds, losses, and recovery do not add another outflow. A BTC-equivalent valuation does not establish the native payment rail. Preserve unknown currency and fee fields. Continue with `next_cursor` and the same filters; a stale continuation requires restarting, while `--offset` assumes unchanged records. History reads scan the retained archive even when the output page is short.
42
+
43
+ For a human who wants to pay a DVM by card, run `dvm credit fund <dvm> --rail stripe --amount '$X' --no-wait`. Open the returned checkout link in your own browser and use the saved card or wallet the human approves; without a browser, hand the link to the human. Ask which email address to enter on Stripe's page: the DVM owner's Stripe account receives it, plus the cardholder name and country. Run the returned `next_step`, then `dvm credit balance <dvm>` to confirm payment. Never treat the link as proof of payment. See [credit.md](credit.md) for session recovery and the Stripe Link fallback when hosted checkout is unavailable.