@trading-boy/cli 1.2.17 → 1.2.19

package/dist/cli.bundle.js

@@ -3711,9 +3711,9 @@ var init_source = __esm({
     init_supports_color();
     init_utilities();
     ({ stdout: stdoutColor, stderr: stderrColor } = supports_color_default);
-    GENERATOR = Symbol("GENERATOR");
-    STYLER = Symbol("STYLER");
-    IS_EMPTY = Symbol("IS_EMPTY");
+    GENERATOR = /* @__PURE__ */ Symbol("GENERATOR");
+    STYLER = /* @__PURE__ */ Symbol("STYLER");
+    IS_EMPTY = /* @__PURE__ */ Symbol("IS_EMPTY");
     levelMapping = [
       "ansi",
       "ansi",
@@ -4310,8 +4310,8 @@ var require_err_helpers = __commonJS({
 var require_err_proto = __commonJS({
   "../../node_modules/.pnpm/pino-std-serializers@7.1.0/node_modules/pino-std-serializers/lib/err-proto.js"(exports, module) {
     "use strict";
-    var seen = Symbol("circular-ref-tag");
-    var rawSymbol = Symbol("pino-raw-err-ref");
+    var seen = /* @__PURE__ */ Symbol("circular-ref-tag");
+    var rawSymbol = /* @__PURE__ */ Symbol("pino-raw-err-ref");
     var pinoErrProto = Object.create({}, {
       type: {
         enumerable: true,
@@ -4448,7 +4448,7 @@ var require_req = __commonJS({
       mapHttpRequest,
       reqSerializer
     };
-    var rawSymbol = Symbol("pino-raw-req-ref");
+    var rawSymbol = /* @__PURE__ */ Symbol("pino-raw-req-ref");
     var pinoReqProto = Object.create({}, {
       id: {
         enumerable: true,
@@ -4543,7 +4543,7 @@ var require_res = __commonJS({
       mapHttpResponse,
       resSerializer
     };
-    var rawSymbol = Symbol("pino-raw-res-ref");
+    var rawSymbol = /* @__PURE__ */ Symbol("pino-raw-res-ref");
     var pinoResProto = Object.create({}, {
       statusCode: {
         enumerable: true,
@@ -4785,7 +4785,7 @@ var require_redact = __commonJS({
       }
       return true;
     }
-    var PATH_NOT_FOUND = Symbol("PATH_NOT_FOUND");
+    var PATH_NOT_FOUND = /* @__PURE__ */ Symbol("PATH_NOT_FOUND");
     function getValueIfExists(obj, parts) {
       let current = obj;
       for (const part of parts) {
@@ -5086,37 +5086,37 @@ var require_redact = __commonJS({
 var require_symbols = __commonJS({
   "../../node_modules/.pnpm/pino@10.3.1/node_modules/pino/lib/symbols.js"(exports, module) {
     "use strict";
-    var setLevelSym = Symbol("pino.setLevel");
-    var getLevelSym = Symbol("pino.getLevel");
-    var levelValSym = Symbol("pino.levelVal");
-    var levelCompSym = Symbol("pino.levelComp");
-    var useLevelLabelsSym = Symbol("pino.useLevelLabels");
-    var useOnlyCustomLevelsSym = Symbol("pino.useOnlyCustomLevels");
-    var mixinSym = Symbol("pino.mixin");
-    var lsCacheSym = Symbol("pino.lsCache");
-    var chindingsSym = Symbol("pino.chindings");
-    var asJsonSym = Symbol("pino.asJson");
-    var writeSym = Symbol("pino.write");
-    var redactFmtSym = Symbol("pino.redactFmt");
-    var timeSym = Symbol("pino.time");
-    var timeSliceIndexSym = Symbol("pino.timeSliceIndex");
-    var streamSym = Symbol("pino.stream");
-    var stringifySym = Symbol("pino.stringify");
-    var stringifySafeSym = Symbol("pino.stringifySafe");
-    var stringifiersSym = Symbol("pino.stringifiers");
-    var endSym = Symbol("pino.end");
-    var formatOptsSym = Symbol("pino.formatOpts");
-    var messageKeySym = Symbol("pino.messageKey");
-    var errorKeySym = Symbol("pino.errorKey");
-    var nestedKeySym = Symbol("pino.nestedKey");
-    var nestedKeyStrSym = Symbol("pino.nestedKeyStr");
-    var mixinMergeStrategySym = Symbol("pino.mixinMergeStrategy");
-    var msgPrefixSym = Symbol("pino.msgPrefix");
-    var wildcardFirstSym = Symbol("pino.wildcardFirst");
-    var serializersSym = Symbol.for("pino.serializers");
-    var formattersSym = Symbol.for("pino.formatters");
-    var hooksSym = Symbol.for("pino.hooks");
-    var needsMetadataGsym = Symbol.for("pino.metadata");
+    var setLevelSym = /* @__PURE__ */ Symbol("pino.setLevel");
+    var getLevelSym = /* @__PURE__ */ Symbol("pino.getLevel");
+    var levelValSym = /* @__PURE__ */ Symbol("pino.levelVal");
+    var levelCompSym = /* @__PURE__ */ Symbol("pino.levelComp");
+    var useLevelLabelsSym = /* @__PURE__ */ Symbol("pino.useLevelLabels");
+    var useOnlyCustomLevelsSym = /* @__PURE__ */ Symbol("pino.useOnlyCustomLevels");
+    var mixinSym = /* @__PURE__ */ Symbol("pino.mixin");
+    var lsCacheSym = /* @__PURE__ */ Symbol("pino.lsCache");
+    var chindingsSym = /* @__PURE__ */ Symbol("pino.chindings");
+    var asJsonSym = /* @__PURE__ */ Symbol("pino.asJson");
+    var writeSym = /* @__PURE__ */ Symbol("pino.write");
+    var redactFmtSym = /* @__PURE__ */ Symbol("pino.redactFmt");
+    var timeSym = /* @__PURE__ */ Symbol("pino.time");
+    var timeSliceIndexSym = /* @__PURE__ */ Symbol("pino.timeSliceIndex");
+    var streamSym = /* @__PURE__ */ Symbol("pino.stream");
+    var stringifySym = /* @__PURE__ */ Symbol("pino.stringify");
+    var stringifySafeSym = /* @__PURE__ */ Symbol("pino.stringifySafe");
+    var stringifiersSym = /* @__PURE__ */ Symbol("pino.stringifiers");
+    var endSym = /* @__PURE__ */ Symbol("pino.end");
+    var formatOptsSym = /* @__PURE__ */ Symbol("pino.formatOpts");
+    var messageKeySym = /* @__PURE__ */ Symbol("pino.messageKey");
+    var errorKeySym = /* @__PURE__ */ Symbol("pino.errorKey");
+    var nestedKeySym = /* @__PURE__ */ Symbol("pino.nestedKey");
+    var nestedKeyStrSym = /* @__PURE__ */ Symbol("pino.nestedKeyStr");
+    var mixinMergeStrategySym = /* @__PURE__ */ Symbol("pino.mixinMergeStrategy");
+    var msgPrefixSym = /* @__PURE__ */ Symbol("pino.msgPrefix");
+    var wildcardFirstSym = /* @__PURE__ */ Symbol("pino.wildcardFirst");
+    var serializersSym = /* @__PURE__ */ Symbol.for("pino.serializers");
+    var formattersSym = /* @__PURE__ */ Symbol.for("pino.formatters");
+    var hooksSym = /* @__PURE__ */ Symbol.for("pino.hooks");
+    var needsMetadataGsym = /* @__PURE__ */ Symbol.for("pino.metadata");
     module.exports = {
       setLevelSym,
       getLevelSym,
@@ -6241,7 +6241,7 @@ var require_thread_stream = __commonJS({
     } = require_indexes();
     var buffer = __require("buffer");
     var assert2 = __require("assert");
-    var kImpl = Symbol("kImpl");
+    var kImpl = /* @__PURE__ */ Symbol("kImpl");
     var MAX_STRING = buffer.constants.MAX_STRING_LENGTH;
     var FakeWeakRef = class {
       constructor(value) {
@@ -8257,7 +8257,7 @@ ${originalIndentation}`;
 var require_multistream = __commonJS({
   "../../node_modules/.pnpm/pino@10.3.1/node_modules/pino/lib/multistream.js"(exports, module) {
     "use strict";
-    var metadata = Symbol.for("pino.metadata");
+    var metadata = /* @__PURE__ */ Symbol.for("pino.metadata");
     var { DEFAULT_LEVELS } = require_constants();
     var DEFAULT_INFO_LEVEL = DEFAULT_LEVELS.info;
     function multistream(streamsArray, opts) {
@@ -8754,7 +8754,7 @@ var init_mjs = __esm({
   "../../node_modules/.pnpm/signal-exit@4.1.0/node_modules/signal-exit/dist/mjs/index.js"() {
     init_signals();
     processOk = (process17) => !!process17 && typeof process17 === "object" && typeof process17.removeListener === "function" && typeof process17.emit === "function" && typeof process17.reallyExit === "function" && typeof process17.listeners === "function" && typeof process17.kill === "function" && typeof process17.pid === "number" && typeof process17.on === "function";
-    kExitEmitter = Symbol.for("signal-exit emitter");
+    kExitEmitter = /* @__PURE__ */ Symbol.for("signal-exit emitter");
     global2 = globalThis;
     ObjectDefineProperty = Object.defineProperty.bind(Object);
     Emitter = class {
@@ -19921,7 +19921,7 @@ var require_utils = __commonJS({
 var require_lib2 = __commonJS({
   "../../node_modules/.pnpm/chardet@2.1.1/node_modules/chardet/lib/index.js"(exports) {
     "use strict";
-    var __createBinding = exports && exports.__createBinding || (Object.create ? function(o, m, k, k2) {
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
       if (k2 === void 0) k2 = k;
       var desc = Object.getOwnPropertyDescriptor(m, k);
       if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
@@ -19930,16 +19930,16 @@ var require_lib2 = __commonJS({
         } };
       }
       Object.defineProperty(o, k2, desc);
-    } : function(o, m, k, k2) {
+    }) : (function(o, m, k, k2) {
       if (k2 === void 0) k2 = k;
       o[k2] = m[k];
-    });
-    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? function(o, v) {
+    }));
+    var __setModuleDefault = exports && exports.__setModuleDefault || (Object.create ? (function(o, v) {
       Object.defineProperty(o, "default", { enumerable: true, value: v });
-    } : function(o, v) {
+    }) : function(o, v) {
       o["default"] = v;
     });
-    var __importStar = exports && exports.__importStar || /* @__PURE__ */ function() {
+    var __importStar = exports && exports.__importStar || /* @__PURE__ */ (function() {
       var ownKeys = function(o) {
         ownKeys = Object.getOwnPropertyNames || function(o2) {
           var ar = [];
@@ -19957,7 +19957,7 @@ var require_lib2 = __commonJS({
         __setModuleDefault(result, mod);
         return result;
       };
-    }();
+    })();
     var __importDefault = exports && exports.__importDefault || function(mod) {
       return mod && mod.__esModule ? mod : { "default": mod };
     };
@@ -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 {
@@ -26541,7 +26541,7 @@ function $constructor(name, initializer3, params) {
   Object.defineProperty(_, "name", { value: name });
   return _;
 }
-var $brand = Symbol("zod_brand");
+var $brand = /* @__PURE__ */ Symbol("zod_brand");
 var $ZodAsyncError = class extends Error {
   constructor() {
     super(`Encountered Promise during synchronous parse. Use .parseAsync() instead.`);
@@ -26688,7 +26688,7 @@ function floatSafeRemainder(val, step) {
   const stepInt = Number.parseInt(step.toFixed(decCount).replace(".", ""));
   return valInt % stepInt / 10 ** decCount;
 }
-var EVALUATING = Symbol("evaluating");
+var EVALUATING = /* @__PURE__ */ Symbol("evaluating");
 function defineLazy(object2, key, getter) {
   let value = void 0;
   Object.defineProperty(object2, key, {
@@ -35761,8 +35761,8 @@ function yo_default() {
 
 // ../../node_modules/.pnpm/zod@4.3.6/node_modules/zod/v4/core/registries.js
 var _a;
-var $output = Symbol("ZodOutput");
-var $input = Symbol("ZodInput");
+var $output = /* @__PURE__ */ Symbol("ZodOutput");
+var $input = /* @__PURE__ */ Symbol("ZodInput");
 var $ZodRegistry = class {
   constructor() {
     this._map = /* @__PURE__ */ new WeakMap();
@@ -36799,7 +36799,7 @@ function _stringbool(Classes, _params) {
     type: "pipe",
     in: stringSchema,
     out: booleanSchema,
-    transform: (input, payload) => {
+    transform: ((input, payload) => {
       let data = input;
       if (params.case !== "sensitive")
         data = data.toLowerCase();
@@ -36818,14 +36818,14 @@ function _stringbool(Classes, _params) {
         });
         return {};
       }
-    },
-    reverseTransform: (input, _payload) => {
+    }),
+    reverseTransform: ((input, _payload) => {
       if (input === true) {
         return truthyArray[0] || "true";
       } else {
         return falsyArray[0] || "false";
       }
-    },
+    }),
     error: params.error
   });
   return codec2;
@@ -38153,10 +38153,10 @@ var ZodType = /* @__PURE__ */ $constructor("ZodType", (inst, def) => {
   inst.with = inst.check;
   inst.clone = (def2, params) => clone(inst, def2, params);
   inst.brand = () => inst;
-  inst.register = (reg, meta3) => {
+  inst.register = ((reg, meta3) => {
     reg.add(inst, meta3);
     return inst;
-  };
+  });
   inst.parse = (data, params) => parse2(inst, data, params, { callee: inst.parse });
   inst.safeParse = (data, params) => safeParse2(inst, data, params);
   inst.parseAsync = async (data, params) => parseAsync2(inst, data, params, { callee: inst.parseAsync });
@@ -39785,6 +39785,8 @@ var envSchema = external_exports.object({
   BELIEF_DISCOUNT_FACTOR: external_exports.coerce.number().min(0).max(1).default(0.995),
   // Cold-start maturity threshold (number of trades before a trader is "established")
   COLD_START_MATURITY_THRESHOLD: external_exports.coerce.number().int().nonnegative().default(50),
+  // Politician trading data
+  FINNHUB_API_KEY: external_exports.string().default(""),
   // Feature flags
   ENABLE_LLM: external_exports.enum(["true", "false"]).default("false").transform((v) => v === "true"),
   ENABLE_LEARNING: external_exports.enum(["true", "false"]).default("false").transform((v) => v === "true"),
@@ -39806,6 +39808,8 @@ var envSchema = external_exports.object({
   NOTIFICATION_FROM_EMAIL: external_exports.string().default("alerts@tradingboy.dev"),
   // Solana (crypto payments)
   SOLANA_MERCHANT_WALLET: external_exports.string().default(""),
+  // Resend Email
+  RESEND_WEBHOOK_SECRET: external_exports.string().default(""),
   // Stripe Billing
   STRIPE_SECRET_KEY: external_exports.string().default(""),
   STRIPE_WEBHOOK_SECRET: external_exports.string().default(""),
@@ -48139,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 = [];
@@ -48420,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));
@@ -48468,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));
@@ -48629,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);
@@ -49758,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");
@@ -49858,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);
@@ -49897,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}
 `);
   }
 }
@@ -50571,7 +50791,7 @@ async function runOnboarding() {
     });
     if (wantsTrader) {
       const name = await input({
-        message: "Trader name (your alias)",
+        message: "Trader name (this will appear on the public leaderboard \u2014 use a pseudonym to stay anonymous)",
         default: "default",
         validate: (v) => v.trim().length > 0 ? true : "Name cannot be empty"
       });
@@ -50592,6 +50812,11 @@ async function runOnboarding() {
             body: { name: name.trim(), riskToleranceMax: parseFloat(maxDrawdown) }
           });
           console.log(source_default.green(`  \u2713 Trader "${result.name}" registered (id: ${result.id})`));
+          if (result.publicAlias) {
+            console.log(source_default.dim(`  Leaderboard alias: ${result.publicAlias}`));
+            console.log(source_default.dim("  This alias is public on the leaderboard. Change it anytime:"));
+            console.log(source_default.dim("  trading-boy trader set-alias <name> <new-alias>"));
+          }
           traderRegistered = true;
         } else {
           console.log(source_default.yellow("  Skipped \u2014 not connected to API. Run: trading-boy trader register"));

package/dist/commands/onboarding.js

@@ -28,7 +28,7 @@ export async function runOnboarding() {
         });
         if (wantsTrader) {
             const name = await input({
-                message: 'Trader name (your alias)',
+                message: 'Trader name (this will appear on the public leaderboard — use a pseudonym to stay anonymous)',
                 default: 'default',
                 validate: (v) => (v.trim().length > 0 ? true : 'Name cannot be empty'),
             });
@@ -49,6 +49,11 @@ export async function runOnboarding() {
                         body: { name: name.trim(), riskToleranceMax: parseFloat(maxDrawdown) },
                     });
                     console.log(chalk.green(`  \u2713 Trader "${result.name}" registered (id: ${result.id})`));
+                    if (result.publicAlias) {
+                        console.log(chalk.dim(`  Leaderboard alias: ${result.publicAlias}`));
+                        console.log(chalk.dim('  This alias is public on the leaderboard. Change it anytime:'));
+                        console.log(chalk.dim('  trading-boy trader set-alias <name> <new-alias>'));
+                    }
                     traderRegistered = true;
                 }
                 else {

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.17",
+  "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": {