app.go

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