@playwo/opencode-cursor-oauth 0.0.0-dev.65683458d3f1 → 0.0.0-dev.762b07a81479

package/dist/auth.js

@@ -111,7 +111,6 @@ export function getTokenExpiry(token) {
             return decoded.exp * 1000 - 5 * 60 * 1000;
         }
     }
-    catch {
-    }
+    catch { }
     return Date.now() + 3600 * 1000;
 }

package/dist/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const CURSOR_PROVIDER_ID: "cursor";
+export declare const OPENCODE_TITLE_REQUEST_MARKER = "Generate a title for this conversation:";

package/dist/constants.js

@@ -0,0 +1,2 @@
+export const CURSOR_PROVIDER_ID = "cursor";
+export const OPENCODE_TITLE_REQUEST_MARKER = "Generate a title for this conversation:";

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

@@ -0,0 +1,13 @@
+import { type CursorBaseRequestOptions } from "./headers";
+export declare function encodeBidiAppendRequest(dataHex: string, requestId: string, appendSeqno: number): Uint8Array;
+export interface CursorSession {
+    write: (data: Uint8Array) => void;
+    end: () => void;
+    onData: (cb: (chunk: Buffer) => void) => void;
+    onClose: (cb: (code: number) => void) => void;
+    readonly alive: boolean;
+}
+export interface CreateCursorSessionOptions extends CursorBaseRequestOptions {
+    requestId: string;
+}
+export declare function createCursorSession(options: CreateCursorSessionOptions): Promise<CursorSession>;

package/dist/cursor/bidi-session.js

@@ -0,0 +1,149 @@
+import { create, toBinary } from "@bufbuild/protobuf";
+import { BidiRequestIdSchema } from "../proto/agent_pb";
+import { CURSOR_API_URL } from "./config";
+import { concatBytes, encodeProtoMessageField, encodeProtoStringField, encodeProtoVarintField, frameConnectMessage, toFetchBody, } from "./connect-framing";
+import { buildCursorHeaders } from "./headers";
+import { errorDetails, logPluginError, logPluginWarn } from "../logger";
+export function encodeBidiAppendRequest(dataHex, requestId, appendSeqno) {
+    const requestIdBytes = toBinary(BidiRequestIdSchema, create(BidiRequestIdSchema, { requestId }));
+    return concatBytes([
+        encodeProtoStringField(1, dataHex),
+        encodeProtoMessageField(2, requestIdBytes),
+        encodeProtoVarintField(3, appendSeqno),
+    ]);
+}
+export async function createCursorSession(options) {
+    const response = await fetch(new URL("/agent.v1.AgentService/RunSSE", options.url ?? CURSOR_API_URL), {
+        method: "POST",
+        headers: buildCursorHeaders(options, "application/connect+proto", {
+            accept: "text/event-stream",
+            "connect-protocol-version": "1",
+        }),
+        body: toFetchBody(frameConnectMessage(toBinary(BidiRequestIdSchema, create(BidiRequestIdSchema, { requestId: options.requestId })))),
+    });
+    if (!response.ok || !response.body) {
+        const errorBody = await response.text().catch(() => "");
+        logPluginError("Cursor RunSSE request failed", {
+            requestId: options.requestId,
+            status: response.status,
+            responseBody: errorBody,
+        });
+        throw new Error(`RunSSE failed: ${response.status}${errorBody ? ` ${errorBody}` : ""}`);
+    }
+    const cbs = {
+        data: null,
+        close: null,
+    };
+    const abortController = new AbortController();
+    const reader = response.body.getReader();
+    let appendSeqno = 0;
+    let alive = true;
+    let closeCode = 0;
+    let writeChain = Promise.resolve();
+    const pendingChunks = [];
+    const finish = (code) => {
+        if (!alive)
+            return;
+        alive = false;
+        closeCode = code;
+        cbs.close?.(code);
+    };
+    const append = async (data) => {
+        const requestBody = encodeBidiAppendRequest(Buffer.from(data).toString("hex"), options.requestId, appendSeqno++);
+        const appendResponse = await fetch(new URL("/aiserver.v1.BidiService/BidiAppend", options.url ?? CURSOR_API_URL), {
+            method: "POST",
+            headers: buildCursorHeaders(options, "application/proto"),
+            body: toFetchBody(requestBody),
+            signal: abortController.signal,
+        });
+        if (!appendResponse.ok) {
+            const errorBody = await appendResponse.text().catch(() => "");
+            logPluginError("Cursor BidiAppend request failed", {
+                requestId: options.requestId,
+                appendSeqno: appendSeqno - 1,
+                status: appendResponse.status,
+                responseBody: errorBody,
+            });
+            throw new Error(`BidiAppend failed: ${appendResponse.status}${errorBody ? ` ${errorBody}` : ""}`);
+        }
+        await appendResponse.arrayBuffer().catch(() => undefined);
+    };
+    (async () => {
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    finish(0);
+                    break;
+                }
+                if (value && value.length > 0) {
+                    const chunk = Buffer.from(value);
+                    if (cbs.data) {
+                        cbs.data(chunk);
+                    }
+                    else {
+                        pendingChunks.push(chunk);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            logPluginWarn("Cursor stream reader closed with error", {
+                requestId: options.requestId,
+                ...errorDetails(error),
+            });
+            finish(alive ? 1 : closeCode);
+        }
+    })();
+    return {
+        get alive() {
+            return alive;
+        },
+        write(data) {
+            if (!alive)
+                return;
+            writeChain = writeChain
+                .then(() => append(data))
+                .catch((error) => {
+                logPluginError("Cursor stream append failed", {
+                    requestId: options.requestId,
+                    ...errorDetails(error),
+                });
+                try {
+                    abortController.abort();
+                }
+                catch { }
+                try {
+                    reader.cancel();
+                }
+                catch { }
+                finish(1);
+            });
+        },
+        end() {
+            try {
+                abortController.abort();
+            }
+            catch { }
+            try {
+                reader.cancel();
+            }
+            catch { }
+            finish(0);
+        },
+        onData(cb) {
+            cbs.data = cb;
+            while (pendingChunks.length > 0) {
+                cb(pendingChunks.shift());
+            }
+        },
+        onClose(cb) {
+            if (!alive) {
+                queueMicrotask(() => cb(closeCode));
+            }
+            else {
+                cbs.close = cb;
+            }
+        },
+    };
+}

package/dist/cursor/config.d.ts

@@ -0,0 +1,4 @@
+export declare const CURSOR_API_URL: string;
+export declare const CURSOR_CLIENT_VERSION = "cli-2026.01.09-231024f";
+export declare const CURSOR_CONNECT_PROTOCOL_VERSION = "1";
+export declare const CONNECT_END_STREAM_FLAG = 2;

package/dist/cursor/config.js

@@ -0,0 +1,4 @@
+export const CURSOR_API_URL = process.env.CURSOR_API_URL ?? "https://api2.cursor.sh";
+export const CURSOR_CLIENT_VERSION = "cli-2026.01.09-231024f";
+export const CURSOR_CONNECT_PROTOCOL_VERSION = "1";
+export const CONNECT_END_STREAM_FLAG = 0b00000010;

package/dist/cursor/connect-framing.d.ts

@@ -0,0 +1,10 @@
+/** Connect protocol frame: [1-byte flags][4-byte BE length][payload] */
+export declare function frameConnectMessage(data: Uint8Array, flags?: number): Buffer;
+export declare function decodeConnectUnaryBody(payload: Uint8Array): Uint8Array | null;
+export declare function encodeVarint(value: number): Uint8Array;
+export declare function encodeProtoField(tag: number, wireType: number, value: Uint8Array): Uint8Array;
+export declare function encodeProtoStringField(tag: number, value: string): Uint8Array;
+export declare function encodeProtoMessageField(tag: number, value: Uint8Array): Uint8Array;
+export declare function encodeProtoVarintField(tag: number, value: number): Uint8Array;
+export declare function concatBytes(parts: Uint8Array[]): Uint8Array;
+export declare function toFetchBody(data: Uint8Array): ArrayBuffer;

package/dist/cursor/connect-framing.js

@@ -0,0 +1,80 @@
+import { CONNECT_END_STREAM_FLAG } from "./config";
+/** Connect protocol frame: [1-byte flags][4-byte BE length][payload] */
+export function frameConnectMessage(data, flags = 0) {
+    const frame = Buffer.alloc(5 + data.length);
+    frame[0] = flags;
+    frame.writeUInt32BE(data.length, 1);
+    frame.set(data, 5);
+    return frame;
+}
+export function decodeConnectUnaryBody(payload) {
+    if (payload.length < 5)
+        return null;
+    let offset = 0;
+    while (offset + 5 <= payload.length) {
+        const flags = payload[offset];
+        const view = new DataView(payload.buffer, payload.byteOffset + offset, payload.byteLength - offset);
+        const messageLength = view.getUint32(1, false);
+        const frameEnd = offset + 5 + messageLength;
+        if (frameEnd > payload.length)
+            return null;
+        if ((flags & 0b0000_0001) !== 0)
+            return null;
+        if ((flags & CONNECT_END_STREAM_FLAG) === 0) {
+            return payload.subarray(offset + 5, frameEnd);
+        }
+        offset = frameEnd;
+    }
+    return null;
+}
+export function encodeVarint(value) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`Unsupported varint value: ${value}`);
+    }
+    const bytes = [];
+    let current = value;
+    while (current >= 0x80) {
+        bytes.push((current & 0x7f) | 0x80);
+        current = Math.floor(current / 128);
+    }
+    bytes.push(current);
+    return Uint8Array.from(bytes);
+}
+export function encodeProtoField(tag, wireType, value) {
+    const key = encodeVarint((tag << 3) | wireType);
+    const out = new Uint8Array(key.length + value.length);
+    out.set(key, 0);
+    out.set(value, key.length);
+    return out;
+}
+export function encodeProtoStringField(tag, value) {
+    const bytes = new TextEncoder().encode(value);
+    const len = encodeVarint(bytes.length);
+    const payload = new Uint8Array(len.length + bytes.length);
+    payload.set(len, 0);
+    payload.set(bytes, len.length);
+    return encodeProtoField(tag, 2, payload);
+}
+export function encodeProtoMessageField(tag, value) {
+    const len = encodeVarint(value.length);
+    const payload = new Uint8Array(len.length + value.length);
+    payload.set(len, 0);
+    payload.set(value, len.length);
+    return encodeProtoField(tag, 2, payload);
+}
+export function encodeProtoVarintField(tag, value) {
+    return encodeProtoField(tag, 0, encodeVarint(value));
+}
+export function concatBytes(parts) {
+    const total = parts.reduce((sum, part) => sum + part.length, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.length;
+    }
+    return out;
+}
+export function toFetchBody(data) {
+    return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+}

package/dist/cursor/headers.d.ts

@@ -0,0 +1,6 @@
+export interface CursorBaseRequestOptions {
+    accessToken: string;
+    url?: string;
+}
+export declare function buildCursorHeaders(options: CursorBaseRequestOptions, contentType: string, extra?: Record<string, string>): Headers;
+export declare function buildCursorHeaderValues(options: CursorBaseRequestOptions, contentType: string, extra?: Record<string, string>): Record<string, string>;

package/dist/cursor/headers.js

@@ -0,0 +1,16 @@
+import { CURSOR_CLIENT_VERSION } from "./config";
+export function buildCursorHeaders(options, contentType, extra = {}) {
+    const headers = new Headers(buildCursorHeaderValues(options, contentType, extra));
+    return headers;
+}
+export function buildCursorHeaderValues(options, contentType, extra = {}) {
+    return {
+        authorization: `Bearer ${options.accessToken}`,
+        "content-type": contentType,
+        "x-ghost-mode": "true",
+        "x-cursor-client-version": CURSOR_CLIENT_VERSION,
+        "x-cursor-client-type": "cli",
+        "x-request-id": crypto.randomUUID(),
+        ...extra,
+    };
+}

package/dist/cursor/index.d.ts

@@ -0,0 +1,5 @@
+export { CURSOR_API_URL, CURSOR_CLIENT_VERSION, CURSOR_CONNECT_PROTOCOL_VERSION, CONNECT_END_STREAM_FLAG, } from "./config";
+export { concatBytes, decodeConnectUnaryBody, encodeProtoMessageField, encodeProtoStringField, encodeProtoVarintField, encodeVarint, frameConnectMessage, toFetchBody, } from "./connect-framing";
+export { buildCursorHeaders, buildCursorHeaderValues, type CursorBaseRequestOptions, } from "./headers";
+export { createCursorSession, encodeBidiAppendRequest, type CreateCursorSessionOptions, type CursorSession, } from "./bidi-session";
+export { callCursorUnaryRpc, type CursorUnaryRpcOptions } from "./unary-rpc";

package/dist/cursor/index.js

@@ -0,0 +1,5 @@
+export { CURSOR_API_URL, CURSOR_CLIENT_VERSION, CURSOR_CONNECT_PROTOCOL_VERSION, CONNECT_END_STREAM_FLAG, } from "./config";
+export { concatBytes, decodeConnectUnaryBody, encodeProtoMessageField, encodeProtoStringField, encodeProtoVarintField, encodeVarint, frameConnectMessage, toFetchBody, } from "./connect-framing";
+export { buildCursorHeaders, buildCursorHeaderValues, } from "./headers";
+export { createCursorSession, encodeBidiAppendRequest, } from "./bidi-session";
+export { callCursorUnaryRpc } from "./unary-rpc";

package/dist/cursor/unary-rpc.d.ts

@@ -0,0 +1,13 @@
+export interface CursorUnaryRpcOptions {
+    accessToken: string;
+    rpcPath: string;
+    requestBody: Uint8Array;
+    url?: string;
+    timeoutMs?: number;
+    transport?: "auto" | "fetch" | "http2";
+}
+export declare function callCursorUnaryRpc(options: CursorUnaryRpcOptions): Promise<{
+    body: Uint8Array;
+    exitCode: number;
+    timedOut: boolean;
+}>;

package/dist/cursor/unary-rpc.js

@@ -0,0 +1,181 @@
+import { connect as connectHttp2, } from "node:http2";
+import { CURSOR_API_URL, CURSOR_CONNECT_PROTOCOL_VERSION } from "./config";
+import { toFetchBody } from "./connect-framing";
+import { buildCursorHeaders, buildCursorHeaderValues } from "./headers";
+import { errorDetails, logPluginError } from "../logger";
+export async function callCursorUnaryRpc(options) {
+    const target = new URL(options.rpcPath, options.url ?? CURSOR_API_URL);
+    const transport = options.transport ?? "auto";
+    if (transport === "http2" ||
+        (transport === "auto" && target.protocol === "https:")) {
+        const http2Result = await callCursorUnaryRpcOverHttp2(options, target);
+        if (transport === "http2" ||
+            http2Result.timedOut ||
+            http2Result.exitCode !== 1) {
+            return http2Result;
+        }
+    }
+    return callCursorUnaryRpcOverFetch(options, target);
+}
+async function callCursorUnaryRpcOverFetch(options, target) {
+    let timedOut = false;
+    const timeoutMs = options.timeoutMs ?? 5_000;
+    const controller = new AbortController();
+    const timeout = timeoutMs > 0
+        ? setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+        }, timeoutMs)
+        : undefined;
+    try {
+        const response = await fetch(target, {
+            method: "POST",
+            headers: buildCursorHeaders(options, "application/proto", {
+                accept: "application/proto, application/json",
+                "connect-protocol-version": CURSOR_CONNECT_PROTOCOL_VERSION,
+                "connect-timeout-ms": String(timeoutMs),
+            }),
+            body: toFetchBody(options.requestBody),
+            signal: controller.signal,
+        });
+        const body = new Uint8Array(await response.arrayBuffer());
+        return {
+            body,
+            exitCode: response.ok ? 0 : response.status,
+            timedOut,
+        };
+    }
+    catch {
+        logPluginError("Cursor unary fetch transport failed", {
+            rpcPath: options.rpcPath,
+            url: target.toString(),
+            timeoutMs,
+            timedOut,
+        });
+        return {
+            body: new Uint8Array(),
+            exitCode: timedOut ? 124 : 1,
+            timedOut,
+        };
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
+}
+async function callCursorUnaryRpcOverHttp2(options, target) {
+    const timeoutMs = options.timeoutMs ?? 5_000;
+    const authority = `${target.protocol}//${target.host}`;
+    return new Promise((resolve) => {
+        let settled = false;
+        let timedOut = false;
+        let session;
+        let stream;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeout)
+                clearTimeout(timeout);
+            try {
+                stream?.close();
+            }
+            catch { }
+            try {
+                session?.close();
+            }
+            catch { }
+            resolve(result);
+        };
+        const timeout = timeoutMs > 0
+            ? setTimeout(() => {
+                timedOut = true;
+                finish({
+                    body: new Uint8Array(),
+                    exitCode: 124,
+                    timedOut: true,
+                });
+            }, timeoutMs)
+            : undefined;
+        try {
+            session = connectHttp2(authority);
+            session.once("error", (error) => {
+                logPluginError("Cursor unary HTTP/2 session failed", {
+                    rpcPath: options.rpcPath,
+                    url: target.toString(),
+                    timedOut,
+                    ...errorDetails(error),
+                });
+                finish({
+                    body: new Uint8Array(),
+                    exitCode: timedOut ? 124 : 1,
+                    timedOut,
+                });
+            });
+            const headers = {
+                ":method": "POST",
+                ":path": `${target.pathname}${target.search}`,
+                ...buildCursorHeaderValues(options, "application/proto", {
+                    accept: "application/proto, application/json",
+                    "connect-protocol-version": CURSOR_CONNECT_PROTOCOL_VERSION,
+                    "connect-timeout-ms": String(timeoutMs),
+                }),
+            };
+            stream = session.request(headers);
+            let statusCode = 0;
+            const chunks = [];
+            stream.once("response", (responseHeaders) => {
+                const statusHeader = responseHeaders[":status"];
+                statusCode =
+                    typeof statusHeader === "number"
+                        ? statusHeader
+                        : Number(statusHeader ?? 0);
+            });
+            stream.on("data", (chunk) => {
+                chunks.push(Buffer.from(chunk));
+            });
+            stream.once("end", () => {
+                const body = new Uint8Array(Buffer.concat(chunks));
+                finish({
+                    body,
+                    exitCode: statusCode >= 200 && statusCode < 300 ? 0 : statusCode || 1,
+                    timedOut,
+                });
+            });
+            stream.once("error", (error) => {
+                logPluginError("Cursor unary HTTP/2 stream failed", {
+                    rpcPath: options.rpcPath,
+                    url: target.toString(),
+                    timedOut,
+                    ...errorDetails(error),
+                });
+                finish({
+                    body: new Uint8Array(),
+                    exitCode: timedOut ? 124 : 1,
+                    timedOut,
+                });
+            });
+            // Bun's node:http2 client currently breaks on end(Buffer.alloc(0)) against
+            // Cursor's HTTPS endpoint, but a header-only end() succeeds for empty unary bodies.
+            if (options.requestBody.length > 0) {
+                stream.end(Buffer.from(options.requestBody));
+            }
+            else {
+                stream.end();
+            }
+        }
+        catch (error) {
+            logPluginError("Cursor unary HTTP/2 setup failed", {
+                rpcPath: options.rpcPath,
+                url: target.toString(),
+                timedOut,
+                ...errorDetails(error),
+            });
+            finish({
+                body: new Uint8Array(),
+                exitCode: timedOut ? 124 : 1,
+                timedOut,
+            });
+        }
+    });
+}

package/dist/index.d.ts

@@ -1,14 +1,2 @@
-/**
- * OpenCode Cursor Auth Plugin
- *
- * Enables using Cursor models (Claude, GPT, etc.) inside OpenCode via:
- * 1. Browser-based OAuth login to Cursor
- * 2. Local proxy translating OpenAI format → Cursor gRPC protocol
- */
-import type { Plugin } from "@opencode-ai/plugin";
-/**
- * OpenCode plugin that provides Cursor authentication and model access.
- * Register in opencode.json: { "plugin": ["opencode-cursor-oauth"] }
- */
-export declare const CursorAuthPlugin: Plugin;
-export default CursorAuthPlugin;
+export { CursorAuthPlugin } from "./plugin/cursor-auth-plugin";
+export { CursorAuthPlugin as default } from "./plugin/cursor-auth-plugin";