@trading-boy/cli 2.0.1 → 2.1.1

package/dist/cli.bundle.js

@@ -19,11 +19,20 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   if (typeof require !== "undefined") return require.apply(this, arguments);
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -6979,13 +6988,16 @@ var init_credentials = __esm({
 // dist/api-client.js
 var api_client_exports = {};
 __export(api_client_exports, {
+  ApiCredentialConflictError: () => ApiCredentialConflictError,
+  ApiCredentialMissingError: () => ApiCredentialMissingError,
   ApiError: () => ApiError,
   apiRequest: () => apiRequest,
   getApiBase: () => getApiBase,
   isDevMode: () => isDevMode,
   isRemoteMode: () => isRemoteMode,
   redactApiKey: () => redactApiKey,
-  resolveApiKey: () => resolveApiKey
+  resolveApiKey: () => resolveApiKey,
+  resolveApiKeyWithSource: () => resolveApiKeyWithSource
 });
 function isDevMode() {
   if (process.env.NODE_ENV !== "development")
@@ -7000,22 +7012,50 @@ function isDevMode() {
     return false;
   }
 }
-async function resolveApiKey(flagKey) {
-  const envKey = process.env.TRADING_BOY_API_KEY;
+function normalizeCandidateKey(value) {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : null;
+}
+function assertNoCredentialConflicts(candidates) {
+  if (candidates.length <= 1)
+    return;
+  const first = candidates[0].apiKey;
+  const conflictingSources = candidates.filter((candidate) => candidate.apiKey !== first).map((candidate) => candidate.source);
+  if (conflictingSources.length === 0)
+    return;
+  throw new ApiCredentialConflictError([
+    candidates[0].source,
+    ...conflictingSources
+  ]);
+}
+async function resolveApiKeyWithSource(flagKey) {
+  const candidates = [];
+  const envKey = normalizeCandidateKey(process.env.TRADING_BOY_API_KEY);
   if (envKey) {
-    logger2.debug("Using API key from TRADING_BOY_API_KEY env var");
-    return envKey;
+    candidates.push({ apiKey: envKey, source: "TRADING_BOY_API_KEY env var" });
   }
-  if (flagKey) {
-    logger2.debug("Using API key from --api-key flag");
-    return flagKey;
+  const normalizedFlagKey = normalizeCandidateKey(flagKey);
+  if (normalizedFlagKey) {
+    candidates.push({ apiKey: normalizedFlagKey, source: "--api-key flag" });
   }
   const stored = await loadCredentials();
   if (stored?.apiKey) {
-    logger2.debug("Using stored API key");
-    return stored.apiKey;
+    candidates.push({
+      apiKey: stored.apiKey,
+      source: "stored credentials",
+      storedCredentials: stored
+    });
+  }
+  assertNoCredentialConflicts(candidates);
+  const resolved = candidates[0];
+  if (!resolved) {
+    throw new ApiCredentialMissingError();
   }
-  throw new Error("Not authenticated. Run `trading-boy login` to set up your API key.");
+  logger2.debug({ source: resolved.source }, "Using API key");
+  return resolved;
+}
+async function resolveApiKey(flagKey) {
+  return (await resolveApiKeyWithSource(flagKey)).apiKey;
 }
 function enforceHttps(url) {
   try {
@@ -7036,7 +7076,7 @@ function getApiBase() {
 }
 async function apiRequest(path3, options = {}) {
   const dev = isDevMode();
-  const apiKey = dev ? void 0 : options.apiKey ?? await resolveApiKey();
+  const apiKey = dev ? void 0 : await resolveApiKey(options.apiKey);
   const apiBase = getApiBase();
   const url = `${apiBase}${path3}`;
   const headers = {
@@ -7109,14 +7149,14 @@ async function isRemoteMode() {
   const stored = await loadCredentials();
   return !!stored?.apiKey;
 }
-var logger2, DEFAULT_API_BASE, ApiError;
+var logger2, DEFAULT_API_BASE, ApiError, ApiCredentialMissingError, ApiCredentialConflictError;
 var init_api_client = __esm({
   "dist/api-client.js"() {
     "use strict";
     init_logger();
     init_credentials();
     logger2 = createLogger2("cli-api-client");
-    DEFAULT_API_BASE = "https://api.cabal.ventures";
+    DEFAULT_API_BASE = "https://api.tradingboy.ai";
     ApiError = class extends Error {
       status;
       body;
@@ -7127,6 +7167,20 @@ var init_api_client = __esm({
         this.name = "ApiError";
       }
     };
+    ApiCredentialMissingError = class extends Error {
+      constructor() {
+        super("Not authenticated. Run `trading-boy login` to set up your API key.");
+        this.name = "ApiCredentialMissingError";
+      }
+    };
+    ApiCredentialConflictError = class extends Error {
+      sources;
+      constructor(sources) {
+        super(`Conflicting API credentials found in ${sources.join(", ")}. Unset one credential source or make them match before running this command.`);
+        this.sources = sources;
+        this.name = "ApiCredentialConflictError";
+      }
+    };
   }
 });
 
@@ -21425,6 +21479,39 @@ function createLogger(_name) {
 }
 
 // src/public-core-shim.ts
+var LLM_REASONING_EFFORTS = ["minimal", "low", "medium", "high", "xhigh"];
+var EXIT_REASONER_MODES = ["off", "observe", "notify", "protect", "manage", "full"];
+var EXIT_STYLES = ["scalp", "swing", "runner", "defensive", "manual"];
+var EXIT_TIMEFRAMES = ["scalp", "swing", "runner"];
+var CUSTOMER_API_KEY_V0_PATTERN = /^(tb_(?:live|test|free)_)([a-f0-9]{32})$/;
+var CUSTOMER_API_KEY_V1_PATTERN = /^(tb_(live|test)_v1_)([A-Za-z0-9_-]{16})\.([A-Za-z0-9_-]{32})$/;
+function legacyEnvironmentFromPrefix(prefix) {
+  return prefix === "tb_live_" ? "live" : "test";
+}
+function parseCustomerApiKey(apiKey) {
+  if (apiKey.trim() !== apiKey) return null;
+  const v1 = apiKey.match(CUSTOMER_API_KEY_V1_PATTERN);
+  if (v1) {
+    const environment = v1[2];
+    const keyId = v1[3];
+    const secret = v1[4];
+    return {
+      version: 1,
+      environment,
+      keyId,
+      secret,
+      keyPrefix: `${v1[1]}${keyId}`,
+      last4: secret.slice(-4)
+    };
+  }
+  const legacy = apiKey.match(CUSTOMER_API_KEY_V0_PATTERN);
+  if (!legacy) return null;
+  return {
+    version: 0,
+    environment: legacyEnvironmentFromPrefix(legacy[1]),
+    keyPrefix: legacy[1] + legacy[2].substring(0, 8)
+  };
+}
 function normalizeWatchlistSymbol(value) {
   const trimmed = value.trim();
   if (trimmed.length === 0) return trimmed;
@@ -22208,8 +22295,8 @@ function formatPnl(pnl) {
   if (pnl === null) {
     return source_default.dim("-");
   }
-  const sign = pnl >= 0 ? "+" : "";
-  const str = `${sign}$${pnl.toFixed(2)}`;
+  const sign = pnl >= 0 ? "+" : "-";
+  const str = `${sign}$${Math.abs(pnl).toFixed(2)}`;
   return pnl > 0 ? source_default.green(str) : pnl < 0 ? source_default.red(str) : source_default.dim(str);
 }
 function formatPercent(pct) {
@@ -22472,6 +22559,7 @@ init_utils();
 init_api_client();
 init_esm15();
 var logger9 = createLogger("cli-trader");
+var ALIAS_PATTERN = /^[a-zA-Z0-9_-]{3,30}$/;
 function formatTraderOutput(trader, wallets) {
   const lines = [];
   lines.push("");
@@ -22495,6 +22583,10 @@ function formatTraderOutput(trader, wallets) {
       lines.push(`    ${source_default.dim("\u2022")} ${source_default.white(w.address)} ${source_default.dim(`(${w.chain})`)} ${source_default.dim(`since ${w.since}`)}`);
     }
   }
+  lines.push(`  ${source_default.gray("Public Board:")}      ${trader.benchmarkOptIn ? source_default.green("visible") : source_default.dim("private")}`);
+  if (trader.publicAlias) {
+    lines.push(`  ${source_default.gray("Public Alias:")}      ${source_default.white(trader.publicAlias)}`);
+  }
   lines.push("");
   lines.push(`  ${source_default.gray("Created:")}           ${source_default.dim(trader.createdAt)}`);
   lines.push(`  ${source_default.gray("Updated:")}           ${source_default.dim(trader.updatedAt)}`);
@@ -22526,14 +22618,26 @@ function formatTraderListOutput(traders) {
 }
 function registerTraderCommand(program2) {
   const trader = program2.command("trader").description("Manage trader profiles");
-  trader.command("register").description("Register a new trader profile").requiredOption("--name <name>", "Trader display name").option("--wallet <address>", "Initial Solana wallet address").option("--max-drawdown <pct>", "Max acceptable drawdown percentage", parseFloatOption).addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (options) => {
+  trader.command("register").description("Register a new trader profile").requiredOption("--name <name>", "Trader display name").option("--wallet <address>", "Initial Solana wallet address").option("--max-drawdown <pct>", "Max acceptable drawdown percentage", parseFloatOption).option("--public-leaderboard", "Opt this trader into the public leaderboard").option("--alias <alias>", "Public leaderboard alias for --public-leaderboard").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (options) => {
+    if (options.publicLeaderboard && !options.alias) {
+      console.error(source_default.red("Error: --alias is required with --public-leaderboard."));
+      process.exitCode = 1;
+      return;
+    }
+    if (options.alias && !ALIAS_PATTERN.test(options.alias)) {
+      console.error(source_default.red("Error: Invalid alias. Must be 3-30 characters, alphanumeric with underscores and hyphens."));
+      process.exitCode = 1;
+      return;
+    }
     try {
       const result = await apiRequest("/api/v1/traders", {
         method: "POST",
         body: {
           name: options.name,
           wallet: options.wallet,
-          maxDrawdown: options.maxDrawdown
+          maxDrawdown: options.maxDrawdown,
+          benchmarkOptIn: options.publicLeaderboard === true,
+          publicAlias: options.alias
         }
       });
       const traderId = result.name ?? result.id;
@@ -22549,8 +22653,11 @@ function registerTraderCommand(program2) {
       } else {
         console.log(formatTraderOutput(result));
         console.log(source_default.green("  Trader registered successfully."));
-        if (result.alias) {
-          console.log(`  ${source_default.gray("Leaderboard alias:")} ${source_default.white(result.alias)} ${source_default.dim("(change with: trading-boy trader set-alias <name> <alias>)")}`);
+        if (result.publicAlias) {
+          console.log(`  ${source_default.gray("Leaderboard alias:")} ${source_default.white(result.publicAlias)} ${source_default.dim("(change with: trading-boy trader set-alias <name> <alias>)")}`);
+        } else {
+          console.log(`  ${source_default.gray("Public leaderboard:")} ${source_default.dim("private by default")}`);
+          console.log(`  ${source_default.dim("Opt in later:")} ${source_default.white("trading-boy trader leaderboard opt-in <name> <alias>")}`);
         }
         console.log("");
         console.log(source_default.bold("  Next: Set up your trading identity"));
@@ -22636,7 +22743,46 @@ function registerTraderCommand(program2) {
       process.exitCode = error2 instanceof ApiError ? 2 : 1;
     }
   });
-  const ALIAS_PATTERN = /^[a-zA-Z0-9_-]{3,30}$/;
+  const leaderboard = trader.command("leaderboard").description("Manage public leaderboard visibility");
+  leaderboard.command("opt-in").description("Show a trader on the public leaderboard").argument("<name-or-id>", "Trader name or ID").argument("<alias>", "Public alias (3-30 chars, alphanumeric/underscores/hyphens)").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (nameOrId, alias, options) => {
+    const jsonMode = options.format === "json";
+    if (!ALIAS_PATTERN.test(alias)) {
+      const msg = "Invalid alias. Must be 3-30 characters, alphanumeric with underscores and hyphens.";
+      if (jsonMode)
+        console.error(JSON.stringify({ error: msg }));
+      else
+        console.error(source_default.red(`  ${msg}`));
+      process.exitCode = 1;
+      return;
+    }
+    try {
+      const result = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/public-profile`, { method: "PATCH", body: { benchmarkOptIn: true, publicAlias: alias } });
+      if (jsonMode) {
+        console.log(JSON.stringify(result));
+      } else {
+        console.log("");
+        console.log(source_default.green(`  Public leaderboard enabled as: ${source_default.white(result.publicAlias)}`));
+        console.log("");
+      }
+    } catch (error2) {
+      handlePublicProfileError(error2, jsonMode, "enable public leaderboard");
+    }
+  });
+  leaderboard.command("opt-out").description("Hide a trader from the public leaderboard").argument("<name-or-id>", "Trader name or ID").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (nameOrId, options) => {
+    const jsonMode = options.format === "json";
+    try {
+      const result = await apiRequest(`/api/v1/traders/${encodeURIComponent(nameOrId)}/public-profile`, { method: "PATCH", body: { benchmarkOptIn: false } });
+      if (jsonMode) {
+        console.log(JSON.stringify(result));
+      } else {
+        console.log("");
+        console.log(source_default.green("  Public leaderboard disabled. This trader is private."));
+        console.log("");
+      }
+    } catch (error2) {
+      handlePublicProfileError(error2, jsonMode, "disable public leaderboard");
+    }
+  });
   trader.command("set-alias").description("Set a public leaderboard alias").argument("<name-or-id>", "Trader name or ID").argument("<alias>", "Leaderboard alias (3-30 chars, alphanumeric/underscores/hyphens)").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (nameOrId, alias, options) => {
     const jsonMode = options.format === "json";
     if (!ALIAS_PATTERN.test(alias)) {
@@ -23210,6 +23356,19 @@ function handleAgentError(error2, jsonMode, agentId, action) {
   }
   process.exitCode = error2 instanceof ApiError ? 2 : 1;
 }
+function handlePublicProfileError(error2, jsonMode, action) {
+  let message = error2 instanceof Error ? error2.message : String(error2);
+  if (error2 instanceof ApiError && error2.status === 409) {
+    message = "Alias already taken. Try a different name.";
+  }
+  logger9.error({ error: message }, `Failed to ${action}`);
+  if (jsonMode) {
+    console.error(JSON.stringify({ error: message }));
+  } else {
+    console.error(source_default.red(`Error: ${message}`));
+  }
+  process.exitCode = error2 instanceof ApiError ? 2 : 1;
+}
 function parseFloatOption(value) {
   return parseFloat(value);
 }
@@ -24408,6 +24567,9 @@ init_logger();
 init_api_client();
 init_utils();
 var logger14 = createLogger2("cli-public-config");
+function formatModelReasoning(model, reasoningEffort) {
+  return reasoningEffort ? `${model} (${reasoningEffort})` : model;
+}
 function printLlmConfig(result) {
   console.log("");
   console.log(source_default.bold.cyan("  LLM Configuration"));
@@ -24416,21 +24578,21 @@ function printLlmConfig(result) {
   if (result.effectiveProvider && (result.effectiveProvider !== result.provider || result.effectiveModel !== result.model)) {
     console.log(`  ${source_default.gray("Effective:")}     ${result.effectiveProvider} / ${result.effectiveModel ?? result.model}`);
   }
-  console.log(`  ${source_default.gray("Model:")}         ${result.model}`);
-  if (result.scanProvider || result.scanModel) {
-    console.log(`  ${source_default.gray("Scan:")}          ${result.scanProvider ?? result.provider} / ${result.scanModel ?? result.model}`);
+  console.log(`  ${source_default.gray("Model:")}         ${formatModelReasoning(result.model, result.reasoningEffort)}`);
+  if (result.scanProvider || result.scanModel || result.scanReasoningEffort) {
+    console.log(`  ${source_default.gray("Scan:")}          ${result.scanProvider ?? result.provider} / ${formatModelReasoning(result.scanModel ?? result.model, result.scanReasoningEffort ?? result.reasoningEffort)}`);
   }
-  if (result.analyzeProvider || result.analyzeModel) {
-    console.log(`  ${source_default.gray("Analyze:")}       ${result.analyzeProvider ?? result.provider} / ${result.analyzeModel ?? result.model}`);
+  if (result.analyzeProvider || result.analyzeModel || result.analyzeReasoningEffort) {
+    console.log(`  ${source_default.gray("Analyze:")}       ${result.analyzeProvider ?? result.provider} / ${formatModelReasoning(result.analyzeModel ?? result.model, result.analyzeReasoningEffort ?? result.reasoningEffort)}`);
   }
-  if (result.decideProvider || result.decideModel) {
-    console.log(`  ${source_default.gray("Decide:")}        ${result.decideProvider ?? result.provider} / ${result.decideModel ?? result.model}`);
+  if (result.decideProvider || result.decideModel || result.decideReasoningEffort) {
+    console.log(`  ${source_default.gray("Decide:")}        ${result.decideProvider ?? result.provider} / ${formatModelReasoning(result.decideModel ?? result.model, result.decideReasoningEffort ?? result.reasoningEffort)}`);
   }
-  if (result.exitHeartbeatModel) {
-    console.log(`  ${source_default.gray("Exit HB:")}       ${result.exitHeartbeatModel}`);
+  if (result.exitHeartbeatModel || result.exitHeartbeatReasoningEffort) {
+    console.log(`  ${source_default.gray("Exit HB:")}       ${formatModelReasoning(result.exitHeartbeatModel ?? result.model, result.exitHeartbeatReasoningEffort ?? result.reasoningEffort)}`);
   }
-  if (result.exitEventModel) {
-    console.log(`  ${source_default.gray("Exit Event:")}    ${result.exitEventModel}`);
+  if (result.exitEventModel || result.exitEventReasoningEffort) {
+    console.log(`  ${source_default.gray("Exit Event:")}    ${formatModelReasoning(result.exitEventModel ?? result.model, result.exitEventReasoningEffort ?? result.reasoningEffort)}`);
   }
   if (result.baseUrl) {
     console.log(`  ${source_default.gray("Base URL:")}      ${result.baseUrl}`);
@@ -24494,7 +24656,44 @@ function registerConfigCommand(program2) {
     }
     printLlmConfig(llmConfig);
   });
-  configCmd.command("set-llm-key <apiKey>").description("Store your LLM provider API key for agents, thesis extraction, and coaching (BYOK)").addOption(new Option("-p, --provider <provider>", "LLM provider (auto-detected from key prefix if omitted)").choices(["anthropic", "openai", "openrouter", "ollama", "gemini", "groq", "deepseek", "codex", "custom"])).option("-m, --model <model>", "Model name (default for all phases)").option("--base-url <url>", "Custom base URL (for openrouter/ollama/custom providers)").option("--scan-model <model>", "Model for market scanning").option("--analyze-model <model>", "Model for deep analysis").option("--decide-model <model>", "Model for trade decisions").addOption(new Option("--scan-provider <provider>", "Provider for scan phase").choices(["anthropic", "openai", "openrouter", "ollama", "gemini", "groq", "deepseek", "custom"])).option("--scan-key <key>", "LLM provider API key for the scan phase").addOption(new Option("--analyze-provider <provider>", "Provider for analyze phase").choices(["anthropic", "openai", "openrouter", "ollama", "gemini", "groq", "deepseek", "custom"])).option("--analyze-key <key>", "LLM provider API key for the analyze phase").addOption(new Option("--decide-provider <provider>", "Provider for decide phase").choices(["anthropic", "openai", "openrouter", "ollama", "gemini", "groq", "deepseek", "custom"])).option("--decide-key <key>", "LLM provider API key for the decide phase").action(async (apiKey, opts) => {
+  configCmd.command("set-llm-key <apiKey>").description("Store your LLM provider API key for agents, thesis extraction, and coaching (BYOK)").addOption(new Option("-p, --provider <provider>", "LLM provider (auto-detected from key prefix if omitted)").choices([
+    "anthropic",
+    "openai",
+    "openrouter",
+    "ollama",
+    "gemini",
+    "groq",
+    "deepseek",
+    "codex",
+    "custom"
+  ])).option("-m, --model <model>", "Model name (default for all phases)").option("--base-url <url>", "Custom base URL (for openrouter/ollama/custom providers)").option("--scan-model <model>", "Model for market scanning").option("--analyze-model <model>", "Model for deep analysis").option("--decide-model <model>", "Model for trade decisions").addOption(new Option("--scan-provider <provider>", "Provider for scan phase").choices([
+    "anthropic",
+    "openai",
+    "openrouter",
+    "ollama",
+    "gemini",
+    "groq",
+    "deepseek",
+    "custom"
+  ])).option("--scan-key <key>", "LLM provider API key for the scan phase").addOption(new Option("--analyze-provider <provider>", "Provider for analyze phase").choices([
+    "anthropic",
+    "openai",
+    "openrouter",
+    "ollama",
+    "gemini",
+    "groq",
+    "deepseek",
+    "custom"
+  ])).option("--analyze-key <key>", "LLM provider API key for the analyze phase").addOption(new Option("--decide-provider <provider>", "Provider for decide phase").choices([
+    "anthropic",
+    "openai",
+    "openrouter",
+    "ollama",
+    "gemini",
+    "groq",
+    "deepseek",
+    "custom"
+  ])).option("--decide-key <key>", "LLM provider API key for the decide phase").action(async (apiKey, opts) => {
     if (!await ensureRemote())
       return;
     try {
@@ -24543,12 +24742,14 @@ function registerConfigCommand(program2) {
       process.exitCode = error2 instanceof ApiError ? 2 : 1;
     }
   });
-  configCmd.command("set-models").description("Update per-stage model assignments (works with BYOK or a ChatGPT connection)").option("-m, --model <model>", "Default model for all phases").option("--scan-model <model>", "Model for market scanning").option("--analyze-model <model>", "Model for deep analysis").option("--decide-model <model>", "Model for trade decisions").option("--exit-heartbeat-model <model>", "Model for exit heartbeat checks").option("--exit-event-model <model>", "Model for exit event-driven analysis").action(async (opts) => {
+  configCmd.command("set-models").description("Update per-stage model assignments (works with BYOK or a ChatGPT connection)").option("-m, --model <model>", "Default model for all phases").addOption(new Option("--reasoning-effort <effort>", "Default reasoning effort").choices([
+    ...LLM_REASONING_EFFORTS
+  ])).option("--scan-model <model>", "Model for market scanning").addOption(new Option("--scan-reasoning-effort <effort>", "Reasoning effort for market scanning").choices([...LLM_REASONING_EFFORTS])).option("--analyze-model <model>", "Model for deep analysis").addOption(new Option("--analyze-reasoning-effort <effort>", "Reasoning effort for deep analysis").choices([...LLM_REASONING_EFFORTS])).option("--decide-model <model>", "Model for trade decisions").addOption(new Option("--decide-reasoning-effort <effort>", "Reasoning effort for trade decisions").choices([...LLM_REASONING_EFFORTS])).option("--exit-heartbeat-model <model>", "Model for exit heartbeat checks").addOption(new Option("--exit-heartbeat-reasoning-effort <effort>", "Reasoning effort for exit heartbeat checks").choices([...LLM_REASONING_EFFORTS])).option("--exit-event-model <model>", "Model for exit event-driven analysis").addOption(new Option("--exit-event-reasoning-effort <effort>", "Reasoning effort for exit event-driven analysis").choices([...LLM_REASONING_EFFORTS])).action(async (opts) => {
     if (!await ensureRemote())
       return;
-    if (!opts.model && !opts.scanModel && !opts.analyzeModel && !opts.decideModel && !opts.exitHeartbeatModel && !opts.exitEventModel) {
-      console.error(source_default.red("  Error: At least one model flag is required."));
-      console.log(source_default.dim("  Example: trading-boy config set-models --scan-model gpt-5.4-mini --analyze-model gpt-5.4"));
+    if (!opts.model && !opts.reasoningEffort && !opts.scanModel && !opts.scanReasoningEffort && !opts.analyzeModel && !opts.analyzeReasoningEffort && !opts.decideModel && !opts.decideReasoningEffort && !opts.exitHeartbeatModel && !opts.exitHeartbeatReasoningEffort && !opts.exitEventModel && !opts.exitEventReasoningEffort) {
+      console.error(source_default.red("  Error: At least one model or reasoning flag is required."));
+      console.log(source_default.dim("  Example: trading-boy config set-models --model gpt-5.5 --reasoning-effort low"));
       process.exitCode = 1;
       return;
     }
@@ -24557,27 +24758,33 @@ function registerConfigCommand(program2) {
         method: "PATCH",
         body: {
           ...opts.model ? { model: opts.model } : {},
+          ...opts.reasoningEffort ? { reasoningEffort: opts.reasoningEffort } : {},
           ...opts.scanModel ? { scanModel: opts.scanModel } : {},
+          ...opts.scanReasoningEffort ? { scanReasoningEffort: opts.scanReasoningEffort } : {},
           ...opts.analyzeModel ? { analyzeModel: opts.analyzeModel } : {},
+          ...opts.analyzeReasoningEffort ? { analyzeReasoningEffort: opts.analyzeReasoningEffort } : {},
           ...opts.decideModel ? { decideModel: opts.decideModel } : {},
+          ...opts.decideReasoningEffort ? { decideReasoningEffort: opts.decideReasoningEffort } : {},
           ...opts.exitHeartbeatModel ? { exitHeartbeatModel: opts.exitHeartbeatModel } : {},
-          ...opts.exitEventModel ? { exitEventModel: opts.exitEventModel } : {}
+          ...opts.exitHeartbeatReasoningEffort ? { exitHeartbeatReasoningEffort: opts.exitHeartbeatReasoningEffort } : {},
+          ...opts.exitEventModel ? { exitEventModel: opts.exitEventModel } : {},
+          ...opts.exitEventReasoningEffort ? { exitEventReasoningEffort: opts.exitEventReasoningEffort } : {}
         }
       });
       console.log("");
-      console.log(source_default.green("  Stage models updated"));
+      console.log(source_default.green("  Stage LLM settings updated"));
       console.log(source_default.gray("  " + "\u2500".repeat(40)));
-      console.log(`  ${source_default.gray("Default:")}           ${result.model}`);
-      if (result.scanModel)
-        console.log(`  ${source_default.gray("Scan:")}              ${result.scanModel}`);
-      if (result.analyzeModel)
-        console.log(`  ${source_default.gray("Analyze:")}           ${result.analyzeModel}`);
-      if (result.decideModel)
-        console.log(`  ${source_default.gray("Decide:")}            ${result.decideModel}`);
-      if (result.exitHeartbeatModel)
-        console.log(`  ${source_default.gray("Exit heartbeat:")}    ${result.exitHeartbeatModel}`);
-      if (result.exitEventModel)
-        console.log(`  ${source_default.gray("Exit event:")}        ${result.exitEventModel}`);
+      console.log(`  ${source_default.gray("Default:")}           ${formatModelReasoning(result.model, result.reasoningEffort)}`);
+      if (result.scanModel || result.scanReasoningEffort)
+        console.log(`  ${source_default.gray("Scan:")}              ${formatModelReasoning(result.scanModel ?? result.model, result.scanReasoningEffort ?? result.reasoningEffort)}`);
+      if (result.analyzeModel || result.analyzeReasoningEffort)
+        console.log(`  ${source_default.gray("Analyze:")}           ${formatModelReasoning(result.analyzeModel ?? result.model, result.analyzeReasoningEffort ?? result.reasoningEffort)}`);
+      if (result.decideModel || result.decideReasoningEffort)
+        console.log(`  ${source_default.gray("Decide:")}            ${formatModelReasoning(result.decideModel ?? result.model, result.decideReasoningEffort ?? result.reasoningEffort)}`);
+      if (result.exitHeartbeatModel || result.exitHeartbeatReasoningEffort)
+        console.log(`  ${source_default.gray("Exit heartbeat:")}    ${formatModelReasoning(result.exitHeartbeatModel ?? result.model, result.exitHeartbeatReasoningEffort ?? result.reasoningEffort)}`);
+      if (result.exitEventModel || result.exitEventReasoningEffort)
+        console.log(`  ${source_default.gray("Exit event:")}        ${formatModelReasoning(result.exitEventModel ?? result.model, result.exitEventReasoningEffort ?? result.reasoningEffort)}`);
       console.log("");
       console.log(source_default.dim("  Agents will use these models on their next tick."));
       console.log("");
@@ -24640,9 +24847,9 @@ init_source();
 init_credentials();
 init_api_client();
 var logger15 = createLogger("cli-login");
-var API_KEY_PATTERN = /^tb_(live|test|free)_[a-f0-9]{32}$/;
+var API_KEY_FORMAT_HELP = "Expected: tb_live_v1_<keyId>.<secret>, tb_test_v1_<keyId>.<secret>, or legacy tb_live_<32hex>/tb_test_<32hex>/tb_free_<32hex>";
 function validateApiKeyFormat(key) {
-  return API_KEY_PATTERN.test(key);
+  return parseCustomerApiKey(key) !== null;
 }
 async function verifyApiKey(apiKey) {
   const apiBase = getApiBase();
@@ -24704,14 +24911,14 @@ function registerLoginCommand(program2) {
             if (!input)
               return "Trading Boy API key is required";
             if (!validateApiKeyFormat(input)) {
-              return "Invalid Trading Boy API key format. Expected: tb_live_<32hex>, tb_test_<32hex>, or tb_free_<32hex>";
+              return `Invalid Trading Boy API key format. ${API_KEY_FORMAT_HELP}`;
             }
             return true;
           }
         });
       }
       if (!validateApiKeyFormat(apiKey)) {
-        console.error(source_default.red("  Invalid Trading Boy API key format. Expected: tb_live_<32hex>, tb_test_<32hex>, or tb_free_<32hex>"));
+        console.error(source_default.red(`  Invalid Trading Boy API key format. ${API_KEY_FORMAT_HELP}`));
         process.exitCode = 1;
         return;
       }
@@ -24843,34 +25050,31 @@ init_credentials();
 init_api_client();
 var logger17 = createLogger("cli-whoami");
 async function executeWhoami() {
-  const envKey = process.env.TRADING_BOY_API_KEY;
-  if (envKey) {
-    return {
-      authenticated: true,
-      redactedKey: redactApiKey(envKey),
-      storageMethod: "TRADING_BOY_API_KEY env var"
-    };
-  }
-  const creds = await loadCredentials();
-  if (!creds) {
-    return { authenticated: false };
+  let resolved;
+  try {
+    resolved = await resolveApiKeyWithSource();
+  } catch (error2) {
+    if (error2 instanceof ApiCredentialMissingError) {
+      return { authenticated: false };
+    }
+    throw error2;
   }
+  const creds = resolved.source === "stored credentials" ? resolved.storedCredentials ?? await loadCredentials() : null;
   const result = {
     authenticated: true,
-    email: creds.email,
-    plan: creds.plan,
-    keyId: creds.keyId,
-    redactedKey: redactApiKey(creds.apiKey),
-    storageMethod: creds.storageMethod,
-    storedAt: creds.storedAt
+    email: creds?.email,
+    plan: creds?.plan,
+    keyId: creds?.keyId,
+    redactedKey: redactApiKey(resolved.apiKey),
+    storageMethod: resolved.source === "stored credentials" ? creds?.storageMethod : resolved.source,
+    storedAt: creds?.storedAt
   };
   try {
-    const apiKey = await resolveApiKey();
     const response = await fetch(`${getApiBase()}/api/v1/auth/verify`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        "Authorization": `Bearer ${apiKey}`
+        "Authorization": `Bearer ${resolved.apiKey}`
       },
       body: "{}"
     });
@@ -24939,16 +25143,9 @@ function registerWhoamiCommand(program2) {
     try {
       const result = await executeWhoami();
       if (options.showKey && result.authenticated) {
-        const envKey = process.env.TRADING_BOY_API_KEY;
-        if (envKey) {
-          console.log(envKey);
-          return;
-        }
-        const creds = await loadCredentials();
-        if (creds) {
-          console.log(creds.apiKey);
-          return;
-        }
+        const resolved = await resolveApiKeyWithSource();
+        console.log(resolved.apiKey);
+        return;
       }
       if (options.format === "json") {
         console.log(JSON.stringify({ ...result, apiUrl: getApiBase() }, null, 2));
@@ -25369,6 +25566,12 @@ async function openBrowser(url) {
 // dist/commands/onboarding.js
 var DEFAULT_FIRST_AGENT_AUTONOMY = "FULLY_AUTONOMOUS";
 var MIN_SCAN_INTERVAL_MS = 6e4;
+var LEADERBOARD_ALIAS_PATTERN = /^[a-zA-Z0-9_-]{3,30}$/;
+function defaultLeaderboardAlias(name) {
+  const normalized = name.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
+  const alias = normalized || "trader";
+  return alias.slice(0, 24);
+}
 function trackOnboardingEvent(eventType, metadata = {}) {
   try {
     emitCliProductEvent(eventType, {
@@ -25442,17 +25645,37 @@ async function runOnboarding() {
           return true;
         }
       });
+      const benchmarkOptIn = await confirm({
+        message: "Show this trader on the public leaderboard? You can opt in later from the CLI.",
+        default: false
+      });
+      let publicAlias;
+      if (benchmarkOptIn) {
+        publicAlias = await input({
+          message: "Public leaderboard alias (3-30 letters, numbers, underscores, or hyphens)",
+          default: defaultLeaderboardAlias(name),
+          validate: (v) => LEADERBOARD_ALIAS_PATTERN.test(v.trim()) ? true : "Alias must be 3-30 characters using letters, numbers, underscores, or hyphens."
+        });
+      }
       try {
         if (await isRemoteMode()) {
           const result = await apiRequest("/api/v1/traders", {
             method: "POST",
-            body: { name: name.trim(), riskToleranceMax: parseFloat(maxDrawdown) }
+            body: {
+              name: name.trim(),
+              maxDrawdown: parseFloat(maxDrawdown),
+              benchmarkOptIn,
+              publicAlias: publicAlias?.trim()
+            }
           });
           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>"));
+          } else {
+            console.log(source_default.dim("  Public leaderboard: private. Opt in later with:"));
+            console.log(source_default.dim("  trading-boy trader leaderboard opt-in <name> <alias>"));
           }
           traderName = name.trim();
           traderId = result.id;
@@ -25637,7 +25860,7 @@ function printExploreQuickReference() {
   console.log(`  ${source_default.white("trading-boy stats")}             ${source_default.dim("Track performance")}`);
   console.log("");
   console.log(source_default.dim("  Build an agent later: trading-boy onboarding"));
-  console.log(source_default.dim("  Full docs: https://api.cabal.ventures/docs"));
+  console.log(source_default.dim("  Full docs: https://api.tradingboy.ai/docs"));
   console.log("");
 }
 function printAgentRuntimeOverview() {
@@ -25681,7 +25904,7 @@ function printAgentQuickReference(traderRegistered) {
     console.log(`  ${source_default.white("trading-boy behavioral profile --trader <trader-id>")} ${source_default.dim("Behavioral analysis")}`);
   }
   console.log("");
-  console.log(source_default.dim("  Full docs: https://api.cabal.ventures/docs"));
+  console.log(source_default.dim("  Full docs: https://api.tradingboy.ai/docs"));
   console.log("");
 }
 async function resolveTraderId(nameOrId) {
@@ -26110,7 +26333,7 @@ async function pollForApiKey(token, onTick) {
       if (result.status === "expired" || result.status === "not_found") {
         return {
           success: false,
-          error: "Provisioning token expired. Your API key will be emailed to you shortly. Then run: `trading-boy login`"
+          error: "Provisioning token expired or was not found. Run `trading-boy forgot-key -e <email>` to request a one-time HTTPS recovery link. Full API keys are never emailed."
         };
       }
       if (result.status === "already_retrieved") {
@@ -26127,7 +26350,7 @@ async function pollForApiKey(token, onTick) {
   }
   return {
     success: false,
-    error: "Timed out waiting for payment confirmation. Your API key will be emailed to you shortly. Then run: `trading-boy login`"
+    error: "Timed out waiting for payment confirmation. Check your payment status, rerun `trading-boy subscribe`, or use `trading-boy forgot-key -e <email>` after activation. Full API keys are never emailed."
   };
 }
 async function saveApiKey(apiKey, metadata) {
@@ -26439,7 +26662,7 @@ function sleep2(ms) {
 var ALLOWED_CHECKOUT_DOMAINS = /* @__PURE__ */ new Set([
   "checkout.stripe.com",
   "billing.stripe.com",
-  "api.cabal.ventures"
+  "api.tradingboy.ai"
 ]);
 function validateBrowserUrl(url) {
   const parsed = new URL(url);
@@ -26595,7 +26818,7 @@ function formatElapsed2(ms) {
   return `${seconds}s`;
 }
 function registerForgotKeyCommand(program2) {
-  program2.command("forgot-key").description("Recover your API key via email").requiredOption("-e, --email <email>", "Your account email address").action(async (options) => {
+  program2.command("forgot-key").description("Recover your API key with a one-time HTTPS claim link").requiredOption("-e, --email <email>", "Your account email address").action(async (options) => {
     const { email } = options;
     if (!isValidEmail2(email)) {
       console.error(source_default.red("  Invalid email address."));
@@ -26610,6 +26833,7 @@ function registerForgotKeyCommand(program2) {
       const recovery = await requestKeyRecovery(email);
       console.log(source_default.white("  Recovery email sent! Check your inbox."));
       console.log(source_default.dim("  Click the link in the email to provision a new key."));
+      console.log(source_default.dim("  Full API keys are never emailed."));
       console.log("");
       let pollResult;
       try {
@@ -26744,9 +26968,9 @@ function formatAttributionOutput(data) {
   }
   lines.push(source_default.bold("  Summary"));
   lines.push(`  ${source_default.gray("Total PnL:")}        ${colorPnl(s.totalPnlUsd ?? 0)}`);
-  lines.push(`  ${source_default.gray("Signal Alpha:")}     ${formatPct2(s.avgSignalAlphaPct ?? 0)}`);
-  lines.push(`  ${source_default.gray("Execution Cost:")}   ${formatPct2(s.avgExecutionCostPct ?? 0)}`);
-  lines.push(`  ${source_default.gray("Timing Variance:")}  ${formatPct2(s.avgTimingVariancePct ?? 0)}`);
+  lines.push(`  ${source_default.gray("Signal Alpha:")}     ${formatPctPoints(s.avgSignalAlphaPct ?? 0)}`);
+  lines.push(`  ${source_default.gray("Execution Cost:")}   ${formatPctPoints(s.avgExecutionCostPct ?? 0)}`);
+  lines.push(`  ${source_default.gray("Timing Variance:")}  ${formatPctPoints(s.avgTimingVariancePct ?? 0)}`);
   lines.push(`  ${source_default.gray("Trade Count:")}      ${s.trades ?? 0}`);
   const setupEntries = Object.entries(data.analysis.bySetupType ?? {});
   if (setupEntries.length > 0) {
@@ -26755,7 +26979,7 @@ function formatAttributionOutput(data) {
     lines.push(`  ${source_default.gray("Setup".padEnd(20))}${"Signal%".padStart(10)}${"Exec%".padStart(10)}${"Timing%".padStart(10)}${"N".padStart(5)}`);
     lines.push(source_default.gray("  " + "\u2500".repeat(55)));
     for (const [setup, v] of setupEntries) {
-      lines.push(`  ${setup.padEnd(20)}${formatPct2(v.avgSignalAlphaPct).padStart(10)}${formatPct2(v.avgExecutionCostPct).padStart(10)}${formatPct2(v.avgTimingVariancePct).padStart(10)}${String(v.trades).padStart(5)}`);
+      lines.push(`  ${setup.padEnd(20)}${formatPctPoints(v.avgSignalAlphaPct).padStart(10)}${formatPctPoints(v.avgExecutionCostPct).padStart(10)}${formatPctPoints(v.avgTimingVariancePct).padStart(10)}${String(v.trades).padStart(5)}`);
     }
   }
   if (data.analysis.attributions.length > 0) {
@@ -26790,13 +27014,17 @@ function colorPnl(usd) {
 }
 function formatUsd4(val) {
   const v = val ?? 0;
-  const sign = v >= 0 ? "+" : "";
-  return `${sign}$${v.toFixed(2)}`;
+  const sign = v >= 0 ? "+" : "-";
+  return `${sign}$${Math.abs(v).toFixed(2)}`;
 }
 function formatPct2(val) {
   const v = val ?? 0;
   return `${v >= 0 ? "+" : ""}${(v * 100).toFixed(1)}%`;
 }
+function formatPctPoints(val) {
+  const v = val ?? 0;
+  return `${v >= 0 ? "+" : ""}${v.toFixed(1)}%`;
+}
 function registerEdgeCommand(program2) {
   program2.command("edge <traderId>").description("Analyze trade quality \u2014 edge ratio and PnL attribution").option("--attribution", "Show PnL attribution breakdown instead of edge ratio").option("--token <symbol>", "Filter by token symbol").option("--limit <n>", "Number of trades to analyze (1-500)", "100").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (traderId, options) => {
     try {
@@ -28149,6 +28377,8 @@ var AUTONOMY_HELP_UPDATE = "Autonomy mode. Choose Fully auto (FULLY_AUTONOMOUS),
 var MIN_CONFIDENCE_HELP = "Minimum confidence threshold (0-1, so 0.70 = 70%)";
 var EXIT_REASONER_HELP = "Enable LLM-powered exit reasoning for open positions (hold, exit, tighten stop, or extend take profit)";
 var DISABLE_EXIT_REASONER_HELP = "Disable LLM-powered exit reasoning for open positions";
+var EXIT_REASONER_MODE_HELP = "Exit reasoner authority mode for open positions";
+var URGENT_EVENT_EXIT_MODE_HELP = "Urgent event exit review mode; cannot exceed the normal exit reasoner mode";
 var SHARED_SCAN_CACHE_INTERNAL_HELP = "Internal/load-test only: bypass shared scan cache for this agent";
 var ENABLE_SHARED_SCAN_CACHE_HELP = "Internal/load-test only: re-enable shared scan cache for this agent";
 function formatShortDate5(isoString) {
@@ -28213,7 +28443,7 @@ function parseHumanInterval2(value) {
 var MIN_SCAN_INTERVAL_MS2 = 6e4;
 function registerAgentCommand(program2) {
   const agent = program2.command("agent").description("Manage autonomous trading agents");
-  agent.command("create").description("Create a new agent").option("--trader-id <traderId>", "Trader ID").option("--strategy-id <strategyId>", "Strategy ID (optional \u2014 auto-creates if omitted)").option("--name <name>", "Agent name").option("--autonomy <level>", AUTONOMY_HELP_CREATE, "FULLY_AUTONOMOUS").option("--scan-interval <ms>", "Scan interval in raw milliseconds (min 60000; e.g. 300000 = 5m)", "300000").option("--scan-interval-human <duration>", "Scan interval in human-readable format (e.g. 1m, 5m, 15m, 30m, 1h). Overrides --scan-interval").option("--watchlist <symbols>", "Comma-separated token symbols").option("--max-daily-trades <n>", "Max daily trades", "10").option("--max-daily-loss <usd>", "Max daily loss in USD", "500").option("--max-position-size <pct>", "Max position size as decimal (0.10 = 10%)", "0.10").option("--min-confidence <n>", MIN_CONFIDENCE_HELP, "0.60").option("--scan-model <model>", "LLM model for market scanning").option("--analyze-model <model>", "LLM model for deep analysis").option("--decide-model <model>", "LLM model for trade decisions").option("--disable-shared-scan-cache", SHARED_SCAN_CACHE_INTERNAL_HELP).addOption(new Option("--asset-class <class>", "Asset class for this agent").choices(["crypto", "commodities", "mixed"]).default("crypto")).option("--soul-override <text>", "Custom soul/personality for this agent").option("--purpose-override <text>", "Custom purpose/mission for this agent").option("--soul-file <path>", "Load soul from a file").option("--purpose-file <path>", "Load purpose from a file").option("--exit-reasoner", EXIT_REASONER_HELP).addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (options) => {
+  agent.command("create").description("Create a new agent").option("--trader-id <traderId>", "Trader ID").option("--strategy-id <strategyId>", "Strategy ID (optional \u2014 auto-creates if omitted)").option("--name <name>", "Agent name").option("--autonomy <level>", AUTONOMY_HELP_CREATE, "FULLY_AUTONOMOUS").option("--scan-interval <ms>", "Scan interval in raw milliseconds (min 60000; e.g. 300000 = 5m)", "300000").option("--scan-interval-human <duration>", "Scan interval in human-readable format (e.g. 1m, 5m, 15m, 30m, 1h). Overrides --scan-interval").option("--watchlist <symbols>", "Comma-separated token symbols").option("--max-daily-trades <n>", "Max daily trades", "10").option("--max-daily-loss <usd>", "Max daily loss in USD", "500").option("--max-position-size <pct>", "Max position size as decimal (0.10 = 10%)", "0.10").option("--min-confidence <n>", MIN_CONFIDENCE_HELP, "0.60").option("--scan-model <model>", "LLM model for market scanning").option("--analyze-model <model>", "LLM model for deep analysis").option("--decide-model <model>", "LLM model for trade decisions").option("--disable-shared-scan-cache", SHARED_SCAN_CACHE_INTERNAL_HELP).addOption(new Option("--asset-class <class>", "Asset class for this agent").choices(["crypto", "commodities", "mixed"]).default("crypto")).option("--soul-override <text>", "Custom soul/personality for this agent").option("--purpose-override <text>", "Custom purpose/mission for this agent").option("--soul-file <path>", "Load soul from a file").option("--purpose-file <path>", "Load purpose from a file").option("--exit-reasoner", EXIT_REASONER_HELP).addOption(new Option("--exit-reasoner-mode <mode>", EXIT_REASONER_MODE_HELP).choices([...EXIT_REASONER_MODES])).addOption(new Option("--urgent-event-exit-mode <mode>", URGENT_EVENT_EXIT_MODE_HELP).choices([...EXIT_REASONER_MODES])).addOption(new Option("--exit-style <style>", "Exit management preset").choices([...EXIT_STYLES])).addOption(new Option("--exit-timeframe <timeframe>", "Strategy exit timing preset").choices([...EXIT_TIMEFRAMES])).addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (options) => {
     if (!await ensureRemote())
       return;
     if (!options.traderId) {
@@ -28269,6 +28499,14 @@ function registerAgentCommand(program2) {
       body.assetClass = options.assetClass;
     if (options.exitReasoner)
       body.exitReasonerEnabled = true;
+    if (options.exitReasonerMode)
+      body.exitReasonerMode = options.exitReasonerMode;
+    if (options.urgentEventExitMode)
+      body.urgentEventExitReviewMode = options.urgentEventExitMode;
+    if (options.exitStyle)
+      body.exitStyle = options.exitStyle;
+    if (options.exitTimeframe)
+      body.exitTimingPolicy = { timeframe: options.exitTimeframe };
     if (options.soulFile) {
       const path3 = resolve(options.soulFile);
       if (!existsSync2(path3)) {
@@ -28306,7 +28544,8 @@ function registerAgentCommand(program2) {
         console.log(`  ${source_default.gray("Trader:")}    ${result.traderId}`);
         console.log(`  ${source_default.gray("Strategy:")}  ${result.strategyId}${result.autoStrategyCreated ? source_default.dim(" (auto-created)") : ""}`);
         console.log(`  ${source_default.gray("Autonomy:")}  ${formatAutonomy(result.autonomyLevel)}`);
-        console.log(`  ${source_default.gray("Exit reasoner:")} ${result.exitReasonerEnabled ? source_default.green("enabled") : source_default.dim("disabled")}`);
+        console.log(`  ${source_default.gray("Exit reasoner:")} ${result.exitReasonerEnabled ? source_default.green("enabled") : source_default.dim("disabled")} (${result.exitReasonerMode ?? "off"})`);
+        console.log(`  ${source_default.gray("Exit preset:")}   ${result.exitStyle ?? "balanced"} / ${result.exitTimingPolicy?.timeframe ?? "swing"}`);
         console.log(`  ${source_default.gray("Interval:")}  ${formatInterval2(result.scanIntervalMs)}`);
         console.log(`  ${source_default.gray("Next scan:")} ${formatShortDate5(result.nextScanAt)}`);
         console.log("");
@@ -28376,7 +28615,8 @@ function registerAgentCommand(program2) {
       if (a.decideModel)
         console.log(`  ${source_default.gray("Decide model:")}    ${a.decideModel}`);
       console.log(`  ${source_default.gray("Shared scan cache:")} ${a.disableSharedScanCache ? source_default.yellow("bypassed") : source_default.dim("enabled")}`);
-      console.log(`  ${source_default.gray("Exit reasoner:")}   ${a.exitReasonerEnabled ? source_default.green("enabled") : source_default.dim("disabled")}`);
+      console.log(`  ${source_default.gray("Exit reasoner:")}   ${a.exitReasonerEnabled ? source_default.green("enabled") : source_default.dim("disabled")} (${a.exitReasonerMode ?? "off"})`);
+      console.log(`  ${source_default.gray("Exit preset:")}     ${a.exitStyle ?? "balanced"} / ${a.exitTimingPolicy?.timeframe ?? "swing"}`);
       console.log(`  ${source_default.gray("Scan interval:")}   ${formatInterval2(a.scanIntervalMs)}`);
       console.log(`  ${source_default.gray("Max daily trades:")} ${a.maxDailyTrades}`);
       console.log(`  ${source_default.gray("Max daily loss:")}  $${a.maxDailyLossUsd}`);
@@ -28500,7 +28740,7 @@ function registerAgentCommand(program2) {
       handleApiError(error2, "Position exit failed", logger30);
     }
   });
-  agent.command("update <agentId>").description("Update agent config").option("--name <name>", "Agent name").option("--autonomy <level>", AUTONOMY_HELP_UPDATE).option("--scan-interval <ms>", "Scan interval in raw milliseconds (e.g. 300000 = 5m)").option("--scan-interval-human <duration>", "Scan interval in human-readable format (e.g. 1m, 5m, 15m, 30m, 1h). Overrides --scan-interval").option("--watchlist <symbols>", "Comma-separated token symbols").option("--max-daily-trades <n>", "Max daily trades").option("--max-daily-loss <usd>", "Max daily loss in USD").option("--max-position-size <pct>", "Max position size as decimal").option("--min-confidence <n>", MIN_CONFIDENCE_HELP).option("--scan-model <model>", "LLM model for market scanning").option("--analyze-model <model>", "LLM model for deep analysis").option("--decide-model <model>", "LLM model for trade decisions").option("--disable-shared-scan-cache", SHARED_SCAN_CACHE_INTERNAL_HELP).option("--enable-shared-scan-cache", ENABLE_SHARED_SCAN_CACHE_HELP).addOption(new Option("--asset-class <class>", "Asset class for this agent").choices(["crypto", "commodities", "mixed"])).option("--soul-override <text>", "Custom soul/personality for this agent").option("--purpose-override <text>", "Custom purpose/mission for this agent").option("--soul-file <path>", "Load soul from a file").option("--purpose-file <path>", "Load purpose from a file").option("--exit-reasoner", EXIT_REASONER_HELP).option("--disable-exit-reasoner", DISABLE_EXIT_REASONER_HELP).addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (agentId, options) => {
+  agent.command("update <agentId>").description("Update agent config").option("--name <name>", "Agent name").option("--autonomy <level>", AUTONOMY_HELP_UPDATE).option("--scan-interval <ms>", "Scan interval in raw milliseconds (e.g. 300000 = 5m)").option("--scan-interval-human <duration>", "Scan interval in human-readable format (e.g. 1m, 5m, 15m, 30m, 1h). Overrides --scan-interval").option("--watchlist <symbols>", "Comma-separated token symbols").option("--max-daily-trades <n>", "Max daily trades").option("--max-daily-loss <usd>", "Max daily loss in USD").option("--max-position-size <pct>", "Max position size as decimal").option("--min-confidence <n>", MIN_CONFIDENCE_HELP).option("--scan-model <model>", "LLM model for market scanning").option("--analyze-model <model>", "LLM model for deep analysis").option("--decide-model <model>", "LLM model for trade decisions").option("--disable-shared-scan-cache", SHARED_SCAN_CACHE_INTERNAL_HELP).option("--enable-shared-scan-cache", ENABLE_SHARED_SCAN_CACHE_HELP).addOption(new Option("--asset-class <class>", "Asset class for this agent").choices(["crypto", "commodities", "mixed"])).option("--soul-override <text>", "Custom soul/personality for this agent").option("--purpose-override <text>", "Custom purpose/mission for this agent").option("--soul-file <path>", "Load soul from a file").option("--purpose-file <path>", "Load purpose from a file").option("--exit-reasoner", EXIT_REASONER_HELP).option("--disable-exit-reasoner", DISABLE_EXIT_REASONER_HELP).addOption(new Option("--exit-reasoner-mode <mode>", EXIT_REASONER_MODE_HELP).choices([...EXIT_REASONER_MODES])).addOption(new Option("--urgent-event-exit-mode <mode>", URGENT_EVENT_EXIT_MODE_HELP).choices([...EXIT_REASONER_MODES])).addOption(new Option("--exit-style <style>", "Exit management preset").choices([...EXIT_STYLES])).addOption(new Option("--exit-timeframe <timeframe>", "Strategy exit timing preset").choices([...EXIT_TIMEFRAMES])).addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (agentId, options) => {
     if (!await ensureRemote())
       return;
     const body = {};
@@ -28558,6 +28798,14 @@ function registerAgentCommand(program2) {
       body.exitReasonerEnabled = true;
     if (options.disableExitReasoner)
       body.exitReasonerEnabled = false;
+    if (options.exitReasonerMode)
+      body.exitReasonerMode = options.exitReasonerMode;
+    if (options.urgentEventExitMode)
+      body.urgentEventExitReviewMode = options.urgentEventExitMode;
+    if (options.exitStyle)
+      body.exitStyle = options.exitStyle;
+    if (options.exitTimeframe)
+      body.exitTimingPolicy = { timeframe: options.exitTimeframe };
     if (options.assetClass)
       body.assetClass = options.assetClass;
     if (options.soulFile) {
@@ -28603,6 +28851,417 @@ function registerAgentCommand(program2) {
   });
 }
 
+// dist/commands/prediction-market-paper.js
+init_source();
+init_api_client();
+init_utils();
+var PREDICTION_MARKET_PAPER_RESULTS_CLI_FLAG = "PREDICTION_MARKET_PAPER_RESULTS_CLI_ENABLED";
+var DEFAULT_PAPER_POSITION_LIMIT = 50;
+var MAX_PAPER_POSITION_LIMIT = 100;
+var MAX_PAPER_POSITION_OFFSET = 1e4;
+var SAFE_IDENTIFIER_PATTERN = /^[A-Za-z0-9_.:@-]+$/;
+var PAPER_POSITION_STATUSES = [
+  "OPEN",
+  "CLOSING",
+  "CLOSED",
+  "EXPIRED",
+  "RESOLVED_WON",
+  "RESOLVED_LOST",
+  "INVALID",
+  "CANCELED",
+  "SETTLED"
+];
+function isPredictionMarketPaperCliEnabled(env2 = process.env) {
+  return env2[PREDICTION_MARKET_PAPER_RESULTS_CLI_FLAG] === "true";
+}
+function printDisabled(format2) {
+  const payload = {
+    disabled: true,
+    featureFlag: PREDICTION_MARKET_PAPER_RESULTS_CLI_FLAG,
+    mode: "paper",
+    label: "Paper / Simulated",
+    noVenueOrderPlaced: true,
+    message: "Prediction-market paper result inspection is disabled."
+  };
+  if (format2 === "json") {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+  console.log(source_default.yellow("Prediction-market paper result inspection is disabled."));
+  console.log(source_default.dim("Paper / Simulated. No venue order placed. Read-only inspection is unavailable in this CLI environment."));
+}
+function validateIdentifier(label, value) {
+  if (!value)
+    return null;
+  if (value.length > 300)
+    return `${label} must be 300 characters or fewer.`;
+  if (!SAFE_IDENTIFIER_PATTERN.test(value)) {
+    return `${label} may contain only letters, numbers, underscore, dot, colon, at, or dash.`;
+  }
+  return null;
+}
+function parseTimestamp(label, value) {
+  if (!value)
+    return { value: null, error: null };
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    return { value: null, error: `${label} must be a valid timestamp.` };
+  }
+  return { value: parsed.toISOString(), error: null };
+}
+function parseIntegerOption(label, value, fallback, min, max) {
+  if (value == null)
+    return { value: fallback, error: null };
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed)) {
+    return { value: fallback, error: `${label} must be an integer.` };
+  }
+  if (parsed < min || parsed > max) {
+    return { value: fallback, error: `${label} must be between ${min} and ${max}.` };
+  }
+  return { value: parsed, error: null };
+}
+function validateWindow(from, to) {
+  if (!from || !to)
+    return null;
+  return new Date(from) < new Date(to) ? null : "--from must be before --to.";
+}
+function printValidationError(message) {
+  console.error(source_default.red(`Error: ${message}`));
+  process.exitCode = 1;
+}
+function buildQuery(options, includePagination) {
+  for (const [label, value] of [
+    ["--agent", options.agent],
+    ["--venue", options.venue],
+    ["--market-id", options.marketId],
+    ["--instrument-key", options.instrumentKey]
+  ]) {
+    const error2 = validateIdentifier(label, value);
+    if (error2) {
+      printValidationError(error2);
+      return null;
+    }
+  }
+  const from = parseTimestamp("--from", options.from);
+  if (from.error) {
+    printValidationError(from.error);
+    return null;
+  }
+  const to = parseTimestamp("--to", options.to);
+  if (to.error) {
+    printValidationError(to.error);
+    return null;
+  }
+  const windowError = validateWindow(from.value, to.value);
+  if (windowError) {
+    printValidationError(windowError);
+    return null;
+  }
+  const params = new URLSearchParams();
+  if (options.agent)
+    params.set("agentId", options.agent);
+  if ("status" in options && options.status)
+    params.set("status", options.status);
+  if (options.venue)
+    params.set("venue", options.venue);
+  if (options.marketId)
+    params.set("marketId", options.marketId);
+  if (options.instrumentKey)
+    params.set("instrumentKey", options.instrumentKey);
+  if (from.value)
+    params.set("from", from.value);
+  if (to.value)
+    params.set("to", to.value);
+  if (includePagination) {
+    const queryOptions = options;
+    const limit = parseIntegerOption("--limit", queryOptions.limit, DEFAULT_PAPER_POSITION_LIMIT, 1, MAX_PAPER_POSITION_LIMIT);
+    if (limit.error) {
+      printValidationError(limit.error);
+      return null;
+    }
+    const offset = parseIntegerOption("--offset", queryOptions.offset, 0, 0, MAX_PAPER_POSITION_OFFSET);
+    if (offset.error) {
+      printValidationError(offset.error);
+      return null;
+    }
+    params.set("limit", String(limit.value));
+    params.set("offset", String(offset.value));
+  }
+  return params;
+}
+function withQuery(path3, params) {
+  const query = params.toString();
+  return query ? `${path3}?${query}` : path3;
+}
+function formatUsd6(value) {
+  if (value == null || !Number.isFinite(value))
+    return source_default.dim("-");
+  return `$${value.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+}
+function formatSignedUsd(value) {
+  if (value == null || !Number.isFinite(value))
+    return source_default.dim("-");
+  const formatted = formatUsd6(Math.abs(value));
+  if (value > 0)
+    return source_default.green(`+${formatted}`);
+  if (value < 0)
+    return source_default.red(`-${formatted}`);
+  return formatted;
+}
+function formatProbability(value) {
+  if (value == null || !Number.isFinite(value))
+    return source_default.dim("-");
+  return `${(value * 100).toFixed(1)}%`;
+}
+function formatQuantity(value) {
+  if (value == null || !Number.isFinite(value))
+    return source_default.dim("-");
+  return value.toLocaleString("en-US", { maximumFractionDigits: 4 });
+}
+function formatTimestamp(value) {
+  if (!value)
+    return source_default.dim("-");
+  try {
+    return new Date(value).toISOString().slice(0, 19).replace("T", " ");
+  } catch {
+    return value;
+  }
+}
+function latestLifecycleTime(position) {
+  return position.closedAt ?? position.settledAt ?? position.resolvedAt ?? position.lastMonitoredAt ?? position.latestSnapshotAt ?? null;
+}
+function formatPaperSummary(summary) {
+  const lines = [];
+  lines.push("");
+  lines.push(source_default.bold.cyan("  Prediction Market Paper Results"));
+  lines.push(source_default.gray("  Paper / Simulated"));
+  lines.push(source_default.gray("  No venue order placed"));
+  lines.push(source_default.gray("  Read-only inspection"));
+  lines.push(source_default.gray("  " + "-".repeat(52)));
+  lines.push(`  ${source_default.gray("Open positions:")}       ${summary.openPositions}`);
+  lines.push(`  ${source_default.gray("Closed positions:")}     ${summary.closedPositions}`);
+  lines.push(`  ${source_default.gray("Resolved won:")}         ${summary.resolvedWon}`);
+  lines.push(`  ${source_default.gray("Resolved lost:")}        ${summary.resolvedLost}`);
+  lines.push(`  ${source_default.gray("Invalid / canceled:")}   ${summary.invalidOrCanceled}`);
+  lines.push(`  ${source_default.gray("Total notional:")}       ${formatUsd6(summary.totalNotionalUsd)}`);
+  lines.push(`  ${source_default.gray("Realized PnL:")}         ${formatSignedUsd(summary.realizedPnlUsd)}`);
+  lines.push(`  ${source_default.gray("Unrealized PnL:")}       ${formatSignedUsd(summary.unrealizedPnlUsd)}`);
+  lines.push(`  ${source_default.gray("Last updated:")}         ${formatTimestamp(summary.lastUpdatedAt)}`);
+  lines.push("");
+  return lines.join("\n");
+}
+function formatPaperPositions(positions) {
+  const lines = [];
+  lines.push("");
+  lines.push(source_default.bold.cyan("  Prediction Market Paper Positions"));
+  lines.push(source_default.gray("  Paper / Simulated"));
+  lines.push(source_default.gray("  No venue order placed"));
+  lines.push(source_default.gray("  Read-only inspection"));
+  lines.push(source_default.gray("  " + "-".repeat(132)));
+  if (positions.length === 0) {
+    lines.push(`  ${source_default.dim("No paper prediction-market positions found.")}`);
+    lines.push(`  ${source_default.dim("Paper PM results appear only after paper runtime and paper writes are enabled.")}`);
+    lines.push("");
+    return lines.join("\n");
+  }
+  lines.push(`  ${source_default.gray("Position".padEnd(14))}${source_default.gray("Agent".padEnd(14))}${source_default.gray("Venue".padEnd(12))}${source_default.gray("Outcome".padEnd(10))}${source_default.gray("Side".padEnd(10))}${source_default.gray("Qty".padStart(10))}${source_default.gray("Entry".padStart(10))}${source_default.gray("Mark".padStart(10))}${source_default.gray("Notional".padStart(12))}${source_default.gray("Realized".padStart(12))}${source_default.gray("Unrealized".padStart(12))}${source_default.gray("Status".padStart(14))}`);
+  lines.push(source_default.gray("  " + "-".repeat(132)));
+  for (const position of positions) {
+    lines.push(`  ${truncate(position.positionId, 13).padEnd(14)}${truncate(position.agentId ?? "-", 13).padEnd(14)}${truncate(position.venue ?? "-", 11).padEnd(12)}${truncate(position.outcomeSide ?? "-", 9).padEnd(10)}${truncate(position.positionSide, 9).padEnd(10)}${formatQuantity(position.quantity).padStart(10)}${formatProbability(position.averageEntryPrice).padStart(10)}${formatProbability(position.markPrice).padStart(10)}${formatUsd6(position.notionalUsd).padStart(12)}${formatSignedUsd(position.realizedPnlUsd).padStart(12)}${formatSignedUsd(position.unrealizedPnlUsd).padStart(12)}${truncate(position.status, 13).padStart(14)}`);
+    lines.push(`  ${source_default.dim("Market:")} ${truncate(position.marketQuestion ?? position.marketId ?? position.instrumentKey, 92)} ${source_default.dim("Opened:")} ${formatTimestamp(position.openedAt)} ${source_default.dim("Latest:")} ${formatTimestamp(latestLifecycleTime(position))} ` + source_default.dim("paper / no venue order placed"));
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function formatPaperPositionDetail(position) {
+  const lines = [];
+  lines.push("");
+  lines.push(source_default.bold.cyan(`  Prediction Market Paper Position - ${position.positionId}`));
+  lines.push(source_default.gray("  Paper / Simulated"));
+  lines.push(source_default.gray("  No venue order placed"));
+  lines.push(source_default.gray("  Read-only inspection"));
+  lines.push(source_default.gray("  " + "-".repeat(68)));
+  lines.push(`  ${source_default.gray("Agent:")}              ${position.agentId ?? "-"}`);
+  lines.push(`  ${source_default.gray("Trader:")}             ${position.traderId ?? "-"}`);
+  lines.push(`  ${source_default.gray("Instrument key:")}     ${position.instrumentKey}`);
+  lines.push(`  ${source_default.gray("Instrument type:")}    ${position.instrumentType}`);
+  lines.push(`  ${source_default.gray("Venue:")}              ${position.venue ?? "-"}`);
+  lines.push(`  ${source_default.gray("Market ID:")}          ${position.marketId ?? "-"}`);
+  lines.push(`  ${source_default.gray("Market question:")}    ${position.marketQuestion ?? "-"}`);
+  lines.push(`  ${source_default.gray("Outcome side:")}       ${position.outcomeSide ?? "-"}`);
+  lines.push(`  ${source_default.gray("Position side:")}      ${position.positionSide}`);
+  lines.push(`  ${source_default.gray("Quantity:")}           ${formatQuantity(position.quantity)}`);
+  lines.push(`  ${source_default.gray("Average entry:")}      ${formatProbability(position.averageEntryPrice)}`);
+  lines.push(`  ${source_default.gray("Mark:")}               ${formatProbability(position.markPrice)}`);
+  lines.push(`  ${source_default.gray("Notional USD:")}       ${formatUsd6(position.notionalUsd)}`);
+  lines.push(`  ${source_default.gray("Realized PnL:")}       ${formatSignedUsd(position.realizedPnlUsd)}`);
+  lines.push(`  ${source_default.gray("Unrealized PnL:")}     ${formatSignedUsd(position.unrealizedPnlUsd)}`);
+  lines.push(`  ${source_default.gray("Status:")}             ${position.status}`);
+  lines.push(`  ${source_default.gray("Opened:")}             ${formatTimestamp(position.openedAt)}`);
+  lines.push(`  ${source_default.gray("Closed:")}             ${formatTimestamp(position.closedAt)}`);
+  lines.push(`  ${source_default.gray("Expiry:")}             ${formatTimestamp(position.expiryAt)}`);
+  lines.push(`  ${source_default.gray("Resolved:")}           ${formatTimestamp(position.resolvedAt)}`);
+  lines.push(`  ${source_default.gray("Settled:")}            ${formatTimestamp(position.settledAt)}`);
+  lines.push(`  ${source_default.gray("Settlement ID:")}      ${position.settlementId ?? "-"}`);
+  lines.push(`  ${source_default.gray("Execution mode:")}     ${position.executionMode}`);
+  lines.push(`  ${source_default.gray("Source:")}             ${position.source}`);
+  lines.push(`  ${source_default.gray("No venue order:")}     ${String(position.noVenueOrderPlaced)}`);
+  lines.push("");
+  return lines.join("\n");
+}
+async function readSummary(options) {
+  const query = buildQuery(options, false);
+  if (!query)
+    return null;
+  const path3 = withQuery("/api/v1/prediction-market-paper/summary", query);
+  return apiRequest(path3);
+}
+async function readPositions(options) {
+  const query = buildQuery(options, true);
+  if (!query)
+    return null;
+  const path3 = withQuery("/api/v1/prediction-market-paper/positions", query);
+  return apiRequest(path3);
+}
+async function readAgentSummary(agentId, options) {
+  const idError = validateIdentifier("agentId", agentId);
+  if (idError) {
+    printValidationError(idError);
+    return null;
+  }
+  const query = buildQuery({ ...options, agent: void 0 }, false);
+  if (!query)
+    return null;
+  const path3 = withQuery(`/api/v1/agents/${encodeURIComponent(agentId)}/prediction-market-paper/summary`, query);
+  return apiRequest(path3);
+}
+async function readAgentPositions(agentId, options) {
+  const idError = validateIdentifier("agentId", agentId);
+  if (idError) {
+    printValidationError(idError);
+    return null;
+  }
+  const query = buildQuery({ ...options, agent: void 0 }, true);
+  if (!query)
+    return null;
+  const path3 = withQuery(`/api/v1/agents/${encodeURIComponent(agentId)}/prediction-market-paper/positions`, query);
+  return apiRequest(path3);
+}
+async function readPosition(positionId) {
+  const idError = validateIdentifier("positionId", positionId);
+  if (idError) {
+    printValidationError(idError);
+    return null;
+  }
+  return apiRequest(`/api/v1/prediction-market-paper/positions/${encodeURIComponent(positionId)}`);
+}
+function isBackendDisabled(error2) {
+  if (!(error2 instanceof ApiError))
+    return false;
+  const body = error2.body;
+  return error2.status === 404 && (error2.message.toLowerCase().includes("paper result reads are disabled") || typeof body === "object" && body !== null && body.code === "PREDICTION_MARKET_PAPER_RESULTS_READ_DISABLED");
+}
+function handlePaperError(error2, format2) {
+  if (isBackendDisabled(error2)) {
+    const payload = {
+      disabled: true,
+      mode: "paper",
+      label: "Paper / Simulated",
+      noVenueOrderPlaced: true,
+      message: "Prediction-market paper result reads are disabled by the API."
+    };
+    if (format2 === "json") {
+      console.log(JSON.stringify(payload, null, 2));
+    } else {
+      console.log(source_default.yellow("Prediction-market paper result reads are disabled by the API."));
+      console.log(source_default.dim("Paper / Simulated. No venue order placed. Read-only inspection only."));
+    }
+    return;
+  }
+  const message = error2 instanceof Error ? error2.message : String(error2);
+  console.error(source_default.red(`Error: ${message}`));
+  process.exitCode = error2 instanceof ApiError ? 2 : 1;
+}
+async function runReadAction(format2, action) {
+  if (!isPredictionMarketPaperCliEnabled()) {
+    printDisabled(format2);
+    return;
+  }
+  if (!await ensureRemote())
+    return;
+  try {
+    await action();
+  } catch (error2) {
+    handlePaperError(error2, format2);
+  }
+}
+function registerPredictionMarketPaperCommand(program2) {
+  const command = program2.command("prediction-market-paper").alias("pm-paper").description("Inspect paper prediction-market positions and results");
+  const addSummaryFilters = (cmd) => cmd.option("--agent <agentId>", "Optional agent ID filter").option("--venue <venue>", "Venue filter").option("--market-id <marketId>", "Prediction-market ID filter").option("--instrument-key <instrumentKey>", "Instrument key filter").option("--from <timestamp>", "Opened-at window start").option("--to <timestamp>", "Opened-at window end").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text"));
+  const addPositionFilters = (cmd) => addSummaryFilters(cmd).addOption(new Option("--status <status>", "Position status filter").choices([...PAPER_POSITION_STATUSES])).option("--limit <n>", `Maximum rows, 1-${MAX_PAPER_POSITION_LIMIT}`, String(DEFAULT_PAPER_POSITION_LIMIT)).option("--offset <n>", `Rows to skip, 0-${MAX_PAPER_POSITION_OFFSET}`, "0");
+  addSummaryFilters(command.command("summary").description("Show read-only paper prediction-market result summary")).action(async (options) => {
+    await runReadAction(options.format, async () => {
+      const data = await readSummary(options);
+      if (!data)
+        return;
+      if (options.format === "json") {
+        console.log(JSON.stringify(data, null, 2));
+      } else {
+        console.log(formatPaperSummary(data.summary));
+      }
+    });
+  });
+  addPositionFilters(command.command("positions").description("List read-only paper prediction-market positions")).action(async (options) => {
+    await runReadAction(options.format, async () => {
+      const data = await readPositions(options);
+      if (!data)
+        return;
+      if (options.format === "json") {
+        console.log(JSON.stringify(data, null, 2));
+      } else {
+        console.log(formatPaperPositions(data.positions));
+      }
+    });
+  });
+  command.command("position").description("Show one read-only paper prediction-market position").argument("<positionId>", "Paper prediction-market position ID").addOption(new Option("--format <format>", "Output format").choices(["text", "json"]).default("text")).action(async (positionId, options) => {
+    await runReadAction(options.format, async () => {
+      const data = await readPosition(positionId);
+      if (!data)
+        return;
+      if (options.format === "json") {
+        console.log(JSON.stringify(data, null, 2));
+      } else {
+        console.log(formatPaperPositionDetail(data.position));
+      }
+    });
+  });
+  addSummaryFilters(command.command("agent-summary").description("Show read-only paper prediction-market result summary for one agent").argument("<agentId>", "Agent ID")).action(async (agentId, options) => {
+    await runReadAction(options.format, async () => {
+      const data = await readAgentSummary(agentId, options);
+      if (!data)
+        return;
+      if (options.format === "json") {
+        console.log(JSON.stringify(data, null, 2));
+      } else {
+        console.log(formatPaperSummary(data.summary));
+      }
+    });
+  });
+  addPositionFilters(command.command("agent-positions").description("List read-only paper prediction-market positions for one agent").argument("<agentId>", "Agent ID")).action(async (agentId, options) => {
+    await runReadAction(options.format, async () => {
+      const data = await readAgentPositions(agentId, options);
+      if (!data)
+        return;
+      if (options.format === "json") {
+        console.log(JSON.stringify(data, null, 2));
+      } else {
+        console.log(formatPaperPositions(data.positions));
+      }
+    });
+  });
+}
+
 // dist/cli.js
 import { readFileSync as readFileSync5 } from "node:fs";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
@@ -28654,6 +29313,7 @@ function createCli() {
   registerSuggestionsCommand(program2);
   registerCronCommand(program2);
   registerAgentCommand(program2);
+  registerPredictionMarketPaperCommand(program2);
   registerConfigCommand(program2);
   const GROUPS = {
     "Core": ["context", "query", "watch"],
@@ -28662,7 +29322,7 @@ function createCli() {
     "Edge & Safety": ["edge", "edge-guard", "coaching", "thesis"],
     "Strategy & Benchmarking": ["strategy", "replay", "benchmark", "suggestions"],
     "Scheduling": ["cron"],
-    "Agents": ["agent"],
+    "Agents": ["agent", "prediction-market-paper"],
     "Account": ["login", "logout", "whoami", "billing", "subscribe", "rotate-key", "forgot-key", "connect-chatgpt", "config"]
   };
   program2.addHelpText("before", "");