@openfinclaw/openfinclaw-strategy 2026.3.310 → 2026.4.2

package/src/tournament/tools.test.ts

@@ -1,221 +0,0 @@
-/**
- * Unit tests for tournament tools.
- * @module openfinclaw/tournament/tools.test
- */
-import { DatabaseSync } from "node:sqlite";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { TournamentDb, ensureTournamentSchema } from "./db.js";
-
-/**
- * Minimal tool executor for testing.
- * Collects registered tools and lets tests call them directly.
- */
-class ToolCollector {
-  tools = new Map<
-    string,
-    { execute: (id: string, params: Record<string, unknown>) => Promise<unknown> }
-  >();
-
-  registerTool(factory: unknown, opts?: unknown) {
-    const tool =
-      typeof factory === "function" ? (factory as (ctx: unknown) => unknown)(null) : factory;
-    const t = tool as {
-      name: string;
-      execute: (id: string, params: Record<string, unknown>) => Promise<unknown>;
-    };
-    const names = (opts as { names?: string[] } | undefined)?.names ?? [t.name];
-    for (const name of names) {
-      this.tools.set(name, t);
-    }
-  }
-
-  async call(
-    name: string,
-    params: Record<string, unknown>,
-  ): Promise<{ content: Array<{ type: string; text: string }>; details: unknown }> {
-    const tool = this.tools.get(name);
-    if (!tool) throw new Error(`Tool not found: ${name}`);
-    return tool.execute("test-call-id", params) as Promise<{
-      content: Array<{ type: string; text: string }>;
-      details: unknown;
-    }>;
-  }
-}
-
-/** Extract parsed details from tool result. */
-function details(result: { details: unknown }): Record<string, unknown> {
-  if (typeof result.details === "string") return JSON.parse(result.details);
-  return result.details as Record<string, unknown>;
-}
-
-describe("tournament tools", () => {
-  let db: DatabaseSync;
-  let tdb: TournamentDb;
-  let collector: ToolCollector;
-
-  beforeEach(async () => {
-    db = new DatabaseSync(":memory:");
-    db.exec("PRAGMA journal_mode = WAL");
-    ensureTournamentSchema(db);
-    tdb = new TournamentDb(db);
-
-    collector = new ToolCollector();
-    const { registerTournamentTools } = await import("./tools.js");
-    registerTournamentTools(collector.registerTool.bind(collector), () => tdb);
-  });
-
-  afterEach(() => {
-    db.close();
-  });
-
-  describe("tournament_pick", () => {
-    it("records valid pick", async () => {
-      tdb.createRound({ id: "round-20260331", date: "2026-03-31", ticker: "AAPL" });
-      tdb.updateRoundStatus("round-20260331", "completed");
-      tdb.saveStrategy({
-        round_id: "round-20260331",
-        agent_name: "bull",
-        thesis: "test",
-        confidence: 80,
-        entry_price: null,
-        exit_price: null,
-        stop_loss: null,
-        position_pct: null,
-        sharpe: 1.5,
-        max_drawdown: null,
-        total_return: null,
-        raw_result: null,
-      });
-
-      const result = await collector.call("tournament_pick", {
-        agent_name: "bull",
-        user_id: "tg:123",
-        session_key: "agent:main",
-      });
-      const d = details(result);
-      expect(d.agent_name).toBe("bull");
-      expect(d.message).toContain("BULL");
-    });
-
-    it("rejects invalid agent name", async () => {
-      tdb.createRound({ id: "round-20260331", date: "2026-03-31", ticker: "AAPL" });
-      tdb.updateRoundStatus("round-20260331", "completed");
-
-      const result = await collector.call("tournament_pick", {
-        agent_name: "invalid",
-        user_id: "tg:123",
-        session_key: "agent:main",
-      });
-      const d = details(result);
-      expect(d.error).toBe(true);
-    });
-
-    it("returns error when no active round", async () => {
-      const result = await collector.call("tournament_pick", {
-        agent_name: "bull",
-        user_id: "tg:123",
-        session_key: "agent:main",
-      });
-      const d = details(result);
-      expect(d.error).toBe(true);
-      expect(d.message).toContain("没有活跃");
-    });
-
-    it("handles duplicate pick idempotently", async () => {
-      tdb.createRound({ id: "round-20260331", date: "2026-03-31", ticker: "AAPL" });
-      tdb.updateRoundStatus("round-20260331", "completed");
-
-      await collector.call("tournament_pick", {
-        agent_name: "bull",
-        user_id: "tg:123",
-        session_key: "agent:main",
-      });
-      const result = await collector.call("tournament_pick", {
-        agent_name: "bear",
-        user_id: "tg:123",
-        session_key: "agent:main",
-      });
-      const d = details(result);
-      expect(d.message).toContain("已经");
-    });
-
-    it("allows different users to pick same round", async () => {
-      tdb.createRound({ id: "round-20260331", date: "2026-03-31", ticker: "AAPL" });
-      tdb.updateRoundStatus("round-20260331", "completed");
-
-      const r1 = await collector.call("tournament_pick", {
-        agent_name: "bull",
-        user_id: "tg:111",
-        session_key: "agent:main",
-      });
-      const r2 = await collector.call("tournament_pick", {
-        agent_name: "bear",
-        user_id: "tg:222",
-        session_key: "agent:main",
-      });
-      expect(details(r1).agent_name).toBe("bull");
-      expect(details(r2).agent_name).toBe("bear");
-    });
-  });
-
-  describe("tournament_leaderboard", () => {
-    it("returns formatted ranking with data", async () => {
-      tdb.recordWin("bull", 2.0);
-      tdb.recordWin("bear", 1.0);
-      tdb.recordWin("contrarian", 3.0);
-
-      const result = await collector.call("tournament_leaderboard", {});
-      const d = details(result);
-      expect(d.message).toContain("排行榜");
-      expect((d.agents as Array<{ name: string }>)[0].name).toBe("contrarian");
-    });
-
-    it("returns empty message when no data", async () => {
-      const result = await collector.call("tournament_leaderboard", {});
-      const d = details(result);
-      expect(d.message).toContain("还没有");
-    });
-  });
-
-  describe("tournament_result", () => {
-    it("stores strategy with all fields", async () => {
-      tdb.createRound({ id: "round-20260331", date: "2026-03-31", ticker: "AAPL" });
-
-      const result = await collector.call("tournament_result", {
-        round_id: "round-20260331",
-        agent_name: "bull",
-        thesis: "Strong momentum signals",
-        entry_price: 150,
-        exit_price: 165,
-        stop_loss: 145,
-        position_pct: 0.25,
-        confidence: 85,
-        sharpe: 1.5,
-        max_drawdown: -0.08,
-        total_return: 0.12,
-      });
-
-      const d = details(result);
-      expect(d.agent_name).toBe("bull");
-
-      const strategies = tdb.getStrategies("round-20260331");
-      expect(strategies).toHaveLength(1);
-      expect(strategies[0].confidence).toBe(85);
-      expect(strategies[0].sharpe).toBe(1.5);
-    });
-
-    it("rejects invalid confidence range", async () => {
-      tdb.createRound({ id: "round-20260331", date: "2026-03-31", ticker: "AAPL" });
-
-      const result = await collector.call("tournament_result", {
-        round_id: "round-20260331",
-        agent_name: "bull",
-        thesis: "test",
-        confidence: 150,
-      });
-      const d = details(result);
-      expect(d.error).toBe(true);
-      expect(d.message).toContain("0-100");
-    });
-  });
-});

package/src/tournament/tools.ts

@@ -1,192 +0,0 @@
-/**
- * Tournament tools: pick, leaderboard, and result submission.
- * @module openfinclaw/tournament/tools
- */
-import { Type } from "@sinclair/typebox";
-import type { TournamentDb } from "./db.js";
-
-const VALID_AGENTS = ["bull", "bear", "contrarian"] as const;
-type AgentName = (typeof VALID_AGENTS)[number];
-
-/** JSON helper for tool results. */
-function json(data: unknown): { content: Array<{ type: "text"; text: string }>; details: unknown } {
-  const text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
-  return { content: [{ type: "text" as const, text }], details: data };
-}
-
-/**
- * Register tournament tools on the plugin API.
- * @param registerTool - api.registerTool from plugin entry
- * @param getDb - lazy getter for TournamentDb (DB may not be ready at registration time)
- */
-export function registerTournamentTools(
-  registerTool: (tool: unknown, opts?: unknown) => void,
-  getDb: () => TournamentDb,
-): void {
-  // ── tournament_pick ─────────────────────────────────────────────────
-
-  registerTool(
-    (_ctx: unknown) => ({
-      name: "tournament_pick",
-      label: "Tournament Pick",
-      description:
-        "Record a user's strategy pick for the current tournament round. Use when user says '/pick bull', '/pick bear', or '/pick contrarian'.",
-      parameters: Type.Object({
-        agent_name: Type.String({
-          description: "Agent to pick: bull, bear, or contrarian",
-        }),
-        user_id: Type.Optional(
-          Type.String({
-            description: "User identifier from the channel (auto-resolved if omitted)",
-          }),
-        ),
-        session_key: Type.Optional(
-          Type.String({ description: "OpenClaw session key (auto-resolved if omitted)" }),
-        ),
-      }),
-      async execute(_toolCallId: string, params: Record<string, unknown>) {
-        const db = getDb();
-        const agentName = String(params.agent_name).toLowerCase().trim();
-
-        if (!VALID_AGENTS.includes(agentName as AgentName)) {
-          return json({
-            error: true,
-            message: `无效选择。请用 /pick bull|bear|contrarian，可选值: ${VALID_AGENTS.join(", ")}`,
-          });
-        }
-
-        const roundId = db.getLatestCompletedRoundId();
-        if (!roundId) {
-          return json({ error: true, message: "当前没有活跃的锦标赛轮次。" });
-        }
-
-        const userId = String(params.user_id ?? "unknown");
-        const sessionKey = String(params.session_key ?? "unknown");
-
-        const isNew = db.recordPick({
-          round_id: roundId,
-          user_id: userId,
-          session_key: sessionKey,
-          agent_name: agentName,
-        });
-
-        if (!isNew) {
-          return json({ message: `你已经在本轮选择过了。你的选择: ${agentName}` });
-        }
-
-        // Update agent W/L based on the pick
-        const strategies = db.getStrategies(roundId);
-        const picked = strategies.find((s) => s.agent_name === agentName);
-        if (picked) {
-          db.recordWin(agentName, picked.sharpe);
-          for (const s of strategies) {
-            if (s.agent_name !== agentName) {
-              db.recordLoss(s.agent_name, s.sharpe);
-            }
-          }
-        }
-
-        return json({
-          message: `已记录你的选择: 🎯 ${agentName.toUpperCase()}`,
-          round_id: roundId,
-          agent_name: agentName,
-        });
-      },
-    }),
-    { names: ["tournament_pick"] },
-  );
-
-  // ── tournament_leaderboard ──────────────────────────────────────────
-
-  registerTool(
-    (_ctx: unknown) => ({
-      name: "tournament_leaderboard",
-      label: "Tournament Leaderboard",
-      description:
-        "Show the strategy tournament agent leaderboard with win/loss records and Sharpe ratios.",
-      parameters: Type.Object({}),
-      async execute() {
-        const db = getDb();
-        const agents = db.getLeaderboard();
-
-        if (agents.length === 0) {
-          return json({ message: "还没有锦标赛记录。等待第一轮锦标赛完成后再查看。" });
-        }
-
-        const medals = ["🥇", "🥈", "🥉"];
-        const lines = agents.map((a, i) => {
-          const medal = medals[i] ?? "  ";
-          const winRate = a.rounds_played > 0 ? ((a.wins / a.rounds_played) * 100).toFixed(0) : "0";
-          return `${medal} ${a.name.toUpperCase().padEnd(12)} W:${String(a.wins).padStart(3)} L:${String(a.losses).padStart(3)} | Sharpe: ${a.avg_sharpe.toFixed(2)} | Win Rate: ${winRate}% | Rounds: ${a.rounds_played}`;
-        });
-
-        return json({
-          message: `📊 策略锦标赛排行榜\n${"─".repeat(60)}\n${lines.join("\n")}\n${"─".repeat(60)}`,
-          agents,
-        });
-      },
-    }),
-    { names: ["tournament_leaderboard"] },
-  );
-
-  // ── tournament_result ───────────────────────────────────────────────
-
-  registerTool(
-    (_ctx: unknown) => ({
-      name: "tournament_result",
-      label: "Tournament Result",
-      description:
-        "Submit analysis result from a tournament subagent. Called by Bull/Bear/Contrarian subagents after completing their analysis.",
-      parameters: Type.Object({
-        round_id: Type.String({ description: "Tournament round ID" }),
-        agent_name: Type.String({ description: "Agent role: bull, bear, or contrarian" }),
-        thesis: Type.String({ description: "Analysis thesis (1 paragraph)" }),
-        entry_price: Type.Optional(Type.Number({ description: "Entry price" })),
-        exit_price: Type.Optional(Type.Number({ description: "Exit/target price" })),
-        stop_loss: Type.Optional(Type.Number({ description: "Stop loss price" })),
-        position_pct: Type.Optional(
-          Type.Number({ description: "Position size as fraction (0-1)" }),
-        ),
-        confidence: Type.Number({ description: "Confidence score (0-100)" }),
-        sharpe: Type.Optional(Type.Number({ description: "Sharpe ratio from backtest" })),
-        max_drawdown: Type.Optional(Type.Number({ description: "Max drawdown from backtest" })),
-        total_return: Type.Optional(Type.Number({ description: "Total return from backtest" })),
-      }),
-      async execute(_toolCallId: string, params: Record<string, unknown>) {
-        const db = getDb();
-        const agentName = String(params.agent_name).toLowerCase().trim();
-        const confidence = Number(params.confidence);
-
-        if (!VALID_AGENTS.includes(agentName as AgentName)) {
-          return json({ error: true, message: `Invalid agent name: ${agentName}` });
-        }
-
-        if (confidence < 0 || confidence > 100 || !Number.isFinite(confidence)) {
-          return json({ error: true, message: `Confidence must be 0-100, got: ${confidence}` });
-        }
-
-        db.saveStrategy({
-          round_id: String(params.round_id),
-          agent_name: agentName,
-          thesis: String(params.thesis),
-          entry_price: params.entry_price != null ? Number(params.entry_price) : null,
-          exit_price: params.exit_price != null ? Number(params.exit_price) : null,
-          stop_loss: params.stop_loss != null ? Number(params.stop_loss) : null,
-          position_pct: params.position_pct != null ? Number(params.position_pct) : null,
-          confidence,
-          sharpe: params.sharpe != null ? Number(params.sharpe) : null,
-          max_drawdown: params.max_drawdown != null ? Number(params.max_drawdown) : null,
-          total_return: params.total_return != null ? Number(params.total_return) : null,
-          raw_result: JSON.stringify(params),
-        });
-
-        return json({
-          message: `Strategy submitted: ${agentName} (confidence: ${confidence})`,
-          round_id: params.round_id,
-          agent_name: agentName,
-        });
-      },
-    }),
-    { names: ["tournament_result"] },
-  );
-}