replicas-engine 0.1.328 → 0.1.330

package/dist/src/index.js

@@ -287,7 +287,7 @@ var WORKSPACE_SIZES = ["small", "large"];
 var INVALID_WORKSPACE_SIZE_ERROR = `Invalid size: must be one of ${WORKSPACE_SIZES.join(", ")}`;
 
 // ../shared/src/e2b.ts
-var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-06-19-v2";
+var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-06-20-v2";
 
 // ../shared/src/runtime-env.ts
 function parsePosixEnvFile(content) {
@@ -2123,11 +2123,13 @@ var DESKTOP_NOVNC_PORT = 6080;
 var DEFAULT_CHAT_TITLES = {
   claude: "Claude Code",
   codex: "Codex",
+  cursor: "Cursor",
   relay: "Relay"
 };
 var CLAUDE_OPUS_1M_MODEL = "opus[1m]";
 var LEGACY_CLAUDE_OPUS_1M_MODEL = "opus-1m";
 var DEFAULT_CODEX_MODEL = "gpt-5.5";
+var DEFAULT_CURSOR_MODEL = "composer-2";
 function normalizeClaudeModel(model) {
   if (model === LEGACY_CLAUDE_OPUS_1M_MODEL) {
     return CLAUDE_OPUS_1M_MODEL;
@@ -2137,6 +2139,7 @@ function normalizeClaudeModel(model) {
 var AGENT_MODELS = {
   claude: [CLAUDE_OPUS_1M_MODEL, "sonnet", "haiku"],
   codex: [DEFAULT_CODEX_MODEL, "gpt-5.4", "gpt-5.4-mini", "gpt-5.3-codex", "gpt-5.2"],
+  cursor: [DEFAULT_CURSOR_MODEL, "composer-2.5"],
   relay: [CLAUDE_OPUS_1M_MODEL, "sonnet"]
 };
 var MODEL_LABELS = {
@@ -2146,6 +2149,8 @@ var MODEL_LABELS = {
   [LEGACY_CLAUDE_OPUS_1M_MODEL]: "Opus 4.8 (1M)",
   haiku: "Haiku 4.5",
   [DEFAULT_CODEX_MODEL]: "GPT-5.5",
+  [DEFAULT_CURSOR_MODEL]: "Composer 2",
+  "composer-2.5": "Composer 2.5",
   "gpt-5.4": "GPT-5.4",
   "gpt-5.4-mini": "GPT-5.4 Mini",
   "gpt-5.3-codex": "GPT-5.3 Codex",
@@ -2825,6 +2830,7 @@ function loadEngineEnv() {
     SLACK_THREAD_TS: readEnv("SLACK_THREAD_TS"),
     ANTHROPIC_API_KEY: readEnv("ANTHROPIC_API_KEY"),
     OPENAI_API_KEY: readEnv("OPENAI_API_KEY"),
+    CURSOR_API_KEY: readEnv("CURSOR_API_KEY"),
     CLAUDE_CODE_USE_BEDROCK: readEnv("CLAUDE_CODE_USE_BEDROCK"),
     AWS_ACCESS_KEY_ID: readEnv("AWS_ACCESS_KEY_ID"),
     AWS_SECRET_ACCESS_KEY: readEnv("AWS_SECRET_ACCESS_KEY"),
@@ -4198,6 +4204,9 @@ function detectCodexAuthMethod() {
   }
   return "none";
 }
+function detectCursorAuthMethod() {
+  return ENGINE_ENV.CURSOR_API_KEY ? "api_key" : "none";
+}
 async function detectGitIdentityConfigured() {
   try {
     const { stdout } = await execFileAsync("git", ["config", "--global", "user.name"]);
@@ -4237,6 +4246,7 @@ function createDefaultDetails() {
     googleAccessConfigured: false,
     claudeAuthMethod: "none",
     codexAuthMethod: "none",
+    cursorAuthMethod: "none",
     lastUpdatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
@@ -4267,6 +4277,7 @@ var EnvironmentDetailsService = class {
     details.engineVersion = E2B_TEMPLATE_NAME;
     details.claudeAuthMethod = detectClaudeAuthMethod();
     details.codexAuthMethod = detectCodexAuthMethod();
+    details.cursorAuthMethod = detectCursorAuthMethod();
     details.gitIdentityConfigured = gitIdentityConfigured;
     const ghConfigured = existsSync3(GH_HOSTS_PATH);
     details.githubAccessConfigured = ghConfigured;
@@ -5015,9 +5026,9 @@ async function registerDesktopPreview() {
 
 // src/services/chat/chat-service.ts
 import { existsSync as existsSync7 } from "fs";
-import { appendFile as appendFile4, copyFile, mkdir as mkdir11, readFile as readFile13, rename as rename2, rm } from "fs/promises";
+import { appendFile as appendFile5, copyFile, mkdir as mkdir12, readFile as readFile13, rename as rename2, rm } from "fs/promises";
 import { homedir as homedir14 } from "os";
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 import { randomUUID as randomUUID5 } from "crypto";
 
 // src/managers/claude-manager.ts
@@ -6290,15 +6301,19 @@ var ClaudeAuthError = class extends Error {
   }
 };
 var ClaudeTransientTurnError = class extends Error {
-  constructor(message) {
+  constructor(message, midTurn = false) {
     super(message);
+    this.midTurn = midTurn;
     this.name = "ClaudeTransientTurnError";
   }
+  midTurn;
 };
 var MAX_AUTH_RETRIES = 2;
 var MAX_TRANSIENT_RETRIES = 2;
+var MAX_MIDTURN_CONTINUE_RETRIES = 2;
 var TRANSIENT_RETRY_DELAYS_MS = [1e3, 2500];
 var CLAUDE_TRANSIENT_HTTP_STATUSES = [408, 500, 502, 503, 504, 529];
+var CLAUDE_MIDTURN_CONTINUE_PROMPT = "Your previous turn was interrupted by a transient network error before it could finish. Continue from exactly where you left off. Do not repeat any tool calls, commits, messages, or other actions you have already completed \u2014 first check what is already done, then do only the remaining work.";
 var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
   historyFile;
   sessionId = null;
@@ -6468,10 +6483,12 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
     let attempt = 0;
     let authRetries = 0;
     let transientRetries = 0;
+    let midTurnContinues = 0;
+    let currentRequest = request;
     try {
       while (true) {
         try {
-          await this.executeQuery(request, { skipUserMessageRecord: attempt > 0 });
+          await this.executeQuery(currentRequest, { skipUserMessageRecord: attempt > 0 });
           return;
         } catch (error) {
           lastError = error;
@@ -6496,6 +6513,23 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
             attempt++;
             continue;
           }
+          if (error instanceof ClaudeTransientTurnError && error.midTurn) {
+            if (midTurnContinues >= MAX_MIDTURN_CONTINUE_RETRIES) {
+              await this.emitMidTurnExhaustedEvent(error);
+              return;
+            }
+            midTurnContinues++;
+            const delayMs = TRANSIENT_RETRY_DELAYS_MS[midTurnContinues - 1] ?? TRANSIENT_RETRY_DELAYS_MS[TRANSIENT_RETRY_DELAYS_MS.length - 1];
+            console.warn(
+              `[ClaudeManager] Mid-turn transient failure detected (attempt ${midTurnContinues}/${MAX_MIDTURN_CONTINUE_RETRIES}), resuming session and continuing in ${delayMs}ms...`,
+              error
+            );
+            await this.tearDownSession();
+            await new Promise((resolve4) => setTimeout(resolve4, delayMs));
+            currentRequest = { ...request, message: CLAUDE_MIDTURN_CONTINUE_PROMPT, images: [] };
+            attempt++;
+            continue;
+          }
           if (_ClaudeManager.isTransientTurnError(error) && transientRetries < MAX_TRANSIENT_RETRIES) {
             transientRetries++;
             const delayMs = TRANSIENT_RETRY_DELAYS_MS[transientRetries - 1] ?? TRANSIENT_RETRY_DELAYS_MS[TRANSIENT_RETRY_DELAYS_MS.length - 1];
@@ -6523,8 +6557,9 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
       }
     }
   }
-  async emitAuthRetryExhaustedEvent(error) {
-    const detail = error instanceof Error ? error.message : String(error);
+  // `errors` is the field the dashboard renders (see claude-parser); `result` is
+  // only retained on the raw event for debugging. The user-facing message goes in `errors`.
+  async emitTerminalErrorResult(result, errors, logLabel) {
     const event = {
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       type: "claude-result",
@@ -6532,8 +6567,8 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
         type: "result",
         subtype: "error_during_execution",
         is_error: true,
-        result: "Couldn't authenticate with Claude after multiple attempts. Check your credentials in Settings \u2192 Agents and try again.",
-        errors: [detail],
+        result,
+        errors,
         session_id: this.sessionId ?? "",
         parent_tool_use_id: null
       }
@@ -6541,10 +6576,26 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
     try {
       await appendFile2(this.historyFile, JSON.stringify(event) + "\n", "utf-8");
     } catch (writeError) {
-      console.error("[ClaudeManager] Failed to record auth-retry-exhausted event:", writeError);
+      console.error(`[ClaudeManager] Failed to record ${logLabel} event:`, writeError);
     }
     this.onEvent(event);
   }
+  async emitAuthRetryExhaustedEvent(error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    await this.emitTerminalErrorResult(
+      detail,
+      ["Couldn't authenticate with Claude after multiple attempts. Check your credentials in Settings \u2192 Agents and try again."],
+      "auth-retry-exhausted"
+    );
+  }
+  async emitMidTurnExhaustedEvent(error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    await this.emitTerminalErrorResult(
+      detail,
+      ["The connection to Claude dropped mid-response and could not be resumed after multiple attempts."],
+      "mid-turn-exhausted"
+    );
+  }
   async executeQuery(request, options = {}) {
     const {
       message,
@@ -6772,12 +6823,10 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
           }
           return;
         }
-        const transientErrorMessage = _ClaudeManager.detectTransientTurnErrorInMessage(
-          msg,
-          this.pendingTurn?.sawActivity ?? false
-        );
+        const transientErrorMessage = _ClaudeManager.detectTransientTurnErrorInMessage(msg);
         if (transientErrorMessage) {
-          this.failPendingTurn(new ClaudeTransientTurnError(transientErrorMessage));
+          const sawActivity = this.pendingTurn?.sawActivity ?? false;
+          this.failPendingTurn(new ClaudeTransientTurnError(transientErrorMessage, sawActivity));
           try {
             response.close();
           } catch (err) {
@@ -6809,7 +6858,7 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
     } finally {
       this.sessionLinearForwarder?.flushThoughtAsResponse();
       const pending = this.pendingTurn;
-      const pendingError = loopError ? pending?.sawActivity && _ClaudeManager.isTransientTurnError(loopError) ? new Error("Claude session ended unexpectedly") : loopError : pending && !pending.sawActivity ? new ClaudeTransientTurnError("Claude session ended unexpectedly before producing a response") : new Error("Claude session ended unexpectedly");
+      const pendingError = loopError ? pending?.sawActivity && _ClaudeManager.isTransientTurnError(loopError) ? new ClaudeTransientTurnError("Claude session ended unexpectedly mid-response", true) : loopError : pending && !pending.sawActivity ? new ClaudeTransientTurnError("Claude session ended unexpectedly before producing a response") : new Error("Claude session ended unexpectedly");
       this.failPendingTurn(pendingError);
       if (this.activeQuery === response) {
         this.clearSessionState();
@@ -6931,8 +6980,7 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
   static isTransientTurnErrorText(text) {
     return isTransientErrorText(text, { httpStatuses: CLAUDE_TRANSIENT_HTTP_STATUSES });
   }
-  static detectTransientTurnErrorInMessage(message, sawActivity) {
-    if (sawActivity) return null;
+  static detectTransientTurnErrorInMessage(message) {
     if (message.type === "assistant" && "error" in message && typeof message.error === "string") {
       return _ClaudeManager.isTransientTurnErrorText(message.error) ? message.error : null;
     }
@@ -7291,7 +7339,7 @@ var AspClient = class {
 // src/managers/codex-asp/app-server-process.ts
 var DEFAULT_CODEX_BINARY = "codex";
 var DEFAULT_CODEX_ARGS = ["app-server", "--listen", "stdio://"];
-var ENGINE_PACKAGE_VERSION = "0.1.328";
+var ENGINE_PACKAGE_VERSION = "0.1.330";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";
@@ -9089,6 +9137,120 @@ var CodexAspManager = class extends CodingAgentManager {
   }
 };
 
+// src/managers/cursor-manager.ts
+import { appendFile as appendFile4, mkdir as mkdir11 } from "fs/promises";
+import { dirname as dirname4, join as join15 } from "path";
+import { Agent as CursorAgent } from "@cursor/sdk";
+var CursorManager = class extends CodingAgentManager {
+  agent = null;
+  activeRun = null;
+  historyFile;
+  constructor(options) {
+    super(options);
+    this.historyFile = options.historyFilePath ?? join15(ENGINE_ENV.HOME_DIR, ".replicas", "cursor", "history.jsonl");
+    this.initializeManager(this.processMessageInternal.bind(this));
+  }
+  async initialize() {
+    await mkdir11(dirname4(this.historyFile), { recursive: true });
+  }
+  async interruptActiveTurn() {
+    await this.activeRun?.cancel();
+  }
+  async getHistory() {
+    return {
+      thread_id: this.agent?.agentId ?? this.initialSessionId,
+      events: await readJSONL(this.historyFile),
+      goal: null
+    };
+  }
+  async ensureAgent(request) {
+    if (this.agent) return this.agent;
+    const apiKey = ENGINE_ENV.CURSOR_API_KEY;
+    if (!apiKey) {
+      throw new Error("Cursor API key is not configured for this workspace.");
+    }
+    const model = { id: request.model ?? DEFAULT_CURSOR_MODEL };
+    this.agent = this.initialSessionId ? await CursorAgent.resume(this.initialSessionId, {
+      apiKey,
+      model,
+      local: { cwd: this.workingDirectory }
+    }) : await CursorAgent.create({
+      apiKey,
+      model,
+      local: { cwd: this.workingDirectory }
+    });
+    await this.onSaveSessionId(this.agent.agentId);
+    return this.agent;
+  }
+  async processMessageInternal(request) {
+    try {
+      const agent = await this.ensureAgent(request);
+      const message = await this.toCursorMessage(request);
+      this.recordHistoryEvent("event_msg", {
+        type: "user_message",
+        message: request.message
+      });
+      const run = await agent.send(message, {
+        model: { id: request.model ?? DEFAULT_CURSOR_MODEL },
+        mode: request.planMode ? "plan" : "agent"
+      });
+      this.activeRun = run;
+      for await (const event of run.stream()) {
+        this.recordCursorEvent(event);
+      }
+      const result = await run.wait();
+      if (result.status === "error") {
+        this.recordHistoryEvent("cursor-error", {
+          type: "error",
+          message: result.result || "Cursor run failed",
+          runId: result.id
+        });
+      }
+    } catch (error) {
+      this.recordHistoryEvent("cursor-error", {
+        type: "error",
+        message: error instanceof Error ? error.message : String(error)
+      });
+    } finally {
+      this.activeRun = null;
+      await this.onTurnComplete();
+    }
+  }
+  async toCursorMessage(request) {
+    if (!request.images || request.images.length === 0) {
+      return request.message;
+    }
+    const images = await normalizeImages(request.images);
+    return {
+      text: request.message,
+      images: images.map((image) => ({
+        data: image.source.data,
+        mimeType: image.source.media_type
+      }))
+    };
+  }
+  recordCursorEvent(event) {
+    this.recordHistoryEvent(`cursor-${event.type}`, event);
+  }
+  recordHistoryEvent(type, payload) {
+    const eventPayload = {};
+    if (payload && typeof payload === "object") {
+      Object.assign(eventPayload, payload);
+    } else {
+      eventPayload.value = payload;
+    }
+    const event = {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      type,
+      payload: eventPayload
+    };
+    this.onEvent(event);
+    appendFile4(this.historyFile, `${JSON.stringify(event)}
+`, "utf-8").catch(() => {
+    });
+  }
+};
+
 // src/managers/relay-tools.ts
 import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk";
 import { z } from "zod";
@@ -9670,10 +9832,10 @@ var keepAliveService = new KeepAliveService();
 // src/services/canvas-service.ts
 import { readdir as readdir4, readFile as readFile11, stat as stat3 } from "fs/promises";
 import { homedir as homedir12 } from "os";
-import { join as join15 } from "path";
+import { join as join16 } from "path";
 var CANVAS_DIRECTORIES = [
-  join15(homedir12(), ".claude", "plans"),
-  join15(homedir12(), ".replicas", "canvas")
+  join16(homedir12(), ".claude", "plans"),
+  join16(homedir12(), ".replicas", "canvas")
 ];
 var CanvasService = class {
   async listItems() {
@@ -9692,7 +9854,7 @@ var CanvasService = class {
         const { kind } = classifyCanvasFilename(entry.name);
         let sizeBytes = 0;
         try {
-          const s = await stat3(join15(directory, entry.name));
+          const s = await stat3(join16(directory, entry.name));
           sizeBytes = s.size;
         } catch {
           continue;
@@ -9707,7 +9869,7 @@ var CanvasService = class {
     if (!safe) return null;
     const { kind, mimeType } = classifyCanvasFilename(safe);
     for (const directory of CANVAS_DIRECTORIES) {
-      const filePath = join15(directory, safe);
+      const filePath = join16(directory, safe);
       let sizeBytes = 0;
       let updatedAt = "";
       try {
@@ -9844,13 +10006,13 @@ async function reconcileCanvasItems(filenames) {
 
 // src/services/upload-chat-transcripts.ts
 import { readdir as readdir5, readFile as readFile12 } from "fs/promises";
-import { basename, join as join16 } from "path";
+import { basename, join as join17 } from "path";
 import { homedir as homedir13 } from "os";
-var ENGINE_DIR2 = join16(homedir13(), ".replicas", "engine");
+var ENGINE_DIR2 = join17(homedir13(), ".replicas", "engine");
 var HISTORY_DIRS = [
-  join16(ENGINE_DIR2, "claude-histories"),
-  join16(ENGINE_DIR2, "relay-histories"),
-  join16(ENGINE_DIR2, "codex-histories")
+  join17(ENGINE_DIR2, "claude-histories"),
+  join17(ENGINE_DIR2, "relay-histories"),
+  join17(ENGINE_DIR2, "codex-histories")
 ];
 async function flushAllChatTranscripts(chatsById = /* @__PURE__ */ new Map()) {
   let flushed = 0;
@@ -9867,7 +10029,7 @@ async function flushAllChatTranscripts(chatsById = /* @__PURE__ */ new Map()) {
       if (!entry.endsWith(".jsonl")) continue;
       const chatId = basename(entry, ".jsonl");
       tasks.push(
-        uploadChatTranscript(chatId, join16(dir, entry), chatsById.get(chatId)).then(() => {
+        uploadChatTranscript(chatId, join17(dir, entry), chatsById.get(chatId)).then(() => {
           flushed++;
         }).catch((err) => {
           failed++;
@@ -9937,18 +10099,20 @@ var DuplicateDefaultChatError = class extends Error {
 };
 
 // src/services/chat/chat-service.ts
-var ENGINE_DIR3 = join17(homedir14(), ".replicas", "engine");
-var CHATS_FILE = join17(ENGINE_DIR3, "chats.json");
-var CLAUDE_HISTORY_DIR = join17(ENGINE_DIR3, "claude-histories");
-var RELAY_HISTORY_DIR = join17(ENGINE_DIR3, "relay-histories");
-var CODEX_HISTORY_DIR = join17(ENGINE_DIR3, "codex-histories");
+var ENGINE_DIR3 = join18(homedir14(), ".replicas", "engine");
+var CHATS_FILE = join18(ENGINE_DIR3, "chats.json");
+var CLAUDE_HISTORY_DIR = join18(ENGINE_DIR3, "claude-histories");
+var RELAY_HISTORY_DIR = join18(ENGINE_DIR3, "relay-histories");
+var CODEX_HISTORY_DIR = join18(ENGINE_DIR3, "codex-histories");
+var CURSOR_HISTORY_DIR = join18(ENGINE_DIR3, "cursor-histories");
 var HISTORY_DIR_BY_PROVIDER = {
   claude: CLAUDE_HISTORY_DIR,
   relay: RELAY_HISTORY_DIR,
-  codex: CODEX_HISTORY_DIR
+  codex: CODEX_HISTORY_DIR,
+  cursor: CURSOR_HISTORY_DIR
 };
-var CHAT_SENDERS_DIR = join17(ENGINE_DIR3, "chat-senders");
-var CODEX_AUTH_PATH2 = join17(homedir14(), ".codex", "auth.json");
+var CHAT_SENDERS_DIR = join18(ENGINE_DIR3, "chat-senders");
+var CODEX_AUTH_PATH2 = join18(homedir14(), ".codex", "auth.json");
 var CHATS_BACKUP_FILE = `${CHATS_FILE}.bak`;
 function isChatMessageSender(value) {
   if (!isRecord4(value)) return false;
@@ -9998,7 +10162,7 @@ function isPersistedChat(value) {
     return false;
   }
   const candidate = value;
-  return typeof candidate.id === "string" && (candidate.provider === "claude" || candidate.provider === "codex" || candidate.provider === "relay") && typeof candidate.title === "string" && typeof candidate.createdAt === "string" && typeof candidate.updatedAt === "string" && (candidate.providerSessionId === null || typeof candidate.providerSessionId === "string") && (candidate.parentChatId === void 0 || candidate.parentChatId === null || typeof candidate.parentChatId === "string");
+  return typeof candidate.id === "string" && (candidate.provider === "claude" || candidate.provider === "codex" || candidate.provider === "cursor" || candidate.provider === "relay") && typeof candidate.title === "string" && typeof candidate.createdAt === "string" && typeof candidate.updatedAt === "string" && (candidate.providerSessionId === null || typeof candidate.providerSessionId === "string") && (candidate.parentChatId === void 0 || candidate.parentChatId === null || typeof candidate.parentChatId === "string");
 }
 function normalizePersistedChat(chat) {
   const isLegacyCodexSdkChat = chat.provider === "codex" && (chat.codexBackend === "sdk" || chat.codexBackend === void 0 && chat.providerSessionId !== null);
@@ -10046,11 +10210,12 @@ var ChatService = class {
   persistInFlight = false;
   persistQueued = false;
   async initialize() {
-    await mkdir11(ENGINE_DIR3, { recursive: true });
-    await mkdir11(CLAUDE_HISTORY_DIR, { recursive: true });
-    await mkdir11(RELAY_HISTORY_DIR, { recursive: true });
-    await mkdir11(CODEX_HISTORY_DIR, { recursive: true });
-    await mkdir11(CHAT_SENDERS_DIR, { recursive: true });
+    await mkdir12(ENGINE_DIR3, { recursive: true });
+    await mkdir12(CLAUDE_HISTORY_DIR, { recursive: true });
+    await mkdir12(RELAY_HISTORY_DIR, { recursive: true });
+    await mkdir12(CODEX_HISTORY_DIR, { recursive: true });
+    await mkdir12(CURSOR_HISTORY_DIR, { recursive: true });
+    await mkdir12(CHAT_SENDERS_DIR, { recursive: true });
     const persisted = await this.loadChats();
     for (const chat of persisted) {
       const runtime = this.createRuntimeChat(chat);
@@ -10062,12 +10227,18 @@ var ChatService = class {
     const hasCodexDefault = [...this.chats.values()].some(
       (c) => c.persisted.provider === "codex" && c.persisted.title === "Codex"
     );
+    const hasCursorDefault = [...this.chats.values()].some(
+      (c) => c.persisted.provider === "cursor" && c.persisted.title === "Cursor"
+    );
     if (!hasClaudeDefault) {
       await this.createChat({ provider: "claude", title: "Claude Code" });
     }
     if (!hasCodexDefault) {
       await this.createChat({ provider: "codex", title: "Codex" });
     }
+    if (!hasCursorDefault) {
+      await this.createChat({ provider: "cursor", title: "Cursor" });
+    }
     const hasRelayDefault = [...this.chats.values()].some(
       (c) => c.persisted.provider === "relay" && c.persisted.title === "Relay"
     );
@@ -10149,11 +10320,11 @@ var ChatService = class {
     };
   }
   senderFilePath(chatId) {
-    return join17(CHAT_SENDERS_DIR, `${chatId}.jsonl`);
+    return join18(CHAT_SENDERS_DIR, `${chatId}.jsonl`);
   }
   async appendSender(chatId, sender) {
     try {
-      await appendFile4(this.senderFilePath(chatId), JSON.stringify(sender) + "\n", "utf-8");
+      await appendFile5(this.senderFilePath(chatId), JSON.stringify(sender) + "\n", "utf-8");
     } catch (error) {
       console.error("[ChatService] Failed to append sender record:", error);
     }
@@ -10305,7 +10476,7 @@ var ChatService = class {
     return descendants;
   }
   async deleteHistoryFile(persisted) {
-    await rm(join17(HISTORY_DIR_BY_PROVIDER[persisted.provider], `${persisted.id}.jsonl`), { force: true });
+    await rm(join18(HISTORY_DIR_BY_PROVIDER[persisted.provider], `${persisted.id}.jsonl`), { force: true });
     await rm(this.senderFilePath(persisted.id), { force: true });
   }
   async getChatHistory(chatId) {
@@ -10376,7 +10547,7 @@ var ChatService = class {
     if (persisted.provider === "claude") {
       provider = new ClaudeManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join17(CLAUDE_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join18(CLAUDE_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -10385,7 +10556,7 @@ var ChatService = class {
     } else if (persisted.provider === "relay") {
       provider = new RelayManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join17(RELAY_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join18(RELAY_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -10393,10 +10564,19 @@ var ChatService = class {
         chatId: persisted.id,
         codexAvailable: isCodexAvailable()
       });
+    } else if (persisted.provider === "cursor") {
+      provider = new CursorManager({
+        workingDirectory: this.workingDirectory,
+        historyFilePath: join18(CURSOR_HISTORY_DIR, `${persisted.id}.jsonl`),
+        initialSessionId: persisted.providerSessionId,
+        onSaveSessionId: saveSession,
+        onTurnComplete: onProviderTurnComplete,
+        onEvent: onProviderEvent
+      });
     } else {
       provider = new CodexAspManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join17(CODEX_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join18(CODEX_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -10535,7 +10715,7 @@ var ChatService = class {
     });
     uploadChatTranscript(
       chatId,
-      join17(HISTORY_DIR_BY_PROVIDER[chat.persisted.provider], `${chatId}.jsonl`),
+      join18(HISTORY_DIR_BY_PROVIDER[chat.persisted.provider], `${chatId}.jsonl`),
       this.toSummary(chat)
     ).catch((err) => {
       console.error("[ChatService] Failed to upload chat transcript:", { chatId, err });
@@ -10651,7 +10831,7 @@ var ChatService = class {
 // src/services/repo-file-service.ts
 import { execFile as execFile2 } from "child_process";
 import { readFile as readFile14, realpath, stat as stat4 } from "fs/promises";
-import { join as join18, resolve as resolve2, extname } from "path";
+import { join as join19, resolve as resolve2, extname } from "path";
 var CACHE_TTL_MS = 3e4;
 var SEARCH_TIMEOUT_MS = 15e3;
 var MAX_CONTENT_BYTES = 256 * 1024;
@@ -10811,7 +10991,7 @@ var RepoFileService = class {
     const repo = repos.find((r) => r.name === repoName);
     if (!repo) return null;
     try {
-      const fullPath = await realpath(resolve2(join18(repo.path, filePath)));
+      const fullPath = await realpath(resolve2(join19(repo.path, filePath)));
       const repoRoot = await realpath(repo.path);
       const repoPrefix = repoRoot.endsWith("/") ? repoRoot : repoRoot + "/";
       if (!fullPath.startsWith(repoPrefix) && fullPath !== repoRoot) return null;
@@ -10919,20 +11099,20 @@ var RepoFileService = class {
 import { Hono } from "hono";
 import { z as z2 } from "zod";
 import { readdir as readdir7, stat as stat5, readFile as readFile17 } from "fs/promises";
-import { join as join21, resolve as resolve3 } from "path";
+import { join as join22, resolve as resolve3 } from "path";
 
 // src/services/warm-hooks-service.ts
 import { spawn as spawn4 } from "child_process";
 import { readFile as readFile16 } from "fs/promises";
 import { existsSync as existsSync8 } from "fs";
-import { join as join20 } from "path";
+import { join as join21 } from "path";
 
 // src/services/warm-hook-logs-service.ts
-import { mkdir as mkdir12, readFile as readFile15, writeFile as writeFile6, readdir as readdir6, appendFile as appendFile5, unlink as unlink3 } from "fs/promises";
+import { mkdir as mkdir13, readFile as readFile15, writeFile as writeFile6, readdir as readdir6, appendFile as appendFile6, unlink as unlink3 } from "fs/promises";
 import { homedir as homedir15 } from "os";
-import { join as join19 } from "path";
-var LOGS_DIR2 = join19(homedir15(), ".replicas", "warm-hook-logs");
-var CURRENT_RUN_LOG = join19(LOGS_DIR2, "current-run.log");
+import { join as join20 } from "path";
+var LOGS_DIR2 = join20(homedir15(), ".replicas", "warm-hook-logs");
+var CURRENT_RUN_LOG = join20(LOGS_DIR2, "current-run.log");
 var GLOBAL_FILENAME = "global.json";
 function withPreview2(stored) {
   const preview = buildHookOutputPreview(stored.output);
@@ -10940,7 +11120,7 @@ function withPreview2(stored) {
 }
 var WarmHookLogsService = class {
   async ensureDir() {
-    await mkdir12(LOGS_DIR2, { recursive: true });
+    await mkdir13(LOGS_DIR2, { recursive: true });
   }
   async saveGlobalHookLog(entry) {
     await this.ensureDir();
@@ -10949,7 +11129,7 @@ var WarmHookLogsService = class {
       hookName: "organization",
       ...entry
     };
-    await writeFile6(join19(LOGS_DIR2, GLOBAL_FILENAME), `${JSON.stringify(log, null, 2)}
+    await writeFile6(join20(LOGS_DIR2, GLOBAL_FILENAME), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async saveEnvironmentHookLog(entry) {
@@ -10959,7 +11139,7 @@ var WarmHookLogsService = class {
       hookName: "environment",
       ...entry
     };
-    await writeFile6(join19(LOGS_DIR2, ENVIRONMENT_HOOK_LOG_FILENAME), `${JSON.stringify(log, null, 2)}
+    await writeFile6(join20(LOGS_DIR2, ENVIRONMENT_HOOK_LOG_FILENAME), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async saveRepoHookLog(repoName, entry) {
@@ -10969,7 +11149,7 @@ var WarmHookLogsService = class {
       hookName: repoName,
       ...entry
     };
-    await writeFile6(join19(LOGS_DIR2, repoHookLogFilename(repoName)), `${JSON.stringify(log, null, 2)}
+    await writeFile6(join20(LOGS_DIR2, repoHookLogFilename(repoName)), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async getAllLogs() {
@@ -10988,7 +11168,7 @@ var WarmHookLogsService = class {
         continue;
       }
       try {
-        const raw = await readFile15(join19(LOGS_DIR2, file), "utf-8");
+        const raw = await readFile15(join20(LOGS_DIR2, file), "utf-8");
         const stored = JSON.parse(raw);
         logs.push(withPreview2(stored));
       } catch {
@@ -11013,7 +11193,7 @@ var WarmHookLogsService = class {
   }
   async appendCurrentRunLog(chunk) {
     if (!chunk) return;
-    await appendFile5(CURRENT_RUN_LOG, chunk, "utf-8");
+    await appendFile6(CURRENT_RUN_LOG, chunk, "utf-8");
   }
   async getCurrentRunLog() {
     try {
@@ -11026,7 +11206,7 @@ var WarmHookLogsService = class {
   async getFullOutput(hookType, hookName) {
     const filename = hookType === "global" ? GLOBAL_FILENAME : hookType === "environment" ? ENVIRONMENT_HOOK_LOG_FILENAME : repoHookLogFilename(hookName);
     try {
-      const raw = await readFile15(join19(LOGS_DIR2, filename), "utf-8");
+      const raw = await readFile15(join20(LOGS_DIR2, filename), "utf-8");
       const stored = JSON.parse(raw);
       if (stored.hookType !== hookType || stored.hookName !== hookName) {
         return null;
@@ -11045,7 +11225,7 @@ var warmHookLogsService = new WarmHookLogsService();
 // src/services/warm-hooks-service.ts
 async function readRepoWarmHook(repoPath) {
   for (const filename of REPLICAS_CONFIG_FILENAMES) {
-    const configPath = join20(repoPath, filename);
+    const configPath = join21(repoPath, filename);
     if (!existsSync8(configPath)) {
       continue;
     }
@@ -11310,7 +11490,7 @@ var setWorkspaceNameSchema = z2.object({
   name: z2.string().min(1).max(48)
 });
 var createChatSchema = z2.object({
-  provider: z2.enum(["claude", "codex", "relay"]),
+  provider: z2.enum(["claude", "codex", "cursor", "relay"]),
   title: z2.string().min(1).optional(),
   parentChatId: z2.string().uuid().optional()
 });
@@ -12000,7 +12180,7 @@ function createV1Routes(deps) {
       const logFiles = files.filter((f) => f.endsWith(".log"));
       const sessions = await Promise.all(
         logFiles.map(async (filename) => {
-          const filePath = join21(LOG_DIR, filename);
+          const filePath = join22(LOG_DIR, filename);
           const fileStat = await stat5(filePath);
           const sessionId = filename.replace(/\.log$/, "");
           return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-engine",
-  "version": "0.1.328",
+  "version": "0.1.330",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",
@@ -31,6 +31,7 @@
   "license": "MIT",
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.3.168",
+    "@cursor/sdk": "1.0.19",
     "@hono/node-server": "^1.19.5",
     "hono": "^4.10.3",
     "smol-toml": "^1.6.0",