From fa2b2fdce22aef913e214efe99e4cf645878044f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Arnaud=20H=C3=A9ritier?= Date: Sun, 12 Jul 2026 04:02:57 +0000 Subject: [PATCH 1/3] docs: update docs for PR #3582 - improve agent transfer feedback --- docs/features/tui/index.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/docs/features/tui/index.md b/docs/features/tui/index.md index 4184bee25..376557197 100644 --- a/docs/features/tui/index.md +++ b/docs/features/tui/index.md @@ -143,6 +143,36 @@ The **effort gauge** is a fixed-width six-cell indicator (`▰` filled, `▱` em Harness-backed agents (e.g. `claude-code`) show the harness type as their model and no thinking gauge. Press **Shift+Tab** to cycle the current model's thinking-effort level; a `✻ Thinking: ` toast confirms the change (useful when the sidebar is hidden). +### Agent Delegation Feedback + +When a parent agent calls `transfer_task` to delegate work to a sub-agent, the TUI provides live visual feedback in both the sidebar and the chat. + +**Sidebar — Transfer box:** As soon as the delegation starts, an animated **Transfer** box appears below the agent roster, showing the direction of the handoff with a traveling dot: + +``` +┌ Transfer ─────────────────┐ +│ parent ●──────► child │ +└───────────────────────────┘ +``` + +The box stays visible for at least 1.5 seconds. Once the sub-agent produces its first message or tool output, the box hides (still honoring the minimum window) to keep the sidebar focused on the active agent. If the sub-agent is slow or silent, the box hides after a 3-second maximum cutoff. The header shows a `↔` marker while any delegation is still in flight, even after the box hides. + +**Sidebar — Return box:** When the sub-agent finishes and control returns to the parent, a brief **Return** box animates the reverse direction for up to 1.5 seconds, then disappears: + +``` +┌ Return ───────────────────┐ +│ child ●──────► parent │ +└───────────────────────────┘ +``` + +**Chat — return transition:** Alongside the sidebar Return animation, the chat shows a one-line static transition between the two agent badges: + +``` +[child] returned control to [parent] +``` + +This transition is not persisted — it does not reappear when you reload the session. + ### Context-Usage Gauge The context percentage shown in the sidebar token-usage section, and the fill bar in the lean TUI status line, both color-escalate as the active session approaches the auto-compaction threshold: From 3d39ce2c7184086d02722cd0dbe5195c3ddf8e85 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Arnaud=20H=C3=A9ritier?= Date: Sun, 12 Jul 2026 04:06:45 +0000 Subject: [PATCH 2/3] docs: fix box corners and activity trigger description in delegation feedback section --- docs/features/tui/index.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/features/tui/index.md b/docs/features/tui/index.md index 376557197..dcca94af1 100644 --- a/docs/features/tui/index.md +++ b/docs/features/tui/index.md @@ -150,19 +150,19 @@ When a parent agent calls `transfer_task` to delegate work to a sub-agent, the T **Sidebar — Transfer box:** As soon as the delegation starts, an animated **Transfer** box appears below the agent roster, showing the direction of the handoff with a traveling dot: ``` -┌ Transfer ─────────────────┐ -│ parent ●──────► child │ -└───────────────────────────┘ +╭─ Transfer ─────────────────╮ +│ parent ●──────► child │ +╰────────────────────────────╯ ``` -The box stays visible for at least 1.5 seconds. Once the sub-agent produces its first message or tool output, the box hides (still honoring the minimum window) to keep the sidebar focused on the active agent. If the sub-agent is slow or silent, the box hides after a 3-second maximum cutoff. The header shows a `↔` marker while any delegation is still in flight, even after the box hides. +The box stays visible for at least 1.5 seconds. Once the sub-agent produces its first message, reasoning, or tool output, the box hides (still honoring the minimum window) to keep the sidebar focused on the active agent. If the sub-agent is slow or silent, the box hides after a 3-second maximum cutoff. The header shows a `↔` marker while any delegation is still in flight, even after the box hides. **Sidebar — Return box:** When the sub-agent finishes and control returns to the parent, a brief **Return** box animates the reverse direction for up to 1.5 seconds, then disappears: ``` -┌ Return ───────────────────┐ -│ child ●──────► parent │ -└───────────────────────────┘ +╭─ Return ───────────────────╮ +│ child ●──────► parent │ +╰────────────────────────────╯ ``` **Chat — return transition:** Alongside the sidebar Return animation, the chat shows a one-line static transition between the two agent badges: From a2723785a639248d774b0cc87c9e937af9c7941f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Arnaud=20H=C3=A9ritier?= Date: Sun, 12 Jul 2026 04:09:14 +0000 Subject: [PATCH 3/3] docs: fix markdownlint issues in tui docs --- docs/features/tui/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/features/tui/index.md b/docs/features/tui/index.md index dcca94af1..55c2e71e9 100644 --- a/docs/features/tui/index.md +++ b/docs/features/tui/index.md @@ -149,7 +149,7 @@ When a parent agent calls `transfer_task` to delegate work to a sub-agent, the T **Sidebar — Transfer box:** As soon as the delegation starts, an animated **Transfer** box appears below the agent roster, showing the direction of the handoff with a traveling dot: -``` +```text ╭─ Transfer ─────────────────╮ │ parent ●──────► child │ ╰────────────────────────────╯ @@ -159,7 +159,7 @@ The box stays visible for at least 1.5 seconds. Once the sub-agent produces its **Sidebar — Return box:** When the sub-agent finishes and control returns to the parent, a brief **Return** box animates the reverse direction for up to 1.5 seconds, then disappears: -``` +```text ╭─ Return ───────────────────╮ │ child ●──────► parent │ ╰────────────────────────────╯ @@ -167,7 +167,7 @@ The box stays visible for at least 1.5 seconds. Once the sub-agent produces its **Chat — return transition:** Alongside the sidebar Return animation, the chat shows a one-line static transition between the two agent badges: -``` +```text [child] returned control to [parent] ```