@trading-boy/cli 1.6.1 → 1.8.0

package/dist/commands/replay-cmd.js

@@ -1,8 +1,8 @@
 import { Option } from 'commander';
 import chalk from 'chalk';
 import { createLogger } from '@trading-boy/core';
-import { isRemoteMode, apiRequest, ApiError } from '../api-client.js';
-import { padRight } from '../utils.js';
+import { apiRequest } from '../api-client.js';
+import { padRight, handleApiError, ensureRemote } from '../utils.js';
 // ─── Logger ───
 const logger = createLogger('cli-replay');
 // ─── Helpers ───
@@ -96,33 +96,6 @@ async function pollReplayJob(jobId) {
     }
     throw new Error(`Replay job ${jobId} did not complete within ${POLL_TIMEOUT_MS / 1000}s timeout.`);
 }
-// ─── Error Handler ───
-function handleApiError(error, context) {
-    if (error instanceof ApiError) {
-        switch (error.status) {
-            case 401:
-                console.error(chalk.red('Error: API key invalid or expired. Run `trading-boy login` to re-authenticate.'));
-                break;
-            case 403:
-                console.error(chalk.red('Error: Subscription inactive. Run `trading-boy billing manage` to update your billing.'));
-                break;
-            case 404:
-                console.error(chalk.red(`Error: Not found — ${error.message}`));
-                break;
-            case 422:
-                console.error(chalk.red(`Error: Validation failed — ${error.message}`));
-                break;
-            default:
-                console.error(chalk.red(`Error: ${error.message}`));
-        }
-    }
-    else {
-        const message = error instanceof Error ? error.message : String(error);
-        logger.error({ error: message }, context);
-        console.error(chalk.red(`Error: ${message}`));
-    }
-    process.exitCode = error instanceof ApiError ? 2 : 1;
-}
 // ─── Command Registration ───
 export function registerReplayCommand(program) {
     program
@@ -134,12 +107,8 @@ export function registerReplayCommand(program) {
         .requiredOption('--to <date>', 'End date (ISO-8601, e.g. 2025-03-01)')
         .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (options) => {
-        if (!(await isRemoteMode())) {
-            console.error(chalk.yellow('Replay requires a remote API connection.'));
-            console.error(chalk.dim('  Run: trading-boy login'));
-            process.exitCode = 1;
+        if (!(await ensureRemote()))
             return;
-        }
         // Validate dates
         const fromDate = new Date(options.from);
         const toDate = new Date(options.to);
@@ -178,7 +147,7 @@ export function registerReplayCommand(program) {
         }
         catch (error) {
             submitSpinner.fail('Failed to submit replay job');
-            handleApiError(error, 'Replay submit failed');
+            handleApiError(error, 'Replay submit failed', logger);
             return;
         }
         // ─── Poll until complete ───
@@ -190,7 +159,7 @@ export function registerReplayCommand(program) {
         }
         catch (error) {
             pollSpinner.fail('Replay timed out or encountered an error');
-            handleApiError(error, 'Replay polling failed');
+            handleApiError(error, 'Replay polling failed', logger);
             return;
         }
         // ─── Display results ───

package/dist/commands/risk.js

@@ -1,8 +1,8 @@
 import { Option } from 'commander';
 import chalk from 'chalk';
 import { createLogger } from '@trading-boy/core';
-import { formatConnectionError, padRight } from '../utils.js';
-import { isRemoteMode, apiRequest, ApiError } from '../api-client.js';
+import { formatConnectionError, padRight, ensureRemote } from '../utils.js';
+import { apiRequest, ApiError } from '../api-client.js';
 // ─── Logger ───
 const logger = createLogger('cli-risk');
 // ─── Formatters ───
@@ -127,12 +127,8 @@ export function registerRiskCommand(program) {
             process.exitCode = 1;
             return;
         }
-        if (!(await isRemoteMode())) {
-            console.error(chalk.yellow('This command requires a remote API connection.'));
-            console.error(chalk.dim('  Run: trading-boy login or trading-boy subscribe'));
-            process.exitCode = 1;
+        if (!(await ensureRemote()))
             return;
-        }
         try {
             const apiResult = await apiRequest(`/api/v1/protocols/${encodeURIComponent(protocol.toLowerCase())}/risk`);
             const result = {

package/dist/commands/strategy-cmd.js

@@ -1,8 +1,8 @@
 import { Option } from 'commander';
 import chalk from 'chalk';
 import { createLogger } from '@trading-boy/core';
-import { isRemoteMode, apiRequest, ApiError } from '../api-client.js';
-import { padRight } from '../utils.js';
+import { apiRequest } from '../api-client.js';
+import { padRight, handleApiError, ensureRemote } from '../utils.js';
 // ─── Logger ───
 const logger = createLogger('cli-strategy');
 // ─── Helpers ───
@@ -127,43 +127,6 @@ export function formatHistoryList(response) {
     lines.push('');
     return lines.join('\n');
 }
-// ─── Remote Mode Guard ───
-async function requireRemote() {
-    if (!(await isRemoteMode())) {
-        console.error(chalk.yellow('Strategy commands require a remote API connection.'));
-        console.error(chalk.dim('  Run: trading-boy login'));
-        process.exitCode = 1;
-        return false;
-    }
-    return true;
-}
-// ─── Error Handler ───
-function handleApiError(error, context) {
-    if (error instanceof ApiError) {
-        switch (error.status) {
-            case 401:
-                console.error(chalk.red('Error: API key invalid or expired. Run `trading-boy login` to re-authenticate.'));
-                break;
-            case 403:
-                console.error(chalk.red('Error: Subscription inactive. Run `trading-boy billing manage` to update your billing.'));
-                break;
-            case 404:
-                console.error(chalk.red(`Error: Not found — ${error.message}`));
-                break;
-            case 422:
-                console.error(chalk.red(`Error: Validation failed — ${error.message}`));
-                break;
-            default:
-                console.error(chalk.red(`Error: ${error.message}`));
-        }
-    }
-    else {
-        const message = error instanceof Error ? error.message : String(error);
-        logger.error({ error: message }, context);
-        console.error(chalk.red(`Error: ${message}`));
-    }
-    process.exitCode = error instanceof ApiError ? 2 : 1;
-}
 // ─── Command Registration ───
 export function registerStrategyCommand(program) {
     const strategy = program
@@ -180,7 +143,7 @@ export function registerStrategyCommand(program) {
         .option('--setups <types>', 'Comma-separated setup types')
         .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (options) => {
-        if (!(await requireRemote()))
+        if (!(await ensureRemote()))
             return;
         const tokens = options.tokens.split(',').map((t) => t.trim().toUpperCase()).filter(Boolean);
         const setupTypes = options.setups
@@ -220,7 +183,7 @@ export function registerStrategyCommand(program) {
             }
         }
         catch (error) {
-            handleApiError(error, 'Strategy create failed');
+            handleApiError(error, 'Strategy create failed', logger);
         }
     });
     // ─── strategy list ───
@@ -233,7 +196,7 @@ export function registerStrategyCommand(program) {
         .option('--offset <n>', 'Pagination offset', '0')
         .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (options) => {
-        if (!(await requireRemote()))
+        if (!(await ensureRemote()))
             return;
         const params = new URLSearchParams();
         params.set('traderId', options.traderId);
@@ -251,7 +214,7 @@ export function registerStrategyCommand(program) {
             }
         }
         catch (error) {
-            handleApiError(error, 'Strategy list failed');
+            handleApiError(error, 'Strategy list failed', logger);
         }
     });
     // ─── strategy show <id> ───
@@ -260,7 +223,7 @@ export function registerStrategyCommand(program) {
         .description('Show full details for a strategy')
         .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (id, options) => {
-        if (!(await requireRemote()))
+        if (!(await ensureRemote()))
             return;
         try {
             const result = await apiRequest(`/api/v1/strategies/${encodeURIComponent(id)}`);
@@ -272,7 +235,7 @@ export function registerStrategyCommand(program) {
             }
         }
         catch (error) {
-            handleApiError(error, 'Strategy show failed');
+            handleApiError(error, 'Strategy show failed', logger);
         }
     });
     // ─── strategy update <id> ───
@@ -284,7 +247,7 @@ export function registerStrategyCommand(program) {
         .option('--setups <types>', 'New comma-separated setup types (replaces existing)')
         .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (id, options) => {
-        if (!(await requireRemote()))
+        if (!(await ensureRemote()))
             return;
         const body = {};
         if (options.name) {
@@ -311,7 +274,7 @@ export function registerStrategyCommand(program) {
             }
         }
         catch (error) {
-            handleApiError(error, 'Strategy update failed');
+            handleApiError(error, 'Strategy update failed', logger);
         }
     });
     // ─── strategy history <id> ───
@@ -320,7 +283,7 @@ export function registerStrategyCommand(program) {
         .description('Show version history for a strategy')
         .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (id, options) => {
-        if (!(await requireRemote()))
+        if (!(await ensureRemote()))
             return;
         try {
             const result = await apiRequest(`/api/v1/strategies/${encodeURIComponent(id)}/history`);
@@ -332,7 +295,7 @@ export function registerStrategyCommand(program) {
             }
         }
         catch (error) {
-            handleApiError(error, 'Strategy history failed');
+            handleApiError(error, 'Strategy history failed', logger);
         }
     });
     // ─── strategy export ───
@@ -345,7 +308,7 @@ export function registerStrategyCommand(program) {
         .default('json'))
         .option('--output <file>', 'Write output to a file instead of stdout')
         .action(async (options) => {
-        if (!(await requireRemote()))
+        if (!(await ensureRemote()))
             return;
         try {
             const result = await apiRequest(`/api/v1/strategies/${encodeURIComponent(options.id)}/export?format=${encodeURIComponent(options.format)}`);
@@ -370,7 +333,7 @@ export function registerStrategyCommand(program) {
             }
         }
         catch (error) {
-            handleApiError(error, 'Strategy export failed');
+            handleApiError(error, 'Strategy export failed', logger);
         }
     });
 }

package/dist/commands/subscribe.js

@@ -156,7 +156,7 @@ export async function pollForApiKey(token, onTick) {
             if (result.status === 'expired' || result.status === 'not_found') {
                 return {
                     success: false,
-                    error: 'Provisioning token expired. If you completed payment, try `trading-boy login` with your API key from the confirmation email.',
+                    error: 'Provisioning token expired. Your API key will be emailed to you shortly. Then run: `trading-boy login`',
                 };
             }
             if (result.status === 'already_retrieved') {
@@ -175,7 +175,7 @@ export async function pollForApiKey(token, onTick) {
     }
     return {
         success: false,
-        error: 'Timed out waiting for payment confirmation. If you completed payment, try `trading-boy login` with your API key from the confirmation email.',
+        error: 'Timed out waiting for payment confirmation. Your API key will be emailed to you shortly. Then run: `trading-boy login`',
     };
 }
 // ─── Credential Storage ───

package/dist/commands/suggestions-cmd.js

@@ -1,8 +1,8 @@
 import { Option } from 'commander';
 import chalk from 'chalk';
 import { createLogger } from '@trading-boy/core';
-import { isRemoteMode, apiRequest, ApiError } from '../api-client.js';
-import { padRight, truncate, formatDate } from '../utils.js';
+import { apiRequest, ApiError } from '../api-client.js';
+import { padRight, truncate, formatDate, ensureRemote } from '../utils.js';
 // ─── Logger ───
 const logger = createLogger('cli-suggestions');
 // ─── Formatters ───
@@ -72,12 +72,8 @@ export function registerSuggestionsCommand(program) {
         .option('--offset <n>', 'Pagination offset', parseInt, 0)
         .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (options) => {
-        if (!(await isRemoteMode())) {
-            console.error(chalk.yellow('This command requires a remote API connection.'));
-            console.error(chalk.dim('  Run: trading-boy login or trading-boy subscribe'));
-            process.exitCode = 1;
+        if (!(await ensureRemote()))
             return;
-        }
         try {
             const params = new URLSearchParams();
             params.set('status', options.status);
@@ -106,12 +102,8 @@ export function registerSuggestionsCommand(program) {
         .description('Approve a suggestion and auto-apply to strategy')
         .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (id, options) => {
-        if (!(await isRemoteMode())) {
-            console.error(chalk.yellow('This command requires a remote API connection.'));
-            console.error(chalk.dim('  Run: trading-boy login or trading-boy subscribe'));
-            process.exitCode = 1;
+        if (!(await ensureRemote()))
             return;
-        }
         try {
             const data = await apiRequest(`/api/v1/suggestions/${encodeURIComponent(id)}/approve`, { method: 'POST' });
             if (options.format === 'json') {
@@ -134,12 +126,8 @@ export function registerSuggestionsCommand(program) {
         .description('Reject a suggestion')
         .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (id, options) => {
-        if (!(await isRemoteMode())) {
-            console.error(chalk.yellow('This command requires a remote API connection.'));
-            console.error(chalk.dim('  Run: trading-boy login or trading-boy subscribe'));
-            process.exitCode = 1;
+        if (!(await ensureRemote()))
             return;
-        }
         try {
             const data = await apiRequest(`/api/v1/suggestions/${encodeURIComponent(id)}/reject`, { method: 'POST' });
             if (options.format === 'json') {

package/dist/commands/thesis-cmd.js

@@ -1,7 +1,8 @@
 import { Option } from 'commander';
 import chalk from 'chalk';
 import { createLogger } from '@trading-boy/core';
-import { isRemoteMode, apiRequest, ApiError } from '../api-client.js';
+import { apiRequest, ApiError } from '../api-client.js';
+import { ensureRemote } from '../utils.js';
 // ─── Logger ───
 const logger = createLogger('cli-thesis');
 // ─── BYOK Error Hint ───
@@ -74,12 +75,8 @@ export function registerThesisCommand(program) {
         .option('--entry-price <n>', 'Entry price', parseFloat)
         .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
         .action(async (decisionId, options) => {
-        if (!(await isRemoteMode())) {
-            console.error(chalk.yellow('Thesis extraction requires a remote API connection.'));
-            console.error(chalk.dim('  Run: trading-boy login'));
-            process.exitCode = 1;
+        if (!(await ensureRemote()))
             return;
-        }
         // Validate direction if provided
         if (options.direction && !['LONG', 'SHORT'].includes(options.direction.toUpperCase())) {
             console.error(chalk.red('Error: --direction must be LONG or SHORT'));

package/dist/commands/whoami.js

@@ -2,6 +2,7 @@ import { Option } from 'commander';
 import chalk from 'chalk';
 import { createLogger } from '@trading-boy/core';
 import { loadCredentials, redactApiKey } from '../credentials.js';
+import { getApiBase } from '../api-client.js';
 const logger = createLogger('cli-whoami');
 // ─── Whoami Logic ───
 export async function executeWhoami() {
@@ -59,6 +60,7 @@ export function formatWhoamiOutput(result) {
         const date = new Date(result.storedAt).toLocaleString();
         lines.push(`  ${chalk.gray('Since:')}    ${date}`);
     }
+    lines.push(`  ${chalk.gray('API:')}      ${getApiBase()}`);
     lines.push('');
     return lines.join('\n');
 }
@@ -86,7 +88,7 @@ export function registerWhoamiCommand(program) {
                 }
             }
             if (options.format === 'json') {
-                console.log(JSON.stringify(result, null, 2));
+                console.log(JSON.stringify({ ...result, apiUrl: getApiBase() }, null, 2));
             }
             else {
                 console.log(formatWhoamiOutput(result));

package/dist/utils.d.ts

@@ -48,4 +48,16 @@ export declare function formatDate(isoString: string | null): string;
  * Parse a string option as an integer.
  */
 export declare function parseIntOption(value: string): number;
+/**
+ * Centralized API error handler for CLI commands.
+ * Prints user-friendly error messages and sets appropriate exit codes.
+ */
+export declare function handleApiError(error: unknown, context: string, logger: {
+    error: (obj: object, msg: string) => void;
+}): void;
+/**
+ * Guard that checks if the CLI is in remote API mode.
+ * Returns false (and prints guidance) if not authenticated.
+ */
+export declare function ensureRemote(): Promise<boolean>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.js

@@ -115,4 +115,55 @@ export function formatDate(isoString) {
 export function parseIntOption(value) {
     return parseInt(value, 10);
 }
+function isApiError(error) {
+    return error instanceof Error && error.name === 'ApiError' && 'status' in error;
+}
+/**
+ * Centralized API error handler for CLI commands.
+ * Prints user-friendly error messages and sets appropriate exit codes.
+ */
+export function handleApiError(error, context, logger) {
+    if (isApiError(error)) {
+        switch (error.status) {
+            case 401:
+                console.error(chalk.red('Error: Not authenticated. Run `trading-boy login` or `trading-boy subscribe` to get started.'));
+                break;
+            case 403:
+                console.error(chalk.red(`Error: ${error.message}`));
+                break;
+            case 404:
+                console.error(chalk.red(`Error: Not found — ${error.message}`));
+                break;
+            case 422:
+                console.error(chalk.red(`Error: Validation failed — ${error.message}`));
+                break;
+            case 429:
+                console.error(chalk.red(`Error: Limit reached — ${error.message}`));
+                break;
+            default:
+                console.error(chalk.red(`Error: ${error.message}`));
+        }
+    }
+    else {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error({ error: message }, context);
+        console.error(chalk.red(`Error: ${message}`));
+    }
+    process.exitCode = isApiError(error) ? 2 : 1;
+}
+// ─── Shared Remote Guard ───
+/**
+ * Guard that checks if the CLI is in remote API mode.
+ * Returns false (and prints guidance) if not authenticated.
+ */
+export async function ensureRemote() {
+    const { isRemoteMode } = await import('./api-client.js');
+    if (!(await isRemoteMode())) {
+        console.error(chalk.yellow('This command requires a remote API connection.'));
+        console.error(chalk.dim('  Run: trading-boy login or trading-boy subscribe'));
+        process.exitCode = 1;
+        return false;
+    }
+    return true;
+}
 //# sourceMappingURL=utils.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trading-boy/cli",
-  "version": "1.6.1",
+  "version": "1.8.0",
   "description": "Trading Boy CLI — crypto context intelligence for traders and AI agents. Query real-time prices, funding rates, whale activity, and DeFi risk for 100+ Solana tokens and 229 Hyperliquid perpetuals.",
   "homepage": "https://cabal.ventures",
   "repository": {