opencodev2-cursor 0.0.0-stage → 0.1.0

package/dist/backends/native/backend.d.ts

@@ -0,0 +1,12 @@
+import type { BackendEvent, BackendRunRequest, CursorBackend } from "../types.js";
+/** OAuth access-token backend. Uses the SDK unless CURSOR_NATIVE_TRANSPORT=connect. */
+export declare class NativeBackend implements CursorBackend {
+    private readonly accessToken;
+    readonly id: "native";
+    private readonly sdk;
+    constructor(accessToken: () => Promise<string>);
+    listModels(): Promise<import("../types.js").CursorModel[]>;
+    warmUp(cwd: string): Promise<import("../types.js").CursorModel[]>;
+    run(request: BackendRunRequest): AsyncIterable<BackendEvent>;
+    dispose(): Promise<void>;
+}

package/dist/backends/native/backend.js

@@ -0,0 +1,105 @@
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { fileURLToPath } from "node:url";
+import { promptWithToolResults } from "../types.js";
+import { SdkBackend } from "../sdk.js";
+import { encodeConnectFrames, encodeRunRequest, decodeConnectData, stringsInProtobuf, toolCallFromText } from "./proto.js";
+import { nodeBinary } from "../spawn.js";
+import { mapCursorTool } from "../../proxy/tools.js";
+import { log } from "../../util/log.js";
+function bridgeScript() {
+    return fileURLToPath(new URL("./h2-bridge.mjs", import.meta.url));
+}
+async function* connectRun(request, accessToken) {
+    const child = spawn(nodeBinary(), [bridgeScript()], {
+        stdio: ["pipe", "pipe", "pipe"],
+        windowsHide: true,
+        env: process.env,
+    });
+    const lines = createInterface({ input: child.stdout });
+    const prompt = promptWithToolResults(request.prompt, request.toolResults);
+    const body = encodeConnectFrames(encodeRunRequest(request.model, prompt, {
+        modelParams: request.modelParams,
+        tools: request.tools,
+        toolResults: request.toolResults,
+    }));
+    child.stdin.write(JSON.stringify({
+        type: "request",
+        id: "run",
+        path: "/agent.v1.AgentService/Run",
+        authorization: `Bearer ${accessToken}`,
+        body: body.toString("base64"),
+    }) + "\n");
+    const onAbort = () => child.kill();
+    request.signal.addEventListener("abort", onAbort, { once: true });
+    try {
+        for await (const line of lines) {
+            const event = JSON.parse(line);
+            if (event.type === "error") {
+                yield { type: "error", message: event.message || "Cursor Connect request failed" };
+                return;
+            }
+            if (event.type === "data" && event.data) {
+                const payload = Buffer.from(event.data, "base64");
+                const frames = decodeConnectData(payload);
+                const texts = frames.flatMap((frame) => stringsInProtobuf(frame));
+                if (texts.length === 0 && event.status && event.status >= 400) {
+                    yield { type: "error", message: `Cursor Connect returned HTTP ${event.status}` };
+                    return;
+                }
+                const advertised = new Set(request.tools.map((tool) => tool.name));
+                for (const text of texts) {
+                    const call = toolCallFromText(text);
+                    if (!call) {
+                        yield { type: "text", text };
+                        continue;
+                    }
+                    yield {
+                        type: "tool_call",
+                        id: call.id,
+                        name: mapCursorTool(call.name, advertised) || call.name,
+                        arguments: call.arguments,
+                    };
+                    return;
+                }
+            }
+            if (event.type === "end") {
+                yield { type: "done" };
+                return;
+            }
+        }
+        yield { type: "error", message: "Cursor Connect bridge closed" };
+    }
+    finally {
+        request.signal.removeEventListener("abort", onAbort);
+        child.kill();
+    }
+}
+/** OAuth access-token backend. Uses the SDK unless CURSOR_NATIVE_TRANSPORT=connect. */
+export class NativeBackend {
+    accessToken;
+    id = "native";
+    sdk;
+    constructor(accessToken) {
+        this.accessToken = accessToken;
+        this.sdk = new SdkBackend(accessToken);
+    }
+    listModels() {
+        return this.sdk.listModels();
+    }
+    warmUp(cwd) {
+        return this.sdk.warmUp(cwd);
+    }
+    async *run(request) {
+        if (process.env.CURSOR_NATIVE_TRANSPORT === "connect") {
+            log("info", "native connect run", { model: request.model });
+            yield* connectRun(request, await this.accessToken());
+            return;
+        }
+        yield* this.sdk.run(request);
+    }
+    async dispose() {
+        await this.sdk.dispose();
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/backends/native/backend.js.map

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

package/dist/backends/native/h2-bridge.mjs

@@ -0,0 +1,55 @@
+import http2 from "node:http2"
+import readline from "node:readline"
+
+const client = http2.connect(process.env.CURSOR_BACKEND_URL || "https://api2.cursor.sh")
+client.on("error", (error) => {
+  process.stdout.write(JSON.stringify({ type: "error", message: error.message }) + "\n")
+})
+
+function emit(message) {
+  process.stdout.write(JSON.stringify(message) + "\n")
+}
+
+const lines = readline.createInterface({ input: process.stdin })
+lines.on("line", (line) => {
+  let cmd
+  try {
+    cmd = JSON.parse(line)
+  } catch {
+    return
+  }
+  if (cmd.type !== "request") return
+  const headers = {
+    ":method": "POST",
+    ":path": cmd.path,
+    "content-type": cmd.contentType || "application/connect+proto",
+    "connect-protocol-version": "1",
+    authorization: cmd.authorization,
+  }
+  const request = client.request(headers)
+  let pending = Buffer.alloc(0)
+  let status
+  const emitFrame = (frame) => {
+    emit({ id: cmd.id, type: "data", status, data: frame.toString("base64") })
+  }
+  request.on("response", (responseHeaders) => {
+    status = responseHeaders[":status"]
+    emit({ id: cmd.id, type: "headers", status })
+  })
+  request.on("data", (chunk) => {
+    pending = Buffer.concat([pending, chunk])
+    while (pending.length >= 5) {
+      const length = pending.readUInt32BE(1)
+      const frameLength = 5 + length
+      if (pending.length < frameLength) break
+      emitFrame(pending.subarray(0, frameLength))
+      pending = pending.subarray(frameLength)
+    }
+  })
+  request.on("end", () => {
+    if (pending.length) emitFrame(pending)
+    emit({ id: cmd.id, type: "end" })
+  })
+  request.on("error", (error) => emit({ id: cmd.id, type: "error", message: error.message }))
+  request.end(Buffer.from(cmd.body, "base64"))
+})

package/dist/backends/native/proto.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Protobuf body for the native Connect fallback.
+ * Field numbers belong to this plugin, not Cursor's AgentService schema:
+ * 1 model, 2 prompt, 3 model params JSON, 4 tools JSON, 5 tool results JSON.
+ */
+export interface ConnectRunExtra {
+    modelParams?: Array<{
+        id: string;
+        value: string;
+    }>;
+    tools?: Array<{
+        name: string;
+        description?: string;
+        parameters?: unknown;
+    }>;
+    toolResults?: Array<{
+        id: string;
+        content: string;
+    }>;
+}
+export declare function encodeRunRequest(model: string, prompt: string, extra?: ConnectRunExtra): Buffer;
+/** Connect streaming envelope: one data frame plus an end-of-stream frame. */
+export declare function encodeConnectFrames(payload: Buffer): Buffer;
+export declare function decodeConnectData(frame: Buffer): Buffer[];
+export declare function stringsInProtobuf(payload: Buffer): string[];
+/** A Connect string that is itself a tool call. Plain assistant text is left alone. */
+export declare function toolCallFromText(text: string): {
+    id: string;
+    name: string;
+    arguments: string;
+} | undefined;

package/dist/backends/native/proto.js

@@ -0,0 +1,130 @@
+/**
+ * Protobuf body for the native Connect fallback.
+ * Field numbers belong to this plugin, not Cursor's AgentService schema:
+ * 1 model, 2 prompt, 3 model params JSON, 4 tools JSON, 5 tool results JSON.
+ */
+function encodeVarint(value) {
+    const bytes = [];
+    let rest = value >>> 0;
+    while (rest > 127) {
+        bytes.push((rest & 0x7f) | 0x80);
+        rest >>>= 7;
+    }
+    bytes.push(rest);
+    return bytes;
+}
+function encodeString(field, value) {
+    const data = Buffer.from(value);
+    return [(field << 3) | 2, ...encodeVarint(data.length), ...data];
+}
+export function encodeRunRequest(model, prompt, extra) {
+    const bytes = [...encodeString(1, model), ...encodeString(2, prompt)];
+    if (extra?.modelParams?.length)
+        bytes.push(...encodeString(3, JSON.stringify(extra.modelParams)));
+    if (extra?.tools?.length)
+        bytes.push(...encodeString(4, JSON.stringify(extra.tools)));
+    if (extra?.toolResults?.length)
+        bytes.push(...encodeString(5, JSON.stringify(extra.toolResults)));
+    return Buffer.from(bytes);
+}
+/** Connect streaming envelope: one data frame plus an end-of-stream frame. */
+export function encodeConnectFrames(payload) {
+    const header = Buffer.alloc(5);
+    header[0] = 0;
+    header.writeUInt32BE(payload.length, 1);
+    const end = Buffer.alloc(5);
+    end[0] = 0x02;
+    end.writeUInt32BE(2, 1);
+    return Buffer.concat([header, payload, end, Buffer.from("{}")]);
+}
+export function decodeConnectData(frame) {
+    const parts = [];
+    let offset = 0;
+    while (offset + 5 <= frame.length) {
+        const flags = frame[offset];
+        const length = frame.readUInt32BE(offset + 1);
+        offset += 5;
+        const body = frame.subarray(offset, offset + length);
+        offset += length;
+        if ((flags & 0x02) === 0)
+            parts.push(Buffer.from(body));
+    }
+    return parts;
+}
+export function stringsInProtobuf(payload) {
+    const found = [];
+    let offset = 0;
+    while (offset < payload.length) {
+        const key = payload[offset];
+        if (key === undefined)
+            break;
+        offset += 1;
+        const wire = key & 7;
+        if (wire === 2) {
+            let length = 0;
+            let shift = 0;
+            while (offset < payload.length) {
+                const byte = payload[offset];
+                offset += 1;
+                if (byte === undefined)
+                    break;
+                length |= (byte & 0x7f) << shift;
+                if ((byte & 0x80) === 0)
+                    break;
+                shift += 7;
+            }
+            const slice = payload.subarray(offset, offset + length);
+            offset += length;
+            const text = readableText(slice);
+            if (text)
+                found.push(text);
+        }
+        else if (wire === 0) {
+            while (offset < payload.length && (payload[offset] & 0x80) !== 0)
+                offset += 1;
+            offset += 1;
+        }
+        else
+            break;
+    }
+    return found;
+}
+function readableText(slice) {
+    if (slice.length === 0 || slice.includes(0))
+        return undefined;
+    const text = slice.toString("utf8");
+    if (text.includes("\uFFFD"))
+        return undefined;
+    const chars = [...text];
+    let printable = 0;
+    for (const char of chars) {
+        const code = char.codePointAt(0) ?? 0;
+        if (code === 9 || code === 10 || code === 13 || code >= 32)
+            printable += 1;
+    }
+    if (printable !== chars.length)
+        return undefined;
+    return text;
+}
+/** A Connect string that is itself a tool call. Plain assistant text is left alone. */
+export function toolCallFromText(text) {
+    if (!text.startsWith("{"))
+        return undefined;
+    try {
+        const value = JSON.parse(text);
+        if (value.type !== "tool_call" || typeof value.name !== "string")
+            return undefined;
+        const args = typeof value.arguments === "string"
+            ? value.arguments
+            : value.arguments && typeof value.arguments === "object"
+                ? JSON.stringify(value.arguments)
+                : undefined;
+        if (!args)
+            return undefined;
+        return { id: typeof value.id === "string" ? value.id : "tool", name: value.name, arguments: args };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=proto.js.map

package/dist/backends/native/proto.js.map

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

package/dist/backends/sdk-runner.mjs

@@ -0,0 +1,317 @@
+import path from "node:path"
+import readline from "node:readline"
+import { randomUUID } from "node:crypto"
+import { Agent, Cursor, JsonlLocalAgentStore, configureCursorSdk, createAgentPlatform } from "@cursor/sdk"
+
+const major = Number(process.versions.node.split(".")[0] ?? 0)
+const minor = Number(process.versions.node.split(".")[1] ?? 0)
+if (major < 22 || (major === 22 && minor < 13)) {
+  process.stdout.write(JSON.stringify({ type: "error", message: `Cursor SDK needs Node.js 22.13 or newer (this runner is ${process.version}). Set CURSOR_ACP_NODE_BIN to a newer node.` }) + "\n")
+  process.exit(1)
+}
+
+/** Long-lived hosts: avoid re-walking the tree every 20s (SDK default). Override with CURSOR_RIPWALK_CACHE_TTL_MS. */
+const WORKSPACE_SCAN_TTL_MS = Number(process.env.CURSOR_RIPWALK_CACHE_TTL_MS || 30 * 60 * 1000)
+
+const waiters = new Map()
+let agent = null
+let activeModel = null
+let activeSession = null
+let runHandle = null
+let busy = false
+/** Bumped when a run is force-cleared so a superseded turn's finally does not clear the new turn's busy flag. */
+let turnGeneration = 0
+let store = null
+let storeRoot = null
+let platform = null
+let prewarmRelease = null
+let prewarmedCwd = null
+let prewarmedApiKey = null
+
+function emit(message) {
+  process.stdout.write(JSON.stringify(message) + "\n")
+}
+
+function customTools(tools) {
+  const defined = {}
+  for (const tool of tools ?? []) {
+    defined[tool.name] = {
+      description: tool.description || `Host tool ${tool.name}. OpenCode runs it and returns the result.`,
+      inputSchema: tool.parameters && typeof tool.parameters === "object" ? tool.parameters : { type: "object", additionalProperties: true },
+      execute(_args, context) {
+        const id = context?.toolCallId || randomUUID()
+        emit({ type: "tool", id, name: tool.name, arguments: JSON.stringify(_args ?? {}) })
+        return new Promise((resolve) => {
+          waiters.set(id, resolve)
+        })
+      },
+    }
+  }
+  return defined
+}
+
+/** Same shape as modelSelectionKey() in auto-models.ts. The runner cannot import that TypeScript module. */
+function modelKey(cmd) {
+  const params = Array.isArray(cmd.modelParams)
+    ? cmd.modelParams.map((param) => ({ id: String(param.id), value: String(param.value) })).sort((left, right) => left.id.localeCompare(right.id))
+    : []
+  return JSON.stringify({ id: cmd.model || "auto-smart", params })
+}
+
+async function clearStuckRun() {
+  turnGeneration += 1
+  const pending = runHandle
+  runHandle = null
+  for (const [, resolve] of waiters) resolve("(cancelled)")
+  waiters.clear()
+  if (pending) {
+    try {
+      await pending.cancel()
+    } catch {
+      // Already terminal or store already marked cancelled.
+    }
+  }
+  busy = false
+}
+
+function ensureStore(stateRoot) {
+  if (store && storeRoot === stateRoot) return
+  storeRoot = stateRoot
+  store = new JsonlLocalAgentStore(stateRoot)
+  configureCursorSdk({
+    local: {
+      store,
+      useHttp1ForAgent: process.env.CURSOR_SDK_HTTP1 === "1",
+      workspaceScanCacheTtlMs: Number.isFinite(WORKSPACE_SCAN_TTL_MS) ? WORKSPACE_SCAN_TTL_MS : 30 * 60 * 1000,
+    },
+  })
+}
+
+function agentLocalOptions(cmd, tools) {
+  return {
+    cwd: cmd.cwd,
+    store,
+    settingSources: [],
+    customTools: tools && Object.keys(tools).length ? tools : undefined,
+  }
+}
+
+async function ensurePrewarm(cmd) {
+  if (!cmd.cwd || !cmd.apiKey) return
+  ensureStore(cmd.stateRoot || path.join(cmd.cwd, ".opencodev2-cursor-sdk"))
+  if (prewarmRelease && prewarmedCwd === cmd.cwd && prewarmedApiKey === cmd.apiKey) return
+  if (prewarmRelease) {
+    try {
+      await prewarmRelease()
+    } catch {
+      // Best effort; a later send() rebuilds.
+    }
+    prewarmRelease = null
+    prewarmedCwd = null
+    prewarmedApiKey = null
+  }
+  if (!platform) platform = await createAgentPlatform()
+  try {
+    prewarmRelease = await platform.prewarmLocalWorkspace({
+      apiKey: cmd.apiKey,
+      model: { id: "auto-smart" },
+      name: "opencodev2-cursor",
+      local: {
+        cwd: cmd.cwd,
+        store,
+        settingSources: [],
+      },
+    })
+    prewarmedCwd = cmd.cwd
+    prewarmedApiKey = cmd.apiKey
+  } catch (error) {
+    emit({
+      type: "warn",
+      message: error instanceof Error ? error.message : String(error),
+    })
+  }
+}
+
+async function ensureAgent(cmd) {
+  const requestedModel = modelKey(cmd)
+  const sessionKey = cmd.sessionKey || "default"
+  if (
+    agent
+    && activeModel === requestedModel
+    && activeSession === sessionKey
+    && (!cmd.agentId || agent.agentId === cmd.agentId)
+  ) {
+    return agent
+  }
+  ensureStore(cmd.stateRoot)
+  await ensurePrewarm(cmd)
+  const tools = customTools(cmd.tools)
+  const model = { id: cmd.model || "auto-smart" }
+  if (Array.isArray(cmd.modelParams) && cmd.modelParams.length) model.params = cmd.modelParams
+  const options = {
+    apiKey: cmd.apiKey,
+    model,
+    name: "opencodev2-cursor",
+    local: agentLocalOptions(cmd, tools),
+  }
+  if (cmd.tools?.length) {
+    options.tools = ["mcp"]
+    options.disallowedTools = ["shell", "read", "edit", "grep", "glob", "delete", "task"]
+  }
+  // Resume only when the parent sends an agentId. A model change omits it, so this creates a new agent.
+  agent = cmd.agentId ? await Agent.resume(cmd.agentId, options) : await Agent.create(options)
+  activeModel = requestedModel
+  activeSession = sessionKey
+  emit({ type: "session", agentId: agent.agentId })
+  return agent
+}
+
+async function startRun(current, prompt) {
+  // local.force expires orphaned activeRunId left by abort/crash/retry (Cursor SDK docs).
+  try {
+    return await current.send(prompt, { local: { force: true } })
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    if (!/already has active run/i.test(message)) throw error
+    const pending = runHandle
+    runHandle = null
+    for (const [, resolve] of waiters) resolve("(cancelled)")
+    waiters.clear()
+    if (pending) {
+      try {
+        await pending.cancel()
+      } catch {
+        // Ignore.
+      }
+    }
+    return current.send(prompt, { local: { force: true } })
+  }
+}
+
+async function runTurn(cmd) {
+  const toolContinue = (cmd.toolResults ?? []).length > 0
+  if (toolContinue) {
+    // Tool results are normally delivered as type=tool_result; keep this path from clearing busy.
+    for (const result of cmd.toolResults ?? []) {
+      const resolve = waiters.get(result.id)
+      if (resolve) {
+        waiters.delete(result.id)
+        resolve(result.content ?? "")
+      }
+    }
+    return
+  }
+  if (busy) {
+    // OpenCode retried or sent a new user message while a previous run was wedged.
+    await clearStuckRun()
+  }
+  const myGeneration = turnGeneration + 1
+  turnGeneration = myGeneration
+  busy = true
+  try {
+    const current = await ensureAgent(cmd)
+    const run = await startRun(current, cmd.prompt || "")
+    if (myGeneration !== turnGeneration) return
+    runHandle = run
+    let sent = ""
+    for await (const event of run.stream()) {
+      if (myGeneration !== turnGeneration) return
+      if (event.type === "assistant") {
+        const blocks = event.message?.content ?? []
+        for (const block of blocks) {
+          if (block.type !== "text" || typeof block.text !== "string") continue
+          const text = block.text.startsWith(sent) ? block.text.slice(sent.length) : block.text
+          sent = block.text.startsWith(sent) ? block.text : sent + block.text
+          if (text) emit({ type: "text", text })
+        }
+      } else if (event.type === "thinking" && event.text) {
+        emit({ type: "reasoning", text: event.text })
+      } else if (event.type === "status" && (event.status === "ERROR" || event.status === "CANCELLED")) {
+        emit({ type: "error", message: event.message || event.status })
+      }
+    }
+    const result = await run.wait()
+    if (myGeneration !== turnGeneration) return
+    runHandle = null
+    if (result.status === "error") emit({ type: "error", message: result.error?.message || "Cursor run failed" })
+    else emit({ type: "done", text: result.result })
+  } catch (error) {
+    if (myGeneration === turnGeneration) {
+      emit({ type: "error", message: error instanceof Error ? error.message : String(error) })
+    }
+  } finally {
+    if (myGeneration === turnGeneration) {
+      busy = false
+      emit({ type: "idle" })
+    }
+  }
+}
+
+async function listModels(cmd) {
+  try {
+    const models = await Cursor.models.list({ apiKey: cmd.apiKey })
+    emit({
+      type: "models",
+      id: cmd.id,
+      models: models.map((model) => ({ id: model.id, name: model.displayName || model.id })),
+    })
+  } catch (error) {
+    emit({ type: "error", id: cmd.id, message: error instanceof Error ? error.message : String(error) })
+  }
+}
+
+async function warm(cmd) {
+  const started = Date.now()
+  try {
+    const modelsPromise = Cursor.models.list({ apiKey: cmd.apiKey }).catch((error) => {
+      throw error
+    })
+    await ensurePrewarm(cmd)
+    const models = await modelsPromise
+    emit({
+      type: "warm",
+      id: cmd.id,
+      ms: Date.now() - started,
+      cwd: cmd.cwd,
+      prewarmed: Boolean(prewarmRelease),
+      models: models.map((model) => ({ id: model.id, name: model.displayName || model.id })),
+    })
+  } catch (error) {
+    emit({ type: "error", id: cmd.id, message: error instanceof Error ? error.message : String(error) })
+  }
+}
+
+const lines = readline.createInterface({ input: process.stdin })
+lines.on("line", (line) => {
+  let cmd
+  try {
+    cmd = JSON.parse(line)
+  } catch {
+    return
+  }
+  if (cmd.type === "tool_result") {
+    const resolve = waiters.get(cmd.id)
+    if (resolve) {
+      waiters.delete(cmd.id)
+      resolve(cmd.content ?? "")
+    }
+    return
+  }
+  if (cmd.type === "cancel") {
+    void clearStuckRun()
+    return
+  }
+  if (cmd.type === "ping") {
+    emit({ type: "pong" })
+    return
+  }
+  if (cmd.type === "models") {
+    void listModels(cmd)
+    return
+  }
+  if (cmd.type === "warm") {
+    void warm(cmd)
+    return
+  }
+  if (cmd.type === "turn") void runTurn(cmd)
+})