8 "github.com/charmbracelet/catwalk/pkg/catwalk"
11type MessageRole string
14 Assistant MessageRole = "assistant"
15 User MessageRole = "user"
16 System MessageRole = "system"
17 Tool MessageRole = "tool"
20type FinishReason string
23 FinishReasonEndTurn FinishReason = "end_turn"
24 FinishReasonMaxTokens FinishReason = "max_tokens"
25 FinishReasonToolUse FinishReason = "tool_use"
26 FinishReasonCanceled FinishReason = "canceled"
27 FinishReasonError FinishReason = "error"
28 FinishReasonPermissionDenied FinishReason = "permission_denied"
30 // Should never happen
31 FinishReasonUnknown FinishReason = "unknown"
34type ContentPart interface {
38type ReasoningContent struct {
39 Thinking string `json:"thinking"`
40 Signature string `json:"signature"`
41 StartedAt int64 `json:"started_at,omitempty"`
42 FinishedAt int64 `json:"finished_at,omitempty"`
45func (tc ReasoningContent) String() string {
48func (ReasoningContent) isPart() {}
50type TextContent struct {
51 Text string `json:"text"`
54func (tc TextContent) String() string {
58func (TextContent) isPart() {}
60type ImageURLContent struct {
61 URL string `json:"url"`
62 Detail string `json:"detail,omitempty"`
65func (iuc ImageURLContent) String() string {
69func (ImageURLContent) isPart() {}
71type BinaryContent struct {
77func (bc BinaryContent) String(p catwalk.InferenceProvider) string {
78 base64Encoded := base64.StdEncoding.EncodeToString(bc.Data)
79 if p == catwalk.InferenceProviderOpenAI {
80 return "data:" + bc.MIMEType + ";base64," + base64Encoded
85func (BinaryContent) isPart() {}
89 Name string `json:"name"`
90 Input string `json:"input"`
91 Type string `json:"type"`
92 Finished bool `json:"finished"`
95func (ToolCall) isPart() {}
97type ToolResult struct {
98 ToolCallID string `json:"tool_call_id"`
99 Name string `json:"name"`
100 Content string `json:"content"`
101 Metadata string `json:"metadata"`
102 IsError bool `json:"is_error"`
105func (ToolResult) isPart() {}
108 Reason FinishReason `json:"reason"`
109 Time int64 `json:"time"`
110 Message string `json:"message,omitempty"`
111 Details string `json:"details,omitempty"`
114func (Finish) isPart() {}
127func (m *Message) Content() TextContent {
128 for _, part := range m.Parts {
129 if c, ok := part.(TextContent); ok {
136func (m *Message) ReasoningContent() ReasoningContent {
137 for _, part := range m.Parts {
138 if c, ok := part.(ReasoningContent); ok {
142 return ReasoningContent{}
145func (m *Message) ImageURLContent() []ImageURLContent {
146 imageURLContents := make([]ImageURLContent, 0)
147 for _, part := range m.Parts {
148 if c, ok := part.(ImageURLContent); ok {
149 imageURLContents = append(imageURLContents, c)
152 return imageURLContents
155func (m *Message) BinaryContent() []BinaryContent {
156 binaryContents := make([]BinaryContent, 0)
157 for _, part := range m.Parts {
158 if c, ok := part.(BinaryContent); ok {
159 binaryContents = append(binaryContents, c)
162 return binaryContents
165func (m *Message) ToolCalls() []ToolCall {
166 toolCalls := make([]ToolCall, 0)
167 for _, part := range m.Parts {
168 if c, ok := part.(ToolCall); ok {
169 toolCalls = append(toolCalls, c)
175func (m *Message) ToolResults() []ToolResult {
176 toolResults := make([]ToolResult, 0)
177 for _, part := range m.Parts {
178 if c, ok := part.(ToolResult); ok {
179 toolResults = append(toolResults, c)
185func (m *Message) IsFinished() bool {
186 for _, part := range m.Parts {
187 if _, ok := part.(Finish); ok {
194func (m *Message) FinishPart() *Finish {
195 for _, part := range m.Parts {
196 if c, ok := part.(Finish); ok {
203func (m *Message) FinishReason() FinishReason {
204 for _, part := range m.Parts {
205 if c, ok := part.(Finish); ok {
212func (m *Message) IsThinking() bool {
213 if m.ReasoningContent().Thinking != "" && m.Content().Text == "" && !m.IsFinished() {
219func (m *Message) AppendContent(delta string) {
221 for i, part := range m.Parts {
222 if c, ok := part.(TextContent); ok {
223 m.Parts[i] = TextContent{Text: c.Text + delta}
228 m.Parts = append(m.Parts, TextContent{Text: delta})
232func (m *Message) AppendReasoningContent(delta string) {
234 for i, part := range m.Parts {
235 if c, ok := part.(ReasoningContent); ok {
236 m.Parts[i] = ReasoningContent{
237 Thinking: c.Thinking + delta,
238 Signature: c.Signature,
239 StartedAt: c.StartedAt,
240 FinishedAt: c.FinishedAt,
246 m.Parts = append(m.Parts, ReasoningContent{
248 StartedAt: time.Now().Unix(),
253func (m *Message) AppendReasoningSignature(signature string) {
254 for i, part := range m.Parts {
255 if c, ok := part.(ReasoningContent); ok {
256 m.Parts[i] = ReasoningContent{
257 Thinking: c.Thinking,
258 Signature: c.Signature + signature,
259 StartedAt: c.StartedAt,
260 FinishedAt: c.FinishedAt,
265 m.Parts = append(m.Parts, ReasoningContent{Signature: signature})
268func (m *Message) FinishThinking() {
269 for i, part := range m.Parts {
270 if c, ok := part.(ReasoningContent); ok {
271 if c.FinishedAt == 0 {
272 m.Parts[i] = ReasoningContent{
273 Thinking: c.Thinking,
274 Signature: c.Signature,
275 StartedAt: c.StartedAt,
276 FinishedAt: time.Now().Unix(),
284func (m *Message) ThinkingDuration() time.Duration {
285 reasoning := m.ReasoningContent()
286 if reasoning.StartedAt == 0 {
290 endTime := reasoning.FinishedAt
292 endTime = time.Now().Unix()
295 return time.Duration(endTime-reasoning.StartedAt) * time.Second
298func (m *Message) FinishToolCall(toolCallID string) {
299 for i, part := range m.Parts {
300 if c, ok := part.(ToolCall); ok {
301 if c.ID == toolCallID {
302 m.Parts[i] = ToolCall{
315func (m *Message) AppendToolCallInput(toolCallID string, inputDelta string) {
316 for i, part := range m.Parts {
317 if c, ok := part.(ToolCall); ok {
318 if c.ID == toolCallID {
319 m.Parts[i] = ToolCall{
322 Input: c.Input + inputDelta,
324 Finished: c.Finished,
332func (m *Message) AddToolCall(tc ToolCall) {
333 for i, part := range m.Parts {
334 if c, ok := part.(ToolCall); ok {
341 m.Parts = append(m.Parts, tc)
344func (m *Message) SetToolCalls(tc []ToolCall) {
345 // remove any existing tool call part it could have multiple
346 parts := make([]ContentPart, 0)
347 for _, part := range m.Parts {
348 if _, ok := part.(ToolCall); ok {
351 parts = append(parts, part)
354 for _, toolCall := range tc {
355 m.Parts = append(m.Parts, toolCall)
359func (m *Message) AddToolResult(tr ToolResult) {
360 m.Parts = append(m.Parts, tr)
363func (m *Message) SetToolResults(tr []ToolResult) {
364 for _, toolResult := range tr {
365 m.Parts = append(m.Parts, toolResult)
369func (m *Message) AddFinish(reason FinishReason, message, details string) {
370 // remove any existing finish part
371 for i, part := range m.Parts {
372 if _, ok := part.(Finish); ok {
373 m.Parts = slices.Delete(m.Parts, i, i+1)
377 m.Parts = append(m.Parts, Finish{Reason: reason, Time: time.Now().Unix(), Message: message, Details: details})
380func (m *Message) AddImageURL(url, detail string) {
381 m.Parts = append(m.Parts, ImageURLContent{URL: url, Detail: detail})
384func (m *Message) AddBinary(mimeType string, data []byte) {
385 m.Parts = append(m.Parts, BinaryContent{MIMEType: mimeType, Data: data})
keysesc to close
- j k
- move down, up
- enter
- open
- esc
- back, or up a level
- 1 2 3 4
- readme, files, commits, refs
- /
- filter
- y
- copy the clone command
- c
- compare the chosen commit with another (or shift-click both)
- ?
- show or hide this list