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 "sync"
13 "time"
14
15 "charm.land/fantasy"
16 tea "github.com/charmbracelet/bubbletea/v2"
17 "github.com/charmbracelet/crush/internal/agent"
18 "github.com/charmbracelet/crush/internal/agent/tools"
19 "github.com/charmbracelet/crush/internal/config"
20 "github.com/charmbracelet/crush/internal/csync"
21 "github.com/charmbracelet/crush/internal/db"
22 "github.com/charmbracelet/crush/internal/format"
23 "github.com/charmbracelet/crush/internal/history"
24 "github.com/charmbracelet/crush/internal/log"
25 "github.com/charmbracelet/crush/internal/lsp"
26 "github.com/charmbracelet/crush/internal/message"
27 "github.com/charmbracelet/crush/internal/permission"
28 "github.com/charmbracelet/crush/internal/pubsub"
29 "github.com/charmbracelet/crush/internal/session"
30 "github.com/charmbracelet/x/ansi"
31)
32
33type App struct {
34 Sessions session.Service
35 Messages message.Service
36 History history.Service
37 Permissions permission.Service
38
39 AgentCoordinator agent.Coordinator
40
41 LSPClients *csync.Map[string, *lsp.Client]
42
43 config *config.Config
44
45 serviceEventsWG *sync.WaitGroup
46 eventsCtx context.Context
47 events chan tea.Msg
48 tuiWG *sync.WaitGroup
49
50 // global context and cleanup functions
51 globalCtx context.Context
52 cleanupFuncs []func() error
53}
54
55// New initializes a new applcation instance.
56func New(ctx context.Context, conn *sql.DB, cfg *config.Config) (*App, error) {
57 q := db.New(conn)
58 sessions := session.NewService(q)
59 messages := message.NewService(q)
60 files := history.NewService(q, conn)
61 skipPermissionsRequests := cfg.Permissions != nil && cfg.Permissions.SkipRequests
62 allowedTools := []string{}
63 if cfg.Permissions != nil && cfg.Permissions.AllowedTools != nil {
64 allowedTools = cfg.Permissions.AllowedTools
65 }
66
67 app := &App{
68 Sessions: sessions,
69 Messages: messages,
70 History: files,
71 Permissions: permission.NewPermissionService(cfg.WorkingDir(), skipPermissionsRequests, allowedTools),
72 LSPClients: csync.NewMap[string, *lsp.Client](),
73
74 globalCtx: ctx,
75
76 config: cfg,
77
78 events: make(chan tea.Msg, 100),
79 serviceEventsWG: &sync.WaitGroup{},
80 tuiWG: &sync.WaitGroup{},
81 }
82
83 app.setupEvents()
84
85 // Initialize LSP clients in the background.
86 app.initLSPClients(ctx)
87
88 // cleanup database upon app shutdown
89 app.cleanupFuncs = append(app.cleanupFuncs, conn.Close)
90
91 // TODO: remove the concept of agent config, most likely.
92 if !cfg.IsConfigured() {
93 slog.Warn("No agent configuration found")
94 return app, nil
95 }
96 if err := app.InitCoderAgent(ctx); err != nil {
97 return nil, fmt.Errorf("failed to initialize coder agent: %w", err)
98 }
99 return app, nil
100}
101
102// Config returns the application configuration.
103func (app *App) Config() *config.Config {
104 return app.config
105}
106
107// RunNonInteractive runs the application in non-interactive mode with the
108// given prompt, printing to stdout.
109func (app *App) RunNonInteractive(ctx context.Context, output io.Writer, prompt string, quiet bool) error {
110 slog.Info("Running in non-interactive mode")
111
112 ctx, cancel := context.WithCancel(ctx)
113 defer cancel()
114
115 var spinner *format.Spinner
116 if !quiet {
117 spinner = format.NewSpinner(ctx, cancel, "Generating")
118 spinner.Start()
119 }
120
121 // Helper function to stop spinner once.
122 stopSpinner := func() {
123 if !quiet && spinner != nil {
124 spinner.Stop()
125 spinner = nil
126 }
127 }
128 defer stopSpinner()
129
130 const maxPromptLengthForTitle = 100
131 const titlePrefix = "Non-interactive: "
132 var titleSuffix string
133
134 if len(prompt) > maxPromptLengthForTitle {
135 titleSuffix = prompt[:maxPromptLengthForTitle] + "..."
136 } else {
137 titleSuffix = prompt
138 }
139 title := titlePrefix + titleSuffix
140
141 sess, err := app.Sessions.Create(ctx, title)
142 if err != nil {
143 return fmt.Errorf("failed to create session for non-interactive mode: %w", err)
144 }
145 slog.Info("Created session for non-interactive run", "session_id", sess.ID)
146
147 // Automatically approve all permission requests for this non-interactive
148 // session.
149 app.Permissions.AutoApproveSession(sess.ID)
150
151 type response struct {
152 result *fantasy.AgentResult
153 err error
154 }
155 done := make(chan response, 1)
156
157 go func(ctx context.Context, sessionID, prompt string) {
158 result, err := app.AgentCoordinator.Run(ctx, sess.ID, prompt)
159 if err != nil {
160 done <- response{
161 err: fmt.Errorf("failed to start agent processing stream: %w", err),
162 }
163 }
164 done <- response{
165 result: result,
166 }
167 }(ctx, sess.ID, prompt)
168
169 messageEvents := app.Messages.Subscribe(ctx)
170 messageReadBytes := make(map[string]int)
171
172 defer func() {
173 _, _ = fmt.Printf(ansi.ResetProgressBar)
174
175 // Always print a newline at the end. If output is a TTY this will
176 // prevent the prompt from overwriting the last line of output.
177 _, _ = fmt.Fprintln(output)
178 }()
179
180 for {
181 // HACK: Reinitialize the terminal progress bar on every iteration so
182 // it doesn't get hidden by the terminal due to inactivity.
183 _, _ = fmt.Printf(ansi.SetIndeterminateProgressBar)
184
185 select {
186 case result := <-done:
187 stopSpinner()
188 if result.err != nil {
189 if errors.Is(result.err, context.Canceled) || errors.Is(result.err, agent.ErrRequestCancelled) {
190 slog.Info("Non-interactive: agent processing cancelled", "session_id", sess.ID)
191 return nil
192 }
193 return fmt.Errorf("agent processing failed: %w", result.err)
194 }
195 return nil
196
197 case event := <-messageEvents:
198 msg := event.Payload
199 if msg.SessionID == sess.ID && msg.Role == message.Assistant && len(msg.Parts) > 0 {
200 stopSpinner()
201
202 content := msg.Content().String()
203 readBytes := messageReadBytes[msg.ID]
204
205 if len(content) < readBytes {
206 slog.Error("Non-interactive: message content is shorter than read bytes", "message_length", len(content), "read_bytes", readBytes)
207 return fmt.Errorf("message content is shorter than read bytes: %d < %d", len(content), readBytes)
208 }
209
210 part := content[readBytes:]
211 fmt.Fprint(output, part)
212 messageReadBytes[msg.ID] = len(content)
213 }
214
215 case <-ctx.Done():
216 stopSpinner()
217 return ctx.Err()
218 }
219 }
220}
221
222func (app *App) UpdateAgentModel(ctx context.Context) error {
223 return app.AgentCoordinator.UpdateModels(ctx)
224}
225
226func (app *App) setupEvents() {
227 ctx, cancel := context.WithCancel(app.globalCtx)
228 app.eventsCtx = ctx
229 setupSubscriber(ctx, app.serviceEventsWG, "sessions", app.Sessions.Subscribe, app.events)
230 setupSubscriber(ctx, app.serviceEventsWG, "messages", app.Messages.Subscribe, app.events)
231 setupSubscriber(ctx, app.serviceEventsWG, "permissions", app.Permissions.Subscribe, app.events)
232 setupSubscriber(ctx, app.serviceEventsWG, "permissions-notifications", app.Permissions.SubscribeNotifications, app.events)
233 setupSubscriber(ctx, app.serviceEventsWG, "history", app.History.Subscribe, app.events)
234 setupSubscriber(ctx, app.serviceEventsWG, "mcp", tools.SubscribeMCPEvents, app.events)
235 setupSubscriber(ctx, app.serviceEventsWG, "lsp", SubscribeLSPEvents, app.events)
236 cleanupFunc := func() error {
237 cancel()
238 app.serviceEventsWG.Wait()
239 return nil
240 }
241 app.cleanupFuncs = append(app.cleanupFuncs, cleanupFunc)
242}
243
244func setupSubscriber[T any](
245 ctx context.Context,
246 wg *sync.WaitGroup,
247 name string,
248 subscriber func(context.Context) <-chan pubsub.Event[T],
249 outputCh chan<- tea.Msg,
250) {
251 wg.Go(func() {
252 subCh := subscriber(ctx)
253 for {
254 select {
255 case event, ok := <-subCh:
256 if !ok {
257 slog.Debug("subscription channel closed", "name", name)
258 return
259 }
260 var msg tea.Msg = event
261 select {
262 case outputCh <- msg:
263 case <-time.After(2 * time.Second):
264 slog.Warn("message dropped due to slow consumer", "name", name)
265 case <-ctx.Done():
266 slog.Debug("subscription cancelled", "name", name)
267 return
268 }
269 case <-ctx.Done():
270 slog.Debug("subscription cancelled", "name", name)
271 return
272 }
273 }
274 })
275}
276
277func (app *App) InitCoderAgent(ctx context.Context) error {
278 coderAgentCfg := app.config.Agents[config.AgentCoder]
279 if coderAgentCfg.ID == "" {
280 return fmt.Errorf("coder agent configuration is missing")
281 }
282 var err error
283 app.AgentCoordinator, err = agent.NewCoordinator(
284 ctx,
285 app.config,
286 app.Sessions,
287 app.Messages,
288 app.Permissions,
289 app.History,
290 app.LSPClients,
291 )
292 if err != nil {
293 slog.Error("Failed to create coder agent", "err", err)
294 return err
295 }
296
297 // Add MCP client cleanup to shutdown process
298 app.cleanupFuncs = append(app.cleanupFuncs, tools.CloseMCPClients)
299 return nil
300}
301
302// Subscribe sends events to the TUI as tea.Msgs.
303func (app *App) Subscribe(program *tea.Program) {
304 defer log.RecoverPanic("app.Subscribe", func() {
305 slog.Info("TUI subscription panic: attempting graceful shutdown")
306 program.Quit()
307 })
308
309 app.tuiWG.Add(1)
310 tuiCtx, tuiCancel := context.WithCancel(app.globalCtx)
311 app.cleanupFuncs = append(app.cleanupFuncs, func() error {
312 slog.Debug("Cancelling TUI message handler")
313 tuiCancel()
314 app.tuiWG.Wait()
315 return nil
316 })
317 defer app.tuiWG.Done()
318
319 for {
320 select {
321 case <-tuiCtx.Done():
322 slog.Debug("TUI message handler shutting down")
323 return
324 case msg, ok := <-app.events:
325 if !ok {
326 slog.Debug("TUI message channel closed")
327 return
328 }
329 program.Send(msg)
330 }
331 }
332}
333
334// Shutdown performs a graceful shutdown of the application.
335func (app *App) Shutdown() {
336 if app.AgentCoordinator != nil {
337 app.AgentCoordinator.CancelAll()
338 }
339
340 // Shutdown all LSP clients.
341 for name, client := range app.LSPClients.Seq2() {
342 shutdownCtx, cancel := context.WithTimeout(app.globalCtx, 5*time.Second)
343 if err := client.Close(shutdownCtx); err != nil {
344 slog.Error("Failed to shutdown LSP client", "name", name, "error", err)
345 }
346 cancel()
347 }
348
349 // Call call cleanup functions.
350 for _, cleanup := range app.cleanupFuncs {
351 if cleanup != nil {
352 if err := cleanup(); err != nil {
353 slog.Error("Failed to cleanup app properly on shutdown", "error", err)
354 }
355 }
356 }
357}