replicas-engine 0.1.258 → 0.1.260

package/README.md

@@ -31,10 +31,10 @@ Chats:
 - `POST /chats/:chatId/messages`
 - `POST /chats/:chatId/interrupt`
 
-Plans:
+Canvas:
 
-- `GET /plans`
-- `GET /plans/:filename`
+- `GET /canvas`
+- `GET /canvas/:filename`
 
 Repos and hooks:
 
@@ -93,9 +93,9 @@ Engine persistence locations:
 - `~/.replicas/engine/events.jsonl`
 - `~/.replicas/engine-state.json`
 - `~/.replicas/startHooks.log`
-- Plan read locations (for `/plans` endpoints):
-  - `~/.claude/plans`
-  - `~/.replicas/plans`
+- Canvas read locations (for `/canvas` endpoints):
+  - `~/.claude/plans` (where Claude Code writes its plans)
+  - `~/.replicas/canvas`
 - Health endpoint readiness signal file:
   - `/var/log/cloud-init-output.log` (if missing, `/health` reports `initializing`)
 

package/dist/src/index.js

@@ -127,7 +127,7 @@ function detectLanguageByPath(filePath) {
 
 // ../shared/src/context-usage.ts
 var CODEX_CATEGORY_COLORS = {
-  input: "#66bb6a",
+  input: "#3eeba3",
   output: "#56b6c2"
 };
 function clampPercentage(value) {
@@ -286,7 +286,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-03-v3";
+var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-06-04-v2";
 
 // ../shared/src/runtime-env.ts
 function parsePosixEnvFile(content) {
@@ -1643,6 +1643,7 @@ var DEFAULT_DEFAULT_SKILLS = {
 };
 
 // ../shared/src/prompts.ts
+var MAX_CODEX_GOAL_OBJECTIVE_CHARS = 4e3;
 function parseGoalCommand(message) {
   const match = message.trim().match(/^\/goal(?:\s+([\s\S]*))?$/i);
   const value = match?.[1]?.trim();
@@ -1650,6 +1651,13 @@ function parseGoalCommand(message) {
   if (/^(clear|reset|unset)$/i.test(value)) return { type: "clear" };
   return { type: "set", objective: value };
 }
+function getGoalCommandObjectiveValidationError(message) {
+  const command = parseGoalCommand(message);
+  if (command?.type !== "set") return null;
+  const length = command.objective.length;
+  if (length <= MAX_CODEX_GOAL_OBJECTIVE_CHARS) return null;
+  return `Goal objective must be at most ${MAX_CODEX_GOAL_OBJECTIVE_CHARS} characters (${length} provided). Shorten the /goal objective, or send the extra details as a regular message after setting the goal.`;
+}
 
 // ../shared/src/replicas-config.ts
 import { parse as parseYaml } from "yaml";
@@ -1831,6 +1839,29 @@ var MODEL_LABELS = {
   "gpt-5": "GPT-5"
 };
 var IMAGE_MEDIA_TYPES = ["image/png", "image/jpeg", "image/gif", "image/webp"];
+var CANVAS_KIND_BY_EXTENSION = {
+  ".md": { kind: "markdown", mimeType: "text/markdown; charset=utf-8" },
+  ".markdown": { kind: "markdown", mimeType: "text/markdown; charset=utf-8" },
+  ".html": { kind: "html", mimeType: "text/html; charset=utf-8" },
+  ".htm": { kind: "html", mimeType: "text/html; charset=utf-8" },
+  ".png": { kind: "image", mimeType: "image/png" },
+  ".jpg": { kind: "image", mimeType: "image/jpeg" },
+  ".jpeg": { kind: "image", mimeType: "image/jpeg" },
+  ".gif": { kind: "image", mimeType: "image/gif" },
+  ".webp": { kind: "image", mimeType: "image/webp" },
+  ".svg": { kind: "image", mimeType: "image/svg+xml" },
+  ".mp4": { kind: "video", mimeType: "video/mp4" },
+  ".webm": { kind: "video", mimeType: "video/webm" },
+  ".mov": { kind: "video", mimeType: "video/quicktime" },
+  ".mp3": { kind: "audio", mimeType: "audio/mpeg" },
+  ".wav": { kind: "audio", mimeType: "audio/wav" },
+  ".ogg": { kind: "audio", mimeType: "audio/ogg" }
+};
+function classifyCanvasFilename(filename) {
+  const idx = filename.lastIndexOf(".");
+  const ext = idx === -1 ? "" : filename.slice(idx).toLowerCase();
+  return CANVAS_KIND_BY_EXTENSION[ext] ?? { kind: "other", mimeType: "application/octet-stream" };
+}
 
 // ../shared/src/engine/v1.ts
 var MERGED_MESSAGE_SEPARATOR = "\n\n<!-- replicas:merged -->\n\n";
@@ -6341,7 +6372,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.258";
+var ENGINE_PACKAGE_VERSION = "0.1.260";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";
@@ -9896,60 +9927,88 @@ var RepoFileService = class {
 // src/v1-routes.ts
 import { Hono } from "hono";
 import { z as z2 } from "zod";
-import { readdir as readdir6, stat as stat4, readFile as readFile14 } from "fs/promises";
+import { readdir as readdir6, stat as stat5, readFile as readFile14 } from "fs/promises";
 import { join as join20, resolve as resolve2 } from "path";
 
-// src/services/plan-service.ts
-import { readdir as readdir4, readFile as readFile11 } from "fs/promises";
+// src/services/canvas-service.ts
+import { readdir as readdir4, readFile as readFile11, stat as stat4 } from "fs/promises";
 import { homedir as homedir14 } from "os";
 import { basename, join as join17 } from "path";
-var PLAN_DIRECTORIES = [
+var CANVAS_DIRECTORIES = [
   join17(homedir14(), ".claude", "plans"),
-  join17(homedir14(), ".replicas", "plans")
+  join17(homedir14(), ".replicas", "canvas")
 ];
-function isMarkdownFile(filename) {
-  return filename.toLowerCase().endsWith(".md");
+var MAX_CANVAS_FILE_BYTES = 5 * 1024 * 1024;
+function isTextKind(kind) {
+  return kind === "markdown" || kind === "html";
 }
-function sanitizePlanFilename(filename) {
+function sanitizeFilename(filename) {
   return basename(filename);
 }
-var PlanService = class {
-  async listPlans() {
-    const planNames = /* @__PURE__ */ new Set();
-    for (const directory of PLAN_DIRECTORIES) {
+var CanvasService = class {
+  async listItems() {
+    const items = /* @__PURE__ */ new Map();
+    for (const directory of CANVAS_DIRECTORIES) {
+      let entries;
       try {
-        const entries = await readdir4(directory, { withFileTypes: true });
-        for (const entry of entries) {
-          if (!entry.isFile()) {
-            continue;
-          }
-          if (!isMarkdownFile(entry.name)) {
-            continue;
-          }
-          planNames.add(entry.name);
-        }
+        entries = await readdir4(directory, { withFileTypes: true });
       } catch {
+        continue;
+      }
+      for (const entry of entries) {
+        if (!entry.isFile()) continue;
+        if (entry.name.startsWith(".")) continue;
+        if (items.has(entry.name)) continue;
+        const { kind } = classifyCanvasFilename(entry.name);
+        let sizeBytes = 0;
+        try {
+          const s = await stat4(join17(directory, entry.name));
+          sizeBytes = s.size;
+        } catch {
+          continue;
+        }
+        items.set(entry.name, { filename: entry.name, kind, sizeBytes });
       }
     }
-    return Array.from(planNames).sort((a, b) => a.localeCompare(b));
+    return Array.from(items.values()).sort((a, b) => a.filename.localeCompare(b.filename));
   }
-  async getPlan(filename) {
-    const safeFilename = sanitizePlanFilename(filename);
-    if (!safeFilename || safeFilename !== filename || !isMarkdownFile(safeFilename)) {
-      return null;
-    }
-    for (const directory of PLAN_DIRECTORIES) {
-      const filePath = join17(directory, safeFilename);
+  async getItem(filename) {
+    const safe = sanitizeFilename(filename);
+    if (!safe || safe !== filename || safe.startsWith(".")) return null;
+    const { kind, mimeType } = classifyCanvasFilename(safe);
+    for (const directory of CANVAS_DIRECTORIES) {
+      const filePath = join17(directory, safe);
+      let sizeBytes = 0;
+      try {
+        const s = await stat4(filePath);
+        sizeBytes = s.size;
+      } catch {
+        continue;
+      }
+      if (sizeBytes > MAX_CANVAS_FILE_BYTES) {
+        return {
+          filename: safe,
+          kind,
+          sizeBytes,
+          mimeType,
+          tooLarge: true
+        };
+      }
       try {
-        const content = await readFile11(filePath, "utf-8");
-        return { filename: safeFilename, content };
+        if (isTextKind(kind)) {
+          const content = await readFile11(filePath, "utf-8");
+          return { filename: safe, kind, sizeBytes, mimeType, content };
+        }
+        const buf = await readFile11(filePath);
+        return { filename: safe, kind, sizeBytes, mimeType, base64: buf.toString("base64") };
       } catch {
+        continue;
       }
     }
     return null;
   }
 };
-var planService = new PlanService();
+var canvasService = new CanvasService();
 
 // src/services/warm-hooks-service.ts
 import { spawn as spawn4 } from "child_process";
@@ -10516,6 +10575,10 @@ function createV1Routes(deps) {
   app2.post("/chats/:chatId/messages", async (c) => {
     try {
       const body = sendMessageSchema.parse(await c.req.json());
+      const goalValidationError = getGoalCommandObjectiveValidationError(body.message);
+      if (goalValidationError) {
+        return c.json(jsonError(goalValidationError), 400);
+      }
       const result = await deps.chatService.sendMessage(c.req.param("chatId"), body);
       return c.json(result);
     } catch (error) {
@@ -10636,31 +10699,31 @@ function createV1Routes(deps) {
     }
     return c.json(result);
   });
-  app2.get("/plans", async (c) => {
+  app2.get("/canvas", async (c) => {
     try {
-      const plans = await planService.listPlans();
-      return c.json({ plans });
+      const items = await canvasService.listItems();
+      return c.json({ items });
     } catch (error) {
       return c.json(
-        jsonError("Failed to list plans", error instanceof Error ? error.message : "Unknown error"),
+        jsonError("Failed to list canvas items", error instanceof Error ? error.message : "Unknown error"),
         500
       );
     }
   });
-  app2.get("/plans/:filename", async (c) => {
+  app2.get("/canvas/:filename", async (c) => {
     try {
       const filename = c.req.param("filename");
       if (!filename) {
         return c.json(jsonError("Filename required"), 400);
       }
-      const plan = await planService.getPlan(filename);
-      if (!plan) {
-        return c.json(jsonError("Plan not found"), 404);
+      const item = await canvasService.getItem(filename);
+      if (!item) {
+        return c.json(jsonError("Canvas item not found"), 404);
       }
-      return c.json(plan);
+      return c.json(item);
     } catch (error) {
       return c.json(
-        jsonError("Failed to read plan", error instanceof Error ? error.message : "Unknown error"),
+        jsonError("Failed to read canvas item", error instanceof Error ? error.message : "Unknown error"),
         500
       );
     }
@@ -10974,7 +11037,7 @@ function createV1Routes(deps) {
       const sessions = await Promise.all(
         logFiles.map(async (filename) => {
           const filePath = join20(LOG_DIR, filename);
-          const fileStat = await stat4(filePath);
+          const fileStat = await stat5(filePath);
           const sessionId = filename.replace(/\.log$/, "");
           return {
             sessionId,

package/package.json

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