rpi_cli/

transcript_view.rs

//! Transport-agnostic transcript rendering.
//!
//! This is the shared render layer behind unification ("only the transport
//! differs"): both the local interactive TUI (driven by in-process
//! `AgentEvent`s) and the remote client (driven by wire `RemoteEvent`s) build
//! their transcript from the **same** `pi-tui` components — an
//! [`AssistantMessageComponent`] per assistant message, a
//! [`ToolExecutionComponent`] per tool call, a [`BashExecutionComponent`] per
//! bash run, and user bubbles. Each side maps its native event stream into the
//! provider-free [`UiEvent`] enum and feeds it to [`TranscriptView`]; the view
//! holds the live component maps and updates them in place.
//!
//! Keeping this provider-free (only `pi-tui` + `serde_json::Value`) is what lets
//! the local host and the remote client share it without dragging `rpi_agent`
//! types into the client.

use std::collections::HashMap;
use std::sync::{Arc, Mutex};

use base64::Engine;
use rpi_tui::{
    render_diff, AssistantBlock, AssistantMessageComponent, AssistantMessageOptions,
    BashExecutionComponent, BashTruncation, Container, Spacer, ToolExecutionComponent, ToolStatus,
    UserMessageComponent,
};
use serde_json::Value;

/// A tool call visible in an assistant message snapshot, normalized to plain
/// data so both the local (`rpi_ai::Content::ToolCall`) and the wire
/// (`{"type":"toolCall",…}`) shapes map onto it.
#[derive(Debug, Clone, PartialEq)]
pub struct UiToolCall {
    pub id: String,
    pub name: String,
    pub args: Value,
}

/// A normalized transcript event. Both the local `AgentEvent` stream and the
/// remote `RemoteEvent` stream are projected into this enum before rendering.
#[derive(Debug, Clone)]
pub enum UiEvent {
    /// A run started (no transcript effect; kept for symmetry).
    AgentStart,
    /// A run ended: finalize any still-streaming assistant panel.
    AgentEnd,
    /// A retry was scheduled — renders as a dim notice line.
    Retry {
        attempt: u32,
        max_retries: u32,
        delay_ms: u64,
        error: String,
    },
    /// An assistant message began (carries any blocks already present).
    AssistantStart { blocks: Vec<AssistantBlock> },
    /// A streaming assistant snapshot: content blocks plus the finalized tool
    /// calls visible in the snapshot.
    AssistantUpdate {
        blocks: Vec<AssistantBlock>,
        tool_calls: Vec<UiToolCall>,
    },
    /// The assistant message finished.
    AssistantEnd { blocks: Vec<AssistantBlock> },
    /// Tool lifecycle (args/result carry the stable wire `Value` shape).
    ToolStart {
        id: String,
        name: String,
        args: Value,
    },
    ToolUpdate {
        id: String,
        name: String,
        args: Value,
        result: Value,
    },
    ToolEnd {
        id: String,
        name: String,
        result: Value,
        is_error: bool,
    },
}

/// The retained transcript: the same component maps the local `TuiState` holds,
/// so a streaming assistant message and each tool/bash panel are updated in
/// place rather than rebuilt per event.
pub struct TranscriptView {
    chat: Arc<Container>,
    current_assistant: Arc<Mutex<Option<Arc<AssistantMessageComponent>>>>,
    tool_components: Arc<Mutex<HashMap<String, Arc<ToolExecutionComponent>>>>,
    /// Bash executions keyed by `tool_call_id` — kept separate from the generic
    /// tool map so bash output streams into a [`BashExecutionComponent`] (command
    /// header + live preview + exit/truncation status).
    bash_components: Arc<Mutex<HashMap<String, Arc<BashExecutionComponent>>>>,
    /// When true, thinking blocks collapse to a label (toggled by the host).
    hide_thinking: Arc<Mutex<bool>>,
    /// Global tool-output expansion preference (toggled by the host).
    expanded: Arc<Mutex<bool>>,
    /// Optional transformer applied to raw assistant markdown before rendering
    /// (installed by the local host from plugin `register_markdown_transformer`
    /// handlers; always `None` on the remote client).
    markdown_transformer: Arc<Mutex<Option<MarkdownTransformer>>>,
}

/// A sync `Fn(&str) -> String` applied to raw assistant markdown. Kept as a
/// trait object so this crate stays free of any plugin types.
pub type MarkdownTransformer = Arc<dyn Fn(&str) -> String + Send + Sync>;

impl TranscriptView {
    /// Self-contained view owning fresh maps (the remote client).
    pub fn new(chat: Arc<Container>) -> Self {
        Self::with_maps(
            chat,
            Arc::new(Mutex::new(None)),
            Arc::new(Mutex::new(HashMap::new())),
            Arc::new(Mutex::new(HashMap::new())),
            Arc::new(Mutex::new(false)),
            Arc::new(Mutex::new(false)),
            Arc::new(Mutex::new(None)),
        )
    }

    /// Wrap **shared** component maps. The local host keeps direct `Arc` handles
    /// to these maps for its render-tick, reload and toggle logic, so it hands
    /// the same handles to the view instead of duplicating them.
    #[allow(clippy::too_many_arguments)]
    pub fn with_maps(
        chat: Arc<Container>,
        current_assistant: Arc<Mutex<Option<Arc<AssistantMessageComponent>>>>,
        tool_components: Arc<Mutex<HashMap<String, Arc<ToolExecutionComponent>>>>,
        bash_components: Arc<Mutex<HashMap<String, Arc<BashExecutionComponent>>>>,
        hide_thinking: Arc<Mutex<bool>>,
        expanded: Arc<Mutex<bool>>,
        markdown_transformer: Arc<Mutex<Option<MarkdownTransformer>>>,
    ) -> Self {
        Self {
            chat,
            current_assistant,
            tool_components,
            bash_components,
            hide_thinking,
            expanded,
            markdown_transformer,
        }
    }

    /// Append a user prompt bubble.
    pub fn add_user(&self, text: &str) {
        self.chat
            .add_child(Arc::new(UserMessageComponent::new(text.to_string())));
        self.chat.add_child(Arc::new(Spacer::new(1)));
    }

    /// Append a dim one-line notice (retry / error / command feedback).
    pub fn add_notice(&self, text: &str) {
        self.chat
            .add_child(Arc::new(rpi_tui::Text::new(format!("· {text}"), 1, 0)));
    }

    /// Fold one normalized event into the retained components. `width` is the
    /// current terminal width, used to render `edit` diffs.
    pub fn apply(&self, event: &UiEvent, width: usize) {
        match event {
            UiEvent::AgentStart => {}
            UiEvent::AgentEnd => {
                if let Some(comp) = self.current_assistant.lock().unwrap().take() {
                    comp.set_streaming(false);
                }
            }
            UiEvent::Retry {
                attempt,
                max_retries,
                delay_ms,
                error,
            } => {
                self.add_notice(&format!(
                    "retry {attempt}/{max_retries} in {delay_ms}ms: {error}"
                ));
            }
            UiEvent::AssistantStart { blocks } => {
                self.start_assistant(blocks);
            }
            UiEvent::AssistantUpdate { blocks, tool_calls } => {
                self.ensure_assistant();
                self.sync_tool_calls(tool_calls);
                if let Some(comp) = self.current_assistant.lock().unwrap().as_ref() {
                    comp.update_blocks(blocks);
                }
            }
            UiEvent::AssistantEnd { blocks } => {
                if let Some(comp) = self.current_assistant.lock().unwrap().take() {
                    comp.update_blocks(blocks);
                    comp.set_streaming(false);
                }
            }
            UiEvent::ToolStart { id, name, args } => self.tool_start(id, name, args, width),
            UiEvent::ToolUpdate {
                id,
                name,
                args,
                result,
            } => self.tool_update(id, name, args, result, width),
            UiEvent::ToolEnd {
                id,
                name,
                result,
                is_error,
            } => self.tool_end(id, name, result, *is_error, width),
        }
    }

    /// Set the global tool-output expansion preference and re-apply it to every
    /// live panel.
    pub fn set_expanded(&self, expanded: bool) {
        *self.expanded.lock().unwrap() = expanded;
        for comp in self.tool_components.lock().unwrap().values() {
            comp.set_expanded(expanded);
        }
        for comp in self.bash_components.lock().unwrap().values() {
            comp.set_expanded(expanded);
        }
    }

    /// Flip the expansion preference; returns the new value.
    pub fn toggle_expanded(&self) -> bool {
        let next = !*self.expanded.lock().unwrap();
        self.set_expanded(next);
        next
    }

    /// Whether tool outputs are currently expanded.
    pub fn expanded(&self) -> bool {
        *self.expanded.lock().unwrap()
    }

    /// Hide/show thinking blocks on the in-flight assistant message.
    pub fn set_hide_thinking(&self, hide: bool) {
        *self.hide_thinking.lock().unwrap() = hide;
        if let Some(comp) = self.current_assistant.lock().unwrap().as_ref() {
            comp.set_hide_thinking(hide);
        }
    }

    /// Flip the thinking-visibility preference; returns the new value.
    pub fn toggle_hide_thinking(&self) -> bool {
        let next = !*self.hide_thinking.lock().unwrap();
        self.set_hide_thinking(next);
        next
    }

    /// Whether thinking blocks are currently hidden.
    pub fn hide_thinking(&self) -> bool {
        *self.hide_thinking.lock().unwrap()
    }

    /// Install (or clear) the assistant-markdown transformer, re-applying it to
    /// the in-flight assistant message immediately (mirrors the local reload).
    pub fn set_markdown_transformer(&self, transformer: Option<MarkdownTransformer>) {
        *self.markdown_transformer.lock().unwrap() = transformer.clone();
        if let Some(comp) = self.current_assistant.lock().unwrap().as_ref() {
            comp.set_markdown_transformer(transformer);
        }
    }

    /// Finalize any still-streaming assistant panel (used at turn/run end).
    pub fn finalize_assistant(&self) {
        if let Some(comp) = self.current_assistant.lock().unwrap().take() {
            comp.set_streaming(false);
        }
    }

    /// Finalize the assistant panel with an authoritative final block list.
    pub fn finalize_assistant_blocks(&self, blocks: &[AssistantBlock]) {
        if let Some(comp) = self.current_assistant.lock().unwrap().take() {
            comp.update_blocks(blocks);
            comp.set_streaming(false);
        }
    }

    /// Whether any tool panel is still running (drives the local render tick).
    pub fn has_running_tool(&self) -> bool {
        self.tool_components
            .lock()
            .unwrap()
            .values()
            .any(|component| component.status() == ToolStatus::Running)
    }

    /// Whether a bash panel is currently on screen.
    pub fn has_active_bash(&self) -> bool {
        !self.bash_components.lock().unwrap().is_empty()
    }

    fn start_assistant(&self, blocks: &[AssistantBlock]) {
        let comp = Arc::new(AssistantMessageComponent::new(
            AssistantMessageOptions::default(),
        ));
        comp.set_hide_thinking(*self.hide_thinking.lock().unwrap());
        if let Some(transformer) = self.markdown_transformer.lock().unwrap().clone() {
            comp.set_markdown_transformer(Some(transformer));
        }
        comp.set_streaming(true);
        comp.update_blocks(blocks);
        self.chat.add_child(comp.clone());
        self.chat.add_child(Arc::new(Spacer::new(1)));
        *self.current_assistant.lock().unwrap() = Some(comp);
    }

    /// Create the streaming assistant component if a delta arrives before
    /// `assistant_start` (the wire does not strictly guarantee ordering).
    fn ensure_assistant(&self) {
        let mut current = self.current_assistant.lock().unwrap();
        if current.is_none() {
            let comp = Arc::new(AssistantMessageComponent::new(
                AssistantMessageOptions::default(),
            ));
            comp.set_hide_thinking(*self.hide_thinking.lock().unwrap());
            if let Some(transformer) = self.markdown_transformer.lock().unwrap().clone() {
                comp.set_markdown_transformer(Some(transformer));
            }
            comp.set_streaming(true);
            self.chat.add_child(comp.clone());
            self.chat.add_child(Arc::new(Spacer::new(1)));
            *current = Some(comp);
        }
    }

    /// Pre-create panels for the tool calls visible in an assistant snapshot. A
    /// later `tool_start` coalesces onto the same entry.
    fn sync_tool_calls(&self, calls: &[UiToolCall]) {
        for call in calls {
            if call.name == "bash" {
                let command = call
                    .args
                    .get("command")
                    .and_then(Value::as_str)
                    .unwrap_or("");
                if command.trim().is_empty() {
                    continue;
                }
                let mut bash = self.bash_components.lock().unwrap();
                if let Some(existing) = bash.get(&call.id) {
                    existing.set_command(command);
                } else {
                    let comp = Arc::new(BashExecutionComponent::new(command));
                    comp.set_expanded(self.expanded());
                    self.chat.add_child(comp.clone());
                    bash.insert(call.id.clone(), comp);
                }
                continue;
            }
            let ask_user = is_ask_user_tool(&call.name);
            let display = if ask_user {
                ask_user_args_display(&call.args)
            } else {
                call.args.to_string()
            };
            let mut tools = self.tool_components.lock().unwrap();
            if let Some(existing) = tools.get(&call.id) {
                if !display.trim().is_empty() && display.trim() != "{}" {
                    existing.set_args(&display);
                }
            } else {
                let comp = Arc::new(ToolExecutionComponent::new(&call.name, &display));
                if ask_user {
                    comp.set_display_title("ASK USER");
                }
                if let Some(skill) = skill_tool_name(&call.name, &call.args) {
                    comp.set_skill_name(skill);
                }
                comp.set_expanded(self.expanded());
                comp.set_running();
                self.chat.add_child(comp.clone());
                tools.insert(call.id.clone(), comp);
            }
        }
    }

    fn tool_start(&self, id: &str, name: &str, args: &Value, _width: usize) {
        if name.trim().is_empty() {
            return;
        }
        if name == "bash" {
            let command = args.get("command").and_then(Value::as_str).unwrap_or("");
            // Arguments can still be `{}` when the lifecycle event races streamed
            // arg finalization — defer until the command lands.
            if command.trim().is_empty() {
                return;
            }
            let mut bash = self.bash_components.lock().unwrap();
            if let Some(existing) = bash.get(id) {
                existing.set_command(command);
            } else {
                let comp = Arc::new(BashExecutionComponent::new(command));
                comp.set_expanded(self.expanded());
                self.chat.add_child(comp.clone());
                bash.insert(id.to_string(), comp);
            }
            return;
        }
        let ask_user = is_ask_user_tool(name);
        let display = if ask_user {
            ask_user_args_display(args)
        } else {
            args.to_string()
        };
        let mut tools = self.tool_components.lock().unwrap();
        if let Some(existing) = tools.get(id) {
            if ask_user {
                existing.set_display_title("ASK USER");
            }
            existing.set_args(&display);
        } else {
            let comp = Arc::new(ToolExecutionComponent::new(name, &display));
            if ask_user {
                comp.set_display_title("ASK USER");
            }
            if let Some(skill) = skill_tool_name(name, args) {
                comp.set_skill_name(skill);
            }
            comp.set_expanded(self.expanded());
            comp.set_running();
            self.chat.add_child(comp.clone());
            tools.insert(id.to_string(), comp);
        }
    }

    fn tool_update(&self, id: &str, name: &str, args: &Value, result: &Value, width: usize) {
        if name.trim().is_empty() {
            return;
        }
        let ask_user = is_ask_user_tool(name);
        let text = if ask_user {
            ask_user_progress_text(args, result)
        } else {
            tool_result_text(result)
        };
        if name == "bash" {
            if let Some(bash) = self.bash_components.lock().unwrap().get(id) {
                if let Some(command) = args.get("command").and_then(Value::as_str) {
                    bash.set_command(command);
                }
                if !text.is_empty() {
                    bash.append_output(&text);
                }
            }
            return;
        }
        let existing = self.tool_components.lock().unwrap().get(id).cloned();
        match existing {
            Some(comp) => {
                if ask_user {
                    comp.set_display_title("ASK USER");
                    comp.set_args(&ask_user_args_display(args));
                } else if !args.is_null() && args != &serde_json::json!({}) {
                    comp.set_args(&args.to_string());
                }
                if tool_update_has_payload(&text, result) {
                    comp.set_result(&text, false);
                    if !ask_user {
                        apply_edit_diff(&comp, name, result.get("details"), width);
                    }
                }
            }
            None => {
                // Update before start (fast tool / out-of-order): create the
                // running panel now so the partial has somewhere to land.
                if tool_update_has_payload(&text, result) {
                    let display = if ask_user {
                        ask_user_args_display(args)
                    } else {
                        args.to_string()
                    };
                    let comp = Arc::new(ToolExecutionComponent::new(name, &display));
                    if ask_user {
                        comp.set_display_title("ASK USER");
                    }
                    if let Some(skill) = skill_tool_name(name, args) {
                        comp.set_skill_name(skill);
                    }
                    comp.set_expanded(self.expanded());
                    comp.set_running();
                    comp.set_result(&text, false);
                    if !ask_user {
                        apply_edit_diff(&comp, name, result.get("details"), width);
                    }
                    self.chat.add_child(comp.clone());
                    self.tool_components
                        .lock()
                        .unwrap()
                        .insert(id.to_string(), comp);
                }
            }
        }
    }

    fn tool_end(&self, id: &str, name: &str, result: &Value, is_error: bool, width: usize) {
        if name.trim().is_empty() {
            return;
        }
        if name == "bash" {
            let bash = self.bash_components.lock().unwrap().remove(id);
            match bash {
                Some(comp) => finalize_bash(&comp, result, is_error),
                None => {
                    let command = result
                        .get("details")
                        .and_then(|details| details.get("command"))
                        .and_then(Value::as_str)
                        .unwrap_or("");
                    let text = tool_result_text(result);
                    if command.trim().is_empty() && text.trim().is_empty() {
                        return;
                    }
                    let comp = Arc::new(BashExecutionComponent::new(command));
                    comp.set_expanded(self.expanded());
                    if !text.is_empty() {
                        comp.append_output(&text);
                    }
                    finalize_bash(&comp, result, is_error);
                    self.chat.add_child(comp);
                }
            }
            return;
        }
        let ask_user = is_ask_user_tool(name);
        let text = if ask_user {
            ask_user_result_text(result)
        } else {
            tool_result_text(result)
        };
        let details = result.get("details");
        let existing = self.tool_components.lock().unwrap().remove(id);
        let comp = match existing {
            Some(comp) => comp,
            None => {
                // Tool ended without a start/update — render a finalized panel.
                let comp = Arc::new(ToolExecutionComponent::new(name, ""));
                if ask_user {
                    comp.set_display_title("ASK USER");
                }
                comp.set_expanded(self.expanded());
                self.chat.add_child(comp.clone());
                comp
            }
        };
        comp.set_result(&text, is_error);
        if !ask_user {
            if tool_result_requests_markdown(details) {
                comp.set_result_markdown(true);
            }
            apply_edit_diff(&comp, name, details, width);
        }
    }
}

/// Map a wire/local assistant message's content blocks into the provider-free
/// [`AssistantBlock`] list the shared component renders (text + thinking +
/// decoded image blocks, in document order).
pub fn assistant_blocks_from_value(message: &Value) -> Vec<AssistantBlock> {
    let mut blocks = Vec::new();
    let Some(content) = message.get("content").and_then(Value::as_array) else {
        return blocks;
    };
    for block in content {
        match block.get("type").and_then(Value::as_str) {
            Some("text") => {
                if let Some(text) = block.get("text").and_then(Value::as_str) {
                    blocks.push(AssistantBlock::Text(text.to_string()));
                }
            }
            Some("thinking") => {
                if let Some(text) = block.get("thinking").and_then(Value::as_str) {
                    blocks.push(AssistantBlock::Thinking(text.to_string()));
                }
            }
            Some("image") => {
                if let Some(data) = block.get("data").and_then(Value::as_str) {
                    if let Ok(bytes) = base64::engine::general_purpose::STANDARD.decode(data) {
                        if !bytes.is_empty() {
                            blocks.push(AssistantBlock::Image(bytes));
                        }
                    }
                }
            }
            _ => {}
        }
    }
    blocks
}

/// Extract the finalized tool calls (`type: "toolCall"`) from an assistant
/// message value, in document order.
pub fn tool_calls_from_value(message: &Value) -> Vec<UiToolCall> {
    let mut calls = Vec::new();
    let Some(content) = message.get("content").and_then(Value::as_array) else {
        return calls;
    };
    for block in content {
        if block.get("type").and_then(Value::as_str) != Some("toolCall") {
            continue;
        }
        let id = block.get("id").and_then(Value::as_str).unwrap_or("");
        let name = block.get("name").and_then(Value::as_str).unwrap_or("");
        if id.is_empty() || name.trim().is_empty() {
            continue;
        }
        calls.push(UiToolCall {
            id: id.to_string(),
            name: name.to_string(),
            args: block.get("arguments").cloned().unwrap_or(Value::Null),
        });
    }
    calls
}

/// Text out of a wire tool-result payload (`{content:[{type:"text",text}]}`).
pub fn tool_result_text(result: &Value) -> String {
    let mut out = String::new();
    if let Some(blocks) = result.get("content").and_then(Value::as_array) {
        for block in blocks {
            if let Some(text) = block.get("text").and_then(Value::as_str) {
                if !out.is_empty() {
                    out.push('\n');
                }
                out.push_str(text);
            }
        }
    }
    out
}

/// Whether a tool result opts into markdown rendering of its body
/// (`details.markdown = true`).
pub fn tool_result_requests_markdown(details: Option<&Value>) -> bool {
    details
        .and_then(|details| details.get("markdown"))
        .and_then(Value::as_bool)
        .unwrap_or(false)
}

/// The skill name when `tool_name` is a `read` of a `SKILL.md` file (the
/// `SKILL.md` parent directory's basename), else `None`. A skill read renders
/// as upstream's `[skill] <name>` box.
pub fn skill_tool_name(tool_name: &str, args: &Value) -> Option<String> {
    if tool_name != "read" {
        return None;
    }
    let path = args.get("path").and_then(Value::as_str)?;
    let normalized = path.replace('\\', "/");
    let file_name = normalized.rsplit('/').next()?;
    if !file_name.eq_ignore_ascii_case("SKILL.md") {
        return None;
    }
    normalized
        .trim_end_matches('/')
        .rsplit('/')
        .nth(1)
        .filter(|name| !name.is_empty())
        .map(str::to_string)
}

/// Tool names rendered through the dedicated `ASK USER` panel instead of a
/// generic tool box. Native `ask_user` plus the JS `ask_user_question` alias.
fn is_ask_user_tool(tool_name: &str) -> bool {
    matches!(tool_name, "ask_user" | "ask_user_question")
}

/// Render ask_user tool-call ARGUMENTS as a readable question. The raw
/// transport JSON must never leak into the transcript.
fn ask_user_args_display(args: &Value) -> String {
    if args.is_null() {
        return String::new();
    }
    if let Some(summary) = args
        .get("summary")
        .and_then(Value::as_str)
        .map(str::trim)
        .filter(|text| !text.is_empty())
    {
        return format!("Confirmation requested: {summary}");
    }

    let mut lines: Vec<String> = Vec::new();
    let questions: Vec<&Value> = args
        .get("questions")
        .and_then(Value::as_array)
        .filter(|items| !items.is_empty())
        .map(|items| items.iter().collect())
        .unwrap_or_else(|| vec![args]);

    for question in questions {
        let prompt = question
            .get("question")
            .and_then(Value::as_str)
            .or_else(|| args.get("question").and_then(Value::as_str))
            .map(str::trim)
            .unwrap_or_default();
        if prompt.is_empty() {
            continue;
        }
        if let Some(header) = question
            .get("header")
            .and_then(Value::as_str)
            .map(str::trim)
            .filter(|text| !text.is_empty())
        {
            lines.push(format!("{header}: {prompt}"));
        } else {
            lines.push(prompt.to_string());
        }
        let context = question
            .get("context")
            .and_then(Value::as_str)
            .or_else(|| args.get("context").and_then(Value::as_str))
            .map(str::trim)
            .filter(|text| !text.is_empty());
        if let Some(context) = context {
            lines.push(format!("  {context}"));
        }
        let options = question
            .get("options")
            .and_then(Value::as_array)
            .or_else(|| args.get("options").and_then(Value::as_array));
        if let Some(options) = options {
            let labels: Vec<String> = options
                .iter()
                .filter_map(|option| {
                    option
                        .get("title")
                        .and_then(Value::as_str)
                        .or_else(|| option.as_str())
                        .map(str::trim)
                        .filter(|label| !label.is_empty())
                        .map(str::to_string)
                })
                .collect();
            if !labels.is_empty() {
                lines.push(format!("Choices: {}", labels.join(", ")));
            }
        }
        if let Some(suggest) = question
            .get("suggest")
            .and_then(Value::as_str)
            .or_else(|| args.get("suggest").and_then(Value::as_str))
            .map(str::trim)
            .filter(|text| !text.is_empty())
        {
            lines.push(format!("Suggestions: {suggest}"));
        }
    }

    lines.join("\n")
}

/// Progress text while an ask_user tool is pending. Prefer the tool's own
/// readable `content`, otherwise show the question so the panel is not blank.
fn ask_user_progress_text(args: &Value, result: &Value) -> String {
    let text = tool_result_text(result);
    if !text.trim().is_empty() {
        return text;
    }
    let args_text = ask_user_args_display(args);
    if args_text.trim().is_empty() {
        "Waiting for your answer…".to_string()
    } else {
        args_text
    }
}

/// Final text for a completed ask_user tool.
fn ask_user_result_text(result: &Value) -> String {
    let text = tool_result_text(result);
    if text.trim().is_empty() {
        "Answer recorded.".to_string()
    } else {
        text
    }
}

/// Whether a partial tool result carries anything worth rendering.
fn tool_update_has_payload(text: &str, result: &Value) -> bool {
    !text.trim().is_empty()
        || result
            .get("details")
            .map(|details| !details.is_null())
            .unwrap_or(false)
}

/// Attach a colored diff to an `edit` tool panel. `write` carries no diff and
/// stays a plain summary.
fn apply_edit_diff(
    comp: &Arc<ToolExecutionComponent>,
    tool_name: &str,
    details: Option<&Value>,
    width: usize,
) {
    if tool_name != "edit" {
        return;
    }
    let Some(diff_text) = details
        .and_then(|details| details.get("diff"))
        .and_then(Value::as_str)
    else {
        return;
    };
    if diff_text.is_empty() {
        return;
    }
    comp.set_diff(render_diff(diff_text, width));
}

/// Mark a bash panel complete from the wire result payload. The exit code is
/// derived from `is_error`; truncation info is read from `details`.
fn finalize_bash(comp: &Arc<BashExecutionComponent>, result: &Value, is_error: bool) {
    let details = result.get("details");
    let exit_code = Some(if is_error { 1 } else { 0 });
    let truncated = details
        .and_then(|details| details.get("truncation"))
        .and_then(|truncation| truncation.get("truncated"))
        .and_then(Value::as_bool)
        .unwrap_or(false);
    let full_output_path = details
        .and_then(|details| details.get("full_output_path"))
        .and_then(Value::as_str)
        .map(str::to_string);
    if let Some(command) = details
        .and_then(|details| details.get("command"))
        .and_then(Value::as_str)
    {
        comp.set_command(command);
    }
    comp.set_complete(
        exit_code,
        false,
        BashTruncation {
            truncated,
            full_output_path,
        },
    );
}

#[cfg(test)]
mod tests {
    use super::*;
    use serde_json::json;

    fn view() -> TranscriptView {
        TranscriptView::new(Arc::new(Container::new()))
    }

    #[test]
    fn assistant_blocks_follow_content_order() {
        let message = json!({
            "content": [
                {"type": "thinking", "thinking": "why"},
                {"type": "text", "text": "hello"},
                {"type": "toolCall", "id": "c1", "name": "read", "arguments": {}},
            ]
        });
        assert_eq!(
            assistant_blocks_from_value(&message),
            vec![
                AssistantBlock::Thinking("why".into()),
                AssistantBlock::Text("hello".into()),
            ]
        );
    }

    #[test]
    fn assistant_blocks_decode_images() {
        // "aGk=" is base64 for "hi".
        let message = json!({
            "content": [{"type": "image", "data": "aGk=", "mimeType": "image/png"}]
        });
        assert_eq!(
            assistant_blocks_from_value(&message),
            vec![AssistantBlock::Image(b"hi".to_vec())]
        );
    }

    #[test]
    fn tool_calls_extract_ids_names_and_args() {
        let message = json!({
            "content": [
                {"type": "text", "text": "x"},
                {"type": "toolCall", "id": "b1", "name": "bash", "arguments": {"command": "ls"}},
                {"type": "toolCall", "id": "", "name": "read", "arguments": {}},
            ]
        });
        assert_eq!(
            tool_calls_from_value(&message),
            vec![UiToolCall {
                id: "b1".into(),
                name: "bash".into(),
                args: json!({"command": "ls"}),
            }]
        );
    }

    #[test]
    fn markdown_flag_is_opt_in() {
        assert!(tool_result_requests_markdown(Some(
            &json!({"markdown": true})
        )));
        assert!(!tool_result_requests_markdown(Some(
            &json!({"markdown": false})
        )));
        assert!(!tool_result_requests_markdown(Some(&json!({}))));
        assert!(!tool_result_requests_markdown(None));
    }

    #[test]
    fn skill_tool_name_only_matches_skill_reads() {
        assert_eq!(
            skill_tool_name("read", &json!({"path": "skills/foo/SKILL.md"})),
            Some("foo".to_string())
        );
        assert_eq!(skill_tool_name("read", &json!({"path": "README.md"})), None);
        assert_eq!(
            skill_tool_name("write", &json!({"path": "skills/foo/SKILL.md"})),
            None
        );
    }

    #[test]
    fn ask_user_args_display_never_leaks_transport_json() {
        let text = ask_user_args_display(&json!({
            "question": "你的代理端口是多少？",
            "context": "本机",
            "options": ["7890", {"title": "7897", "description": "clash"}],
            "suggest": "1080"
        }));
        assert!(text.contains("你的代理端口是多少？"));
        assert!(text.contains("本机"));
        assert!(text.contains("Choices: 7890, 7897"));
        assert!(text.contains("Suggestions: 1080"));
        assert!(!text.trim_start().starts_with('{'));
        assert_eq!(
            ask_user_args_display(&json!({"type": "confirm", "summary": "Deploy?"})),
            "Confirmation requested: Deploy?"
        );
    }

    #[test]
    fn tool_start_routes_bash_to_its_own_map() {
        let view = view();
        view.apply(
            &UiEvent::ToolStart {
                id: "b1".into(),
                name: "bash".into(),
                args: json!({"command": "ls -la"}),
            },
            80,
        );
        view.apply(
            &UiEvent::ToolStart {
                id: "r1".into(),
                name: "read".into(),
                args: json!({"path": "a.txt"}),
            },
            80,
        );
        assert!(view.bash_components.lock().unwrap().contains_key("b1"));
        assert!(view.tool_components.lock().unwrap().contains_key("r1"));
        assert!(view.tool_components.lock().unwrap().get("b1").is_none());
    }

    #[test]
    fn bash_start_without_a_command_is_deferred() {
        let view = view();
        view.apply(
            &UiEvent::ToolStart {
                id: "b1".into(),
                name: "bash".into(),
                args: json!({}),
            },
            80,
        );
        assert!(view.bash_components.lock().unwrap().is_empty());
        assert!(view.tool_components.lock().unwrap().is_empty());
    }

    #[test]
    fn assistant_stream_reuses_one_component() {
        let view = view();
        view.apply(&UiEvent::AssistantStart { blocks: vec![] }, 80);
        view.apply(
            &UiEvent::AssistantUpdate {
                blocks: vec![AssistantBlock::Text("hi".into())],
                tool_calls: vec![],
            },
            80,
        );
        assert!(view.current_assistant.lock().unwrap().is_some());
    }

    #[test]
    fn toggle_expanded_round_trips() {
        let view = view();
        assert!(!view.expanded());
        assert!(view.toggle_expanded());
        assert!(view.expanded());
    }
}