subharness 0.0.4 → 0.0.5

package/dist/adapters/cursor-rpc.js

@@ -0,0 +1,271 @@
+import { spawn } from "node:child_process";
+import { AgentError } from "../errors.js";
+const MAX_FRAME_BYTES = 16 * 1024 * 1024;
+const CONTROL_TIMEOUT_MS = 15_000;
+const GRACEFUL_CLOSE_MS = 100;
+const TERM_CLOSE_MS = 250;
+const KILL_CLOSE_MS = 1_000;
+const protocolError = () => new AgentError("PROTOCOL_ERROR", "Cursor returned invalid ACP protocol data.");
+const closedError = () => new AgentError("SESSION_CLOSED", "The Cursor ACP transport is closed.");
+const cancellationError = () => new AgentError("CANCELLATION_FAILED", "Cursor ACP process termination could not be confirmed.");
+export class CursorRpcNativeError extends AgentError {
+    nativeCode;
+    constructor(nativeCode) {
+        super("NATIVE_ERROR", "Cursor ACP request failed.");
+        this.nativeCode = nativeCode;
+        this.name = "CursorRpcNativeError";
+    }
+}
+const validId = (value) => typeof value === "string" || (typeof value === "number" && Number.isFinite(value));
+function validEnvelope(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const message = value;
+    if (message.jsonrpc !== "2.0")
+        return false;
+    const hasId = Object.hasOwn(message, "id");
+    const hasMethod = Object.hasOwn(message, "method");
+    const hasResult = Object.hasOwn(message, "result");
+    const hasError = Object.hasOwn(message, "error");
+    if (hasMethod) {
+        return typeof message.method === "string" && (!hasId || validId(message.id)) && !hasResult && !hasError;
+    }
+    if (!hasId || !validId(message.id) || hasResult === hasError || Object.hasOwn(message, "params"))
+        return false;
+    if (!hasError)
+        return true;
+    const error = message.error;
+    return !!error && typeof error === "object" && !Array.isArray(error)
+        && Number.isInteger(error.code)
+        && typeof error.message === "string";
+}
+/** Newline-delimited JSON-RPC 2.0 transport for Cursor's native ACP process. */
+export class CursorRpc {
+    child;
+    pending = new Map();
+    sequence = 0;
+    buffer = "";
+    started = false;
+    closing = false;
+    closed = false;
+    closePromise;
+    failure;
+    failureHandler = () => { };
+    onMessage = () => { };
+    constructor(executable, args, cwd, env) {
+        if (process.platform === "win32") {
+            throw new AgentError("UNSUPPORTED_OPTION", "Cursor subscription access is supported only on macOS and Linux.");
+        }
+        this.child = spawn(executable, args, { cwd, env, detached: true, stdio: ["pipe", "pipe", "pipe"] });
+        this.child.once("spawn", () => { this.started = true; });
+        this.child.stdout.setEncoding("utf8");
+        this.child.stdout.on("data", chunk => this.read(chunk));
+        this.child.stderr.resume();
+        this.child.stdin.on("error", () => this.handleInputFailure());
+        this.child.stdin.on("close", () => this.handleInputFailure());
+        this.child.once("error", () => {
+            this.fail(new AgentError("HARNESS_UNAVAILABLE", "Cannot start the Cursor ACP executable."));
+            void this.close().catch(() => { });
+        });
+        this.child.once("close", () => this.handleExit());
+    }
+    request(method, params, timeoutMs) {
+        if (this.failure)
+            return Promise.reject(this.failure);
+        if (this.closing)
+            return Promise.reject(closedError());
+        const timeout = timeoutMs ?? (method === "session/prompt" ? undefined : CONTROL_TIMEOUT_MS);
+        if (timeout !== undefined && (!Number.isSafeInteger(timeout) || timeout <= 0)) {
+            return Promise.reject(new AgentError("INVALID_ARGUMENT", "Cursor ACP request timeout must be a positive safe integer."));
+        }
+        const id = ++this.sequence;
+        return new Promise((resolve, reject) => {
+            const pending = { resolve, reject };
+            if (timeout !== undefined) {
+                pending.timer = setTimeout(() => {
+                    if (!this.pending.delete(id))
+                        return;
+                    reject(new AgentError("HARNESS_FAILED", "Cursor ACP request timed out."));
+                }, timeout);
+                pending.timer.unref();
+            }
+            this.pending.set(id, pending);
+            try {
+                this.send({ id, method, params });
+            }
+            catch (error) {
+                this.pending.delete(id);
+                if (pending.timer)
+                    clearTimeout(pending.timer);
+                reject(error);
+            }
+        });
+    }
+    send(envelope) {
+        if (this.failure)
+            throw this.failure;
+        if (this.closing)
+            throw closedError();
+        let frame;
+        try {
+            frame = JSON.stringify({ jsonrpc: "2.0", ...envelope });
+            if (Buffer.byteLength(frame, "utf8") > MAX_FRAME_BYTES || !validEnvelope(JSON.parse(frame)))
+                throw protocolError();
+        }
+        catch {
+            throw protocolError();
+        }
+        try {
+            this.child.stdin.write(`${frame}\n`);
+        }
+        catch {
+            const error = new AgentError("HARNESS_FAILED", "The Cursor ACP input connection closed.");
+            this.fail(error);
+            void this.close().catch(() => { });
+            throw error;
+        }
+    }
+    setFailureHandler(handler) {
+        this.failureHandler = handler;
+        if (this.failure)
+            handler(this.failure);
+    }
+    close() {
+        this.closePromise ??= this.closeOwnedProcess();
+        return this.closePromise;
+    }
+    async closeOwnedProcess() {
+        this.closing = true;
+        this.rejectPending(this.failure ?? closedError());
+        if (!this.closed) {
+            try {
+                this.child.stdin.end();
+            }
+            catch { }
+        }
+        if (await this.waitForRetirement(GRACEFUL_CLOSE_MS))
+            return;
+        this.signal("SIGTERM");
+        if (await this.waitForRetirement(TERM_CLOSE_MS))
+            return;
+        this.signal("SIGKILL");
+        if (await this.waitForRetirement(KILL_CLOSE_MS))
+            return;
+        const error = cancellationError();
+        this.fail(error);
+        throw error;
+    }
+    signal(signal) {
+        try {
+            if (this.child.pid !== undefined)
+                process.kill(-this.child.pid, signal);
+        }
+        catch { }
+    }
+    async waitForRetirement(timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            if (this.retired())
+                return true;
+            await new Promise(resolve => setTimeout(resolve, 10));
+        }
+        return this.retired();
+    }
+    retired() {
+        if (!this.closed)
+            return false;
+        if (this.child.pid === undefined)
+            return true;
+        try {
+            process.kill(-this.child.pid, 0);
+            return false;
+        }
+        catch (error) {
+            return error.code === "ESRCH";
+        }
+    }
+    read(chunk) {
+        if (this.failure)
+            return;
+        this.buffer += chunk;
+        let newline;
+        while ((newline = this.buffer.indexOf("\n")) >= 0) {
+            const line = this.buffer.slice(0, newline);
+            this.buffer = this.buffer.slice(newline + 1);
+            if (!line.trim())
+                continue;
+            if (Buffer.byteLength(line, "utf8") > MAX_FRAME_BYTES)
+                return this.invalid();
+            let message;
+            try {
+                message = JSON.parse(line);
+            }
+            catch {
+                return this.invalid();
+            }
+            if (!validEnvelope(message))
+                return this.invalid();
+            if (typeof message.method === "string") {
+                try {
+                    this.onMessage(message);
+                }
+                catch {
+                    this.fail(new AgentError("HARNESS_FAILED", "Cursor ACP message handling failed."));
+                    void this.close().catch(() => { });
+                }
+                continue;
+            }
+            if (typeof message.id !== "number")
+                continue;
+            const pending = this.pending.get(message.id);
+            if (!pending)
+                continue;
+            this.pending.delete(message.id);
+            if (pending.timer)
+                clearTimeout(pending.timer);
+            if (Object.hasOwn(message, "error")) {
+                const nativeCode = message.error.code;
+                pending.reject(new CursorRpcNativeError(nativeCode));
+            }
+            else
+                pending.resolve(message.result);
+        }
+        if (Buffer.byteLength(this.buffer, "utf8") > MAX_FRAME_BYTES)
+            this.invalid();
+    }
+    invalid() {
+        this.fail(protocolError());
+        void this.close().catch(() => { });
+    }
+    handleInputFailure() {
+        if (!this.started || this.closing || this.closed)
+            return;
+        this.fail(new AgentError("HARNESS_FAILED", "The Cursor ACP input connection closed."));
+        void this.close().catch(() => { });
+    }
+    handleExit() {
+        this.closed = true;
+        if (this.closing)
+            return this.rejectPending(closedError());
+        this.fail(this.buffer.trim()
+            ? protocolError()
+            : new AgentError("HARNESS_FAILED", "Cursor ACP exited before the native operation completed."));
+        void this.close().catch(() => { });
+    }
+    rejectPending(error) {
+        for (const pending of this.pending.values()) {
+            if (pending.timer)
+                clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+    fail(error) {
+        if (this.failure)
+            return;
+        this.failure = error;
+        this.rejectPending(error);
+        this.failureHandler(error);
+    }
+}
+//# sourceMappingURL=cursor-rpc.js.map

package/dist/adapters/cursor-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-rpc.js","sourceRoot":"","sources":["../../src/adapters/cursor-rpc.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, type ChildProcessWithoutNullStreams } from \"node:child_process\";\nimport { AgentError } from \"../errors.js\";\n\nconst MAX_FRAME_BYTES = 16 * 1024 * 1024;\nconst CONTROL_TIMEOUT_MS = 15_000;\nconst GRACEFUL_CLOSE_MS = 100;\nconst TERM_CLOSE_MS = 250;\nconst KILL_CLOSE_MS = 1_000;\nconst protocolError = () => new AgentError(\"PROTOCOL_ERROR\", \"Cursor returned invalid ACP protocol data.\");\nconst closedError = () => new AgentError(\"SESSION_CLOSED\", \"The Cursor ACP transport is closed.\");\nconst cancellationError = () => new AgentError(\"CANCELLATION_FAILED\", \"Cursor ACP process termination could not be confirmed.\");\n\nexport type CursorRpcEnvelope = {\n  jsonrpc?: \"2.0\";\n  id?: string | number;\n  method?: string;\n  params?: unknown;\n  result?: unknown;\n  error?: unknown;\n};\n\nexport class CursorRpcNativeError extends AgentError {\n  constructor(public readonly nativeCode: number) {\n    super(\"NATIVE_ERROR\", \"Cursor ACP request failed.\");\n    this.name = \"CursorRpcNativeError\";\n  }\n}\n\ntype Pending = { timer?: NodeJS.Timeout; resolve(value: unknown): void; reject(error: Error): void };\n\nconst validId = (value: unknown): value is string | number =>\n  typeof value === \"string\" || (typeof value === \"number\" && Number.isFinite(value));\n\nfunction validEnvelope(value: unknown): value is CursorRpcEnvelope {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n  const message = value as CursorRpcEnvelope;\n  if (message.jsonrpc !== \"2.0\") return false;\n  const hasId = Object.hasOwn(message, \"id\");\n  const hasMethod = Object.hasOwn(message, \"method\");\n  const hasResult = Object.hasOwn(message, \"result\");\n  const hasError = Object.hasOwn(message, \"error\");\n  if (hasMethod) {\n    return typeof message.method === \"string\" && (!hasId || validId(message.id)) && !hasResult && !hasError;\n  }\n  if (!hasId || !validId(message.id) || hasResult === hasError || Object.hasOwn(message, \"params\")) return false;\n  if (!hasError) return true;\n  const error = message.error;\n  return !!error && typeof error === \"object\" && !Array.isArray(error)\n    && Number.isInteger((error as { code?: unknown }).code)\n    && typeof (error as { message?: unknown }).message === \"string\";\n}\n\n/** Newline-delimited JSON-RPC 2.0 transport for Cursor's native ACP process. */\nexport class CursorRpc {\n  private readonly child: ChildProcessWithoutNullStreams;\n  private readonly pending = new Map<number, Pending>();\n  private sequence = 0;\n  private buffer = \"\";\n  private started = false;\n  private closing = false;\n  private closed = false;\n  private closePromise?: Promise<void>;\n  private failure?: AgentError;\n  private failureHandler: (error: AgentError) => void = () => {};\n  onMessage: (message: CursorRpcEnvelope) => void = () => {};\n\n  constructor(executable: string, args: string[], cwd: string, env: NodeJS.ProcessEnv) {\n    if (process.platform === \"win32\") {\n      throw new AgentError(\"UNSUPPORTED_OPTION\", \"Cursor subscription access is supported only on macOS and Linux.\");\n    }\n    this.child = spawn(executable, args, { cwd, env, detached: true, stdio: [\"pipe\", \"pipe\", \"pipe\"] });\n    this.child.once(\"spawn\", () => { this.started = true; });\n    this.child.stdout.setEncoding(\"utf8\");\n    this.child.stdout.on(\"data\", chunk => this.read(chunk));\n    this.child.stderr.resume();\n    this.child.stdin.on(\"error\", () => this.handleInputFailure());\n    this.child.stdin.on(\"close\", () => this.handleInputFailure());\n    this.child.once(\"error\", () => {\n      this.fail(new AgentError(\"HARNESS_UNAVAILABLE\", \"Cannot start the Cursor ACP executable.\"));\n      void this.close().catch(() => {});\n    });\n    this.child.once(\"close\", () => this.handleExit());\n  }\n\n  request(method: string, params: unknown, timeoutMs?: number): Promise<unknown> {\n    if (this.failure) return Promise.reject(this.failure);\n    if (this.closing) return Promise.reject(closedError());\n    const timeout = timeoutMs ?? (method === \"session/prompt\" ? undefined : CONTROL_TIMEOUT_MS);\n    if (timeout !== undefined && (!Number.isSafeInteger(timeout) || timeout <= 0)) {\n      return Promise.reject(new AgentError(\"INVALID_ARGUMENT\", \"Cursor ACP request timeout must be a positive safe integer.\"));\n    }\n    const id = ++this.sequence;\n    return new Promise((resolve, reject) => {\n      const pending: Pending = { resolve, reject };\n      if (timeout !== undefined) {\n        pending.timer = setTimeout(() => {\n          if (!this.pending.delete(id)) return;\n          reject(new AgentError(\"HARNESS_FAILED\", \"Cursor ACP request timed out.\"));\n        }, timeout);\n        pending.timer.unref();\n      }\n      this.pending.set(id, pending);\n      try { this.send({ id, method, params }); }\n      catch (error) {\n        this.pending.delete(id);\n        if (pending.timer) clearTimeout(pending.timer);\n        reject(error);\n      }\n    });\n  }\n\n  send(envelope: CursorRpcEnvelope): void {\n    if (this.failure) throw this.failure;\n    if (this.closing) throw closedError();\n    let frame: string;\n    try {\n      frame = JSON.stringify({ jsonrpc: \"2.0\", ...envelope });\n      if (Buffer.byteLength(frame, \"utf8\") > MAX_FRAME_BYTES || !validEnvelope(JSON.parse(frame))) throw protocolError();\n    } catch {\n      throw protocolError();\n    }\n    try {\n      this.child.stdin.write(`${frame}\\n`);\n    } catch {\n      const error = new AgentError(\"HARNESS_FAILED\", \"The Cursor ACP input connection closed.\");\n      this.fail(error);\n      void this.close().catch(() => {});\n      throw error;\n    }\n  }\n\n  setFailureHandler(handler: (error: AgentError) => void): void {\n    this.failureHandler = handler;\n    if (this.failure) handler(this.failure);\n  }\n\n  close(): Promise<void> {\n    this.closePromise ??= this.closeOwnedProcess();\n    return this.closePromise;\n  }\n\n  private async closeOwnedProcess(): Promise<void> {\n    this.closing = true;\n    this.rejectPending(this.failure ?? closedError());\n    if (!this.closed) {\n      try { this.child.stdin.end(); } catch {}\n    }\n    if (await this.waitForRetirement(GRACEFUL_CLOSE_MS)) return;\n    this.signal(\"SIGTERM\");\n    if (await this.waitForRetirement(TERM_CLOSE_MS)) return;\n    this.signal(\"SIGKILL\");\n    if (await this.waitForRetirement(KILL_CLOSE_MS)) return;\n    const error = cancellationError();\n    this.fail(error);\n    throw error;\n  }\n\n  private signal(signal: NodeJS.Signals): void {\n    try { if (this.child.pid !== undefined) process.kill(-this.child.pid, signal); }\n    catch {}\n  }\n\n  private async waitForRetirement(timeoutMs: number): Promise<boolean> {\n    const deadline = Date.now() + timeoutMs;\n    while (Date.now() < deadline) {\n      if (this.retired()) return true;\n      await new Promise(resolve => setTimeout(resolve, 10));\n    }\n    return this.retired();\n  }\n\n  private retired(): boolean {\n    if (!this.closed) return false;\n    if (this.child.pid === undefined) return true;\n    try {\n      process.kill(-this.child.pid, 0);\n      return false;\n    } catch (error) {\n      return (error as NodeJS.ErrnoException).code === \"ESRCH\";\n    }\n  }\n\n  private read(chunk: string): void {\n    if (this.failure) return;\n    this.buffer += chunk;\n    let newline: number;\n    while ((newline = this.buffer.indexOf(\"\\n\")) >= 0) {\n      const line = this.buffer.slice(0, newline);\n      this.buffer = this.buffer.slice(newline + 1);\n      if (!line.trim()) continue;\n      if (Buffer.byteLength(line, \"utf8\") > MAX_FRAME_BYTES) return this.invalid();\n      let message: unknown;\n      try { message = JSON.parse(line); }\n      catch { return this.invalid(); }\n      if (!validEnvelope(message)) return this.invalid();\n      if (typeof message.method === \"string\") {\n        try { this.onMessage(message); }\n        catch {\n          this.fail(new AgentError(\"HARNESS_FAILED\", \"Cursor ACP message handling failed.\"));\n          void this.close().catch(() => {});\n        }\n        continue;\n      }\n      if (typeof message.id !== \"number\") continue;\n      const pending = this.pending.get(message.id);\n      if (!pending) continue;\n      this.pending.delete(message.id);\n      if (pending.timer) clearTimeout(pending.timer);\n      if (Object.hasOwn(message, \"error\")) {\n        const nativeCode = (message.error as { code: number }).code;\n        pending.reject(new CursorRpcNativeError(nativeCode as number));\n      }\n      else pending.resolve(message.result);\n    }\n    if (Buffer.byteLength(this.buffer, \"utf8\") > MAX_FRAME_BYTES) this.invalid();\n  }\n\n  private invalid(): void {\n    this.fail(protocolError());\n    void this.close().catch(() => {});\n  }\n\n  private handleInputFailure(): void {\n    if (!this.started || this.closing || this.closed) return;\n    this.fail(new AgentError(\"HARNESS_FAILED\", \"The Cursor ACP input connection closed.\"));\n    void this.close().catch(() => {});\n  }\n\n  private handleExit(): void {\n    this.closed = true;\n    if (this.closing) return this.rejectPending(closedError());\n    this.fail(this.buffer.trim()\n      ? protocolError()\n      : new AgentError(\"HARNESS_FAILED\", \"Cursor ACP exited before the native operation completed.\"));\n    void this.close().catch(() => {});\n  }\n\n  private rejectPending(error: AgentError): void {\n    for (const pending of this.pending.values()) {\n      if (pending.timer) clearTimeout(pending.timer);\n      pending.reject(error);\n    }\n    this.pending.clear();\n  }\n\n  private fail(error: AgentError): void {\n    if (this.failure) return;\n    this.failure = error;\n    this.rejectPending(error);\n    this.failureHandler(error);\n  }\n}\n"]}

package/dist/adapters/cursor-session.d.ts

@@ -0,0 +1,4 @@
+import type { SDKAgent, SDKModel } from "@cursor/sdk";
+import type { AdapterOptions, NativeSession } from "./types.js";
+import type { CursorTools } from "./cursor-tools.js";
+export declare function createCursorSession(native: SDKAgent, selected: SDKModel, options: AdapterOptions, tools: CursorTools): NativeSession;

package/dist/adapters/cursor-session.js

@@ -0,0 +1,327 @@
+import { AgentError } from "../errors.js";
+import { cursorTerminalText, isCursorTerminalStatus, validateCursorRunResult } from "./cursor-model.js";
+const NATIVE_STOP_TIMEOUT_MS = 3_000;
+export function createCursorSession(native, selected, options, tools) {
+    let closed = false;
+    let active;
+    let first = true;
+    let closing;
+    let sessionFailure;
+    const refreshTerminal = (current) => {
+        if (!current.run || current.terminalStatus)
+            return;
+        try {
+            if (isCursorTerminalStatus(current.run.status))
+                current.markTerminal(current.run.status);
+        }
+        catch { /* A verified status event or result is still required. */ }
+    };
+    const stopNative = async (current) => {
+        await bounded(current.runReady, NATIVE_STOP_TIMEOUT_MS, "Cursor did not expose the active native run for cancellation.");
+        if (!current.run) {
+            await tools.drain();
+            return;
+        }
+        refreshTerminal(current);
+        if (current.terminalStatus) {
+            await tools.drain();
+            return;
+        }
+        current.cancellation ??= Promise.resolve().then(() => current.run.cancel());
+        void current.cancellation.catch(() => { });
+        await tools.drain();
+        refreshTerminal(current);
+        if (current.terminalStatus)
+            return;
+        const cancellation = current.cancellation.then(() => ({ kind: "accepted" }), error => ({ kind: "rejected", error }));
+        const cancellationOutcome = await bounded(Promise.race([
+            cancellation,
+            current.terminal.then(() => ({ kind: "terminal" })),
+        ]), NATIVE_STOP_TIMEOUT_MS, "Cursor did not confirm the native cancellation request.");
+        if (cancellationOutcome.kind === "terminal")
+            return;
+        if (cancellationOutcome.kind === "rejected") {
+            refreshTerminal(current);
+            if (!current.terminalStatus)
+                throw cancellationOutcome.error instanceof AgentError
+                    ? cancellationOutcome.error
+                    : new AgentError("CANCELLATION_FAILED", "Cursor did not confirm native cancellation.");
+            return;
+        }
+        refreshTerminal(current);
+        if (!current.terminalStatus) {
+            await bounded(current.terminal, NATIVE_STOP_TIMEOUT_MS, "Cursor did not reach a terminal status after cancellation.");
+        }
+    };
+    const requestStop = (current) => {
+        if (!current.stopTask) {
+            current.stopTask = stopNative(current).catch(error => {
+                const failure = error instanceof AgentError && error.code === "CANCELLATION_FAILED"
+                    ? error
+                    : new AgentError("CANCELLATION_FAILED", "Cursor did not confirm native cancellation.");
+                current.stopFailure = failure;
+                sessionFailure = failure;
+                tools.stopAdmission();
+                throw failure;
+            });
+            void current.stopTask.catch(() => { });
+        }
+        current.signalStop();
+        return current.stopTask;
+    };
+    const watchRun = async (current, run) => {
+        try {
+            for await (const message of run.stream()) {
+                observeMessage(current, message);
+            }
+            refreshTerminal(current);
+            if (!current.terminalStatus && !current.interrupted && !current.closing) {
+                current.nativeFailure = new AgentError("NATIVE_ERROR", "Cursor native event delivery stopped before terminal completion.");
+                tools.stopAdmission();
+                void requestStop(current);
+            }
+        }
+        catch {
+            refreshTerminal(current);
+            if (!current.terminalStatus && !current.interrupted && !current.closing) {
+                current.nativeFailure = new AgentError("NATIVE_ERROR", "Cursor native event delivery failed.");
+                tools.stopAdmission();
+                void requestStop(current);
+            }
+        }
+    };
+    const bindRun = (current, run) => {
+        current.run = run;
+        try {
+            current.unsubscribe = run.onDidChangeStatus(status => {
+                if (isCursorTerminalStatus(status))
+                    current.markTerminal(status);
+            });
+            refreshTerminal(current);
+        }
+        catch {
+            current.nativeFailure = new AgentError("NATIVE_ERROR", "Cursor native status observation failed.");
+        }
+        current.releaseRun();
+        void watchRun(current, run);
+        if (current.nativeFailure) {
+            tools.stopAdmission();
+            void requestStop(current);
+        }
+    };
+    const bindLateRun = (current, run) => {
+        current.run = run;
+        try {
+            current.unsubscribe = run.onDidChangeStatus(status => {
+                if (isCursorTerminalStatus(status))
+                    current.markTerminal(status);
+            });
+            refreshTerminal(current);
+        }
+        catch { /* The poisoned session still owns and cancels the late run. */ }
+        current.releaseRun();
+        current.cancellation ??= Promise.resolve().then(() => run.cancel());
+        void current.cancellation.catch(() => { });
+        void watchRun(current, run).finally(() => current.unsubscribe?.());
+    };
+    const stoppedFailure = (current) => {
+        if (current.closing)
+            return new AgentError("SESSION_CLOSED", "The Cursor session closed during the turn.");
+        if (current.interrupted)
+            return new AgentError("INTERRUPTED", "The Cursor turn was interrupted.");
+        return current.nativeFailure ?? new AgentError("NATIVE_ERROR", "Cursor stopped without a native terminal result.");
+    };
+    const executeTurn = async (current, prompt) => {
+        tools.start();
+        try {
+            const includeInstructions = first;
+            const message = includeInstructions && options.agent.instructions
+                ? firstPrompt(options.agent.instructions, prompt)
+                : prompt;
+            const admission = Promise.resolve().then(() => native.send(message, { model: { id: selected.id } })).then(run => {
+                if (current.stopFailure)
+                    bindLateRun(current, run);
+                else
+                    bindRun(current, run);
+                if (includeInstructions)
+                    first = false;
+                return { kind: "run", run };
+            }, error => {
+                current.releaseRun();
+                return { kind: "admission-failure", error };
+            });
+            const stopped = current.stopSignal.then(async () => {
+                try {
+                    await current.stopTask;
+                    return { kind: "stopped" };
+                }
+                catch (error) {
+                    return { kind: "stop-failure", error };
+                }
+            });
+            const admitted = await Promise.race([admission, stopped]);
+            if (admitted.kind === "stop-failure")
+                throw admitted.error;
+            if (admitted.kind === "stopped")
+                throw stoppedFailure(current);
+            if (admitted.kind === "admission-failure")
+                throw admitted.error;
+            const waited = admitted.run.wait().then(result => ({ kind: "result", result }), () => ({ kind: "failure" }));
+            const outcome = await Promise.race([waited, stopped]);
+            if (outcome.kind === "stop-failure")
+                throw outcome.error;
+            if (outcome.kind === "stopped")
+                throw stoppedFailure(current);
+            if (outcome.kind === "failure") {
+                current.nativeFailure = new AgentError("NATIVE_ERROR", "Cursor native result delivery failed.");
+                tools.stopAdmission();
+                await requestStop(current);
+                throw stoppedFailure(current);
+            }
+            validateCursorRunResult(outcome.result);
+            current.markTerminal(outcome.result.status);
+            if (current.stopTask) {
+                await current.stopTask;
+                throw stoppedFailure(current);
+            }
+            return cursorTerminalText(outcome.result, selected);
+        }
+        catch (error) {
+            current.releaseRun();
+            if (error instanceof AgentError) {
+                if (error.code === "INVALID_CONFIG" || error.code === "CANCELLATION_FAILED")
+                    sessionFailure = error;
+                throw error;
+            }
+            if (current.closing)
+                throw new AgentError("SESSION_CLOSED", "The Cursor session closed during the turn.");
+            if (current.interrupted)
+                throw new AgentError("INTERRUPTED", "The Cursor turn was interrupted.");
+            throw new AgentError("NATIVE_ERROR", "Cursor could not complete the turn.");
+        }
+        finally {
+            current.unsubscribe?.();
+            tools.stopAdmission();
+            await tools.drain();
+            if (active === current && !current.stopFailure)
+                active = undefined;
+        }
+    };
+    return {
+        async turn(prompt) {
+            if (closed)
+                throw new AgentError("SESSION_CLOSED", "The Cursor session has closed.");
+            if (sessionFailure)
+                throw sessionFailure;
+            if (active)
+                throw new AgentError("SESSION_BUSY", "Cursor already has an active turn.");
+            let releaseRun, markTerminal, signalStop;
+            const current = {
+                runReady: new Promise(resolve => { releaseRun = resolve; }),
+                releaseRun: () => releaseRun(),
+                terminal: new Promise(resolve => { markTerminal = resolve; }),
+                markTerminal(status) {
+                    if (current.terminalStatus)
+                        return;
+                    current.terminalStatus = status;
+                    markTerminal(status);
+                },
+                stopSignal: new Promise(resolve => { signalStop = resolve; }),
+                signalStop: () => signalStop(),
+                completion: undefined,
+                interrupted: false,
+                closing: false,
+            };
+            active = current;
+            current.completion = executeTurn(current, prompt);
+            return await current.completion;
+        },
+        async steer() { throw new AgentError("UNSUPPORTED_DELIVERY", "Cursor does not expose verified active steering."); },
+        async interrupt() {
+            const current = active;
+            if (!current)
+                return;
+            current.interrupted = true;
+            tools.stopAdmission();
+            try {
+                await requestStop(current);
+            }
+            catch (error) {
+                throw error instanceof AgentError ? error : new AgentError("CANCELLATION_FAILED", "Cursor did not confirm native cancellation.");
+            }
+            await current.completion.catch(() => { });
+        },
+        async resume() { throw new AgentError("RECOVERY_UNSUPPORTED", "Cursor cannot retry failed execution without replaying input."); },
+        async close() {
+            if (closing)
+                return await closing;
+            closed = true;
+            tools.stopAdmission();
+            const current = active;
+            if (current)
+                current.closing = true;
+            closing = (async () => {
+                const disposal = Promise.resolve().then(() => native[Symbol.asyncDispose]());
+                void disposal.catch(() => { });
+                let stopFailure;
+                if (current) {
+                    try {
+                        await requestStop(current);
+                    }
+                    catch (error) {
+                        stopFailure = error;
+                    }
+                }
+                else
+                    await tools.drain();
+                try {
+                    await bounded(disposal, NATIVE_STOP_TIMEOUT_MS, "Cursor did not confirm native session disposal.");
+                }
+                catch (error) {
+                    if (error instanceof AgentError)
+                        throw error;
+                    throw new AgentError("CANCELLATION_FAILED", "Cursor did not confirm native session disposal.");
+                }
+                finally {
+                    await tools.drain();
+                    if (active === current)
+                        active = undefined;
+                }
+                if (stopFailure)
+                    throw stopFailure instanceof AgentError
+                        ? stopFailure
+                        : new AgentError("CANCELLATION_FAILED", "Cursor did not confirm native cancellation during close.");
+                if (current)
+                    await current.completion.catch(() => { });
+            })();
+            return await closing;
+        },
+    };
+}
+function firstPrompt(instructions, prompt) {
+    return `<subharness-instructions>\n${instructions}\n</subharness-instructions>\n\n${prompt}`;
+}
+function observeMessage(current, message) {
+    if (message.type !== "status")
+        return;
+    const status = message.status === "FINISHED" ? "finished"
+        : message.status === "ERROR" ? "error"
+            : message.status === "CANCELLED" || message.status === "EXPIRED" ? "cancelled"
+                : undefined;
+    if (status)
+        current.markTerminal(status);
+}
+async function bounded(promise, milliseconds, message) {
+    let timer;
+    const timeout = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => reject(new AgentError("CANCELLATION_FAILED", message)), milliseconds);
+        timer.unref();
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=cursor-session.js.map