1package tui
2
3import (
4 "context"
5 "fmt"
6 "math/rand"
7 "slices"
8 "strings"
9 "time"
10
11 "github.com/charmbracelet/bubbles/v2/key"
12 tea "github.com/charmbracelet/bubbletea/v2"
13 "github.com/charmbracelet/crush/internal/agent/tools/mcp"
14 "github.com/charmbracelet/crush/internal/app"
15 "github.com/charmbracelet/crush/internal/config"
16 "github.com/charmbracelet/crush/internal/event"
17 "github.com/charmbracelet/crush/internal/permission"
18 "github.com/charmbracelet/crush/internal/pubsub"
19 cmpChat "github.com/charmbracelet/crush/internal/tui/components/chat"
20 "github.com/charmbracelet/crush/internal/tui/components/chat/splash"
21 "github.com/charmbracelet/crush/internal/tui/components/completions"
22 "github.com/charmbracelet/crush/internal/tui/components/core"
23 "github.com/charmbracelet/crush/internal/tui/components/core/layout"
24 "github.com/charmbracelet/crush/internal/tui/components/core/status"
25 "github.com/charmbracelet/crush/internal/tui/components/dialogs"
26 "github.com/charmbracelet/crush/internal/tui/components/dialogs/commands"
27 "github.com/charmbracelet/crush/internal/tui/components/dialogs/filepicker"
28 "github.com/charmbracelet/crush/internal/tui/components/dialogs/models"
29 "github.com/charmbracelet/crush/internal/tui/components/dialogs/permissions"
30 "github.com/charmbracelet/crush/internal/tui/components/dialogs/quit"
31 "github.com/charmbracelet/crush/internal/tui/components/dialogs/sessions"
32 "github.com/charmbracelet/crush/internal/tui/page"
33 "github.com/charmbracelet/crush/internal/tui/page/chat"
34 "github.com/charmbracelet/crush/internal/tui/styles"
35 "github.com/charmbracelet/crush/internal/tui/util"
36 "github.com/charmbracelet/lipgloss/v2"
37 "golang.org/x/text/cases"
38 "golang.org/x/text/language"
39)
40
41var lastMouseEvent time.Time
42
43func MouseEventFilter(m tea.Model, msg tea.Msg) tea.Msg {
44 switch msg.(type) {
45 case tea.MouseWheelMsg, tea.MouseMotionMsg:
46 now := time.Now()
47 // trackpad is sending too many requests
48 if now.Sub(lastMouseEvent) < 15*time.Millisecond {
49 return nil
50 }
51 lastMouseEvent = now
52 }
53 return msg
54}
55
56// appModel represents the main application model that manages pages, dialogs, and UI state.
57type appModel struct {
58 wWidth, wHeight int // Window dimensions
59 width, height int
60 keyMap KeyMap
61
62 currentPage page.PageID
63 previousPage page.PageID
64 pages map[page.PageID]util.Model
65 loadedPages map[page.PageID]bool
66
67 // Status
68 status status.StatusCmp
69 showingFullHelp bool
70
71 app *app.App
72
73 dialog dialogs.DialogCmp
74 completions completions.Completions
75 isConfigured bool
76
77 // Chat Page Specific
78 selectedSessionID string // The ID of the currently selected session
79
80 // sendProgressBar instructs the TUI to send progress bar updates to the
81 // terminal.
82 sendProgressBar bool
83
84 // QueryVersion instructs the TUI to query for the terminal version when it
85 // starts.
86 QueryVersion bool
87}
88
89// Init initializes the application model and returns initial commands.
90func (a appModel) Init() tea.Cmd {
91 item, ok := a.pages[a.currentPage]
92 if !ok {
93 return nil
94 }
95
96 var cmds []tea.Cmd
97 cmd := item.Init()
98 cmds = append(cmds, cmd)
99 a.loadedPages[a.currentPage] = true
100
101 cmd = a.status.Init()
102 cmds = append(cmds, cmd)
103 if a.QueryVersion {
104 cmds = append(cmds, tea.RequestTerminalVersion)
105 }
106
107 return tea.Batch(cmds...)
108}
109
110// Update handles incoming messages and updates the application state.
111func (a *appModel) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
112 var cmds []tea.Cmd
113 var cmd tea.Cmd
114 a.isConfigured = config.HasInitialDataConfig()
115
116 switch msg := msg.(type) {
117 case tea.EnvMsg:
118 // Is this Windows Terminal?
119 if !a.sendProgressBar {
120 a.sendProgressBar = slices.Contains(msg, "WT_SESSION")
121 }
122 case tea.TerminalVersionMsg:
123 termVersion := strings.ToLower(string(msg))
124 // Only enable progress bar for the following terminals.
125 if !a.sendProgressBar {
126 a.sendProgressBar = strings.Contains(termVersion, "ghostty")
127 }
128 return a, nil
129 case tea.KeyboardEnhancementsMsg:
130 for id, page := range a.pages {
131 m, pageCmd := page.Update(msg)
132 a.pages[id] = m
133
134 if pageCmd != nil {
135 cmds = append(cmds, pageCmd)
136 }
137 }
138 return a, tea.Batch(cmds...)
139 case tea.WindowSizeMsg:
140 a.wWidth, a.wHeight = msg.Width, msg.Height
141 a.completions.Update(msg)
142 return a, a.handleWindowResize(msg.Width, msg.Height)
143
144 case pubsub.Event[mcp.Event]:
145 switch msg.Payload.Type {
146 case mcp.EventStateChanged:
147 return a, a.handleStateChanged(context.Background())
148 case mcp.EventPromptsListChanged:
149 return a, handleMCPPromptsEvent(context.Background(), msg.Payload.Name)
150 case mcp.EventToolsListChanged:
151 return a, handleMCPToolsEvent(context.Background(), msg.Payload.Name)
152 case mcp.EventResourcesListChanged:
153 return a, handleMCPResourcesEvent(context.Background(), msg.Payload.Name)
154 }
155
156 // Completions messages
157 case completions.OpenCompletionsMsg, completions.FilterCompletionsMsg,
158 completions.CloseCompletionsMsg, completions.RepositionCompletionsMsg:
159 u, completionCmd := a.completions.Update(msg)
160 if model, ok := u.(completions.Completions); ok {
161 a.completions = model
162 }
163
164 return a, completionCmd
165
166 // Dialog messages
167 case dialogs.OpenDialogMsg, dialogs.CloseDialogMsg:
168 u, completionCmd := a.completions.Update(completions.CloseCompletionsMsg{})
169 a.completions = u.(completions.Completions)
170 u, dialogCmd := a.dialog.Update(msg)
171 a.dialog = u.(dialogs.DialogCmp)
172 return a, tea.Batch(completionCmd, dialogCmd)
173 case commands.ShowArgumentsDialogMsg:
174 var args []commands.Argument
175 for _, arg := range msg.ArgNames {
176 args = append(args, commands.Argument{
177 Name: arg,
178 Title: cases.Title(language.English).String(arg),
179 Required: true,
180 })
181 }
182 return a, util.CmdHandler(
183 dialogs.OpenDialogMsg{
184 Model: commands.NewCommandArgumentsDialog(
185 msg.CommandID,
186 msg.CommandID,
187 msg.CommandID,
188 msg.Description,
189 args,
190 msg.OnSubmit,
191 ),
192 },
193 )
194 case commands.ShowMCPPromptArgumentsDialogMsg:
195 args := make([]commands.Argument, 0, len(msg.Prompt.Arguments))
196 for _, arg := range msg.Prompt.Arguments {
197 args = append(args, commands.Argument(*arg))
198 }
199 dialog := commands.NewCommandArgumentsDialog(
200 msg.Prompt.Name,
201 msg.Prompt.Title,
202 msg.Prompt.Name,
203 msg.Prompt.Description,
204 args,
205 msg.OnSubmit,
206 )
207 return a, util.CmdHandler(
208 dialogs.OpenDialogMsg{
209 Model: dialog,
210 },
211 )
212 // Page change messages
213 case page.PageChangeMsg:
214 return a, a.moveToPage(msg.ID)
215
216 // Status Messages
217 case util.InfoMsg, util.ClearStatusMsg:
218 s, statusCmd := a.status.Update(msg)
219 a.status = s.(status.StatusCmp)
220 cmds = append(cmds, statusCmd)
221 return a, tea.Batch(cmds...)
222
223 // Session
224 case cmpChat.SessionSelectedMsg:
225 a.selectedSessionID = msg.ID
226 case cmpChat.SessionClearedMsg:
227 a.selectedSessionID = ""
228 // Commands
229 case commands.SwitchSessionsMsg:
230 return a, func() tea.Msg {
231 allSessions, _ := a.app.Sessions.List(context.Background())
232 return dialogs.OpenDialogMsg{
233 Model: sessions.NewSessionDialogCmp(allSessions, a.selectedSessionID),
234 }
235 }
236
237 case commands.SwitchModelMsg:
238 return a, util.CmdHandler(
239 dialogs.OpenDialogMsg{
240 Model: models.NewModelDialogCmp(),
241 },
242 )
243 // Compact
244 case commands.CompactMsg:
245 return a, func() tea.Msg {
246 err := a.app.AgentCoordinator.Summarize(context.Background(), msg.SessionID)
247 if err != nil {
248 return util.ReportError(err)()
249 }
250 return nil
251 }
252 case commands.QuitMsg:
253 return a, util.CmdHandler(dialogs.OpenDialogMsg{
254 Model: quit.NewQuitDialog(),
255 })
256 case commands.ToggleYoloModeMsg:
257 a.app.Permissions.SetSkipRequests(!a.app.Permissions.SkipRequests())
258 case commands.ToggleHelpMsg:
259 a.status.ToggleFullHelp()
260 a.showingFullHelp = !a.showingFullHelp
261 return a, a.handleWindowResize(a.wWidth, a.wHeight)
262 // Model Switch
263 case models.ModelSelectedMsg:
264 if a.app.AgentCoordinator.IsBusy() {
265 return a, util.ReportWarn("Agent is busy, please wait...")
266 }
267
268 config.Get().UpdatePreferredModel(msg.ModelType, msg.Model)
269
270 go a.app.UpdateAgentModel(context.TODO())
271
272 modelTypeName := "large"
273 if msg.ModelType == config.SelectedModelTypeSmall {
274 modelTypeName = "small"
275 }
276 return a, util.ReportInfo(fmt.Sprintf("%s model changed to %s", modelTypeName, msg.Model.Model))
277
278 // File Picker
279 case commands.OpenFilePickerMsg:
280 event.FilePickerOpened()
281
282 if a.dialog.ActiveDialogID() == filepicker.FilePickerID {
283 // If the commands dialog is already open, close it
284 return a, util.CmdHandler(dialogs.CloseDialogMsg{})
285 }
286 return a, util.CmdHandler(dialogs.OpenDialogMsg{
287 Model: filepicker.NewFilePickerCmp(a.app.Config().WorkingDir()),
288 })
289 // Permissions
290 case pubsub.Event[permission.PermissionNotification]:
291 item, ok := a.pages[a.currentPage]
292 if !ok {
293 return a, nil
294 }
295
296 // Forward to view.
297 updated, itemCmd := item.Update(msg)
298 a.pages[a.currentPage] = updated
299
300 return a, itemCmd
301 case pubsub.Event[permission.PermissionRequest]:
302 return a, util.CmdHandler(dialogs.OpenDialogMsg{
303 Model: permissions.NewPermissionDialogCmp(msg.Payload, &permissions.Options{
304 DiffMode: config.Get().Options.TUI.DiffMode,
305 }),
306 })
307 case permissions.PermissionResponseMsg:
308 switch msg.Action {
309 case permissions.PermissionAllow:
310 a.app.Permissions.Grant(msg.Permission)
311 case permissions.PermissionAllowForSession:
312 a.app.Permissions.GrantPersistent(msg.Permission)
313 case permissions.PermissionDeny:
314 a.app.Permissions.Deny(msg.Permission)
315 }
316 return a, nil
317 case splash.OnboardingCompleteMsg:
318 item, ok := a.pages[a.currentPage]
319 if !ok {
320 return a, nil
321 }
322
323 a.isConfigured = config.HasInitialDataConfig()
324 updated, pageCmd := item.Update(msg)
325 a.pages[a.currentPage] = updated
326
327 cmds = append(cmds, pageCmd)
328 return a, tea.Batch(cmds...)
329
330 case tea.KeyPressMsg:
331 return a, a.handleKeyPressMsg(msg)
332
333 case tea.MouseWheelMsg:
334 if a.dialog.HasDialogs() {
335 u, dialogCmd := a.dialog.Update(msg)
336 a.dialog = u.(dialogs.DialogCmp)
337 cmds = append(cmds, dialogCmd)
338 } else {
339 item, ok := a.pages[a.currentPage]
340 if !ok {
341 return a, nil
342 }
343
344 updated, pageCmd := item.Update(msg)
345 a.pages[a.currentPage] = updated
346
347 cmds = append(cmds, pageCmd)
348 }
349 return a, tea.Batch(cmds...)
350 case tea.PasteMsg:
351 if a.dialog.HasDialogs() {
352 u, dialogCmd := a.dialog.Update(msg)
353 if model, ok := u.(dialogs.DialogCmp); ok {
354 a.dialog = model
355 }
356
357 cmds = append(cmds, dialogCmd)
358 } else {
359 item, ok := a.pages[a.currentPage]
360 if !ok {
361 return a, nil
362 }
363
364 updated, pageCmd := item.Update(msg)
365 a.pages[a.currentPage] = updated
366
367 cmds = append(cmds, pageCmd)
368 }
369 return a, tea.Batch(cmds...)
370 }
371 s, _ := a.status.Update(msg)
372 a.status = s.(status.StatusCmp)
373
374 item, ok := a.pages[a.currentPage]
375 if !ok {
376 return a, nil
377 }
378
379 updated, cmd := item.Update(msg)
380 a.pages[a.currentPage] = updated
381
382 if a.dialog.HasDialogs() {
383 u, dialogCmd := a.dialog.Update(msg)
384 if model, ok := u.(dialogs.DialogCmp); ok {
385 a.dialog = model
386 }
387
388 cmds = append(cmds, dialogCmd)
389 }
390 cmds = append(cmds, cmd)
391 return a, tea.Batch(cmds...)
392}
393
394// handleWindowResize processes window resize events and updates all components.
395func (a *appModel) handleWindowResize(width, height int) tea.Cmd {
396 var cmds []tea.Cmd
397
398 // TODO: clean up these magic numbers.
399 if a.showingFullHelp {
400 height -= 5
401 } else {
402 height -= 2
403 }
404
405 a.width, a.height = width, height
406 // Update status bar
407 s, cmd := a.status.Update(tea.WindowSizeMsg{Width: width, Height: height})
408 if model, ok := s.(status.StatusCmp); ok {
409 a.status = model
410 }
411 cmds = append(cmds, cmd)
412
413 // Update the current view.
414 for p, page := range a.pages {
415 updated, pageCmd := page.Update(tea.WindowSizeMsg{Width: width, Height: height})
416 a.pages[p] = updated
417
418 cmds = append(cmds, pageCmd)
419 }
420
421 // Update the dialogs
422 dialog, cmd := a.dialog.Update(tea.WindowSizeMsg{Width: width, Height: height})
423 if model, ok := dialog.(dialogs.DialogCmp); ok {
424 a.dialog = model
425 }
426
427 cmds = append(cmds, cmd)
428
429 return tea.Batch(cmds...)
430}
431
432// handleKeyPressMsg processes keyboard input and routes to appropriate handlers.
433func (a *appModel) handleKeyPressMsg(msg tea.KeyPressMsg) tea.Cmd {
434 // Check this first as the user should be able to quit no matter what.
435 if key.Matches(msg, a.keyMap.Quit) {
436 if a.dialog.ActiveDialogID() == quit.QuitDialogID {
437 return tea.Quit
438 }
439 return util.CmdHandler(dialogs.OpenDialogMsg{
440 Model: quit.NewQuitDialog(),
441 })
442 }
443
444 if a.completions.Open() {
445 // completions
446 keyMap := a.completions.KeyMap()
447 switch {
448 case key.Matches(msg, keyMap.Up), key.Matches(msg, keyMap.Down),
449 key.Matches(msg, keyMap.Select), key.Matches(msg, keyMap.Cancel),
450 key.Matches(msg, keyMap.UpInsert), key.Matches(msg, keyMap.DownInsert):
451 u, cmd := a.completions.Update(msg)
452 a.completions = u.(completions.Completions)
453 return cmd
454 }
455 }
456 if a.dialog.HasDialogs() {
457 u, dialogCmd := a.dialog.Update(msg)
458 a.dialog = u.(dialogs.DialogCmp)
459 return dialogCmd
460 }
461 switch {
462 // help
463 case key.Matches(msg, a.keyMap.Help):
464 a.status.ToggleFullHelp()
465 a.showingFullHelp = !a.showingFullHelp
466 return a.handleWindowResize(a.wWidth, a.wHeight)
467 // dialogs
468 case key.Matches(msg, a.keyMap.Commands):
469 // if the app is not configured show no commands
470 if !a.isConfigured {
471 return nil
472 }
473 if a.dialog.ActiveDialogID() == commands.CommandsDialogID {
474 return util.CmdHandler(dialogs.CloseDialogMsg{})
475 }
476 if a.dialog.HasDialogs() {
477 return nil
478 }
479 return util.CmdHandler(dialogs.OpenDialogMsg{
480 Model: commands.NewCommandDialog(a.selectedSessionID),
481 })
482 case key.Matches(msg, a.keyMap.Sessions):
483 // if the app is not configured show no sessions
484 if !a.isConfigured {
485 return nil
486 }
487 if a.dialog.ActiveDialogID() == sessions.SessionsDialogID {
488 return util.CmdHandler(dialogs.CloseDialogMsg{})
489 }
490 if a.dialog.HasDialogs() && a.dialog.ActiveDialogID() != commands.CommandsDialogID {
491 return nil
492 }
493 var cmds []tea.Cmd
494 if a.dialog.ActiveDialogID() == commands.CommandsDialogID {
495 // If the commands dialog is open, close it first
496 cmds = append(cmds, util.CmdHandler(dialogs.CloseDialogMsg{}))
497 }
498 cmds = append(cmds,
499 func() tea.Msg {
500 allSessions, _ := a.app.Sessions.List(context.Background())
501 return dialogs.OpenDialogMsg{
502 Model: sessions.NewSessionDialogCmp(allSessions, a.selectedSessionID),
503 }
504 },
505 )
506 return tea.Sequence(cmds...)
507 case key.Matches(msg, a.keyMap.Suspend):
508 if a.app.AgentCoordinator != nil && a.app.AgentCoordinator.IsBusy() {
509 return util.ReportWarn("Agent is busy, please wait...")
510 }
511 return tea.Suspend
512 default:
513 item, ok := a.pages[a.currentPage]
514 if !ok {
515 return nil
516 }
517
518 updated, cmd := item.Update(msg)
519 a.pages[a.currentPage] = updated
520 return cmd
521 }
522}
523
524// moveToPage handles navigation between different pages in the application.
525func (a *appModel) moveToPage(pageID page.PageID) tea.Cmd {
526 if a.app.AgentCoordinator.IsBusy() {
527 // TODO: maybe remove this : For now we don't move to any page if the agent is busy
528 return util.ReportWarn("Agent is busy, please wait...")
529 }
530
531 var cmds []tea.Cmd
532 if _, ok := a.loadedPages[pageID]; !ok {
533 cmd := a.pages[pageID].Init()
534 cmds = append(cmds, cmd)
535 a.loadedPages[pageID] = true
536 }
537 a.previousPage = a.currentPage
538 a.currentPage = pageID
539 if sizable, ok := a.pages[a.currentPage].(layout.Sizeable); ok {
540 cmd := sizable.SetSize(a.width, a.height)
541 cmds = append(cmds, cmd)
542 }
543
544 return tea.Batch(cmds...)
545}
546
547// View renders the complete application interface including pages, dialogs, and overlays.
548func (a *appModel) View() tea.View {
549 var view tea.View
550 view.AltScreen = true
551 t := styles.CurrentTheme()
552 view.BackgroundColor = t.BgBase
553 if a.wWidth < 25 || a.wHeight < 15 {
554 view.Layer = lipgloss.NewCanvas(
555 lipgloss.NewLayer(
556 t.S().Base.Width(a.wWidth).Height(a.wHeight).
557 Align(lipgloss.Center, lipgloss.Center).
558 Render(
559 t.S().Base.
560 Padding(1, 4).
561 Foreground(t.White).
562 BorderStyle(lipgloss.RoundedBorder()).
563 BorderForeground(t.Primary).
564 Render("Window too small!"),
565 ),
566 ),
567 )
568 return view
569 }
570
571 page := a.pages[a.currentPage]
572 if withHelp, ok := page.(core.KeyMapHelp); ok {
573 a.status.SetKeyMap(withHelp.Help())
574 }
575 pageView := page.View()
576 components := []string{
577 pageView,
578 }
579 components = append(components, a.status.View())
580
581 appView := lipgloss.JoinVertical(lipgloss.Top, components...)
582 layers := []*lipgloss.Layer{
583 lipgloss.NewLayer(appView),
584 }
585 if a.dialog.HasDialogs() {
586 layers = append(
587 layers,
588 a.dialog.GetLayers()...,
589 )
590 }
591
592 var cursor *tea.Cursor
593 if v, ok := page.(util.Cursor); ok {
594 cursor = v.Cursor()
595 // Hide the cursor if it's positioned outside the textarea
596 statusHeight := a.height - strings.Count(pageView, "\n") + 1
597 if cursor != nil && cursor.Y+statusHeight+chat.EditorHeight-2 <= a.height { // 2 for the top and bottom app padding
598 cursor = nil
599 }
600 }
601 activeView := a.dialog.ActiveModel()
602 if activeView != nil {
603 cursor = nil // Reset cursor if a dialog is active unless it implements util.Cursor
604 if v, ok := activeView.(util.Cursor); ok {
605 cursor = v.Cursor()
606 }
607 }
608
609 if a.completions.Open() && cursor != nil {
610 cmp := a.completions.View()
611 x, y := a.completions.Position()
612 layers = append(
613 layers,
614 lipgloss.NewLayer(cmp).X(x).Y(y),
615 )
616 }
617
618 canvas := lipgloss.NewCanvas(
619 layers...,
620 )
621
622 view.Layer = canvas
623 view.Cursor = cursor
624 view.MouseMode = tea.MouseModeCellMotion
625
626 if a.sendProgressBar && a.app != nil && a.app.AgentCoordinator != nil && a.app.AgentCoordinator.IsBusy() {
627 // HACK: use a random percentage to prevent ghostty from hiding it
628 // after a timeout.
629 view.ProgressBar = tea.NewProgressBar(tea.ProgressBarIndeterminate, rand.Intn(100))
630 }
631 return view
632}
633
634func (a *appModel) handleStateChanged(ctx context.Context) tea.Cmd {
635 return func() tea.Msg {
636 a.app.UpdateAgentModel(ctx)
637 return nil
638 }
639}
640
641func handleMCPPromptsEvent(ctx context.Context, name string) tea.Cmd {
642 return func() tea.Msg {
643 mcp.RefreshPrompts(ctx, name)
644 return nil
645 }
646}
647
648func handleMCPToolsEvent(ctx context.Context, name string) tea.Cmd {
649 return func() tea.Msg {
650 mcp.RefreshTools(ctx, name)
651 return nil
652 }
653}
654
655func handleMCPResourcesEvent(ctx context.Context, name string) tea.Cmd {
656 return func() tea.Msg {
657 mcp.RefreshResources(ctx, name)
658 return nil
659 }
660}
661
662// New creates and initializes a new TUI application model.
663func New(app *app.App) *appModel {
664 chatPage := chat.New(app)
665 keyMap := DefaultKeyMap()
666 keyMap.pageBindings = chatPage.Bindings()
667
668 model := &appModel{
669 currentPage: chat.ChatPageID,
670 app: app,
671 status: status.NewStatusCmp(),
672 loadedPages: make(map[page.PageID]bool),
673 keyMap: keyMap,
674
675 pages: map[page.PageID]util.Model{
676 chat.ChatPageID: chatPage,
677 },
678
679 dialog: dialogs.NewDialogCmp(),
680 completions: completions.New(),
681 }
682
683 return model
684}