replicas-engine 0.1.470 → 0.1.472

package/dist/src/index.js

@@ -582,7 +582,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-07-20-v2";
+var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-07-21-v2";
 
 // ../shared/src/runtime-env.ts
 function shellQuotePosix(value) {
@@ -1190,7 +1190,7 @@ GitHub does NOT have a public API for uploading images to PRs/issues. When you n
 - Do NOT commit screenshots as files to the repository
 - Run \`replicas media upload <image> --share\` and put the printed \`Forge embed\` Markdown in the PR body or comment
 - For video, embed a shared poster image linked to the recording's **View in Replicas** URL; GitHub does not reliably render externally hosted video inline
-- Treat the public URL as an opt-in bearer capability and revoke it with \`replicas media revoke <media-id>\` when appropriate
+- Treat the public URL as an opt-in bearer capability; revoke it with \`replicas media revoke <media-id>\` only when the user asks or the media should stop rendering \u2014 revoking breaks embeds already posted on the PR
 - If you were triggered from Slack, also upload the image to the Slack thread so the user can see it directly
 `;
 var GITHUB_ABILITY = {
@@ -1969,7 +1969,7 @@ GitHub does not reliably render arbitrary external videos as inline players. For
 [![Demo recording](<public-poster-url>)](<recording-dashboard-url>)
 \`\`\`
 
-Public forge shares are bearer capabilities. For private repositories, create one only when the user asked for inline PR media, and revoke it with \`replicas media revoke <media-id>\` when it should stop resolving.
+Public forge shares are bearer capabilities. For private repositories, create one only when the user asked for inline PR media. Revoke with \`replicas media revoke <media-id>\` **only** when the user asks or the media should intentionally stop rendering \u2014 never as routine post-task cleanup, since revoking breaks every embed already posted on the PR.
 
 Do **not** commit screenshots to the repo, use placeholder URLs, expose the authenticated \`/v1/media/<id>\` URL, or automate GitHub's undocumented browser upload flow.
 
@@ -2809,6 +2809,44 @@ var createChatRequestSchema = z2.object({
   parentChatId: z2.string().uuid().optional(),
   clientRequestId: z2.string().min(1).max(128).optional()
 });
+var sendChatMessageRequestSchema = z2.object({
+  messageId: z2.string().optional(),
+  submittedAt: z2.string().optional(),
+  message: z2.string(),
+  model: z2.string().optional(),
+  customInstructions: z2.string().optional(),
+  planMode: z2.boolean().optional(),
+  images: z2.array(z2.object({
+    type: z2.literal("image"),
+    source: z2.discriminatedUnion("type", [
+      z2.object({ type: z2.literal("base64"), media_type: z2.enum(IMAGE_MEDIA_TYPES), data: z2.string() }),
+      z2.object({ type: z2.literal("url"), url: z2.string() })
+    ])
+  })).optional(),
+  thinkingLevel: z2.enum(VALID_THINKING_LEVELS).optional(),
+  goalMode: z2.boolean().optional(),
+  fastMode: z2.boolean().optional(),
+  enableInteractiveTools: z2.boolean().optional(),
+  type: z2.string().optional(),
+  merge: z2.boolean().optional(),
+  idempotencyKey: z2.string().optional(),
+  senderUserId: z2.string().optional(),
+  senderEmail: z2.string().optional(),
+  senderDisplayName: z2.string().optional(),
+  senderAvatarUrl: z2.string().optional(),
+  errorNotificationTarget: z2.discriminatedUnion("type", [
+    z2.object({ type: z2.literal("slack") }),
+    z2.object({ type: z2.literal("linear"), sessionId: z2.string() }),
+    z2.object({
+      type: z2.literal("code_host"),
+      provider: z2.enum(["github", "gitlab"]),
+      resource: z2.enum(["issue", "pull_request"]),
+      repositoryId: z2.string(),
+      resourceNumber: z2.number()
+    }),
+    z2.object({ type: z2.literal("automation"), executionId: z2.string() })
+  ]).optional()
+}).passthrough();
 function normalizeCodexAspTranscriptStatus(status, failed = false) {
   if (failed || status === "failed" || status === "declined") return "failed";
   if (status === "completed") return "completed";
@@ -3137,6 +3175,18 @@ var DEFAULT_WORKSPACE_FILTERS = {
 };
 var ONE_DAY_MS = 24 * 60 * 60 * 1e3;
 
+// ../shared/src/routes/workspace-events.ts
+import { z as z3 } from "zod";
+var workspaceChangedEventSchema = z3.discriminatedUnion("type", [
+  z3.object({ type: z3.literal("workspace.changed"), workspaceId: z3.string(), ts: z3.string() }),
+  z3.object({
+    type: z3.literal("workspace.chat.changed"),
+    workspaceId: z3.string(),
+    chatId: z3.string(),
+    ts: z3.string()
+  })
+]);
+
 // ../shared/src/audit-log.ts
 var AUDIT_LOG_ACTION = {
   CREATE: "create",
@@ -9832,7 +9882,7 @@ var DEFAULT_CODEX_ARGS = ["app-server", "--listen", "stdio://"];
 var MIN_CODEX_CLI_VERSION = "0.144.6";
 var CODEX_UPGRADE_TIMEOUT_MS = 12e4;
 var codexCliVersionEnsured = null;
-var ENGINE_PACKAGE_VERSION = "0.1.470";
+var ENGINE_PACKAGE_VERSION = "0.1.472";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";
@@ -12063,6 +12113,7 @@ var CursorManager = class extends CodingAgentManager {
   abortActiveTurn = null;
   blockedToolCallIds = /* @__PURE__ */ new Set();
   pendingCursorBlockReason = null;
+  instructionsDelivered = false;
   historyFilePath;
   historyFile;
   slashCommandsCache = null;
@@ -12136,16 +12187,18 @@ var CursorManager = class extends CodingAgentManager {
       throw new Error("Cursor API key is not configured for this workspace.");
     }
     const model = { id: request.model ?? DEFAULT_CURSOR_MODEL };
+    const settingSources = ["project", "user"];
+    const local = { cwd: this.workingDirectory, settingSources };
     this.agent = this.initialSessionId ? await CursorAgent.resume(this.initialSessionId, {
       apiKey,
       model,
-      local: { cwd: this.workingDirectory }
+      local
     }) : await CursorAgent.create({
       apiKey,
       model,
-      local: { cwd: this.workingDirectory }
+      local
     });
-    await this.onSaveSessionId(this.agent.agentId);
+    if (this.initialSessionId) await this.onSaveSessionId(this.agent.agentId);
     return this.agent;
   }
   async processMessageInternal(request) {
@@ -12156,8 +12209,9 @@ var CursorManager = class extends CodingAgentManager {
     const linearSessionId = ENGINE_ENV.LINEAR_SESSION_ID;
     const linearForwarder = new LinearEventForwarder(linearSessionId);
     try {
+      const includeInstructions = !this.initialSessionId && !this.instructionsDelivered;
+      const message = await this.toCursorMessage(request, includeInstructions);
       const agent = await this.ensureAgent(request);
-      const message = await this.toCursorMessage(request);
       const model = request.model ?? DEFAULT_CURSOR_MODEL;
       this.recordHistoryEvent("event_msg", {
         type: "user_message",
@@ -12211,6 +12265,10 @@ var CursorManager = class extends CodingAgentManager {
       if (result === TIMEOUT) {
         throw new Error("Cursor run did not report a result after its event stream ended");
       }
+      if (includeInstructions) {
+        this.instructionsDelivered = true;
+        await this.onSaveSessionId(agent.agentId);
+      }
       if (result.status === "error") {
         this.recordHistoryEvent("cursor-error", {
           type: "error",
@@ -12269,13 +12327,19 @@ var CursorManager = class extends CodingAgentManager {
     }
     this.pendingCursorBlockReason = message;
   }
-  async toCursorMessage(request) {
+  async toCursorMessage(request, includeInstructions) {
+    const instructions = includeInstructions ? this.buildCombinedInstructions(request.customInstructions) : void 0;
+    const text = instructions ? `<workspace-instructions>
+${instructions}
+</workspace-instructions>
+
+${request.message}` : request.message;
     if (!request.images || request.images.length === 0) {
-      return request.message;
+      return text;
     }
     const images = await normalizeImages(request.images);
     return {
-      text: request.message,
+      text,
       images: images.map((image) => ({
         data: image.source.data,
         mimeType: image.source.media_type
@@ -12357,7 +12421,7 @@ import { delimiter, dirname as dirname6, join as join18 } from "path";
 import { randomBytes as randomBytes2 } from "crypto";
 import { fileURLToPath } from "url";
 import { Agent } from "undici";
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 import {
   createOpencodeClient,
   createOpencodeServer
@@ -12394,9 +12458,9 @@ var OPENCODE_VARIANT_CANDIDATES_BY_THINKING_LEVEL = {
   ultra: ["max", "xhigh", "high"],
   ultracode: ["max", "xhigh", "high"]
 };
-var opencodeAuthSchema = z3.record(z3.string(), z3.object({
-  type: z3.string().optional(),
-  key: z3.string().optional()
+var opencodeAuthSchema = z4.record(z4.string(), z4.object({
+  type: z4.string().optional(),
+  key: z4.string().optional()
 }));
 async function hasOpenCodeGoCredentials() {
   if (!existsSync7(OPENCODE_AUTH_PATH2)) return false;
@@ -13241,7 +13305,7 @@ var PiManager = class extends CodingAgentManager {
 
 // src/managers/relay-tools.ts
 import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk";
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 
 // src/managers/relay-providers.ts
 function isRelaySubagentProviderAllowed(provider, allowedProviders) {
@@ -13356,7 +13420,7 @@ function buildSpawnAgentTool(parentChatId, availability = {}, getAllowedProvider
   const cursorAvailable = availability.cursorAvailable ?? false;
   const opencodeAvailable = availability.opencodeAvailable ?? false;
   const availableProviders = getAvailableRelayProviders(availability);
-  const providerEnum = z4.enum(availableProviders);
+  const providerEnum = z5.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)
@@ -13375,18 +13439,18 @@ The tool blocks until the subagent completes and returns its final response.
 You will also receive the chatId so you can send follow-up messages or clean up the chat.`,
     {
       provider: providerEnum.describe(providerDesc),
-      prompt: z4.string().describe("The full prompt/instructions for the subagent. Be detailed - it has no context from your conversation."),
-      model: z4.string().optional().describe([
+      prompt: z5.string().describe("The full prompt/instructions for the subagent. Be detailed - it has no context from your conversation."),
+      model: z5.string().optional().describe([
         `Model override. Claude: ${AGENT_MODELS.claude.join(", ")} (opus is the default; sonnet is faster).`,
         codexAvailable ? `Codex: ${AGENT_MODELS.codex.join(", ")}.` : null,
         cursorAvailable ? `Cursor: ${AGENT_MODELS.cursor.join(", ")}.` : null,
         opencodeAvailable ? `Opencode: ${AGENT_MODELS.opencode.join(", ")}.` : null
       ].filter(Boolean).join(" ")),
-      thinking_level: z4.enum(VALID_THINKING_LEVELS).optional().describe(
+      thinking_level: z5.enum(VALID_THINKING_LEVELS).optional().describe(
         "Controls how much thinking/reasoning the subagent applies. low = light thinking, medium = moderate, high = deep reasoning, xhigh = extended effort, max = maximum effort, ultra = Codex ultra, ultracode = Claude Code dynamic workflows. Defaults: Claude = high, Codex = medium, Cursor = medium, Opencode = medium."
       ),
-      title: z4.string().optional().describe("Optional title for the subagent chat (for identification)."),
-      timeout_minutes: z4.number().positive().optional().describe("Timeout in minutes for the subagent to complete (default: 10). Set higher for large tasks to avoid losing work.")
+      title: z5.string().optional().describe("Optional title for the subagent chat (for identification)."),
+      timeout_minutes: z5.number().positive().optional().describe("Timeout in minutes for the subagent to complete (default: 10). Set higher for large tasks to avoid losing work.")
     },
     async (args) => {
       try {
@@ -13461,13 +13525,13 @@ var messageAgentTool = tool(
 
 The tool blocks until the subagent completes and returns its response.`,
   {
-    chatId: z4.string().describe("The chat ID of the subagent (returned by spawn_agent)."),
-    message: z4.string().describe("The follow-up message to send."),
-    model: z4.string().optional().describe("Optional model override for this message."),
-    thinking_level: z4.enum(VALID_THINKING_LEVELS).optional().describe(
+    chatId: z5.string().describe("The chat ID of the subagent (returned by spawn_agent)."),
+    message: z5.string().describe("The follow-up message to send."),
+    model: z5.string().optional().describe("Optional model override for this message."),
+    thinking_level: z5.enum(VALID_THINKING_LEVELS).optional().describe(
       "Controls how much thinking/reasoning the subagent applies. low = light thinking, medium = moderate, high = deep reasoning, xhigh = extended effort, max = maximum effort, ultra = Codex ultra, ultracode = Claude Code dynamic workflows. Defaults: Claude = high, Codex = medium, Cursor = medium, Opencode = medium."
     ),
-    timeout_minutes: z4.number().positive().optional().describe("Timeout in minutes for the subagent to complete (default: 10). Set higher for large tasks to avoid losing work.")
+    timeout_minutes: z5.number().positive().optional().describe("Timeout in minutes for the subagent to complete (default: 10). Set higher for large tasks to avoid losing work.")
   },
   async (args) => {
     try {
@@ -13505,7 +13569,7 @@ var deleteAgentTool = tool(
   "delete_agent",
   `Delete a subagent chat to free resources. Use this after a subagent has completed its work and you no longer need to send it follow-up messages.`,
   {
-    chatId: z4.string().describe("The chat ID of the subagent to delete.")
+    chatId: z5.string().describe("The chat ID of the subagent to delete.")
   },
   async (args) => {
     try {
@@ -15331,7 +15395,7 @@ var RepoFileService = class {
 
 // src/v1-routes.ts
 import { Hono } from "hono";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 import { readdir as readdir9, stat as stat5, readFile as readFile18 } from "fs/promises";
 import { join as join26, resolve as resolve3 } from "path";
 
@@ -15839,75 +15903,75 @@ var TerminalService = class {
 var terminalService = new TerminalService();
 
 // src/v1-routes.ts
-var setWorkspaceNameSchema = z5.object({
-  name: z5.string().min(1).max(48)
+var setWorkspaceNameSchema = z6.object({
+  name: z6.string().min(1).max(48)
 });
-var imageMediaTypeSchema = z5.enum(IMAGE_MEDIA_TYPES);
-var createPreviewSchema = z5.object({
-  port: z5.number().int().min(1).max(65535),
-  publicUrl: z5.string().min(1)
+var imageMediaTypeSchema = z6.enum(IMAGE_MEDIA_TYPES);
+var createPreviewSchema = z6.object({
+  port: z6.number().int().min(1).max(65535),
+  publicUrl: z6.string().min(1)
 });
-var terminalSizeSchema = z5.object({
-  cols: z5.number().int().min(2).max(500),
-  rows: z5.number().int().min(1).max(200)
+var terminalSizeSchema = z6.object({
+  cols: z6.number().int().min(2).max(500),
+  rows: z6.number().int().min(1).max(200)
 });
-var writeTerminalSessionSchema = z5.object({
-  data: z5.string().max(64 * 1024),
-  generation: z5.number().int().nonnegative(),
-  sequence: z5.number().int().nonnegative()
+var writeTerminalSessionSchema = z6.object({
+  data: z6.string().max(64 * 1024),
+  generation: z6.number().int().nonnegative(),
+  sequence: z6.number().int().nonnegative()
 });
-var sendMessageSchema = z5.object({
-  messageId: z5.string().min(1).optional(),
-  submittedAt: z5.string().datetime().optional(),
-  message: z5.string().min(1),
-  model: z5.string().optional(),
-  customInstructions: z5.string().optional(),
-  planMode: z5.boolean().optional(),
-  images: z5.array(z5.object({
-    type: z5.literal("image"),
-    source: z5.union([
-      z5.object({
-        type: z5.literal("base64"),
+var sendMessageSchema = z6.object({
+  messageId: z6.string().min(1).optional(),
+  submittedAt: z6.string().datetime().optional(),
+  message: z6.string().min(1),
+  model: z6.string().optional(),
+  customInstructions: z6.string().optional(),
+  planMode: z6.boolean().optional(),
+  images: z6.array(z6.object({
+    type: z6.literal("image"),
+    source: z6.union([
+      z6.object({
+        type: z6.literal("base64"),
         media_type: imageMediaTypeSchema,
-        data: z5.string().min(1)
+        data: z6.string().min(1)
       }),
-      z5.object({
-        type: z5.literal("url"),
-        url: z5.string().url()
+      z6.object({
+        type: z6.literal("url"),
+        url: z6.string().url()
       })
     ])
   })).optional(),
-  thinkingLevel: z5.enum(VALID_THINKING_LEVELS).optional(),
-  goalMode: z5.boolean().optional(),
-  fastMode: z5.boolean().optional(),
-  enableInteractiveTools: z5.boolean().optional(),
-  type: z5.string().min(1).optional(),
-  merge: z5.boolean().optional(),
-  idempotencyKey: z5.string().min(1).max(128).optional(),
-  senderUserId: z5.string().optional(),
-  senderEmail: z5.string().optional(),
-  senderDisplayName: z5.string().optional(),
-  senderAvatarUrl: z5.string().optional(),
-  errorNotificationTarget: z5.discriminatedUnion("type", [
-    z5.object({ type: z5.literal("slack") }),
-    z5.object({ type: z5.literal("linear"), sessionId: z5.string().min(1) }),
-    z5.object({
-      type: z5.literal("code_host"),
-      provider: z5.enum(["github", "gitlab"]),
-      resource: z5.enum(["issue", "pull_request"]),
-      repositoryId: z5.string().min(1),
-      resourceNumber: z5.number().int().positive()
+  thinkingLevel: z6.enum(VALID_THINKING_LEVELS).optional(),
+  goalMode: z6.boolean().optional(),
+  fastMode: z6.boolean().optional(),
+  enableInteractiveTools: z6.boolean().optional(),
+  type: z6.string().min(1).optional(),
+  merge: z6.boolean().optional(),
+  idempotencyKey: z6.string().min(1).max(128).optional(),
+  senderUserId: z6.string().optional(),
+  senderEmail: z6.string().optional(),
+  senderDisplayName: z6.string().optional(),
+  senderAvatarUrl: z6.string().optional(),
+  errorNotificationTarget: z6.discriminatedUnion("type", [
+    z6.object({ type: z6.literal("slack") }),
+    z6.object({ type: z6.literal("linear"), sessionId: z6.string().min(1) }),
+    z6.object({
+      type: z6.literal("code_host"),
+      provider: z6.enum(["github", "gitlab"]),
+      resource: z6.enum(["issue", "pull_request"]),
+      repositoryId: z6.string().min(1),
+      resourceNumber: z6.number().int().positive()
     }),
-    z5.object({ type: z5.literal("automation"), executionId: z5.string().min(1) })
+    z6.object({ type: z6.literal("automation"), executionId: z6.string().min(1) })
   ]).optional()
 });
-var respondToolInputSchema = z5.object({
-  requestId: z5.string().min(1),
-  selectionId: z5.string().min(1)
+var respondToolInputSchema = z6.object({
+  requestId: z6.string().min(1),
+  selectionId: z6.string().min(1)
 });
-var updateGoalSchema = z5.object({
-  objective: z5.string().trim().min(1).max(MAX_CODEX_GOAL_OBJECTIVE_CHARS).optional(),
-  status: z5.enum(["active", "paused"]).optional()
+var updateGoalSchema = z6.object({
+  objective: z6.string().trim().min(1).max(MAX_CODEX_GOAL_OBJECTIVE_CHARS).optional(),
+  status: z6.enum(["active", "paused"]).optional()
 }).refine((body) => body.objective !== void 0 || body.status !== void 0, {
   message: "Goal objective or status required"
 });
@@ -16098,7 +16162,7 @@ function createV1Routes(deps) {
       const result = await deps.chatService.updateGoal(c.req.param("chatId"), body);
       return c.json(result);
     } catch (error) {
-      if (error instanceof z5.ZodError) {
+      if (error instanceof z6.ZodError) {
         return c.json(jsonError(error.issues[0]?.message || "Invalid goal update"), 400);
       }
       if (error instanceof ChatNotFoundError) {

package/package.json

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