@pi-unipi/ralph 2.4.0 → 2.4.2

package/index.ts

@@ -145,8 +145,11 @@ export default function (pi: ExtensionAPI) {
     }
   });
 
-  // Inject ralph instructions when loop is active
-  pi.on("before_agent_start", async (event, ctx) => {
+  // Inject ralph instructions when loop is active.
+  // NOTE: injected as a hidden tail message (not the system prompt) so the
+  // cacheable prefix (system prompt + prior history) stays byte-stable across
+  // turns. The iteration number changes every turn and must never touch the prefix.
+  pi.on("before_agent_start", async (_event, ctx) => {
     const mgr = getManager(ctx, pi);
     const currentLoop = mgr.getCurrentLoop();
     if (!currentLoop) return;
@@ -165,9 +168,11 @@ export default function (pi: ExtensionAPI) {
     instructions += `- Otherwise, call ralph_done tool to proceed to next iteration`;
 
     return {
-      systemPrompt:
-        event.systemPrompt +
-        `\n[RALPH LOOP - ${state.name} - Iteration ${iterStr}]\n\n${instructions}`,
+      message: {
+        customType: "unipi-ralph-loop-reminder",
+        content: `[RALPH LOOP - ${state.name} - Iteration ${iterStr}]\n\n${instructions}`,
+        display: false,
+      },
     };
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ralph",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "Long-running iterative development loops for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -27,8 +27,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.4.0",
-    "@pi-unipi/info-screen": "2.4.0"
+    "@pi-unipi/core": "2.4.1",
+    "@pi-unipi/info-screen": "2.4.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.80.0",

package/ralph-loop.ts

@@ -374,6 +374,8 @@ export class RalphLoopManager {
       return null;
     }
 
+    this.emitIterationDone(state);
+
     const needsReflection =
       state.reflectEvery > 0 && (state.iteration - 1) % state.reflectEvery === 0;
     if (needsReflection) state.lastReflectionAt = state.iteration;
@@ -384,6 +386,14 @@ export class RalphLoopManager {
     return { state, needsReflection };
   }
 
+  private emitIterationDone(state: LoopState): void {
+    this.emitFn(UNIPI_EVENTS.RALPH_ITERATION_DONE, {
+      name: state.name,
+      iteration: state.iteration - 1,
+      nextIteration: state.iteration,
+    });
+  }
+
   archiveLoop(name: string): boolean {
     const state = this.loadState(name);
     if (!state) return false;