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

12.7 KB
Raw Blame
import test from "node:test";
import assert from "node:assert/strict";
import fs from "node:fs";
import os from "node:os";
import path from "node:path";

const {
  CURSOR_AGENT_CLI_VERSION,
  configureCursorAgentCliVersionForTests,
  detectCursorAgentCliVersionFromFs,
  extractVersionIdFromInstallerScript,
  extractVersionIdFromResolvedPath,
  formatCursorAgentClientVersion,
  getCursorAgentCliVersion,
  newestVersionInDir,
  refreshCursorAgentCliVersionFromInstaller,
  resetCursorAgentCliVersionCache,
  resetCursorAgentCliVersionTestHooks,
} = await import("../../open-sse/utils/cursorAgentCliVersion.ts");

function withEnv(vars: Record<string, string | undefined>, fn: () => void | Promise<void>) {
  const saved: Record<string, string | undefined> = {};
  for (const key of Object.keys(vars)) {
    saved[key] = process.env[key];
    const next = vars[key];
    if (next === undefined) delete process.env[key];
    else process.env[key] = next;
  }
  const restore = () => {
    for (const key of Object.keys(saved)) {
      if (saved[key] === undefined) delete process.env[key];
      else process.env[key] = saved[key];
    }
  };
  try {
    const result = fn();
    if (result && typeof (result as Promise<void>).then === "function") {
      return (result as Promise<void>).finally(restore);
    }
    restore();
    return result;
  } catch (err) {
    restore();
    throw err;
  }
}

test("formatCursorAgentClientVersion prefixes cli-", () => {
  assert.equal(formatCursorAgentClientVersion("2026.07.08-0c04a8a"), "cli-2026.07.08-0c04a8a");
});

test("extractVersionIdFromResolvedPath reads versions/<id>", () => {
  assert.equal(
    extractVersionIdFromResolvedPath(
      "/home/u/.local/share/cursor-agent/versions/2026.07.08-0c04a8a/cursor-agent"
    ),
    "2026.07.08-0c04a8a"
  );
  assert.equal(extractVersionIdFromResolvedPath("/tmp/not-an-agent"), null);
});

test("newestVersionInDir picks lexicographically newest matching child", () => {
  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-ver-dir-"));
  try {
    fs.mkdirSync(path.join(tmp, "2026.05.24-dda726e"));
    fs.mkdirSync(path.join(tmp, "2026.07.08-0c04a8a"));
    fs.writeFileSync(path.join(tmp, "not-a-version"), "x");
    fs.mkdirSync(path.join(tmp, "3.9.0"));
    assert.equal(newestVersionInDir(tmp), "2026.07.08-0c04a8a");
  } finally {
    fs.rmSync(tmp, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
  }
});

test("detectCursorAgentCliVersionFromFs uses shim realpath under versions/<id>", () => {
  const home = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-home-shim-"));
  try {
    const id = "2026.06.01-abcdef0";
    const versionDir = path.join(home, ".local", "share", "cursor-agent", "versions", id);
    fs.mkdirSync(versionDir, { recursive: true });
    const binary = path.join(versionDir, "cursor-agent");
    fs.writeFileSync(binary, "#!/bin/sh\n");
    const binDir = path.join(home, ".local", "bin");
    fs.mkdirSync(binDir, { recursive: true });
    fs.symlinkSync(binary, path.join(binDir, "agent"));

    withEnv({ CURSOR_DATA_DIR: undefined, CURSOR_AGENT_CLI_VERSION: undefined }, () => {
      assert.equal(detectCursorAgentCliVersionFromFs(home), id);
    });
  } finally {
    fs.rmSync(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
  }
});

test("detectCursorAgentCliVersionFromFs uses CURSOR_DATA_DIR versions when no shim", () => {
  const home = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-home-empty-"));
  const data = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-data-"));
  try {
    const id = "2026.04.01-deadbeef";
    fs.mkdirSync(path.join(data, "versions", id), { recursive: true });
    withEnv({ CURSOR_DATA_DIR: data }, () => {
      assert.equal(detectCursorAgentCliVersionFromFs(home), id);
    });
  } finally {
    fs.rmSync(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
    fs.rmSync(data, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
  }
});

test("getCursorAgentCliVersion env override wins", async () => {
  await withEnv({ CURSOR_AGENT_CLI_VERSION: "2026.01.02-abc1234" }, async () => {
    resetCursorAgentCliVersionCache();
    assert.equal(await getCursorAgentCliVersion(), "2026.01.02-abc1234");
  });
  resetCursorAgentCliVersionCache();
});

test("getCursorAgentCliVersion ignores invalid env and uses pin when FS empty", async () => {
  const home = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-home-pin-"));
  const cacheDir = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-cache-pin-"));
  try {
    configureCursorAgentCliVersionForTests({
      cacheDir,
      fetchImpl: (async () => {
        throw new Error("offline");
      }) as typeof fetch,
    });
    await withEnv(
      {
        HOME: home,
        USERPROFILE: home,
        CURSOR_AGENT_CLI_VERSION: "3.9",
        CURSOR_DATA_DIR: undefined,
      },
      async () => {
        resetCursorAgentCliVersionCache();
        assert.equal(await getCursorAgentCliVersion(), CURSOR_AGENT_CLI_VERSION);
      }
    );
  } finally {
    resetCursorAgentCliVersionTestHooks();
    fs.rmSync(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
    fs.rmSync(cacheDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
  }
});

test("getCursorAgentCliVersion caches until reset", async () => {
  await withEnv({ CURSOR_AGENT_CLI_VERSION: "2026.02.03-111aaaa" }, async () => {
    resetCursorAgentCliVersionCache();
    assert.equal(await getCursorAgentCliVersion(), "2026.02.03-111aaaa");
    process.env.CURSOR_AGENT_CLI_VERSION = "2026.02.03-222bbbb";
    assert.equal(await getCursorAgentCliVersion(), "2026.02.03-111aaaa", "cached");
    resetCursorAgentCliVersionCache();
    assert.equal(await getCursorAgentCliVersion(), "2026.02.03-222bbbb");
  });
  resetCursorAgentCliVersionCache();
});

test("getCursorAgentCliVersion reads CURSOR_DATA_DIR via isolated HOME", async () => {
  const home = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-home-get-"));
  const data = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-data-get-"));
  try {
    const id = "2026.03.15-cafebabe";
    fs.mkdirSync(path.join(data, "versions", id), { recursive: true });
    await withEnv(
      {
        HOME: home,
        USERPROFILE: home,
        CURSOR_DATA_DIR: data,
        CURSOR_AGENT_CLI_VERSION: undefined,
      },
      async () => {
        resetCursorAgentCliVersionCache();
        assert.equal(await getCursorAgentCliVersion(), id);
        assert.equal(
          formatCursorAgentClientVersion(await getCursorAgentCliVersion()),
          `cli-${id}`
        );
      }
    );
  } finally {
    resetCursorAgentCliVersionCache();
    fs.rmSync(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
    fs.rmSync(data, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
  }
});

test("extractVersionIdFromInstallerScript reads downloads.cursor.com/lab/<id>/", () => {
  const script = `
    BASE="https://downloads.cursor.com/lab/2026.08.01-deadbeef/linux/x64"
    echo "$BASE"
  `;
  assert.equal(extractVersionIdFromInstallerScript(script), "2026.08.01-deadbeef");
  assert.equal(extractVersionIdFromInstallerScript("no version here"), null);
});

test("disk cache hit serves immediately without blocking on network", async () => {
  const cacheDir = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-cache-hit-"));
  const home = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-home-cache-"));
  let fetchCalls = 0;
  const cachedId = "2026.08.02-aabbcc1";
  try {
    configureCursorAgentCliVersionForTests({
      cacheDir,
      fetchImpl: (async () => {
        fetchCalls += 1;
        return new Response(`https://downloads.cursor.com/lab/2026.08.09-zzzzzzz/linux/x64/`, {
          status: 200,
        });
      }) as typeof fetch,
    });
    fs.writeFileSync(
      path.join(cacheDir, "cursor-agent-cli-version.json"),
      JSON.stringify({ version: cachedId, fetchedAt: Date.now() })
    );
    await withEnv(
      {
        HOME: home,
        USERPROFILE: home,
        CURSOR_AGENT_CLI_VERSION: undefined,
        CURSOR_DATA_DIR: undefined,
      },
      async () => {
        resetCursorAgentCliVersionCache();
        assert.equal(await getCursorAgentCliVersion(), cachedId);
        assert.equal(fetchCalls, 0, "must not block on network");
      }
    );
  } finally {
    resetCursorAgentCliVersionTestHooks();
    fs.rmSync(cacheDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
    fs.rmSync(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
  }
});

test("refreshCursorAgentCliVersionFromInstaller writes disk cache from HTML", async () => {
  const cacheDir = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-cache-refresh-"));
  const scrapedId = "2026.08.03-1122334";
  try {
    configureCursorAgentCliVersionForTests({
      cacheDir,
      fetchImpl: (async () =>
        new Response(
          `curl -fsSL https://downloads.cursor.com/lab/${scrapedId}/darwin/arm64/agent-cli-package.tar.gz`,
          { status: 200 }
        )) as typeof fetch,
    });
    resetCursorAgentCliVersionCache();
    const id = await refreshCursorAgentCliVersionFromInstaller();
    assert.equal(id, scrapedId);
    const onDisk = JSON.parse(
      fs.readFileSync(path.join(cacheDir, "cursor-agent-cli-version.json"), "utf8")
    ) as { version: string };
    assert.equal(onDisk.version, scrapedId);
  } finally {
    resetCursorAgentCliVersionTestHooks();
    fs.rmSync(cacheDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
  }
});

test("invalid installer HTML falls through to pin", async () => {
  const cacheDir = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-cache-invalid-"));
  const home = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-home-invalid-"));
  try {
    configureCursorAgentCliVersionForTests({
      cacheDir,
      fetchImpl: (async () => new Response("<html>no lab url</html>", { status: 200 })) as typeof fetch,
    });
    await withEnv(
      {
        HOME: home,
        USERPROFILE: home,
        CURSOR_AGENT_CLI_VERSION: undefined,
        CURSOR_DATA_DIR: undefined,
      },
      async () => {
        resetCursorAgentCliVersionCache();
        assert.equal(await getCursorAgentCliVersion(), CURSOR_AGENT_CLI_VERSION);
      }
    );
    const id = await refreshCursorAgentCliVersionFromInstaller();
    assert.equal(id, null);
  } finally {
    resetCursorAgentCliVersionTestHooks();
    fs.rmSync(cacheDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
    fs.rmSync(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
  }
});

function installerHtml(id: string): string {
  return `DOWNLOAD_URL="https://downloads.cursor.com/lab/${id}/\${OS}/\${ARCH}/agent-cli-package.tar.gz"`;
}

test("fetched install version newer than the pin is returned", async () => {
  const cacheDir = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-cache-newer-"));
  const home = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-home-newer-"));
  const fetchedId = "2026.10.01-e373342";
  try {
    configureCursorAgentCliVersionForTests({
      cacheDir,
      fetchImpl: (async () => new Response(installerHtml(fetchedId), { status: 200 })) as typeof fetch,
    });
    await withEnv(
      {
        HOME: home,
        USERPROFILE: home,
        CURSOR_AGENT_CLI_VERSION: undefined,
        CURSOR_DATA_DIR: undefined,
      },
      async () => {
        resetCursorAgentCliVersionCache();
        assert.equal(await getCursorAgentCliVersion(), "2026.07.08-0c04a8a");
        assert.equal(await refreshCursorAgentCliVersionFromInstaller(), fetchedId);
        assert.equal(await getCursorAgentCliVersion(), fetchedId);
      }
    );
  } finally {
    resetCursorAgentCliVersionTestHooks();
    fs.rmSync(cacheDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
    fs.rmSync(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
  }
});

test("rejected install fetch keeps the pin", async () => {
  const cacheDir = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-cache-reject-"));
  const home = fs.mkdtempSync(path.join(os.tmpdir(), "cursor-cli-home-reject-"));
  try {
    configureCursorAgentCliVersionForTests({
      cacheDir,
      fetchImpl: (async () => {
        throw new Error("network down");
      }) as typeof fetch,
    });
    await withEnv(
      {
        HOME: home,
        USERPROFILE: home,
        CURSOR_AGENT_CLI_VERSION: undefined,
        CURSOR_DATA_DIR: undefined,
      },
      async () => {
        resetCursorAgentCliVersionCache();
        assert.equal(await getCursorAgentCliVersion(), CURSOR_AGENT_CLI_VERSION);
      }
    );
  } finally {
    resetCursorAgentCliVersionTestHooks();
    fs.rmSync(cacheDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
    fs.rmSync(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
  }
});