Skip to content

Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors

27.7 KB
Raw Blame
import { afterEach, beforeEach, describe, it } from "node:test";
import assert from "node:assert/strict";

const { OpencodeExecutor } = await import("../../open-sse/executors/opencode.ts");
const { DefaultExecutor } = await import("../../open-sse/executors/default.ts");
const { PROVIDER_MODELS } = await import("../../open-sse/config/providerModels.ts");

function createMockResponse() {
  return new Response(JSON.stringify({ ok: true }), {
    status: 200,
    headers: { "Content-Type": "application/json" },
  });
}

function createInput(model, stream = true, credentials = { apiKey: "test-key" }) {
  return {
    model,
    stream,
    credentials,
    body: {
      model,
      stream,
      messages: [{ role: "user", content: "hello" }],
    },
  };
}

function registerModel(provider, model) {
  PROVIDER_MODELS[provider] = [...(PROVIDER_MODELS[provider] || []), model];
}

describe("OpencodeExecutor", () => {
  let zenExecutor;
  let goExecutor;
  let fetchCalls;
  let originalFetch;
  let originalZenModels;
  let originalGoModels;
  let originalSynthesizeCliHeaders;

  beforeEach(() => {
    zenExecutor = new OpencodeExecutor("opencode-zen");
    goExecutor = new OpencodeExecutor("opencode-go");
    fetchCalls = [];
    originalFetch = globalThis.fetch;
    originalZenModels = [...(PROVIDER_MODELS["opencode-zen"] || [])];
    originalGoModels = [...(PROVIDER_MODELS["opencode-go"] || [])];
    // This suite characterizes header/URL-building behavior that predates PR #10571's
    // CLI-identity synthesis default flip. #10571 turned synthesis ON by default, which
    // would fabricate User-Agent / x-opencode-* values these tests deliberately assert are
    // ABSENT (forward-only contract). Pin the flag off here so this suite keeps
    // characterizing the forward-only path; the on-by-default synthesis path itself is
    // covered by tests/unit/opencode-cli-headers-synthesis-5997.test.ts and
    // tests/unit/opencode-session-fingerprint-headers-10571.test.ts.
    originalSynthesizeCliHeaders = process.env.OPENCODE_SYNTHESIZE_CLI_HEADERS;
    process.env.OPENCODE_SYNTHESIZE_CLI_HEADERS = "false";
    globalThis.fetch = (async (url, options) => {
      fetchCalls.push({ url, options });
      return createMockResponse();
    }) as any;
  });

  afterEach(() => {
    globalThis.fetch = originalFetch;
    PROVIDER_MODELS["opencode-zen"] = originalZenModels;
    PROVIDER_MODELS["opencode-go"] = originalGoModels;
    if (originalSynthesizeCliHeaders === undefined) {
      delete process.env.OPENCODE_SYNTHESIZE_CLI_HEADERS;
    } else {
      process.env.OPENCODE_SYNTHESIZE_CLI_HEADERS = originalSynthesizeCliHeaders;
    }
  });

  describe("execute", () => {
    it('resolves "opencode" executor alias to opencode-zen config', async () => {
      const aliasExecutor = new OpencodeExecutor("opencode-zen");
      const result = await aliasExecutor.execute(createInput("deepseek-v4-flash-free"));
      assert.equal(result.url, "https://opencode.ai/inference/v1/chat/completions");
      assert.equal(fetchCalls[0].url, "https://opencode.ai/inference/v1/chat/completions");
    });

    it("routes deepseek-v4-flash-free to chat completions", async () => {
      const result = await zenExecutor.execute(createInput("deepseek-v4-flash-free"));
      assert.equal(result.url, "https://opencode.ai/inference/v1/chat/completions");
      assert.equal(fetchCalls[0].url, "https://opencode.ai/inference/v1/chat/completions");
    });

    it("includes deepseek-v4.1-flash-free in opencode-zen PROVIDER_MODELS", () => {
      const models = PROVIDER_MODELS["opencode-zen"];
      const model = models?.find((m) => m.id === "deepseek-v4.1-flash-free");
      assert.ok(model, "deepseek-v4.1-flash-free should be in opencode-zen model list");
      assert.equal(model.name, "DeepSeek V4.1 Flash Free");
      assert.deepEqual(model.aliases, ["deepseek-v4-flash-free"]);
      assert.equal(model.supportsReasoning, true);
    });

    it("declares V4 effort tiers on OpenCode Go base models only", () => {
      const goModels = PROVIDER_MODELS["opencode-go"] || [];
      const zenModels = PROVIDER_MODELS["opencode-zen"] || [];
      const efforts = ["none", "low", "high", "max"];

      for (const modelId of ["deepseek-v4-pro", "deepseek-v4-flash"]) {
        const base = goModels.find((model) => model.id === modelId);
        assert.deepEqual(base?.supportedThinkingEfforts, efforts);
        for (const effort of efforts) {
          const variant = `${modelId}-${effort}`;
          assert.equal(
            goModels.some((model) => model.id === variant),
            false
          );
          assert.equal(
            zenModels.some((model) => model.id === variant),
            false
          );
        }
      }
    });

    it("routes free models to the inference surface and paid ones to zen", async () => {
      const minimaxResult = await zenExecutor.execute(createInput("minimax-m2.5-free"));
      assert.equal(minimaxResult.url, "https://opencode.ai/inference/v1/chat/completions");
      assert.equal(fetchCalls[0].url, "https://opencode.ai/inference/v1/chat/completions");

      const pickleResult = await zenExecutor.execute(createInput("big-pickle"));
      assert.equal(pickleResult.url, "https://opencode.ai/inference/v1/chat/completions");
      assert.equal(fetchCalls[1].url, "https://opencode.ai/inference/v1/chat/completions");

      const nanoResult = await zenExecutor.execute(createInput("gpt-5-nano"));
      assert.equal(nanoResult.url, "https://opencode.ai/zen/v1/chat/completions");
      assert.equal(fetchCalls[2].url, "https://opencode.ai/zen/v1/chat/completions");
    });

    it("routes claude target format models to messages endpoint", async () => {
      const m27Result = await goExecutor.execute(
        createInput("minimax-m2.7", true, { apiKey: "claude-key" })
      );
      assert.equal(m27Result.url, "https://opencode.ai/zen/go/v1/messages");
      assert.equal(fetchCalls[0].url, "https://opencode.ai/zen/go/v1/messages");
      assert.equal(m27Result.headers["anthropic-version"], "2023-06-01");

      const m25Result = await goExecutor.execute(
        createInput("minimax-m2.5", true, { apiKey: "claude-key" })
      );
      assert.equal(m25Result.url, "https://opencode.ai/zen/go/v1/messages");
      assert.equal(fetchCalls[1].url, "https://opencode.ai/zen/go/v1/messages");
      assert.equal(m25Result.headers["anthropic-version"], "2023-06-01");
    });

    it("routes openai responses target format models to responses endpoint", async () => {
      registerModel("opencode-zen", {
        id: "gpt-5-responses",
        name: "GPT 5 Responses",
        targetFormat: "openai-responses",
      });

      const result = await zenExecutor.execute(createInput("gpt-5-responses"));

      assert.equal(result.url, "https://opencode.ai/zen/v1/responses");
      assert.equal(fetchCalls[0].url, "https://opencode.ai/zen/v1/responses");
    });

    it("routes OpenCode Go DeepSeek V4 models to the responses endpoint", async () => {
      const models = ["deepseek-v4-pro", "deepseek-v4-flash"];

      for (const [index, model] of models.entries()) {
        const result = await goExecutor.execute(createInput(model));
        assert.equal(result.url, "https://opencode.ai/zen/go/v1/responses");
        assert.equal(fetchCalls[index].url, "https://opencode.ai/zen/go/v1/responses");
      }
    });

    it("routes gemini streaming requests to streamGenerateContent", async () => {
      registerModel("opencode-zen", {
        id: "gemini-2.5-pro",
        name: "Gemini 2.5 Pro",
        targetFormat: "gemini",
      });

      const result = await zenExecutor.execute(createInput("gemini-2.5-pro"));

      assert.equal(
        result.url,
        "https://opencode.ai/zen/v1/models/gemini-2.5-pro:streamGenerateContent?alt=sse"
      );
      assert.equal(
        fetchCalls[0].url,
        "https://opencode.ai/zen/v1/models/gemini-2.5-pro:streamGenerateContent?alt=sse"
      );
    });

    it("routes gemini non streaming requests to generateContent", async () => {
      registerModel("opencode-zen", {
        id: "gemini-2.5-pro",
        name: "Gemini 2.5 Pro",
        targetFormat: "gemini",
      });

      const result = await zenExecutor.execute(createInput("gemini-2.5-pro", false));

      assert.equal(result.url, "https://opencode.ai/zen/v1/models/gemini-2.5-pro:generateContent");
      assert.equal(
        fetchCalls[0].url,
        "https://opencode.ai/zen/v1/models/gemini-2.5-pro:generateContent"
      );
    });

    it("falls back to chat completions for unknown models", async () => {
      const result = await zenExecutor.execute(createInput("unknown-model"));

      assert.equal(result.url, "https://opencode.ai/zen/v1/chat/completions");
      assert.equal(fetchCalls[0].url, "https://opencode.ai/zen/v1/chat/completions");
    });

    it("builds default headers for standard models", async () => {
      const result = await zenExecutor.execute(createInput("gpt-5-nano"));

      assert.deepEqual(result.headers, {
        Authorization: "Bearer test-key",
        "Content-Type": "application/json",
        Accept: "text/event-stream",
      });
      assert.deepEqual(fetchCalls[0].options.headers, result.headers);
    });

    it("adds anthropic version for claude target format", async () => {
      const result = await goExecutor.execute(
        createInput("minimax-m2.7", true, { apiKey: "claude-key" })
      );

      assert.deepEqual(result.headers, {
        "x-api-key": "claude-key",
        "Content-Type": "application/json",
        "anthropic-version": "2023-06-01",
        Accept: "text/event-stream",
      });
      assert.deepEqual(fetchCalls[0].options.headers, result.headers);
    });

    it("omits accept header when stream is false", async () => {
      // A paid model carries the client's non-streaming expectation through. A free-tier
      // model does not: the gated tier only answers streamed requests, so the executor
      // announces the event stream and the JSON body is rebuilt from it.
      const result = await zenExecutor.execute(createInput("gpt-5.6-luna", false));

      // #14384 routed gpt-5.6-* on Zen through /v1/responses, so #12633's rule applies:
      // that endpoint authenticates with x-api-key, not Bearer. The point of THIS test is
      // the absent Accept header — the auth header is asserted only so the bag is exact.
      assert.deepEqual(result.headers, {
        "x-api-key": "test-key",
        "Content-Type": "application/json",
      });
      assert.deepEqual(fetchCalls[0].options.headers, result.headers);
    });

    it("announces the event stream for a free-tier model even when the client wants JSON", async () => {
      const result = await zenExecutor.execute(createInput("big-pickle", false));

      assert.equal(result.headers["Accept"], "text/event-stream");
    });

    it("omits authorization when credentials are missing", async () => {
      const result = await zenExecutor.execute(createInput("minimax-m2.5-free", true, null));

      assert.deepEqual(result.headers, {
        "Content-Type": "application/json",
        Accept: "text/event-stream",
      });
      assert.deepEqual(fetchCalls[0].options.headers, result.headers);
    });

    it("routes opencode-go new models to chat completions", async () => {
      // Register new models
      registerModel("opencode-go", { id: "glm-5.1", name: "GLM-5.1", contextLength: 204800 });
      registerModel("opencode-go", { id: "kimi-k2.6", name: "Kimi K2.6" });
      registerModel("opencode-go", { id: "mimo-v2.5-pro", name: "MiMo V2.5 Pro" });
      registerModel("opencode-go", { id: "mimo-v2.5", name: "MiMo V2.5" });

      // glm-5.1
      const glm51 = await goExecutor.execute(createInput("glm-5.1"));
      assert.equal(glm51.url, "https://opencode.ai/zen/go/v1/chat/completions");

      // kimi-k2.6
      const kimi26 = await goExecutor.execute(createInput("kimi-k2.6"));
      assert.equal(kimi26.url, "https://opencode.ai/zen/go/v1/chat/completions");

      // mimo-v2.5-pro
      const mimoPro = await goExecutor.execute(createInput("mimo-v2.5-pro"));
      assert.equal(mimoPro.url, "https://opencode.ai/zen/go/v1/chat/completions");

      // mimo-v2.5
      const mimo = await goExecutor.execute(createInput("mimo-v2.5"));
      assert.equal(mimo.url, "https://opencode.ai/zen/go/v1/chat/completions");
    });

    it("routes opencode-go qwen models to claude messages endpoint", async () => {
      const qwen36 = await goExecutor.execute(
        createInput("qwen3.6-plus", true, { apiKey: "claude-key" })
      );
      assert.equal(qwen36.url, "https://opencode.ai/zen/go/v1/messages");
      assert.equal(qwen36.headers["anthropic-version"], "2023-06-01");

      const qwen35 = await goExecutor.execute(
        createInput("qwen3.5-plus", true, { apiKey: "claude-key" })
      );
      assert.equal(qwen35.url, "https://opencode.ai/zen/go/v1/messages");
      assert.equal(qwen35.headers["anthropic-version"], "2023-06-01");
    });

    it("builds bearer auth headers for opencode-go openai models", async () => {
      registerModel("opencode-go", { id: "glm-5.1", name: "GLM-5.1" });

      const result = await goExecutor.execute(createInput("glm-5.1"));

      assert.deepEqual(result.headers, {
        Authorization: "Bearer test-key",
        "Content-Type": "application/json",
        Accept: "text/event-stream",
      });
      assert.deepEqual(fetchCalls[0].options.headers, result.headers);
    });

    it("routes opencode-go catalog-only models to chat completions", async () => {
      // Register new models
      registerModel("opencode-go", { id: "glm-6-max", name: "GLM-6 Max" });
      registerModel("opencode-go", { id: "mimo-v2.5-pro", name: "MiMo-V2.5-Pro" });
      registerModel("opencode-go", { id: "mimo-v2.5", name: "MiMo-V2.5" });
      registerModel("opencode-go", { id: "hy3-preview", name: "Hunyuan3 Preview" });

      // glm-6-max
      const glm6 = await goExecutor.execute(createInput("glm-6-max"));
      assert.equal(glm6.url, "https://opencode.ai/zen/go/v1/chat/completions");

      // mimo-v2.5-pro
      const mimoPro = await goExecutor.execute(createInput("mimo-v2.5-pro"));
      assert.equal(mimoPro.url, "https://opencode.ai/zen/go/v1/chat/completions");

      // mimo-v2.5
      const mimo = await goExecutor.execute(createInput("mimo-v2.5"));
      assert.equal(mimo.url, "https://opencode.ai/zen/go/v1/chat/completions");

      // hy3-preview
      const hy3 = await goExecutor.execute(createInput("hy3-preview"));
      assert.equal(hy3.url, "https://opencode.ai/zen/go/v1/chat/completions");
    });
  });

  describe("user-agent forwarding", () => {
    it("forwards User-Agent from clientHeaders", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "User-Agent": "opencode/1.15.4",
      });
      assert.equal(headers["User-Agent"], "opencode/1.15.4");
    });

    it("omits User-Agent when clientHeaders is null", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, null);
      assert.equal(headers["User-Agent"], undefined);
    });

    it("omits User-Agent when clientHeaders has no User-Agent key", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {});
      assert.equal(headers["User-Agent"], undefined);
    });

    it("forwards User-Agent with claude format headers", () => {
      goExecutor._requestFormat = "claude";
      const headers = goExecutor.buildHeaders(
        { apiKey: "claude-key" },
        true,
        { "User-Agent": "opencode/1.0" },
        "minimax-m2.7"
      );
      assert.equal(headers["User-Agent"], "opencode/1.0");
      assert.equal(headers["x-api-key"], "claude-key");
      assert.equal(headers["anthropic-version"], "2023-06-01");
      assert.equal(headers["Content-Type"], "application/json");
      assert.equal(headers["Accept"], "text/event-stream");
    });

    it("forwards User-Agent without credentials", () => {
      const headers = zenExecutor.buildHeaders(null, true, { "User-Agent": "opencode/1.0" });
      assert.equal(headers["User-Agent"], "opencode/1.0");
      assert.equal(headers["Authorization"], undefined);
    });
  });

  describe("opencode request metadata headers", () => {
    it("forwards x-opencode-session from clientHeaders", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-opencode-session": "sess-123",
      });
      assert.equal(headers["x-opencode-session"], "sess-123");
    });

    it("forwards all four x-opencode-* headers from clientHeaders", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-opencode-session": "sess-abc",
        "x-opencode-request": "req-xyz",
        "x-opencode-project": "proj-5",
        "x-opencode-client": "tui",
      });
      assert.equal(headers["x-opencode-session"], "sess-abc");
      assert.equal(headers["x-opencode-request"], "req-xyz");
      assert.equal(headers["x-opencode-project"], "proj-5");
      assert.equal(headers["x-opencode-client"], "tui");
    });

    it("does not add x-opencode-* when clientHeaders is null", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, null);
      assert.equal(headers["x-opencode-session"], undefined);
      assert.equal(headers["x-opencode-request"], undefined);
      assert.equal(headers["x-opencode-project"], undefined);
      assert.equal(headers["x-opencode-client"], undefined);
    });

    it("does not add x-opencode-* when clientHeaders has no matching keys", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "some-other-header": "val",
      });
      assert.equal(headers["x-opencode-session"], undefined);
      assert.equal(headers["x-opencode-request"], undefined);
    });

    it("skips empty string x-opencode-* values", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-opencode-session": "",
        "x-opencode-request": "req-xyz",
      });
      assert.equal(headers["x-opencode-session"], undefined);
      assert.equal(headers["x-opencode-request"], "req-xyz");
    });

    it("handles case-insensitive x-opencode-* key matching", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "X-OpenCode-Session": "sess-456",
        "X-OPENCODE-REQUEST": "req-789",
      });
      assert.equal(headers["x-opencode-session"], "sess-456");
      assert.equal(headers["x-opencode-request"], "req-789");
    });

    it("opencode-go executor also forwards x-opencode-* headers", () => {
      const headers = goExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-opencode-session": "sess-go",
      });
      assert.equal(headers["x-opencode-session"], "sess-go");
    });

    it("forwards x-opencode-* headers with claude format", () => {
      goExecutor._requestFormat = "claude";
      const headers = goExecutor.buildHeaders(
        { apiKey: "claude-key" },
        true,
        {
          "x-opencode-session": "sess-claude",
          "User-Agent": "opencode/1.0",
        },
        "minimax-m2.7"
      );
      assert.equal(headers["x-opencode-session"], "sess-claude");
      assert.equal(headers["x-api-key"], "claude-key");
      assert.equal(headers["anthropic-version"], "2023-06-01");
      assert.equal(headers["User-Agent"], "opencode/1.0");
    });

    it("forwards x-opencode-* headers without credentials", () => {
      const headers = zenExecutor.buildHeaders(null, true, {
        "x-opencode-session": "sess-noauth",
      });
      assert.equal(headers["x-opencode-session"], "sess-noauth");
      assert.equal(headers["Authorization"], undefined);
    });
  });

  // #4022: OpenCode CLI only emits x-opencode-* when the provider id starts with
  // "opencode". For a custom-named provider (e.g. "omniroute") it instead sends
  // x-session-affinity / X-Session-Id (both carry the same OpenCode sessionID).
  // The executor must map that session id onto x-opencode-session so session
  // continuity to the opencode.ai upstream works regardless of provider name.
  describe("opencode session-affinity fallback (#4022)", () => {
    it("maps x-session-affinity to x-opencode-session when no direct x-opencode-session", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-session-affinity": "sess-aff",
      });
      assert.equal(headers["x-opencode-session"], "sess-aff");
    });

    it("maps X-Session-Id to x-opencode-session when no direct x-opencode-session", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "X-Session-Id": "sess-id",
      });
      assert.equal(headers["x-opencode-session"], "sess-id");
    });

    it("prefers a direct x-opencode-session over x-session-affinity (regression guard)", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-opencode-session": "direct",
        "x-session-affinity": "affinity",
        "X-Session-Id": "session-id",
      });
      assert.equal(headers["x-opencode-session"], "direct");
    });

    it("does not set x-opencode-session when neither direct nor affinity is present", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "some-other-header": "val",
      });
      assert.equal(headers["x-opencode-session"], undefined);
    });

    it("matches session-affinity headers case-insensitively", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "X-Session-Affinity": "sess-ci",
      });
      assert.equal(headers["x-opencode-session"], "sess-ci");
    });

    it("opencode-go executor also maps session-affinity to x-opencode-session", () => {
      const headers = goExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-session-affinity": "sess-go-aff",
      });
      assert.equal(headers["x-opencode-session"], "sess-go-aff");
    });
  });

  // #4465: custom-named providers reach the session-affinity fallback above, but the
  // OpenCode CLI never emits x-opencode-request for them (it only emits x-opencode-*
  // when the provider id starts with "opencode"). Synthesize a request correlation id
  // so these users are not disadvantaged on the opencode.ai upstream. x-opencode-client
  // / x-opencode-project are NOT fabricated: their valid values are opencode-internal
  // and inventing them risks upstream rejection — they stay forward-only.
  describe("opencode request-id synthesis for custom-named providers (#4465)", () => {
    it("synthesizes x-opencode-request when only session-affinity is present", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-session-affinity": "sess-aff",
      });
      assert.equal(headers["x-opencode-session"], "sess-aff");
      assert.ok(
        typeof headers["x-opencode-request"] === "string" &&
          headers["x-opencode-request"].length > 0,
        "expected a synthesized x-opencode-request id"
      );
    });

    it("synthesizes a unique x-opencode-request per call", () => {
      const a = zenExecutor.buildHeaders({ apiKey: "k" }, true, {
        "x-session-affinity": "sess-aff",
      });
      const b = zenExecutor.buildHeaders({ apiKey: "k" }, true, {
        "x-session-affinity": "sess-aff",
      });
      assert.notEqual(a["x-opencode-request"], b["x-opencode-request"]);
    });

    it("prefers a client-sent x-opencode-request over the synthesized one", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-session-affinity": "sess-aff",
        "x-opencode-request": "req-real",
      });
      assert.equal(headers["x-opencode-request"], "req-real");
    });

    it("does not fabricate x-opencode-client / x-opencode-project (no client source)", () => {
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-session-affinity": "sess-aff",
      });
      assert.equal(headers["x-opencode-client"], undefined);
      assert.equal(headers["x-opencode-project"], undefined);
    });

    it("does not synthesize x-opencode-request on the direct opencode-session path", () => {
      // opencode CLI (provider id starts with "opencode") sends its own x-opencode-*
      // set; we must not override/inject when it controls the request id itself.
      const headers = zenExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-opencode-session": "direct",
      });
      assert.equal(headers["x-opencode-request"], undefined);
    });

    it("opencode-go executor also synthesizes x-opencode-request on the fallback path", () => {
      const headers = goExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-session-affinity": "sess-go-aff",
      });
      assert.ok(
        typeof headers["x-opencode-request"] === "string" &&
          headers["x-opencode-request"].length > 0
      );
    });
  });

  describe("DeepSeek V4 reasoning-effort variants", () => {
    function baseBody(model) {
      return {
        model,
        stream: false,
        messages: [{ role: "user", content: "ok" }],
        max_tokens: 16,
      };
    }

    const levels = ["none", "low", "high", "max"];
    for (const model of ["deepseek-v4-pro", "deepseek-v4-flash"]) {
      for (const level of levels) {
        it(`maps ${model}-${level} to base id + reasoning_effort=${level}`, () => {
          const variant = `${model}-${level}`;
          const out = goExecutor.transformRequest(variant, baseBody(variant), false, {
            apiKey: "test-key",
          });
          assert.equal(out.model, model);
          assert.equal(out.reasoning_effort, level);
          assert.ok(!String(out.model).endsWith(`-${level}`));
        });
      }
    }

    it("preserves explicit reasoning_effort over the variant suffix", () => {
      const body = baseBody("deepseek-v4-pro-high") as Record<string, unknown>;
      body.reasoning_effort = "max";
      const out = goExecutor.transformRequest("deepseek-v4-pro-high", body, false, {
        apiKey: "test-key",
      });
      assert.equal(out.reasoning_effort, "max");
      assert.equal(out.model, "deepseek-v4-pro");
    });

    it("leaves the base id (no suffix) untouched", () => {
      const out = goExecutor.transformRequest(
        "deepseek-v4-pro",
        baseBody("deepseek-v4-pro"),
        false,
        { apiKey: "test-key" }
      );
      assert.equal(out.model, "deepseek-v4-pro");
      assert.equal(out.reasoning_effort, undefined);
    });

    it("does not rewrite unrelated models with matching suffixes", () => {
      const out = goExecutor.transformRequest(
        "some-other-model-high",
        baseBody("some-other-model-high"),
        false,
        { apiKey: "test-key" }
      );
      assert.equal(out.model, "some-other-model-high");
      assert.equal(out.reasoning_effort, undefined);
    });
  });
});

describe("DefaultExecutor", () => {
  let defaultExecutor;

  beforeEach(() => {
    defaultExecutor = new DefaultExecutor("openai-compatible-test");
  });

  describe("buildHeaders", () => {
    it("forwards x-opencode-* headers from clientHeaders", () => {
      const headers = defaultExecutor.buildHeaders({ apiKey: "test-key" }, true, {
        "x-opencode-session": "sess-abc",
        "x-opencode-request": "req-xyz",
        "x-opencode-project": "proj-5",
        "x-opencode-client": "tui",
      });
      assert.equal(headers["x-opencode-session"], "sess-abc");
      assert.equal(headers["x-opencode-request"], "req-xyz");
      assert.equal(headers["x-opencode-project"], "proj-5");
      assert.equal(headers["x-opencode-client"], "tui");
    });

    it("preserves existing behavior when clientHeaders is null", () => {
      const headers = defaultExecutor.buildHeaders({ apiKey: "test-key" }, true, null);
      assert.equal(headers["x-opencode-session"], undefined);
      assert.equal(headers["Content-Type"], "application/json");
      assert.equal(headers["Accept"], "text/event-stream");
      assert.equal(headers["Authorization"], "Bearer test-key");
    });
  });
});