@hheei/pi-subagents 0.2.3 → 0.3.0

package/dist/domain.d.ts

@@ -67,6 +67,11 @@ export interface Selection {
 /** Extensions and skills are selected the same way; the aliases keep the two roles named. */
 export type ExtensionSelection = Selection;
 export type SkillSelection = Selection;
+export interface McpSelection {
+    readonly enabled: boolean;
+    readonly servers?: readonly string[];
+    readonly excluded?: readonly string[];
+}
 export interface EffectiveLaunchConfig {
     /** Logical child id; the same value the child bridge reports back. */
     readonly subagentId: string;
@@ -77,8 +82,6 @@ export interface EffectiveLaunchConfig {
     readonly sessionDir: string;
     /** Known only once the session has been flushed to disk. */
     readonly sessionPath?: string;
-    /** Optional path to a prior session JSONL file referenced for on-demand context inspection. */
-    readonly referencedSessionPath?: string;
     readonly agent: ResolvedAgentIdentity;
     readonly model: ResolvedModel;
     readonly thinking: ResolvedThinking;
@@ -86,10 +89,9 @@ export interface EffectiveLaunchConfig {
     readonly excludeTools: readonly string[];
     readonly extensions: ExtensionSelection;
     readonly skills: SkillSelection;
+    readonly mcp: McpSelection;
     readonly prompt: string;
     readonly bridgeExtensionPath: string;
-    /** Frozen at spawn. Interactive children do not auto-wake the parent except via contact_parent. */
-    readonly interactive: boolean;
     /** Whether the subagent operates in codemode-only mode. */
     readonly codemodeOnly?: boolean;
     /**
@@ -106,7 +108,7 @@ export interface ResolvedAgentPolicy {
     readonly excludeTools: readonly string[];
     readonly extensions: ExtensionSelection;
     readonly skills: SkillSelection;
-    readonly interactive: boolean;
+    readonly mcp: McpSelection;
     readonly codemodeOnly?: boolean;
     readonly enabled?: boolean;
 }
@@ -150,18 +152,20 @@ export interface SubagentRecord {
 }
 export interface PublicSubagent {
     readonly id: string;
+    /** Pi-assigned session file path; the first write may still be pending. */
+    readonly path?: string;
     readonly agent: string;
     readonly displayName?: string;
     readonly state: SubagentState;
     readonly presentation: Presentation;
     readonly cwd: string;
     readonly sessionId: string;
+    readonly task?: string;
     readonly summary?: string;
     readonly activeTool?: string;
     readonly usage?: UsageSummary;
     readonly interrupted?: string;
     readonly freshness: "live" | "last_known";
-    readonly interactive: boolean;
     readonly model: ResolvedModel;
     readonly thinking: ResolvedThinking;
     readonly createdAt: string;
@@ -183,21 +187,17 @@ export interface SpawnSubagentInput {
      * Where to run this child. `auto` (the default) means a panel whenever this parent has a
      * presentation host, and the background otherwise; the Task tool pins `background` because a
      * Task is settled by its parent and never handed to a human. This is not a model-facing
-     * parameter: `spawn_agent` always spawns with `auto`.
+     * parameter: `agent_spawn` always spawns with `auto`.
      */
     readonly presentation?: Presentation | "auto";
     /** Optional child session title; the child branch prefixes it with the subagent marker. */
     readonly title?: string;
-    /**
-     * Optional session or agent to fork context from (e.g. 'parent', or a subagent id like 'agent-1').
-     * Thinking blocks are stripped and context is compacted if pi-ext-memory is active.
-     */
-    readonly forkFrom?: string;
 }
 /** True when a manager call returned a structured failure instead of a value. */
 export declare function isOperationError(value: unknown): value is OperationError;
 /** Child bridge tool name; agent tool policy must never remove it. */
 export declare const CONTACT_PARENT_TOOL_NAME: "contact_parent";
+export declare const DEFAULT_PI_TOOLS: readonly ["read", "bash", "edit", "write"];
 /** Environment contract between a parent launch and the child branch of this extension. */
 export declare const BRIDGE_ENVIRONMENT_KEYS: {
     readonly parentSessionId: "PI_SUBAGENTS_PARENT_SESSION_ID";

package/dist/domain.js

@@ -10,12 +10,12 @@ export function normalizeSubagentState(value) {
         case "idle":
             return "running";
         case "done":
+        case "stopped":
             return "done";
         case "blocked":
             return "blocked";
         case "error":
         case "failed":
-        case "stopped":
             return "error";
         default:
             return undefined;
@@ -53,6 +53,7 @@ export function isOperationError(value) {
 }
 /** Child bridge tool name; agent tool policy must never remove it. */
 export const CONTACT_PARENT_TOOL_NAME = "contact_parent";
+export const DEFAULT_PI_TOOLS = ["read", "bash", "edit", "write"];
 /** Environment contract between a parent launch and the child branch of this extension. */
 export const BRIDGE_ENVIRONMENT_KEYS = {
     parentSessionId: "PI_SUBAGENTS_PARENT_SESSION_ID",

package/dist/extension.d.ts

@@ -1,9 +1,10 @@
-import type { ExtensionAPI, Skill } from "@earendil-works/pi-coding-agent";
+import type { ExtensionAPI, ExtensionUIContext, Skill } from "@earendil-works/pi-coding-agent";
 import { type BackgroundDelivery } from "@hheei/pi-ext-core";
-import type { SkillCatalogEntry } from "./agent-resolver.js";
+import { type SkillCatalogEntry } from "./agent-resolver.js";
 import { type ParentChannel } from "./manager.js";
 /** Parent channel plus the teardown its owner must call. */
 export interface ParentChannelHandle extends ParentChannel {
+    dismiss(childId: string): void;
     /** Unregisters delivery and appends anything still held without waking the parent. */
     dispose(): void;
 }
@@ -14,8 +15,9 @@ export interface ParentChannelHandle extends ParentChannel {
  * background work finishes; decision requests and blockers bypass that wait. The shared gate
  * coordinates this channel with Task/Bash results so only one message requests a new idle turn.
  */
-export declare function createParentChannel(pi: Pick<ExtensionAPI, "sendMessage" | "on">, deps: {
+export declare function createParentChannel(pi: Pick<ExtensionAPI, "sendMessage" | "on" | "appendEntry">, deps: {
     readonly isIdle: () => boolean;
+    readonly ui: Pick<ExtensionUIContext, "notify">;
     readonly delivery: BackgroundDelivery;
     readonly signal?: AbortSignal;
 }): ParentChannelHandle;

package/dist/extension.js

@@ -1,21 +1,23 @@
 import { errorMessage, getBackgroundDelivery, registerExtensionLifecycle, TASK_REGISTRY_SERVICE_KEY, waitForService, } from "@hheei/pi-ext-core";
+import { discoverAgents } from "./agent-resolver.js";
 import { ChildBridgeServer } from "./bridge-server.js";
 import { registerChildBridge } from "./child-bridge.js";
-import { bindParentStatus, registerParentCommands } from "./commands.js";
+import { registerParentCommands } from "./commands.js";
 import { BRIDGE_ENVIRONMENT_KEYS, isThinkingLevel } from "./domain.js";
 import { createCmuxHostAdapter, createHerdrHostAdapter, selectHostAdapter, } from "./host-adapter.js";
+import { appendSubagentInfo, displaySubagentText, registerSubagentInfo } from "./info.js";
 import { SubagentManager } from "./manager.js";
 import { transformSubagentsMarkdown } from "./markdown.js";
 import { createSubagentRegistry } from "./registry.js";
 import { createRuntimeTokenStore, launchChild, openChildPanel, parentBridgeEndpoint, prepareRuntimeDirectory, } from "./runtime.js";
 import { persistSubagentIntent, resolveSubagentLaunch } from "./session-bootstrap.js";
-import { resolveForkSessionReference } from "./session-fork.js";
+import { createSubagentStatus } from "./status.js";
 import { registerInteractiveToolActivation } from "./tool-activation.js";
 import { registerParentTools } from "./tools.js";
-import { createSubagentWidget } from "./widget.js";
 const CHILD_ENV_KEYS = Object.values(BRIDGE_ENVIRONMENT_KEYS);
 /** How long startup waits for a child that survived a parent restart to reconnect its bridge. */
 const ADOPT_WINDOW_MS = 5_000;
+const START_WINDOW_MS = 20_000;
 function diagnose(message) {
     if (process.env.DEBUG || process.env.PI_SUBAGENTS_DEBUG) {
         console.error(`pi-subagents: ${message}`);
@@ -53,7 +55,9 @@ export function createParentChannel(pi, deps) {
     const flush = (triggerTurn, urgentOnly = false) => {
         if (held.length === 0)
             return;
-        const reports = urgentOnly ? held.filter((report) => report.reason === "blocked") : [...held];
+        const reports = urgentOnly
+            ? held.filter((report) => report.reason === "blocked" || report.reason === "error")
+            : [...held];
         if (reports.length === 0)
             return;
         for (const report of reports)
@@ -62,7 +66,7 @@ export function createParentChannel(pi, deps) {
             pi.sendMessage({
                 customType: "subagent-report",
                 content: reports.map(reportText).join("\n\n"),
-                display: true,
+                display: false,
                 details: { reports },
             }, { triggerTurn, deliverAs: "steer" });
         }
@@ -70,6 +74,15 @@ export function createParentChannel(pi, deps) {
             held.unshift(...reports);
             throw error;
         }
+        for (const report of reports) {
+            try {
+                appendSubagentInfo(pi, report);
+            }
+            catch (error) {
+                // The model already received this batch; an entry failure must not resend it.
+                deps.ui.notify(displaySubagentText(`Could not display subagent report for ${report.childId}: ${errorMessage(error)}`), "error");
+            }
+        }
     };
     const registration = deps.delivery.registerChannel({
         isIdle: deps.isIdle,
@@ -83,7 +96,12 @@ export function createParentChannel(pi, deps) {
             if (disposed)
                 throw new Error("Parent report channel is disposed");
             held.push(report);
-            registration.request(report.reason === "blocked");
+            registration.request(report.reason === "blocked" || report.reason === "error");
+        },
+        dismiss(childId) {
+            const index = held.findIndex((report) => report.childId === childId);
+            if (index !== -1)
+                held.splice(index, 1);
         },
         dispose() {
             disposed = true;
@@ -112,6 +130,7 @@ export default function piSubagentsExtension(pi) {
         registerChildBridge(pi, child);
         return;
     }
+    registerSubagentInfo(pi);
     registerExtensionLifecycle(pi, {
         key: "@hheei/pi-subagents",
         async start(runtime) {
@@ -133,6 +152,7 @@ export default function piSubagentsExtension(pi) {
             const delivery = getBackgroundDelivery(pi);
             const channel = createParentChannel(pi, {
                 isIdle: () => context.isIdle(),
+                ui: context.ui,
                 delivery,
                 signal: runtime.signal,
             });
@@ -173,7 +193,8 @@ export default function piSubagentsExtension(pi) {
             // the only name → path catalog; Pi hands it over before every prompt of this session.
             let skillCatalog = [];
             const unsubscribeSkillCatalog = pi.on("before_agent_start", (event) => {
-                skillCatalog = skillCatalogFromLoaded(event.systemPromptOptions.skills);
+                const skills = event.systemPromptOptions?.skills ?? [];
+                skillCatalog = skillCatalogFromLoaded(skills);
             });
             runtime.resources.add("subagent-skill-catalog", unsubscribeSkillCatalog);
             manager = new SubagentManager({
@@ -191,27 +212,6 @@ export default function piSubagentsExtension(pi) {
                     }
                     const records = await registry.list().catch(() => []);
                     const existingSubagentIds = records.map((record) => record.subagentId);
-                    let referencedSessionPath;
-                    const forkTarget = input.forkFrom?.trim();
-                    if (forkTarget !== undefined && forkTarget !== "") {
-                        try {
-                            if (forkTarget === "current") {
-                                throw new Error("forkFrom cannot be 'current'. Use 'parent' to reference the parent session or specify a subagent id like 'agent-1'.");
-                            }
-                            const parentSessionFile = context.sessionManager.getSessionFile();
-                            referencedSessionPath = await resolveForkSessionReference({
-                                forkFrom: forkTarget,
-                                ...(parentSessionFile === undefined
-                                    ? {}
-                                    : { parentSessionPath: parentSessionFile }),
-                                registry,
-                                onWarning: (message) => context.ui.notify(message, "warning"),
-                            });
-                        }
-                        catch (error) {
-                            context.ui.notify(`Referencing session failed: ${errorMessage(error)}; starting fresh session without reference`, "warning");
-                        }
-                    }
                     return resolveSubagentLaunch({
                         input,
                         cwd: context.cwd,
@@ -219,8 +219,6 @@ export default function piSubagentsExtension(pi) {
                         skillCatalog,
                         existingSubagentIds,
                         enforceEnabled: true,
-                        onWarning: (message) => context.ui.notify(message, "warning"),
-                        ...(referencedSessionPath === undefined ? {} : { referencedSessionPath }),
                         parent: {
                             model: { provider: model.provider, id: model.id },
                             thinking,
@@ -237,7 +235,7 @@ export default function piSubagentsExtension(pi) {
                         record,
                         tokens,
                         waitForBridge: (childId, signal) => server.waitForConnection(childId, {
-                            timeoutMs: ADOPT_WINDOW_MS,
+                            timeoutMs: START_WINDOW_MS,
                             ...(signal === undefined ? {} : { signal }),
                         }),
                         signal: runtime.signal,
@@ -254,7 +252,7 @@ export default function piSubagentsExtension(pi) {
                                 tokens,
                                 host: hostSelection.adapter,
                                 waitForBridge: (childId, signal) => server.waitForConnection(childId, {
-                                    timeoutMs: ADOPT_WINDOW_MS,
+                                    timeoutMs: START_WINDOW_MS,
                                     ...(signal === undefined ? {} : { signal }),
                                 }),
                                 signal: runtime.signal,
@@ -294,7 +292,7 @@ export default function piSubagentsExtension(pi) {
                     .map((failure) => `- ${failure.childId}: ${failure.reason}`)
                     .join("\n")}`, "error");
             }
-            registerParentTools(pi, manager);
+            registerParentTools(pi, manager, await discoverAgents(context.cwd));
             if (typeof pi.registerMarkdownTransformer === "function") {
                 pi.registerMarkdownTransformer(transformSubagentsMarkdown);
             }
@@ -315,26 +313,26 @@ export default function piSubagentsExtension(pi) {
                 .catch((error) => {
                 diagnose(`Task registry service unavailable for subagents: ${errorMessage(error)}`);
             });
-            const widget = createSubagentWidget(pi, context, runtime.signal);
-            const refreshWidget = () => {
+            const status = createSubagentStatus(context.ui, runtime.signal);
+            let refreshVersion = 0;
+            const refreshStatus = () => {
                 if (runtime.signal.aborted)
                     return;
+                const version = ++refreshVersion;
                 void manager
                     .list()
                     .then((children) => {
-                    if (runtime.signal.aborted)
+                    if (runtime.signal.aborted || version !== refreshVersion)
                         return;
-                    widget?.refresh(children);
+                    status.refresh(children);
                 })
-                    .catch(() => { });
+                    .catch((error) => diagnose(`Subagent status failed: ${errorMessage(error)}`));
             };
-            const unsubscribe = manager.onChange(refreshWidget);
-            const unbindStatus = bindParentStatus(pi, context, manager, runtime.signal);
-            refreshWidget();
-            runtime.resources.add("subagent-widget", () => {
+            const unsubscribe = manager.onChange(refreshStatus);
+            refreshStatus();
+            runtime.resources.add("subagent-status", () => {
                 unsubscribe();
-                unbindStatus();
-                widget?.dispose();
+                status.dispose();
             });
             runtime.resources.add("subagent-manager", () => manager.closeLocalConnections());
         },

package/dist/host-adapter.js

@@ -180,7 +180,7 @@ export function createCmuxHostAdapter(options) {
                 noun: "surface",
                 // TODO(cmux-focus): cmux does not report which surface a human is looking at, so
                 // observation cannot answer `focused` and idle reclaim fails open here: a cmux child
-                // is only ever closed by stop_agent.
+                // is only ever closed by agent_stop.
                 reportsFocus: false,
                 observe: async () => {
                     const process = await runner.run("cmux", ["--json", "list-panels"], { timeoutMs });

package/dist/info.d.ts

@@ -0,0 +1,9 @@
+import type { ExtensionAPI, Theme } from "@earendil-works/pi-coding-agent";
+import type { ParentChannelReport } from "./manager.js";
+export declare const SUBAGENT_INFO_TYPE = "subagent-info";
+/** Keep line breaks, expand tabs, and remove terminal control characters from child text. */
+export declare function displaySubagentText(text: string): string;
+export declare function renderSubagentInfo(data: unknown, expanded: boolean, theme: Pick<Theme, "fg">): string | undefined;
+/** Native transcript entries survive resume and never enter the model context. */
+export declare function registerSubagentInfo(pi: Pick<ExtensionAPI, "registerEntryRenderer">): void;
+export declare function appendSubagentInfo(pi: Pick<ExtensionAPI, "appendEntry">, report: ParentChannelReport): void;

package/dist/info.js

@@ -0,0 +1,54 @@
+import { stripVTControlCharacters } from "node:util";
+import { Text } from "@earendil-works/pi-tui";
+import { Type } from "typebox";
+import { Value } from "typebox/value";
+import { VISUAL_SUBAGENT_GLYPH, VISUAL_SUBAGENT_TONE } from "./domain.js";
+import { formatSubagentId } from "./status.js";
+export const SUBAGENT_INFO_TYPE = "subagent-info";
+const infoSchema = Type.Object({
+    id: Type.String(),
+    agent: Type.String(),
+    status: Type.Union([
+        Type.Literal("running"),
+        Type.Literal("done"),
+        Type.Literal("blocked"),
+        Type.Literal("error"),
+    ]),
+    message: Type.String(),
+});
+/** Keep line breaks, expand tabs, and remove terminal control characters from child text. */
+export function displaySubagentText(text) {
+    return stripVTControlCharacters(text)
+        .replaceAll("\t", "    ")
+        .replace(/[\u0000-\u0008\u000b-\u001f\u007f-\u009f]/gu, "");
+}
+export function renderSubagentInfo(data, expanded, theme) {
+    if (!Value.Check(infoSchema, data))
+        return undefined;
+    const id = formatSubagentId(displaySubagentText(data.id).replace(/\s+/gu, " "));
+    const agent = displaySubagentText(data.agent).replace(/\s+/gu, " ");
+    const heading = theme.fg("dim", "info · agents · ") +
+        theme.fg(VISUAL_SUBAGENT_TONE[data.status], VISUAL_SUBAGENT_GLYPH[data.status]) +
+        theme.fg("dim", ` ${id} ${agent} · ${data.status}`);
+    return expanded ? `${heading}\n${displaySubagentText(data.message)}` : heading;
+}
+/** Native transcript entries survive resume and never enter the model context. */
+export function registerSubagentInfo(pi) {
+    pi.registerEntryRenderer(SUBAGENT_INFO_TYPE, (entry, options, theme) => {
+        const text = renderSubagentInfo(entry.data, options.expanded, theme);
+        return text === undefined ? undefined : new Text(text, 1, 0);
+    });
+}
+export function appendSubagentInfo(pi, report) {
+    const status = report.reason === "success"
+        ? "done"
+        : report.reason === "blocked" || report.reason === "error"
+            ? report.reason
+            : report.status;
+    pi.appendEntry(SUBAGENT_INFO_TYPE, {
+        id: report.childId,
+        agent: report.agent,
+        status,
+        message: report.message,
+    });
+}

package/dist/launch-spec.d.ts

@@ -16,7 +16,6 @@ export interface LaunchSpec {
     readonly env: Readonly<Record<string, string>>;
     readonly config: EffectiveLaunchConfig;
 }
-export declare const HINDSIGHT_TOOLS: readonly ["hindsight_search_knowledge_pages", "hindsight_list_knowledge_pages", "hindsight_read_knowledge_page", "hindsight_reflect", "hindsight_capture_initiative", "hindsight_ingest_document", "hindsight_sync_status", "hindsight_diagnose"];
 export declare function stripHindsightContent(text: string): string;
 export interface BuildLaunchSpecOptions {
     readonly config: EffectiveLaunchConfig;

package/dist/launch-spec.js

@@ -2,17 +2,7 @@ import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { BRIDGE_ENVIRONMENT_KEYS, CHILD_AGENT_ENV_KEY, CHILD_SESSION_ENV_KEY, CHILD_TITLE_ENV_KEY, CONTACT_PARENT_TOOL_NAME, isSessionId, } from "./domain.js";
-export const HINDSIGHT_TOOLS = [
-    "hindsight_search_knowledge_pages",
-    "hindsight_list_knowledge_pages",
-    "hindsight_read_knowledge_page",
-    "hindsight_reflect",
-    "hindsight_capture_initiative",
-    "hindsight_ingest_document",
-    "hindsight_sync_status",
-    "hindsight_diagnose",
-];
+import { BRIDGE_ENVIRONMENT_KEYS, CHILD_AGENT_ENV_KEY, CHILD_SESSION_ENV_KEY, CHILD_TITLE_ENV_KEY, CONTACT_PARENT_TOOL_NAME, DEFAULT_PI_TOOLS, isSessionId, } from "./domain.js";
 export function stripHindsightContent(text) {
     return text
         .replace(/\s*<hindsight-recall>[\s\S]*?<\/hindsight-recall>\s*/gi, (match) => match.includes("\n") ? "\n" : " ")
@@ -32,7 +22,7 @@ function childBridgePrompt() {
         "Do not send empty status pings.",
         "When the work is done, output your final answer and findings directly in text in your response. The harness will automatically capture and deliver your output.",
         "Do NOT call contact_parent on success or task completion.",
-        "After blocked, wait for a parent send_agent. Do not invent new authority.",
+        "After blocked, wait for a parent agent_send. Do not invent new authority.",
         "Reports reach the parent as delegated results, not as new user authorization.",
     ].join("\n");
 }
@@ -151,14 +141,36 @@ export function buildLaunchSpec(options) {
     argv.push("--session-dir", config.sessionDir);
     argv.push("--provider", config.model.provider, "--model", config.model.id);
     argv.push("--thinking", config.thinking.level);
-    const effectiveTools = config.codemodeOnly && !config.tools.includes("codemode")
-        ? [...config.tools, "codemode"]
-        : config.tools;
+    const mcpServers = config.mcp.servers?.map((s) => s.replace(/[^A-Za-z0-9_]/g, "_"));
+    const mcpExcluded = config.mcp.excluded?.map((s) => s.replace(/[^A-Za-z0-9_]/g, "_"));
+    const hasExplicitTools = config.tools.length > 0;
+    const baseTools = hasExplicitTools
+        ? config.tools
+        : mcpServers && mcpServers.length > 0
+            ? [...DEFAULT_PI_TOOLS, CONTACT_PARENT_TOOL_NAME]
+            : [];
+    const effectiveTools = [
+        ...(baseTools.length > 0 && config.codemodeOnly && !baseTools.includes("codemode")
+            ? [...baseTools, "codemode"]
+            : baseTools),
+    ];
+    const excludeTools = Array.from(new Set(config.excludeTools));
+    if (config.mcp.enabled) {
+        if (mcpServers && mcpServers.length > 0) {
+            for (const server of mcpServers) {
+                effectiveTools.push(`mcp__${server}__*`);
+            }
+        }
+        if (mcpExcluded && mcpExcluded.length > 0) {
+            for (const server of mcpExcluded) {
+                excludeTools.push(`mcp__${server}__*`);
+            }
+        }
+    }
     if (effectiveTools.length > 0)
-        argv.push("--tools", effectiveTools.join(","));
-    const excludeTools = Array.from(new Set([...config.excludeTools, ...HINDSIGHT_TOOLS]));
+        argv.push("--tools", Array.from(new Set(effectiveTools)).join(","));
     if (excludeTools.length > 0)
-        argv.push("--exclude-tools", excludeTools.join(","));
+        argv.push("--exclude-tools", Array.from(new Set(excludeTools)).join(","));
     if (!config.extensions.discovery)
         argv.push("--no-extensions");
     for (const path of config.extensions.paths)
@@ -167,6 +179,8 @@ export function buildLaunchSpec(options) {
         argv.push("--no-skills");
     for (const path of config.skills.paths)
         argv.push("--skill", path);
+    if (!config.mcp.enabled)
+        argv.push("--no-mcp");
     argv.push("--append-system-prompt", config.prompt);
     const env = {
         [BRIDGE_ENVIRONMENT_KEYS.parentSessionId]: options.bridge.parentSessionId,
@@ -179,6 +193,12 @@ export function buildLaunchSpec(options) {
         [CHILD_TITLE_ENV_KEY]: config.title ?? "",
         PI_HINDSIGHT_DISABLE: "1",
         ...(config.codemodeOnly ? { PI_CODEMODE_MODE: "only" } : {}),
+        ...(mcpExcluded && mcpExcluded.length > 0
+            ? { PI_SUBAGENT_MCP_EXCLUDE: mcpExcluded.join(",") }
+            : {}),
+        ...(mcpServers && mcpServers.length > 0
+            ? { PI_SUBAGENT_MCP_SERVERS: mcpServers.join(",") }
+            : {}),
     };
     return Object.freeze({
         command: options.invocation.command,

package/dist/manager.d.ts

@@ -7,7 +7,7 @@ import type { SubagentRegistry } from "./registry.js";
 import type { LaunchOutcome, RuntimeTokenStore } from "./runtime.js";
 /**
  * How long an idle child keeps its runtime. A background child holds a whole Pi process and its
- * session lock, so an idle one is reclaimed after this window and a later `send_agent` starts it
+ * session lock, so an idle one is reclaimed after this window and a later `agent_send` starts it
  * again from the same session.
  */
 export declare const SUBAGENT_IDLE_TIMEOUT_MS = 15000;
@@ -25,6 +25,7 @@ export interface ParentChannelReport {
 }
 export interface ParentChannel {
     deliver(report: ParentChannelReport): Promise<void>;
+    dismiss?(childId: string): void;
 }
 /**
  * The parent side of the bridge, as the manager needs it: one connection per child, requests the
@@ -82,6 +83,7 @@ export interface PresentationDeps {
 }
 export interface SpawnResult {
     readonly child: PublicSubagent;
+    readonly path: string;
     /** Set when the child did not run where it would have by default. */
     readonly note?: string;
 }
@@ -106,7 +108,7 @@ export declare class SubagentManager {
      * `task_result` and settle events without also owning the bridge connection.
      */
     onChildEvent(listener: (childId: string, event: unknown) => void): () => void;
-    /** Presentation-only: widget and similar projections re-read list() after this. */
+    /** Presentation-only: status and similar projections re-read list() after this. */
     onChange(listener: () => void): () => void;
     dispose(): void;
     /**