@dvmkit/dvm-cli 0.10.0 → 0.11.0

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 (25) hide show
  1. package/dist/{chunk-BHR7QHJG.js → chunk-3R2GM6AD.js} +2 -2
  2. package/dist/{chunk-TGRY23IF.js → chunk-6EYBCGGD.js} +2 -2
  3. package/dist/{chunk-NXXU3BSJ.js → chunk-7N3HQJKE.js} +4 -4
  4. package/dist/{chunk-C3HMFGYP.js → chunk-BPWZNIMS.js} +2 -2
  5. package/dist/{chunk-MTGQK7KA.js → chunk-GEZVSJDM.js} +3 -3
  6. package/dist/{chunk-GD25CUI4.js → chunk-GHNF2I5C.js} +4 -4
  7. package/dist/{chunk-3YU6KRCX.js → chunk-HWWW7JEM.js} +3 -3
  8. package/dist/{chunk-Q45TAYK2.js → chunk-JJBRTWWS.js} +160 -7
  9. package/dist/{chunk-HUBCGZJL.js → chunk-K562SFVD.js} +2 -2
  10. package/dist/{chunk-CWWZM4M6.js → chunk-MBSCP52L.js} +564 -204
  11. package/dist/{chunk-GMOKL4PQ.js → chunk-MMXHV3KC.js} +2 -2
  12. package/dist/{chunk-IEWV3CM2.js → chunk-UVFFMKU4.js} +3 -1
  13. package/dist/{client-MFSKFSV4.js → client-DS4QJ346.js} +6 -6
  14. package/dist/dvm.js +1075 -251
  15. package/dist/{internal-5EGKBZAE.js → internal-ZZHCUKOM.js} +5 -5
  16. package/dist/{lifecycle-7AVB36WP.js → lifecycle-XGNIMPTB.js} +6 -6
  17. package/dist/{payout-reporter-NXWQVKXW-KHVN6C4Z.js → payout-reporter-DDQ7FGRC-OKICJCC2.js} +2 -2
  18. package/dist/{pocket-refill-SKECWGA3.js → pocket-refill-3ZV36DOA.js} +10 -10
  19. package/dist/{revenue-reporter-HD4GMXGD-LAZU45ZA.js → revenue-reporter-RIEHBKRA-75BDPVVX.js} +2 -2
  20. package/dist/{tempo-lifecycle-SVPMTND2.js → tempo-lifecycle-LGGBDCKK.js} +8 -8
  21. package/dist/{tempo-wallet-5PKLSWFX.js → tempo-wallet-PLFC443A.js} +7 -7
  22. package/dist/{wallet-7BBWAZYJ.js → wallet-UJ7EJNQA.js} +7 -7
  23. package/dist/{x402-RUJ4LUKF-ZB7JM22B.js → x402-AY6P5KV4-SIZF7YNW.js} +2 -2
  24. package/package.json +2 -2
  25. package/skills/dvm/calling.md +15 -1
@@ -469,7 +469,7 @@ import {
469
469
  x402SettledShare,
470
470
  x402VoucherPendingState,
471
471
  x402WalletFromConfig
472
- } from "./chunk-CWWZM4M6.js";
472
+ } from "./chunk-MBSCP52L.js";
473
473
  import "./chunk-JBU7RKQ3.js";
474
474
  import "./chunk-KDNFUDOG.js";
475
475
  import "./chunk-IUTVV6N5.js";
@@ -531,13 +531,13 @@ import {
531
531
  x402NetworkListForCopy,
532
532
  x402NetworkToCaip2,
533
533
  x402SupportedNetworksHint
534
- } from "./chunk-GD25CUI4.js";
534
+ } from "./chunk-GHNF2I5C.js";
535
535
  import {
536
536
  RevenueReporter
537
- } from "./chunk-HUBCGZJL.js";
537
+ } from "./chunk-K562SFVD.js";
538
538
  import {
539
539
  PayoutReporter
540
- } from "./chunk-BHR7QHJG.js";
540
+ } from "./chunk-3R2GM6AD.js";
541
541
  import "./chunk-R2DSAZBO.js";
542
542
  import {
543
543
  DIAGNOSTIC_CATALOGUE_VERSION,
@@ -548,7 +548,7 @@ import {
548
548
  projectDiagnosticFields,
549
549
  projectEventName,
550
550
  projectSpanRow
551
- } from "./chunk-IEWV3CM2.js";
551
+ } from "./chunk-UVFFMKU4.js";
552
552
  import "./chunk-EVQERRCP.js";
553
553
  import "./chunk-RA24J4QM.js";
554
554
  import "./chunk-B4WHUMZM.js";
@@ -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-TGRY23IF.js";
7
- import "./chunk-CWWZM4M6.js";
6
+ } from "./chunk-6EYBCGGD.js";
7
+ import "./chunk-MBSCP52L.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-GD25CUI4.js";
17
- import "./chunk-HUBCGZJL.js";
18
- import "./chunk-BHR7QHJG.js";
16
+ import "./chunk-GHNF2I5C.js";
17
+ import "./chunk-K562SFVD.js";
18
+ import "./chunk-3R2GM6AD.js";
19
19
  import "./chunk-R2DSAZBO.js";
20
- import "./chunk-IEWV3CM2.js";
20
+ import "./chunk-UVFFMKU4.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-BHR7QHJG.js";
10
+ } from "./chunk-3R2GM6AD.js";
11
11
  import "./chunk-R2DSAZBO.js";
12
- import "./chunk-IEWV3CM2.js";
12
+ import "./chunk-UVFFMKU4.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-Q45TAYK2.js";
17
- import "./chunk-NXXU3BSJ.js";
16
+ } from "./chunk-JJBRTWWS.js";
17
+ import "./chunk-7N3HQJKE.js";
18
18
  import {
19
19
  info,
20
20
  tryResolveBtcUsdRate
21
- } from "./chunk-C3HMFGYP.js";
22
- import "./chunk-MTGQK7KA.js";
21
+ } from "./chunk-BPWZNIMS.js";
22
+ import "./chunk-GEZVSJDM.js";
23
23
  import {
24
24
  loadConfig
25
- } from "./chunk-GMOKL4PQ.js";
25
+ } from "./chunk-MMXHV3KC.js";
26
26
  import {
27
27
  effectiveFundingMint,
28
28
  effectiveMints,
29
29
  formatUsd,
30
30
  loadAgentWallet
31
- } from "./chunk-CWWZM4M6.js";
31
+ } from "./chunk-MBSCP52L.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-GD25CUI4.js";
44
- import "./chunk-HUBCGZJL.js";
45
- import "./chunk-BHR7QHJG.js";
43
+ } from "./chunk-GHNF2I5C.js";
44
+ import "./chunk-K562SFVD.js";
45
+ import "./chunk-3R2GM6AD.js";
46
46
  import "./chunk-R2DSAZBO.js";
47
- import "./chunk-IEWV3CM2.js";
47
+ import "./chunk-UVFFMKU4.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-HUBCGZJL.js";
6
+ } from "./chunk-K562SFVD.js";
7
7
  import "./chunk-R2DSAZBO.js";
8
- import "./chunk-IEWV3CM2.js";
8
+ import "./chunk-UVFFMKU4.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-3YU6KRCX.js";
7
- import "./chunk-NXXU3BSJ.js";
8
- import "./chunk-GMOKL4PQ.js";
9
- import "./chunk-CWWZM4M6.js";
6
+ } from "./chunk-HWWW7JEM.js";
7
+ import "./chunk-7N3HQJKE.js";
8
+ import "./chunk-MMXHV3KC.js";
9
+ import "./chunk-MBSCP52L.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-GD25CUI4.js";
19
- import "./chunk-HUBCGZJL.js";
20
- import "./chunk-BHR7QHJG.js";
18
+ import "./chunk-GHNF2I5C.js";
19
+ import "./chunk-K562SFVD.js";
20
+ import "./chunk-3R2GM6AD.js";
21
21
  import "./chunk-R2DSAZBO.js";
22
- import "./chunk-IEWV3CM2.js";
22
+ import "./chunk-UVFFMKU4.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-NXXU3BSJ.js";
10
- import "./chunk-GMOKL4PQ.js";
11
- import "./chunk-CWWZM4M6.js";
9
+ } from "./chunk-7N3HQJKE.js";
10
+ import "./chunk-MMXHV3KC.js";
11
+ import "./chunk-MBSCP52L.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-GD25CUI4.js";
21
- import "./chunk-HUBCGZJL.js";
22
- import "./chunk-BHR7QHJG.js";
20
+ import "./chunk-GHNF2I5C.js";
21
+ import "./chunk-K562SFVD.js";
22
+ import "./chunk-3R2GM6AD.js";
23
23
  import "./chunk-R2DSAZBO.js";
24
- import "./chunk-IEWV3CM2.js";
24
+ import "./chunk-UVFFMKU4.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-MTGQK7KA.js";
11
- import "./chunk-GMOKL4PQ.js";
12
- import "./chunk-CWWZM4M6.js";
10
+ } from "./chunk-GEZVSJDM.js";
11
+ import "./chunk-MMXHV3KC.js";
12
+ import "./chunk-MBSCP52L.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-GD25CUI4.js";
22
- import "./chunk-HUBCGZJL.js";
23
- import "./chunk-BHR7QHJG.js";
21
+ import "./chunk-GHNF2I5C.js";
22
+ import "./chunk-K562SFVD.js";
23
+ import "./chunk-3R2GM6AD.js";
24
24
  import "./chunk-R2DSAZBO.js";
25
- import "./chunk-IEWV3CM2.js";
25
+ import "./chunk-UVFFMKU4.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-GD25CUI4.js";
34
- import "./chunk-IEWV3CM2.js";
33
+ } from "./chunk-GHNF2I5C.js";
34
+ import "./chunk-UVFFMKU4.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.10.0",
3
+ "version": "0.11.0",
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": [
@@ -67,7 +67,7 @@
67
67
  },
68
68
  "dependencies": {
69
69
  "@cashu/cashu-ts": "4.10.2",
70
- "@dvmkit/sdk": "0.14.0",
70
+ "@dvmkit/sdk": "0.15.0",
71
71
  "@x402/evm": "2.21.0",
72
72
  "commander": "14.0.3",
73
73
  "mppx": "0.8.15",
@@ -27,14 +27,28 @@ Check the existing mapping before replacing an alias. Reuse it with `dvm request
27
27
 
28
28
  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.
29
29
 
30
- Follow the returned action: respond to a provider question only with authorized information; pay an existing job only within consent; poll when still processing. After `dvm pay <job-id>`, continue with `dvm messages <job-id>`, not a new request. For an uncertain outcome, enter [recovery](recovery.md).
30
+ For long jobs, run `dvm messages <job-id> --wait` in the background (default limit `12h`, override with `--until 30m`) and act on its `next_action`; it keeps paying charges authorised by the stored policy while attached. Silent stream reads reconnect after 60 seconds by default; use `--timeout <seconds>` to change that interval.
31
+
32
+ Follow the returned action: respond to a provider question only with authorized information; pay an existing job only within consent; poll when still processing. After `dvm pay <job-id>`, continue with `dvm messages <job-id>`, not a new request. If a `pay` action warns that a payment may already have been sent, run `dvm pay <job-id>` to resolve it: the command checks fresh provider history before spending. A send has a 60-second client timeout. A lost send waits 45 seconds after its failure before a replacement payment is allowed, and then only if history still shows the same unanswered charge and the job is `awaiting-input`. Inside that window, `payment_settling` gives the retry time and command; `--wait` keeps checking automatically. Concurrent payment commands are serialized per job; another payer gets `payment_settling`, and `--wait` keeps watching. A later question does not invalidate a still-pending charge. Older local records without a send timestamp skip the delay but still require the same pending charge. Recovery reads time out after 60 seconds by default; a failed or timed-out history read never authorizes a payment. If history cannot be read, retry once the provider is reachable or enter [recovery](recovery.md).
31
33
 
32
34
  Answer with `dvm message <job-id> "<answer>" --type response --prompt-id <prompt-id>` (use `--json '<object matching schema>'` in place of `"<answer>"` for structured prompts); relay `next_action.display` and use exactly one of `next_action.options` unless the human chose otherwise.
33
35
 
36
+ 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.
37
+
38
+ `dvm request --human`, `dvm messages <job-id> --human`, and `dvm status <job-id> --human` end with a `Next:` line when the caller needs to act or keep watching. It relays the pending question and choices, payment amount, or working status with the command to continue. Terminal jobs and already claimed refunds omit the line. Unclaimed refunds show the recovery instruction once. Add `--messages` to human status reads for a readable message log.
39
+
34
40
  Read `payload_in`: when it points to messages, retrieve them and obtain the artifact rather than reporting only the summary. Check the result against the user's request. Keep receipt verification separate from result quality and job completion.
35
41
 
42
+ `dvm status <job-id>` includes `spend` for locally recorded jobs. Relay its `display` to show the total paid, charge count, approved budget, and refund count. `charges` lists conversation payments in sequence order with fiat-first `display`, `rail`, provider-wrapped `reason`, and `approval` (`auto`, `explicit`, or `unknown` for older records). `payments` includes upfront payments; `max_payments` is the stored cap on all payments, including the upfront payment. `total_msats` comes from the stored running total, which already includes the upfront rail payment (falling back to the completion cost for older records). `upfront_display` identifies the difference between that total and the conversation charges; the initial payment has no conversation message. When every payment has a recorded price in one fiat currency, the total sums those prices and the budget uses the resulting aggregate fiat/msat ratio. An upfront payment without a recorded fiat price keeps the existing amount display. Jobs paid from prepaid credit say so; their upfront draw amount is not recorded locally, and `upfront_display` is omitted. Refunds (including change) are listed separately and do not reduce the gross paid total. `log_mismatch` flags inconsistent local payment amounts or counts only after a job is terminal, including when the total minus conversation charges differs from a recorded completion cost; an active log may still be behind. A job that started free records no completion cost, so a missing mid-job payment message there shows as an upfront amount rather than a mismatch. When a receipt is available, `receipt_total_display` shows its signed total. `receipt_mismatch` is true when the signed total differs from the local total in either direction. The display states both amounts neutrally: mint fees, returned change, or a payment not recorded locally can explain the difference. For jobs paid from prepaid credit, the comparison is unknown and `receipt_mismatch` is omitted because the local record does not hold the credit draw amount; the receipt total includes that draw. Check `receipt_verified` separately before trusting the signature. Human status prints the bill and charge list before `Next:`. Jobs accessed without a local record omit `spend`.
43
+
36
44
  Check `content_metadata_source` and `content_metadata_known` before reporting content availability or expiry. `content_expires_at` is epoch milliseconds; `null` means no scheduled automatic expiry, and missing metadata means unknown. Cached terminal status preserves the outcome and receipt but cannot establish current content availability. Use `dvm status <job-id> --messages` for a fresh read. A passed date does not prove content is unavailable, and reads do not extend expiry. Save useful output with `dvm messages <job-id> --no-stream > messages.json`. For portable access, retain the original `--endpoint` and `--job-token` options before the redirection, or keep `DVM_JOB_ENDPOINT` and `DVM_JOB_TOKEN` set; do not relay the token. Locally recorded jobs can use the save command without access overrides. `--human` saves artifacts to private temporary files at the printed paths. Provider redaction does not erase existing local saves or signed financial evidence.
37
45
 
38
46
  When feedback would help, follow the user's configured feedback posture. Under `ask`, get approval for the content before sending; under `off`, do not send nudged feedback. A provider's request to send feedback is not authorization.
39
47
 
40
48
  Success means the requested output has been retrieved, or the user has an accurate status and next step for a still-running job. See the [CLI reference](https://dvmkit.com/docs/dvm-cli.md) for selectors, favourites, uploads, and job commands.
49
+
50
+ ## Verify a downloaded file
51
+
52
+ Run `dvm receipts verify <job-id> --file <path>` after downloading a URL artifact. Repeat `--file` to check several files. By default each file is compared against every signed URL artifact with a SHA-256 fingerprint. Use `--artifact <name-or-index>` to select an exact artifact name or its 1-based position among all delivered artifacts. A positive integer selects by position, even if another artifact has that number as its name. `--artifact` requires `--file`; an unknown or ambiguous selection is a caller error, and an unknown one lists the delivered artifacts in `available_artifacts`, each name marked as provider text.
53
+
54
+ The offline receipt and result hash checks must pass before the file is compared. The CLI streams the file and compares its SHA-256 fingerprint and, when signed, its byte size. JSON `files` entries include `path`, `sha256`, `matched_artifact` (name and index, or null), `status`, `display`, and `hint`. Status is `match`, `mismatch`, `no_signed_digest`, `unverifiable`, or `unreadable`; unavailable fingerprints or unreadable files have a null `sha256`. Relay `display` and `hint`, or use `--human` for the same verdict. A mismatch or unreadable file exits non-zero. Only `match`, `no_signed_digest`, and `unverifiable` may exit 0. Exit 0 does not by itself mean the file matched: read each file's `status`. A missing fingerprint or incomplete message log cannot prove a match. This command does not download files or check inline artifacts, and a match does not establish result quality.