replicas-engine 0.1.18 → 0.1.20

package/dist/src/index.js

@@ -4,7 +4,7 @@
 import "dotenv/config";
 import { serve } from "@hono/node-server";
 import { Hono as Hono3 } from "hono";
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 import { execSync as execSync2 } from "child_process";
 
 // src/middleware/auth.ts
@@ -608,6 +608,7 @@ var CodexManager = class {
   currentThread = null;
   workingDirectory;
   messageQueue;
+  baseSystemPrompt;
   constructor(workingDirectory) {
     this.codex = new Codex();
     if (workingDirectory) {
@@ -640,6 +641,19 @@ var CodexManager = class {
   getQueueStatus() {
     return this.messageQueue.getStatus();
   }
+  /**
+   * Set the base system prompt from replicas.json
+   * This will be combined with any custom instructions passed to individual messages
+   */
+  setBaseSystemPrompt(prompt) {
+    this.baseSystemPrompt = prompt;
+  }
+  /**
+   * Get the current base system prompt
+   */
+  getBaseSystemPrompt() {
+    return this.baseSystemPrompt;
+  }
   /**
    * Legacy sendMessage method - now uses the queue internally
    * @deprecated Use enqueueMessage for better control over queue status
@@ -668,8 +682,16 @@ var CodexManager = class {
             sandboxMode: "danger-full-access",
             model: model || "gpt-5.1-codex"
           });
-          if (customInstructions) {
-            message = customInstructions + "\n" + message;
+          let combinedInstructions;
+          if (this.baseSystemPrompt && customInstructions) {
+            combinedInstructions = `${this.baseSystemPrompt}
+
+${customInstructions}`;
+          } else {
+            combinedInstructions = this.baseSystemPrompt || customInstructions;
+          }
+          if (combinedInstructions) {
+            message = combinedInstructions + "\n" + message;
           }
           const { events: events2 } = await this.currentThread.runStreamed("Hello");
           for await (const event of events2) {
@@ -945,6 +967,7 @@ var ClaudeManager = class {
   sessionId = null;
   initialized;
   messageQueue;
+  baseSystemPrompt;
   constructor(workingDirectory) {
     if (workingDirectory) {
       this.workingDirectory = workingDirectory;
@@ -979,6 +1002,19 @@ var ClaudeManager = class {
   getQueueStatus() {
     return this.messageQueue.getStatus();
   }
+  /**
+   * Set the base system prompt from replicas.json
+   * This will be combined with any custom instructions passed to individual messages
+   */
+  setBaseSystemPrompt(prompt) {
+    this.baseSystemPrompt = prompt;
+  }
+  /**
+   * Get the current base system prompt
+   */
+  getBaseSystemPrompt() {
+    return this.baseSystemPrompt;
+  }
   /**
    * Legacy sendMessage method - now uses the queue internally
    * @deprecated Use enqueueMessage for better control over queue status
@@ -1014,6 +1050,14 @@ var ClaudeManager = class {
       const promptIterable = (async function* () {
         yield userMessage;
       })();
+      let combinedInstructions;
+      if (this.baseSystemPrompt && customInstructions) {
+        combinedInstructions = `${this.baseSystemPrompt}
+
+${customInstructions}`;
+      } else {
+        combinedInstructions = this.baseSystemPrompt || customInstructions;
+      }
       const response = query({
         prompt: promptIterable,
         options: {
@@ -1025,7 +1069,7 @@ var ClaudeManager = class {
           systemPrompt: {
             type: "preset",
             preset: "claude_code",
-            append: customInstructions
+            append: combinedInstructions
           },
           env: process.env,
           model: model || "opus"
@@ -1568,6 +1612,148 @@ async function initializeGitRepository() {
   }
 }
 
+// src/services/replicas-config.ts
+import { readFile as readFile2 } from "fs/promises";
+import { existsSync as existsSync2 } from "fs";
+import { join as join3 } from "path";
+import { homedir as homedir3 } from "os";
+import { exec } from "child_process";
+import { promisify } from "util";
+var execAsync = promisify(exec);
+var ReplicasConfigService = class {
+  config = null;
+  workingDirectory;
+  hooksExecuted = false;
+  constructor() {
+    const repoName = process.env.REPLICAS_REPO_NAME;
+    const workspaceHome = process.env.WORKSPACE_HOME || process.env.HOME || homedir3();
+    if (repoName) {
+      this.workingDirectory = join3(workspaceHome, "workspaces", repoName);
+    } else {
+      this.workingDirectory = workspaceHome;
+    }
+  }
+  /**
+   * Initialize the service by reading replicas.json and executing start hooks
+   */
+  async initialize() {
+    await this.loadConfig();
+    await this.executeStartHooks();
+  }
+  /**
+   * Load and parse the replicas.json config file
+   */
+  async loadConfig() {
+    const configPath = join3(this.workingDirectory, "replicas.json");
+    if (!existsSync2(configPath)) {
+      console.log("No replicas.json found in workspace directory");
+      this.config = null;
+      return;
+    }
+    try {
+      const data = await readFile2(configPath, "utf-8");
+      const config = JSON.parse(data);
+      if (config.copy && !Array.isArray(config.copy)) {
+        throw new Error('Invalid replicas.json: "copy" must be an array of file paths');
+      }
+      if (config.ports && !Array.isArray(config.ports)) {
+        throw new Error('Invalid replicas.json: "ports" must be an array of port numbers');
+      }
+      if (config.ports && !config.ports.every((p) => typeof p === "number")) {
+        throw new Error("Invalid replicas.json: all ports must be numbers");
+      }
+      if (config.systemPrompt && typeof config.systemPrompt !== "string") {
+        throw new Error('Invalid replicas.json: "systemPrompt" must be a string');
+      }
+      if (config.startHook) {
+        if (typeof config.startHook !== "object" || Array.isArray(config.startHook)) {
+          throw new Error('Invalid replicas.json: "startHook" must be an object with "commands" array');
+        }
+        if (!Array.isArray(config.startHook.commands)) {
+          throw new Error('Invalid replicas.json: "startHook.commands" must be an array of shell commands');
+        }
+        if (!config.startHook.commands.every((cmd) => typeof cmd === "string")) {
+          throw new Error("Invalid replicas.json: all startHook.commands entries must be strings");
+        }
+        if (config.startHook.timeout !== void 0 && (typeof config.startHook.timeout !== "number" || config.startHook.timeout <= 0)) {
+          throw new Error('Invalid replicas.json: "startHook.timeout" must be a positive number');
+        }
+      }
+      this.config = config;
+      console.log("Loaded replicas.json config:", {
+        hasSystemPrompt: !!config.systemPrompt,
+        startHookCount: config.startHook?.commands.length ?? 0
+      });
+    } catch (error) {
+      if (error instanceof SyntaxError) {
+        console.error("Failed to parse replicas.json:", error.message);
+      } else if (error instanceof Error) {
+        console.error("Error loading replicas.json:", error.message);
+      }
+      this.config = null;
+    }
+  }
+  /**
+   * Execute all start hooks defined in replicas.json
+   */
+  async executeStartHooks() {
+    if (this.hooksExecuted) {
+      console.log("Start hooks already executed, skipping");
+      return;
+    }
+    const startHookConfig = this.config?.startHook;
+    if (!startHookConfig || startHookConfig.commands.length === 0) {
+      this.hooksExecuted = true;
+      return;
+    }
+    const timeout = startHookConfig.timeout ?? 3e5;
+    const hooks = startHookConfig.commands;
+    console.log(`Executing ${hooks.length} start hook(s) with timeout ${timeout}ms...`);
+    for (const hook of hooks) {
+      try {
+        console.log(`Running start hook: ${hook}`);
+        const { stdout, stderr } = await execAsync(hook, {
+          cwd: this.workingDirectory,
+          timeout,
+          env: process.env
+        });
+        if (stdout) {
+          console.log(`[${hook}] stdout:`, stdout);
+        }
+        if (stderr) {
+          console.warn(`[${hook}] stderr:`, stderr);
+        }
+        console.log(`Start hook completed: ${hook}`);
+      } catch (error) {
+        if (error instanceof Error) {
+          console.error(`Start hook failed: ${hook}`, error.message);
+        }
+      }
+    }
+    this.hooksExecuted = true;
+    console.log("All start hooks completed");
+  }
+  /**
+   * Get the system prompt from replicas.json
+   */
+  getSystemPrompt() {
+    return this.config?.systemPrompt;
+  }
+  /**
+   * Get the full config object
+   */
+  getConfig() {
+    return this.config;
+  }
+  /**
+   * Check if start hooks have been executed
+   */
+  hasExecutedHooks() {
+    return this.hooksExecuted;
+  }
+};
+var replicasConfigService = new ReplicasConfigService();
+
 // src/index.ts
 var READY_MESSAGE = "========= REPLICAS WORKSPACE READY ==========";
 var COMPLETION_MESSAGE = "========= REPLICAS WORKSPACE INITIALIZATION COMPLETE ==========";
@@ -1583,7 +1769,7 @@ function checkActiveSSHSessions() {
 var app = new Hono3();
 app.get("/health", async (c) => {
   try {
-    const logContent = await readFile2("/var/log/cloud-init-output.log", "utf-8");
+    const logContent = await readFile3("/var/log/cloud-init-output.log", "utf-8");
     let status;
     if (logContent.includes(COMPLETION_MESSAGE)) {
       status = "active";
@@ -1648,6 +1834,13 @@ serve(
     } else {
       console.warn(`Git initialization warning: ${gitResult.error}`);
     }
+    await replicasConfigService.initialize();
+    const systemPrompt = replicasConfigService.getSystemPrompt();
+    if (systemPrompt) {
+      claudeManager.setBaseSystemPrompt(systemPrompt);
+      codexManager.setBaseSystemPrompt(systemPrompt);
+      console.log("Applied system prompt from replicas.json to Claude and Codex managers");
+    }
     await githubTokenManager.start();
     await claudeTokenManager.start();
     await codexTokenManager.start();

package/package.json

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