subharness 0.0.4 → 0.0.7

package/dist/adapters/cursor-cli-session.js

@@ -0,0 +1,316 @@
+import { AgentError } from "../errors.js";
+import { NativeApprovals } from "./approval-lifetime.js";
+import { cursorCliApproval } from "./cursor-cli-approvals.js";
+import { applyCursorCliModel, verifyCursorCliModelUpdate } from "./cursor-cli-model.js";
+import { CursorRpcNativeError } from "./cursor-rpc.js";
+export class CursorCliSession {
+    rpc;
+    sessionId;
+    selected;
+    options;
+    tools;
+    cleanup;
+    closePromise;
+    active;
+    failure;
+    first = true;
+    closed = false;
+    constructor(rpc, sessionId, selected, options, tools, cleanup) {
+        this.rpc = rpc;
+        this.sessionId = sessionId;
+        this.selected = selected;
+        this.options = options;
+        this.tools = tools;
+        this.cleanup = cleanup;
+        rpc.onMessage = message => this.message(message);
+        rpc.setFailureHandler(error => this.fail(error));
+        tools.onFailure(error => this.fail(error));
+    }
+    async turn(prompt) {
+        if (this.closed)
+            throw new AgentError("SESSION_CLOSED", "The Cursor session is closed.");
+        if (this.failure)
+            throw this.failure;
+        if (this.active)
+            throw new AgentError("SESSION_BUSY", "Cursor already has an active turn.");
+        let resolve;
+        let reject;
+        let releaseAdmission;
+        let resolveNativeStopped;
+        const completion = new Promise((accept, fail) => { resolve = accept; reject = fail; });
+        const admission = new Promise(accept => { releaseAdmission = accept; });
+        const nativeStopped = new Promise(accept => { resolveNativeStopped = accept; });
+        void completion.catch(() => { });
+        const active = {
+            text: "", responseBytes: 0, responseTooLarge: false, completion, resolve, reject,
+            terminal: false, submitted: false, cancelRequested: false,
+            admission, releaseAdmission, nativeStopped, resolveNativeStopped,
+            approvals: new NativeApprovals(), pendingApprovalIds: new Set(), withdrawnApprovals: new Set(),
+        };
+        this.active = active;
+        try {
+            await applyCursorCliModel(this.rpc, this.sessionId, this.selected);
+            if (this.failure)
+                throw this.failure;
+            if (active.cancelRequested || this.closed)
+                throw new AgentError("INTERRUPTED", "The Cursor turn was interrupted before submission.");
+            this.tools.beginTurn();
+            const text = this.first && this.options.agent.instructions
+                ? firstPrompt(this.options.agent.instructions, prompt)
+                : prompt;
+            active.submitted = true;
+            active.releaseAdmission();
+            const promptRequest = this.rpc.request("session/prompt", { sessionId: this.sessionId, prompt: [{ type: "text", text }] });
+            this.first = false;
+            const result = await promptRequest;
+            active.resolveNativeStopped();
+            await this.finish(active, result, active.failure);
+        }
+        catch (error) {
+            active.releaseAdmission();
+            active.resolveNativeStopped();
+            const failure = active.failure ?? (error instanceof CursorRpcNativeError
+                ? new AgentError("HARNESS_ERROR", "Cursor could not complete the native prompt.")
+                : error instanceof AgentError ? error : new AgentError("HARNESS_ERROR", "Cursor could not complete the native prompt."));
+            await this.finish(active, undefined, failure);
+        }
+        return await completion;
+    }
+    async steer(_prompt) {
+        throw new AgentError("UNSUPPORTED_DELIVERY", "Cursor does not expose verified active steering.");
+    }
+    async interrupt() {
+        const active = this.active;
+        if (!active)
+            return;
+        active.stopTask ??= this.stop(active);
+        return await active.stopTask;
+    }
+    async resume() {
+        throw new AgentError("RECOVERY_UNSUPPORTED", "Cursor recovery without a new prompt is unavailable.");
+    }
+    close() {
+        this.closePromise ??= this.closeOwnedResources();
+        return this.closePromise;
+    }
+    async closeOwnedResources() {
+        this.closed = true;
+        this.tools.stopAdmission();
+        const active = this.active;
+        if (active) {
+            active.cancelRequested = true;
+            active.failure ??= new AgentError("SESSION_CLOSED", "The Cursor session was closed during execution.");
+            this.retireApprovals(active);
+            if (active.submitted && !active.terminal) {
+                try {
+                    this.rpc.send({ method: "session/cancel", params: { sessionId: this.sessionId } });
+                }
+                catch { }
+            }
+        }
+        let closeFailure;
+        try {
+            await this.rpc.close();
+        }
+        catch (error) {
+            closeFailure = error;
+        }
+        await this.tools.close();
+        await active?.completion.catch(() => { });
+        if (closeFailure)
+            throw closeFailure;
+        await this.cleanup();
+    }
+    message(message) {
+        const active = this.active;
+        const params = asObject(message.params);
+        if (message.method === "$/cancel_request" && active && (typeof params?.requestId === "string" || typeof params?.requestId === "number")) {
+            if (active.pendingApprovalIds.delete(params.requestId)) {
+                active.withdrawnApprovals.add(params.requestId);
+                active.approvals.withdraw(params.requestId);
+            }
+            return;
+        }
+        if (message.id !== undefined) {
+            if (active && active.submitted && !active.terminal && !active.cancelRequested && !active.failure
+                && params?.sessionId === this.sessionId && message.method === "session/request_permission" && this.options.onApproval) {
+                try {
+                    const request = cursorCliApproval(message.params);
+                    active.pendingApprovalIds.add(message.id);
+                    void active.approvals.request(message.id, request, this.options.onApproval).then(content => {
+                        if (this.active === active && !active.terminal && !active.cancelRequested && !active.failure && !active.withdrawnApprovals.has(message.id)) {
+                            active.pendingApprovalIds.delete(message.id);
+                            this.rpc.send({ id: message.id, result: { outcome: { outcome: "selected", optionId: content.decision } } });
+                        }
+                    }).catch(error => {
+                        if (!(error instanceof AgentError && error.code === "REQUEST_EXPIRED"))
+                            this.unsupportedRequest(message, active);
+                    }).finally(() => {
+                        active.pendingApprovalIds.delete(message.id);
+                        active.withdrawnApprovals.delete(message.id);
+                    });
+                    return;
+                }
+                catch { }
+            }
+            this.unsupportedRequest(message, active);
+            return;
+        }
+        if (message.method !== "session/update")
+            return;
+        if (!params || params.sessionId !== this.sessionId || !active || active.terminal)
+            return;
+        const update = asObject(params.update);
+        if (!update || typeof update.sessionUpdate !== "string") {
+            this.fail(new AgentError("PROTOCOL_ERROR", "Cursor returned an invalid ACP session update."));
+            return;
+        }
+        if (update.sessionUpdate === "config_option_update") {
+            try {
+                verifyCursorCliModelUpdate(update.configOptions, this.selected);
+            }
+            catch (error) {
+                this.stopForModelFailure(active, error instanceof AgentError
+                    ? error
+                    : new AgentError("PROTOCOL_ERROR", "Cursor returned an invalid native model configuration."));
+            }
+            return;
+        }
+        if (update.sessionUpdate !== "agent_message_chunk")
+            return;
+        const content = asObject(update.content);
+        if (content?.type !== "text" || typeof content.text !== "string") {
+            this.fail(new AgentError("PROTOCOL_ERROR", "Cursor returned an invalid assistant message update."));
+            return;
+        }
+        active.responseBytes += Buffer.byteLength(content.text, "utf8");
+        if (active.responseBytes > 1024 * 1024)
+            active.responseTooLarge = true;
+        else
+            active.text += content.text;
+    }
+    async finish(active, value, error) {
+        if (active.terminal)
+            return;
+        active.terminal = true;
+        this.retireApprovals(active);
+        this.tools.stopAdmission();
+        await this.tools.drain();
+        if (this.active === active)
+            this.active = undefined;
+        if (error)
+            return active.reject(error);
+        const result = asObject(value);
+        if (!result || typeof result.stopReason !== "string") {
+            const failure = new AgentError("PROTOCOL_ERROR", "Cursor returned an invalid native terminal result.");
+            this.failure = failure;
+            return active.reject(failure);
+        }
+        if (active.responseTooLarge)
+            return active.reject(new AgentError("RESPONSE_TOO_LARGE", "Cursor response exceeds 1 MiB."));
+        if (result.stopReason === "end_turn")
+            return active.resolve(active.text);
+        if (result.stopReason === "cancelled")
+            return active.reject(new AgentError("INTERRUPTED", "The Cursor turn was interrupted."));
+        active.reject(new AgentError("HARNESS_ERROR", "Cursor did not complete the native turn successfully."));
+    }
+    async stop(active) {
+        active.cancelRequested = true;
+        this.retireApprovals(active);
+        this.tools.stopAdmission();
+        try {
+            await bounded(active.admission, 2_000);
+            if (active.submitted && !active.terminal)
+                this.rpc.send({ method: "session/cancel", params: { sessionId: this.sessionId } });
+            const callbacks = this.tools.drain();
+            await bounded(active.nativeStopped, 3_000);
+            await callbacks;
+            await active.completion.catch(() => { });
+        }
+        catch {
+            const failure = new AgentError("CANCELLATION_FAILED", "Cursor did not confirm that native execution stopped.");
+            active.failure = failure;
+            this.failure = failure;
+            this.tools.stopAdmission();
+            await this.rpc.close().catch(() => { });
+            await this.tools.drain();
+            await this.finish(active, undefined, failure);
+            throw failure;
+        }
+    }
+    fail(error) {
+        this.failure ??= error;
+        this.tools.stopAdmission();
+        const active = this.active;
+        if (active)
+            this.retireApprovals(active);
+        if (active)
+            void this.finish(active, undefined, this.failure);
+        void this.rpc.close().catch(() => { });
+    }
+    stopForModelFailure(active, failure) {
+        if (active.failure)
+            return;
+        active.failure = failure;
+        this.failure ??= failure;
+        this.tools.stopAdmission();
+        this.retireApprovals(active);
+        active.stopTask ??= this.stop(active);
+        void active.stopTask.catch(() => { });
+    }
+    unsupportedRequest(message, active) {
+        if (active && message.id !== undefined && active.pendingApprovalIds.has(message.id))
+            this.retireApproval(active, message.id);
+        else
+            this.respondCancelled(message.id);
+        const failure = new AgentError("INPUT_REQUIRED", "Cursor requested unsupported interactive input; no permission was granted.");
+        if (!active)
+            return this.fail(failure);
+        if (active.failure)
+            return;
+        active.failure = failure;
+        this.retireApprovals(active);
+        this.tools.stopAdmission();
+        active.stopTask ??= this.stop(active);
+        void active.stopTask.catch(() => { });
+    }
+    retireApprovals(active) {
+        for (const id of [...active.pendingApprovalIds])
+            this.retireApproval(active, id);
+        active.approvals.clear();
+    }
+    retireApproval(active, id) {
+        if (!active.pendingApprovalIds.delete(id))
+            return;
+        active.approvals.withdraw(id);
+        if (!active.withdrawnApprovals.has(id))
+            this.respondCancelled(id);
+    }
+    respondCancelled(id) {
+        if (id === undefined)
+            return;
+        try {
+            this.rpc.send({ id, result: { outcome: { outcome: "cancelled" } } });
+        }
+        catch { }
+    }
+}
+function firstPrompt(instructions, prompt) {
+    return `<subharness-instructions>\n${instructions}\n</subharness-instructions>\n\n${prompt}`;
+}
+function asObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+async function bounded(promise, milliseconds) {
+    let timer;
+    try {
+        return await Promise.race([promise, new Promise((_resolve, reject) => {
+                timer = setTimeout(() => reject(new Error("timeout")), milliseconds);
+                timer.unref();
+            })]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=cursor-cli-session.js.map

package/dist/adapters/cursor-cli-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-cli-session.js","sourceRoot":"","sources":["../../src/adapters/cursor-cli-session.ts"],"names":[],"mappings":"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","sourcesContent":["import { AgentError } from \"../errors.js\";\nimport { NativeApprovals } from \"./approval-lifetime.js\";\nimport { cursorCliApproval } from \"./cursor-cli-approvals.js\";\nimport type { AdapterOptions, NativeSession } from \"./types.js\";\nimport { applyCursorCliModel, verifyCursorCliModelUpdate } from \"./cursor-cli-model.js\";\nimport type { CursorCliToolEndpoint } from \"./cursor-cli-tools.js\";\nimport { CursorRpcNativeError, type CursorRpc, type CursorRpcEnvelope } from \"./cursor-rpc.js\";\n\ntype ActiveTurn = {\n  text: string;\n  responseBytes: number;\n  responseTooLarge: boolean;\n  completion: Promise<string>;\n  resolve(value: string): void;\n  reject(error: Error): void;\n  terminal: boolean;\n  submitted: boolean;\n  cancelRequested: boolean;\n  admission: Promise<void>;\n  releaseAdmission(): void;\n  nativeStopped: Promise<void>;\n  resolveNativeStopped(): void;\n  stopTask?: Promise<void>;\n  failure?: AgentError;\n  approvals: NativeApprovals;\n  pendingApprovalIds: Set<string | number>;\n  withdrawnApprovals: Set<string | number>;\n};\n\nexport class CursorCliSession implements NativeSession {\n  private closePromise?: Promise<void>;\n  private active?: ActiveTurn;\n  private failure?: AgentError;\n  private first = true;\n  private closed = false;\n\n  constructor(\n    private readonly rpc: CursorRpc,\n    private readonly sessionId: string,\n    private readonly selected: string,\n    private readonly options: AdapterOptions,\n    private readonly tools: CursorCliToolEndpoint,\n    private readonly cleanup: () => Promise<void>,\n  ) {\n    rpc.onMessage = message => this.message(message);\n    rpc.setFailureHandler(error => this.fail(error));\n    tools.onFailure(error => this.fail(error));\n  }\n\n  async turn(prompt: string): Promise<string> {\n    if (this.closed) throw new AgentError(\"SESSION_CLOSED\", \"The Cursor session is closed.\");\n    if (this.failure) throw this.failure;\n    if (this.active) throw new AgentError(\"SESSION_BUSY\", \"Cursor already has an active turn.\");\n    let resolve!: (value: string) => void;\n    let reject!: (error: Error) => void;\n    let releaseAdmission!: () => void;\n    let resolveNativeStopped!: () => void;\n    const completion = new Promise<string>((accept, fail) => { resolve = accept; reject = fail; });\n    const admission = new Promise<void>(accept => { releaseAdmission = accept; });\n    const nativeStopped = new Promise<void>(accept => { resolveNativeStopped = accept; });\n    void completion.catch(() => {});\n    const active: ActiveTurn = {\n      text: \"\", responseBytes: 0, responseTooLarge: false, completion, resolve, reject,\n      terminal: false, submitted: false, cancelRequested: false,\n      admission, releaseAdmission, nativeStopped, resolveNativeStopped,\n      approvals: new NativeApprovals(), pendingApprovalIds: new Set(), withdrawnApprovals: new Set(),\n    };\n    this.active = active;\n    try {\n      await applyCursorCliModel(this.rpc, this.sessionId, this.selected);\n      if (this.failure) throw this.failure;\n      if (active.cancelRequested || this.closed) throw new AgentError(\"INTERRUPTED\", \"The Cursor turn was interrupted before submission.\");\n      this.tools.beginTurn();\n      const text = this.first && this.options.agent.instructions\n        ? firstPrompt(this.options.agent.instructions, prompt)\n        : prompt;\n      active.submitted = true;\n      active.releaseAdmission();\n      const promptRequest = this.rpc.request(\"session/prompt\", { sessionId: this.sessionId, prompt: [{ type: \"text\", text }] });\n      this.first = false;\n      const result = await promptRequest;\n      active.resolveNativeStopped();\n      await this.finish(active, result, active.failure);\n    } catch (error) {\n      active.releaseAdmission();\n      active.resolveNativeStopped();\n      const failure = active.failure ?? (error instanceof CursorRpcNativeError\n        ? new AgentError(\"HARNESS_ERROR\", \"Cursor could not complete the native prompt.\")\n        : error instanceof AgentError ? error : new AgentError(\"HARNESS_ERROR\", \"Cursor could not complete the native prompt.\"));\n      await this.finish(active, undefined, failure);\n    }\n    return await completion;\n  }\n\n  async steer(_prompt: string): Promise<void> {\n    throw new AgentError(\"UNSUPPORTED_DELIVERY\", \"Cursor does not expose verified active steering.\");\n  }\n\n  async interrupt(): Promise<void> {\n    const active = this.active;\n    if (!active) return;\n    active.stopTask ??= this.stop(active);\n    return await active.stopTask;\n  }\n\n  async resume(): Promise<string> {\n    throw new AgentError(\"RECOVERY_UNSUPPORTED\", \"Cursor recovery without a new prompt is unavailable.\");\n  }\n\n  close(): Promise<void> {\n    this.closePromise ??= this.closeOwnedResources();\n    return this.closePromise;\n  }\n\n  private async closeOwnedResources(): Promise<void> {\n    this.closed = true;\n    this.tools.stopAdmission();\n    const active = this.active;\n    if (active) {\n      active.cancelRequested = true;\n      active.failure ??= new AgentError(\"SESSION_CLOSED\", \"The Cursor session was closed during execution.\");\n      this.retireApprovals(active);\n      if (active.submitted && !active.terminal) {\n        try { this.rpc.send({ method: \"session/cancel\", params: { sessionId: this.sessionId } }); } catch {}\n      }\n    }\n    let closeFailure: unknown;\n    try { await this.rpc.close(); } catch (error) { closeFailure = error; }\n    await this.tools.close();\n    await active?.completion.catch(() => {});\n    if (closeFailure) throw closeFailure;\n    await this.cleanup();\n  }\n\n  private message(message: CursorRpcEnvelope): void {\n    const active = this.active;\n    const params = asObject(message.params);\n    if (message.method === \"$/cancel_request\" && active && (typeof params?.requestId === \"string\" || typeof params?.requestId === \"number\")) {\n      if (active.pendingApprovalIds.delete(params.requestId)) {\n        active.withdrawnApprovals.add(params.requestId);\n        active.approvals.withdraw(params.requestId);\n      }\n      return;\n    }\n    if (message.id !== undefined) {\n      if (active && active.submitted && !active.terminal && !active.cancelRequested && !active.failure\n        && params?.sessionId === this.sessionId && message.method === \"session/request_permission\" && this.options.onApproval) {\n        try {\n          const request = cursorCliApproval(message.params);\n          active.pendingApprovalIds.add(message.id);\n          void active.approvals.request(message.id, request, this.options.onApproval).then(content => {\n            if (this.active === active && !active.terminal && !active.cancelRequested && !active.failure && !active.withdrawnApprovals.has(message.id!)) {\n              active.pendingApprovalIds.delete(message.id!);\n              this.rpc.send({ id: message.id, result: { outcome: { outcome: \"selected\", optionId: content.decision } } });\n            }\n          }).catch(error => {\n            if (!(error instanceof AgentError && error.code === \"REQUEST_EXPIRED\")) this.unsupportedRequest(message, active);\n          }).finally(() => {\n            active.pendingApprovalIds.delete(message.id!);\n            active.withdrawnApprovals.delete(message.id!);\n          });\n          return;\n        } catch {}\n      }\n      this.unsupportedRequest(message, active);\n      return;\n    }\n    if (message.method !== \"session/update\") return;\n    if (!params || params.sessionId !== this.sessionId || !active || active.terminal) return;\n    const update = asObject(params.update);\n    if (!update || typeof update.sessionUpdate !== \"string\") {\n      this.fail(new AgentError(\"PROTOCOL_ERROR\", \"Cursor returned an invalid ACP session update.\"));\n      return;\n    }\n    if (update.sessionUpdate === \"config_option_update\") {\n      try { verifyCursorCliModelUpdate(update.configOptions, this.selected); }\n      catch (error) {\n        this.stopForModelFailure(active, error instanceof AgentError\n          ? error\n          : new AgentError(\"PROTOCOL_ERROR\", \"Cursor returned an invalid native model configuration.\"));\n      }\n      return;\n    }\n    if (update.sessionUpdate !== \"agent_message_chunk\") return;\n    const content = asObject(update.content);\n    if (content?.type !== \"text\" || typeof content.text !== \"string\") {\n      this.fail(new AgentError(\"PROTOCOL_ERROR\", \"Cursor returned an invalid assistant message update.\"));\n      return;\n    }\n    active.responseBytes += Buffer.byteLength(content.text, \"utf8\");\n    if (active.responseBytes > 1024 * 1024) active.responseTooLarge = true;\n    else active.text += content.text;\n  }\n\n  private async finish(active: ActiveTurn, value?: unknown, error?: AgentError): Promise<void> {\n    if (active.terminal) return;\n    active.terminal = true;\n    this.retireApprovals(active);\n    this.tools.stopAdmission();\n    await this.tools.drain();\n    if (this.active === active) this.active = undefined;\n    if (error) return active.reject(error);\n    const result = asObject(value);\n    if (!result || typeof result.stopReason !== \"string\") {\n      const failure = new AgentError(\"PROTOCOL_ERROR\", \"Cursor returned an invalid native terminal result.\");\n      this.failure = failure;\n      return active.reject(failure);\n    }\n    if (active.responseTooLarge) return active.reject(new AgentError(\"RESPONSE_TOO_LARGE\", \"Cursor response exceeds 1 MiB.\"));\n    if (result.stopReason === \"end_turn\") return active.resolve(active.text);\n    if (result.stopReason === \"cancelled\") return active.reject(new AgentError(\"INTERRUPTED\", \"The Cursor turn was interrupted.\"));\n    active.reject(new AgentError(\"HARNESS_ERROR\", \"Cursor did not complete the native turn successfully.\"));\n  }\n\n  private async stop(active: ActiveTurn): Promise<void> {\n    active.cancelRequested = true;\n    this.retireApprovals(active);\n    this.tools.stopAdmission();\n    try {\n      await bounded(active.admission, 2_000);\n      if (active.submitted && !active.terminal) this.rpc.send({ method: \"session/cancel\", params: { sessionId: this.sessionId } });\n      const callbacks = this.tools.drain();\n      await bounded(active.nativeStopped, 3_000);\n      await callbacks;\n      await active.completion.catch(() => {});\n    } catch {\n      const failure = new AgentError(\"CANCELLATION_FAILED\", \"Cursor did not confirm that native execution stopped.\");\n      active.failure = failure;\n      this.failure = failure;\n      this.tools.stopAdmission();\n      await this.rpc.close().catch(() => {});\n      await this.tools.drain();\n      await this.finish(active, undefined, failure);\n      throw failure;\n    }\n  }\n\n  private fail(error: AgentError): void {\n    this.failure ??= error;\n    this.tools.stopAdmission();\n    const active = this.active;\n    if (active) this.retireApprovals(active);\n    if (active) void this.finish(active, undefined, this.failure);\n    void this.rpc.close().catch(() => {});\n  }\n\n  private stopForModelFailure(active: ActiveTurn, failure: AgentError): void {\n    if (active.failure) return;\n    active.failure = failure;\n    this.failure ??= failure;\n    this.tools.stopAdmission();\n    this.retireApprovals(active);\n    active.stopTask ??= this.stop(active);\n    void active.stopTask.catch(() => {});\n  }\n\n  private unsupportedRequest(message: CursorRpcEnvelope, active: ActiveTurn | undefined): void {\n    if (active && message.id !== undefined && active.pendingApprovalIds.has(message.id)) this.retireApproval(active, message.id);\n    else this.respondCancelled(message.id);\n    const failure = new AgentError(\"INPUT_REQUIRED\", \"Cursor requested unsupported interactive input; no permission was granted.\");\n    if (!active) return this.fail(failure);\n    if (active.failure) return;\n    active.failure = failure;\n    this.retireApprovals(active);\n    this.tools.stopAdmission();\n    active.stopTask ??= this.stop(active);\n    void active.stopTask.catch(() => {});\n  }\n\n  private retireApprovals(active: ActiveTurn): void {\n    for (const id of [...active.pendingApprovalIds]) this.retireApproval(active, id);\n    active.approvals.clear();\n  }\n\n  private retireApproval(active: ActiveTurn, id: string | number): void {\n    if (!active.pendingApprovalIds.delete(id)) return;\n    active.approvals.withdraw(id);\n    if (!active.withdrawnApprovals.has(id)) this.respondCancelled(id);\n  }\n\n  private respondCancelled(id: string | number | undefined): void {\n    if (id === undefined) return;\n    try { this.rpc.send({ id, result: { outcome: { outcome: \"cancelled\" } } }); } catch {}\n  }\n}\n\nfunction firstPrompt(instructions: string, prompt: string): string {\n  return `<subharness-instructions>\\n${instructions}\\n</subharness-instructions>\\n\\n${prompt}`;\n}\n\nfunction asObject(value: unknown): Record<string, any> | undefined {\n  return value && typeof value === \"object\" && !Array.isArray(value) ? value as Record<string, any> : undefined;\n}\n\nasync function bounded<T>(promise: Promise<T>, milliseconds: number): Promise<T> {\n  let timer: NodeJS.Timeout | undefined;\n  try {\n    return await Promise.race([promise, new Promise<never>((_resolve, reject) => {\n      timer = setTimeout(() => reject(new Error(\"timeout\")), milliseconds);\n      timer.unref();\n    })]);\n  } finally { clearTimeout(timer); }\n}\n"]}

package/dist/adapters/cursor-cli-tools.d.ts

@@ -0,0 +1,20 @@
+import { AgentError } from "../errors.js";
+import type { ExecutionDefinition } from "./types.js";
+export type CursorCliToolEndpoint = {
+    readonly descriptor?: {
+        readonly type: "http";
+        readonly name: string;
+        readonly url: string;
+        readonly headers: {
+            name: string;
+            value: string;
+        }[];
+    };
+    waitReady(timeoutMs: number): Promise<void>;
+    onFailure(handler: (error: AgentError) => void): void;
+    beginTurn(): void;
+    stopAdmission(): void;
+    drain(): Promise<void>;
+    close(): Promise<void>;
+};
+export declare function startCursorCliTools(agent: Pick<ExecutionDefinition, "tools">): Promise<CursorCliToolEndpoint>;

package/dist/adapters/cursor-cli-tools.js

@@ -0,0 +1,181 @@
+import { randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
+import { createServer } from "node:http";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { AgentError } from "../errors.js";
+import { executeTool, toolJsonSchema } from "../sdk/tools.js";
+import { mcpToolContent } from "./mcp-tool-content.js";
+const MAX_MCP_BODY_BYTES = 16 * 1024 * 1024;
+export async function startCursorCliTools(agent) {
+    const definitions = Object.entries(agent.tools ?? {});
+    if (definitions.length === 0)
+        return emptyEndpoint();
+    for (const [, definition] of definitions)
+        toolJsonSchema(definition);
+    const token = randomBytes(32).toString("base64url");
+    const namespace = `subharness_${randomUUID().replaceAll("-", "")}`;
+    const pending = new Set();
+    let accepting = false;
+    let endpointFailure;
+    let failureHandler;
+    let initialized = false;
+    let resolveReady;
+    let rejectReady;
+    const readiness = new Promise((resolve, reject) => { resolveReady = resolve; rejectReady = reject; });
+    void readiness.catch(() => { });
+    const mcp = new McpServer({ name: namespace, version: "1.0.0" });
+    mcp.server.oninitialized = () => { initialized = true; resolveReady(); };
+    for (const [name, definition] of definitions) {
+        mcp.registerTool(name, { description: definition.description, inputSchema: definition.inputSchema }, async (input) => {
+            if (!accepting)
+                return toolError("The task is not accepting tool calls.");
+            const execution = executeTool(definition, input);
+            pending.add(execution);
+            try {
+                return { content: mcpToolContent(await execution) };
+            }
+            catch (error) {
+                return toolError(error instanceof AgentError ? `Tool failed (${error.code}).` : "The custom tool failed.");
+            }
+            finally {
+                pending.delete(execution);
+            }
+        });
+    }
+    const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: randomUUID, enableJsonResponse: true });
+    await mcp.connect(transport);
+    let http;
+    let closing;
+    let draining;
+    const drain = () => {
+        accepting = false;
+        return draining ??= Promise.allSettled([...pending]).then(() => { }).finally(() => { draining = undefined; });
+    };
+    const closeEndpoint = () => closing ??= (async () => {
+        accepting = false;
+        rejectReady(new AgentError("HARNESS_FAILED", "The private Cursor tool endpoint closed before initialization."));
+        await drain();
+        await mcp.close().catch(() => { });
+        if (http)
+            await closeHttp(http);
+    })();
+    const failEndpoint = () => {
+        if (endpointFailure || closing)
+            return;
+        endpointFailure = new AgentError("HARNESS_FAILED", "The private Cursor tool endpoint failed.");
+        accepting = false;
+        rejectReady(endpointFailure);
+        failureHandler?.(endpointFailure);
+        void closeEndpoint();
+    };
+    mcp.server.onerror = failEndpoint;
+    mcp.server.onclose = failEndpoint;
+    try {
+        http = createServer({ maxHeaderSize: 16 * 1024 }, (request, response) => {
+            if (request.url !== "/mcp" || !authorized(request.headers.authorization, token)) {
+                response.writeHead(401, { "content-type": "application/json" });
+                response.end(JSON.stringify({ error: "unauthorized" }));
+                return;
+            }
+            void handleRequest(transport, request, response).catch(() => {
+                if (!response.headersSent)
+                    response.writeHead(500);
+                response.end();
+                failEndpoint();
+            });
+        });
+        await new Promise((resolve, reject) => {
+            http.once("error", reject);
+            http.listen(0, "127.0.0.1", () => {
+                http.off("error", reject);
+                http.on("error", failEndpoint);
+                resolve();
+            });
+        });
+    }
+    catch {
+        await closeEndpoint();
+        throw new AgentError("HARNESS_FAILED", "The private Cursor tool endpoint could not start.");
+    }
+    const address = http.address();
+    if (!address || typeof address === "string") {
+        await closeEndpoint();
+        throw new AgentError("HARNESS_FAILED", "The private Cursor tool endpoint did not bind to loopback.");
+    }
+    return {
+        async waitReady(timeoutMs) {
+            if (endpointFailure)
+                throw endpointFailure;
+            if (closing)
+                throw new AgentError("HARNESS_FAILED", "The private Cursor tool endpoint is closed.");
+            if (!Number.isFinite(timeoutMs) || timeoutMs <= 0)
+                throw new AgentError("HARNESS_FAILED", "Cursor tool initialization requires a bounded timeout.");
+            const timer = setTimeout(failEndpoint, timeoutMs);
+            try {
+                await readiness;
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        },
+        descriptor: { type: "http", name: namespace, url: `http://127.0.0.1:${address.port}/mcp`, headers: [{ name: "Authorization", value: `Bearer ${token}` }] },
+        onFailure(handler) { failureHandler = handler; if (endpointFailure)
+            handler(endpointFailure); },
+        beginTurn() {
+            if (!initialized || closing || draining || endpointFailure)
+                throw new AgentError("HARNESS_FAILED", "The private Cursor tool endpoint is unavailable.");
+            accepting = true;
+        },
+        stopAdmission() { accepting = false; },
+        drain,
+        close: closeEndpoint,
+    };
+}
+async function handleRequest(transport, request, response) {
+    if (request.method !== "POST")
+        return transport.handleRequest(request, response);
+    const chunks = [];
+    let bytes = 0;
+    for await (const chunk of request.iterator({ destroyOnReturn: false })) {
+        bytes += chunk.length;
+        if (bytes > MAX_MCP_BODY_BYTES) {
+            response.writeHead(413, { connection: "close" });
+            response.end();
+            request.resume();
+            return;
+        }
+        chunks.push(chunk);
+    }
+    let body;
+    try {
+        body = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+    }
+    catch {
+        response.writeHead(400);
+        response.end();
+        return;
+    }
+    await transport.handleRequest(request, response, body);
+}
+function authorized(header, token) {
+    if (typeof header !== "string")
+        return false;
+    const expected = Buffer.from(`Bearer ${token}`);
+    const actual = Buffer.from(header);
+    return actual.length === expected.length && timingSafeEqual(actual, expected);
+}
+function toolError(text) {
+    return { isError: true, content: [{ type: "text", text }] };
+}
+function emptyEndpoint() {
+    return { async waitReady() { }, onFailure() { }, beginTurn() { }, stopAdmission() { }, async drain() { }, async close() { } };
+}
+async function closeHttp(server) {
+    if (!server.listening)
+        return;
+    await new Promise(resolve => {
+        server.close(() => resolve());
+        server.closeAllConnections();
+    });
+}
+//# sourceMappingURL=cursor-cli-tools.js.map

package/dist/adapters/cursor-cli-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-cli-tools.js","sourceRoot":"","sources":["../../src/adapters/cursor-cli-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomBytes, randomUUID, timingSafeEqual } from \"node:crypto\";\nimport { createServer, type IncomingMessage, type ServerResponse, type Server as HttpServer } from \"node:http\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\nimport { AgentError } from \"../errors.js\";\nimport { executeTool, toolJsonSchema } from \"../sdk/tools.js\";\nimport type { ExecutionDefinition } from \"./types.js\";\nimport { mcpToolContent } from \"./mcp-tool-content.js\";\n\nconst MAX_MCP_BODY_BYTES = 16 * 1024 * 1024;\n\nexport type CursorCliToolEndpoint = {\n  readonly descriptor?: { readonly type: \"http\"; readonly name: string; readonly url: string; readonly headers: { name: string; value: string }[] };\n  waitReady(timeoutMs: number): Promise<void>;\n  onFailure(handler: (error: AgentError) => void): void;\n  beginTurn(): void;\n  stopAdmission(): void;\n  drain(): Promise<void>;\n  close(): Promise<void>;\n};\n\nexport async function startCursorCliTools(agent: Pick<ExecutionDefinition, \"tools\">): Promise<CursorCliToolEndpoint> {\n  const definitions = Object.entries(agent.tools ?? {});\n  if (definitions.length === 0) return emptyEndpoint();\n  for (const [, definition] of definitions) toolJsonSchema(definition);\n\n  const token = randomBytes(32).toString(\"base64url\");\n  const namespace = `subharness_${randomUUID().replaceAll(\"-\", \"\")}`;\n  const pending = new Set<Promise<unknown>>();\n  let accepting = false;\n  let endpointFailure: AgentError | undefined;\n  let failureHandler: ((error: AgentError) => void) | undefined;\n  let initialized = false;\n  let resolveReady!: () => void;\n  let rejectReady!: (error: AgentError) => void;\n  const readiness = new Promise<void>((resolve, reject) => { resolveReady = resolve; rejectReady = reject; });\n  void readiness.catch(() => {});\n  const mcp = new McpServer({ name: namespace, version: \"1.0.0\" });\n  mcp.server.oninitialized = () => { initialized = true; resolveReady(); };\n  for (const [name, definition] of definitions) {\n    mcp.registerTool(name, { description: definition.description, inputSchema: definition.inputSchema }, async (input: unknown) => {\n      if (!accepting) return toolError(\"The task is not accepting tool calls.\");\n      const execution = executeTool(definition, input);\n      pending.add(execution);\n      try {\n        return { content: mcpToolContent(await execution) };\n      } catch (error) {\n        return toolError(error instanceof AgentError ? `Tool failed (${error.code}).` : \"The custom tool failed.\");\n      } finally {\n        pending.delete(execution);\n      }\n    });\n  }\n\n  const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: randomUUID, enableJsonResponse: true });\n  await mcp.connect(transport);\n  let http: HttpServer | undefined;\n  let closing: Promise<void> | undefined;\n  let draining: Promise<void> | undefined;\n  const drain = (): Promise<void> => {\n    accepting = false;\n    return draining ??= Promise.allSettled([...pending]).then(() => {}).finally(() => { draining = undefined; });\n  };\n  const closeEndpoint = (): Promise<void> => closing ??= (async () => {\n    accepting = false;\n    rejectReady(new AgentError(\"HARNESS_FAILED\", \"The private Cursor tool endpoint closed before initialization.\"));\n    await drain();\n    await mcp.close().catch(() => {});\n    if (http) await closeHttp(http);\n  })();\n  const failEndpoint = () => {\n    if (endpointFailure || closing) return;\n    endpointFailure = new AgentError(\"HARNESS_FAILED\", \"The private Cursor tool endpoint failed.\");\n    accepting = false;\n    rejectReady(endpointFailure);\n    failureHandler?.(endpointFailure);\n    void closeEndpoint();\n  };\n  mcp.server.onerror = failEndpoint;\n  mcp.server.onclose = failEndpoint;\n  try {\n    http = createServer({ maxHeaderSize: 16 * 1024 }, (request, response) => {\n      if (request.url !== \"/mcp\" || !authorized(request.headers.authorization, token)) {\n        response.writeHead(401, { \"content-type\": \"application/json\" });\n        response.end(JSON.stringify({ error: \"unauthorized\" }));\n        return;\n      }\n      void handleRequest(transport, request, response).catch(() => {\n        if (!response.headersSent) response.writeHead(500);\n        response.end();\n        failEndpoint();\n      });\n    });\n    await new Promise<void>((resolve, reject) => {\n      http!.once(\"error\", reject);\n      http!.listen(0, \"127.0.0.1\", () => {\n        http!.off(\"error\", reject);\n        http!.on(\"error\", failEndpoint);\n        resolve();\n      });\n    });\n  } catch {\n    await closeEndpoint();\n    throw new AgentError(\"HARNESS_FAILED\", \"The private Cursor tool endpoint could not start.\");\n  }\n  const address = http.address();\n  if (!address || typeof address === \"string\") {\n    await closeEndpoint();\n    throw new AgentError(\"HARNESS_FAILED\", \"The private Cursor tool endpoint did not bind to loopback.\");\n  }\n\n  return {\n    async waitReady(timeoutMs) {\n      if (endpointFailure) throw endpointFailure;\n      if (closing) throw new AgentError(\"HARNESS_FAILED\", \"The private Cursor tool endpoint is closed.\");\n      if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) throw new AgentError(\"HARNESS_FAILED\", \"Cursor tool initialization requires a bounded timeout.\");\n      const timer = setTimeout(failEndpoint, timeoutMs);\n      try { await readiness; }\n      finally { clearTimeout(timer); }\n    },\n    descriptor: { type: \"http\", name: namespace, url: `http://127.0.0.1:${address.port}/mcp`, headers: [{ name: \"Authorization\", value: `Bearer ${token}` }] },\n    onFailure(handler) { failureHandler = handler; if (endpointFailure) handler(endpointFailure); },\n    beginTurn() {\n      if (!initialized || closing || draining || endpointFailure) throw new AgentError(\"HARNESS_FAILED\", \"The private Cursor tool endpoint is unavailable.\");\n      accepting = true;\n    },\n    stopAdmission() { accepting = false; },\n    drain,\n    close: closeEndpoint,\n  };\n}\n\nasync function handleRequest(transport: StreamableHTTPServerTransport, request: IncomingMessage, response: ServerResponse): Promise<void> {\n  if (request.method !== \"POST\") return transport.handleRequest(request, response);\n  const chunks: Buffer[] = [];\n  let bytes = 0;\n  for await (const chunk of request.iterator({ destroyOnReturn: false })) {\n    bytes += chunk.length;\n    if (bytes > MAX_MCP_BODY_BYTES) {\n      response.writeHead(413, { connection: \"close\" });\n      response.end();\n      request.resume();\n      return;\n    }\n    chunks.push(chunk);\n  }\n  let body: unknown;\n  try { body = JSON.parse(Buffer.concat(chunks).toString(\"utf8\")); }\n  catch { response.writeHead(400); response.end(); return; }\n  await transport.handleRequest(request, response, body);\n}\n\nfunction authorized(header: string | undefined, token: string): boolean {\n  if (typeof header !== \"string\") return false;\n  const expected = Buffer.from(`Bearer ${token}`);\n  const actual = Buffer.from(header);\n  return actual.length === expected.length && timingSafeEqual(actual, expected);\n}\n\nfunction toolError(text: string) {\n  return { isError: true, content: [{ type: \"text\" as const, text }] };\n}\n\nfunction emptyEndpoint(): CursorCliToolEndpoint {\n  return { async waitReady() {}, onFailure() {}, beginTurn() {}, stopAdmission() {}, async drain() {}, async close() {} };\n}\n\nasync function closeHttp(server: HttpServer): Promise<void> {\n  if (!server.listening) return;\n  await new Promise<void>(resolve => {\n    server.close(() => resolve());\n    server.closeAllConnections();\n  });\n}\n"]}

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

@@ -0,0 +1,2 @@
+import type { AdapterOptions, NativeSession } from "./types.js";
+export declare function openCursorCli(options: AdapterOptions): Promise<NativeSession>;