@sumeru/adapter-cursor-agent 0.1.0

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 shazhou
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
+associated documentation files (the "Software"), to deal in the Software without restriction, including 
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the 
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial 
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT 
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO 
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/.build-fingerprint

@@ -0,0 +1 @@
+e371c4a1fc9f2b118a38850ede13ff6ceeab014e825e4e0e60880bd531f04df1

package/dist/adapter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Cursor Agent adapter — implements the `Adapter` contract from `@sumeru/core`
+ * by shelling out to `cursor-agent -p <prompt> --print --output-format
+ * stream-json --trust --force --workspace <cwd>` for create/send and parsing
+ * the resulting NDJSON stream into `Turn[]`.
+ *
+ * cursor-agent does NOT expose a stable on-disk session DB; the adapter
+ * therefore caches parsed turns in an in-memory `Map<string, Turn[]>` keyed by
+ * `nativeId` and is the sole authority on history for the lifetime of the
+ * adapter instance.
+ *
+ * The factory:
+ *   - createSession spawns `cursor-agent -p "ping" --print
+ *     --output-format stream-json --trust --force --workspace <cwd>` and
+ *     parses the `system` line for the session id. Accepts `SessionConfig`
+ *     with `model` and `cwd` fields; always uses a fixed "ping" prompt.
+ *   - send is an async generator that spawns `cursor-agent -p <content>
+ *     --resume <id> ...`, rewrites the per-run turn indices so they are
+ *     globally monotonic across the whole `nativeId` lifetime, and yields
+ *     `SendEvent`s (`turn`, `done`, or `error`).
+ *   - close is a logical close — adds the nativeId to a per-instance Set; no
+ *     cursor-agent-side notification, no cache eviction.
+ *   - getTurns returns a defensive copy of the in-memory cache.
+ */
+import type { Adapter } from "@sumeru/core";
+import type { CursorAgentAdapterOptions } from "./types.js";
+export declare function createCursorAgentAdapter(options?: Partial<CursorAgentAdapterOptions>): Adapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACX,OAAO,EAMP,MAAM,cAAc,CAAC;AAMtB,OAAO,KAAK,EACX,yBAAyB,EAOzB,MAAM,YAAY,CAAC;AAsBpB,wBAAgB,wBAAwB,CACvC,OAAO,GAAE,OAAO,CAAC,yBAAyB,CAAM,GAC9C,OAAO,CA8ST"}

package/dist/adapter.js

@@ -0,0 +1,350 @@
+/**
+ * Cursor Agent adapter — implements the `Adapter` contract from `@sumeru/core`
+ * by shelling out to `cursor-agent -p <prompt> --print --output-format
+ * stream-json --trust --force --workspace <cwd>` for create/send and parsing
+ * the resulting NDJSON stream into `Turn[]`.
+ *
+ * cursor-agent does NOT expose a stable on-disk session DB; the adapter
+ * therefore caches parsed turns in an in-memory `Map<string, Turn[]>` keyed by
+ * `nativeId` and is the sole authority on history for the lifetime of the
+ * adapter instance.
+ *
+ * The factory:
+ *   - createSession spawns `cursor-agent -p "ping" --print
+ *     --output-format stream-json --trust --force --workspace <cwd>` and
+ *     parses the `system` line for the session id. Accepts `SessionConfig`
+ *     with `model` and `cwd` fields; always uses a fixed "ping" prompt.
+ *   - send is an async generator that spawns `cursor-agent -p <content>
+ *     --resume <id> ...`, rewrites the per-run turn indices so they are
+ *     globally monotonic across the whole `nativeId` lifetime, and yields
+ *     `SendEvent`s (`turn`, `done`, or `error`).
+ *   - close is a logical close — adds the nativeId to a per-instance Set; no
+ *     cursor-agent-side notification, no cache eviction.
+ *   - getTurns returns a defensive copy of the in-memory cache.
+ */
+import { defaultSpawn, defaultStreamingSpawn } from "./spawn.js";
+import { parseStreamJson, parseStreamJsonIncremental, } from "./stream-parser.js";
+const DEFAULT_CURSOR_AGENT_BIN = "cursor-agent";
+const DEFAULT_CREATE_TIMEOUT_MS = 5 * 60_000;
+const DEFAULT_SEND_TIMEOUT_MS = 10 * 60_000;
+const STDERR_TRUNCATE_LIMIT = 500;
+const API_KEY_ERROR_MESSAGE = "cursor-agent API key error. Check your CURSOR_API_KEY configuration.";
+const TRUST_ERROR_MESSAGE = "cursor-agent requires --trust for headless operation.";
+const API_KEY_PATTERNS = [
+    /CURSOR_API_KEY/i,
+    /authentication/i,
+    /unauthorized/i,
+    /api.?key/i,
+];
+const TRUST_PATTERNS = [
+    /trust/i,
+    /untrusted/i,
+    /workspace not trusted/i,
+];
+export function createCursorAgentAdapter(options = {}) {
+    const cursorAgentBin = options.cursorAgentBin ?? DEFAULT_CURSOR_AGENT_BIN;
+    const defaultModel = options.model ?? null;
+    const cwd = options.cwd ?? null;
+    const createSessionTimeoutMs = options.createSessionTimeoutMs ?? DEFAULT_CREATE_TIMEOUT_MS;
+    const sendTimeoutMs = options.sendTimeoutMs ?? DEFAULT_SEND_TIMEOUT_MS;
+    const spawnFn = options.spawnFn ?? defaultSpawn;
+    const streamingSpawnFn = options.streamingSpawnFn ?? defaultStreamingSpawn;
+    const permissionMode = options.permissionMode ?? "force";
+    const sandbox = options.sandbox ?? null;
+    const turnsCache = new Map();
+    const closedRefs = new Set();
+    const sendLocks = new Map();
+    function resolveCwd() {
+        return cwd ?? process.cwd();
+    }
+    function buildArgs(prompt, resumeId, model, spawnCwd) {
+        const args = [
+            "-p",
+            prompt,
+            "--print",
+            "--output-format",
+            "stream-json",
+            "--trust",
+        ];
+        // Permission mode flag
+        if (permissionMode === "force") {
+            args.push("--force");
+        }
+        else if (permissionMode === "yolo") {
+            args.push("--yolo");
+        }
+        if (resumeId !== null) {
+            args.push("--resume", resumeId);
+        }
+        if (model !== null) {
+            args.push("--model", model);
+        }
+        if (sandbox !== null) {
+            args.push("--sandbox", sandbox);
+        }
+        args.push("--workspace", spawnCwd);
+        return args;
+    }
+    async function runCursorAgent(prompt, resumeId, model, timeoutMs, spawnCwd) {
+        const args = buildArgs(prompt, resumeId, model, spawnCwd);
+        const result = await spawnFn({
+            command: cursorAgentBin,
+            args,
+            timeoutMs,
+            cwd: spawnCwd,
+        }).catch((err) => {
+            const detail = err instanceof Error ? err.message : String(err);
+            throw new Error(`cursor-agent adapter failed to spawn '${cursorAgentBin}': ${detail}`);
+        });
+        const parsed = parseStreamJson(result.stdout);
+        return { result, parsed };
+    }
+    async function createSession(config) {
+        const model = config.model !== null && config.model.length > 0
+            ? config.model
+            : defaultModel;
+        const spawnCwd = config.cwd !== null && config.cwd.length > 0 ? config.cwd : resolveCwd();
+        const { result, parsed } = await runCursorAgent("ping", null, model, createSessionTimeoutMs, spawnCwd);
+        if (result.timedOut) {
+            throw new Error(`createSession timed out after ${createSessionTimeoutMs}ms`);
+        }
+        if (parsed === null) {
+            throw makeUnparseableOrExitError(result, cursorAgentBin);
+        }
+        if (parsed.sessionId === "") {
+            throw makeUnparseableOrExitError(result, cursorAgentBin);
+        }
+        const rewritten = rewriteIndices(parsed.turns, -1);
+        turnsCache.set(parsed.sessionId, rewritten);
+        const meta = {
+            cwd: spawnCwd,
+            model: parsed.model !== "" ? parsed.model : model,
+            createdAt: new Date().toISOString(),
+            subtype: parsed.subtype,
+        };
+        return { nativeId: parsed.sessionId, meta };
+    }
+    function send(ref, content) {
+        // Synchronous pre-checks — throw before returning the iterable.
+        assertRef(ref, "send");
+        if (closedRefs.has(ref.nativeId)) {
+            throw new Error(`cursor-agent session ${ref.nativeId} is closed`);
+        }
+        if (typeof content !== "string" || content.length === 0) {
+            throw new Error("send: content must be a non-empty string");
+        }
+        const nativeId = ref.nativeId;
+        async function* generate() {
+            // Acquire the lock — it stays held until this generator finishes.
+            const prev = sendLocks.get(nativeId) ?? Promise.resolve();
+            let release = () => { };
+            const next = new Promise((resolve) => {
+                release = resolve;
+            });
+            const chain = prev.then(() => next);
+            sendLocks.set(nativeId, chain);
+            try {
+                await prev;
+                yield* streamSend(nativeId, ref, content);
+            }
+            finally {
+                release();
+                if (sendLocks.get(nativeId) === chain) {
+                    sendLocks.delete(nativeId);
+                }
+            }
+        }
+        return generate();
+    }
+    async function* streamSend(nativeId, ref, content) {
+        if (closedRefs.has(nativeId)) {
+            yield {
+                type: "error",
+                error: new Error(`cursor-agent session ${nativeId} is closed`),
+            };
+            return;
+        }
+        const before = turnsCache.get(nativeId) ?? [];
+        const highWater = before.length === 0
+            ? -1
+            : before.reduce((m, t) => (t.index > m ? t.index : m), -1);
+        let nextIndex = highWater + 1;
+        const refModel = typeof ref.meta.model === "string" && ref.meta.model.length > 0
+            ? ref.meta.model
+            : defaultModel;
+        const refCwd = typeof ref.meta.cwd === "string" && ref.meta.cwd.length > 0
+            ? ref.meta.cwd
+            : resolveCwd();
+        const args = buildArgs(content, nativeId, refModel, refCwd);
+        const startedAt = Date.now();
+        let streamResult;
+        try {
+            streamResult = streamingSpawnFn({
+                command: cursorAgentBin,
+                args,
+                timeoutMs: sendTimeoutMs,
+                cwd: refCwd,
+            });
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            yield {
+                type: "error",
+                error: new Error(`cursor-agent adapter failed to spawn '${cursorAgentBin}': ${detail}`),
+            };
+            return;
+        }
+        let resultLine = null;
+        try {
+            for await (const event of parseStreamJsonIncremental(streamResult.lines)) {
+                if (event.type === "turn") {
+                    const turn = event.turn;
+                    turn.index = nextIndex++;
+                    const existing = turnsCache.get(nativeId) ?? [];
+                    turnsCache.set(nativeId, [...existing, turn]);
+                    yield { type: "turn", turn };
+                }
+                else if (event.type === "result") {
+                    resultLine = event.resultLine;
+                }
+            }
+        }
+        catch (err) {
+            yield {
+                type: "error",
+                error: err instanceof Error
+                    ? err
+                    : new Error(`stream read error: ${String(err)}`),
+            };
+            return;
+        }
+        let exitInfo;
+        try {
+            exitInfo = await streamResult.waitForExit();
+        }
+        catch (err) {
+            yield {
+                type: "error",
+                error: err instanceof Error
+                    ? err
+                    : new Error(`process exit error: ${String(err)}`),
+            };
+            return;
+        }
+        if (exitInfo.timedOut) {
+            yield {
+                type: "error",
+                error: new Error(`send timed out after ${sendTimeoutMs}ms`),
+            };
+            return;
+        }
+        if (exitInfo.exitCode !== null && exitInfo.exitCode !== 0) {
+            const stderrTrimmed = exitInfo.stderr.trim();
+            const snippet = stderrTrimmed === ""
+                ? ""
+                : `: ${tail(stderrTrimmed, STDERR_TRUNCATE_LIMIT)}`;
+            yield {
+                type: "error",
+                error: new Error(`cursor-agent exited with code ${String(exitInfo.exitCode)}${snippet}`),
+            };
+            return;
+        }
+        const tokens = deriveTokensFromResultLine(resultLine);
+        yield {
+            type: "done",
+            durationMs: Date.now() - startedAt,
+            tokens,
+        };
+    }
+    async function close(ref) {
+        assertRef(ref, "close");
+        closedRefs.add(ref.nativeId);
+    }
+    async function getTurns(ref) {
+        assertRef(ref, "getTurns");
+        const cached = turnsCache.get(ref.nativeId);
+        if (cached === undefined)
+            return [];
+        return [...cached];
+    }
+    return {
+        name: "cursor-agent",
+        createSession,
+        send,
+        close,
+        getTurns,
+    };
+}
+function assertRef(ref, op) {
+    if (ref === null ||
+        ref === undefined ||
+        typeof ref !== "object" ||
+        typeof ref.nativeId !== "string" ||
+        ref.nativeId.length === 0) {
+        throw new Error(`${op}: invalid NativeSessionRef`);
+    }
+}
+function rewriteIndices(turns, highWater) {
+    let nextIndex = highWater + 1;
+    return turns.map((turn) => ({
+        ...turn,
+        index: nextIndex++,
+    }));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function safeNumber(v, fallback = 0) {
+    return typeof v === "number" && Number.isFinite(v) ? v : fallback;
+}
+function deriveTokensFromResultLine(resultLine) {
+    if (resultLine === null)
+        return null;
+    const usage = isRecord(resultLine.usage) ? resultLine.usage : {};
+    const input = safeNumber(usage.inputTokens);
+    const output = safeNumber(usage.outputTokens);
+    if (input === 0 && output === 0)
+        return null;
+    return { input, output };
+}
+function makeUnparseableOrExitError(result, cursorAgentBin, nativeId = null) {
+    const stderr = result.stderr ?? "";
+    const stdout = result.stdout ?? "";
+    const stderrTrimmed = stderr.trim();
+    // API key errors take precedence.
+    for (const pattern of API_KEY_PATTERNS) {
+        if (pattern.test(stderrTrimmed)) {
+            const codeText = result.exitCode === null ? "null" : String(result.exitCode);
+            return new Error(`cursor-agent exited with code ${codeText}: ${API_KEY_ERROR_MESSAGE}`);
+        }
+    }
+    // Trust errors.
+    for (const pattern of TRUST_PATTERNS) {
+        if (pattern.test(stderrTrimmed)) {
+            const codeText = result.exitCode === null ? "null" : String(result.exitCode);
+            return new Error(`cursor-agent exited with code ${codeText}: ${TRUST_ERROR_MESSAGE}`);
+        }
+    }
+    // Session-not-found heuristic for resume failures.
+    if (nativeId !== null &&
+        /not found|no such session|session.*not.*exist/i.test(stderrTrimmed)) {
+        return new Error(`cursor-agent session ${nativeId} not found: ${tail(stderrTrimmed, STDERR_TRUNCATE_LIMIT)}`);
+    }
+    if (result.exitCode !== null && result.exitCode !== 0) {
+        const codeText = String(result.exitCode);
+        const snippet = stderrTrimmed === ""
+            ? ""
+            : `: ${tail(stderrTrimmed, STDERR_TRUNCATE_LIMIT)}`;
+        return new Error(`cursor-agent exited with code ${codeText}${snippet}`);
+    }
+    // Unparseable but exit was 0 (or null).
+    const head = stdout.slice(0, 500);
+    const stderrTail = tail(stderrTrimmed, STDERR_TRUNCATE_LIMIT);
+    return new Error(`cursor-agent returned unparseable stream-json output (bin=${cursorAgentBin}, first 500 chars: ${head}, stderr tail: ${stderrTail})`);
+}
+function tail(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(s.length - n);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public surface of `@sumeru/adapter-cursor-agent`.
+ *
+ * The factory `createCursorAgentAdapter` returns an `Adapter` (from
+ * `@sumeru/core`) that drives cursor-agent via its CLI in
+ * `--print --output-format stream-json --trust --force` mode.
+ * See `adapter.ts` for the implementation.
+ */
+export { createCursorAgentAdapter } from "./adapter.js";
+export { parseStreamJson, parseStreamJsonIncremental, } from "./stream-parser.js";
+export type { CursorAgentAdapterOptions, CursorAgentParsedResult, CursorAgentResultSubtype, SpawnArgs, SpawnExitInfo, SpawnFn, SpawnResult, SpawnStreamResult, StreamingSpawnFn, StreamParseEvent, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACN,eAAe,EACf,0BAA0B,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,SAAS,EACT,aAAa,EACb,OAAO,EACP,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * Public surface of `@sumeru/adapter-cursor-agent`.
+ *
+ * The factory `createCursorAgentAdapter` returns an `Adapter` (from
+ * `@sumeru/core`) that drives cursor-agent via its CLI in
+ * `--print --output-format stream-json --trust --force` mode.
+ * See `adapter.ts` for the implementation.
+ */
+export { createCursorAgentAdapter } from "./adapter.js";
+export { parseStreamJson, parseStreamJsonIncremental, } from "./stream-parser.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACN,eAAe,EACf,0BAA0B,GAC1B,MAAM,oBAAoB,CAAC"}

package/dist/spawn.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Default `SpawnFn` for the Cursor Agent adapter — wraps
+ * `node:child_process.spawn` with a timeout.
+ *
+ * Returns `{stdout, stderr, exitCode, signal, timedOut, durationMs}`. On
+ * timeout the child receives `SIGTERM`; if it is still alive after 5 s a
+ * `SIGKILL` follows. `timedOut` is set to `true`.
+ *
+ * Argv is passed as an explicit array — never via shell — so embedded
+ * quotes, backslashes, newlines, and emoji round-trip without corruption.
+ */
+import type { SpawnFn, StreamingSpawnFn } from "./types.js";
+export declare const defaultSpawn: SpawnFn;
+/**
+ * Streaming variant of `defaultSpawn` — returns synchronously with
+ * line-by-line stdout access via `lines` (an AsyncIterable<string>).
+ */
+export declare const defaultStreamingSpawn: StreamingSpawnFn;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAGX,OAAO,EAGP,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,YAAY,EAAE,OAyD1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,gBA4DnC,CAAC"}

package/dist/spawn.js

@@ -0,0 +1,117 @@
+/**
+ * Default `SpawnFn` for the Cursor Agent adapter — wraps
+ * `node:child_process.spawn` with a timeout.
+ *
+ * Returns `{stdout, stderr, exitCode, signal, timedOut, durationMs}`. On
+ * timeout the child receives `SIGTERM`; if it is still alive after 5 s a
+ * `SIGKILL` follows. `timedOut` is set to `true`.
+ *
+ * Argv is passed as an explicit array — never via shell — so embedded
+ * quotes, backslashes, newlines, and emoji round-trip without corruption.
+ */
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+const FORCE_KILL_GRACE_MS = 5_000;
+export const defaultSpawn = async ({ command, args, timeoutMs, cwd, }) => {
+    const startedAt = Date.now();
+    return new Promise((resolve, reject) => {
+        let child;
+        try {
+            child = spawn(command, args, {
+                stdio: ["ignore", "pipe", "pipe"],
+                windowsHide: true,
+                cwd,
+                env: process.env,
+                shell: false,
+            });
+        }
+        catch (err) {
+            reject(err instanceof Error ? err : new Error(String(err)));
+            return;
+        }
+        let timedOut = false;
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+            setTimeout(() => {
+                if (child.exitCode === null && child.signalCode === null) {
+                    child.kill("SIGKILL");
+                }
+            }, FORCE_KILL_GRACE_MS).unref();
+        }, timeoutMs);
+        timer.unref();
+        child.stdout?.on("data", (chunk) => stdoutChunks.push(chunk));
+        child.stderr?.on("data", (chunk) => stderrChunks.push(chunk));
+        child.once("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.once("close", (code, signal) => {
+            clearTimeout(timer);
+            resolve({
+                stdout: Buffer.concat(stdoutChunks).toString("utf-8"),
+                stderr: Buffer.concat(stderrChunks).toString("utf-8"),
+                exitCode: code,
+                signal: signal ?? null,
+                timedOut,
+                durationMs: Date.now() - startedAt,
+            });
+        });
+    });
+};
+/**
+ * Streaming variant of `defaultSpawn` — returns synchronously with
+ * line-by-line stdout access via `lines` (an AsyncIterable<string>).
+ */
+export const defaultStreamingSpawn = ({ command, args, timeoutMs, cwd, }) => {
+    const startedAt = Date.now();
+    const child = spawn(command, args, {
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+        cwd,
+        env: process.env,
+        shell: false,
+    });
+    let timedOut = false;
+    const stderrChunks = [];
+    const timer = setTimeout(() => {
+        timedOut = true;
+        child.kill("SIGTERM");
+        setTimeout(() => {
+            if (child.exitCode === null && child.signalCode === null) {
+                child.kill("SIGKILL");
+            }
+        }, FORCE_KILL_GRACE_MS).unref();
+    }, timeoutMs);
+    timer.unref();
+    // stdio: ["ignore", "pipe", "pipe"] guarantees child.stdout is non-null
+    const stdout = child.stdout;
+    if (stdout === null) {
+        throw new Error("child.stdout is null despite pipe stdio configuration");
+    }
+    child.stderr?.on("data", (chunk) => stderrChunks.push(chunk));
+    const rl = createInterface({ input: stdout, crlfDelay: Infinity });
+    const exitPromise = new Promise((resolve, reject) => {
+        child.once("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        child.once("close", (code, signal) => {
+            clearTimeout(timer);
+            resolve({
+                exitCode: code,
+                signal: signal ?? null,
+                timedOut,
+                durationMs: Date.now() - startedAt,
+                stderr: Buffer.concat(stderrChunks).toString("utf-8"),
+            });
+        });
+    });
+    return {
+        lines: rl,
+        waitForExit: () => exitPromise,
+    };
+};
+//# sourceMappingURL=spawn.js.map

package/dist/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"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"}

package/dist/stream-parser.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Stream-json parser for cursor-agent's
+ * `cursor-agent -p ... --output-format stream-json` NDJSON output.
+ *
+ * Each line is a JSON object with a `type` field:
+ *   - `"system"` (subtype: `init`) — first line; carries `session_id`, `model`,
+ *     `cwd`, `permissionMode`.
+ *   - `"user"` — carries `message.content` array with text segments.
+ *   - `"thinking"` (subtype: `delta` or `completed`) — reasoning text; discarded.
+ *   - `"assistant"` — carries `message.content` array.
+ *   - `"tool_call"` (subtype: `started`) — carries `call_id`,
+ *     `tool_call.{editToolCall|shellToolCall}.args`.
+ *   - `"tool_call"` (subtype: `completed`) — carries `call_id`,
+ *     `tool_call.{...}.result`.
+ *   - `"result"` (subtype: `success`) — carries `result`, `duration_ms`, `usage`.
+ *
+ * Unlike Claude Code (where tool_use is embedded in assistant message content
+ * and tool_result is a user line), cursor-agent uses separate `tool_call`
+ * events with explicit `started`/`completed` subtypes. The parser maps these
+ * to Sumeru's `ToolCall` model.
+ */
+import type { CursorAgentParsedResult, StreamParseEvent } from "./types.js";
+/**
+ * Parse cursor-agent stream-json (NDJSON) output into an ordered Turn[] plus
+ * a result summary.
+ *
+ * Behavior:
+ *   - Pure: same input → same output (modulo the per-call `now()` timestamp).
+ *   - Tolerant: malformed lines and lines without a recognized `type` are
+ *     silently skipped.
+ *   - Returns `null` when neither a `system` line (with session_id) NOR a
+ *     `result` line was parsed — the adapter caller maps this to a hard error.
+ *
+ * @param stdout Raw NDJSON text (the full captured stdout of `cursor-agent -p`).
+ */
+export declare function parseStreamJson(stdout: string): CursorAgentParsedResult | null;
+/**
+ * Incremental async-generator parser for cursor-agent NDJSON output.
+ *
+ * Yields `StreamParseEvent` as each line is consumed:
+ *   - `{ type: "meta" }` after the first `system` line sets session + model.
+ *   - `{ type: "turn" }` for each new Turn added (assistant, user, or
+ *     assistant created by a `tool_call` started event).
+ *   - `{ type: "result" }` when the `result` line is encountered.
+ *
+ * `tool_call` started events that MUTATE an existing turn's toolCalls array
+ * do NOT yield a new event (reference sharing). `tool_call` completed events
+ * fill in `ToolCall.output` on previously-yielded Turn objects — no new event.
+ */
+export declare function parseStreamJsonIncremental(lines: AsyncIterable<string>): AsyncGenerator<StreamParseEvent>;
+//# sourceMappingURL=stream-parser.d.ts.map

package/dist/stream-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-parser.d.ts","sourceRoot":"","sources":["../src/stream-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EACX,uBAAuB,EAEvB,gBAAgB,EAChB,MAAM,YAAY,CAAC;AAyTpB;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,GACZ,uBAAuB,GAAG,IAAI,CAehC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAuB,0BAA0B,CAChD,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B,cAAc,CAAC,gBAAgB,CAAC,CAuClC"}

package/dist/stream-parser.js

@@ -0,0 +1,366 @@
+/**
+ * Stream-json parser for cursor-agent's
+ * `cursor-agent -p ... --output-format stream-json` NDJSON output.
+ *
+ * Each line is a JSON object with a `type` field:
+ *   - `"system"` (subtype: `init`) — first line; carries `session_id`, `model`,
+ *     `cwd`, `permissionMode`.
+ *   - `"user"` — carries `message.content` array with text segments.
+ *   - `"thinking"` (subtype: `delta` or `completed`) — reasoning text; discarded.
+ *   - `"assistant"` — carries `message.content` array.
+ *   - `"tool_call"` (subtype: `started`) — carries `call_id`,
+ *     `tool_call.{editToolCall|shellToolCall}.args`.
+ *   - `"tool_call"` (subtype: `completed`) — carries `call_id`,
+ *     `tool_call.{...}.result`.
+ *   - `"result"` (subtype: `success`) — carries `result`, `duration_ms`, `usage`.
+ *
+ * Unlike Claude Code (where tool_use is embedded in assistant message content
+ * and tool_result is a user line), cursor-agent uses separate `tool_call`
+ * events with explicit `started`/`completed` subtypes. The parser maps these
+ * to Sumeru's `ToolCall` model.
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function safeNumber(v, fallback = 0) {
+    return typeof v === "number" && Number.isFinite(v) ? v : fallback;
+}
+function extractTextContent(content) {
+    const texts = [];
+    for (const item of content) {
+        if (isRecord(item) &&
+            item.type === "text" &&
+            typeof item.text === "string") {
+            texts.push(item.text);
+        }
+    }
+    return texts.join("\n");
+}
+function processSystemLine(parsed, state) {
+    if (typeof parsed.session_id === "string")
+        state.sessionId = parsed.session_id;
+    if (typeof parsed.model === "string")
+        state.model = parsed.model;
+}
+function processAssistantLine(parsed, state) {
+    if (!isRecord(parsed.message))
+        return;
+    const content = Array.isArray(parsed.message.content)
+        ? parsed.message.content
+        : [];
+    const textContent = extractTextContent(content);
+    if (textContent === "")
+        return;
+    const turn = {
+        index: state.turnIndex++,
+        role: "assistant",
+        content: textContent,
+        timestamp: state.now,
+        toolCalls: null,
+        tokens: null,
+        hash: null,
+    };
+    state.turns.push(turn);
+}
+function processUserLine(parsed, state) {
+    if (!isRecord(parsed.message))
+        return;
+    const content = Array.isArray(parsed.message.content)
+        ? parsed.message.content
+        : [];
+    const userText = extractTextContent(content);
+    if (userText === "")
+        return;
+    state.turns.push({
+        index: state.turnIndex++,
+        role: "user",
+        content: userText,
+        timestamp: state.now,
+        toolCalls: null,
+        tokens: null,
+        hash: null,
+    });
+}
+function getToolName(toolCallObj) {
+    if ("editToolCall" in toolCallObj)
+        return "editToolCall";
+    if ("shellToolCall" in toolCallObj)
+        return "shellToolCall";
+    // Fallback: find the first key that looks like a tool call
+    for (const key of Object.keys(toolCallObj)) {
+        if (key.endsWith("ToolCall"))
+            return key;
+    }
+    return "unknownTool";
+}
+function getToolArgs(toolCallObj, toolName) {
+    const inner = toolCallObj[toolName];
+    if (isRecord(inner) && isRecord(inner.args)) {
+        return inner.args;
+    }
+    if (isRecord(inner)) {
+        return inner;
+    }
+    return {};
+}
+function getToolResult(toolCallObj, toolName) {
+    const inner = toolCallObj[toolName];
+    if (!isRecord(inner))
+        return { output: "", exitCode: null };
+    const result = inner.result;
+    if (isRecord(result)) {
+        const stdout = typeof result.stdout === "string" ? result.stdout : "";
+        const content = typeof result.content === "string" ? result.content : "";
+        const output = stdout || content || JSON.stringify(result);
+        const exitCode = toolName === "shellToolCall" && typeof result.exitCode === "number"
+            ? result.exitCode
+            : null;
+        return { output, exitCode };
+    }
+    if (typeof result === "string")
+        return { output: result, exitCode: null };
+    return { output: JSON.stringify(result ?? null), exitCode: null };
+}
+function processToolCallStarted(parsed, state) {
+    const callId = typeof parsed.call_id === "string" ? parsed.call_id : null;
+    if (callId === null)
+        return;
+    const toolCallObj = parsed.tool_call;
+    if (!isRecord(toolCallObj))
+        return;
+    const toolName = getToolName(toolCallObj);
+    const input = getToolArgs(toolCallObj, toolName);
+    const call = {
+        tool: toolName,
+        input,
+        output: null,
+        durationMs: null,
+        exitCode: null,
+    };
+    // Associate with the most recent assistant Turn.
+    const lastAssistantIdx = findLastAssistantTurnIndex(state.turns);
+    if (lastAssistantIdx >= 0) {
+        const turn = state.turns[lastAssistantIdx];
+        if (turn !== undefined) {
+            if (turn.toolCalls === null) {
+                turn.toolCalls = [call];
+            }
+            else {
+                turn.toolCalls.push(call);
+            }
+        }
+    }
+    else {
+        // No assistant turn yet — create one with empty content to hold the tool call.
+        const turn = {
+            index: state.turnIndex++,
+            role: "assistant",
+            content: "",
+            timestamp: state.now,
+            toolCalls: [call],
+            tokens: null,
+            hash: null,
+        };
+        state.turns.push(turn);
+    }
+    state.pendingToolCalls.set(callId, call);
+}
+function processToolCallCompleted(parsed, state) {
+    const callId = typeof parsed.call_id === "string" ? parsed.call_id : null;
+    if (callId === null)
+        return;
+    const target = state.pendingToolCalls.get(callId);
+    if (target === undefined)
+        return; // unmatched completed — silently dropped
+    const toolCallObj = parsed.tool_call;
+    if (!isRecord(toolCallObj))
+        return;
+    const toolName = target.tool;
+    const { output, exitCode } = getToolResult(toolCallObj, toolName);
+    target.output = output;
+    target.exitCode = exitCode;
+    state.pendingToolCalls.delete(callId);
+}
+function processToolCall(parsed, state) {
+    const subtype = parsed.subtype;
+    if (subtype === "started") {
+        processToolCallStarted(parsed, state);
+    }
+    else if (subtype === "completed") {
+        processToolCallCompleted(parsed, state);
+    }
+}
+function findLastAssistantTurnIndex(turns) {
+    for (let i = turns.length - 1; i >= 0; i--) {
+        if (turns[i]?.role === "assistant")
+            return i;
+    }
+    return -1;
+}
+function processLine(line, state) {
+    const trimmed = line.trim();
+    if (trimmed === "")
+        return;
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return;
+    }
+    if (!isRecord(parsed))
+        return;
+    const type = parsed.type;
+    if (type === "system")
+        processSystemLine(parsed, state);
+    else if (type === "assistant")
+        processAssistantLine(parsed, state);
+    else if (type === "user")
+        processUserLine(parsed, state);
+    else if (type === "tool_call")
+        processToolCall(parsed, state);
+    else if (type === "result")
+        state.resultLine = parsed;
+    // "thinking" lines are completely discarded — NOT emitted as Turns.
+}
+function extractLastAssistantContent(turns) {
+    for (let i = turns.length - 1; i >= 0; i--) {
+        const turn = turns[i];
+        if (turn !== undefined &&
+            turn.role === "assistant" &&
+            turn.content !== "") {
+            return turn.content;
+        }
+    }
+    return "";
+}
+function coerceSubtype(raw) {
+    if (raw === "success")
+        return "success";
+    return "incomplete";
+}
+function assembleResult(state) {
+    if (state.resultLine === null) {
+        // Incomplete path — at minimum we need a session id.
+        if (state.sessionId === "")
+            return null;
+        return {
+            type: "result",
+            subtype: "incomplete",
+            result: extractLastAssistantContent(state.turns),
+            sessionId: state.sessionId,
+            numTurns: state.turns.length,
+            durationMs: 0,
+            model: state.model,
+            usage: {
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheReadTokens: 0,
+                cacheWriteTokens: 0,
+            },
+            turns: state.turns,
+        };
+    }
+    const result = state.resultLine.result;
+    const usage = isRecord(state.resultLine.usage) ? state.resultLine.usage : {};
+    const sessionIdFromResult = typeof state.resultLine.session_id === "string"
+        ? state.resultLine.session_id
+        : state.sessionId;
+    return {
+        type: typeof state.resultLine.type === "string"
+            ? state.resultLine.type
+            : "result",
+        subtype: coerceSubtype(state.resultLine.subtype),
+        result: typeof result === "string"
+            ? result
+            : extractLastAssistantContent(state.turns),
+        sessionId: sessionIdFromResult || state.sessionId,
+        numTurns: state.turns.length,
+        durationMs: safeNumber(state.resultLine.duration_ms),
+        model: state.model,
+        usage: {
+            inputTokens: safeNumber(usage.inputTokens),
+            outputTokens: safeNumber(usage.outputTokens),
+            cacheReadTokens: safeNumber(usage.cacheReadTokens),
+            cacheWriteTokens: safeNumber(usage.cacheWriteTokens),
+        },
+        turns: state.turns,
+    };
+}
+/**
+ * Parse cursor-agent stream-json (NDJSON) output into an ordered Turn[] plus
+ * a result summary.
+ *
+ * Behavior:
+ *   - Pure: same input → same output (modulo the per-call `now()` timestamp).
+ *   - Tolerant: malformed lines and lines without a recognized `type` are
+ *     silently skipped.
+ *   - Returns `null` when neither a `system` line (with session_id) NOR a
+ *     `result` line was parsed — the adapter caller maps this to a hard error.
+ *
+ * @param stdout Raw NDJSON text (the full captured stdout of `cursor-agent -p`).
+ */
+export function parseStreamJson(stdout) {
+    const lines = stdout.split("\n");
+    const state = {
+        turns: [],
+        pendingToolCalls: new Map(),
+        resultLine: null,
+        model: "",
+        sessionId: "",
+        turnIndex: 0,
+        now: new Date().toISOString(),
+    };
+    for (const line of lines) {
+        processLine(line, state);
+    }
+    return assembleResult(state);
+}
+/**
+ * Incremental async-generator parser for cursor-agent NDJSON output.
+ *
+ * Yields `StreamParseEvent` as each line is consumed:
+ *   - `{ type: "meta" }` after the first `system` line sets session + model.
+ *   - `{ type: "turn" }` for each new Turn added (assistant, user, or
+ *     assistant created by a `tool_call` started event).
+ *   - `{ type: "result" }` when the `result` line is encountered.
+ *
+ * `tool_call` started events that MUTATE an existing turn's toolCalls array
+ * do NOT yield a new event (reference sharing). `tool_call` completed events
+ * fill in `ToolCall.output` on previously-yielded Turn objects — no new event.
+ */
+export async function* parseStreamJsonIncremental(lines) {
+    const state = {
+        turns: [],
+        pendingToolCalls: new Map(),
+        resultLine: null,
+        model: "",
+        sessionId: "",
+        turnIndex: 0,
+        now: new Date().toISOString(),
+    };
+    let metaYielded = false;
+    for await (const line of lines) {
+        const turnsBefore = state.turns.length;
+        const hadResult = state.resultLine !== null;
+        const hadSession = state.sessionId !== "";
+        processLine(line, state);
+        // Yield meta event once session info is available
+        if (!metaYielded && !hadSession && state.sessionId !== "") {
+            metaYielded = true;
+            yield { type: "meta", sessionId: state.sessionId, model: state.model };
+        }
+        // Yield new turns (only newly created turns, not mutated ones)
+        for (let i = turnsBefore; i < state.turns.length; i++) {
+            const turn = state.turns[i];
+            if (turn !== undefined) {
+                yield { type: "turn", turn };
+            }
+        }
+        // Yield result event
+        if (!hadResult && state.resultLine !== null) {
+            yield { type: "result", resultLine: state.resultLine };
+        }
+    }
+}
+//# sourceMappingURL=stream-parser.js.map

package/dist/stream-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-parser.js","sourceRoot":"","sources":["../src/stream-parser.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Public types for `@sumeru/adapter-cursor-agent`.
+ *
+ * The adapter contract lives in `@sumeru/core` (`Adapter`, `NativeSessionRef`,
+ * `SendEvent`, `SessionConfig`, `Turn`, `ToolCall`, `TokenUsage`). This module
+ * only declares package-local options, the parser's intermediate shape, and the
+ * `child_process.spawn` test seam.
+ */
+import type { Turn } from "@sumeru/core";
+/** Post-exit metadata from a streaming spawn. */
+export type SpawnExitInfo = {
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    timedOut: boolean;
+    durationMs: number;
+    stderr: string;
+};
+/** Return value of `StreamingSpawnFn` — lines + exit promise. */
+export type SpawnStreamResult = {
+    lines: AsyncIterable<string>;
+    waitForExit(): Promise<SpawnExitInfo>;
+};
+/** Streaming spawn test seam — returns synchronously with incremental stdout access. */
+export type StreamingSpawnFn = (args: SpawnArgs) => SpawnStreamResult;
+/** Events yielded by the incremental stream parser. */
+export type StreamParseEvent = {
+    type: "turn";
+    turn: Turn;
+} | {
+    type: "meta";
+    sessionId: string;
+    model: string;
+} | {
+    type: "result";
+    resultLine: Record<string, unknown>;
+};
+/**
+ * Optional configuration for `createCursorAgentAdapter`. Every field accepts
+ * `null` (or absence) to fall through to the defaults — no optional `?:`
+ * properties on this surface.
+ */
+export type CursorAgentAdapterOptions = {
+    /** Path to the `cursor-agent` executable. Defaults to `"cursor-agent"` (rely on $PATH). */
+    cursorAgentBin: string | null;
+    /**
+     * `--model` value passed on every spawn. Defaults to `null`, which means
+     * the adapter does NOT pass `--model` and lets cursor-agent use its default.
+     */
+    model: string | null;
+    /** Working directory for the spawned process. Passed as `--workspace <path>`. Defaults to `process.cwd()`. */
+    cwd: string | null;
+    /** Default 5-minute timeout for `createSession`. */
+    createSessionTimeoutMs: number | null;
+    /** Default 10-minute timeout for `send`. */
+    sendTimeoutMs: number | null;
+    /**
+     * Test-only override for `child_process.spawn`. Production code never
+     * passes this — the integration tests inject a fake to avoid spawning a
+     * real `cursor-agent` binary.
+     */
+    spawnFn: SpawnFn | null;
+    /**
+     * Test-only override for the streaming spawn used in `send()`. Inject a
+     * mock to control line timing in tests without spawning a real process.
+     */
+    streamingSpawnFn: StreamingSpawnFn | null;
+    /**
+     * Controls permission bypass flag.
+     * `"force"` passes `--force`, `"yolo"` passes `--yolo`.
+     * Defaults to `"force"`.
+     */
+    permissionMode: "force" | "yolo" | null;
+    /** `--sandbox` value; defaults to `null` (do not pass flag). */
+    sandbox: "enabled" | "disabled" | null;
+};
+/** Argument shape mirroring `child_process.spawn` minus the irrelevant overloads. */
+export type SpawnArgs = {
+    command: string;
+    args: string[];
+    timeoutMs: number;
+    cwd: string;
+};
+/** Result of a spawned `cursor-agent` invocation. */
+export type SpawnResult = {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    timedOut: boolean;
+    durationMs: number;
+};
+/** Test seam for `child_process.spawn`. */
+export type SpawnFn = (args: SpawnArgs) => Promise<SpawnResult>;
+/**
+ * Subtype of a parsed cursor-agent result — string-literal union.
+ * The `"incomplete"` variant is synthesized by the parser when no `result`
+ * line was emitted (process was killed or its stream truncated).
+ */
+export type CursorAgentResultSubtype = "success" | "incomplete";
+/**
+ * Intermediate parsed result from cursor-agent's
+ * `--output-format stream-json` NDJSON output. The adapter consumes `turns`,
+ * `sessionId`, `subtype`, and `usage` directly.
+ */
+export type CursorAgentParsedResult = {
+    type: string;
+    subtype: CursorAgentResultSubtype;
+    result: string;
+    sessionId: string;
+    numTurns: number;
+    durationMs: number;
+    model: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+    };
+    turns: Turn[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Public types for `@sumeru/adapter-cursor-agent`.
+ *
+ * The adapter contract lives in `@sumeru/core` (`Adapter`, `NativeSessionRef`,
+ * `SendEvent`, `SessionConfig`, `Turn`, `ToolCall`, `TokenUsage`). This module
+ * only declares package-local options, the parser's intermediate shape, and the
+ * `child_process.spawn` test seam.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@sumeru/adapter-cursor-agent",
+  "description": "Sumeru adapter for Cursor Agent CLI",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@sumeru/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test:ci": "npx vitest run"
+  }
+}