terminal_panel.rs

   1use std::{cmp, ops::ControlFlow, path::PathBuf, process::ExitStatus, sync::Arc, time::Duration};
   2
   3use crate::{
   4    TerminalView, default_working_directory,
   5    persistence::{
   6        SerializedItems, SerializedTerminalPanel, deserialize_terminal_panel, serialize_pane_group,
   7    },
   8};
   9use breadcrumbs::Breadcrumbs;
  10use collections::HashMap;
  11use db::kvp::KEY_VALUE_STORE;
  12use futures::{channel::oneshot, future::join_all};
  13use gpui::{
  14    Action, AnyView, App, AsyncApp, AsyncWindowContext, Context, Corner, Entity, EventEmitter,
  15    ExternalPaths, FocusHandle, Focusable, IntoElement, ParentElement, Pixels, Render, Styled,
  16    Task, WeakEntity, Window, actions,
  17};
  18use itertools::Itertools;
  19use project::{Fs, Project, ProjectEntryId};
  20use search::{BufferSearchBar, buffer_search::DivRegistrar};
  21use settings::{Settings, TerminalDockPosition};
  22use task::{RevealStrategy, RevealTarget, Shell, ShellBuilder, SpawnInTerminal, TaskId};
  23use terminal::{Terminal, terminal_settings::TerminalSettings};
  24use ui::{
  25    ButtonLike, Clickable, ContextMenu, FluentBuilder, PopoverMenu, SplitButton, Toggleable,
  26    Tooltip, prelude::*,
  27};
  28use util::{ResultExt, TryFutureExt};
  29use workspace::{
  30    ActivateNextPane, ActivatePane, ActivatePaneDown, ActivatePaneLeft, ActivatePaneRight,
  31    ActivatePaneUp, ActivatePreviousPane, DraggedSelection, DraggedTab, ItemId, MoveItemToPane,
  32    MoveItemToPaneInDirection, MovePaneDown, MovePaneLeft, MovePaneRight, MovePaneUp, NewTerminal,
  33    Pane, PaneGroup, SplitDirection, SplitDown, SplitLeft, SplitRight, SplitUp, SwapPaneDown,
  34    SwapPaneLeft, SwapPaneRight, SwapPaneUp, ToggleZoom, Workspace,
  35    dock::{DockPosition, Panel, PanelEvent, PanelHandle},
  36    item::SerializableItem,
  37    move_active_item, move_item, pane,
  38};
  39
  40use anyhow::{Result, anyhow};
  41use zed_actions::assistant::InlineAssist;
  42
  43const TERMINAL_PANEL_KEY: &str = "TerminalPanel";
  44
  45actions!(
  46    terminal_panel,
  47    [
  48        /// Toggles the terminal panel.
  49        Toggle,
  50        /// Toggles focus on the terminal panel.
  51        ToggleFocus
  52    ]
  53);
  54
  55pub fn init(cx: &mut App) {
  56    cx.observe_new(
  57        |workspace: &mut Workspace, _window, _: &mut Context<Workspace>| {
  58            workspace.register_action(TerminalPanel::new_terminal);
  59            workspace.register_action(TerminalPanel::open_terminal);
  60            workspace.register_action(|workspace, _: &ToggleFocus, window, cx| {
  61                if is_enabled_in_workspace(workspace, cx) {
  62                    workspace.toggle_panel_focus::<TerminalPanel>(window, cx);
  63                }
  64            });
  65            workspace.register_action(|workspace, _: &Toggle, window, cx| {
  66                if is_enabled_in_workspace(workspace, cx) {
  67                    if !workspace.toggle_panel_focus::<TerminalPanel>(window, cx) {
  68                        workspace.close_panel::<TerminalPanel>(window, cx);
  69                    }
  70                }
  71            });
  72        },
  73    )
  74    .detach();
  75}
  76
  77pub struct TerminalPanel {
  78    pub(crate) active_pane: Entity<Pane>,
  79    pub(crate) center: PaneGroup,
  80    fs: Arc<dyn Fs>,
  81    workspace: WeakEntity<Workspace>,
  82    pub(crate) width: Option<Pixels>,
  83    pub(crate) height: Option<Pixels>,
  84    pending_serialization: Task<Option<()>>,
  85    pending_terminals_to_add: usize,
  86    deferred_tasks: HashMap<TaskId, Task<()>>,
  87    assistant_enabled: bool,
  88    assistant_tab_bar_button: Option<AnyView>,
  89    active: bool,
  90}
  91
  92impl TerminalPanel {
  93    pub fn new(workspace: &Workspace, window: &mut Window, cx: &mut Context<Self>) -> Self {
  94        let project = workspace.project();
  95        let pane = new_terminal_pane(workspace.weak_handle(), project.clone(), false, window, cx);
  96        let center = PaneGroup::new(pane.clone());
  97        let terminal_panel = Self {
  98            center,
  99            active_pane: pane,
 100            fs: workspace.app_state().fs.clone(),
 101            workspace: workspace.weak_handle(),
 102            pending_serialization: Task::ready(None),
 103            width: None,
 104            height: None,
 105            pending_terminals_to_add: 0,
 106            deferred_tasks: HashMap::default(),
 107            assistant_enabled: false,
 108            assistant_tab_bar_button: None,
 109            active: false,
 110        };
 111        terminal_panel.apply_tab_bar_buttons(&terminal_panel.active_pane, cx);
 112        terminal_panel
 113    }
 114
 115    pub fn set_assistant_enabled(&mut self, enabled: bool, cx: &mut Context<Self>) {
 116        self.assistant_enabled = enabled;
 117        if enabled {
 118            let focus_handle = self
 119                .active_pane
 120                .read(cx)
 121                .active_item()
 122                .map(|item| item.item_focus_handle(cx))
 123                .unwrap_or(self.focus_handle(cx));
 124            self.assistant_tab_bar_button = Some(
 125                cx.new(move |_| InlineAssistTabBarButton { focus_handle })
 126                    .into(),
 127            );
 128        } else {
 129            self.assistant_tab_bar_button = None;
 130        }
 131        for pane in self.center.panes() {
 132            self.apply_tab_bar_buttons(pane, cx);
 133        }
 134    }
 135
 136    fn apply_tab_bar_buttons(&self, terminal_pane: &Entity<Pane>, cx: &mut Context<Self>) {
 137        let assistant_tab_bar_button = self.assistant_tab_bar_button.clone();
 138        terminal_pane.update(cx, |pane, cx| {
 139            pane.set_render_tab_bar_buttons(cx, move |pane, window, cx| {
 140                let split_context = pane
 141                    .active_item()
 142                    .and_then(|item| item.downcast::<TerminalView>())
 143                    .map(|terminal_view| terminal_view.read(cx).focus_handle.clone());
 144                if !pane.has_focus(window, cx) && !pane.context_menu_focused(window, cx) {
 145                    return (None, None);
 146                }
 147                let focus_handle = pane.focus_handle(cx);
 148                let right_children = h_flex()
 149                    .gap(DynamicSpacing::Base02.rems(cx))
 150                    .child(
 151                        PopoverMenu::new("terminal-tab-bar-popover-menu")
 152                            .trigger_with_tooltip(
 153                                IconButton::new("plus", IconName::Plus).icon_size(IconSize::Small),
 154                                Tooltip::text("New…"),
 155                            )
 156                            .anchor(Corner::TopRight)
 157                            .with_handle(pane.new_item_context_menu_handle.clone())
 158                            .menu(move |window, cx| {
 159                                let focus_handle = focus_handle.clone();
 160                                let menu = ContextMenu::build(window, cx, |menu, _, _| {
 161                                    menu.context(focus_handle.clone())
 162                                        .action(
 163                                            "New Terminal",
 164                                            workspace::NewTerminal.boxed_clone(),
 165                                        )
 166                                        // We want the focus to go back to terminal panel once task modal is dismissed,
 167                                        // hence we focus that first. Otherwise, we'd end up without a focused element, as
 168                                        // context menu will be gone the moment we spawn the modal.
 169                                        .action(
 170                                            "Spawn Task",
 171                                            zed_actions::Spawn::modal().boxed_clone(),
 172                                        )
 173                                });
 174
 175                                Some(menu)
 176                            }),
 177                    )
 178                    .children(assistant_tab_bar_button.clone())
 179                    .child(
 180                        PopoverMenu::new("terminal-pane-tab-bar-split")
 181                            .trigger_with_tooltip(
 182                                IconButton::new("terminal-pane-split", IconName::Split)
 183                                    .icon_size(IconSize::Small),
 184                                Tooltip::text("Split Pane"),
 185                            )
 186                            .anchor(Corner::TopRight)
 187                            .with_handle(pane.split_item_context_menu_handle.clone())
 188                            .menu({
 189                                move |window, cx| {
 190                                    ContextMenu::build(window, cx, |menu, _, _| {
 191                                        menu.when_some(
 192                                            split_context.clone(),
 193                                            |menu, split_context| menu.context(split_context),
 194                                        )
 195                                        .action("Split Right", SplitRight.boxed_clone())
 196                                        .action("Split Left", SplitLeft.boxed_clone())
 197                                        .action("Split Up", SplitUp.boxed_clone())
 198                                        .action("Split Down", SplitDown.boxed_clone())
 199                                    })
 200                                    .into()
 201                                }
 202                            }),
 203                    )
 204                    .child({
 205                        let zoomed = pane.is_zoomed();
 206                        IconButton::new("toggle_zoom", IconName::Maximize)
 207                            .icon_size(IconSize::Small)
 208                            .toggle_state(zoomed)
 209                            .selected_icon(IconName::Minimize)
 210                            .on_click(cx.listener(|pane, _, window, cx| {
 211                                pane.toggle_zoom(&workspace::ToggleZoom, window, cx);
 212                            }))
 213                            .tooltip(move |_window, cx| {
 214                                Tooltip::for_action(
 215                                    if zoomed { "Zoom Out" } else { "Zoom In" },
 216                                    &ToggleZoom,
 217                                    cx,
 218                                )
 219                            })
 220                    })
 221                    .into_any_element()
 222                    .into();
 223                (None, right_children)
 224            });
 225        });
 226    }
 227
 228    fn serialization_key(workspace: &Workspace) -> Option<String> {
 229        workspace
 230            .database_id()
 231            .map(|id| i64::from(id).to_string())
 232            .or(workspace.session_id())
 233            .map(|id| format!("{:?}-{:?}", TERMINAL_PANEL_KEY, id))
 234    }
 235
 236    pub async fn load(
 237        workspace: WeakEntity<Workspace>,
 238        mut cx: AsyncWindowContext,
 239    ) -> Result<Entity<Self>> {
 240        let mut terminal_panel = None;
 241
 242        if let Some((database_id, serialization_key)) = workspace
 243            .read_with(&cx, |workspace, _| {
 244                workspace
 245                    .database_id()
 246                    .zip(TerminalPanel::serialization_key(workspace))
 247            })
 248            .ok()
 249            .flatten()
 250            && let Some(serialized_panel) = cx
 251                .background_spawn(async move { KEY_VALUE_STORE.read_kvp(&serialization_key) })
 252                .await
 253                .log_err()
 254                .flatten()
 255                .map(|panel| serde_json::from_str::<SerializedTerminalPanel>(&panel))
 256                .transpose()
 257                .log_err()
 258                .flatten()
 259            && let Ok(serialized) = workspace
 260                .update_in(&mut cx, |workspace, window, cx| {
 261                    deserialize_terminal_panel(
 262                        workspace.weak_handle(),
 263                        workspace.project().clone(),
 264                        database_id,
 265                        serialized_panel,
 266                        window,
 267                        cx,
 268                    )
 269                })?
 270                .await
 271        {
 272            terminal_panel = Some(serialized);
 273        }
 274
 275        let terminal_panel = if let Some(panel) = terminal_panel {
 276            panel
 277        } else {
 278            workspace.update_in(&mut cx, |workspace, window, cx| {
 279                cx.new(|cx| TerminalPanel::new(workspace, window, cx))
 280            })?
 281        };
 282
 283        if let Some(workspace) = workspace.upgrade() {
 284            workspace
 285                .update(&mut cx, |workspace, _| {
 286                    workspace.set_terminal_provider(TerminalProvider(terminal_panel.clone()))
 287                })
 288                .ok();
 289        }
 290
 291        // Since panels/docks are loaded outside from the workspace, we cleanup here, instead of through the workspace.
 292        if let Some(workspace) = workspace.upgrade() {
 293            let cleanup_task = workspace.update_in(&mut cx, |workspace, window, cx| {
 294                let alive_item_ids = terminal_panel
 295                    .read(cx)
 296                    .center
 297                    .panes()
 298                    .into_iter()
 299                    .flat_map(|pane| pane.read(cx).items())
 300                    .map(|item| item.item_id().as_u64() as ItemId)
 301                    .collect();
 302                workspace.database_id().map(|workspace_id| {
 303                    TerminalView::cleanup(workspace_id, alive_item_ids, window, cx)
 304                })
 305            })?;
 306            if let Some(task) = cleanup_task {
 307                task.await.log_err();
 308            }
 309        }
 310
 311        if let Some(workspace) = workspace.upgrade() {
 312            let should_focus = workspace
 313                .update_in(&mut cx, |workspace, window, cx| {
 314                    workspace.active_item(cx).is_none()
 315                        && workspace
 316                            .is_dock_at_position_open(terminal_panel.position(window, cx), cx)
 317                })
 318                .unwrap_or(false);
 319
 320            if should_focus {
 321                terminal_panel
 322                    .update_in(&mut cx, |panel, window, cx| {
 323                        panel.active_pane.update(cx, |pane, cx| {
 324                            pane.focus_active_item(window, cx);
 325                        });
 326                    })
 327                    .ok();
 328            }
 329        }
 330        Ok(terminal_panel)
 331    }
 332
 333    fn handle_pane_event(
 334        &mut self,
 335        pane: &Entity<Pane>,
 336        event: &pane::Event,
 337        window: &mut Window,
 338        cx: &mut Context<Self>,
 339    ) {
 340        match event {
 341            pane::Event::ActivateItem { .. } => self.serialize(cx),
 342            pane::Event::RemovedItem { .. } => self.serialize(cx),
 343            pane::Event::Remove { focus_on_pane } => {
 344                let pane_count_before_removal = self.center.panes().len();
 345                let _removal_result = self.center.remove(pane, cx);
 346                if pane_count_before_removal == 1 {
 347                    self.center.first_pane().update(cx, |pane, cx| {
 348                        pane.set_zoomed(false, cx);
 349                    });
 350                    cx.emit(PanelEvent::Close);
 351                } else if let Some(focus_on_pane) =
 352                    focus_on_pane.as_ref().or_else(|| self.center.panes().pop())
 353                {
 354                    focus_on_pane.focus_handle(cx).focus(window);
 355                }
 356            }
 357            pane::Event::ZoomIn => {
 358                for pane in self.center.panes() {
 359                    pane.update(cx, |pane, cx| {
 360                        pane.set_zoomed(true, cx);
 361                    })
 362                }
 363                cx.emit(PanelEvent::ZoomIn);
 364                cx.notify();
 365            }
 366            pane::Event::ZoomOut => {
 367                for pane in self.center.panes() {
 368                    pane.update(cx, |pane, cx| {
 369                        pane.set_zoomed(false, cx);
 370                    })
 371                }
 372                cx.emit(PanelEvent::ZoomOut);
 373                cx.notify();
 374            }
 375            pane::Event::AddItem { item } => {
 376                if let Some(workspace) = self.workspace.upgrade() {
 377                    workspace.update(cx, |workspace, cx| {
 378                        item.added_to_pane(workspace, pane.clone(), window, cx)
 379                    })
 380                }
 381                self.serialize(cx);
 382            }
 383            &pane::Event::Split {
 384                direction,
 385                clone_active_item,
 386            } => {
 387                if clone_active_item {
 388                    let fut = self.new_pane_with_cloned_active_terminal(window, cx);
 389                    let pane = pane.clone();
 390                    cx.spawn_in(window, async move |panel, cx| {
 391                        let Some(new_pane) = fut.await else {
 392                            return;
 393                        };
 394                        panel
 395                            .update_in(cx, |panel, window, cx| {
 396                                panel
 397                                    .center
 398                                    .split(&pane, &new_pane, direction, cx)
 399                                    .log_err();
 400                                window.focus(&new_pane.focus_handle(cx));
 401                            })
 402                            .ok();
 403                    })
 404                    .detach();
 405                } else {
 406                    let Some(item) = pane.update(cx, |pane, cx| pane.take_active_item(window, cx))
 407                    else {
 408                        return;
 409                    };
 410                    let Ok(project) = self
 411                        .workspace
 412                        .update(cx, |workspace, _| workspace.project().clone())
 413                    else {
 414                        return;
 415                    };
 416                    let new_pane =
 417                        new_terminal_pane(self.workspace.clone(), project, false, window, cx);
 418                    new_pane.update(cx, |pane, cx| {
 419                        pane.add_item(item, true, true, None, window, cx);
 420                    });
 421                    self.center.split(&pane, &new_pane, direction, cx).log_err();
 422                    window.focus(&new_pane.focus_handle(cx));
 423                }
 424            }
 425            pane::Event::Focus => {
 426                self.active_pane = pane.clone();
 427            }
 428            pane::Event::ItemPinned | pane::Event::ItemUnpinned => {
 429                self.serialize(cx);
 430            }
 431
 432            _ => {}
 433        }
 434    }
 435
 436    fn new_pane_with_cloned_active_terminal(
 437        &mut self,
 438        window: &mut Window,
 439        cx: &mut Context<Self>,
 440    ) -> Task<Option<Entity<Pane>>> {
 441        let Some(workspace) = self.workspace.upgrade() else {
 442            return Task::ready(None);
 443        };
 444        let workspace = workspace.read(cx);
 445        let database_id = workspace.database_id();
 446        let weak_workspace = self.workspace.clone();
 447        let project = workspace.project().clone();
 448        let active_pane = &self.active_pane;
 449        let terminal_view = active_pane
 450            .read(cx)
 451            .active_item()
 452            .and_then(|item| item.downcast::<TerminalView>());
 453        let working_directory = terminal_view
 454            .as_ref()
 455            .and_then(|terminal_view| {
 456                terminal_view
 457                    .read(cx)
 458                    .terminal()
 459                    .read(cx)
 460                    .working_directory()
 461            })
 462            .or_else(|| default_working_directory(workspace, cx));
 463        let is_zoomed = active_pane.read(cx).is_zoomed();
 464        cx.spawn_in(window, async move |panel, cx| {
 465            let terminal = project
 466                .update(cx, |project, cx| match terminal_view {
 467                    Some(view) => project.clone_terminal(
 468                        &view.read(cx).terminal.clone(),
 469                        cx,
 470                        working_directory,
 471                    ),
 472                    None => project.create_terminal_shell(working_directory, cx),
 473                })
 474                .ok()?
 475                .await
 476                .log_err()?;
 477
 478            panel
 479                .update_in(cx, move |terminal_panel, window, cx| {
 480                    let terminal_view = Box::new(cx.new(|cx| {
 481                        TerminalView::new(
 482                            terminal.clone(),
 483                            weak_workspace.clone(),
 484                            database_id,
 485                            project.downgrade(),
 486                            window,
 487                            cx,
 488                        )
 489                    }));
 490                    let pane = new_terminal_pane(weak_workspace, project, is_zoomed, window, cx);
 491                    terminal_panel.apply_tab_bar_buttons(&pane, cx);
 492                    pane.update(cx, |pane, cx| {
 493                        pane.add_item(terminal_view, true, true, None, window, cx);
 494                    });
 495                    Some(pane)
 496                })
 497                .ok()
 498                .flatten()
 499        })
 500    }
 501
 502    pub fn open_terminal(
 503        workspace: &mut Workspace,
 504        action: &workspace::OpenTerminal,
 505        window: &mut Window,
 506        cx: &mut Context<Workspace>,
 507    ) {
 508        let Some(terminal_panel) = workspace.panel::<Self>(cx) else {
 509            return;
 510        };
 511
 512        terminal_panel
 513            .update(cx, |panel, cx| {
 514                panel.add_terminal_shell(
 515                    Some(action.working_directory.clone()),
 516                    RevealStrategy::Always,
 517                    window,
 518                    cx,
 519                )
 520            })
 521            .detach_and_log_err(cx);
 522    }
 523
 524    pub fn spawn_task(
 525        &mut self,
 526        task: &SpawnInTerminal,
 527        window: &mut Window,
 528        cx: &mut Context<Self>,
 529    ) -> Task<Result<WeakEntity<Terminal>>> {
 530        let Some(workspace) = self.workspace.upgrade() else {
 531            return Task::ready(Err(anyhow!("failed to read workspace")));
 532        };
 533
 534        let project = workspace.read(cx).project().read(cx);
 535
 536        if project.is_via_collab() {
 537            return Task::ready(Err(anyhow!("cannot spawn tasks as a guest")));
 538        }
 539
 540        let remote_client = project.remote_client();
 541        let is_windows = project.path_style(cx).is_windows();
 542        let remote_shell = remote_client
 543            .as_ref()
 544            .and_then(|remote_client| remote_client.read(cx).shell());
 545
 546        let shell = if let Some(remote_shell) = remote_shell
 547            && task.shell == Shell::System
 548        {
 549            Shell::Program(remote_shell)
 550        } else {
 551            task.shell.clone()
 552        };
 553
 554        let builder = ShellBuilder::new(&shell, is_windows);
 555        let command_label = builder.command_label(task.command.as_deref().unwrap_or(""));
 556        let (command, args) = builder.build_no_quote(task.command.clone(), &task.args);
 557
 558        let task = SpawnInTerminal {
 559            command_label,
 560            command: Some(command),
 561            args,
 562            ..task.clone()
 563        };
 564
 565        if task.allow_concurrent_runs && task.use_new_terminal {
 566            return self.spawn_in_new_terminal(task, window, cx);
 567        }
 568
 569        let mut terminals_for_task = self.terminals_for_task(&task.full_label, cx);
 570        let Some(existing) = terminals_for_task.pop() else {
 571            return self.spawn_in_new_terminal(task, window, cx);
 572        };
 573
 574        let (existing_item_index, task_pane, existing_terminal) = existing;
 575        if task.allow_concurrent_runs {
 576            return self.replace_terminal(
 577                task,
 578                task_pane,
 579                existing_item_index,
 580                existing_terminal,
 581                window,
 582                cx,
 583            );
 584        }
 585
 586        let (tx, rx) = oneshot::channel();
 587
 588        self.deferred_tasks.insert(
 589            task.id.clone(),
 590            cx.spawn_in(window, async move |terminal_panel, cx| {
 591                wait_for_terminals_tasks(terminals_for_task, cx).await;
 592                let task = terminal_panel.update_in(cx, |terminal_panel, window, cx| {
 593                    if task.use_new_terminal {
 594                        terminal_panel.spawn_in_new_terminal(task, window, cx)
 595                    } else {
 596                        terminal_panel.replace_terminal(
 597                            task,
 598                            task_pane,
 599                            existing_item_index,
 600                            existing_terminal,
 601                            window,
 602                            cx,
 603                        )
 604                    }
 605                });
 606                if let Ok(task) = task {
 607                    tx.send(task.await).ok();
 608                }
 609            }),
 610        );
 611
 612        cx.spawn(async move |_, _| rx.await?)
 613    }
 614
 615    fn spawn_in_new_terminal(
 616        &mut self,
 617        spawn_task: SpawnInTerminal,
 618        window: &mut Window,
 619        cx: &mut Context<Self>,
 620    ) -> Task<Result<WeakEntity<Terminal>>> {
 621        let reveal = spawn_task.reveal;
 622        let reveal_target = spawn_task.reveal_target;
 623        match reveal_target {
 624            RevealTarget::Center => self
 625                .workspace
 626                .update(cx, |workspace, cx| {
 627                    Self::add_center_terminal(workspace, window, cx, |project, cx| {
 628                        project.create_terminal_task(spawn_task, cx)
 629                    })
 630                })
 631                .unwrap_or_else(|e| Task::ready(Err(e))),
 632            RevealTarget::Dock => self.add_terminal_task(spawn_task, reveal, window, cx),
 633        }
 634    }
 635
 636    /// Create a new Terminal in the current working directory or the user's home directory
 637    fn new_terminal(
 638        workspace: &mut Workspace,
 639        _: &workspace::NewTerminal,
 640        window: &mut Window,
 641        cx: &mut Context<Workspace>,
 642    ) {
 643        let Some(terminal_panel) = workspace.panel::<Self>(cx) else {
 644            return;
 645        };
 646
 647        terminal_panel
 648            .update(cx, |this, cx| {
 649                this.add_terminal_shell(
 650                    default_working_directory(workspace, cx),
 651                    RevealStrategy::Always,
 652                    window,
 653                    cx,
 654                )
 655            })
 656            .detach_and_log_err(cx);
 657    }
 658
 659    fn terminals_for_task(
 660        &self,
 661        label: &str,
 662        cx: &mut App,
 663    ) -> Vec<(usize, Entity<Pane>, Entity<TerminalView>)> {
 664        let Some(workspace) = self.workspace.upgrade() else {
 665            return Vec::new();
 666        };
 667
 668        let pane_terminal_views = |pane: Entity<Pane>| {
 669            pane.read(cx)
 670                .items()
 671                .enumerate()
 672                .filter_map(|(index, item)| Some((index, item.act_as::<TerminalView>(cx)?)))
 673                .filter_map(|(index, terminal_view)| {
 674                    let task_state = terminal_view.read(cx).terminal().read(cx).task()?;
 675                    if &task_state.spawned_task.full_label == label {
 676                        Some((index, terminal_view))
 677                    } else {
 678                        None
 679                    }
 680                })
 681                .map(move |(index, terminal_view)| (index, pane.clone(), terminal_view))
 682        };
 683
 684        self.center
 685            .panes()
 686            .into_iter()
 687            .cloned()
 688            .flat_map(pane_terminal_views)
 689            .chain(
 690                workspace
 691                    .read(cx)
 692                    .panes()
 693                    .iter()
 694                    .cloned()
 695                    .flat_map(pane_terminal_views),
 696            )
 697            .sorted_by_key(|(_, _, terminal_view)| terminal_view.entity_id())
 698            .collect()
 699    }
 700
 701    fn activate_terminal_view(
 702        &self,
 703        pane: &Entity<Pane>,
 704        item_index: usize,
 705        focus: bool,
 706        window: &mut Window,
 707        cx: &mut App,
 708    ) {
 709        pane.update(cx, |pane, cx| {
 710            pane.activate_item(item_index, true, focus, window, cx)
 711        })
 712    }
 713
 714    pub fn add_center_terminal(
 715        workspace: &mut Workspace,
 716        window: &mut Window,
 717        cx: &mut Context<Workspace>,
 718        create_terminal: impl FnOnce(
 719            &mut Project,
 720            &mut Context<Project>,
 721        ) -> Task<Result<Entity<Terminal>>>
 722        + 'static,
 723    ) -> Task<Result<WeakEntity<Terminal>>> {
 724        if !is_enabled_in_workspace(workspace, cx) {
 725            return Task::ready(Err(anyhow!(
 726                "terminal not yet supported for remote projects"
 727            )));
 728        }
 729        let project = workspace.project().downgrade();
 730        cx.spawn_in(window, async move |workspace, cx| {
 731            let terminal = project.update(cx, create_terminal)?.await?;
 732
 733            workspace.update_in(cx, |workspace, window, cx| {
 734                let terminal_view = cx.new(|cx| {
 735                    TerminalView::new(
 736                        terminal.clone(),
 737                        workspace.weak_handle(),
 738                        workspace.database_id(),
 739                        workspace.project().downgrade(),
 740                        window,
 741                        cx,
 742                    )
 743                });
 744                workspace.add_item_to_active_pane(Box::new(terminal_view), None, true, window, cx);
 745            })?;
 746            Ok(terminal.downgrade())
 747        })
 748    }
 749
 750    pub fn add_terminal_task(
 751        &mut self,
 752        task: SpawnInTerminal,
 753        reveal_strategy: RevealStrategy,
 754        window: &mut Window,
 755        cx: &mut Context<Self>,
 756    ) -> Task<Result<WeakEntity<Terminal>>> {
 757        let workspace = self.workspace.clone();
 758        cx.spawn_in(window, async move |terminal_panel, cx| {
 759            if workspace.update(cx, |workspace, cx| !is_enabled_in_workspace(workspace, cx))? {
 760                anyhow::bail!("terminal not yet supported for remote projects");
 761            }
 762            let pane = terminal_panel.update(cx, |terminal_panel, _| {
 763                terminal_panel.pending_terminals_to_add += 1;
 764                terminal_panel.active_pane.clone()
 765            })?;
 766            let project = workspace.read_with(cx, |workspace, _| workspace.project().clone())?;
 767            let terminal = project
 768                .update(cx, |project, cx| project.create_terminal_task(task, cx))?
 769                .await?;
 770            let result = workspace.update_in(cx, |workspace, window, cx| {
 771                let terminal_view = Box::new(cx.new(|cx| {
 772                    TerminalView::new(
 773                        terminal.clone(),
 774                        workspace.weak_handle(),
 775                        workspace.database_id(),
 776                        workspace.project().downgrade(),
 777                        window,
 778                        cx,
 779                    )
 780                }));
 781
 782                match reveal_strategy {
 783                    RevealStrategy::Always => {
 784                        workspace.focus_panel::<Self>(window, cx);
 785                    }
 786                    RevealStrategy::NoFocus => {
 787                        workspace.open_panel::<Self>(window, cx);
 788                    }
 789                    RevealStrategy::Never => {}
 790                }
 791
 792                pane.update(cx, |pane, cx| {
 793                    let focus = pane.has_focus(window, cx)
 794                        || matches!(reveal_strategy, RevealStrategy::Always);
 795                    pane.add_item(terminal_view, true, focus, None, window, cx);
 796                });
 797
 798                Ok(terminal.downgrade())
 799            })?;
 800            terminal_panel.update(cx, |terminal_panel, cx| {
 801                terminal_panel.pending_terminals_to_add =
 802                    terminal_panel.pending_terminals_to_add.saturating_sub(1);
 803                terminal_panel.serialize(cx)
 804            })?;
 805            result
 806        })
 807    }
 808
 809    fn add_terminal_shell(
 810        &mut self,
 811        cwd: Option<PathBuf>,
 812        reveal_strategy: RevealStrategy,
 813        window: &mut Window,
 814        cx: &mut Context<Self>,
 815    ) -> Task<Result<WeakEntity<Terminal>>> {
 816        let workspace = self.workspace.clone();
 817
 818        cx.spawn_in(window, async move |terminal_panel, cx| {
 819            if workspace.update(cx, |workspace, cx| !is_enabled_in_workspace(workspace, cx))? {
 820                anyhow::bail!("terminal not yet supported for collaborative projects");
 821            }
 822            let pane = terminal_panel.update(cx, |terminal_panel, _| {
 823                terminal_panel.pending_terminals_to_add += 1;
 824                terminal_panel.active_pane.clone()
 825            })?;
 826            let project = workspace.read_with(cx, |workspace, _| workspace.project().clone())?;
 827            let terminal = project
 828                .update(cx, |project, cx| project.create_terminal_shell(cwd, cx))?
 829                .await;
 830
 831            match terminal {
 832                Ok(terminal) => {
 833                    let result = workspace.update_in(cx, |workspace, window, cx| {
 834                        let terminal_view = Box::new(cx.new(|cx| {
 835                            TerminalView::new(
 836                                terminal.clone(),
 837                                workspace.weak_handle(),
 838                                workspace.database_id(),
 839                                workspace.project().downgrade(),
 840                                window,
 841                                cx,
 842                            )
 843                        }));
 844
 845                        match reveal_strategy {
 846                            RevealStrategy::Always => {
 847                                workspace.focus_panel::<Self>(window, cx);
 848                            }
 849                            RevealStrategy::NoFocus => {
 850                                workspace.open_panel::<Self>(window, cx);
 851                            }
 852                            RevealStrategy::Never => {}
 853                        }
 854
 855                        pane.update(cx, |pane, cx| {
 856                            let focus = pane.has_focus(window, cx)
 857                                || matches!(reveal_strategy, RevealStrategy::Always);
 858                            pane.add_item(terminal_view, true, focus, None, window, cx);
 859                        });
 860
 861                        Ok(terminal.downgrade())
 862                    })?;
 863                    terminal_panel.update(cx, |terminal_panel, cx| {
 864                        terminal_panel.pending_terminals_to_add =
 865                            terminal_panel.pending_terminals_to_add.saturating_sub(1);
 866                        terminal_panel.serialize(cx)
 867                    })?;
 868                    result
 869                }
 870                Err(error) => {
 871                    pane.update_in(cx, |pane, window, cx| {
 872                        let focus = pane.has_focus(window, cx);
 873                        let failed_to_spawn = cx.new(|cx| FailedToSpawnTerminal {
 874                            error: error.to_string(),
 875                            focus_handle: cx.focus_handle(),
 876                        });
 877                        pane.add_item(Box::new(failed_to_spawn), true, focus, None, window, cx);
 878                    })?;
 879                    Err(error)
 880                }
 881            }
 882        })
 883    }
 884
 885    fn serialize(&mut self, cx: &mut Context<Self>) {
 886        let height = self.height;
 887        let width = self.width;
 888        let Some(serialization_key) = self
 889            .workspace
 890            .read_with(cx, |workspace, _| {
 891                TerminalPanel::serialization_key(workspace)
 892            })
 893            .ok()
 894            .flatten()
 895        else {
 896            return;
 897        };
 898        self.pending_serialization = cx.spawn(async move |terminal_panel, cx| {
 899            cx.background_executor()
 900                .timer(Duration::from_millis(50))
 901                .await;
 902            let terminal_panel = terminal_panel.upgrade()?;
 903            let items = terminal_panel
 904                .update(cx, |terminal_panel, cx| {
 905                    SerializedItems::WithSplits(serialize_pane_group(
 906                        &terminal_panel.center,
 907                        &terminal_panel.active_pane,
 908                        cx,
 909                    ))
 910                })
 911                .ok()?;
 912            cx.background_spawn(
 913                async move {
 914                    KEY_VALUE_STORE
 915                        .write_kvp(
 916                            serialization_key,
 917                            serde_json::to_string(&SerializedTerminalPanel {
 918                                items,
 919                                active_item_id: None,
 920                                height,
 921                                width,
 922                            })?,
 923                        )
 924                        .await?;
 925                    anyhow::Ok(())
 926                }
 927                .log_err(),
 928            )
 929            .await;
 930            Some(())
 931        });
 932    }
 933
 934    fn replace_terminal(
 935        &self,
 936        spawn_task: SpawnInTerminal,
 937        task_pane: Entity<Pane>,
 938        terminal_item_index: usize,
 939        terminal_to_replace: Entity<TerminalView>,
 940        window: &mut Window,
 941        cx: &mut Context<Self>,
 942    ) -> Task<Result<WeakEntity<Terminal>>> {
 943        let reveal = spawn_task.reveal;
 944        let reveal_target = spawn_task.reveal_target;
 945        let task_workspace = self.workspace.clone();
 946        cx.spawn_in(window, async move |terminal_panel, cx| {
 947            let project = terminal_panel.update(cx, |this, cx| {
 948                this.workspace
 949                    .update(cx, |workspace, _| workspace.project().clone())
 950            })??;
 951            let new_terminal = project
 952                .update(cx, |project, cx| {
 953                    project.create_terminal_task(spawn_task, cx)
 954                })?
 955                .await?;
 956            terminal_to_replace.update_in(cx, |terminal_to_replace, window, cx| {
 957                terminal_to_replace.set_terminal(new_terminal.clone(), window, cx);
 958            })?;
 959
 960            match reveal {
 961                RevealStrategy::Always => match reveal_target {
 962                    RevealTarget::Center => {
 963                        task_workspace.update_in(cx, |workspace, window, cx| {
 964                            let did_activate = workspace.activate_item(
 965                                &terminal_to_replace,
 966                                true,
 967                                true,
 968                                window,
 969                                cx,
 970                            );
 971
 972                            anyhow::ensure!(did_activate, "Failed to retrieve terminal pane");
 973
 974                            anyhow::Ok(())
 975                        })??;
 976                    }
 977                    RevealTarget::Dock => {
 978                        terminal_panel.update_in(cx, |terminal_panel, window, cx| {
 979                            terminal_panel.activate_terminal_view(
 980                                &task_pane,
 981                                terminal_item_index,
 982                                true,
 983                                window,
 984                                cx,
 985                            )
 986                        })?;
 987
 988                        cx.spawn(async move |cx| {
 989                            task_workspace
 990                                .update_in(cx, |workspace, window, cx| {
 991                                    workspace.focus_panel::<Self>(window, cx)
 992                                })
 993                                .ok()
 994                        })
 995                        .detach();
 996                    }
 997                },
 998                RevealStrategy::NoFocus => match reveal_target {
 999                    RevealTarget::Center => {
1000                        task_workspace.update_in(cx, |workspace, window, cx| {
1001                            workspace.active_pane().focus_handle(cx).focus(window);
1002                        })?;
1003                    }
1004                    RevealTarget::Dock => {
1005                        terminal_panel.update_in(cx, |terminal_panel, window, cx| {
1006                            terminal_panel.activate_terminal_view(
1007                                &task_pane,
1008                                terminal_item_index,
1009                                false,
1010                                window,
1011                                cx,
1012                            )
1013                        })?;
1014
1015                        cx.spawn(async move |cx| {
1016                            task_workspace
1017                                .update_in(cx, |workspace, window, cx| {
1018                                    workspace.open_panel::<Self>(window, cx)
1019                                })
1020                                .ok()
1021                        })
1022                        .detach();
1023                    }
1024                },
1025                RevealStrategy::Never => {}
1026            }
1027
1028            Ok(new_terminal.downgrade())
1029        })
1030    }
1031
1032    fn has_no_terminals(&self, cx: &App) -> bool {
1033        self.active_pane.read(cx).items_len() == 0 && self.pending_terminals_to_add == 0
1034    }
1035
1036    pub fn assistant_enabled(&self) -> bool {
1037        self.assistant_enabled
1038    }
1039
1040    fn is_enabled(&self, cx: &App) -> bool {
1041        self.workspace
1042            .upgrade()
1043            .is_some_and(|workspace| is_enabled_in_workspace(workspace.read(cx), cx))
1044    }
1045
1046    fn activate_pane_in_direction(
1047        &mut self,
1048        direction: SplitDirection,
1049        window: &mut Window,
1050        cx: &mut Context<Self>,
1051    ) {
1052        if let Some(pane) = self
1053            .center
1054            .find_pane_in_direction(&self.active_pane, direction, cx)
1055        {
1056            window.focus(&pane.focus_handle(cx));
1057        } else {
1058            self.workspace
1059                .update(cx, |workspace, cx| {
1060                    workspace.activate_pane_in_direction(direction, window, cx)
1061                })
1062                .ok();
1063        }
1064    }
1065
1066    fn swap_pane_in_direction(&mut self, direction: SplitDirection, cx: &mut Context<Self>) {
1067        if let Some(to) = self
1068            .center
1069            .find_pane_in_direction(&self.active_pane, direction, cx)
1070            .cloned()
1071        {
1072            self.center.swap(&self.active_pane, &to, cx);
1073            cx.notify();
1074        }
1075    }
1076
1077    fn move_pane_to_border(&mut self, direction: SplitDirection, cx: &mut Context<Self>) {
1078        if self
1079            .center
1080            .move_to_border(&self.active_pane, direction, cx)
1081            .unwrap()
1082        {
1083            cx.notify();
1084        }
1085    }
1086}
1087
1088fn is_enabled_in_workspace(workspace: &Workspace, cx: &App) -> bool {
1089    workspace.project().read(cx).supports_terminal(cx)
1090}
1091
1092pub fn new_terminal_pane(
1093    workspace: WeakEntity<Workspace>,
1094    project: Entity<Project>,
1095    zoomed: bool,
1096    window: &mut Window,
1097    cx: &mut Context<TerminalPanel>,
1098) -> Entity<Pane> {
1099    let is_local = project.read(cx).is_local();
1100    let terminal_panel = cx.entity();
1101    let pane = cx.new(|cx| {
1102        let mut pane = Pane::new(
1103            workspace.clone(),
1104            project.clone(),
1105            Default::default(),
1106            None,
1107            NewTerminal.boxed_clone(),
1108            false,
1109            window,
1110            cx,
1111        );
1112        pane.set_zoomed(zoomed, cx);
1113        pane.set_can_navigate(false, cx);
1114        pane.display_nav_history_buttons(None);
1115        pane.set_should_display_tab_bar(|_, _| true);
1116        pane.set_zoom_out_on_close(false);
1117
1118        let split_closure_terminal_panel = terminal_panel.downgrade();
1119        pane.set_can_split(Some(Arc::new(move |pane, dragged_item, _window, cx| {
1120            if let Some(tab) = dragged_item.downcast_ref::<DraggedTab>() {
1121                let is_current_pane = tab.pane == cx.entity();
1122                let Some(can_drag_away) = split_closure_terminal_panel
1123                    .read_with(cx, |terminal_panel, _| {
1124                        let current_panes = terminal_panel.center.panes();
1125                        !current_panes.contains(&&tab.pane)
1126                            || current_panes.len() > 1
1127                            || (!is_current_pane || pane.items_len() > 1)
1128                    })
1129                    .ok()
1130                else {
1131                    return false;
1132                };
1133                if can_drag_away {
1134                    let item = if is_current_pane {
1135                        pane.item_for_index(tab.ix)
1136                    } else {
1137                        tab.pane.read(cx).item_for_index(tab.ix)
1138                    };
1139                    if let Some(item) = item {
1140                        return item.downcast::<TerminalView>().is_some();
1141                    }
1142                }
1143            }
1144            false
1145        })));
1146
1147        let buffer_search_bar = cx.new(|cx| {
1148            search::BufferSearchBar::new(Some(project.read(cx).languages().clone()), window, cx)
1149        });
1150        let breadcrumbs = cx.new(|_| Breadcrumbs::new());
1151        pane.toolbar().update(cx, |toolbar, cx| {
1152            toolbar.add_item(buffer_search_bar, window, cx);
1153            toolbar.add_item(breadcrumbs, window, cx);
1154        });
1155
1156        let drop_closure_project = project.downgrade();
1157        let drop_closure_terminal_panel = terminal_panel.downgrade();
1158        pane.set_custom_drop_handle(cx, move |pane, dropped_item, window, cx| {
1159            let Some(project) = drop_closure_project.upgrade() else {
1160                return ControlFlow::Break(());
1161            };
1162            if let Some(tab) = dropped_item.downcast_ref::<DraggedTab>() {
1163                let this_pane = cx.entity();
1164                let item = if tab.pane == this_pane {
1165                    pane.item_for_index(tab.ix)
1166                } else {
1167                    tab.pane.read(cx).item_for_index(tab.ix)
1168                };
1169                if let Some(item) = item {
1170                    if item.downcast::<TerminalView>().is_some() {
1171                        let source = tab.pane.clone();
1172                        let item_id_to_move = item.item_id();
1173
1174                        let Ok(new_split_pane) = pane
1175                            .drag_split_direction()
1176                            .map(|split_direction| {
1177                                drop_closure_terminal_panel.update(cx, |terminal_panel, cx| {
1178                                    let is_zoomed = if terminal_panel.active_pane == this_pane {
1179                                        pane.is_zoomed()
1180                                    } else {
1181                                        terminal_panel.active_pane.read(cx).is_zoomed()
1182                                    };
1183                                    let new_pane = new_terminal_pane(
1184                                        workspace.clone(),
1185                                        project.clone(),
1186                                        is_zoomed,
1187                                        window,
1188                                        cx,
1189                                    );
1190                                    terminal_panel.apply_tab_bar_buttons(&new_pane, cx);
1191                                    terminal_panel.center.split(
1192                                        &this_pane,
1193                                        &new_pane,
1194                                        split_direction,
1195                                        cx,
1196                                    )?;
1197                                    anyhow::Ok(new_pane)
1198                                })
1199                            })
1200                            .transpose()
1201                        else {
1202                            return ControlFlow::Break(());
1203                        };
1204
1205                        match new_split_pane.transpose() {
1206                            // Source pane may be the one currently updated, so defer the move.
1207                            Ok(Some(new_pane)) => cx
1208                                .spawn_in(window, async move |_, cx| {
1209                                    cx.update(|window, cx| {
1210                                        move_item(
1211                                            &source,
1212                                            &new_pane,
1213                                            item_id_to_move,
1214                                            new_pane.read(cx).active_item_index(),
1215                                            true,
1216                                            window,
1217                                            cx,
1218                                        );
1219                                    })
1220                                    .ok();
1221                                })
1222                                .detach(),
1223                            // If we drop into existing pane or current pane,
1224                            // regular pane drop handler will take care of it,
1225                            // using the right tab index for the operation.
1226                            Ok(None) => return ControlFlow::Continue(()),
1227                            err @ Err(_) => {
1228                                err.log_err();
1229                                return ControlFlow::Break(());
1230                            }
1231                        };
1232                    } else if let Some(project_path) = item.project_path(cx)
1233                        && let Some(entry_path) = project.read(cx).absolute_path(&project_path, cx)
1234                    {
1235                        add_paths_to_terminal(pane, &[entry_path], window, cx);
1236                    }
1237                }
1238            } else if let Some(selection) = dropped_item.downcast_ref::<DraggedSelection>() {
1239                let project = project.read(cx);
1240                let paths_to_add = selection
1241                    .items()
1242                    .map(|selected_entry| selected_entry.entry_id)
1243                    .filter_map(|entry_id| project.path_for_entry(entry_id, cx))
1244                    .filter_map(|project_path| project.absolute_path(&project_path, cx))
1245                    .collect::<Vec<_>>();
1246                if !paths_to_add.is_empty() {
1247                    add_paths_to_terminal(pane, &paths_to_add, window, cx);
1248                }
1249            } else if let Some(&entry_id) = dropped_item.downcast_ref::<ProjectEntryId>() {
1250                if let Some(entry_path) = project
1251                    .read(cx)
1252                    .path_for_entry(entry_id, cx)
1253                    .and_then(|project_path| project.read(cx).absolute_path(&project_path, cx))
1254                {
1255                    add_paths_to_terminal(pane, &[entry_path], window, cx);
1256                }
1257            } else if is_local && let Some(paths) = dropped_item.downcast_ref::<ExternalPaths>() {
1258                add_paths_to_terminal(pane, paths.paths(), window, cx);
1259            }
1260
1261            ControlFlow::Break(())
1262        });
1263
1264        pane
1265    });
1266
1267    cx.subscribe_in(&pane, window, TerminalPanel::handle_pane_event)
1268        .detach();
1269    cx.observe(&pane, |_, _, cx| cx.notify()).detach();
1270
1271    pane
1272}
1273
1274async fn wait_for_terminals_tasks(
1275    terminals_for_task: Vec<(usize, Entity<Pane>, Entity<TerminalView>)>,
1276    cx: &mut AsyncApp,
1277) {
1278    let pending_tasks = terminals_for_task.iter().filter_map(|(_, _, terminal)| {
1279        terminal
1280            .update(cx, |terminal_view, cx| {
1281                terminal_view
1282                    .terminal()
1283                    .update(cx, |terminal, cx| terminal.wait_for_completed_task(cx))
1284            })
1285            .ok()
1286    });
1287    join_all(pending_tasks).await;
1288}
1289
1290fn add_paths_to_terminal(
1291    pane: &mut Pane,
1292    paths: &[PathBuf],
1293    window: &mut Window,
1294    cx: &mut Context<Pane>,
1295) {
1296    if let Some(terminal_view) = pane
1297        .active_item()
1298        .and_then(|item| item.downcast::<TerminalView>())
1299    {
1300        window.focus(&terminal_view.focus_handle(cx));
1301        let mut new_text = paths.iter().map(|path| format!(" {path:?}")).join("");
1302        new_text.push(' ');
1303        terminal_view.update(cx, |terminal_view, cx| {
1304            terminal_view.terminal().update(cx, |terminal, _| {
1305                terminal.paste(&new_text);
1306            });
1307        });
1308    }
1309}
1310
1311struct FailedToSpawnTerminal {
1312    error: String,
1313    focus_handle: FocusHandle,
1314}
1315
1316impl Focusable for FailedToSpawnTerminal {
1317    fn focus_handle(&self, _: &App) -> FocusHandle {
1318        self.focus_handle.clone()
1319    }
1320}
1321
1322impl Render for FailedToSpawnTerminal {
1323    fn render(&mut self, _: &mut Window, cx: &mut Context<Self>) -> impl IntoElement {
1324        let popover_menu = PopoverMenu::new("settings-popover")
1325            .trigger(
1326                IconButton::new("icon-button-popover", IconName::ChevronDown)
1327                    .icon_size(IconSize::XSmall),
1328            )
1329            .menu(move |window, cx| {
1330                Some(ContextMenu::build(window, cx, |context_menu, _, _| {
1331                    context_menu
1332                        .action("Open Settings", zed_actions::OpenSettings.boxed_clone())
1333                        .action(
1334                            "Edit settings.json",
1335                            zed_actions::OpenSettingsFile.boxed_clone(),
1336                        )
1337                }))
1338            })
1339            .anchor(Corner::TopRight)
1340            .offset(gpui::Point {
1341                x: px(0.0),
1342                y: px(2.0),
1343            });
1344
1345        v_flex()
1346            .track_focus(&self.focus_handle)
1347            .size_full()
1348            .p_4()
1349            .items_center()
1350            .justify_center()
1351            .bg(cx.theme().colors().editor_background)
1352            .child(
1353                v_flex()
1354                    .max_w_112()
1355                    .items_center()
1356                    .justify_center()
1357                    .text_center()
1358                    .child(Label::new("Failed to spawn terminal"))
1359                    .child(
1360                        Label::new(self.error.to_string())
1361                            .size(LabelSize::Small)
1362                            .color(Color::Muted)
1363                            .mb_4(),
1364                    )
1365                    .child(SplitButton::new(
1366                        ButtonLike::new("open-settings-ui")
1367                            .child(Label::new("Edit Settings").size(LabelSize::Small))
1368                            .on_click(|_, window, cx| {
1369                                window.dispatch_action(zed_actions::OpenSettings.boxed_clone(), cx);
1370                            }),
1371                        popover_menu.into_any_element(),
1372                    )),
1373            )
1374    }
1375}
1376
1377impl EventEmitter<()> for FailedToSpawnTerminal {}
1378
1379impl workspace::Item for FailedToSpawnTerminal {
1380    type Event = ();
1381
1382    fn tab_content_text(&self, _detail: usize, _cx: &App) -> SharedString {
1383        SharedString::new_static("Failed to spawn terminal")
1384    }
1385}
1386
1387impl EventEmitter<PanelEvent> for TerminalPanel {}
1388
1389impl Render for TerminalPanel {
1390    fn render(&mut self, window: &mut Window, cx: &mut Context<Self>) -> impl IntoElement {
1391        let mut registrar = DivRegistrar::new(
1392            |panel, _, cx| {
1393                panel
1394                    .active_pane
1395                    .read(cx)
1396                    .toolbar()
1397                    .read(cx)
1398                    .item_of_type::<BufferSearchBar>()
1399            },
1400            cx,
1401        );
1402        BufferSearchBar::register(&mut registrar);
1403        let registrar = registrar.into_div();
1404        self.workspace
1405            .update(cx, |workspace, cx| {
1406                registrar.size_full().child(self.center.render(
1407                    workspace.zoomed_item(),
1408                    &workspace::PaneRenderContext {
1409                        follower_states: &HashMap::default(),
1410                        active_call: workspace.active_call(),
1411                        active_pane: &self.active_pane,
1412                        app_state: workspace.app_state(),
1413                        project: workspace.project(),
1414                        workspace: &workspace.weak_handle(),
1415                    },
1416                    window,
1417                    cx,
1418                ))
1419            })
1420            .ok()
1421            .map(|div| {
1422                div.on_action({
1423                    cx.listener(|terminal_panel, _: &ActivatePaneLeft, window, cx| {
1424                        terminal_panel.activate_pane_in_direction(SplitDirection::Left, window, cx);
1425                    })
1426                })
1427                .on_action({
1428                    cx.listener(|terminal_panel, _: &ActivatePaneRight, window, cx| {
1429                        terminal_panel.activate_pane_in_direction(
1430                            SplitDirection::Right,
1431                            window,
1432                            cx,
1433                        );
1434                    })
1435                })
1436                .on_action({
1437                    cx.listener(|terminal_panel, _: &ActivatePaneUp, window, cx| {
1438                        terminal_panel.activate_pane_in_direction(SplitDirection::Up, window, cx);
1439                    })
1440                })
1441                .on_action({
1442                    cx.listener(|terminal_panel, _: &ActivatePaneDown, window, cx| {
1443                        terminal_panel.activate_pane_in_direction(SplitDirection::Down, window, cx);
1444                    })
1445                })
1446                .on_action(
1447                    cx.listener(|terminal_panel, _action: &ActivateNextPane, window, cx| {
1448                        let panes = terminal_panel.center.panes();
1449                        if let Some(ix) = panes
1450                            .iter()
1451                            .position(|pane| **pane == terminal_panel.active_pane)
1452                        {
1453                            let next_ix = (ix + 1) % panes.len();
1454                            window.focus(&panes[next_ix].focus_handle(cx));
1455                        }
1456                    }),
1457                )
1458                .on_action(cx.listener(
1459                    |terminal_panel, _action: &ActivatePreviousPane, window, cx| {
1460                        let panes = terminal_panel.center.panes();
1461                        if let Some(ix) = panes
1462                            .iter()
1463                            .position(|pane| **pane == terminal_panel.active_pane)
1464                        {
1465                            let prev_ix = cmp::min(ix.wrapping_sub(1), panes.len() - 1);
1466                            window.focus(&panes[prev_ix].focus_handle(cx));
1467                        }
1468                    },
1469                ))
1470                .on_action(
1471                    cx.listener(|terminal_panel, action: &ActivatePane, window, cx| {
1472                        let panes = terminal_panel.center.panes();
1473                        if let Some(&pane) = panes.get(action.0) {
1474                            window.focus(&pane.read(cx).focus_handle(cx));
1475                        } else {
1476                            let future =
1477                                terminal_panel.new_pane_with_cloned_active_terminal(window, cx);
1478                            cx.spawn_in(window, async move |terminal_panel, cx| {
1479                                if let Some(new_pane) = future.await {
1480                                    _ = terminal_panel.update_in(
1481                                        cx,
1482                                        |terminal_panel, window, cx| {
1483                                            terminal_panel
1484                                                .center
1485                                                .split(
1486                                                    &terminal_panel.active_pane,
1487                                                    &new_pane,
1488                                                    SplitDirection::Right,
1489                                                    cx,
1490                                                )
1491                                                .log_err();
1492                                            let new_pane = new_pane.read(cx);
1493                                            window.focus(&new_pane.focus_handle(cx));
1494                                        },
1495                                    );
1496                                }
1497                            })
1498                            .detach();
1499                        }
1500                    }),
1501                )
1502                .on_action(cx.listener(|terminal_panel, _: &SwapPaneLeft, _, cx| {
1503                    terminal_panel.swap_pane_in_direction(SplitDirection::Left, cx);
1504                }))
1505                .on_action(cx.listener(|terminal_panel, _: &SwapPaneRight, _, cx| {
1506                    terminal_panel.swap_pane_in_direction(SplitDirection::Right, cx);
1507                }))
1508                .on_action(cx.listener(|terminal_panel, _: &SwapPaneUp, _, cx| {
1509                    terminal_panel.swap_pane_in_direction(SplitDirection::Up, cx);
1510                }))
1511                .on_action(cx.listener(|terminal_panel, _: &SwapPaneDown, _, cx| {
1512                    terminal_panel.swap_pane_in_direction(SplitDirection::Down, cx);
1513                }))
1514                .on_action(cx.listener(|terminal_panel, _: &MovePaneLeft, _, cx| {
1515                    terminal_panel.move_pane_to_border(SplitDirection::Left, cx);
1516                }))
1517                .on_action(cx.listener(|terminal_panel, _: &MovePaneRight, _, cx| {
1518                    terminal_panel.move_pane_to_border(SplitDirection::Right, cx);
1519                }))
1520                .on_action(cx.listener(|terminal_panel, _: &MovePaneUp, _, cx| {
1521                    terminal_panel.move_pane_to_border(SplitDirection::Up, cx);
1522                }))
1523                .on_action(cx.listener(|terminal_panel, _: &MovePaneDown, _, cx| {
1524                    terminal_panel.move_pane_to_border(SplitDirection::Down, cx);
1525                }))
1526                .on_action(
1527                    cx.listener(|terminal_panel, action: &MoveItemToPane, window, cx| {
1528                        let Some(&target_pane) =
1529                            terminal_panel.center.panes().get(action.destination)
1530                        else {
1531                            return;
1532                        };
1533                        move_active_item(
1534                            &terminal_panel.active_pane,
1535                            target_pane,
1536                            action.focus,
1537                            true,
1538                            window,
1539                            cx,
1540                        );
1541                    }),
1542                )
1543                .on_action(cx.listener(
1544                    |terminal_panel, action: &MoveItemToPaneInDirection, window, cx| {
1545                        let source_pane = &terminal_panel.active_pane;
1546                        if let Some(destination_pane) = terminal_panel
1547                            .center
1548                            .find_pane_in_direction(source_pane, action.direction, cx)
1549                        {
1550                            move_active_item(
1551                                source_pane,
1552                                destination_pane,
1553                                action.focus,
1554                                true,
1555                                window,
1556                                cx,
1557                            );
1558                        };
1559                    },
1560                ))
1561            })
1562            .unwrap_or_else(|| div())
1563    }
1564}
1565
1566impl Focusable for TerminalPanel {
1567    fn focus_handle(&self, cx: &App) -> FocusHandle {
1568        self.active_pane.focus_handle(cx)
1569    }
1570}
1571
1572impl Panel for TerminalPanel {
1573    fn position(&self, _window: &Window, cx: &App) -> DockPosition {
1574        match TerminalSettings::get_global(cx).dock {
1575            TerminalDockPosition::Left => DockPosition::Left,
1576            TerminalDockPosition::Bottom => DockPosition::Bottom,
1577            TerminalDockPosition::Right => DockPosition::Right,
1578        }
1579    }
1580
1581    fn position_is_valid(&self, _: DockPosition) -> bool {
1582        true
1583    }
1584
1585    fn set_position(
1586        &mut self,
1587        position: DockPosition,
1588        _window: &mut Window,
1589        cx: &mut Context<Self>,
1590    ) {
1591        settings::update_settings_file(self.fs.clone(), cx, move |settings, _| {
1592            let dock = match position {
1593                DockPosition::Left => TerminalDockPosition::Left,
1594                DockPosition::Bottom => TerminalDockPosition::Bottom,
1595                DockPosition::Right => TerminalDockPosition::Right,
1596            };
1597            settings.terminal.get_or_insert_default().dock = Some(dock);
1598        });
1599    }
1600
1601    fn size(&self, window: &Window, cx: &App) -> Pixels {
1602        let settings = TerminalSettings::get_global(cx);
1603        match self.position(window, cx) {
1604            DockPosition::Left | DockPosition::Right => {
1605                self.width.unwrap_or(settings.default_width)
1606            }
1607            DockPosition::Bottom => self.height.unwrap_or(settings.default_height),
1608        }
1609    }
1610
1611    fn set_size(&mut self, size: Option<Pixels>, window: &mut Window, cx: &mut Context<Self>) {
1612        match self.position(window, cx) {
1613            DockPosition::Left | DockPosition::Right => self.width = size,
1614            DockPosition::Bottom => self.height = size,
1615        }
1616        cx.notify();
1617        cx.defer_in(window, |this, _, cx| {
1618            this.serialize(cx);
1619        })
1620    }
1621
1622    fn is_zoomed(&self, _window: &Window, cx: &App) -> bool {
1623        self.active_pane.read(cx).is_zoomed()
1624    }
1625
1626    fn set_zoomed(&mut self, zoomed: bool, _: &mut Window, cx: &mut Context<Self>) {
1627        for pane in self.center.panes() {
1628            pane.update(cx, |pane, cx| {
1629                pane.set_zoomed(zoomed, cx);
1630            })
1631        }
1632        cx.notify();
1633    }
1634
1635    fn set_active(&mut self, active: bool, window: &mut Window, cx: &mut Context<Self>) {
1636        let old_active = self.active;
1637        self.active = active;
1638        if !active || old_active == active || !self.has_no_terminals(cx) {
1639            return;
1640        }
1641        cx.defer_in(window, |this, window, cx| {
1642            let Ok(kind) = this
1643                .workspace
1644                .update(cx, |workspace, cx| default_working_directory(workspace, cx))
1645            else {
1646                return;
1647            };
1648
1649            this.add_terminal_shell(kind, RevealStrategy::Always, window, cx)
1650                .detach_and_log_err(cx)
1651        })
1652    }
1653
1654    fn icon_label(&self, _window: &Window, cx: &App) -> Option<String> {
1655        let count = self
1656            .center
1657            .panes()
1658            .into_iter()
1659            .map(|pane| pane.read(cx).items_len())
1660            .sum::<usize>();
1661        if count == 0 {
1662            None
1663        } else {
1664            Some(count.to_string())
1665        }
1666    }
1667
1668    fn persistent_name() -> &'static str {
1669        "TerminalPanel"
1670    }
1671
1672    fn panel_key() -> &'static str {
1673        TERMINAL_PANEL_KEY
1674    }
1675
1676    fn icon(&self, _window: &Window, cx: &App) -> Option<IconName> {
1677        if (self.is_enabled(cx) || !self.has_no_terminals(cx))
1678            && TerminalSettings::get_global(cx).button
1679        {
1680            Some(IconName::TerminalAlt)
1681        } else {
1682            None
1683        }
1684    }
1685
1686    fn icon_tooltip(&self, _window: &Window, _cx: &App) -> Option<&'static str> {
1687        Some("Terminal Panel")
1688    }
1689
1690    fn toggle_action(&self) -> Box<dyn gpui::Action> {
1691        Box::new(ToggleFocus)
1692    }
1693
1694    fn pane(&self) -> Option<Entity<Pane>> {
1695        Some(self.active_pane.clone())
1696    }
1697
1698    fn activation_priority(&self) -> u32 {
1699        1
1700    }
1701}
1702
1703struct TerminalProvider(Entity<TerminalPanel>);
1704
1705impl workspace::TerminalProvider for TerminalProvider {
1706    fn spawn(
1707        &self,
1708        task: SpawnInTerminal,
1709        window: &mut Window,
1710        cx: &mut App,
1711    ) -> Task<Option<Result<ExitStatus>>> {
1712        let terminal_panel = self.0.clone();
1713        window.spawn(cx, async move |cx| {
1714            let terminal = terminal_panel
1715                .update_in(cx, |terminal_panel, window, cx| {
1716                    terminal_panel.spawn_task(&task, window, cx)
1717                })
1718                .ok()?
1719                .await;
1720            match terminal {
1721                Ok(terminal) => {
1722                    let exit_status = terminal
1723                        .read_with(cx, |terminal, cx| terminal.wait_for_completed_task(cx))
1724                        .ok()?
1725                        .await?;
1726                    Some(Ok(exit_status))
1727                }
1728                Err(e) => Some(Err(e)),
1729            }
1730        })
1731    }
1732}
1733
1734struct InlineAssistTabBarButton {
1735    focus_handle: FocusHandle,
1736}
1737
1738impl Render for InlineAssistTabBarButton {
1739    fn render(&mut self, _window: &mut Window, cx: &mut Context<Self>) -> impl IntoElement {
1740        let focus_handle = self.focus_handle.clone();
1741        IconButton::new("terminal_inline_assistant", IconName::ZedAssistant)
1742            .icon_size(IconSize::Small)
1743            .on_click(cx.listener(|_, _, window, cx| {
1744                window.dispatch_action(InlineAssist::default().boxed_clone(), cx);
1745            }))
1746            .tooltip(move |_window, cx| {
1747                Tooltip::for_action_in("Inline Assist", &InlineAssist::default(), &focus_handle, cx)
1748            })
1749    }
1750}
1751
1752#[cfg(test)]
1753mod tests {
1754    use std::num::NonZero;
1755
1756    use super::*;
1757    use gpui::{TestAppContext, UpdateGlobal as _};
1758    use pretty_assertions::assert_eq;
1759    use project::FakeFs;
1760    use settings::SettingsStore;
1761
1762    #[gpui::test]
1763    async fn test_spawn_an_empty_task(cx: &mut TestAppContext) {
1764        init_test(cx);
1765
1766        let fs = FakeFs::new(cx.executor());
1767        let project = Project::test(fs, [], cx).await;
1768        let workspace = cx.add_window(|window, cx| Workspace::test_new(project, window, cx));
1769
1770        let (window_handle, terminal_panel) = workspace
1771            .update(cx, |workspace, window, cx| {
1772                let window_handle = window.window_handle();
1773                let terminal_panel = cx.new(|cx| TerminalPanel::new(workspace, window, cx));
1774                (window_handle, terminal_panel)
1775            })
1776            .unwrap();
1777
1778        let task = window_handle
1779            .update(cx, |_, window, cx| {
1780                terminal_panel.update(cx, |terminal_panel, cx| {
1781                    terminal_panel.spawn_task(&SpawnInTerminal::default(), window, cx)
1782                })
1783            })
1784            .unwrap();
1785
1786        let terminal = task.await.unwrap();
1787        let expected_shell = util::get_system_shell();
1788        terminal
1789            .update(cx, |terminal, _| {
1790                let task_metadata = terminal
1791                    .task()
1792                    .expect("When spawning a task, should have the task metadata")
1793                    .spawned_task
1794                    .clone();
1795                assert_eq!(task_metadata.env, HashMap::default());
1796                assert_eq!(task_metadata.cwd, None);
1797                assert_eq!(task_metadata.shell, task::Shell::System);
1798                assert_eq!(
1799                    task_metadata.command,
1800                    Some(expected_shell.clone()),
1801                    "Empty tasks should spawn a -i shell"
1802                );
1803                assert_eq!(task_metadata.args, Vec::<String>::new());
1804                assert_eq!(
1805                    task_metadata.command_label, expected_shell,
1806                    "We show the shell launch for empty commands"
1807                );
1808            })
1809            .unwrap();
1810    }
1811
1812    #[gpui::test]
1813    async fn test_bypass_max_tabs_limit(cx: &mut TestAppContext) {
1814        init_test(cx);
1815
1816        let fs = FakeFs::new(cx.executor());
1817        let project = Project::test(fs, [], cx).await;
1818        let workspace = cx.add_window(|window, cx| Workspace::test_new(project, window, cx));
1819
1820        let (window_handle, terminal_panel) = workspace
1821            .update(cx, |workspace, window, cx| {
1822                let window_handle = window.window_handle();
1823                let terminal_panel = cx.new(|cx| TerminalPanel::new(workspace, window, cx));
1824                (window_handle, terminal_panel)
1825            })
1826            .unwrap();
1827
1828        set_max_tabs(cx, Some(3));
1829
1830        for _ in 0..5 {
1831            let task = window_handle
1832                .update(cx, |_, window, cx| {
1833                    terminal_panel.update(cx, |panel, cx| {
1834                        panel.add_terminal_shell(None, RevealStrategy::Always, window, cx)
1835                    })
1836                })
1837                .unwrap();
1838            task.await.unwrap();
1839        }
1840
1841        cx.run_until_parked();
1842
1843        let item_count =
1844            terminal_panel.read_with(cx, |panel, cx| panel.active_pane.read(cx).items_len());
1845
1846        assert_eq!(
1847            item_count, 5,
1848            "Terminal panel should bypass max_tabs limit and have all 5 terminals"
1849        );
1850    }
1851
1852    // A complex Unix command won't be properly parsed by the Windows terminal hence omit the test there.
1853    #[cfg(unix)]
1854    #[gpui::test]
1855    async fn test_spawn_script_like_task(cx: &mut TestAppContext) {
1856        init_test(cx);
1857
1858        let fs = FakeFs::new(cx.executor());
1859        let project = Project::test(fs, [], cx).await;
1860        let workspace = cx.add_window(|window, cx| Workspace::test_new(project, window, cx));
1861
1862        let (window_handle, terminal_panel) = workspace
1863            .update(cx, |workspace, window, cx| {
1864                let window_handle = window.window_handle();
1865                let terminal_panel = cx.new(|cx| TerminalPanel::new(workspace, window, cx));
1866                (window_handle, terminal_panel)
1867            })
1868            .unwrap();
1869
1870        let user_command = r#"REPO_URL=$(git remote get-url origin | sed -e \"s/^git@\\(.*\\):\\(.*\\)\\.git$/https:\\/\\/\\1\\/\\2/\"); COMMIT_SHA=$(git log -1 --format=\"%H\" -- \"${ZED_RELATIVE_FILE}\"); echo \"${REPO_URL}/blob/${COMMIT_SHA}/${ZED_RELATIVE_FILE}#L${ZED_ROW}-$(echo $(($(wc -l <<< \"$ZED_SELECTED_TEXT\") + $ZED_ROW - 1)))\" | xclip -selection clipboard"#.to_string();
1871
1872        let expected_cwd = PathBuf::from("/some/work");
1873        let task = window_handle
1874            .update(cx, |_, window, cx| {
1875                terminal_panel.update(cx, |terminal_panel, cx| {
1876                    terminal_panel.spawn_task(
1877                        &SpawnInTerminal {
1878                            command: Some(user_command.clone()),
1879                            cwd: Some(expected_cwd.clone()),
1880                            ..SpawnInTerminal::default()
1881                        },
1882                        window,
1883                        cx,
1884                    )
1885                })
1886            })
1887            .unwrap();
1888
1889        let terminal = task.await.unwrap();
1890        let shell = util::get_system_shell();
1891        terminal
1892            .update(cx, |terminal, _| {
1893                let task_metadata = terminal
1894                    .task()
1895                    .expect("When spawning a task, should have the task metadata")
1896                    .spawned_task
1897                    .clone();
1898                assert_eq!(task_metadata.env, HashMap::default());
1899                assert_eq!(task_metadata.cwd, Some(expected_cwd));
1900                assert_eq!(task_metadata.shell, task::Shell::System);
1901                assert_eq!(task_metadata.command, Some(shell.clone()));
1902                assert_eq!(
1903                    task_metadata.args,
1904                    vec!["-i".to_string(), "-c".to_string(), user_command.clone(),],
1905                    "Use command should have been moved into the arguments, as we're spawning a new -i shell",
1906                );
1907                assert_eq!(
1908                    task_metadata.command_label,
1909                    format!("{shell} {interactive}-c '{user_command}'", interactive = if cfg!(windows) {""} else {"-i "}),
1910                    "We want to show to the user the entire command spawned");
1911            })
1912            .unwrap();
1913    }
1914
1915    #[gpui::test]
1916    async fn renders_error_if_default_shell_fails(cx: &mut TestAppContext) {
1917        init_test(cx);
1918
1919        cx.update(|cx| {
1920            SettingsStore::update_global(cx, |store, cx| {
1921                store.update_user_settings(cx, |settings| {
1922                    settings.terminal.get_or_insert_default().project.shell =
1923                        Some(settings::Shell::Program("asdf".to_owned()));
1924                });
1925            });
1926        });
1927
1928        let fs = FakeFs::new(cx.executor());
1929        let project = Project::test(fs, [], cx).await;
1930        let workspace = cx.add_window(|window, cx| Workspace::test_new(project, window, cx));
1931
1932        let (window_handle, terminal_panel) = workspace
1933            .update(cx, |workspace, window, cx| {
1934                let window_handle = window.window_handle();
1935                let terminal_panel = cx.new(|cx| TerminalPanel::new(workspace, window, cx));
1936                (window_handle, terminal_panel)
1937            })
1938            .unwrap();
1939
1940        window_handle
1941            .update(cx, |_, window, cx| {
1942                terminal_panel.update(cx, |terminal_panel, cx| {
1943                    terminal_panel.add_terminal_shell(None, RevealStrategy::Always, window, cx)
1944                })
1945            })
1946            .unwrap()
1947            .await
1948            .unwrap_err();
1949
1950        window_handle
1951            .update(cx, |_, _, cx| {
1952                terminal_panel.update(cx, |terminal_panel, cx| {
1953                    assert!(
1954                        terminal_panel
1955                            .active_pane
1956                            .read(cx)
1957                            .items()
1958                            .any(|item| item.downcast::<FailedToSpawnTerminal>().is_some()),
1959                        "should spawn `FailedToSpawnTerminal` pane"
1960                    );
1961                })
1962            })
1963            .unwrap();
1964    }
1965
1966    fn set_max_tabs(cx: &mut TestAppContext, value: Option<usize>) {
1967        cx.update_global(|store: &mut SettingsStore, cx| {
1968            store.update_user_settings(cx, |settings| {
1969                settings.workspace.max_tabs = value.map(|v| NonZero::new(v).unwrap())
1970            });
1971        });
1972    }
1973
1974    pub fn init_test(cx: &mut TestAppContext) {
1975        cx.update(|cx| {
1976            let store = SettingsStore::test(cx);
1977            cx.set_global(store);
1978            theme::init(theme::LoadThemes::JustBase, cx);
1979            editor::init(cx);
1980            crate::init(cx);
1981        });
1982    }
1983}