app.go

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