ac-teams 0.0.3 → 0.0.5

package/README.md

@@ -7,7 +7,7 @@ Persistent agent teams for [Pi](https://github.com/earendil-works/pi): shared ta
 Requires Linux, Node 22.19 or newer, and an authenticated `pi` executable on `PATH`. Interactive teams also require `tmux` on `PATH`. Tested with Pi 1.4.0.
 
 ```sh
-pi install npm:ac-teams@0.0.2
+pi install npm:ac-teams@0.0.4
 ```
 
 Restart Pi after installation. Use Pi's `/trust` command to save approval for each project directory before launching members there; headless children cannot answer the initial trust prompt.
@@ -28,7 +28,7 @@ Your Pi session is the root; its child agents are members. Ask Pi to delegate a
 
 The task summary sits above the input. The agent selector sits below the input, above your existing footer, and shows descriptive names, models, and context usage. ac-teams publishes a compact team status without replacing the footer or editor supplied by other extensions. `/teams config` toggles these displays independently.
 
-From an empty editor, press Down to select the team row, then Enter to open a member. Ctrl+Shift+Left returns to Main without stopping the member. `/teams stop` stops every descendant.
+From an empty editor, press Down to select the team row, then Enter to open a member. A red **Needs input** label marks a member with an open question. Ctrl+Shift+Left returns to Main without stopping the member or dismissing its question. `/teams stop` stops every descendant.
 
 Defaults allow up to **10 live members** and **two levels of delegation**. Use the fewest useful agents.
 

package/docs/usage.md

@@ -14,6 +14,10 @@ In interactive Pi, `/teams` or `/teams panel` opens the team panel. `/teams team
 
 The agent selector sits below the input editor, above the existing footer. It shows each member's name, state, model display name, and context usage. It keeps Main pinned and shows at most five rows, including an overflow indicator when needed. A finished assignment leaves its member idle and selectable.
 
+A red **Needs input** label beside a member's name marks an open question. Open that member's Pi session to answer it. Ctrl+Shift+Left returns to Main without dismissing the question.
+
+With Herdr's Pi integration and the question adapter installed, Main reports the team's status through the shared event bus. Any open question keeps Herdr blocked; otherwise, active work keeps it working. When all members settle, it becomes idle. Members do not report directly to the shared Herdr pane.
+
 Context shows Pi's reported token estimate, window size, and percentage, for example `Claude Opus 4.6 · 48k / 200k (24%)`. Reports refresh about once a second when they change. Unknown usage stays marked unknown, not zero. Stopped members retain their last report. These are context estimates, not billing totals.
 
 - Press Down from an empty editor to focus Main in the agent selector. Up/Down select members; Enter opens the selected live session; Esc returns to editing.
@@ -28,7 +32,11 @@ A task request is a proposal, not an instruction to create a task. Main receives
 
 The send receipt confirms delivery, not acceptance or task creation. This is agent guidance, not an automatic semantic duplicate detector.
 
-Team tool results and messages are compact by default. Ctrl+O expands them into labeled fields. UI state colors do not replace the underlying progress, ownership, or dependency fields.
+Each team tool call uses one line with a status dot, tool name, action, and result preview. Bold, colored badges such as `[todo]` separate statuses from titles and names.
+
+The `+N lines` hint shows the hidden detail count. Ctrl+O expands the full request and response JSON; mouse-enabled Pi views also support clicking the row.
+
+Team notification messages remain compact; Ctrl+O expands their labeled fields. UI state colors do not replace the underlying progress, ownership, or dependency fields.
 
 ## Show tasks and configure the displays
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ac-teams",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Small, persistent teams for Pi",
   "type": "module",
   "license": "MIT",
@@ -15,10 +15,12 @@
   "engines": { "node": ">=22.19.0" },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^1.4.0",
+    "@earendil-works/pi-tui": "^1.4.0",
     "typebox": "^1.0.0"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "1.4.0",
+    "@earendil-works/pi-tui": "1.4.0",
     "@types/node": "^22.0.0",
     "typebox": "^1.0.0",
     "typescript": "^5.9.0"

package/src/coordinator.ts

@@ -32,6 +32,7 @@ export interface CoordinatorOptions {
   interactive?: boolean; model?: string; thinking?: string;
   notice: (through: number, messages: Message[]) => void;
   warning: (message: string) => void;
+  status?: (kind: "busy" | "blocked", active: boolean) => void;
 }
 export class Coordinator {
   readonly store: Store;
@@ -46,6 +47,7 @@ export class Coordinator {
   private notices = new Map<string, NodeJS.Timeout>();
   private operations = new Set<Promise<unknown>>();
   private closed = false;
+  private status = { busy: false, blocked: false };
   private closePromise?: Promise<void>;
 
   private options: CoordinatorOptions;
@@ -76,7 +78,10 @@ export class Coordinator {
         state.members.root.sessionFile = options.sessionFile;
         state.members.root.model = options.model;
         state.members.root.thinking = options.thinking;
-        for (const member of Object.values(state.members)) if (member.id !== "root" && isLive(member)) member.status = "interrupted";
+        for (const member of Object.values(state.members)) {
+          delete member.needsInput;
+          if (member.id !== "root" && isLive(member)) member.status = "interrupted";
+        }
       });
       try { unlinkSync(coordinator.socketPath); } catch (error) { if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error; }
       coordinator.server = createServer(socket => coordinator.accept(socket));
@@ -98,6 +103,10 @@ export class Coordinator {
       this.connections.delete(socket);
       if (bound && this.sockets.get(bound) === socket) {
         this.sockets.delete(bound);
+        if (!this.closed) {
+          this.store.update(state => { delete state.members[bound!].needsInput; });
+          this.publishStatus();
+        }
         for (const [id, pending] of this.controls) if (pending.member === bound) {
           clearTimeout(pending.timer); this.controls.delete(id); pending.reject(new Error("Native member disconnected"));
         }
@@ -157,25 +166,38 @@ export class Coordinator {
       send(socket, { type: "command", id, command, args });
     });
   }
+  private publishStatus(): void {
+    const members = this.live().filter(member => member.status !== "stopping");
+    const next = {
+      busy: members.some(member => member.status === "starting" || member.status === "busy"),
+      blocked: members.some(member => member.needsInput),
+    };
+    for (const kind of ["busy", "blocked"] as const) if (next[kind] !== this.status[kind]) {
+      this.status[kind] = next[kind];
+      this.options.status?.(kind, next[kind]);
+    }
+  }
   recordEvent(actor: string, value: unknown): void {
     validate("event", value);
     if (this.closed) return;
-    const event = value as { type: string; text?: string; model?: string; modelName?: string; contextUsage?: ContextUsage | null };
+    const event = value as { type: string; active?: boolean; text?: string; model?: string; modelName?: string; contextUsage?: ContextUsage | null };
     const member = this.store.state.members[actor];
     if (!member || !isLive(member) || (member.status === "stopping" && event.type !== "model_error")) return;
     this.store.update(next => {
       const current = next.members[actor];
-      if (event.type === "telemetry") {
+      if (event.type === "blocked") { if (event.active) current.needsInput = true; else delete current.needsInput; }
+      else if (event.type === "telemetry") {
         current.model = event.model ?? current.model;
         current.modelName = event.modelName;
         current.contextUsage = event.contextUsage ?? undefined;
       }
       else if (event.type === "agent_start") { current.status = "busy"; current.activity = "Working"; delete current.error; delete current.summary; }
-      else if (event.type === "agent_settled") { current.status = "idle"; current.activity = current.error ? "Model request failed" : current.summary || "Available for follow-up"; }
+      else if (event.type === "agent_settled") { delete current.needsInput; current.status = "idle"; current.activity = current.error ? "Model request failed" : current.summary || "Available for follow-up"; }
       else if (event.type === "activity") current.activity = event.text;
       else if (event.type === "summary") current.summary = event.text?.slice(0, 500);
       else if (event.type === "model_error") current.error = event.text || "Model request failed";
     });
+    this.publishStatus();
     if (event.type === "model_error" && actor !== "root" && member.status !== "stopping") {
       const recipient = member.parent && isLive(this.store.state.members[member.parent]) ? member.parent : "root";
       this.store.message(actor, { action: "send", recipients: [recipient], text: `Member ${actor} model error: ${event.text || "Model request failed"}` });
@@ -307,6 +329,7 @@ export class Coordinator {
     const member: Member = resumed ? { ...resumed, token: randomUUID(), status: "starting", error: undefined, contextUsage: undefined, modelName: undefined } : { id, name: args.name, parent: actor, depth, token: randomUUID(), cwd, status: "starting", notified: 0 };
     // Reserve synchronously before the first await so concurrent launches cannot oversubscribe.
     this.store.update(next => { next.members[id] = member; });
+    this.publishStatus();
     member.model = args.model; member.thinking = args.thinking ?? "off";
     member.terminal = this.options.interactive === true;
     this.store.update(next => { next.members[id] = member; });
@@ -330,7 +353,7 @@ export class Coordinator {
       chmodSync(join(this.store.dir, "sessions"), 0o700);
       const rpcArgs = [...(this.options.interactive ? [] : ["--mode", "rpc"]), "--session-dir", join(this.store.dir, "sessions"), "-e", this.options.extension, "--provider", args.model.slice(0, slash), "--model", args.model.slice(slash + 1), "--thinking", args.thinking ?? "off"];
       if (resumed?.sessionFile) rpcArgs.push("--session", resumed.sessionFile);
-      const spawnOptions = { cwd: member.cwd, args: rpcArgs, command: this.options.command, env: { ...process.env, AC_TEAMS_SOCKET: this.socketPath, AC_TEAMS_MEMBER: id, AC_TEAMS_TOKEN: member.token, AC_TEAMS_TERMINAL_SOCKET: join(this.store.dir, "t.sock") } };
+      const spawnOptions = { cwd: member.cwd, args: rpcArgs, command: this.options.command, env: { ...process.env, HERDR_ENV: "0", AC_TEAMS_SOCKET: this.socketPath, AC_TEAMS_MEMBER: id, AC_TEAMS_TOKEN: member.token, AC_TEAMS_TERMINAL_SOCKET: join(this.store.dir, "t.sock") } };
       agent = this.options.interactive
         ? new TerminalAgent({ ...spawnOptions, id, dir: this.store.dir, request: (type, fields, timeout) => this.control(id, type, fields, timeout) })
         : new RpcAgent(spawnOptions);
@@ -349,7 +372,8 @@ export class Coordinator {
       agent.once("exit", () => {
         this.agents.delete(id);
         if (this.closed) return;
-        this.store.update(next => { next.members[id].status = next.members[id].status === "stopping" ? "stopped" : "interrupted"; });
+        this.store.update(next => { next.members[id].status = next.members[id].status === "stopping" ? "stopped" : "interrupted"; delete next.members[id].needsInput; });
+        this.publishStatus();
         void this.stopDescendants(id).catch(error => this.options.warning(String(error)));
       });
       if (agent instanceof TerminalAgent) await agent.start();
@@ -363,12 +387,14 @@ export class Coordinator {
       if (!isRecord(rpcState) || !isRecord(rpcState.model) || rpcState.model.provider !== args.model.slice(0, slash) || rpcState.model.id !== args.model.slice(slash + 1)) throw new Error("Pi did not select the requested model");
       if (rpcState.model.name !== undefined || rpcState.contextUsage !== undefined) this.recordEvent(id, { type: "telemetry", model: args.model, modelName: rpcState.model.name, contextUsage: rpcState.contextUsage ?? null });
       this.store.update(next => { if (next.members[id].status === "starting") next.members[id].status = prompt ? "busy" : "idle"; });
+      this.publishStatus();
       if (prompt) await agent.request("prompt", { message: args.brief, streamingBehavior: "followUp" });
       return this.publicMember(this.store.state.members[id]);
     } catch (error) {
       clearTimeout(timer); this.ready.delete(id);
       if (agent) await agent.stop();
-      this.store.update(next => { next.members[id].status = "interrupted"; next.members[id].error = error instanceof Error ? error.message : "Startup failed"; });
+      this.store.update(next => { next.members[id].status = "interrupted"; delete next.members[id].needsInput; next.members[id].error = error instanceof Error ? error.message : "Startup failed"; });
+      this.publishStatus();
       throw error;
     }
   }
@@ -379,7 +405,8 @@ export class Coordinator {
   private async stopOne(id: string): Promise<void> {
     const member = this.store.state.members[id];
     if (!isLive(member)) return;
-    this.store.update(next => { next.members[id].status = "stopping"; });
+    this.store.update(next => { next.members[id].status = "stopping"; delete next.members[id].needsInput; });
+    this.publishStatus();
     const agent = this.agents.get(id);
     if (agent) await agent.stop();
     else if (member.pid && processAlive(member.pid, member.identity)) throw new Error("No owned transport for live process; refusing to kill by PID");

package/src/index.ts

@@ -10,7 +10,7 @@ import { showTeamsPanel } from "./panel.ts";
 import { teamToolRenderers, renderTeamMessage, cleanText } from "./render.ts";
 import { join } from "node:path";
 import { Coordinator, assistantEvent, taskRequestGuidance } from "./coordinator.ts";
-import { Connection } from "./connection.ts";
+import { Connection, isRecord } from "./connection.ts";
 import { policy, readDisplaySettings, defaultDisplaySettings } from "./config.ts";
 
 export default function teams(pi: ExtensionAPI) {
@@ -27,6 +27,7 @@ export default function teams(pi: ExtensionAPI) {
   let exiting = false;
   let disposeUI: (() => void) | undefined;
   let telemetryTimer: NodeJS.Timeout | undefined;
+  let inputCount = 0;
   const drafts = new Map<string, string>();
   const display = { ...defaultDisplaySettings };
   const self = environment[1] ?? "root";
@@ -44,8 +45,14 @@ export default function teams(pi: ExtensionAPI) {
       id: ctx.sessionManager.getSessionId(), cwd: ctx.cwd, sessionFile: ctx.sessionManager.getSessionFile(),
       ...policy(ctx.cwd, pi.getFlag("teams-project-config") === true, { limit: pi.getFlag("teams-limit") as string | undefined, depth: pi.getFlag("teams-depth") as string | undefined }),
       extension: fileURLToPath(import.meta.url), notice: notify, warning: warn,
+      status: (kind, active) => pi.events.emit(`herdr:${kind}`, { active, source: "ac-teams" }),
       interactive: ctx.mode === "tui", model: ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : undefined, thinking: pi.getThinkingLevel(),
-    }).then(value => { coordinator = value; return value; }, error => { opening = undefined; throw error; });
+    }).then(value => {
+      coordinator = value;
+      if (ctx.isIdle?.() === false) value.recordEvent("root", { type: "agent_start" });
+      if (inputCount > 0) value.recordEvent("root", { type: "blocked", active: true });
+      return value;
+    }, error => { opening = undefined; throw error; });
     return opening;
   }
   async function handle(operation: "agent" | "task" | "message", value: unknown, ctx: ExtensionContext): Promise<unknown> {
@@ -71,7 +78,7 @@ export default function teams(pi: ExtensionAPI) {
     return (await root(ctx)).handle("root", operation, args, authorized);
   }
   async function snapshot(ctx: ExtensionContext): Promise<TeamSnapshot> {
-    if (!child && !opening) return { members: [{ id: "root", cwd: ctx.cwd, depth: 0, status: ctx.isIdle() ? "idle" : "busy", notified: 0 }], tasks: [], messages: [], limit: 10, depth: 2 };
+    if (!child && !opening) return { members: [{ id: "root", cwd: ctx.cwd, depth: 0, status: ctx.isIdle() ? "idle" : "busy", notified: 0, needsInput: inputCount > 0 }], tasks: [], messages: [], limit: 10, depth: 2 };
     const status = await handle("agent", { action: "list" }, ctx) as Pick<TeamSnapshot, "members" | "limit" | "depth"> & { lastMessage: number };
     const tasks: TaskView[] = [];
     let total = 0;
@@ -106,7 +113,7 @@ export default function teams(pi: ExtensionAPI) {
     };
     return api;
   }
-  function report(ctx: ExtensionContext, event: { type: string; text?: string }) {
+  function report(ctx: ExtensionContext, event: { type: string; text?: string; active?: boolean }) {
     if (exiting) return;
     if (child && ctx.mode === "tui") void connection?.request("event", event).catch(error => warn(cleanText(String(error))));
     else if (!child) coordinator?.recordEvent("root", event);
@@ -130,8 +137,18 @@ export default function teams(pi: ExtensionAPI) {
     telemetryTimer.unref();
     void publish();
   }
+  pi.events.on("herdr:blocked", (data: unknown) => {
+    // Main already receives this signal locally; relay only across the team socket.
+    if (!isRecord(data) || typeof data.active !== "boolean" || data.source === "ac-teams") return;
+    inputCount = Math.max(0, inputCount + (data.active ? 1 : -1));
+    if (context) {
+      const event = { type: "blocked", active: inputCount > 0 };
+      if (child) void connection?.request("event", event).catch(error => warn(cleanText(String(error))));
+      else coordinator?.recordEvent("root", event);
+    }
+  });
   pi.on("agent_start", (_event, ctx) => report(ctx, { type: "agent_start" }));
-  pi.on("agent_settled", (_event, ctx) => report(ctx, { type: "agent_settled" }));
+  pi.on("agent_settled", (_event, ctx) => { inputCount = 0; report(ctx, { type: "agent_settled" }); });
   pi.on("tool_execution_start", (event, ctx) => report(ctx, { type: "activity", text: `Running ${event.toolName}`.slice(0, 500) }));
   pi.on("message_end", (event, ctx) => {
     const change = assistantEvent(event.message);
@@ -169,7 +186,7 @@ export default function teams(pi: ExtensionAPI) {
   }
   pi.on("session_start", async (_event, ctx) => {
     if (!child && coordinator && coordinator.store.state.id !== ctx.sessionManager.getSessionId()) { await close(); drafts.clear(); }
-    context = ctx; exiting = false;
+    context = ctx; exiting = false; inputCount = 0;
     if (child) {
       if (environment.some(value => !value)) throw new Error("Incomplete AC_TEAMS membership environment; refusing independent-root fallback");
       connection = new Connection(environment[0]!, environment[1]!, environment[2]!);

package/src/panel.ts

@@ -184,8 +184,10 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
         if (graph && !graphData && tasks.length) left[0] = fg("muted", "Graph unavailable or too large; showing list.");
       } else if (tab === 1) {
         left = [fg("muted", "  Member       Session"), "", ...memberIds().map((id, index) => {
-          const description = id === "root" ? "Main conversation" : snapshot.members.find(member => member.id === id)?.status ?? "Unavailable";
-          return fg(index === memberIndex ? "accent" : "text", `${index === memberIndex ? "●" : " "} ${name(id).padEnd(12)} ${clean(description)}`);
+          const member = snapshot.members.find(member => member.id === id);
+          const description = id === "root" ? "Main conversation" : member?.status ?? "Unavailable";
+          return fg(index === memberIndex ? "accent" : "text", `${index === memberIndex ? "●" : " "} ${name(id).padEnd(12)} `)
+            + (member?.needsInput ? fg("error", "Needs input") : fg(index === memberIndex ? "accent" : "text", clean(description)));
         })];
         selectedRow = memberIndex + 2;
         right = split ? memberDetails(rightWidth) : [];
@@ -224,7 +226,7 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
       const id = memberIds()[memberIndex];
       const member = snapshot.members.find(member => member.id === id);
       const assigned = tasks.filter(task => task.owner === id);
-      return wrap([heading(name(id)), "", label("State", clean(member?.status ?? (id === "root" ? "Main conversation" : "Unavailable"))),
+      return wrap([heading(name(id)), "", label("State", member?.needsInput ? fg("error", "Needs input") : clean(member?.status ?? (id === "root" ? "Main conversation" : "Unavailable"))),
         label("ID", id), label("Model / context", clean(modelContext(member ?? {}))),
         label("Cwd", clean(member?.cwd ?? (id === host.self ? ctx.cwd : "Unavailable"))),
         label("Session", clean(member?.sessionFile ?? member?.sessionId ?? "Unavailable")),

package/src/render.ts

@@ -1,6 +1,6 @@
 import { stripVTControlCharacters } from "node:util";
-import type { MessageRenderer, Theme, ToolRenderers } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth, wrapTextWithAnsi, type Component } from "@earendil-works/pi-tui";
+import { keyHint, type MessageRenderer, type Theme, type ToolRenderers } from "@earendil-works/pi-coding-agent";
+import { Container, Text, TruncatedText, truncateToWidth, visibleWidth, wrapTextWithAnsi, type Component } from "@earendil-works/pi-tui";
 
 export const cleanText = (text: string): string => stripVTControlCharacters(text).replaceAll("\t", " ").replace(/[\x00-\x08\x0b-\x1f\x7f-\x9f]/g, "");
 const inline = (value: unknown) => cleanText(String(value)).replace(/[\n\r\t]/g, " ");
@@ -46,18 +46,78 @@ function entry(title: string, value: unknown, expanded: boolean, theme: Theme, e
   };
 }
 
+function preview(items: unknown[], count: string, theme: Theme): string {
+  const entries = items.slice(0, 3).map(item => toolSummary(item, theme)).filter(Boolean);
+  if (items.length > 3) entries.push(`+${items.length - 3} more`);
+  return [count, ...entries].join(" · ");
+}
+
+function toolSummary(data: unknown, theme: Theme): string {
+  if (Array.isArray(data)) return preview(data, `${data.length} messages`, theme);
+  if (data && typeof data === "object") {
+    const value = data as Record<string, unknown>;
+    if (Array.isArray(value.members)) return preview(value.members, `${value.members.length} members`, theme);
+    if (Array.isArray(value.tasks)) return preview(value.tasks, `${value.tasks.length} of ${value.total} tasks`, theme);
+    const label = value.title ?? value.name ?? value.brief ?? value.text ?? value.query ?? value.id;
+    const status = value.status === undefined ? "" : inline(value.status);
+    const color = status === "done" ? "success"
+      : status === "interrupted" ? "error"
+      : status === "busy" || status === "in_progress" ? "accent"
+      : status === "todo" || status === "starting" || status === "stopping" ? "warning" : "muted";
+    const parts = [status ? theme.fg(color, theme.bold(`[${status}]`)) : "", label === undefined ? "" : inline(label)];
+    if (Array.isArray(value.recipients)) parts.push(`to ${value.recipients.map(inline).join(", ")}`);
+    for (const key of ["seq", "limit", "depth"]) {
+      if (value[key] !== undefined) parts.push(`${key}: ${inline(value[key])}`);
+    }
+    return parts.filter(Boolean).join(" ");
+  }
+  return data === undefined || data === null ? "" : inline(data);
+}
+
 export function teamToolRenderers(name: string): ToolRenderers {
   return {
+    renderShell: "self",
     renderCall(args, theme, context) {
-      return entry(name, args, context.expanded, theme);
+      if (!context.isPartial) return new Container();
+      const { action, ...fields } = (args ?? {}) as Record<string, unknown>;
+      const request = toolSummary(fields, theme);
+      const text = `${theme.fg("warning", "●")} ${theme.fg("toolTitle", name)} · ${inline(action ?? "...")} → running${request ? ` · ${request}` : ""}`;
+      return new TruncatedText(text, context.outputPad, 0);
     },
     renderResult(result, options, theme, context) {
+      if (options.isPartial) return new Container();
+      const { action, ...fields } = (context.args ?? {}) as Record<string, unknown>;
+      const text = result.content.filter(block => block.type === "text").map(block => block.text).join("\n");
       let data: unknown = result.details;
       if (data === undefined) {
-        const text = result.content.filter(part => part.type === "text").map(part => part.text).join("\n");
         try { data = JSON.parse(text); } catch { data = text; }
       }
-      return entry(`${name} ${options.isPartial ? "receiving" : "result"}`, data, options.expanded, theme, context.isError);
+      const outcome = context.isError ? `error · ${inline(text)}` : toolSummary(data, theme) || "done";
+      const request = toolSummary(fields, theme);
+      const heading = `${theme.fg(context.isError ? "error" : "success", "●")} ${theme.fg("toolTitle", name)} · ${inline(action ?? "...")} → ${outcome}${request && !outcome.includes(request) ? ` · ${request}` : ""}`;
+      const requestJSON = cleanText(JSON.stringify(context.args, null, 2));
+      const responseJSON = cleanText(result.details === undefined ? text : JSON.stringify(result.details, null, 2));
+      const hiddenLines = requestJSON.split("\n").length + responseJSON.split("\n").length + 2;
+      const hint = theme.fg("muted", options.expanded ? " (" : ` … +${hiddenLines} lines (`)
+        + keyHint("app.tools.expand", options.expanded ? "to collapse" : "to expand") + theme.fg("muted", ")");
+      const row = new Container();
+      row.addChild({
+        invalidate() {},
+        render(width) {
+          const pad = " ".repeat(Math.min(context.outputPad, Math.floor(width / 2)));
+          const available = Math.max(0, width - pad.length * 2);
+          // Keep the hint visible unless the terminal is too narrow to also identify the tool.
+          const suffix = available >= visibleWidth(hint) + 30 ? hint : "";
+          return [pad + truncateToWidth(heading, available - visibleWidth(suffix)) + suffix + pad];
+        },
+      });
+      if (options.expanded) {
+        row.addChild(new Text(theme.fg("muted", "Request"), context.outputPad, 0));
+        row.addChild(new Text(requestJSON, context.outputPad, 0));
+        row.addChild(new Text(theme.fg("muted", "Response"), context.outputPad, 0));
+        row.addChild(new Text(responseJSON, context.outputPad, 0));
+      }
+      return row;
     },
   };
 }

package/src/schemas.ts

@@ -40,13 +40,15 @@ const ContextUsageSchema = Type.Object({
   contextWindow: Type.Integer({ minimum: 1, maximum: Number.MAX_SAFE_INTEGER }),
   percent: Type.Union([Type.Null(), Type.Number({ minimum: 0 })]),
 }, { additionalProperties: false });
-const EventSchema = Type.Object({
+const EventSchema = Type.Union([Type.Object({
+  type: Type.Literal("blocked"), active: Type.Boolean(),
+}, { additionalProperties: false }), Type.Object({
   type: Type.Union(["agent_start", "agent_settled", "activity", "summary", "model_error", "telemetry"].map(v => Type.Literal(v))),
   text: Type.Optional(Type.String({ maxLength: 2000 })),
   model: Type.Optional(Type.String({ maxLength: 256 })),
   modelName: Type.Optional(Type.String({ maxLength: 256 })),
   contextUsage: Type.Optional(Type.Union([Type.Null(), ContextUsageSchema])),
-}, { additionalProperties: false });
+}, { additionalProperties: false })]);
 export function validate(operation: string, value: unknown): void {
   const schema = operation === "agent" ? AgentSchema : operation === "task" ? TaskSchema : operation === "message" ? MessageSchema : operation === "ui" ? UserActionSchema : operation === "event" ? EventSchema : undefined;
   if (!schema || !Value.Check(schema, value)) throw new Error(`Invalid ${operation} request`);

package/src/store.ts

@@ -28,7 +28,9 @@ export function processIdentity(pid: number): string | undefined {
     }
     throw error;
   }
-  const start = stat.slice(stat.lastIndexOf(")") + 2).split(" ")[19];
+  const fields = stat.slice(stat.lastIndexOf(")") + 2).split(" ");
+  if (fields[0] === "Z" || fields[0] === "X") return undefined;
+  const start = fields[19];
   requireValue(start && /^\d+$/.test(start), "Cannot determine process identity");
   const boot = readFileSync("/proc/sys/kernel/random/boot_id", "utf8").trim();
   requireValue(boot, "Cannot determine boot identity");
@@ -39,9 +41,8 @@ export function processAlive(pid: number, identity?: string): boolean {
   requireValue(integer(pid, 1), "Invalid PID");
   try { process.kill(pid, 0); }
   catch (error) { if (code(error) === "ESRCH") return false; throw error; }
-  if (identity === undefined) return true;
   const actual = processIdentity(pid);
-  return actual !== undefined && actual === identity;
+  return actual !== undefined && (identity === undefined || actual === identity);
 }
 
 function validateWorktree(value: unknown): value is Worktree {
@@ -90,6 +91,7 @@ function validate(state: unknown): asserts state is TeamState {
       requireValue(object(usage) && integer(usage.contextWindow, 1) && (usage.tokens === null || integer(usage.tokens)) && (usage.percent === null || typeof usage.percent === "number" && Number.isFinite(usage.percent) && usage.percent >= 0), "Invalid member context usage");
     }
     requireValue(member.terminal === undefined || typeof member.terminal === "boolean", "Invalid member terminal flag");
+    requireValue(member.needsInput === undefined || typeof member.needsInput === "boolean", "Invalid member input flag");
     requireValue(member.pid === undefined || integer(member.pid, 1), "Invalid member PID");
     requireValue(member.worktree === undefined || validateWorktree(member.worktree), "Invalid member worktree");
     const seen = new Set<string>([key]);

package/src/terminal-agent.ts

@@ -44,7 +44,7 @@ export class TerminalAgent extends EventEmitter {
       writeFileSync(config, "set -g status off\nset -g prefix None\nset -s extended-keys always\nbind-key -n C-S-Left detach-client\n", { flag: "wx", mode: 0o600 });
       this.files.push(config);
       const exports = Object.entries(this.options.env)
-        .filter(([key, value]) => key.startsWith("AC_TEAMS_") && value !== undefined)
+        .filter(([key, value]) => (key.startsWith("AC_TEAMS_") || key === "HERDR_ENV") && value !== undefined)
         .map(([key, value]) => `export ${key}=${quote(value!)}`);
       const command = this.options.command ?? process.env.AC_TEAMS_PI ?? "pi";
       writeFileSync(script, [...exports,

package/src/terminal-ui.ts

@@ -122,13 +122,18 @@ export function installTeamFooter(_pi: ExtensionAPI, ctx: ExtensionContext, host
           const status = member?.status === "busy" ? "working" : member?.status ?? "idle";
           const metrics = id === host.self ? readTelemetry(ctx) : member ?? {};
           const title = id === "root" ? "main" : memberName(member ?? { id });
-          const description = `${title}  ${id === "root" ? "" : status + " · "}${modelContext(metrics)}${assigned ? ` · ${taskName(assigned)}` : ""}${member?.error || member?.activity ? ` · ${member.error || member.activity}` : ""}`;
-          return theme.fg(selected === id || host.self === id ? "accent" : "muted", `${selected === id ? ">" : " "} ${host.self === id ? "●" : "○"} ${cleanText(description).replaceAll("\n", " ")}`);
+          const color = selected === id || host.self === id ? "accent" : "muted";
+          const titleRow = theme.fg(color, `${selected === id ? ">" : " "} ${host.self === id ? "●" : "○"} ${cleanText(title).replaceAll("\n", " ")}`);
+          const attention = member?.needsInput ? theme.fg("error", " · Needs input") : "";
+          const description = `  ${id === "root" ? "" : status + " · "}${modelContext(metrics)}${assigned ? ` · ${taskName(assigned)}` : ""}${member?.error || member?.activity ? ` · ${member.error || member.activity}` : ""}`;
+          return titleRow + attention + theme.fg(color, cleanText(description).replaceAll("\n", " "));
         };
         const peers = ids().slice(1);
-        return (display.agents ? [row("root"), ...peers.slice(start, start + slots()).map(row),
-          ...(peers.length > 4 ? [theme.fg("dim", `  ↑ ${start} above · ↓ ${Math.max(0, peers.length - start - slots())} below`)] : [])] : []
-        ).map(line => truncateToWidth(line, width));
+        return [
+          ...(host.self !== "root" ? [theme.fg("dim", "Ctrl+Shift+Left: Main (keeps questions open)")] : []),
+          ...(display.agents ? [row("root"), ...peers.slice(start, start + slots()).map(row),
+            ...(peers.length > 4 ? [theme.fg("dim", `  ↑ ${start} above · ↓ ${Math.max(0, peers.length - start - slots())} below`)] : [])] : []),
+        ].map(line => truncateToWidth(line, width));
       },
       invalidate() {},
     };

package/src/types.ts

@@ -38,6 +38,7 @@ export interface Member {
   activity?: string;
   summary?: string;
   terminal?: boolean;
+  needsInput?: boolean;
 }
 export const memberNameMaxLength = 40;
 export const memberNamePattern = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)?(?![\s\S])/;