@kynver-app/runtime 0.1.1 → 0.1.3

package/README.md

@@ -26,7 +26,18 @@ login | setup | daemon
 
 ## Worker providers
 
-Default provider: `claude` (`workerProvider` in `~/.kynver/config.json`). Provider interface lives in `src/providers/`.
+Set once in `kynver setup --provider claude|cursor` (stored in `~/.kynver/config.json` as `workerProvider`).
+
+| Provider | CLI | Auth |
+| --- | --- | --- |
+| `claude` (default) | `claude` on PATH | `claude login` (OAuth). `ANTHROPIC_API_KEY` is stripped from worker env so OAuth wins. |
+| `cursor` | `agent` on PATH ([Cursor Agent CLI](https://cursor.com/docs/cli/headless)) | `agent login` (OAuth) **or** `CURSOR_API_KEY` for headless runners. |
+
+Override per invocation: `kynver worker start ... --provider cursor`
+
+Install Cursor CLI (Windows PowerShell): `irm 'https://cursor.com/install?win32=true' | iex`
+
+Default Cursor model: `composer-2.5`. Override with `--model` on dispatch/worker start.
 
 ## Tests
 

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import { mkdirSync as mkdirSync5 } from "node:fs";
-import path12 from "node:path";
+import path13 from "node:path";
 import { fileURLToPath } from "node:url";
 
 // src/config.ts
@@ -243,12 +243,12 @@ var DEFAULT_CRITICAL_FREE_BYTES = 15 * 1024 * 1024 * 1024;
 var DEFAULT_MAX_USED_PERCENT = 80;
 var DEFAULT_HARD_MAX_USED_PERCENT = 90;
 function observeRunnerDiskGate(input = {}) {
-  const path13 = input.diskPath?.trim() || "/";
+  const path14 = input.diskPath?.trim() || "/";
   const warnBelowBytes = input.diskFreeWarnBytes ?? DEFAULT_WARN_FREE_BYTES;
   const criticalBelowBytes = input.diskFreeCriticalBytes ?? DEFAULT_CRITICAL_FREE_BYTES;
   const maxUsedPercent = input.diskMaxUsedPercent ?? DEFAULT_MAX_USED_PERCENT;
   const hardMaxUsedPercent = input.diskHardMaxUsedPercent ?? DEFAULT_HARD_MAX_USED_PERCENT;
-  const stats = statfsSync(path13);
+  const stats = statfsSync(path14);
   const freeBytes = Number(stats.bavail) * Number(stats.bsize);
   const totalBytes = Number(stats.blocks) * Number(stats.bsize);
   const usedPercent = totalBytes > 0 ? (totalBytes - freeBytes) / totalBytes * 100 : 100;
@@ -268,7 +268,7 @@ function observeRunnerDiskGate(input = {}) {
   }
   return {
     ok,
-    path: path13,
+    path: path14,
     freeBytes,
     totalBytes,
     usedPercent,
@@ -379,7 +379,8 @@ function parseClaudeStream(file) {
   for (const line of lines) {
     const event = safeJson(line);
     if (!event) continue;
-    const ts = event.timestamp || event.ts;
+    const tsMs = event.timestamp_ms;
+    const ts = event.timestamp || event.ts || (tsMs ? new Date(tsMs).toISOString() : void 0);
     if (ts) {
       result.firstEventAt ||= ts;
       result.lastEventAt = ts;
@@ -638,8 +639,8 @@ function observeRunnerResourceGate(input) {
 }
 
 // src/supervisor.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync3 } from "node:fs";
-import path6 from "node:path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync3 } from "node:fs";
+import path7 from "node:path";
 
 // src/prompt.ts
 function buildPrompt(input) {
@@ -698,9 +699,97 @@ var claudeProvider = {
   }
 };
 
+// src/providers/cursor.ts
+import { closeSync as closeSync2, existsSync as existsSync6, openSync as openSync2, readdirSync as readdirSync2 } from "node:fs";
+import { spawn as spawn2 } from "node:child_process";
+import path6 from "node:path";
+var DEFAULT_CURSOR_MODEL = "composer-2.5";
+function latestVersionDir(versionsRoot) {
+  if (!existsSync6(versionsRoot)) return null;
+  const versions = readdirSync2(versionsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory() && /^\d{4}\.\d/.test(entry.name)).map((entry) => entry.name).sort((a, b) => b.localeCompare(a));
+  return versions[0] ? path6.join(versionsRoot, versions[0]) : null;
+}
+function resolveBundledCursor(versionDir) {
+  const nodeExe = path6.join(versionDir, "node.exe");
+  const indexJs = path6.join(versionDir, "index.js");
+  if (!existsSync6(nodeExe) || !existsSync6(indexJs)) return null;
+  return { executable: nodeExe, prefixArgs: [indexJs], shell: false, detached: true };
+}
+function resolveWindowsCursorSpawn(agentBin) {
+  const agentRoot = path6.dirname(agentBin);
+  const direct = resolveBundledCursor(agentRoot);
+  if (direct) return direct;
+  const versionDir = latestVersionDir(path6.join(agentRoot, "versions"));
+  return versionDir ? resolveBundledCursor(versionDir) : null;
+}
+function resolveCursorSpawn(agentBin) {
+  if (process.platform === "win32" && /\.(cmd|bat)$/i.test(agentBin)) {
+    const bundled = resolveWindowsCursorSpawn(agentBin);
+    if (bundled) return bundled;
+    return { executable: agentBin, prefixArgs: [], shell: true, detached: false };
+  }
+  return { executable: agentBin, prefixArgs: [], shell: false, detached: true };
+}
+function resolveAgentBin() {
+  const configured = process.env.KYNVER_CURSOR_AGENT_BIN?.trim() || process.env.CURSOR_AGENT_BIN?.trim();
+  if (configured) return configured;
+  if (process.platform === "win32") {
+    const localAgent = path6.join(process.env.LOCALAPPDATA || "", "cursor-agent", "agent.cmd");
+    if (existsSync6(localAgent)) return localAgent;
+  }
+  return "agent";
+}
+var cursorProvider = {
+  name: "cursor",
+  start(opts) {
+    const model = opts.model || DEFAULT_CURSOR_MODEL;
+    const stdoutFd = openSync2(opts.stdoutPath, "a");
+    const stderrFd = openSync2(opts.stderrPath, "a");
+    const agentBin = resolveAgentBin();
+    const spawnTarget = resolveCursorSpawn(agentBin);
+    const child = spawn2(
+      spawnTarget.executable,
+      [
+        ...spawnTarget.prefixArgs,
+        "-p",
+        "--force",
+        "--trust",
+        "--workspace",
+        opts.worktreePath,
+        "--output-format",
+        "stream-json",
+        "--stream-partial-output",
+        "--model",
+        model,
+        opts.prompt
+      ],
+      {
+        cwd: opts.worktreePath,
+        detached: spawnTarget.detached,
+        shell: spawnTarget.shell,
+        stdio: ["ignore", stdoutFd, stderrFd],
+        env: {
+          ...process.env,
+          ...spawnTarget.prefixArgs.length > 0 ? { CURSOR_INVOKED_AS: path6.basename(agentBin) } : {}
+        }
+      }
+    );
+    closeSync2(stdoutFd);
+    closeSync2(stderrFd);
+    if (!child.pid) {
+      throw new Error(
+        `failed to spawn Cursor agent worker (is \`${agentBin}\` on PATH? run \`agent login\` or set CURSOR_API_KEY)`
+      );
+    }
+    child.unref();
+    return { pid: child.pid, model };
+  }
+};
+
 // src/providers/registry.ts
 var BUILTIN = {
-  claude: claudeProvider
+  claude: claudeProvider,
+  cursor: cursorProvider
 };
 var overrideProvider = null;
 function resolveWorkerProvider(name) {
@@ -720,16 +809,16 @@ function spawnWorkerProcess(run, opts) {
   if (run.workers?.[name]) throw new Error(`worker already exists in run ${run.id}: ${name}`);
   if (!opts.task) throw new Error(`missing task text for worker ${name}`);
   const { worktreesDir } = getPaths();
-  const workerDir = path6.join(runDirectory(run.id), "workers", name);
+  const workerDir = path7.join(runDirectory(run.id), "workers", name);
   mkdirSync3(workerDir, { recursive: true });
-  const worktreePath = path6.join(worktreesDir, run.id, name);
+  const worktreePath = path7.join(worktreesDir, run.id, name);
   const branch = opts.branch || `agent/${run.id}/${name}`;
-  if (existsSync6(worktreePath)) throw new Error(`worktree path already exists: ${worktreePath}`);
+  if (existsSync7(worktreePath)) throw new Error(`worktree path already exists: ${worktreePath}`);
   git(run.repo, ["fetch", "origin", "--prune"], { allowFailure: true });
   git(run.repo, ["worktree", "add", "-b", branch, worktreePath, run.baseCommit], { throwError: true });
-  const stdoutPath = path6.join(workerDir, "stdout.jsonl");
-  const stderrPath = path6.join(workerDir, "stderr.log");
-  const heartbeatPath = path6.join(workerDir, "heartbeat.jsonl");
+  const stdoutPath = path7.join(workerDir, "stdout.jsonl");
+  const stderrPath = path7.join(workerDir, "stderr.log");
+  const heartbeatPath = path7.join(workerDir, "heartbeat.jsonl");
   const prompt = buildPrompt({
     task: opts.task,
     ownedPaths: opts.ownedPaths || [],
@@ -778,7 +867,7 @@ function spawnWorkerProcess(run, opts) {
     startedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   saveWorker(run.id, worker);
-  run.workers = { ...run.workers || {}, [name]: { workerDir, statusPath: path6.join(workerDir, "worker.json") } };
+  run.workers = { ...run.workers || {}, [name]: { workerDir, statusPath: path7.join(workerDir, "worker.json") } };
   run.status = "running";
   saveRun(run);
   return worker;
@@ -974,7 +1063,7 @@ async function dispatchRun(args) {
 }
 
 // src/sweep.ts
-import path7 from "node:path";
+import path8 from "node:path";
 async function sweepRun(args) {
   const pipeline = args.pipeline === true || args.pipeline === "true";
   try {
@@ -986,7 +1075,7 @@ async function sweepRun(args) {
     const releasedLocalOrphans = [];
     for (const name of Object.keys(run.workers || {})) {
       const worker = readJson(
-        path7.join(runDirectory(run.id), "workers", safeSlug(name), "worker.json"),
+        path8.join(runDirectory(run.id), "workers", safeSlug(name), "worker.json"),
         null
       );
       if (!worker || !worker.dispatched || !worker.taskId) continue;
@@ -1029,11 +1118,11 @@ async function sweepRun(args) {
 }
 
 // src/worktree.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync4 } from "node:fs";
-import path9 from "node:path";
+import { existsSync as existsSync8, mkdirSync as mkdirSync4 } from "node:fs";
+import path10 from "node:path";
 
 // src/validate.ts
-import path8 from "node:path";
+import path9 from "node:path";
 var RUN_ID_RE = /^[a-z0-9][a-z0-9._-]{0,127}$/i;
 function validateRunId(runId) {
   const trimmed = runId.trim();
@@ -1041,7 +1130,7 @@ function validateRunId(runId) {
   return trimmed;
 }
 function validateRepo(repo) {
-  const resolved = path8.resolve(repo);
+  const resolved = path9.resolve(repo);
   if (resolved.includes("..")) throw new Error("repo path must not contain .. segments");
   return resolved;
 }
@@ -1052,7 +1141,7 @@ function createRun(args) {
   ensureGitRepo(repo);
   const id = args.id ? validateRunId(String(args.id)) : timestampSlug(String(args.name || "run"));
   const dir = runDirectory(id);
-  if (existsSync7(dir)) failExists(`run already exists: ${id}`);
+  if (existsSync8(dir)) failExists(`run already exists: ${id}`);
   mkdirSync4(dir, { recursive: true });
   const base = String(args.base || "origin/main");
   const baseCommit = git(repo, ["rev-parse", base]).trim();
@@ -1066,12 +1155,12 @@ function createRun(args) {
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     workers: {}
   };
-  writeJson(path9.join(dir, "run.json"), run);
+  writeJson(path10.join(dir, "run.json"), run);
   console.log(JSON.stringify({ runId: id, runDir: dir, repo, base, baseCommit }, null, 2));
 }
 function listRuns() {
   const { runsDir } = getPaths();
-  const rows = listRunIds(runsDir).map((id) => readJson(path9.join(runDirectory(id), "run.json"), null)).filter(Boolean).map((run) => ({
+  const rows = listRunIds(runsDir).map((id) => readJson(path10.join(runDirectory(id), "run.json"), null)).filter(Boolean).map((run) => ({
     id: run.id,
     name: run.name,
     status: run.status,
@@ -1086,7 +1175,7 @@ function failExists(message) {
 }
 
 // src/worker-ops.ts
-import path10 from "node:path";
+import path11 from "node:path";
 async function tryCompleteWorker(args) {
   const worker = loadWorker(String(args.run), String(args.name));
   const status = computeWorkerStatus(worker);
@@ -1179,7 +1268,7 @@ async function completeWorker(args) {
 function workerStatus(args) {
   const worker = loadWorker(String(args.run), String(args.name));
   const status = computeWorkerStatus(worker);
-  writeJson(path10.join(worker.workerDir, "last-status.json"), status);
+  writeJson(path11.join(worker.workerDir, "last-status.json"), status);
   console.log(JSON.stringify(status, null, 2));
 }
 function runStatus(args) {
@@ -1187,7 +1276,7 @@ function runStatus(args) {
   const names = Object.keys(run.workers || {});
   const workers = names.map((name) => {
     const worker = readJson(
-      path10.join(runDirectory(run.id), "workers", safeSlug(name), "worker.json"),
+      path11.join(runDirectory(run.id), "workers", safeSlug(name), "worker.json"),
       null
     );
     if (!worker) {
@@ -1219,7 +1308,7 @@ function runStatus(args) {
     needsAttention: workers.filter((w) => w.attention && w.attention !== "ok" && w.attention !== "done").map((w) => w.worker),
     workers
   };
-  writeJson(path10.join(runDirectory(run.id), "last-board.json"), board);
+  writeJson(path11.join(runDirectory(run.id), "last-board.json"), board);
   console.log(JSON.stringify(board, null, 2));
 }
 function tailWorker(args) {
@@ -1252,7 +1341,7 @@ function stopWorker(args) {
 }
 
 // src/pipeline-tick.ts
-import path11 from "node:path";
+import path12 from "node:path";
 
 // src/workspace-runtime-config.ts
 async function fetchWorkspaceRuntimePreferences(agentOsId, args) {
@@ -1281,7 +1370,7 @@ async function completeFinishedWorkers(runId, args) {
   const outcomes = [];
   for (const name of Object.keys(run.workers || {})) {
     const worker = readJson(
-      path11.join(runDirectory(run.id), "workers", safeSlug(name), "worker.json"),
+      path12.join(runDirectory(run.id), "workers", safeSlug(name), "worker.json"),
       null
     );
     if (!worker?.dispatched || !worker.taskId) continue;
@@ -1414,14 +1503,14 @@ function usage(code = 0) {
     [
       "Usage:",
       "  kynver login --api-key KEY",
-      "  kynver setup [--api-base-url URL] [--agent-os-id ID] [--agent-os-slug SLUG] [--repo PATH] [--max-workers N]",
+      "  kynver setup [--api-base-url URL] [--agent-os-id ID] [--agent-os-slug SLUG] [--repo PATH] [--max-workers N] [--provider claude|cursor]",
       "  kynver daemon --run RUN_ID --agent-os-id AOS_ID [--execute] [--interval-ms MS]",
       "  kynver run create --repo /path/repo [--name name] [--base origin/main]",
       "  kynver run list",
       "  kynver run status --run RUN_ID",
       "  kynver run dispatch --run RUN_ID --agent-os-id AOS_ID [--base-url URL] [--secret SECRET] [--execute] [--lane any|implementation|review|landing] [--max-starts 1] [--lease-ms MS] [--owned path[,path]] [--model claude-opus-4-7] [--disk-path /]",
       "  kynver run sweep --run RUN_ID --agent-os-id AOS_ID [--base-url URL] [--secret SECRET] [--grace-ms MS]",
-      '  kynver worker start --run RUN_ID --name worker --task "..." [--owned path[,path]] [--model claude-opus-4-7] [--agent-os-id AOS_ID] [--task-id TASK_ID]',
+      '  kynver worker start --run RUN_ID --name worker --task "..." [--owned path[,path]] [--model MODEL] [--provider claude|cursor] [--agent-os-id AOS_ID] [--task-id TASK_ID]',
       "  kynver worker status --run RUN_ID --name worker",
       "  kynver worker tail --run RUN_ID --name worker [--lines 40] [--raw]",
       "  kynver worker stop --run RUN_ID --name worker",
@@ -1460,7 +1549,7 @@ async function main(argv = process.argv.slice(2)) {
   if (scope === "worker" && action === "complete") return void await completeWorker(args);
   unknownCommand(scope, action);
 }
-var isCliEntry = process.argv[1] && path12.resolve(process.argv[1]) === path12.resolve(fileURLToPath(import.meta.url));
+var isCliEntry = process.argv[1] && path13.resolve(process.argv[1]) === path13.resolve(fileURLToPath(import.meta.url));
 if (isCliEntry) {
   void main().catch((error) => {
     console.error(error);