@pi-unipi/unipi 2.4.0 → 2.4.1

package/CHANGELOG.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.4.1] — 2026-08-13
+
+### Fixed
+
+- **`ralph`: loop status no longer invalidates the DeepSeek prefix cache.** The `before_agent_start` hook appended `[RALPH LOOP - name - Iteration N]` to the system prompt on every turn; because the iteration number changes each turn, this mutated the request prefix on every turn of a Ralph loop, forcing a full DeepSeek prefix-cache miss (~60K tokens re-billed at uncached price) per turn. The loop status now rides a hidden tail message (`unipi-ralph-loop-reminder`) so the cacheable prefix (system prompt + prior history) stays byte-stable across turns. The model still sees the loop name, iteration, and instructions.
+
 ## [2.4.0] — 2026-08-09
 
 Image generation no longer requires an OpenRouter account, and `image_generate` can now edit an existing image.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -80,7 +80,7 @@
     "@pi-unipi/info-screen": "2.4.0",
     "@pi-unipi/mcp": "2.4.0",
     "@pi-unipi/memory": "2.4.0",
-    "@pi-unipi/ralph": "2.4.0",
+    "@pi-unipi/ralph": "2.4.1",
     "@pi-unipi/subagents": "2.4.0",
     "@pi-unipi/utility": "2.4.0",
     "@pi-unipi/milestone": "2.4.0",

package/packages/ralph/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/packages/ralph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ralph",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Long-running iterative development loops for Pi coding agent",
   "type": "module",
   "main": "index.ts",

package/packages/unipi/bundled.js

@@ -7743,7 +7743,7 @@ function ralph_default(pi) {
       );
     }
   });
-  pi.on("before_agent_start", async (event, ctx) => {
+  pi.on("before_agent_start", async (_event, ctx) => {
     const mgr = getManager(ctx, pi);
     const currentLoop = mgr.getCurrentLoop();
     if (!currentLoop) return;
@@ -7762,10 +7762,13 @@ function ralph_default(pi) {
 `;
     instructions += `- Otherwise, call ralph_done tool to proceed to next iteration`;
     return {
-      systemPrompt: event.systemPrompt + `
-[RALPH LOOP - ${state.name} - Iteration ${iterStr}]
+      message: {
+        customType: "unipi-ralph-loop-reminder",
+        content: `[RALPH LOOP - ${state.name} - Iteration ${iterStr}]
 
-${instructions}`
+${instructions}`,
+        display: false
+      }
     };
   });
   pi.on("session_shutdown", async (_event, ctx) => {