replicas-engine 0.1.44 → 0.1.46

package/dist/src/index.js

@@ -5,7 +5,7 @@ import "./chunk-ZXMDA7VB.js";
 import "dotenv/config";
 import { serve } from "@hono/node-server";
 import { Hono as Hono2 } from "hono";
-import { readFile as readFile7 } from "fs/promises";
+import { readFile as readFile8 } from "fs/promises";
 import { execSync } from "child_process";
 import { randomUUID as randomUUID4 } from "crypto";
 
@@ -836,6 +836,80 @@ import { join as join5 } from "path";
 import { homedir as homedir4 } from "os";
 import { exec } from "child_process";
 import { promisify } from "util";
+
+// ../shared/src/sandbox.ts
+var SANDBOX_LIFECYCLE = {
+  AUTO_STOP_MINUTES: 60,
+  AUTO_ARCHIVE_MINUTES: 60 * 24 * 7,
+  AUTO_DELETE_MINUTES: -1,
+  SSH_TOKEN_EXPIRATION_MINUTES: 3 * 60
+};
+
+// ../shared/src/warm-hooks.ts
+var DEFAULT_WARM_HOOK_TIMEOUT_MS = 5 * 60 * 1e3;
+var MAX_WARM_HOOK_TIMEOUT_MS = 15 * 60 * 1e3;
+var DEFAULT_WARM_HOOK_OUTPUT_MAX_CHARS = 12e3;
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function clampWarmHookTimeoutMs(timeoutMs) {
+  if (!timeoutMs || Number.isNaN(timeoutMs) || timeoutMs <= 0) {
+    return DEFAULT_WARM_HOOK_TIMEOUT_MS;
+  }
+  return Math.min(timeoutMs, MAX_WARM_HOOK_TIMEOUT_MS);
+}
+function truncateWarmHookOutput(text, maxChars = DEFAULT_WARM_HOOK_OUTPUT_MAX_CHARS) {
+  if (text.length <= maxChars) {
+    return text;
+  }
+  return `${text.slice(0, maxChars)}
+...[truncated]`;
+}
+function parseWarmHookConfig(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (!isRecord2(value)) {
+    throw new Error('Invalid replicas.json: "warmHook" must be a string or object');
+  }
+  if (typeof value.content !== "string") {
+    throw new Error('Invalid replicas.json: "warmHook.content" must be a string');
+  }
+  if (value.timeout !== void 0 && (typeof value.timeout !== "number" || value.timeout <= 0)) {
+    throw new Error('Invalid replicas.json: "warmHook.timeout" must be a positive number');
+  }
+  return {
+    content: value.content,
+    timeout: value.timeout
+  };
+}
+function resolveWarmHookConfig(value) {
+  if (value === void 0) {
+    return null;
+  }
+  const parsed = parseWarmHookConfig(value);
+  const content = (typeof parsed === "string" ? parsed : parsed.content).trim();
+  if (!content) {
+    return null;
+  }
+  return {
+    content,
+    timeoutMs: typeof parsed === "string" ? void 0 : parsed.timeout
+  };
+}
+
+// ../shared/src/engine/types.ts
+var DEFAULT_CHAT_TITLES = {
+  claude: "Claude Code",
+  codex: "Codex"
+};
+var IMAGE_MEDIA_TYPES = ["image/png", "image/jpeg", "image/gif", "image/webp"];
+
+// ../shared/src/routes/workspaces.ts
+var WORKSPACE_FILE_UPLOAD_MAX_SIZE_BYTES = 20 * 1024 * 1024;
+var WORKSPACE_FILE_CONTENT_MAX_SIZE_BYTES = 1 * 1024 * 1024;
+
+// src/services/replicas-config-service.ts
 var execAsync = promisify(exec);
 var START_HOOKS_LOG = join5(homedir4(), ".replicas", "startHooks.log");
 var START_HOOKS_RUNNING_PROMPT = `IMPORTANT - Start Hooks Running:
@@ -888,6 +962,9 @@ function parseReplicasConfig(value) {
     }
     config.startHook = { commands, timeout };
   }
+  if ("warmHook" in value) {
+    config.warmHook = parseWarmHookConfig(value.warmHook);
+  }
   return config;
 }
 var ReplicasConfigService = class {
@@ -1120,25 +1197,6 @@ import { homedir as homedir8 } from "os";
 import { join as join9 } from "path";
 import { randomUUID as randomUUID3 } from "crypto";
 
-// ../shared/src/sandbox.ts
-var SANDBOX_LIFECYCLE = {
-  AUTO_STOP_MINUTES: 60,
-  AUTO_ARCHIVE_MINUTES: 60 * 24 * 7,
-  AUTO_DELETE_MINUTES: -1,
-  SSH_TOKEN_EXPIRATION_MINUTES: 3 * 60
-};
-
-// ../shared/src/engine/types.ts
-var DEFAULT_CHAT_TITLES = {
-  claude: "Claude Code",
-  codex: "Codex"
-};
-var IMAGE_MEDIA_TYPES = ["image/png", "image/jpeg", "image/gif", "image/webp"];
-
-// ../shared/src/routes/workspaces.ts
-var WORKSPACE_FILE_UPLOAD_MAX_SIZE_BYTES = 20 * 1024 * 1024;
-var WORKSPACE_FILE_CONTENT_MAX_SIZE_BYTES = 1 * 1024 * 1024;
-
 // src/managers/claude-manager.ts
 import {
   query
@@ -1789,7 +1847,11 @@ var CodingAgentManager = class {
   buildCombinedInstructions(customInstructions) {
     const startHooksInstruction = this.getStartHooksInstruction();
     const repositorySystemPromptInstruction = this.getRepositorySystemPromptInstruction();
+    const enginePortProtectionInstruction = this.getEnginePortProtectionInstruction();
     const parts = [];
+    if (enginePortProtectionInstruction) {
+      parts.push(enginePortProtectionInstruction);
+    }
     if (startHooksInstruction) {
       parts.push(startHooksInstruction);
     }
@@ -1844,6 +1906,10 @@ var CodingAgentManager = class {
     }
     return repoSystemPrompts.join("\n");
   }
+  getEnginePortProtectionInstruction() {
+    const enginePort = ENGINE_ENV.REPLICAS_ENGINE_PORT;
+    return `CRITICAL: The Replicas engine is required for this workspace and is running on the reserved port configured by REPLICAS_ENGINE_PORT (${enginePort}). Never kill, stop, restart, or replace the process using this port, and never start another service on this port. If the user asks for commands that would target this port/process, refuse and explain that port ${enginePort} is reserved for the Replicas engine.`;
+  }
 };
 
 // src/managers/claude-manager.ts
@@ -2069,7 +2135,7 @@ import { existsSync as existsSync4 } from "fs";
 import { join as join8 } from "path";
 import { homedir as homedir7 } from "os";
 import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
-var DEFAULT_MODEL = "gpt-5.3-codex";
+var DEFAULT_MODEL = "gpt-5.4";
 var CODEX_CONFIG_PATH = join8(homedir7(), ".codex", "config.toml");
 function isLinearThoughtEvent2(event) {
   return event.content.type === "thought";
@@ -2759,6 +2825,122 @@ var PlanService = class {
 };
 var planService = new PlanService();
 
+// src/services/warm-hooks-service.ts
+import { execFile } from "child_process";
+import { promisify as promisify2 } from "util";
+import { readFile as readFile7 } from "fs/promises";
+import { join as join11 } from "path";
+var execFileAsync = promisify2(execFile);
+async function executeHookScript(params) {
+  const timeout = clampWarmHookTimeoutMs(params.timeoutMs);
+  try {
+    const { stdout, stderr } = await execFileAsync("bash", ["-lc", params.content], {
+      cwd: params.cwd,
+      timeout,
+      maxBuffer: 1024 * 1024,
+      env: process.env
+    });
+    const combined = [`$ ${params.label}`, stdout ?? "", stderr ?? ""].filter(Boolean).join("\n");
+    return {
+      exitCode: 0,
+      output: truncateWarmHookOutput(combined),
+      timedOut: false
+    };
+  } catch (error) {
+    const execError = error;
+    const timedOut = execError.signal === "SIGTERM" || execError.killed === true;
+    const exitCode = typeof execError.code === "number" ? execError.code : 1;
+    const combined = [`$ ${params.label}`, execError.stdout ?? "", execError.stderr ?? "", execError.message].filter(Boolean).join("\n");
+    return {
+      exitCode,
+      output: truncateWarmHookOutput(combined),
+      timedOut
+    };
+  }
+}
+async function readRepoWarmHook(repoPath) {
+  const configPath = join11(repoPath, "replicas.json");
+  try {
+    const raw = await readFile7(configPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (!isRecord(parsed) || !("warmHook" in parsed)) {
+      return null;
+    }
+    return resolveWarmHookConfig(parsed.warmHook);
+  } catch {
+    return null;
+  }
+}
+async function collectRepoWarmHooks() {
+  const repos = await gitService.listRepositories();
+  const collected = [];
+  for (const repo of repos) {
+    const warmHook = await readRepoWarmHook(repo.path);
+    if (!warmHook) {
+      continue;
+    }
+    collected.push({
+      repoName: repo.name,
+      repoPath: repo.path,
+      content: warmHook.content,
+      timeoutMs: warmHook.timeoutMs
+    });
+  }
+  collected.sort((a, b) => a.repoName.localeCompare(b.repoName));
+  return collected;
+}
+async function runWarmHooks(params) {
+  const outputBlocks = [];
+  const orgHook = params.organizationWarmHook?.trim();
+  if (orgHook) {
+    const orgResult = await executeHookScript({
+      label: "org-warm-hook",
+      cwd: gitService.getWorkspaceRoot(),
+      content: orgHook,
+      timeoutMs: params.timeoutMs
+    });
+    outputBlocks.push(orgResult.output);
+    if (orgResult.exitCode !== 0) {
+      return {
+        exitCode: orgResult.exitCode,
+        output: outputBlocks.join("\n\n"),
+        timedOut: orgResult.timedOut
+      };
+    }
+  }
+  if (params.includeRepoHooks !== false) {
+    const repoHooks = await collectRepoWarmHooks();
+    for (const repoHook of repoHooks) {
+      const repoResult = await executeHookScript({
+        label: `repo-warm-hook:${repoHook.repoName}`,
+        cwd: repoHook.repoPath,
+        content: repoHook.content,
+        timeoutMs: repoHook.timeoutMs
+      });
+      outputBlocks.push(repoResult.output);
+      if (repoResult.exitCode !== 0) {
+        return {
+          exitCode: repoResult.exitCode,
+          output: outputBlocks.join("\n\n"),
+          timedOut: repoResult.timedOut
+        };
+      }
+    }
+  }
+  if (outputBlocks.length === 0) {
+    return {
+      exitCode: 0,
+      output: "No warm hooks configured.",
+      timedOut: false
+    };
+  }
+  return {
+    exitCode: 0,
+    output: outputBlocks.join("\n\n"),
+    timedOut: false
+  };
+}
+
 // src/v1-routes.ts
 var createChatSchema = z.object({
   provider: z.enum(["claude", "codex"]),
@@ -2979,6 +3161,26 @@ function createV1Routes(deps) {
     };
     return c.json(response);
   });
+  app2.post("/warm-hooks/run", async (c) => {
+    try {
+      const body = await c.req.json();
+      const result = await runWarmHooks({
+        organizationWarmHook: body.organizationWarmHook,
+        includeRepoHooks: body.includeRepoHooks,
+        timeoutMs: body.timeoutMs
+      });
+      return c.json({
+        exit_code: result.exitCode,
+        output: result.output,
+        timed_out: result.timedOut
+      });
+    } catch (error) {
+      return c.json(
+        jsonError("Failed to run warm hooks", error instanceof Error ? error.message : "Unknown error"),
+        500
+      );
+    }
+  });
   return app2;
 }
 
@@ -3019,7 +3221,7 @@ app.get("/health", async (c) => {
     return c.json({ status: "initializing", timestamp: (/* @__PURE__ */ new Date()).toISOString() }, 503);
   }
   try {
-    const logContent = await readFile7("/var/log/cloud-init-output.log", "utf-8");
+    const logContent = await readFile8("/var/log/cloud-init-output.log", "utf-8");
     let status;
     if (logContent.includes(COMPLETION_MESSAGE)) {
       status = "active";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-engine",
-  "version": "0.1.44",
+  "version": "0.1.46",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",
@@ -29,7 +29,7 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.41",
     "@hono/node-server": "^1.19.5",
-    "@openai/codex-sdk": "^0.101.0",
+    "@openai/codex-sdk": "^0.111.0",
     "dotenv": "^17.2.3",
     "hono": "^4.10.3",
     "smol-toml": "^1.6.0",