pi-subagents 0.82.0 → 0.82.1

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [0.82.1] - 2026-10-24
+
+### Highlights
+
+- A run with a damaged status file no longer hides your other runs from `/subagents-fleet` and status listings.
+- The bundled skill costs about 3k tokens per use instead of 10.6k, and agents following it block on a child less often.
+- On Opus 5.5, Sonnet 5.5 and Fable 5.1, a workflow launch that loses its script recovers on the next try instead of failing again.
+
+### Changed
+
+- The bundled `pi-subagents` skill is about a quarter of its old size: about 3k tokens per use instead of 10.6k. It keeps the common calls, the workflow and resume examples, and the rules for when and how to delegate, and points to the `guide` sections for everything else instead of copying the reference docs. In testing, agents using it blocked on a child with `async: false` 2 times in 39 tasks instead of 10. `/council` no longer loads an extra 11k-token reference.
+- On Claude 5.x models (Opus 5.5, Sonnet 5.5, Fable 5.1), text written after a tool call reaches Pi only as a short summary without code blocks, so a ```` ```js workflow ```` block written at that point is lost and `subagent({ workflow: true })` can't find it. The error now explains this and tells the agent to pass the script as a file for the rest of the turn, and the bundled skill tells these models to use a file from the start once the turn has made a tool call.
+
+### Fixed
+
+- A recent background run whose `status.json` no longer parses, for example a file filled with NUL bytes, no longer stops `/subagents-fleet` and status listings from showing your other runs. The run is skipped with one warning, shown as a notice while `/subagents-fleet` is open, which repeats only if the file changes. Its files are left as they are, and asking for that run by id still reports the parse error. Thanks to [@ozand](https://github.com/ozand) for #3040 and #3041.
+
 ## [0.82.0] - 2026-10-24
 
 ### Highlights

package/README.md

@@ -62,7 +62,7 @@ The extension ships with agents you can use immediately:
 | `researcher` | Web/docs research with sources and a concise research brief. Requires [pi-web-access in the child](docs/agents.md#web-research-prerequisites). |
 | `evidence-auditor` | Independently checks whether important research claims are supported by their sources. Requires [pi-web-access in the child](docs/agents.md#web-research-prerequisites). |
 | `worker` | Implementation work. Edits files, validates, escalates unapproved decisions instead of guessing. |
-| `reviewer` | Code review and small fixes against the task/plan, tests, edge cases, and simplicity. |
+| `reviewer` | Read-only code review against the task/plan, tests, edge cases, and simplicity. |
 | `oracle` | A second opinion before acting. Challenges assumptions without editing. |
 | `delegate` | A lightweight general delegate that behaves close to the parent session. |
 

package/bundle/{chunk-GC4DSPMH.js → chunk-3JCDWF4V.js}

@@ -15,15 +15,15 @@ import {
   resolveCurrentSessionId,
   resolveWatchdogReviewModel,
   startWatchdogDiffBaselineCapture
-} from "./chunk-W2SZ22EM.js";
+} from "./chunk-VSUSLDNW.js";
 import {
   MODEL_ONLY_TOOL,
   agentStreamOptions,
   opencodeSessionHeaders
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-6XJB7PIX.js";
 import {
   inheritedNestedRouteOf
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import {
   CHILD_WATCHDOG_STATUS_EVENT,
   MISSING_STRUCTURED_ACCEPTANCE_REPORT_ERROR,

package/bundle/{chunk-NRQ75MGH.js → chunk-46XKCPJR.js}

@@ -109,6 +109,28 @@ var TOOL_CALL_INDEX_DIR = "@tool-calls";
 function isTerminalState(state) {
   return state === "complete" || state === "failed" || state === "partial" || state === "paused" || state === "stopped" || state === "rejected";
 }
+function isCorruptStatusError(error, statusPath) {
+  const message = error instanceof Error ? error.message : String(error);
+  return message.startsWith(`Failed to parse async status file '${statusPath}'`) || message.startsWith(`Failed to validate async status file '${statusPath}'`);
+}
+var reportedCorruptTerminalStatus = /* @__PURE__ */ new Map();
+function warnCorruptTerminalStatus(runId, statusPath, error, onCorruptStatus) {
+  let fileSignature = "unavailable";
+  try {
+    const stat = fs.statSync(statusPath);
+    fileSignature = `${stat.size}:${stat.mtimeMs}:${stat.ctimeMs}:${stat.ino}`;
+  } catch (statError) {
+    if (statError.code !== "ENOENT") throw statError;
+  }
+  const message = error instanceof Error ? error.message : String(error);
+  const signature = `${fileSignature}
+${message}`;
+  if (reportedCorruptTerminalStatus.get(statusPath) === signature) return;
+  reportedCorruptTerminalStatus.set(statusPath, signature);
+  const warning = `Skipping indexed terminal run '${runId}' with corrupt status at '${statusPath}': ${message}`;
+  if (onCorruptStatus) onCorruptStatus(warning);
+  else console.error(`[pi-subagents] ${warning}`);
+}
 function indexRoot(asyncDirRoot) {
   return path2.join(asyncDirRoot, TERMINAL_RUN_INDEX_DIR);
 }
@@ -221,7 +243,15 @@ function readRecentTerminalRunIndex(asyncDirRoot, options = {}) {
       continue;
     }
     const asyncDir = path2.join(asyncDirRoot, entry.runId);
-    const status = readStatus(asyncDir);
+    const statusPath = path2.join(asyncDir, "status.json");
+    let status;
+    try {
+      status = readStatus(asyncDir);
+    } catch (error) {
+      if (!isCorruptStatusError(error, statusPath)) throw error;
+      warnCorruptTerminalStatus(entry.runId, statusPath, error, options.onCorruptStatus);
+      continue;
+    }
     if (!status || !isTerminalState(status.state) || status.sessionId !== entry.sessionId || status.runId && status.runId !== entry.runId) {
       removeInvalidMarker(marker);
       continue;
@@ -1936,7 +1966,7 @@ async function executeWorkflowHostCommand(input) {
 }
 
 // src/workflows/scripted-workflow.ts
-import { accessSync, constants as constants2, readFileSync as readFileSync6, realpathSync as realpathSync3, statSync as statSync3 } from "node:fs";
+import { accessSync, constants as constants2, readFileSync as readFileSync6, realpathSync as realpathSync3, statSync as statSync4 } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname as dirname6, resolve as resolvePath } from "node:path";
 import { Worker } from "node:worker_threads";
@@ -3703,7 +3733,7 @@ async function runWorkflowScript(options) {
       if (staleCwd) process.chdir(options.processCwd);
       else {
         const target = realpathSync3(options.processCwd);
-        if (!statSync3(target).isDirectory()) {
+        if (!statSync4(target).isDirectory()) {
           const error = new Error(`ENOTDIR: not a directory, access '${target}'`);
           error.code = "ENOTDIR";
           throw error;

package/bundle/{chunk-M2CTFYT3.js → chunk-4Y2ROR7L.js}

@@ -1,6 +1,6 @@
 import {
   buildWorkflowChatProgressRows
-} from "./chunk-7PCKZHR5.js";
+} from "./chunk-FXUXCX2K.js";
 import {
   aggregateStepStatus,
   contextModeBadge,
@@ -25,13 +25,13 @@ import {
   projectWorkflowChecklist,
   withCachedUiContext,
   workflowGraphStageNodes
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-6XJB7PIX.js";
 import {
   flatToLogicalStepIndex,
   formatWorkflowJsonPreview,
   hostStepReportName,
   hostStepVerdictLabel
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import {
   snapshotExternalRuns
 } from "./chunk-UKG4V45O.js";

package/bundle/{chunk-VH5OAWVG.js → chunk-6XJB7PIX.js}

@@ -39,7 +39,7 @@ import {
   validateModelResponseAliases,
   withWorkflowChildRunModel,
   withWorktreeTransaction
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import {
   validateIntercomBridgeConfig
 } from "./chunk-XSWOTIA3.js";
@@ -2454,7 +2454,7 @@ function listAsyncRuns(asyncDirRoot, options = {}, observeStatus) {
       }
       if (wantsTerminal) {
         for (const sessionId of owners ?? [void 0]) {
-          for (const entry of readRecentTerminalRunIndex(asyncDirRoot, { sessionId, ...options.entryLimit !== void 0 ? { limit: options.entryLimit } : {} })) indexed.add(entry);
+          for (const entry of readRecentTerminalRunIndex(asyncDirRoot, { sessionId, onCorruptStatus: options.onCorruptStatus, ...options.entryLimit !== void 0 ? { limit: options.entryLimit } : {} })) indexed.add(entry);
         }
       }
       entries = [...indexed];

package/bundle/{chunk-7PCKZHR5.js → chunk-FXUXCX2K.js}

@@ -13,7 +13,7 @@ import {
   summarizeContextModes,
   utf8Tail,
   workflowPreflightLaneForRuntimeKey
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-6XJB7PIX.js";
 import {
   assertSafeNestedId,
   checkRecordedPidLiveness,
@@ -32,7 +32,7 @@ import {
   updateActiveRunIndex,
   validateModelResponseAliases,
   writeAsyncResultFile
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import {
   deliverStopRequest,
   stopInboxClosedPath

package/bundle/{chunk-7YMXOYEU.js → chunk-G4GZD3OJ.js}

@@ -6,25 +6,25 @@ import {
   resolveWorkflowForegroundSteeringTarget,
   steerAsyncRun,
   steerWorkflowForegroundTarget
-} from "./chunk-7IVSUMQQ.js";
+} from "./chunk-PBK2I7WY.js";
 import {
   FLEET_STATUS_WIDGET_KEY,
   reportFleetWarning,
   runningTone,
   stepTaskSummary
-} from "./chunk-M2CTFYT3.js";
+} from "./chunk-4Y2ROR7L.js";
 import {
   foregroundChildStateLabel,
   formatAsyncRunTranscript,
   stopAsyncRun
-} from "./chunk-7PCKZHR5.js";
+} from "./chunk-FXUXCX2K.js";
 import {
   contextModeBadge,
   contextModeLabel,
   decodeUtf8Tail,
   listAsyncRuns
-} from "./chunk-VH5OAWVG.js";
-import "./chunk-NRQ75MGH.js";
+} from "./chunk-6XJB7PIX.js";
+import "./chunk-46XKCPJR.js";
 import "./chunk-OYF6AFDY.js";
 import "./chunk-NIXWDZZV.js";
 import "./chunk-XSWOTIA3.js";
@@ -302,7 +302,8 @@ function collectFleetSnapshot(state, options = {}) {
         ...state.currentSessionId ? { sessionId: state.currentSessionId } : {},
         entryLimit: MAX_FLEET_HISTORY_CANDIDATES,
         resultsDir: options.resultsDir ?? DIRS.results,
-        reconcile: false
+        reconcile: false,
+        onCorruptStatus: (warning) => reportFleetWarning(state, warning)
       }).filter((run) => !trackedIds.has(run.id));
       runs = [...trackedRuns, ...history];
     } else {

package/bundle/{chunk-WVD4UEL4.js → chunk-IVAE5Z6Q.js}

@@ -10,10 +10,10 @@ import {
   setInlineWorkflowCoverage,
   setMainThinkingLevelSource,
   widgetRenderKey
-} from "./chunk-M2CTFYT3.js";
+} from "./chunk-4Y2ROR7L.js";
 import {
   package_default
-} from "./chunk-ZQGSDHL6.js";
+} from "./chunk-UTT254JE.js";
 import {
   EXTERNAL_JOB_BRIDGE_REQUEST_DIR,
   REVIVAL_ORIGIN_FILE,
@@ -61,7 +61,7 @@ import {
   snapshotProviderDiagnostics,
   workflowResumeClaimState,
   workflowResumeRefusal
-} from "./chunk-ZLINIYTP.js";
+} from "./chunk-ZIV4J4HG.js";
 import {
   CONTACT_SUPERVISOR_TOOL_NAME,
   NATIVE_SUPERVISOR_TOOL_NAME,
@@ -89,14 +89,14 @@ import {
   resolveWaitToolConfig,
   setDeclarationPinning,
   topLevelSupervisorTool
-} from "./chunk-W2SZ22EM.js";
+} from "./chunk-VSUSLDNW.js";
 import {
   deliverAsyncRunStop,
   ownerConfirmedDead,
   readSessionMessagesTail,
   resolveSubagentRunId,
   restoreForegroundRunHistory
-} from "./chunk-7PCKZHR5.js";
+} from "./chunk-FXUXCX2K.js";
 import {
   ASYNC_STATUS_SNAPSHOT_KIND,
   ASYNC_STATUS_SNAPSHOT_VERSION,
@@ -118,7 +118,7 @@ import {
   resolveAsyncStatusChild,
   stopStoppableAsyncStatusChildren,
   withCachedUiContext
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-6XJB7PIX.js";
 import "./chunk-NF7IEKBH.js";
 import {
   disabledFeatureUseError,
@@ -129,7 +129,7 @@ import {
   resolveDisabledFeatureSurface,
   resolveMaxActiveAsyncRunsPerSession,
   resolveScheduledStoreRoot
-} from "./chunk-NGGAFDL6.js";
+} from "./chunk-UCPP4GNU.js";
 import {
   ACTIVE_RUN_INDEX_DIR,
   MissionNotFoundError,
@@ -178,7 +178,7 @@ import {
   withWorkflowChildRunModel,
   writeAsyncResultFile,
   writeResultIndexForData
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import "./chunk-OYF6AFDY.js";
 import {
   shouldUseNativeFsWatch
@@ -5180,7 +5180,7 @@ function registerSlashCommands(pi, state, options = {}) {
     }
     fleetOpen = true;
     try {
-      const { openSubagentFleet } = await import("./chunk-7YMXOYEU.js");
+      const { openSubagentFleet } = await import("./chunk-G4GZD3OJ.js");
       await openSubagentFleet(ctx, state, { asyncDirRoot: DIRS.async, inspectorPlugins: () => getInspectorPlugins(pi), resultsDir: DIRS.results, fleetKeybindings: options.fleetKeybindings });
     } finally {
       fleetOpen = false;
@@ -8567,7 +8567,7 @@ function registerSubagentExtension(pi) {
     const ctx = withLastUiContext((current) => current);
     if (!ctx) return;
     try {
-      const { openSubagentFleet } = await import("./chunk-7YMXOYEU.js");
+      const { openSubagentFleet } = await import("./chunk-G4GZD3OJ.js");
       await openSubagentFleet(ctx, state, { initialKey: itemKey, asyncDirRoot: DIRS.async, resultsDir: DIRS.results, fleetKeybindings: config.fleetKeybindings, inspectorPlugins: () => getInspectorPlugins(pi) });
     } catch (error) {
       if (isStaleExtensionContextError(error)) {
@@ -8763,7 +8763,7 @@ function registerSubagentExtension(pi) {
   let executor;
   let executorPromise;
   let executorModulePromise;
-  const loadExecutorModule = () => executorModulePromise ??= import("./chunk-B5EKXDHE.js");
+  const loadExecutorModule = () => executorModulePromise ??= import("./chunk-QE4AGIMG.js");
   const getExecutor = () => {
     executorPromise ??= loadExecutorModule().then(({ createSubagentExecutor }) => {
       executor = createSubagentExecutor(executorDeps);
@@ -8777,7 +8777,7 @@ function registerSubagentExtension(pi) {
     modulePreloadTimer = setTimeout(() => {
       loadExecutorModule().catch(() => {
       });
-      if (fleetViewEnabled) import("./chunk-7YMXOYEU.js").catch(() => {
+      if (fleetViewEnabled) import("./chunk-G4GZD3OJ.js").catch(() => {
       });
     }, MODULE_PRELOAD_DELAY_MS);
     modulePreloadTimer.unref?.();

package/bundle/{chunk-SIJ4S3EN.js → chunk-JYUKW2SY.js}

@@ -1,18 +1,18 @@
 import {
   rewriteSubagentPrompt
-} from "./chunk-GC4DSPMH.js";
+} from "./chunk-3JCDWF4V.js";
 import {
   package_default
-} from "./chunk-ZQGSDHL6.js";
-import "./chunk-W2SZ22EM.js";
+} from "./chunk-UTT254JE.js";
+import "./chunk-VSUSLDNW.js";
 import {
   MODEL_ONLY_TOOL
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-6XJB7PIX.js";
 import "./chunk-NF7IEKBH.js";
 import {
   appendAgentRefinementOverlay
 } from "./chunk-PLCCBLPY.js";
-import "./chunk-NRQ75MGH.js";
+import "./chunk-46XKCPJR.js";
 import "./chunk-NIXWDZZV.js";
 import "./chunk-XSWOTIA3.js";
 import "./chunk-7F6RKT6W.js";

package/bundle/{chunk-7IVSUMQQ.js → chunk-PBK2I7WY.js}

@@ -1,13 +1,13 @@
 import {
   isTrustedRecordedSessionFile,
   resolveSubagentRunId
-} from "./chunk-7PCKZHR5.js";
+} from "./chunk-FXUXCX2K.js";
 import {
   agentStreamOptions,
   opencodeSessionHeaders,
   ownsRun,
   resolveAsyncResumeTarget
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-6XJB7PIX.js";
 import {
   currentCompletionOwnerId,
   listMissions,
@@ -16,7 +16,7 @@ import {
   reconcileAsyncRun,
   resolveAuthorityDecision,
   resolveMissionStoreLocation
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import {
   deliverInterruptRequest,
   queueRevivalBrief,

package/bundle/{chunk-MHZ4G23A.js → chunk-PDZWJCHD.js}

@@ -15,7 +15,7 @@ import {
 } from "./chunk-RMQFMMAT.js";
 import {
   package_default
-} from "./chunk-ZQGSDHL6.js";
+} from "./chunk-UTT254JE.js";
 import {
   HERDR_PI_MODE_ENV,
   HERDR_PI_PROTOCOL,

package/bundle/{chunk-B5EKXDHE.js → chunk-QE4AGIMG.js}

@@ -3,7 +3,7 @@ import {
   projectRuntimeAcknowledgedExtensions,
   registerSubagentPromptBoundary,
   registerSubagentPromptRuntime
-} from "./chunk-GC4DSPMH.js";
+} from "./chunk-3JCDWF4V.js";
 import {
   INSPECTOR_ACTIONS,
   canQueueRetainedAsyncFollowUp,
@@ -25,7 +25,7 @@ import {
   updateSteeringTarget,
   waitForSteeringAction,
   workflowAsyncChildSteeringGuidance
-} from "./chunk-7IVSUMQQ.js";
+} from "./chunk-PBK2I7WY.js";
 import {
   REX_LOCAL_MACHINE,
   isRexLocalMachine,
@@ -119,7 +119,7 @@ import {
   workflowStopCause,
   writeWorkflowLaunchRecord,
   writeWorkflowReceipt
-} from "./chunk-ZLINIYTP.js";
+} from "./chunk-ZIV4J4HG.js";
 import {
   NATIVE_SUPERVISOR_TOOL_NAME,
   SUBAGENT_PARENT_SESSION_ENV,
@@ -135,7 +135,7 @@ import {
   resolveWatchdogConfig,
   sendRuleViolationWarning,
   writeWatchdogModelSettings
-} from "./chunk-W2SZ22EM.js";
+} from "./chunk-VSUSLDNW.js";
 import {
   MAX_REMEMBERED_FOREGROUND_RUNS,
   discardRunningForegroundRun,
@@ -148,7 +148,7 @@ import {
   resolveSubagentRunId,
   resolveWorkflowChatProgress,
   stopAsyncRun
-} from "./chunk-7PCKZHR5.js";
+} from "./chunk-FXUXCX2K.js";
 import {
   MODEL_ONLY_TOOL,
   RunFanoutLimitError,
@@ -210,7 +210,7 @@ import {
   writeParallelHandoffGroup,
   writeRunFanoutBudgetDescriptor,
   writeWorktreeSetupHandoff
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-6XJB7PIX.js";
 import {
   authorizeWorkflowResourceHost,
   claimWorkflowChildPermit,
@@ -244,7 +244,7 @@ import {
   resolveDisabledFeatureSurface,
   resolveMaxActiveAsyncRunsPerSession,
   transferActiveAsyncCapacity
-} from "./chunk-NGGAFDL6.js";
+} from "./chunk-UCPP4GNU.js";
 import {
   DEFAULT_STALE_TERMINAL_ACTIVE_MARKER_MS,
   MACHINE_DIFF_OPTIONS,
@@ -323,7 +323,7 @@ import {
   writeNestedControlRequest,
   writeNestedControlResult,
   writeNestedEvent
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import {
   closeSteerInbox,
   consumeSteerRequests,
@@ -3987,7 +3987,8 @@ var WORKFLOW_FENCE = /^```(?:js|javascript) workflow[ \t]*$/;
 var PLAIN_JS_FENCE = /^```(?:js|javascript)[ \t]*$/;
 var OPEN_FENCE = /^(`{3,}|~{3,})/;
 var CLOSE_FENCE = /^(`{3,}|~{3,})[ \t]*$/;
-var FILE_FALLBACK = 'Or write the script to a file and pass its path, such as workflow: "./script.js".';
+var SUMMARY_NOTE = 'On some models, text written after a tool call in the same turn reaches the session only as a summary without code blocks, so for the rest of this turn write the script to a file and pass its path, such as workflow: "./script.js".';
+var FILE_FALLBACK = `If the block is in your reply: ${SUMMARY_NOTE}`;
 function readReplyWorkflowScript(sessionManager, toolCallId) {
   const branch = sessionManager.getBranch();
   for (let index = branch.length - 1; index >= 0; index--) {
@@ -4003,7 +4004,7 @@ function readReplyWorkflowScript(sessionManager, toolCallId) {
 function scriptFromReply(content) {
   const replyCalls = content.filter((block) => block.type === "toolCall" && block.name === "subagent" && (block.arguments?.workflow === true || block.arguments?.workflow === "true")).length;
   if (replyCalls > 1) return { error: `This reply has ${replyCalls} subagent calls with workflow: true; a reply can carry only one. Pass other scripts as workflow file paths.` };
-  if (!content.some((block) => block.type === "text")) return { error: 'The assistant message that issued this call has no text in the session, so the reply\'s visible text, including any ```js workflow block, never reached it. Write the script to a file and pass its path, such as workflow: "./script.js".' };
+  if (!content.some((block) => block.type === "text")) return { error: `The assistant message that issued this call has no text in the session, so the reply's visible text, including any \`\`\`js workflow block, never reached it. ${SUMMARY_NOTE}` };
   const text = content.flatMap((block) => block.type === "text" && typeof block.text === "string" ? [block.text] : []).join("\n");
   const { tagged, plain, unclosed } = workflowBlocks(text);
   if (unclosed) return { error: "The script's fenced block in this reply is not closed." };

package/bundle/{chunk-NGGAFDL6.js → chunk-UCPP4GNU.js}

@@ -11,7 +11,7 @@ import {
   validateAuthorityPolicy,
   validateMissionStoreConfig,
   validateModelResponseAliases
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import {
   getAgentDir,
   readStatus,

package/bundle/{chunk-ZQGSDHL6.js → chunk-UTT254JE.js}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "pi-subagents",
-  version: "0.82.0",
+  version: "0.82.1",
   private: true,
   description: "Pi extension for single-agent delegation and scripted multi-agent workflows",
   author: "Nico Bailon",

package/bundle/{chunk-W2SZ22EM.js → chunk-VSUSLDNW.js}

@@ -11,7 +11,7 @@ import {
   projectTimeoutRecovery,
   readAsyncRecoveryDescriptor,
   utf8Tail
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-6XJB7PIX.js";
 import {
   MAX_ARGS_BYTES,
   MAX_ARGS_DEPTH,
@@ -24,7 +24,7 @@ import {
   resultFilePath,
   resultPayloadMatchesSessionRun,
   resultPayloadPathForSessionRun
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import {
   shouldUseNativeFsWatch
 } from "./chunk-NIXWDZZV.js";

package/bundle/{chunk-ZLINIYTP.js → chunk-ZIV4J4HG.js}

@@ -11,10 +11,10 @@ import {
   startWatchdogDiffBaselineCapture,
   writeUserWatchdogEnabled,
   writeWatchdogModelSettings
-} from "./chunk-W2SZ22EM.js";
+} from "./chunk-VSUSLDNW.js";
 import {
   resolveGitRepositoryIdentity
-} from "./chunk-7PCKZHR5.js";
+} from "./chunk-FXUXCX2K.js";
 import {
   listAsyncRuns,
   ownsRun,
@@ -22,7 +22,7 @@ import {
   parseWorkflowChildSummary,
   readAsyncRecoveryDescriptor,
   resolveRetainedWorktreeCwd
-} from "./chunk-VH5OAWVG.js";
+} from "./chunk-6XJB7PIX.js";
 import {
   deepFreezeWorkflowArgs,
   normalizeWorkflowArgs
@@ -50,7 +50,7 @@ import {
   resolveMissionStoreLocation,
   validateMissionId,
   workflowRunParamsFingerprint
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import {
   requestAsyncCommand,
   watchAsyncControlInbox
@@ -4207,8 +4207,7 @@ var SUBAGENT_GUIDE_SECTION_MAX_CHARS = 8e3;
 var packageRoot = path7.resolve(path7.dirname(fileURLToPath(new URL("../src/extension/subagent-guide.js", import.meta.url).href)), "..", "..");
 var COUNCIL_FILES = [
   "skills/council-mode/SKILL.md",
-  "skills/council-mode/references/pass-contracts.md",
-  "skills/pi-subagents/references/execution-controls.md"
+  "skills/council-mode/references/pass-contracts.md"
 ];
 function isGuideTopic(value) {
   return SUBAGENT_GUIDE_TOPICS.includes(value);
@@ -7710,7 +7709,7 @@ function childSessionFactory() {
 }
 function createLazyPlacementFactory(local) {
   let placed;
-  const factory = async () => placed ??= (await import("./chunk-MHZ4G23A.js")).createPlacementAwareChildSessionFactory(local);
+  const factory = async () => placed ??= (await import("./chunk-PDZWJCHD.js")).createPlacementAwareChildSessionFactory(local);
   return {
     async create(launch) {
       return launch.machine ? (await factory()).create(launch) : local.create(launch);

package/bundle/index.js

@@ -17,7 +17,7 @@ function readInstalledPackageVersion() {
 var loadedPackageVersion = readInstalledPackageVersion();
 
 // index.ts
-var registerExtension = process.env[HERDR_PI_MODE_ENV] === "1" ? (await import("./chunk-SIJ4S3EN.js")).default : process.env.PI_SUBAGENT_CHILD === "1" ? void 0 : (await import("./chunk-WVD4UEL4.js")).default;
+var registerExtension = process.env[HERDR_PI_MODE_ENV] === "1" ? (await import("./chunk-JYUKW2SY.js")).default : process.env.PI_SUBAGENT_CHILD === "1" ? void 0 : (await import("./chunk-IVAE5Z6Q.js")).default;
 function registerSubagentExtension(pi) {
   const installedVersion = readInstalledPackageVersion();
   if (installedVersion !== loadedPackageVersion) {

package/bundle/preflight.js

@@ -6,13 +6,13 @@ import {
 import "./chunk-PLCCBLPY.js";
 import {
   loadConfig
-} from "./chunk-NGGAFDL6.js";
+} from "./chunk-UCPP4GNU.js";
 import {
   nestedResultsPath,
   processTerminalCandidatePath,
   processTerminalPath,
   resultFilePath
-} from "./chunk-NRQ75MGH.js";
+} from "./chunk-46XKCPJR.js";
 import {
   applyIntercomBridgeToAgent,
   resolveIntercomBridge,

package/docs/agents.md

@@ -43,7 +43,7 @@ Builtins load at the lowest priority, so a user or project agent with the same n
 | `researcher` | Web/docs research with sources: official docs, specs, benchmarks, recent changes, and a concise research brief. |
 | `evidence-auditor` | Independent evidence review of important claims in an existing research brief. |
 | `worker` | Implementation work, including approved oracle handoffs. It edits files, validates, and escalates unapproved decisions instead of guessing. |
-| `reviewer` | Code review and small fixes. It checks the implementation against the task/plan, tests, edge cases, and simplicity. |
+| `reviewer` | Read-only code review. It checks the implementation against the task/plan, tests, edge cases, and simplicity. |
 | `oracle` | A second opinion before acting. It challenges assumptions, catches drift, and recommends the safest next move without editing. |
 | `delegate` | A lightweight general delegate when you want a child agent that behaves close to the parent session. |
 
@@ -650,11 +650,10 @@ The package bundles a `pi-subagents` skill that is automatically available to th
 
 What it covers:
 
-- **Delegation patterns**: how to select a bounded agent and single, parallel, scripted, or async shape after delegation is authorized, including fresh or forked context.
-- **Prompt workflow recipes**: how to apply the packaged techniques directly with `subagent(...)` when the user describes the workflow in natural language instead of invoking a slash command. This includes parallel review, review-loop, parallel research, parallel context-build, parallel handoff-plan, gather-context-and-clarify, and parallel cleanup.
-- **Role-agent prompting guidance**: compact contract prompts instead of long scripts, what to include in role-specific meta prompts, and retrieval budgets for researchers.
-- **Safety boundaries**: child agents must not run subagents unless their resolved builtin tools explicitly include `subagent`, must not invent intercom targets, and must escalate unapproved decisions.
-- **Intercom conventions**: when to ask vs send, and how parent-side supervisor/result delivery works through the native channel.
-- **Control and diagnostics**: attention signals, soft interrupts, status, and the `doctor` action.
+- **Calls**: the common `subagent` calls, workflow script and resume shapes, and async waiting rules.
+- **Delegation rules**: when to delegate at all, what every child brief contains, one writer per worktree, fresh or forked context, and what to do when a lane fails.
+- **Prompt workflow recipes**: how to apply the packaged techniques directly with `subagent(...)` when the user describes the workflow in natural language instead of invoking a slash command: parallel review, review loop, parallel research, gather-context-and-clarify, parallel cleanup, and oracle consultation.
+- **Orchestration**: splitting work into lanes, review loops, finding disposition, and gate-failure triage.
+- **Lookups**: which `guide` section answers each rarer question, so the skill does not copy this reference.
 
 If you are writing an agent that has been asked to orchestrate subagents, the bundled skill helps it behave correctly without guessing the patterns. If you are a human user, you do not need to read it; the README and prompt shortcuts encode the same workflows in user-facing form.

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "pi-subagents",
-  "version": "0.82.0",
+  "version": "0.82.1",
   "description": "Pi extension for single-agent delegation and scripted multi-agent workflows",
   "author": "Nico Bailon",
   "license": "MIT",

package/skills/council-mode/SKILL.md

@@ -9,10 +9,7 @@ Council mode is parent-supervised advice for a material decision with real trade
 
 The parent selects the roster, relays only curated claims, decides validity, and writes the memo. Advisors stay read-only and do not see peer transcripts by default.
 
-Before launch, read:
-
-- `skills/pi-subagents/references/execution-controls.md`
-- `skills/council-mode/references/pass-contracts.md`
+Before launch, read `skills/council-mode/references/pass-contracts.md`.
 
 ## Roster