@linkedclaw/cli 0.1.2 → 0.1.5

package/test/arena-api.test.ts

@@ -0,0 +1,211 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { ApiError } from "../src/errors.js";
+import { makeArenaApi } from "../src/arena/api.js";
+
+function jsonResponse(body: unknown, init: { ok?: boolean; status?: number } = {}) {
+  return {
+    ok: init.ok ?? true,
+    status: init.status ?? 200,
+    json: vi.fn(async () => body),
+  } as any;
+}
+
+describe("makeArenaApi", () => {
+  const fetchMock = vi.fn();
+
+  beforeEach(() => {
+    fetchMock.mockResolvedValue(jsonResponse({ ok: true }));
+    vi.stubGlobal("fetch", fetchMock);
+  });
+
+  afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.restoreAllMocks();
+  });
+
+  it("register posts to the contestant registration route", async () => {
+    const api = makeArenaApi("http://services.test/", "k");
+    await api.register({
+      contestant_agent_id: "agt_1",
+      mandate_id: "mand_1",
+      category: { topic: "code", subtopic: "rust" },
+    });
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/contestants/register",
+      expect.objectContaining({ method: "POST" }),
+    );
+  });
+
+  it("createTournamentArena posts the exact manifest with idempotency header", async () => {
+    const api = makeArenaApi("http://services.test/", "k");
+    const manifest = {
+      mode: "tournament" as const,
+      category: { topic: "code", subtopic: "rust" },
+      config: {
+        bracket_shape: "single_elim",
+        child_mode: "task_submission",
+        advancement_rule: "top_k(1)",
+        bracket_size: 4,
+        seeding: "unseeded",
+        child_config: { prompt: "ship a patch" },
+      },
+    };
+    await api.createTournamentArena(manifest, { idempotencyKey: "idem_123" });
+    const [, init] = fetchMock.mock.calls[0];
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/arenas",
+      expect.objectContaining({ method: "POST" }),
+    );
+    expect(init.headers).toMatchObject({
+      Authorization: "Bearer k",
+      "X-CSRF-Token": "k",
+      "Idempotency-Key": "idem_123",
+    });
+    expect(JSON.parse(init.body)).toEqual(manifest);
+  });
+
+  it("offers uses GET and accepts pending matches", async () => {
+    fetchMock.mockResolvedValueOnce(jsonResponse({
+      offers: [],
+      pending_matches: [{ match_id: "amch_123", prompt: "ship it" }],
+    }));
+    const api = makeArenaApi("http://services.test", "k");
+    const response = await api.listOffers();
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/offers",
+      expect.objectContaining({ method: "GET" }),
+    );
+    expect(response.pending_matches?.[0].match_id).toBe("amch_123");
+  });
+
+  it("acceptOffer posts to the offer accept route", async () => {
+    const api = makeArenaApi("http://services.test", "k");
+    await api.acceptOffer("aoff_123");
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/offers/aoff_123/accept",
+      expect.objectContaining({ method: "POST" }),
+    );
+  });
+
+  it("submit posts to the submissions route and strips only client-only submission_hash", async () => {
+    const api = makeArenaApi("http://services.test", "k");
+    await api.submit("arn_123", {
+      offer_id: "aoff_123",
+      raw_content: "hello",
+      match_id: "amch_123",
+      seq: 1,
+      submission_hash: "sha256:" + "a".repeat(64),
+    });
+    const [, init] = fetchMock.mock.calls[0];
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/arenas/arn_123/submissions",
+      expect.objectContaining({ method: "POST" }),
+    );
+    expect(JSON.parse(init.body)).toEqual({
+      offer_id: "aoff_123",
+      raw_content: "hello",
+      match_id: "amch_123",
+      seq: 1,
+    });
+  });
+
+  it("commitJuror posts to the juror commit route with the exact body", async () => {
+    const api = makeArenaApi("http://services.test", "k");
+    await api.commitJuror("arn_123", {
+      juror_agent_id: "agt_juror",
+      mandate_id: "mnd_123",
+    });
+    const [, init] = fetchMock.mock.calls[0];
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/arenas/arn_123/jurors/commit",
+      expect.objectContaining({ method: "POST" }),
+    );
+    expect(JSON.parse(init.body)).toEqual({
+      juror_agent_id: "agt_juror",
+      mandate_id: "mnd_123",
+    });
+  });
+
+  it("voteTask posts to the task juror vote route with the exact body", async () => {
+    const api = makeArenaApi("http://services.test", "k");
+    await api.voteTask("arn_123", {
+      submission_id: "asub_123",
+      score: 0.75,
+      rationale_ref: "note://1",
+    });
+    const [, init] = fetchMock.mock.calls[0];
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/arenas/arn_123/juror-votes",
+      expect.objectContaining({ method: "POST" }),
+    );
+    expect(JSON.parse(init.body)).toEqual({
+      submission_id: "asub_123",
+      score: 0.75,
+      rationale_ref: "note://1",
+    });
+  });
+
+  it("voteMatch posts to the match juror vote route with the exact body", async () => {
+    const api = makeArenaApi("http://services.test", "k");
+    await api.voteMatch("arn_123", "amch_123", {
+      outcome: "a",
+      rationale_ref: "note://2",
+    });
+    const [, init] = fetchMock.mock.calls[0];
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/arenas/arn_123/matches/amch_123/juror-votes",
+      expect.objectContaining({ method: "POST" }),
+    );
+    expect(JSON.parse(init.body)).toEqual({
+      outcome: "a",
+      rationale_ref: "note://2",
+    });
+  });
+
+  it("listArenas registered uses the registered query parameter", async () => {
+    const api = makeArenaApi("http://services.test", "k");
+    await api.listArenas({ registered: true });
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/arenas?registered=true",
+      expect.objectContaining({ method: "GET" }),
+    );
+  });
+
+  it("getLeaderboard hits the leaderboard route", async () => {
+    const api = makeArenaApi("http://services.test", "k");
+    await api.getLeaderboard("arn_123");
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/arenas/arn_123/leaderboard",
+      expect.objectContaining({ method: "GET" }),
+    );
+  });
+
+  it("getCategoryLeaderboard hits the category leaderboard route", async () => {
+    const api = makeArenaApi("http://services.test", "k");
+    await api.getCategoryLeaderboard({ topic: "coding", subtopic: "patches" }, "match");
+    expect(fetchMock).toHaveBeenCalledWith(
+      "http://services.test/api/v1/arena/leaderboard?category_topic=coding&category_subtopic=patches&mode=match",
+      expect.objectContaining({ method: "GET" }),
+    );
+  });
+
+  it("sends authorization and content-type headers", async () => {
+    const api = makeArenaApi("http://services.test", "k");
+    await api.listOffers();
+    const [, init] = fetchMock.mock.calls[0];
+    expect(init.headers).toMatchObject({
+      Authorization: "Bearer k",
+      "Content-Type": "application/json",
+    });
+  });
+
+  it("turns non-2xx responses into ApiError", async () => {
+    fetchMock.mockResolvedValueOnce(jsonResponse({ detail: "arena_not_found" }, { ok: false, status: 404 }));
+    const api = makeArenaApi("http://services.test", "k");
+    await expect(api.getLeaderboard("missing")).rejects.toMatchObject({
+      name: "ApiError",
+      status: 404,
+      detail: "arena_not_found",
+    } satisfies Partial<ApiError>);
+  });
+});