botanary 0.1.0 → 0.2.0

package/dist/src/completion.js

@@ -0,0 +1,69 @@
+import { GET_ROUTES } from 'botanary-mcp';
+import { invalidArgs } from './errors.js';
+export const SHELLS = ['bash', 'zsh', 'fish', 'powershell'];
+/**
+ * Every word worth completing: command names at any depth, every long flag, and the documented GET routes
+ * (so `botanary api /y<TAB>` works). All of it is static at generation time, which is the point - a
+ * completion script that had to make a network call to answer would hang a shell.
+ */
+export function completionWords(program) {
+    const words = new Set();
+    const walk = (cmd) => {
+        for (const option of cmd.options) {
+            if (option.long)
+                words.add(option.long);
+        }
+        for (const sub of cmd.commands) {
+            words.add(sub.name());
+            for (const alias of sub.aliases())
+                words.add(alias);
+            walk(sub);
+        }
+    };
+    walk(program);
+    for (const route of GET_ROUTES)
+        words.add(route);
+    return [...words].sort();
+}
+export function completionScript(shell, program) {
+    const words = completionWords(program).join(' ');
+    switch (shell) {
+        case 'bash':
+            return [
+                '# botanary completion for bash',
+                '_botanary_complete() {',
+                '  local cur="${COMP_WORDS[COMP_CWORD]}"',
+                `  COMPREPLY=( $(compgen -W "${words}" -- "$cur") )`,
+                '}',
+                'complete -F _botanary_complete botanary',
+                '',
+            ].join('\n');
+        case 'zsh':
+            return [
+                '#compdef botanary',
+                '# botanary completion for zsh',
+                '_botanary_complete() {',
+                `  local -a words; words=(${words})`,
+                '  compadd -- $words',
+                '}',
+                'compdef _botanary_complete botanary',
+                '',
+            ].join('\n');
+        case 'fish':
+            return ['# botanary completion for fish', `complete -c botanary -f -a "${words}"`, ''].join('\n');
+        case 'powershell':
+            return [
+                '# botanary completion for PowerShell',
+                'Register-ArgumentCompleter -Native -CommandName botanary -ScriptBlock {',
+                '  param($wordToComplete, $commandAst, $cursorPosition)',
+                `  @(${completionWords(program).map((w) => `'${w}'`).join(',')}) |`,
+                '    Where-Object { $_ -like "$wordToComplete*" } |',
+                "    ForEach-Object { [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_) }",
+                '}',
+                '',
+            ].join('\n');
+        default:
+            throw invalidArgs(`Unsupported shell "${shell}". Supported: ${SHELLS.join(', ')}.`, `Run \`botanary completion <shell>\` with one of the supported shells.`);
+    }
+}
+//# sourceMappingURL=completion.js.map

package/dist/src/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/completion.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAErE;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,GAAY,EAAQ,EAAE;QAClC,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,IAAI;gBAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC/B,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACtB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE;gBAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACpD,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,UAAU;QAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAgB;IAC9D,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO;gBACL,gCAAgC;gBAChC,wBAAwB;gBACxB,yCAAyC;gBACzC,+BAA+B,KAAK,gBAAgB;gBACpD,GAAG;gBACH,yCAAyC;gBACzC,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,KAAK,KAAK;YACR,OAAO;gBACL,mBAAmB;gBACnB,+BAA+B;gBAC/B,wBAAwB;gBACxB,4BAA4B,KAAK,GAAG;gBACpC,qBAAqB;gBACrB,GAAG;gBACH,qCAAqC;gBACrC,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,KAAK,MAAM;YACT,OAAO,CAAC,gCAAgC,EAAE,+BAA+B,KAAK,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpG,KAAK,YAAY;YACf,OAAO;gBACL,sCAAsC;gBACtC,yEAAyE;gBACzE,wDAAwD;gBACxD,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK;gBACnE,oDAAoD;gBACpD,2GAA2G;gBAC3G,GAAG;gBACH,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf;YACE,MAAM,WAAW,CACf,sBAAsB,KAAK,iBAAiB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAChE,uEAAuE,CACxE,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/src/config-store.js

@@ -0,0 +1,52 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { botanaryMcpHome } from 'botanary-mcp';
+import { invalidArgs } from './errors.js';
+/** Every key `botanary config set` accepts. Anything else is refused, never silently stored. */
+export const CONFIG_KEYS = ['chainId', 'accountId', 'apiUrl', 'output', 'color', 'confirm'];
+/** Keys whose value is a fixed set. A key absent here takes any non-empty string. */
+const ENUMS = {
+    output: ['auto', 'json', 'raw'],
+    color: ['auto', 'never'],
+    confirm: ['always', 'never'],
+};
+/** Beside identity and session, so one BOTANARY_MCP_HOME moves all three together. */
+export function configPath() {
+    return join(botanaryMcpHome(), 'cli-config.json');
+}
+/** A missing or unreadable file is an empty config, not an error: defaults are the whole point of it. */
+export async function readConfig() {
+    try {
+        const parsed = JSON.parse(await readFile(configPath(), 'utf8'));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return {};
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+export async function writeConfig(next) {
+    await mkdir(botanaryMcpHome(), { recursive: true });
+    await writeFile(configPath(), `${JSON.stringify(next, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
+}
+/** Assert that a key is known, and return it narrowed. Throws a CliError with exit 2 if unknown. */
+export function assertKnownKey(key) {
+    if (!CONFIG_KEYS.includes(key)) {
+        throw invalidArgs(`Unknown config key "${key}". Valid keys: ${CONFIG_KEYS.join(', ')}.`, undefined);
+    }
+    return key;
+}
+/** Validate one `config set` pair, returning it narrowed. Throws a CliError with exit 2 on anything else. */
+export function validateEntry(key, value) {
+    const narrowed = assertKnownKey(key);
+    const allowed = ENUMS[narrowed];
+    if (allowed && !allowed.includes(value)) {
+        throw invalidArgs(`Invalid value "${value}" for ${narrowed}. Valid values: ${allowed.join(', ')}.`, undefined);
+    }
+    if (!value) {
+        throw invalidArgs(`${narrowed} cannot be empty.`, `Use \`botanary config unset ${narrowed}\` to remove it.`);
+    }
+    return { key: narrowed, value };
+}
+//# sourceMappingURL=config-store.js.map

package/dist/src/config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../../src/config-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,gGAAgG;AAChG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAarG,qFAAqF;AACrF,MAAM,KAAK,GAAkD;IAC3D,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC;IAC/B,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,sFAAsF;AACtF,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,eAAe,EAAE,EAAE,iBAAiB,CAAC,CAAC;AACpD,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QAC9E,OAAO,MAAuB,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAmB;IACnD,MAAM,KAAK,CAAC,eAAe,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,CAAC,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACzG,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAE,WAAiC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,WAAW,CACf,uBAAuB,GAAG,kBAAkB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACrE,SAAS,CACV,CAAC;IACJ,CAAC;IACD,OAAO,GAAgB,CAAC;AAC1B,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,KAAa;IACtD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,WAAW,CACf,kBAAkB,KAAK,SAAS,QAAQ,mBAAmB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAChF,SAAS,CACV,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,WAAW,CAAC,GAAG,QAAQ,mBAAmB,EAAE,+BAA+B,QAAQ,kBAAkB,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC"}

package/dist/src/context.js

@@ -1,9 +1,19 @@
-export function createContext(runtime, globalOpts) {
+export function createContext(runtime, settings) {
     return {
         runtime,
-        json: !!globalOpts.json,
-        noInteractive: globalOpts.interactive === false,
-        reveal: !!globalOpts.reveal,
+        settings,
+        json: settings.json,
+        raw: settings.raw,
+        quiet: settings.quiet,
+        verbose: settings.verbose,
+        reveal: settings.reveal,
+        interactive: settings.interactive,
+        noInteractive: !settings.interactive,
+        yes: settings.yes,
+        dryRun: settings.dryRun,
+        chain: settings.chain,
+        account: settings.account,
+        outcome: { exit: 0 },
     };
 }
 //# sourceMappingURL=context.js.map

package/dist/src/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,aAAa,CAAC,OAAqB,EAAE,UAAsB;IACzE,OAAO;QACL,OAAO;QACP,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI;QACvB,aAAa,EAAE,UAAU,CAAC,WAAW,KAAK,KAAK;QAC/C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,aAAa,CAAC,OAAqB,EAAE,QAA0B;IAC7E,OAAO;QACL,OAAO;QACP,QAAQ;QACR,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,aAAa,EAAE,CAAC,QAAQ,CAAC,WAAW;QACpC,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;KACrB,CAAC;AACJ,CAAC"}

package/dist/src/errors.js

@@ -0,0 +1,116 @@
+import { BotanaryApiError } from 'botanary-mcp';
+import { colors, glyphs } from './render/colors.js';
+/**
+ * The exit-code contract. Deliberately typed rather than the 0/1 the v1 design chose: a CI step branches
+ * on an exit code before it ever pipes through jq, and Botanary has one outcome nobody else's table has
+ * (`pending` - a relayed op whose receipt has not arrived, which is neither success nor failure).
+ */
+export const EXIT = {
+    ok: 0,
+    error: 1,
+    invalidArgs: 2,
+    notAuthenticated: 3,
+    declined: 4,
+    pending: 5,
+    upstream: 6,
+    interrupted: 130,
+};
+/** The same table, in help-print order. Root help renders this verbatim (see src/help/format.ts). */
+export const EXIT_CODES = [
+    { code: EXIT.ok, meaning: 'Success' },
+    { code: EXIT.error, meaning: 'Error' },
+    { code: EXIT.invalidArgs, meaning: 'Invalid arguments' },
+    { code: EXIT.notAuthenticated, meaning: 'Not logged in, or not paired' },
+    { code: EXIT.declined, meaning: 'Declined (policy, bounds, or chain tier)' },
+    { code: EXIT.pending, meaning: 'Pending: relayed, settlement unknown' },
+    { code: EXIT.upstream, meaning: 'Upstream unavailable (network, RPC, bundler)' },
+    { code: EXIT.interrupted, meaning: 'Interrupted (SIGINT)' },
+];
+/**
+ * Every failure this CLI reports. `message` is ALWAYS the backend's own words when a backend produced it -
+ * re-authoring a decline is how a CLI ends up overstating enforcement that is not live (see the workspace
+ * CLAUDE.md's hookless-accounts caveat). `code` is the stable string a script branches on; `hint` is one
+ * actionable sentence, never a paragraph.
+ */
+export class CliError extends Error {
+    code;
+    exit;
+    hint;
+    constructor(message, code, exit, hint) {
+        super(message);
+        this.code = code;
+        this.exit = exit;
+        this.hint = hint;
+        this.name = 'CliError';
+    }
+}
+export function invalidArgs(message, hint) {
+    return new CliError(message, 'invalid_args', EXIT.invalidArgs, hint);
+}
+export function notLoggedIn() {
+    return new CliError('Not logged in as the wallet owner.', 'not_logged_in', EXIT.notAuthenticated, 'Run `botanary login` first.');
+}
+export function notPaired() {
+    return new CliError('This machine has no agent identity paired with Botanary.', 'not_paired', EXIT.notAuthenticated, 'Run `botanary agent pair` and enter the code in Botanary.');
+}
+/** True for the transport-level failures fetch reports as a plain Error, which carry no HTTP status. */
+function isNetworkError(e) {
+    if (!(e instanceof Error))
+        return false;
+    const code = e.code;
+    if (code === 'ENOTFOUND' || code === 'ECONNREFUSED' || code === 'ECONNRESET' || code === 'ETIMEDOUT' || code === 'EAI_AGAIN') {
+        return true;
+    }
+    return e.name === 'AbortError' || /fetch failed|network|socket hang up/i.test(e.message);
+}
+function fromApiError(e) {
+    // The backend's own typed refusal, when it sent one. Keyed off the guaranteed field rather than the
+    // prose, exactly as BotanaryApiError.details' own doc comment asks.
+    const declineReason = typeof e.details?.declineReason === 'string' ? e.details.declineReason : null;
+    if (e.status === 401 || e.status === 403) {
+        return new CliError(e.message, 'not_authenticated', EXIT.notAuthenticated, 'Run `botanary login` again.');
+    }
+    if (declineReason || e.status === 402) {
+        return new CliError(e.message, declineReason ?? 'declined', EXIT.declined, 'Run `botanary diagnose` to see what is blocking this.');
+    }
+    if (e.status === 404) {
+        return new CliError(e.message, 'not_found', EXIT.error);
+    }
+    if (e.status === 400 || e.status === 422) {
+        return new CliError(e.message, 'invalid_args', EXIT.invalidArgs);
+    }
+    if (e.status === 429) {
+        return new CliError(e.message, 'rate_limited', EXIT.upstream, e.retryAfterSeconds != null ? `Retry in ${e.retryAfterSeconds}s.` : 'Try again shortly.');
+    }
+    if (e.status >= 500) {
+        return new CliError(e.message, 'upstream_unavailable', EXIT.upstream, 'The backend or an upstream RPC is unavailable. Try again shortly.');
+    }
+    return new CliError(e.message, 'error', EXIT.error);
+}
+/** Normalize anything a command threw into the one type cli.ts knows how to report. */
+export function toCliError(e) {
+    if (e instanceof CliError)
+        return e;
+    if (e instanceof BotanaryApiError)
+        return fromApiError(e);
+    if (isNetworkError(e)) {
+        return new CliError(e instanceof Error ? e.message : String(e), 'upstream_unavailable', EXIT.upstream, 'Check your connection, or `botanary config` for the API URL in use.');
+    }
+    return new CliError(e instanceof Error ? e.message : String(e), 'error', EXIT.error);
+}
+/** The `--json` failure contract. Successful output stays the bare payload: a zero exit already says ok. */
+export function errorEnvelope(err) {
+    return {
+        ok: false,
+        error: { code: err.code, message: err.message, ...(err.hint ? { hint: err.hint } : {}) },
+    };
+}
+/** The human failure shape the v1 design spec §7 promised: the reason, the machine code, the next step. */
+export function errorLines(err) {
+    const label = err.exit === EXIT.declined ? 'declined' : 'error';
+    const lines = [glyphs.danger(`${label}: ${err.message}`), colors.dim(`  code: ${err.code}`)];
+    if (err.hint)
+        lines.push(`  ${err.hint}`);
+    return lines;
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,CAAC;IACR,WAAW,EAAE,CAAC;IACd,gBAAgB,EAAE,CAAC;IACnB,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,GAAG;CACR,CAAC;AAEX,qGAAqG;AACrG,MAAM,CAAC,MAAM,UAAU,GAA6C;IAClE,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;IACrC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;IACtC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,mBAAmB,EAAE;IACxD,EAAE,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,EAAE,8BAA8B,EAAE;IACxE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,0CAA0C,EAAE;IAC5E,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,sCAAsC,EAAE;IACvE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,8CAA8C,EAAE;IAChF,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,sBAAsB,EAAE;CAC5D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGtB;IACA;IACA;IAJX,YACE,OAAe,EACN,IAAY,EACZ,IAAY,EACZ,IAAa;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAa;IACxD,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,QAAQ,CACjB,oCAAoC,EACpC,eAAe,EACf,IAAI,CAAC,gBAAgB,EACrB,6BAA6B,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,QAAQ,CACjB,0DAA0D,EAC1D,YAAY,EACZ,IAAI,CAAC,gBAAgB,EACrB,2DAA2D,CAC5D,CAAC;AACJ,CAAC;AAED,wGAAwG;AACxG,SAAS,cAAc,CAAC,CAAU;IAChC,IAAI,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,IAAI,GAAI,CAAuB,CAAC,IAAI,CAAC;IAC3C,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QAC7H,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,sCAAsC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,YAAY,CAAC,CAAmB;IACvC,oGAAoG;IACpG,oEAAoE;IACpE,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;IAEpG,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACzC,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,CAAC,gBAAgB,EAAE,6BAA6B,CAAC,CAAC;IAC5G,CAAC;IACD,IAAI,aAAa,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACtC,OAAO,IAAI,QAAQ,CACjB,CAAC,CAAC,OAAO,EACT,aAAa,IAAI,UAAU,EAC3B,IAAI,CAAC,QAAQ,EACb,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACrB,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACzC,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACrB,OAAO,IAAI,QAAQ,CACjB,CAAC,CAAC,OAAO,EACT,cAAc,EACd,IAAI,CAAC,QAAQ,EACb,CAAC,CAAC,iBAAiB,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAC,oBAAoB,CACzF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QACpB,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,sBAAsB,EAAE,IAAI,CAAC,QAAQ,EAAE,mEAAmE,CAAC,CAAC;IAC7I,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,CAAU;IACnC,IAAI,CAAC,YAAY,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,YAAY,gBAAgB;QAAE,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,QAAQ,CACjB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAC1C,sBAAsB,EACtB,IAAI,CAAC,QAAQ,EACb,qEAAqE,CACtE,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,QAAQ,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AACvF,CAAC;AAED,4GAA4G;AAC5G,MAAM,UAAU,aAAa,CAAC,GAAa;IACzC,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;KACzF,CAAC;AACJ,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,UAAU,CAAC,GAAa;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7F,IAAI,GAAG,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/help/examples.js

@@ -0,0 +1,357 @@
+/** 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)',
+    },
+    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 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',
+        ],
+        notes: '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)',
+    },
+    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`.',
+        examples: ['botanary yield', 'botanary yield --json'],
+        seeAlso: 'botanary markets - wallet_yield (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 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)',
+    },
+    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)',
+    },
+    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-check',
+    },
+    'update-check': {
+        body: 'Ask npm whether a newer botanary is published. Cached for a day, silent when offline, and never\n' +
+            'self-updating - it prints the upgrade command and leaves the decision to you.',
+        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 version',
+    },
+    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