@agent-fuel/sdk 0.1.1 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to `@agent-fuel/sdk` are documented here. Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this package follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] — 2026-05-31
+
+### Added
+
+- `agent-fuel` CLI binary. Same install (`npm i -g @agent-fuel/sdk` or `npx @agent-fuel/sdk …`), three command surfaces:
+  - **Read** (no key) — `score <agent>`, `vault <owner> <agent>`, `policy <owner> <agent>`, `service <authority>`. Hit the live backend / on-chain account directly, no setup needed: `npx @agent-fuel/sdk vault <owner> <agent>` works out of the box.
+  - **Action** (`--keypair`) — `pay`, `request-spend`, `register-service`. Same primitives as the JS surface, with keypairs loaded from `solana-keygen`-style JSON files.
+  - **Dev** — `keygen [--out path]` (writes a fresh keypair; pubkey to stdout, secret to stderr so you can redirect), `--version`, `--help`.
+- Global flags: `--cluster <name>` (default `devnet`), `--rpc <url>` override, `--api-base <url>` (default `https://api.agentfuel.online`), `--json` for machine-readable output piping into `jq`.
+
+## [0.2.0] — 2026-05-31
+
+### Added
+
+- `pay({ agent, service, owner, amountUsdc, receiptHash, connection })` — atomic `spend` + `record_payment` in one tx, mirroring `Spender::pay()` in the Rust runtime. Vault burn and reputation accrual now land together or not at all; no half-states where USDC moved but the agent ↔ service link never updated.
+- `requestSpend({ agent, owner, service, amountUsdc, connection })` — agent-initiated half of the over-limit approval flow. Returns the `pendingSpend` PDA so callers can poll for resolution.
+- `registerService({ sponsor, service, name, category, serviceUri?, connection })` — register a new service on chain. Two-signer (sponsor pays rent, service is the long-lived identity).
+- `pendingSpendPda(vault, nonce)` PDA helper.
+- `PendingSpendAccount` type + decoder.
+- Convenience wrappers on `AgentFuel`: `fuel.pay()`, `fuel.requestSpend()`, `fuel.registerService()` — same surface as the standalone functions, with the connection and agent supplied by the instance.
+
+### Changed
+
+- Re-vendored IDLs against the latest on-chain deploys so the SDK sees `request_spend`, `approve_spend`, `cancel_spend`, `register_service`, and the new `pending_count` field on `CreditVault`.
+- `CreditVaultAccount` now includes `pending_count: number` — the nonce burned by the next `request_spend`.
+
 ## [0.1.1] — 2026-05-29
 
 ### Changed

package/README.md

@@ -2,7 +2,42 @@
 
 TypeScript SDK for [Agent Fuel](https://github.com/TODO/agent_fuel) — credit vault + reputation primitives for AI agents on Solana.
 
-> **Status:** `0.1.0`. Full read/write/stream surface live, published to npm with provenance.
+> **Status:** `0.3.0`. Full read/write/stream surface live, plus the `agent-fuel` CLI. Published to npm with provenance.
+
+## CLI
+
+Installing the package also installs an `agent-fuel` binary. Read commands work with zero setup over `npx`:
+
+```bash
+npx @agent-fuel/sdk vault   <OWNER_PUBKEY> <AGENT_PUBKEY>
+npx @agent-fuel/sdk score   <AGENT_PUBKEY>
+npx @agent-fuel/sdk policy  <OWNER_PUBKEY> <AGENT_PUBKEY>
+npx @agent-fuel/sdk service <AUTHORITY_PUBKEY>
+```
+
+Action commands take a `solana-keygen`-style keypair JSON:
+
+```bash
+agent-fuel pay \
+  --keypair         ~/.config/solana/agent.json \
+  --service-keypair ~/.config/solana/svc-pyth.json \
+  --owner           <OWNER_PUBKEY> \
+  --amount          0.5
+
+agent-fuel request-spend \
+  --keypair ~/.config/solana/agent.json \
+  --owner   <OWNER_PUBKEY> \
+  --service <SERVICE_PUBKEY> \
+  --amount  30
+
+agent-fuel register-service \
+  --sponsor         ~/.config/solana/id.json \
+  --service-keypair ~/.config/solana/svc-pyth.json \
+  --name            "Pyth BTC Feed" \
+  --category        DataFeed
+```
+
+Plus `agent-fuel keygen [--out path]` to generate a fresh keypair (pubkey to stdout, secret to stderr — redirect with `2>` to save). Global flags: `--cluster devnet|mainnet-beta|testnet|localnet`, `--rpc <url>`, `--api-base <url>`, `--json` for machine-readable output.
 
 ## The six functions