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