botanary 0.2.2 → 0.4.0

package/README.md

@@ -6,6 +6,10 @@ Botanary from your terminal - a guided CLI over the same wallet and agent lanes
 
 `agent whoami` used to print this machine's local key readout. It now asks the backend what Botanary actually says about this agent (claimed? live? which account? which grant?), which is what the name means everywhere else. The local readout moved to `agent identity`, unchanged.
 
+## New in 0.4.0
+
+This release closes the gap between what the web app can write and what this CLI could reach: `solana` (send, swap, and Botanary Mandates Program grant/freeze/revoke), `mandates grant|freeze|unfreeze|revoke|confirm|pause|resume|cancel`, `signers guardian set`, `signers policy set|remove`, `signers condition-set`, `signers migrate`, `rules update`, `agentwallet deposit` and `approvals announce`. `test/sign-kind-parity.spec.ts` is the durable guard behind this: it asserts every registered, available sign-kind the backend serves is reachable from a command here, so this gap cannot silently reopen. See "What this CLI cannot do" below for the two real, remaining exceptions.
+
 ## Install
 
 ```bash
@@ -20,7 +24,7 @@ Run `botanary` with no arguments for a guided REPL, or run any command directly:
 ```bash
 botanary login
 botanary balance
-botanary send --amount 25 --token USDC --recipient 0xAb12...9F3 --chain-id 8453
+botanary send --amount 25 --token 0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913 --recipient 0xAb12...9F3 --chain-id 8453
 botanary agent whoami
 botanary mcp config claude
 ```
@@ -29,6 +33,8 @@ Every command works both ways: answer prompts interactively, or pass flags and a
 
 ## Commands
 
+Every command below is real and registered - `test/help-format.spec.ts` fails the build if one is missing a description or help metadata, and `test/sign-kind-parity.spec.ts` fails it if a mutating command's own backend counterpart (a "sign-kind") exists but nothing here reaches it. Run `botanary <command> --help` for a command's own flags, or `botanary prompt` for every command, every flag, and worked examples in one place.
+
 | Command | Description |
 |---------|-------------|
 | **Wallet** | |
@@ -39,15 +45,107 @@ Every command works both ways: answer prompts interactively, or pass flags and a
 | `chains` | Every chain this backend serves, and what each can do |
 | `gas [options]` | Gas methods available for this account on a chain |
 | `balance` | What this account holds, across every chain |
+| `tokens [options] [query]` | Every token held on a chain, with the address `send` needs |
 | `send [options]` | Send tokens from an account you own |
+| `swap [options]` | Swap tokens in an account you own |
 | `activity` | Recent sends, swaps and yield transactions |
 | `markets` | Public market data: prices and symbols |
 | `yield` | Yield pools, a shortlist, and this account's positions |
-| `mandates` | What the agent lane may spend unattended (testnet only) |
+| `yield deposit [options]` | Deposit into a yield pool |
+| `yield withdraw [options]` | Withdraw from a yield pool |
+| `yield claim [options]` | Claim accrued rewards from a yield pool |
+| `solana` | Send, swap and manage Botanary Mandates on Solana - key-keyed, not chainId-keyed |
+| `solana send [options]` | Send tokens on Solana (raw base-unit amount) |
+| `solana swap [options]` | Swap tokens on Solana (human-scale amount) |
+| `solana mandate` | Grant, freeze/unfreeze and revoke Botanary Mandates Program delegations on Solana |
+| `solana mandate grant [options]` | Grant a bounded Solana mandate |
+| `solana mandate freeze [options]` | Freeze (or `--unfreeze`) every Solana mandate for this owner at once |
+| `solana mandate revoke <id> [options]` | Revoke a Solana mandate |
+| `mandates` | What the agent lane may spend unattended (testnet only) - reads both delegations and mandates |
+| `mandates suggest` | Suggest a bounded mandate for each agent that has none |
+| `mandates propose [options]` | Compile a parsed rule/mandate intent against the capability matrix (a pure read) |
+| `mandates grant [options]` | Grant bounded access to a delegatee agent (a Smart Session, the classic delegation lane) |
+| `mandates freeze <delegationId>` | Freeze a delegation (reversible) |
+| `mandates unfreeze <delegationId>` | Unfreeze a delegation |
+| `mandates revoke <delegationId>` | Revoke a delegation (permanent) |
+| `mandates confirm [options]` | Confirm and enable proposed mandates or rules, from `mandates propose` |
+| `mandates pause <mandateId>` | Pause a mandate (reversible) |
+| `mandates resume <mandateId>` | Resume a paused mandate |
+| `mandates cancel <mandateId>` | Revoke a mandate (permanent) - named `cancel`, not `revoke`, to stay distinct from `mandates revoke`, which targets a delegation, a different id space |
 | `agents` | Connected agents and any pending approval requests |
+| `agents approve <id>` | Approve an agent's request - the owner signs, the agent can never approve its own request |
+| `agents deny <id>` | **Read-only.** There is no deny route on the backend - reads the request back and explains why |
+| `agents claim <code> [options]` | Claim a pending pairing and bind that agent to this account |
+| `agents revoke <id>` | Disconnect an agent from this account |
+| `account` | Deploy, set up, fund, freeze/unfreeze and migrate this account |
+| `account deploy` | Mint a new account with its own address (always the next CREATE2 index) |
+| `account setup [options]` | Install every account module this chain is missing |
+| `account fund [options]` | Mint testnet USDC into this account (testnet faucet top-up) |
+| `account freeze [options]` | Freeze this account (kill-switch) |
+| `account unfreeze [options]` | Unfreeze this account |
+| `account migrate [options]` | Migrate this account to today's address |
+| `account rename [accountId] [options]` | Rename (and/or hide/unhide) an account - off-chain metadata only |
+| `recovery` | Social recovery: guardians and the emergency signer-set replacement |
+| `recovery status` | The live guardian set on this account |
+| `recovery install [options]` | Install social recovery with a guardian set and an M-of-N threshold |
+| `recovery guardian add [options]` | Add a recovery guardian |
+| `recovery guardian remove <guardianId> [options]` | Remove a recovery guardian |
+| `recovery recover [options]` | Replace this account's whole signer set (the emergency lane) |
+| `signers` | This account's enrolled signers (the v1 authority core, BotanaryPolicyValidator) |
+| `signers list` | Every enrolled signer, by index |
+| `signers add [options]` | Enrol a new ECDSA signer on this chain |
+| `signers remove [options]` | Remove a signer from this chain, by index |
+| `signers threshold [options]` | Set the account-wide signer approval threshold |
+| `signers trust-anchor [options]` | Mirror an issuer's currently-active signing key onto this account |
+| `signers guardian set [options]` | Set the policy-validator guardian threshold over a subset of signer indexes (not `recovery guardian` - a different contract) |
+| `signers policy set [options]` | Write (or overwrite) the conditional signing policy at a slot |
+| `signers policy remove [options]` | Remove the conditional signing policy at a slot |
+| `signers condition-set [options]` | Add or remove a condition-set member |
+| `signers migrate [options]` | Upgrade this account's authority core onto BotanaryPolicyValidator (step 1 of 2) |
+| `devices` | Co-signer devices on this account's OwnableValidator root |
+| `devices list` | The live device set and its M-of-N threshold |
+| `devices add [options]` | Add a device as a co-signer |
+| `devices remove [options]` | Remove a device from the co-signer set |
+| `devices threshold [options]` | Set the M-of-N device signing threshold |
+| `panic` | The panic freeze lane: any one listed device can freeze the account, gas-abstractedly |
+| `panic install [options]` | Install the panic freeze lane |
+| `panic freeze [options]` | Freeze the account via the panic lane |
+| `rules` | Owner-lane caps and allowlist on this account's AgentGuard hook |
+| `rules update [options]` | Update account caps and/or the contract/recipient allowlist, from JSON files |
+| `notifications [options]` | Alerts - blocked actions, depeg warnings, and the like |
+| `notifications read <id>` | Mark one notification as read |
+| `notifications read-all` | Mark every notification as read |
+| `paysh` | pay.sh: the x402 spending balance and its guardrails |
+| `paysh accounts` | This account's recorded pay.sh accounts (read-only - creation is Privy-client-side) |
+| `paysh topup [options]` | Top up the pay.sh balance |
+| `paysh withdraw [options]` | Withdraw from a pay.sh account's custodial Solana USDC balance |
+| `paysh allowlist <accountId>` | **Read-only.** The trusted pay.sh domains for this account |
+| `paysh settings <accountId>` | **Read-only.** This account's persisted default copilot pay.sh mode |
+| `marketplace` | Hire an ACP agent under a bounded mandate, and run its jobs |
+| `marketplace hire [options]` | Hire an ACP agent under a bounded mandate |
+| `marketplace deposit [options]` | Deposit into a Virtuals-custodied wallet |
+| `marketplace jobs create [options]` | Create an ACP job under a mandate (op 1 of a hire) |
+| `marketplace jobs fund [options]` | Fund an ACP job under a mandate (op 2 of a hire) |
+| `apis` | The x402 paid-API catalog, and the on-chain spending budget backing it |
+| `apis budget <chainId> <agentId>` | Read the current API budget and its state |
+| `apis budget commit [options]` | Commit a three-transaction atomic API spending budget |
+| `apis providers [options]` | Ranked, searchable catalog of x402 API providers |
+| `onramp [options]` | Start a fiat-to-crypto Buy checkout session - no UserOp, no signature |
+| `onramp methods` | Chains currently buyable through the wired onramp provider |
+| `agentwallet` | Deposit into a Virtuals agent wallet |
+| `agentwallet deposit [options]` | Deposit into a Virtuals agent wallet (distinct from `marketplace deposit`) |
+| `approvals` | Announce a collected off-chain approval |
+| `approvals announce <digest> [options]` | Announce a collected approval, by its digest |
 | `open [target]` | Open Botanary in your browser |
 | `accounts` | Manage which owner account subsequent commands use |
+| `accounts list` | Every account this login can see |
+| `accounts use <accountId>` | Switch the active account |
 | `api [options] [path]` | Read any documented GET endpoint as the owner |
+| `sign` | Owner-authorized writes: park a typed intent and wait for your browser to sign it - the ONE write path underneath every command above |
+| `sign list` | Sign requests this machine parked and is still waiting on |
+| `sign show <id>` | Read one sign request by id, with its op status |
+| `sign resume <handle>` | Rejoin an interrupted wait on a sign request this machine parked |
+| `watch` | Tail live events in the foreground: agent requests, balance changes, sign-request status |
 | **Agent** | |
 | `agent` | This machine's own agent identity, grant, and spend under it |
 | `agent identity` | This machine's local agent key: address, public key, fingerprint |
@@ -87,6 +185,30 @@ Every command works both ways: answer prompts interactively, or pass flags and a
 | `update-check` | Check whether a newer botanary is published |
 | `update` | Update botanary to the latest published version |
 
+## What this CLI cannot do
+
+Terminal-first parity is not total parity. Two genuine gaps remain, both by design rather than oversight:
+
+- **`agents deny` does not exist as a write.** The backend (`AgentsController`) has no deny, decline or
+  reject route for an agent's request at all - only `requests/{id}/approve`. An owner can approve an
+  agent's request from the terminal but cannot deny one; a request is either approved or left to expire on
+  its own. `agents deny <id>` ships as a read-only command that explains this rather than failing with an
+  opaque "unknown command".
+- **`paysh allowlist` and `paysh settings` are refused as writes for any CLI session.** The backend's own
+  `CliSessionForbidden` gate 403s them because pay.sh and agent-wallet writes move value with no owner
+  signature anywhere in the loop - a CLI session (`kind: 'cli'`, minted by `botanary login`) is read-only
+  there by design. Both ship as reads only; make the change in the web app.
+
+Separately, **`solana.send`/`solana.swap` cover Solana; Stellar sends and swaps are not reachable from
+anywhere** - not this CLI, not `botanary-mcp`, not the web app. Review panels exist on the backend's own
+sign-kind registry, but there is no client-side Stellar signing infrastructure anywhere in this workspace
+(no `@stellar/stellar-sdk`, no Stellar signer in the auth store), so nothing can actually sign a Stellar
+operation yet. This is a signing-infrastructure gap, not a CLI gap.
+
+`test/sign-kind-parity.spec.ts` is what proves these are the only gaps: it walks the backend's sign-kind
+registry and fails the build if any AVAILABLE kind (i.e. not one of the two Stellar kinds above, which the
+registry itself marks unavailable) has no reachable command.
+
 ## Non-interactive use
 
 Use `--json` to get machine-readable output, `--yes` to skip the review step on money commands, and `--dry-run` to preflight without sending. The failure contract is strict: on success, stdout is the response payload (or a plain string); on failure, stdout carries an error object.
@@ -198,6 +320,10 @@ pnpm test
 pnpm dev     # run bin/botanary.ts directly, watching for changes
 ```
 
+## Why send requires a token address, not a symbol
+
+The `send` command requires a contract address or CAIP-19 asset ref, never a symbol. This is by design: a symbol is a label a contract picks for itself, and two contracts on one chain can legally share the same symbol. The product will not guess which one you meant. Use `botanary tokens --chain-id <id> [query]` to list every token this account holds on a chain, each with the contract address `--token` needs.
+
 `BOTANARY_MCP_HOME` and `BOTANARY_API_URL` behave exactly as documented in `botanary-mcp`'s own README - this package depends on that one as its engine and adds no storage or network logic of its own.
 
 ## Release note
@@ -215,3 +341,15 @@ Repeat that order for any future release where the CLI needs a change in the eng
 against an unpublished `botanary-mcp` installs broken.
 
 See `docs/superpowers/specs/2026-08-19-botanary-cli-completion-design.md` section 5 for the rationale.
+
+### 0.4.0 (the terminal-first sign-kind parity release)
+
+Same fixed order, and it matters for the same reason: npm's caret on a `0.x` version is restrictive, so
+`"botanary-mcp": "^0.7.0"` means `>=0.7.0 <0.8.0` and would never resolve to `0.8.0` on its own.
+
+1. `botanary-mcp@0.8.0` publishes to npm first.
+2. `tools/botanary-cli/package.json`'s `botanary-mcp` dependency bumps from `^0.7.0` to `^0.8.0`,
+   alongside `botanary`'s own bump to `0.4.0`. **Both version numbers are already bumped in this repo** -
+   the CLI's actual dependency resolution (a real `pnpm install` against the published `0.8.0`) happens in
+   the publish task, not here, since `0.8.0` does not exist on the registry until step 1 runs.
+3. `botanary@0.4.0` publishes.

package/dist/bin/botanary.js

@@ -2,9 +2,12 @@
 import { createDefaultRuntime } from 'botanary-mcp';
 import { runCli } from '../src/cli.js';
 import { EXIT } from '../src/errors.js';
+// Read from package.json with `fs` at runtime, NOT `import('../package.json')`: that import made tsc
+// copy the manifest into outDir, publishing a stray nested `dist/package.json`. See the header of
+// src/package-version.ts.
+import { CLI_VERSION } from '../src/package-version.js';
 // Deliberately the only file in this package that is not unit tested directly - it wires the real runtime
 // factory into runCli and traps SIGINT, and nothing else.
-const packageJson = await import('../package.json', { with: { type: 'json' } });
 // @clack/prompts leaves the cursor hidden and the terminal in raw mode if a prompt is interrupted, so a
 // bare Ctrl-C would hand back an unusable shell. Restore both, then exit with the conventional 130.
 process.on('SIGINT', () => {
@@ -16,7 +19,7 @@ process.on('SIGINT', () => {
 });
 const exitCode = await runCli(process.argv.slice(2), {
     createRuntime: (options) => createDefaultRuntime(options),
-    cliVersion: packageJson.default.version,
+    cliVersion: CLI_VERSION,
 });
 process.exit(exitCode);
 //# sourceMappingURL=botanary.js.map

package/dist/bin/botanary.js.map

@@ -1 +1 @@
-{"version":3,"file":"botanary.js","sourceRoot":"","sources":["../../bin/botanary.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,0GAA0G;AAC1G,0DAA0D;AAC1D,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;AAEhF,wGAAwG;AACxG,oGAAoG;AACpG,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAClC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACnD,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC;IACzD,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,OAAiB;CAClD,CAAC,CAAC;AACH,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"botanary.js","sourceRoot":"","sources":["../../bin/botanary.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,qGAAqG;AACrG,kGAAkG;AAClG,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,0GAA0G;AAC1G,0DAA0D;AAE1D,wGAAwG;AACxG,oGAAoG;AACpG,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAClC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACnD,aAAa,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC;IACzD,UAAU,EAAE,WAAW;CACxB,CAAC,CAAC;AACH,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC"}

package/dist/package.json

@@ -1,15 +1,22 @@
 {
     "name": "botanary",
     "type": "module",
-    "version": "0.2.2",
+    "version": "0.3.0",
     "description": "Botanary from your terminal - a guided CLI over the same wallet and agent lanes botanary-mcp exposes to a coding agent.",
     "license": "UNLICENSED",
     "homepage": "https://docs.botanary.xyz",
-    "keywords": ["botanary", "cli", "wallet"],
+    "keywords": [
+        "botanary",
+        "cli",
+        "wallet"
+    ],
     "bin": {
         "botanary": "dist/bin/botanary.js"
     },
-    "files": ["dist", "README.md"],
+    "files": [
+        "dist",
+        "README.md"
+    ],
     "engines": {
         "node": ">=22.0.0"
     },
@@ -23,13 +30,13 @@
         "test:watch": "vitest"
     },
     "dependencies": {
-        "botanary-mcp": "^0.6.1",
-        "commander": "^13.1.0",
         "@clack/prompts": "^0.9.1",
-        "picocolors": "^1.1.1",
-        "gradient-string": "^3.0.0",
+        "botanary-mcp": "^0.7.0",
+        "cli-table3": "^0.6.5",
+        "commander": "^13.1.0",
         "figlet": "^1.7.0",
-        "cli-table3": "^0.6.5"
+        "gradient-string": "^3.0.0",
+        "picocolors": "^1.1.1"
     },
     "devDependencies": {
         "@swc-node/register": "^1.10.9",

package/dist/src/app-url.js

@@ -1,6 +1,23 @@
 import { invalidArgs } from './errors.js';
-/** Surfaces `botanary open <target>` knows about. Each is a real route in the app. */
-export const APP_TARGETS = ['mandates', 'agents', 'history', 'yield', 'markets', 'settings'];
+/** Surfaces `botanary open <target>` knows about. Each is a real route in the app - see
+ *  `botanary-fe/src/app` for the current route list (`find src/app -name page.tsx` there is the source
+ *  of truth). `/delegations`, `/rules` and `/earn` retired; `/activity` permanently redirects to
+ *  `/history`, so it is never listed here on its own. */
+export const APP_TARGETS = [
+    'mandates',
+    'agents',
+    'history',
+    'yield',
+    'markets',
+    'settings',
+    'grant',
+    'recovery',
+    'apis',
+    'copilot',
+    'stocks',
+    'marketplace',
+    'launchpad',
+];
 /**
  * The app origin for an API base URL, by dropping a leading `api.` label: `api.app.botanary.xyz` is served
  * by Caddy in front of the same deployment as `app.botanary.xyz`.

package/dist/src/app-url.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-url.js","sourceRoot":"","sources":["../../src/app-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,sFAAsF;AACtF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AAEtG;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtF,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,UAAkB,EAAE,MAAe;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAC3B,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,MAAM,WAAW,CACf,mBAAmB,MAAM,kBAAkB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACpE,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"app-url.js","sourceRoot":"","sources":["../../src/app-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;yDAGyD;AACzD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU;IACV,QAAQ;IACR,SAAS;IACT,OAAO;IACP,SAAS;IACT,UAAU;IACV,OAAO;IACP,UAAU;IACV,MAAM;IACN,SAAS;IACT,QAAQ;IACR,aAAa;IACb,WAAW;CACH,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtF,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,UAAkB,EAAE,MAAe;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAC3B,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,MAAM,WAAW,CACf,mBAAmB,MAAM,kBAAkB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACpE,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAC/B,CAAC"}

package/dist/src/cli.js

@@ -3,10 +3,17 @@ import { CommanderError } from 'commander';
 import { createContext } from './context.js';
 import { createProgram } from './parser.js';
 import { registerWalletCommands } from './commands/wallet.js';
+import { registerSignCommands } from './commands/sign.js';
+import { registerTokenCommands } from './commands/tokens.js';
 import { registerAgentCommands } from './commands/agent.js';
 import { registerMcpCommands } from './commands/mcp.js';
 import { registerSystemCommands } from './commands/system.js';
 import { registerUtilityCommands } from './commands/utilities.js';
+import { registerAccountCommands } from './commands/account.js';
+import { registerWatchCommands } from './commands/watch.js';
+import { registerAuthorityCommands } from './commands/authority.js';
+import { registerSessionWriteCommands } from './commands/session-writes.js';
+import { registerServiceCommands } from './commands/services.js';
 import { runRepl } from './repl.js';
 import { colors, setColorEnabled } from './render/colors.js';
 import { readConfig } from './config-store.js';
@@ -81,10 +88,20 @@ export async function runCli(argv, deps) {
     const program = createProgram();
     program.version(deps.cliVersion, '-v, --version', 'Print the installed botanary CLI version');
     registerWalletCommands(program);
+    registerSignCommands(program);
+    registerTokenCommands(program);
     registerAgentCommands(program);
     registerMcpCommands(program);
     registerSystemCommands(program, deps.cliVersion);
     registerUtilityCommands(program, deps.cliVersion);
+    // Order matters from here down: later modules (authority, session-writes, services) look up an
+    // existing top-level Command (`account`, `agents`, `mandates`) by name to attach subcommands onto,
+    // rather than creating a second command of the same name - see each module's own doc comment for why.
+    registerAccountCommands(program);
+    registerWatchCommands(program);
+    registerAuthorityCommands(program);
+    registerSessionWriteCommands(program);
+    registerServiceCommands(program);
     program.exitOverride();
     // Recorded here, rather than sniffed from argv, because a global flag (`--json`, `--yes`, ...) can sit
     // before OR after the command name - `preAction` fires with the actual leaf command about to run,

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAyB,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWpD;;;;;;;GAOG;AACH,SAAS,SAAS,CAAC,QAA0B,EAAE,MAA8B;IAC3E,IAAI,QAAQ,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IACrE,OAAO,CAAC,KAAK,EAAE,KAA6B,EAAE,IAAkB,EAAE,EAAE;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC5G,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5E,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC1E,MAAM,CAAC,WAAW,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;YACvH,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;gBAAS,CAAC;YACT,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAiB,CAAC;AACrB,CAAC;AAED;;mCAEmC;AACnC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;AAEhE;;;;;;;;GAQG;AACH,KAAK,UAAU,QAAQ,CAAC,GAAe,EAAE,UAAkB,EAAE,MAA8B,EAAE,WAA0B;IACrH,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO;IACpF,IAAI,WAAW,KAAK,IAAI,IAAI,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO;IACzE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7F,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2DAA2D;IAC7D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc,EAAE,IAAa;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;IAEpF,qGAAqG;IACrG,mFAAmF;IACnF,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAC/C,MAAM,aAAa,GAAG,gBAAgB,IAAI,gBAAgB,CAAC;IAE3D,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,EAAE,0CAA0C,CAAC,CAAC;IAC9F,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACjD,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,OAAO,CAAC,YAAY,EAAE,CAAC;IAEvB,uGAAuG;IACvG,kGAAkG;IAClG,0CAA0C;IAC1C,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,EAAE;QACxD,cAAc,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,IAAI,GAAG,GAAsB,IAAI,CAAC;IAClC,IAAI,CAAC;QACH,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAE5B,kGAAkG;QAClG,gBAAgB;QAChB,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,CAAC;QAED,qGAAqG;QACrG,0EAA0E;QAC1E,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC;QAC5C,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC;YAC/B,IAAI;YACJ,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,IAAI,EAAE,MAAM,UAAU,EAAE;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEhC,MAAM,OAAO,GACX,IAAI,CAAC,OAAO;YACZ,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvD,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,GAAG,CAAC,GAAG,EAAE;oBACP,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAC5C,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,CAAC,CAAC,EAAE;aACL,CAAC,CAAC;QAEL,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACtC,OAAO,CAAC,IAAiD,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAE7F,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACjE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACnD,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,CAAC;QAED,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QAC7D,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;IAC1B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,cAAc,EAAE,CAAC;YAChC,kFAAkF;YAClF,gFAAgF;YAChF,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,KAAK,0BAA0B,IAAI,CAAC,CAAC,IAAI,KAAK,yBAAyB,IAAI,CAAC,CAAC,IAAI,KAAK,uCAAuC,CAAC;YACzJ,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,aAAa,EAAE,CAAC;oBAClB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxG,CAAC;gBACD,OAAO,IAAI,CAAC,WAAW,CAAC;YAC1B,CAAC;YACD,8BAA8B;YAC9B,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;gBAClE,OAAO,IAAI,CAAC,EAAE,CAAC;YACjB,CAAC;YACD,wCAAwC;YACxC,OAAO,CAAC,CAAC,QAAQ,CAAC;QACpB,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,GAAG,EAAE,IAAI,IAAI,aAAa,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/account.js

@@ -0,0 +1,171 @@
+import { submitIntent, describeSignOutcome } from './sign.js';
+import { group } from '../help/groups.js';
+import { printResult } from '../render/print.js';
+import { step } from '../progress.js';
+import { confirmOrThrow, dryRunPayload, renderReview } from '../review.js';
+import { assertTierAllows, findChain } from '../validate.js';
+import { invalidArgs, notLoggedIn } from '../errors.js';
+/** Mirrors `wallet.ts`'s/`sign.ts`'s own `requireWalletToken` - duplicated for the same reason
+ *  `tokens.ts` duplicates it: every write here funnels through `submitIntent` (sign.ts), so importing a
+ *  shared helper FROM sign.ts back into a file sign.ts might one day need to import from is exactly the
+ *  circular-dependency shape sign.ts's own comment warns against. */
+async function requireWalletToken(ctx) {
+    const session = await ctx.runtime.walletSession();
+    if (!session)
+        throw notLoggedIn();
+    return session.sessionToken;
+}
+/** Parse `--op-count`, shared by `account setup` and `account migrate` - both DTOs (`CliAccountSetupIntentDto`,
+ *  `CliAccountMigrateIntentDto`) declare it optional-positive-integer, defaulting server-side to 1 when
+ *  omitted (see `sign-request.dto.ts`'s own doc comments on each). */
+function parseOpCount(raw) {
+    if (raw === undefined)
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value <= 0) {
+        throw invalidArgs(`--op-count must be a positive integer, got ${JSON.stringify(raw)}.`);
+    }
+    return value;
+}
+/** Review, confirm (or dry-run), park the intent, and print the outcome - the same four steps every
+ *  `submitIntent` caller in `wallet.ts` already repeats for `swap`/`yield deposit`/`yield withdraw`. */
+async function reviewAndSubmit(ctx, title, rows, warnings, kind, params) {
+    if (ctx.dryRun) {
+        printResult(ctx, dryRunPayload(title, rows, warnings), () => renderReview('Dry run - nothing will be sent', rows, warnings));
+        return;
+    }
+    await confirmOrThrow(ctx, title, rows, warnings);
+    const outcome = await submitIntent(ctx, kind, params);
+    printResult(ctx, outcome.data, () => describeSignOutcome(outcome));
+}
+/**
+ * `account` (singular) - owner-signed lifecycle actions on the account itself: deploy a new one, install
+ * missing modules, top up on testnet, freeze/unfreeze the kill-switch, and migrate to today's address.
+ * Every action here is a `submitIntent` write; there is no read half beyond what `accounts list` (the
+ * PLURAL group in wallet.ts) already gives.
+ *
+ * `account rename` is deliberately NOT here - it is a plain session write (`PATCH /accounts/{id}`, no
+ * signature involved), wired onto this same Command object by `session-writes.ts` (Task 19). Registration
+ * order in cli.ts matters: this module must run first so that command exists to attach to.
+ */
+export function registerAccountCommands(program) {
+    const account = group(program.command('account').description("Deploy, set up, fund, freeze/unfreeze and migrate this account"), 'Wallet');
+    account
+        .command('deploy')
+        .description('Mint a new account with its own address (always the next CREATE2 index)')
+        .action(async () => {
+        const ctx = program.opts().__ctx;
+        await requireWalletToken(ctx);
+        const rows = [{ label: 'action', value: 'deploy a new account' }, { label: 'signed by', value: 'you, in your browser' }];
+        await reviewAndSubmit(ctx, 'Review this account deploy', rows, [], 'account.deploy', {});
+    });
+    account
+        .command('setup')
+        .description('Install every account module this chain is missing')
+        .requiredOption('--chain-id <chainId>', 'Chain to set up - see `botanary chains`')
+        .option('--op-count <n>', 'How many ops this setup will produce - omit to let the backend size it (usually 1)')
+        .action(async (opts) => {
+        const ctx = program.opts().__ctx;
+        const token = await requireWalletToken(ctx);
+        const chains = await step(ctx, 'Reading chains', () => ctx.runtime.api.get('/v1/chains', token));
+        const chain = findChain(chains, opts.chainId);
+        assertTierAllows(chain, 'send');
+        if (chain.chainId === null) {
+            throw invalidArgs(`${chain.name} (${chain.key}) has no EVM chain id - account setup is EVM-only today.`, 'Pick an EVM chain - see `botanary chains`.');
+        }
+        const opCount = parseOpCount(opts.opCount);
+        const rows = [
+            { label: 'action', value: 'install missing account modules' },
+            { label: 'chain', value: `${chain.name} (${chain.key}, ${chain.tier})` },
+            { label: 'signed by', value: 'you, in your browser' },
+        ];
+        const warnings = chain.testnet ? ['This is a testnet chain.'] : [];
+        await reviewAndSubmit(ctx, 'Review this account setup', rows, warnings, 'account.setup', {
+            chainId: chain.chainId,
+            ...(opCount !== undefined ? { opCount } : {}),
+        });
+    });
+    account
+        .command('fund')
+        .description('Mint testnet USDC into this account (testnet faucet top-up, never a real transfer)')
+        .option('--account-id <accountId>', 'Specific account of yours - omit for your default')
+        .action(async (opts) => {
+        const ctx = program.opts().__ctx;
+        await requireWalletToken(ctx);
+        const rows = [
+            { label: 'action', value: 'mint testnet USDC into this account' },
+            { label: 'signed by', value: 'you, in your browser' },
+        ];
+        const warnings = ['Testnet faucet only - this never moves real funds.'];
+        await reviewAndSubmit(ctx, 'Review this account fund', rows, warnings, 'account.fund', {
+            ...(opts.accountId ? { accountId: opts.accountId } : {}),
+        });
+    });
+    account
+        .command('freeze')
+        .description('Freeze this account (kill-switch) - no further transfers are authorized until unfrozen')
+        .option('--account-id <accountId>', 'Specific account of yours - omit for your default')
+        .option('--lane <lane>', 'owner or panic - which frozen-flag lane to set, omit for the default')
+        .action(async (opts) => {
+        const ctx = program.opts().__ctx;
+        await requireWalletToken(ctx);
+        if (opts.lane !== undefined && opts.lane !== 'owner' && opts.lane !== 'panic') {
+            throw invalidArgs(`--lane must be "owner" or "panic", got ${JSON.stringify(opts.lane)}.`);
+        }
+        const rows = [
+            { label: 'action', value: 'freeze this account' },
+            ...(opts.lane ? [{ label: 'lane', value: opts.lane }] : []),
+            { label: 'signed by', value: 'you, in your browser' },
+        ];
+        const warnings = ['This is the kill-switch. No further transfers will be authorized until you unfreeze.'];
+        await reviewAndSubmit(ctx, 'Review this account freeze', rows, warnings, 'account.freeze', {
+            ...(opts.accountId ? { accountId: opts.accountId } : {}),
+            ...(opts.lane ? { lane: opts.lane } : {}),
+        });
+    });
+    account
+        .command('unfreeze')
+        .description('Unfreeze this account, restoring its ability to authorize transfers')
+        .option('--account-id <accountId>', 'Specific account of yours - omit for your default')
+        .action(async (opts) => {
+        const ctx = program.opts().__ctx;
+        await requireWalletToken(ctx);
+        const rows = [
+            { label: 'action', value: 'unfreeze this account' },
+            { label: 'signed by', value: 'you, in your browser' },
+        ];
+        await reviewAndSubmit(ctx, 'Review this account unfreeze', rows, [], 'account.unfreeze', {
+            ...(opts.accountId ? { accountId: opts.accountId } : {}),
+        });
+    });
+    account
+        .command('migrate')
+        .description("Migrate this account to today's address (zero, one or two ops, depending on its current phase)")
+        .requiredOption('--chain-id <chainId>', 'Chain to migrate on - see `botanary chains`')
+        .option('--account-id <accountId>', 'Specific account of yours - omit for your default')
+        .option('--op-count <n>', 'How many ops this migration will produce - omit to let the backend size it (usually 1)')
+        .action(async (opts) => {
+        const ctx = program.opts().__ctx;
+        const token = await requireWalletToken(ctx);
+        const chains = await step(ctx, 'Reading chains', () => ctx.runtime.api.get('/v1/chains', token));
+        const chain = findChain(chains, opts.chainId);
+        assertTierAllows(chain, 'send');
+        if (chain.chainId === null) {
+            throw invalidArgs(`${chain.name} (${chain.key}) has no EVM chain id - account migration is EVM-only today.`, 'Pick an EVM chain - see `botanary chains`.');
+        }
+        const opCount = parseOpCount(opts.opCount);
+        const rows = [
+            { label: 'action', value: "migrate this account to today's address" },
+            { label: 'chain', value: `${chain.name} (${chain.key}, ${chain.tier})` },
+            { label: 'signed by', value: 'you, in your browser' },
+        ];
+        const warnings = chain.testnet ? ['This is a testnet chain.'] : [];
+        await reviewAndSubmit(ctx, 'Review this account migration', rows, warnings, 'account.migrate', {
+            chainId: chain.chainId,
+            ...(opts.accountId ? { accountId: opts.accountId } : {}),
+            ...(opCount !== undefined ? { opCount } : {}),
+        });
+    });
+    return account;
+}
+//# sourceMappingURL=account.js.map

package/dist/src/commands/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/commands/account.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/agent.js

@@ -115,7 +115,7 @@ export function registerAgentCommands(program) {
         .description('Spend under this agent\'s own grant, unattended (propose_payment)')
         .option('--recipient <address>', 'Destination address (0x... on EVM)')
         .option('--amount <amount>', 'Amount in display units, e.g. 5')
-        .option('--token <symbol>', 'Token symbol the grant budgets, e.g. USDC')
+        .option('--token <addressOrAssetRef>', 'Token the grant budgets - contract address or CAIP-19 asset ref, never a symbol')
         .option('--chain-id <chainId>', 'Chain the grant is on - see `botanary agent grant`')
         .action(async (opts) => {
         const ctx = program.opts().__ctx;
@@ -161,7 +161,7 @@ export function registerAgentCommands(program) {
             return;
         }
         await confirmOrThrow(ctx, 'Review this spend', rows, warnings);
-        const result = await step(ctx, 'Spending under the grant', () => proposePayment(ctx.runtime, { recipient: to, amount, tokenSymbol, chainId: chain.chainId ?? Number.NaN }));
+        const result = await step(ctx, 'Spending under the grant', () => proposePayment(ctx.runtime, { recipient: to, amount, token: tokenSymbol, chainId: chain.chainId ?? Number.NaN }));
         const outcome = classifyAgentAction(result);
         ctx.outcome.exit = outcome.exit;
         printResult(ctx, result);
@@ -169,8 +169,8 @@ export function registerAgentCommands(program) {
     agent
         .command('swap')
         .description('Swap under this agent\'s own grant, unattended (propose_swap)')
-        .option('--token-in <symbol>', 'Token to sell')
-        .option('--token-out <symbol>', 'Token to buy')
+        .option('--token-in <addressOrAssetRef>', 'Token to sell - contract address or CAIP-19 asset ref, never a symbol')
+        .option('--token-out <addressOrAssetRef>', 'Token to buy - contract address or CAIP-19 asset ref, never a symbol')
         .option('--amount-in <amount>', 'Amount of --token-in to sell, in display units')
         .option('--chain-id <chainId>', 'Chain the grant is on - see `botanary agent grant`')
         .option('--max-slippage-bps <bps>', 'Maximum acceptable slippage, in basis points')
@@ -203,8 +203,8 @@ export function registerAgentCommands(program) {
         }
         await confirmOrThrow(ctx, 'Review this swap', rows, warnings);
         const result = await step(ctx, 'Swapping under the grant', () => proposeSwap(ctx.runtime, {
-            tokenIn,
-            tokenOut,
+            assetIn: tokenIn,
+            assetOut: tokenOut,
             amountIn: amount,
             chainId: chain.chainId ?? Number.NaN,
             ...(maxSlippageBps ? { maxSlippageBps: Number(maxSlippageBps) } : {}),