pi-herdsman 0.21.1 → 0.21.3

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.3",
   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",
@@ -280,6 +280,7 @@ import {
   fuzzyFilter,
   Input,
   Key,
+  MouseRegion,
   matchesKey,
   SelectList,
   Spacer as Spacer2,
@@ -3815,6 +3816,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 +13701,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 +14904,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 +15030,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 +15200,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 +15215,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 +18718,7 @@ function createLeadCoordinationRuntime(host) {
     listPeerLeadRecords: listPeerLeadRecords2,
     publishProjectMessage,
     resolveMessageFiles: resolveMessageFiles2,
-    buildSessionProjection: buildSessionProjection3,
+    buildSessionProjection: buildSessionProjection4,
     contentText: contentText6,
     supervisorStateType,
     workspacePresentationProvenance: workspacePresentationProvenance2,
@@ -19081,7 +19112,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
     );
@@ -21011,6 +21042,21 @@ function createLeadRoleTransitions(state, host) {
 
 // extension/index.ts
 var HERDSMAN_VERSION = package_default.version;
+function expandableMessage(initialExpanded, render) {
+  let expanded = initialExpanded;
+  const content = new Container2();
+  const rebuild = () => {
+    content.clear();
+    content.addChild(render(expanded));
+  };
+  rebuild();
+  return new MouseRegion(content, (event) => {
+    if (event.type !== "click" || event.button !== "left") return void 0;
+    expanded = !expanded;
+    rebuild();
+    return { handled: true };
+  });
+}
 var HERDSMAN_EXTENSION_PATH = fileURLToPath2(import.meta.url);
 var HERDSMAN_BUILD = runtimeBuild(HERDSMAN_VERSION, HERDSMAN_EXTENSION_PATH);
 var PI_SESSION_ID_PATTERN = "^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$";
@@ -21314,12 +21360,28 @@ function index_default(pi) {
   for (const kind of COORDINATION_MESSAGE_KINDS) {
     pi.registerMessageRenderer(
       `pi-herdsman-${kind}`,
-      (message, options, theme) => renderCoordinationMessage(kind, message, options, theme)
+      (message, options, theme) => expandableMessage(
+        options.expanded,
+        (expanded) => renderCoordinationMessage(
+          kind,
+          message,
+          { ...options, expanded },
+          theme
+        )
+      )
     );
   }
   pi.registerMessageRenderer(
     "pi-herdsman-project_message",
-    (message, options, theme) => renderCoordinationMessage("project_message", message, options, theme)
+    (message, options, theme) => expandableMessage(
+      options.expanded,
+      (expanded) => renderCoordinationMessage(
+        "project_message",
+        message,
+        { ...options, expanded },
+        theme
+      )
+    )
   );
   pi.registerMessageRenderer(
     "pi-herdsman-stop-summary",
@@ -21327,23 +21389,38 @@ function index_default(pi) {
   );
   pi.registerMessageRenderer(
     "pi-herdsman-agent-result",
-    (message, options, theme) => renderCompletionMessage(message, options, theme)
+    (message, options, theme) => expandableMessage(
+      options.expanded,
+      (expanded) => renderCompletionMessage(message, { ...options, expanded }, theme)
+    )
   );
   pi.registerMessageRenderer(
     "pi-herdsman-agent-ask",
-    (message, options, theme) => renderAgentAskMessage(message, options, theme)
+    (message, options, theme) => expandableMessage(
+      options.expanded,
+      (expanded) => renderAgentAskMessage(message, { ...options, expanded }, theme)
+    )
   );
   pi.registerMessageRenderer(
     "pi-herdsman-agent-stale",
-    (message, options, theme) => renderAgentStaleMessage(message, options, theme)
+    (message, options, theme) => expandableMessage(
+      options.expanded,
+      (expanded) => renderAgentStaleMessage(message, { ...options, expanded }, theme)
+    )
   );
   pi.registerMessageRenderer(
     "pi-herdsman-agent-lost",
-    (message, options, theme) => renderAgentLostMessage(message, options, theme)
+    (message, options, theme) => expandableMessage(
+      options.expanded,
+      (expanded) => renderAgentLostMessage(message, { ...options, expanded }, theme)
+    )
   );
   pi.registerMessageRenderer(
     "pi-herdsman-agent-attention",
-    (message, options, theme) => renderAgentAttentionMessage(message, options, theme)
+    (message, options, theme) => expandableMessage(
+      options.expanded,
+      (expanded) => renderAgentAttentionMessage(message, { ...options, expanded }, theme)
+    )
   );
   const processRole = role();
   if (processRole === "unmanaged") {
@@ -22321,7 +22398,7 @@ ${summary}`,
           messageLimits: messageLimits2,
           chiefMessageBytes,
           coordinationMessageMaxBytes: COORDINATION_MESSAGE_MAX_BYTES,
-          buildSessionProjection: buildSessionProjection2,
+          buildSessionProjection: buildSessionProjection3,
           contentText: contentText5,
           supervisorStateType: SUPERVISOR_STATE_TYPE,
           sameManagerDescriptor,