@agentgates/cli 0.74.0 → 0.84.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 (3) hide show
  1. package/README.md +31 -0
  2. package/dist/cli.mjs +1477 -426
  3. package/package.json +6 -2
package/README.md CHANGED
@@ -26,9 +26,40 @@ agentgates subscribe <creator-user-id> [--months 1|3|12] # prepaid, at the cre
26
26
  agentgates trade status|key|quote|buy|sell|positions # launch-coin trading on Solana devnet, see below
27
27
  agentgates desk status|deposit|withdraw|session|buy|sell # the trading desk: bounds on chain, see below
28
28
  agentgates passwords init|add|allow|use|list|invite # logins an agent stores and uses blind, no human, see below
29
+ agentgates compute plans|buy|renew|list|status|wait # confidential virtual machines, paid per request in USDC, see below
29
30
  agentgates --help # full command list
30
31
  ```
31
32
 
33
+ ## Compute (confidential virtual machines)
34
+
35
+ A machine is rented with one x402 payment signed by this machine's own key
36
+ (the twelve words `agentgates init` mints, or `AGENTGATES_PASSWORDS_SEED`).
37
+ The key pays USDC on an EVM network with no gas, and the key that pays owns
38
+ the machine: `list`, `status` and `wait` are reads it signs. Every price,
39
+ network and address comes from the API's 402 or its catalog at the moment
40
+ of the call.
41
+
42
+ ```sh
43
+ agentgates compute plans # live plans and prices per network (no key)
44
+ agentgates compute buy --plan <id> --hours 1 --image nginx:alpine --quote # the price on every network; signs nothing
45
+ agentgates compute buy --plan <id> --hours 1 --image nginx:alpine --wait # asks, pays, waits until it runs
46
+ agentgates compute buy --plan <id> --hours 6 --compose ./docker-compose.yml --env TOKEN=... --yes --json
47
+ agentgates compute renew <id> --hours 1 # more paid hours; any wallet may pay a renewal
48
+ agentgates compute list # the machines this key paid for
49
+ agentgates compute status <id> # status, endpoint, paid time, attestation
50
+ agentgates compute wait <id> # until it runs (the clock starts then)
51
+ ```
52
+
53
+ `buy` asks the price for free first, picks the cheapest network this key
54
+ holds the USDC for (`--network` names one, `--max-usd` caps it), and asks
55
+ before it signs; an agent passes `--yes` (required when stdout is not a
56
+ terminal). A paid request that gets no clear answer is sent again with the
57
+ same payment, never a new one: the API hands back what that payment bought.
58
+ A solana leg needs a Solana key, so this CLI pays the EVM legs. Output is
59
+ JSON when stdout is not a terminal, and a refusal exits 1 with its `code`
60
+ (`insufficient_funds`, `confirm_required`, `over_max`, `no_answer`, the
61
+ API's own codes).
62
+
32
63
  ## Passwords (no pairing, no browser, no human)
33
64
 
34
65
  `agentgates passwords` runs the Passwords lane with twelve words it mints on