@varsity-arena/agent 0.1.1

package/dist/util/env.js

@@ -0,0 +1,43 @@
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * Load .env.runtime.local from the arena root and return as a key-value map.
+ */
+export function loadEnvFile(arenaRoot) {
+    const envPath = resolve(arenaRoot, ".env.runtime.local");
+    if (!existsSync(envPath))
+        return {};
+    const env = {};
+    const content = readFileSync(envPath, "utf-8");
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIdx = trimmed.indexOf("=");
+        if (eqIdx < 1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        let value = trimmed.slice(eqIdx + 1).trim();
+        // Strip surrounding quotes
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        env[key] = value;
+    }
+    return env;
+}
+/**
+ * Build process env for child Python processes.
+ */
+export function buildChildEnv(arenaRoot) {
+    const base = { ...process.env };
+    const local = loadEnvFile(arenaRoot);
+    return {
+        ...base,
+        ARENA_ROOT: arenaRoot,
+        ARENA_HOME: arenaRoot,
+        ...local,
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/util/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/util/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,GAAG,CAAC;YAAE,SAAS;QACxB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,2BAA2B;QAC3B,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,MAAM,IAAI,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAA4B,CAAC;IAC1D,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACrC,OAAO;QACL,GAAG,IAAI;QACP,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,SAAS;QACrB,GAAG,KAAK;KACT,CAAC;AACJ,CAAC"}

package/dist/util/home.d.ts

@@ -0,0 +1,43 @@
+export declare const HOME_MARKER = ".arena-home.json";
+export declare const DEFAULT_MONITOR_PORT = 8767;
+export declare const DEFAULT_PYTHON_INSTALL_SOURCE: string;
+export type ManagedAgent = "auto" | "rule" | "claude" | "gemini" | "openclaw" | "codex";
+export interface ArenaHomeState {
+    version: number;
+    createdAt: string;
+    defaultAgent: ManagedAgent;
+    defaultModel: string | null;
+    liveTrading: boolean;
+    monitorPort: number;
+    pythonInstallSource: string;
+    profiles: {
+        agentExec: string;
+        rule: string;
+    };
+}
+export declare function localPythonSourcePath(): string | null;
+export declare function defaultArenaHome(): string;
+export declare function resolveArenaHome(explicitPath?: string): string;
+export declare function arenaHomeMarkerPath(home: string): string;
+export declare function envFilePath(home: string): string;
+export declare function configDirPath(home: string): string;
+export declare function artifactsDirPath(home: string): string;
+export declare function logsDirPath(home: string): string;
+export declare function profilePath(home: string, profile: "agent_exec" | "rule"): string;
+export declare function isManagedArenaHome(home: string): boolean;
+export declare function isRepoArenaRoot(home: string): boolean;
+export declare function isArenaHome(home: string): boolean;
+export declare function readArenaHomeState(home: string): ArenaHomeState | null;
+export declare function ensureArenaHomeDirectories(home: string): void;
+export declare function createArenaHomeState(home: string, options: {
+    defaultAgent: ManagedAgent;
+    defaultModel?: string | null;
+    liveTrading: boolean;
+    monitorPort?: number;
+    pythonInstallSource?: string;
+}): ArenaHomeState;
+export declare function writeArenaHomeState(home: string, state: ArenaHomeState): void;
+export declare function writeArenaEnvFile(home: string, apiKey: string): void;
+export declare function writeManagedConfigs(home: string, state: ArenaHomeState, options?: {
+    overwrite?: boolean;
+}): void;

package/dist/util/home.js

@@ -0,0 +1,263 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+export const HOME_MARKER = ".arena-home.json";
+export const DEFAULT_MONITOR_PORT = 8767;
+export const DEFAULT_PYTHON_INSTALL_SOURCE = process.env.ARENA_PYTHON_INSTALL_SOURCE ??
+    "git+https://github.com/varsity-tech-product/arena.git";
+function packageRepoRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), "../../../../");
+}
+export function localPythonSourcePath() {
+    const repoRoot = packageRepoRoot();
+    if (existsSync(resolve(repoRoot, "arena_agent", "__init__.py"))) {
+        return repoRoot;
+    }
+    return null;
+}
+export function defaultArenaHome() {
+    return resolve(homedir(), ".arena-agent");
+}
+export function resolveArenaHome(explicitPath) {
+    const raw = explicitPath ??
+        process.env.ARENA_HOME ??
+        process.env.ARENA_ROOT ??
+        defaultArenaHome();
+    return resolve(raw);
+}
+export function arenaHomeMarkerPath(home) {
+    return resolve(home, HOME_MARKER);
+}
+export function envFilePath(home) {
+    return resolve(home, ".env.runtime.local");
+}
+export function configDirPath(home) {
+    return resolve(home, "config");
+}
+export function artifactsDirPath(home) {
+    return resolve(home, "artifacts");
+}
+export function logsDirPath(home) {
+    return resolve(home, "logs");
+}
+export function profilePath(home, profile) {
+    return resolve(configDirPath(home), `${profile}.yaml`);
+}
+export function isManagedArenaHome(home) {
+    return existsSync(arenaHomeMarkerPath(home));
+}
+export function isRepoArenaRoot(home) {
+    return existsSync(resolve(home, "arena_agent", "__init__.py"));
+}
+export function isArenaHome(home) {
+    return isManagedArenaHome(home) || isRepoArenaRoot(home);
+}
+export function readArenaHomeState(home) {
+    const markerPath = arenaHomeMarkerPath(home);
+    if (!existsSync(markerPath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(markerPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function ensureArenaHomeDirectories(home) {
+    mkdirSync(home, { recursive: true });
+    mkdirSync(configDirPath(home), { recursive: true });
+    mkdirSync(artifactsDirPath(home), { recursive: true });
+    mkdirSync(logsDirPath(home), { recursive: true });
+}
+export function createArenaHomeState(home, options) {
+    return {
+        version: 1,
+        createdAt: new Date().toISOString(),
+        defaultAgent: options.defaultAgent,
+        defaultModel: options.defaultModel ?? null,
+        liveTrading: options.liveTrading,
+        monitorPort: options.monitorPort ?? DEFAULT_MONITOR_PORT,
+        pythonInstallSource: options.pythonInstallSource ?? DEFAULT_PYTHON_INSTALL_SOURCE,
+        profiles: {
+            agentExec: profilePath(home, "agent_exec"),
+            rule: profilePath(home, "rule"),
+        },
+    };
+}
+export function writeArenaHomeState(home, state) {
+    ensureArenaHomeDirectories(home);
+    writeFileSync(arenaHomeMarkerPath(home), JSON.stringify(state, null, 2) + "\n", "utf-8");
+}
+export function writeArenaEnvFile(home, apiKey) {
+    ensureArenaHomeDirectories(home);
+    writeFileSync(envFilePath(home), `VARSITY_API_KEY=${apiKey.trim()}\n`, "utf-8");
+}
+export function writeManagedConfigs(home, state, options = {}) {
+    ensureArenaHomeDirectories(home);
+    const overwrite = options.overwrite ?? true;
+    const configs = [
+        [state.profiles.agentExec, renderAgentExecConfig(state)],
+        [state.profiles.rule, renderRuleConfig(state)],
+    ];
+    for (const [path, content] of configs) {
+        if (!overwrite && existsSync(path)) {
+            continue;
+        }
+        writeFileSync(path, content, "utf-8");
+    }
+}
+function boolText(value) {
+    return value ? "true" : "false";
+}
+function renderAgentExecConfig(state) {
+    return `# Managed by arena-agent init
+competition_id: 4
+symbol: BTCUSDT
+interval: 1m
+tick_interval_seconds: 30
+kline_limit: 120
+orderbook_depth: 20
+max_iterations: null
+stop_when_competition_inactive: true
+error_backoff_seconds: 5
+dry_run: ${boolText(!state.liveTrading)}
+adapter_retry_attempts: 3
+adapter_retry_backoff_seconds: 0.5
+adapter_min_call_spacing_seconds: 0.0
+
+policy:
+  type: agent_exec
+  backend: auto
+  indicator_mode: full
+  timeout_seconds: 20
+  recent_transition_limit: 5
+  fail_open_to_hold: true
+  sandbox_mode: read-only
+  bootstrap_from_transition_log: true
+  strategy_context: active_momentum
+  extra_instructions: >-
+    All available technical indicators are pre-computed in the features section.
+    Use trend, momentum, volatility, and volume signals together.
+    Be decisive, but prefer HOLD when the market regime is ambiguous.
+
+strategy:
+  sizing:
+    type: volatility_scaled
+    target_risk_pct: 0.02
+    atr_multiplier: 2.0
+  tpsl:
+    type: atr_multiple
+    atr_tp_mult: 2.0
+    atr_sl_mult: 1.5
+  entry_filters:
+    - type: trade_budget
+      min_remaining_trades: 5
+  exit_rules:
+    - type: trailing_stop
+      atr_multiplier: 2.0
+    - type: drawdown_exit
+      max_drawdown_pct: 0.02
+
+risk_limits:
+  max_position_size_pct: 0.1
+  max_absolute_size: 0.01
+  min_size: 0.001
+  quantity_precision: 3
+  price_precision: 2
+  max_trades: 40
+  min_seconds_between_trades: 60
+  allow_long: true
+  allow_short: true
+
+storage:
+  transition_path: ./artifacts/transitions_agent_exec.jsonl
+  journal_path: ./artifacts/journal_agent_exec.jsonl
+  max_in_memory_transitions: 1000
+
+observability:
+  enabled: true
+  host: 127.0.0.1
+  port: ${state.monitorPort}
+  max_transitions: 20
+  max_logs: 50
+  no_transition_threshold_seconds: 90
+  no_transition_error_threshold_seconds: 180
+  max_decision_latency_seconds: 20
+  max_consecutive_runtime_errors: 3
+  supervisor_stop_on_error: true
+`;
+}
+function renderRuleConfig(state) {
+    return `# Managed by arena-agent init
+competition_id: 4
+symbol: BTCUSDT
+interval: 1m
+tick_interval_seconds: 30
+kline_limit: 120
+orderbook_depth: 20
+max_iterations: null
+stop_when_competition_inactive: true
+error_backoff_seconds: 5
+dry_run: ${boolText(!state.liveTrading)}
+adapter_retry_attempts: 3
+adapter_retry_backoff_seconds: 0.5
+adapter_min_call_spacing_seconds: 0.0
+
+signal_indicators:
+  - indicator: SMA
+    params:
+      period: 20
+  - indicator: RSI
+    params:
+      period: 14
+  - indicator: OBV
+    params: {}
+
+policy:
+  type: ensemble
+  members:
+    - type: ma_crossover
+      params:
+        fast_period: 20
+        slow_period: 50
+    - type: rsi_mean_reversion
+      params:
+        rsi_period: 14
+        oversold: 30
+        overbought: 70
+        exit_level: 50
+    - type: channel_breakout
+      params:
+        lookback: 20
+
+risk_limits:
+  max_position_size_pct: 0.1
+  max_absolute_size: 0.01
+  min_size: 0.001
+  quantity_precision: 3
+  price_precision: 2
+  max_trades: 40
+  min_seconds_between_trades: 60
+  allow_long: true
+  allow_short: true
+
+storage:
+  transition_path: ./artifacts/transitions_rule.jsonl
+  journal_path: ./artifacts/journal_rule.jsonl
+  max_in_memory_transitions: 1000
+
+observability:
+  enabled: true
+  host: 127.0.0.1
+  port: ${state.monitorPort}
+  max_transitions: 20
+  max_logs: 50
+  no_transition_threshold_seconds: 90
+  no_transition_error_threshold_seconds: 180
+  max_consecutive_runtime_errors: 3
+  supervisor_stop_on_error: true
+`;
+}
+//# sourceMappingURL=home.js.map

package/dist/util/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","sourceRoot":"","sources":["../../src/util/home.ts"],"names":[],"mappings":"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"}

package/dist/util/paths.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Find the arena project root by walking up from cwd or using ARENA_ROOT env.
+ */
+export declare function findArenaRoot(): string;
+/**
+ * Resolve the Python binary inside the arena venv.
+ */
+export declare function findPython(arenaRoot: string): string;

package/dist/util/paths.js

@@ -0,0 +1,51 @@
+import { existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { defaultArenaHome, isArenaHome, localPythonSourcePath } from "./home.js";
+/**
+ * Find the arena project root by walking up from cwd or using ARENA_ROOT env.
+ */
+export function findArenaRoot() {
+    const envRoot = process.env.ARENA_ROOT;
+    if (envRoot && isArenaHome(resolve(envRoot))) {
+        return resolve(envRoot);
+    }
+    const envHome = process.env.ARENA_HOME;
+    if (envHome && isArenaHome(resolve(envHome))) {
+        return resolve(envHome);
+    }
+    let dir = process.cwd();
+    for (let i = 0; i < 10; i++) {
+        if (isArenaHome(dir)) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    const managedHome = defaultArenaHome();
+    if (isArenaHome(managedHome)) {
+        return managedHome;
+    }
+    const localSource = localPythonSourcePath();
+    if (localSource && isArenaHome(localSource)) {
+        return localSource;
+    }
+    throw new Error("Cannot find an Arena home. Run `arena-agent init`, or set ARENA_ROOT to a configured Arena directory.");
+}
+/**
+ * Resolve the Python binary inside the arena venv.
+ */
+export function findPython(arenaRoot) {
+    const candidates = [
+        resolve(arenaRoot, ".venv", "bin", "python"),
+        resolve(arenaRoot, ".venv", "bin", "python3"),
+        resolve(arenaRoot, ".venv", "Scripts", "python.exe"), // Windows
+    ];
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    throw new Error(`No Python venv found at ${arenaRoot}/.venv. Run \`arena-agent init\` to bootstrap the runtime.`);
+}
+//# sourceMappingURL=paths.js.map

package/dist/util/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/util/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEjF;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACvC,IAAI,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACvC,IAAI,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB,EAAE,CAAC;IACvC,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;IAC5C,IAAI,WAAW,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC;QAC5C,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC;QAC7C,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,UAAU;KACjE,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,IAAI,KAAK,CACb,2BAA2B,SAAS,4DAA4D,CACjG,CAAC;AACJ,CAAC"}

package/dist/util/runtime-state.d.ts

@@ -0,0 +1,15 @@
+export interface RuntimeState {
+    pid: number;
+    agent: string;
+    configPath: string;
+    logPath: string;
+    startedAt: string;
+    monitorPort: number;
+}
+export declare function runtimeStatePath(home: string): string;
+export declare function readRuntimeState(home: string): RuntimeState | null;
+export declare function writeRuntimeState(home: string, state: RuntimeState): void;
+export declare function clearRuntimeState(home: string): void;
+export declare function isProcessRunning(pid: number): boolean;
+export declare function latestRuntimeLogPath(home: string): string | null;
+export declare function tailLines(path: string, limit: number): string;

package/dist/util/runtime-state.js

@@ -0,0 +1,55 @@
+import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync, } from "node:fs";
+import { resolve } from "node:path";
+import { logsDirPath } from "./home.js";
+export function runtimeStatePath(home) {
+    return resolve(home, ".runtime-state.json");
+}
+export function readRuntimeState(home) {
+    const path = runtimeStatePath(home);
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function writeRuntimeState(home, state) {
+    writeFileSync(runtimeStatePath(home), JSON.stringify(state, null, 2) + "\n");
+}
+export function clearRuntimeState(home) {
+    const path = runtimeStatePath(home);
+    if (existsSync(path)) {
+        unlinkSync(path);
+    }
+}
+export function isProcessRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function latestRuntimeLogPath(home) {
+    const dir = logsDirPath(home);
+    if (!existsSync(dir)) {
+        return null;
+    }
+    const candidates = readdirSync(dir)
+        .filter((name) => name.startsWith("runtime-") && name.endsWith(".log"))
+        .sort();
+    if (candidates.length === 0) {
+        return null;
+    }
+    return resolve(dir, candidates[candidates.length - 1]);
+}
+export function tailLines(path, limit) {
+    const content = readFileSync(path, "utf-8");
+    const lines = content.split("\n");
+    return lines.slice(Math.max(0, lines.length - limit)).join("\n");
+}
+//# sourceMappingURL=runtime-state.js.map

package/dist/util/runtime-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state.js","sourceRoot":"","sources":["../../src/util/runtime-state.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAWxC,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAiB,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAmB;IACjE,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC;SAChC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SACtE,IAAI,EAAE,CAAC;IACV,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@varsity-arena/agent",
+  "version": "0.1.1",
+  "description": "Arena trading agent runtime with managed install, TUI monitoring, and MCP support",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/varsity-tech-product/arena.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/varsity-tech-product/arena/tree/main/packages/mcp",
+  "bugs": {
+    "url": "https://github.com/varsity-tech-product/arena/issues"
+  },
+  "type": "module",
+  "bin": {
+    "arena-mcp": "./dist/cli.js",
+    "arena-agent": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepack": "npm run build",
+    "dev": "tsc --watch",
+    "serve": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/",
+    "bin/"
+  ],
+  "keywords": [
+    "mcp",
+    "arena",
+    "trading",
+    "varsity",
+    "claude",
+    "gemini",
+    "openclaw",
+    "codex",
+    "agent",
+    "tui"
+  ],
+  "license": "MIT"
+}