@narumitw/pi-subagents 2.0.0 → 2.0.2

package/dist/index.ts

@@ -0,0 +1,1057 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+import {
+  registerSubagentInspect
+} from "./chunks/chunk-F4L2UVSK.js";
+import {
+  SubagentParams,
+  hasUsableAggregator
+} from "./chunks/chunk-NIF42QMF.js";
+import {
+  registerStatefulSubagents
+} from "./chunks/chunk-F5YWVHQX.js";
+import {
+  discoverAgentCatalog,
+  formatAgentCatalog,
+  formatUsageStats,
+  registerSubagentConsult
+} from "./chunks/chunk-RHRQMT7Q.js";
+import "./chunks/chunk-P7OH4XMF.js";
+import "./chunks/chunk-N7BLVXKK.js";
+import {
+  getResultFinalOutput,
+  isResultError
+} from "./chunks/chunk-AEUYS7JC.js";
+import "./chunks/chunk-RTCVYIZA.js";
+import "./chunks/chunk-ONDTY4EL.js";
+import "./chunks/chunk-O4VO6JUJ.js";
+import {
+  cachedModuleLoader,
+  throwIfAborted
+} from "./chunks/chunk-HOP5FXDT.js";
+import "./chunks/chunk-PSK43Y6A.js";
+import "./chunks/chunk-RSUXZD6S.js";
+import {
+  DEFAULT_CONSULTATION_CWD_POLICY,
+  DEFAULT_CONSULT_RESOURCE_POLICY,
+  DEFAULT_DELEGATION_CWD_POLICY,
+  consumeSubagentSettingsNotice,
+  inspectSubagentSettings,
+  readSubagentSettings,
+  resolveBlockingMaxParallelTasks
+} from "./chunks/chunk-QBORTI4W.js";
+import "./chunks/chunk-7OBINKFM.js";
+import "./chunks/chunk-DPPVEQAM.js";
+import {
+  SUBAGENT_COMPLETION_MESSAGE_TYPE,
+  renderCompletionMessage
+} from "./chunks/chunk-QDVGH2X7.js";
+import {
+  expansionHint,
+  formatToolActivity,
+  safeBlock,
+  safeLine
+} from "./chunks/chunk-BFK2Z4ZF.js";
+import "./chunks/chunk-SWGQLFSD.js";
+import "./chunks/chunk-I2FAK44T.js";
+import {
+  MAX_BLOCKING_PARALLEL_CONCURRENCY
+} from "./chunks/chunk-H3FP6DLR.js";
+import "./chunks/chunk-S2IWVK3J.js";
+
+// src/subagents-extension.ts
+import {
+  CONFIG_DIR_NAME
+} from "@earendil-works/pi-coding-agent";
+
+// src/config-registration.ts
+var SUBCOMMANDS = [
+  { value: "settings", label: "settings", description: "Configure subagent user settings" },
+  { value: "status", label: "status", description: "Show effective subagent settings" },
+  { value: "help", label: "help", description: "Show subagent settings help" }
+];
+function registerSubagentConfigLifecycle(pi) {
+  const owner = { generation: 0, controller: new AbortController() };
+  pi.on("session_start", () => {
+    owner.generation += 1;
+    owner.controller.abort(new DOMException("Subagent session replaced", "AbortError"));
+    owner.controller = new AbortController();
+  });
+  pi.on("session_shutdown", () => {
+    owner.generation += 1;
+    owner.controller.abort(new DOMException("Subagent session shut down", "AbortError"));
+  });
+  return owner;
+}
+function registerSubagentConfigCommand(pi, runtime, owner = registerSubagentConfigLifecycle(pi), dependencies = {}) {
+  const loadConfigUi = cachedModuleLoader(
+    dependencies.loadConfigUi ?? (() => import("./chunks/config-ui-3IBMHTQB.js"))
+  );
+  const loadConfigStatus = cachedModuleLoader(
+    dependencies.loadConfigStatus ?? (() => import("./chunks/config-status-J4GPWP46.js"))
+  );
+  pi.registerCommand("subagents", {
+    description: "Manage current-session subagents and user settings",
+    getArgumentCompletions(prefix) {
+      const normalized = prefix.trim().toLowerCase();
+      const matches = SUBCOMMANDS.filter((item) => item.value.startsWith(normalized));
+      return matches.length > 0 ? matches : null;
+    },
+    async handler(args, ctx) {
+      const subcommand = args.trim().toLowerCase();
+      const runStatusCommand = async (show) => {
+        const generation = owner.generation;
+        const controller = owner.controller;
+        const isCurrent = () => generation === owner.generation && controller === owner.controller && !controller.signal.aborted;
+        let status;
+        try {
+          status = await loadConfigStatus();
+        } catch (error) {
+          if (!isCurrent()) return;
+          throw error;
+        }
+        if (!isCurrent()) return;
+        show(status);
+      };
+      if (!subcommand && ctx.mode !== "tui") {
+        await runStatusCommand((status) => status.showSubagentStatus(ctx, runtime));
+        return;
+      }
+      if (subcommand === "status") {
+        await runStatusCommand((status) => status.showSubagentStatus(ctx, runtime));
+        return;
+      }
+      if (subcommand === "help") {
+        await runStatusCommand((status) => status.showSubagentHelp(ctx, runtime));
+        return;
+      }
+      if (!subcommand || subcommand === "settings") {
+        const generation = owner.generation;
+        const controller = owner.controller;
+        const isCurrent = () => generation === owner.generation && controller === owner.controller && !controller.signal.aborted;
+        let configUi;
+        try {
+          configUi = await loadConfigUi();
+        } catch (error) {
+          if (!isCurrent()) return;
+          throw error;
+        }
+        if (!isCurrent()) return;
+        if (!subcommand) await configUi.showSubagentManager(pi, ctx, runtime, owner);
+        else await configUi.showSubagentSettings(ctx, runtime, owner);
+        return;
+      }
+      if (ctx.mode === "tui" || ctx.hasUI) {
+        ctx.ui.notify(`Unknown /subagents subcommand: ${subcommand}`, "warning");
+      }
+    }
+  });
+}
+
+// src/render.ts
+import {
+  getMarkdownTheme
+} from "@earendil-works/pi-coding-agent";
+import { Container, Markdown, Spacer, Text as Text2 } from "@earendil-works/pi-tui";
+
+// src/panel-render.ts
+import { Text } from "@earendil-works/pi-tui";
+function renderPanelCall(args, theme) {
+  const panel = args.panel;
+  if (!panel) return void 0;
+  const scope = args.agentScope ?? "user";
+  let text = theme.fg("toolTitle", theme.bold("subagent ")) + theme.fg("accent", `panel ${panel.preset ?? "custom"} (${panel.reviewers.length} reviewers)`) + theme.fg("muted", ` [${scope}]`);
+  text += `
+  ${theme.fg("dim", preview(panel.task, 80))}`;
+  for (const reviewer of panel.reviewers.slice(0, 3)) {
+    text += `
+  ${theme.fg("muted", `${safeLine(reviewer.id, "reviewer", 256)}:`)} ${theme.fg("accent", safeLine(reviewer.agent, "agent", 256))}`;
+    if (reviewer.focus) text += theme.fg("dim", ` ${preview(reviewer.focus, 40)}`);
+  }
+  if (panel.reviewers.length > 3) {
+    text += `
+  ${theme.fg("muted", `... +${panel.reviewers.length - 3} more`)}`;
+  }
+  text += `
+  ${theme.fg("muted", "synthesis \u2192 ")}${theme.fg("accent", safeLine(panel.synthesizer.agent, "agent", 256))}`;
+  return new Text(text, 0, 0);
+}
+function renderPanelResult(details, expanded, isPartial, theme) {
+  const panel = details.panel;
+  if (details.mode !== "panel" || !panel) return void 0;
+  const running = isPartial || panel.state === "running";
+  const status = running ? "running" : panel.state;
+  const color = status === "completed" ? "success" : status === "running" || status === "degraded" ? "warning" : "error";
+  let text = `${theme.fg(color, status)} ${theme.fg("accent", safeLine(panel.preset, "panel", 128))}`;
+  text += theme.fg(
+    "muted",
+    ` \xB7 valid ${panel.validReviewCount}/${panel.reviewerIds.length} \xB7 failed ${panel.failedReviewCount} \xB7 blockers ${panel.blockingObjectionCount} \xB7 dissent ${panel.dissentCount}`
+  );
+  if (panel.synthesis) {
+    text += `
+${theme.fg("toolOutput", safeBlock(panel.synthesis.summary, "", 8 * 1024))}`;
+  } else if (panel.state === "insufficient-panel") {
+    text += `
+${theme.fg("warning", "Synthesis skipped because too few valid reviews remained.")}`;
+  }
+  if (!expanded) return new Text(text, 0, 0);
+  text += `
+
+${theme.fg("muted", "Shared task: ")}${theme.fg("dim", safeBlock(panel.sharedTaskPreview, "", 2 * 1024))}`;
+  text += `
+
+${theme.fg("muted", "Reviewers:")}`;
+  for (const reviewerId of panel.reviewerIds) {
+    const artifact = panel.evidence.find((candidate) => candidate.reviewerId === reviewerId);
+    const failure = panel.failures.find((candidate) => candidate.reviewerId === reviewerId);
+    const result = details.results.find(
+      (candidate) => candidate.step === panel.reviewerIds.indexOf(reviewerId) + 1
+    );
+    const model = result?.actualModel ?? result?.model;
+    text += `
+  ${theme.fg("accent", safeLine(reviewerId, "reviewer", 256))}`;
+    if (model) text += theme.fg("muted", ` \xB7 ${safeLine(model, "", 256)}`);
+    if (artifact) {
+      text += theme.fg(
+        "muted",
+        ` \xB7 ${artifact.review.disposition} \xB7 revision ${artifact.revision}`
+      );
+      for (const finding of artifact.review.findings) {
+        text += `
+    ${theme.fg(finding.severity === "critical" || finding.severity === "high" ? "error" : "warning", `[${finding.severity}]`)} ${safeLine(finding.title, "finding", 512)}`;
+      }
+    } else if (failure) {
+      text += theme.fg("error", ` \xB7 ${safeLine(failure.kind, "failed", 128)}`);
+    }
+  }
+  if (panel.synthesis?.disagreements.length) {
+    text += `
+
+${theme.fg("muted", "Disagreements:")}`;
+    for (const disagreement of panel.synthesis.disagreements) {
+      text += `
+  ${safeLine(disagreement.summary, "disagreement", 1024)}`;
+    }
+  }
+  if (panel.synthesis?.objections.length) {
+    text += `
+
+${theme.fg("muted", "Blocking objections:")}`;
+    for (const objection of panel.synthesis.objections) {
+      text += `
+  ${safeLine(`${objection.reviewerId}/${objection.findingId}: ${objection.resolution}`, "objection", 1024)}`;
+    }
+  }
+  const limitations = panel.synthesis?.limitations ?? [];
+  if (limitations.length) {
+    text += `
+
+${theme.fg("muted", "Limitations:")}`;
+    for (const limitation of limitations) text += `
+  ${safeLine(limitation, "", 1024)}`;
+  }
+  text += `
+
+${theme.fg("muted", `Budget: review ${panel.budgets.reviewMs}ms \xB7 finalization ${panel.budgets.finalizationMs}ms \xB7 synthesis ${panel.budgets.synthesisMs}ms \xB7 cleanup ${panel.budgets.cleanupMs}ms`)}`;
+  text += `
+${theme.fg("muted", `Cleanup: ${panel.cleanupComplete ? "complete" : "pending"}`)}`;
+  return new Text(text, 0, 0);
+}
+function preview(value, maxLength) {
+  const text = safeLine(value, "", 2 * 1024);
+  return text.length > maxLength ? `${text.slice(0, maxLength)}...` : text;
+}
+
+// src/render.ts
+var COLLAPSED_ITEM_COUNT = 5;
+function previewTask(task, maxLength = 40) {
+  const safe = safeLine(task, "...", 2 * 1024);
+  return safe.length > maxLength ? `${safe.slice(0, maxLength)}...` : safe;
+}
+function previewAgent(agent) {
+  return safeLine(agent, "...", 256);
+}
+function formatResultUsageStats(result) {
+  return formatUsageStats(
+    result.usage,
+    result.model,
+    result.thinkingLevel,
+    result.actualProvider,
+    result.actualModel
+  );
+}
+function formatToolCall(toolName, args, themeFg) {
+  return formatToolActivity(toolName, args, themeFg);
+}
+function getDisplayItems(messages) {
+  const items = [];
+  for (const msg of messages) {
+    if (msg.role === "assistant") {
+      for (const part of msg.content) {
+        if (part.type === "text") {
+          const text = safeBlock(part.text, "", 8 * 1024).trim();
+          if (text) items.push({ type: "text", text });
+        } else if (part.type === "toolCall") {
+          items.push({
+            type: "toolCall",
+            name: safeLine(part.name, "tool", 256),
+            args: part.arguments
+          });
+        }
+      }
+    }
+  }
+  return items;
+}
+function getCollapsedDisplayItems(result) {
+  if (result.recentActivity && result.recentActivity.length > 0) {
+    return {
+      items: result.recentActivity,
+      total: Math.max(result.recentActivity.length, result.recentActivityTotal ?? 0)
+    };
+  }
+  const items = getDisplayItems(result.messages);
+  return { items, total: items.length };
+}
+function sanitizeSingleResultForRender(result) {
+  return {
+    ...result,
+    agent: safeLine(result.agent, "subagent", 256),
+    task: safeBlock(result.task, "", 50 * 1024),
+    stderr: safeBlock(result.stderr, "", 8 * 1024),
+    model: result.model ? safeLine(result.model, "", 256) : void 0,
+    actualProvider: result.actualProvider ? safeLine(result.actualProvider, "", 256) : void 0,
+    actualModel: result.actualModel ? safeLine(result.actualModel, "", 256) : void 0,
+    stopReason: result.stopReason ? safeLine(result.stopReason, "", 256) : void 0,
+    errorMessage: result.errorMessage ? safeBlock(result.errorMessage, "", 8 * 1024) : void 0,
+    finalOutput: result.finalOutput ? safeBlock(result.finalOutput, "", 50 * 1024) : void 0
+  };
+}
+function renderResultStatus(result, isPartial) {
+  if (result.outcome && !["completed", "partial"].includes(result.outcome.status)) {
+    return result.outcome.status.split("-").map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`).join(" ");
+  }
+  if (isResultError(result)) {
+    return result.stopReason === "aborted" || result.aborted ? "Cancelled" : "Failed";
+  }
+  return isPartial || result.exitCode === -1 ? "Running" : "Completed";
+}
+function coloredStatus(theme, status) {
+  const color = status === "Failed" ? "error" : status === "Completed" ? "success" : "warning";
+  return theme.fg(color, status);
+}
+function coloredResultStatus(theme, result, isPartial) {
+  return coloredStatus(theme, renderResultStatus(result, isPartial));
+}
+function formatResultIntelligence(result) {
+  const structured = result.structuredResult?.version === "pi-subagents:result:v2" ? result.structuredResult : void 0;
+  return [
+    result.contract ? `contract: ${result.contract.level} \xB7 ${result.contract.taskId}` : void 0,
+    result.outcome ? `outcome: ${result.outcome.status}${result.outcome.reasonCode ? ` \xB7 ${result.outcome.reasonCode}` : ""}` : void 0,
+    structured ? `evidence: ${structured.claims.length} claims \xB7 ${structured.artifacts.length} artifacts \xB7 ${structured.verification.length} verification items \xB7 ${structured.limitations.length} limitations` : void 0,
+    result.resultContractInvalid ? "contract warning: invalid structured result" : void 0,
+    result.executionPlan ? `plan: ${result.executionPlan.id.slice(0, 12)} \xB7 generation ${result.executionPlan.taskGeneration} \xB7 admission ${result.executionPlan.admission.recommendation}` : void 0,
+    result.capabilityGrant ? `grant: ${result.capabilityGrant.state} \xB7 expires ${result.capabilityGrant.expiresAt}` : void 0
+  ].filter((line) => Boolean(line)).join("\n");
+}
+function formatResultPolicy(result) {
+  if (!result.policy) return "";
+  return [
+    `inherited: ${result.policy.inherited.map((tool) => safeLine(tool, "", 256)).join(", ") || "none"}`,
+    `overridden: ${result.policy.overridden.map((tool) => safeLine(tool, "", 256)).join(", ") || "none"}`,
+    `unsupported: ${result.policy.unsupported.map((tool) => safeLine(tool, "", 256)).join(", ") || "none"}`
+  ].join("\n");
+}
+function renderSubagentCall(args, theme) {
+  const scope = args.agentScope ?? "user";
+  const limits = [
+    typeof args.timeoutMs === "number" ? `timeout:${args.timeoutMs}ms` : void 0,
+    typeof args.totalTimeoutMs === "number" ? `total:${args.totalTimeoutMs}ms` : void 0,
+    typeof args.idleTimeoutMs === "number" ? `idle:${args.idleTimeoutMs}ms` : void 0,
+    typeof args.maxTurns === "number" ? `turns:${args.maxTurns}` : void 0,
+    typeof args.maxToolCalls === "number" ? `tools:${args.maxToolCalls}` : void 0
+  ].filter((value) => Boolean(value));
+  const limitText = limits.length > 0 ? ` \xB7 ${limits.join(" \xB7 ")}` : "";
+  const panelCall = renderPanelCall(args, theme);
+  if (panelCall) return panelCall;
+  if (args.workflow && args.workflow.tasks.length > 0) {
+    let text2 = theme.fg("toolTitle", theme.bold("subagent ")) + theme.fg("accent", `workflow (${args.workflow.tasks.length} tasks)`) + theme.fg("muted", ` [${scope}]${limitText}`);
+    for (const task of args.workflow.tasks.slice(0, 3)) {
+      text2 += `
+  ${theme.fg("muted", `${task.id}:`)} ${theme.fg("accent", previewAgent(task.agent))}${theme.fg("dim", ` ${previewTask(task.task)}`)}`;
+    }
+    if (args.workflow.tasks.length > 3) {
+      text2 += `
+  ${theme.fg("muted", `... +${args.workflow.tasks.length - 3} more`)}`;
+    }
+    return new Text2(text2, 0, 0);
+  }
+  if (args.chain && args.chain.length > 0) {
+    let text2 = theme.fg("toolTitle", theme.bold("subagent ")) + theme.fg("accent", `chain (${args.chain.length} steps)`) + theme.fg("muted", ` [${scope}]${limitText}`);
+    for (let i = 0; i < Math.min(args.chain.length, 3); i++) {
+      const step = args.chain[i];
+      const cleanTask = typeof step?.task === "string" ? step.task.replace(/\{previous\}/g, "").trim() : void 0;
+      text2 += "\n  " + theme.fg("muted", `${i + 1}.`) + " " + theme.fg("accent", previewAgent(step?.agent)) + theme.fg("dim", ` ${previewTask(cleanTask)}`);
+    }
+    if (args.chain.length > 3)
+      text2 += `
+  ${theme.fg("muted", `... +${args.chain.length - 3} more`)}`;
+    return new Text2(text2, 0, 0);
+  }
+  if (args.tasks && args.tasks.length > 0) {
+    let text2 = theme.fg("toolTitle", theme.bold("subagent ")) + theme.fg("accent", `parallel (${args.tasks.length} tasks)`) + theme.fg("muted", ` [${scope}]${limitText}`);
+    for (const task of args.tasks.slice(0, 3)) {
+      const item = task;
+      text2 += `
+  ${theme.fg("accent", previewAgent(item?.agent))}${theme.fg("dim", ` ${previewTask(item?.task)}`)}`;
+    }
+    if (args.tasks.length > 3)
+      text2 += `
+  ${theme.fg("muted", `... +${args.tasks.length - 3} more`)}`;
+    if (hasUsableAggregator(args.aggregator)) {
+      const aggregator = args.aggregator;
+      text2 += `
+  ${theme.fg("muted", "fan-in \u2192 ")}${theme.fg("accent", previewAgent(aggregator.agent))}${theme.fg(
+        "dim",
+        ` ${previewTask(aggregator.task)}`
+      )}`;
+    }
+    return new Text2(text2, 0, 0);
+  }
+  const agentName = previewAgent(args.agent);
+  const preview2 = previewTask(args.task, 60);
+  let text = theme.fg("toolTitle", theme.bold("subagent ")) + theme.fg("accent", agentName) + theme.fg("muted", ` [${scope}]${limitText}`);
+  text += `
+  ${theme.fg("dim", preview2)}`;
+  return new Text2(text, 0, 0);
+}
+function renderSubagentResult(result, { expanded, isPartial }, theme) {
+  const rawDetails = result.details;
+  if (rawDetails?.mode === "panel") {
+    const panelResult = renderPanelResult(rawDetails, expanded, isPartial, theme);
+    if (panelResult) return panelResult;
+  }
+  if (!rawDetails || rawDetails.results.length === 0) {
+    const text2 = result.content[0];
+    return new Text2(
+      text2?.type === "text" ? safeBlock(text2.text, "(no output)", 8 * 1024) : "(no output)",
+      0,
+      0
+    );
+  }
+  const details = {
+    ...rawDetails,
+    results: rawDetails.results.map(sanitizeSingleResultForRender),
+    aggregator: rawDetails.aggregator ? sanitizeSingleResultForRender(rawDetails.aggregator) : void 0
+  };
+  const mdTheme = getMarkdownTheme();
+  const renderDisplayItems = (items, limit, total = items.length) => {
+    const toShow = limit ? items.slice(-limit) : items;
+    const skipped = Math.max(0, total - toShow.length);
+    let text2 = "";
+    if (skipped > 0) text2 += theme.fg("muted", `... ${skipped} earlier items
+`);
+    for (const item of toShow) {
+      if (item.type === "text") {
+        const safeText = safeBlock(item.text, "", 8 * 1024);
+        const preview2 = expanded ? safeText : safeText.split("\n").slice(0, 3).join("\n");
+        text2 += `${theme.fg("toolOutput", preview2)}
+`;
+      } else {
+        text2 += `${theme.fg("muted", "\u2192 ") + formatToolCall(item.name, item.args, theme.fg.bind(theme))}
+`;
+      }
+    }
+    return text2.trimEnd();
+  };
+  if (details.mode === "single" && details.results.length === 1) {
+    const r = details.results[0];
+    const isError = isResultError(r);
+    const icon = isError ? theme.fg("error", "\u2717") : isPartial ? theme.fg("warning", "\u23F3") : theme.fg("success", "\u2713");
+    const displayItems = getDisplayItems(r.messages);
+    const finalOutput = getResultFinalOutput(r);
+    if (expanded) {
+      const container = new Container();
+      let header = `${icon} ${theme.fg("toolTitle", theme.bold(r.agent))}${theme.fg("muted", ` (${safeLine(r.agentSource, "unknown", 128)})`)} \xB7 ${coloredResultStatus(theme, r, isPartial)}`;
+      if (isError && r.stopReason) header += ` ${theme.fg("error", `[${r.stopReason}]`)}`;
+      container.addChild(new Text2(header, 0, 0));
+      if (isError && r.errorMessage)
+        container.addChild(new Text2(theme.fg("error", `Error: ${r.errorMessage}`), 0, 0));
+      container.addChild(new Spacer(1));
+      container.addChild(new Text2(theme.fg("muted", "\u2500\u2500\u2500 Task \u2500\u2500\u2500"), 0, 0));
+      container.addChild(new Text2(theme.fg("dim", r.task), 0, 0));
+      const intelligence = formatResultIntelligence(r);
+      if (intelligence) {
+        container.addChild(new Spacer(1));
+        container.addChild(new Text2(theme.fg("muted", "\u2500\u2500\u2500 Delegation \u2500\u2500\u2500"), 0, 0));
+        container.addChild(new Text2(theme.fg("dim", intelligence), 0, 0));
+      }
+      const policy = formatResultPolicy(r);
+      if (policy) {
+        container.addChild(new Spacer(1));
+        container.addChild(new Text2(theme.fg("muted", "\u2500\u2500\u2500 Policy \u2500\u2500\u2500"), 0, 0));
+        container.addChild(new Text2(theme.fg("dim", policy), 0, 0));
+      }
+      container.addChild(new Spacer(1));
+      container.addChild(new Text2(theme.fg("muted", "\u2500\u2500\u2500 Output \u2500\u2500\u2500"), 0, 0));
+      if (displayItems.length === 0 && !finalOutput) {
+        container.addChild(new Text2(theme.fg("muted", "(no output)"), 0, 0));
+      } else {
+        for (const item of displayItems) {
+          if (item.type === "toolCall")
+            container.addChild(
+              new Text2(
+                theme.fg("muted", "\u2192 ") + formatToolCall(item.name, item.args, theme.fg.bind(theme)),
+                0,
+                0
+              )
+            );
+        }
+        if (finalOutput) {
+          container.addChild(new Spacer(1));
+          container.addChild(new Markdown(finalOutput.trim(), 0, 0, mdTheme));
+        }
+      }
+      const usageStr2 = formatResultUsageStats(r);
+      if (usageStr2) {
+        container.addChild(new Spacer(1));
+        container.addChild(new Text2(theme.fg("dim", usageStr2), 0, 0));
+      }
+      return container;
+    }
+    const collapsed = getCollapsedDisplayItems(r);
+    let text2 = `${icon} ${theme.fg("toolTitle", theme.bold(r.agent))}${theme.fg("muted", ` (${safeLine(r.agentSource, "unknown", 128)})`)} \xB7 ${coloredResultStatus(theme, r, isPartial)}`;
+    if (isError && r.stopReason) text2 += ` ${theme.fg("error", `[${r.stopReason}]`)}`;
+    if (isError && r.errorMessage) text2 += `
+${theme.fg("error", `Error: ${r.errorMessage}`)}`;
+    if (collapsed.items.length > 0) {
+      text2 += `
+${renderDisplayItems(collapsed.items, COLLAPSED_ITEM_COUNT, collapsed.total)}`;
+      if (collapsed.total > COLLAPSED_ITEM_COUNT) text2 += `
+${expansionHint()}`;
+    } else if (finalOutput.trim()) {
+      const outputLines = finalOutput.trim().split("\n");
+      text2 += `
+${theme.fg("toolOutput", outputLines.slice(0, 3).join("\n"))}`;
+      if (outputLines.length > 3) text2 += `
+${expansionHint()}`;
+    } else if (!isError || !r.errorMessage) {
+      text2 += `
+${theme.fg("muted", isPartial && !isError ? "(running...)" : "(no output)")}`;
+    }
+    const usageStr = formatResultUsageStats(r);
+    if (usageStr) text2 += `
+${theme.fg("dim", usageStr)}`;
+    return new Text2(text2, 0, 0);
+  }
+  const aggregateUsage = (results) => {
+    const total = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: 0 };
+    for (const r of results) {
+      total.input += r.usage.input;
+      total.output += r.usage.output;
+      total.cacheRead += r.usage.cacheRead;
+      total.cacheWrite += r.usage.cacheWrite;
+      total.cost += r.usage.cost;
+      total.turns += r.usage.turns;
+    }
+    return total;
+  };
+  if (details.mode === "chain") {
+    const currentResult = details.results.at(-1);
+    const currentIsRunning = isPartial && currentResult !== void 0 && !isResultError(currentResult);
+    const successCount = details.results.filter(
+      (result2) => !isResultError(result2) && (!currentIsRunning || result2 !== currentResult)
+    ).length;
+    const icon = currentIsRunning ? theme.fg("warning", "\u23F3") : successCount === details.results.length ? theme.fg("success", "\u2713") : theme.fg("error", "\u2717");
+    const overallStatus = currentIsRunning ? "Running" : successCount === details.results.length ? "Completed" : "Failed";
+    if (expanded) {
+      const container = new Container();
+      container.addChild(
+        new Text2(
+          icon + " " + theme.fg("toolTitle", theme.bold("chain ")) + theme.fg("accent", `${successCount}/${details.results.length} steps`) + ` \xB7 ${coloredStatus(theme, overallStatus)}`,
+          0,
+          0
+        )
+      );
+      for (const r of details.results) {
+        const rFailed = isResultError(r);
+        const rIcon = rFailed ? theme.fg("error", "\u2717") : currentIsRunning && r === currentResult ? theme.fg("warning", "\u23F3") : theme.fg("success", "\u2713");
+        const displayItems = getDisplayItems(r.messages);
+        const finalOutput = getResultFinalOutput(r);
+        container.addChild(new Spacer(1));
+        container.addChild(
+          new Text2(
+            `${theme.fg("muted", `\u2500\u2500\u2500 Step ${r.step}: `) + theme.fg("accent", r.agent)} ${rIcon} ${coloredResultStatus(theme, r, currentIsRunning && r === currentResult)}`,
+            0,
+            0
+          )
+        );
+        container.addChild(new Text2(theme.fg("muted", "Task: ") + theme.fg("dim", r.task), 0, 0));
+        const policy = formatResultPolicy(r);
+        if (policy)
+          container.addChild(
+            new Text2(theme.fg("muted", "Policy:\n") + theme.fg("dim", policy), 0, 0)
+          );
+        if (rFailed && r.errorMessage)
+          container.addChild(new Text2(theme.fg("error", `Error: ${r.errorMessage}`), 0, 0));
+        for (const item of displayItems) {
+          if (item.type === "toolCall") {
+            container.addChild(
+              new Text2(
+                theme.fg("muted", "\u2192 ") + formatToolCall(item.name, item.args, theme.fg.bind(theme)),
+                0,
+                0
+              )
+            );
+          }
+        }
+        if (finalOutput) {
+          container.addChild(new Spacer(1));
+          container.addChild(new Markdown(finalOutput.trim(), 0, 0, mdTheme));
+        }
+        const stepUsage = formatResultUsageStats(r);
+        if (stepUsage) container.addChild(new Text2(theme.fg("dim", stepUsage), 0, 0));
+      }
+      const usageStr2 = formatUsageStats(aggregateUsage(details.results));
+      if (usageStr2) {
+        container.addChild(new Spacer(1));
+        container.addChild(new Text2(theme.fg("dim", `Total: ${usageStr2}`), 0, 0));
+      }
+      return container;
+    }
+    let text2 = icon + " " + theme.fg("toolTitle", theme.bold("chain ")) + theme.fg("accent", `${successCount}/${details.results.length} steps`) + ` \xB7 ${coloredStatus(theme, overallStatus)}`;
+    for (const r of details.results) {
+      const rFailed = isResultError(r);
+      const rIcon = rFailed ? theme.fg("error", "\u2717") : currentIsRunning && r === currentResult ? theme.fg("warning", "\u23F3") : theme.fg("success", "\u2713");
+      const collapsed = getCollapsedDisplayItems(r);
+      const finalOutput = getResultFinalOutput(r).trim();
+      text2 += `
+
+${theme.fg("muted", `\u2500\u2500\u2500 Step ${r.step}: `)}${theme.fg("accent", r.agent)} ${rIcon} ${coloredResultStatus(theme, r, currentIsRunning && r === currentResult)}`;
+      if (rFailed && r.errorMessage) text2 += `
+${theme.fg("error", `Error: ${r.errorMessage}`)}`;
+      if (collapsed.items.length > 0)
+        text2 += `
+${renderDisplayItems(collapsed.items, 5, collapsed.total)}`;
+      else if (currentIsRunning && r === currentResult)
+        text2 += `
+${theme.fg("muted", "(running...)")}`;
+      else if (finalOutput)
+        text2 += `
+${theme.fg("toolOutput", finalOutput.split("\n").slice(0, 3).join("\n"))}`;
+      else if (!rFailed || !r.errorMessage) text2 += `
+${theme.fg("muted", "(no output)")}`;
+    }
+    const usageStr = formatUsageStats(aggregateUsage(details.results));
+    if (usageStr) text2 += `
+
+${theme.fg("dim", `Total: ${usageStr}`)}`;
+    text2 += `
+${expansionHint()}`;
+    return new Text2(text2, 0, 0);
+  }
+  if (details.mode === "parallel" || details.mode === "workflow") {
+    const modeLabel = details.mode === "workflow" ? "workflow" : "parallel";
+    const resultIsRunning = (result2) => result2.exitCode === -1 && !isResultError(result2);
+    const running = details.results.filter(resultIsRunning).length;
+    const successCount = details.results.filter(
+      (result2) => result2.exitCode !== -1 && !isResultError(result2)
+    ).length;
+    const failCount = details.results.filter(isResultError).length;
+    const aggregator = details.aggregator;
+    const aggregatorFailed = aggregator ? isResultError(aggregator) : false;
+    const aggregatorRunning = aggregator ? !aggregatorFailed && (isPartial || aggregator.exitCode === -1) : false;
+    const pendingSuccessfulSettlement = isPartial && !aggregator && running === 0 && failCount === 0;
+    const isRunning = running > 0 || aggregatorRunning || pendingSuccessfulSettlement;
+    const icon = isRunning ? theme.fg("warning", "\u23F3") : failCount > 0 || aggregatorFailed ? theme.fg("warning", "\u25D0") : theme.fg("success", "\u2713");
+    const status = isRunning ? aggregatorRunning ? `${successCount + failCount}/${details.results.length} done, fan-in running` : running > 0 ? `${successCount + failCount}/${details.results.length} done, ${running} running` : `${successCount + failCount}/${details.results.length} done, running` : aggregator ? `${successCount}/${details.results.length} tasks + fan-in` : `${successCount}/${details.results.length} tasks`;
+    const overallStatus = isRunning ? "Running" : failCount > 0 || aggregatorFailed ? "Failed" : "Completed";
+    if (expanded && !isRunning) {
+      const container = new Container();
+      container.addChild(
+        new Text2(
+          `${icon} ${theme.fg("toolTitle", theme.bold(`${modeLabel} `))}${theme.fg("accent", status)} \xB7 ${coloredStatus(theme, overallStatus)}`,
+          0,
+          0
+        )
+      );
+      for (const r of details.results) {
+        const rFailed = isResultError(r);
+        const rIcon = rFailed ? theme.fg("error", "\u2717") : resultIsRunning(r) ? theme.fg("warning", "\u23F3") : theme.fg("success", "\u2713");
+        const displayItems = getDisplayItems(r.messages);
+        const finalOutput = getResultFinalOutput(r);
+        container.addChild(new Spacer(1));
+        container.addChild(
+          new Text2(
+            `${theme.fg("muted", "\u2500\u2500\u2500 ") + theme.fg("accent", r.agent)} ${rIcon} ${coloredResultStatus(theme, r, resultIsRunning(r))}`,
+            0,
+            0
+          )
+        );
+        container.addChild(new Text2(theme.fg("muted", "Task: ") + theme.fg("dim", r.task), 0, 0));
+        const policy = formatResultPolicy(r);
+        if (policy)
+          container.addChild(
+            new Text2(theme.fg("muted", "Policy:\n") + theme.fg("dim", policy), 0, 0)
+          );
+        if (rFailed && r.errorMessage)
+          container.addChild(new Text2(theme.fg("error", `Error: ${r.errorMessage}`), 0, 0));
+        for (const item of displayItems) {
+          if (item.type === "toolCall") {
+            container.addChild(
+              new Text2(
+                theme.fg("muted", "\u2192 ") + formatToolCall(item.name, item.args, theme.fg.bind(theme)),
+                0,
+                0
+              )
+            );
+          }
+        }
+        if (finalOutput) {
+          container.addChild(new Spacer(1));
+          container.addChild(new Markdown(finalOutput.trim(), 0, 0, mdTheme));
+        }
+        const taskUsage = formatResultUsageStats(r);
+        if (taskUsage) container.addChild(new Text2(theme.fg("dim", taskUsage), 0, 0));
+      }
+      if (aggregator) {
+        const rIcon = aggregatorFailed ? theme.fg("error", "\u2717") : aggregatorRunning ? theme.fg("warning", "\u23F3") : theme.fg("success", "\u2713");
+        const displayItems = getDisplayItems(aggregator.messages);
+        const finalOutput = getResultFinalOutput(aggregator);
+        container.addChild(new Spacer(1));
+        container.addChild(
+          new Text2(
+            `${theme.fg("muted", "\u2500\u2500\u2500 fan-in \u2192 ") + theme.fg("accent", aggregator.agent)} ${rIcon} ${coloredResultStatus(theme, aggregator, aggregatorRunning)}`,
+            0,
+            0
+          )
+        );
+        container.addChild(
+          new Text2(theme.fg("muted", "Task: ") + theme.fg("dim", aggregator.task), 0, 0)
+        );
+        const aggregatorPolicy = formatResultPolicy(aggregator);
+        if (aggregatorPolicy)
+          container.addChild(
+            new Text2(theme.fg("muted", "Policy:\n") + theme.fg("dim", aggregatorPolicy), 0, 0)
+          );
+        if (aggregatorFailed && aggregator.errorMessage)
+          container.addChild(
+            new Text2(theme.fg("error", `Error: ${aggregator.errorMessage}`), 0, 0)
+          );
+        for (const item of displayItems) {
+          if (item.type === "toolCall") {
+            container.addChild(
+              new Text2(
+                theme.fg("muted", "\u2192 ") + formatToolCall(item.name, item.args, theme.fg.bind(theme)),
+                0,
+                0
+              )
+            );
+          }
+        }
+        if (finalOutput) {
+          container.addChild(new Spacer(1));
+          container.addChild(new Markdown(finalOutput.trim(), 0, 0, mdTheme));
+        }
+        const fanInUsage = formatResultUsageStats(aggregator);
+        if (fanInUsage) container.addChild(new Text2(theme.fg("dim", fanInUsage), 0, 0));
+      }
+      const usageResults = aggregator ? [...details.results, aggregator] : details.results;
+      const usageStr = formatUsageStats(aggregateUsage(usageResults));
+      if (usageStr) {
+        container.addChild(new Spacer(1));
+        container.addChild(new Text2(theme.fg("dim", `Total: ${usageStr}`), 0, 0));
+      }
+      return container;
+    }
+    let text2 = `${icon} ${theme.fg("toolTitle", theme.bold(`${modeLabel} `))}${theme.fg("accent", status)} \xB7 ${coloredStatus(theme, overallStatus)}`;
+    for (const r of details.results) {
+      const rFailed = isResultError(r);
+      const rRunning = resultIsRunning(r);
+      const rIcon = rFailed ? theme.fg("error", "\u2717") : rRunning ? theme.fg("warning", "\u23F3") : theme.fg("success", "\u2713");
+      const collapsed = getCollapsedDisplayItems(r);
+      const finalOutput = getResultFinalOutput(r).trim();
+      text2 += `
+
+${theme.fg("muted", "\u2500\u2500\u2500 ")}${theme.fg("accent", r.agent)} ${rIcon} ${coloredResultStatus(theme, r, rRunning)}`;
+      if (rFailed && r.errorMessage) text2 += `
+${theme.fg("error", `Error: ${r.errorMessage}`)}`;
+      if (collapsed.items.length > 0)
+        text2 += `
+${renderDisplayItems(collapsed.items, 5, collapsed.total)}`;
+      else if (rRunning) text2 += `
+${theme.fg("muted", "(running...)")}`;
+      else if (finalOutput)
+        text2 += `
+${theme.fg("toolOutput", finalOutput.split("\n").slice(0, 3).join("\n"))}`;
+      else if (!rFailed || !r.errorMessage) text2 += `
+${theme.fg("muted", "(no output)")}`;
+    }
+    if (aggregator) {
+      const rIcon = aggregatorFailed ? theme.fg("error", "\u2717") : aggregatorRunning ? theme.fg("warning", "\u23F3") : theme.fg("success", "\u2713");
+      const collapsed = getCollapsedDisplayItems(aggregator);
+      const finalOutput = getResultFinalOutput(aggregator).trim();
+      text2 += `
+
+${theme.fg("muted", "\u2500\u2500\u2500 fan-in \u2192 ")}${theme.fg("accent", aggregator.agent)} ${rIcon} ${coloredResultStatus(theme, aggregator, aggregatorRunning)}`;
+      if (aggregatorFailed && aggregator.errorMessage)
+        text2 += `
+${theme.fg("error", `Error: ${aggregator.errorMessage}`)}`;
+      if (collapsed.items.length > 0)
+        text2 += `
+${renderDisplayItems(collapsed.items, 5, collapsed.total)}`;
+      else if (aggregatorRunning) text2 += `
+${theme.fg("muted", "(running...)")}`;
+      else if (finalOutput)
+        text2 += `
+${theme.fg("toolOutput", finalOutput.split("\n").slice(0, 3).join("\n"))}`;
+      else if (!aggregatorFailed || !aggregator.errorMessage)
+        text2 += `
+${theme.fg("muted", "(no output)")}`;
+    }
+    if (!isRunning) {
+      const usageResults = aggregator ? [...details.results, aggregator] : details.results;
+      const usageStr = formatUsageStats(aggregateUsage(usageResults));
+      if (usageStr) text2 += `
+
+${theme.fg("dim", `Total: ${usageStr}`)}`;
+    }
+    if (!expanded) text2 += `
+${expansionHint()}`;
+    return new Text2(text2, 0, 0);
+  }
+  const text = result.content[0];
+  return new Text2(
+    text?.type === "text" ? safeBlock(text.text, "(no output)", 8 * 1024) : "(no output)",
+    0,
+    0
+  );
+}
+
+// src/subagents-extension.ts
+function subagents_extension_default(pi, dependencies = {}) {
+  pi.registerMessageRenderer(SUBAGENT_COMPLETION_MESSAGE_TYPE, renderCompletionMessage);
+  const loadBlockingExecution = cachedModuleLoader(
+    dependencies.loadBlockingExecution ?? (() => import("./chunks/execution-DS2DEIQZ.js"))
+  );
+  const configOwner = registerSubagentConfigLifecycle(pi);
+  const settings = readSubagentSettings();
+  let currentSettings = settings;
+  let currentCatalog = "";
+  const blockingEnabled = settings?.blocking?.enabled !== false;
+  const refreshBlockingCatalog = blockingEnabled ? registerBlockingSubagent(pi, () => currentSettings, loadBlockingExecution) : () => void 0;
+  let refreshStatefulCatalog = () => void 0;
+  let refreshConsultCatalog = () => void 0;
+  pi.on("session_start", (_event, ctx) => {
+    const loadNotice = consumeSubagentSettingsNotice();
+    const refreshedSettings = readSubagentSettings();
+    const refreshedNotice = consumeSubagentSettingsNotice();
+    if (!inspectSubagentSettings().error) currentSettings = refreshedSettings;
+    const notice = [
+      ...new Set([loadNotice, refreshedNotice].filter((value) => value !== void 0))
+    ].join("\n");
+    if (notice) ctx.ui.notify(notice, "warning");
+    currentCatalog = formatAgentCatalog(
+      discoverAgentCatalog(ctx.cwd, ctx.isProjectTrusted(), refreshedSettings)
+    ).text;
+    refreshBlockingCatalog(currentCatalog);
+    refreshStatefulCatalog(currentCatalog);
+    refreshConsultCatalog(currentCatalog);
+  });
+  const statefulRuntime = registerStatefulSubagents(pi, {
+    blockingEnabled,
+    settings: settings?.stateful,
+    getSettings: () => currentSettings,
+    loadTransport: dependencies.loadStatefulTransport
+  });
+  refreshStatefulCatalog = statefulRuntime.setAgentCatalog;
+  const getBlockingEnabled = () => blockingEnabled;
+  const getMaxParallelTasks = () => resolveBlockingMaxParallelTasks(currentSettings);
+  const getConsultResourcePolicy = () => currentSettings?.consult?.resources ?? DEFAULT_CONSULT_RESOURCE_POLICY;
+  const getConsultationCwdPolicy = () => currentSettings?.cwdPolicy?.consultation ?? DEFAULT_CONSULTATION_CWD_POLICY;
+  const getDelegationCwdPolicy = () => currentSettings?.cwdPolicy?.delegation ?? DEFAULT_DELEGATION_CWD_POLICY;
+  registerSubagentInspect(
+    pi,
+    {
+      ...statefulRuntime,
+      getBlockingEnabled,
+      getMaxParallelTasks,
+      getConsultResourcePolicy,
+      getConsultationCwdPolicy,
+      getDelegationCwdPolicy
+    },
+    dependencies.inspect
+  );
+  if (blockingEnabled) {
+    refreshConsultCatalog = registerSubagentConsult(
+      pi,
+      { getSettings: () => currentSettings },
+      dependencies.consult
+    );
+  }
+  registerSubagentConfigCommand(
+    pi,
+    {
+      ...statefulRuntime,
+      getBlockingEnabled,
+      getMaxParallelTasks,
+      getConsultResourcePolicy,
+      getConsultationCwdPolicy,
+      getDelegationCwdPolicy,
+      setMaxParallelTasks(value) {
+        const previousSettings = currentSettings;
+        currentSettings = {
+          ...currentSettings ?? {},
+          blocking: { ...currentSettings?.blocking ?? {}, maxParallelTasks: value }
+        };
+        try {
+          refreshBlockingCatalog(currentCatalog);
+        } catch (applyError) {
+          currentSettings = previousSettings;
+          try {
+            refreshBlockingCatalog(currentCatalog);
+          } catch (rollbackError) {
+            throw new AggregateError(
+              [applyError, rollbackError],
+              "Failed to apply and roll back the parallel-worker limit"
+            );
+          }
+          throw applyError;
+        }
+      },
+      setConsultResourcePolicy(value) {
+        currentSettings = {
+          ...currentSettings ?? {},
+          consult: { ...currentSettings?.consult ?? {}, resources: value }
+        };
+        refreshConsultCatalog(currentCatalog);
+      },
+      setConsultationCwdPolicy(value) {
+        currentSettings = {
+          ...currentSettings ?? {},
+          cwdPolicy: { ...currentSettings?.cwdPolicy ?? {}, consultation: value }
+        };
+        refreshConsultCatalog(currentCatalog);
+      },
+      setDelegationCwdPolicy(value) {
+        currentSettings = {
+          ...currentSettings ?? {},
+          cwdPolicy: { ...currentSettings?.cwdPolicy ?? {}, delegation: value }
+        };
+        refreshBlockingCatalog(currentCatalog);
+        statefulRuntime.refreshSettingsGuidance();
+      }
+    },
+    configOwner,
+    dependencies.config
+  );
+}
+function registerBlockingSubagent(pi, getSettings, loadExecution) {
+  let catalog = "";
+  const activeControllers = /* @__PURE__ */ new Set();
+  const activeWork = /* @__PURE__ */ new Set();
+  const cancelAndWaitForWork = async (reason) => {
+    for (const controller of activeControllers) {
+      controller.abort(new DOMException(reason, "AbortError"));
+    }
+    await Promise.allSettled([...activeWork]);
+  };
+  pi.on("session_start", () => cancelAndWaitForWork("Blocking subagent session replaced"));
+  pi.on("session_shutdown", () => cancelAndWaitForWork("Blocking subagent session shut down"));
+  const baseDescription = () => [
+    "Run specialized subagents as a blocking operation with isolated contexts.",
+    "The call blocks the main agent until every worker and optional aggregator finishes, so queued steering waits.",
+    "Modes: single (agent + task), parallel (tasks array), chain (sequential with {previous} placeholder), workflow (named dependency tasks with optional capability routing), or panel (independent reviewers plus evidence-preserving synthesis).",
+    "Parallel mode may include an aggregator fan-in step; workflow mode validates dependencies, authority, artifacts, scope conflicts, retries, and hedging before scheduling. Use subagent_consult instead for one synchronous child that must be executor-constrained to read-only tools.",
+    'Default agent scope is "user" (from ~/.pi/agent/agents).',
+    `To enable project-local agents in ${CONFIG_DIR_NAME}/agents, pass agentScope: "both" (or "project") as a top-level argument for that call.`,
+    `Maximum parallel worker tasks per call: ${resolveBlockingMaxParallelTasks(getSettings())}. Parallel execution starts at most ${MAX_BLOCKING_PARALLEL_CONCURRENCY} workers at once.`,
+    `Working-directory target policy: ${getSettings()?.cwdPolicy?.delegation ?? DEFAULT_DELEGATION_CWD_POLICY}. This controls launch targets and protected project resources, not filesystem access or sandboxing.`
+  ].join(" ");
+  const promptGuidelines = () => [
+    "Use subagent only when delegation fits; the main agent should decide how many subagents to spawn from task shape instead of waiting for the user to specify a count.",
+    "The main agent retains overall planning, immediate critical-path work, integration, final verification, and the final answer.",
+    "Use no subagent for simple answers, quick targeted edits, latency-sensitive one-step work, tasks requiring frequent user back-and-forth, or critical-path work the main agent can perform directly.",
+    "One ordinary implementation worker should not replace work the main agent can perform directly; use a blocking single only when intentional synchronous isolation or a user-requested specialist justifies waiting.",
+    "Keep ordinary planning in the main agent, or use explicit workflow mode when a genuine dependency graph requires caller-authored orchestration.",
+    "Keep ordinary review in the main agent with a review skill and deterministic checks; reserve panel mode or custom verifier agents for consequential independent verification.",
+    "Use the blocking subagent tool only when delegated outputs are required before the main agent's next action and waiting is intentional; the main agent cannot process queued steering until the call returns.",
+    "Use a blocking subagent single, parallel, chain, workflow, panel, or fan-in call only when synchronous context or output isolation is worth making the main agent unavailable while it runs.",
+    `If a blocking parallel subagent call is genuinely required, keep tasks independent, stay within the configured max ${resolveBlockingMaxParallelTasks(getSettings())}, and avoid write-heavy implementation touching the same files or shared state.`,
+    "For parallel subagent calls, omit the aggregator key entirely unless a fan-in step is required; do not send null, empty strings, or an empty object for unused optional fields.",
+    "Use workflow mode for explicit dependencies or capability routing; declare read/write or ownership scopes, require structured-v2 artifacts when downstream tasks consume them, and use retry or hedging only with the required side-effect contract.",
+    "Use panel mode only for consequential review or research that benefits from at least two independent reviewers and one bounded synthesis; agreement is not proof, dissent and blocking objections remain visible, and simple or latency-sensitive work should not use a panel.",
+    'Do not use subagent with project-local agents unless the user explicitly wants project agents or sets agentScope to "project" or "both"; keep confirmation enabled for untrusted repositories.',
+    "When using subagent, write self-contained tasks with file paths, context, expected output, and whether the subagent may edit files.",
+    "Set subagent timeoutMs to the shortest realistic work deadline for the task difficulty, just as thinkingLevel should match reasoning difficulty; split oversized tasks instead of extending the deadline merely to compensate for broad scope. Use totalTimeoutMs to cap an entire blocking workflow, idleTimeoutMs for stalled work, and maxTurns or maxToolCalls to stop repeated work without progress. Every budget stop preserves a bounded checkpoint and may make one separately bounded summary attempt."
+  ];
+  const definition = {
+    name: "subagent",
+    label: "Blocking Subagent",
+    description: appendAgentCatalog(baseDescription(), catalog),
+    promptSnippet: "Run blocking isolated subagents only when their outputs are required before the main agent can continue.",
+    promptGuidelines: promptGuidelines(),
+    parameters: SubagentParams,
+    async execute(toolCallId, params, signal, onUpdate, ctx) {
+      const lifecycleController = new AbortController();
+      activeControllers.add(lifecycleController);
+      const effectiveSignal = signal ? AbortSignal.any([signal, lifecycleController.signal]) : lifecycleController.signal;
+      const work = (async () => {
+        throwIfAborted(effectiveSignal, "Blocking subagent execution was cancelled");
+        let executionModule;
+        try {
+          executionModule = await loadExecution();
+        } catch (error) {
+          throwIfAborted(
+            effectiveSignal,
+            "Blocking subagent execution was cancelled while loading"
+          );
+          throw error;
+        }
+        throwIfAborted(effectiveSignal, "Blocking subagent execution was cancelled while loading");
+        return executionModule.executeSubagent(
+          toolCallId,
+          params,
+          effectiveSignal,
+          onUpdate,
+          ctx,
+          getSettings()
+        );
+      })();
+      activeWork.add(work);
+      try {
+        return await work;
+      } finally {
+        activeControllers.delete(lifecycleController);
+        activeWork.delete(work);
+      }
+    },
+    renderCall(args, theme) {
+      return renderSubagentCall(args, theme);
+    },
+    renderResult(result, options, theme) {
+      return renderSubagentResult(result, options, theme);
+    }
+  };
+  pi.registerTool(definition);
+  pi.on("tool_result", (event) => {
+    if (event.toolName !== "subagent") return;
+    if (event.details?.isError)
+      return { isError: true };
+  });
+  return (nextCatalog) => {
+    catalog = nextCatalog;
+    definition.description = appendAgentCatalog(baseDescription(), catalog);
+    definition.promptGuidelines = promptGuidelines();
+    pi.registerTool(definition);
+  };
+}
+function appendAgentCatalog(baseDescription, catalog) {
+  return catalog ? `${baseDescription}
+
+${catalog}` : baseDescription;
+}
+export {
+  subagents_extension_default as default
+};
+//# sourceMappingURL=index.ts.map