@kynver-app/runtime 0.1.0 → 0.1.2

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

@@ -698,9 +698,58 @@ var claudeProvider = {
   }
 };
 
+// src/providers/cursor.ts
+import { closeSync as closeSync2, openSync as openSync2 } from "node:fs";
+import { spawn as spawn2 } from "node:child_process";
+var DEFAULT_CURSOR_MODEL = "composer-2.5";
+function resolveAgentBin() {
+  return process.env.KYNVER_CURSOR_AGENT_BIN?.trim() || process.env.CURSOR_AGENT_BIN?.trim() || "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 child = spawn2(
+      agentBin,
+      [
+        "-p",
+        "--force",
+        "--trust",
+        "--workspace",
+        opts.worktreePath,
+        "--output-format",
+        "stream-json",
+        "--stream-partial-output",
+        "--model",
+        model,
+        opts.prompt
+      ],
+      {
+        cwd: opts.worktreePath,
+        detached: true,
+        stdio: ["ignore", stdoutFd, stderrFd],
+        env: process.env
+      }
+    );
+    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) {
@@ -1414,14 +1463,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",
@@ -1433,8 +1482,15 @@ function usage(code = 0) {
 async function main(argv = process.argv.slice(2)) {
   if (argv.length === 0 || isHelpFlag(argv[0])) return usage(0);
   const scope = argv.shift();
-  const action = argv.shift();
-  const args = parseArgs(argv);
+  let action;
+  let rest;
+  if (scope === "run" || scope === "worker") {
+    action = argv.shift();
+    rest = argv;
+  } else {
+    rest = argv;
+  }
+  const args = parseArgs(rest);
   const { runsDir, worktreesDir } = getPaths();
   mkdirSync5(runsDir, { recursive: true });
   mkdirSync5(worktreesDir, { recursive: true });