botanary 0.5.2 → 0.6.0

package/dist/src/errors.js

@@ -1,116 +0,0 @@
-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

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