1// Package app wires together services, coordinates agents, and manages
2// application lifecycle.
3package app
4
5import (
6 "context"
7 "database/sql"
8 "errors"
9 "fmt"
10 "io"
11 "log/slog"
12 "os"
13 "strings"
14 "sync"
15 "time"
16
17 tea "charm.land/bubbletea/v2"
18 "charm.land/fantasy"
19 "charm.land/lipgloss/v2"
20 "github.com/charmbracelet/catwalk/pkg/catwalk"
21 "github.com/charmbracelet/crush/internal/agent"
22 "github.com/charmbracelet/crush/internal/agent/tools/mcp"
23 "github.com/charmbracelet/crush/internal/config"
24 "github.com/charmbracelet/crush/internal/csync"
25 "github.com/charmbracelet/crush/internal/db"
26 "github.com/charmbracelet/crush/internal/filetracker"
27 "github.com/charmbracelet/crush/internal/format"
28 "github.com/charmbracelet/crush/internal/history"
29 "github.com/charmbracelet/crush/internal/log"
30 "github.com/charmbracelet/crush/internal/lsp"
31 "github.com/charmbracelet/crush/internal/message"
32 "github.com/charmbracelet/crush/internal/permission"
33 "github.com/charmbracelet/crush/internal/pubsub"
34 "github.com/charmbracelet/crush/internal/session"
35 "github.com/charmbracelet/crush/internal/shell"
36 "github.com/charmbracelet/crush/internal/tui/components/anim"
37 "github.com/charmbracelet/crush/internal/tui/styles"
38 "github.com/charmbracelet/crush/internal/update"
39 "github.com/charmbracelet/crush/internal/version"
40 "github.com/charmbracelet/x/ansi"
41 "github.com/charmbracelet/x/exp/charmtone"
42 "github.com/charmbracelet/x/term"
43)
44
45// UpdateAvailableMsg is sent when a new version is available.
46type UpdateAvailableMsg struct {
47 CurrentVersion string
48 LatestVersion string
49 IsDevelopment bool
50}
51
52type App struct {
53 Sessions session.Service
54 Messages message.Service
55 History history.Service
56 Permissions permission.Service
57 FileTracker filetracker.Service
58
59 AgentCoordinator agent.Coordinator
60
61 LSPClients *csync.Map[string, *lsp.Client]
62
63 config *config.Config
64
65 serviceEventsWG *sync.WaitGroup
66 eventsCtx context.Context
67 events chan tea.Msg
68 tuiWG *sync.WaitGroup
69
70 // global context and cleanup functions
71 globalCtx context.Context
72 cleanupFuncs []func() error
73}
74
75// New initializes a new application instance.
76func New(ctx context.Context, conn *sql.DB, cfg *config.Config) (*App, error) {
77 q := db.New(conn)
78 sessions := session.NewService(q, conn)
79 messages := message.NewService(q)
80 files := history.NewService(q, conn)
81 skipPermissionsRequests := cfg.Permissions != nil && cfg.Permissions.SkipRequests
82 var allowedTools []string
83 if cfg.Permissions != nil && cfg.Permissions.AllowedTools != nil {
84 allowedTools = cfg.Permissions.AllowedTools
85 }
86
87 app := &App{
88 Sessions: sessions,
89 Messages: messages,
90 History: files,
91 Permissions: permission.NewPermissionService(cfg.WorkingDir(), skipPermissionsRequests, allowedTools),
92 FileTracker: filetracker.NewService(q),
93 LSPClients: csync.NewMap[string, *lsp.Client](),
94
95 globalCtx: ctx,
96
97 config: cfg,
98
99 events: make(chan tea.Msg, 100),
100 serviceEventsWG: &sync.WaitGroup{},
101 tuiWG: &sync.WaitGroup{},
102 }
103
104 app.setupEvents()
105
106 // Initialize LSP clients in the background.
107 go app.initLSPClients(ctx)
108
109 // Check for updates in the background.
110 go app.checkForUpdates(ctx)
111
112 go func() {
113 slog.Info("Initializing MCP clients")
114 mcp.Initialize(ctx, app.Permissions, cfg)
115 }()
116
117 // cleanup database upon app shutdown
118 app.cleanupFuncs = append(app.cleanupFuncs, conn.Close, mcp.Close)
119
120 // TODO: remove the concept of agent config, most likely.
121 if !cfg.IsConfigured() {
122 slog.Warn("No agent configuration found")
123 return app, nil
124 }
125 if err := app.InitCoderAgent(ctx); err != nil {
126 return nil, fmt.Errorf("failed to initialize coder agent: %w", err)
127 }
128 return app, nil
129}
130
131// Config returns the application configuration.
132func (app *App) Config() *config.Config {
133 return app.config
134}
135
136// RunNonInteractive runs the application in non-interactive mode with the
137// given prompt, printing to stdout.
138func (app *App) RunNonInteractive(ctx context.Context, output io.Writer, prompt, largeModel, smallModel string, quiet bool) error {
139 slog.Info("Running in non-interactive mode")
140
141 ctx, cancel := context.WithCancel(ctx)
142 defer cancel()
143
144 if largeModel != "" || smallModel != "" {
145 if err := app.overrideModelsForNonInteractive(ctx, largeModel, smallModel); err != nil {
146 return fmt.Errorf("failed to override models: %w", err)
147 }
148 }
149
150 var (
151 spinner *format.Spinner
152 stdoutTTY bool
153 stderrTTY bool
154 stdinTTY bool
155 progress bool
156 )
157
158 if f, ok := output.(*os.File); ok {
159 stdoutTTY = term.IsTerminal(f.Fd())
160 }
161 stderrTTY = term.IsTerminal(os.Stderr.Fd())
162 stdinTTY = term.IsTerminal(os.Stdin.Fd())
163
164 progress = app.config.Options.Progress == nil || *app.config.Options.Progress
165
166 if !quiet && stderrTTY {
167 t := styles.CurrentTheme()
168
169 // Detect background color to set the appropriate color for the
170 // spinner's 'Generating...' text. Without this, that text would be
171 // unreadable in light terminals.
172 hasDarkBG := true
173 if f, ok := output.(*os.File); ok && stdinTTY && stdoutTTY {
174 hasDarkBG = lipgloss.HasDarkBackground(os.Stdin, f)
175 }
176 defaultFG := lipgloss.LightDark(hasDarkBG)(charmtone.Pepper, t.FgBase)
177
178 spinner = format.NewSpinner(ctx, cancel, anim.Settings{
179 Size: 10,
180 Label: "Generating",
181 LabelColor: defaultFG,
182 GradColorA: t.Primary,
183 GradColorB: t.Secondary,
184 CycleColors: true,
185 })
186 spinner.Start()
187 }
188
189 // Helper function to stop spinner once.
190 stopSpinner := func() {
191 if !quiet && spinner != nil {
192 spinner.Stop()
193 spinner = nil
194 }
195 }
196
197 // Wait for MCP initialization to complete before reading MCP tools.
198 if err := mcp.WaitForInit(ctx); err != nil {
199 return fmt.Errorf("failed to wait for MCP initialization: %w", err)
200 }
201
202 // force update of agent models before running so mcp tools are loaded
203 app.AgentCoordinator.UpdateModels(ctx)
204
205 defer stopSpinner()
206
207 const maxPromptLengthForTitle = 100
208 const titlePrefix = "Non-interactive: "
209 var titleSuffix string
210
211 if len(prompt) > maxPromptLengthForTitle {
212 titleSuffix = prompt[:maxPromptLengthForTitle] + "..."
213 } else {
214 titleSuffix = prompt
215 }
216 title := titlePrefix + titleSuffix
217
218 sess, err := app.Sessions.Create(ctx, title)
219 if err != nil {
220 return fmt.Errorf("failed to create session for non-interactive mode: %w", err)
221 }
222 slog.Info("Created session for non-interactive run", "session_id", sess.ID)
223
224 // Automatically approve all permission requests for this non-interactive
225 // session.
226 app.Permissions.AutoApproveSession(sess.ID)
227
228 type response struct {
229 result *fantasy.AgentResult
230 err error
231 }
232 done := make(chan response, 1)
233
234 go func(ctx context.Context, sessionID, prompt string) {
235 result, err := app.AgentCoordinator.Run(ctx, sess.ID, prompt)
236 if err != nil {
237 done <- response{
238 err: fmt.Errorf("failed to start agent processing stream: %w", err),
239 }
240 }
241 done <- response{
242 result: result,
243 }
244 }(ctx, sess.ID, prompt)
245
246 messageEvents := app.Messages.Subscribe(ctx)
247 messageReadBytes := make(map[string]int)
248
249 defer func() {
250 if progress && stderrTTY {
251 _, _ = fmt.Fprintf(os.Stderr, ansi.ResetProgressBar)
252 }
253
254 // Always print a newline at the end. If output is a TTY this will
255 // prevent the prompt from overwriting the last line of output.
256 _, _ = fmt.Fprintln(output)
257 }()
258
259 for {
260 if progress && stderrTTY {
261 // HACK: Reinitialize the terminal progress bar on every iteration
262 // so it doesn't get hidden by the terminal due to inactivity.
263 _, _ = fmt.Fprintf(os.Stderr, ansi.SetIndeterminateProgressBar)
264 }
265
266 select {
267 case result := <-done:
268 stopSpinner()
269 if result.err != nil {
270 if errors.Is(result.err, context.Canceled) || errors.Is(result.err, agent.ErrRequestCancelled) {
271 slog.Info("Non-interactive: agent processing cancelled", "session_id", sess.ID)
272 return nil
273 }
274 return fmt.Errorf("agent processing failed: %w", result.err)
275 }
276 return nil
277
278 case event := <-messageEvents:
279 msg := event.Payload
280 if msg.SessionID == sess.ID && msg.Role == message.Assistant && len(msg.Parts) > 0 {
281 stopSpinner()
282
283 content := msg.Content().String()
284 readBytes := messageReadBytes[msg.ID]
285
286 if len(content) < readBytes {
287 slog.Error("Non-interactive: message content is shorter than read bytes", "message_length", len(content), "read_bytes", readBytes)
288 return fmt.Errorf("message content is shorter than read bytes: %d < %d", len(content), readBytes)
289 }
290
291 part := content[readBytes:]
292 // Trim leading whitespace. Sometimes the LLM includes leading
293 // formatting and intentation, which we don't want here.
294 if readBytes == 0 {
295 part = strings.TrimLeft(part, " \t")
296 }
297 fmt.Fprint(output, part)
298 messageReadBytes[msg.ID] = len(content)
299 }
300
301 case <-ctx.Done():
302 stopSpinner()
303 return ctx.Err()
304 }
305 }
306}
307
308func (app *App) UpdateAgentModel(ctx context.Context) error {
309 if app.AgentCoordinator == nil {
310 return fmt.Errorf("agent configuration is missing")
311 }
312 return app.AgentCoordinator.UpdateModels(ctx)
313}
314
315// overrideModelsForNonInteractive parses the model strings and temporarily
316// overrides the model configurations, then rebuilds the agent.
317// Format: "model-name" (searches all providers) or "provider/model-name".
318// Model matching is case-insensitive.
319// If largeModel is provided but smallModel is not, the small model defaults to
320// the provider's default small model.
321func (app *App) overrideModelsForNonInteractive(ctx context.Context, largeModel, smallModel string) error {
322 providers := app.config.Providers.Copy()
323
324 largeMatches, smallMatches, err := findModels(providers, largeModel, smallModel)
325 if err != nil {
326 return err
327 }
328
329 var largeProviderID string
330
331 // Override large model.
332 if largeModel != "" {
333 found, err := validateMatches(largeMatches, largeModel, "large")
334 if err != nil {
335 return err
336 }
337 largeProviderID = found.provider
338 slog.Info("Overriding large model for non-interactive run", "provider", found.provider, "model", found.modelID)
339 app.config.Models[config.SelectedModelTypeLarge] = config.SelectedModel{
340 Provider: found.provider,
341 Model: found.modelID,
342 }
343 }
344
345 // Override small model.
346 switch {
347 case smallModel != "":
348 found, err := validateMatches(smallMatches, smallModel, "small")
349 if err != nil {
350 return err
351 }
352 slog.Info("Overriding small model for non-interactive run", "provider", found.provider, "model", found.modelID)
353 app.config.Models[config.SelectedModelTypeSmall] = config.SelectedModel{
354 Provider: found.provider,
355 Model: found.modelID,
356 }
357
358 case largeModel != "":
359 // No small model specified, but large model was - use provider's default.
360 smallCfg := app.GetDefaultSmallModel(largeProviderID)
361 app.config.Models[config.SelectedModelTypeSmall] = smallCfg
362 }
363
364 return app.AgentCoordinator.UpdateModels(ctx)
365}
366
367// GetDefaultSmallModel returns the default small model for the given
368// provider. Falls back to the large model if no default is found.
369func (app *App) GetDefaultSmallModel(providerID string) config.SelectedModel {
370 cfg := app.config
371 largeModelCfg := cfg.Models[config.SelectedModelTypeLarge]
372
373 // Find the provider in the known providers list to get its default small model.
374 knownProviders, _ := config.Providers(cfg)
375 var knownProvider *catwalk.Provider
376 for _, p := range knownProviders {
377 if string(p.ID) == providerID {
378 knownProvider = &p
379 break
380 }
381 }
382
383 // For unknown/local providers, use the large model as small.
384 if knownProvider == nil {
385 slog.Warn("Using large model as small model for unknown provider", "provider", providerID, "model", largeModelCfg.Model)
386 return largeModelCfg
387 }
388
389 defaultSmallModelID := knownProvider.DefaultSmallModelID
390 model := cfg.GetModel(providerID, defaultSmallModelID)
391 if model == nil {
392 slog.Warn("Default small model not found, using large model", "provider", providerID, "model", largeModelCfg.Model)
393 return largeModelCfg
394 }
395
396 slog.Info("Using provider default small model", "provider", providerID, "model", defaultSmallModelID)
397 return config.SelectedModel{
398 Provider: providerID,
399 Model: defaultSmallModelID,
400 MaxTokens: model.DefaultMaxTokens,
401 ReasoningEffort: model.DefaultReasoningEffort,
402 }
403}
404
405func (app *App) setupEvents() {
406 ctx, cancel := context.WithCancel(app.globalCtx)
407 app.eventsCtx = ctx
408 setupSubscriber(ctx, app.serviceEventsWG, "sessions", app.Sessions.Subscribe, app.events)
409 setupSubscriber(ctx, app.serviceEventsWG, "messages", app.Messages.Subscribe, app.events)
410 setupSubscriber(ctx, app.serviceEventsWG, "permissions", app.Permissions.Subscribe, app.events)
411 setupSubscriber(ctx, app.serviceEventsWG, "permissions-notifications", app.Permissions.SubscribeNotifications, app.events)
412 setupSubscriber(ctx, app.serviceEventsWG, "history", app.History.Subscribe, app.events)
413 setupSubscriber(ctx, app.serviceEventsWG, "mcp", mcp.SubscribeEvents, app.events)
414 setupSubscriber(ctx, app.serviceEventsWG, "lsp", SubscribeLSPEvents, app.events)
415 cleanupFunc := func() error {
416 cancel()
417 app.serviceEventsWG.Wait()
418 return nil
419 }
420 app.cleanupFuncs = append(app.cleanupFuncs, cleanupFunc)
421}
422
423func setupSubscriber[T any](
424 ctx context.Context,
425 wg *sync.WaitGroup,
426 name string,
427 subscriber func(context.Context) <-chan pubsub.Event[T],
428 outputCh chan<- tea.Msg,
429) {
430 wg.Go(func() {
431 subCh := subscriber(ctx)
432 for {
433 select {
434 case event, ok := <-subCh:
435 if !ok {
436 slog.Debug("subscription channel closed", "name", name)
437 return
438 }
439 var msg tea.Msg = event
440 select {
441 case outputCh <- msg:
442 case <-time.After(2 * time.Second):
443 slog.Warn("message dropped due to slow consumer", "name", name)
444 case <-ctx.Done():
445 slog.Debug("subscription cancelled", "name", name)
446 return
447 }
448 case <-ctx.Done():
449 slog.Debug("subscription cancelled", "name", name)
450 return
451 }
452 }
453 })
454}
455
456func (app *App) InitCoderAgent(ctx context.Context) error {
457 coderAgentCfg := app.config.Agents[config.AgentCoder]
458 if coderAgentCfg.ID == "" {
459 return fmt.Errorf("coder agent configuration is missing")
460 }
461 var err error
462 app.AgentCoordinator, err = agent.NewCoordinator(
463 ctx,
464 app.config,
465 app.Sessions,
466 app.Messages,
467 app.Permissions,
468 app.History,
469 app.FileTracker,
470 app.LSPClients,
471 )
472 if err != nil {
473 slog.Error("Failed to create coder agent", "err", err)
474 return err
475 }
476 return nil
477}
478
479// Subscribe sends events to the TUI as tea.Msgs.
480func (app *App) Subscribe(program *tea.Program) {
481 defer log.RecoverPanic("app.Subscribe", func() {
482 slog.Info("TUI subscription panic: attempting graceful shutdown")
483 program.Quit()
484 })
485
486 app.tuiWG.Add(1)
487 tuiCtx, tuiCancel := context.WithCancel(app.globalCtx)
488 app.cleanupFuncs = append(app.cleanupFuncs, func() error {
489 slog.Debug("Cancelling TUI message handler")
490 tuiCancel()
491 app.tuiWG.Wait()
492 return nil
493 })
494 defer app.tuiWG.Done()
495
496 for {
497 select {
498 case <-tuiCtx.Done():
499 slog.Debug("TUI message handler shutting down")
500 return
501 case msg, ok := <-app.events:
502 if !ok {
503 slog.Debug("TUI message channel closed")
504 return
505 }
506 program.Send(msg)
507 }
508 }
509}
510
511// Shutdown performs a graceful shutdown of the application.
512func (app *App) Shutdown() {
513 start := time.Now()
514 defer func() { slog.Info("Shutdown took " + time.Since(start).String()) }()
515
516 // First, cancel all agents and wait for them to finish. This must complete
517 // before closing the DB so agents can finish writing their state.
518 if app.AgentCoordinator != nil {
519 app.AgentCoordinator.CancelAll()
520 }
521
522 // Now run remaining cleanup tasks in parallel.
523 var wg sync.WaitGroup
524
525 // Kill all background shells.
526 wg.Go(func() {
527 shell.GetBackgroundShellManager().KillAll()
528 })
529
530 // Shutdown all LSP clients.
531 shutdownCtx, cancel := context.WithTimeout(app.globalCtx, 5*time.Second)
532 defer cancel()
533 for name, client := range app.LSPClients.Seq2() {
534 wg.Go(func() {
535 if err := client.Close(shutdownCtx); err != nil &&
536 !errors.Is(err, io.EOF) &&
537 !errors.Is(err, context.Canceled) &&
538 err.Error() != "signal: killed" {
539 slog.Warn("Failed to shutdown LSP client", "name", name, "error", err)
540 }
541 })
542 }
543
544 // Call all cleanup functions.
545 for _, cleanup := range app.cleanupFuncs {
546 if cleanup != nil {
547 wg.Go(func() {
548 if err := cleanup(); err != nil {
549 slog.Error("Failed to cleanup app properly on shutdown", "error", err)
550 }
551 })
552 }
553 }
554 wg.Wait()
555}
556
557// checkForUpdates checks for available updates.
558func (app *App) checkForUpdates(ctx context.Context) {
559 checkCtx, cancel := context.WithTimeout(ctx, 30*time.Second)
560 defer cancel()
561
562 info, err := update.Check(checkCtx, version.Version, update.Default)
563 if err != nil || !info.Available() {
564 return
565 }
566 app.events <- UpdateAvailableMsg{
567 CurrentVersion: info.Current,
568 LatestVersion: info.Latest,
569 IsDevelopment: info.IsDevelopment(),
570 }
571}