pi-ultracode 0.7.1 → 0.8.0

package/README.md

@@ -29,7 +29,7 @@ pi --ultracode
 
 > `pi-ultracode` registers a tool named `workflow`. If `pi-dynamic-workflows` is installed, remove it first with `pi remove npm:pi-dynamic-workflows`.
 
-Current releases are tested with Pi 0.84.
+**Pi ≥ 0.86.0**
 
 ## Core features
 

package/README.zh-CN.md

@@ -29,7 +29,7 @@ pi --ultracode
 
 > `pi-ultracode` 会注册名为 `workflow` 的工具。如果已安装 `pi-dynamic-workflows`，请先运行 `pi remove npm:pi-dynamic-workflows`。
 
-当前版本已在 Pi 0.84 上验证。
+需要 Pi 0.86.0 或更高版本。模式提示词通过独立分区更新，不再替换整段系统提示词。
 
 ## 核心特性
 

package/extensions/ultracode.ts

@@ -111,9 +111,9 @@ export default function extension(pi: ExtensionAPI, extraDeps: UltracodeExtensio
   });
 
   pi.on("before_agent_start", async (event) => {
-    // Reconcile tool availability and append the standing policy on every
-    // enforcing turn, even when another active-tool writer caused drift.
+    // Reconcile tool availability and update our prompt section on every turn,
+    // including removal when the mode is off or suspended.
     mode.syncWorkflowTool(pi);
-    return mode.beforeAgentStart(event);
+    mode.beforeAgentStart(event);
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ultracode",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Adaptive semantic-depth workflow orchestration for Pi, with focused, standard, and deep modes, isolated subagents, worktree delivery, structured output, and durable resume.",
   "type": "module",
   "keywords": [
@@ -53,10 +53,10 @@
     "acorn": "^8.11.0"
   },
   "devDependencies": {
-    "@earendil-works/pi-agent-core": "^0.84.0",
-    "@earendil-works/pi-ai": "^0.84.0",
-    "@earendil-works/pi-coding-agent": "^0.84.0",
-    "@earendil-works/pi-tui": "^0.84.0",
+    "@earendil-works/pi-agent-core": "^0.86.0",
+    "@earendil-works/pi-ai": "^0.86.0",
+    "@earendil-works/pi-coding-agent": "^0.86.0",
+    "@earendil-works/pi-tui": "^0.86.0",
     "@types/node": "^24.12.4",
     "typebox": "1.3.7",
     "typescript": "^5.9.3"
@@ -64,7 +64,7 @@
   "peerDependencies": {
     "@earendil-works/pi-agent-core": "*",
     "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-coding-agent": ">=0.86.0",
     "@earendil-works/pi-tui": "*",
     "typebox": "*"
   },

package/src/mode.ts

@@ -184,11 +184,14 @@ export class UltracodeMode {
     return state !== undefined;
   }
 
-  /** Append the configured semantic-depth policy to the turn's system prompt. */
-  beforeAgentStart(event: { systemPrompt: string }): { systemPrompt: string } | undefined {
-    if (!this.isEnforcing() || !isActiveUltracodeMode(this.mode)) return undefined;
-    const block = ultracodeSystemBlock(this.mode);
-    return { systemPrompt: `${event.systemPrompt}\n\n${block}\n\n${ULTRACODE_ACTIVE_REMINDER}` };
+  /** Update only our prompt section so Pi can persist and diff it across turns. */
+  beforeAgentStart(event: { systemPromptOptions: { sections: Record<string, string> } }): void {
+    const { sections } = event.systemPromptOptions;
+    if (!this.isEnforcing() || !isActiveUltracodeMode(this.mode)) {
+      delete sections.ultracode;
+      return;
+    }
+    sections.ultracode = `${ultracodeSystemBlock(this.mode)}\n\n${ULTRACODE_ACTIVE_REMINDER}`;
   }
 
   statusLine(styleLabel: (label: string) => string = (label) => label): string {

package/src/prompts.ts

@@ -6,13 +6,12 @@ import type { ActiveUltracodeMode } from "./depth.ts";
 export const ULTRACODE_TAGLINE = "semantic-depth workflow orchestration";
 
 /**
- * The standing system-prompt block injected on every turn while Ultracode is
- * active. The parent model performs the semantic routing itself; starting a
+ * The standing system-prompt section body (Pi adds the XML wrapper). Injected
+ * on every active turn. The parent model performs semantic routing; starting a
  * separate agent merely to classify depth would defeat the focused path.
  */
 export function ultracodeSystemBlock(mode: ActiveUltracodeMode = "deep"): string {
   return [
-    "<ultracode>",
     `Configured mode: ${mode}.`,
     "Analysis depth is a semantic quality decision, never a wall-clock decision. Do not use elapsed time, deadlines, or duration limits to choose, lower, or stop analysis depth.",
     "Use the smallest depth that can establish a correct answer. Depth is controlled by research rounds, independent perspectives, verification strength, evidence requirements, skeptic count, and per-agent reasoning effort.",
@@ -34,7 +33,6 @@ export function ultracodeSystemBlock(mode: ActiveUltracodeMode = "deep"): string
     "- Avoid a separate synthesis agent when deterministic merging or parent synthesis is enough. Use an adjudicator only when a material conflict remains.",
     "- Select each workflow agent's effort from its task: use a per-call model suffix such as :medium for bounded discovery/synthesis, :high for substantive analysis or implementation, and :max only for deep or decisive high-risk verification. If omitted, the child session uses its normal user/model configuration.",
     "- When a workflow runs, log `analysis-depth: <level> — <reason>` before launching agents, `analysis-escalation: ...` for each semantic escalation, and `analysis-stop: ...` for the final evidence-based stop reason. Never use time as an escalation or stop reason.",
-    "</ultracode>",
   ].join("\n");
 }