@dvmkit/dvm-cli 0.9.2 → 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.
- package/dist/{chunk-BHR7QHJG.js → chunk-3R2GM6AD.js} +2 -2
- package/dist/{chunk-5R3BLFVO.js → chunk-6EYBCGGD.js} +2 -2
- package/dist/{chunk-BCDMVIPI.js → chunk-7N3HQJKE.js} +4 -4
- package/dist/{chunk-C7ZNQONB.js → chunk-BPWZNIMS.js} +2 -2
- package/dist/{chunk-PMPHS3LS.js → chunk-GEZVSJDM.js} +3 -3
- package/dist/{chunk-GD25CUI4.js → chunk-GHNF2I5C.js} +4 -4
- package/dist/{chunk-XDYBVNFS.js → chunk-HWWW7JEM.js} +3 -3
- package/dist/{chunk-MVVKMKWR.js → chunk-JJBRTWWS.js} +984 -24
- package/dist/{chunk-HUBCGZJL.js → chunk-K562SFVD.js} +2 -2
- package/dist/{chunk-6XTWANVN.js → chunk-MBSCP52L.js} +1073 -252
- package/dist/{chunk-QDOY3JF2.js → chunk-MMXHV3KC.js} +2 -2
- package/dist/{chunk-IEWV3CM2.js → chunk-UVFFMKU4.js} +3 -1
- package/dist/{client-MMJYIMKJ.js → client-DS4QJ346.js} +6 -6
- package/dist/dvm.js +1379 -1171
- package/dist/{internal-LRW4XR3J.js → internal-ZZHCUKOM.js} +15 -5
- package/dist/{lifecycle-QE3KHIHQ.js → lifecycle-XGNIMPTB.js} +6 -6
- package/dist/{payout-reporter-NXWQVKXW-KHVN6C4Z.js → payout-reporter-DDQ7FGRC-OKICJCC2.js} +2 -2
- package/dist/{pocket-refill-J3BME4O3.js → pocket-refill-3ZV36DOA.js} +10 -10
- package/dist/{revenue-reporter-HD4GMXGD-LAZU45ZA.js → revenue-reporter-RIEHBKRA-75BDPVVX.js} +2 -2
- package/dist/{tempo-lifecycle-HJQYBOZR.js → tempo-lifecycle-LGGBDCKK.js} +8 -8
- package/dist/{tempo-wallet-XN72C2GK.js → tempo-wallet-PLFC443A.js} +7 -7
- package/dist/{wallet-UEQTGVJE.js → wallet-UJ7EJNQA.js} +7 -7
- package/dist/{x402-RUJ4LUKF-ZB7JM22B.js → x402-AY6P5KV4-SIZF7YNW.js} +2 -2
- package/package.json +6 -3
- package/skills/dvm/calling.md +17 -1
|
@@ -225,6 +225,7 @@ import {
|
|
|
225
225
|
isCreditFundingMode,
|
|
226
226
|
isDerivedCreditId,
|
|
227
227
|
isDrainReceipt,
|
|
228
|
+
isDrawFundingReceipt,
|
|
228
229
|
isFundingReceipt,
|
|
229
230
|
isInKindDepletion,
|
|
230
231
|
isJobIdentityValue,
|
|
@@ -338,6 +339,7 @@ import {
|
|
|
338
339
|
recordBalanceResponse,
|
|
339
340
|
recordCreditX402Instrument,
|
|
340
341
|
recordDrainReceipts,
|
|
342
|
+
recordDrawFunding,
|
|
341
343
|
recordFundResponse,
|
|
342
344
|
recordFundingMenuSnapshot,
|
|
343
345
|
recordPendingDrain,
|
|
@@ -376,6 +378,7 @@ import {
|
|
|
376
378
|
shellQuoteArg,
|
|
377
379
|
signAttestation,
|
|
378
380
|
signDrainReceipt,
|
|
381
|
+
signDrawFundingReceipt,
|
|
379
382
|
signDvmRequestData,
|
|
380
383
|
signFundingReceipt,
|
|
381
384
|
signReceipt,
|
|
@@ -417,6 +420,8 @@ import {
|
|
|
417
420
|
verifyChallenge,
|
|
418
421
|
verifyDrainReceipt,
|
|
419
422
|
verifyDrainReceiptChain,
|
|
423
|
+
verifyDrawFundingReceipt,
|
|
424
|
+
verifyDrawFundingReceiptChain,
|
|
420
425
|
verifyFundingReceipt,
|
|
421
426
|
verifyFundingReceiptChain,
|
|
422
427
|
verifyIncomingPayment,
|
|
@@ -464,7 +469,7 @@ import {
|
|
|
464
469
|
x402SettledShare,
|
|
465
470
|
x402VoucherPendingState,
|
|
466
471
|
x402WalletFromConfig
|
|
467
|
-
} from "./chunk-
|
|
472
|
+
} from "./chunk-MBSCP52L.js";
|
|
468
473
|
import "./chunk-JBU7RKQ3.js";
|
|
469
474
|
import "./chunk-KDNFUDOG.js";
|
|
470
475
|
import "./chunk-IUTVV6N5.js";
|
|
@@ -526,13 +531,13 @@ import {
|
|
|
526
531
|
x402NetworkListForCopy,
|
|
527
532
|
x402NetworkToCaip2,
|
|
528
533
|
x402SupportedNetworksHint
|
|
529
|
-
} from "./chunk-
|
|
534
|
+
} from "./chunk-GHNF2I5C.js";
|
|
530
535
|
import {
|
|
531
536
|
RevenueReporter
|
|
532
|
-
} from "./chunk-
|
|
537
|
+
} from "./chunk-K562SFVD.js";
|
|
533
538
|
import {
|
|
534
539
|
PayoutReporter
|
|
535
|
-
} from "./chunk-
|
|
540
|
+
} from "./chunk-3R2GM6AD.js";
|
|
536
541
|
import "./chunk-R2DSAZBO.js";
|
|
537
542
|
import {
|
|
538
543
|
DIAGNOSTIC_CATALOGUE_VERSION,
|
|
@@ -543,7 +548,7 @@ import {
|
|
|
543
548
|
projectDiagnosticFields,
|
|
544
549
|
projectEventName,
|
|
545
550
|
projectSpanRow
|
|
546
|
-
} from "./chunk-
|
|
551
|
+
} from "./chunk-UVFFMKU4.js";
|
|
547
552
|
import "./chunk-EVQERRCP.js";
|
|
548
553
|
import "./chunk-RA24J4QM.js";
|
|
549
554
|
import "./chunk-B4WHUMZM.js";
|
|
@@ -811,6 +816,7 @@ export {
|
|
|
811
816
|
isCreditFundingMode,
|
|
812
817
|
isDerivedCreditId,
|
|
813
818
|
isDrainReceipt,
|
|
819
|
+
isDrawFundingReceipt,
|
|
814
820
|
isFundingReceipt,
|
|
815
821
|
isInKindDepletion,
|
|
816
822
|
isJobIdentityValue,
|
|
@@ -936,6 +942,7 @@ export {
|
|
|
936
942
|
recordBalanceResponse,
|
|
937
943
|
recordCreditX402Instrument,
|
|
938
944
|
recordDrainReceipts,
|
|
945
|
+
recordDrawFunding,
|
|
939
946
|
recordFundResponse,
|
|
940
947
|
recordFundingMenuSnapshot,
|
|
941
948
|
recordPendingDrain,
|
|
@@ -980,6 +987,7 @@ export {
|
|
|
980
987
|
shellQuoteArg,
|
|
981
988
|
signAttestation,
|
|
982
989
|
signDrainReceipt,
|
|
990
|
+
signDrawFundingReceipt,
|
|
983
991
|
signDvmRequestData,
|
|
984
992
|
signFundingReceipt,
|
|
985
993
|
signReceipt,
|
|
@@ -1028,6 +1036,8 @@ export {
|
|
|
1028
1036
|
verifyChallenge,
|
|
1029
1037
|
verifyDrainReceipt,
|
|
1030
1038
|
verifyDrainReceiptChain,
|
|
1039
|
+
verifyDrawFundingReceipt,
|
|
1040
|
+
verifyDrawFundingReceiptChain,
|
|
1031
1041
|
verifyFundingReceipt,
|
|
1032
1042
|
verifyFundingReceiptChain,
|
|
1033
1043
|
verifyIncomingPayment,
|
|
@@ -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-
|
|
7
|
-
import "./chunk-
|
|
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-
|
|
17
|
-
import "./chunk-
|
|
18
|
-
import "./chunk-
|
|
16
|
+
import "./chunk-GHNF2I5C.js";
|
|
17
|
+
import "./chunk-K562SFVD.js";
|
|
18
|
+
import "./chunk-3R2GM6AD.js";
|
|
19
19
|
import "./chunk-R2DSAZBO.js";
|
|
20
|
-
import "./chunk-
|
|
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-
|
|
10
|
+
} from "./chunk-3R2GM6AD.js";
|
|
11
11
|
import "./chunk-R2DSAZBO.js";
|
|
12
|
-
import "./chunk-
|
|
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-
|
|
17
|
-
import "./chunk-
|
|
16
|
+
} from "./chunk-JJBRTWWS.js";
|
|
17
|
+
import "./chunk-7N3HQJKE.js";
|
|
18
18
|
import {
|
|
19
19
|
info,
|
|
20
20
|
tryResolveBtcUsdRate
|
|
21
|
-
} from "./chunk-
|
|
22
|
-
import "./chunk-
|
|
21
|
+
} from "./chunk-BPWZNIMS.js";
|
|
22
|
+
import "./chunk-GEZVSJDM.js";
|
|
23
23
|
import {
|
|
24
24
|
loadConfig
|
|
25
|
-
} from "./chunk-
|
|
25
|
+
} from "./chunk-MMXHV3KC.js";
|
|
26
26
|
import {
|
|
27
27
|
effectiveFundingMint,
|
|
28
28
|
effectiveMints,
|
|
29
29
|
formatUsd,
|
|
30
30
|
loadAgentWallet
|
|
31
|
-
} from "./chunk-
|
|
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-
|
|
44
|
-
import "./chunk-
|
|
45
|
-
import "./chunk-
|
|
43
|
+
} from "./chunk-GHNF2I5C.js";
|
|
44
|
+
import "./chunk-K562SFVD.js";
|
|
45
|
+
import "./chunk-3R2GM6AD.js";
|
|
46
46
|
import "./chunk-R2DSAZBO.js";
|
|
47
|
-
import "./chunk-
|
|
47
|
+
import "./chunk-UVFFMKU4.js";
|
|
48
48
|
import "./chunk-EVQERRCP.js";
|
|
49
49
|
import "./chunk-RA24J4QM.js";
|
|
50
50
|
import "./chunk-B4WHUMZM.js";
|
package/dist/{revenue-reporter-HD4GMXGD-LAZU45ZA.js → revenue-reporter-RIEHBKRA-75BDPVVX.js}
RENAMED
|
@@ -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-
|
|
6
|
+
} from "./chunk-K562SFVD.js";
|
|
7
7
|
import "./chunk-R2DSAZBO.js";
|
|
8
|
-
import "./chunk-
|
|
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-
|
|
7
|
-
import "./chunk-
|
|
8
|
-
import "./chunk-
|
|
9
|
-
import "./chunk-
|
|
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-
|
|
19
|
-
import "./chunk-
|
|
20
|
-
import "./chunk-
|
|
18
|
+
import "./chunk-GHNF2I5C.js";
|
|
19
|
+
import "./chunk-K562SFVD.js";
|
|
20
|
+
import "./chunk-3R2GM6AD.js";
|
|
21
21
|
import "./chunk-R2DSAZBO.js";
|
|
22
|
-
import "./chunk-
|
|
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-
|
|
10
|
-
import "./chunk-
|
|
11
|
-
import "./chunk-
|
|
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-
|
|
21
|
-
import "./chunk-
|
|
22
|
-
import "./chunk-
|
|
20
|
+
import "./chunk-GHNF2I5C.js";
|
|
21
|
+
import "./chunk-K562SFVD.js";
|
|
22
|
+
import "./chunk-3R2GM6AD.js";
|
|
23
23
|
import "./chunk-R2DSAZBO.js";
|
|
24
|
-
import "./chunk-
|
|
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-
|
|
11
|
-
import "./chunk-
|
|
12
|
-
import "./chunk-
|
|
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-
|
|
22
|
-
import "./chunk-
|
|
23
|
-
import "./chunk-
|
|
21
|
+
import "./chunk-GHNF2I5C.js";
|
|
22
|
+
import "./chunk-K562SFVD.js";
|
|
23
|
+
import "./chunk-3R2GM6AD.js";
|
|
24
24
|
import "./chunk-R2DSAZBO.js";
|
|
25
|
-
import "./chunk-
|
|
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-
|
|
34
|
-
import "./chunk-
|
|
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.
|
|
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": [
|
|
@@ -60,11 +60,14 @@
|
|
|
60
60
|
"test:contract": "vitest run --config vitest.config.ts test/contract",
|
|
61
61
|
"test:unit": "vitest run --config vitest.config.ts --exclude 'test/contract/**'",
|
|
62
62
|
"typecheck": "tsc --noEmit",
|
|
63
|
-
"verify": "node scripts/verify.mjs"
|
|
63
|
+
"verify": "node scripts/verify.mjs",
|
|
64
|
+
"artifact:runtime": "node scripts/runtime-artifact.mjs",
|
|
65
|
+
"check:runtime": "node scripts/runtime-smoke.mjs",
|
|
66
|
+
"check:runtime-policy": "node scripts/check-runtime-policy.mjs"
|
|
64
67
|
},
|
|
65
68
|
"dependencies": {
|
|
66
69
|
"@cashu/cashu-ts": "4.10.2",
|
|
67
|
-
"@dvmkit/sdk": "0.
|
|
70
|
+
"@dvmkit/sdk": "0.15.0",
|
|
68
71
|
"@x402/evm": "2.21.0",
|
|
69
72
|
"commander": "14.0.3",
|
|
70
73
|
"mppx": "0.8.15",
|
package/skills/dvm/calling.md
CHANGED
|
@@ -27,12 +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
|
-
|
|
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).
|
|
33
|
+
|
|
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.
|
|
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.
|
|
31
39
|
|
|
32
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.
|
|
33
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
|
+
|
|
34
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.
|
|
35
45
|
|
|
36
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.
|
|
37
47
|
|
|
38
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.
|