botanary 0.1.0 → 0.2.0

package/dist/src/help/examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../../../src/help/examples.ts"],"names":[],"mappings":"AAqBA,4GAA4G;AAC5G,MAAM,CAAC,MAAM,YAAY,GAAgC;IACvD,KAAK,EAAE;QACL,IAAI,EACF,oGAAoG;YACpG,uGAAuG;YACvG,gGAAgG;QAClG,QAAQ,EAAE,CAAC,gBAAgB,EAAE,uBAAuB,CAAC;QACrD,KAAK,EAAE,mGAAmG;QAC1G,OAAO,EAAE,uDAAuD;KACjE;IACD,MAAM,EAAE;QACN,IAAI,EAAE,gFAAgF;QACtF,QAAQ,EAAE,CAAC,iBAAiB,CAAC;QAC7B,OAAO,EAAE,sCAAsC;KAChD;IACD,MAAM,EAAE;QACN,IAAI,EAAE,mHAAmH;QACzH,QAAQ,EAAE,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;QACvD,OAAO,EAAE,0DAA0D;KACpE;IACD,MAAM,EAAE;QACN,IAAI,EACF,mGAAmG;YACnG,oEAAoE;QACtE,QAAQ,EAAE,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;QACvD,OAAO,EAAE,uEAAuE;KACjF;IACD,OAAO,EAAE;QACP,IAAI,EACF,uGAAuG;YACvG,kGAAkG;YAClG,qEAAqE;QACvE,QAAQ,EAAE,CAAC,kBAAkB,EAAE,iDAAiD,EAAE,wBAAwB,CAAC;QAC3G,OAAO,EAAE,6DAA6D;KACvE;IACD,IAAI,EAAE;QACJ,IAAI,EACF,kGAAkG;YAClG,wFAAwF;YACxF,IAAI;YACJ,wCAAwC;YACxC,wEAAwE;YACxE,oEAAoE;QACtE,QAAQ,EAAE;YACR,yEAAyE;YACzE,6EAA6E;YAC7E,uFAAuF;YACvF,0GAA0G;SAC3G;QACD,KAAK,EACH,gFAAgF;YAChF,8HAA8H;QAChI,OAAO,EAAE,sEAAsE;KAChF;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,4EAA4E;QAClF,QAAQ,EAAE,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;QAC3D,OAAO,EAAE,0CAA0C;KACpD;IACD,OAAO,EAAE;QACP,IAAI,EAAE,yFAAyF;QAC/F,QAAQ,EAAE,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;QACzD,OAAO,EAAE,uCAAuC;KACjD;IACD,KAAK,EAAE;QACL,IAAI,EACF,kGAAkG;YAClG,sEAAsE;QACxE,QAAQ,EAAE,CAAC,gBAAgB,EAAE,uBAAuB,CAAC;QACrD,OAAO,EAAE,uCAAuC;KACjD;IACD,QAAQ,EAAE;QACR,IAAI,EACF,wGAAwG;YACxG,kCAAkC;QACpC,QAAQ,EAAE,CAAC,mBAAmB,EAAE,2BAA2B,EAAE,0BAA0B,CAAC;QACxF,KAAK,EAAE,qFAAqF;QAC5F,OAAO,EAAE,+DAA+D;KACzE;IACD,kBAAkB,EAAE;QAClB,IAAI,EACF,wGAAwG;YACxG,+FAA+F;QACjG,QAAQ,EAAE,CAAC,2BAA2B,EAAE,kCAAkC,CAAC;QAC3E,OAAO,EAAE,mEAAmE;KAC7E;IACD,MAAM,EAAE;QACN,IAAI,EAAE,sFAAsF;QAC5F,QAAQ,EAAE,CAAC,iBAAiB,EAAE,wBAAwB,CAAC;QACvD,OAAO,EAAE,kEAAkE;KAC5E;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,iDAAiD;QACvD,QAAQ,EAAE,CAAC,wBAAwB,EAAE,8BAA8B,CAAC;QACpE,OAAO,EAAE,4CAA4C;KACtD;IACD,eAAe,EAAE;QACf,IAAI,EAAE,+DAA+D;QACrE,QAAQ,EAAE,CAAC,wBAAwB,EAAE,+BAA+B,CAAC;QACrE,OAAO,EAAE,uBAAuB;KACjC;IACD,cAAc,EAAE;QACd,IAAI,EACF,qGAAqG;YACrG,yEAAyE;QAC3E,QAAQ,EAAE,CAAC,8BAA8B,CAAC;QAC1C,OAAO,EAAE,mDAAmD;KAC7D;IACD,MAAM,EAAE;QACN,IAAI,EACF,uEAAuE;YACvE,oDAAoD;YACpD,mGAAmG;YACnG,4DAA4D;YAC5D,IAAI;YACJ,uDAAuD;QACzD,QAAQ,EAAE,CAAC,iBAAiB,EAAE,6EAA6E,CAAC;QAC5G,OAAO,EAAE,iDAAiD;KAC3D;IACD,GAAG,EAAE;QACH,IAAI,EACF,oGAAoG;YACpG,uGAAuG;YACvG,iBAAiB;QACnB,QAAQ,EAAE,CAAC,8BAA8B,EAAE,qCAAqC,CAAC;QACjF,OAAO,EAAE,wDAAwD;KAClE;IACD,GAAG,EAAE;QACH,IAAI,EACF,sGAAsG;YACtG,6FAA6F;YAC7F,6FAA6F;QAC/F,QAAQ,EAAE;YACR,sBAAsB;YACtB,mDAAmD;YACnD,qBAAqB;YACrB,2BAA2B;SAC5B;QACD,OAAO,EAAE,4DAA4D;KACtE;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,oEAAoE;QAC1E,QAAQ,EAAE,CAAC,eAAe,EAAE,wBAAwB,EAAE,sBAAsB,CAAC;QAC7E,OAAO,EAAE,eAAe;KACzB;IACD,KAAK,EAAE;QACL,IAAI,EACF,oGAAoG;YACpG,yFAAyF;QAC3F,QAAQ,EAAE,CAAC,uBAAuB,EAAE,sBAAsB,EAAE,qBAAqB,CAAC;QAClF,OAAO,EAAE,oCAAoC;KAC9C;IACD,cAAc,EAAE;QACd,IAAI,EACF,yGAAyG;YACzG,uGAAuG;YACvG,0CAA0C;QAC5C,QAAQ,EAAE,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;QACnE,OAAO,EAAE,iFAAiF;KAC3F;IACD,gBAAgB,EAAE;QAChB,IAAI,EACF,wGAAwG;YACxG,uGAAuG;YACvG,4EAA4E;QAC9E,QAAQ,EAAE,CAAC,yBAAyB,EAAE,gCAAgC,CAAC;QACvE,OAAO,EAAE,iEAAiE;KAC3E;IACD,YAAY,EAAE;QACZ,IAAI,EACF,qGAAqG;YACrG,uGAAuG;YACvG,qBAAqB;QACvB,QAAQ,EAAE,CAAC,qBAAqB,EAAE,kCAAkC,CAAC;QACrE,KAAK,EAAE,yIAAyI;QAChJ,OAAO,EAAE,gDAAgD;KAC1D;IACD,aAAa,EAAE;QACb,IAAI,EAAE,0FAA0F;QAChG,QAAQ,EAAE,CAAC,sBAAsB,EAAE,6BAA6B,CAAC;QACjE,OAAO,EAAE,gEAAgE;KAC1E;IACD,eAAe,EAAE;QACf,IAAI,EAAE,qGAAqG;QAC3G,QAAQ,EAAE,CAAC,wBAAwB,EAAE,yCAAyC,CAAC;QAC/E,OAAO,EAAE,2CAA2C;KACrD;IACD,eAAe,EAAE;QACf,IAAI,EAAE,6FAA6F;QACnG,QAAQ,EAAE,CAAC,wBAAwB,EAAE,+BAA+B,CAAC;QACrE,OAAO,EAAE,sCAAsC;KAChD;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,gFAAgF;QACtF,QAAQ,EAAE,CAAC,yBAAyB,EAAE,gCAAgC,CAAC;QACvE,OAAO,EAAE,8CAA8C;KACxD;IACD,eAAe,EAAE;QACf,IAAI,EACF,yGAAyG;YACzG,oGAAoG;YACpG,qDAAqD;QACvD,QAAQ,EAAE;YACR,uFAAuF;YACvF,+EAA+E;SAChF;QACD,KAAK,EAAE,mHAAmH;QAC1H,OAAO,EAAE,wEAAwE;KAClF;IACD,aAAa,EAAE;QACb,IAAI,EACF,sGAAsG;YACtG,uGAAuG;YACvG,4DAA4D;QAC9D,QAAQ,EAAE;YACR,oFAAoF;YACpF,8FAA8F;SAC/F;QACD,KAAK,EAAE,oFAAoF;QAC3F,OAAO,EAAE,qEAAqE;KAC/E;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,uFAAuF;QAC7F,QAAQ,EAAE;YACR,qFAAqF;YACrF,4GAA4G;SAC7G;QACD,OAAO,EAAE,2CAA2C;KACrD;IACD,cAAc,EAAE;QACd,IAAI,EACF,yGAAyG;YACzG,oGAAoG;QACtG,QAAQ,EAAE,CAAC,8BAA8B,EAAE,qCAAqC,CAAC;QACjF,OAAO,EAAE,gDAAgD;KAC1D;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,kGAAkG;QACxG,QAAQ,EAAE,CAAC,sCAAsC,EAAE,6CAA6C,CAAC;QACjG,OAAO,EAAE,6DAA6D;KACvE;IACD,WAAW,EAAE;QACX,IAAI,EAAE,yFAAyF;QAC/F,QAAQ,EAAE,CAAC,kGAAkG,CAAC;QAC9G,OAAO,EAAE,6DAA6D;KACvE;IACD,cAAc,EAAE;QACd,IAAI,EAAE,yFAAyF;QAC/F,QAAQ,EAAE,CAAC,wCAAwC,EAAE,+CAA+C,CAAC;QACrG,OAAO,EAAE,4CAA4C;KACtD;IACD,cAAc,EAAE;QACd,IAAI,EACF,iGAAiG;YACjG,gFAAgF;QAClF,QAAQ,EAAE,CAAC,uBAAuB,CAAC;QACnC,OAAO,EAAE,8CAA8C;KACxD;IACD,sBAAsB,EAAE;QACtB,IAAI,EACF,yGAAyG;YACzG,4FAA4F;QAC9F,QAAQ,EAAE,CAAC,sCAAsC,CAAC;QAClD,OAAO,EAAE,8CAA8C;KACxD;IACD,GAAG,EAAE;QACH,IAAI,EAAE,mGAAmG;QACzG,QAAQ,EAAE,CAAC,4BAA4B,EAAE,6BAA6B,EAAE,oBAAoB,CAAC;QAC7F,OAAO,EAAE,qBAAqB;KAC/B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,0DAA0D;QAChE,QAAQ,EAAE,CAAC,4BAA4B,EAAE,4BAA4B,CAAC;QACtE,OAAO,EAAE,sBAAsB;KAChC;IACD,aAAa,EAAE;QACb,IAAI,EACF,mGAAmG;YACnG,0FAA0F;YAC1F,IAAI;YACJ,wGAAwG;YACxG,kDAAkD;QACpD,QAAQ,EAAE,CAAC,6BAA6B,EAAE,kCAAkC,CAAC;QAC7E,OAAO,EAAE,qBAAqB;KAC/B;IACD,WAAW,EAAE;QACX,IAAI,EACF,iGAAiG;YACjG,mEAAmE;QACrE,QAAQ,EAAE,CAAC,oBAAoB,CAAC;QAChC,OAAO,EAAE,qBAAqB;KAC/B;IACD,QAAQ,EAAE;QACR,IAAI,EACF,yGAAyG;YACzG,sGAAsG;YACtG,uFAAuF;QACzF,QAAQ,EAAE,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;QAC3D,OAAO,EAAE,yDAAyD;KACnE;IACD,MAAM,EAAE;QACN,IAAI,EAAE,uFAAuF;QAC7F,QAAQ,EAAE,CAAC,iBAAiB,CAAC;QAC7B,OAAO,EAAE,mBAAmB;KAC7B;IACD,MAAM,EAAE;QACN,IAAI,EACF,wGAAwG;YACxG,4DAA4D;QAC9D,QAAQ,EAAE,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,kCAAkC,CAAC;QACzF,OAAO,EAAE,mBAAmB;KAC7B;IACD,aAAa,EAAE;QACb,IAAI,EACF,uGAAuG;YACvG,qGAAqG;YACrG,6FAA6F;QAC/F,QAAQ,EAAE,CAAC,sBAAsB,EAAE,6BAA6B,CAAC;QACjE,OAAO,EAAE,qBAAqB;KAC/B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,6DAA6D;QACnE,QAAQ,EAAE,CAAC,6BAA6B,CAAC;QACzC,OAAO,EAAE,sBAAsB;KAChC;IACD,YAAY,EAAE;QACZ,IAAI,EACF,kGAAkG;YAClG,4GAA4G;QAC9G,QAAQ,EAAE,CAAC,kCAAkC,EAAE,iCAAiC,CAAC;QACjF,OAAO,EAAE,6CAA6C;KACvD;IACD,cAAc,EAAE;QACd,IAAI,EAAE,qFAAqF;QAC3F,QAAQ,EAAE,CAAC,+BAA+B,CAAC;QAC3C,OAAO,EAAE,sBAAsB;KAChC;IACD,OAAO,EAAE;QACP,IAAI,EAAE,qCAAqC;QAC3C,QAAQ,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;QACpD,OAAO,EAAE,uBAAuB;KACjC;IACD,cAAc,EAAE;QACd,IAAI,EACF,mGAAmG;YACnG,+EAA+E;QACjF,QAAQ,EAAE,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;QACnE,KAAK,EAAE,sFAAsF;QAC7F,OAAO,EAAE,kBAAkB;KAC5B;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,2EAA2E;QACjF,QAAQ,EAAE,CAAC,eAAe,EAAE,wBAAwB,CAAC;QACrD,OAAO,EAAE,eAAe;KACzB;IACD,UAAU,EAAE;QACV,IAAI,EACF,mGAAmG;YACnG,qCAAqC;QACvC,QAAQ,EAAE;YACR,sDAAsD;YACtD,uCAAuC;SACxC;QACD,OAAO,EAAE,eAAe;KACzB;IACD,MAAM,EAAE;QACN,IAAI,EACF,qGAAqG;YACrG,wGAAwG;YACxG,+DAA+D;QACjE,QAAQ,EAAE,CAAC,iBAAiB,EAAE,+BAA+B,CAAC;QAC9D,OAAO,EAAE,0CAA0C;KACpD;CACF,CAAC;AAEF,yFAAyF;AACzF,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAmB,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QAC9D,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/src/help/format.js

@@ -0,0 +1,144 @@
+import { colors } from '../render/colors.js';
+import { DOCS_URL, GROUP_ORDER, OPTION_SECTIONS, QUICK_START, groupOf } from './groups.js';
+import { helpFor } from './examples.js';
+import { EXIT_CODES } from '../errors.js';
+/** Column at which a description starts. Long terms simply push their description one space right. */
+const TERM_WIDTH = 22;
+function heading(title) {
+    return colors.brand(colors.bold(`◆ ${title}`));
+}
+function subheading(title) {
+    return colors.bold(`  ${title}`);
+}
+function entry(term, description, indent = '  ') {
+    return `${indent}${term.padEnd(TERM_WIDTH)} ${description}`.trimEnd();
+}
+function indentBlock(text, indent) {
+    return text
+        .split('\n')
+        .map((line) => (line ? `${indent}${line}` : ''))
+        .join('\n');
+}
+/**
+ * commander synthesizes a placeholder Command for the implicit `help` subcommand, so there is no
+ * registration site to tag it at. This is the ONE place a name match is unavoidable; everything else
+ * groups by the tag recorded on the Command object itself.
+ */
+function groupOfVisible(cmd) {
+    return cmd.name() === 'help' ? 'Utilities' : groupOf(cmd);
+}
+/** Assign every option to exactly one section, with anything unlisted falling into the last one. */
+function sectionize(options) {
+    const buckets = OPTION_SECTIONS.map((s) => ({ title: s.title, options: [] }));
+    const fallback = buckets[buckets.length - 1];
+    for (const option of options) {
+        const index = OPTION_SECTIONS.findIndex((s) => s.flags.includes(option.long ?? ''));
+        (index >= 0 ? buckets[index] : fallback).options.push(option);
+    }
+    return buckets.filter((bucket) => bucket.options.length > 0);
+}
+function optionLines(options, helper) {
+    const lines = [];
+    for (const bucket of sectionize(options)) {
+        lines.push(subheading(bucket.title));
+        for (const option of bucket.options) {
+            lines.push(entry(helper.optionTerm(option), helper.optionDescription(option), '    '));
+        }
+    }
+    return lines;
+}
+export function formatRootHelp(cmd, helper) {
+    const lines = [];
+    lines.push(`${colors.bold('Usage:')} ${helper.commandUsage(cmd)}`);
+    lines.push('');
+    lines.push(cmd.description());
+    lines.push('');
+    const visible = helper.visibleCommands(cmd);
+    for (const title of GROUP_ORDER) {
+        const group = visible.filter((c) => groupOfVisible(c) === title);
+        if (!group.length)
+            continue;
+        lines.push(heading(title));
+        for (const sub of group) {
+            lines.push(entry(helper.subcommandTerm(sub), helper.subcommandDescription(sub)));
+        }
+        lines.push('');
+    }
+    const options = helper.visibleOptions(cmd);
+    if (options.length) {
+        lines.push(heading('Global options'));
+        lines.push(...optionLines(options, helper));
+        lines.push('');
+    }
+    lines.push(heading('Quick Start'));
+    for (const line of QUICK_START)
+        lines.push(`  ${line}`);
+    lines.push('');
+    lines.push(heading('Exit Codes'));
+    for (const { code, meaning } of EXIT_CODES)
+        lines.push(`  ${String(code).padEnd(5)}${meaning}`);
+    lines.push('');
+    lines.push(heading('Resources'));
+    lines.push(`  Docs: ${DOCS_URL}`);
+    return `${lines.join('\n')}\n`;
+}
+export function formatCommandHelp(cmd, helper) {
+    const meta = helpFor(cmd);
+    const lines = [];
+    lines.push(`${colors.bold('Usage:')} ${helper.commandUsage(cmd)}`);
+    lines.push('');
+    lines.push(helper.commandDescription(cmd));
+    if (meta?.body) {
+        lines.push('');
+        lines.push(meta.body);
+    }
+    const subcommands = helper.visibleCommands(cmd);
+    if (subcommands.length) {
+        lines.push('');
+        lines.push(heading('Commands'));
+        for (const sub of subcommands) {
+            lines.push(entry(helper.subcommandTerm(sub), helper.subcommandDescription(sub)));
+        }
+    }
+    const own = helper.visibleOptions(cmd);
+    if (own.length) {
+        lines.push('');
+        lines.push(heading('Options'));
+        for (const option of own) {
+            lines.push(entry(helper.optionTerm(option), helper.optionDescription(option)));
+        }
+    }
+    const globals = helper.visibleGlobalOptions(cmd);
+    if (globals.length) {
+        lines.push('');
+        lines.push(heading('Global options'));
+        lines.push(...optionLines(globals, helper));
+    }
+    if (meta?.examples.length) {
+        lines.push('');
+        lines.push(heading('Examples'));
+        for (const example of meta.examples)
+            lines.push(`  ${example}`);
+    }
+    if (meta?.notes) {
+        lines.push('');
+        lines.push(heading('Notes'));
+        lines.push(indentBlock(meta.notes, '  '));
+    }
+    if (meta?.seeAlso) {
+        lines.push('');
+        lines.push(heading('See also'));
+        lines.push(colors.dim(`  ${meta.seeAlso}`));
+    }
+    return `${lines.join('\n')}\n`;
+}
+/**
+ * One formatter registered on the root, dispatching on whether it was handed the root or a subcommand.
+ * commander inherits `configureHelp` into every subcommand, which is what made 0.1.0's root-shaped
+ * formatter mislabel and silently drop subcommand help - inheritance is fine, a formatter that ignores
+ * which command it is rendering is not.
+ */
+export function formatHelp(cmd, helper) {
+    return cmd.parent === null ? formatRootHelp(cmd, helper) : formatCommandHelp(cmd, helper);
+}
+//# sourceMappingURL=format.js.map

package/dist/src/help/format.js.map

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

package/dist/src/help/groups.js

@@ -0,0 +1,39 @@
+/**
+ * Group titles, in the order root help prints them.
+ *
+ * `Other` is the catch-all, and it is load-bearing: `botanary@0.1.0` grouped commands by matching a flat
+ * allowlist of names, so any command nobody remembered to list vanished from help entirely (`agent --help`
+ * showed one of twelve subcommands). Tagging at registration plus an always-visible catch-all means the
+ * worst case is a command in the wrong section, never a command nobody can find - and
+ * test/help-format.spec.ts asserts `Other` is empty, which turns a forgotten tag into a failing test.
+ */
+export const GROUP_ORDER = ['Wallet', 'Agent', 'Connect', 'System', 'Utilities', 'Other'];
+/** Keyed by the Command object itself, so nothing depends on a name matching a list. */
+const TAGS = new WeakMap();
+/** Tag `cmd` for root help. Returns `cmd`, so it wraps a `.command(...)` chain in place. */
+export function group(cmd, title) {
+    TAGS.set(cmd, title);
+    return cmd;
+}
+export function groupOf(cmd) {
+    return TAGS.get(cmd) ?? 'Other';
+}
+/**
+ * Global-option sections, in help order, keyed by commander's own `option.long` (so `--no-color`, not
+ * `--color`). A long flag missing from every section is printed under the last one rather than dropped.
+ */
+export const OPTION_SECTIONS = [
+    { title: 'General', flags: ['--version', '--help'] },
+    { title: 'Auth and Network', flags: ['--chain', '--chain-id', '--account', '--api-url', '--home'] },
+    { title: 'Output and Formatting', flags: ['--json', '--raw', '--quiet', '--verbose', '--no-color', '--reveal'] },
+    { title: 'Runtime and Behavior', flags: ['--timeout', '--debug', '--no-interactive', '--yes', '--dry-run'] },
+];
+/** The four lines root help prints under Quick Start. Deliberately the shortest useful path in. */
+export const QUICK_START = [
+    'botanary login                      Log in as the owner, in your browser',
+    'botanary balance                    What you hold, across every chain',
+    'botanary chains                     Which chains work, and what each can do',
+    'botanary send --dry-run             Preflight a payment without sending it',
+];
+export const DOCS_URL = 'https://docs.botanary.xyz';
+//# sourceMappingURL=groups.js.map

package/dist/src/help/groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.js","sourceRoot":"","sources":["../../../src/help/groups.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AAInG,wFAAwF;AACxF,MAAM,IAAI,GAAG,IAAI,OAAO,EAAuB,CAAC;AAEhD,4FAA4F;AAC5F,MAAM,UAAU,KAAK,CAAoB,GAAM,EAAE,KAAiB;IAChE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAA8C;IACxE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE;IACpD,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;IACnG,EAAE,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE;IAChH,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE;CAC7G,CAAC;AAEF,mGAAmG;AACnG,MAAM,CAAC,MAAM,WAAW,GAAa;IACnC,0EAA0E;IAC1E,uEAAuE;IACvE,6EAA6E;IAC7E,4EAA4E;CAC7E,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,2BAA2B,CAAC"}

package/dist/src/mcp-snippets.js

@@ -4,18 +4,24 @@ export const MCP_SNIPPETS = {
     claude: {
         label: 'Claude Code',
         snippet: 'claude mcp add --transport stdio botanary -- npx -y botanary-mcp',
+        // Its own CLI owns its config. Running the client's documented command is a far smaller blast radius
+        // than us editing a config file we do not own.
+        installCommand: ['claude', 'mcp', 'add', '--transport', 'stdio', 'botanary', '--', 'npx', '-y', 'botanary-mcp'],
     },
     codex: {
         label: 'Codex',
         snippet: 'codex mcp add botanary -- npx -y botanary-mcp',
+        installCommand: ['codex', 'mcp', 'add', 'botanary', '--', 'npx', '-y', 'botanary-mcp'],
     },
     cursor: {
         label: 'Cursor (.cursor/mcp.json)',
         snippet: JSON.stringify({ mcpServers: { botanary: { command: 'npx', args: ['-y', 'botanary-mcp'] } } }, null, 2),
+        configPath: '.cursor/mcp.json',
     },
     'claude-desktop': {
         label: 'Claude Desktop (claude_desktop_config.json)',
         snippet: JSON.stringify({ mcpServers: { botanary: { command: 'npx', args: ['-y', 'botanary-mcp'], env: { BOTANARY_API_URL: 'https://api.app.botanary.xyz' } } } }, null, 2),
+        configPath: 'claude_desktop_config.json',
     },
 };
 //# sourceMappingURL=mcp-snippets.js.map

package/dist/src/mcp-snippets.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-snippets.js","sourceRoot":"","sources":["../../src/mcp-snippets.ts"],"names":[],"mappings":"AAAA;iGACiG;AACjG,MAAM,CAAC,MAAM,YAAY,GAAuD;IAC9E,MAAM,EAAE;QACN,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,kEAAkE;KAC5E;IACD,KAAK,EAAE;QACL,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,+CAA+C;KACzD;IACD,MAAM,EAAE;QACN,KAAK,EAAE,2BAA2B;QAClC,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,EAAE,EAC9E,IAAI,EACJ,CAAC,CACF;KACF;IACD,gBAAgB,EAAE;QAChB,KAAK,EAAE,6CAA6C;QACpD,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,EAAE,gBAAgB,EAAE,8BAA8B,EAAE,EAAE,EAAE,EAAE,EACzI,IAAI,EACJ,CAAC,CACF;KACF;CACF,CAAC"}
+{"version":3,"file":"mcp-snippets.js","sourceRoot":"","sources":["../../src/mcp-snippets.ts"],"names":[],"mappings":"AAAA;iGACiG;AACjG,MAAM,CAAC,MAAM,YAAY,GAGrB;IACF,MAAM,EAAE;QACN,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,kEAAkE;QAC3E,qGAAqG;QACrG,+CAA+C;QAC/C,cAAc,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC;KAChH;IACD,KAAK,EAAE;QACL,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,+CAA+C;QACxD,cAAc,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,CAAC;KACvF;IACD,MAAM,EAAE;QACN,KAAK,EAAE,2BAA2B;QAClC,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE,EAAE,EAC9E,IAAI,EACJ,CAAC,CACF;QACD,UAAU,EAAE,kBAAkB;KAC/B;IACD,gBAAgB,EAAE;QAChB,KAAK,EAAE,6CAA6C;QACpD,OAAO,EAAE,IAAI,CAAC,SAAS,CACrB,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,EAAE,gBAAgB,EAAE,8BAA8B,EAAE,EAAE,EAAE,EAAE,EACzI,IAAI,EACJ,CAAC,CACF;QACD,UAAU,EAAE,4BAA4B;KACzC;CACF,CAAC"}

package/dist/src/outcome.js

@@ -0,0 +1,63 @@
+import { EXIT } from './errors.js';
+/**
+ * Turn a send result into an exit code WITHOUT inventing a verdict.
+ *
+ * The one that matters is `pending`: the op is live, the backend has it, and the receipt has not arrived.
+ * That is neither a success (nothing is confirmed) nor a failure (a resend would move money twice), and it
+ * is exactly what exit 5 exists for. An unrecognised shape is treated as pending for the same reason:
+ * claiming success for a result we cannot read is the one unrecoverable mistake here.
+ *
+ * When settled is true but status is missing, that is relayed-and-unreadable, not a decline - it maps to
+ * exit 5 with code 'unknown' to avoid inventing a decline reason the backend never stated.
+ */
+export function classifyWalletSend(result) {
+    const root = (result ?? {});
+    if (root.lane === 'agent') {
+        const relay = root.relay ?? {};
+        if (relay.settled === true) {
+            if (relay.status === 'included') {
+                return { exit: EXIT.ok, code: 'included', note: null };
+            }
+            if (relay.status === undefined) {
+                return { exit: EXIT.pending, code: 'unknown', note: relay.note ?? null };
+            }
+            return { exit: EXIT.declined, code: relay.status, note: relay.note ?? null };
+        }
+        return { exit: EXIT.pending, code: String(relay.status ?? 'pending'), note: relay.note ?? null };
+    }
+    switch (root.status) {
+        case 'relayed':
+            return { exit: EXIT.ok, code: 'relayed', note: null };
+        case 'failed':
+            return { exit: EXIT.declined, code: String(root.declineReason ?? 'failed'), note: root.note ?? null };
+        case 'rejected':
+            return { exit: EXIT.error, code: 'rejected', note: 'You rejected it in the browser. Nothing was sent.' };
+        case 'expired':
+            return { exit: EXIT.error, code: 'expired', note: 'The request expired before it was signed. Nothing was sent.' };
+        default:
+            return { exit: EXIT.pending, code: String(root.status ?? 'pending'), note: root.note ?? null };
+    }
+}
+/**
+ * The same job for the agent lane's own `{ proposed, settled, status, reason }` envelope.
+ *
+ * When settled is true but status is missing, that is relayed-and-unreadable, not a decline - it maps to
+ * exit 5 with code 'unknown' to avoid inventing a status the backend never stated.
+ */
+export function classifyAgentAction(result) {
+    const root = (result ?? {});
+    if (root.proposed === false) {
+        return { exit: EXIT.declined, code: String(root.reason ?? 'declined'), note: root.note ?? null };
+    }
+    if (root.settled === true) {
+        if (root.status === 'included') {
+            return { exit: EXIT.ok, code: 'included', note: null };
+        }
+        if (root.status === undefined) {
+            return { exit: EXIT.pending, code: 'unknown', note: root.note ?? null };
+        }
+        return { exit: EXIT.declined, code: root.status, note: root.note ?? null };
+    }
+    return { exit: EXIT.pending, code: String(root.status ?? 'pending'), note: root.note ?? null };
+}
+//# sourceMappingURL=outcome.js.map

package/dist/src/outcome.js.map

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

package/dist/src/parser.js

@@ -1,51 +1,30 @@
-import { Command } from 'commander';
-import { colors } from './render/colors.js';
-/** Alchemy-style grouped help: commander's default help lists commands flat, so this overrides the
- *  formatter to print grouped section headers instead. Groups match the design spec's command table. */
-const GROUPS = [
-    { title: 'Wallet', commands: ['login', 'logout', 'status', 'balance', 'send', 'activity', 'markets', 'yield', 'mandates', 'agents', 'accounts', 'api'] },
-    { title: 'Agent', commands: ['agent'] },
-    { title: 'Connect', commands: ['mcp'] },
-    { title: 'System', commands: ['diagnose', 'config'] },
-];
+import { Command, Option } from 'commander';
+import { formatHelp } from './help/format.js';
 export function createProgram() {
     const program = new Command();
     program
         .name('botanary')
         .description('Botanary from your terminal.')
         .option('--json', 'Force JSON output (auto-enabled when piped)')
+        .option('--raw', 'Print the full raw JSON payload instead of a table')
+        .option('-q, --quiet', 'Suppress non-essential output')
+        .option('--verbose', 'Show detail an ordinary run leaves out')
         .option('--no-interactive', 'Disable prompts and the REPL')
         .option('--no-color', 'Disable color output')
         .option('--reveal', 'Show redacted values in plain text')
-        .configureHelp({
-        formatHelp: (cmd, helper) => {
-            const lines = [];
-            lines.push(`${colors.bold('Usage:')} ${helper.commandUsage(cmd)}`);
-            lines.push('');
-            lines.push(cmd.description());
-            lines.push('');
-            for (const group of GROUPS) {
-                const subcommands = helper
-                    .visibleCommands(cmd)
-                    .filter((c) => group.commands.includes(c.name()));
-                if (!subcommands.length)
-                    continue;
-                lines.push(colors.brand(colors.bold(`◆ ${group.title}`)));
-                for (const sub of subcommands) {
-                    lines.push(`  ${sub.name().padEnd(20)} ${sub.description()}`);
-                }
-                lines.push('');
-            }
-            const options = helper.visibleOptions(cmd);
-            if (options.length) {
-                lines.push(colors.brand(colors.bold('◆ Global options')));
-                for (const opt of options) {
-                    lines.push(`  ${helper.optionTerm(opt).padEnd(20)} ${helper.optionDescription(opt)}`);
-                }
-            }
-            return lines.join('\n');
-        },
-    });
+        .option('--chain <id|key>', 'Default chain: an EVM chain id (8453) or a chain key (solana)')
+        .option('--account <accountId>', 'Owner account to act as')
+        .option('--api-url <url>', 'Botanary API base URL')
+        .option('--home <dir>', 'Directory holding identity, session and CLI config')
+        .option('--timeout <ms>', 'Abort any single request after this many milliseconds')
+        .option('--debug', 'Log one redacted line per HTTP request to stderr')
+        .option('-y, --yes', 'Skip the review step on a command that moves funds')
+        .option('--dry-run', 'Preflight only: never create a sign request, never relay')
+        // `-V` was 0.1.0's only version flag. `-v` is the spelling every comparable CLI uses, so it becomes
+        // the documented one and `-V` stays as a hidden alias - commander allows one short flag per option,
+        // so the alias is a separate hidden option that runCli handles before dispatch.
+        .addOption(new Option('-V', 'Alias of -v').hideHelp())
+        .configureHelp({ showGlobalOptions: true, formatHelp });
     program.exitOverride();
     return program;
 }

package/dist/src/parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;wGACwG;AACxG,MAAM,MAAM,GAAiD;IAC3D,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE;IACxJ,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;IACvC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE;IACvC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE;CACtD,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,QAAQ,EAAE,6CAA6C,CAAC;SAC/D,MAAM,CAAC,kBAAkB,EAAE,8BAA8B,CAAC;SAC1D,MAAM,CAAC,YAAY,EAAE,sBAAsB,CAAC;SAC5C,MAAM,CAAC,UAAU,EAAE,oCAAoC,CAAC;SACxD,aAAa,CAAC;QACb,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YAC1B,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,WAAW,GAAG,MAAM;qBACvB,eAAe,CAAC,GAAG,CAAC;qBACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACpD,IAAI,CAAC,WAAW,CAAC,MAAM;oBAAE,SAAS;gBAClC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC1D,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;oBAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBAChE,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;gBAC1D,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACxF,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC,CAAC;IACL,OAAO,CAAC,YAAY,EAAE,CAAC;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;cAGc;AACd,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,kBAAkB,CAAC;IAC9B,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,QAAQ,EAAE,6CAA6C,CAAC;SAC/D,MAAM,CAAC,OAAO,EAAE,oDAAoD,CAAC;SACrE,MAAM,CAAC,aAAa,EAAE,+BAA+B,CAAC;SACtD,MAAM,CAAC,WAAW,EAAE,wCAAwC,CAAC;SAC7D,MAAM,CAAC,kBAAkB,EAAE,8BAA8B,CAAC;SAC1D,MAAM,CAAC,YAAY,EAAE,sBAAsB,CAAC;SAC5C,MAAM,CAAC,UAAU,EAAE,oCAAoC,CAAC;SACxD,MAAM,CAAC,kBAAkB,EAAE,+DAA+D,CAAC;SAC3F,MAAM,CAAC,uBAAuB,EAAE,yBAAyB,CAAC;SAC1D,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;SAClD,MAAM,CAAC,cAAc,EAAE,oDAAoD,CAAC;SAC5E,MAAM,CAAC,gBAAgB,EAAE,uDAAuD,CAAC;SACjF,MAAM,CAAC,SAAS,EAAE,kDAAkD,CAAC;SACrE,MAAM,CAAC,WAAW,EAAE,oDAAoD,CAAC;SACzE,MAAM,CAAC,WAAW,EAAE,0DAA0D,CAAC;QAChF,oGAAoG;QACpG,oGAAoG;QACpG,gFAAgF;SAC/E,SAAS,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC;SACrD,aAAa,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,YAAY,EAAE,CAAC;IACvB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;cAGc;AACd,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,kBAAkB,CAAC;IAC9B,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/progress.js

@@ -0,0 +1,37 @@
+import * as clack from '@clack/prompts';
+/** True whenever nothing decorative may be written. */
+export function isQuietMode(ctx) {
+    return !ctx.interactive || ctx.json || ctx.quiet;
+}
+/**
+ * Run `fn` behind a spinner. Completely inert - no ANSI, no stdin touch, no output at all - when the
+ * output is machine-bound (`--json`), suppressed (`--quiet`), or the terminal is not interactive. 0.1.0
+ * had no spinner anywhere, so every network call looked like a hang.
+ */
+export async function step(ctx, label, fn) {
+    if (isQuietMode(ctx))
+        return fn();
+    const spinner = clack.spinner();
+    spinner.start(label);
+    try {
+        const result = await fn();
+        spinner.stop(label);
+        return result;
+    }
+    catch (e) {
+        spinner.stop(label, 1);
+        throw e;
+    }
+}
+/**
+ * Print one line of human-facing progress to stderr. Unlike `step`, this DOES print in a non-interactive
+ * terminal: its callers carry the login code and the approval URL, which is exactly what a headless or
+ * piped run still needs a human to act on. Printed to stderr (never stdout) so it cannot corrupt a piped
+ * payload. Silenced only by `--json` or `--quiet`.
+ */
+export function notify(ctx, line) {
+    if (ctx.json || ctx.quiet)
+        return;
+    process.stderr.write(`${line}\n`);
+}
+//# sourceMappingURL=progress.js.map

package/dist/src/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AASxC,uDAAuD;AACvD,MAAM,UAAU,WAAW,CAAC,GAAgB;IAC1C,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAI,GAAgB,EAAE,KAAa,EAAE,EAAoB;IACjF,IAAI,WAAW,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACvB,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,GAAgB,EAAE,IAAY;IACnD,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/prompt-doc.js

@@ -0,0 +1,92 @@
+import { EXIT_CODES } from './errors.js';
+import { COMMAND_HELP, commandPath } from './help/examples.js';
+import { DOCS_URL, GROUP_ORDER, groupOf } from './help/groups.js';
+/**
+ * The whole operating manual for a non-human driver, generated from the same metadata `--help` renders, so
+ * a new command appears in both or in neither. Deliberately plain text with no ANSI: its destination is a
+ * file, a prompt, or another program's context window.
+ */
+export function promptDoc(program, cliVersion) {
+    const lines = [];
+    lines.push(`# botanary CLI ${cliVersion} - operating manual for an automation`);
+    lines.push('');
+    lines.push('You are driving the `botanary` CLI non-interactively. Botanary never holds a signing key: the');
+    lines.push('CLI builds unsigned operations and either an on-chain mandate signs them locally or the human');
+    lines.push('owner approves them in a browser. Nothing you do here can sign as the owner.');
+    lines.push('');
+    lines.push('## Two lanes, never confuse them');
+    lines.push('');
+    lines.push('- OWNER lane (`login`, `balance`, `send`, ...): acts as the human account owner, using a session');
+    lines.push('  token stored on this machine. A `send` that no mandate covers needs the human in a browser.');
+    lines.push('- AGENT lane (`agent ...`): acts as this machine\'s own paired agent, spending unattended within');
+    lines.push('  whatever the owner granted it. `agent spend` refuses out-of-bounds amounts; `agent request`');
+    lines.push('  asks the owner instead.');
+    lines.push('');
+    lines.push('## Invocation rules');
+    lines.push('');
+    lines.push('- Always pass `--json`. Output is then a single compact JSON line on stdout (except `completion`,');
+    lines.push('  which prints a shell script regardless).');
+    lines.push('- Always pass `--yes` on a command that moves funds, or it exits 2 rather than prompting.');
+    lines.push('- Use `--dry-run` first on anything that moves funds: same checks, same review, nothing sent.');
+    lines.push('- `--chain-id` is required by money commands. Run `botanary chains --json` to learn valid ids.');
+    lines.push('- Never retry a `send` that returned exit 5. The operation is live; poll');
+    lines.push('  `botanary api /userops/<opId> --json` to check its status. A retry moves funds twice.');
+    lines.push('- Never retry an `agent spend` that returned exit 5 either; poll `botanary agent status');
+    lines.push('  <opId> --json` instead.');
+    lines.push('');
+    lines.push('## Failure contract');
+    lines.push('');
+    lines.push('On failure with `--json`, stdout carries a single JSON line. The error object always has');
+    lines.push('`code` and `message`. The `hint` field is optional and must not be assumed to exist.');
+    lines.push('Example:');
+    lines.push('');
+    lines.push('    {"ok":false,"error":{"code":"declined","message":"...","hint":"..."}}');
+    lines.push('');
+    lines.push('A successful command prints its payload bare, with no wrapper. Branch on the exit code first');
+    lines.push('and on `error.code` second. Never string-match a message.');
+    lines.push('');
+    lines.push('## Exit codes');
+    lines.push('');
+    for (const { code, meaning } of EXIT_CODES)
+        lines.push(`- exit ${code}: ${meaning}`);
+    lines.push('');
+    lines.push('## Commands');
+    lines.push('');
+    const visible = program.commands.filter((cmd) => !cmd.name().startsWith('help'));
+    for (const title of GROUP_ORDER) {
+        const groupCommands = visible.filter((cmd) => groupOf(cmd) === title);
+        if (!groupCommands.length)
+            continue;
+        lines.push(`### ${title}`);
+        lines.push('');
+        for (const cmd of groupCommands) {
+            const describe = (target) => {
+                const path = commandPath(target);
+                lines.push(`- \`botanary ${path}\` - ${target.description()}`);
+                const meta = COMMAND_HELP[path];
+                for (const example of meta?.examples ?? [])
+                    lines.push(`    ${example}`);
+                if (meta?.notes) {
+                    for (const note of meta.notes.split('\n'))
+                        lines.push(`    note: ${note}`);
+                }
+                for (const sub of target.commands)
+                    describe(sub);
+            };
+            describe(cmd);
+        }
+        lines.push('');
+    }
+    lines.push('## What still needs a human');
+    lines.push('');
+    lines.push('- `login`: the owner approves in a browser. The CLI prints the code and URL to stderr');
+    lines.push('  immediately (never silenced by `--json`); relay them to the human and wait.');
+    lines.push('- `send` without a covering mandate: the same, via an approval URL.');
+    lines.push('- Granting or widening a mandate: only ever in Botanary itself. `mandates suggest` proposes,');
+    lines.push('  it does not grant.');
+    lines.push('');
+    lines.push(`Docs: ${DOCS_URL}`);
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=prompt-doc.js.map

package/dist/src/prompt-doc.js.map

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

package/dist/src/render/accounts.js

@@ -0,0 +1,21 @@
+import { colors } from './colors.js';
+import { columns, dash, section, shortAddress } from './kv.js';
+const HEADERS = ['', 'ID', 'LABEL', 'ADDRESS'];
+export function accountRows(list, activeId) {
+    const accounts = Array.isArray(list) ? list : [];
+    return accounts
+        .filter((account) => account !== null && typeof account === 'object')
+        .map((account) => [
+        account.id && account.id === activeId ? '*' : '',
+        dash(account.id),
+        dash(account.label ?? account.name),
+        shortAddress(account.address),
+    ]);
+}
+export function renderAccounts(list, activeId) {
+    const rows = accountRows(list, activeId);
+    if (!rows.length)
+        return `${section('Accounts')}\n${colors.muted('  No accounts on this login.')}`;
+    return `${section('Accounts')}\n${columns(HEADERS, rows)}\n${colors.dim('  * is the active account. Switch with `botanary accounts use <id>`.')}`;
+}
+//# sourceMappingURL=accounts.js.map

package/dist/src/render/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../../src/render/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAS/D,MAAM,OAAO,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAE/C,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,QAAuB;IAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC;SACpE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAChD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;QACnC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC;KAC9B,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAa,EAAE,QAAuB;IACnE,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,EAAE,CAAC;IACnG,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,sEAAsE,CAAC,EAAE,CAAC;AACpJ,CAAC"}

package/dist/src/render/activity.js

@@ -0,0 +1,34 @@
+import { colors } from './colors.js';
+import { amount, columns, dash, section, shortTime } from './kv.js';
+const HEADERS = ['WHEN', 'WHAT', 'AMOUNT', 'CHAIN', 'STATUS'];
+function statusCell(item) {
+    if (item.declineReason)
+        return colors.danger(`declined: ${item.declineReason}`);
+    if (item.status === 'executed')
+        return colors.success('executed');
+    if (item.status === 'pending')
+        return colors.warning('pending');
+    return dash(item.status);
+}
+export function activityRows(payload) {
+    const items = payload?.history?.items;
+    const list = Array.isArray(items) ? items : [];
+    return list
+        .filter((item) => item !== null && typeof item === 'object')
+        .map((item) => [
+        shortTime(item.timestamp),
+        dash(item.title),
+        item.amount?.value === undefined
+            ? '-'
+            : `${amount(item.amount.value)} ${dash(item.amount.token?.symbol)}`.trim(),
+        dash(item.chain),
+        statusCell(item),
+    ]);
+}
+export function renderActivity(payload) {
+    const rows = activityRows(payload);
+    if (!rows.length)
+        return `${section('Activity')}\n${colors.muted('  No activity yet.')}`;
+    return `${section('Activity')}\n${columns(HEADERS, rows)}`;
+}
+//# sourceMappingURL=activity.js.map

package/dist/src/render/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/render/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAWpE,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAE9D,SAAS,UAAU,CAAC,IAAiB;IACnC,IAAI,IAAI,CAAC,aAAa;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAChF,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,MAAM,KAAK,GAAI,OAAyD,EAAE,OAAO,EAAE,KAAK,CAAC;IACzF,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,OAAO,IAAI;SACR,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC;SAC3D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACb,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAChB,IAAI,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS;YAC9B,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAC5E,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAChB,UAAU,CAAC,IAAI,CAAC;KACjB,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC;IACzF,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;AAC7D,CAAC"}