Repository navigation
Expand file tree
/
Copy pathevent_manager.lua
More file actions
616 lines (527 loc) · 22.5 KB
/
Copy pathevent_manager.lua
File metadata and controls
616 lines (527 loc) · 22.5 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
local state = require('opencode.state')
local config = require('opencode.config')
local ThrottlingEmitter = require('opencode.throttling_emitter')
local util = require('opencode.util')
local log = require('opencode.log')
--- @class EventInstallationUpdated
--- @field type "installation.updated"
--- @field properties {version: string}
--- @class EventLspClientDiagnostics
--- @field type "lsp.client.diagnostics"
--- @field properties {serverID: string, path: string}
--- @class EventMessageUpdated
--- @field type "message.updated"
--- @field properties {info: MessageInfo}
--- @class EventMessageRemoved
--- @field type "message.removed"
--- @field properties {sessionID: string, messageID: string}
--- @class EventMessagePartUpdated
--- @field type "message.part.updated"
--- @field properties {part: OpencodeMessagePart}
--- @class EventMessagePartDelta
--- @field type "message.part.delta"
--- @field properties {
--- sessionID: string,
--- messageID: string,
--- partID: string,
--- field: string,
--- delta: string
--- }
--- @class EventMessagePartRemoved
--- @field type "message.part.removed"
--- @field properties {sessionID: string, messageID: string, partID: string}
--- @class EventSessionCompacted
--- @field type "session.compacted"
--- @field properties {sessionID: string}
--- @class EventSessionIdle
--- @field type "session.idle"
--- @field properties {sessionID: string}
--- @class EventSessionUpdated
--- @field type "session.updated"
--- @field properties {info: Session}
--- @class EventSessionDeleted
--- @field type "session.deleted"
--- @field properties {info: Session}
--- @class EventSessionError
--- @field type "session.error"
--- @field properties {sessionID: string, error: table}
--- @class EventSessionStatus
--- @field type "session.status"
--- @field properties {
--- sessionID: string,
--- status: {
--- type: string,
--- message?: string,
--- attempt?: number,
--- next?: number
--- }
--- }
--- @class OpencodePermission
--- @field id string
--- @field type string
--- @field pattern string|string[]
--- @field sessionID string
--- @field tool? {messageID: string, callID: string}
--- @field messageID string
--- @field callID? string
--- @field title string
--- @field metadata table
--- @field time {created: number}
--- @class OpencodePermissionAsked
--- @field id string
--- @field type string
--- @field pattern string|string[]
--- @field sessionID string
--- @field tool? {messageID: string, callID: string}
--- @field messageID string
--- @field callID? string
--- @field title string
--- @field metadata table
--- @field time {created: number}
--- @class EventPermissionUpdated
--- @field type "permission.updated"
--- @field properties OpencodePermission
--- @class EventPermissionAsked
--- @field type "permission.asked"
--- @field properties OpencodePermission
--- @class EventPermissionReplied
--- @field type "permission.replied"
--- @field properties {sessionID: string, permissionID?: string, requestID?: string, response: string}
--- @class EventFileEdited
--- @field type "file.edited"
--- @field properties {file: string}
--- @class EventFileWatcherUpdated
--- @field type "file.watcher.updated"
--- @field properties {file: string, event: "add"|"change"|"unlink"}
--- @class EventServerConnected
--- @field type "server.connected"
--- @field properties table
--- @class EventIdeInstalled
--- @field type "ide.installed"
--- @field properties {ide: string}
--- @class ServerStartingEvent
--- @field url string
--- @class ServerReadyEvent
--- @field url string
--- @class ServerStoppedEvent
--- @class RestorePointCreatedEvent
--- @field restore_point RestorePoint
--- @class EventQuestionAsked
--- @field type "question.asked"
--- @field properties OpencodeQuestionRequest
--- @class EventQuestionReplied
--- @field type "question.replied"
--- @field properties { sessionID: string, requestID: string, answers: string[][] }
--- @class EventQuestionRejected
--- @field type "question.rejected"
--- @field properties { sessionID: string, requestID: string }
--- @alias OpencodeEventName
--- | "installation.updated"
--- | "lsp.client.diagnostics"
--- | "message.updated"
--- | "message.removed"
--- | "message.part.updated"
--- | "message.part.delta"
--- | "message.part.removed"
--- | "session.compacted"
--- | "session.idle"
--- | "session.updated"
--- | "session.deleted"
--- | "session.error"
--- | "session.status"
--- | "permission.updated"
--- | "permission.asked"
--- | "permission.replied"
--- | "question.asked"
--- | "question.replied"
--- | "question.rejected"
--- | "file.edited"
--- | "file.watcher.updated"
--- | "server.connected"
--- | "ide.installed"
--- | "custom.server_starting"
--- | "custom.server_ready"
--- | "custom.server_stopped"
--- | "custom.restore_point.created"
--- | "custom.emit_events.started"
--- | "custom.emit_events.finished"
--- | "custom.command.before"
--- | "custom.command.after"
--- | "custom.command.error"
--- | "custom.command.finally"
--- | "custom.command.hook_error"
--- @class EventManager
--- @field events table<string, function[]> Event listener registry
--- @field server_subscription table|nil Subscription to server events
--- @field state_server_listener function|nil Listener for state.opencode_server updates
--- @field state_cwd_listener function|nil Listener for state.current_cwd updates
--- @field is_started boolean Whether the event manager is started
--- @field captured_events table[] List of captured events for debugging
--- @field ignored_events string[] List of event types to ignore when capturing
--- @field throttling_emitter ThrottlingEmitter Throttle instance for batching events
local EventManager = {}
EventManager.__index = EventManager
--- Create a new EventManager instance
--- @return EventManager
function EventManager.new()
local self = setmetatable({
events = {},
server_subscription = nil,
state_server_listener = nil,
state_cwd_listener = nil,
is_started = false,
captured_events = {},
ignored_events = { 'server.heartbeat' },
_parts_by_id = {},
}, EventManager)
local throttle_ms = config.ui.output.rendering.event_throttle_ms
self.throttling_emitter = ThrottlingEmitter.new(function(events)
self:_on_drained_events(events)
end, throttle_ms)
return self
end
--- Subscribe to an event with type-safe callbacks using function overloads
--- @overload fun(self: EventManager, event_name: "installation.updated", callback: fun(data: EventInstallationUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "lsp.client.diagnostics", callback: fun(data: EventLspClientDiagnostics['properties']): nil)
--- @overload fun(self: EventManager, event_name: "message.updated", callback: fun(data: EventMessageUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "message.removed", callback: fun(data: EventMessageRemoved['properties']): nil)
--- @overload fun(self: EventManager, event_name: "message.part.updated", callback: fun(data: EventMessagePartUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "message.part.delta", callback: fun(data: EventMessagePartDelta['properties']): nil)
--- @overload fun(self: EventManager, event_name: "message.part.removed", callback: fun(data: EventMessagePartRemoved['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.compacted", callback: fun(data: EventSessionCompacted['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.idle", callback: fun(data: EventSessionIdle['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.updated", callback: fun(data: EventSessionUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.deleted", callback: fun(data: EventSessionDeleted['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.error", callback: fun(data: EventSessionError['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.status", callback: fun(data: EventSessionStatus['properties']): nil)
--- @overload fun(self: EventManager, event_name: "permission.updated", callback: fun(data: EventPermissionUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "permission.replied", callback: fun(data: EventPermissionReplied['properties']): nil)
--- @overload fun(self: EventManager, event_name: "file.edited", callback: fun(data: EventFileEdited['properties']): nil)
--- @overload fun(self: EventManager, event_name: "file.watcher.updated", callback: fun(data: EventFileWatcherUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "server.connected", callback: fun(data: EventServerConnected['properties']): nil)
--- @overload fun(self: EventManager, event_name: "ide.installed", callback: fun(data: EventIdeInstalled['properties']): nil)
--- @overload fun(self: EventManager, event_name: "custom.server_starting", callback: fun(data: ServerStartingEvent['properties']): nil)
--- @overload fun(self: EventManager, event_name: "custom.server_ready", callback: fun(data: ServerReadyEvent['properties']): nil)
--- @overload fun(self: EventManager, event_name: "custom.server_stopped", callback: fun(data: ServerStoppedEvent['properties']): nil)
--- @overload fun(self: EventManager, event_name: "custom.restore_point.created", callback: fun(data: RestorePointCreatedEvent['properties']): nil)
--- @overload fun(self: EventManager, event_name: "custom.emit_events.started", callback: fun(): nil)
--- @overload fun(self: EventManager, event_name: "custom.emit_events.finished", callback: fun(): nil)
--- @param event_name OpencodeEventName The event name to listen for
--- @param callback function Callback function to execute when event is triggered
function EventManager:subscribe(event_name, callback)
if not self.events[event_name] then
self.events[event_name] = {}
end
for _, cb in ipairs(self.events[event_name]) do
if cb == callback then
return
end
end
table.insert(self.events[event_name], callback)
end
--- Unsubscribe from an event with type-safe callbacks using function overloads
--- @overload fun(self: EventManager, event_name: "installation.updated", callback: fun(data: EventInstallationUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "lsp.client.diagnostics", callback: fun(data: EventLspClientDiagnostics['properties']): nil)
--- @overload fun(self: EventManager, event_name: "message.updated", callback: fun(data: EventMessageUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "message.removed", callback: fun(data: EventMessageRemoved['properties']): nil)
--- @overload fun(self: EventManager, event_name: "message.part.updated", callback: fun(data: EventMessagePartUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "message.part.delta", callback: fun(data: EventMessagePartDelta['properties']): nil)
--- @overload fun(self: EventManager, event_name: "message.part.removed", callback: fun(data: EventMessagePartRemoved['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.compacted", callback: fun(data: EventSessionCompacted['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.idle", callback: fun(data: EventSessionIdle['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.updated", callback: fun(data: EventSessionUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.deleted", callback: fun(data: EventSessionDeleted['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.error", callback: fun(data: EventSessionError['properties']): nil)
--- @overload fun(self: EventManager, event_name: "session.status", callback: fun(data: EventSessionStatus['properties']): nil)
--- @overload fun(self: EventManager, event_name: "permission.updated", callback: fun(data: EventPermissionUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "permission.replied", callback: fun(data: EventPermissionReplied['properties']): nil)
--- @overload fun(self: EventManager, event_name: "file.edited", callback: fun(data: EventFileEdited['properties']): nil)
--- @overload fun(self: EventManager, event_name: "file.watcher.updated", callback: fun(data: EventFileWatcherUpdated['properties']): nil)
--- @overload fun(self: EventManager, event_name: "server.connected", callback: fun(data: EventServerConnected['properties']): nil)
--- @overload fun(self: EventManager, event_name: "ide.installed", callback: fun(data: EventIdeInstalled['properties']): nil)
--- @overload fun(self: EventManager, event_name: "custom.server_starting", callback: fun(data: ServerStartingEvent['properties']): nil)
--- @overload fun(self: EventManager, event_name: "custom.server_ready", callback: fun(data: ServerReadyEvent['properties']): nil)
--- @overload fun(self: EventManager, event_name: "custom.server_stopped", callback: fun(data: ServerStoppedEvent['properties']): nil)
--- @overload fun(self: EventManager, event_name: "custom.restore_point.created", callback: fun(data: RestorePointCreatedEvent['properties']): nil)
--- @overload fun(self: EventManager, event_name: "custom.emit_events.started", callback: fun(): nil)
--- @overload fun(self: EventManager, event_name: "custom.emit_events.finished", callback: fun(): nil)
--- @param event_name OpencodeEventName The event name
--- @param callback function The callback function to remove
function EventManager:unsubscribe(event_name, callback)
local listeners = self.events[event_name]
if not listeners then
return
end
for i = #listeners, 1, -1 do
local cb = listeners[i]
if cb == callback then
table.remove(listeners, i)
end
end
end
---Normalize message.part.delta events into message.part.updated events so
---consumers can continue rendering full part payloads.
---@param event table
---@return table|nil
function EventManager:_normalize_stream_event(event)
if not event or not event.type then
return nil
end
local properties = event.properties or {}
if event.type == 'message.part.updated' and properties.part and properties.part.id then
self._parts_by_id[properties.part.id] = vim.deepcopy(properties.part)
return event
end
if event.type == 'message.part.removed' and properties.partID then
self._parts_by_id[properties.partID] = nil
return event
end
if event.type ~= 'message.part.delta' then
return event
end
local part_id = properties.partID
local message_id = properties.messageID
local session_id = properties.sessionID
local field = properties.field
if not part_id or not message_id or not session_id or not field then
return nil
end
local part = vim.deepcopy(self._parts_by_id[part_id])
if not part then
part = {
id = part_id,
messageID = message_id,
sessionID = session_id,
}
if field == 'text' then
part.type = 'text'
part.text = ''
end
end
local delta = properties.delta
local current = part[field]
if type(delta) == 'string' then
if type(current) == 'string' then
part[field] = current .. delta
else
part[field] = delta
end
else
part[field] = delta
end
self._parts_by_id[part_id] = part
return {
type = 'message.part.updated',
properties = {
part = part,
},
}
end
---Callback from ThrottlingEmitter when the events are now ready to be processed.
---Collapses parts that are duplicated, making sure to replace earlier parts with later
---ones (but keeping the earlier position)
---@param events any
function EventManager:_on_drained_events(events)
self:emit('custom.emit_events.started', {})
local normalized_events = {}
for _, event in ipairs(events) do
local normalized_event = self:_normalize_stream_event(event)
if normalized_event then
table.insert(normalized_events, normalized_event)
end
end
if not config.ui.output.rendering.event_collapsing then
for _, event in ipairs(normalized_events) do
if event and event.type then
self:emit(event.type, event.properties)
else
log.warn('Received event with missing type: %s', vim.inspect(event))
end
end
self:emit('custom.emit_events.finished', {})
return
end
local collapsed_events = {}
local part_update_indices = {}
for i, event in ipairs(normalized_events) do
if event.type == 'message.part.updated' and event.properties.part then
local part_id = event.properties.part.id
if part_update_indices[part_id] then
local previous_index = part_update_indices[part_id]
-- Preserve ordering dependencies for permission events.
-- Moving a later part update earlier can break correlation when
-- permission.updated/permission.asked sits between the two updates.
local has_intervening_permission_event = false
for j = previous_index + 1, i - 1 do
if
normalized_events[j]
and (normalized_events[j].type == 'permission.updated' or normalized_events[j].type == 'permission.asked')
then
has_intervening_permission_event = true
break
end
end
if has_intervening_permission_event then
collapsed_events[previous_index] = nil
collapsed_events[i] = event
part_update_indices[part_id] = i
else
collapsed_events[previous_index] = event
collapsed_events[i] = nil
end
else
part_update_indices[part_id] = i
collapsed_events[i] = event
end
else
collapsed_events[i] = event
end
end
for i = 1, #normalized_events do
local event = collapsed_events[i]
if event and event.type then
self:emit(event.type, event.properties)
elseif event then
log.warn('Received collapsed event with missing type: %s', vim.inspect(event))
end
end
self:emit('custom.emit_events.finished', {})
end
--- Emit an event to all subscribers
--- @param event_name OpencodeEventName The event name
--- @param data table Data to pass to event listeners
function EventManager:emit(event_name, data)
local listeners = self.events[event_name]
local event = { type = event_name, properties = data }
if config.debug.capture_streamed_events then
table.insert(self.captured_events, vim.deepcopy(event))
end
if listeners then
for _, callback in ipairs(listeners) do
local ok, result = util.pcall_trace(callback, data)
if not ok then
vim.notify('Error calling ' .. event_name .. ' listener: ' .. result, vim.log.levels.ERROR)
end
end
end
vim.api.nvim_exec_autocmds('User', {
pattern = 'OpencodeEvent:' .. event_name,
data = {
event = event,
},
})
end
--- Start the event manager and begin listening to server events
function EventManager:start()
if self.is_started then
return
end
self.is_started = true
if self.state_server_listener then
state.store.unsubscribe('opencode_server', self.state_server_listener)
end
self.state_server_listener = function(key, current, prev)
if current and current:get_spawn_promise() then
self:emit('custom.server_starting', { url = current.url })
current:get_spawn_promise():and_then(function(server)
self:emit('custom.server_ready', { url = server.url })
vim.defer_fn(function()
self:_subscribe_to_server_events(server)
end, 200)
end)
current:get_shutdown_promise():and_then(function()
self:emit('custom.server_stopped', {})
self:_cleanup_server_subscription()
end)
elseif prev and not current then
self:emit('custom.server_stopped', {})
self:_cleanup_server_subscription()
end
end
state.store.subscribe('opencode_server', self.state_server_listener)
if self.state_cwd_listener then
state.store.unsubscribe('current_cwd', self.state_cwd_listener)
end
self.state_cwd_listener = function(key, new_cwd, old_cwd)
if new_cwd ~= old_cwd and state.opencode_server and state.opencode_server.url then
log.debug('Directory changed from %s to %s, re-subscribing to server events', old_cwd, new_cwd)
self:_subscribe_to_server_events(state.opencode_server)
end
end
state.store.subscribe('current_cwd', self.state_cwd_listener)
end
function EventManager:stop()
if not self.is_started then
return
end
self.is_started = false
if self.state_server_listener then
state.store.unsubscribe('opencode_server', self.state_server_listener)
self.state_server_listener = nil
end
if self.state_cwd_listener then
state.store.unsubscribe('current_cwd', self.state_cwd_listener)
self.state_cwd_listener = nil
end
self:_cleanup_server_subscription()
self.throttling_emitter:clear()
self._parts_by_id = {}
self.events = {}
end
--- Subscribe to server-sent events from the API
--- @param server table The server instance
function EventManager:_subscribe_to_server_events(server)
if not server.url then
return
end
self:_cleanup_server_subscription()
local api_client = state.api_client
local emitter = function(event)
if not event or not event.type then
log.warn('Received malformed event from server: %s', vim.inspect(event))
return
end
if self.ignored_events and vim.tbl_contains(self.ignored_events, event.type) then
log.debug('Ignoring event of type %s', event.type)
return
end
self.throttling_emitter:enqueue(event)
end
local directory = state.current_cwd or vim.fn.getcwd()
log.debug('Subscribing to server events for directory: %s', directory)
self.server_subscription = api_client:subscribe_to_events(directory, emitter)
end
function EventManager:_cleanup_server_subscription()
if self.server_subscription then
pcall(function()
if self.server_subscription.shutdown then
self.server_subscription:shutdown()
elseif self.server_subscription.pid and type(self.server_subscription.pid) == 'number' then
vim.fn.jobstop(self.server_subscription.pid --[[@as integer]])
end
end)
self.server_subscription = nil
end
end
--- Get all event names that have subscribers
--- @return string[] List of event names
function EventManager:get_event_names()
local names = {}
for name, _ in pairs(self.events) do
table.insert(names, name)
end
return names
end
--- Get number of subscribers for an event
--- @param event_name OpencodeEventName The event name
--- @return number Number of subscribers
function EventManager:get_subscriber_count(event_name)
local listeners = self.events[event_name]
return listeners and #listeners or 0
end
function EventManager.setup()
local manager = EventManager.new()
state.jobs.set_event_manager(manager)
manager:start()
end
return EventManager