@camstack/types 1.1.45 → 1.1.47

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,545 @@
1
+ //#region src/enums/event-category.ts
2
+ var EventCategory = /* @__PURE__ */ function(EventCategory) {
3
+ EventCategory["SystemBoot"] = "system.boot";
4
+ EventCategory["SystemAddonsReady"] = "system.addons-ready";
5
+ EventCategory["SystemRestarting"] = "system.restarting";
6
+ /**
7
+ * Fired exactly once after the hub finishes booting following a
8
+ * restart that was triggered by `RestartCoordinator` (today: framework
9
+ * live-update). Payload is the marker that was on disk at boot
10
+ * (`PendingRestartMarkerPayload`); admin UI listens for it to display a
11
+ * success toast describing what changed.
12
+ *
13
+ * Spec: docs/superpowers/specs/2026-05-14-framework-live-update-design.md
14
+ */
15
+ EventCategory["SystemRestartCompleted"] = "system.restart-completed";
16
+ /**
17
+ * Readiness transition for a capability provider. Every producer emits
18
+ * this event on `onInitialize` completion, `onDestroy`, and
19
+ * `$node.reconnect`; every consumer that needs to gate on a cross-process
20
+ * cap subscribes via the kernel's readiness module (`awaitReady` /
21
+ * `onReadyState`) instead of polling. Payload is
22
+ * `SystemReadyStatePayload` — see event-bus.ts.
23
+ */
24
+ EventCategory["SystemReadyState"] = "system.ready-state";
25
+ EventCategory["AddonStarted"] = "addon.started";
26
+ EventCategory["AddonStopped"] = "addon.stopped";
27
+ EventCategory["AddonRestarted"] = "addon.restarted";
28
+ EventCategory["AddonUpdated"] = "addon.updated";
29
+ EventCategory["AddonInstalled"] = "addon.installed";
30
+ EventCategory["AddonUninstalled"] = "addon.uninstalled";
31
+ EventCategory["AddonCrashed"] = "addon.crashed";
32
+ EventCategory["AddonError"] = "addon.error";
33
+ EventCategory["AddonPageReady"] = "addon.page-ready";
34
+ EventCategory["AddonWidgetReady"] = "addon.widget-ready";
35
+ /**
36
+ * Addon failed to load (import or initialize). Emitted by the kernel's
37
+ * AddonHealthMonitor only AFTER the boot grace period ends — failures
38
+ * during the first 5 minutes are silently retried without alerting
39
+ * (slow-starting addons must have time to come up). Post-grace, this
40
+ * event is emitted exactly once per failure-streak; AlertCenter
41
+ * consumes it to create a persistent operator-visible alert.
42
+ *
43
+ * Payload: `{ packageName, addonId?, error: { message, stack }, retryCount, nextRetryAt }`.
44
+ */
45
+ EventCategory["AddonLoadFailed"] = "addon.load-failed";
46
+ /**
47
+ * Addon recovered from a previous failure. Emitted when an addon
48
+ * transitions from `failed` back to `healthy` (typically via the
49
+ * monitor's auto-retry loop, or after manual `addons.retryLoad`).
50
+ * AlertCenter dismisses the corresponding `AddonLoadFailed` alert
51
+ * on this event.
52
+ */
53
+ EventCategory["AddonLoadRecovered"] = "addon.load-recovered";
54
+ /**
55
+ * Monitor scheduled the next retry for a failed addon. Transient —
56
+ * surfaced to the UI for live-updating the "next retry in Ns"
57
+ * countdown on the Addons page row, NOT persisted as an alert.
58
+ */
59
+ EventCategory["AddonRetryScheduled"] = "addon.retry-scheduled";
60
+ /**
61
+ * Monitor is attempting to reload a failed addon NOW. UI uses this
62
+ * to show a spinner during the retry attempt. Same transient nature
63
+ * as AddonRetryScheduled.
64
+ */
65
+ EventCategory["AddonRetryAttempting"] = "addon.retry-attempting";
66
+ EventCategory["DeviceRegistered"] = "device.registered";
67
+ EventCategory["DeviceUnregistered"] = "device.unregistered";
68
+ EventCategory["DeviceEnabled"] = "device.enabled";
69
+ EventCategory["DeviceDisabled"] = "device.disabled";
70
+ EventCategory["DeviceSettingsUpdated"] = "device.settings-updated";
71
+ /**
72
+ * Emitted when the set of native capability providers bound to a device
73
+ * changes — e.g. an addon registers a new native cap via
74
+ * `DeviceContext.registerNativeCap`, or all native bindings for a device
75
+ * are cleared on removal. Hub consumers re-resolve device-proxy routes
76
+ * when this fires.
77
+ */
78
+ EventCategory["DeviceBindingsChanged"] = "device.bindings-changed";
79
+ /**
80
+ * Emitted when the operator-organisational meta surface changes
81
+ * (`name` / `location` / `disabled`). Payload: `{deviceId, field,
82
+ * value}`. Live consumers (UI device list, alert center) react
83
+ * without polling. Distinct from `DeviceSettingsUpdated` which
84
+ * fires on hardware-config changes (host/port/credentials/etc).
85
+ */
86
+ EventCategory["DeviceMetaChanged"] = "device.meta-changed";
87
+ /**
88
+ * Emitted by `BaseDevice.updateSourceInfo()` after a successful patch
89
+ * to the device's upstream-system identity / rendering envelope. The
90
+ * full new SourceInfo travels in the payload so cross-process listeners
91
+ * (UI, export adapters) don't need to re-read the meta blob.
92
+ *
93
+ * Payload: `{deviceId, sourceInfo}`.
94
+ *
95
+ * Distinct from `DeviceMetaChanged` which covers the operator-edited
96
+ * surface (`name` / `location` / `disabled`). The two share the
97
+ * persistence layer (both ride on `device-manager.setMetadata` for
98
+ * SourceInfo, or `setName`/`setLocation`/`setDisabled` for the meta
99
+ * fields) but consumers care about different subsets.
100
+ */
101
+ EventCategory["DeviceSourceInfoChanged"] = "device.source-info-changed";
102
+ /**
103
+ * Emitted by DeviceStreamWiringService after a successful
104
+ * `stream-broker.registerDeviceStreams` call. Payload includes
105
+ * deviceId — consumers look up the full registered device info via
106
+ * `brokerManager.getRegisteredDevice(deviceId)`.
107
+ *
108
+ * Replaces the legacy `StreamRouterService.onDeviceRegistered` callback.
109
+ */
110
+ EventCategory["DeviceStreamsRegistered"] = "device.streams-registered";
111
+ /**
112
+ * Device-level "fully provisioned" signal — the EXPORT trigger. Emitted once
113
+ * a device's persisted export-relevant shape (its `DeviceFeature` set) is
114
+ * established or changes, carrying `{deviceId, fingerprint, generation}`.
115
+ * Export adapters (Alexa / HAP) react to THIS instead of the chatty per-cap
116
+ * `DeviceBindingsChanged`, turning a boot's incomplete→complete trickle into
117
+ * one clean delta. `fingerprint` is `canonicalDeviceFingerprint(shape)`.
118
+ *
119
+ * Spec: docs/superpowers/specs/2026-06-01-alexa-hap-export-reconciler-design.md
120
+ */
121
+ EventCategory["DeviceProvisioned"] = "device.provisioned";
122
+ /**
123
+ * Fires once when a device's initial feature-probe completes successfully
124
+ * (lastProbedAt 0→>0); exported shape is now stable. Telemetry (may be
125
+ * dropped) — consumers MUST also gate on the device record's `probed` flag.
126
+ */
127
+ EventCategory["DeviceReady"] = "device.ready";
128
+ EventCategory["IntegrationEnabled"] = "integration.enabled";
129
+ EventCategory["IntegrationDisabled"] = "integration.disabled";
130
+ EventCategory["IntegrationDeleted"] = "integration.deleted";
131
+ /** Emitted when a broker connection's status flips (connected /
132
+ * disconnected / error). Carries `{ brokerId, status, error? }`. */
133
+ EventCategory["BrokerStatusChanged"] = "broker.status-changed";
134
+ /** Emitted for every subscription-matched message routed by a
135
+ * broker provider. Carries `{ brokerId, subscriptionId, key, payload }`.
136
+ * Consumers filter by `brokerId` + `subscriptionId` in the handler. */
137
+ EventCategory["BrokerMessage"] = "broker.message";
138
+ EventCategory["ProviderStarted"] = "provider.started";
139
+ EventCategory["ProviderStopped"] = "provider.stopped";
140
+ EventCategory["ProcessCrashed"] = "process.crashed";
141
+ EventCategory["ProcessRestartScheduled"] = "process.restart_scheduled";
142
+ EventCategory["ProcessRestarted"] = "process.restarted";
143
+ EventCategory["RecordingStarted"] = "recording.started";
144
+ EventCategory["RecordingStopped"] = "recording.stopped";
145
+ EventCategory["RecordingError"] = "recording.error";
146
+ EventCategory["RecordingHealthDegraded"] = "recording.health.degraded";
147
+ EventCategory["RecordingStorageCritical"] = "recording.storage.critical";
148
+ EventCategory["RecordingSegmentWritten"] = "recording.segment.written";
149
+ EventCategory["RecordingPolicyFallback"] = "recording.policy.fallback";
150
+ EventCategory["RecordingRetentionCompleted"] = "recording.retention.completed";
151
+ /** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
152
+ * thumb is a scrub gap the recorder's keyframe backfill covers. */
153
+ EventCategory["RecordingThumbSampled"] = "recording.thumb-sampled";
154
+ EventCategory["DetectionEvent"] = "detection.event";
155
+ EventCategory["SessionTrackNew"] = "session.track.new";
156
+ EventCategory["SessionTrackExpired"] = "session.track.expired";
157
+ EventCategory["BenchmarkProgress"] = "benchmark.progress";
158
+ EventCategory["PlatformProbePhase"] = "platform-probe.phase";
159
+ EventCategory["PipelineProgress"] = "pipeline.progress";
160
+ /** Per-frame execution trace emitted by the pipeline executor for live observability. */
161
+ EventCategory["PipelineTrace"] = "pipeline.trace";
162
+ /**
163
+ * Raw inference output emitted by `addon-pipeline-runner` after running the
164
+ * detection pipeline on a frame. Carries the `FrameResult` (with
165
+ * `detections[]`, `width`/`height`, timing debug) — never the frame
166
+ * buffer itself. Hub-side consumers (analysis pipeline, class filters,
167
+ * notifications) subscribe to this and re-emit `detection.result` after
168
+ * post-processing.
169
+ */
170
+ EventCategory["PipelineInferenceResult"] = "pipeline.inference-result";
171
+ /**
172
+ * Camera lifecycle event emitted by `addon-pipeline-orchestrator` when it
173
+ * assigns or unassigns a camera to/from an agent. Carries no frame data;
174
+ * pure observability for UI dashboards and metrics consumers.
175
+ */
176
+ EventCategory["PipelineCameraAssigned"] = "pipeline.camera-assigned";
177
+ EventCategory["PipelineCameraUnassigned"] = "pipeline.camera-unassigned";
178
+ /**
179
+ * Per-camera pipeline config was mutated by the orchestrator
180
+ * (3-level settings change via `setAgentAddonDefaults` /
181
+ * `setCameraStepToggle` / `setCameraPipelineForAgent` or a
182
+ * pipeline-scoped `applyDeviceSettingsPatch`). Orchestrator
183
+ * subscribes to its own emission to hot-reload the assigned runner
184
+ * via `attachCamera` so the next frame executes against the new
185
+ * engine/steps without waiting for a rebalance or the next
186
+ * `DeviceStreamsRegistered` cycle.
187
+ */
188
+ EventCategory["PipelineCameraUpdated"] = "pipeline.camera-updated";
189
+ /**
190
+ * The cluster camera-source OWNER changed (`clusterRoles.ingestNode`).
191
+ * Emitted by addon-pipeline-orchestrator whenever it (re)derives node
192
+ * capabilities — at boot, on agent online/offline, and on an ingest-node
193
+ * flip. Carries the resolved `ownerNodeId`. The stream-broker consumes it to
194
+ * keep its ingest-owner-gate decision current WITHOUT a per-`ensureBroker`
195
+ * cross-process `getIngestOwner` query (push the authority's decision instead
196
+ * of polling it on the hot path). Idempotent state — re-emitted on every
197
+ * topology change, so a dropped event self-heals on the next one (plus the
198
+ * broker's long backstop reconcile query).
199
+ */
200
+ EventCategory["PipelineIngestOwnerChanged"] = "pipeline.ingest-owner-changed";
201
+ /**
202
+ * Periodic snapshot of per-node pipeline-runner load
203
+ * (`RunnerLocalLoad`). Emitted ~1Hz by every runner so UI dashboards
204
+ * subscribe instead of polling `pipelineRunner.getLocalLoad`.
205
+ * `nodeId` carried in the payload + on `event.source.nodeId`.
206
+ */
207
+ EventCategory["PipelineRunnerLoadSnapshot"] = "pipeline.runner-load-snapshot";
208
+ /**
209
+ * Periodic snapshot of per-camera pipeline metrics (`CameraMetrics`
210
+ * + `deviceId` + `nodeId`). Emitted ~1Hz by every runner for each
211
+ * attached camera. UI subscribes to drive overlay phase / fps /
212
+ * inference time without polling `getCameraMetrics`.
213
+ */
214
+ EventCategory["PipelineCameraMetricsSnapshot"] = "pipeline.camera-metrics-snapshot";
215
+ /**
216
+ * Periodic snapshot of stream-broker per-broker statistics (input
217
+ * fps, decoded fps, bitrate, codec). Emitted ~1Hz by every
218
+ * stream-broker process for each active broker so the UI can drive
219
+ * the Stream / Cluster dashboards without polling
220
+ * `streamBroker.listAllProfileSlots` and friends.
221
+ */
222
+ EventCategory["StreamBrokerMetricsSnapshot"] = "stream-broker.metrics-snapshot";
223
+ /**
224
+ * Cap event fired by `stream-broker` when a profile slot enters
225
+ * "demanded" state — a cam stream has been assigned and at least one
226
+ * consumer (RTSP restream, decoded subscriber, WebRTC session, …) is
227
+ * present. Camera-provider addons (Reolink Baichuan push, …)
228
+ * subscribe to this category to start their underlying transport
229
+ * lazily. Payload: `{ deviceId, camStreamId, profile }`.
230
+ */
231
+ EventCategory["StreamBrokerOnCamStreamDemand"] = "stream-broker.onCamStreamDemand";
232
+ /**
233
+ * Cap event fired by `stream-broker` when the last consumer leaves a
234
+ * previously-demanded cam stream. Providers tear down their
235
+ * underlying transport on receipt. Payload: `{ deviceId, camStreamId }`.
236
+ */
237
+ EventCategory["StreamBrokerOnCamStreamIdle"] = "stream-broker.onCamStreamIdle";
238
+ /**
239
+ * Cap event fired by `stream-broker` when a broker fails to dial a
240
+ * managed-loopback source (today: `pull-rfc4571`) and the publisher
241
+ * needs to refresh the cached URL. The lib's TCP server idle-tears-down
242
+ * on its own schedule, so a re-publish with a fresh `host:port` is the
243
+ * only way to keep the broker dialable. Camera providers (Reolink
244
+ * Baichuan native, …) subscribe and respond by re-running their publish
245
+ * pipeline.
246
+ * Payload: `{ deviceId, camStreamId, brokerId }`.
247
+ */
248
+ EventCategory["StreamBrokerOnRequestStreamSourceRefresh"] = "stream-broker.onRequestStreamSourceRefresh";
249
+ /**
250
+ * A camera provider changed a device's stream parameters (codec /
251
+ * resolution / bitrate / a stream added or removed). A LOW-LATENCY NUDGE
252
+ * for the stream-broker's catalog reconcile: it carries NO authoritative
253
+ * data — the broker re-PULLS that device's `stream-catalog` cap on receipt
254
+ * (the 30s reconcile poll is the backstop if this nudge is dropped). Emitted
255
+ * by providers from `stream-params.setProfile`. Payload: `{ deviceId }`.
256
+ */
257
+ EventCategory["StreamParamsChanged"] = "stream-params.changed";
258
+ /**
259
+ * Generic per-device runtime-state change. Fired by `device-manager`
260
+ * whenever a persisted slice in any cap's `runtimeState` shape
261
+ * mutates. Payload: `{deviceId, capName, slice}`. Subscribers are
262
+ * the `deviceState` cap router (cross-process listeners) and the
263
+ * deviceProxy reactive bindings (`device.state.<capName>.value`).
264
+ * Cap-specific events (`battery.onStatusChanged`, …) still fire
265
+ * — they're authoritative for callers that want a typed payload
266
+ * without filtering on `capName`.
267
+ */
268
+ EventCategory["DeviceStateChanged"] = "device.state-changed";
269
+ /**
270
+ * Cap event fired by every device that registers the `battery`
271
+ * capability. Mirrors the cap definition's `onStatusChanged`. Carries
272
+ * `{ deviceId, status: BatteryStatus }`. Subscribers (alert center,
273
+ * snapshot wrapper, UI) react to charge/sleep transitions without
274
+ * polling `batteryCapability.getStatus`.
275
+ */
276
+ EventCategory["BatteryOnStatusChanged"] = "battery.onStatusChanged";
277
+ /**
278
+ * Emitted by the battery cap provider WHEN `wakeForStream` enters the
279
+ * "wake in progress" window — between the Baichuan wake-up issue and
280
+ * the camera's first dialed-back RTP packet. The stream-broker
281
+ * manager subscribes to flip the per-broker placeholder reason to
282
+ * `'waking'` so viewers see a labelled "WAKING UP" tile instead of
283
+ * the generic `'reconnecting'` frame. Carries `{ deviceId }`. The
284
+ * complementary "wake complete" signal is the existing
285
+ * `BatteryOnStatusChanged { sleeping: false }` event.
286
+ */
287
+ EventCategory["BatteryOnWakeStarted"] = "battery.onWakeStarted";
288
+ /**
289
+ * Cap event fired by every device that registers the `doorbell`
290
+ * capability. Mirrors `doorbellCapability.events.onPressed`. Carries
291
+ * `{ deviceId, timestamp }`. Operators consuming the UI subscribe
292
+ * here to render transient ring toasts and a "Recent presses" row
293
+ * on the device detail page.
294
+ */
295
+ EventCategory["DoorbellOnPressed"] = "doorbell.onPressed";
296
+ /**
297
+ * Cap event fired by every device that registers the `event-emitter`
298
+ * capability. Mirrors `eventEmitterCapability.events.onEvent`. Carries
299
+ * `{ deviceId, eventType, data, timestamp, seq }` — the device's EXACT
300
+ * declared event verbatim (NO normalization). Subscribers (UI event
301
+ * stream, advanced-notifier rules) react to fired events without
302
+ * holding a cap reference.
303
+ */
304
+ EventCategory["EventEmitted"] = "event-emitter.event";
305
+ /**
306
+ * Periodic snapshot of the per-node detection-pipeline engine
307
+ * registry (loaded engines, models resident, in-use cameras, idle
308
+ * TTL). Emitted ~0.2Hz (every 5 s) by every detection-pipeline
309
+ * process. The Engines tab subscribes to drive its inventory view
310
+ * without polling `pipelineExecutor.listLoadedEngines`.
311
+ */
312
+ EventCategory["PipelineEngineMetricsSnapshot"] = "pipeline.engine-metrics-snapshot";
313
+ /**
314
+ * Per-node detection-engine runtime-provisioning transition. Emitted by
315
+ * the detection-pipeline provider on every state change of its lazy
316
+ * engine-provisioning machine (idle → installing → verifying → ready,
317
+ * or → failed with a `nextRetryAt`). Payload is the
318
+ * `EngineProvisioningState` snapshot; `event.source.nodeId` carries the
319
+ * node. The Pipeline page subscribes to drive a live "installing
320
+ * OpenVINO… / ready" indicator per node without polling
321
+ * `pipelineExecutor.getEngineProvisioning`. Telemetry-grade (D8): the UI
322
+ * also reads the cap snapshot on mount / reconnect. Phase 2.
323
+ */
324
+ EventCategory["PipelineEngineProvisioning"] = "pipeline.engine-provisioning";
325
+ /**
326
+ * Cluster topology snapshot. Carries the same payload returned by
327
+ * `nodes.topology` (every reachable node + addons + processes).
328
+ * Emitted by the hub on any agent / addon lifecycle change
329
+ * (debounced) plus a periodic safety net. Replaces UI polling on
330
+ * `nodes.topology` — admin-ui dashboards subscribe to drive the
331
+ * cluster view directly from the event payload.
332
+ */
333
+ EventCategory["ClusterTopologySnapshot"] = "cluster.topology-snapshot";
334
+ /**
335
+ * Periodic per-node system metrics snapshot (CPU / memory / GPU /
336
+ * disk / network). Emitted ~0.2 Hz by the metrics-provider addon
337
+ * for each node. Drives the dashboard SystemStatus / ProcessResources
338
+ * widgets without polling `metricsProvider.getCurrent`.
339
+ */
340
+ EventCategory["MetricsNodeResourcesSnapshot"] = "metrics.node-resources-snapshot";
341
+ /**
342
+ * Periodic per-node process-tree snapshot (camstack-related pids
343
+ * with ghost / managed / root classification). Emitted ~0.2 Hz by
344
+ * the metrics-provider addon. Drives the Cluster → Processes tab
345
+ * without polling `metricsProvider.listNodeProcesses`.
346
+ */
347
+ EventCategory["MetricsNodeProcessesSnapshot"] = "metrics.node-processes-snapshot";
348
+ /**
349
+ * Capability binding change event emitted by `addon-pipeline-orchestrator`
350
+ * when a user changes which addon implements a cap on a node. Subscribed
351
+ * by every kernel process to update its local `preferredProviderRegistry`
352
+ * so future capability lookups respect the new binding.
353
+ */
354
+ /**
355
+ * A capability binding was changed for a node — addon X now provides
356
+ * capability `cap` on node `nodeId`. Lives under the generic
357
+ * `capability.*` namespace because capability bindings are a kernel-
358
+ * level concept used by many addons, not strictly pipeline-scoped.
359
+ */
360
+ EventCategory["CapabilityBindingChanged"] = "capability.binding-changed";
361
+ EventCategory["ModelDownloadProgress"] = "model.download.progress";
362
+ EventCategory["AgentRegistered"] = "agent.registered";
363
+ EventCategory["AgentUnregistered"] = "agent.unregistered";
364
+ EventCategory["AgentOnline"] = "agent.online";
365
+ EventCategory["AgentOffline"] = "agent.offline";
366
+ /** Forked worker process (e.g. hub/pipeline) connected to the broker. */
367
+ EventCategory["WorkerOnline"] = "worker.online";
368
+ /** Forked worker process disconnected from the broker. */
369
+ EventCategory["WorkerOffline"] = "worker.offline";
370
+ EventCategory["AgentTaskDispatched"] = "agent.task.dispatched";
371
+ EventCategory["AgentTaskAssigned"] = "agent.task.assigned";
372
+ EventCategory["AgentTrpcConnected"] = "agent.trpc.connected";
373
+ EventCategory["AgentWsConnected"] = "agent.ws.connected";
374
+ EventCategory["AgentWsDisconnected"] = "agent.ws.disconnected";
375
+ EventCategory["AgentBackupActivated"] = "agent.backup.activated";
376
+ EventCategory["OrchestrationSettingsUpdated"] = "orchestration.settings-updated";
377
+ /**
378
+ * Per-agent hwaccel preference changed (user override set, cleared, or
379
+ * re-probed). Observability event — decoders pull the current pref at
380
+ * `createSession`, so running sessions keep their current backend until
381
+ * they rotate naturally (camera add/remove, stream restart). Future
382
+ * work can wire a listener in stream-broker that force-rotates live
383
+ * sessions; for now this event powers logs + admin-UI toast feedback.
384
+ */
385
+ EventCategory["PipelineAgentHwaccelChanged"] = "pipeline.agent-hwaccel-changed";
386
+ EventCategory["MotionAnalysis"] = "detection.motion-analysis";
387
+ /** All raw motion zones from CCL before minArea filter — for UI debug overlay. */
388
+ EventCategory["MotionZonesRaw"] = "detection.motion-zones-raw";
389
+ /**
390
+ * Per-camera motion phase transition (`watching ↔ active`) emitted
391
+ * by the runner. Mirrors the `motion.onMotionChanged` cap event
392
+ * surface — payload `MotionOnMotionChangedPayload` carries
393
+ * `{deviceId, detected, timestamp, source, regions?}`. Subscribers
394
+ * include addons that need to react to motion state without
395
+ * polling the runtime-state mirror.
396
+ */
397
+ EventCategory["MotionOnMotionChanged"] = "motion.on-motion-changed";
398
+ EventCategory["DetectionResult"] = "detection.result";
399
+ EventCategory["DetectionRaw"] = "detection.raw";
400
+ EventCategory["DetectionCameraNative"] = "detection.camera-native";
401
+ /**
402
+ * Canonical per-chunk live audio pipeline output. Payload is
403
+ * `PipelineAudioInferenceResultPayload` carrying a full `AudioResult`
404
+ * (level + detections + debug). Lives on the pipeline.* namespace
405
+ * alongside `pipeline.inference-result` (video) for symmetry.
406
+ */
407
+ EventCategory["PipelineAudioInferenceResult"] = "pipeline.audio-inference-result";
408
+ EventCategory["DetectionPhaseTransition"] = "detection.phase-transition";
409
+ EventCategory["ProviderMotion"] = "provider.motion";
410
+ EventCategory["ProviderDetection"] = "provider.detection";
411
+ EventCategory["EnrichmentEmbeddingStored"] = "enrichment.embedding.stored";
412
+ EventCategory["EnrichmentSceneStateChanged"] = "enrichment.scene.state-changed";
413
+ EventCategory["EnrichmentActivitySummary"] = "enrichment.activity.summary";
414
+ /**
415
+ * Unified track-lifecycle event: ONE category carrying `phase:
416
+ * 'start' | 'update' | 'end'` with a rich, typed
417
+ * `PipelineAnalyticsTrackLifecyclePayload`. Supersedes the thin
418
+ * `PipelineAnalyticsTrackStarted` / `PipelineAnalyticsTrackEnded`
419
+ * pair — a consumer subscribes once and branches on `phase`.
420
+ */
421
+ EventCategory["PipelineAnalyticsTrackLifecycle"] = "pipeline-analytics.track-lifecycle";
422
+ /**
423
+ * @deprecated Superseded by {@link PipelineAnalyticsTrackLifecycle}
424
+ * (`phase:'start'`). Kept as a soft alias — no known subscribers.
425
+ */
426
+ EventCategory["PipelineAnalyticsTrackStarted"] = "pipeline-analytics.track-started";
427
+ /**
428
+ * @deprecated Superseded by {@link PipelineAnalyticsTrackLifecycle}
429
+ * (`phase:'end'`). Kept as a soft alias — no known subscribers.
430
+ */
431
+ EventCategory["PipelineAnalyticsTrackEnded"] = "pipeline-analytics.track-ended";
432
+ EventCategory["PipelineAnalyticsDetectionEvent"] = "pipeline-analytics.detection-event";
433
+ EventCategory["PipelineAnalyticsFrameTracked"] = "pipeline-analytics.frame-tracked";
434
+ /**
435
+ * Fired by `addon-post-analysis` when a parked (stationary) object appears
436
+ * (a track was promoted to a stationary-registry entry) or departs (the
437
+ * object moved / was removed). Telemetry (D8): lossy, drives a UI refresh of
438
+ * the dedicated "Stationary" section — never the live event feed. Payload:
439
+ * `{ deviceId, entryId, className, phase:'appeared'|'departed', timestamp }`.
440
+ */
441
+ EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
442
+ /**
443
+ * Fired by `addon-post-analysis` whenever a gallery face row changes:
444
+ * `kind:'buffered'` a new detected face was persisted, `'assigned'` /
445
+ * `'unassigned'` its identity link changed, `'deleted'` the row was
446
+ * removed. Telemetry semantics (D8): a lost event only delays a refresh,
447
+ * never a correctness issue. Payload `PipelineAnalyticsFaceGalleryChangedPayload`.
448
+ */
449
+ EventCategory["PipelineAnalyticsFaceGalleryChanged"] = "pipeline-analytics.face-gallery-changed";
450
+ /**
451
+ * Fired by `addon-post-analysis` whenever a gallery plate row changes:
452
+ * `kind:'buffered'` a new read was persisted (`PlateRecognizer.onTrackEnd`),
453
+ * `'assigned'` / `'unassigned'` its vehicle link changed
454
+ * (`PlateGalleryProvider`), `'deleted'` the row was removed. Telemetry
455
+ * semantics (D8): a lost event only delays a refresh, never a correctness
456
+ * issue. Payload `PipelineAnalyticsPlateGalleryChangedPayload`.
457
+ */
458
+ EventCategory["PipelineAnalyticsPlateGalleryChanged"] = "pipeline-analytics.plate-gallery-changed";
459
+ EventCategory["FrigateLiveEvent"] = "frigate.live-event";
460
+ EventCategory["CameraStreamsProfileSlotsChanged"] = "camera-streams.onProfileSlotsChanged";
461
+ /**
462
+ * Stream-broker health watchdog. Per-broker (deviceId/profile) emission.
463
+ * `stream.offline` fires after STREAM_STALE_TIMEOUT_MS without an encoded
464
+ * packet on an active broker. `stream.online` fires on first packet
465
+ * after a stale gap (or on initial first packet). Payload includes
466
+ * the assigned camStreamId as `profileKey`.
467
+ */
468
+ EventCategory["StreamOnline"] = "stream.online";
469
+ EventCategory["StreamOffline"] = "stream.offline";
470
+ EventCategory["NetworkTunnelStarted"] = "network.tunnel.started";
471
+ EventCategory["NetworkTunnelStopped"] = "network.tunnel.stopped";
472
+ /** Fired by the `local-network` cap when the host's interface set
473
+ * changes (new IP from DHCP, VPN connect, docker bridge added). */
474
+ EventCategory["LocalNetworkChanged"] = "network.local.changed";
475
+ /**
476
+ * Fired by a `mesh-network` provider (Tailscale, …) when its
477
+ * mesh-reachable host changes (join / leave / MagicDNS or 100.x IP
478
+ * change). Lets `local-network` fold the mesh endpoint into its
479
+ * connection-endpoint list without a cross-package import. Payload
480
+ * carries the preferred host (`host: ''` = no longer reachable),
481
+ * the hub port, and the scheme. Telemetry-grade (D8): consumers
482
+ * pull-reconcile from the provider's `getStatus` on reconnect. */
483
+ EventCategory["MeshNetworkChanged"] = "network.mesh.changed";
484
+ EventCategory["BackupCompleted"] = "backup.completed";
485
+ EventCategory["BackupRestored"] = "backup.restored";
486
+ EventCategory["NotificationDispatched"] = "notification.dispatched";
487
+ EventCategory["NotificationFailed"] = "notification.failed";
488
+ EventCategory["DeviceUpdated"] = "device.updated";
489
+ /**
490
+ * Transport-level connectivity. Emitted by the device driver when
491
+ * the underlying control socket actually connects / disconnects
492
+ * (Baichuan TCP, ONVIF probe response, RTSP DESCRIBE, …) — NOT for
493
+ * power-state transitions on a battery camera. For battery wake /
494
+ * doze cycles see `DeviceAwake` / `DeviceSleeping`.
495
+ */
496
+ EventCategory["DeviceOnline"] = "device.online";
497
+ /**
498
+ * Stream-broker watchdog — emitted when no encoded packet has been
499
+ * received for STREAM_STALE_TIMEOUT_MS on an active broker (rtsp or
500
+ * push). Paired with DeviceOnline which fires on first packet after
501
+ * a stale gap. Payload: DeviceStreamHealthPayload.
502
+ */
503
+ EventCategory["DeviceOffline"] = "device.offline";
504
+ /**
505
+ * Battery cam woke up — physical power-state transition reported
506
+ * by the device firmware. Distinct from `DeviceOnline` so a UI panel
507
+ * watching power state doesn't flap on every UDP socket reconnect.
508
+ */
509
+ EventCategory["DeviceAwake"] = "device.awake";
510
+ /**
511
+ * Battery cam went to sleep. See `DeviceAwake`.
512
+ */
513
+ EventCategory["DeviceSleeping"] = "device.sleeping";
514
+ EventCategory["RetentionCleanup"] = "retention.cleanup";
515
+ /**
516
+ * Legacy bulk-update progress snapshot (payload `BulkUpdateState`). No longer
517
+ * emitted — F3 removed the coordinator that produced it; "Update all" now runs
518
+ * as one lifecycle engine job (`AddonsJobProgress`/`AddonsJobLog`). Retained
519
+ * (with `BulkUpdateState`) only to avoid regenerating the event maps; removed
520
+ * in F4 once live bulk progress is re-implemented over the engine events.
521
+ */
522
+ EventCategory["AddonsBulkUpdateProgress"] = "addons.bulk-update-progress";
523
+ EventCategory["AddonsJobProgress"] = "addons.job-progress";
524
+ EventCategory["AddonsJobLog"] = "addons.job-log";
525
+ /**
526
+ * A container's child visibility toggled (hidden/shown). Emitted by the
527
+ * `accessories` cap when a child device is hidden or revealed.
528
+ * Payload: `{ deviceId, childDeviceId, hidden }`.
529
+ */
530
+ EventCategory["AccessoriesChildVisibilityChanged"] = "accessories.onChildVisibilityChanged";
531
+ /**
532
+ * A container's child set changed (children added/removed/reordered).
533
+ * Payload: `{ deviceId, childDeviceIds, hiddenChildIds }`.
534
+ */
535
+ EventCategory["AccessoriesChanged"] = "accessories.onAccessoriesChanged";
536
+ /**
537
+ * Progress update from a running model conversion job.
538
+ * Payload: `{ kind: 'model-convert', phase, sessionId?, pct?, detail? }`.
539
+ * Emitted by `addon-model-studio` on the converting node.
540
+ */
541
+ EventCategory["ModelConvertProgress"] = "model-convert.progress";
542
+ return EventCategory;
543
+ }({});
544
+ //#endregion
545
+ export { EventCategory as t };