ac-teams 0.0.11 → 0.0.13

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 and 1.5.0.
 
 ```sh
-pi install npm:ac-teams@0.0.4
+pi install npm:ac-teams
 ```
 
 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.

package/docs/usage.md

@@ -24,7 +24,10 @@ Context shows Pi's reported token estimate, window size, and percentage, for exa
 - 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.
-    - **Teammates:** Enter opens a live member, or quietly resumes a stopped member's saved session before opening it. Root can open any member; member views can open their descendants.
+    - **Teammates:** Shows working, idle, stopped, and needs-input counts; interrupted sessions count as needing input. Enter opens a live member, or quietly resumes a stopped member's saved session before opening it. Right opens details; Esc returns to the roster. Model, context, and directory appear above session IDs and paths. Root can open any member; member views can open their descendants.
+        - Wider rosters also show Tasks (completed / currently assigned total) and the directory's final folder name. Reassigned tasks leave the previous owner's counts. Narrower views drop Directory first, then Tasks; full paths and counts remain in details.
+        - Press `/` to filter names (case-insensitive). Enter applies the filter; Esc while editing clears it. Backspace edits the query. Press `/` again to edit an applied filter.
+        - H hides or shows stopped members. Interrupted sessions remain visible for recovery. All members are visible by default; filters affect only this panel, not team state.
     - **Activity:** Shows the latest 100 persistent team messages rather than every tool update. Use `team_message history` to read older messages.
 - N composes a task request for Main. C on a task sends feedback to its creator. Enter sends; Shift+Enter adds a newline; Esc cancels without losing the draft. These messages do not directly edit the task graph. Feedback resumes a stopped creator when possible; otherwise, the receipt explicitly reports delivery to Main instead.
 
@@ -36,7 +39,7 @@ Each team tool call uses one line with a status dot, tool name, action, and resu
 
 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.
+Tool summaries and team notification previews prefer teammate names over IDs. Message receipt IDs stay out of compact summaries. Ctrl+O expands the original request and response, including IDs. Unknown members fall back to their IDs. UI state colors do not replace the underlying progress, ownership, or dependency fields.
 
 ## Main sessions share one team
 
@@ -156,7 +159,11 @@ Example `team_message` arguments:
 {"action":"send","recipients":["root"],"text":"Parser review complete. No edits; two malformed-input cases need tests."}
 ```
 
-Omit `recipients` to notify all other live members. Explicit sets must contain unique live member IDs; an invalid set rejects the whole send. All team members can read the full history, including direct messages.
+Use exact teammate names (such as `"oom-review"`) or member IDs in `recipients`; IDs remain valid. Omit `recipients` to notify all other live members.
+
+Each recipient must resolve to a different live member. An unknown name, a stopped member, or two entries for the same member rejects the whole send.
+
+Receipts and stored history retain resolved IDs. All team members can read the full history, including direct messages.
 
 ```json
 {"action":"history","after":0,"limit":20}

package/package.json

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

package/src/index.ts

@@ -7,8 +7,8 @@ import { installTeamFooter, visitMember, showDisplayConfig } from "./terminal-ui
 import { readTelemetry } from "./telemetry.ts";
 import { resolveTeammate, teamsCompletions } from "./commands.ts";
 import { showTeamsPanel } from "./panel.ts";
-import { teamToolRenderers, renderTeamMessage, cleanText } from "./render.ts";
-import { join } from "node:path";
+import { teamToolRenderers, teamMessageRenderer, cleanText } from "./render.ts";
+import { dirname, join } from "node:path";
 import { randomUUID } from "node:crypto";
 import { execFile } from "node:child_process";
 import { existsSync, readdirSync } from "node:fs";
@@ -48,7 +48,13 @@ export default function teams(pi: ExtensionAPI) {
   const teamTools = ["team_agent", "team_task", "team_message"];
   const memberId = () => child ? environment[1]! : team?.member ?? "root";
   const teamId = (ctx: ExtensionContext) => team?.team ?? ctx.sessionManager.getSessionId();
-  pi.registerMessageRenderer("ac-teams", renderTeamMessage);
+  function memberLabels(): Record<string, string> {
+    try {
+      const members = coordinator?.store.state.members ?? readState(child ? dirname(environment[0]!) : join(teamsHome(), teamId(context!))).members;
+      return Object.fromEntries(Object.values(members).map(member => [member.id, memberName(member)]));
+    } catch { return { root: "Main" }; } // A transcript can render before its team is available.
+  }
+  pi.registerMessageRenderer("ac-teams", teamMessageRenderer(memberLabels));
   const warn = (message: string) => context?.ui.notify(message, "warning");
   const notify = (through: number, messages: Message[] = []) => {
     pi.sendMessage({ customType: "ac-teams", content: `New team messages through sequence ${through}. Read team_message history after your last cursor. Reply only with useful updates, not acknowledgements.`, display: true, details: { through, messages } }, { deliverAs: "followUp", triggerTurn: true });
@@ -273,13 +279,13 @@ export default function teams(pi: ExtensionAPI) {
     if (change) report(ctx, change);
   });
   function output(data: unknown) { return { content: [{ type: "text" as const, text: JSON.stringify(data) }], details: data }; }
-  const guidance = "Team launches use real long-lived Pi sessions. Idle members count against the shared ceiling. Use stable member/task IDs; query status and history instead of acknowledging notifications. Limits cover only ac-teams, not other launchers or shell commands.";
+  const guidance = "Team launches use real long-lived Pi sessions. Idle members count against the shared ceiling. Use teammate names for messaging and stable IDs for member control and tasks; query status and history instead of acknowledging notifications. Limits cover only ac-teams, not other launchers or shell commands.";
   const taskTrackingGuidance = "Before delegating a deliverable through team_agent, create or reuse a team_task and include its ID in the member's brief. Use one shared task list for your own work and delegated work; do not create one task per teammate by default. Quick lookups and brief second opinions need no separate task unless their results need coordination or follow-up.";
   pi.registerTool({
     name: "team_agent", label: "Team agent", description: "Launch/resume Pi members, list/status, stop owned subtrees, change root limits, and explicitly clean stopped worktrees. Create or reuse team_task entries for delegated deliverables; quick lookups need no task unless results need coordination or follow-up.",
     promptGuidelines: [guidance, taskTrackingGuidance, "Delegation needs the user's authorization. Give each new member a unique descriptive name (one or two lowercase words, hyphenated if two), plus a bounded brief. Names remain stable on resume. Avoid concurrent writers in the same cwd. Worktrees are opt-in."],
     parameters: AgentSchema,
-    ...teamToolRenderers("team_agent"),
+    ...teamToolRenderers("team_agent", memberLabels),
     async execute(_id, args, _signal, _update, ctx) { return output(await handle("agent", args, ctx)); },
   });
   pi.registerTool({
@@ -294,7 +300,7 @@ export default function teams(pi: ExtensionAPI) {
       "team_task start refuses another owner's task or unfinished dependencies. Complete requires ownership, in-progress work, and acceptance=true. Release clears ownership, returns in-progress work to todo, and leaves done work done. Reopen is explicit and cannot invalidate active or done dependents.",
     ],
     parameters: TaskSchema,
-    ...teamToolRenderers("team_task"),
+    ...teamToolRenderers("team_task", memberLabels),
     async execute(_id, args, _signal, _update, ctx) {
       const data = await handle("task", args, ctx) as TaskView | { tasks: TaskView[]; total: number };
       const compact = (task: TaskView) => ({ id: task.id, number: task.number, label: task.label, title: task.title, status: task.status, owner: task.owner, revision: task.revision, dependencies: task.dependencies, blockedBy: task.blockedBy });
@@ -303,10 +309,10 @@ export default function teams(pi: ExtensionAPI) {
     },
   });
   pi.registerTool({
-    name: "team_message", label: "Team message", description: "Send a persistent direct/team message or read cursor-paged history. Send returns a receipt; history and search return full messages. New messages queue a compact follow-up notification for each recipient.",
+    name: "team_message", label: "Team message", description: "Send a persistent direct/team message to teammate names or IDs, or read cursor-paged history. Send returns a receipt with resolved IDs; history and search return full messages. New messages queue a compact follow-up notification for each recipient.",
     promptGuidelines: ["Do not poll team_message history while waiting for replies; notifications trigger a follow-up turn. On notification, read team_message history after your last read cursor and advance it through the returned messages. An empty result means no newer messages, not that a teammate has finished."],
     parameters: MessageSchema,
-    ...teamToolRenderers("team_message"),
+    ...teamToolRenderers("team_message", memberLabels),
     async execute(_id, args, _signal, _update, ctx) {
       const result = await handle("message", args, ctx);
       if (args.action === "send") {

package/src/panel.ts

@@ -1,6 +1,7 @@
+import { basename } from "node:path";
 import type { ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
 import { Editor, indexedColor, matchesKey, sliceByColumn, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
-import { modelContext } from "./telemetry.ts";
+import { contextSummary } from "./telemetry.ts";
 import { buildTaskGraph, moveTaskSelection, taskStatus } from "./graph.ts";
 import { cleanText as clean } from "./render.ts";
 import type { PanelHost } from "./ui-types.ts";
@@ -18,15 +19,22 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
   const destination = await ctx.ui.custom<string | undefined>((tui, theme, _kb, done) => {
     let tab = 0, taskIndex = 0, memberIndex = 0, eventIndex = 0;
     let graph = true, detail = false, scroll = 0, detailScroll = 0, columnScroll = 0;
-    let height = 30, bodyHeight = 21, receipt = "Select a task or teammate. N requests a task from Main.";
+    let height = 30, bodyHeight = 21, receipt = "";
     let compose: "new" | "feedback" | undefined;
     let sending = false, opening = false, disposed = false;
     let composeTask: TaskView | undefined;
     let timer: ReturnType<typeof setTimeout> | undefined;
     let focused = true;
+    let memberQuery = "", searching = false, hideStopped = false;
     const tabs = ["Tasks", "Teammates", "Activity"];
     const selectedTask = () => tasks[taskIndex];
-    const memberIds = () => ["root", ...snapshot.members.filter(member => member.id !== "root").map(member => member.id)];
+    const memberIds = () => ["root", ...snapshot.members.filter(member => member.id !== "root").map(member => member.id)]
+      .filter(id => name(id).toLowerCase().includes(memberQuery.toLowerCase())
+        && (!hideStopped || snapshot.members.find(member => member.id === id)?.status !== "stopped"));
+    const taskProgress = (id: string) => {
+      const assigned = tasks.filter(task => task.owner === id);
+      return `${assigned.filter(task => task.status === "done").length}/${assigned.length}`;
+    };
     const refresh = () => { if (!disposed) tui.requestRender(); };
     async function poll() {
       try {
@@ -47,9 +55,12 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
     const statusText = (task: TaskView, text: string) => taskStatus(task) === "Ready" ? fg("muted", text)
       : theme.style(text, { fg: indexedColor(({ Done: 2, Blocked: 1, Working: 6, Ready: 7 })[taskStatus(task)]) });
     const stateLabel = (task: TaskView) => statusText(task, taskStatus(task));
-    const pad = (text: string, width: number) => truncateToWidth(text, width) + " ".repeat(Math.max(0, width - visibleWidth(text)));
+    const pad = (text: string, width: number) => {
+      const clipped = truncateToWidth(text, width);
+      return clipped + " ".repeat(Math.max(0, width - visibleWidth(clipped)));
+    };
     const heading = (text: string) => theme.bold(fg("text", text));
-    const label = (key: string, value: string) => fg("muted", key.padEnd(10)) + value;
+    const label = (key: string, value: string) => fg("muted", key.padEnd(9) + " ") + value;
     const wrap = (lines: string[], width: number) => lines.flatMap(line => wrapTextWithAnsi(line, Math.max(1, width)));
     const editor = new Editor(tui, {
       borderColor: text => fg("accent", text),
@@ -185,13 +196,38 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
         right = split ? taskDetails(rightWidth) : [];
         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 ids = memberIds();
+        const sessionWidth = Math.min(17, Math.max(1, Math.floor(leftWidth / 2)));
+        const preferredNameWidth = Math.min(24, Math.max(18, ...ids.map(id => visibleWidth(name(id)))));
+        const tasksWidth = Math.max(5, ...ids.map(id => taskProgress(id).length));
+        const showTasks = leftWidth >= 2 + preferredNameWidth + 4 + sessionWidth + 4 + tasksWidth;
+        const directory = (id: string) => clean(basename(snapshot.members.find(member => member.id === id)?.cwd ?? (id === host.self ? ctx.cwd : ""))) || "—";
+        const directorySpace = showTasks ? leftWidth - (2 + preferredNameWidth + 4 + sessionWidth + 4 + tasksWidth + 4) : 0;
+        const showDirectory = directorySpace >= 10;
+        const directoryWidth = showDirectory ? Math.min(directorySpace, Math.max(10, ...ids.map(id => visibleWidth(directory(id))))) : 0;
+        let nameWidth = Math.max(1, Math.min(preferredNameWidth, leftWidth - sessionWidth - 6));
+        const gaps = 1 + Number(showTasks) + Number(showDirectory);
+        const spare = Math.max(0, leftWidth - (2 + nameWidth + sessionWidth + (showTasks ? tasksWidth : 0) + directoryWidth + 4 * gaps));
+        const nameExtra = Math.min(spare, Math.max(0, ...ids.map(id => visibleWidth(name(id)) - nameWidth)));
+        const gap = " ".repeat(4 + Math.floor((spare - nameExtra) / gaps));
+        nameWidth += nameExtra + (spare - nameExtra) % gaps;
+        left = [fg("muted", `  ${pad("Member", nameWidth)}${gap}${pad("Session", sessionWidth)}`
+          + (showTasks ? `${gap}${pad("Tasks", tasksWidth)}` : "") + (showDirectory ? `${gap}Directory` : "")), ...ids.map((id, index) => {
           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)));
+          const selected = index === memberIndex;
+          const stopped = member && ["stopped", "interrupted"].includes(member.status);
+          const description = member?.needsInput ? "Needs input" : id === "root" ? "Main conversation"
+            : clean(member?.status ?? "Unavailable").replace(/^./, char => char.toUpperCase());
+          const color = member?.needsInput || member?.status === "interrupted" ? "error"
+            : member?.status === "busy" ? "accent" : "muted";
+          const memberName = fg(selected ? "accent" : stopped ? "dim" : "text", pad(name(id), nameWidth));
+          return fg(selected ? "accent" : "dim", `${selected ? "●" : " "} `)
+            + (selected ? theme.bold(memberName) : memberName) + gap + fg(color, pad(description, sessionWidth))
+            + (showTasks ? fg("muted", `${gap}${pad(taskProgress(id), tasksWidth)}`) : "")
+            + (showDirectory ? fg("muted", `${gap}${pad(directory(id), directoryWidth)}`) : "");
         })];
-        selectedRow = memberIndex + 2;
+        if (!ids.length) left.push(fg("muted", "No matching teammates."));
+        selectedRow = memberIndex + 1;
         right = split ? memberDetails(rightWidth) : [];
       } else {
         left = events.length ? [fg("muted", "  Recent messages · newest first"), "", ...events.flatMap((event, index) => [
@@ -226,20 +262,23 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
     function memberDetails(width: number) {
       if (tab === 2) return eventDetails(width);
       const id = memberIds()[memberIndex];
+      if (!id) return wrap([heading("No matching teammates"), "Change the name filter or show stopped members."], width);
       const member = snapshot.members.find(member => member.id === id);
       const assigned = tasks.filter(task => task.owner === id);
-      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")),
-        label("Worktree", member?.worktree ? clean(`${member.worktree.path} (${member.worktree.branch})`) : "None"),
+      return wrap([heading(name(id)), "", label("State", member?.needsInput ? fg("error", "Needs input") : clean(member?.status ?? (id === "root" ? "Main conversation" : "Unavailable")).replace(/^./, char => char.toUpperCase())),
+        label("Model", clean(member?.modelName || member?.model?.slice(member.model.indexOf("/") + 1) || "Unknown")),
+        label("Context", clean(contextSummary(member?.contextUsage).replace(/^context unknown/, "Unknown"))),
+        label("Directory", clean(member?.cwd ?? (id === host.self ? ctx.cwd : "Unavailable"))),
+        label("Tasks", taskProgress(id)), fg("muted", "Completed / currently assigned"),
         ...(member?.error ? [label("Error", clean(member.error))] : []), "", heading("Assigned tasks"),
         ...assigned.map(task => `${clean(taskName(task))} · ${taskStatus(task)}`),
         ...(assigned.length ? [] : [fg("muted", "No assigned tasks.")]), "",
-        heading("Message with full context"), "Open the native Pi session to read its conversation and type your message there.", "",
-        fg("accent", member && ["stopped", "interrupted"].includes(member.status) ? "Enter  Resume and open" : "Enter  Open full session"),
-        fg("muted", "No separate message composer."),
-        ...(!host.child && member?.role === "member" ? ["", fg("accent", "P  Promote to main session"), fg("muted", "Stops it and reopens its transcript as a main session in its own terminal.")] : []),
+        fg("accent", member && ["stopped", "interrupted"].includes(member.status) ? "Enter  Resume and open" : "Enter  Open session"),
+        ...(!detail ? [fg("muted", "→  Details")] : []),
+        ...(!host.child && member?.role === "member" ? [fg("accent", "P  Promote to main session"), fg("muted", "Stops member; reopens transcript as a main session.")] : []),
+        "", heading("Session details"), label("ID", id),
+        label("Session", clean(member?.sessionFile ?? member?.sessionId ?? "Unavailable")),
+        label("Worktree", member?.worktree ? clean(`${member.worktree.path} (${member.worktree.branch})`) : "None"),
       ], width);
     }
 
@@ -253,13 +292,24 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
         const row = (text: string) => fg("dim", "│ ") + pad(text, inner) + fg("dim", " │");
         const title = heading("Teams") + fg("muted", ` · ${name(host.self)} · ${snapshot.members.filter(member => member.id !== "root" && ["starting", "busy", "idle", "stopping"].includes(member.status)).length}/${snapshot.limit} live · depth ${snapshot.depth}`);
         const tabLine = tabs.map((text, index) => index === tab ? theme.bold(fg("accent", `[${text}]`)) : fg("muted", ` ${text} `)).join("  ") + (tab === 0 && inner >= 78 ? fg("muted", `    ${graph ? "Graph · prerequisites above · G List" : "List · G Graph"}`) : "");
-        const help = compose ? "Enter Send · Shift+Enter Newline · Esc Keep draft"
-          : detail ? tab === 0 ? "↑↓ Scroll · C Feedback · O Open owner · Esc Back" : "↑↓ Scroll · O Open related session · Esc Back"
+        const filters = `${searching || memberQuery ? `/ Filter: ${memberQuery}${searching ? "▏" : ""}` : "/ Filter"} · H ${hideStopped ? "Stopped: hidden" : "Hide stopped"}`;
+        const help = searching ? `${filters} · Enter Apply · Esc Clear`
+          : compose ? "Enter Send · Shift+Enter Newline · Esc Keep draft"
+          : detail ? tab === 0 ? "↑↓ Scroll · C Feedback · O Open owner · Esc Back"
+            : tab === 1 ? "↑↓ Scroll · Enter Open session · Esc Back" : "↑↓ Scroll · O Open related session · Esc Back"
           : tab === 0 ? `${graph ? "↑↓←→" : "↑↓"} Select · Enter Details · G Graph/List · C Feedback · N New task · Tab Next · Esc Close`
-          : tab === 1 ? "↑↓ Select · → Details · Enter Open session · N New task · Tab Next · Esc Close"
+          : tab === 1 ? `${filters} · ↑↓ Select · → Details · Enter Open session · N New task · Tab Next · Esc Close`
           : "↑↓ Select · Enter Details · O Open related session · Tab Next · Esc Close";
-        const summary = wrapTextWithAnsi(fg("muted", `${tasks.length} tasks · ${["Working", "Ready", "Blocked", "Done"].map(state => `${tasks.filter(task => taskStatus(task) === state).length} ${state.toLowerCase()}`).join(" · ")}`), inner);
-        const receipts = wrapTextWithAnsi(fg("muted", receipt), inner);
+        const teammates = snapshot.members.filter(member => member.id !== "root");
+        const memberStates = teammates.map(member => member.needsInput || member.status === "interrupted" ? "needs input"
+          : ["starting", "busy", "stopping"].includes(member.status) ? "working"
+          : member.status === "stopped" ? "stopped" : "idle");
+        const summaryText = tab === 0
+          ? `${tasks.length} tasks · ${["Working", "Ready", "Blocked", "Done"].map(state => `${tasks.filter(task => taskStatus(task) === state).length} ${state.toLowerCase()}`).join(" · ")}`
+          : tab === 1 ? `${teammates.length} teammate${teammates.length === 1 ? "" : "s"} · ${["working", "idle", "stopped", "needs input"].map(state => `${memberStates.filter(value => value === state).length} ${state}`).join(" · ")}`
+          : `${events.length} message${events.length === 1 ? "" : "s"} · newest first`;
+        const summary = wrapTextWithAnsi(fg("muted", summaryText), inner);
+        const receipts = receipt ? wrapTextWithAnsi(fg("muted", receipt), inner) : [];
         const hints = wrapTextWithAnsi(fg("dim", help), inner);
         bodyHeight = Math.max(1, height - 6 - summary.length - receipts.length - hints.length);
         const content = body(inner);
@@ -281,6 +331,21 @@ export async function showTeamsPanel(ctx: ExtensionContext, host: PanelHost): Pr
           refresh(); return;
         }
         if (opening) return;
+        if (searching) {
+          if (matchesKey(data, "escape")) { memberQuery = ""; searching = false; }
+          else if (matchesKey(data, "enter")) searching = false;
+          else if (matchesKey(data, "backspace")) memberQuery = Array.from(memberQuery).slice(0, -1).join("");
+          else {
+            const text = data.replace(/^\x1b\[200~|\x1b\[201~$/g, "");
+            if (!/[\x00-\x1f\x7f-\x9f]/.test(text)) memberQuery += clean(text);
+          }
+          memberIndex = 0; scroll = 0; refresh(); return;
+        }
+        if (tab === 1 && !detail && (data === "/" || data.toLowerCase() === "h")) {
+          if (data === "/") searching = true;
+          else hideStopped = !hideStopped;
+          memberIndex = 0; scroll = 0; refresh(); return;
+        }
         const direction = (["up", "down", "left", "right"] as const).find(key => matchesKey(data, key));
         if (matchesKey(data, "escape")) { if (detail) { detail = false; detailScroll = 0; } else done(undefined); }
         else if (matchesKey(data, "tab") || matchesKey(data, "shift+tab")) { tab = (tab + (matchesKey(data, "shift+tab") ? 2 : 1)) % 3; detail = false; scroll = 0; detailScroll = 0; }

package/src/render.ts

@@ -46,26 +46,30 @@ 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);
+type MemberLabels = () => Readonly<Record<string, string>>;
+const defaultLabels: MemberLabels = () => ({ root: "Main" });
+const memberLabel = (id: unknown, labels: Readonly<Record<string, string>>) => inline(typeof id === "string" && Object.hasOwn(labels, id) ? labels[id] : id);
+
+function preview(items: unknown[], count: string, theme: Theme, labels: Readonly<Record<string, string>>): string {
+  const entries = items.slice(0, 3).map(item => toolSummary(item, theme, labels)).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);
+function toolSummary(data: unknown, theme: Theme, labels: Readonly<Record<string, string>>): string {
+  if (Array.isArray(data)) return preview(data, `${data.length} messages`, theme, labels);
   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.total === undefined ? `${value.tasks.length} tasks` : `${value.tasks.length} of ${value.total} tasks`, theme);
-    const label = value.title ?? value.name ?? value.brief ?? value.text ?? value.query ?? value.id;
+    if (Array.isArray(value.members)) return preview(value.members, `${value.members.length} members`, theme, labels);
+    if (Array.isArray(value.tasks)) return preview(value.tasks, value.total === undefined ? `${value.tasks.length} tasks` : `${value.tasks.length} of ${value.total} tasks`, theme, labels);
+    const label = value.title ?? value.name ?? value.brief ?? value.text ?? value.query ?? (Array.isArray(value.recipients) ? undefined : value.id === undefined ? undefined : memberLabel(value.id, labels));
     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(", ")}`);
+    if (Array.isArray(value.recipients)) parts.push(`${value.from === undefined ? "to" : `${memberLabel(value.from, labels)} →`} ${value.recipients.map(id => memberLabel(id, labels)).join(", ")}`);
     for (const key of ["seq", "limit", "depth"]) {
       if (value[key] !== undefined) parts.push(`${key}: ${inline(value[key])}`);
     }
@@ -74,13 +78,13 @@ function toolSummary(data: unknown, theme: Theme): string {
   return data === undefined || data === null ? "" : inline(data);
 }
 
-export function teamToolRenderers(name: string): ToolRenderers {
+export function teamToolRenderers(name: string, getLabels: MemberLabels = defaultLabels): ToolRenderers {
   return {
     renderShell: "self",
     renderCall(args, theme, context) {
       if (!context.isPartial) return new Container();
       const { action, ...fields } = (args ?? {}) as Record<string, unknown>;
-      const request = toolSummary(fields, theme);
+      const request = toolSummary(fields, theme, getLabels());
       const text = `${theme.fg("warning", "●")} ${theme.fg("toolTitle", name)} · ${inline(action ?? "...")} → running${request ? ` · ${request}` : ""}`;
       return new TruncatedText(text, context.outputPad, 0);
     },
@@ -92,8 +96,9 @@ export function teamToolRenderers(name: string): ToolRenderers {
       if (data === undefined) {
         try { data = JSON.parse(text); } catch { data = text; }
       }
-      const outcome = context.isError ? `error · ${inline(text)}` : toolSummary(data, theme) || "done";
-      const request = toolSummary(fields, theme);
+      const labels = getLabels();
+      const outcome = context.isError ? `error · ${inline(text)}` : toolSummary(data, theme, labels) || "done";
+      const request = toolSummary(fields, theme, labels);
       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));
@@ -122,10 +127,15 @@ export function teamToolRenderers(name: string): ToolRenderers {
   };
 }
 
-export const renderTeamMessage: MessageRenderer = (message, { expanded }, theme) => {
-  const details = message.details as { through?: number; messages?: { from: string; text: string; recipients: string[] }[] } | undefined;
-  const recent = details?.messages?.at(-1);
-  const name = (id: string) => id === "root" ? "Main" : id;
-  const preview = recent ? `${name(recent.from)} → ${recent.recipients.map(name).join(", ")} · ${recent.text.split("\n")[0]}` : `Updates through ${details?.through ?? "unknown"}`;
-  return entry("Team message", details ?? { content: message.content }, expanded, theme, false, preview);
-};
+export function teamMessageRenderer(getLabels: MemberLabels = defaultLabels): MessageRenderer {
+  return (message, { expanded }, theme) => {
+    const details = message.details as { through?: number; messages?: { from: string; text: string; recipients: string[] }[] } | undefined;
+    const recent = details?.messages?.at(-1);
+    const labels = getLabels();
+    const name = (id: string) => memberLabel(id, labels);
+    const preview = recent ? `${name(recent.from)} → ${recent.recipients.map(name).join(", ")} · ${recent.text.split("\n")[0]}` : `Updates through ${details?.through ?? "unknown"}`;
+    return entry("Team message", details ?? { content: message.content }, expanded, theme, false, preview);
+  };
+}
+
+export const renderTeamMessage = teamMessageRenderer();

package/src/schemas.ts

@@ -36,7 +36,7 @@ export const TaskSchema = Type.Object({
 }, { additionalProperties: false });
 export const MessageSchema = Type.Object({
   action: Type.Union(["send", "history", "search"].map(v => Type.Literal(v))),
-  recipients: Type.Optional(Type.Array(id, { minItems: 1, maxItems: 100, uniqueItems: true })),
+  recipients: Type.Optional(Type.Array(id, { minItems: 1, maxItems: 100, uniqueItems: true, description: "Exact teammate names or member IDs. Each must resolve to a different live member. Omit to notify all other live members." })),
   text: Type.Optional(text), query: Type.Optional(Type.String({ minLength: 1, maxLength: 500 })),
   after: Type.Optional(Type.Integer({ minimum: 0 })), limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 100 })),
 }, { additionalProperties: false });

package/src/store.ts

@@ -360,8 +360,11 @@ export class Store {
     if (args.action === "send") return this.update(state => {
       const limit = enveloped ? maxMessageText : 16000;
       requireValue(text(args.text, limit), `Message text must be nonempty and at most ${limit} characters`);
-      const recipients = args.recipients === undefined ? Object.values(state.members).filter(member => member.id !== actor && isLive(member)).map(member => member.id) : args.recipients;
-      requireValue(Array.isArray(recipients) && (args.recipients === undefined || recipients.length > 0) && new Set(recipients).size === recipients.length && recipients.every(recipient => typeof recipient === "string" && Object.hasOwn(state.members, recipient) && isLive(state.members[recipient])), "Recipients must be unique live member IDs");
+      const members = Object.values(state.members);
+      requireValue(args.recipients === undefined || Array.isArray(args.recipients), "Recipients must be unique live member names or IDs");
+      const recipients = args.recipients === undefined ? members.filter(member => member.id !== actor && isLive(member)).map(member => member.id)
+        : args.recipients.map(recipient => typeof recipient === "string" ? members.find(member => member.id === recipient || member.name === recipient)?.id : undefined);
+      requireValue((args.recipients === undefined || recipients.length > 0) && new Set(recipients).size === recipients.length && recipients.every((recipient): recipient is string => recipient !== undefined && isLive(state.members[recipient])), "Recipients must be unique live member names or IDs");
       const message = { seq: (state.messages.at(-1)?.seq ?? 0) + 1, id: randomUUID(), from: actor, recipients: [...recipients], text: args.text, time: new Date().toISOString() };
       state.messages.push(message);
       return structuredClone(message);

package/src/telemetry.ts

@@ -10,10 +10,13 @@ export function readTelemetry(ctx: ExtensionContext): Telemetry {
 
 export function modelContext(member: Pick<Member, "model" | "modelName" | "contextUsage">): string {
   const model = member.modelName || member.model?.slice(member.model.indexOf("/") + 1) || "Model unknown";
-  const usage = member.contextUsage;
+  return `${model} · ${contextSummary(member.contextUsage)}`;
+}
+
+export function contextSummary(usage: Member["contextUsage"]): string {
   const count = (value: number) => value >= 1000 ? `${(value / 1000).toFixed(1).replace(/\.0$/, "")}k` : String(value);
   const context = !usage ? "context unknown" : usage.tokens === null || usage.percent === null
     ? `context unknown / ${count(usage.contextWindow)}`
     : `${count(usage.tokens)} / ${count(usage.contextWindow)} (${usage.percent.toFixed(1).replace(/\.0$/, "")}%)`;
-  return `${model} · ${context}`;
+  return context;
 }