1package messages
2
3import (
4 "encoding/json"
5 "fmt"
6 "strings"
7 "time"
8
9 "github.com/charmbracelet/crush/internal/diff"
10 "github.com/charmbracelet/crush/internal/fileutil"
11 "github.com/charmbracelet/crush/internal/highlight"
12 "github.com/charmbracelet/crush/internal/llm/agent"
13 "github.com/charmbracelet/crush/internal/llm/tools"
14 "github.com/charmbracelet/crush/internal/tui/styles"
15 "github.com/charmbracelet/lipgloss/v2"
16 "github.com/charmbracelet/lipgloss/v2/tree"
17 "github.com/charmbracelet/x/ansi"
18)
19
20// responseContextHeight limits the number of lines displayed in tool output
21const responseContextHeight = 10
22
23// renderer defines the interface for tool-specific rendering implementations
24type renderer interface {
25 // Render returns the complete (already styled) tool‑call view, not
26 // including the outer border.
27 Render(v *toolCallCmp) string
28}
29
30// rendererFactory creates new renderer instances
31type rendererFactory func() renderer
32
33// renderRegistry manages the mapping of tool names to their renderers
34type renderRegistry map[string]rendererFactory
35
36// register adds a new renderer factory to the registry
37func (rr renderRegistry) register(name string, f rendererFactory) { rr[name] = f }
38
39// lookup retrieves a renderer for the given tool name, falling back to generic renderer
40func (rr renderRegistry) lookup(name string) renderer {
41 if f, ok := rr[name]; ok {
42 return f()
43 }
44 return genericRenderer{} // sensible fallback
45}
46
47// registry holds all registered tool renderers
48var registry = renderRegistry{}
49
50// baseRenderer provides common functionality for all tool renderers
51type baseRenderer struct{}
52
53// paramBuilder helps construct parameter lists for tool headers
54type paramBuilder struct {
55 args []string
56}
57
58// newParamBuilder creates a new parameter builder
59func newParamBuilder() *paramBuilder {
60 return ¶mBuilder{args: make([]string, 0)}
61}
62
63// addMain adds the main parameter (first argument)
64func (pb *paramBuilder) addMain(value string) *paramBuilder {
65 if value != "" {
66 pb.args = append(pb.args, value)
67 }
68 return pb
69}
70
71// addKeyValue adds a key-value pair parameter
72func (pb *paramBuilder) addKeyValue(key, value string) *paramBuilder {
73 if value != "" {
74 pb.args = append(pb.args, key, value)
75 }
76 return pb
77}
78
79// addFlag adds a boolean flag parameter
80func (pb *paramBuilder) addFlag(key string, value bool) *paramBuilder {
81 if value {
82 pb.args = append(pb.args, key, "true")
83 }
84 return pb
85}
86
87// build returns the final parameter list
88func (pb *paramBuilder) build() []string {
89 return pb.args
90}
91
92// renderWithParams provides a common rendering pattern for tools with parameters
93func (br baseRenderer) renderWithParams(v *toolCallCmp, toolName string, args []string, contentRenderer func() string) string {
94 width := v.textWidth()
95 if v.isNested {
96 width -= 4 // Adjust for nested tool call indentation
97 }
98 header := br.makeHeader(v, toolName, width, args...)
99 if v.isNested {
100 return v.style().Render(header)
101 }
102 if res, done := earlyState(header, v); done {
103 return res
104 }
105 body := contentRenderer()
106 return joinHeaderBody(header, body)
107}
108
109// unmarshalParams safely unmarshal JSON parameters
110func (br baseRenderer) unmarshalParams(input string, target any) error {
111 return json.Unmarshal([]byte(input), target)
112}
113
114// makeHeader builds "<Tool>: param (key=value)" and truncates as needed.
115func (br baseRenderer) makeHeader(v *toolCallCmp, tool string, width int, params ...string) string {
116 t := styles.CurrentTheme()
117 icon := t.S().Base.Foreground(t.GreenDark).Render(styles.ToolPending)
118 if v.result.ToolCallID != "" {
119 if v.result.IsError {
120 icon = t.S().Base.Foreground(t.RedDark).Render(styles.ToolError)
121 } else {
122 icon = t.S().Base.Foreground(t.Green).Render(styles.ToolSuccess)
123 }
124 } else if v.cancelled {
125 icon = t.S().Muted.Render(styles.ToolPending)
126 }
127 tool = t.S().Base.Foreground(t.Blue).Render(tool)
128 prefix := fmt.Sprintf("%s %s: ", icon, tool)
129 return prefix + renderParamList(width-lipgloss.Width(prefix), params...)
130}
131
132// renderError provides consistent error rendering
133func (br baseRenderer) renderError(v *toolCallCmp, message string) string {
134 t := styles.CurrentTheme()
135 header := br.makeHeader(v, prettifyToolName(v.call.Name), v.textWidth(), "")
136 message = t.S().Error.Render(v.fit(message, v.textWidth()-2)) // -2 for padding
137 return joinHeaderBody(header, message)
138}
139
140// Register tool renderers
141func init() {
142 registry.register(tools.BashToolName, func() renderer { return bashRenderer{} })
143 registry.register(tools.ViewToolName, func() renderer { return viewRenderer{} })
144 registry.register(tools.EditToolName, func() renderer { return editRenderer{} })
145 registry.register(tools.WriteToolName, func() renderer { return writeRenderer{} })
146 registry.register(tools.FetchToolName, func() renderer { return fetchRenderer{} })
147 registry.register(tools.GlobToolName, func() renderer { return globRenderer{} })
148 registry.register(tools.GrepToolName, func() renderer { return grepRenderer{} })
149 registry.register(tools.LSToolName, func() renderer { return lsRenderer{} })
150 registry.register(tools.SourcegraphToolName, func() renderer { return sourcegraphRenderer{} })
151 registry.register(tools.PatchToolName, func() renderer { return patchRenderer{} })
152 registry.register(tools.DiagnosticsToolName, func() renderer { return diagnosticsRenderer{} })
153 registry.register(agent.AgentToolName, func() renderer { return agentRenderer{} })
154}
155
156// -----------------------------------------------------------------------------
157// Generic renderer
158// -----------------------------------------------------------------------------
159
160// genericRenderer handles unknown tool types with basic parameter display
161type genericRenderer struct {
162 baseRenderer
163}
164
165// Render displays the tool call with its raw input and plain content output
166func (gr genericRenderer) Render(v *toolCallCmp) string {
167 return gr.renderWithParams(v, prettifyToolName(v.call.Name), []string{v.call.Input}, func() string {
168 return renderPlainContent(v, v.result.Content)
169 })
170}
171
172// -----------------------------------------------------------------------------
173// Bash renderer
174// -----------------------------------------------------------------------------
175
176// bashRenderer handles bash command execution display
177type bashRenderer struct {
178 baseRenderer
179}
180
181// Render displays the bash command with sanitized newlines and plain output
182func (br bashRenderer) Render(v *toolCallCmp) string {
183 var params tools.BashParams
184 if err := br.unmarshalParams(v.call.Input, ¶ms); err != nil {
185 return br.renderError(v, "Invalid bash parameters")
186 }
187
188 cmd := strings.ReplaceAll(params.Command, "\n", " ")
189 args := newParamBuilder().addMain(cmd).build()
190
191 return br.renderWithParams(v, "Bash", args, func() string {
192 return renderPlainContent(v, v.result.Content)
193 })
194}
195
196// -----------------------------------------------------------------------------
197// View renderer
198// -----------------------------------------------------------------------------
199
200// viewRenderer handles file viewing with syntax highlighting and line numbers
201type viewRenderer struct {
202 baseRenderer
203}
204
205// Render displays file content with optional limit and offset parameters
206func (vr viewRenderer) Render(v *toolCallCmp) string {
207 var params tools.ViewParams
208 if err := vr.unmarshalParams(v.call.Input, ¶ms); err != nil {
209 return vr.renderError(v, "Invalid view parameters")
210 }
211
212 file := fileutil.PrettyPath(params.FilePath)
213 args := newParamBuilder().
214 addMain(file).
215 addKeyValue("limit", formatNonZero(params.Limit)).
216 addKeyValue("offset", formatNonZero(params.Offset)).
217 build()
218
219 return vr.renderWithParams(v, "View", args, func() string {
220 var meta tools.ViewResponseMetadata
221 if err := vr.unmarshalParams(v.result.Metadata, &meta); err != nil {
222 return renderPlainContent(v, v.result.Content)
223 }
224 return renderCodeContent(v, meta.FilePath, meta.Content, params.Offset)
225 })
226}
227
228// formatNonZero returns string representation of non-zero integers, empty string for zero
229func formatNonZero(value int) string {
230 if value == 0 {
231 return ""
232 }
233 return fmt.Sprintf("%d", value)
234}
235
236// -----------------------------------------------------------------------------
237// Edit renderer
238// -----------------------------------------------------------------------------
239
240// editRenderer handles file editing with diff visualization
241type editRenderer struct {
242 baseRenderer
243}
244
245// Render displays the edited file with a formatted diff of changes
246func (er editRenderer) Render(v *toolCallCmp) string {
247 var params tools.EditParams
248 if err := er.unmarshalParams(v.call.Input, ¶ms); err != nil {
249 return er.renderError(v, "Invalid edit parameters")
250 }
251
252 file := fileutil.PrettyPath(params.FilePath)
253 args := newParamBuilder().addMain(file).build()
254
255 return er.renderWithParams(v, "Edit", args, func() string {
256 var meta tools.EditResponseMetadata
257 if err := er.unmarshalParams(v.result.Metadata, &meta); err != nil {
258 return renderPlainContent(v, v.result.Content)
259 }
260
261 trunc := truncateHeight(meta.Diff, responseContextHeight)
262 diffView, _ := diff.FormatDiff(trunc, diff.WithTotalWidth(v.textWidth()-2))
263 return diffView
264 })
265}
266
267// -----------------------------------------------------------------------------
268// Write renderer
269// -----------------------------------------------------------------------------
270
271// writeRenderer handles file writing with syntax-highlighted content preview
272type writeRenderer struct {
273 baseRenderer
274}
275
276// Render displays the file being written with syntax highlighting
277func (wr writeRenderer) Render(v *toolCallCmp) string {
278 var params tools.WriteParams
279 if err := wr.unmarshalParams(v.call.Input, ¶ms); err != nil {
280 return wr.renderError(v, "Invalid write parameters")
281 }
282
283 file := fileutil.PrettyPath(params.FilePath)
284 args := newParamBuilder().addMain(file).build()
285
286 return wr.renderWithParams(v, "Write", args, func() string {
287 return renderCodeContent(v, file, params.Content, 0)
288 })
289}
290
291// -----------------------------------------------------------------------------
292// Fetch renderer
293// -----------------------------------------------------------------------------
294
295// fetchRenderer handles URL fetching with format-specific content display
296type fetchRenderer struct {
297 baseRenderer
298}
299
300// Render displays the fetched URL with format and timeout parameters
301func (fr fetchRenderer) Render(v *toolCallCmp) string {
302 var params tools.FetchParams
303 if err := fr.unmarshalParams(v.call.Input, ¶ms); err != nil {
304 return fr.renderError(v, "Invalid fetch parameters")
305 }
306
307 args := newParamBuilder().
308 addMain(params.URL).
309 addKeyValue("format", params.Format).
310 addKeyValue("timeout", formatTimeout(params.Timeout)).
311 build()
312
313 return fr.renderWithParams(v, "Fetch", args, func() string {
314 file := fr.getFileExtension(params.Format)
315 return renderCodeContent(v, file, v.result.Content, 0)
316 })
317}
318
319// getFileExtension returns appropriate file extension for syntax highlighting
320func (fr fetchRenderer) getFileExtension(format string) string {
321 switch format {
322 case "text":
323 return "fetch.txt"
324 case "html":
325 return "fetch.html"
326 default:
327 return "fetch.md"
328 }
329}
330
331// formatTimeout converts timeout seconds to duration string
332func formatTimeout(timeout int) string {
333 if timeout == 0 {
334 return ""
335 }
336 return (time.Duration(timeout) * time.Second).String()
337}
338
339// -----------------------------------------------------------------------------
340// Glob renderer
341// -----------------------------------------------------------------------------
342
343// globRenderer handles file pattern matching with path filtering
344type globRenderer struct {
345 baseRenderer
346}
347
348// Render displays the glob pattern with optional path parameter
349func (gr globRenderer) Render(v *toolCallCmp) string {
350 var params tools.GlobParams
351 if err := gr.unmarshalParams(v.call.Input, ¶ms); err != nil {
352 return gr.renderError(v, "Invalid glob parameters")
353 }
354
355 args := newParamBuilder().
356 addMain(params.Pattern).
357 addKeyValue("path", params.Path).
358 build()
359
360 return gr.renderWithParams(v, "Glob", args, func() string {
361 return renderPlainContent(v, v.result.Content)
362 })
363}
364
365// -----------------------------------------------------------------------------
366// Grep renderer
367// -----------------------------------------------------------------------------
368
369// grepRenderer handles content searching with pattern matching options
370type grepRenderer struct {
371 baseRenderer
372}
373
374// Render displays the search pattern with path, include, and literal text options
375func (gr grepRenderer) Render(v *toolCallCmp) string {
376 var params tools.GrepParams
377 if err := gr.unmarshalParams(v.call.Input, ¶ms); err != nil {
378 return gr.renderError(v, "Invalid grep parameters")
379 }
380
381 args := newParamBuilder().
382 addMain(params.Pattern).
383 addKeyValue("path", params.Path).
384 addKeyValue("include", params.Include).
385 addFlag("literal", params.LiteralText).
386 build()
387
388 return gr.renderWithParams(v, "Grep", args, func() string {
389 return renderPlainContent(v, v.result.Content)
390 })
391}
392
393// -----------------------------------------------------------------------------
394// LS renderer
395// -----------------------------------------------------------------------------
396
397// lsRenderer handles directory listing with default path handling
398type lsRenderer struct {
399 baseRenderer
400}
401
402// Render displays the directory path, defaulting to current directory
403func (lr lsRenderer) Render(v *toolCallCmp) string {
404 var params tools.LSParams
405 if err := lr.unmarshalParams(v.call.Input, ¶ms); err != nil {
406 return lr.renderError(v, "Invalid ls parameters")
407 }
408
409 path := params.Path
410 if path == "" {
411 path = "."
412 }
413 path = fileutil.PrettyPath(path)
414
415 args := newParamBuilder().addMain(path).build()
416
417 return lr.renderWithParams(v, "List", args, func() string {
418 return renderPlainContent(v, v.result.Content)
419 })
420}
421
422// -----------------------------------------------------------------------------
423// Sourcegraph renderer
424// -----------------------------------------------------------------------------
425
426// sourcegraphRenderer handles code search with count and context options
427type sourcegraphRenderer struct {
428 baseRenderer
429}
430
431// Render displays the search query with optional count and context window parameters
432func (sr sourcegraphRenderer) Render(v *toolCallCmp) string {
433 var params tools.SourcegraphParams
434 if err := sr.unmarshalParams(v.call.Input, ¶ms); err != nil {
435 return sr.renderError(v, "Invalid sourcegraph parameters")
436 }
437
438 args := newParamBuilder().
439 addMain(params.Query).
440 addKeyValue("count", formatNonZero(params.Count)).
441 addKeyValue("context", formatNonZero(params.ContextWindow)).
442 build()
443
444 return sr.renderWithParams(v, "Sourcegraph", args, func() string {
445 return renderPlainContent(v, v.result.Content)
446 })
447}
448
449// -----------------------------------------------------------------------------
450// Patch renderer
451// -----------------------------------------------------------------------------
452
453// patchRenderer handles multi-file patches with change summaries
454type patchRenderer struct {
455 baseRenderer
456}
457
458// Render displays patch summary with file count and change statistics
459func (pr patchRenderer) Render(v *toolCallCmp) string {
460 var params tools.PatchParams
461 if err := pr.unmarshalParams(v.call.Input, ¶ms); err != nil {
462 return pr.renderError(v, "Invalid patch parameters")
463 }
464
465 args := newParamBuilder().addMain("multiple files").build()
466
467 return pr.renderWithParams(v, "Patch", args, func() string {
468 var meta tools.PatchResponseMetadata
469 if err := pr.unmarshalParams(v.result.Metadata, &meta); err != nil {
470 return renderPlainContent(v, v.result.Content)
471 }
472
473 summary := fmt.Sprintf("Changed %d files (%d+ %d-)",
474 len(meta.FilesChanged), meta.Additions, meta.Removals)
475 filesList := strings.Join(meta.FilesChanged, "\n")
476
477 return renderPlainContent(v, summary+"\n\n"+filesList)
478 })
479}
480
481// -----------------------------------------------------------------------------
482// Diagnostics renderer
483// -----------------------------------------------------------------------------
484
485// diagnosticsRenderer handles project-wide diagnostic information
486type diagnosticsRenderer struct {
487 baseRenderer
488}
489
490// Render displays project diagnostics with plain content formatting
491func (dr diagnosticsRenderer) Render(v *toolCallCmp) string {
492 args := newParamBuilder().addMain("project").build()
493
494 return dr.renderWithParams(v, "Diagnostics", args, func() string {
495 return renderPlainContent(v, v.result.Content)
496 })
497}
498
499// -----------------------------------------------------------------------------
500// Task renderer
501// -----------------------------------------------------------------------------
502
503// agentRenderer handles project-wide diagnostic information
504type agentRenderer struct {
505 baseRenderer
506}
507
508// Render displays agent task parameters and result content
509func (tr agentRenderer) Render(v *toolCallCmp) string {
510 var params agent.AgentParams
511 if err := tr.unmarshalParams(v.call.Input, ¶ms); err != nil {
512 return tr.renderError(v, "Invalid task parameters")
513 }
514 prompt := params.Prompt
515 prompt = strings.ReplaceAll(prompt, "\n", " ")
516 args := newParamBuilder().addMain(prompt).build()
517
518 header := tr.makeHeader(v, "Task", v.textWidth(), args...)
519 t := tree.Root(header)
520
521 for _, call := range v.nestedToolCalls {
522 t.Child(call.View())
523 }
524
525 parts := []string{
526 t.Enumerator(tree.RoundedEnumerator).String(),
527 }
528 if v.result.ToolCallID == "" {
529 v.spinning = true
530 parts = append(parts, v.anim.View().String())
531 } else {
532 v.spinning = false
533 }
534
535 header = lipgloss.JoinVertical(
536 lipgloss.Left,
537 parts...,
538 )
539
540 if v.result.ToolCallID == "" {
541 return header
542 }
543
544 body := renderPlainContent(v, v.result.Content)
545 return joinHeaderBody(header, body)
546}
547
548// renderParamList renders params, params[0] (params[1]=params[2] ....)
549func renderParamList(paramsWidth int, params ...string) string {
550 if len(params) == 0 {
551 return ""
552 }
553 mainParam := params[0]
554 if len(mainParam) > paramsWidth {
555 mainParam = mainParam[:paramsWidth-3] + "..."
556 }
557
558 if len(params) == 1 {
559 return mainParam
560 }
561 otherParams := params[1:]
562 // create pairs of key/value
563 // if odd number of params, the last one is a key without value
564 if len(otherParams)%2 != 0 {
565 otherParams = append(otherParams, "")
566 }
567 parts := make([]string, 0, len(otherParams)/2)
568 for i := 0; i < len(otherParams); i += 2 {
569 key := otherParams[i]
570 value := otherParams[i+1]
571 if value == "" {
572 continue
573 }
574 parts = append(parts, fmt.Sprintf("%s=%s", key, value))
575 }
576
577 partsRendered := strings.Join(parts, ", ")
578 remainingWidth := paramsWidth - lipgloss.Width(partsRendered) - 3 // count for " ()"
579 if remainingWidth < 30 {
580 // No space for the params, just show the main
581 return mainParam
582 }
583
584 if len(parts) > 0 {
585 mainParam = fmt.Sprintf("%s (%s)", mainParam, strings.Join(parts, ", "))
586 }
587
588 return ansi.Truncate(mainParam, paramsWidth, "...")
589}
590
591// earlyState returns immediately‑rendered error/cancelled/ongoing states.
592func earlyState(header string, v *toolCallCmp) (string, bool) {
593 t := styles.CurrentTheme()
594 message := ""
595 switch {
596 case v.result.IsError:
597 message = v.renderToolError()
598 case v.cancelled:
599 message = "Cancelled"
600 case v.result.ToolCallID == "":
601 message = "Waiting for tool to start..."
602 default:
603 return "", false
604 }
605
606 message = t.S().Base.PaddingLeft(2).Render(message)
607 return lipgloss.JoinVertical(lipgloss.Left, header, message), true
608}
609
610func joinHeaderBody(header, body string) string {
611 t := styles.CurrentTheme()
612 body = t.S().Base.PaddingLeft(2).Render(body)
613 return lipgloss.JoinVertical(lipgloss.Left, header, body, "")
614}
615
616func renderPlainContent(v *toolCallCmp, content string) string {
617 t := styles.CurrentTheme()
618 content = strings.TrimSpace(content)
619 lines := strings.Split(content, "\n")
620
621 width := v.textWidth() - 2 // -2 for left padding
622 var out []string
623 for i, ln := range lines {
624 if i >= responseContextHeight {
625 break
626 }
627 ln = " " + ln // left padding
628 if len(ln) > width {
629 ln = v.fit(ln, width)
630 }
631 out = append(out, t.S().Muted.
632 Width(width).
633 Background(t.BgSubtle).
634 Render(ln))
635 }
636
637 if len(lines) > responseContextHeight {
638 out = append(out, t.S().Muted.
639 Background(t.BgSubtle).
640 Width(width).
641 Render(fmt.Sprintf("... (%d lines)", len(lines)-responseContextHeight)))
642 }
643 return strings.Join(out, "\n")
644}
645
646func renderCodeContent(v *toolCallCmp, path, content string, offset int) string {
647 t := styles.CurrentTheme()
648 truncated := truncateHeight(content, responseContextHeight)
649
650 highlighted, _ := highlight.SyntaxHighlight(truncated, path, t.BgSubtle)
651 lines := strings.Split(highlighted, "\n")
652
653 if len(strings.Split(content, "\n")) > responseContextHeight {
654 lines = append(lines, t.S().Muted.
655 Background(t.BgSubtle).
656 Width(v.textWidth()-2).
657 Render(fmt.Sprintf("... (%d lines)", len(strings.Split(content, "\n"))-responseContextHeight)))
658 }
659
660 for i, ln := range lines {
661 num := t.S().Muted.
662 Background(t.BgSubtle).
663 PaddingLeft(4).
664 PaddingRight(2).
665 Render(fmt.Sprintf("%d", i+1+offset))
666 w := v.textWidth() - 2 - lipgloss.Width(num) // -2 for left padding
667 lines[i] = lipgloss.JoinHorizontal(lipgloss.Left,
668 num,
669 t.S().Base.
670 Width(w).
671 Background(t.BgSubtle).
672 Render(v.fit(ln, w)))
673 }
674 return lipgloss.JoinVertical(lipgloss.Left, lines...)
675}
676
677func (v *toolCallCmp) renderToolError() string {
678 t := styles.CurrentTheme()
679 err := strings.ReplaceAll(v.result.Content, "\n", " ")
680 err = fmt.Sprintf("Error: %s", err)
681 return t.S().Base.Foreground(t.Error).Render(v.fit(err, v.textWidth()))
682}
683
684func truncateHeight(s string, h int) string {
685 lines := strings.Split(s, "\n")
686 if len(lines) > h {
687 return strings.Join(lines[:h], "\n")
688 }
689 return s
690}
691
692func prettifyToolName(name string) string {
693 switch name {
694 case agent.AgentToolName:
695 return "Task"
696 case tools.BashToolName:
697 return "Bash"
698 case tools.EditToolName:
699 return "Edit"
700 case tools.FetchToolName:
701 return "Fetch"
702 case tools.GlobToolName:
703 return "Glob"
704 case tools.GrepToolName:
705 return "Grep"
706 case tools.LSToolName:
707 return "List"
708 case tools.SourcegraphToolName:
709 return "Sourcegraph"
710 case tools.ViewToolName:
711 return "View"
712 case tools.WriteToolName:
713 return "Write"
714 case tools.PatchToolName:
715 return "Patch"
716 default:
717 return name
718 }
719}