pi-soul 0.1.2 → 0.2.0

package/README.md

@@ -6,6 +6,8 @@ Write your soul once in markdown, and pi-soul injects it into the system prompt
 
 ## Install
 
+Requires pi 0.86.0 or later.
+
 ```bash
 # from npm
 pi install npm:pi-soul
@@ -56,7 +58,7 @@ With this soul, every new pi session reasons, communicates, and codes like that
 
 ## How it works
 
-A single TypeScript extension listens for pi's `before_agent_start` event and appends your soul to the system prompt under a `# Your Soul` section. No build step, no runtime dependencies — pi loads the TypeScript source directly.
+A single TypeScript extension listens for pi's `before_agent_start` event and adds your soul to the system prompt as a `<soul>` section. Pi records the section in the session. When you edit your soul or run `/soul off`, pi appends the change to the conversation instead of rewriting the system prompt, so models that accept mid-conversation system messages keep their prompt cache. No build step, no runtime dependencies — pi loads the TypeScript source directly.
 
 ## License
 

package/extensions/soul.ts

@@ -2,7 +2,7 @@
  * pi-soul — give your pi agent a soul.
  *
  * A "soul" is a persistent persona/profile written in markdown. When present,
- * it is appended to the system prompt on every turn so the agent's output is
+ * it is added to the system prompt as a <soul> section so the agent's output is
  * tailored to it in every session.
  *
  * Soul resolution (checked fresh on each agent start):
@@ -86,22 +86,19 @@ export default function soulExtension(pi: ExtensionAPI) {
 		updateStatus(ctx);
 	});
 
-	// Inject the soul into the system prompt on every turn.
+	// Add the soul as its own prompt section rather than returning `systemPrompt`.
+	// Pi records sections in the session and sends a later edit or /soul off as an
+	// update. A returned `systemPrompt` replaces the whole prompt on every change
+	// and never reaches the session file.
 	pi.on("before_agent_start", async (event, ctx) => {
 		if (!enabled) return undefined;
 		const soul = resolveSoul(ctx);
 		if (!soul) return undefined;
-		return {
-			systemPrompt: `${event.systemPrompt}
-
-# Your Soul
-
-The user has given you the following soul — a persona and profile you must
+		event.systemPromptOptions.sections.soul = `The user has given you the following soul — a persona and profile you must
 embody. Let it shape your reasoning, tone, and output in every response,
 while still completing every task correctly and accurately.
 
-${soul.content}`,
-		};
+${soul.content}`;
 	});
 
 	pi.registerCommand("soul", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-soul",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Give your pi agent a soul — a persistent persona that tailors every session.",
   "keywords": [
     "pi-package",