@bifrost-ai/engine-cursor 0.1.1-build.1783540132209

package/dist/index.d.mts

@@ -0,0 +1,27 @@
+import { McpServerConfig, SettingSource } from "@cursor/sdk";
+import { Engine, EngineContext, EngineResult } from "@bifrost-ai/engine";
+
+//#region src/cursor-engine.d.ts
+type CursorEngineConfig = {
+  apiKey?: string;
+  model?: string;
+  settingSources?: SettingSource[];
+  mode?: "agent" | "plan";
+  executionTimeoutMs?: number;
+};
+type McpToolkitConstructor = (context: EngineContext) => McpServerConfig;
+declare class CursorEngine implements Engine {
+  private readonly config;
+  private toolkits;
+  constructor(config?: CursorEngineConfig);
+  registerToolkit(name: string, toolkit: McpServerConfig | McpToolkitConstructor): void;
+  private resolveApiKey;
+  private resolveModel;
+  private resolveMcpServers;
+  private streamRun;
+  private withExecutionTimeout;
+  private mapFinishedResult;
+  execute(context: EngineContext, sessionId?: string): Promise<EngineResult>;
+}
+//#endregion
+export { CursorEngine, type CursorEngineConfig, type McpToolkitConstructor };

package/dist/index.mjs

@@ -0,0 +1,619 @@
+import { Agent, CursorAgentError } from "@cursor/sdk";
+import createDebug from "debug";
+//#region src/prompt.ts
+const promptSection = (name, body) => `<${name}>${body}</${name}>`;
+const buildPrompt = (options) => {
+	const { agent, instructions } = options;
+	return [promptSection("AgentDefinition", agent.promptBody), promptSection("FeatureDefinition", instructions)].join("\n");
+};
+//#endregion
+//#region src/pricing.ts
+const catalog = {
+	source: "https://cursor.com/docs/models-and-pricing",
+	unit: "usd_per_million_tokens",
+	auto: {
+		"inputAndCacheWrite": 1.25,
+		"output": 6,
+		"cacheRead": .25
+	},
+	models: [
+		{
+			"name": "Claude 4 Sonnet",
+			"ids": ["claude-4-sonnet", "claude-4-sonnet-thinking"],
+			"provider": "Anthropic",
+			"input": 3,
+			"cacheWrite": 3.75,
+			"cacheRead": .3,
+			"output": 15
+		},
+		{
+			"name": "Claude 4 Sonnet 1M",
+			"ids": ["claude-4-sonnet-1m"],
+			"provider": "Anthropic",
+			"input": 6,
+			"cacheWrite": 7.5,
+			"cacheRead": .6,
+			"output": 22.5
+		},
+		{
+			"name": "Claude 4.5 Haiku",
+			"ids": ["claude-4-5-haiku", "claude-4.5-haiku"],
+			"provider": "Anthropic",
+			"input": 1,
+			"cacheWrite": 1.25,
+			"cacheRead": .1,
+			"output": 5
+		},
+		{
+			"name": "Claude 4.5 Opus",
+			"ids": ["claude-4-5-opus", "claude-4.5-opus"],
+			"provider": "Anthropic",
+			"input": 5,
+			"cacheWrite": 6.25,
+			"cacheRead": .5,
+			"output": 25
+		},
+		{
+			"name": "Claude 4.5 Sonnet",
+			"ids": ["claude-4-5-sonnet", "claude-4.5-sonnet"],
+			"provider": "Anthropic",
+			"input": 3,
+			"cacheWrite": 3.75,
+			"cacheRead": .3,
+			"output": 15
+		},
+		{
+			"name": "Claude 4.6 Opus",
+			"ids": ["claude-4-6-opus", "claude-4.6-opus"],
+			"provider": "Anthropic",
+			"input": 5,
+			"cacheWrite": 6.25,
+			"cacheRead": .5,
+			"output": 25
+		},
+		{
+			"name": "Claude 4.6 Sonnet",
+			"ids": ["claude-4-6-sonnet", "claude-4.6-sonnet"],
+			"provider": "Anthropic",
+			"input": 3,
+			"cacheWrite": 3.75,
+			"cacheRead": .3,
+			"output": 15
+		},
+		{
+			"name": "Claude 4.7 Opus",
+			"ids": ["claude-4-7-opus", "claude-4.7-opus"],
+			"provider": "Anthropic",
+			"input": 5,
+			"cacheWrite": 6.25,
+			"cacheRead": .5,
+			"output": 25
+		},
+		{
+			"name": "Claude Fable 5",
+			"ids": ["claude-fable-5"],
+			"provider": "Anthropic",
+			"input": 10,
+			"cacheWrite": 12.5,
+			"cacheRead": 1,
+			"output": 50
+		},
+		{
+			"name": "Claude Opus 4.7 (fast mode)",
+			"ids": ["claude-opus-4-7-fast", "claude-opus-4.7-fast"],
+			"provider": "Anthropic",
+			"input": 30,
+			"cacheWrite": 37.5,
+			"cacheRead": 3,
+			"output": 150
+		},
+		{
+			"name": "Claude Opus 4.8",
+			"ids": [
+				"claude-opus-4-8",
+				"claude-opus-4.8",
+				"claude-opus-4-8-fast"
+			],
+			"provider": "Anthropic",
+			"input": 5,
+			"cacheWrite": 6.25,
+			"cacheRead": .5,
+			"output": 25
+		},
+		{
+			"name": "Claude Sonnet 5",
+			"ids": ["claude-sonnet-5"],
+			"provider": "Anthropic",
+			"input": 3,
+			"cacheWrite": 3.75,
+			"cacheRead": .3,
+			"output": 15
+		},
+		{
+			"name": "Composer 1",
+			"ids": ["composer-1"],
+			"provider": "Cursor",
+			"input": 1.25,
+			"cacheRead": .125,
+			"output": 10
+		},
+		{
+			"name": "Composer 1.5",
+			"ids": ["composer-1.5"],
+			"provider": "Cursor",
+			"input": 3.5,
+			"cacheRead": .35,
+			"output": 17.5
+		},
+		{
+			"name": "Composer 2",
+			"ids": ["composer-2", "composer-2-fast"],
+			"provider": "Cursor",
+			"input": .5,
+			"cacheRead": .2,
+			"output": 2.5
+		},
+		{
+			"name": "Composer 2.5",
+			"ids": ["composer-2.5"],
+			"provider": "Cursor",
+			"input": .5,
+			"cacheRead": .2,
+			"output": 2.5
+		},
+		{
+			"name": "Composer 2.5 (Fast)",
+			"ids": ["composer-2.5-fast"],
+			"provider": "Cursor",
+			"input": 3,
+			"cacheRead": .5,
+			"output": 15
+		},
+		{
+			"name": "Gemini 2.5 Flash",
+			"ids": ["gemini-2.5-flash"],
+			"provider": "Google",
+			"input": .3,
+			"cacheRead": .03,
+			"output": 2.5
+		},
+		{
+			"name": "Gemini 3 Flash",
+			"ids": ["gemini-3-flash"],
+			"provider": "Google",
+			"input": .5,
+			"cacheRead": .05,
+			"output": 3
+		},
+		{
+			"name": "Gemini 3 Pro",
+			"ids": ["gemini-3-pro", "gemini-3-pro-image-preview"],
+			"provider": "Google",
+			"input": 2,
+			"cacheRead": .2,
+			"output": 12
+		},
+		{
+			"name": "Gemini 3.1 Pro",
+			"ids": ["gemini-3.1-pro"],
+			"provider": "Google",
+			"input": 2,
+			"cacheRead": .2,
+			"output": 12
+		},
+		{
+			"name": "Gemini 3.5 Flash",
+			"ids": ["gemini-3.5-flash"],
+			"provider": "Google",
+			"input": 1.5,
+			"cacheRead": .15,
+			"output": 9
+		},
+		{
+			"name": "GLM 5.2",
+			"ids": ["glm-5.2"],
+			"provider": "Z.ai",
+			"input": 1.4,
+			"cacheRead": .26,
+			"output": 4.4
+		},
+		{
+			"name": "GPT-5",
+			"ids": ["gpt-5", "gpt-5-high"],
+			"provider": "OpenAI",
+			"input": 1.25,
+			"cacheRead": .125,
+			"output": 10
+		},
+		{
+			"name": "GPT-5 Fast",
+			"ids": [
+				"gpt-5-fast",
+				"gpt-5-high-fast",
+				"gpt-5-low-fast"
+			],
+			"provider": "OpenAI",
+			"input": 2.5,
+			"cacheRead": .25,
+			"output": 20
+		},
+		{
+			"name": "GPT-5 Mini",
+			"ids": ["gpt-5-mini"],
+			"provider": "OpenAI",
+			"input": .25,
+			"cacheRead": .025,
+			"output": 2
+		},
+		{
+			"name": "GPT-5-Codex",
+			"ids": ["gpt-5-codex"],
+			"provider": "OpenAI",
+			"input": 1.25,
+			"cacheRead": .125,
+			"output": 10
+		},
+		{
+			"name": "GPT-5.1 Codex",
+			"ids": ["gpt-5.1-codex"],
+			"provider": "OpenAI",
+			"input": 1.25,
+			"cacheRead": .125,
+			"output": 10
+		},
+		{
+			"name": "GPT-5.1 Codex Max",
+			"ids": ["gpt-5.1-codex-max"],
+			"provider": "OpenAI",
+			"input": 1.25,
+			"cacheRead": .125,
+			"output": 10
+		},
+		{
+			"name": "GPT-5.1 Codex Mini",
+			"ids": ["gpt-5.1-codex-mini"],
+			"provider": "OpenAI",
+			"input": .25,
+			"cacheRead": .025,
+			"output": 2
+		},
+		{
+			"name": "GPT-5.2",
+			"ids": ["gpt-5.2", "gpt-5.2-high"],
+			"provider": "OpenAI",
+			"input": 1.75,
+			"cacheRead": .175,
+			"output": 14
+		},
+		{
+			"name": "GPT-5.2 Codex",
+			"ids": ["gpt-5.2-codex"],
+			"provider": "OpenAI",
+			"input": 1.75,
+			"cacheRead": .175,
+			"output": 14
+		},
+		{
+			"name": "GPT-5.3 Codex",
+			"ids": ["gpt-5.3-codex", "gpt-5.3-codex-high"],
+			"provider": "OpenAI",
+			"input": 1.75,
+			"cacheRead": .175,
+			"output": 14
+		},
+		{
+			"name": "GPT-5.4",
+			"ids": ["gpt-5.4", "gpt-5.4-fast"],
+			"provider": "OpenAI",
+			"input": 2.5,
+			"cacheRead": .25,
+			"output": 15
+		},
+		{
+			"name": "GPT-5.4 Mini",
+			"ids": ["gpt-5.4-mini"],
+			"provider": "OpenAI",
+			"input": .75,
+			"cacheRead": .075,
+			"output": 4.5
+		},
+		{
+			"name": "GPT-5.4 Nano",
+			"ids": ["gpt-5.4-nano"],
+			"provider": "OpenAI",
+			"input": .2,
+			"cacheRead": .02,
+			"output": 1.25
+		},
+		{
+			"name": "GPT-5.5",
+			"ids": ["gpt-5.5", "gpt-5.5-fast"],
+			"provider": "OpenAI",
+			"input": 5,
+			"cacheRead": .5,
+			"output": 30
+		},
+		{
+			"name": "Grok 4.20",
+			"ids": ["grok-4.20"],
+			"provider": "xAI",
+			"input": 2,
+			"cacheRead": .2,
+			"output": 6
+		},
+		{
+			"name": "Grok 4.3",
+			"ids": ["grok-4.3"],
+			"provider": "xAI",
+			"input": 1.25,
+			"cacheRead": .2,
+			"output": 2.5
+		},
+		{
+			"name": "Grok Build 0.1",
+			"ids": ["grok-build-0.1"],
+			"provider": "xAI",
+			"input": 1,
+			"cacheRead": .2,
+			"output": 2
+		},
+		{
+			"name": "Kimi K2.7 Code",
+			"ids": ["kimi-k2.7-code", "kimi-k2-7-code"],
+			"provider": "Moonshot",
+			"input": .95,
+			"cacheRead": .19,
+			"output": 4
+		}
+	]
+};
+const TOKENS_PER_MILLION = 1e6;
+const normalizeModelId = (modelId) => modelId.trim().toLowerCase().replaceAll("_", "-");
+const ratesById = new Map(catalog.models.flatMap((model) => model.ids.map((id) => [normalizeModelId(id), {
+	input: model.input,
+	cacheWrite: model.cacheWrite,
+	cacheRead: model.cacheRead,
+	output: model.output
+}])));
+const resolveModelRates = (modelId) => {
+	if (!modelId) return;
+	const normalized = normalizeModelId(modelId);
+	if (normalized === "auto") return {
+		input: catalog.auto.inputAndCacheWrite,
+		cacheWrite: catalog.auto.inputAndCacheWrite,
+		cacheRead: catalog.auto.cacheRead,
+		output: catalog.auto.output
+	};
+	const exact = ratesById.get(normalized);
+	if (exact) return exact;
+	let bestMatchId;
+	let bestRates;
+	for (const [id, rates] of ratesById) if (normalized.startsWith(id)) {
+		if (!bestMatchId || id.length > bestMatchId.length) {
+			bestMatchId = id;
+			bestRates = rates;
+		}
+	}
+	return bestRates;
+};
+const calculateUsageCostUsd = (modelId, usage) => {
+	const rates = resolveModelRates(modelId);
+	if (!rates) return 0;
+	const cacheWriteRate = rates.cacheWrite ?? rates.input;
+	const cacheReadRate = rates.cacheRead ?? 0;
+	return (usage.inputTokens * rates.input + usage.cacheWriteTokens * cacheWriteRate + usage.cacheReadTokens * cacheReadRate + usage.outputTokens * rates.output) / TOKENS_PER_MILLION;
+};
+//#endregion
+//#region src/stats.ts
+const mapRunResultToStats = (result, numTurns) => {
+	const usage = result.usage;
+	const tokenUsage = {
+		inputTokens: usage?.inputTokens ?? 0,
+		outputTokens: usage?.outputTokens ?? 0,
+		cacheReadTokens: usage?.cacheReadTokens ?? 0,
+		cacheWriteTokens: usage?.cacheWriteTokens ?? 0
+	};
+	return {
+		durationMs: result.durationMs ?? 0,
+		inputTokens: tokenUsage.inputTokens,
+		outputTokens: tokenUsage.outputTokens,
+		cacheReadTokens: tokenUsage.cacheReadTokens,
+		cacheCreationTokens: tokenUsage.cacheWriteTokens,
+		totalCostUsd: calculateUsageCostUsd(result.modelId, tokenUsage),
+		numTurns
+	};
+};
+//#endregion
+//#region src/stream-preview.ts
+const formatToolInput = (input) => {
+	if (!input || typeof input !== "object") return String(input ?? "");
+	return Object.entries(input).slice(0, 3).map(([key, val]) => `${key}=${String(val)}`).join(", ");
+};
+const extractAssistantPreview = (message) => {
+	if (message.type !== "assistant") return null;
+	const content = message.message.content;
+	const parts = [];
+	for (const block of content) if (block.type === "text" && block.text) parts.push(block.text.replace(/\n/g, " "));
+	else if (block.type === "tool_use" && block.name) {
+		const args = formatToolInput(block.input);
+		parts.push(`ToolCall(${block.name}${args ? `, ${args}` : ""})`);
+	}
+	return parts.length > 0 ? parts.join(" | ") : null;
+};
+const getMessagePreview = (message) => {
+	if (message.type === "assistant") return extractAssistantPreview(message) ?? "";
+	if (message.type === "thinking") return message.text.replace(/\n/g, " ");
+	if (message.type === "tool_call") return `ToolCall(${message.name}, ${message.status})`;
+	if (message.type === "user") {
+		const parts = [];
+		for (const block of message.message.content) if (block.type === "text" && block.text) parts.push(block.text.replace(/\n/g, " "));
+		return parts.join(" | ");
+	}
+	return "";
+};
+//#endregion
+//#region src/cursor-engine.ts
+const debug = createDebug("bifrost:engine:cursor");
+const DEFAULT_MODEL = "composer-2.5";
+const DEFAULT_EXECUTION_TIMEOUT_MS = 1800 * 1e3;
+const mcpServerNamePattern = /^mcp__([^_]+(?:_[^_]+)*)__/;
+var ExecutionTimeoutError = class extends Error {
+	timeoutMs;
+	constructor(timeoutMs) {
+		super(`Execution timed out after ${timeoutMs}ms`);
+		this.timeoutMs = timeoutMs;
+		this.name = "ExecutionTimeoutError";
+	}
+};
+var CursorEngine = class {
+	config;
+	toolkits = /* @__PURE__ */ new Map();
+	constructor(config = {}) {
+		this.config = config;
+	}
+	registerToolkit(name, toolkit) {
+		this.toolkits.set(name, toolkit);
+	}
+	resolveApiKey() {
+		return this.config.apiKey ?? process.env.CURSOR_API_KEY;
+	}
+	resolveModel(agentModel) {
+		return { id: agentModel ?? this.config.model ?? DEFAULT_MODEL };
+	}
+	resolveMcpServers(tools, context) {
+		const bareToolNames = [...new Set(tools.map((tool) => typeof tool === "string" ? tool.replace(/\(.*\)$/, "") : tool.name))];
+		const activeServerNames = new Set(bareToolNames.map((toolName) => mcpServerNamePattern.exec(toolName)?.[1]).filter((serverName) => serverName !== null && serverName !== void 0));
+		if (activeServerNames.size === 0) return;
+		debug("creating tools workingDir=%s", context.workingDir);
+		const mcpServers = {};
+		for (const name of activeServerNames) {
+			const entry = this.toolkits.get(name);
+			if (entry !== void 0) mcpServers[name] = typeof entry === "function" ? entry(context) : entry;
+		}
+		debug("mcp tools created count=%s", Object.keys(mcpServers).length);
+		return Object.keys(mcpServers).length > 0 ? mcpServers : void 0;
+	}
+	async streamRun(run) {
+		let lastMessage = null;
+		let numTurns = 0;
+		for await (const message of run.stream()) {
+			const preview = getMessagePreview(message);
+			debug("message type=%s preview=%s", message.type, preview ? `"${preview}..."` : "-");
+			if (message.type === "usage") numTurns += 1;
+			if (message.type === "assistant") {
+				if (preview) lastMessage = preview;
+			}
+		}
+		return {
+			lastMessage,
+			numTurns: numTurns > 0 ? numTurns : 1
+		};
+	}
+	async withExecutionTimeout(run, timeoutMs, operation) {
+		let timer;
+		try {
+			return await Promise.race([operation(), new Promise((_, reject) => {
+				timer = setTimeout(() => {
+					reject(new ExecutionTimeoutError(timeoutMs));
+				}, timeoutMs);
+			})]);
+		} catch (error) {
+			if (error instanceof ExecutionTimeoutError) await run.cancel().catch(() => void 0);
+			throw error;
+		} finally {
+			if (timer !== void 0) clearTimeout(timer);
+		}
+	}
+	mapFinishedResult(result, agentId, lastMessage, numTurns, modelId) {
+		const stats = mapRunResultToStats({
+			durationMs: result.durationMs,
+			usage: result.usage,
+			modelId: result.model?.id ?? modelId
+		}, numTurns);
+		return {
+			success: true,
+			skipFulfill: false,
+			lastMessage: result.result ?? lastMessage ?? "No response from Cursor",
+			stats,
+			sessionId: agentId
+		};
+	}
+	async execute(context, sessionId) {
+		const { agent, instructions, workingDir } = context;
+		const apiKey = this.resolveApiKey();
+		if (!apiKey) return {
+			success: false,
+			skipFulfill: false,
+			lastMessage: "Missing Cursor API key (set CURSOR_API_KEY or pass apiKey in config)",
+			stats: null
+		};
+		const prompt = sessionId ? instructions : buildPrompt({
+			agent,
+			instructions
+		});
+		const model = this.resolveModel(agent.model);
+		const mcpServers = this.resolveMcpServers(agent.tools, context);
+		const settingSources = this.config.settingSources ?? [];
+		const executionTimeoutMs = this.config.executionTimeoutMs ?? DEFAULT_EXECUTION_TIMEOUT_MS;
+		debug("execute workingDir=%s sessionId=%s", workingDir, sessionId ?? "none");
+		debug("prompt: %s", prompt);
+		try {
+			const agentHandle = sessionId ? await this.withExecutionTimeout({ cancel: async () => void 0 }, executionTimeoutMs, () => Agent.resume(sessionId, {
+				apiKey,
+				model,
+				local: {
+					cwd: workingDir,
+					settingSources
+				},
+				...mcpServers && { mcpServers }
+			})) : await this.withExecutionTimeout({ cancel: async () => void 0 }, executionTimeoutMs, () => Agent.create({
+				apiKey,
+				model,
+				local: {
+					cwd: workingDir,
+					settingSources
+				},
+				...mcpServers && { mcpServers },
+				...this.config.mode && { mode: this.config.mode }
+			}));
+			const run = await this.withExecutionTimeout({ cancel: async () => void 0 }, executionTimeoutMs, () => agentHandle.send(prompt));
+			debug("run started id=%s requestId=%s", run.id, run.requestId ?? "-");
+			const { lastMessage, numTurns } = await this.withExecutionTimeout(run, executionTimeoutMs, () => this.streamRun(run));
+			const result = await this.withExecutionTimeout(run, executionTimeoutMs, () => run.wait());
+			if (result.status === "error" || result.status === "cancelled") return {
+				success: false,
+				skipFulfill: false,
+				lastMessage: result.result ?? result.status,
+				stats: mapRunResultToStats({
+					durationMs: result.durationMs,
+					usage: result.usage,
+					modelId: result.model?.id ?? model.id
+				}, numTurns),
+				sessionId: agentHandle.agentId
+			};
+			return this.mapFinishedResult(result, agentHandle.agentId, lastMessage, numTurns, model.id);
+		} catch (error) {
+			debug("error: %o", error);
+			if (error instanceof ExecutionTimeoutError) return {
+				success: false,
+				skipFulfill: false,
+				lastMessage: error.message,
+				stats: null
+			};
+			if (error instanceof CursorAgentError) return {
+				success: false,
+				skipFulfill: false,
+				lastMessage: error.message,
+				stats: null
+			};
+			return {
+				success: false,
+				skipFulfill: false,
+				lastMessage: error instanceof Error ? error.message : String(error),
+				stats: null
+			};
+		}
+	}
+};
+//#endregion
+export { CursorEngine };

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@bifrost-ai/engine-cursor",
+  "version": "0.1.1-build.1783540132209",
+  "description": "Cursor SDK engine for Bifrost orchestrator v2",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@bifrost-ai/engine": "0.1.1-build.1783540132209",
+    "@cursor/sdk": "^1.0.22",
+    "debug": "^4.4.0"
+  },
+  "devDependencies": {
+    "@types/debug": "^4.1.12",
+    "@types/node": "^25.6.2",
+    "@typescript/native-preview": "latest",
+    "bumpp": "^11.1.0",
+    "typescript": "^6.0.3",
+    "vite-plus": "^0.2.0",
+    "vitest-gwt": "^4.1.0"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
+  }
+}