ac-teams 0.0.2 → 0.0.4

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.
@@ -26,9 +26,9 @@ Your Pi session is the root; its child agents are members. Ask Pi to delegate a
 
 `/teams` or `/teams panel` opens Tasks, Teammates, and Activity. `/teams teammate <name-or-id>` opens a teammate directly; subcommands and teammate names autocomplete. Use the task graph or list, send feedback, and open a member's full live Pi session.
 
-The task summary sits above the input. The agent selector below status shows descriptive names, models, and context usage. `/teams config` toggles these displays independently.
+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 footer, 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

@@ -12,11 +12,15 @@ In interactive Pi, `/teams` or `/teams panel` opens the team panel. `/teams team
 
 ## Navigate without stopping members
 
-The agent selector sits below Pi's status lines. 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.
+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 footer. Up/Down select members; Enter opens the selected live session; Esc returns to editing.
+- 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.
 - Ctrl+Shift+Left returns from a member to Main. Switching preserves the member's process, session, and draft. Returning does not stop it.
 - `/teams` opens three tabs. Tab moves between Tasks, Teammates, and Activity; Esc closes the panel.
     - **Tasks:** Arrow keys select nodes in the dependency graph. G toggles graph/list, and Enter shows full details. Green means Done, red Blocked, cyan Working, and neutral Ready; written labels remain visible. Large or unsupported graphs fall back to the list.
@@ -32,7 +36,7 @@ Team tool results and messages are compact by default. Ctrl+O expands them into
 
 ## Show tasks and configure the displays
 
-The task summary sits above the input editor; the agent selector stays below the status lines. It shows completed/total counts and up to five numbered task labels, ordered by:
+The task summary sits above the input editor; the agent selector sits below the editor. The task summary shows completed/total counts and up to five numbered task labels, ordered by:
 
 1. In-progress work
 2. Ready prerequisites blocking other tasks, with the most dependents first
@@ -41,6 +45,8 @@ The task summary sits above the input editor; the agent selector stays below the
 
 Ordinary ready tasks remain in `/teams`; the summary is not the full task list. Completion time determines recent order for newly completed tasks. Older completed tasks without timestamps fall back to task-number order.
 
+ac-teams leaves your existing footer intact and publishes a compact summary under the `ac-teams` extension-status key. Custom footers must support extension statuses to show it. In Zentui, use `/zentui extensions` to choose a placement for `ac-teams` if statuses are hidden by default. Agent navigation remains available in its own row even when the footer hides statuses.
+
 Use `/teams config` to toggle **Task summary** and **Agent selector** independently. Up/Down select a setting; Space or Enter toggles it; Esc closes. Changes save immediately for the current and future sessions. Other running sessions are not updated automatically. Both displays default to On.
 
 Hiding a display does not stop agents, change tasks, or disable `/teams`. With the agent selector hidden, ordinary editor Down behavior returns. These global display preferences do not change the team's resource ceilings.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ac-teams",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Small, persistent teams for Pi",
   "type": "module",
   "license": "MIT",

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/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

@@ -1,7 +1,7 @@
 import { spawn, execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { CustomEditor, getSettingsListTheme, type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { matchesKey, renderFakeCursor, truncateToWidth, visibleWidth, SettingsList } from "@earendil-works/pi-tui";
+import { matchesKey, renderFakeCursor, truncateToWidth, visibleWidth, SettingsList, type EditorComponent, type Focusable } from "@earendil-works/pi-tui";
 import { cleanText } from "./render.ts";
 import { isLive, taskName, memberName } from "./types.ts";
 import { saveDisplaySettings, type DisplaySettings } from "./config.ts";
@@ -68,11 +68,11 @@ export async function showDisplayConfig(ctx: ExtensionContext, settings: Display
   }, { overlay: true, overlayOptions: { width: 64, minWidth: 30, anchor: "center" } });
 }
 
-export function installTeamFooter(pi: ExtensionAPI, ctx: ExtensionContext, host: PanelHost, display: DisplaySettings): () => void {
+export function installTeamFooter(_pi: ExtensionAPI, ctx: ExtensionContext, host: PanelHost, display: DisplaySettings): () => void {
   let members: Awaited<ReturnType<PanelHost["snapshot"]>>["members"] = [];
   let tasks: Awaited<ReturnType<PanelHost["snapshot"]>>["tasks"] = [];
   let selected: string | undefined, start = 0;
-  let editor: CustomEditor | undefined;
+  let editor: (EditorComponent & Partial<Focusable> & { isShowingAutocomplete?(): boolean }) | undefined;
   let redraw = () => {};
   let disposed = false;
   let timer: NodeJS.Timeout | undefined;
@@ -87,10 +87,19 @@ export function installTeamFooter(pi: ExtensionAPI, ctx: ExtensionContext, host:
   };
   async function refresh() {
     try {
-      if (!display.tasks && !display.agents) return;
+      if (!display.tasks && !display.agents) {
+        ctx.ui.setStatus("ac-teams", undefined);
+        redraw();
+        return;
+      }
       const next = await host.snapshot();
       if (disposed) return;
       members = next.members; tasks = next.tasks;
+      const count = ids().length;
+      ctx.ui.setStatus("ac-teams", `Teams ${[
+        ...(display.agents ? [`${count} ${count === 1 ? "agent" : "agents"}`, `${members.filter(member => member.status === "busy").length} working`] : []),
+        ...(display.tasks ? [`${tasks.filter(task => task.status === "done").length}/${tasks.length} tasks done`] : []),
+      ].join(" · ")}`);
       if (selected && !ids().includes(selected)) { selected = undefined; if (editor) editor.focused = true; }
       start = Math.min(start, Math.max(0, ids().length - 1 - slots()));
       reveal(); redraw();
@@ -102,61 +111,69 @@ export function installTeamFooter(pi: ExtensionAPI, ctx: ExtensionContext, host:
     render: width => display.tasks ? renderTaskSummary(tasks, theme, width) : [],
     invalidate() {},
   }), { placement: "aboveEditor" });
-  ctx.ui.setFooter((tui, theme, data) => {
+  ctx.ui.setWidget("ac-teams-agents", (tui, theme) => {
     redraw = () => tui.requestRender();
-    const unsubscribe = data.onBranchChange(redraw);
     return {
       render(width) {
         if (!display.agents && selected !== undefined) { selected = undefined; if (editor) editor.focused = true; }
-        const branch = data.getGitBranch(), usage = ctx.getContextUsage()?.percent;
         const row = (id: string) => {
           const member = members.find(member => member.id === id);
           const assigned = tasks.find(task => task.owner === id && task.status === "in_progress") ?? tasks.find(task => task.owner === id && task.status !== "done");
           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 [theme.fg("dim", `${cleanText(ctx.cwd)}${branch ? ` (${cleanText(branch)})` : ""}`),
-          theme.fg("dim", `${usage == null ? "Unknown" : usage.toFixed(1) + "%"} context · ${ctx.model?.id ?? "no model"} · ${pi.getThinkingLevel()}`),
-          ...Array.from(data.getExtensionStatuses().values(), status => theme.fg("dim", cleanText(status))),
-          ...(display.agents ? ["", row("root"), ...peers.slice(start, start + slots()).map(row),
+        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() {},
-      dispose() { disposed = true; clearTimeout(timer); unsubscribe(); },
     };
-  });
-  ctx.ui.setEditorComponent((tui, theme, keys) => {
-    class TeamEditor extends CustomEditor {
-      render(width: number) {
-        const lines = super.render(width);
-        return selected === undefined ? lines : lines.map(line => line.replace(renderFakeCursor(" "), " "));
+  }, { placement: "belowEditor" });
+  const previousEditor = ctx.ui.getEditorComponent();
+  const teamEditor: NonNullable<typeof previousEditor> = (tui, theme, keys) => {
+    const current: NonNullable<typeof editor> = previousEditor?.(tui, theme, keys) ?? new CustomEditor(tui, theme, keys);
+    // Decorate the instance so custom editor methods and Pi's app-control wiring survive.
+    const render = current.render.bind(current), handleInput = current.handleInput.bind(current);
+    current.render = (width: number) => {
+      const lines = render(width);
+      return disposed || selected === undefined ? lines : lines.map(line => line.replace(renderFakeCursor(" "), " "));
+    };
+    current.handleInput = (input: string) => {
+      if (disposed) { handleInput(input); return; }
+      if (!display.agents) { selected = undefined; current.focused = true; handleInput(input); return; }
+      if (selected !== undefined) {
+        const destinations = ids(), index = destinations.indexOf(selected);
+        if (matchesKey(input, "down")) selected = destinations[Math.min(destinations.length - 1, index + 1)];
+        else if (matchesKey(input, "up")) selected = index <= 0 ? undefined : destinations[index - 1];
+        else if (matchesKey(input, "escape")) selected = undefined;
+        else if (matchesKey(input, "enter")) {
+          const id = selected; selected = undefined;
+          void host.visit(id).catch(error => ctx.ui.notify(cleanText(String(error)), "error"));
+        } else { selected = undefined; handleInput(input); }
+        current.focused = selected === undefined; reveal(); redraw(); return;
       }
-      handleInput(input: string) {
-        if (!display.agents) { selected = undefined; this.focused = true; super.handleInput(input); return; }
-        if (selected !== undefined) {
-          const destinations = ids(), index = destinations.indexOf(selected);
-          if (matchesKey(input, "down")) selected = destinations[Math.min(destinations.length - 1, index + 1)];
-          else if (matchesKey(input, "up")) selected = index <= 0 ? undefined : destinations[index - 1];
-          else if (matchesKey(input, "escape")) selected = undefined;
-          else if (matchesKey(input, "enter")) {
-            const id = selected; selected = undefined;
-            void host.visit(id).catch(error => ctx.ui.notify(cleanText(String(error)), "error"));
-          } else { selected = undefined; super.handleInput(input); }
-          this.focused = selected === undefined; reveal(); redraw(); return;
-        }
-        if (matchesKey(input, "down") && !this.getText() && !this.isShowingAutocomplete()) {
-          selected = "root"; start = 0; this.focused = false; redraw(); return;
-        }
-        super.handleInput(input);
+      if (matchesKey(input, "down") && !current.getText() && !current.isShowingAutocomplete?.()) {
+        selected = "root"; start = 0; current.focused = false; redraw(); return;
       }
-    }
-    editor = new TeamEditor(tui, theme, keys);
-    return editor;
-  });
-  return () => { disposed = true; clearTimeout(timer); ctx.ui.setWidget("ac-teams-tasks", undefined); ctx.ui.setFooter(undefined); ctx.ui.setEditorComponent(undefined); };
+      handleInput(input);
+    };
+    editor = current;
+    return current;
+  };
+  ctx.ui.setEditorComponent(teamEditor);
+  return () => {
+    disposed = true; clearTimeout(timer);
+    ctx.ui.setWidget("ac-teams-tasks", undefined); ctx.ui.setWidget("ac-teams-agents", undefined);
+    ctx.ui.setStatus("ac-teams", undefined);
+    if (ctx.ui.getEditorComponent() === teamEditor) ctx.ui.setEditorComponent(previousEditor);
+  };
 }

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])/;