@trading-boy/cli 1.2.18 → 1.2.19

package/dist/cli.bundle.js

@@ -23934,7 +23934,7 @@ var init_RemoveFileError = __esm({
 
 // ../../node_modules/.pnpm/@inquirer+external-editor@1.0.3_@types+node@25.2.3/node_modules/@inquirer/external-editor/dist/esm/index.js
 import { spawn, spawnSync } from "child_process";
-import { readFileSync as readFileSync4, unlinkSync as unlinkSync2, writeFileSync as writeFileSync3 } from "fs";
+import { readFileSync as readFileSync2, unlinkSync as unlinkSync2, writeFileSync as writeFileSync2 } from "fs";
 import path2 from "node:path";
 import os2 from "node:os";
 import { randomUUID } from "node:crypto";
@@ -24051,14 +24051,14 @@ var init_esm5 = __esm({
           if (Object.prototype.hasOwnProperty.call(this.fileOptions, "mode")) {
             opt.mode = this.fileOptions.mode;
           }
-          writeFileSync3(this.tempFile, this.text, opt);
+          writeFileSync2(this.tempFile, this.text, opt);
         } catch (createFileError) {
           throw new CreateFileError(createFileError);
         }
       }
       readTemporaryFile() {
         try {
-          const tempFileBuffer = readFileSync4(this.tempFile);
+          const tempFileBuffer = readFileSync2(this.tempFile);
           if (tempFileBuffer.length === 0) {
             this.text = "";
           } else {
@@ -48143,9 +48143,10 @@ function computeStats(decisions) {
 }
 
 // dist/commands/trader.js
-import { readFileSync as readFileSync2 } from "node:fs";
+import { readFileSync as readFileSync3 } from "node:fs";
 init_source();
 init_utils();
+init_esm15();
 var logger12 = createLogger("cli-trader");
 function formatTraderOutput(trader, wallets) {
   const lines = [];
@@ -48424,7 +48425,7 @@ function registerTraderCommand(program2) {
   trader.command("soul").description("Show or upload a SOUL document").argument("<name-or-id>", "Trader name or ID").option("--file <path>", "Path to SOUL document file to upload").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (nameOrId, options) => {
     try {
       if (options.file) {
-        const document = readFileSync2(options.file, "utf-8");
+        const document = readFileSync3(options.file, "utf-8");
         const result = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/soul`, { method: "PUT", body: { document } });
         if (options.format === "json") {
           console.log(JSON.stringify(result, null, 2));
@@ -48472,7 +48473,7 @@ function registerTraderCommand(program2) {
   trader.command("purpose").description("Show or upload a PURPOSE document").argument("<name-or-id>", "Trader name or ID").option("--file <path>", "Path to PURPOSE document file to upload").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (nameOrId, options) => {
     try {
       if (options.file) {
-        const document = readFileSync2(options.file, "utf-8");
+        const document = readFileSync3(options.file, "utf-8");
         const result = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/purpose`, { method: "PUT", body: { document } });
         if (options.format === "json") {
           console.log(JSON.stringify(result, null, 2));
@@ -48633,6 +48634,221 @@ function registerTraderCommand(program2) {
       process.exitCode = error49 instanceof ApiError ? 2 : 1;
     }
   });
+  const AUTONOMY_LEVELS = ["OBSERVE_ONLY", "SUGGEST", "AUTO_WITH_APPROVAL", "FULLY_AUTONOMOUS"];
+  const agent = trader.command("agent").description("Manage autonomous trading agent");
+  agent.command("status").description("Show agent runtime status").argument("<agent-id>", "Agent ID").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (agentId, options) => {
+    const jsonMode = options.format === "json";
+    try {
+      const result = await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/status`);
+      if (jsonMode) {
+        const safeOutput = {
+          agentId,
+          state: result.state,
+          autonomyLevel: result.autonomyLevel,
+          paused: result.paused,
+          killed: result.killed,
+          override: result.humanOverride,
+          openPositions: result.openPositions ?? 0,
+          dailyTradeCount: result.dailyTradeCount ?? 0,
+          dailyPnlUsd: result.dailyPnlUsd ?? null,
+          lastTransitionAt: result.lastTransitionAt ?? null,
+          healthTimestamp: result.healthTimestamp ?? null
+        };
+        console.log(JSON.stringify(safeOutput, null, 2));
+      } else {
+        console.log("");
+        console.log(source_default.bold.cyan("  Agent Status"));
+        console.log(source_default.gray("  " + "\u2500".repeat(50)));
+        console.log("");
+        console.log(`  ${source_default.gray("Agent ID:")}       ${source_default.white(agentId)}`);
+        console.log(`  ${source_default.gray("State:")}          ${formatAgentState(result.state)}`);
+        console.log(`  ${source_default.gray("Autonomy:")}       ${source_default.white(result.autonomyLevel)}`);
+        console.log(`  ${source_default.gray("Paused:")}         ${result.paused ? source_default.yellow("yes") : source_default.green("no")}`);
+        console.log(`  ${source_default.gray("Killed:")}         ${result.killed ? source_default.red("yes") : source_default.green("no")}`);
+        console.log(`  ${source_default.gray("Override:")}       ${result.humanOverride ? source_default.yellow("active") : source_default.dim("none")}`);
+        console.log(`  ${source_default.gray("Open positions:")} ${source_default.white(String(result.openPositions ?? 0))}`);
+        console.log(`  ${source_default.gray("Trades today:")}   ${source_default.white(String(result.dailyTradeCount ?? 0))}`);
+        console.log(`  ${source_default.gray("Daily PnL:")}      ${formatPnl2(result.dailyPnlUsd)}`);
+        console.log("");
+      }
+    } catch (error49) {
+      handleAgentError(error49, jsonMode, agentId, "get agent status");
+    }
+  });
+  agent.command("pause").description("Pause the agent (stops all trading)").argument("<agent-id>", "Agent ID").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (agentId, options) => {
+    const jsonMode = options.format === "json";
+    try {
+      await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/pause`, { method: "POST" });
+      if (jsonMode) {
+        console.log(JSON.stringify({ agentId, paused: true }));
+      } else {
+        console.log("");
+        console.log(source_default.yellow(`  Agent ${agentId} paused.`));
+        console.log(source_default.dim("  Resume with: trading-boy trader agent resume " + agentId));
+        console.log("");
+      }
+    } catch (error49) {
+      handleAgentError(error49, jsonMode, agentId, "pause agent");
+    }
+  });
+  agent.command("resume").description("Resume a paused agent").argument("<agent-id>", "Agent ID").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (agentId, options) => {
+    const jsonMode = options.format === "json";
+    try {
+      await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/resume`, { method: "POST" });
+      if (jsonMode) {
+        console.log(JSON.stringify({ agentId, resumed: true }));
+      } else {
+        console.log("");
+        console.log(source_default.green(`  Agent ${agentId} resumed.`));
+        console.log("");
+      }
+    } catch (error49) {
+      handleAgentError(error49, jsonMode, agentId, "resume agent");
+    }
+  });
+  agent.command("kill").description("Kill the agent permanently (until revived)").argument("<agent-id>", "Agent ID").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).addOption(new Option("--force", "Skip confirmation prompt")).action(async (agentId, options) => {
+    const jsonMode = options.format === "json";
+    if (jsonMode && !options.force) {
+      console.error(JSON.stringify({ error: "--force is required with --format json" }));
+      process.exitCode = 1;
+      return;
+    }
+    if (!options.force) {
+      const proceed = await esm_default4({
+        message: `Are you sure you want to kill agent ${agentId}? This is permanent until revived.`
+      });
+      if (!proceed) {
+        console.log(source_default.dim("  Kill cancelled."));
+        return;
+      }
+    }
+    try {
+      await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/kill`, { method: "POST" });
+      if (jsonMode) {
+        console.log(JSON.stringify({ agentId, killed: true }));
+      } else {
+        console.log("");
+        console.log(source_default.red(`  Agent ${agentId} killed.`));
+        console.log(source_default.dim("  The agent will not trade until manually revived."));
+        console.log("");
+      }
+    } catch (error49) {
+      handleAgentError(error49, jsonMode, agentId, "kill agent");
+    }
+  });
+  agent.command("autonomy").description("Set agent autonomy level").argument("<agent-id>", "Agent ID").argument("<level>", `Autonomy level: ${AUTONOMY_LEVELS.join(" | ")}`).addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (agentId, level, options) => {
+    const jsonMode = options.format === "json";
+    const upperLevel = level.toUpperCase();
+    if (!AUTONOMY_LEVELS.includes(upperLevel)) {
+      const msg = `Invalid autonomy level. Must be one of: ${AUTONOMY_LEVELS.join(", ")}`;
+      if (jsonMode) {
+        console.error(JSON.stringify({ error: msg }));
+      } else {
+        console.error(source_default.red(`  ${msg}`));
+      }
+      process.exitCode = 1;
+      return;
+    }
+    try {
+      await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/autonomy`, {
+        method: "PUT",
+        body: { level: upperLevel }
+      });
+      if (jsonMode) {
+        console.log(JSON.stringify({ agentId, autonomyLevel: upperLevel }));
+      } else {
+        console.log("");
+        console.log(source_default.green(`  Autonomy level set to: ${source_default.white(upperLevel)}`));
+        console.log("");
+      }
+    } catch (error49) {
+      handleAgentError(error49, jsonMode, agentId, "set autonomy");
+    }
+  });
+  agent.command("override").description("Set human override (agent defers all decisions to human)").argument("<agent-id>", "Agent ID").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).addOption(new Option("--force", "Skip confirmation prompt")).action(async (agentId, options) => {
+    const jsonMode = options.format === "json";
+    if (jsonMode && !options.force) {
+      console.error(JSON.stringify({ error: "--force is required with --format json" }));
+      process.exitCode = 1;
+      return;
+    }
+    if (!options.force) {
+      const proceed = await esm_default4({
+        message: `Are you sure you want to set human override for agent ${agentId}?`
+      });
+      if (!proceed) {
+        console.log(source_default.dim("  Override cancelled."));
+        return;
+      }
+    }
+    try {
+      await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/override`, { method: "POST" });
+      if (jsonMode) {
+        console.log(JSON.stringify({ agentId, humanOverride: true }));
+      } else {
+        console.log("");
+        console.log(source_default.yellow(`  Human override set for agent ${agentId}.`));
+        console.log(source_default.dim("  The agent will defer all decisions to you."));
+        console.log(source_default.dim("  Clear with: trading-boy trader agent clear-override " + agentId));
+        console.log("");
+      }
+    } catch (error49) {
+      handleAgentError(error49, jsonMode, agentId, "set override");
+    }
+  });
+  agent.command("clear-override").description("Clear human override (return control to agent)").argument("<agent-id>", "Agent ID").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (agentId, options) => {
+    const jsonMode = options.format === "json";
+    try {
+      await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/clear-override`, { method: "POST" });
+      if (jsonMode) {
+        console.log(JSON.stringify({ agentId, humanOverride: false }));
+      } else {
+        console.log("");
+        console.log(source_default.green(`  Human override cleared for agent ${agentId}.`));
+        console.log(source_default.dim("  The agent will resume autonomous decision-making."));
+        console.log("");
+      }
+    } catch (error49) {
+      handleAgentError(error49, jsonMode, agentId, "clear override");
+    }
+  });
+}
+function formatAgentState(state) {
+  const colors8 = {
+    "IDLE": source_default.dim,
+    "SCANNING": source_default.cyan,
+    "ANALYZING": source_default.blue,
+    "EXECUTING": source_default.yellow,
+    "PAUSED": source_default.yellow,
+    "KILLED": source_default.red
+  };
+  return (colors8[state] ?? source_default.white)(state);
+}
+function formatPnl2(pnl) {
+  if (pnl === void 0 || pnl === null)
+    return source_default.dim("n/a");
+  const sign = pnl >= 0 ? "+" : "";
+  const color = pnl >= 0 ? source_default.green : source_default.red;
+  return color(`${sign}$${pnl.toFixed(2)}`);
+}
+function handleAgentError(error49, jsonMode, agentId, action) {
+  if (error49 instanceof ApiError && error49.status === 404) {
+    const msg = `Agent not found: "${agentId}"`;
+    if (jsonMode) {
+      console.error(JSON.stringify({ error: msg }));
+    } else {
+      console.error(source_default.yellow(msg));
+    }
+  } else {
+    const message = error49 instanceof Error ? error49.message : String(error49);
+    logger12.error({ error: message }, `Failed to ${action}`);
+    if (jsonMode) {
+      console.error(JSON.stringify({ error: message }));
+    } else {
+      console.error(source_default.red(`Error: ${message}`));
+    }
+  }
+  process.exitCode = error49 instanceof ApiError ? 2 : 1;
 }
 function parseFloatOption(value) {
   return parseFloat(value);
@@ -49762,7 +49978,7 @@ function registerAuditCommand(program2) {
 
 // dist/commands/config-cmd.js
 init_source();
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync2, existsSync as existsSync2 } from "node:fs";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync3, existsSync as existsSync2 } from "node:fs";
 import { resolve } from "node:path";
 init_utils();
 var logger17 = createLogger("cli-config");
@@ -49862,7 +50078,7 @@ function parseEnvFile(filePath) {
   if (!existsSync2(filePath)) {
     return { entries, lines };
   }
-  const content = readFileSync3(filePath, "utf-8");
+  const content = readFileSync4(filePath, "utf-8");
   const rawLines = content.split("\n");
   for (const line of rawLines) {
     lines.push(line);
@@ -49901,11 +50117,11 @@ function writeEnvValue(filePath, key, value) {
       }
       return line;
     });
-    writeFileSync2(filePath, updatedLines.join("\n"));
+    writeFileSync3(filePath, updatedLines.join("\n"));
   } else {
-    const existing = existsSync2(filePath) ? readFileSync3(filePath, "utf-8") : "";
+    const existing = existsSync2(filePath) ? readFileSync4(filePath, "utf-8") : "";
     const separator = existing.endsWith("\n") || existing === "" ? "" : "\n";
-    writeFileSync2(filePath, existing + separator + `${key}=${value}
+    writeFileSync3(filePath, existing + separator + `${key}=${value}
 `);
   }
 }

package/dist/commands/trader.js

@@ -4,6 +4,7 @@ import chalk from 'chalk';
 import { createLogger } from '@trading-boy/core';
 import { padRight } from '../utils.js';
 import { apiRequest, ApiError } from '../api-client.js';
+import { confirm } from '@inquirer/prompts';
 // ─── Logger ───
 const logger = createLogger('cli-trader');
 // ─── Formatters ───
@@ -634,6 +635,288 @@ export function registerTraderCommand(program) {
             process.exitCode = error instanceof ApiError ? 2 : 1;
         }
     });
+    // ─── agent (subcommand group) ───
+    const AUTONOMY_LEVELS = ['OBSERVE_ONLY', 'SUGGEST', 'AUTO_WITH_APPROVAL', 'FULLY_AUTONOMOUS'];
+    const agent = trader
+        .command('agent')
+        .description('Manage autonomous trading agent');
+    // ─── agent status ───
+    agent
+        .command('status')
+        .description('Show agent runtime status')
+        .argument('<agent-id>', 'Agent ID')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (agentId, options) => {
+        const jsonMode = options.format === 'json';
+        try {
+            const result = await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/status`);
+            if (jsonMode) {
+                const safeOutput = {
+                    agentId,
+                    state: result.state,
+                    autonomyLevel: result.autonomyLevel,
+                    paused: result.paused,
+                    killed: result.killed,
+                    override: result.humanOverride,
+                    openPositions: result.openPositions ?? 0,
+                    dailyTradeCount: result.dailyTradeCount ?? 0,
+                    dailyPnlUsd: result.dailyPnlUsd ?? null,
+                    lastTransitionAt: result.lastTransitionAt ?? null,
+                    healthTimestamp: result.healthTimestamp ?? null,
+                };
+                console.log(JSON.stringify(safeOutput, null, 2));
+            }
+            else {
+                console.log('');
+                console.log(chalk.bold.cyan('  Agent Status'));
+                console.log(chalk.gray('  ' + '\u2500'.repeat(50)));
+                console.log('');
+                console.log(`  ${chalk.gray('Agent ID:')}       ${chalk.white(agentId)}`);
+                console.log(`  ${chalk.gray('State:')}          ${formatAgentState(result.state)}`);
+                console.log(`  ${chalk.gray('Autonomy:')}       ${chalk.white(result.autonomyLevel)}`);
+                console.log(`  ${chalk.gray('Paused:')}         ${result.paused ? chalk.yellow('yes') : chalk.green('no')}`);
+                console.log(`  ${chalk.gray('Killed:')}         ${result.killed ? chalk.red('yes') : chalk.green('no')}`);
+                console.log(`  ${chalk.gray('Override:')}       ${result.humanOverride ? chalk.yellow('active') : chalk.dim('none')}`);
+                console.log(`  ${chalk.gray('Open positions:')} ${chalk.white(String(result.openPositions ?? 0))}`);
+                console.log(`  ${chalk.gray('Trades today:')}   ${chalk.white(String(result.dailyTradeCount ?? 0))}`);
+                console.log(`  ${chalk.gray('Daily PnL:')}      ${formatPnl(result.dailyPnlUsd)}`);
+                console.log('');
+            }
+        }
+        catch (error) {
+            handleAgentError(error, jsonMode, agentId, 'get agent status');
+        }
+    });
+    // ─── agent pause ───
+    agent
+        .command('pause')
+        .description('Pause the agent (stops all trading)')
+        .argument('<agent-id>', 'Agent ID')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (agentId, options) => {
+        const jsonMode = options.format === 'json';
+        try {
+            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/pause`, { method: 'POST' });
+            if (jsonMode) {
+                console.log(JSON.stringify({ agentId, paused: true }));
+            }
+            else {
+                console.log('');
+                console.log(chalk.yellow(`  Agent ${agentId} paused.`));
+                console.log(chalk.dim('  Resume with: trading-boy trader agent resume ' + agentId));
+                console.log('');
+            }
+        }
+        catch (error) {
+            handleAgentError(error, jsonMode, agentId, 'pause agent');
+        }
+    });
+    // ─── agent resume ───
+    agent
+        .command('resume')
+        .description('Resume a paused agent')
+        .argument('<agent-id>', 'Agent ID')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (agentId, options) => {
+        const jsonMode = options.format === 'json';
+        try {
+            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/resume`, { method: 'POST' });
+            if (jsonMode) {
+                console.log(JSON.stringify({ agentId, resumed: true }));
+            }
+            else {
+                console.log('');
+                console.log(chalk.green(`  Agent ${agentId} resumed.`));
+                console.log('');
+            }
+        }
+        catch (error) {
+            handleAgentError(error, jsonMode, agentId, 'resume agent');
+        }
+    });
+    // ─── agent kill ───
+    agent
+        .command('kill')
+        .description('Kill the agent permanently (until revived)')
+        .argument('<agent-id>', 'Agent ID')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .addOption(new Option('--force', 'Skip confirmation prompt'))
+        .action(async (agentId, options) => {
+        const jsonMode = options.format === 'json';
+        if (jsonMode && !options.force) {
+            console.error(JSON.stringify({ error: '--force is required with --format json' }));
+            process.exitCode = 1;
+            return;
+        }
+        if (!options.force) {
+            const proceed = await confirm({
+                message: `Are you sure you want to kill agent ${agentId}? This is permanent until revived.`,
+            });
+            if (!proceed) {
+                console.log(chalk.dim('  Kill cancelled.'));
+                return;
+            }
+        }
+        try {
+            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/kill`, { method: 'POST' });
+            if (jsonMode) {
+                console.log(JSON.stringify({ agentId, killed: true }));
+            }
+            else {
+                console.log('');
+                console.log(chalk.red(`  Agent ${agentId} killed.`));
+                console.log(chalk.dim('  The agent will not trade until manually revived.'));
+                console.log('');
+            }
+        }
+        catch (error) {
+            handleAgentError(error, jsonMode, agentId, 'kill agent');
+        }
+    });
+    // ─── agent autonomy ───
+    agent
+        .command('autonomy')
+        .description('Set agent autonomy level')
+        .argument('<agent-id>', 'Agent ID')
+        .argument('<level>', `Autonomy level: ${AUTONOMY_LEVELS.join(' | ')}`)
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (agentId, level, options) => {
+        const jsonMode = options.format === 'json';
+        const upperLevel = level.toUpperCase();
+        if (!AUTONOMY_LEVELS.includes(upperLevel)) {
+            const msg = `Invalid autonomy level. Must be one of: ${AUTONOMY_LEVELS.join(', ')}`;
+            if (jsonMode) {
+                console.error(JSON.stringify({ error: msg }));
+            }
+            else {
+                console.error(chalk.red(`  ${msg}`));
+            }
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/autonomy`, {
+                method: 'PUT',
+                body: { level: upperLevel },
+            });
+            if (jsonMode) {
+                console.log(JSON.stringify({ agentId, autonomyLevel: upperLevel }));
+            }
+            else {
+                console.log('');
+                console.log(chalk.green(`  Autonomy level set to: ${chalk.white(upperLevel)}`));
+                console.log('');
+            }
+        }
+        catch (error) {
+            handleAgentError(error, jsonMode, agentId, 'set autonomy');
+        }
+    });
+    // ─── agent override ───
+    agent
+        .command('override')
+        .description('Set human override (agent defers all decisions to human)')
+        .argument('<agent-id>', 'Agent ID')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .addOption(new Option('--force', 'Skip confirmation prompt'))
+        .action(async (agentId, options) => {
+        const jsonMode = options.format === 'json';
+        if (jsonMode && !options.force) {
+            console.error(JSON.stringify({ error: '--force is required with --format json' }));
+            process.exitCode = 1;
+            return;
+        }
+        if (!options.force) {
+            const proceed = await confirm({
+                message: `Are you sure you want to set human override for agent ${agentId}?`,
+            });
+            if (!proceed) {
+                console.log(chalk.dim('  Override cancelled.'));
+                return;
+            }
+        }
+        try {
+            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/override`, { method: 'POST' });
+            if (jsonMode) {
+                console.log(JSON.stringify({ agentId, humanOverride: true }));
+            }
+            else {
+                console.log('');
+                console.log(chalk.yellow(`  Human override set for agent ${agentId}.`));
+                console.log(chalk.dim('  The agent will defer all decisions to you.'));
+                console.log(chalk.dim('  Clear with: trading-boy trader agent clear-override ' + agentId));
+                console.log('');
+            }
+        }
+        catch (error) {
+            handleAgentError(error, jsonMode, agentId, 'set override');
+        }
+    });
+    // ─── agent clear-override ───
+    agent
+        .command('clear-override')
+        .description('Clear human override (return control to agent)')
+        .argument('<agent-id>', 'Agent ID')
+        .addOption(new Option('--format <format>', 'Output format').choices(['text', 'json']).default('text'))
+        .action(async (agentId, options) => {
+        const jsonMode = options.format === 'json';
+        try {
+            await apiRequest(`/api/v1/agents/${encodeURIComponent(agentId)}/clear-override`, { method: 'POST' });
+            if (jsonMode) {
+                console.log(JSON.stringify({ agentId, humanOverride: false }));
+            }
+            else {
+                console.log('');
+                console.log(chalk.green(`  Human override cleared for agent ${agentId}.`));
+                console.log(chalk.dim('  The agent will resume autonomous decision-making.'));
+                console.log('');
+            }
+        }
+        catch (error) {
+            handleAgentError(error, jsonMode, agentId, 'clear override');
+        }
+    });
+}
+// ─── Agent Helpers ───
+function formatAgentState(state) {
+    const colors = {
+        'IDLE': chalk.dim,
+        'SCANNING': chalk.cyan,
+        'ANALYZING': chalk.blue,
+        'EXECUTING': chalk.yellow,
+        'PAUSED': chalk.yellow,
+        'KILLED': chalk.red,
+    };
+    return (colors[state] ?? chalk.white)(state);
+}
+function formatPnl(pnl) {
+    if (pnl === undefined || pnl === null)
+        return chalk.dim('n/a');
+    const sign = pnl >= 0 ? '+' : '';
+    const color = pnl >= 0 ? chalk.green : chalk.red;
+    return color(`${sign}$${pnl.toFixed(2)}`);
+}
+function handleAgentError(error, jsonMode, agentId, action) {
+    if (error instanceof ApiError && error.status === 404) {
+        const msg = `Agent not found: "${agentId}"`;
+        if (jsonMode) {
+            console.error(JSON.stringify({ error: msg }));
+        }
+        else {
+            console.error(chalk.yellow(msg));
+        }
+    }
+    else {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error({ error: message }, `Failed to ${action}`);
+        if (jsonMode) {
+            console.error(JSON.stringify({ error: message }));
+        }
+        else {
+            console.error(chalk.red(`Error: ${message}`));
+        }
+    }
+    process.exitCode = error instanceof ApiError ? 2 : 1;
 }
 // ─── Helpers ───
 function parseFloatOption(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trading-boy/cli",
-  "version": "1.2.18",
+  "version": "1.2.19",
   "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": {