thread.rs

   1use crate::{
   2    ContextServerRegistry, CopyPathTool, CreateDirectoryTool, DbLanguageModel, DbThread,
   3    DeletePathTool, DiagnosticsTool, EditFileTool, FetchTool, FindPathTool, GrepTool,
   4    ListDirectoryTool, MovePathTool, NowTool, OpenTool, ProjectSnapshot, ReadFileTool,
   5    RestoreFileFromDiskTool, SaveFileTool, SystemPromptTemplate, Template, Templates, TerminalTool,
   6    ThinkingTool, WebSearchTool,
   7};
   8use acp_thread::{MentionUri, UserMessageId};
   9use action_log::ActionLog;
  10
  11use agent_client_protocol as acp;
  12use agent_settings::{
  13    AgentProfileId, AgentProfileSettings, AgentSettings, CompletionMode,
  14    SUMMARIZE_THREAD_DETAILED_PROMPT, SUMMARIZE_THREAD_PROMPT,
  15};
  16use anyhow::{Context as _, Result, anyhow};
  17use chrono::{DateTime, Utc};
  18use client::{ModelRequestUsage, RequestUsage, UserStore};
  19use cloud_llm_client::{CompletionIntent, Plan, UsageLimit};
  20use collections::{HashMap, HashSet, IndexMap};
  21use fs::Fs;
  22use futures::stream;
  23use futures::{
  24    FutureExt,
  25    channel::{mpsc, oneshot},
  26    future::Shared,
  27    stream::FuturesUnordered,
  28};
  29use gpui::{
  30    App, AppContext, AsyncApp, Context, Entity, EventEmitter, SharedString, Task, WeakEntity,
  31};
  32use language_model::{
  33    LanguageModel, LanguageModelCompletionError, LanguageModelCompletionEvent, LanguageModelExt,
  34    LanguageModelId, LanguageModelImage, LanguageModelProviderId, LanguageModelRegistry,
  35    LanguageModelRequest, LanguageModelRequestMessage, LanguageModelRequestTool,
  36    LanguageModelToolResult, LanguageModelToolResultContent, LanguageModelToolSchemaFormat,
  37    LanguageModelToolUse, LanguageModelToolUseId, Role, SelectedModel, StopReason, TokenUsage,
  38    ZED_CLOUD_PROVIDER_ID,
  39};
  40use project::Project;
  41use prompt_store::ProjectContext;
  42use schemars::{JsonSchema, Schema};
  43use serde::{Deserialize, Serialize};
  44use settings::{LanguageModelSelection, Settings, update_settings_file};
  45use smol::stream::StreamExt;
  46use std::{
  47    collections::BTreeMap,
  48    ops::RangeInclusive,
  49    path::Path,
  50    rc::Rc,
  51    sync::Arc,
  52    time::{Duration, Instant},
  53};
  54use std::{fmt::Write, path::PathBuf};
  55use util::{ResultExt, debug_panic, markdown::MarkdownCodeBlock, paths::PathStyle};
  56use uuid::Uuid;
  57
  58const TOOL_CANCELED_MESSAGE: &str = "Tool canceled by user";
  59pub const MAX_TOOL_NAME_LENGTH: usize = 64;
  60
  61/// The ID of the user prompt that initiated a request.
  62///
  63/// This equates to the user physically submitting a message to the model (e.g., by pressing the Enter key).
  64#[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Clone, Serialize, Deserialize)]
  65pub struct PromptId(Arc<str>);
  66
  67impl PromptId {
  68    pub fn new() -> Self {
  69        Self(Uuid::new_v4().to_string().into())
  70    }
  71}
  72
  73impl std::fmt::Display for PromptId {
  74    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
  75        write!(f, "{}", self.0)
  76    }
  77}
  78
  79pub(crate) const MAX_RETRY_ATTEMPTS: u8 = 4;
  80pub(crate) const BASE_RETRY_DELAY: Duration = Duration::from_secs(5);
  81
  82#[derive(Debug, Clone)]
  83enum RetryStrategy {
  84    ExponentialBackoff {
  85        initial_delay: Duration,
  86        max_attempts: u8,
  87    },
  88    Fixed {
  89        delay: Duration,
  90        max_attempts: u8,
  91    },
  92}
  93
  94#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
  95pub enum Message {
  96    User(UserMessage),
  97    Agent(AgentMessage),
  98    Resume,
  99}
 100
 101impl Message {
 102    pub fn as_agent_message(&self) -> Option<&AgentMessage> {
 103        match self {
 104            Message::Agent(agent_message) => Some(agent_message),
 105            _ => None,
 106        }
 107    }
 108
 109    pub fn to_request(&self) -> Vec<LanguageModelRequestMessage> {
 110        match self {
 111            Message::User(message) => {
 112                if message.content.is_empty() {
 113                    vec![]
 114                } else {
 115                    vec![message.to_request()]
 116                }
 117            }
 118            Message::Agent(message) => message.to_request(),
 119            Message::Resume => vec![LanguageModelRequestMessage {
 120                role: Role::User,
 121                content: vec!["Continue where you left off".into()],
 122                cache: false,
 123                reasoning_details: None,
 124            }],
 125        }
 126    }
 127
 128    pub fn to_markdown(&self) -> String {
 129        match self {
 130            Message::User(message) => message.to_markdown(),
 131            Message::Agent(message) => message.to_markdown(),
 132            Message::Resume => "[resume]\n".into(),
 133        }
 134    }
 135
 136    pub fn role(&self) -> Role {
 137        match self {
 138            Message::User(_) | Message::Resume => Role::User,
 139            Message::Agent(_) => Role::Assistant,
 140        }
 141    }
 142}
 143
 144#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 145pub struct UserMessage {
 146    pub id: UserMessageId,
 147    pub content: Vec<UserMessageContent>,
 148}
 149
 150#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 151pub enum UserMessageContent {
 152    Text(String),
 153    Mention { uri: MentionUri, content: String },
 154    Image(LanguageModelImage),
 155}
 156
 157impl UserMessage {
 158    pub fn to_markdown(&self) -> String {
 159        let mut markdown = String::from("## User\n\n");
 160
 161        for content in &self.content {
 162            match content {
 163                UserMessageContent::Text(text) => {
 164                    markdown.push_str(text);
 165                    markdown.push('\n');
 166                }
 167                UserMessageContent::Image(_) => {
 168                    markdown.push_str("<image />\n");
 169                }
 170                UserMessageContent::Mention { uri, content } => {
 171                    if !content.is_empty() {
 172                        let _ = writeln!(&mut markdown, "{}\n\n{}", uri.as_link(), content);
 173                    } else {
 174                        let _ = writeln!(&mut markdown, "{}", uri.as_link());
 175                    }
 176                }
 177            }
 178        }
 179
 180        markdown
 181    }
 182
 183    fn to_request(&self) -> LanguageModelRequestMessage {
 184        let mut message = LanguageModelRequestMessage {
 185            role: Role::User,
 186            content: Vec::with_capacity(self.content.len()),
 187            cache: false,
 188            reasoning_details: None,
 189        };
 190
 191        const OPEN_CONTEXT: &str = "<context>\n\
 192            The following items were attached by the user. \
 193            They are up-to-date and don't need to be re-read.\n\n";
 194
 195        const OPEN_FILES_TAG: &str = "<files>";
 196        const OPEN_DIRECTORIES_TAG: &str = "<directories>";
 197        const OPEN_SYMBOLS_TAG: &str = "<symbols>";
 198        const OPEN_SELECTIONS_TAG: &str = "<selections>";
 199        const OPEN_THREADS_TAG: &str = "<threads>";
 200        const OPEN_FETCH_TAG: &str = "<fetched_urls>";
 201        const OPEN_RULES_TAG: &str =
 202            "<rules>\nThe user has specified the following rules that should be applied:\n";
 203
 204        let mut file_context = OPEN_FILES_TAG.to_string();
 205        let mut directory_context = OPEN_DIRECTORIES_TAG.to_string();
 206        let mut symbol_context = OPEN_SYMBOLS_TAG.to_string();
 207        let mut selection_context = OPEN_SELECTIONS_TAG.to_string();
 208        let mut thread_context = OPEN_THREADS_TAG.to_string();
 209        let mut fetch_context = OPEN_FETCH_TAG.to_string();
 210        let mut rules_context = OPEN_RULES_TAG.to_string();
 211
 212        for chunk in &self.content {
 213            let chunk = match chunk {
 214                UserMessageContent::Text(text) => {
 215                    language_model::MessageContent::Text(text.clone())
 216                }
 217                UserMessageContent::Image(value) => {
 218                    language_model::MessageContent::Image(value.clone())
 219                }
 220                UserMessageContent::Mention { uri, content } => {
 221                    match uri {
 222                        MentionUri::File { abs_path } => {
 223                            write!(
 224                                &mut file_context,
 225                                "\n{}",
 226                                MarkdownCodeBlock {
 227                                    tag: &codeblock_tag(abs_path, None),
 228                                    text: &content.to_string(),
 229                                }
 230                            )
 231                            .ok();
 232                        }
 233                        MentionUri::PastedImage => {
 234                            debug_panic!("pasted image URI should not be used in mention content")
 235                        }
 236                        MentionUri::Directory { .. } => {
 237                            write!(&mut directory_context, "\n{}\n", content).ok();
 238                        }
 239                        MentionUri::Symbol {
 240                            abs_path: path,
 241                            line_range,
 242                            ..
 243                        } => {
 244                            write!(
 245                                &mut symbol_context,
 246                                "\n{}",
 247                                MarkdownCodeBlock {
 248                                    tag: &codeblock_tag(path, Some(line_range)),
 249                                    text: content
 250                                }
 251                            )
 252                            .ok();
 253                        }
 254                        MentionUri::Selection {
 255                            abs_path: path,
 256                            line_range,
 257                            ..
 258                        } => {
 259                            write!(
 260                                &mut selection_context,
 261                                "\n{}",
 262                                MarkdownCodeBlock {
 263                                    tag: &codeblock_tag(
 264                                        path.as_deref().unwrap_or("Untitled".as_ref()),
 265                                        Some(line_range)
 266                                    ),
 267                                    text: content
 268                                }
 269                            )
 270                            .ok();
 271                        }
 272                        MentionUri::Thread { .. } => {
 273                            write!(&mut thread_context, "\n{}\n", content).ok();
 274                        }
 275                        MentionUri::TextThread { .. } => {
 276                            write!(&mut thread_context, "\n{}\n", content).ok();
 277                        }
 278                        MentionUri::Rule { .. } => {
 279                            write!(
 280                                &mut rules_context,
 281                                "\n{}",
 282                                MarkdownCodeBlock {
 283                                    tag: "",
 284                                    text: content
 285                                }
 286                            )
 287                            .ok();
 288                        }
 289                        MentionUri::Fetch { url } => {
 290                            write!(&mut fetch_context, "\nFetch: {}\n\n{}", url, content).ok();
 291                        }
 292                    }
 293
 294                    language_model::MessageContent::Text(uri.as_link().to_string())
 295                }
 296            };
 297
 298            message.content.push(chunk);
 299        }
 300
 301        let len_before_context = message.content.len();
 302
 303        if file_context.len() > OPEN_FILES_TAG.len() {
 304            file_context.push_str("</files>\n");
 305            message
 306                .content
 307                .push(language_model::MessageContent::Text(file_context));
 308        }
 309
 310        if directory_context.len() > OPEN_DIRECTORIES_TAG.len() {
 311            directory_context.push_str("</directories>\n");
 312            message
 313                .content
 314                .push(language_model::MessageContent::Text(directory_context));
 315        }
 316
 317        if symbol_context.len() > OPEN_SYMBOLS_TAG.len() {
 318            symbol_context.push_str("</symbols>\n");
 319            message
 320                .content
 321                .push(language_model::MessageContent::Text(symbol_context));
 322        }
 323
 324        if selection_context.len() > OPEN_SELECTIONS_TAG.len() {
 325            selection_context.push_str("</selections>\n");
 326            message
 327                .content
 328                .push(language_model::MessageContent::Text(selection_context));
 329        }
 330
 331        if thread_context.len() > OPEN_THREADS_TAG.len() {
 332            thread_context.push_str("</threads>\n");
 333            message
 334                .content
 335                .push(language_model::MessageContent::Text(thread_context));
 336        }
 337
 338        if fetch_context.len() > OPEN_FETCH_TAG.len() {
 339            fetch_context.push_str("</fetched_urls>\n");
 340            message
 341                .content
 342                .push(language_model::MessageContent::Text(fetch_context));
 343        }
 344
 345        if rules_context.len() > OPEN_RULES_TAG.len() {
 346            rules_context.push_str("</user_rules>\n");
 347            message
 348                .content
 349                .push(language_model::MessageContent::Text(rules_context));
 350        }
 351
 352        if message.content.len() > len_before_context {
 353            message.content.insert(
 354                len_before_context,
 355                language_model::MessageContent::Text(OPEN_CONTEXT.into()),
 356            );
 357            message
 358                .content
 359                .push(language_model::MessageContent::Text("</context>".into()));
 360        }
 361
 362        message
 363    }
 364}
 365
 366fn codeblock_tag(full_path: &Path, line_range: Option<&RangeInclusive<u32>>) -> String {
 367    let mut result = String::new();
 368
 369    if let Some(extension) = full_path.extension().and_then(|ext| ext.to_str()) {
 370        let _ = write!(result, "{} ", extension);
 371    }
 372
 373    let _ = write!(result, "{}", full_path.display());
 374
 375    if let Some(range) = line_range {
 376        if range.start() == range.end() {
 377            let _ = write!(result, ":{}", range.start() + 1);
 378        } else {
 379            let _ = write!(result, ":{}-{}", range.start() + 1, range.end() + 1);
 380        }
 381    }
 382
 383    result
 384}
 385
 386impl AgentMessage {
 387    pub fn to_markdown(&self) -> String {
 388        let mut markdown = String::from("## Assistant\n\n");
 389
 390        for content in &self.content {
 391            match content {
 392                AgentMessageContent::Text(text) => {
 393                    markdown.push_str(text);
 394                    markdown.push('\n');
 395                }
 396                AgentMessageContent::Thinking { text, .. } => {
 397                    markdown.push_str("<think>");
 398                    markdown.push_str(text);
 399                    markdown.push_str("</think>\n");
 400                }
 401                AgentMessageContent::RedactedThinking(_) => {
 402                    markdown.push_str("<redacted_thinking />\n")
 403                }
 404                AgentMessageContent::ToolUse(tool_use) => {
 405                    markdown.push_str(&format!(
 406                        "**Tool Use**: {} (ID: {})\n",
 407                        tool_use.name, tool_use.id
 408                    ));
 409                    markdown.push_str(&format!(
 410                        "{}\n",
 411                        MarkdownCodeBlock {
 412                            tag: "json",
 413                            text: &format!("{:#}", tool_use.input)
 414                        }
 415                    ));
 416                }
 417            }
 418        }
 419
 420        for tool_result in self.tool_results.values() {
 421            markdown.push_str(&format!(
 422                "**Tool Result**: {} (ID: {})\n\n",
 423                tool_result.tool_name, tool_result.tool_use_id
 424            ));
 425            if tool_result.is_error {
 426                markdown.push_str("**ERROR:**\n");
 427            }
 428
 429            match &tool_result.content {
 430                LanguageModelToolResultContent::Text(text) => {
 431                    writeln!(markdown, "{text}\n").ok();
 432                }
 433                LanguageModelToolResultContent::Image(_) => {
 434                    writeln!(markdown, "<image />\n").ok();
 435                }
 436            }
 437
 438            if let Some(output) = tool_result.output.as_ref() {
 439                writeln!(
 440                    markdown,
 441                    "**Debug Output**:\n\n```json\n{}\n```\n",
 442                    serde_json::to_string_pretty(output).unwrap()
 443                )
 444                .unwrap();
 445            }
 446        }
 447
 448        markdown
 449    }
 450
 451    pub fn to_request(&self) -> Vec<LanguageModelRequestMessage> {
 452        let mut assistant_message = LanguageModelRequestMessage {
 453            role: Role::Assistant,
 454            content: Vec::with_capacity(self.content.len()),
 455            cache: false,
 456            reasoning_details: self.reasoning_details.clone(),
 457        };
 458        for chunk in &self.content {
 459            match chunk {
 460                AgentMessageContent::Text(text) => {
 461                    assistant_message
 462                        .content
 463                        .push(language_model::MessageContent::Text(text.clone()));
 464                }
 465                AgentMessageContent::Thinking { text, signature } => {
 466                    assistant_message
 467                        .content
 468                        .push(language_model::MessageContent::Thinking {
 469                            text: text.clone(),
 470                            signature: signature.clone(),
 471                        });
 472                }
 473                AgentMessageContent::RedactedThinking(value) => {
 474                    assistant_message.content.push(
 475                        language_model::MessageContent::RedactedThinking(value.clone()),
 476                    );
 477                }
 478                AgentMessageContent::ToolUse(tool_use) => {
 479                    if self.tool_results.contains_key(&tool_use.id) {
 480                        assistant_message
 481                            .content
 482                            .push(language_model::MessageContent::ToolUse(tool_use.clone()));
 483                    }
 484                }
 485            };
 486        }
 487
 488        let mut user_message = LanguageModelRequestMessage {
 489            role: Role::User,
 490            content: Vec::new(),
 491            cache: false,
 492            reasoning_details: None,
 493        };
 494
 495        for tool_result in self.tool_results.values() {
 496            let mut tool_result = tool_result.clone();
 497            // Surprisingly, the API fails if we return an empty string here.
 498            // It thinks we are sending a tool use without a tool result.
 499            if tool_result.content.is_empty() {
 500                tool_result.content = "<Tool returned an empty string>".into();
 501            }
 502            user_message
 503                .content
 504                .push(language_model::MessageContent::ToolResult(tool_result));
 505        }
 506
 507        let mut messages = Vec::new();
 508        if !assistant_message.content.is_empty() {
 509            messages.push(assistant_message);
 510        }
 511        if !user_message.content.is_empty() {
 512            messages.push(user_message);
 513        }
 514        messages
 515    }
 516}
 517
 518#[derive(Default, Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 519pub struct AgentMessage {
 520    pub content: Vec<AgentMessageContent>,
 521    pub tool_results: IndexMap<LanguageModelToolUseId, LanguageModelToolResult>,
 522    pub reasoning_details: Option<serde_json::Value>,
 523}
 524
 525#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 526pub enum AgentMessageContent {
 527    Text(String),
 528    Thinking {
 529        text: String,
 530        signature: Option<String>,
 531    },
 532    RedactedThinking(String),
 533    ToolUse(LanguageModelToolUse),
 534}
 535
 536pub trait TerminalHandle {
 537    fn id(&self, cx: &AsyncApp) -> Result<acp::TerminalId>;
 538    fn current_output(&self, cx: &AsyncApp) -> Result<acp::TerminalOutputResponse>;
 539    fn wait_for_exit(&self, cx: &AsyncApp) -> Result<Shared<Task<acp::TerminalExitStatus>>>;
 540    fn kill(&self, cx: &AsyncApp) -> Result<()>;
 541    fn was_stopped_by_user(&self, cx: &AsyncApp) -> Result<bool>;
 542}
 543
 544pub trait ThreadEnvironment {
 545    fn create_terminal(
 546        &self,
 547        command: String,
 548        cwd: Option<PathBuf>,
 549        output_byte_limit: Option<u64>,
 550        cx: &mut AsyncApp,
 551    ) -> Task<Result<Rc<dyn TerminalHandle>>>;
 552}
 553
 554#[derive(Debug)]
 555pub enum ThreadEvent {
 556    UserMessage(UserMessage),
 557    AgentText(String),
 558    AgentThinking(String),
 559    ToolCall(acp::ToolCall),
 560    ToolCallUpdate(acp_thread::ToolCallUpdate),
 561    ToolCallAuthorization(ToolCallAuthorization),
 562    Retry(acp_thread::RetryStatus),
 563    Stop(acp::StopReason),
 564}
 565
 566#[derive(Debug)]
 567pub struct NewTerminal {
 568    pub command: String,
 569    pub output_byte_limit: Option<u64>,
 570    pub cwd: Option<PathBuf>,
 571    pub response: oneshot::Sender<Result<Entity<acp_thread::Terminal>>>,
 572}
 573
 574#[derive(Debug)]
 575pub struct ToolCallAuthorization {
 576    pub tool_call: acp::ToolCallUpdate,
 577    pub options: Vec<acp::PermissionOption>,
 578    pub response: oneshot::Sender<acp::PermissionOptionId>,
 579}
 580
 581#[derive(Debug, thiserror::Error)]
 582enum CompletionError {
 583    #[error("max tokens")]
 584    MaxTokens,
 585    #[error("refusal")]
 586    Refusal,
 587    #[error(transparent)]
 588    Other(#[from] anyhow::Error),
 589}
 590
 591pub struct Thread {
 592    id: acp::SessionId,
 593    prompt_id: PromptId,
 594    updated_at: DateTime<Utc>,
 595    title: Option<SharedString>,
 596    pending_title_generation: Option<Task<()>>,
 597    pending_summary_generation: Option<Shared<Task<Option<SharedString>>>>,
 598    summary: Option<SharedString>,
 599    messages: Vec<Message>,
 600    user_store: Entity<UserStore>,
 601    completion_mode: CompletionMode,
 602    /// Holds the task that handles agent interaction until the end of the turn.
 603    /// Survives across multiple requests as the model performs tool calls and
 604    /// we run tools, report their results.
 605    running_turn: Option<RunningTurn>,
 606    pending_message: Option<AgentMessage>,
 607    tools: BTreeMap<SharedString, Arc<dyn AnyAgentTool>>,
 608    tool_use_limit_reached: bool,
 609    request_token_usage: HashMap<UserMessageId, language_model::TokenUsage>,
 610    #[allow(unused)]
 611    cumulative_token_usage: TokenUsage,
 612    #[allow(unused)]
 613    initial_project_snapshot: Shared<Task<Option<Arc<ProjectSnapshot>>>>,
 614    context_server_registry: Entity<ContextServerRegistry>,
 615    profile_id: AgentProfileId,
 616    project_context: Entity<ProjectContext>,
 617    templates: Arc<Templates>,
 618    model: Option<Arc<dyn LanguageModel>>,
 619    summarization_model: Option<Arc<dyn LanguageModel>>,
 620    prompt_capabilities_tx: watch::Sender<acp::PromptCapabilities>,
 621    pub(crate) prompt_capabilities_rx: watch::Receiver<acp::PromptCapabilities>,
 622    pub(crate) project: Entity<Project>,
 623    pub(crate) action_log: Entity<ActionLog>,
 624    /// Tracks the last time files were read by the agent, to detect external modifications
 625    pub(crate) file_read_times: HashMap<PathBuf, fs::MTime>,
 626    /// True if this thread was imported from a shared thread and can be synced.
 627    imported: bool,
 628}
 629
 630impl Thread {
 631    fn prompt_capabilities(model: Option<&dyn LanguageModel>) -> acp::PromptCapabilities {
 632        let image = model.map_or(true, |model| model.supports_images());
 633        acp::PromptCapabilities::new()
 634            .image(image)
 635            .embedded_context(true)
 636    }
 637
 638    pub fn new(
 639        project: Entity<Project>,
 640        project_context: Entity<ProjectContext>,
 641        context_server_registry: Entity<ContextServerRegistry>,
 642        templates: Arc<Templates>,
 643        model: Option<Arc<dyn LanguageModel>>,
 644        cx: &mut Context<Self>,
 645    ) -> Self {
 646        let profile_id = AgentSettings::get_global(cx).default_profile.clone();
 647        let action_log = cx.new(|_cx| ActionLog::new(project.clone()));
 648        let (prompt_capabilities_tx, prompt_capabilities_rx) =
 649            watch::channel(Self::prompt_capabilities(model.as_deref()));
 650        Self {
 651            id: acp::SessionId::new(uuid::Uuid::new_v4().to_string()),
 652            prompt_id: PromptId::new(),
 653            updated_at: Utc::now(),
 654            title: None,
 655            pending_title_generation: None,
 656            pending_summary_generation: None,
 657            summary: None,
 658            messages: Vec::new(),
 659            user_store: project.read(cx).user_store(),
 660            completion_mode: AgentSettings::get_global(cx).preferred_completion_mode,
 661            running_turn: None,
 662            pending_message: None,
 663            tools: BTreeMap::default(),
 664            tool_use_limit_reached: false,
 665            request_token_usage: HashMap::default(),
 666            cumulative_token_usage: TokenUsage::default(),
 667            initial_project_snapshot: {
 668                let project_snapshot = Self::project_snapshot(project.clone(), cx);
 669                cx.foreground_executor()
 670                    .spawn(async move { Some(project_snapshot.await) })
 671                    .shared()
 672            },
 673            context_server_registry,
 674            profile_id,
 675            project_context,
 676            templates,
 677            model,
 678            summarization_model: None,
 679            prompt_capabilities_tx,
 680            prompt_capabilities_rx,
 681            project,
 682            action_log,
 683            file_read_times: HashMap::default(),
 684            imported: false,
 685        }
 686    }
 687
 688    pub fn id(&self) -> &acp::SessionId {
 689        &self.id
 690    }
 691
 692    /// Returns true if this thread was imported from a shared thread.
 693    pub fn is_imported(&self) -> bool {
 694        self.imported
 695    }
 696
 697    pub fn replay(
 698        &mut self,
 699        cx: &mut Context<Self>,
 700    ) -> mpsc::UnboundedReceiver<Result<ThreadEvent>> {
 701        let (tx, rx) = mpsc::unbounded();
 702        let stream = ThreadEventStream(tx);
 703        for message in &self.messages {
 704            match message {
 705                Message::User(user_message) => stream.send_user_message(user_message),
 706                Message::Agent(assistant_message) => {
 707                    for content in &assistant_message.content {
 708                        match content {
 709                            AgentMessageContent::Text(text) => stream.send_text(text),
 710                            AgentMessageContent::Thinking { text, .. } => {
 711                                stream.send_thinking(text)
 712                            }
 713                            AgentMessageContent::RedactedThinking(_) => {}
 714                            AgentMessageContent::ToolUse(tool_use) => {
 715                                self.replay_tool_call(
 716                                    tool_use,
 717                                    assistant_message.tool_results.get(&tool_use.id),
 718                                    &stream,
 719                                    cx,
 720                                );
 721                            }
 722                        }
 723                    }
 724                }
 725                Message::Resume => {}
 726            }
 727        }
 728        rx
 729    }
 730
 731    fn replay_tool_call(
 732        &self,
 733        tool_use: &LanguageModelToolUse,
 734        tool_result: Option<&LanguageModelToolResult>,
 735        stream: &ThreadEventStream,
 736        cx: &mut Context<Self>,
 737    ) {
 738        let tool = self.tools.get(tool_use.name.as_ref()).cloned().or_else(|| {
 739            self.context_server_registry
 740                .read(cx)
 741                .servers()
 742                .find_map(|(_, tools)| {
 743                    if let Some(tool) = tools.get(tool_use.name.as_ref()) {
 744                        Some(tool.clone())
 745                    } else {
 746                        None
 747                    }
 748                })
 749        });
 750
 751        let Some(tool) = tool else {
 752            stream
 753                .0
 754                .unbounded_send(Ok(ThreadEvent::ToolCall(
 755                    acp::ToolCall::new(tool_use.id.to_string(), tool_use.name.to_string())
 756                        .status(acp::ToolCallStatus::Failed)
 757                        .raw_input(tool_use.input.clone()),
 758                )))
 759                .ok();
 760            return;
 761        };
 762
 763        let title = tool.initial_title(tool_use.input.clone(), cx);
 764        let kind = tool.kind();
 765        stream.send_tool_call(
 766            &tool_use.id,
 767            &tool_use.name,
 768            title,
 769            kind,
 770            tool_use.input.clone(),
 771        );
 772
 773        let output = tool_result
 774            .as_ref()
 775            .and_then(|result| result.output.clone());
 776        if let Some(output) = output.clone() {
 777            // For replay, we use a dummy cancellation receiver since the tool already completed
 778            let (_cancellation_tx, cancellation_rx) = watch::channel(false);
 779            let tool_event_stream = ToolCallEventStream::new(
 780                tool_use.id.clone(),
 781                stream.clone(),
 782                Some(self.project.read(cx).fs().clone()),
 783                cancellation_rx,
 784            );
 785            tool.replay(tool_use.input.clone(), output, tool_event_stream, cx)
 786                .log_err();
 787        }
 788
 789        stream.update_tool_call_fields(
 790            &tool_use.id,
 791            acp::ToolCallUpdateFields::new()
 792                .status(
 793                    tool_result
 794                        .as_ref()
 795                        .map_or(acp::ToolCallStatus::Failed, |result| {
 796                            if result.is_error {
 797                                acp::ToolCallStatus::Failed
 798                            } else {
 799                                acp::ToolCallStatus::Completed
 800                            }
 801                        }),
 802                )
 803                .raw_output(output),
 804        );
 805    }
 806
 807    pub fn from_db(
 808        id: acp::SessionId,
 809        db_thread: DbThread,
 810        project: Entity<Project>,
 811        project_context: Entity<ProjectContext>,
 812        context_server_registry: Entity<ContextServerRegistry>,
 813        templates: Arc<Templates>,
 814        cx: &mut Context<Self>,
 815    ) -> Self {
 816        let profile_id = db_thread
 817            .profile
 818            .unwrap_or_else(|| AgentSettings::get_global(cx).default_profile.clone());
 819
 820        let mut model = LanguageModelRegistry::global(cx).update(cx, |registry, cx| {
 821            db_thread
 822                .model
 823                .and_then(|model| {
 824                    let model = SelectedModel {
 825                        provider: model.provider.clone().into(),
 826                        model: model.model.into(),
 827                    };
 828                    registry.select_model(&model, cx)
 829                })
 830                .or_else(|| registry.default_model())
 831                .map(|model| model.model)
 832        });
 833
 834        if model.is_none() {
 835            model = Self::resolve_profile_model(&profile_id, cx);
 836        }
 837        if model.is_none() {
 838            model = LanguageModelRegistry::global(cx).update(cx, |registry, _cx| {
 839                registry.default_model().map(|model| model.model)
 840            });
 841        }
 842
 843        let (prompt_capabilities_tx, prompt_capabilities_rx) =
 844            watch::channel(Self::prompt_capabilities(model.as_deref()));
 845
 846        let action_log = cx.new(|_| ActionLog::new(project.clone()));
 847
 848        Self {
 849            id,
 850            prompt_id: PromptId::new(),
 851            title: if db_thread.title.is_empty() {
 852                None
 853            } else {
 854                Some(db_thread.title.clone())
 855            },
 856            pending_title_generation: None,
 857            pending_summary_generation: None,
 858            summary: db_thread.detailed_summary,
 859            messages: db_thread.messages,
 860            user_store: project.read(cx).user_store(),
 861            completion_mode: db_thread.completion_mode.unwrap_or_default(),
 862            running_turn: None,
 863            pending_message: None,
 864            tools: BTreeMap::default(),
 865            tool_use_limit_reached: false,
 866            request_token_usage: db_thread.request_token_usage.clone(),
 867            cumulative_token_usage: db_thread.cumulative_token_usage,
 868            initial_project_snapshot: Task::ready(db_thread.initial_project_snapshot).shared(),
 869            context_server_registry,
 870            profile_id,
 871            project_context,
 872            templates,
 873            model,
 874            summarization_model: None,
 875            project,
 876            action_log,
 877            updated_at: db_thread.updated_at,
 878            prompt_capabilities_tx,
 879            prompt_capabilities_rx,
 880            file_read_times: HashMap::default(),
 881            imported: db_thread.imported,
 882        }
 883    }
 884
 885    pub fn to_db(&self, cx: &App) -> Task<DbThread> {
 886        let initial_project_snapshot = self.initial_project_snapshot.clone();
 887        let mut thread = DbThread {
 888            title: self.title(),
 889            messages: self.messages.clone(),
 890            updated_at: self.updated_at,
 891            detailed_summary: self.summary.clone(),
 892            initial_project_snapshot: None,
 893            cumulative_token_usage: self.cumulative_token_usage,
 894            request_token_usage: self.request_token_usage.clone(),
 895            model: self.model.as_ref().map(|model| DbLanguageModel {
 896                provider: model.provider_id().to_string(),
 897                model: model.name().0.to_string(),
 898            }),
 899            completion_mode: Some(self.completion_mode),
 900            profile: Some(self.profile_id.clone()),
 901            imported: self.imported,
 902        };
 903
 904        cx.background_spawn(async move {
 905            let initial_project_snapshot = initial_project_snapshot.await;
 906            thread.initial_project_snapshot = initial_project_snapshot;
 907            thread
 908        })
 909    }
 910
 911    /// Create a snapshot of the current project state including git information and unsaved buffers.
 912    fn project_snapshot(
 913        project: Entity<Project>,
 914        cx: &mut Context<Self>,
 915    ) -> Task<Arc<ProjectSnapshot>> {
 916        let task = project::telemetry_snapshot::TelemetrySnapshot::new(&project, cx);
 917        cx.spawn(async move |_, _| {
 918            let snapshot = task.await;
 919
 920            Arc::new(ProjectSnapshot {
 921                worktree_snapshots: snapshot.worktree_snapshots,
 922                timestamp: Utc::now(),
 923            })
 924        })
 925    }
 926
 927    pub fn project_context(&self) -> &Entity<ProjectContext> {
 928        &self.project_context
 929    }
 930
 931    pub fn project(&self) -> &Entity<Project> {
 932        &self.project
 933    }
 934
 935    pub fn action_log(&self) -> &Entity<ActionLog> {
 936        &self.action_log
 937    }
 938
 939    pub fn is_empty(&self) -> bool {
 940        self.messages.is_empty() && self.title.is_none()
 941    }
 942
 943    pub fn model(&self) -> Option<&Arc<dyn LanguageModel>> {
 944        self.model.as_ref()
 945    }
 946
 947    pub fn set_model(&mut self, model: Arc<dyn LanguageModel>, cx: &mut Context<Self>) {
 948        let old_usage = self.latest_token_usage();
 949        self.model = Some(model);
 950        let new_caps = Self::prompt_capabilities(self.model.as_deref());
 951        let new_usage = self.latest_token_usage();
 952        if old_usage != new_usage {
 953            cx.emit(TokenUsageUpdated(new_usage));
 954        }
 955        self.prompt_capabilities_tx.send(new_caps).log_err();
 956        cx.notify()
 957    }
 958
 959    pub fn summarization_model(&self) -> Option<&Arc<dyn LanguageModel>> {
 960        self.summarization_model.as_ref()
 961    }
 962
 963    pub fn set_summarization_model(
 964        &mut self,
 965        model: Option<Arc<dyn LanguageModel>>,
 966        cx: &mut Context<Self>,
 967    ) {
 968        self.summarization_model = model;
 969        cx.notify()
 970    }
 971
 972    pub fn completion_mode(&self) -> CompletionMode {
 973        self.completion_mode
 974    }
 975
 976    pub fn set_completion_mode(&mut self, mode: CompletionMode, cx: &mut Context<Self>) {
 977        let old_usage = self.latest_token_usage();
 978        self.completion_mode = mode;
 979        let new_usage = self.latest_token_usage();
 980        if old_usage != new_usage {
 981            cx.emit(TokenUsageUpdated(new_usage));
 982        }
 983        cx.notify()
 984    }
 985
 986    #[cfg(any(test, feature = "test-support"))]
 987    pub fn last_message(&self) -> Option<Message> {
 988        if let Some(message) = self.pending_message.clone() {
 989            Some(Message::Agent(message))
 990        } else {
 991            self.messages.last().cloned()
 992        }
 993    }
 994
 995    pub fn add_default_tools(
 996        &mut self,
 997        environment: Rc<dyn ThreadEnvironment>,
 998        cx: &mut Context<Self>,
 999    ) {
1000        let language_registry = self.project.read(cx).languages().clone();
1001        self.add_tool(CopyPathTool::new(self.project.clone()));
1002        self.add_tool(CreateDirectoryTool::new(self.project.clone()));
1003        self.add_tool(DeletePathTool::new(
1004            self.project.clone(),
1005            self.action_log.clone(),
1006        ));
1007        self.add_tool(DiagnosticsTool::new(self.project.clone()));
1008        self.add_tool(EditFileTool::new(
1009            self.project.clone(),
1010            cx.weak_entity(),
1011            language_registry,
1012            Templates::new(),
1013        ));
1014        self.add_tool(FetchTool::new(self.project.read(cx).client().http_client()));
1015        self.add_tool(FindPathTool::new(self.project.clone()));
1016        self.add_tool(GrepTool::new(self.project.clone()));
1017        self.add_tool(ListDirectoryTool::new(self.project.clone()));
1018        self.add_tool(MovePathTool::new(self.project.clone()));
1019        self.add_tool(NowTool);
1020        self.add_tool(OpenTool::new(self.project.clone()));
1021        self.add_tool(ReadFileTool::new(
1022            cx.weak_entity(),
1023            self.project.clone(),
1024            self.action_log.clone(),
1025        ));
1026        self.add_tool(SaveFileTool::new(self.project.clone()));
1027        self.add_tool(RestoreFileFromDiskTool::new(self.project.clone()));
1028        self.add_tool(TerminalTool::new(self.project.clone(), environment));
1029        self.add_tool(ThinkingTool);
1030        self.add_tool(WebSearchTool);
1031    }
1032
1033    pub fn add_tool<T: AgentTool>(&mut self, tool: T) {
1034        self.tools.insert(T::name().into(), tool.erase());
1035    }
1036
1037    pub fn remove_tool(&mut self, name: &str) -> bool {
1038        self.tools.remove(name).is_some()
1039    }
1040
1041    pub fn profile(&self) -> &AgentProfileId {
1042        &self.profile_id
1043    }
1044
1045    pub fn set_profile(&mut self, profile_id: AgentProfileId, cx: &mut Context<Self>) {
1046        if self.profile_id == profile_id {
1047            return;
1048        }
1049
1050        self.profile_id = profile_id;
1051
1052        // Swap to the profile's preferred model when available.
1053        if let Some(model) = Self::resolve_profile_model(&self.profile_id, cx) {
1054            self.set_model(model, cx);
1055        }
1056    }
1057
1058    pub fn cancel(&mut self, cx: &mut Context<Self>) -> Task<()> {
1059        let Some(running_turn) = self.running_turn.take() else {
1060            self.flush_pending_message(cx);
1061            return Task::ready(());
1062        };
1063
1064        let turn_task = running_turn.cancel();
1065
1066        cx.spawn(async move |this, cx| {
1067            turn_task.await;
1068            this.update(cx, |this, cx| {
1069                this.flush_pending_message(cx);
1070            })
1071            .ok();
1072        })
1073    }
1074
1075    fn update_token_usage(&mut self, update: language_model::TokenUsage, cx: &mut Context<Self>) {
1076        let Some(last_user_message) = self.last_user_message() else {
1077            return;
1078        };
1079
1080        self.request_token_usage
1081            .insert(last_user_message.id.clone(), update);
1082        cx.emit(TokenUsageUpdated(self.latest_token_usage()));
1083        cx.notify();
1084    }
1085
1086    pub fn truncate(&mut self, message_id: UserMessageId, cx: &mut Context<Self>) -> Result<()> {
1087        self.cancel(cx).detach();
1088        // Clear pending message since cancel will try to flush it asynchronously,
1089        // and we don't want that content to be added after we truncate
1090        self.pending_message.take();
1091        let Some(position) = self.messages.iter().position(
1092            |msg| matches!(msg, Message::User(UserMessage { id, .. }) if id == &message_id),
1093        ) else {
1094            return Err(anyhow!("Message not found"));
1095        };
1096
1097        for message in self.messages.drain(position..) {
1098            match message {
1099                Message::User(message) => {
1100                    self.request_token_usage.remove(&message.id);
1101                }
1102                Message::Agent(_) | Message::Resume => {}
1103            }
1104        }
1105        self.clear_summary();
1106        cx.notify();
1107        Ok(())
1108    }
1109
1110    pub fn latest_request_token_usage(&self) -> Option<language_model::TokenUsage> {
1111        let last_user_message = self.last_user_message()?;
1112        let tokens = self.request_token_usage.get(&last_user_message.id)?;
1113        Some(*tokens)
1114    }
1115
1116    pub fn latest_token_usage(&self) -> Option<acp_thread::TokenUsage> {
1117        let usage = self.latest_request_token_usage()?;
1118        let model = self.model.clone()?;
1119        Some(acp_thread::TokenUsage {
1120            max_tokens: model.max_token_count_for_mode(self.completion_mode.into()),
1121            used_tokens: usage.total_tokens(),
1122        })
1123    }
1124
1125    /// Get the total input token count as of the message before the given message.
1126    ///
1127    /// Returns `None` if:
1128    /// - `target_id` is the first message (no previous message)
1129    /// - The previous message hasn't received a response yet (no usage data)
1130    /// - `target_id` is not found in the messages
1131    pub fn tokens_before_message(&self, target_id: &UserMessageId) -> Option<u64> {
1132        let mut previous_user_message_id: Option<&UserMessageId> = None;
1133
1134        for message in &self.messages {
1135            if let Message::User(user_msg) = message {
1136                if &user_msg.id == target_id {
1137                    let prev_id = previous_user_message_id?;
1138                    let usage = self.request_token_usage.get(prev_id)?;
1139                    return Some(usage.input_tokens);
1140                }
1141                previous_user_message_id = Some(&user_msg.id);
1142            }
1143        }
1144        None
1145    }
1146
1147    /// Look up the active profile and resolve its preferred model if one is configured.
1148    fn resolve_profile_model(
1149        profile_id: &AgentProfileId,
1150        cx: &mut Context<Self>,
1151    ) -> Option<Arc<dyn LanguageModel>> {
1152        let selection = AgentSettings::get_global(cx)
1153            .profiles
1154            .get(profile_id)?
1155            .default_model
1156            .clone()?;
1157        Self::resolve_model_from_selection(&selection, cx)
1158    }
1159
1160    /// Translate a stored model selection into the configured model from the registry.
1161    fn resolve_model_from_selection(
1162        selection: &LanguageModelSelection,
1163        cx: &mut Context<Self>,
1164    ) -> Option<Arc<dyn LanguageModel>> {
1165        let selected = SelectedModel {
1166            provider: LanguageModelProviderId::from(selection.provider.0.clone()),
1167            model: LanguageModelId::from(selection.model.clone()),
1168        };
1169        LanguageModelRegistry::global(cx).update(cx, |registry, cx| {
1170            registry
1171                .select_model(&selected, cx)
1172                .map(|configured| configured.model)
1173        })
1174    }
1175
1176    pub fn resume(
1177        &mut self,
1178        cx: &mut Context<Self>,
1179    ) -> Result<mpsc::UnboundedReceiver<Result<ThreadEvent>>> {
1180        self.messages.push(Message::Resume);
1181        cx.notify();
1182
1183        log::debug!("Total messages in thread: {}", self.messages.len());
1184        self.run_turn(cx)
1185    }
1186
1187    /// Sending a message results in the model streaming a response, which could include tool calls.
1188    /// After calling tools, the model will stops and waits for any outstanding tool calls to be completed and their results sent.
1189    /// The returned channel will report all the occurrences in which the model stops before erroring or ending its turn.
1190    pub fn send<T>(
1191        &mut self,
1192        id: UserMessageId,
1193        content: impl IntoIterator<Item = T>,
1194        cx: &mut Context<Self>,
1195    ) -> Result<mpsc::UnboundedReceiver<Result<ThreadEvent>>>
1196    where
1197        T: Into<UserMessageContent>,
1198    {
1199        let content = content.into_iter().map(Into::into).collect::<Vec<_>>();
1200        log::debug!("Thread::send content: {:?}", content);
1201
1202        self.messages
1203            .push(Message::User(UserMessage { id, content }));
1204        cx.notify();
1205
1206        self.send_existing(cx)
1207    }
1208
1209    pub fn send_existing(
1210        &mut self,
1211        cx: &mut Context<Self>,
1212    ) -> Result<mpsc::UnboundedReceiver<Result<ThreadEvent>>> {
1213        let model = self.model().context("No language model configured")?;
1214
1215        log::info!("Thread::send called with model: {}", model.name().0);
1216        self.advance_prompt_id();
1217
1218        log::debug!("Total messages in thread: {}", self.messages.len());
1219        self.run_turn(cx)
1220    }
1221
1222    pub fn push_acp_user_block(
1223        &mut self,
1224        id: UserMessageId,
1225        blocks: impl IntoIterator<Item = acp::ContentBlock>,
1226        path_style: PathStyle,
1227        cx: &mut Context<Self>,
1228    ) {
1229        let content = blocks
1230            .into_iter()
1231            .map(|block| UserMessageContent::from_content_block(block, path_style))
1232            .collect::<Vec<_>>();
1233        self.messages
1234            .push(Message::User(UserMessage { id, content }));
1235        cx.notify();
1236    }
1237
1238    pub fn push_acp_agent_block(&mut self, block: acp::ContentBlock, cx: &mut Context<Self>) {
1239        let text = match block {
1240            acp::ContentBlock::Text(text_content) => text_content.text,
1241            acp::ContentBlock::Image(_) => "[image]".to_string(),
1242            acp::ContentBlock::Audio(_) => "[audio]".to_string(),
1243            acp::ContentBlock::ResourceLink(resource_link) => resource_link.uri,
1244            acp::ContentBlock::Resource(resource) => match resource.resource {
1245                acp::EmbeddedResourceResource::TextResourceContents(resource) => resource.uri,
1246                acp::EmbeddedResourceResource::BlobResourceContents(resource) => resource.uri,
1247                _ => "[resource]".to_string(),
1248            },
1249            _ => "[unknown]".to_string(),
1250        };
1251
1252        self.messages.push(Message::Agent(AgentMessage {
1253            content: vec![AgentMessageContent::Text(text)],
1254            ..Default::default()
1255        }));
1256        cx.notify();
1257    }
1258
1259    #[cfg(feature = "eval")]
1260    pub fn proceed(
1261        &mut self,
1262        cx: &mut Context<Self>,
1263    ) -> Result<mpsc::UnboundedReceiver<Result<ThreadEvent>>> {
1264        self.run_turn(cx)
1265    }
1266
1267    fn run_turn(
1268        &mut self,
1269        cx: &mut Context<Self>,
1270    ) -> Result<mpsc::UnboundedReceiver<Result<ThreadEvent>>> {
1271        // Flush the old pending message synchronously before cancelling,
1272        // to avoid a race where the detached cancel task might flush the NEW
1273        // turn's pending message instead of the old one.
1274        self.flush_pending_message(cx);
1275        self.cancel(cx).detach();
1276
1277        let model = self.model.clone().context("No language model configured")?;
1278        let profile = AgentSettings::get_global(cx)
1279            .profiles
1280            .get(&self.profile_id)
1281            .context("Profile not found")?;
1282        let (events_tx, events_rx) = mpsc::unbounded::<Result<ThreadEvent>>();
1283        let event_stream = ThreadEventStream(events_tx);
1284        let message_ix = self.messages.len().saturating_sub(1);
1285        self.tool_use_limit_reached = false;
1286        self.clear_summary();
1287        let (cancellation_tx, mut cancellation_rx) = watch::channel(false);
1288        self.running_turn = Some(RunningTurn {
1289            event_stream: event_stream.clone(),
1290            tools: self.enabled_tools(profile, &model, cx),
1291            cancellation_tx,
1292            _task: cx.spawn(async move |this, cx| {
1293                log::debug!("Starting agent turn execution");
1294
1295                let turn_result = Self::run_turn_internal(
1296                    &this,
1297                    model,
1298                    &event_stream,
1299                    cancellation_rx.clone(),
1300                    cx,
1301                )
1302                .await;
1303
1304                // Check if we were cancelled - if so, cancel() already took running_turn
1305                // and we shouldn't touch it (it might be a NEW turn now)
1306                let was_cancelled = *cancellation_rx.borrow();
1307                if was_cancelled {
1308                    log::debug!("Turn was cancelled, skipping cleanup");
1309                    return;
1310                }
1311
1312                _ = this.update(cx, |this, cx| this.flush_pending_message(cx));
1313
1314                match turn_result {
1315                    Ok(()) => {
1316                        log::debug!("Turn execution completed");
1317                        event_stream.send_stop(acp::StopReason::EndTurn);
1318                    }
1319                    Err(error) => {
1320                        log::error!("Turn execution failed: {:?}", error);
1321                        match error.downcast::<CompletionError>() {
1322                            Ok(CompletionError::Refusal) => {
1323                                event_stream.send_stop(acp::StopReason::Refusal);
1324                                _ = this.update(cx, |this, _| this.messages.truncate(message_ix));
1325                            }
1326                            Ok(CompletionError::MaxTokens) => {
1327                                event_stream.send_stop(acp::StopReason::MaxTokens);
1328                            }
1329                            Ok(CompletionError::Other(error)) | Err(error) => {
1330                                event_stream.send_error(error);
1331                            }
1332                        }
1333                    }
1334                }
1335
1336                _ = this.update(cx, |this, _| this.running_turn.take());
1337            }),
1338        });
1339        Ok(events_rx)
1340    }
1341
1342    async fn run_turn_internal(
1343        this: &WeakEntity<Self>,
1344        model: Arc<dyn LanguageModel>,
1345        event_stream: &ThreadEventStream,
1346        mut cancellation_rx: watch::Receiver<bool>,
1347        cx: &mut AsyncApp,
1348    ) -> Result<()> {
1349        let mut attempt = 0;
1350        let mut intent = CompletionIntent::UserPrompt;
1351        loop {
1352            let request =
1353                this.update(cx, |this, cx| this.build_completion_request(intent, cx))??;
1354
1355            telemetry::event!(
1356                "Agent Thread Completion",
1357                thread_id = this.read_with(cx, |this, _| this.id.to_string())?,
1358                prompt_id = this.read_with(cx, |this, _| this.prompt_id.to_string())?,
1359                model = model.telemetry_id(),
1360                model_provider = model.provider_id().to_string(),
1361                attempt
1362            );
1363
1364            log::debug!("Calling model.stream_completion, attempt {}", attempt);
1365
1366            let (mut events, mut error) = match model.stream_completion(request, cx).await {
1367                Ok(events) => (events, None),
1368                Err(err) => (stream::empty().boxed(), Some(err)),
1369            };
1370            let mut tool_results = FuturesUnordered::new();
1371            let mut cancelled = false;
1372            loop {
1373                // Race between getting the next event and cancellation
1374                let event = futures::select! {
1375                    event = events.next().fuse() => event,
1376                    _ = cancellation_rx.changed().fuse() => {
1377                        if *cancellation_rx.borrow() {
1378                            cancelled = true;
1379                            break;
1380                        }
1381                        continue;
1382                    }
1383                };
1384                let Some(event) = event else {
1385                    break;
1386                };
1387                log::trace!("Received completion event: {:?}", event);
1388                match event {
1389                    Ok(event) => {
1390                        tool_results.extend(this.update(cx, |this, cx| {
1391                            this.handle_completion_event(
1392                                event,
1393                                event_stream,
1394                                cancellation_rx.clone(),
1395                                cx,
1396                            )
1397                        })??);
1398                    }
1399                    Err(err) => {
1400                        error = Some(err);
1401                        break;
1402                    }
1403                }
1404            }
1405
1406            let end_turn = tool_results.is_empty();
1407            while let Some(tool_result) = tool_results.next().await {
1408                log::debug!("Tool finished {:?}", tool_result);
1409
1410                event_stream.update_tool_call_fields(
1411                    &tool_result.tool_use_id,
1412                    acp::ToolCallUpdateFields::new()
1413                        .status(if tool_result.is_error {
1414                            acp::ToolCallStatus::Failed
1415                        } else {
1416                            acp::ToolCallStatus::Completed
1417                        })
1418                        .raw_output(tool_result.output.clone()),
1419                );
1420                this.update(cx, |this, _cx| {
1421                    this.pending_message()
1422                        .tool_results
1423                        .insert(tool_result.tool_use_id.clone(), tool_result);
1424                })?;
1425            }
1426
1427            this.update(cx, |this, cx| {
1428                this.flush_pending_message(cx);
1429                if this.title.is_none() && this.pending_title_generation.is_none() {
1430                    this.generate_title(cx);
1431                }
1432            })?;
1433
1434            if cancelled {
1435                log::debug!("Turn cancelled by user, exiting");
1436                return Ok(());
1437            }
1438
1439            if let Some(error) = error {
1440                attempt += 1;
1441                let retry = this.update(cx, |this, cx| {
1442                    let user_store = this.user_store.read(cx);
1443                    this.handle_completion_error(error, attempt, user_store.plan())
1444                })??;
1445                let timer = cx.background_executor().timer(retry.duration);
1446                event_stream.send_retry(retry);
1447                timer.await;
1448                this.update(cx, |this, _cx| {
1449                    if let Some(Message::Agent(message)) = this.messages.last() {
1450                        if message.tool_results.is_empty() {
1451                            intent = CompletionIntent::UserPrompt;
1452                            this.messages.push(Message::Resume);
1453                        }
1454                    }
1455                })?;
1456            } else if this.read_with(cx, |this, _| this.tool_use_limit_reached)? {
1457                return Err(language_model::ToolUseLimitReachedError.into());
1458            } else if end_turn {
1459                return Ok(());
1460            } else {
1461                intent = CompletionIntent::ToolResults;
1462                attempt = 0;
1463            }
1464        }
1465    }
1466
1467    fn handle_completion_error(
1468        &mut self,
1469        error: LanguageModelCompletionError,
1470        attempt: u8,
1471        plan: Option<Plan>,
1472    ) -> Result<acp_thread::RetryStatus> {
1473        let Some(model) = self.model.as_ref() else {
1474            return Err(anyhow!(error));
1475        };
1476
1477        let auto_retry = if model.provider_id() == ZED_CLOUD_PROVIDER_ID {
1478            match plan {
1479                Some(Plan::V2(_)) => true,
1480                Some(Plan::V1(_)) => self.completion_mode == CompletionMode::Burn,
1481                None => false,
1482            }
1483        } else {
1484            true
1485        };
1486
1487        if !auto_retry {
1488            return Err(anyhow!(error));
1489        }
1490
1491        let Some(strategy) = Self::retry_strategy_for(&error) else {
1492            return Err(anyhow!(error));
1493        };
1494
1495        let max_attempts = match &strategy {
1496            RetryStrategy::ExponentialBackoff { max_attempts, .. } => *max_attempts,
1497            RetryStrategy::Fixed { max_attempts, .. } => *max_attempts,
1498        };
1499
1500        if attempt > max_attempts {
1501            return Err(anyhow!(error));
1502        }
1503
1504        let delay = match &strategy {
1505            RetryStrategy::ExponentialBackoff { initial_delay, .. } => {
1506                let delay_secs = initial_delay.as_secs() * 2u64.pow((attempt - 1) as u32);
1507                Duration::from_secs(delay_secs)
1508            }
1509            RetryStrategy::Fixed { delay, .. } => *delay,
1510        };
1511        log::debug!("Retry attempt {attempt} with delay {delay:?}");
1512
1513        Ok(acp_thread::RetryStatus {
1514            last_error: error.to_string().into(),
1515            attempt: attempt as usize,
1516            max_attempts: max_attempts as usize,
1517            started_at: Instant::now(),
1518            duration: delay,
1519        })
1520    }
1521
1522    /// A helper method that's called on every streamed completion event.
1523    /// Returns an optional tool result task, which the main agentic loop will
1524    /// send back to the model when it resolves.
1525    fn handle_completion_event(
1526        &mut self,
1527        event: LanguageModelCompletionEvent,
1528        event_stream: &ThreadEventStream,
1529        cancellation_rx: watch::Receiver<bool>,
1530        cx: &mut Context<Self>,
1531    ) -> Result<Option<Task<LanguageModelToolResult>>> {
1532        log::trace!("Handling streamed completion event: {:?}", event);
1533        use LanguageModelCompletionEvent::*;
1534
1535        match event {
1536            StartMessage { .. } => {
1537                self.flush_pending_message(cx);
1538                self.pending_message = Some(AgentMessage::default());
1539            }
1540            Text(new_text) => self.handle_text_event(new_text, event_stream, cx),
1541            Thinking { text, signature } => {
1542                self.handle_thinking_event(text, signature, event_stream, cx)
1543            }
1544            RedactedThinking { data } => self.handle_redacted_thinking_event(data, cx),
1545            ReasoningDetails(details) => {
1546                let last_message = self.pending_message();
1547                // Store the last non-empty reasoning_details (overwrites earlier ones)
1548                // This ensures we keep the encrypted reasoning with signatures, not the early text reasoning
1549                if let serde_json::Value::Array(ref arr) = details {
1550                    if !arr.is_empty() {
1551                        last_message.reasoning_details = Some(details);
1552                    }
1553                } else {
1554                    last_message.reasoning_details = Some(details);
1555                }
1556            }
1557            ToolUse(tool_use) => {
1558                return Ok(self.handle_tool_use_event(tool_use, event_stream, cancellation_rx, cx));
1559            }
1560            ToolUseJsonParseError {
1561                id,
1562                tool_name,
1563                raw_input,
1564                json_parse_error,
1565            } => {
1566                return Ok(Some(Task::ready(
1567                    self.handle_tool_use_json_parse_error_event(
1568                        id,
1569                        tool_name,
1570                        raw_input,
1571                        json_parse_error,
1572                    ),
1573                )));
1574            }
1575            UsageUpdate(usage) => {
1576                telemetry::event!(
1577                    "Agent Thread Completion Usage Updated",
1578                    thread_id = self.id.to_string(),
1579                    prompt_id = self.prompt_id.to_string(),
1580                    model = self.model.as_ref().map(|m| m.telemetry_id()),
1581                    model_provider = self.model.as_ref().map(|m| m.provider_id().to_string()),
1582                    input_tokens = usage.input_tokens,
1583                    output_tokens = usage.output_tokens,
1584                    cache_creation_input_tokens = usage.cache_creation_input_tokens,
1585                    cache_read_input_tokens = usage.cache_read_input_tokens,
1586                );
1587                self.update_token_usage(usage, cx);
1588            }
1589            UsageUpdated { amount, limit } => {
1590                self.update_model_request_usage(amount, limit, cx);
1591            }
1592            ToolUseLimitReached => {
1593                self.tool_use_limit_reached = true;
1594            }
1595            Stop(StopReason::Refusal) => return Err(CompletionError::Refusal.into()),
1596            Stop(StopReason::MaxTokens) => return Err(CompletionError::MaxTokens.into()),
1597            Stop(StopReason::ToolUse | StopReason::EndTurn) => {}
1598            Started | Queued { .. } => {}
1599        }
1600
1601        Ok(None)
1602    }
1603
1604    fn handle_text_event(
1605        &mut self,
1606        new_text: String,
1607        event_stream: &ThreadEventStream,
1608        cx: &mut Context<Self>,
1609    ) {
1610        event_stream.send_text(&new_text);
1611
1612        let last_message = self.pending_message();
1613        if let Some(AgentMessageContent::Text(text)) = last_message.content.last_mut() {
1614            text.push_str(&new_text);
1615        } else {
1616            last_message
1617                .content
1618                .push(AgentMessageContent::Text(new_text));
1619        }
1620
1621        cx.notify();
1622    }
1623
1624    fn handle_thinking_event(
1625        &mut self,
1626        new_text: String,
1627        new_signature: Option<String>,
1628        event_stream: &ThreadEventStream,
1629        cx: &mut Context<Self>,
1630    ) {
1631        event_stream.send_thinking(&new_text);
1632
1633        let last_message = self.pending_message();
1634        if let Some(AgentMessageContent::Thinking { text, signature }) =
1635            last_message.content.last_mut()
1636        {
1637            text.push_str(&new_text);
1638            *signature = new_signature.or(signature.take());
1639        } else {
1640            last_message.content.push(AgentMessageContent::Thinking {
1641                text: new_text,
1642                signature: new_signature,
1643            });
1644        }
1645
1646        cx.notify();
1647    }
1648
1649    fn handle_redacted_thinking_event(&mut self, data: String, cx: &mut Context<Self>) {
1650        let last_message = self.pending_message();
1651        last_message
1652            .content
1653            .push(AgentMessageContent::RedactedThinking(data));
1654        cx.notify();
1655    }
1656
1657    fn handle_tool_use_event(
1658        &mut self,
1659        tool_use: LanguageModelToolUse,
1660        event_stream: &ThreadEventStream,
1661        cancellation_rx: watch::Receiver<bool>,
1662        cx: &mut Context<Self>,
1663    ) -> Option<Task<LanguageModelToolResult>> {
1664        cx.notify();
1665
1666        let tool = self.tool(tool_use.name.as_ref());
1667        let mut title = SharedString::from(&tool_use.name);
1668        let mut kind = acp::ToolKind::Other;
1669        if let Some(tool) = tool.as_ref() {
1670            title = tool.initial_title(tool_use.input.clone(), cx);
1671            kind = tool.kind();
1672        }
1673
1674        // Ensure the last message ends in the current tool use
1675        let last_message = self.pending_message();
1676        let push_new_tool_use = last_message.content.last_mut().is_none_or(|content| {
1677            if let AgentMessageContent::ToolUse(last_tool_use) = content {
1678                if last_tool_use.id == tool_use.id {
1679                    *last_tool_use = tool_use.clone();
1680                    false
1681                } else {
1682                    true
1683                }
1684            } else {
1685                true
1686            }
1687        });
1688
1689        if push_new_tool_use {
1690            event_stream.send_tool_call(
1691                &tool_use.id,
1692                &tool_use.name,
1693                title,
1694                kind,
1695                tool_use.input.clone(),
1696            );
1697            last_message
1698                .content
1699                .push(AgentMessageContent::ToolUse(tool_use.clone()));
1700        } else {
1701            event_stream.update_tool_call_fields(
1702                &tool_use.id,
1703                acp::ToolCallUpdateFields::new()
1704                    .title(title.as_str())
1705                    .kind(kind)
1706                    .raw_input(tool_use.input.clone()),
1707            );
1708        }
1709
1710        if !tool_use.is_input_complete {
1711            return None;
1712        }
1713
1714        let Some(tool) = tool else {
1715            let content = format!("No tool named {} exists", tool_use.name);
1716            return Some(Task::ready(LanguageModelToolResult {
1717                content: LanguageModelToolResultContent::Text(Arc::from(content)),
1718                tool_use_id: tool_use.id,
1719                tool_name: tool_use.name,
1720                is_error: true,
1721                output: None,
1722            }));
1723        };
1724
1725        let fs = self.project.read(cx).fs().clone();
1726        let tool_event_stream = ToolCallEventStream::new(
1727            tool_use.id.clone(),
1728            event_stream.clone(),
1729            Some(fs),
1730            cancellation_rx,
1731        );
1732        tool_event_stream.update_fields(
1733            acp::ToolCallUpdateFields::new().status(acp::ToolCallStatus::InProgress),
1734        );
1735        let supports_images = self.model().is_some_and(|model| model.supports_images());
1736        let tool_result = tool.run(tool_use.input, tool_event_stream, cx);
1737        log::debug!("Running tool {}", tool_use.name);
1738        Some(cx.foreground_executor().spawn(async move {
1739            let tool_result = tool_result.await.and_then(|output| {
1740                if let LanguageModelToolResultContent::Image(_) = &output.llm_output
1741                    && !supports_images
1742                {
1743                    return Err(anyhow!(
1744                        "Attempted to read an image, but this model doesn't support it.",
1745                    ));
1746                }
1747                Ok(output)
1748            });
1749
1750            match tool_result {
1751                Ok(output) => LanguageModelToolResult {
1752                    tool_use_id: tool_use.id,
1753                    tool_name: tool_use.name,
1754                    is_error: false,
1755                    content: output.llm_output,
1756                    output: Some(output.raw_output),
1757                },
1758                Err(error) => LanguageModelToolResult {
1759                    tool_use_id: tool_use.id,
1760                    tool_name: tool_use.name,
1761                    is_error: true,
1762                    content: LanguageModelToolResultContent::Text(Arc::from(error.to_string())),
1763                    output: Some(error.to_string().into()),
1764                },
1765            }
1766        }))
1767    }
1768
1769    fn handle_tool_use_json_parse_error_event(
1770        &mut self,
1771        tool_use_id: LanguageModelToolUseId,
1772        tool_name: Arc<str>,
1773        raw_input: Arc<str>,
1774        json_parse_error: String,
1775    ) -> LanguageModelToolResult {
1776        let tool_output = format!("Error parsing input JSON: {json_parse_error}");
1777        LanguageModelToolResult {
1778            tool_use_id,
1779            tool_name,
1780            is_error: true,
1781            content: LanguageModelToolResultContent::Text(tool_output.into()),
1782            output: Some(serde_json::Value::String(raw_input.to_string())),
1783        }
1784    }
1785
1786    fn update_model_request_usage(&self, amount: usize, limit: UsageLimit, cx: &mut Context<Self>) {
1787        self.project
1788            .read(cx)
1789            .user_store()
1790            .update(cx, |user_store, cx| {
1791                user_store.update_model_request_usage(
1792                    ModelRequestUsage(RequestUsage {
1793                        amount: amount as i32,
1794                        limit,
1795                    }),
1796                    cx,
1797                )
1798            });
1799    }
1800
1801    pub fn title(&self) -> SharedString {
1802        self.title.clone().unwrap_or("New Thread".into())
1803    }
1804
1805    pub fn is_generating_summary(&self) -> bool {
1806        self.pending_summary_generation.is_some()
1807    }
1808
1809    pub fn is_generating_title(&self) -> bool {
1810        self.pending_title_generation.is_some()
1811    }
1812
1813    pub fn summary(&mut self, cx: &mut Context<Self>) -> Shared<Task<Option<SharedString>>> {
1814        if let Some(summary) = self.summary.as_ref() {
1815            return Task::ready(Some(summary.clone())).shared();
1816        }
1817        if let Some(task) = self.pending_summary_generation.clone() {
1818            return task;
1819        }
1820        let Some(model) = self.summarization_model.clone() else {
1821            log::error!("No summarization model available");
1822            return Task::ready(None).shared();
1823        };
1824        let mut request = LanguageModelRequest {
1825            intent: Some(CompletionIntent::ThreadContextSummarization),
1826            temperature: AgentSettings::temperature_for_model(&model, cx),
1827            ..Default::default()
1828        };
1829
1830        for message in &self.messages {
1831            request.messages.extend(message.to_request());
1832        }
1833
1834        request.messages.push(LanguageModelRequestMessage {
1835            role: Role::User,
1836            content: vec![SUMMARIZE_THREAD_DETAILED_PROMPT.into()],
1837            cache: false,
1838            reasoning_details: None,
1839        });
1840
1841        let task = cx
1842            .spawn(async move |this, cx| {
1843                let mut summary = String::new();
1844                let mut messages = model.stream_completion(request, cx).await.log_err()?;
1845                while let Some(event) = messages.next().await {
1846                    let event = event.log_err()?;
1847                    let text = match event {
1848                        LanguageModelCompletionEvent::Text(text) => text,
1849                        LanguageModelCompletionEvent::UsageUpdated { amount, limit } => {
1850                            this.update(cx, |thread, cx| {
1851                                thread.update_model_request_usage(amount, limit, cx);
1852                            })
1853                            .ok()?;
1854                            continue;
1855                        }
1856                        _ => continue,
1857                    };
1858
1859                    let mut lines = text.lines();
1860                    summary.extend(lines.next());
1861                }
1862
1863                log::debug!("Setting summary: {}", summary);
1864                let summary = SharedString::from(summary);
1865
1866                this.update(cx, |this, cx| {
1867                    this.summary = Some(summary.clone());
1868                    this.pending_summary_generation = None;
1869                    cx.notify()
1870                })
1871                .ok()?;
1872
1873                Some(summary)
1874            })
1875            .shared();
1876        self.pending_summary_generation = Some(task.clone());
1877        task
1878    }
1879
1880    pub fn generate_title(&mut self, cx: &mut Context<Self>) {
1881        let Some(model) = self.summarization_model.clone() else {
1882            return;
1883        };
1884
1885        log::debug!(
1886            "Generating title with model: {:?}",
1887            self.summarization_model.as_ref().map(|model| model.name())
1888        );
1889        let mut request = LanguageModelRequest {
1890            intent: Some(CompletionIntent::ThreadSummarization),
1891            temperature: AgentSettings::temperature_for_model(&model, cx),
1892            ..Default::default()
1893        };
1894
1895        for message in &self.messages {
1896            request.messages.extend(message.to_request());
1897        }
1898
1899        request.messages.push(LanguageModelRequestMessage {
1900            role: Role::User,
1901            content: vec![SUMMARIZE_THREAD_PROMPT.into()],
1902            cache: false,
1903            reasoning_details: None,
1904        });
1905        self.pending_title_generation = Some(cx.spawn(async move |this, cx| {
1906            let mut title = String::new();
1907
1908            let generate = async {
1909                let mut messages = model.stream_completion(request, cx).await?;
1910                while let Some(event) = messages.next().await {
1911                    let event = event?;
1912                    let text = match event {
1913                        LanguageModelCompletionEvent::Text(text) => text,
1914                        LanguageModelCompletionEvent::UsageUpdated { amount, limit } => {
1915                            this.update(cx, |thread, cx| {
1916                                thread.update_model_request_usage(amount, limit, cx);
1917                            })?;
1918                            continue;
1919                        }
1920                        _ => continue,
1921                    };
1922
1923                    let mut lines = text.lines();
1924                    title.extend(lines.next());
1925
1926                    // Stop if the LLM generated multiple lines.
1927                    if lines.next().is_some() {
1928                        break;
1929                    }
1930                }
1931                anyhow::Ok(())
1932            };
1933
1934            if generate.await.context("failed to generate title").is_ok() {
1935                _ = this.update(cx, |this, cx| this.set_title(title.into(), cx));
1936            }
1937            _ = this.update(cx, |this, _| this.pending_title_generation = None);
1938        }));
1939    }
1940
1941    pub fn set_title(&mut self, title: SharedString, cx: &mut Context<Self>) {
1942        self.pending_title_generation = None;
1943        if Some(&title) != self.title.as_ref() {
1944            self.title = Some(title);
1945            cx.emit(TitleUpdated);
1946            cx.notify();
1947        }
1948    }
1949
1950    fn clear_summary(&mut self) {
1951        self.summary = None;
1952        self.pending_summary_generation = None;
1953    }
1954
1955    fn last_user_message(&self) -> Option<&UserMessage> {
1956        self.messages
1957            .iter()
1958            .rev()
1959            .find_map(|message| match message {
1960                Message::User(user_message) => Some(user_message),
1961                Message::Agent(_) => None,
1962                Message::Resume => None,
1963            })
1964    }
1965
1966    fn pending_message(&mut self) -> &mut AgentMessage {
1967        self.pending_message.get_or_insert_default()
1968    }
1969
1970    fn flush_pending_message(&mut self, cx: &mut Context<Self>) {
1971        let Some(mut message) = self.pending_message.take() else {
1972            return;
1973        };
1974
1975        if message.content.is_empty() {
1976            return;
1977        }
1978
1979        for content in &message.content {
1980            let AgentMessageContent::ToolUse(tool_use) = content else {
1981                continue;
1982            };
1983
1984            if !message.tool_results.contains_key(&tool_use.id) {
1985                message.tool_results.insert(
1986                    tool_use.id.clone(),
1987                    LanguageModelToolResult {
1988                        tool_use_id: tool_use.id.clone(),
1989                        tool_name: tool_use.name.clone(),
1990                        is_error: true,
1991                        content: LanguageModelToolResultContent::Text(TOOL_CANCELED_MESSAGE.into()),
1992                        output: None,
1993                    },
1994                );
1995            }
1996        }
1997
1998        self.messages.push(Message::Agent(message));
1999        self.updated_at = Utc::now();
2000        self.clear_summary();
2001        cx.notify()
2002    }
2003
2004    pub(crate) fn build_completion_request(
2005        &self,
2006        completion_intent: CompletionIntent,
2007        cx: &App,
2008    ) -> Result<LanguageModelRequest> {
2009        let model = self.model().context("No language model configured")?;
2010        let tools = if let Some(turn) = self.running_turn.as_ref() {
2011            turn.tools
2012                .iter()
2013                .filter_map(|(tool_name, tool)| {
2014                    log::trace!("Including tool: {}", tool_name);
2015                    Some(LanguageModelRequestTool {
2016                        name: tool_name.to_string(),
2017                        description: tool.description().to_string(),
2018                        input_schema: tool.input_schema(model.tool_input_format()).log_err()?,
2019                    })
2020                })
2021                .collect::<Vec<_>>()
2022        } else {
2023            Vec::new()
2024        };
2025
2026        log::debug!("Building completion request");
2027        log::debug!("Completion intent: {:?}", completion_intent);
2028        log::debug!("Completion mode: {:?}", self.completion_mode);
2029
2030        let available_tools: Vec<_> = self
2031            .running_turn
2032            .as_ref()
2033            .map(|turn| turn.tools.keys().cloned().collect())
2034            .unwrap_or_default();
2035
2036        log::debug!("Request includes {} tools", available_tools.len());
2037        let messages = self.build_request_messages(available_tools, cx);
2038        log::debug!("Request will include {} messages", messages.len());
2039
2040        let request = LanguageModelRequest {
2041            thread_id: Some(self.id.to_string()),
2042            prompt_id: Some(self.prompt_id.to_string()),
2043            intent: Some(completion_intent),
2044            mode: Some(self.completion_mode.into()),
2045            messages,
2046            tools,
2047            tool_choice: None,
2048            stop: Vec::new(),
2049            temperature: AgentSettings::temperature_for_model(model, cx),
2050            thinking_allowed: true,
2051        };
2052
2053        log::debug!("Completion request built successfully");
2054        Ok(request)
2055    }
2056
2057    fn enabled_tools(
2058        &self,
2059        profile: &AgentProfileSettings,
2060        model: &Arc<dyn LanguageModel>,
2061        cx: &App,
2062    ) -> BTreeMap<SharedString, Arc<dyn AnyAgentTool>> {
2063        fn truncate(tool_name: &SharedString) -> SharedString {
2064            if tool_name.len() > MAX_TOOL_NAME_LENGTH {
2065                let mut truncated = tool_name.to_string();
2066                truncated.truncate(MAX_TOOL_NAME_LENGTH);
2067                truncated.into()
2068            } else {
2069                tool_name.clone()
2070            }
2071        }
2072
2073        let mut tools = self
2074            .tools
2075            .iter()
2076            .filter_map(|(tool_name, tool)| {
2077                if tool.supports_provider(&model.provider_id())
2078                    && profile.is_tool_enabled(tool_name)
2079                {
2080                    Some((truncate(tool_name), tool.clone()))
2081                } else {
2082                    None
2083                }
2084            })
2085            .collect::<BTreeMap<_, _>>();
2086
2087        let mut context_server_tools = Vec::new();
2088        let mut seen_tools = tools.keys().cloned().collect::<HashSet<_>>();
2089        let mut duplicate_tool_names = HashSet::default();
2090        for (server_id, server_tools) in self.context_server_registry.read(cx).servers() {
2091            for (tool_name, tool) in server_tools {
2092                if profile.is_context_server_tool_enabled(&server_id.0, &tool_name) {
2093                    let tool_name = truncate(tool_name);
2094                    if !seen_tools.insert(tool_name.clone()) {
2095                        duplicate_tool_names.insert(tool_name.clone());
2096                    }
2097                    context_server_tools.push((server_id.clone(), tool_name, tool.clone()));
2098                }
2099            }
2100        }
2101
2102        // When there are duplicate tool names, disambiguate by prefixing them
2103        // with the server ID. In the rare case there isn't enough space for the
2104        // disambiguated tool name, keep only the last tool with this name.
2105        for (server_id, tool_name, tool) in context_server_tools {
2106            if duplicate_tool_names.contains(&tool_name) {
2107                let available = MAX_TOOL_NAME_LENGTH.saturating_sub(tool_name.len());
2108                if available >= 2 {
2109                    let mut disambiguated = server_id.0.to_string();
2110                    disambiguated.truncate(available - 1);
2111                    disambiguated.push('_');
2112                    disambiguated.push_str(&tool_name);
2113                    tools.insert(disambiguated.into(), tool.clone());
2114                } else {
2115                    tools.insert(tool_name, tool.clone());
2116                }
2117            } else {
2118                tools.insert(tool_name, tool.clone());
2119            }
2120        }
2121
2122        tools
2123    }
2124
2125    fn tool(&self, name: &str) -> Option<Arc<dyn AnyAgentTool>> {
2126        self.running_turn.as_ref()?.tools.get(name).cloned()
2127    }
2128
2129    pub fn has_tool(&self, name: &str) -> bool {
2130        self.running_turn
2131            .as_ref()
2132            .is_some_and(|turn| turn.tools.contains_key(name))
2133    }
2134
2135    fn build_request_messages(
2136        &self,
2137        available_tools: Vec<SharedString>,
2138        cx: &App,
2139    ) -> Vec<LanguageModelRequestMessage> {
2140        log::trace!(
2141            "Building request messages from {} thread messages",
2142            self.messages.len()
2143        );
2144
2145        let system_prompt = SystemPromptTemplate {
2146            project: self.project_context.read(cx),
2147            available_tools,
2148            model_name: self.model.as_ref().map(|m| m.name().0.to_string()),
2149        }
2150        .render(&self.templates)
2151        .context("failed to build system prompt")
2152        .expect("Invalid template");
2153        let mut messages = vec![LanguageModelRequestMessage {
2154            role: Role::System,
2155            content: vec![system_prompt.into()],
2156            cache: false,
2157            reasoning_details: None,
2158        }];
2159        for message in &self.messages {
2160            messages.extend(message.to_request());
2161        }
2162
2163        if let Some(last_message) = messages.last_mut() {
2164            last_message.cache = true;
2165        }
2166
2167        if let Some(message) = self.pending_message.as_ref() {
2168            messages.extend(message.to_request());
2169        }
2170
2171        messages
2172    }
2173
2174    pub fn to_markdown(&self) -> String {
2175        let mut markdown = String::new();
2176        for (ix, message) in self.messages.iter().enumerate() {
2177            if ix > 0 {
2178                markdown.push('\n');
2179            }
2180            markdown.push_str(&message.to_markdown());
2181        }
2182
2183        if let Some(message) = self.pending_message.as_ref() {
2184            markdown.push('\n');
2185            markdown.push_str(&message.to_markdown());
2186        }
2187
2188        markdown
2189    }
2190
2191    fn advance_prompt_id(&mut self) {
2192        self.prompt_id = PromptId::new();
2193    }
2194
2195    fn retry_strategy_for(error: &LanguageModelCompletionError) -> Option<RetryStrategy> {
2196        use LanguageModelCompletionError::*;
2197        use http_client::StatusCode;
2198
2199        // General strategy here:
2200        // - If retrying won't help (e.g. invalid API key or payload too large), return None so we don't retry at all.
2201        // - If it's a time-based issue (e.g. server overloaded, rate limit exceeded), retry up to 4 times with exponential backoff.
2202        // - If it's an issue that *might* be fixed by retrying (e.g. internal server error), retry up to 3 times.
2203        match error {
2204            HttpResponseError {
2205                status_code: StatusCode::TOO_MANY_REQUESTS,
2206                ..
2207            } => Some(RetryStrategy::ExponentialBackoff {
2208                initial_delay: BASE_RETRY_DELAY,
2209                max_attempts: MAX_RETRY_ATTEMPTS,
2210            }),
2211            ServerOverloaded { retry_after, .. } | RateLimitExceeded { retry_after, .. } => {
2212                Some(RetryStrategy::Fixed {
2213                    delay: retry_after.unwrap_or(BASE_RETRY_DELAY),
2214                    max_attempts: MAX_RETRY_ATTEMPTS,
2215                })
2216            }
2217            UpstreamProviderError {
2218                status,
2219                retry_after,
2220                ..
2221            } => match *status {
2222                StatusCode::TOO_MANY_REQUESTS | StatusCode::SERVICE_UNAVAILABLE => {
2223                    Some(RetryStrategy::Fixed {
2224                        delay: retry_after.unwrap_or(BASE_RETRY_DELAY),
2225                        max_attempts: MAX_RETRY_ATTEMPTS,
2226                    })
2227                }
2228                StatusCode::INTERNAL_SERVER_ERROR => Some(RetryStrategy::Fixed {
2229                    delay: retry_after.unwrap_or(BASE_RETRY_DELAY),
2230                    // Internal Server Error could be anything, retry up to 3 times.
2231                    max_attempts: 3,
2232                }),
2233                status => {
2234                    // There is no StatusCode variant for the unofficial HTTP 529 ("The service is overloaded"),
2235                    // but we frequently get them in practice. See https://http.dev/529
2236                    if status.as_u16() == 529 {
2237                        Some(RetryStrategy::Fixed {
2238                            delay: retry_after.unwrap_or(BASE_RETRY_DELAY),
2239                            max_attempts: MAX_RETRY_ATTEMPTS,
2240                        })
2241                    } else {
2242                        Some(RetryStrategy::Fixed {
2243                            delay: retry_after.unwrap_or(BASE_RETRY_DELAY),
2244                            max_attempts: 2,
2245                        })
2246                    }
2247                }
2248            },
2249            ApiInternalServerError { .. } => Some(RetryStrategy::Fixed {
2250                delay: BASE_RETRY_DELAY,
2251                max_attempts: 3,
2252            }),
2253            ApiReadResponseError { .. }
2254            | HttpSend { .. }
2255            | DeserializeResponse { .. }
2256            | BadRequestFormat { .. } => Some(RetryStrategy::Fixed {
2257                delay: BASE_RETRY_DELAY,
2258                max_attempts: 3,
2259            }),
2260            // Retrying these errors definitely shouldn't help.
2261            HttpResponseError {
2262                status_code:
2263                    StatusCode::PAYLOAD_TOO_LARGE | StatusCode::FORBIDDEN | StatusCode::UNAUTHORIZED,
2264                ..
2265            }
2266            | AuthenticationError { .. }
2267            | PermissionError { .. }
2268            | NoApiKey { .. }
2269            | ApiEndpointNotFound { .. }
2270            | PromptTooLarge { .. } => None,
2271            // These errors might be transient, so retry them
2272            SerializeRequest { .. } | BuildRequestBody { .. } => Some(RetryStrategy::Fixed {
2273                delay: BASE_RETRY_DELAY,
2274                max_attempts: 1,
2275            }),
2276            // Retry all other 4xx and 5xx errors once.
2277            HttpResponseError { status_code, .. }
2278                if status_code.is_client_error() || status_code.is_server_error() =>
2279            {
2280                Some(RetryStrategy::Fixed {
2281                    delay: BASE_RETRY_DELAY,
2282                    max_attempts: 3,
2283                })
2284            }
2285            Other(err)
2286                if err.is::<language_model::PaymentRequiredError>()
2287                    || err.is::<language_model::ModelRequestLimitReachedError>() =>
2288            {
2289                // Retrying won't help for Payment Required or Model Request Limit errors (where
2290                // the user must upgrade to usage-based billing to get more requests, or else wait
2291                // for a significant amount of time for the request limit to reset).
2292                None
2293            }
2294            // Conservatively assume that any other errors are non-retryable
2295            HttpResponseError { .. } | Other(..) => Some(RetryStrategy::Fixed {
2296                delay: BASE_RETRY_DELAY,
2297                max_attempts: 2,
2298            }),
2299        }
2300    }
2301}
2302
2303struct RunningTurn {
2304    /// Holds the task that handles agent interaction until the end of the turn.
2305    /// Survives across multiple requests as the model performs tool calls and
2306    /// we run tools, report their results.
2307    _task: Task<()>,
2308    /// The current event stream for the running turn. Used to report a final
2309    /// cancellation event if we cancel the turn.
2310    event_stream: ThreadEventStream,
2311    /// The tools that were enabled for this turn.
2312    tools: BTreeMap<SharedString, Arc<dyn AnyAgentTool>>,
2313    /// Sender to signal tool cancellation. When cancel is called, this is
2314    /// set to true so all tools can detect user-initiated cancellation.
2315    cancellation_tx: watch::Sender<bool>,
2316}
2317
2318impl RunningTurn {
2319    fn cancel(mut self) -> Task<()> {
2320        log::debug!("Cancelling in progress turn");
2321        self.cancellation_tx.send(true).ok();
2322        self.event_stream.send_canceled();
2323        self._task
2324    }
2325}
2326
2327pub struct TokenUsageUpdated(pub Option<acp_thread::TokenUsage>);
2328
2329impl EventEmitter<TokenUsageUpdated> for Thread {}
2330
2331pub struct TitleUpdated;
2332
2333impl EventEmitter<TitleUpdated> for Thread {}
2334
2335pub trait AgentTool
2336where
2337    Self: 'static + Sized,
2338{
2339    type Input: for<'de> Deserialize<'de> + Serialize + JsonSchema;
2340    type Output: for<'de> Deserialize<'de> + Serialize + Into<LanguageModelToolResultContent>;
2341
2342    fn name() -> &'static str;
2343
2344    fn description() -> SharedString {
2345        let schema = schemars::schema_for!(Self::Input);
2346        SharedString::new(
2347            schema
2348                .get("description")
2349                .and_then(|description| description.as_str())
2350                .unwrap_or_default(),
2351        )
2352    }
2353
2354    fn kind() -> acp::ToolKind;
2355
2356    /// The initial tool title to display. Can be updated during the tool run.
2357    fn initial_title(
2358        &self,
2359        input: Result<Self::Input, serde_json::Value>,
2360        cx: &mut App,
2361    ) -> SharedString;
2362
2363    /// Returns the JSON schema that describes the tool's input.
2364    fn input_schema(format: LanguageModelToolSchemaFormat) -> Schema {
2365        language_model::tool_schema::root_schema_for::<Self::Input>(format)
2366    }
2367
2368    /// Some tools rely on a provider for the underlying billing or other reasons.
2369    /// Allow the tool to check if they are compatible, or should be filtered out.
2370    fn supports_provider(_provider: &LanguageModelProviderId) -> bool {
2371        true
2372    }
2373
2374    /// Runs the tool with the provided input.
2375    fn run(
2376        self: Arc<Self>,
2377        input: Self::Input,
2378        event_stream: ToolCallEventStream,
2379        cx: &mut App,
2380    ) -> Task<Result<Self::Output>>;
2381
2382    /// Emits events for a previous execution of the tool.
2383    fn replay(
2384        &self,
2385        _input: Self::Input,
2386        _output: Self::Output,
2387        _event_stream: ToolCallEventStream,
2388        _cx: &mut App,
2389    ) -> Result<()> {
2390        Ok(())
2391    }
2392
2393    fn erase(self) -> Arc<dyn AnyAgentTool> {
2394        Arc::new(Erased(Arc::new(self)))
2395    }
2396}
2397
2398pub struct Erased<T>(T);
2399
2400pub struct AgentToolOutput {
2401    pub llm_output: LanguageModelToolResultContent,
2402    pub raw_output: serde_json::Value,
2403}
2404
2405pub trait AnyAgentTool {
2406    fn name(&self) -> SharedString;
2407    fn description(&self) -> SharedString;
2408    fn kind(&self) -> acp::ToolKind;
2409    fn initial_title(&self, input: serde_json::Value, _cx: &mut App) -> SharedString;
2410    fn input_schema(&self, format: LanguageModelToolSchemaFormat) -> Result<serde_json::Value>;
2411    fn supports_provider(&self, _provider: &LanguageModelProviderId) -> bool {
2412        true
2413    }
2414    fn run(
2415        self: Arc<Self>,
2416        input: serde_json::Value,
2417        event_stream: ToolCallEventStream,
2418        cx: &mut App,
2419    ) -> Task<Result<AgentToolOutput>>;
2420    fn replay(
2421        &self,
2422        input: serde_json::Value,
2423        output: serde_json::Value,
2424        event_stream: ToolCallEventStream,
2425        cx: &mut App,
2426    ) -> Result<()>;
2427}
2428
2429impl<T> AnyAgentTool for Erased<Arc<T>>
2430where
2431    T: AgentTool,
2432{
2433    fn name(&self) -> SharedString {
2434        T::name().into()
2435    }
2436
2437    fn description(&self) -> SharedString {
2438        T::description()
2439    }
2440
2441    fn kind(&self) -> agent_client_protocol::ToolKind {
2442        T::kind()
2443    }
2444
2445    fn initial_title(&self, input: serde_json::Value, _cx: &mut App) -> SharedString {
2446        let parsed_input = serde_json::from_value(input.clone()).map_err(|_| input);
2447        self.0.initial_title(parsed_input, _cx)
2448    }
2449
2450    fn input_schema(&self, format: LanguageModelToolSchemaFormat) -> Result<serde_json::Value> {
2451        let mut json = serde_json::to_value(T::input_schema(format))?;
2452        language_model::tool_schema::adapt_schema_to_format(&mut json, format)?;
2453        Ok(json)
2454    }
2455
2456    fn supports_provider(&self, provider: &LanguageModelProviderId) -> bool {
2457        T::supports_provider(provider)
2458    }
2459
2460    fn run(
2461        self: Arc<Self>,
2462        input: serde_json::Value,
2463        event_stream: ToolCallEventStream,
2464        cx: &mut App,
2465    ) -> Task<Result<AgentToolOutput>> {
2466        cx.spawn(async move |cx| {
2467            let input = serde_json::from_value(input)?;
2468            let output = cx
2469                .update(|cx| self.0.clone().run(input, event_stream, cx))
2470                .await?;
2471            let raw_output = serde_json::to_value(&output)?;
2472            Ok(AgentToolOutput {
2473                llm_output: output.into(),
2474                raw_output,
2475            })
2476        })
2477    }
2478
2479    fn replay(
2480        &self,
2481        input: serde_json::Value,
2482        output: serde_json::Value,
2483        event_stream: ToolCallEventStream,
2484        cx: &mut App,
2485    ) -> Result<()> {
2486        let input = serde_json::from_value(input)?;
2487        let output = serde_json::from_value(output)?;
2488        self.0.replay(input, output, event_stream, cx)
2489    }
2490}
2491
2492#[derive(Clone)]
2493struct ThreadEventStream(mpsc::UnboundedSender<Result<ThreadEvent>>);
2494
2495impl ThreadEventStream {
2496    fn send_user_message(&self, message: &UserMessage) {
2497        self.0
2498            .unbounded_send(Ok(ThreadEvent::UserMessage(message.clone())))
2499            .ok();
2500    }
2501
2502    fn send_text(&self, text: &str) {
2503        self.0
2504            .unbounded_send(Ok(ThreadEvent::AgentText(text.to_string())))
2505            .ok();
2506    }
2507
2508    fn send_thinking(&self, text: &str) {
2509        self.0
2510            .unbounded_send(Ok(ThreadEvent::AgentThinking(text.to_string())))
2511            .ok();
2512    }
2513
2514    fn send_tool_call(
2515        &self,
2516        id: &LanguageModelToolUseId,
2517        tool_name: &str,
2518        title: SharedString,
2519        kind: acp::ToolKind,
2520        input: serde_json::Value,
2521    ) {
2522        self.0
2523            .unbounded_send(Ok(ThreadEvent::ToolCall(Self::initial_tool_call(
2524                id,
2525                tool_name,
2526                title.to_string(),
2527                kind,
2528                input,
2529            ))))
2530            .ok();
2531    }
2532
2533    fn initial_tool_call(
2534        id: &LanguageModelToolUseId,
2535        tool_name: &str,
2536        title: String,
2537        kind: acp::ToolKind,
2538        input: serde_json::Value,
2539    ) -> acp::ToolCall {
2540        acp::ToolCall::new(id.to_string(), title)
2541            .kind(kind)
2542            .raw_input(input)
2543            .meta(acp::Meta::from_iter([(
2544                "tool_name".into(),
2545                tool_name.into(),
2546            )]))
2547    }
2548
2549    fn update_tool_call_fields(
2550        &self,
2551        tool_use_id: &LanguageModelToolUseId,
2552        fields: acp::ToolCallUpdateFields,
2553    ) {
2554        self.0
2555            .unbounded_send(Ok(ThreadEvent::ToolCallUpdate(
2556                acp::ToolCallUpdate::new(tool_use_id.to_string(), fields).into(),
2557            )))
2558            .ok();
2559    }
2560
2561    fn send_retry(&self, status: acp_thread::RetryStatus) {
2562        self.0.unbounded_send(Ok(ThreadEvent::Retry(status))).ok();
2563    }
2564
2565    fn send_stop(&self, reason: acp::StopReason) {
2566        self.0.unbounded_send(Ok(ThreadEvent::Stop(reason))).ok();
2567    }
2568
2569    fn send_canceled(&self) {
2570        self.0
2571            .unbounded_send(Ok(ThreadEvent::Stop(acp::StopReason::Cancelled)))
2572            .ok();
2573    }
2574
2575    fn send_error(&self, error: impl Into<anyhow::Error>) {
2576        self.0.unbounded_send(Err(error.into())).ok();
2577    }
2578}
2579
2580#[derive(Clone)]
2581pub struct ToolCallEventStream {
2582    tool_use_id: LanguageModelToolUseId,
2583    stream: ThreadEventStream,
2584    fs: Option<Arc<dyn Fs>>,
2585    cancellation_rx: watch::Receiver<bool>,
2586}
2587
2588impl ToolCallEventStream {
2589    #[cfg(any(test, feature = "test-support"))]
2590    pub fn test() -> (Self, ToolCallEventStreamReceiver) {
2591        let (events_tx, events_rx) = mpsc::unbounded::<Result<ThreadEvent>>();
2592        let (_cancellation_tx, cancellation_rx) = watch::channel(false);
2593
2594        let stream = ToolCallEventStream::new(
2595            "test_id".into(),
2596            ThreadEventStream(events_tx),
2597            None,
2598            cancellation_rx,
2599        );
2600
2601        (stream, ToolCallEventStreamReceiver(events_rx))
2602    }
2603
2604    fn new(
2605        tool_use_id: LanguageModelToolUseId,
2606        stream: ThreadEventStream,
2607        fs: Option<Arc<dyn Fs>>,
2608        cancellation_rx: watch::Receiver<bool>,
2609    ) -> Self {
2610        Self {
2611            tool_use_id,
2612            stream,
2613            fs,
2614            cancellation_rx,
2615        }
2616    }
2617
2618    /// Returns a future that resolves when the user cancels the tool call.
2619    /// Tools should select on this alongside their main work to detect user cancellation.
2620    pub fn cancelled_by_user(&self) -> impl std::future::Future<Output = ()> + '_ {
2621        let mut rx = self.cancellation_rx.clone();
2622        async move {
2623            loop {
2624                if *rx.borrow() {
2625                    return;
2626                }
2627                if rx.changed().await.is_err() {
2628                    // Sender dropped, will never be cancelled
2629                    std::future::pending::<()>().await;
2630                }
2631            }
2632        }
2633    }
2634
2635    /// Returns true if the user has cancelled this tool call.
2636    /// This is useful for checking cancellation state after an operation completes,
2637    /// to determine if the completion was due to user cancellation.
2638    pub fn was_cancelled_by_user(&self) -> bool {
2639        *self.cancellation_rx.clone().borrow()
2640    }
2641
2642    pub fn update_fields(&self, fields: acp::ToolCallUpdateFields) {
2643        self.stream
2644            .update_tool_call_fields(&self.tool_use_id, fields);
2645    }
2646
2647    pub fn update_diff(&self, diff: Entity<acp_thread::Diff>) {
2648        self.stream
2649            .0
2650            .unbounded_send(Ok(ThreadEvent::ToolCallUpdate(
2651                acp_thread::ToolCallUpdateDiff {
2652                    id: acp::ToolCallId::new(self.tool_use_id.to_string()),
2653                    diff,
2654                }
2655                .into(),
2656            )))
2657            .ok();
2658    }
2659
2660    pub fn authorize(&self, title: impl Into<String>, cx: &mut App) -> Task<Result<()>> {
2661        if agent_settings::AgentSettings::get_global(cx).always_allow_tool_actions {
2662            return Task::ready(Ok(()));
2663        }
2664
2665        let (response_tx, response_rx) = oneshot::channel();
2666        self.stream
2667            .0
2668            .unbounded_send(Ok(ThreadEvent::ToolCallAuthorization(
2669                ToolCallAuthorization {
2670                    tool_call: acp::ToolCallUpdate::new(
2671                        self.tool_use_id.to_string(),
2672                        acp::ToolCallUpdateFields::new().title(title.into()),
2673                    ),
2674                    options: vec![
2675                        acp::PermissionOption::new(
2676                            acp::PermissionOptionId::new("always_allow"),
2677                            "Always Allow",
2678                            acp::PermissionOptionKind::AllowAlways,
2679                        ),
2680                        acp::PermissionOption::new(
2681                            acp::PermissionOptionId::new("allow"),
2682                            "Allow",
2683                            acp::PermissionOptionKind::AllowOnce,
2684                        ),
2685                        acp::PermissionOption::new(
2686                            acp::PermissionOptionId::new("deny"),
2687                            "Deny",
2688                            acp::PermissionOptionKind::RejectOnce,
2689                        ),
2690                    ],
2691                    response: response_tx,
2692                },
2693            )))
2694            .ok();
2695        let fs = self.fs.clone();
2696        cx.spawn(async move |cx| match response_rx.await?.0.as_ref() {
2697            "always_allow" => {
2698                if let Some(fs) = fs.clone() {
2699                    cx.update(|cx| {
2700                        update_settings_file(fs, cx, |settings, _| {
2701                            settings
2702                                .agent
2703                                .get_or_insert_default()
2704                                .set_always_allow_tool_actions(true);
2705                        });
2706                    });
2707                }
2708
2709                Ok(())
2710            }
2711            "allow" => Ok(()),
2712            _ => Err(anyhow!("Permission to run tool denied by user")),
2713        })
2714    }
2715}
2716
2717#[cfg(any(test, feature = "test-support"))]
2718pub struct ToolCallEventStreamReceiver(mpsc::UnboundedReceiver<Result<ThreadEvent>>);
2719
2720#[cfg(any(test, feature = "test-support"))]
2721impl ToolCallEventStreamReceiver {
2722    pub async fn expect_authorization(&mut self) -> ToolCallAuthorization {
2723        let event = self.0.next().await;
2724        if let Some(Ok(ThreadEvent::ToolCallAuthorization(auth))) = event {
2725            auth
2726        } else {
2727            panic!("Expected ToolCallAuthorization but got: {:?}", event);
2728        }
2729    }
2730
2731    pub async fn expect_update_fields(&mut self) -> acp::ToolCallUpdateFields {
2732        let event = self.0.next().await;
2733        if let Some(Ok(ThreadEvent::ToolCallUpdate(acp_thread::ToolCallUpdate::UpdateFields(
2734            update,
2735        )))) = event
2736        {
2737            update.fields
2738        } else {
2739            panic!("Expected update fields but got: {:?}", event);
2740        }
2741    }
2742
2743    pub async fn expect_diff(&mut self) -> Entity<acp_thread::Diff> {
2744        let event = self.0.next().await;
2745        if let Some(Ok(ThreadEvent::ToolCallUpdate(acp_thread::ToolCallUpdate::UpdateDiff(
2746            update,
2747        )))) = event
2748        {
2749            update.diff
2750        } else {
2751            panic!("Expected diff but got: {:?}", event);
2752        }
2753    }
2754
2755    pub async fn expect_terminal(&mut self) -> Entity<acp_thread::Terminal> {
2756        let event = self.0.next().await;
2757        if let Some(Ok(ThreadEvent::ToolCallUpdate(acp_thread::ToolCallUpdate::UpdateTerminal(
2758            update,
2759        )))) = event
2760        {
2761            update.terminal
2762        } else {
2763            panic!("Expected terminal but got: {:?}", event);
2764        }
2765    }
2766}
2767
2768#[cfg(any(test, feature = "test-support"))]
2769impl std::ops::Deref for ToolCallEventStreamReceiver {
2770    type Target = mpsc::UnboundedReceiver<Result<ThreadEvent>>;
2771
2772    fn deref(&self) -> &Self::Target {
2773        &self.0
2774    }
2775}
2776
2777#[cfg(any(test, feature = "test-support"))]
2778impl std::ops::DerefMut for ToolCallEventStreamReceiver {
2779    fn deref_mut(&mut self) -> &mut Self::Target {
2780        &mut self.0
2781    }
2782}
2783
2784impl From<&str> for UserMessageContent {
2785    fn from(text: &str) -> Self {
2786        Self::Text(text.into())
2787    }
2788}
2789
2790impl UserMessageContent {
2791    pub fn from_content_block(value: acp::ContentBlock, path_style: PathStyle) -> Self {
2792        match value {
2793            acp::ContentBlock::Text(text_content) => Self::Text(text_content.text),
2794            acp::ContentBlock::Image(image_content) => Self::Image(convert_image(image_content)),
2795            acp::ContentBlock::Audio(_) => {
2796                // TODO
2797                Self::Text("[audio]".to_string())
2798            }
2799            acp::ContentBlock::ResourceLink(resource_link) => {
2800                match MentionUri::parse(&resource_link.uri, path_style) {
2801                    Ok(uri) => Self::Mention {
2802                        uri,
2803                        content: String::new(),
2804                    },
2805                    Err(err) => {
2806                        log::error!("Failed to parse mention link: {}", err);
2807                        Self::Text(format!("[{}]({})", resource_link.name, resource_link.uri))
2808                    }
2809                }
2810            }
2811            acp::ContentBlock::Resource(resource) => match resource.resource {
2812                acp::EmbeddedResourceResource::TextResourceContents(resource) => {
2813                    match MentionUri::parse(&resource.uri, path_style) {
2814                        Ok(uri) => Self::Mention {
2815                            uri,
2816                            content: resource.text,
2817                        },
2818                        Err(err) => {
2819                            log::error!("Failed to parse mention link: {}", err);
2820                            Self::Text(
2821                                MarkdownCodeBlock {
2822                                    tag: &resource.uri,
2823                                    text: &resource.text,
2824                                }
2825                                .to_string(),
2826                            )
2827                        }
2828                    }
2829                }
2830                acp::EmbeddedResourceResource::BlobResourceContents(_) => {
2831                    // TODO
2832                    Self::Text("[blob]".to_string())
2833                }
2834                other => {
2835                    log::warn!("Unexpected content type: {:?}", other);
2836                    Self::Text("[unknown]".to_string())
2837                }
2838            },
2839            other => {
2840                log::warn!("Unexpected content type: {:?}", other);
2841                Self::Text("[unknown]".to_string())
2842            }
2843        }
2844    }
2845}
2846
2847impl From<UserMessageContent> for acp::ContentBlock {
2848    fn from(content: UserMessageContent) -> Self {
2849        match content {
2850            UserMessageContent::Text(text) => text.into(),
2851            UserMessageContent::Image(image) => {
2852                acp::ContentBlock::Image(acp::ImageContent::new(image.source, "image/png"))
2853            }
2854            UserMessageContent::Mention { uri, content } => acp::ContentBlock::Resource(
2855                acp::EmbeddedResource::new(acp::EmbeddedResourceResource::TextResourceContents(
2856                    acp::TextResourceContents::new(content, uri.to_uri().to_string()),
2857                )),
2858            ),
2859        }
2860    }
2861}
2862
2863fn convert_image(image_content: acp::ImageContent) -> LanguageModelImage {
2864    LanguageModelImage {
2865        source: image_content.data.into(),
2866        size: None,
2867    }
2868}