@ai-ide-bridge/cursor 1.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @ai-ide-bridge/cursor@1.0.1 build /home/runner/work/llm-bridge/llm-bridge/packages/cursor
+> tsc
+

package/README.md

@@ -0,0 +1,54 @@
+# @ai-ide-bridge/cursor
+
+The Cursor API plugin for **AI IDE Bridge**.
+
+AI IDE Bridge is a local HTTP server that translates OpenAI-compatible API requests into provider-specific calls, enabling any OpenAI-format client to use any AI IDE's model catalog.
+
+## Overview
+
+`@ai-ide-bridge/cursor` provides seamless integration with Cursor's cloud AI agents. It acts as a plugin for `@ai-ide-bridge/core` and uses the `@cursor/sdk` to authenticate, list models, and stream chat completions.
+
+## Installation
+
+```bash
+npm install @ai-ide-bridge/cursor
+```
+
+## Configuration
+
+The plugin requires a valid `CURSOR_API_KEY`, which can be obtained from the [Cursor Dashboard](https://cursor.com/dashboard/cloud-agents).
+
+Set the credential via environment variable:
+
+```bash
+export CURSOR_API_KEY="cursor_your_api_key"
+```
+
+Or configure it in `~/.config/llm-bridge/config.json`:
+
+```json
+{
+  "plugins": {
+    "cursor": {
+      "CURSOR_API_KEY": "cursor_your_api_key"
+    }
+  }
+}
+```
+
+## Supported Models
+
+Models are accessible via the `cursor/` prefix:
+
+- `cursor/composer-2` — Cursor Composer 2
+- `cursor/composer-fast` — Cursor Composer Fast
+- `cursor/claude-3.5-sonnet` — Claude 3.5 Sonnet (Cursor)
+- `cursor/gpt-4o` — GPT-4o (Cursor)
+
+## Documentation
+
+For full documentation and setup instructions, please visit the main repository: [https://github.com/aeswibon/llm-bridge](https://github.com/aeswibon/llm-bridge).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { CursorBridgePlugin } from './plugin.js';
+export { CursorBridgeSession } from './session.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { CursorBridgePlugin } from './plugin.js';
+export { CursorBridgeSession } from './session.js';

package/dist/plugin.d.ts

@@ -0,0 +1,8 @@
+import type { BridgePlugin, BridgeSession, ModelInfo } from '@ai-ide-bridge/core';
+export declare class CursorBridgePlugin implements BridgePlugin {
+    name: string;
+    version: string;
+    authenticate(config: Record<string, string>): Promise<boolean>;
+    listModels(config: Record<string, string>): Promise<ModelInfo[]>;
+    createSession(config: Record<string, string>, model: string): Promise<BridgeSession>;
+}

package/dist/plugin.js

@@ -0,0 +1,36 @@
+import { Cursor } from '@cursor/sdk';
+import { CursorBridgeSession } from './session.js';
+export class CursorBridgePlugin {
+    name = 'cursor';
+    version = '2.0.0';
+    async authenticate(config) {
+        const apiKey = config.CURSOR_API_KEY;
+        if (!apiKey)
+            return false;
+        try {
+            await Cursor.me({ apiKey });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async listModels(config) {
+        const apiKey = config.CURSOR_API_KEY;
+        if (!apiKey)
+            throw new Error('Missing CURSOR_API_KEY');
+        const models = await Cursor.models.list({ apiKey });
+        return models.map((m) => ({
+            id: m.id,
+            name: m.id,
+            capabilities: { streaming: true, tools: true },
+        }));
+    }
+    async createSession(config, model) {
+        const apiKey = config.CURSOR_API_KEY;
+        if (!apiKey)
+            throw new Error('Missing CURSOR_API_KEY');
+        const cwd = config.CURSOR_OPENCODE_BRIDGE_CWD ?? process.cwd();
+        return new CursorBridgeSession(apiKey, model, cwd);
+    }
+}

package/dist/session.d.ts

@@ -0,0 +1,11 @@
+import type { BridgeSession, Message, ToolDefinition, StreamChunk } from '@ai-ide-bridge/core';
+export declare class CursorBridgeSession implements BridgeSession {
+    private agent;
+    private apiKey;
+    private modelId;
+    private cwd;
+    constructor(apiKey: string, modelId: string, cwd?: string);
+    send(messages: Message[], tools?: ToolDefinition[]): AsyncIterable<StreamChunk>;
+    dispose(): Promise<void>;
+    private buildPrompt;
+}

package/dist/session.js

@@ -0,0 +1,69 @@
+import { Agent } from '@cursor/sdk';
+import { translateTools } from './tools.js';
+export class CursorBridgeSession {
+    agent = null;
+    apiKey;
+    modelId;
+    cwd;
+    constructor(apiKey, modelId, cwd = process.cwd()) {
+        this.apiKey = apiKey;
+        this.modelId = modelId;
+        this.cwd = cwd;
+    }
+    async *send(messages, tools) {
+        const prompt = this.buildPrompt(messages);
+        const cursorTools = tools ? translateTools(tools) : undefined;
+        try {
+            this.agent = await Agent.create({
+                apiKey: this.apiKey,
+                model: { id: this.modelId },
+                local: { cwd: this.cwd, settingSources: [] },
+            });
+            const sendOptions = {
+                model: { id: this.modelId },
+                onDelta: ({ update }) => {
+                    if (update.type === 'text-delta' && 'text' in update && update.text) {
+                        // onDelta is synchronous callback, we buffer and yield in the loop
+                    }
+                },
+            };
+            const run = await this.agent.send(prompt, sendOptions);
+            const result = await run.wait();
+            if (result.status === 'error' || result.status === 'cancelled') {
+                yield {
+                    type: 'error',
+                    content: `Agent run ${result.status}: ${result.result ?? 'no details'}`,
+                    finishReason: 'error',
+                };
+                return;
+            }
+            yield { type: 'text', content: result.result ?? '', finishReason: 'stop' };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            yield { type: 'error', content: msg, finishReason: 'error' };
+        }
+    }
+    async dispose() {
+        if (this.agent) {
+            try {
+                await this.agent[Symbol.asyncDispose]();
+            }
+            catch {
+                // Ignore dispose errors
+            }
+            this.agent = null;
+        }
+    }
+    buildPrompt(messages) {
+        const blocks = [];
+        for (const m of messages) {
+            const text = typeof m.content === 'string' ? m.content : '';
+            if (!text)
+                continue;
+            const label = m.role === 'tool' ? `tool (${m.tool_call_id ?? m.name ?? 'result'})` : m.role;
+            blocks.push(`[${label}]\n${text}`);
+        }
+        return `\nFollow this conversation transcript and reply as the assistant.\n\n${blocks.join('\n\n---\n\n')}\n`;
+    }
+}

package/dist/tools.d.ts

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from '@ai-ide-bridge/core';
+export interface CursorTool {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export declare function translateTools(tools: ToolDefinition[]): CursorTool[];
+export declare function translateToolResult(toolCallId: string, result: string): string;

package/dist/tools.js

@@ -0,0 +1,13 @@
+export function translateTools(tools) {
+    return tools.map((tool) => ({
+        type: 'function',
+        function: {
+            name: tool.function.name,
+            description: tool.function.description,
+            parameters: tool.function.parameters,
+        },
+    }));
+}
+export function translateToolResult(toolCallId, result) {
+    return `[tool result for ${toolCallId}]\n${result}`;
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@ai-ide-bridge/cursor",
+  "version": "1.0.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@cursor/sdk": "^1.0.13",
+    "@ai-ide-bridge/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "vitest": "^2.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { CursorBridgePlugin } from './plugin.js';
+export { CursorBridgeSession } from './session.js';

package/src/plugin.ts

@@ -0,0 +1,37 @@
+import { Cursor } from '@cursor/sdk';
+import type { BridgePlugin, BridgeSession, ModelInfo } from '@ai-ide-bridge/core';
+import { CursorBridgeSession } from './session.js';
+
+export class CursorBridgePlugin implements BridgePlugin {
+  name = 'cursor';
+  version = '2.0.0';
+
+  async authenticate(config: Record<string, string>): Promise<boolean> {
+    const apiKey = config.CURSOR_API_KEY;
+    if (!apiKey) return false;
+    try {
+      await Cursor.me({ apiKey });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  async listModels(config: Record<string, string>): Promise<ModelInfo[]> {
+    const apiKey = config.CURSOR_API_KEY;
+    if (!apiKey) throw new Error('Missing CURSOR_API_KEY');
+    const models = await Cursor.models.list({ apiKey });
+    return models.map((m) => ({
+      id: m.id,
+      name: m.id,
+      capabilities: { streaming: true, tools: true },
+    }));
+  }
+
+  async createSession(config: Record<string, string>, model: string): Promise<BridgeSession> {
+    const apiKey = config.CURSOR_API_KEY;
+    if (!apiKey) throw new Error('Missing CURSOR_API_KEY');
+    const cwd = config.CURSOR_OPENCODE_BRIDGE_CWD ?? process.cwd();
+    return new CursorBridgeSession(apiKey, model, cwd);
+  }
+}

package/src/session.ts

@@ -0,0 +1,78 @@
+import { Agent } from '@cursor/sdk';
+import type { SDKAgent, SendOptions } from '@cursor/sdk';
+import type { BridgeSession, Message, ToolDefinition, StreamChunk } from '@ai-ide-bridge/core';
+import { translateTools } from './tools.js';
+
+export class CursorBridgeSession implements BridgeSession {
+  private agent: SDKAgent | null = null;
+  private apiKey: string;
+  private modelId: string;
+  private cwd: string;
+
+  constructor(apiKey: string, modelId: string, cwd: string = process.cwd()) {
+    this.apiKey = apiKey;
+    this.modelId = modelId;
+    this.cwd = cwd;
+  }
+
+  async *send(messages: Message[], tools?: ToolDefinition[]): AsyncIterable<StreamChunk> {
+    const prompt = this.buildPrompt(messages);
+    const cursorTools = tools ? translateTools(tools) : undefined;
+
+    try {
+      this.agent = await Agent.create({
+        apiKey: this.apiKey,
+        model: { id: this.modelId },
+        local: { cwd: this.cwd, settingSources: [] },
+      });
+
+      const sendOptions: SendOptions = {
+        model: { id: this.modelId },
+        onDelta: ({ update }) => {
+          if (update.type === 'text-delta' && 'text' in update && update.text) {
+            // onDelta is synchronous callback, we buffer and yield in the loop
+          }
+        },
+      };
+
+      const run = await this.agent.send(prompt, sendOptions);
+
+      const result = await run.wait();
+      if (result.status === 'error' || result.status === 'cancelled') {
+        yield {
+          type: 'error',
+          content: `Agent run ${result.status}: ${result.result ?? 'no details'}`,
+          finishReason: 'error',
+        };
+        return;
+      }
+
+      yield { type: 'text', content: result.result ?? '', finishReason: 'stop' };
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      yield { type: 'error', content: msg, finishReason: 'error' };
+    }
+  }
+
+  async dispose(): Promise<void> {
+    if (this.agent) {
+      try {
+        await this.agent[Symbol.asyncDispose]();
+      } catch {
+        // Ignore dispose errors
+      }
+      this.agent = null;
+    }
+  }
+
+  private buildPrompt(messages: Message[]): string {
+    const blocks: string[] = [];
+    for (const m of messages) {
+      const text = typeof m.content === 'string' ? m.content : '';
+      if (!text) continue;
+      const label = m.role === 'tool' ? `tool (${m.tool_call_id ?? m.name ?? 'result'})` : m.role;
+      blocks.push(`[${label}]\n${text}`);
+    }
+    return `\nFollow this conversation transcript and reply as the assistant.\n\n${blocks.join('\n\n---\n\n')}\n`;
+  }
+}

package/src/tools.ts

@@ -0,0 +1,25 @@
+import type { ToolDefinition } from '@ai-ide-bridge/core';
+
+export interface CursorTool {
+  type: 'function';
+  function: {
+    name: string;
+    description?: string;
+    parameters: Record<string, unknown>;
+  };
+}
+
+export function translateTools(tools: ToolDefinition[]): CursorTool[] {
+  return tools.map((tool) => ({
+    type: 'function' as const,
+    function: {
+      name: tool.function.name,
+      description: tool.function.description,
+      parameters: tool.function.parameters as Record<string, unknown>,
+    },
+  }));
+}
+
+export function translateToolResult(toolCallId: string, result: string): string {
+  return `[tool result for ${toolCallId}]\n${result}`;
+}

package/test/plugin.test.ts

@@ -0,0 +1,42 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { CursorBridgePlugin } from '../src/plugin.js';
+import { Cursor } from '@cursor/sdk';
+
+vi.mock('@cursor/sdk', () => ({
+  Cursor: {
+    me: vi.fn(),
+    models: { list: vi.fn() },
+  },
+  Agent: { create: vi.fn(), prompt: vi.fn() },
+}));
+
+describe('CursorBridgePlugin', () => {
+  let plugin: CursorBridgePlugin;
+
+  beforeEach(() => {
+    plugin = new CursorBridgePlugin();
+    vi.clearAllMocks();
+  });
+
+  it('authenticates with valid key', async () => {
+    (Cursor.me as any).mockResolvedValue({ id: 'user-123' });
+    const result = await plugin.authenticate({ CURSOR_API_KEY: 'cursor_test_key' });
+    expect(result).toBe(true);
+  });
+
+  it('fails authentication with missing key', async () => {
+    const result = await plugin.authenticate({});
+    expect(result).toBe(false);
+  });
+
+  it('lists models', async () => {
+    (Cursor.models.list as any).mockResolvedValue([{ id: 'composer-2' }, { id: 'sonnet' }]);
+    const models = await plugin.listModels({ CURSOR_API_KEY: 'cursor_test_key' });
+    expect(models).toHaveLength(2);
+    expect(models[0].id).toBe('composer-2');
+  });
+
+  it('throws on listModels without key', async () => {
+    await expect(plugin.listModels({})).rejects.toThrow('Missing CURSOR_API_KEY');
+  });
+});

package/test/tools.test.ts

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import { translateTools, translateToolResult } from '../src/tools.js';
+import type { ToolDefinition } from '@ai-ide-bridge/core';
+
+describe('translateTools', () => {
+  it('translates OpenAI tool definitions to Cursor format', () => {
+    const tools: ToolDefinition[] = [
+      {
+        type: 'function',
+        function: {
+          name: 'search',
+          description: 'Search the web',
+          parameters: { type: 'object', properties: { q: { type: 'string' } } },
+        },
+      },
+    ];
+    const result = translateTools(tools);
+    expect(result).toHaveLength(1);
+    expect(result[0].type).toBe('function');
+    expect(result[0].function.name).toBe('search');
+    expect(result[0].function.description).toBe('Search the web');
+  });
+
+  it('handles multiple tools', () => {
+    const tools: ToolDefinition[] = [
+      { type: 'function', function: { name: 'a', description: 'A', parameters: {} } },
+      { type: 'function', function: { name: 'b', description: 'B', parameters: {} } },
+    ];
+    const result = translateTools(tools);
+    expect(result).toHaveLength(2);
+    expect(result[0].function.name).toBe('a');
+    expect(result[1].function.name).toBe('b');
+  });
+});
+
+describe('translateToolResult', () => {
+  it('formats tool result with ID', () => {
+    const result = translateToolResult('tc-1', 'search results');
+    expect(result).toContain('tc-1');
+    expect(result).toContain('search results');
+  });
+});

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*.ts"]
+}