1package server
2
3import (
4 "encoding/json"
5 "fmt"
6 "log/slog"
7
8 "github.com/charmbracelet/crush/internal/agent/notify"
9 "github.com/charmbracelet/crush/internal/agent/tools/mcp"
10 "github.com/charmbracelet/crush/internal/app"
11 "github.com/charmbracelet/crush/internal/backend"
12 "github.com/charmbracelet/crush/internal/history"
13 "github.com/charmbracelet/crush/internal/message"
14 "github.com/charmbracelet/crush/internal/permission"
15 "github.com/charmbracelet/crush/internal/proto"
16 "github.com/charmbracelet/crush/internal/pubsub"
17 "github.com/charmbracelet/crush/internal/session"
18 "github.com/charmbracelet/crush/internal/skills"
19)
20
21// wrapEvent converts a raw tea.Msg (a pubsub.Event[T] from the app
22// event fan-in) into a pubsub.Payload envelope with the correct
23// PayloadType discriminator and a proto-typed inner payload that has
24// proper JSON tags. Returns nil if the event type is unrecognized.
25func wrapEvent(ev any) *pubsub.Payload {
26 switch e := ev.(type) {
27 case pubsub.Event[app.LSPEvent]:
28 return envelope(pubsub.PayloadTypeLSPEvent, pubsub.Event[proto.LSPEvent]{
29 Type: e.Type,
30 Payload: proto.LSPEvent{
31 Type: proto.LSPEventType(e.Payload.Type),
32 Name: e.Payload.Name,
33 State: e.Payload.State,
34 Error: e.Payload.Error,
35 DiagnosticCount: e.Payload.DiagnosticCount,
36 },
37 })
38 case pubsub.Event[mcp.Event]:
39 return envelope(pubsub.PayloadTypeMCPEvent, pubsub.Event[proto.MCPEvent]{
40 Type: e.Type,
41 Payload: proto.MCPEvent{
42 Type: mcpEventTypeToProto(e.Payload.Type),
43 Name: e.Payload.Name,
44 State: proto.MCPState(e.Payload.State),
45 Error: e.Payload.Error,
46 ToolCount: e.Payload.Counts.Tools,
47 },
48 })
49 case pubsub.Event[permission.PermissionRequest]:
50 return envelope(pubsub.PayloadTypePermissionRequest, pubsub.Event[proto.PermissionRequest]{
51 Type: e.Type,
52 Payload: proto.PermissionRequest{
53 ID: e.Payload.ID,
54 SessionID: e.Payload.SessionID,
55 ToolCallID: e.Payload.ToolCallID,
56 ToolName: e.Payload.ToolName,
57 Description: e.Payload.Description,
58 Action: e.Payload.Action,
59 Path: e.Payload.Path,
60 Params: e.Payload.Params,
61 },
62 })
63 case pubsub.Event[permission.PermissionNotification]:
64 return envelope(pubsub.PayloadTypePermissionNotification, pubsub.Event[proto.PermissionNotification]{
65 Type: e.Type,
66 Payload: proto.PermissionNotification{
67 ToolCallID: e.Payload.ToolCallID,
68 Granted: e.Payload.Granted,
69 Denied: e.Payload.Denied,
70 },
71 })
72 case pubsub.Event[message.Message]:
73 return envelope(pubsub.PayloadTypeMessage, pubsub.Event[proto.Message]{
74 Type: e.Type,
75 Payload: messageToProto(e.Payload),
76 })
77 case pubsub.Event[session.Session]:
78 return envelope(pubsub.PayloadTypeSession, pubsub.Event[proto.Session]{
79 Type: e.Type,
80 Payload: sessionToProto(e.Payload),
81 })
82 case pubsub.Event[history.File]:
83 return envelope(pubsub.PayloadTypeFile, pubsub.Event[proto.File]{
84 Type: e.Type,
85 Payload: fileToProto(e.Payload),
86 })
87 case pubsub.Event[notify.Notification]:
88 return envelope(pubsub.PayloadTypeAgentEvent, pubsub.Event[proto.AgentEvent]{
89 Type: e.Type,
90 Payload: proto.AgentEvent{
91 SessionID: e.Payload.SessionID,
92 SessionTitle: e.Payload.SessionTitle,
93 Type: proto.AgentEventType(e.Payload.Type),
94 },
95 })
96 case pubsub.Event[proto.ConfigChanged]:
97 return envelope(pubsub.PayloadTypeConfigChanged, e)
98 case pubsub.Event[skills.Event]:
99 return envelope(pubsub.PayloadTypeSkillsEvent, pubsub.Event[proto.SkillsEvent]{
100 Type: e.Type,
101 Payload: skillsEventToProto(e.Payload),
102 })
103 default:
104 slog.Warn("Unrecognized event type for SSE wrapping", "type", fmt.Sprintf("%T", ev))
105 return nil
106 }
107}
108
109// envelope marshals the inner event and wraps it in a pubsub.Payload.
110func envelope(payloadType pubsub.PayloadType, inner any) *pubsub.Payload {
111 raw, err := json.Marshal(inner)
112 if err != nil {
113 slog.Error("Failed to marshal event payload", "error", err)
114 return nil
115 }
116 return &pubsub.Payload{
117 Type: payloadType,
118 Payload: raw,
119 }
120}
121
122func mcpEventTypeToProto(t mcp.EventType) proto.MCPEventType {
123 switch t {
124 case mcp.EventStateChanged:
125 return proto.MCPEventStateChanged
126 case mcp.EventToolsListChanged:
127 return proto.MCPEventToolsListChanged
128 case mcp.EventPromptsListChanged:
129 return proto.MCPEventPromptsListChanged
130 case mcp.EventResourcesListChanged:
131 return proto.MCPEventResourcesListChanged
132 default:
133 return proto.MCPEventStateChanged
134 }
135}
136
137func sessionToProto(s session.Session) proto.Session {
138 return proto.Session{
139 ID: s.ID,
140 ParentSessionID: s.ParentSessionID,
141 Title: s.Title,
142 SummaryMessageID: s.SummaryMessageID,
143 MessageCount: s.MessageCount,
144 PromptTokens: s.PromptTokens,
145 CompletionTokens: s.CompletionTokens,
146 Cost: s.Cost,
147 Todos: todosToProto(s.Todos),
148 CreatedAt: s.CreatedAt,
149 UpdatedAt: s.UpdatedAt,
150 }
151}
152
153// isSessionBusy reports whether the given workspace has an in-flight
154// agent run for sessionID. It tolerates a nil workspace (treating it as
155// "not busy") so REST handlers can pass GetWorkspace's result through
156// unconditionally — the workspace lookup error is already surfaced by
157// the prior ListSessions/GetSession call when relevant.
158func isSessionBusy(ws *backend.Workspace, sessionID string) bool {
159 if ws == nil || ws.App == nil || ws.AgentCoordinator == nil {
160 return false
161 }
162 return ws.AgentCoordinator.IsSessionBusy(sessionID)
163}
164
165// attachedClients returns the number of clients currently viewing
166// sessionID in ws. Hold-only clients (streams == 0) do not contribute.
167// A nil workspace is treated as zero so handlers can pass GetWorkspace's
168// result through without an extra guard.
169func attachedClients(ws *backend.Workspace, sessionID string) int {
170 if ws == nil {
171 return 0
172 }
173 return ws.AttachedClientsForSession(sessionID)
174}
175
176func todosToProto(todos []session.Todo) []proto.Todo {
177 if len(todos) == 0 {
178 return nil
179 }
180 out := make([]proto.Todo, len(todos))
181 for i, t := range todos {
182 out[i] = proto.Todo{
183 Content: t.Content,
184 Status: string(t.Status),
185 ActiveForm: t.ActiveForm,
186 }
187 }
188 return out
189}
190
191func fileToProto(f history.File) proto.File {
192 return proto.File{
193 ID: f.ID,
194 SessionID: f.SessionID,
195 Path: f.Path,
196 Content: f.Content,
197 Version: f.Version,
198 CreatedAt: f.CreatedAt,
199 UpdatedAt: f.UpdatedAt,
200 }
201}
202
203func messageToProto(m message.Message) proto.Message {
204 msg := proto.Message{
205 ID: m.ID,
206 SessionID: m.SessionID,
207 Role: proto.MessageRole(m.Role),
208 Model: m.Model,
209 Provider: m.Provider,
210 CreatedAt: m.CreatedAt,
211 UpdatedAt: m.UpdatedAt,
212 }
213
214 for _, p := range m.Parts {
215 switch v := p.(type) {
216 case message.TextContent:
217 msg.Parts = append(msg.Parts, proto.TextContent{Text: v.Text})
218 case message.ReasoningContent:
219 msg.Parts = append(msg.Parts, proto.ReasoningContent{
220 Thinking: v.Thinking,
221 Signature: v.Signature,
222 StartedAt: v.StartedAt,
223 FinishedAt: v.FinishedAt,
224 })
225 case message.ToolCall:
226 msg.Parts = append(msg.Parts, proto.ToolCall{
227 ID: v.ID,
228 Name: v.Name,
229 Input: v.Input,
230 Finished: v.Finished,
231 })
232 case message.ToolResult:
233 msg.Parts = append(msg.Parts, proto.ToolResult{
234 ToolCallID: v.ToolCallID,
235 Name: v.Name,
236 Content: v.Content,
237 Data: v.Data,
238 MIMEType: v.MIMEType,
239 Metadata: v.Metadata,
240 IsError: v.IsError,
241 })
242 case message.Finish:
243 msg.Parts = append(msg.Parts, proto.Finish{
244 Reason: proto.FinishReason(v.Reason),
245 Time: v.Time,
246 Message: v.Message,
247 Details: v.Details,
248 })
249 case message.ImageURLContent:
250 msg.Parts = append(msg.Parts, proto.ImageURLContent{URL: v.URL, Detail: v.Detail})
251 case message.BinaryContent:
252 msg.Parts = append(msg.Parts, proto.BinaryContent{Path: v.Path, MIMEType: v.MIMEType, Data: v.Data})
253 }
254 }
255
256 return msg
257}
258
259// skillsEventToProto converts a skills.Event into its wire form. Errors
260// are flattened to strings because error does not round-trip over JSON.
261func skillsEventToProto(e skills.Event) proto.SkillsEvent {
262 if len(e.States) == 0 {
263 return proto.SkillsEvent{}
264 }
265 out := proto.SkillsEvent{States: make([]proto.SkillState, len(e.States))}
266 for i, s := range e.States {
267 entry := proto.SkillState{
268 Name: s.Name,
269 Path: s.Path,
270 State: proto.SkillDiscoveryState(s.State),
271 }
272 if s.Err != nil {
273 entry.Error = s.Err.Error()
274 }
275 out.States[i] = entry
276 }
277 return out
278}
279
280func messagesToProto(msgs []message.Message) []proto.Message {
281 out := make([]proto.Message, len(msgs))
282 for i, m := range msgs {
283 out[i] = messageToProto(m)
284 }
285 return out
286}