import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import fs from "node:fs/promises"; import os from "node:os"; import path from "node:path"; import { runChildProcess } from "@paperclipai/adapter-utils/server-utils"; import { testEnvironment } from "@paperclipai/adapter-cursor-local/server"; async function writeFakeAgentCommand(binDir: string, argsCapturePath: string): Promise { const commandPath = path.join(binDir, "agent"); const script = `#!/usr/bin/env node const fs = require("node:fs"); const outPath = process.env.PAPERCLIP_TEST_ARGS_PATH; if (outPath) { fs.writeFileSync(outPath, JSON.stringify(process.argv.slice(2)), "utf8"); } console.log(JSON.stringify({ type: "assistant", message: { content: [{ type: "output_text", text: "hello" }] }, })); console.log(JSON.stringify({ type: "result", subtype: "success", result: "hello", })); `; await fs.writeFile(commandPath, script, "utf8"); await fs.chmod(commandPath, 0o755); return commandPath; } async function writeFakeCursorAgentCommand(commandPath: string): Promise { const script = `#!/usr/bin/env node const fs = require("node:fs"); const outPath = process.env.PAPERCLIP_TEST_ARGS_PATH; if (outPath) { fs.writeFileSync(outPath, JSON.stringify({ command: process.argv[1], argv: process.argv.slice(2), path: process.env.PATH || "", }), "utf8"); } console.log(JSON.stringify({ type: "assistant", message: { content: [{ type: "output_text", text: "hello" }] }, })); console.log(JSON.stringify({ type: "result", subtype: "success", result: "hello", })); `; await fs.mkdir(path.dirname(commandPath), { recursive: true }); await fs.writeFile(commandPath, script, "utf8"); await fs.chmod(commandPath, 0o755); } function createLocalSandboxRunner() { let counter = 0; return { execute: async (input: { command: string; args?: string[]; cwd?: string; env?: Record; stdin?: string; timeoutMs?: number; onLog?: (stream: "stdout" | "stderr", chunk: string) => Promise; onSpawn?: (meta: { pid: number; startedAt: string }) => Promise; }) => { counter += 1; return await runChildProcess(`cursor-sandbox-env-${counter}`, input.command, input.args ?? [], { cwd: input.cwd ?? process.cwd(), env: input.env ?? {}, stdin: input.stdin, timeoutSec: Math.max(1, Math.ceil((input.timeoutMs ?? 30_000) / 1000)), graceSec: 5, onLog: input.onLog ?? (async () => {}), onSpawn: input.onSpawn ? async (meta) => input.onSpawn?.({ pid: meta.pid, startedAt: meta.startedAt }) : undefined, }); }, }; } describe("cursor environment diagnostics", () => { beforeEach(() => { vi.stubEnv("CURSOR_API_KEY", ""); }); afterEach(() => { vi.unstubAllEnvs(); }); it("creates a missing working directory when cwd is absolute", async () => { const cwd = path.join( os.tmpdir(), `paperclip-cursor-local-cwd-${Date.now()}-${Math.random().toString(16).slice(2)}`, "workspace", ); await fs.rm(path.dirname(cwd), { recursive: true, force: true }); const result = await testEnvironment({ companyId: "company-1", adapterType: "cursor", config: { command: process.execPath, cwd, }, }); expect(result.checks.some((check) => check.code === "cursor_cwd_valid")).toBe(true); expect(result.checks.some((check) => check.level === "error")).toBe(false); const stats = await fs.stat(cwd); expect(stats.isDirectory()).toBe(true); await fs.rm(path.dirname(cwd), { recursive: true, force: true }); }); it("adds --yolo to hello probe args by default", async () => { const root = path.join( os.tmpdir(), `paperclip-cursor-local-probe-${Date.now()}-${Math.random().toString(16).slice(2)}`, ); const binDir = path.join(root, "bin"); const cwd = path.join(root, "workspace"); const argsCapturePath = path.join(root, "args.json"); await fs.mkdir(binDir, { recursive: true }); await writeFakeAgentCommand(binDir, argsCapturePath); const result = await testEnvironment({ companyId: "company-1", adapterType: "cursor", config: { command: "agent", cwd, env: { CURSOR_API_KEY: "test-key", PAPERCLIP_TEST_ARGS_PATH: argsCapturePath, PATH: `${binDir}${path.delimiter}${process.env.PATH ?? ""}`, }, }, }); expect(result.status).toBe("pass"); const args = JSON.parse(await fs.readFile(argsCapturePath, "utf8")) as string[]; expect(args).toContain("--yolo"); await fs.rm(root, { recursive: true, force: true }); }); it("does not auto-add --yolo when extraArgs already bypass trust", async () => { const root = path.join( os.tmpdir(), `paperclip-cursor-local-probe-extra-${Date.now()}-${Math.random().toString(16).slice(2)}`, ); const binDir = path.join(root, "bin"); const cwd = path.join(root, "workspace"); const argsCapturePath = path.join(root, "args.json"); await fs.mkdir(binDir, { recursive: true }); await writeFakeAgentCommand(binDir, argsCapturePath); const result = await testEnvironment({ companyId: "company-1", adapterType: "cursor", config: { command: "agent", cwd, extraArgs: ["--yolo"], env: { CURSOR_API_KEY: "test-key", PAPERCLIP_TEST_ARGS_PATH: argsCapturePath, PATH: `${binDir}${path.delimiter}${process.env.PATH ?? ""}`, }, }, }); expect(result.status).toBe("pass"); const args = JSON.parse(await fs.readFile(argsCapturePath, "utf8")) as string[]; expect(args).toContain("--yolo"); expect(args).not.toContain("--trust"); await fs.rm(root, { recursive: true, force: true }); }); it("prefers ~/.local/bin/cursor-agent for remote sandbox probes when using the default command", async () => { const root = path.join( os.tmpdir(), `paperclip-cursor-sandbox-probe-${Date.now()}-${Math.random().toString(16).slice(2)}`, ); const homeDir = path.join(root, "home"); const remoteCwd = path.join(root, "workspace"); const argsCapturePath = path.join(root, "args.json"); const cursorAgentPath = path.join(homeDir, ".local", "bin", "cursor-agent"); await fs.mkdir(remoteCwd, { recursive: true }); await writeFakeCursorAgentCommand(cursorAgentPath); const previousHome = process.env.HOME; process.env.HOME = homeDir; try { const result = await testEnvironment({ companyId: "company-1", adapterType: "cursor", executionTarget: { kind: "remote", transport: "sandbox", remoteCwd, runner: createLocalSandboxRunner(), timeoutMs: 30_000, }, config: { command: "agent", cwd: remoteCwd, env: { CURSOR_API_KEY: "test-key", PAPERCLIP_TEST_ARGS_PATH: argsCapturePath, }, }, }); expect(result.status).toBe("pass"); const capture = JSON.parse(await fs.readFile(argsCapturePath, "utf8")) as { command: string; argv: string[]; path: string; }; expect(capture.command).toBe(cursorAgentPath); expect(capture.path.split(":")[0]).toBe(path.join(homeDir, ".local", "bin")); } finally { if (previousHome === undefined) delete process.env.HOME; else process.env.HOME = previousHome; await fs.rm(root, { recursive: true, force: true }); } }); it("emits cursor_native_auth_present when cli-config.json has authInfo and CURSOR_API_KEY is unset", async () => { const root = path.join( os.tmpdir(), `paperclip-cursor-auth-${Date.now()}-${Math.random().toString(16).slice(2)}`, ); const cursorHome = path.join(root, ".cursor"); const cwd = path.join(root, "workspace"); try { await fs.mkdir(cursorHome, { recursive: true }); await fs.writeFile( path.join(cursorHome, "cli-config.json"), JSON.stringify({ authInfo: { email: "test@example.com", displayName: "Test User", userId: 12345, }, }), ); const result = await testEnvironment({ companyId: "company-1", adapterType: "cursor", config: { command: process.execPath, cwd, env: { CURSOR_HOME: cursorHome }, }, }); expect(result.checks.some((check) => check.code === "cursor_native_auth_present")).toBe(true); expect(result.checks.some((check) => check.code === "cursor_api_key_missing")).toBe(false); const authCheck = result.checks.find((check) => check.code === "cursor_native_auth_present"); expect(authCheck?.detail).toContain("test@example.com"); } finally { await fs.rm(root, { recursive: true, force: true }); } }); it("emits cursor_api_key_missing when neither env var nor native auth exists", async () => { const root = path.join( os.tmpdir(), `paperclip-cursor-noauth-${Date.now()}-${Math.random().toString(16).slice(2)}`, ); const cursorHome = path.join(root, ".cursor"); const cwd = path.join(root, "workspace"); try { await fs.mkdir(cursorHome, { recursive: true }); // No cli-config.json written const result = await testEnvironment({ companyId: "company-1", adapterType: "cursor", config: { command: process.execPath, cwd, env: { CURSOR_HOME: cursorHome }, }, }); expect(result.checks.some((check) => check.code === "cursor_api_key_missing")).toBe(true); expect(result.checks.some((check) => check.code === "cursor_native_auth_present")).toBe(false); } finally { await fs.rm(root, { recursive: true, force: true }); } }); });