botanary 0.5.2 → 0.6.0

package/dist/src/help/examples.js

@@ -1,904 +0,0 @@
-/** Keyed by the command's full path with the program name stripped: 'send', 'agent spend', 'mcp config'. */
-export const COMMAND_HELP = {
-    login: {
-        body: 'Log in as the account owner. Botanary prints a one-time code and opens your browser; you approve\n' +
-            'there. The CLI never sees your key and never signs for you - it stores only a session token, in the\n' +
-            'same place botanary-mcp stores its own, so a coding agent on this machine sees the same login.',
-        examples: ['botanary login', 'botanary login --json'],
-        notes: 'If a browser cannot be opened (SSH, headless, WSL), the printed URL is the one to visit yourself.',
-        seeAlso: 'botanary status, botanary logout - wallet_login (MCP)',
-    },
-    logout: {
-        body: 'Revoke the stored owner session on the server and delete it from this machine.',
-        examples: ['botanary logout'],
-        seeAlso: 'botanary login - wallet_logout (MCP)',
-    },
-    status: {
-        body: 'The owner session and this machine\'s agent binding, side by side, with no network call beyond\nreading each one.',
-        examples: ['botanary status', 'botanary status --json'],
-        seeAlso: 'botanary whoami, botanary diagnose - wallet_status (MCP)',
-    },
-    whoami: {
-        body: 'Who Botanary says you are, in both lanes: the owner session this machine holds, and whether the\n' +
-            'agent identity on this machine is a live, claimed connected agent.',
-        examples: ['botanary whoami', 'botanary whoami --json'],
-        seeAlso: 'botanary status, botanary agent whoami - wallet_status + whoami (MCP)',
-    },
-    balance: {
-        body: 'What this account holds, across every chain Botanary serves, with a fiat total and the freshness of\n' +
-            'the numbers. Balances come from the backend store, which can lag the chain; the footer says so\n' +
-            'whenever it does, rather than presenting a stale number as settled.',
-        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' +
-            '\n' +
-            'Which lane signs is decided for you:\n' +
-            '  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 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: '--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 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.',
-        examples: ['botanary activity', 'botanary activity --json'],
-        seeAlso: 'botanary balance - wallet_activity (MCP)',
-    },
-    markets: {
-        body: 'Public market data: the token catalog Botanary prices, with symbols and current prices.',
-        examples: ['botanary markets', 'botanary markets --json'],
-        seeAlso: 'botanary yield - wallet_markets (MCP)',
-    },
-    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`. `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, 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' +
-            'of each budget is already spent.',
-        examples: ['botanary mandates', 'botanary mandates suggest', 'botanary mandates --json'],
-        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'],
-        seeAlso: 'botanary mandates, botanary agent requests - wallet_agents (MCP)',
-    },
-    accounts: {
-        body: 'Which of your accounts subsequent commands use.',
-        examples: ['botanary accounts list', 'botanary accounts use acct_2'],
-        seeAlso: 'botanary status - wallet_use_account (MCP)',
-    },
-    'accounts list': {
-        body: 'Every account this login can see, with the active one marked.',
-        examples: ['botanary accounts list', 'botanary accounts list --json'],
-        seeAlso: 'botanary accounts use',
-    },
-    'accounts use': {
-        body: 'Switch the active account. The id is validated against the accounts this login actually has, so a\n' +
-            'typo fails here rather than silently targeting the wrong account later.',
-        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 budget revoke': {
-        body: 'Revoke an agent\'s on-chain API spending budget. This is the only control that stops an agent ' +
-            'that has stopped asking permission: pausing a mandate is off-chain and binds a cooperative ' +
-            'agent, while the validator never reads the pause flag. Opens your browser to sign, because the ' +
-            'backend never signs. On a frozen account it declines and names the alternative.',
-        examples: ['botanary apis budget revoke --chain-id 84532 --agent-id agt_1'],
-        seeAlso: 'botanary apis budget, botanary apis budget commit',
-    },
-    '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' +
-            '  basic      a bundler exists but no AgentGuard: send, swap and manage work; authority declines\n' +
-            '  botanary   full on-chain authority, including mandates\n' +
-            '\n' +
-            'This is the answer to "what do I pass to --chain-id".',
-        examples: ['botanary chains', 'botanary chains --json | jq -r ".[] | select(.tier==\\"botanary\\") | .key"'],
-        seeAlso: 'botanary gas, botanary send - list_chains (MCP)',
-    },
-    gas: {
-        body: 'The gas methods actually available for this account on a chain. The backend filters out anything\n' +
-            'unavailable, so every row printed is usable. An empty list is the usual cause of a relay failing to\n' +
-            'pay for itself.',
-        examples: ['botanary gas --chain-id 8453', 'botanary gas --chain-id 8453 --json'],
-        seeAlso: 'botanary chains, botanary send - get_gas_methods (MCP)',
-    },
-    api: {
-        body: 'Read any GET endpoint the frozen OpenAPI contract documents, authenticated as the owner. Paths are\n' +
-            'validated against the contract before anything reaches the network, and there is no write\n' +
-            'equivalent: every write goes through a typed intent you sign, or an on-chain-bound mandate.',
-        examples: [
-            'botanary api /chains',
-            'botanary api "/balance?focusChainRef=eip155:8453"',
-            'botanary api --list',
-            'botanary api --list yield',
-        ],
-        seeAlso: 'botanary balance, botanary activity - wallet_api_get (MCP)',
-    },
-    open: {
-        body: 'Open Botanary in your browser, optionally straight to one surface.',
-        examples: ['botanary open', 'botanary open mandates', 'botanary open agents'],
-        seeAlso: 'botanary docs',
-    },
-    agent: {
-        body: 'This machine\'s own agent identity: what it is, what its owner granted it, and what it may spend\n' +
-            'unattended. This is never your owner session - the two lanes are deliberately separate.',
-        examples: ['botanary agent whoami', 'botanary agent grant', 'botanary agent pair'],
-        seeAlso: 'botanary whoami, botanary mandates',
-    },
-    'agent whoami': {
-        body: 'What the Botanary backend says about this agent: whether it was actually claimed, which account it is\n' +
-            'bound to, and its live grant if it has one. Fails honestly when this agent was never claimed rather\n' +
-            'than reporting a fabricated "connected".',
-        examples: ['botanary agent whoami', 'botanary agent whoami --json'],
-        seeAlso: 'botanary agent identity, botanary agent grant, botanary diagnose - whoami (MCP)',
-    },
-    'agent identity': {
-        body: 'This machine\'s local agent key: address, public key, short fingerprint, and which backend holds the\n' +
-            'private key (an OS keychain, or a 0600 file when none is available). Never contacts the backend and\n' +
-            'never prints the private key. Having an identity grants nothing by itself.',
-        examples: ['botanary agent identity', 'botanary agent identity --json'],
-        seeAlso: 'botanary agent whoami, botanary agent pair - get_identity (MCP)',
-    },
-    'agent pair': {
-        body: 'Show the pairing code for this machine and register it with Botanary. In Botanary, open Connected\n' +
-            'agents, enter the code, and name the agent. The same code comes back until it expires; --regenerate\n' +
-            'forces a fresh one.',
-        examples: ['botanary agent pair', 'botanary agent pair --regenerate'],
-        notes: 'The code only identifies this agent. Completing a pairing also needs a signature from the private key, which never leaves this machine.',
-        seeAlso: 'botanary agent whoami - get_pairing_code (MCP)',
-    },
-    'agent grant': {
-        body: 'What this agent may do right now, in plain terms, without hitting any bound to find out.',
-        examples: ['botanary agent grant', 'botanary agent grant --json'],
-        seeAlso: 'botanary agent whoami, botanary mandates - what_may_i_do (MCP)',
-    },
-    'agent account': {
-        body: 'The one account this agent is bound to: its address and deployment status, optionally on one chain.',
-        examples: ['botanary agent account', 'botanary agent account --chain-id 84532'],
-        seeAlso: 'botanary agent whoami - get_account (MCP)',
-    },
-    'agent balance': {
-        body: 'The bound account\'s balance, read with this agent\'s own session rather than the owner\'s.',
-        examples: ['botanary agent balance', 'botanary agent balance --json'],
-        seeAlso: 'botanary balance - get_balance (MCP)',
-    },
-    'agent requests': {
-        body: 'Every approval request this agent has filed, and the owner\'s verdict on each.',
-        examples: ['botanary agent requests', 'botanary agent requests --json'],
-        seeAlso: 'botanary agent request - list_requests (MCP)',
-    },
-    'agent request': {
-        body: 'Ask the owner to approve something this agent could not do under its own grant. Names the exact calls\n' +
-            'and why, and returns which bound was crossed and the deadline, as the backend computed them. The\n' +
-            'owner approves it as their own action, in Botanary.',
-        examples: [
-            'botanary agent request --reason "Pay the September invoice" --calls-file ./calls.json',
-            'botanary agent request --reason "Top up gas" --calls-file ./calls.json --json',
-        ],
-        notes: 'The calls file is a JSON array of { to, data, value, chainId } - the same shape a build response already carries.',
-        seeAlso: 'botanary agent requests, botanary agent spend - request_approval (MCP)',
-    },
-    'agent spend': {
-        body: 'Spend under this agent\'s own grant, unattended. Reads the grant first: with no grant, an inactive\n' +
-            'grant, the wrong chain, or an amount past its remaining budget or per-action cap, this refuses with\n' +
-            'the backend\'s own numbers instead of attempting anything.',
-        examples: [
-            'botanary agent spend --amount 5 --token USDC --recipient 0xAb..3F --chain-id 84532',
-            'botanary agent spend --amount 5 --token USDC --recipient 0xAb..3F --chain-id 84532 --dry-run',
-        ],
-        notes: 'When it refuses, `botanary agent request` is the lane that asks the owner instead.',
-        seeAlso: 'botanary agent grant, botanary agent status - propose_payment (MCP)',
-    },
-    'agent swap': {
-        body: 'Swap under this agent\'s own grant, unattended, through the one venue the grant pins.',
-        examples: [
-            'botanary agent swap --token-in USDC --token-out ETH --amount-in 10 --chain-id 84532',
-            'botanary agent swap --token-in USDC --token-out ETH --amount-in 10 --chain-id 84532 --max-slippage-bps 100',
-        ],
-        seeAlso: 'botanary agent grant - propose_swap (MCP)',
-    },
-    'agent status': {
-        body: 'The current status of an action this agent relayed, by the op id spend returned: pending, included or\n' +
-            'failed, with a transaction hash once one exists. Never resend a payment to find out what happened.',
-        examples: ['botanary agent status op_123', 'botanary agent status op_123 --json'],
-        seeAlso: 'botanary agent spend - get_action_status (MCP)',
-    },
-    'agent apis': {
-        body: 'Paid (x402) third-party API endpoints this agent may call, with live price and remaining budget.',
-        examples: ['botanary agent apis --chain-id 84532', 'botanary agent apis --chain-id 84532 --json'],
-        seeAlso: 'botanary agent pay, botanary agent budget - list_apis (MCP)',
-    },
-    'agent pay': {
-        body: 'Call a paid API endpoint and pay for it inside the budget the owner committed on chain.',
-        examples: ['botanary agent pay ep_1 --chain-id 84532 --provider-id prov_1 --url https://api.example/v1/thing'],
-        seeAlso: 'botanary agent apis, botanary agent budget - call_api (MCP)',
-    },
-    'agent budget': {
-        body: 'Remaining authorizations, per-call maximum, expiry and epoch for this agent on a chain.',
-        examples: ['botanary agent budget --chain-id 84532', 'botanary agent budget --chain-id 84532 --json'],
-        seeAlso: 'botanary agent apis - get_api_budget (MCP)',
-    },
-    'agent forget': {
-        body: 'Step 1 of 2. Preview what forgetting this machine\'s agent identity would destroy, and mint a\n' +
-            'confirmation token valid for five minutes. Nothing is deleted by this command.',
-        examples: ['botanary agent forget'],
-        seeAlso: 'botanary agent confirm-forget - forget (MCP)',
-    },
-    'agent confirm-forget': {
-        body: 'Step 2 of 2. Actually delete the agent key from this machine, given the token forget printed. The key\n' +
-            'cannot be recovered, and any grant issued to it stays orphaned until the owner revokes it.',
-        examples: ['botanary agent confirm-forget 9f2c..'],
-        seeAlso: 'botanary agent forget - confirm_forget (MCP)',
-    },
-    mcp: {
-        body: 'Connect a coding agent (Claude Code, Codex, Cursor, Claude Desktop) to Botanary via botanary-mcp.',
-        examples: ['botanary mcp config claude', 'botanary mcp install claude', 'botanary mcp serve'],
-        seeAlso: 'botanary agent pair',
-    },
-    'mcp config': {
-        body: 'Print the install snippet for one client, ready to copy.',
-        examples: ['botanary mcp config claude', 'botanary mcp config cursor'],
-        seeAlso: 'botanary mcp install',
-    },
-    'mcp install': {
-        body: 'Install botanary-mcp into a client that has its own CLI for it (claude, codex), by running that\n' +
-            'client\'s own command. The exact command is printed first and needs your confirmation.\n' +
-            '\n' +
-            'For cursor and claude-desktop this prints the snippet and the config path instead: Botanary does not\n' +
-            'edit another tool\'s config file on your behalf.',
-        examples: ['botanary mcp install claude', 'botanary mcp install codex --yes'],
-        seeAlso: 'botanary mcp config',
-    },
-    'mcp serve': {
-        body: 'Run the botanary-mcp server on stdio from this binary, for an MCP client configured to launch\n' +
-            '`botanary mcp serve`. Identical to running botanary-mcp directly.',
-        examples: ['botanary mcp serve'],
-        seeAlso: 'botanary mcp config',
-    },
-    diagnose: {
-        body: 'Start here when anything is unclear or an action failed. One call answers who this agent is bound to,\n' +
-            'whether that account is funded on the grant\'s own chain, whether that chain can do what the grant\n' +
-            'claims, and what is blocking the next action, ranked, each with a concrete next step.',
-        examples: ['botanary diagnose', 'botanary diagnose --json'],
-        seeAlso: 'botanary doctor, botanary agent whoami - diagnose (MCP)',
-    },
-    doctor: {
-        body: 'The same readiness check as `botanary diagnose`, under the name most CLIs use for it.',
-        examples: ['botanary doctor'],
-        seeAlso: 'botanary diagnose',
-    },
-    config: {
-        body: 'Where identity and session live, which environment variables are active, and the CLI defaults stored\n' +
-            'on this machine. Unauthenticated and safe to run any time.',
-        examples: ['botanary config', 'botanary config list', 'botanary config set chainId 8453'],
-        seeAlso: 'botanary diagnose',
-    },
-    'config list': {
-        body: 'Every setting, its resolved value, and where that value came from: a flag, an environment variable,\n' +
-            'the config file, or the built-in default. The provenance column is the point - a stale file value\n' +
-            'that overrides nothing looks identical to one silently retargeting every command otherwise.',
-        examples: ['botanary config list', 'botanary config list --json'],
-        seeAlso: 'botanary config set',
-    },
-    'config get': {
-        body: 'Print one stored config value, or nothing when it is unset.',
-        examples: ['botanary config get chainId'],
-        seeAlso: 'botanary config list',
-    },
-    'config set': {
-        body: 'Store a default for one setting, so you stop retyping it. Unknown keys and values are refused.\n' +
-            'Warning: `config set confirm never` auto-confirms all mutations. Do not set this in an untrusted terminal.',
-        examples: ['botanary config set chainId 8453', 'botanary config set output json'],
-        seeAlso: 'botanary config list, botanary config unset',
-    },
-    'config unset': {
-        body: 'Remove one stored default, falling back to the environment or the built-in default.',
-        examples: ['botanary config unset chainId'],
-        seeAlso: 'botanary config list',
-    },
-    version: {
-        body: 'The installed botanary CLI version.',
-        examples: ['botanary version', 'botanary --version'],
-        seeAlso: 'botanary update',
-    },
-    'update-check': {
-        body: 'Ask npm whether a newer botanary is published. Cached for a day and silent when offline. It only\n' +
-            'reports - `botanary update` is the one that changes anything.',
-        examples: ['botanary update-check', 'botanary update-check --json'],
-        notes: 'Set BOTANARY_NO_UPDATE_NOTIFIER=1 to suppress the one-line nag other commands print.',
-        seeAlso: 'botanary update',
-    },
-    update: {
-        body: 'Update botanary to the latest published version. It works out how this copy was installed - npm,\n' +
-            'pnpm, yarn or bun - and runs that manager, after showing you the exact command and asking. Under a\n' +
-            'one-off runner - `npx`, `pnpm dlx` or `bunx` - there is nothing to update, because those already\n' +
-            'fetch the latest botanary every run.',
-        examples: ['botanary update', 'botanary update --yes', 'botanary update --json --yes', 'botanary update --dry-run'],
-        notes: 'Needs --yes when it cannot ask, and it never uses sudo: a permission error is yours to resolve.',
-        seeAlso: 'botanary update-check',
-    },
-    docs: {
-        body: 'Open the Botanary documentation in your browser, optionally at one topic.',
-        examples: ['botanary docs', 'botanary docs mandates'],
-        seeAlso: 'botanary open',
-    },
-    completion: {
-        body: 'Print a shell completion script. Add it to your shell profile to complete command names, flags,\n' +
-            'chain ids and documented API paths.',
-        examples: [
-            'botanary completion zsh > ~/.botanary-completion.zsh',
-            'botanary completion bash >> ~/.bashrc',
-        ],
-        seeAlso: 'botanary help',
-    },
-    prompt: {
-        body: 'Print the complete operating manual for a non-human driver: every command, flags-only invocation,\n' +
-            'the exit-code table, the JSON envelope, the two lanes, and which steps still need a human. Generated\n' +
-            'from the same metadata as --help, so it cannot drift from it.',
-        examples: ['botanary prompt', 'botanary prompt > BOTANARY.md'],
-        seeAlso: 'botanary completion, botanary mcp config',
-    },
-};
-/** The command's full path with the program name stripped: '', 'send', 'agent spend'. */
-export function commandPath(cmd) {
-    const parts = [];
-    for (let c = cmd; c && c.parent; c = c.parent) {
-        parts.unshift(c.name());
-    }
-    return parts.join(' ');
-}
-export function helpFor(cmd) {
-    return COMMAND_HELP[commandPath(cmd)];
-}
-//# sourceMappingURL=examples.js.map