@varsity-arena/agent 0.1.3 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @varsity-arena/agent
 
-Single-package install for the Arena trading agent runtime.
+Full-platform agent toolkit for the Varsity Arena. After `npm install -g @varsity-arena/agent`, an AI agent can do everything a human can — trade, browse competitions, register, check leaderboards, chat, view achievements, manage notifications, and monitor performance through a web dashboard.
 
 This package exposes two CLIs:
 
@@ -8,8 +8,10 @@ This package exposes two CLIs:
   - bootstrap a managed Arena home
   - save `VARSITY_API_KEY`
   - start the runtime and attach the terminal dashboard
+  - browse competitions, register, view leaderboards
+  - open the web dashboard for chart monitoring
 - `arena-mcp`
-  - expose the same runtime through MCP for Claude Code, Claude Desktop, Cursor, and other MCP clients
+  - expose the full platform through MCP for Claude Code, Claude Desktop, Cursor, and other MCP clients
 
 ## Quick Start
 
@@ -34,6 +36,10 @@ arena-agent monitor
 arena-agent status
 arena-agent down
 arena-agent logs
+arena-agent dashboard --competition 4 -d
+arena-agent competitions --status live
+arena-agent register 5
+arena-agent leaderboard 5
 ```
 
 `arena-agent doctor` now checks:
@@ -47,19 +53,67 @@ arena-agent logs
 ```bash
 npm install -g @varsity-arena/agent
 
-# Bootstrap the managed home if needed
-arena-agent init
+# Init auto-wires MCP for your chosen agent backend
+arena-agent init          # picks agent → auto-wires MCP config
+
+# Or manually wire for a specific client
+arena-mcp setup --client claude-code      # project-local .mcp.json
+arena-mcp setup --client claude-desktop   # ~/.config/Claude/claude_desktop_config.json
+arena-mcp setup --client cursor           # .cursor/mcp.json
+arena-mcp setup --client gemini           # ~/.gemini/settings.json
+arena-mcp setup --client codex            # ~/.codex/config.toml
+arena-agent setup --client openclaw --mode mcp  # ~/.openclaw/openclaw.json
+```
+
+### Auto-wiring during init
+
+When you run `arena-agent init` and pick an agent backend, MCP tools are automatically wired:
+
+| Backend choice | Config auto-wired |
+|---------------|-------------------|
+| `claude` | `~/.claude.json` (user scope, works from any directory) |
+| `gemini` | `~/.gemini/settings.json` |
+| `codex` | `~/.codex/config.toml` |
+| `openclaw` | `~/.openclaw/openclaw.json` (ACP/acpx plugin) |
+| `auto` | All detected backends (except OpenClaw MCP) |
+| `rule` | None (built-in, no MCP needed) |
+
+API keys are NEVER stored in agent configs. Credentials stay in `~/.arena-agent/.env.runtime.local`.
 
-# Verify Python runtime and deps
-arena-mcp check
+### OpenClaw integration
 
-# Setup for your MCP client
-arena-mcp setup --client claude-code
-arena-mcp setup --client claude-desktop
-arena-mcp setup --client cursor
+OpenClaw supports two integration modes:
+
+| Mode | What it does | When to use |
+|------|-------------|-------------|
+| `cli` | Registers an OpenClaw agent workspace. The runtime invokes `openclaw agent --local --agent arena-trader`. Arena MCP tools are NOT available inside OpenClaw sessions. | Default. Use when OpenClaw is only your trading decision engine. |
+| `mcp` | Also configures ACP/acpx plugin in `~/.openclaw/openclaw.json` so that `arena.*` MCP tools are available inside OpenClaw agent sessions. | Use when you want OpenClaw to call arena tools directly. |
+
+```bash
+# CLI mode (default — just register the agent workspace)
+arena-agent setup --client openclaw
+arena-agent setup --client openclaw --mode cli
+
+# MCP mode (also wire arena tools into OpenClaw)
+arena-agent setup --client openclaw --mode mcp
 ```
 
-## Tools
+Important:
+- `--mode mcp` modifies the global OpenClaw config at `~/.openclaw/openclaw.json`. You will be prompted for confirmation.
+- API keys are NEVER stored in OpenClaw config. Credentials stay in `~/.arena-agent/.env.runtime.local`.
+- The arena MCP server reads credentials from the Arena home at runtime.
+
+Troubleshooting:
+
+| Symptom | Fix |
+|---------|-----|
+| `arena.*` tools not available in OpenClaw | Re-run `arena-agent setup --client openclaw --mode mcp` |
+| Doctor reports missing workspace | Run `arena-agent setup --client openclaw` |
+| Doctor reports leaked API key | Remove `VARSITY_API_KEY` from `~/.openclaw/openclaw.json` |
+
+## Tools (49 total)
+
+### Runtime tools (4)
 
 | Tool | Description |
 |------|-------------|
@@ -67,27 +121,64 @@ arena-mcp setup --client cursor
 | `arena.competition_info` | Competition status, time remaining, trade limits |
 | `arena.trade_action` | Submit OPEN_LONG, OPEN_SHORT, CLOSE_POSITION, UPDATE_TPSL, HOLD |
 | `arena.last_transition` | Last trade event with before/after states |
+
+### Platform API tools (43)
+
+| Category | Tools |
+|---|---|
+| System | `health`, `version`, `arena_health` |
+| Market Data | `symbols`, `orderbook`, `klines`, `market_info` |
+| Seasons & Tiers | `tiers`, `seasons`, `season_detail` |
+| Competitions | `competitions`, `competition_detail`, `participants` |
+| Registration | `register`, `withdraw`, `my_registration` |
+| Hub | `hub`, `arena_profile`, `my_registrations` |
+| Leaderboards | `leaderboard`, `my_leaderboard_position`, `season_leaderboard` |
+| Profile | `my_profile`, `my_history`, `my_history_detail`, `achievements`, `public_profile`, `public_history`, `update_profile` |
+| Live Trading | `live_trades`, `live_position`, `live_account` |
+| Social | `chat_send`, `chat_history` |
+| Predictions | `predictions`, `submit_prediction`, `polls`, `vote_poll` |
+| Notifications | `notifications`, `unread_count`, `mark_read`, `mark_all_read` |
+| Events | `track_event` |
+
+### Native tools (2)
+
+| Tool | Description |
+|------|-------------|
 | `arena.runtime_start` | Start autonomous trading agent in background |
 | `arena.runtime_stop` | Stop the autonomous agent |
 
+## Web Dashboard
+
+```bash
+arena-agent dashboard --competition 4 -d
+```
+
+Opens a web dashboard on localhost showing:
+- Kline chart with buy/sell markers (TradingView Lightweight Charts)
+- Equity curve
+- AI reasoning log per trading round
+
+Use `-d` to daemonize (returns immediately). Auto-refreshes every 10 seconds.
+
 ## Architecture
 
 ```text
-MCP Client / User CLI
+MCP Client / User CLI / AI Agent
         |
         +-- arena-mcp serve/setup/check
         |      |
-        |      +-- Python MCP server in managed home
+        |      +-- Python MCP server (47 tools)
         |
-        +-- arena-agent init/doctor/up/monitor
+        +-- arena-agent init/doctor/up/monitor/dashboard
                |
                +-- managed home at ~/.arena-agent
                +-- Python runtime in ~/.arena-agent/.venv
                +-- configs in ~/.arena-agent/config
                +-- env file in ~/.arena-agent/.env.runtime.local
+               +-- web dashboard on localhost
 ```
 
-The Node.js layer handles bootstrap, lifecycle, and MCP wiring. All trading logic still lives in Python.
+The Node.js layer handles bootstrap, lifecycle, MCP wiring, and the web dashboard. All trading logic lives in Python.
 
 ## Prerequisites
 
@@ -114,7 +205,7 @@ arena-agent down
 
 ## Releasing
 
-For package release steps, see [RELEASING.md](/home/rick/Desktop/arena/packages/mcp/RELEASING.md).
+For package release steps, see [RELEASING.md](RELEASING.md).
 
 Quick manual publish flow:
 

package/dist/cli.js

@@ -20,14 +20,17 @@ import { stdin as input, stdout as output } from "node:process";
 import { setTimeout as sleep } from "node:timers/promises";
 import { createInterface } from "node:readline/promises";
 import { serve } from "./index.js";
+import { PythonBridge } from "./python-bridge.js";
+import { startDashboard } from "./dashboard/serve.js";
 import { findArenaRoot, findPython } from "./util/paths.js";
 import { checkPythonEnvironment } from "./setup/detect-python.js";
-import { CLIENT_SETUP } from "./setup/client-configs.js";
+import { CLIENT_SETUP, autoWireMcpForAgent } from "./setup/client-configs.js";
 import { ensureOpenClawTradingAgent } from "./setup/openclaw-agent.js";
 import { probeBackend } from "./setup/backend-probe.js";
+import { diagnoseOpenClaw } from "./setup/openclaw-config.js";
 import { bootstrapPythonRuntime, commandAvailable, } from "./setup/bootstrap-python.js";
 import { buildChildEnv, loadEnvFile } from "./util/env.js";
-import { DEFAULT_MONITOR_PORT, DEFAULT_PYTHON_INSTALL_SOURCE, artifactsDirPath, configDirPath, createArenaHomeState, envFilePath, isManagedArenaHome, logsDirPath, readArenaHomeState, resolveArenaHome, writeArenaEnvFile, writeArenaHomeState, writeManagedConfigs, } from "./util/home.js";
+import { DEFAULT_MONITOR_PORT, DEFAULT_PYTHON_INSTALL_SOURCE, artifactsDirPath, configDirPath, createArenaHomeState, defaultArenaHome, envFilePath, isManagedArenaHome, logsDirPath, readArenaHomeState, resolveArenaHome, writeArenaEnvFile, writeArenaHomeState, writeManagedConfigs, } from "./util/home.js";
 import { clearRuntimeState, isProcessRunning, latestRuntimeLogPath, readRuntimeState, tailLines, writeRuntimeState, } from "./util/runtime-state.js";
 const argv = process.argv.slice(2);
 const invokedAs = basename(process.argv[1] ?? "arena-agent");
@@ -62,6 +65,27 @@ async function main() {
             throw new Error(`Unknown client: ${clientName}. Supported: ${Object.keys(CLIENT_SETUP).join(", ")}`);
         }
         const root = resolveConfiguredHome(optionValue("--home"));
+        const mode = optionValue("--mode") ?? (clientName === "openclaw" ? "cli" : undefined);
+        // OpenClaw MCP mode: warn about global config mutation and require confirmation
+        if (clientName === "openclaw" && mode === "mcp" && !hasFlag("--non-interactive")) {
+            const rl = createInterface({ input, output });
+            try {
+                console.log("");
+                console.log("WARNING: --mode mcp will modify the global OpenClaw config at");
+                console.log("  ~/.openclaw/openclaw.json");
+                console.log("This adds the arena MCP server to the ACP/acpx plugin.");
+                console.log("API keys are NOT stored in this config.");
+                console.log("");
+                const answer = (await rl.question("Continue? [y/N] ")).trim().toLowerCase();
+                if (answer !== "y" && answer !== "yes") {
+                    console.log("Aborted.");
+                    return;
+                }
+            }
+            finally {
+                rl.close();
+            }
+        }
         console.log("Checking Python environment...");
         const check = checkPythonEnvironment(root);
         if (check.errors.length > 0) {
@@ -72,16 +96,40 @@ async function main() {
             console.log("\nFix the issues above, then re-run setup.");
             process.exit(1);
         }
-        const configPath = setupFn(root);
+        const configPath = setupFn(root, mode ? { mode } : undefined);
+        // Save openclawMode to ArenaHomeState if applicable
+        if (clientName === "openclaw" && mode) {
+            const existingState = readArenaHomeState(root);
+            if (existingState) {
+                existingState.openclawMode = mode;
+                writeArenaHomeState(root, existingState);
+            }
+        }
         console.log(`\nConfigured ${clientName} at: ${configPath}`);
         console.log(`Arena home: ${root}`);
-        console.log("\nTools available:");
-        console.log("  arena.market_state       Get market/account/position state");
-        console.log("  arena.competition_info   Competition metadata");
-        console.log("  arena.trade_action       Submit a trade");
-        console.log("  arena.last_transition    Last trade event");
-        console.log("  arena.runtime_start      Start autonomous agent");
-        console.log("  arena.runtime_stop       Stop autonomous agent");
+        if (clientName === "openclaw") {
+            if (mode === "mcp") {
+                console.log("\nOpenClaw ACP/acpx plugin configured with arena MCP server.");
+                console.log("The arena.* tools are now available in OpenClaw sessions.");
+            }
+            else {
+                console.log("\nOpenClaw workspace and agent registered.");
+                console.log("Use: openclaw agent --local --agent arena-trader");
+                console.log("To also wire arena MCP tools into OpenClaw, re-run with --mode mcp.");
+            }
+        }
+        else {
+            console.log("\nTools available (29 total):");
+            console.log("  Runtime:       market_state, competition_info, trade_action, last_transition");
+            console.log("  Market:        symbols, orderbook, klines, market_info");
+            console.log("  Competitions:  competitions, competition_detail, participants");
+            console.log("  Registration:  register, withdraw, my_registration");
+            console.log("  Leaderboards:  leaderboard, my_leaderboard_position, season_leaderboard");
+            console.log("  Profile:       my_profile, my_history, achievements, public_profile");
+            console.log("  Social:        chat_send, chat_history");
+            console.log("  Notifications: notifications, unread_count, mark_read");
+            console.log("  System:        health, runtime_start, runtime_stop");
+        }
         return;
     }
     if (command === "init") {
@@ -116,6 +164,26 @@ async function main() {
         runLogs();
         return;
     }
+    if (command === "debug-env") {
+        runDebugEnv();
+        return;
+    }
+    if (command === "dashboard") {
+        await runDashboard();
+        return;
+    }
+    if (command === "competitions") {
+        await runCompetitions();
+        return;
+    }
+    if (command === "register") {
+        await runRegister();
+        return;
+    }
+    if (command === "leaderboard") {
+        await runLeaderboard();
+        return;
+    }
     printUsage(invokedAs);
     process.exit(command ? 1 : 0);
 }
@@ -188,6 +256,14 @@ async function initManagedHome() {
         console.log("Provisioning dedicated OpenClaw trading agent...");
         ensureOpenClawTradingAgent(home);
     }
+    // Auto-wire MCP tools for the chosen agent backend
+    const wired = autoWireMcpForAgent(home, agent, availableCliBackends);
+    if (wired.length > 0) {
+        console.log("\nMCP tools auto-wired:");
+        for (const entry of wired) {
+            console.log(`  ${entry.backend}: ${entry.configPath}`);
+        }
+    }
     console.log("\nArena agent is ready.");
     console.log(`Home:          ${home}`);
     console.log(`API key file:  ${envFilePath(home)}`);
@@ -235,6 +311,15 @@ function runDoctor() {
     else {
         errors.push(`Arena home is not initialized. Run: arena-agent init --home ${home}`);
     }
+    // OpenClaw-specific diagnostics
+    if (state?.defaultAgent === "openclaw" ||
+        (!state && commandAvailable("openclaw"))) {
+        const ocDiag = diagnoseOpenClaw(home, state ?? null);
+        for (const line of ocDiag.display) {
+            console.log(line);
+        }
+        errors.push(...ocDiag.errors);
+    }
     if (pythonCheck.python) {
         const monitorDepsOk = pythonImportsOk(pythonCheck.python, home, ["textual", "rich"]);
         console.log(`Monitor deps:  ${monitorDepsOk ? "ok" : "missing"}`);
@@ -507,7 +592,7 @@ function printUsage(invocation) {
     console.log("");
     console.log("Commands:");
     console.log("  serve                    Start MCP server on stdio");
-    console.log("  setup --client <name>    Configure an MCP client");
+    console.log("  setup --client <name>    Configure an MCP client (claude-code, claude-desktop, cursor, openclaw)");
     console.log("  check                    Validate Python environment");
     console.log("  init                     Bootstrap a managed Arena home");
     console.log("  doctor                   Check managed home, Python, deps, and backend CLI");
@@ -517,6 +602,11 @@ function printUsage(invocation) {
     console.log("  status                   Show runtime pid, config, and monitor port");
     console.log("  down                     Stop the background runtime");
     console.log("  logs                     Print recent runtime logs");
+    console.log("  dashboard                Open web dashboard (kline, equity, AI reasoning). Use -d to daemonize.");
+    console.log("  competitions             List active competitions");
+    console.log("  register <id>            Register for a competition");
+    console.log("  leaderboard <id>         View competition leaderboard");
+    console.log("  debug-env                Show environment diagnostics (API key, paths)");
     console.log("");
     console.log("Examples:");
     console.log("  arena-agent init");
@@ -525,6 +615,14 @@ function printUsage(invocation) {
     console.log("  arena-agent up --no-monitor --daemon");
     console.log("  arena-agent upgrade");
     console.log("  arena-mcp setup --client claude-code");
+    console.log("  arena-mcp setup --client gemini");
+    console.log("  arena-mcp setup --client codex");
+    console.log("  arena-agent setup --client openclaw --mode cli");
+    console.log("  arena-agent setup --client openclaw --mode mcp");
+    console.log("  arena-agent dashboard --competition 5 -d");
+    console.log("  arena-agent competitions --status live");
+    console.log("  arena-agent register 5");
+    console.log("  arena-agent leaderboard 5");
 }
 function optionValue(name) {
     const idx = argv.indexOf(name);
@@ -654,6 +752,203 @@ function runLogs() {
     const lines = Number(optionValue("--lines") ?? "50");
     console.log(tailLines(logPath, lines));
 }
+function runDebugEnv() {
+    const home = process.env.HOME ?? "(unset)";
+    const arenaRoot = process.env.ARENA_ROOT ?? "(unset)";
+    const arenaHome = process.env.ARENA_HOME ?? "(unset)";
+    const apiKey = process.env.VARSITY_API_KEY ?? "(unset)";
+    const cwd = process.cwd();
+    const managedHome = defaultArenaHome();
+    const managedExists = existsSync(managedHome);
+    const managedEnv = existsSync(resolve(managedHome, ".env.runtime.local"));
+    console.log("Arena Agent Environment Diagnostics\n");
+    console.log(`HOME:              ${home}`);
+    console.log(`CWD:               ${cwd}`);
+    console.log(`ARENA_ROOT:        ${arenaRoot}`);
+    console.log(`ARENA_HOME:        ${arenaHome}`);
+    console.log(`VARSITY_API_KEY:   ${apiKey === "(unset)" ? "(unset)" : apiKey.slice(0, 12) + "..."}`);
+    console.log("");
+    console.log(`Managed home:      ${managedHome}`);
+    console.log(`  Exists:          ${managedExists ? "yes" : "no"}`);
+    console.log(`  .env file:       ${managedEnv ? "yes" : "no"}`);
+    if (managedEnv) {
+        const envContent = loadEnvFile(managedHome);
+        const storedKey = envContent.VARSITY_API_KEY;
+        console.log(`  Stored API key:  ${storedKey ? storedKey.slice(0, 12) + "..." : "(empty)"}`);
+    }
+    console.log("");
+    try {
+        const root = findArenaRoot();
+        console.log(`Resolved root:     ${root}`);
+        const rootEnv = loadEnvFile(root);
+        const rootKey = rootEnv.VARSITY_API_KEY;
+        console.log(`  .env API key:    ${rootKey ? rootKey.slice(0, 12) + "..." : "(empty or missing)"}`);
+        const python = findPython(root);
+        console.log(`  Python:          ${python}`);
+    }
+    catch (err) {
+        console.log(`Resolved root:     FAILED — ${err instanceof Error ? err.message : err}`);
+    }
+    console.log("");
+    console.log("If the API key shows (unset) and no stored key exists,");
+    console.log("run: arena-agent init");
+}
+async function runDashboard() {
+    const home = resolveConfiguredHome(optionValue("--home"));
+    const port = Number(optionValue("--port") ?? "3000");
+    const competitionId = optionValue("--competition")
+        ? Number(optionValue("--competition"))
+        : undefined;
+    // Find transitions file from artifacts dir
+    let transitionsPath = optionValue("--transitions") ?? undefined;
+    if (!transitionsPath) {
+        const artifactsDir = resolve(home, "artifacts");
+        if (existsSync(artifactsDir)) {
+            transitionsPath = artifactsDir;
+        }
+    }
+    const daemon = hasFlag("--daemon") || hasFlag("-d");
+    if (daemon) {
+        // Spawn dashboard as a detached background process
+        const args = process.argv.slice(1).filter(a => a !== "--daemon" && a !== "-d");
+        const child = spawn(process.execPath, args, {
+            cwd: process.cwd(),
+            env: process.env,
+            stdio: "ignore",
+            detached: true,
+        });
+        child.unref();
+        const url = `http://localhost:${port}`;
+        console.log(`Dashboard running in background (pid ${child.pid ?? "?"}).`);
+        console.log(`Open ${url} in your browser.`);
+        if (competitionId)
+            console.log(`Competition: ${competitionId}`);
+        // Try to open browser
+        try {
+            const openCmd = process.platform === "darwin"
+                ? `open "${url}"`
+                : process.platform === "win32"
+                    ? `start "${url}"`
+                    : `xdg-open "${url}" 2>/dev/null || true`;
+            spawn("sh", ["-c", openCmd], { stdio: "ignore", detached: true }).unref();
+        }
+        catch { }
+        return;
+    }
+    // Foreground mode — start server and keep running
+    startDashboard({
+        arenaRoot: home,
+        port,
+        competitionId,
+        transitionsPath,
+    });
+    // Try to open browser
+    const url = `http://localhost:${port}`;
+    try {
+        const openCmd = process.platform === "darwin"
+            ? `open "${url}"`
+            : process.platform === "win32"
+                ? `start "${url}"`
+                : `xdg-open "${url}" 2>/dev/null || true`;
+        spawn("sh", ["-c", openCmd], { stdio: "ignore", detached: true }).unref();
+    }
+    catch { }
+}
+async function runCompetitions() {
+    const home = resolveConfiguredHome(optionValue("--home"));
+    const bridge = new PythonBridge(home);
+    try {
+        const status = optionValue("--status") ?? undefined;
+        const args = { page: 1, size: 20 };
+        if (status)
+            args.status = status;
+        const result = await bridge.callTool("varsity.competitions", args);
+        if (result?.error) {
+            console.error(`Error: ${result.error}`);
+            process.exit(1);
+        }
+        const items = result?.items ?? result?.list ?? result;
+        if (!Array.isArray(items) || items.length === 0) {
+            console.log("No competitions found.");
+            return;
+        }
+        console.log("Competitions:\n");
+        for (const c of items) {
+            const id = c.id ?? c.competitionId ?? "?";
+            const name = c.name ?? c.title ?? "Unnamed";
+            const st = c.status ?? "unknown";
+            const type = c.type ?? c.competitionType ?? "";
+            console.log(`  #${id}  ${name}`);
+            console.log(`        Status: ${st}  Type: ${type}`);
+            console.log("");
+        }
+    }
+    finally {
+        await bridge.disconnect();
+    }
+}
+async function runRegister() {
+    const home = resolveConfiguredHome(optionValue("--home"));
+    const idArg = argv[1];
+    if (!idArg || isNaN(Number(idArg))) {
+        console.error("Usage: arena-agent register <competition_id>");
+        process.exit(1);
+    }
+    const bridge = new PythonBridge(home);
+    try {
+        const result = await bridge.callTool("varsity.register", {
+            competition_id: Number(idArg),
+        });
+        if (result?.error) {
+            console.error(`Error: ${result.error ?? result.message}`);
+            process.exit(1);
+        }
+        console.log(`Registered for competition ${idArg}.`);
+        if (result?.status) {
+            console.log(`Status: ${result.status}`);
+        }
+    }
+    finally {
+        await bridge.disconnect();
+    }
+}
+async function runLeaderboard() {
+    const home = resolveConfiguredHome(optionValue("--home"));
+    const idArg = argv[1];
+    if (!idArg) {
+        console.error("Usage: arena-agent leaderboard <competition_id>");
+        process.exit(1);
+    }
+    const bridge = new PythonBridge(home);
+    try {
+        const result = await bridge.callTool("varsity.leaderboard", {
+            identifier: idArg,
+            page: 1,
+            size: 20,
+        });
+        if (result?.error) {
+            console.error(`Error: ${result.error ?? result.message}`);
+            process.exit(1);
+        }
+        const items = result?.items ?? result?.list ?? result;
+        if (!Array.isArray(items) || items.length === 0) {
+            console.log("No leaderboard data.");
+            return;
+        }
+        console.log(`Leaderboard for competition ${idArg}:\n`);
+        console.log("  Rank  Username             PnL");
+        console.log("  ----  -------------------  ----------");
+        for (const entry of items) {
+            const rank = String(entry.rank ?? entry.position ?? "?").padStart(4);
+            const user = (entry.username ?? entry.displayName ?? "unknown").padEnd(19);
+            const pnl = entry.pnl ?? entry.totalPnl ?? entry.returnPct ?? "?";
+            console.log(`  ${rank}  ${user}  ${pnl}`);
+        }
+    }
+    finally {
+        await bridge.disconnect();
+    }
+}
 main().catch((err) => {
     console.error(err instanceof Error ? err.message : err);
     process.exit(1);