pi-herdsman 0.21.1 → 0.21.2

package/dist/index.js

@@ -1,7 +1,7 @@
 // extension/index.ts
 import { contentText as contentText5 } from "@earendil-works/pi-ai";
 import {
-  buildSessionProjection as buildSessionProjection2,
+  buildSessionProjection as buildSessionProjection3,
   DynamicBorder,
   getAgentDir as getAgentDir4,
   getSelectListTheme as getSelectListTheme2,
@@ -15,7 +15,7 @@ import { fileURLToPath as fileURLToPath2 } from "node:url";
 // package.json
 var package_default = {
   name: "pi-herdsman",
-  version: "0.21.1",
+  version: "0.21.2",
   type: "module",
   description: "Asynchronous Pi subagents and agent fleet orchestration for parallel coding agents with nested delegation, background work, and supervision in herdr.",
   license: "Apache-2.0",
@@ -3815,6 +3815,7 @@ async function rollbackHerdrStart(pi, ctx, started, signal) {
 // extension/managed-agent-runtime.ts
 import { isAbsolute as isAbsolute4, resolve as resolve5 } from "node:path";
 import { realpathSync as realpathSync4 } from "node:fs";
+import { buildSessionProjection as buildSessionProjection2 } from "@earendil-works/pi-coding-agent";
 import { contentText as contentText3 } from "@earendil-works/pi-ai";
 
 // extension/agent-controller.ts
@@ -13699,6 +13700,7 @@ var AGENT_LABEL_PATTERN2 = /^[a-z][a-z0-9_-]{0,31}$/;
 var RESERVED_PREFIX = "__PI_HERDSMAN_AGENT_V5__:";
 var AGENT_CONTEXT_RETIRED_ENTRY = "pi-herdsman-agent-context-retired";
 var CONTEXT_RETIREMENT_INSTRUCTION = "Context pressure has retired this session. Do not start new work or new agents. Finish the current coherent operation at the next safe point. Avoid nonessential tool calls and validation; perform only what is needed for a reliable handoff. Resolve already-running dependent work, then complete this assignment with a self-contained handoff covering completed work, current state, relevant files, validation performed, unresolved issues, and exact next steps. This session will not be continued or forked.";
+var CONTEXT_RETIREMENT_REMINDER = "This session is retired. Do not start new work or agents. Finish the current assignment and return a self-contained handoff.";
 function createManagedAgentExecutionState() {
   return {
     assignment: void 0,
@@ -14901,10 +14903,6 @@ This is the session-start definition snapshot. Use agent_list for live Agent sta
       }
     })
   );
-  registerManagedAgentContextHandlers(pi, {
-    contextRetirementEnabled: () => readConfig().contextRetirement,
-    hasActiveAssignment: () => !!execution.assignment?.activeRequestId
-  });
   const prepareDelegatingRoster = async (ctx) => {
     startupDefinitionRoster = void 0;
     if (!delegationEnabled) return;
@@ -15031,6 +15029,10 @@ This is the session-start definition snapshot. Use agent_list for live Agent sta
       controller.shutdown();
     }
   });
+  registerManagedAgentContextHandlers(pi, {
+    contextRetirementEnabled: () => readConfig().contextRetirement,
+    hasActiveAssignment: () => !!execution.assignment?.activeRequestId
+  });
 }
 function createManagedAgentRequestState(pi, options) {
   let requestPumpErrorReported = false;
@@ -15197,7 +15199,13 @@ function sessionContextRetired(entries, sessionId) {
     (entry) => entry?.type === "custom" && entry.customType === AGENT_CONTEXT_RETIRED_ENTRY && entry.data?.sessionId === sessionId
   );
 }
+function sessionRetirementGuidanceVisible(ctx, sessionId) {
+  return buildSessionProjection2(ctx.sessionManager.getBranch()).entries.some(
+    ({ sourceEntry, messages }) => sourceEntry.type === "custom_message" && sourceEntry.customType === AGENT_CONTEXT_RETIRED_ENTRY && sourceEntry.details?.sessionId === sessionId && messages.length > 0
+  );
+}
 function registerManagedAgentContextHandlers(pi, options) {
+  let overflowRetryGuidance;
   pi.on(
     "session_before_compact",
     (event, ctx) => {
@@ -15206,24 +15214,46 @@ function registerManagedAgentContextHandlers(pi, options) {
       if (event.reason === "manual") return;
       const sessionId = ctx.sessionManager.getSessionId();
       const entries = ctx.sessionManager.getEntries();
-      if (!sessionContextRetired(entries, sessionId))
-        pi.appendEntry(AGENT_CONTEXT_RETIRED_ENTRY, { sessionId });
+      const retired = sessionContextRetired(entries, sessionId);
+      const guided = sessionRetirementGuidanceVisible(ctx, sessionId);
+      let guidance;
+      if (!retired) pi.appendEntry(AGENT_CONTEXT_RETIRED_ENTRY, { sessionId });
+      if (!guided) guidance = CONTEXT_RETIREMENT_INSTRUCTION;
+      else if (event.reason === "overflow")
+        guidance = CONTEXT_RETIREMENT_REMINDER;
+      if (guidance) {
+        pi.sendMessage(
+          {
+            customType: AGENT_CONTEXT_RETIRED_ENTRY,
+            content: guidance,
+            display: false,
+            details: { sessionId }
+          },
+          { triggerTurn: false }
+        );
+        if (event.reason === "overflow" && event.willRetry)
+          overflowRetryGuidance = guidance;
+      }
       if (event.reason === "threshold") return { cancel: true };
     }
   );
-  pi.on("context", (event, ctx) => {
-    if (!options.contextRetirementEnabled()) return;
-    if (!options.hasActiveAssignment()) return;
-    const sessionId = ctx.sessionManager.getSessionId();
-    if (!sessionContextRetired(ctx.sessionManager.getEntries(), sessionId))
-      return;
+  pi.on("session_compact_failed", (event) => {
+    if (event.reason === "overflow") overflowRetryGuidance = void 0;
+  });
+  pi.on("agent_settled", () => {
+    overflowRetryGuidance = void 0;
+  });
+  pi.on("context", (event) => {
+    if (!overflowRetryGuidance) return;
+    const content = overflowRetryGuidance;
+    overflowRetryGuidance = void 0;
     return {
       messages: [
         ...event.messages,
         {
           role: "custom",
           customType: AGENT_CONTEXT_RETIRED_ENTRY,
-          content: CONTEXT_RETIREMENT_INSTRUCTION,
+          content,
           display: false,
           timestamp: Date.now()
         }
@@ -18687,7 +18717,7 @@ function createLeadCoordinationRuntime(host) {
     listPeerLeadRecords: listPeerLeadRecords2,
     publishProjectMessage,
     resolveMessageFiles: resolveMessageFiles2,
-    buildSessionProjection: buildSessionProjection3,
+    buildSessionProjection: buildSessionProjection4,
     contentText: contentText6,
     supervisorStateType,
     workspacePresentationProvenance: workspacePresentationProvenance2,
@@ -19081,7 +19111,7 @@ function createLeadCoordinationRuntime(host) {
   };
   const latestCustomMessageText = (ctx, customType) => {
     const entry = [
-      ...buildSessionProjection3(ctx.sessionManager.getBranch()).entries
+      ...buildSessionProjection4(ctx.sessionManager.getBranch()).entries
     ].reverse().find(
       (candidate) => candidate.sourceEntry.type === "custom_message" && candidate.sourceEntry.customType === customType && candidate.messages.length > 0
     );
@@ -22321,7 +22351,7 @@ ${summary}`,
           messageLimits: messageLimits2,
           chiefMessageBytes,
           coordinationMessageMaxBytes: COORDINATION_MESSAGE_MAX_BYTES,
-          buildSessionProjection: buildSessionProjection2,
+          buildSessionProjection: buildSessionProjection3,
           contentText: contentText5,
           supervisorStateType: SUPERVISOR_STATE_TYPE,
           sameManagerDescriptor,