@dvmkit/dvm-cli 0.7.0-rc.3 → 0.8.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/NOTICE +1 -1
- package/README.md +35 -37
- package/dist/{chunk-2I5XAIQ4.js → chunk-4U43FVT4.js} +3 -3
- package/dist/{chunk-IERBEO4C.js → chunk-7ICHLPOY.js} +3 -3
- package/dist/{chunk-LIITTIEN.js → chunk-AGGWYE3D.js} +288 -71
- package/dist/{chunk-BHJLMVO2.js → chunk-AX6COXU3.js} +8 -7
- package/dist/{chunk-ZM5QFHEY.js → chunk-DSNUC4J7.js} +32 -5
- package/dist/{chunk-5QO3MGMH.js → chunk-EDK4X4F3.js} +4 -4
- package/dist/{chunk-3PV36227.js → chunk-HY65VFLL.js} +2 -2
- package/dist/{chunk-5VOAE2CL.js → chunk-JZPSF4C6.js} +2 -2
- package/dist/{chunk-C5XIOTRP.js → chunk-MULGWPBV.js} +2 -2
- package/dist/{chunk-EQXNDN5I.js → chunk-PKZUEXMJ.js} +2 -2
- package/dist/{chunk-6JP6ZBWW.js → chunk-QPT5KD7H.js} +29 -27
- package/dist/{chunk-7OA2XUM4.js → chunk-YJQNDNYK.js} +2 -2
- package/dist/{client-PGOH2ION.js → client-65B5WQPC.js} +6 -6
- package/dist/dvm.js +148 -59
- package/dist/{internal-VIAWW5ED.js → internal-BT3U2FFW.js} +5 -5
- package/dist/{lifecycle-VHGTNHHE.js → lifecycle-2LISVEWB.js} +6 -6
- package/dist/{payout-reporter-3UVWPGMO-WWZWXWCG.js → payout-reporter-HQSIIBFL-XHOVIA5Q.js} +2 -2
- package/dist/{pocket-refill-BHNKMENF.js → pocket-refill-K24FKUXH.js} +10 -10
- package/dist/{revenue-reporter-E56J3NZK-NZ5H27ZI.js → revenue-reporter-X52GPZ5U-JQKBYUBQ.js} +2 -2
- package/dist/{tempo-lifecycle-NDBO3V3A.js → tempo-lifecycle-L5C55URR.js} +8 -8
- package/dist/{tempo-wallet-BAU7ASWF.js → tempo-wallet-XPXR3T3E.js} +7 -7
- package/dist/{wallet-RB2RPWIN.js → wallet-2XALZRFL.js} +7 -7
- package/dist/{x402-BN26TQZ6-4MWLNZGT.js → x402-Q4S36NHQ-KWEN7KSE.js} +2 -2
- package/package.json +18 -4
package/NOTICE
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
dvm
|
|
2
|
-
Copyright 2026
|
|
2
|
+
Copyright 2026 DVM Technologies Ltd
|
package/README.md
CHANGED
|
@@ -1,68 +1,66 @@
|
|
|
1
1
|
# dvm
|
|
2
2
|
|
|
3
|
-
The
|
|
3
|
+
The command-line client and agent skill for Digital Vending Machines: pay-per-use HTTPS services that AI agents can find, pay, and call with no account or API key.
|
|
4
|
+
|
|
5
|
+
Alpha software: run with small balances and review spend regularly. This is a pre-1.0 alpha; breaking changes are announced in the [release notes](./CHANGELOG.md).
|
|
6
|
+
|
|
7
|
+
Requires Node.js 22 or later.
|
|
4
8
|
|
|
5
9
|
## Install
|
|
6
10
|
|
|
7
11
|
```sh
|
|
8
|
-
npm install --
|
|
12
|
+
npm install --global @dvmkit/dvm-cli
|
|
9
13
|
dvm init
|
|
10
14
|
```
|
|
11
15
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
The bundled agent skill is exported as `@dvmkit/dvm-cli/skill`. That export resolves its entry file; copy the whole containing directory into your agent's skill directory so its calling, wallet, credit, and recovery procedures are available too. Keep the skill and CLI on the same package version. The [agent setup guide](https://dvmkit.com/docs/agent-setup) has installation commands for supported harnesses.
|
|
15
|
-
|
|
16
|
-
## Community
|
|
17
|
-
|
|
18
|
-
Bug reports and discussions are welcome, but this repository does not accept unsolicited pull requests, including documentation and typo fixes. Send reproducible defects through the [bug report form](https://github.com/dvmkit/dvm-cli/issues/new/choose), take features and design questions to [Discussions](https://github.com/dvmkit/dvm-cli/discussions), and report suspected vulnerabilities only through the private route in [SECURITY.md](SECURITY.md).
|
|
16
|
+
`dvm init` returns JSON with `status: "created"` on first setup and the message "Local setup is ready. Nothing has been funded yet, so nothing can be spent yet." It also reports the configuration path and wallet setup steps.
|
|
19
17
|
|
|
20
|
-
|
|
18
|
+
## For agents
|
|
21
19
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
`status`, `messages`, `message`, and `cancel` can follow a job from another machine when both its provider endpoint and job token are available. Prefer environment variables so the bearer token does not enter shell history or the process list:
|
|
20
|
+
Copy the bundled [`dvm` skill](skills/dvm/SKILL.md) into your agent's skill directory. For Claude Code:
|
|
25
21
|
|
|
26
22
|
```sh
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
dvm status <job-id>
|
|
23
|
+
mkdir -p ~/.claude/skills
|
|
24
|
+
cp -R "$(npm root --global)/@dvmkit/dvm-cli/skills/dvm" ~/.claude/skills/
|
|
30
25
|
```
|
|
31
26
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
## Protocol compatibility
|
|
27
|
+
Codex uses `~/.codex/skills/` and other Agent Skills harnesses use `~/.agents/skills/`; [agent setup](https://dvmkit.com/docs/agent-setup) has the full list. Load the copied skill before asking your agent to run a job.
|
|
35
28
|
|
|
36
|
-
|
|
29
|
+
Keep the skill and CLI on the same package version. After `npm update --global @dvmkit/dvm-cli`, copy the skill again.
|
|
37
30
|
|
|
38
|
-
##
|
|
39
|
-
|
|
40
|
-
Use the exact Node.js release in `.nvmrc`. Install with `node scripts/pinned-npm.mjs ci --ignore-scripts`, then run the same local gate as CI with `node scripts/pinned-npm.mjs run verify`. The bootstrap downloads the exact npm release declared in `package.json`, verifies its integrity before every extraction, and keeps it under the ignored repository-local `.tooling/` directory.
|
|
31
|
+
## First job
|
|
41
32
|
|
|
42
|
-
|
|
33
|
+
For a first job, ask your agent: "Load the dvm skill, find a service for my task, and show me its price before spending." The skill's calling procedure takes over from discovery through submitting a job and retrieving its result. If payment is needed, its wallet procedure explains the human steps for connecting or funding a wallet. Commands return structured JSON by default; use `--human` for direct terminal reading.
|
|
43
34
|
|
|
44
|
-
|
|
35
|
+
## What's in the package
|
|
45
36
|
|
|
46
|
-
|
|
37
|
+
| Entry point | Purpose |
|
|
38
|
+
| --- | --- |
|
|
39
|
+
| `dvm` | Discover services, submit jobs, manage payments, and retrieve results. |
|
|
40
|
+
| `skills/dvm` | Teach your agent the calling, wallet, credit, and recovery procedures. |
|
|
47
41
|
|
|
48
|
-
|
|
42
|
+
Reference: every command, flag, JSON shape, and error code is in the [dvm CLI reference](https://dvmkit.com/docs/dvm-cli).
|
|
49
43
|
|
|
50
|
-
|
|
44
|
+
## Next steps
|
|
51
45
|
|
|
52
|
-
|
|
46
|
+
- [Agent setup](https://dvmkit.com/docs/agent-setup): load the skill in your agent's harness.
|
|
47
|
+
- [Wallets](https://dvmkit.com/docs/wallets): connect a wallet when a job needs payment.
|
|
48
|
+
- [Budgets](https://dvmkit.com/docs/budgets): set limits before spending.
|
|
53
49
|
|
|
54
|
-
|
|
50
|
+
## Development
|
|
55
51
|
|
|
56
|
-
|
|
52
|
+
See [docs/development.md](docs/development.md) for building and verifying this repository.
|
|
53
|
+
Release automation is documented in [docs/releasing.md](docs/releasing.md).
|
|
57
54
|
|
|
58
|
-
|
|
55
|
+
## Community
|
|
59
56
|
|
|
60
|
-
|
|
57
|
+
Bug reports and discussions are welcome, but this repository does not accept unsolicited pull requests, including documentation and typo fixes. See [CONTRIBUTING.md](CONTRIBUTING.md) for the contribution policy and reporting routes.
|
|
61
58
|
|
|
62
|
-
|
|
59
|
+
Report suspected vulnerabilities only through the private route in [SECURITY.md](SECURITY.md).
|
|
63
60
|
|
|
64
|
-
|
|
61
|
+
See [SUPPORT.md](SUPPORT.md) for support boundaries and the [Code of Conduct](CODE_OF_CONDUCT.md) for community expectations.
|
|
65
62
|
|
|
66
|
-
|
|
63
|
+
## License
|
|
67
64
|
|
|
68
|
-
|
|
65
|
+
Apache-2.0. See [LICENSE](./LICENSE) and [NOTICE](./NOTICE).
|
|
66
|
+
See [TRADEMARKS.md](TRADEMARKS.md) for the distinction between Apache-licensed code and dvmkit names and marks.
|
|
@@ -5,11 +5,11 @@ import {
|
|
|
5
5
|
authorizeProtectedRemoval,
|
|
6
6
|
loadConfig,
|
|
7
7
|
updateConfig
|
|
8
|
-
} from "./chunk-
|
|
8
|
+
} from "./chunk-YJQNDNYK.js";
|
|
9
9
|
import {
|
|
10
10
|
withX402ChannelLock,
|
|
11
11
|
x402WalletFromConfig
|
|
12
|
-
} from "./chunk-
|
|
12
|
+
} from "./chunk-AGGWYE3D.js";
|
|
13
13
|
import {
|
|
14
14
|
DvmError,
|
|
15
15
|
X402_DEFAULT_NETWORK,
|
|
@@ -17,7 +17,7 @@ import {
|
|
|
17
17
|
ensureAddress,
|
|
18
18
|
isValidEvmPrivateKey,
|
|
19
19
|
x402NetworkByCaip2
|
|
20
|
-
} from "./chunk-
|
|
20
|
+
} from "./chunk-QPT5KD7H.js";
|
|
21
21
|
|
|
22
22
|
// src/lib/x402/networks.ts
|
|
23
23
|
function x402NetworkLabel(network) {
|
|
@@ -3,7 +3,7 @@ import { createRequire as __dvmCreateRequire } from "node:module";
|
|
|
3
3
|
const require = __dvmCreateRequire(import.meta.url);
|
|
4
4
|
import {
|
|
5
5
|
connectedTempoAccount
|
|
6
|
-
} from "./chunk-
|
|
6
|
+
} from "./chunk-EDK4X4F3.js";
|
|
7
7
|
import {
|
|
8
8
|
deriveIdentityFromPrivkey,
|
|
9
9
|
formatUsdcMicrounits,
|
|
@@ -13,10 +13,10 @@ import {
|
|
|
13
13
|
reconcileTempoChannelOnChain,
|
|
14
14
|
shellQuoteArg,
|
|
15
15
|
tempoChannelControlledBy
|
|
16
|
-
} from "./chunk-
|
|
16
|
+
} from "./chunk-AGGWYE3D.js";
|
|
17
17
|
import {
|
|
18
18
|
DvmError
|
|
19
|
-
} from "./chunk-
|
|
19
|
+
} from "./chunk-QPT5KD7H.js";
|
|
20
20
|
|
|
21
21
|
// src/lib/cli-identity-resolve.ts
|
|
22
22
|
function resolveSigningIdentity(opts) {
|