@clanker-code/pi-subagents 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.11.1] - 2026-06-28
+
+### Fixed
+- **Depth 2+ subagents now appear in the TUI widget** — each child session's `DefaultResourceLoader` previously created its own isolated event bus, so lifecycle events (`subagents:created`, `subagents:started`, `subagents:completed`, `subagents:failed`) from depth 2+ agents never reached the parent's widget listener. A forwarding event bus now wraps the parent bus: the child gets its own isolated local bus, but lifecycle events are forwarded to the parent so the widget renders the full recursive agent tree.
+- **Agent tool description shows next spawn depth instead of agent's own depth** — the `{{currentDepth}}` placeholder and recursive guideline in the Agent tool description now show `extensionDepth + 1` (the depth the *next* spawned agent would be at) instead of `extensionDepth` (the agent's own depth), eliminating the off-by-one confusion where a depth-1 agent displayed "1/4" but spawned agents at depth 2.
+- **Event bus propagation covers all spawn paths** — RPC-spawned agents (`cross-extension-rpc.ts`), scheduled agents (`schedule.ts`), and `spawnAndWait` foreground agents now correctly receive the parent's event bus and recursive depth metadata, so lifecycle events from agents spawned via any path are visible in the parent widget.
+- **Dashboard UI action handlers** — steer, abort, and view-result row actions in the subagents management modal now route to the correct handler functions instead of silently no-opping.
+- **Dashboard UI duplicate module push guard** — the `ui_management` probe no longer pushes duplicate module entries when called multiple times in the same session.
+
+### Added
+- **Dashboard UI model column** — the subagents management modal now shows the model used by each agent (e.g. "opus", "sonnet") in a dedicated column.
+
 ## [0.11.0] - 2026-06-28
 
 ### Added

package/dist/agent-manager.d.ts

@@ -8,6 +8,7 @@
 import type { Model } from "@earendil-works/pi-ai";
 import type { AgentSession, ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { type ToolActivity } from "./agent-runner.js";
+import type { EventBus } from "./cross-extension-rpc.js";
 import { type AgentInvocation, type AgentRecord, type IsolationMode, type SubagentType, type ThinkingLevel } from "./types.js";
 export type OnAgentComplete = (record: AgentRecord) => void;
 export type OnAgentStart = (record: AgentRecord) => void;
@@ -69,6 +70,8 @@ interface SpawnOptions {
     }) => void;
     /** Called when the session successfully compacts. */
     onCompaction?: (info: CompactionInfo) => void;
+    /** Parent's event bus — shared with child sessions so lifecycle events propagate to the parent widget. */
+    eventBus?: EventBus;
 }
 interface ResumeOptions {
     signal?: AbortSignal;

package/dist/agent-manager.js

@@ -218,6 +218,7 @@ export class AgentManager {
             },
             depth: record.depth,
             parentAgentId: record.parentAgentId,
+            eventBus: options.eventBus,
             onSessionCreated: (session) => {
                 record.session = session;
                 // Flush any steers that arrived before the session was ready

package/dist/agent-runner.d.ts

@@ -4,6 +4,7 @@
 import type { Model } from "@earendil-works/pi-ai";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { type AgentSession, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { EventBus } from "./cross-extension-rpc.js";
 import { type SubagentType, type ThinkingLevel } from "./types.js";
 /**
  * Tool names registered by THIS extension. Single source of truth so the
@@ -19,6 +20,13 @@ export declare const SUBAGENT_TOOL_NAMES: {
     readonly CLEAR_SUBAGENTS: "clear_subagents";
     readonly LIST_MODELS: "list_models";
 };
+/**
+ * Create a forwarding event bus for a child session.
+ * The child gets its own local bus for emit/on, but lifecycle events
+ * (subagents:*) are also forwarded to the parent bus so the parent widget
+ * can display depth 2+ agents.
+ */
+export declare function createForwardingEventBus(parentBus: EventBus): EventBus;
 export declare function getCurrentExtensionDepth(): number;
 export declare function getCurrentExtensionAgentId(): string | undefined;
 export declare function getCurrentExtensionParentAgentId(): string | undefined;
@@ -131,6 +139,9 @@ export interface RunOptions {
     depth?: number;
     /** Parent subagent id when spawned recursively from another subagent. */
     parentAgentId?: string;
+    /** Parent's event bus — shared with the child session so lifecycle events
+     * (subagents:created, subagents:started, etc.) propagate to the parent widget. */
+    eventBus?: EventBus;
 }
 export interface RunResult {
     responseText: string;

package/dist/agent-runner.js

@@ -4,7 +4,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
-import { createAgentSession, DefaultResourceLoader, getAgentDir, SessionManager, SettingsManager, } from "@earendil-works/pi-coding-agent";
+import { createAgentSession, createEventBus, DefaultResourceLoader, getAgentDir, SessionManager, SettingsManager, } from "@earendil-works/pi-coding-agent";
 import { BUILTIN_TOOL_NAMES, getAgentConfig, getConfig, getMemoryToolNames, getReadOnlyMemoryToolNames, getToolNamesForType } from "./agent-types.js";
 import { buildParentContext, extractText } from "./context.js";
 import { DEFAULT_AGENTS } from "./default-agents.js";
@@ -40,6 +40,38 @@ const RECURSIVE_TOOL_NAMES = [
     SUBAGENT_TOOL_NAMES.STEER,
 ];
 const EXTENSION_DEPTH_KEY = Symbol.for("pi-subagents:extension-depth");
+/** Lifecycle event names that should propagate from child to parent sessions. */
+const FORWARDABLE_EVENTS = new Set([
+    "subagents:created",
+    "subagents:started",
+    "subagents:completed",
+    "subagents:failed",
+    "subagents:compacted",
+]);
+/**
+ * Create a forwarding event bus for a child session.
+ * The child gets its own local bus for emit/on, but lifecycle events
+ * (subagents:*) are also forwarded to the parent bus so the parent widget
+ * can display depth 2+ agents.
+ */
+export function createForwardingEventBus(parentBus) {
+    // Use the parent's EventBus factory to create a properly isolated local bus
+    const localBus = createEventBus();
+    return {
+        on(event, handler) {
+            // Subscribe to local bus only — child doesn't see parent/sibling events
+            return localBus.on(event, handler);
+        },
+        emit(event, data) {
+            // Always emit on local bus for child's own listeners
+            localBus.emit(event, data);
+            // Forward lifecycle events to parent bus for parent widget visibility
+            if (FORWARDABLE_EVENTS.has(event)) {
+                parentBus.emit(event, data);
+            }
+        },
+    };
+}
 const AUTO_EXPOSE_EXTENSION_NAMES = new Set(["pi-c2c"]);
 let extensionDepthLoadChain = Promise.resolve();
 const packageNameCache = new Map();
@@ -438,6 +470,10 @@ export async function runAgent(ctx, type, prompt, options) {
                 }),
             };
         };
+    // Create a forwarding event bus so the child session's lifecycle events
+    // (subagents:created, subagents:started, etc.) propagate to the parent's
+    // event bus — making depth 2+ agents visible in the parent widget.
+    const childEventBus = options.eventBus ? createForwardingEventBus(options.eventBus) : undefined;
     const loader = new DefaultResourceLoader({
         cwd: configCwd,
         agentDir,
@@ -450,6 +486,7 @@ export async function runAgent(ctx, type, prompt, options) {
         noContextFiles: true,
         systemPromptOverride: () => systemPrompt,
         appendSystemPromptOverride: () => [],
+        eventBus: childEventBus,
     });
     await withLoadingExtensionDepth(depth, options.agentId, options.parentAgentId, () => loader.reload());
     // Plain entries in `tools:` are expected to be built-in names (extension tools

package/dist/agent-tool-description.d.ts

@@ -2,7 +2,13 @@ import type { ToolDescriptionMode } from "./settings.js";
 export declare function getModelLabelFromConfig(model: string): string;
 export interface AgentToolDescriptionOptions {
     mode: ToolDescriptionMode;
-    extensionDepth: number;
+    /**
+     * Depth at which the NEXT spawned subagent will run.
+     * This is `extensionDepth + 1` — the agent's own depth plus one.
+     * Displayed as "Current recursive depth" in the tool description so the
+     * LLM sees the depth of the agent it is about to create, not its own depth.
+     */
+    nextSubagentDepth: number;
     schedulingEnabled: boolean;
 }
 export declare function buildScheduleGuideline(schedulingEnabled: boolean): string;

package/dist/agent-tool-description.js

@@ -39,7 +39,7 @@ export function buildScheduleGuideline(schedulingEnabled) {
 }
 export function buildAgentToolDescription(options) {
     const scheduleGuideline = buildScheduleGuideline(options.schedulingEnabled);
-    const recursiveGuideline = `Recursive agents are allowed through depth ${MAX_RECURSIVE_DEPTH}. Current recursive depth: ${options.extensionDepth}/${MAX_RECURSIVE_DEPTH}.`;
+    const recursiveGuideline = `Recursive agents are allowed through depth ${MAX_RECURSIVE_DEPTH}. Current recursive depth: ${options.nextSubagentDepth}/${MAX_RECURSIVE_DEPTH}.`;
     const compactAgentToolDescription = `Launch an autonomous agent for complex, multi-step tasks. Agent types:
 ${buildCompactTypeListText()}
 
@@ -49,7 +49,7 @@ Notes:
 - description: 3-5 words (shown in UI). Prompts must be self-contained — the agent has not seen this conversation.
 - Parallel work: one message, multiple Agent calls; they all run in the background. You are notified when agents finish — never poll or sleep.
 - Background by default: when you have useful independent work, launch it and continue. Doing nothing while an agent runs is worse than letting background work proceed.
-- Recursive agents: current depth ${options.extensionDepth}/${MAX_RECURSIVE_DEPTH}; you may spawn subagents until depth ${MAX_RECURSIVE_DEPTH}.
+- Recursive agents: current depth ${options.nextSubagentDepth}/${MAX_RECURSIVE_DEPTH}; you may spawn subagents until depth ${MAX_RECURSIVE_DEPTH}.
 - The result is not shown to the user — summarize it for them. Verify an agent's claimed code changes before reporting work done.
 - resume continues a previous agent by ID; steer_subagent messages a running one.
 - list_models enumerates the model registry the \`model:\` param accepts — call it before picking a model explicitly.
@@ -105,7 +105,7 @@ Terse command-style prompts produce shallow, generic work.
             compactTypeList: buildCompactTypeListText,
             agentDir: getAgentDir,
             scheduleGuideline: () => scheduleGuideline,
-            currentDepth: () => String(options.extensionDepth),
+            currentDepth: () => String(options.nextSubagentDepth),
             maxDepth: () => String(MAX_RECURSIVE_DEPTH),
             recursiveGuideline: () => recursiveGuideline,
         };

package/dist/cross-extension-rpc.d.ts

@@ -33,6 +33,10 @@ export interface RpcDeps {
     pi: unknown;
     getCtx: () => unknown | undefined;
     manager: SpawnCapable;
+    /** Default recursive depth for RPC-spawned subagents in this session. */
+    depth?: number;
+    /** Parent subagent id for RPC-spawned subagents in this session. */
+    parentAgentId?: string;
 }
 export interface RpcHandle {
     unsubPing: () => void;

package/dist/cross-extension-rpc.js

@@ -66,7 +66,17 @@ export function registerRpcHandlers(deps) {
             }
             normalizedOptions = { ...normalizedOptions, model: resolved };
         }
-        return { id: manager.spawn(pi, ctx, type, prompt, normalizedOptions) };
+        const spawnOptions = {
+            ...normalizedOptions,
+            eventBus: events,
+            depth: normalizedOptions.depth ?? deps.depth,
+            parentAgentId: normalizedOptions.parentAgentId ?? deps.parentAgentId,
+        };
+        if (spawnOptions.depth === undefined)
+            delete spawnOptions.depth;
+        if (spawnOptions.parentAgentId === undefined)
+            delete spawnOptions.parentAgentId;
+        return { id: manager.spawn(pi, ctx, type, prompt, spawnOptions) };
     });
     const unsubStop = handleRpc(events, "subagents:rpc:stop", ({ agentId }) => {
         if (!manager.abort(agentId))

package/dist/dashboard-ui.js

@@ -24,6 +24,7 @@ function buildAgentRow(record) {
         id: record.id,
         type: getDisplayName(record.type),
         description: record.description ?? "",
+        model: record.invocation?.modelName ?? "—",
         status: record.status,
         toolUses: record.toolUses ?? 0,
         tokens: totalTokens > 0 ? formatTokenCount(totalTokens) : "—",
@@ -56,7 +57,14 @@ export function registerDashboardModules(pi, manager) {
         }, INVALIDATE_DEBOUNCE_MS);
     }
     // ── 1. Module Discovery (ui:list-modules) ──────────────────────────
+    // Guard against duplicate pushes: the bridge may call refreshUiModules
+    // multiple times per probe cycle when multiple sessions each register
+    // their own ui:invalidate listener. Check if our modules are already
+    // present before pushing.
     pi.events.on("ui:list-modules", ((probe) => {
+        const alreadyContributed = probe.modules.some((m) => m.kind === "management-modal" && m.id === MODULE_ID);
+        if (alreadyContributed)
+            return;
         const agents = manager.listAgents();
         const running = agents.filter(a => a.status === "running").length;
         const completed = agents.filter(a => a.status === "completed").length;
@@ -96,6 +104,7 @@ export function registerDashboardModules(pi, manager) {
                     { key: "id", label: "ID", kind: "text", width: 120 },
                     { key: "type", label: "Type", kind: "text", width: 100 },
                     { key: "description", label: "Description", kind: "text" },
+                    { key: "model", label: "Model", kind: "text", width: 80 },
                     { key: "status", label: "Status", kind: "text", width: 90 },
                     { key: "toolUses", label: "Tools", kind: "number", width: 60 },
                     { key: "tokens", label: "Tokens", kind: "text", width: 80 },
@@ -148,20 +157,25 @@ export function registerDashboardModules(pi, manager) {
     pi.events.on("subagents:ui:refresh", (() => {
         scheduleInvalidate();
     }));
-    // View Result: emit the result as a toast so the dashboard shows it
+    // View Result: return the agent's result as table rows so the modal
+    // displays it. The bridge's synchronous fast path calls `_reply(items)`
+    // when `data.items` is populated by the handler — do NOT call
+    // `scheduleInvalidate()` here as the subsequent re-probe would
+    // overwrite the returned rows with the original table data.
     pi.events.on("subagents:ui:view-result", ((data) => {
-        const agentId = data.params?.id ?? data.id;
+        // Bridge spreads msg.params into data; row identity is at data.row.id.
+        const agentId = data.row?.id ?? data.id;
+        if (!agentId)
+            return;
         const record = manager.getRecord(agentId);
-        if (!record) {
-            pi.events.emit("ui:invalidate", { id: MODULE_ID });
+        if (!record)
             return;
-        }
         const resultText = record.result?.trim() || "No output yet.";
         const preview = resultText.length > 2000
             ? resultText.slice(0, 2000) + "\n…(truncated)"
             : resultText;
-        pi.events.emit("ui:invalidate", { id: MODULE_ID });
-        // Return result as items so it shows in a detail view
+        // Populate data.items — the bridge's synchronous fast path forwards
+        // this as a `ui_data_list` message back to the dashboard.
         data.items = [{
                 id: record.id,
                 type: getDisplayName(record.type),
@@ -171,25 +185,36 @@ export function registerDashboardModules(pi, manager) {
                 outputFile: record.outputFile ?? "",
             }];
     }));
-    // Abort: signal the agent to stop
+    // Abort: stop the running agent via the manager's abort() method
+    // which properly cancels the AbortController and cleans up state.
     pi.events.on("subagents:ui:abort", ((data) => {
-        const agentId = data.params?.id ?? data.id;
-        const record = manager.getRecord(agentId);
-        if (record?.session) {
-            // Use the session's abort mechanism
-            try {
-                record.session.dispose?.();
-            }
-            catch {
-                // Ignore disposal errors
-            }
-        }
+        const agentId = data.row?.id ?? data.id;
+        if (!agentId)
+            return;
+        manager.abort(agentId);
         scheduleInvalidate();
     }));
-    // Steer: for now just invalidate — full steer requires a prompt input
-    // which the management-modal form view could support in the future
-    pi.events.on("subagents:ui:steer", ((_data) => {
-        // TODO: Could open a form view for entering the steer message
+    // Steer: send a steering message to a running agent's session.
+    // The management-modal row action carries the row identity; we steer
+    // with a default "Continue" nudge. A future form view could accept
+    // custom text.
+    pi.events.on("subagents:ui:steer", ((data) => {
+        const agentId = data.row?.id ?? data.id;
+        if (!agentId)
+            return;
+        const record = manager.getRecord(agentId);
+        if (!record)
+            return;
+        if (record.status === "running" && record.session) {
+            // Session is live — steer immediately
+            record.session.steer("Continue").catch(() => { });
+        }
+        else if (record.status === "queued") {
+            // Session not yet created — queue the steer for flush on start
+            if (!record.pendingSteers)
+                record.pendingSteers = [];
+            record.pendingSteers.push("Continue");
+        }
         scheduleInvalidate();
     }));
     // ── 4. Invalidate on agent lifecycle events ────────────────────────

package/dist/index.js

@@ -379,7 +379,7 @@ export default function (pi) {
                 return; // sessionId not yet available — try again on next event
             const path = resolveStorePath(ctx.cwd, sessionId);
             const store = new ScheduleStore(path);
-            scheduler.start(pi, ctx, manager, store);
+            scheduler.start(pi, ctx, manager, store, { depth: nextSubagentDepth, parentAgentId: extensionAgentId });
             pi.events.emit("subagents:scheduler_ready", { sessionId, jobCount: store.list().length });
         }
         catch (err) {
@@ -412,6 +412,8 @@ export default function (pi) {
         pi,
         getCtx: () => currentCtx,
         manager,
+        depth: nextSubagentDepth,
+        parentAgentId: extensionAgentId,
     });
     // Broadcast readiness so extensions loaded after us can discover us
     pi.events.emit("subagents:ready", {});
@@ -594,7 +596,7 @@ export default function (pi) {
     const scheduleParam = isSchedulingEnabled() ? scheduleParamShape : {};
     const agentToolDescription = buildAgentToolDescription({
         mode: getToolDescriptionMode(),
-        extensionDepth,
+        nextSubagentDepth,
         schedulingEnabled: isSchedulingEnabled(),
     });
     pi.registerTool(defineTool({
@@ -872,6 +874,7 @@ export default function (pi) {
                     invocation: agentInvocation,
                     depth: nextSubagentDepth,
                     parentAgentId: extensionAgentId,
+                    eventBus: pi.events,
                     outputFileForAgent: (agentId) => createOutputFilePath(ctx.cwd, agentId, ctx.sessionManager.getSessionId()),
                     onOutputFileCreated: (outputFile, agentId) => writeInitialEntry(outputFile, agentId, P.prompt, ctx.cwd),
                     ...bgCallbacks,
@@ -1632,6 +1635,9 @@ Write the file using the write tool. Only write the file, nothing else.`;
         const record = await manager.spawnAndWait(pi, ctx, "general-purpose", generatePrompt, {
             description: `Generate ${name} agent`,
             maxTurns: 5,
+            eventBus: pi.events,
+            depth: nextSubagentDepth,
+            parentAgentId: extensionAgentId,
         });
         if (record.status === "error") {
             ctx.ui.notify(`Generation failed: ${record.error}`, "warning");

package/dist/schedule.d.ts

@@ -51,6 +51,12 @@ export interface NewJobInput {
     isolated?: boolean;
     isolation?: IsolationMode;
 }
+interface SchedulerSpawnDefaults {
+    /** Recursive depth for scheduled subagents fired from this session. */
+    depth?: number;
+    /** Parent subagent id for scheduled subagents fired from this session. */
+    parentAgentId?: string;
+}
 export declare class SubagentScheduler {
     private jobs;
     private intervals;
@@ -58,8 +64,9 @@ export declare class SubagentScheduler {
     private pi;
     private ctx;
     private manager;
+    private spawnDefaults;
     /** Start the scheduler: bind to a session's store and arm enabled jobs. */
-    start(pi: ExtensionAPI, ctx: ExtensionContext, manager: AgentManager, store: ScheduleStore): void;
+    start(pi: ExtensionAPI, ctx: ExtensionContext, manager: AgentManager, store: ScheduleStore, spawnDefaults?: SchedulerSpawnDefaults): void;
     /** Stop all timers; drop refs. Safe to call repeatedly. */
     stop(): void;
     /** True if start() has bound a store and the scheduler is active. */
@@ -107,3 +114,4 @@ export declare class SubagentScheduler {
     /** "10s"/"5m"/"1h"/"2d" → milliseconds. */
     static parseInterval(s: string): number | null;
 }
+export {};

package/dist/schedule.js

@@ -24,12 +24,14 @@ export class SubagentScheduler {
     pi;
     ctx;
     manager;
+    spawnDefaults = {};
     /** Start the scheduler: bind to a session's store and arm enabled jobs. */
-    start(pi, ctx, manager, store) {
+    start(pi, ctx, manager, store, spawnDefaults = {}) {
         this.pi = pi;
         this.ctx = ctx;
         this.manager = manager;
         this.store = store;
+        this.spawnDefaults = spawnDefaults;
         for (const job of store.list()) {
             if (job.enabled)
                 this.scheduleJob(job);
@@ -47,6 +49,7 @@ export class SubagentScheduler {
         this.pi = undefined;
         this.ctx = undefined;
         this.manager = undefined;
+        this.spawnDefaults = {};
     }
     /** True if start() has bound a store and the scheduler is active. */
     isActive() {
@@ -222,6 +225,9 @@ export class SubagentScheduler {
                 isolated: job.isolated,
                 thinkingLevel: job.thinking,
                 isolation: job.isolation,
+                eventBus: pi.events,
+                depth: this.spawnDefaults.depth,
+                parentAgentId: this.spawnDefaults.parentAgentId,
             });
         }
         catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clanker-code/pi-subagents",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "A pi extension extension that brings smart Claude Code-style autonomous sub-agents to pi.",
   "author": "clankercode",
   "license": "MIT",

package/src/agent-manager.ts

@@ -12,6 +12,7 @@ import { isAbsolute } from "node:path";
 import type { Model } from "@earendil-works/pi-ai";
 import type { AgentSession, ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { resumeAgent, runAgent, type ToolActivity } from "./agent-runner.js";
+import type { EventBus } from "./cross-extension-rpc.js";
 import { type AgentInvocation, type AgentRecord, type IsolationMode, MAX_RECURSIVE_DEPTH, type SubagentType, type ThinkingLevel } from "./types.js";
 import { addUsage } from "./usage.js";
 import { cleanupWorktree, createWorktree, pruneWorktrees, } from "./worktree.js";
@@ -102,6 +103,8 @@ interface SpawnOptions {
   onAssistantUsage?: (usage: { input: number; output: number; cacheWrite: number }) => void;
   /** Called when the session successfully compacts. */
   onCompaction?: (info: CompactionInfo) => void;
+  /** Parent's event bus — shared with child sessions so lifecycle events propagate to the parent widget. */
+  eventBus?: EventBus;
 }
 
 interface ResumeOptions {
@@ -310,6 +313,7 @@ export class AgentManager {
       },
       depth: record.depth,
       parentAgentId: record.parentAgentId,
+      eventBus: options.eventBus,
       onSessionCreated: (session) => {
         record.session = session;
         // Flush any steers that arrived before the session was ready

package/src/agent-runner.ts

@@ -11,6 +11,7 @@ import {
   type AgentSession,
   type AgentSessionEvent,
   createAgentSession,
+  createEventBus,
   DefaultResourceLoader,
   type ExtensionAPI,
   getAgentDir,
@@ -19,6 +20,7 @@ import {
 } from "@earendil-works/pi-coding-agent";
 import { BUILTIN_TOOL_NAMES, getAgentConfig, getConfig, getMemoryToolNames, getReadOnlyMemoryToolNames, getToolNamesForType } from "./agent-types.js";
 import { buildParentContext, extractText } from "./context.js";
+import type { EventBus } from "./cross-extension-rpc.js";
 import { DEFAULT_AGENTS } from "./default-agents.js";
 import { detectEnv } from "./env.js";
 import { buildMemoryBlock, buildReadOnlyMemoryBlock } from "./memory.js";
@@ -55,6 +57,40 @@ const RECURSIVE_TOOL_NAMES: string[] = [
 ];
 
 const EXTENSION_DEPTH_KEY = Symbol.for("pi-subagents:extension-depth");
+
+/** Lifecycle event names that should propagate from child to parent sessions. */
+const FORWARDABLE_EVENTS = new Set([
+  "subagents:created",
+  "subagents:started",
+  "subagents:completed",
+  "subagents:failed",
+  "subagents:compacted",
+]);
+
+/**
+ * Create a forwarding event bus for a child session.
+ * The child gets its own local bus for emit/on, but lifecycle events
+ * (subagents:*) are also forwarded to the parent bus so the parent widget
+ * can display depth 2+ agents.
+ */
+export function createForwardingEventBus(parentBus: EventBus): EventBus {
+  // Use the parent's EventBus factory to create a properly isolated local bus
+  const localBus = createEventBus();
+  return {
+    on(event, handler) {
+      // Subscribe to local bus only — child doesn't see parent/sibling events
+      return localBus.on(event, handler);
+    },
+    emit(event, data) {
+      // Always emit on local bus for child's own listeners
+      localBus.emit(event, data);
+      // Forward lifecycle events to parent bus for parent widget visibility
+      if (FORWARDABLE_EVENTS.has(event)) {
+        parentBus.emit(event, data);
+      }
+    },
+  };
+}
 const AUTO_EXPOSE_EXTENSION_NAMES = new Set(["pi-c2c"]);
 let extensionDepthLoadChain: Promise<void> = Promise.resolve();
 const packageNameCache = new Map<string, string[]>();
@@ -365,6 +401,9 @@ export interface RunOptions {
   depth?: number;
   /** Parent subagent id when spawned recursively from another subagent. */
   parentAgentId?: string;
+  /** Parent's event bus — shared with the child session so lifecycle events
+   * (subagents:created, subagents:started, etc.) propagate to the parent widget. */
+  eventBus?: EventBus;
 }
 
 export interface RunResult {
@@ -555,6 +594,11 @@ export async function runAgent(
           };
         };
 
+  // Create a forwarding event bus so the child session's lifecycle events
+  // (subagents:created, subagents:started, etc.) propagate to the parent's
+  // event bus — making depth 2+ agents visible in the parent widget.
+  const childEventBus = options.eventBus ? createForwardingEventBus(options.eventBus) : undefined;
+
   const loader = new DefaultResourceLoader({
     cwd: configCwd,
     agentDir,
@@ -567,6 +611,7 @@ export async function runAgent(
     noContextFiles: true,
     systemPromptOverride: () => systemPrompt,
     appendSystemPromptOverride: () => [],
+    eventBus: childEventBus,
   });
   await withLoadingExtensionDepth(depth, options.agentId, options.parentAgentId, () => loader.reload());
 

package/src/agent-tool-description.ts

@@ -44,7 +44,13 @@ const buildCompactTypeListText = () =>
 
 export interface AgentToolDescriptionOptions {
   mode: ToolDescriptionMode;
-  extensionDepth: number;
+  /**
+   * Depth at which the NEXT spawned subagent will run.
+   * This is `extensionDepth + 1` — the agent's own depth plus one.
+   * Displayed as "Current recursive depth" in the tool description so the
+   * LLM sees the depth of the agent it is about to create, not its own depth.
+   */
+  nextSubagentDepth: number;
   schedulingEnabled: boolean;
 }
 
@@ -56,7 +62,7 @@ export function buildScheduleGuideline(schedulingEnabled: boolean): string {
 
 export function buildAgentToolDescription(options: AgentToolDescriptionOptions): string {
   const scheduleGuideline = buildScheduleGuideline(options.schedulingEnabled);
-  const recursiveGuideline = `Recursive agents are allowed through depth ${MAX_RECURSIVE_DEPTH}. Current recursive depth: ${options.extensionDepth}/${MAX_RECURSIVE_DEPTH}.`;
+  const recursiveGuideline = `Recursive agents are allowed through depth ${MAX_RECURSIVE_DEPTH}. Current recursive depth: ${options.nextSubagentDepth}/${MAX_RECURSIVE_DEPTH}.`;
 
   const compactAgentToolDescription = `Launch an autonomous agent for complex, multi-step tasks. Agent types:
 ${buildCompactTypeListText()}
@@ -67,7 +73,7 @@ Notes:
 - description: 3-5 words (shown in UI). Prompts must be self-contained — the agent has not seen this conversation.
 - Parallel work: one message, multiple Agent calls; they all run in the background. You are notified when agents finish — never poll or sleep.
 - Background by default: when you have useful independent work, launch it and continue. Doing nothing while an agent runs is worse than letting background work proceed.
-- Recursive agents: current depth ${options.extensionDepth}/${MAX_RECURSIVE_DEPTH}; you may spawn subagents until depth ${MAX_RECURSIVE_DEPTH}.
+- Recursive agents: current depth ${options.nextSubagentDepth}/${MAX_RECURSIVE_DEPTH}; you may spawn subagents until depth ${MAX_RECURSIVE_DEPTH}.
 - The result is not shown to the user — summarize it for them. Verify an agent's claimed code changes before reporting work done.
 - resume continues a previous agent by ID; steer_subagent messages a running one.
 - list_models enumerates the model registry the \`model:\` param accepts — call it before picking a model explicitly.
@@ -125,7 +131,7 @@ Terse command-style prompts produce shallow, generic work.
       compactTypeList: buildCompactTypeListText,
       agentDir: getAgentDir,
       scheduleGuideline: () => scheduleGuideline,
-      currentDepth: () => String(options.extensionDepth),
+      currentDepth: () => String(options.nextSubagentDepth),
       maxDepth: () => String(MAX_RECURSIVE_DEPTH),
       recursiveGuideline: () => recursiveGuideline,
     };

package/src/cross-extension-rpc.ts

@@ -36,6 +36,10 @@ export interface RpcDeps {
   pi: unknown;                    // passed through to manager.spawn
   getCtx: () => unknown | undefined;  // returns current ExtensionContext
   manager: SpawnCapable;
+  /** Default recursive depth for RPC-spawned subagents in this session. */
+  depth?: number;
+  /** Parent subagent id for RPC-spawned subagents in this session. */
+  parentAgentId?: string;
 }
 
 export interface RpcHandle {
@@ -108,7 +112,16 @@ export function registerRpcHandlers(deps: RpcDeps): RpcHandle {
         normalizedOptions = { ...normalizedOptions, model: resolved };
       }
 
-      return { id: manager.spawn(pi, ctx, type, prompt, normalizedOptions) };
+      const spawnOptions = {
+        ...normalizedOptions,
+        eventBus: events,
+        depth: normalizedOptions.depth ?? deps.depth,
+        parentAgentId: normalizedOptions.parentAgentId ?? deps.parentAgentId,
+      };
+      if (spawnOptions.depth === undefined) delete spawnOptions.depth;
+      if (spawnOptions.parentAgentId === undefined) delete spawnOptions.parentAgentId;
+
+      return { id: manager.spawn(pi, ctx, type, prompt, spawnOptions) };
     },
   );
 

package/src/dashboard-ui.ts

@@ -77,6 +77,7 @@ function buildAgentRow(record: any) {
     id: record.id,
     type: getDisplayName(record.type),
     description: record.description ?? "",
+    model: record.invocation?.modelName ?? "—",
     status: record.status,
     toolUses: record.toolUses ?? 0,
     tokens: totalTokens > 0 ? formatTokenCount(totalTokens) : "—",
@@ -110,7 +111,16 @@ export function registerDashboardModules(pi: ExtensionAPI, manager: AgentManager
   }
 
   // ── 1. Module Discovery (ui:list-modules) ──────────────────────────
+  // Guard against duplicate pushes: the bridge may call refreshUiModules
+  // multiple times per probe cycle when multiple sessions each register
+  // their own ui:invalidate listener. Check if our modules are already
+  // present before pushing.
   pi.events.on("ui:list-modules", ((probe: ModuleProbe) => {
+    const alreadyContributed = probe.modules.some(
+      (m: any) => m.kind === "management-modal" && m.id === MODULE_ID,
+    );
+    if (alreadyContributed) return;
+
     const agents = manager.listAgents();
     const running = agents.filter(a => a.status === "running").length;
     const completed = agents.filter(a => a.status === "completed").length;
@@ -150,6 +160,7 @@ export function registerDashboardModules(pi: ExtensionAPI, manager: AgentManager
           { key: "id", label: "ID", kind: "text", width: 120 },
           { key: "type", label: "Type", kind: "text", width: 100 },
           { key: "description", label: "Description", kind: "text" },
+          { key: "model", label: "Model", kind: "text", width: 80 },
           { key: "status", label: "Status", kind: "text", width: 90 },
           { key: "toolUses", label: "Tools", kind: "number", width: 60 },
           { key: "tokens", label: "Tokens", kind: "text", width: 80 },
@@ -206,23 +217,25 @@ export function registerDashboardModules(pi: ExtensionAPI, manager: AgentManager
     scheduleInvalidate();
   }) as any);
 
-  // View Result: emit the result as a toast so the dashboard shows it
+  // View Result: return the agent's result as table rows so the modal
+  // displays it. The bridge's synchronous fast path calls `_reply(items)`
+  // when `data.items` is populated by the handler — do NOT call
+  // `scheduleInvalidate()` here as the subsequent re-probe would
+  // overwrite the returned rows with the original table data.
   pi.events.on("subagents:ui:view-result", ((data: any) => {
-    const agentId = data.params?.id ?? data.id;
+    // Bridge spreads msg.params into data; row identity is at data.row.id.
+    const agentId = data.row?.id ?? data.id;
+    if (!agentId) return;
     const record = manager.getRecord(agentId);
-    if (!record) {
-      pi.events.emit("ui:invalidate", { id: MODULE_ID });
-      return;
-    }
+    if (!record) return;
 
     const resultText = record.result?.trim() || "No output yet.";
     const preview = resultText.length > 2000
       ? resultText.slice(0, 2000) + "\n…(truncated)"
       : resultText;
 
-    pi.events.emit("ui:invalidate", { id: MODULE_ID });
-
-    // Return result as items so it shows in a detail view
+    // Populate data.items — the bridge's synchronous fast path forwards
+    // this as a `ui_data_list` message back to the dashboard.
     data.items = [{
       id: record.id,
       type: getDisplayName(record.type),
@@ -233,25 +246,33 @@ export function registerDashboardModules(pi: ExtensionAPI, manager: AgentManager
     }];
   }) as any);
 
-  // Abort: signal the agent to stop
+  // Abort: stop the running agent via the manager's abort() method
+  // which properly cancels the AbortController and cleans up state.
   pi.events.on("subagents:ui:abort", ((data: any) => {
-    const agentId = data.params?.id ?? data.id;
-    const record = manager.getRecord(agentId);
-    if (record?.session) {
-      // Use the session's abort mechanism
-      try {
-        record.session.dispose?.();
-      } catch {
-        // Ignore disposal errors
-      }
-    }
+    const agentId = data.row?.id ?? data.id;
+    if (!agentId) return;
+    manager.abort(agentId);
     scheduleInvalidate();
   }) as any);
 
-  // Steer: for now just invalidate — full steer requires a prompt input
-  // which the management-modal form view could support in the future
-  pi.events.on("subagents:ui:steer", ((_data: any) => {
-    // TODO: Could open a form view for entering the steer message
+  // Steer: send a steering message to a running agent's session.
+  // The management-modal row action carries the row identity; we steer
+  // with a default "Continue" nudge. A future form view could accept
+  // custom text.
+  pi.events.on("subagents:ui:steer", ((data: any) => {
+    const agentId = data.row?.id ?? data.id;
+    if (!agentId) return;
+    const record = manager.getRecord(agentId);
+    if (!record) return;
+
+    if (record.status === "running" && record.session) {
+      // Session is live — steer immediately
+      record.session.steer("Continue").catch(() => {});
+    } else if (record.status === "queued") {
+      // Session not yet created — queue the steer for flush on start
+      if (!record.pendingSteers) record.pendingSteers = [];
+      record.pendingSteers.push("Continue");
+    }
     scheduleInvalidate();
   }) as any);
 

package/src/index.ts

@@ -444,7 +444,7 @@ export default function (pi: ExtensionAPI) {
       if (!sessionId) return;  // sessionId not yet available — try again on next event
       const path = resolveStorePath(ctx.cwd, sessionId);
       const store = new ScheduleStore(path);
-      scheduler.start(pi, ctx, manager, store);
+      scheduler.start(pi, ctx, manager, store, { depth: nextSubagentDepth, parentAgentId: extensionAgentId });
       pi.events.emit("subagents:scheduler_ready", { sessionId, jobCount: store.list().length });
     } catch (err) {
       // Scheduling is non-essential — log and move on so the rest of the
@@ -478,6 +478,8 @@ export default function (pi: ExtensionAPI) {
     pi,
     getCtx: () => currentCtx,
     manager,
+    depth: nextSubagentDepth,
+    parentAgentId: extensionAgentId,
   });
 
   // Broadcast readiness so extensions loaded after us can discover us
@@ -683,7 +685,7 @@ export default function (pi: ExtensionAPI) {
 
   const agentToolDescription = buildAgentToolDescription({
     mode: getToolDescriptionMode(),
-    extensionDepth,
+    nextSubagentDepth,
     schedulingEnabled: isSchedulingEnabled(),
   });
 
@@ -1016,6 +1018,7 @@ export default function (pi: ExtensionAPI) {
           invocation: agentInvocation,
           depth: nextSubagentDepth,
           parentAgentId: extensionAgentId,
+          eventBus: pi.events,
           outputFileForAgent: (agentId) => createOutputFilePath(ctx.cwd, agentId, ctx.sessionManager.getSessionId()),
           onOutputFileCreated: (outputFile, agentId) => writeInitialEntry(outputFile, agentId, P.prompt!, ctx.cwd),
           ...bgCallbacks,
@@ -1826,6 +1829,9 @@ Write the file using the write tool. Only write the file, nothing else.`;
     const record = await manager.spawnAndWait(pi, ctx, "general-purpose", generatePrompt, {
       description: `Generate ${name} agent`,
       maxTurns: 5,
+      eventBus: pi.events,
+      depth: nextSubagentDepth,
+      parentAgentId: extensionAgentId,
     });
 
     if (record.status === "error") {

package/src/schedule.ts

@@ -45,6 +45,13 @@ export interface NewJobInput {
   isolation?: IsolationMode;
 }
 
+interface SchedulerSpawnDefaults {
+  /** Recursive depth for scheduled subagents fired from this session. */
+  depth?: number;
+  /** Parent subagent id for scheduled subagents fired from this session. */
+  parentAgentId?: string;
+}
+
 export class SubagentScheduler {
   private jobs = new Map<string, Cron>();
   private intervals = new Map<string, NodeJS.Timeout>();
@@ -52,13 +59,21 @@ export class SubagentScheduler {
   private pi: ExtensionAPI | undefined;
   private ctx: ExtensionContext | undefined;
   private manager: AgentManager | undefined;
+  private spawnDefaults: SchedulerSpawnDefaults = {};
 
   /** Start the scheduler: bind to a session's store and arm enabled jobs. */
-  start(pi: ExtensionAPI, ctx: ExtensionContext, manager: AgentManager, store: ScheduleStore): void {
+  start(
+    pi: ExtensionAPI,
+    ctx: ExtensionContext,
+    manager: AgentManager,
+    store: ScheduleStore,
+    spawnDefaults: SchedulerSpawnDefaults = {},
+  ): void {
     this.pi = pi;
     this.ctx = ctx;
     this.manager = manager;
     this.store = store;
+    this.spawnDefaults = spawnDefaults;
 
     for (const job of store.list()) {
       if (job.enabled) this.scheduleJob(job);
@@ -75,6 +90,7 @@ export class SubagentScheduler {
     this.pi = undefined;
     this.ctx = undefined;
     this.manager = undefined;
+    this.spawnDefaults = {};
   }
 
   /** True if start() has bound a store and the scheduler is active. */
@@ -247,6 +263,9 @@ export class SubagentScheduler {
         isolated: job.isolated,
         thinkingLevel: job.thinking,
         isolation: job.isolation,
+        eventBus: pi.events,
+        depth: this.spawnDefaults.depth,
+        parentAgentId: this.spawnDefaults.parentAgentId,
       });
     } catch (err) {
       const error = err instanceof Error ? err.message : String(err);

package/bugs.txt

@@ -1,57 +0,0 @@
-# pi-subagents bugs
-
-## 2026-06-24: subagent-spawned reviewer c2c alias registrations route to coordinator
-
-Observed in `/home/xertrov/src/autoplanet-harness` session while coordinating nested pi Agent reviewers.
-
-Symptom:
-- Coordinator received transcript notifications like `Subagent <id> registered as pi-...` for reviewer subagents spawned by an implementer subagent.
-- The spawning implementer subagent did **not** receive those c2c alias registration notifications.
-- This made the coordinator see aliases for subagents it did not directly start, while the parent subagent could not map its Agent handles to c2c aliases.
-
-Concrete example:
-- Coordinator directly started T244/G9 implementer: agent `81a4688f-82ce-40e`, alias `pi-8391d3-ae5887a`.
-- T244 spawned reviewer/rereviewer Agent subagents with IDs:
-  - `436193fa-ef20-4d0`
-  - `97bddbcf-53a8-48c`
-  - `56a58df4-c91c-48a`
-  - `82ae1d14-707d-415`
-- Coordinator received registrations for aliases including `pi-8391d3-a723e9a`, `pi-8391d3-a0a8a00`, `pi-8391d3-ab7ed6f`, `pi-8391d3-ab167dc`.
-- T244 reported: its transcript only showed Agent result handles/output paths/completion summaries; it did not see `Subagent <id> registered as pi-...` messages and could not map reviewer IDs to c2c aliases.
-
-Expected behavior:
-- Alias registration notifications for a subagent spawned by another subagent should be delivered to the spawning subagent's transcript, or at least to both the spawning subagent and coordinator with parent/owner metadata.
-- The notification should include parent/spawner identity so coordinators can distinguish direct children from nested reviewer subagents.
-
-Impact:
-- Coordinator receives noisy/ambiguous registrations for unknown aliases.
-- Spawning subagent cannot c2c-message its own reviewers by alias or report alias ownership accurately.
-- Requires extra coordinator debugging messages to identify ownership.
-
-Suggested fix:
-- Route `Subagent <id> registered as <alias>` to the agent that invoked the Agent tool.
-- Add fields like `parent_agent_id`, `parent_alias`, and maybe `root_coordinator_alias` to registration notifications.
-- If root coordinator must also receive nested registrations, label them explicitly as nested.
-
-Additional observation after filing:
-- Coordinator later received another nested-looking registration: `Subagent 8262e0d6-457e-49c registered as pi-8391d3-ab41e8a`, again without the coordinator directly starting that subagent.
-- Confirmed with T245/G6 implementer `pi-8391d3-a861bf0`: it spawned reviewer Agent IDs `8262e0d6-457e-49c` and `14d29ca7-348e-437`, while coordinator received alias registrations `pi-8391d3-ab41e8a` and `pi-8391d3-aa90cd5`; T245 reported it had not received any c2c alias registration notifications for them.
-- After crash recovery restart, coordinator received another nested-looking registration: `Subagent 4f396572-cab5-42c registered as pi-8391d3-a52ab8a`; likely spawned by a recovery worker/reviewer rather than directly by coordinator.
-- Coordinator also received `Subagent 09dc9e7f-f960-411 registered as pi-8391d3-a219275` during recovery worker activity, again likely nested/reviewer notification routed to coordinator.
-- Coordinator also received `Subagent ee594feb-8fd1-458 registered as pi-8391d3-a8f6d40` while nested reviewer activity was ongoing; likely another nested alias notification routed to coordinator.
-- Coordinator also received `Subagent dd29fe5b-357a-48f registered as pi-8391d3-afd6cfc` during T246 nested rereview activity; likely another nested alias notification routed to coordinator.
-- Coordinator received nested-looking registrations `Subagent 9aa66b38-3ba8-405 registered as pi-8391d3-a6cefa4` and `Subagent d33bb514-be85-4a5 registered as pi-8391d3-ae99126` during active worker review activity.
-- Coordinator received nested-looking registration `Subagent ab7cb925-d76c-489 registered as pi-8391d3-a8c6afd` during active worker review activity.
-- Coordinator received nested-looking registration `Subagent ba23eaaf-a706-459 registered as pi-8391d3-af5d393` during active worker review activity.
-- Coordinator received nested-looking registration `Subagent adf52e5e-862e-4c6 registered as pi-8391d3-aa897ea` during active worker review activity.
-- Coordinator received nested-looking registration `Subagent e6eb1662-8223-458 registered as pi-8391d3-adb2231` during active worker review activity.
-- Coordinator received nested-looking registration `Subagent 565012aa-43b6-407 registered as pi-8391d3-a66be3e` during active worker review activity.
-- Coordinator received nested-looking registration `Subagent 603b211a-9daa-421 registered as pi-8391d3-aa92c43` during active worker review activity.
-- Coordinator received nested-looking registration `Subagent 734f3fa3-958b-4bd registered as pi-8391d3-a028432` during active T248 review activity.
-- Coordinator received nested-looking registration `Subagent 2d565584-fcbc-496 registered as pi-8391d3-ac6e43c` during active T250/T251/T252 review activity.
-- Coordinator received nested-looking registration `Subagent 5e7ee0d1-5112-4b9 registered as pi-8391d3-a7722c2` during active T250/T251/T252 review activity.
-- Coordinator received nested-looking registration `Subagent eae7393b-dfb4-445 registered as pi-8391d3-a2a9d62` during active T250/T251/T252 review activity.
-- Coordinator received nested-looking registration `Subagent 6629a0fe-daef-401 registered as pi-8391d3-ad0b4e5` during active T250 review activity.
-- Coordinator received nested-looking registration `Subagent 49eb5d11-178d-4d2 registered as pi-8391d3-a979978` during active T250 review activity.
-- Coordinator received nested-looking registration `Subagent bf846951-6b2f-4b5 registered as pi-8391d3-aabc2c5` during active T250 rereview activity.
-- Coordinator received nested-looking registration `Subagent 3250e286-4fd4-4a2 registered as pi-8391d3-a78b404` during active T250 rereview activity.