botanary 0.1.0 → 0.2.0

package/dist/src/repl.js

@@ -1,9 +1,80 @@
 import readline from 'node:readline';
 import { CommanderError } from 'commander';
+import { botanaryMcpHome } from 'botanary-mcp';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
 import { parseLine } from './parser.js';
 import { renderBanner } from './render/banner.js';
 import { colors } from './render/colors.js';
-const COMMAND_NAMES = ['login', 'logout', 'status', 'balance', 'send', 'activity', 'markets', 'yield', 'mandates', 'agents', 'accounts', 'api', 'agent', 'mcp', 'diagnose', 'config', 'help', 'exit', 'quit'];
+/** Words the REPL itself answers, which are not commands on the program. */
+const REPL_WORDS = ['help', 'clear', 'exit', 'quit', '?'];
+/** Global flags that must be set at startup, not per REPL line. */
+const GLOBAL_FLAGS = new Set([
+    '--json', '--raw', '--quiet', '--verbose', '--no-color', '--no-interactive',
+    '--reveal', '--chain', '--account', '--api-url', '--home', '--timeout', '--debug', '--yes', '--dry-run',
+    '-q', '-y',
+]);
+/**
+ * `botanary balance` typed INSIDE the REPL used to fail with "unknown command 'botanary'" - the exact
+ * papercut the Alchemy CLI reference has too. People type the program name out of habit; stripping it is
+ * three lines and removes a guaranteed first-run error.
+ */
+export function normalizeReplLine(line) {
+    const trimmed = line.trim().replace(/\s+/g, ' ');
+    if (trimmed === '?')
+        return 'help';
+    if (trimmed === 'botanary')
+        return '';
+    if (trimmed.startsWith('botanary '))
+        return trimmed.slice('botanary '.length).trim();
+    return trimmed;
+}
+/**
+ * Completions from the parser tree rather than a hardcoded list: 0.1.0 kept a second copy of every
+ * command name in this file, which drifted the moment a command was added, and only completed at position
+ * zero because it returned the whole line as the token being completed.
+ */
+export function replCompletions(program, line) {
+    const normalized = normalizeReplLine(line);
+    const tokens = parseLine(normalized);
+    const trailingSpace = /\s$/.test(line) || normalized === '';
+    const partial = trailingSpace ? '' : (tokens[tokens.length - 1] ?? '');
+    const consumed = trailingSpace ? tokens : tokens.slice(0, -1);
+    let cmd = program;
+    for (const token of consumed) {
+        const next = cmd.commands.find((c) => c.name() === token || c.aliases().includes(token));
+        if (!next)
+            break;
+        cmd = next;
+    }
+    const candidates = [
+        ...cmd.commands.map((c) => c.name()),
+        ...cmd.options.map((o) => o.long ?? o.short ?? '').filter((f) => f !== ''),
+        ...(cmd === program ? REPL_WORDS : []),
+    ];
+    const hits = candidates.filter((c) => c.startsWith(partial)).sort();
+    return [hits.length ? hits : candidates.sort(), partial];
+}
+const HISTORY_LIMIT = 200;
+const historyPath = () => join(botanaryMcpHome(), 'cli-history');
+async function loadHistory() {
+    try {
+        const lines = (await readFile(historyPath(), 'utf8')).split('\n').filter((l) => l !== '');
+        return lines.slice(0, HISTORY_LIMIT);
+    }
+    catch {
+        return [];
+    }
+}
+async function saveHistory(history) {
+    try {
+        await mkdir(botanaryMcpHome(), { recursive: true });
+        await writeFile(historyPath(), `${history.slice(0, HISTORY_LIMIT).join('\n')}\n`, { encoding: 'utf8', mode: 0o600 });
+    }
+    catch {
+        // A REPL that cannot write its history is still a working REPL - never fail the session over it.
+    }
+}
 /** A dispatched command (e.g. `send`, `agent spend`) may itself build an interactive prompt via
  *  @clack/prompts, which creates its OWN readline interface on this same process.stdin. Verified live:
  *  two readline interfaces alive on one stdin at once is not just cosmetically risky - the REPL's own
@@ -13,18 +84,19 @@ const COMMAND_NAMES = ['login', 'logout', 'status', 'balance', 'send', 'activity
  *  the REPL's still-open outer interface of further input with no way to recover (confirmed: it never
  *  sees a subsequent line again, including "exit"). The fix is to never let two interfaces be alive at
  *  once: close this interface before dispatching, then build a fresh one once the command settles. */
-function createReplInterface() {
+function createReplInterface(program, history) {
     return readline.createInterface({
         input: process.stdin,
         output: process.stdout,
         prompt: colors.brand('> '),
-        completer: (line) => {
-            const hits = COMMAND_NAMES.filter((c) => c.startsWith(line));
-            return [hits.length ? hits : COMMAND_NAMES, line];
-        },
+        // readline wants most-recent-first, which is the order `history` is maintained in.
+        history: [...history],
+        removeHistoryDuplicates: true,
+        completer: (line) => replCompletions(program, line),
     });
 }
 export async function runRepl(program, state) {
+    const history = await loadHistory();
     console.log(renderBanner('BOTANARY'));
     console.log(`${colors.brand('◆')} ${colors.bold('Welcome to Botanary')}`);
     console.log(state.loggedIn ? `${colors.success('✔')} Logged in` : `${colors.muted('not logged in')} - try \`login\``);
@@ -33,7 +105,9 @@ export async function runRepl(program, state) {
     const quick = state.loggedIn ? ['balance', 'send', 'status'] : ['login', 'agent pair'];
     for (const q of quick)
         console.log(colors.dim(`  - ${q}`));
-    console.log(colors.dim("\nPress TAB for autocomplete. Type 'exit' or 'quit' to leave.\n"));
+    console.log(colors.dim("Press TAB for autocomplete. Type 'clear' to clear, 'exit' or 'quit' to leave."));
+    console.log(colors.dim('Ctrl-C leaves immediately.\n'));
+    let savePromise = Promise.resolve();
     await new Promise((resolve) => {
         // The REPL's readline interface gets closed and rebuilt around every dispatched command (see
         // createReplInterface's doc comment), so a *lot* more 'close' events fire than just "the user is
@@ -55,6 +129,7 @@ export async function runRepl(program, state) {
             if (finished)
                 return;
             finished = true;
+            savePromise = saveHistory(history);
             console.log(colors.dim('\nbye.'));
             resolve();
         };
@@ -64,18 +139,43 @@ export async function runRepl(program, state) {
                 queue = queue.then(async () => {
                     if (finished)
                         return;
-                    const trimmed = line.trim();
+                    const trimmed = normalizeReplLine(line);
                     if (trimmed === 'exit' || trimmed === 'quit') {
                         current.close();
                         finish();
                         return;
                     }
+                    if (trimmed === 'clear') {
+                        // \x1bc is a full terminal reset, which also drops the scrollback the banner filled.
+                        process.stdout.write('\x1bc');
+                        current.prompt();
+                        return;
+                    }
                     if (trimmed) {
+                        // Check if the line contains a global flag - these must be set at startup, not per REPL line.
+                        const tokens = parseLine(trimmed);
+                        for (const rawToken of tokens) {
+                            // Split on `=` first: `--chain=8453` is valid syntax everywhere else in this CLI, and
+                            // matching only the bare spelling let that form through silently - which is the exact
+                            // "typed here, quietly ignored" bug this guard exists to prevent.
+                            const token = rawToken.split('=')[0];
+                            if (GLOBAL_FLAGS.has(token)) {
+                                console.log(colors.warning('Global flags (like ' + token + ') must be set when starting botanary, not per REPL line.\n' +
+                                    '  Exit with `quit`, restart with: botanary ' + token + ' ... \n' +
+                                    '  Global flags: --json --raw --quiet --verbose --no-color --no-interactive --reveal ' +
+                                    '--chain --account --api-url --home --timeout --debug --yes --dry-run'));
+                                current.prompt();
+                                return;
+                            }
+                        }
                         // A dispatched command may itself open an interactive prompt (e.g. `send`/`agent spend`
                         // use @clack/prompts, which builds its OWN readline interface on this same process.stdin).
                         // Two live readline interfaces on one stdin fight over raw-mode/keypress state - closing
                         // this one first (and building a fresh one once the command settles) keeps exactly one
                         // interface alive at a time, never two.
+                        history.unshift(trimmed);
+                        if (history.length > HISTORY_LIMIT)
+                            history.length = HISTORY_LIMIT;
                         closingForDispatch = true;
                         current.close();
                         try {
@@ -96,7 +196,7 @@ export async function runRepl(program, state) {
                         finally {
                             closingForDispatch = false;
                             if (!finished) {
-                                attach(createReplInterface());
+                                attach(createReplInterface(program, history));
                                 current.prompt();
                             }
                         }
@@ -120,9 +220,13 @@ export async function runRepl(program, state) {
                 });
             });
         };
-        attach(createReplInterface());
+        attach(createReplInterface(program, history));
         // attach() assigns `current` synchronously before returning.
         current.prompt();
     });
+    // The history save was initiated in finish() but we waited for the REPL to resolve first. Now
+    // wait for the actual file write to complete before returning, so process.exit() (called by
+    // bin/botanary.ts immediately after await runCli() resolves) doesn't race the filesystem I/O.
+    await savePromise;
 }
 //# sourceMappingURL=repl.js.map

package/dist/src/repl.js.map

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

package/dist/src/review.js

@@ -0,0 +1,52 @@
+import * as clack from '@clack/prompts';
+import { colors } from './render/colors.js';
+import { kv, section } from './render/kv.js';
+import { CliError, EXIT, invalidArgs } from './errors.js';
+export function renderReview(title, rows, warnings) {
+    const blocks = [section(title), kv(rows.map((row) => [row.label, row.value]))];
+    if (warnings.length) {
+        blocks.push('');
+        for (const warning of warnings)
+            blocks.push(colors.warning(`  ⚠ ${warning}`));
+    }
+    return blocks.join('\n');
+}
+/** The same panel, flat, for `--dry-run --json`. */
+export function dryRunPayload(title, rows, warnings) {
+    return {
+        dryRun: true,
+        title,
+        review: Object.fromEntries(rows.map((row) => [row.label, row.value])),
+        warnings,
+    };
+}
+/**
+ * Show what is about to happen and get a yes, or refuse.
+ *
+ * 0.1.0 went from four free-text prompts straight to relaying funds. The gate has one hard rule: it never
+ * proceeds on an assumption. `--yes` is an explicit yes; an interactive terminal is asked; and anything
+ * else - a script, a pipe, `--json`, `--no-interactive` - is exit 2 naming the flag it needed, rather than
+ * a prompt that cannot render or a silent self-confirmation.
+ */
+export async function confirmOrThrow(ctx, title, rows, warnings, opts) {
+    // When yes came from the config file (confirm: never), still print the review panel so the user sees
+    // what is happening. When --yes was passed explicitly, skip the panel.
+    const yesFromConfig = ctx.yes && ctx.settings?.provenance?.yes === 'file';
+    if (yesFromConfig) {
+        if (!ctx.quiet)
+            console.log(renderReview(title, rows, warnings));
+        return;
+    }
+    if (ctx.yes)
+        return;
+    if (ctx.json || !ctx.interactive) {
+        throw invalidArgs(`${opts?.because ?? 'This command moves funds and needs a confirmation it cannot ask for here.'} Pass --yes to confirm non-interactively, or --dry-run to preflight it instead.`);
+    }
+    if (!ctx.quiet)
+        console.log(renderReview(title, rows, warnings));
+    const answer = await clack.confirm({ message: opts?.question ?? 'Send it?', initialValue: false });
+    if (answer !== true) {
+        throw new CliError('Cancelled - nothing was signed and nothing was sent.', 'cancelled', EXIT.error);
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/src/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAiB1D,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,IAAiB,EAAE,QAAkB;IAC/E,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAqB,CAAC,CAAC,CAAC,CAAC;IACnG,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,IAAiB,EAAE,QAAkB;IAChF,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,KAAK;QACL,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAc,EACd,KAAa,EACb,IAAiB,EACjB,QAAkB,EAClB,IAA8C;IAE9C,qGAAqG;IACrG,uEAAuE;IACvE,MAAM,aAAa,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,KAAK,MAAM,CAAC;IAC1E,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,CAAC,GAAG,CAAC,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IACD,IAAI,GAAG,CAAC,GAAG;QAAE,OAAO;IACpB,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,WAAW,CACf,GAAG,IAAI,EAAE,OAAO,IAAI,2EAA2E,iFAAiF,CACjL,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,IAAI,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IACnG,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,sDAAsD,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACtG,CAAC;AACH,CAAC"}

package/dist/src/settings.js

@@ -0,0 +1,88 @@
+import pc from 'picocolors';
+import { invalidArgs } from './errors.js';
+function truthy(value) {
+    return value === '1' || value === 'true' || value === 'yes';
+}
+/** One resolution order for everything: flag, then env, then the config file, then a built-in default. */
+export function resolveSettings(input) {
+    const { opts, env, file, stdout, stdin } = input;
+    const provenance = {};
+    function pick(key, candidates, fallback) {
+        for (const [from, value] of candidates) {
+            if (value !== undefined) {
+                provenance[key] = from;
+                return value;
+            }
+        }
+        provenance[key] = 'default';
+        return fallback;
+    }
+    const json = pick('json', [
+        ['flag', opts.json === true ? true : undefined],
+        ['env', truthy(env.BOTANARY_JSON) ? true : undefined],
+        ['file', file.output === 'json' ? true : file.output === 'raw' ? false : undefined],
+    ], !stdout.isTTY);
+    const rawRequested = pick('raw', [
+        ['flag', opts.raw ? true : undefined],
+        ['file', file.output === 'raw' ? true : undefined],
+    ], false);
+    // `--json` wins, including the implicit one a pipe brings: `--raw` is a human affordance, and a machine
+    // consumer always gets the compact single-line form it can parse.
+    const raw = json ? false : rawRequested;
+    // When json overrides a requested raw, update provenance to match the actual value: the source was
+    // overridden, so reporting it would mislead a config list display.
+    if (json && rawRequested) {
+        provenance['raw'] = 'default';
+    }
+    const color = pick('color', [
+        ['flag', opts.color === false ? false : undefined],
+        ['env', env.NO_COLOR ? false : undefined],
+        ['file', file.color === 'never' ? false : file.color === 'auto' ? pc.isColorSupported : undefined],
+    ], pc.isColorSupported);
+    const interactive = pick('interactive', [['flag', opts.interactive === false ? false : undefined]], !!stdin.isTTY && !!stdout.isTTY);
+    const yes = pick('yes', [
+        ['flag', opts.yes ? true : undefined],
+        ['file', file.confirm === 'never' ? true : file.confirm === 'always' ? false : undefined],
+    ], false);
+    const timeoutMs = pick('timeoutMs', [
+        ['flag', opts.timeout === undefined ? undefined : parseTimeout(opts.timeout, '--timeout')],
+        ['env', env.BOTANARY_TIMEOUT_MS === undefined ? undefined : parseTimeout(env.BOTANARY_TIMEOUT_MS, 'BOTANARY_TIMEOUT_MS')],
+    ], null);
+    return {
+        json,
+        raw,
+        quiet: pick('quiet', [['flag', opts.quiet ? true : undefined]], false),
+        verbose: pick('verbose', [['flag', opts.verbose ? true : undefined]], false),
+        debug: pick('debug', [['flag', opts.debug ? true : undefined]], false),
+        color,
+        reveal: pick('reveal', [['flag', opts.reveal ? true : undefined]], false),
+        interactive,
+        yes,
+        dryRun: pick('dryRun', [['flag', opts.dryRun ? true : undefined]], false),
+        chain: pick('chain', [
+            ['flag', opts.chain],
+            ['env', env.BOTANARY_CHAIN_ID],
+            ['file', file.chainId],
+        ], null),
+        account: pick('account', [
+            ['flag', opts.account],
+            ['env', env.BOTANARY_ACCOUNT_ID],
+            ['file', file.accountId],
+        ], null),
+        apiUrl: pick('apiUrl', [
+            ['flag', opts.apiUrl],
+            ['env', env.BOTANARY_API_URL],
+            ['file', file.apiUrl],
+        ], null),
+        timeoutMs,
+        provenance,
+    };
+}
+function parseTimeout(value, source) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw invalidArgs(`${source} must be a positive number of milliseconds, got "${value}".`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=settings.js.map

package/dist/src/settings.js.map

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

package/dist/src/update-check.js

@@ -0,0 +1,85 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { botanaryMcpHome } from 'botanary-mcp';
+/** One check a day is plenty: this is a courtesy, not a dependency. */
+export const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const REGISTRY_URL = 'https://registry.npmjs.org/botanary/latest';
+const DEFAULT_TIMEOUT_MS = 1_500;
+export function cachePath() {
+    return join(botanaryMcpHome(), 'update-check.json');
+}
+export async function readCache() {
+    try {
+        const parsed = JSON.parse(await readFile(cachePath(), 'utf8'));
+        if (typeof parsed.checkedAt !== 'number')
+            return null;
+        if (typeof parsed.latest !== 'string' && parsed.latest !== null)
+            return null;
+        return { checkedAt: parsed.checkedAt, latest: parsed.latest };
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeCache(entry) {
+    try {
+        await mkdir(botanaryMcpHome(), { recursive: true });
+        await writeFile(cachePath(), `${JSON.stringify(entry)}\n`, { encoding: 'utf8', mode: 0o600 });
+    }
+    catch {
+        // A cache we cannot write just means we check again next time. Never fail a command over it.
+    }
+}
+/** Numeric segment comparison. A prerelease sorts BELOW its release, so a beta never nags a stable user. */
+export function isNewer(latest, current) {
+    const parse = (version) => {
+        const match = /^(\d+)\.(\d+)\.(\d+)(-.*)?$/.exec(version.trim());
+        if (!match)
+            return null;
+        return [Number(match[1]), Number(match[2]), Number(match[3]), match[4] ? 0 : 1];
+    };
+    const a = parse(latest);
+    const b = parse(current);
+    if (!a || !b)
+        return false;
+    for (let i = 0; i < 4; i += 1) {
+        if (a[i] !== b[i])
+            return a[i] > b[i];
+    }
+    return false;
+}
+/** Never throws, never waits long. A registry that is slow or unreachable simply produces no answer. */
+export async function fetchLatest(deps) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), deps.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    try {
+        const response = await deps.fetchImpl(REGISTRY_URL, { signal: controller.signal });
+        if (!response.ok)
+            return null;
+        const body = (await response.json());
+        return typeof body.version === 'string' ? body.version : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function checkForUpdate(current, deps) {
+    const cached = await readCache();
+    if (!deps.force && cached && deps.now() - cached.checkedAt < CACHE_TTL_MS) {
+        return { current, latest: cached.latest, newer: cached.latest ? isNewer(cached.latest, current) : false, fromCache: true };
+    }
+    const latest = await fetchLatest(deps);
+    await writeCache({ checkedAt: deps.now(), latest });
+    return { current, latest, newer: latest ? isNewer(latest, current) : false, fromCache: false };
+}
+export function nagLine(latest, current) {
+    return `Update available: ${current} to ${latest}. Run \`npm i -g botanary\` (or use \`npx botanary\`).`;
+}
+/** CI is included because a nag in a build log is noise nobody can act on from there. */
+export function nagSuppressed(env) {
+    return !!env.BOTANARY_NO_UPDATE_NOTIFIER || !!env.CI;
+}
+//# sourceMappingURL=update-check.js.map

package/dist/src/update-check.js.map

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

package/dist/src/validate.js

@@ -0,0 +1,92 @@
+import { CliError, EXIT, invalidArgs } from './errors.js';
+/** Validate an amount at the one boundary that can still say which flag was wrong. 0.1.0 passed the raw
+ *  string to `Number()`, so `--amount abc` became NaN and travelled all the way to a build call. */
+export function parseAmount(raw, flag = '--amount') {
+    const value = typeof raw === 'number' ? raw : typeof raw === 'string' ? Number(raw.trim()) : Number.NaN;
+    if (!Number.isFinite(value) || value <= 0) {
+        throw invalidArgs(`${flag} must be a positive number, got ${JSON.stringify(raw)}.`, 'Amounts are in display units, e.g. 25 for 25 USDC.');
+    }
+    return value;
+}
+/** CAIP-2 namespaces map one-to-one onto address formats. Unknown or absent defaults to EVM, which is the
+ *  only family a chain row without a namespace could be under the current contract. */
+export function familyOf(namespace) {
+    if (namespace === 'solana')
+        return 'solana';
+    if (namespace === 'stellar')
+        return 'stellar';
+    return 'evm';
+}
+const PATTERNS = {
+    evm: { re: /^0x[0-9a-fA-F]{40}$/, label: 'an EVM address', example: '0x' + 'ab'.repeat(20) },
+    solana: { re: /^[1-9A-HJ-NP-Za-km-z]{32,44}$/, label: 'a Solana address', example: '4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T' },
+    stellar: { re: /^G[A-Z2-7]{55}$/, label: 'a Stellar address', example: `G${'A'.repeat(55)}` },
+};
+export function assertAddress(raw, family) {
+    if (typeof raw !== 'string' || raw.trim() === '') {
+        throw invalidArgs('--recipient is required.', `Expected ${PATTERNS[family].label}, e.g. ${PATTERNS[family].example}.`);
+    }
+    const value = raw.trim();
+    const pattern = PATTERNS[family];
+    if (!pattern.re.test(value)) {
+        throw invalidArgs(`"${value}" is not ${pattern.label}.`, `This chain expects ${pattern.label}, e.g. ${pattern.example}.`);
+    }
+    return value;
+}
+/** Resolve whatever the user typed against the chains the backend actually serves. Accepts a chain id, a
+ *  chain key, a CAIP-2 chainRef, or a case-insensitive name, because all four appear in the product. */
+export function findChain(chains, ref) {
+    const list = (Array.isArray(chains) ? chains : []);
+    if (!list.length) {
+        throw new CliError('The backend reported no chains at all.', 'no_chains', EXIT.upstream, 'Try again shortly, or check `botanary config` for the API URL in use.');
+    }
+    if (ref === null || ref === undefined || ref === '') {
+        throw invalidArgs('--chain is required.', `Pass --chain-id for EVM chains or --chain for any family, or set one with \`botanary config set chainId <id>\`. See \`botanary chains\`.`);
+    }
+    const needle = String(ref).trim().toLowerCase();
+    const match = list.find((chain) => String(chain.key ?? '').toLowerCase() === needle ||
+        String(chain.chainId ?? '').toLowerCase() === needle ||
+        String(chain.chainRef ?? '').toLowerCase() === needle ||
+        String(chain.name ?? '').toLowerCase() === needle);
+    if (!match) {
+        const known = list.map((chain) => chain.key).filter(Boolean).slice(0, 12).join(', ');
+        throw invalidArgs(`"${ref}" is not a chain this backend serves. Try one of: ${known}.`, `Full list: \`botanary chains\`.`);
+    }
+    return {
+        key: String(match.key ?? ''),
+        name: String(match.name ?? ''),
+        chainId: typeof match.chainId === 'number' ? match.chainId : null,
+        chainRef: String(match.chainRef ?? ''),
+        namespace: String(match.namespace ?? 'eip155'),
+        tier: String(match.tier ?? ''),
+        testnet: match.testnet === true,
+    };
+}
+/**
+ * Refuse before building what the chain's own tier cannot do. This is an OFF-CHAIN preflight, never an
+ * on-chain revert - product copy must not imply otherwise (workspace CLAUDE.md, "Chain families and
+ * tiers") - and it reports as a decline rather than a usage error, because nothing about the command was
+ * malformed.
+ */
+export function assertTierAllows(chain, need) {
+    if (need === 'read')
+        return;
+    if (chain.tier === 'watch') {
+        throw new CliError(`${chain.name} (${chain.key}) is a watch-tier chain: read-only, with no bundler.`, 'chain_capability_unavailable', EXIT.declined, 'Pick a chain with tier basic or botanary - see `botanary chains`.');
+    }
+    if (need === 'authority' && chain.tier !== 'botanary') {
+        throw new CliError(`${chain.name} (${chain.key}) carries no AgentGuard, so authority actions are unavailable there.`, 'chain_capability_unavailable', EXIT.declined, 'Authority actions need a botanary-tier chain - see `botanary chains`.');
+    }
+}
+/** Tokens actually held on one chain, largest holding first, for a `select` prompt. Never a catalog: a
+ *  token the account does not hold is not a sendable choice. */
+export function tokenChoicesFor(balance, chainRef) {
+    const holdings = balance?.holdings;
+    const list = Array.isArray(holdings) ? holdings : [];
+    return list
+        .filter((h) => typeof h.assetRef === 'string' && h.assetRef.split('/')[0] === chainRef)
+        .filter((h) => typeof h.symbol === 'string' && typeof h.amount === 'number' && h.amount > 0)
+        .map((h) => ({ symbol: h.symbol, amount: h.amount }))
+        .sort((a, b) => b.amount - a.amount);
+}
+//# sourceMappingURL=validate.js.map

package/dist/src/validate.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "botanary",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Botanary from your terminal - a guided CLI over the same wallet and agent lanes botanary-mcp exposes to a coding agent.",
   "license": "UNLICENSED",
   "homepage": "https://docs.botanary.xyz",
@@ -23,7 +23,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "botanary-mcp": "^0.5.0",
+    "botanary-mcp": "^0.6.0",
     "commander": "^13.1.0",
     "@clack/prompts": "^0.9.1",
     "picocolors": "^1.1.1",