replicas-engine 0.1.336 → 0.1.337

package/dist/src/index.js

@@ -15,6 +15,10 @@ function isRecord(value) {
 }
 
 // ../shared/src/agent.ts
+var VALID_AGENT_PROVIDERS = ["claude", "codex", "cursor", "relay"];
+var VALID_CODING_AGENT_PROVIDERS = VALID_AGENT_PROVIDERS.filter(
+  (provider) => provider !== "relay"
+);
 var CODEX_REASONING_EFFORT_BY_THINKING_LEVEL = {
   low: "low",
   medium: "medium",
@@ -291,7 +295,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-22-v2";
+var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-06-22-v3";
 
 // ../shared/src/runtime-env.ts
 function parsePosixEnvFile(content) {
@@ -7497,7 +7501,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.336";
+var ENGINE_PACKAGE_VERSION = "0.1.337";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";
@@ -9385,8 +9389,29 @@ var CursorManager = class extends CodingAgentManager {
 // src/managers/relay-tools.ts
 import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk";
 import { z } from "zod";
+
+// src/managers/relay-providers.ts
+function getAvailableRelayProviders(availability) {
+  const codexAvailable = availability.codexAvailable ?? false;
+  const cursorAvailable = availability.cursorAvailable ?? false;
+  const providers = ["claude"];
+  if (codexAvailable) providers.push("codex");
+  if (cursorAvailable) providers.push("cursor");
+  providers.push("relay");
+  return providers;
+}
+function getAvailableCodeProviders(availability) {
+  return getAvailableRelayProviders(availability).filter((provider) => provider === "codex" || provider === "cursor");
+}
+
+// src/managers/relay-tools.ts
 var POLL_INTERVAL_MS = 2e3;
 var DEFAULT_SUBAGENT_TIMEOUT_MS = 6e5;
+function extractTextBlocks(content, textBlockType, separator = "\n") {
+  if (!Array.isArray(content)) return null;
+  const texts = content.map((block) => block && typeof block === "object" && "type" in block && block.type === textBlockType && "text" in block && typeof block.text === "string" ? block.text : "").filter(Boolean);
+  return texts.length > 0 ? texts.join(separator) : null;
+}
 async function engineFetch(path5, options) {
   const baseUrl = `http://localhost:${ENGINE_ENV.REPLICAS_ENGINE_PORT}`;
   return fetch(`${baseUrl}${path5}`, {
@@ -9439,21 +9464,12 @@ async function getChatFinalResponse(chatId) {
     }
     if (event.type === "claude-assistant") {
       const message = payload.message;
-      if (message?.content) {
-        const textBlocks = message.content.filter((block) => block.type === "text" && block.text).map((block) => block.text);
-        if (textBlocks.length > 0) {
-          return textBlocks.join("\n");
-        }
-      }
+      const text = extractTextBlocks(message?.content, "text");
+      if (text) return text;
     }
     if (event.type === "response_item" && payload.type === "message" && payload.role === "assistant") {
-      const content = payload.content;
-      if (Array.isArray(content)) {
-        const texts = content.filter((block) => block.type === "output_text" && block.text).map((block) => block.text);
-        if (texts.length > 0) {
-          return texts.join("\n");
-        }
-      }
+      const text = extractTextBlocks(payload.content, "output_text");
+      if (text) return text;
     }
     if (event.type === "event_msg" && payload.type === "agent_reasoning") {
       const text = payload.text;
@@ -9461,13 +9477,22 @@ async function getChatFinalResponse(chatId) {
         return text;
       }
     }
+    if (event.type === "cursor-assistant") {
+      const message = payload.message;
+      const text = extractTextBlocks(message?.content, "text", "");
+      if (text) return text;
+    }
   }
   return "[No response from subagent]";
 }
-function buildSpawnAgentTool(parentChatId, codexAvailable = false) {
-  const providerEnum = codexAvailable ? z.enum(["claude", "codex", "relay"]) : z.enum(["claude", "relay"]);
-  const providerDesc = codexAvailable ? "Which agent to use. Prefer codex for code writing, claude for exploration/analysis, relay for complex multi-step orchestration." : "Which agent to use. Use claude for code writing, exploration, and analysis. Use relay for complex multi-step orchestration.";
-  const useCases = codexAvailable ? `- Complex code writing tasks (use provider 'codex' with a capable model)
+function buildSpawnAgentTool(parentChatId, availability = {}) {
+  const codexAvailable = availability.codexAvailable ?? false;
+  const cursorAvailable = availability.cursorAvailable ?? false;
+  const availableProviders = getAvailableRelayProviders(availability);
+  const providerEnum = z.enum(availableProviders);
+  const codeProviders = getAvailableCodeProviders(availability);
+  const providerDesc = codeProviders.length > 0 ? `Which agent to use. Prefer ${codeProviders.join(" or ")} for code writing, claude for exploration/analysis, relay for complex multi-step orchestration.` : "Which agent to use. Use claude for code writing, exploration, and analysis. Use relay for complex multi-step orchestration.";
+  const useCases = codeProviders.length > 0 ? `- Complex code writing tasks (use provider '${codeProviders.join("' or '")}' with a capable model)
 - Codebase exploration that would consume many tokens (use provider 'claude')` : `- Complex code writing tasks (use provider 'claude')
 - Codebase exploration that would consume many tokens (use provider 'claude')`;
   return tool(
@@ -9484,9 +9509,13 @@ You will also receive the chatId so you can send follow-up messages or clean up
     {
       provider: providerEnum.describe(providerDesc),
       prompt: z.string().describe("The full prompt/instructions for the subagent. Be detailed - it has no context from your conversation."),
-      model: z.string().optional().describe(codexAvailable ? `Model override. Claude: ${AGENT_MODELS.claude.join(", ")} (opus[1m] is the default, 1M context, use for very large codebases or huge context tasks). Codex: gpt-5.5, gpt-5.4, gpt-5.3-codex, etc.` : `Model override. Claude: ${AGENT_MODELS.claude.join(", ")} (opus[1m] is the default, 1M context, use for very large codebases or huge context tasks).`),
+      model: z.string().optional().describe([
+        `Model override. Claude: ${AGENT_MODELS.claude.join(", ")} (opus[1m] is the default, 1M context, use for very large codebases or huge context tasks).`,
+        codexAvailable ? "Codex: gpt-5.5, gpt-5.4, gpt-5.3-codex, etc." : null,
+        cursorAvailable ? `Cursor: ${AGENT_MODELS.cursor.join(", ")}.` : null
+      ].filter(Boolean).join(" ")),
       thinking_level: z.enum(["low", "medium", "high", "max"]).optional().describe(
-        "Controls how much thinking/reasoning the subagent applies. low = light thinking, medium = moderate, high = deep reasoning, max = maximum effort. Defaults: Claude = high, Codex = medium."
+        "Controls how much thinking/reasoning the subagent applies. low = light thinking, medium = moderate, high = deep reasoning, max = maximum effort. Defaults: Claude = high, Codex = medium, Cursor = medium."
       ),
       title: z.string().optional().describe("Optional title for the subagent chat (for identification)."),
       timeout_minutes: z.number().positive().optional().describe("Timeout in minutes for the subagent to complete (default: 10). Set higher for large tasks to avoid losing work.")
@@ -9554,7 +9583,7 @@ The tool blocks until the subagent completes and returns its response.`,
     message: z.string().describe("The follow-up message to send."),
     model: z.string().optional().describe("Optional model override for this message."),
     thinking_level: z.enum(["low", "medium", "high", "max"]).optional().describe(
-      "Controls how much thinking/reasoning the subagent applies. low = light thinking, medium = moderate, high = deep reasoning, max = maximum effort. Defaults: Claude = high, Codex = medium."
+      "Controls how much thinking/reasoning the subagent applies. low = light thinking, medium = moderate, high = deep reasoning, max = maximum effort. Defaults: Claude = high, Codex = medium, Cursor = medium."
     ),
     timeout_minutes: z.number().positive().optional().describe("Timeout in minutes for the subagent to complete (default: 10). Set higher for large tasks to avoid losing work.")
   },
@@ -9612,11 +9641,11 @@ var deleteAgentTool = tool(
     }
   }
 );
-function createRelayMcpServer(parentChatId, codexAvailable = false) {
+function createRelayMcpServer(parentChatId, availability = {}) {
   return createSdkMcpServer({
     name: "relay-subagent-tools",
     version: "1.0.0",
-    tools: [buildSpawnAgentTool(parentChatId, codexAvailable), messageAgentTool, deleteAgentTool]
+    tools: [buildSpawnAgentTool(parentChatId, availability), messageAgentTool, deleteAgentTool]
   });
 }
 
@@ -9718,11 +9747,15 @@ function getUsingToolsSection() {
   ];
   return [`# Using your tools`, ...prependBullets(items)].join("\n");
 }
-function getDelegationSection(codexAvailable) {
-  const providerList = codexAvailable ? "claude, codex, or relay" : "claude or relay";
+function getDelegationSection(codexAvailable, cursorAvailable) {
+  const providerList = getAvailableRelayProviders({ codexAvailable, cursorAvailable }).join(", ");
   const spawnDesc = `Create a new subagent with a specific provider (${providerList}), send it a prompt, and wait for its response. Returns the chatId and the agent's final response. You can set a custom timeout via the timeout_minutes parameter (default: 10 minutes).`;
   const claudeModelList = AGENT_MODELS.claude.join(", ");
-  const agentSelectionLines = codexAvailable ? `Use provider 'codex' for heavy code writing, implementation, and large refactors. Suggested models: gpt-5.5 (default), gpt-5.4, gpt-5.3-codex.
+  const extraAgentLines = [
+    codexAvailable ? `Use provider 'codex' for heavy code writing, implementation, and large refactors. Suggested models: gpt-5.5 (default), gpt-5.4, gpt-5.3-codex.` : null,
+    cursorAvailable ? `Use provider 'cursor' for fast iteration on code changes. Suggested models: ${AGENT_MODELS.cursor.join(", ")}.` : null
+  ].filter(Boolean);
+  const agentSelectionLines = extraAgentLines.length > 0 ? `${extraAgentLines.join("\n\n")}
 
 Use provider 'claude' for codebase exploration, code review, planning, complex debugging, and tasks requiring nuanced architectural understanding. Suggested models: ${claudeModelList} (opus[1m] is the default, 1M context window, use for very large codebases; sonnet is faster).` : `Use provider 'claude' for all tasks including code writing, codebase exploration, code review, planning, complex debugging, and tasks requiring nuanced architectural understanding. Suggested models: ${claudeModelList} (opus[1m] is the default, 1M context window, use for very large codebases; sonnet is faster).`;
   return `# Delegation
@@ -9842,14 +9875,14 @@ function getEnvironmentSection() {
   ].join("\n");
 }
 function buildRelaySystemPrompt(options) {
-  const { customInstructions, codexAvailable } = options ?? {};
+  const { customInstructions, codexAvailable, cursorAvailable } = options ?? {};
   const sections = [
     getIntroSection(),
     getSystemSection(),
     getDoingTasksSection(),
     getActionsSection(),
     getUsingToolsSection(),
-    getDelegationSection(codexAvailable ?? false),
+    getDelegationSection(codexAvailable ?? false, cursorAvailable ?? false),
     getToneAndStyleSection(),
     getOutputEfficiencySection(),
     getEnvironmentSection(),
@@ -9880,12 +9913,13 @@ var RelayManager = class {
   inner;
   constructor(options) {
     const codexAvailable = options.codexAvailable ?? false;
+    const cursorAvailable = options.cursorAvailable ?? false;
     this.inner = new ClaudeManager({
       ...options,
-      systemPromptOverride: (customInstructions) => buildRelaySystemPrompt({ customInstructions, codexAvailable }),
+      systemPromptOverride: (customInstructions) => buildRelaySystemPrompt({ customInstructions, codexAvailable, cursorAvailable }),
       tools: RELAY_TOOLS,
       mcpServers: {
-        "relay-subagent-tools": createRelayMcpServer(options.chatId, codexAvailable)
+        "relay-subagent-tools": createRelayMcpServer(options.chatId, { codexAvailable, cursorAvailable })
       },
       envOverrides: {
         CLAUDE_CODE_STREAM_CLOSE_TIMEOUT: "900000"
@@ -10252,6 +10286,9 @@ function isChatMessageSender(value) {
 function isCodexAvailable() {
   return existsSync7(CODEX_AUTH_PATH2) || Boolean(ENGINE_ENV.OPENAI_API_KEY);
 }
+function isCursorAvailable() {
+  return Boolean(ENGINE_ENV.CURSOR_API_KEY);
+}
 function isSameAcceptedUserEvent(event, acceptedEvent) {
   if (areSameUserMessageEvents(event, acceptedEvent)) return true;
   const eventMessage = getUserMessage(event);
@@ -10693,7 +10730,8 @@ var ChatService = class {
         onTurnComplete: onProviderTurnComplete,
         onEvent: onProviderEvent,
         chatId: persisted.id,
-        codexAvailable: isCodexAvailable()
+        codexAvailable: isCodexAvailable(),
+        cursorAvailable: isCursorAvailable()
       });
     } else if (persisted.provider === "cursor") {
       provider = new CursorManager({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-engine",
-  "version": "0.1.336",
+  "version": "0.1.337",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",