botanary 0.2.2 → 0.4.0

package/dist/src/help/examples.js

@@ -31,6 +31,14 @@ export const COMMAND_HELP = {
         examples: ['botanary balance', 'botanary balance --json | jq .balance.totalFiat', 'botanary balance --raw'],
         seeAlso: 'botanary activity, botanary chains - wallet_portfolio (MCP)',
     },
+    tokens: {
+        body: '`send`\'s discovery command. Every token this account holds on one chain, with the contract address\n' +
+            '`--token` actually needs. `send` is address-only on purpose - a symbol is a label a contract picks\n' +
+            'for itself, and two tokens on one chain can legally share one - so this is where the address comes\n' +
+            'from, rather than a block explorer.',
+        examples: ['botanary tokens --chain-id 8453', 'botanary tokens --chain-id 8453 usdc', 'botanary tokens --chain-id 8453 --json'],
+        seeAlso: 'botanary send, botanary balance',
+    },
     send: {
         body: 'Send tokens from an account you own. Botanary never holds your key: the CLI builds an unsigned\n' +
             'operation, then either a mandate signs it locally or you approve it in your browser.\n' +
@@ -39,14 +47,96 @@ export const COMMAND_HELP = {
             '  mandate   a live mandate covers this exact amount, token and chain\n' +
             '  browser   anything else, which opens Botanary for you to approve',
         examples: [
-            'botanary send                                                  # guided',
-            'botanary send --amount 25 --token USDC --recipient 0xAb..3F --chain-id 8453',
-            'botanary send --amount 25 --token USDC --recipient 0xAb..3F --chain-id 8453 --dry-run',
-            'botanary send --amount 25 --token USDC --recipient 0xAb..3F --chain-id 8453 --yes --json | jq -r .txHash',
+            'botanary send                                                              # guided',
+            'botanary send --amount 25 --token 0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913 --recipient 0xAb..3F --chain-id 8453',
+            'botanary send --amount 25 --token 0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913 --recipient 0xAb..3F --chain-id 8453 --dry-run',
+            'botanary send --amount 25 --token 0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913 --recipient 0xAb..3F --chain-id 8453 --yes --json | jq -r .txHash',
         ],
-        notes: 'Mandates are testnet-only today, so on mainnet every send is browser-signed.\n' +
+        notes: '--token takes a contract address (0x...) or a CAIP-19 asset ref, never a symbol - a symbol is a\n' +
+            'label a contract picks for itself, so two tokens on one chain can share one. `botanary tokens\n' +
+            '--chain-id <id>` lists every address this account can send.\n' +
+            'Mandates are testnet-only today, so on mainnet every send is browser-signed.\n' +
             'Exit 5 means the op was relayed but no receipt arrived yet - poll `botanary api /userops/<opId> --json` to check its status.',
-        seeAlso: 'botanary chains, botanary gas, botanary mandates - wallet_send (MCP)',
+        seeAlso: 'botanary tokens, botanary chains, botanary gas, botanary mandates - wallet_send (MCP)',
+    },
+    swap: {
+        body: 'Swap tokens in an account you own. Botanary never holds your key: this parks a typed intent and\n' +
+            'waits for you to approve it in your browser, the same one path every mutating command uses.\n' +
+            '\n' +
+            '--token-in and --token-out both take a contract address or a CAIP-19 asset ref, never a symbol -\n' +
+            'the same restriction `send` applies, and for the same reason.',
+        examples: [
+            'botanary swap --token-in 0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913 --token-out 0x4200000000000000000000000000000000000006 --amount-in 10 --chain-id 8453',
+            'botanary swap --token-in 0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913 --token-out 0x4200000000000000000000000000000000000006 --amount-in 10 --chain-id 8453 --max-slippage-bps 100',
+            'botanary swap --token-in 0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913 --token-out 0x4200000000000000000000000000000000000006 --amount-in 10 --chain-id 8453 --dry-run',
+        ],
+        notes: '`botanary tokens --chain-id <id>` lists every address this account holds.',
+        seeAlso: 'botanary tokens, botanary send, botanary sign - wallet_sign_request (MCP)',
+    },
+    sign: {
+        body: 'The one write path underneath every command that moves funds or grants authority. Every one of\n' +
+            'them parks a typed intent here (`POST /sign-requests`) and waits for your browser - this CLI never\n' +
+            'holds your key and never signs on your behalf, whatever the command.',
+        examples: ['botanary sign list', 'botanary sign show sr_1', 'botanary sign resume hnd_1'],
+        seeAlso: 'botanary send - wallet_sign_request (MCP)',
+    },
+    'sign list': {
+        body: 'Sign requests this machine parked and is still waiting on your browser to settle.',
+        examples: ['botanary sign list', 'botanary sign list --json'],
+        seeAlso: 'botanary sign show, botanary sign resume',
+    },
+    'sign show': {
+        body: 'Read one sign request by id: its status, its sign URL, and once relayed, the operation it\n' +
+            'produced. For a multi-op request (account.setup, account.migrate, recovery.recover) also shows\n' +
+            'each op\'s own status and which one is next.',
+        examples: ['botanary sign show sr_1', 'botanary sign show sr_1 --json'],
+        notes: 'There is no `sign reject` - only the browser that signs a request can settle it. `sign show`\n' +
+            'prints the sign URL; decline there, or let the request expire on its own.',
+        seeAlso: 'botanary sign list, botanary sign resume',
+    },
+    'sign resume': {
+        body: 'Rejoin an interrupted wait on a sign request this machine parked - after a dropped connection, a\n' +
+            'Ctrl-C, or a closed terminal. Takes the local handle id `botanary sign list` prints, not the sign\n' +
+            'request id.',
+        examples: ['botanary sign resume hnd_1'],
+        seeAlso: 'botanary sign list',
+    },
+    solana: {
+        body: 'Send, swap and manage Botanary Mandates on Solana. Solana is key-keyed, not chainId-keyed - every\n' +
+            'command here takes --key (see `botanary chains`) rather than --chain-id, and amounts for send and\n' +
+            'mandate grant are raw base units (lamports or SPL base units), not display units.',
+        examples: ['botanary solana send --key solana --to <address> --amount 1000000 --yes'],
+        seeAlso: 'botanary send, botanary swap, botanary chains',
+    },
+    'solana send': {
+        body: 'Send tokens on Solana. --amount is a raw base-unit integer string (lamports for SOL), not a display amount.',
+        examples: ['botanary solana send --key solana --to <address> --amount 1000000 --yes'],
+        seeAlso: 'botanary solana swap',
+    },
+    'solana swap': {
+        body: 'Swap tokens on Solana. --amount-in is HUMAN-SCALE (e.g. 1.5), unlike solana send\'s raw base-unit amount.',
+        examples: ['botanary solana swap --key solana --amount-in 1.5 --max-slippage-bps 100 --yes'],
+        seeAlso: 'botanary solana send',
+    },
+    'solana mandate': {
+        body: 'Grant, freeze/unfreeze and revoke Botanary Mandates Program delegations on Solana.',
+        examples: ['botanary solana mandate grant --key solana --mint <mint> --recipient <address> --per-action-max 1000000 --cap-limit 5000000 --cap-period-seconds 3600 --expiry 2027-01-01T00:00:00Z --yes'],
+        seeAlso: 'botanary mandates',
+    },
+    'solana mandate grant': {
+        body: 'Grant a bounded Solana mandate. Unlike the EVM delegation lane, --expiry is mandatory here.',
+        examples: ['botanary solana mandate grant --key solana --mint <mint> --recipient <address> --per-action-max 1000000 --cap-limit 5000000 --cap-period-seconds 3600 --expiry 2027-01-01T00:00:00Z --yes'],
+        seeAlso: 'botanary solana mandate freeze, botanary solana mandate revoke',
+    },
+    'solana mandate freeze': {
+        body: 'Freeze (or --unfreeze) every Solana mandate for this owner at once - one kill switch across every mint.',
+        examples: ['botanary solana mandate freeze --key solana --yes', 'botanary solana mandate freeze --key solana --unfreeze --yes'],
+        seeAlso: 'botanary solana mandate grant',
+    },
+    'solana mandate revoke': {
+        body: 'Revoke a Solana mandate.',
+        examples: ['botanary solana mandate revoke man_1 --key solana --yes'],
+        seeAlso: 'botanary solana mandate grant',
     },
     activity: {
         body: 'Recent sends, swaps and yield transactions for this account, newest first.',
@@ -60,9 +150,35 @@ export const COMMAND_HELP = {
     },
     yield: {
         body: 'Yield pools, a shortlist ranked off your own holdings, and this account\'s farm positions. The\n' +
-            'shortlist is ranked server-side and is not scoped by `accounts use`.',
+            'shortlist is ranked server-side and is not scoped by `accounts use`. `deposit`, `withdraw` and\n' +
+            '`claim` are how you actually enter, exit or collect from one of these pools.',
         examples: ['botanary yield', 'botanary yield --json'],
-        seeAlso: 'botanary markets - wallet_yield (MCP)',
+        seeAlso: 'botanary markets, botanary yield deposit - wallet_yield (MCP)',
+    },
+    'yield deposit': {
+        body: 'Deposit into a yield pool, for an account you own. Parks a typed intent and waits for you to\n' +
+            'approve it in your browser, the same one path every mutating command uses. --amount is in the\n' +
+            'pool\'s underlying asset, not shares.',
+        examples: [
+            'botanary yield deposit --pool-id p_1 --amount 25 --chain-id 84532',
+            'botanary yield deposit --pool-id p_1 --amount 25 --chain-id 84532 --dry-run',
+        ],
+        seeAlso: 'botanary yield, botanary yield withdraw - wallet_sign_request (MCP)',
+    },
+    'yield withdraw': {
+        body: 'Withdraw from a yield pool, for an account you own. Parks a typed intent and waits for you to\n' +
+            'approve it in your browser. --amount is in the pool\'s underlying asset, not shares.',
+        examples: [
+            'botanary yield withdraw --pool-id p_1 --amount 25 --chain-id 84532',
+            'botanary yield withdraw --pool-id p_1 --amount 25 --chain-id 84532 --dry-run',
+        ],
+        seeAlso: 'botanary yield, botanary yield deposit - wallet_sign_request (MCP)',
+    },
+    'yield claim': {
+        body: 'Claim accrued rewards from a yield pool, for an account you own. No --amount: what is claimable is\n' +
+            'decided from a live probe of this account\'s own accrued rewards, not a number you supply.',
+        examples: ['botanary yield claim --pool-id p_1 --chain-id 84532', 'botanary yield claim --pool-id p_1 --chain-id 84532 --dry-run'],
+        seeAlso: 'botanary yield - wallet_sign_request (MCP)',
     },
     mandates: {
         body: 'What the agent lane may spend unattended: every delegation on this account, its bounds, and how much\n' +
@@ -71,12 +187,66 @@ export const COMMAND_HELP = {
         notes: 'Mandates are testnet-only and pre-mainnet. Nothing here is enforced on mainnet yet.',
         seeAlso: 'botanary agents, botanary agent grant - wallet_mandates (MCP)',
     },
+    'mandates propose': {
+        body: 'Compile a parsed rule/mandate intent against the capability matrix. Pure compilation - reads nothing\n' +
+            'and writes nothing, so no signature is involved. subject: self routes to a rule (AgentGuard);\n' +
+            'copilot routes to a mandate (MandateExecutor); omitted lets the backend decide, or offer both.',
+        examples: ['botanary mandates propose --primitive per_tx_amount_cap --value 500 --unit USDC --comparator lte --subject copilot'],
+        seeAlso: 'botanary mandates, botanary mandates suggest',
+    },
     'mandates suggest': {
         body: 'Suggest a bounded mandate for each registered agent that does not have one yet, with a Grant URL for\n' +
             'each. A suggestion only: it never widens an existing grant, and granting happens in Botanary.',
         examples: ['botanary mandates suggest', 'botanary mandates suggest --json'],
         seeAlso: 'botanary mandates, botanary agents - wallet_suggest_mandate (MCP)',
     },
+    'mandates grant': {
+        body: 'Grant bounded access to a delegatee agent - a Smart Session, the classic delegation lane. The full\n' +
+            'shape (name, delegateeAddress, chainId, budgets, and the rest) lives in a JSON file, not flags - see\n' +
+            'the README. This writes into the Delegations table `botanary mandates` reads, not the Mandates table.',
+        examples: ['botanary mandates grant --grant-file grant.json --yes'],
+        seeAlso: 'botanary mandates freeze, botanary mandates revoke, botanary mandates confirm',
+    },
+    'mandates freeze': {
+        body: 'Freeze a delegation (reversible). Id from the Delegations table in `botanary mandates`.',
+        examples: ['botanary mandates freeze del_1 --yes'],
+        seeAlso: 'botanary mandates unfreeze, botanary mandates grant',
+    },
+    'mandates unfreeze': {
+        body: 'Unfreeze a delegation. Id from the Delegations table in `botanary mandates`.',
+        examples: ['botanary mandates unfreeze del_1 --yes'],
+        seeAlso: 'botanary mandates freeze',
+    },
+    'mandates revoke': {
+        body: 'Revoke a delegation (permanent). Id from the Delegations table in `botanary mandates` - not the\n' +
+            'Mandates table, which `botanary mandates cancel` targets instead.',
+        examples: ['botanary mandates revoke del_1 --yes'],
+        notes: 'Permanent - use `botanary mandates freeze` instead if you may want it back.',
+        seeAlso: 'botanary mandates freeze, botanary mandates cancel',
+    },
+    'mandates confirm': {
+        body: 'Confirm and enable proposed mandates or rules. Candidates are a JSON array, typically saved from\n' +
+            '`botanary mandates propose --json`.',
+        examples: ['botanary mandates confirm --candidates-file candidates.json --yes'],
+        seeAlso: 'botanary mandates propose, botanary mandates pause',
+    },
+    'mandates pause': {
+        body: 'Pause a mandate (reversible). Id from the Mandates (on-chain) table in `botanary mandates`.',
+        examples: ['botanary mandates pause man_1 --yes'],
+        seeAlso: 'botanary mandates resume, botanary mandates cancel',
+    },
+    'mandates resume': {
+        body: 'Resume a paused mandate. Id from the Mandates (on-chain) table in `botanary mandates`.',
+        examples: ['botanary mandates resume man_1 --yes'],
+        seeAlso: 'botanary mandates pause',
+    },
+    'mandates cancel': {
+        body: 'Revoke a mandate (permanent). Named cancel here, not revoke, to stay distinct from `botanary mandates\n' +
+            'revoke`, which targets a delegation, not a mandate. Id from the Mandates (on-chain) table.',
+        examples: ['botanary mandates cancel man_1 --yes'],
+        notes: 'Permanent - use `botanary mandates pause` instead if you may want it back.',
+        seeAlso: 'botanary mandates pause, botanary mandates revoke',
+    },
     agents: {
         body: 'Connected agents on this account, and any approval requests waiting on your verdict.',
         examples: ['botanary agents', 'botanary agents --json'],
@@ -98,6 +268,366 @@ export const COMMAND_HELP = {
         examples: ['botanary accounts use acct_2'],
         seeAlso: 'botanary accounts list - wallet_use_account (MCP)',
     },
+    recovery: {
+        body: 'Social recovery: the guardian set on this account, and the emergency signer-set replacement.',
+        examples: ['botanary recovery status'],
+        seeAlso: 'botanary panic, botanary signers',
+    },
+    'recovery status': {
+        body: 'The live guardian set on this account, read on-chain.',
+        examples: ['botanary recovery status', 'botanary recovery status --json'],
+        seeAlso: 'botanary recovery install',
+    },
+    'recovery install': {
+        body: 'Install social recovery with a guardian set and an M-of-N threshold. At least 2 guardians and a threshold of at least 2 - a single guardian could rotate the account unilaterally.',
+        examples: ['botanary recovery install --guardian 0xAb..1F --guardian 0xCd..2A --threshold 2 --yes'],
+        seeAlso: 'botanary recovery guardian add, botanary recovery recover',
+    },
+    'recovery guardian': {
+        body: 'Add or remove one recovery guardian.',
+        examples: ['botanary recovery guardian add --name "iPhone 15" --kind device --address 0xAb..1F --yes'],
+        seeAlso: 'botanary recovery status',
+    },
+    'recovery guardian add': {
+        body: 'Add a recovery guardian.',
+        examples: ['botanary recovery guardian add --name "iPhone 15" --kind device --address 0xAb..1F --yes'],
+        seeAlso: 'botanary recovery guardian remove',
+    },
+    'recovery guardian remove': {
+        body: 'Remove a recovery guardian.',
+        examples: ['botanary recovery guardian remove grd_1 --yes'],
+        seeAlso: 'botanary recovery guardian add',
+    },
+    'recovery recover': {
+        body: "Replace this account's whole signer set - the emergency lane, signed by a guardian rather than the\n" +
+            'current owner. The complete new signer set, not a single lost/new pair.',
+        examples: ['botanary recovery recover --new-signer 0xAb..1F --new-threshold 1 --yes'],
+        seeAlso: 'botanary recovery install',
+    },
+    signers: {
+        body: "This account's enrolled signers on the v1 authority core (BotanaryPolicyValidator) - who can approve, not how a person reaches the account.",
+        examples: ['botanary signers list'],
+        seeAlso: 'botanary devices, botanary recovery',
+    },
+    'signers list': {
+        body: 'Every enrolled signer, by index.',
+        examples: ['botanary signers list', 'botanary signers list --json'],
+        seeAlso: 'botanary signers add',
+    },
+    'signers add': {
+        body: 'Enrol a new ECDSA signer on this chain.',
+        examples: ['botanary signers add --address 0xAb..1F --yes'],
+        seeAlso: 'botanary signers remove, botanary signers list',
+    },
+    'signers remove': {
+        body: 'Remove a signer from this chain, by index.',
+        examples: ['botanary signers remove --index 1 --yes'],
+        seeAlso: 'botanary signers list',
+    },
+    'signers threshold': {
+        body: 'Set the account-wide signer approval threshold.',
+        examples: ['botanary signers threshold --threshold 2 --yes'],
+        seeAlso: 'botanary signers list',
+    },
+    'signers trust-anchor': {
+        body: "Mirror an issuer's currently-active signing key onto this account. Only google has a live JWKS source today.",
+        examples: ['botanary signers trust-anchor --yes'],
+        seeAlso: 'botanary signers add',
+    },
+    'signers guardian': {
+        body: "Set BotanaryPolicyValidator's own guardian threshold over enrolled signers. Not `recovery guardian`\n" +
+            'above - a different contract behind the same English word.',
+        examples: ['botanary signers guardian set --signer-index 0 --signer-index 1 --threshold 2 --yes'],
+        seeAlso: 'botanary recovery guardian',
+    },
+    'signers guardian set': {
+        body: 'Set the policy-validator guardian threshold over a subset of enrolled signer indexes. --threshold 0 opts out.',
+        examples: ['botanary signers guardian set --signer-index 0 --signer-index 1 --threshold 2 --yes'],
+        seeAlso: 'botanary signers list',
+    },
+    'signers policy': {
+        body: 'Write or remove a conditional signing policy at a slot (BotanaryPolicyValidator).',
+        examples: ['botanary signers policy set --slot 0 --approvals 1 --delay-seconds 0 --signer-index 0 --yes'],
+        seeAlso: 'botanary signers guardian',
+    },
+    'signers policy set': {
+        body: 'Write (or overwrite) the conditional signing policy at a slot.',
+        examples: ['botanary signers policy set --slot 0 --approvals 1 --delay-seconds 0 --signer-index 0 --yes'],
+        seeAlso: 'botanary signers policy remove',
+    },
+    'signers policy remove': {
+        body: 'Remove the conditional signing policy at a slot.',
+        examples: ['botanary signers policy remove --slot 0 --yes'],
+        seeAlso: 'botanary signers policy set',
+    },
+    'signers condition-set': {
+        body: 'Add or remove a condition-set member (BotanaryPolicyValidator).',
+        examples: ['botanary signers condition-set --set-id 0x..32 --member 0x..32 --yes'],
+        seeAlso: 'botanary signers policy set',
+    },
+    'signers migrate': {
+        body: "Upgrade this account's authority core onto BotanaryPolicyValidator - step 1 of 2. Not the same flow\n" +
+            'as `account migrate` (address migration, a different contract behind the same English word).',
+        examples: ['botanary signers migrate --yes'],
+        seeAlso: 'botanary account migrate',
+    },
+    devices: {
+        body: "Co-signer devices on this account's OwnableValidator root, and their M-of-N threshold.",
+        examples: ['botanary devices list'],
+        seeAlso: 'botanary signers, botanary panic',
+    },
+    'devices list': {
+        body: 'The live device set and its M-of-N threshold.',
+        examples: ['botanary devices list', 'botanary devices list --json'],
+        seeAlso: 'botanary devices add',
+    },
+    'devices add': {
+        body: 'Add a device as a co-signer.',
+        examples: ['botanary devices add --device 0xAb..1F --label "Work laptop" --yes'],
+        seeAlso: 'botanary devices remove, botanary devices list',
+    },
+    'devices remove': {
+        body: 'Remove a device from the co-signer set.',
+        examples: ['botanary devices remove --device 0xAb..1F --yes'],
+        seeAlso: 'botanary devices list',
+    },
+    'devices threshold': {
+        body: 'Set the M-of-N device signing threshold.',
+        examples: ['botanary devices threshold --threshold 2 --yes'],
+        seeAlso: 'botanary devices list',
+    },
+    panic: {
+        body: 'The panic freeze lane: once installed, any one listed device can freeze the account, gas-abstractedly.',
+        examples: ['botanary panic install --yes', 'botanary panic freeze --yes'],
+        seeAlso: 'botanary account freeze, botanary devices',
+    },
+    'panic install': {
+        body: 'Install the panic freeze lane - a 1-of-N session over the listed device keys, omit to use the account\'s own signer set.',
+        examples: ['botanary panic install --yes'],
+        seeAlso: 'botanary panic freeze',
+    },
+    'panic freeze': {
+        body: 'Freeze the account via the panic lane. Any one listed device can sign - this is the kill-switch.',
+        examples: ['botanary panic freeze --yes'],
+        notes: 'Needs `botanary panic install` first.',
+        seeAlso: 'botanary account unfreeze',
+    },
+    rules: {
+        body: "Owner-lane caps and allowlist on this account's AgentGuard hook - the universal floor every mandate can only narrow from.",
+        examples: ['botanary rules update --caps-file caps.json --yes'],
+        notes: 'Accounts created since 2026-07-30 deploy permanently hookless, so the backend declines to build\n' +
+            'an op that cannot bind on those accounts. This still parks and signs; it does not enforce on-chain there.',
+        seeAlso: 'botanary account freeze, botanary mandates',
+    },
+    'rules update': {
+        body: 'Update account caps and/or the contract/recipient allowlist. Each half is left unchanged if omitted -\n' +
+            'both are complex, arbitrarily-sized shapes, so they come from JSON files rather than flags.',
+        examples: ['botanary rules update --caps-file caps.json --allowlist-file allowlist.json --yes'],
+        seeAlso: 'botanary rules',
+    },
+    'agents approve': {
+        body: "Approve an agent's request. The owner signs; the agent can never approve its own request.",
+        examples: ['botanary agents approve req_1 --yes'],
+        seeAlso: 'botanary agents, botanary agents deny',
+    },
+    'agents deny': {
+        body: 'There is no deny action on this surface - reads the request back and explains why. An agent request is either approved or left to expire on its own.',
+        examples: ['botanary agents deny req_1'],
+        seeAlso: 'botanary agents approve',
+    },
+    'agents claim': {
+        body: 'Claim a pending pairing and bind that agent to this account. No signature - a plain session write.',
+        examples: ['botanary agents claim ABC-123-XYZ --name "Claude Code"'],
+        seeAlso: 'botanary agent pair, botanary agents revoke',
+    },
+    'agents revoke': {
+        body: 'Disconnect an agent from this account. No signature - a plain session write.',
+        examples: ['botanary agents revoke agt_1'],
+        seeAlso: 'botanary agents claim, botanary agents',
+    },
+    notifications: {
+        body: 'Alerts - blocked actions, depeg warnings, and the like. No signature - a plain session surface.',
+        examples: ['botanary notifications', 'botanary notifications --unread-only'],
+        seeAlso: 'botanary watch, botanary notifications read-all',
+    },
+    'notifications read': {
+        body: 'Mark one notification as read.',
+        examples: ['botanary notifications read n1'],
+        seeAlso: 'botanary notifications, botanary notifications read-all',
+    },
+    'notifications read-all': {
+        body: 'Mark every notification as read.',
+        examples: ['botanary notifications read-all'],
+        seeAlso: 'botanary notifications',
+    },
+    paysh: {
+        body: 'pay.sh: the x402 spending balance and its guardrails.',
+        examples: ['botanary paysh accounts'],
+        seeAlso: 'botanary apis, botanary agent pay',
+    },
+    'paysh accounts': {
+        body: "The caller's recorded pay.sh accounts. Read-only - account creation happens entirely client-side via\n" +
+            'Privy in the web app, and `POST /pay-sh/accounts` refuses a CLI session outright.',
+        examples: ['botanary paysh accounts', 'botanary paysh accounts --json'],
+        seeAlso: 'botanary paysh topup',
+    },
+    'paysh topup': {
+        body: 'Top up the pay.sh balance.',
+        examples: ['botanary paysh topup --amount-usdc 25 --yes'],
+        seeAlso: 'botanary paysh withdraw',
+    },
+    'paysh withdraw': {
+        body: "Withdraw from a pay.sh account's custodial Solana USDC balance.",
+        examples: ['botanary paysh withdraw --paysh-account-id psh_1 --amount-usdc 25 --destination <solana address> --yes'],
+        seeAlso: 'botanary paysh topup, botanary paysh accounts',
+    },
+    'paysh allowlist': {
+        body: 'The trusted pay.sh domains for one account. Read-only - adding or removing a domain 403s for a CLI\n' +
+            'session (CliSessionForbidden), because pay.sh moves value with no owner signature in the loop. Do it\n' +
+            'in the web app.',
+        examples: ['botanary paysh allowlist psh_1'],
+        seeAlso: 'botanary paysh settings',
+    },
+    'paysh settings': {
+        body: "One account's persisted default copilot pay.sh mode. Read-only - changing it 403s for a CLI session,\n" +
+            'same reason as `paysh allowlist`.',
+        examples: ['botanary paysh settings psh_1'],
+        seeAlso: 'botanary paysh allowlist',
+    },
+    marketplace: {
+        body: 'Hire an ACP agent under a bounded mandate, and run its jobs.',
+        examples: ['botanary marketplace hire --agent-wallet 0xAb..1F --chain-id 8453 --per-job-budget 10 --delegatee-address 0xCd..2A --yes'],
+        seeAlso: 'botanary mandates, botanary markets',
+    },
+    'marketplace hire': {
+        body: 'Hire an ACP agent under a bounded mandate.',
+        examples: ['botanary marketplace hire --agent-wallet 0xAb..1F --chain-id 8453 --per-job-budget 10 --delegatee-address 0xCd..2A --yes'],
+        seeAlso: 'botanary marketplace deposit, botanary marketplace jobs create',
+    },
+    'marketplace deposit': {
+        body: 'Deposit into a Virtuals-custodied wallet.',
+        examples: ['botanary marketplace deposit --chain-id 8453 --amount 50 --token-symbol USDC --token-address 0xAb..1F --yes'],
+        seeAlso: 'botanary marketplace hire',
+    },
+    'marketplace jobs': {
+        body: 'ACP jobs run under a marketplace mandate.',
+        examples: ['botanary marketplace jobs create --mandate-id 0x..32 --agent-wallet 0xAb..1F --description "Write a report" --chain-id 8453 --yes'],
+        seeAlso: 'botanary marketplace hire',
+    },
+    'marketplace jobs create': {
+        body: 'Create an ACP job under a mandate - op 1 of a hire.',
+        examples: ['botanary marketplace jobs create --mandate-id 0x..32 --agent-wallet 0xAb..1F --description "Write a report" --chain-id 8453 --yes'],
+        seeAlso: 'botanary marketplace jobs fund',
+    },
+    'marketplace jobs fund': {
+        body: 'Fund an ACP job under a mandate - op 2 of a hire, approve and fund batched together.',
+        examples: ['botanary marketplace jobs fund --mandate-id 0x..32 --job-id job_1 --per-job-budget 10 --chain-id 8453 --yes'],
+        seeAlso: 'botanary marketplace jobs create',
+    },
+    apis: {
+        body: 'The x402 paid-API catalog, and the on-chain spending budget backing it.',
+        examples: ['botanary apis providers', 'botanary apis budget --chain-id 8453 --agent-id agt_1'],
+        seeAlso: 'botanary agent apis, botanary agent pay',
+    },
+    'apis budget': {
+        body: 'Read the current API budget and its state: remaining count, per-call max, expiry, epoch, token, exposure, spent.',
+        examples: ['botanary apis budget 8453 agt_1'],
+        seeAlso: 'botanary apis budget commit',
+    },
+    'apis budget commit': {
+        body: 'Commit a three-transaction atomic API spending budget.',
+        examples: ['botanary apis budget commit --chain-id 8453 --agent-id agt_1 --max-value 1000000 --count 10 --expires-at 2026-12-31T00:00:00Z --yes'],
+        seeAlso: 'botanary apis budget',
+    },
+    'apis providers': {
+        body: 'Ranked, searchable catalog of x402 API providers.',
+        examples: ['botanary apis providers', 'botanary apis providers --chain-id 8453 --q weather'],
+        seeAlso: 'botanary agent apis',
+    },
+    onramp: {
+        body: 'Start a fiat-to-crypto Buy checkout session. No UserOp, no signature - funds arrive directly from the\n' +
+            'provider, the same way an ordinary incoming transfer does.',
+        examples: ['botanary onramp --chain-key base', 'botanary onramp --chain-key base --no-open'],
+        seeAlso: 'botanary onramp methods, botanary balance',
+    },
+    'onramp methods': {
+        body: 'Chains currently buyable through the wired onramp provider.',
+        examples: ['botanary onramp methods'],
+        seeAlso: 'botanary onramp',
+    },
+    agentwallet: {
+        body: 'Deposit into a Virtuals agent wallet - a per-agent custodial wallet, distinct from `marketplace deposit`.',
+        examples: ['botanary agentwallet deposit --agent-id agt_1 --network base --token-symbol USDC --token-address 0x..14 --amount 25 --yes'],
+        seeAlso: 'botanary marketplace deposit',
+    },
+    'agentwallet deposit': {
+        body: 'Deposit into a Virtuals agent wallet. Base-only in v1 - a solana --network is accepted here but declined server-side.',
+        examples: ['botanary agentwallet deposit --agent-id agt_1 --network base --token-symbol USDC --token-address 0x..14 --amount 25 --yes'],
+        seeAlso: 'botanary agentwallet',
+    },
+    approvals: {
+        body: 'Announce a collected off-chain approval, by its digest.',
+        examples: ['botanary approvals announce 0x..32 --yes'],
+        seeAlso: 'botanary sign',
+    },
+    'approvals announce': {
+        body: 'Announce a collected approval, by its digest. Takes no body beyond the digest itself.',
+        examples: ['botanary approvals announce 0x..32 --yes'],
+        seeAlso: 'botanary approvals',
+    },
+    watch: {
+        body: 'Tail live events in the foreground - a terminal has no notification bell, so this is how you learn\n' +
+            'an agent filed a request, your balance moved, or a parked sign request settled without polling by\n' +
+            'hand. Balance and sign-request status are real pushes (SSE), reconnected with backoff on drop;\n' +
+            'agent requests are polled, because the backend has no owner-facing push for those yet. Ctrl-C stops\n' +
+            'it cleanly, exit 0.',
+        examples: ['botanary watch', 'botanary watch --json | jq .', 'botanary watch --interval-ms 2000'],
+        seeAlso: 'botanary sign list, botanary agents, botanary balance',
+    },
+    account: {
+        body: "Owner-signed lifecycle actions on the account itself: deploy a new one, install missing modules,\n" +
+            'top up on testnet, freeze/unfreeze the kill-switch, and migrate to today\'s address. Every\n' +
+            'subcommand here parks a sign request and waits on your browser, exactly like send and swap.',
+        examples: ['botanary account deploy', 'botanary account freeze --yes'],
+        seeAlso: 'botanary accounts list, botanary sign list',
+    },
+    'account deploy': {
+        body: 'Mint a new account with its own address - always the next CREATE2 index, never an existing one.',
+        examples: ['botanary account deploy', 'botanary account deploy --yes --json'],
+        seeAlso: 'botanary accounts list',
+    },
+    'account setup': {
+        body: 'Install every account module this chain is missing, so the account can actually be used there.',
+        examples: ['botanary account setup --chain-id 84532 --yes'],
+        seeAlso: 'botanary account migrate, botanary diagnose',
+    },
+    'account fund': {
+        body: 'Mint testnet USDC into this account - a faucet top-up, never a real transfer.',
+        examples: ['botanary account fund --yes'],
+        seeAlso: 'botanary balance',
+    },
+    'account freeze': {
+        body: 'Freeze this account, the kill-switch. No further transfers are authorized until you unfreeze.',
+        examples: ['botanary account freeze --yes', 'botanary account freeze --lane panic --yes'],
+        notes: 'This is testnet-only enforcement today - see the workspace CLAUDE.md\'s hookless-accounts caveat.',
+        seeAlso: 'botanary account unfreeze, botanary panic freeze',
+    },
+    'account unfreeze': {
+        body: 'Unfreeze this account, restoring its ability to authorize transfers.',
+        examples: ['botanary account unfreeze --yes'],
+        seeAlso: 'botanary account freeze',
+    },
+    'account rename': {
+        body: 'Rename (and/or hide/unhide) an account. Off-chain metadata only - never builds, signs or relays a\n' +
+            'UserOp, unlike everything else in the account group. No signature - a plain session write.',
+        examples: ['botanary account rename --label "Trading"', 'botanary account rename acct_2 --hide'],
+        seeAlso: 'botanary accounts list',
+    },
+    'account migrate': {
+        body: "Migrate this account to today's address. Produces zero, one or two ops depending on its current migration phase and root validator.",
+        examples: ['botanary account migrate --chain-id 84532 --yes'],
+        seeAlso: 'botanary account setup, botanary sign show',
+    },
     chains: {
         body: 'Every chain this backend serves, and what each one can actually do:\n' +
             '  watch      read-only. No bundler, no authority\n' +