@camstack/addon-static-turn 1.2.19 → 1.2.21

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.
@@ -1,5 +1,5 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- //#region ../types/dist/event-category-Bxo5yJjt.mjs
2
+ //#region ../types/dist/event-category-XfKNtfCc.mjs
3
3
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
4
4
  EventCategory["SystemBoot"] = "system.boot";
5
5
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -16,9 +16,10 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
16
16
  EventCategory["SystemRestartCompleted"] = "system.restart-completed";
17
17
  /**
18
18
  * A newer addon or server-root package version was found by the
19
- * authoritative registry check. Emitted once per
20
- * `(target, packageName, currentVersion, latestVersion)` transition; repeated
21
- * polling of the same result is deduplicated by the checker.
19
+ * authoritative registry check. Emitted once when any observed
20
+ * `latestVersion` changes (or a package/node first appears behind);
21
+ * the payload carries the full currently-available list. Repeated
22
+ * polling of the same latests is silent.
22
23
  */
23
24
  EventCategory["UpdateAvailable"] = "update.available";
24
25
  /**
@@ -37,6 +38,22 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
37
38
  EventCategory["AddonInstalled"] = "addon.installed";
38
39
  EventCategory["AddonUninstalled"] = "addon.uninstalled";
39
40
  EventCategory["AddonCrashed"] = "addon.crashed";
41
+ /**
42
+ * A RUNNER the D6 crash circuit-breaker gave up on — terminal.
43
+ *
44
+ * `AddonCrashed` is the routine, self-healing fact ("it crashed; it is being
45
+ * respawned"); this is the one that never resolves itself. Emitted exactly
46
+ * once per trip, by `process-service.ts`, carrying the node, the runner, the
47
+ * addons it hosted and the crash count that tripped the breaker.
48
+ *
49
+ * It exists because a runner marked terminally `failed` used to be SILENT:
50
+ * on 2026-08-18 the `recorder` runner died of three unhandled ffmpeg spawn
51
+ * errors, the breaker stopped respawning it (correctly), `/health` kept
52
+ * returning 200, and fleet-wide recording was gone for 3h15 before the
53
+ * operator's phone told him. The Notification Center's system-event intake
54
+ * consumes this category and maps it to the `addon-crash-loop` kind.
55
+ */
56
+ EventCategory["AddonRunnerFailed"] = "addon.runner-failed";
40
57
  EventCategory["AddonError"] = "addon.error";
41
58
  EventCategory["AddonPageReady"] = "addon.page-ready";
42
59
  EventCategory["AddonWidgetReady"] = "addon.widget-ready";
@@ -7532,6 +7549,10 @@ var RecordingBandSchema = object({
7532
7549
  preBufferSec: number().min(0).optional(),
7533
7550
  postBufferSec: number().min(0).optional()
7534
7551
  });
7552
+ ({
7553
+ preBufferSec: 10,
7554
+ postBufferSec: 30
7555
+ }).postBufferSec * 1e3;
7535
7556
  /**
7536
7557
  * Per-device retention overrides. Every field is optional; an unset or `0`
7537
7558
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -7579,6 +7600,12 @@ var RecordingConfigSchema = object({
7579
7600
  /** DERIVED summary of `bands`, stamped by the recorder on every save.
7580
7601
  * Authoring it has no effect — see {@link RecordingStorageModeSchema}. */
7581
7602
  mode: RecordingStorageModeSchema.optional(),
7603
+ /**
7604
+ * Which assigned broker slots to record. Absent / empty = {@link
7605
+ * DEFAULT_RECORDING_PROFILES} (`high`+`low`) intersected with the
7606
+ * camera's currently assigned slots — never `mid` unless the operator
7607
+ * picks it, and never a slot the broker has not assigned.
7608
+ */
7582
7609
  profiles: array(CamProfileSchema).optional(),
7583
7610
  segmentSeconds: number().int().positive().optional(),
7584
7611
  /**
@@ -7659,7 +7686,11 @@ var RelocateFootageInputSchema = object({
7659
7686
  profiles: array(string()).optional(),
7660
7687
  /** Copy throttle in MB/s (default 40) — the drain is a background chore,
7661
7688
  * never allowed to starve live writers. */
7662
- throttleMbps: number().min(1).max(1e3).optional()
7689
+ throttleMbps: number().min(1).max(1e3).optional(),
7690
+ /** Move only segments whose startMs is >= this. Absent = the whole source
7691
+ * pile. Used when a full drain is too expensive and the operator only
7692
+ * wants the recent window on the new disk. */
7693
+ sinceMs: number().int().optional()
7663
7694
  });
7664
7695
  /** Internal, lease-scoped participant operation. It is intentionally separate
7665
7696
  * from persistent recording settings: a migration never changes
@@ -14222,6 +14253,7 @@ var NcSystemEventKindSchema = _enum([
14222
14253
  "node-offline",
14223
14254
  "node-inference-unavailable",
14224
14255
  "detection-blind",
14256
+ "addon-crash-loop",
14225
14257
  "addon-update-available",
14226
14258
  "server-update-available",
14227
14259
  "alarm-triggered",
@@ -14229,6 +14261,9 @@ var NcSystemEventKindSchema = _enum([
14229
14261
  "alarm-disarmed",
14230
14262
  "alarm-arming",
14231
14263
  "alarm-arm-refused",
14264
+ "addon-updated",
14265
+ "server-updated",
14266
+ "export-completed",
14232
14267
  "camera-online",
14233
14268
  "camera-offline",
14234
14269
  "camera-disabled",
@@ -16122,13 +16157,19 @@ var RetrainStatusSchema = _enum([
16122
16157
  * "never marked" from "already trained" must read `retrainStatus`.
16123
16158
  *
16124
16159
  * `debug` does NOT pin; it is attention, not durability.
16160
+ *
16161
+ * `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
16162
+ * A favourited track is skipped by retention the same way `staging` is, but
16163
+ * it does not enter `none|staging|trained` and has no staging budget.
16125
16164
  */
16126
16165
  var TrackFlagFields = {
16127
16166
  /** Operator marked this track as training material — i.e. `retrainStatus` is
16128
16167
  * `'staging'`. */
16129
16168
  markForTrain: boolean().optional(),
16130
16169
  /** Operator marked this track for diagnostic attention. */
16131
- debug: boolean().optional()
16170
+ debug: boolean().optional(),
16171
+ /** Operator favourited this track. Pins it against pruning. */
16172
+ favourited: boolean().optional()
16132
16173
  };
16133
16174
  /**
16134
16175
  * The lifecycle field itself, on the READ surfaces only (`Track`, `KeyEvent`).
@@ -16153,6 +16194,7 @@ var TrackFlagsSchema = object({
16153
16194
  trackId: string(),
16154
16195
  markForTrain: boolean(),
16155
16196
  debug: boolean(),
16197
+ favourited: boolean(),
16156
16198
  /** The lifecycle state the boolean was derived from. Required here (unlike on
16157
16199
  * a track row) because this shape is only ever produced by the write body,
16158
16200
  * which always knows it — and a surface that has just written needs to render
@@ -16785,6 +16827,12 @@ var TrackCascadeCountsSchema = object({
16785
16827
  /** Per-track CLIP search vectors removed (best-effort). */
16786
16828
  embeddings: number().int()
16787
16829
  });
16830
+ /** Disk-wins reconcile: media rows whose blobs are gone, then empty tracks. */
16831
+ var DiskReconcileCountsSchema = object({
16832
+ mediaDropped: number().int(),
16833
+ tracks: number().int(),
16834
+ events: number().int()
16835
+ });
16788
16836
  /** Event-store footprint for one camera. */
16789
16837
  var EventStoreDeviceFootprintSchema = object({
16790
16838
  deviceId: number(),
@@ -16961,6 +17009,9 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
16961
17009
  }), method(object({ deviceId: number() }), TrackCascadeCountsSchema, {
16962
17010
  kind: "mutation",
16963
17011
  auth: "admin"
17012
+ }), method(object({ deviceId: number() }), DiskReconcileCountsSchema, {
17013
+ kind: "mutation",
17014
+ auth: "admin"
16964
17015
  }), method(object({
16965
17016
  deviceId: number(),
16966
17017
  trackIds: array(string()).min(1)
@@ -18471,6 +18522,24 @@ var CameraStatusDegradationSchema = object({
18471
18522
  *
18472
18523
  * See spec: `docs/superpowers/specs/2026-06-24-camera-status-aggregator-cap.md`
18473
18524
  */
18525
+ var DiskReconcileJobSchema = object({
18526
+ state: _enum([
18527
+ "idle",
18528
+ "running",
18529
+ "done",
18530
+ "error"
18531
+ ]),
18532
+ total: number().int().nonnegative(),
18533
+ completed: number().int().nonnegative(),
18534
+ currentDeviceId: number().int().nullable(),
18535
+ failed: array(number().int()).readonly(),
18536
+ mediaDropped: number().int().nonnegative(),
18537
+ tracks: number().int().nonnegative(),
18538
+ events: number().int().nonnegative(),
18539
+ startedAtMs: number().int().nullable(),
18540
+ finishedAtMs: number().int().nullable(),
18541
+ error: string().nullable()
18542
+ });
18474
18543
  var CameraStatusSchema = object({
18475
18544
  deviceId: number(),
18476
18545
  assignment: CameraAssignmentStatusSchema,
@@ -18702,7 +18771,10 @@ method(StorageMigrationLeaseInputSchema, object({ paused: literal(true) }), {
18702
18771
  }), CameraSwitchGroupSchema, {
18703
18772
  kind: "mutation",
18704
18773
  auth: "admin"
18705
- }), method(object({ deviceId: number() }), CameraStatusSchema), method(object({ deviceIds: array(number()).optional() }), array(CameraStatusSchema).readonly()), method(_void(), array(PipelineTemplateSchema).readonly()), method(object({
18774
+ }), method(object({ deviceId: number() }), CameraStatusSchema), method(object({ deviceIds: array(number()).optional() }), array(CameraStatusSchema).readonly()), method(_void(), DiskReconcileJobSchema, {
18775
+ kind: "mutation",
18776
+ auth: "admin"
18777
+ }), method(_void(), DiskReconcileJobSchema, { auth: "admin" }), method(_void(), array(PipelineTemplateSchema).readonly()), method(object({
18706
18778
  name: string(),
18707
18779
  description: string().optional(),
18708
18780
  config: CameraPipelineConfigSchema
@@ -19798,20 +19870,6 @@ var VectorStatsResultSchema = object({
19798
19870
  exact: boolean()
19799
19871
  });
19800
19872
  method(VectorDeclareIndexInputSchema, _void(), { kind: "mutation" }), method(VectorUpsertInputSchema, VectorUpsertResultSchema, { kind: "mutation" }), method(VectorQueryInputSchema, VectorQueryResultSchema), method(VectorGetInputSchema, VectorGetResultSchema), method(VectorDeleteInputSchema, VectorDeleteResultSchema, { kind: "mutation" }), method(VectorDeleteByFilterInputSchema, VectorDeleteResultSchema, { kind: "mutation" }), method(VectorStatsInputSchema, VectorStatsResultSchema);
19801
- /**
19802
- * `videoclips` — the unified, navigable-clip surface for a camera.
19803
- *
19804
- * A device-scoped WRAPPER cap (like `pipeline-analytics`): exactly one active
19805
- * provider per device, substitutable. The DEFAULT provider (registered by
19806
- * `addon-post-analysis`, `defaultActive: true`) composes the analytics event
19807
- * log (markers + thumbnails) with the recorder's `getPlaybackManifest` — a clip
19808
- * is a time-WINDOW over existing footage, never a separate file. A camera that
19809
- * exposes NATIVE onboard clips (Reolink/Hikvision NVR) can later substitute the
19810
- * wrapper provider for its device and serve its own clip catalog + URLs.
19811
- *
19812
- * A `Clip` is purely time-based (subtree-blind): playback resolves segments by
19813
- * temporal overlap, so the API never decides `continuous` vs `events`.
19814
- */
19815
19873
  var ClipSchema = object({
19816
19874
  /** Opaque, provider-namespaced id. The default provider encodes the time
19817
19875
  * window so `getClipPlayback` is self-contained (no event re-query). */
@@ -19828,8 +19886,65 @@ var ClipSchema = object({
19828
19886
  startMs: number(),
19829
19887
  endMs: number()
19830
19888
  }),
19831
- /** Thumbnail URL (lazy; e.g. analytics `getEventMedia`). Never inlined. */
19832
- thumbnail: string().optional()
19889
+ /**
19890
+ * Distinct object classes attached to this visit (`person`, `car`, …),
19891
+ * dominant first, capped at {@link MAX_CLIP_LABELS}. The ribbon renders these
19892
+ * instead of the bare kind — "Object" tells the operator nothing a colour bar
19893
+ * did not. Absent (never empty) when the visit attached no classified object
19894
+ * event, so a motion/audio-only visit keeps its kind label.
19895
+ */
19896
+ labels: array(string()).max(3).optional(),
19897
+ /**
19898
+ * Lazy thumbnail URL, never inlined.
19899
+ *
19900
+ * Recording-derived clips (events-mode keep-window, and the prepared
19901
+ * continuous event+fragment visit) MUST use the snapshot of the **main
19902
+ * event of the interval** — `getEventMedia({ eventId, kind: 'snapshot' })`
19903
+ * of the event that owns `kind` (object > motion > audio). Do not extract
19904
+ * a keyframe from the recorded segments. Other providers (onboard, HKSV)
19905
+ * mint their own stills.
19906
+ *
19907
+ * **VOUCHED, never fabricated.** A provider emits this only for an event it
19908
+ * has CONFIRMED owns at least one media row (its own, or its owning track's).
19909
+ * Absent is meaningful — "this visit has no event still" — never "we did not
19910
+ * look". Stamping it from a URL template made 35% of one camera's clips point
19911
+ * at a 404 (device 3836, 2026-08-17: 64 of 179 clips dead, 63 of them motion).
19912
+ * A read that FAILS drops the claim; it never invents it.
19913
+ */
19914
+ thumbnail: string().optional(),
19915
+ /**
19916
+ * An instant INSIDE this visit's footage, hole-safe, where a recorded still
19917
+ * can be decoded. Present whenever the visit came from recorded availability;
19918
+ * absent on a per-event padded window (there is no footage to promise).
19919
+ *
19920
+ * This is not a thumbnail and not a second byte path: it is the argument to
19921
+ * the recorder's existing still route. The surface — never the provider —
19922
+ * decides whether to use it. It is the midpoint of the visit's LONGEST
19923
+ * contiguous range, not of the visit: a visit spans its holes by
19924
+ * construction, so a naive midpoint lands in dead air.
19925
+ */
19926
+ stillAtMs: number().optional(),
19927
+ /**
19928
+ * Analytics event ids that overlap this visit — a BOUNDED sample, newest
19929
+ * first within kind (object → motion → audio), capped at
19930
+ * {@link MAX_CLIP_EVENT_IDS}. Empty on footage-only clips.
19931
+ *
19932
+ * Bounded because it is not a payload the surface pages through: one visit on
19933
+ * device 615 carried 2 345 ids, and `eventIds` was 99% of a 153 KB
19934
+ * camera-day. Read {@link eventCount} for the true total.
19935
+ */
19936
+ eventIds: array(string()).optional(),
19937
+ /** How many analytics events actually overlap this visit. Differs from
19938
+ * `eventIds.length` exactly when the sample was capped — so a truncated
19939
+ * list is never mistaken for a quiet visit. */
19940
+ eventCount: number().int().nonnegative().optional(),
19941
+ /** Intra-visit footage holes (GOP rolls, discarded segments) still shorter
19942
+ * than `VISIT_MERGE_GAP_MS`. Playback concatenates around them; the timeline
19943
+ * bar keeps showing them via `recording.getAvailability`. */
19944
+ holes: array(object({
19945
+ startMs: number(),
19946
+ endMs: number()
19947
+ })).optional()
19833
19948
  });
19834
19949
  var ClipPlaybackSchema = object({
19835
19950
  /** HLS master URL through the hub data-plane (Range + token in path). */
@@ -20293,7 +20408,14 @@ var SearchResultSchema = object({
20293
20408
  });
20294
20409
  var AutoUpdateSettingsSchema = object({
20295
20410
  channel: ChannelSchema,
20296
- intervalSeconds: number()
20411
+ intervalSeconds: number(),
20412
+ /**
20413
+ * Cadence of the "an update exists" POLLER, in seconds. Independent of
20414
+ * `channel`: the poller runs while auto-apply is `off`, because being told
20415
+ * about a publish and installing it are different decisions. Clamped
20416
+ * server-side to 900 s … 604800 s; defaults to 21600 s (6 h).
20417
+ */
20418
+ updateCheckIntervalSeconds: number()
20297
20419
  });
20298
20420
  var AddonAutoUpdateSchema = ChannelWithInheritSchema;
20299
20421
  var RestartAddonResultSchema = unknown();
@@ -20434,7 +20556,9 @@ method(_void(), array(AddonListItemSchema).readonly()), method(object({
20434
20556
  auth: "admin"
20435
20557
  }), method(_void(), AutoUpdateSettingsSchema, { auth: "admin" }), method(object({
20436
20558
  channel: ChannelSchema,
20437
- intervalSeconds: number().min(300).max(86400).optional()
20559
+ intervalSeconds: number().min(300).max(86400).optional(),
20560
+ /** Availability-poll cadence; see AutoUpdateSettingsSchema. */
20561
+ updateCheckIntervalSeconds: number().min(900).max(604800).optional()
20438
20562
  }), unknown(), {
20439
20563
  kind: "mutation",
20440
20564
  auth: "admin"
@@ -24427,7 +24551,9 @@ var ExportOptionsSchema = object({
24427
24551
  includeAudio: boolean(),
24428
24552
  maxLifeMs: number().int().positive(),
24429
24553
  deleteAfterDownload: boolean(),
24430
- title: string().max(200).optional()
24554
+ title: string().max(200).optional(),
24555
+ /** Notification-output target ids to ping when this export becomes ready. */
24556
+ notifyTargetIds: array(string().min(1)).max(20).optional()
24431
24557
  }).superRefine((v, ctx) => {
24432
24558
  if (v.speed !== void 0 && v.timelapse !== void 0) ctx.addIssue({
24433
24559
  code: ZodIssueCode.custom,
@@ -24486,10 +24612,18 @@ var ExportBytesSchema = object({
24486
24612
  });
24487
24613
  method(object({
24488
24614
  deviceId: number(),
24489
- profile: string(),
24615
+ /** @deprecated Prefer `profiles`. Kept so timelapse/notifiers keep working. */
24616
+ profile: string().optional(),
24617
+ profiles: array(string()).min(1).optional(),
24490
24618
  fromMs: number(),
24491
24619
  toMs: number(),
24492
24620
  options: ExportOptionsSchema
24621
+ }).superRefine((v, ctx) => {
24622
+ if ((v.profiles !== void 0 && v.profiles.length > 0 ? v.profiles : v.profile !== void 0 ? [v.profile] : []).length < 1) ctx.addIssue({
24623
+ code: ZodIssueCode.custom,
24624
+ message: "pass profiles[] (min 1) or legacy profile",
24625
+ path: ["profiles"]
24626
+ });
24493
24627
  }), ExportRecordSchema, {
24494
24628
  kind: "mutation",
24495
24629
  auth: "protected"
@@ -29089,6 +29223,12 @@ Object.freeze({
29089
29223
  addonId: null,
29090
29224
  access: "create"
29091
29225
  },
29226
+ "pipelineAnalytics.reconcileFromDisk": {
29227
+ capName: "pipeline-analytics",
29228
+ capScope: "device",
29229
+ addonId: null,
29230
+ access: "create"
29231
+ },
29092
29232
  "pipelineAnalytics.refreshStorageLocationsForMigration": {
29093
29233
  capName: "pipeline-analytics",
29094
29234
  capScope: "device",
@@ -29491,6 +29631,12 @@ Object.freeze({
29491
29631
  addonId: null,
29492
29632
  access: "view"
29493
29633
  },
29634
+ "pipelineOrchestrator.getReconcileFromDiskStatus": {
29635
+ capName: "pipeline-orchestrator",
29636
+ capScope: "system",
29637
+ addonId: null,
29638
+ access: "view"
29639
+ },
29494
29640
  "pipelineOrchestrator.listAgentSettings": {
29495
29641
  capName: "pipeline-orchestrator",
29496
29642
  capScope: "system",
@@ -29515,6 +29661,12 @@ Object.freeze({
29515
29661
  addonId: null,
29516
29662
  access: "create"
29517
29663
  },
29664
+ "pipelineOrchestrator.reconcileFromDisk": {
29665
+ capName: "pipeline-orchestrator",
29666
+ capScope: "system",
29667
+ addonId: null,
29668
+ access: "create"
29669
+ },
29518
29670
  "pipelineOrchestrator.removeAgentSettings": {
29519
29671
  capName: "pipeline-orchestrator",
29520
29672
  capScope: "system",
@@ -32506,6 +32658,11 @@ Object.freeze({
32506
32658
  form: "single",
32507
32659
  optional: true
32508
32660
  }],
32661
+ "pipelineAnalytics.reconcileFromDisk": [{
32662
+ name: "deviceId",
32663
+ form: "single",
32664
+ optional: false
32665
+ }],
32509
32666
  "pipelineAnalytics.restageRetrainTrack": [{
32510
32667
  name: "deviceId",
32511
32668
  form: "single",
@@ -33571,6 +33728,8 @@ DEFAULT_NATIVE_LEASE_SETTINGS.budgetMb;
33571
33728
  DEFAULT_NATIVE_LEASE_SETTINGS.activityMs;
33572
33729
  DEFAULT_NATIVE_LEASE_SETTINGS.tileBudgetMb;
33573
33730
  DEFAULT_NATIVE_LEASE_SETTINGS.admission;
33731
+ var MB = 1024 * 1024;
33732
+ 1024 * MB, 3072 * MB;
33574
33733
  //#endregion
33575
33734
  //#region src/static-turn.addon.ts
33576
33735
  /**
@@ -1,4 +1,4 @@
1
- //#region ../types/dist/event-category-Bxo5yJjt.mjs
1
+ //#region ../types/dist/event-category-XfKNtfCc.mjs
2
2
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
3
3
  EventCategory["SystemBoot"] = "system.boot";
4
4
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -15,9 +15,10 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
15
15
  EventCategory["SystemRestartCompleted"] = "system.restart-completed";
16
16
  /**
17
17
  * A newer addon or server-root package version was found by the
18
- * authoritative registry check. Emitted once per
19
- * `(target, packageName, currentVersion, latestVersion)` transition; repeated
20
- * polling of the same result is deduplicated by the checker.
18
+ * authoritative registry check. Emitted once when any observed
19
+ * `latestVersion` changes (or a package/node first appears behind);
20
+ * the payload carries the full currently-available list. Repeated
21
+ * polling of the same latests is silent.
21
22
  */
22
23
  EventCategory["UpdateAvailable"] = "update.available";
23
24
  /**
@@ -36,6 +37,22 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
36
37
  EventCategory["AddonInstalled"] = "addon.installed";
37
38
  EventCategory["AddonUninstalled"] = "addon.uninstalled";
38
39
  EventCategory["AddonCrashed"] = "addon.crashed";
40
+ /**
41
+ * A RUNNER the D6 crash circuit-breaker gave up on — terminal.
42
+ *
43
+ * `AddonCrashed` is the routine, self-healing fact ("it crashed; it is being
44
+ * respawned"); this is the one that never resolves itself. Emitted exactly
45
+ * once per trip, by `process-service.ts`, carrying the node, the runner, the
46
+ * addons it hosted and the crash count that tripped the breaker.
47
+ *
48
+ * It exists because a runner marked terminally `failed` used to be SILENT:
49
+ * on 2026-08-18 the `recorder` runner died of three unhandled ffmpeg spawn
50
+ * errors, the breaker stopped respawning it (correctly), `/health` kept
51
+ * returning 200, and fleet-wide recording was gone for 3h15 before the
52
+ * operator's phone told him. The Notification Center's system-event intake
53
+ * consumes this category and maps it to the `addon-crash-loop` kind.
54
+ */
55
+ EventCategory["AddonRunnerFailed"] = "addon.runner-failed";
39
56
  EventCategory["AddonError"] = "addon.error";
40
57
  EventCategory["AddonPageReady"] = "addon.page-ready";
41
58
  EventCategory["AddonWidgetReady"] = "addon.widget-ready";
@@ -7531,6 +7548,10 @@ var RecordingBandSchema = object({
7531
7548
  preBufferSec: number().min(0).optional(),
7532
7549
  postBufferSec: number().min(0).optional()
7533
7550
  });
7551
+ ({
7552
+ preBufferSec: 10,
7553
+ postBufferSec: 30
7554
+ }).postBufferSec * 1e3;
7534
7555
  /**
7535
7556
  * Per-device retention overrides. Every field is optional; an unset or `0`
7536
7557
  * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -7578,6 +7599,12 @@ var RecordingConfigSchema = object({
7578
7599
  /** DERIVED summary of `bands`, stamped by the recorder on every save.
7579
7600
  * Authoring it has no effect — see {@link RecordingStorageModeSchema}. */
7580
7601
  mode: RecordingStorageModeSchema.optional(),
7602
+ /**
7603
+ * Which assigned broker slots to record. Absent / empty = {@link
7604
+ * DEFAULT_RECORDING_PROFILES} (`high`+`low`) intersected with the
7605
+ * camera's currently assigned slots — never `mid` unless the operator
7606
+ * picks it, and never a slot the broker has not assigned.
7607
+ */
7581
7608
  profiles: array(CamProfileSchema).optional(),
7582
7609
  segmentSeconds: number().int().positive().optional(),
7583
7610
  /**
@@ -7658,7 +7685,11 @@ var RelocateFootageInputSchema = object({
7658
7685
  profiles: array(string()).optional(),
7659
7686
  /** Copy throttle in MB/s (default 40) — the drain is a background chore,
7660
7687
  * never allowed to starve live writers. */
7661
- throttleMbps: number().min(1).max(1e3).optional()
7688
+ throttleMbps: number().min(1).max(1e3).optional(),
7689
+ /** Move only segments whose startMs is >= this. Absent = the whole source
7690
+ * pile. Used when a full drain is too expensive and the operator only
7691
+ * wants the recent window on the new disk. */
7692
+ sinceMs: number().int().optional()
7662
7693
  });
7663
7694
  /** Internal, lease-scoped participant operation. It is intentionally separate
7664
7695
  * from persistent recording settings: a migration never changes
@@ -14221,6 +14252,7 @@ var NcSystemEventKindSchema = _enum([
14221
14252
  "node-offline",
14222
14253
  "node-inference-unavailable",
14223
14254
  "detection-blind",
14255
+ "addon-crash-loop",
14224
14256
  "addon-update-available",
14225
14257
  "server-update-available",
14226
14258
  "alarm-triggered",
@@ -14228,6 +14260,9 @@ var NcSystemEventKindSchema = _enum([
14228
14260
  "alarm-disarmed",
14229
14261
  "alarm-arming",
14230
14262
  "alarm-arm-refused",
14263
+ "addon-updated",
14264
+ "server-updated",
14265
+ "export-completed",
14231
14266
  "camera-online",
14232
14267
  "camera-offline",
14233
14268
  "camera-disabled",
@@ -16121,13 +16156,19 @@ var RetrainStatusSchema = _enum([
16121
16156
  * "never marked" from "already trained" must read `retrainStatus`.
16122
16157
  *
16123
16158
  * `debug` does NOT pin; it is attention, not durability.
16159
+ *
16160
+ * `favourited` IS a BOOLEAN pin (durability bit), not a retrain lifecycle.
16161
+ * A favourited track is skipped by retention the same way `staging` is, but
16162
+ * it does not enter `none|staging|trained` and has no staging budget.
16124
16163
  */
16125
16164
  var TrackFlagFields = {
16126
16165
  /** Operator marked this track as training material — i.e. `retrainStatus` is
16127
16166
  * `'staging'`. */
16128
16167
  markForTrain: boolean().optional(),
16129
16168
  /** Operator marked this track for diagnostic attention. */
16130
- debug: boolean().optional()
16169
+ debug: boolean().optional(),
16170
+ /** Operator favourited this track. Pins it against pruning. */
16171
+ favourited: boolean().optional()
16131
16172
  };
16132
16173
  /**
16133
16174
  * The lifecycle field itself, on the READ surfaces only (`Track`, `KeyEvent`).
@@ -16152,6 +16193,7 @@ var TrackFlagsSchema = object({
16152
16193
  trackId: string(),
16153
16194
  markForTrain: boolean(),
16154
16195
  debug: boolean(),
16196
+ favourited: boolean(),
16155
16197
  /** The lifecycle state the boolean was derived from. Required here (unlike on
16156
16198
  * a track row) because this shape is only ever produced by the write body,
16157
16199
  * which always knows it — and a surface that has just written needs to render
@@ -16784,6 +16826,12 @@ var TrackCascadeCountsSchema = object({
16784
16826
  /** Per-track CLIP search vectors removed (best-effort). */
16785
16827
  embeddings: number().int()
16786
16828
  });
16829
+ /** Disk-wins reconcile: media rows whose blobs are gone, then empty tracks. */
16830
+ var DiskReconcileCountsSchema = object({
16831
+ mediaDropped: number().int(),
16832
+ tracks: number().int(),
16833
+ events: number().int()
16834
+ });
16787
16835
  /** Event-store footprint for one camera. */
16788
16836
  var EventStoreDeviceFootprintSchema = object({
16789
16837
  deviceId: number(),
@@ -16960,6 +17008,9 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
16960
17008
  }), method(object({ deviceId: number() }), TrackCascadeCountsSchema, {
16961
17009
  kind: "mutation",
16962
17010
  auth: "admin"
17011
+ }), method(object({ deviceId: number() }), DiskReconcileCountsSchema, {
17012
+ kind: "mutation",
17013
+ auth: "admin"
16963
17014
  }), method(object({
16964
17015
  deviceId: number(),
16965
17016
  trackIds: array(string()).min(1)
@@ -18470,6 +18521,24 @@ var CameraStatusDegradationSchema = object({
18470
18521
  *
18471
18522
  * See spec: `docs/superpowers/specs/2026-06-24-camera-status-aggregator-cap.md`
18472
18523
  */
18524
+ var DiskReconcileJobSchema = object({
18525
+ state: _enum([
18526
+ "idle",
18527
+ "running",
18528
+ "done",
18529
+ "error"
18530
+ ]),
18531
+ total: number().int().nonnegative(),
18532
+ completed: number().int().nonnegative(),
18533
+ currentDeviceId: number().int().nullable(),
18534
+ failed: array(number().int()).readonly(),
18535
+ mediaDropped: number().int().nonnegative(),
18536
+ tracks: number().int().nonnegative(),
18537
+ events: number().int().nonnegative(),
18538
+ startedAtMs: number().int().nullable(),
18539
+ finishedAtMs: number().int().nullable(),
18540
+ error: string().nullable()
18541
+ });
18473
18542
  var CameraStatusSchema = object({
18474
18543
  deviceId: number(),
18475
18544
  assignment: CameraAssignmentStatusSchema,
@@ -18701,7 +18770,10 @@ method(StorageMigrationLeaseInputSchema, object({ paused: literal(true) }), {
18701
18770
  }), CameraSwitchGroupSchema, {
18702
18771
  kind: "mutation",
18703
18772
  auth: "admin"
18704
- }), method(object({ deviceId: number() }), CameraStatusSchema), method(object({ deviceIds: array(number()).optional() }), array(CameraStatusSchema).readonly()), method(_void(), array(PipelineTemplateSchema).readonly()), method(object({
18773
+ }), method(object({ deviceId: number() }), CameraStatusSchema), method(object({ deviceIds: array(number()).optional() }), array(CameraStatusSchema).readonly()), method(_void(), DiskReconcileJobSchema, {
18774
+ kind: "mutation",
18775
+ auth: "admin"
18776
+ }), method(_void(), DiskReconcileJobSchema, { auth: "admin" }), method(_void(), array(PipelineTemplateSchema).readonly()), method(object({
18705
18777
  name: string(),
18706
18778
  description: string().optional(),
18707
18779
  config: CameraPipelineConfigSchema
@@ -19797,20 +19869,6 @@ var VectorStatsResultSchema = object({
19797
19869
  exact: boolean()
19798
19870
  });
19799
19871
  method(VectorDeclareIndexInputSchema, _void(), { kind: "mutation" }), method(VectorUpsertInputSchema, VectorUpsertResultSchema, { kind: "mutation" }), method(VectorQueryInputSchema, VectorQueryResultSchema), method(VectorGetInputSchema, VectorGetResultSchema), method(VectorDeleteInputSchema, VectorDeleteResultSchema, { kind: "mutation" }), method(VectorDeleteByFilterInputSchema, VectorDeleteResultSchema, { kind: "mutation" }), method(VectorStatsInputSchema, VectorStatsResultSchema);
19800
- /**
19801
- * `videoclips` — the unified, navigable-clip surface for a camera.
19802
- *
19803
- * A device-scoped WRAPPER cap (like `pipeline-analytics`): exactly one active
19804
- * provider per device, substitutable. The DEFAULT provider (registered by
19805
- * `addon-post-analysis`, `defaultActive: true`) composes the analytics event
19806
- * log (markers + thumbnails) with the recorder's `getPlaybackManifest` — a clip
19807
- * is a time-WINDOW over existing footage, never a separate file. A camera that
19808
- * exposes NATIVE onboard clips (Reolink/Hikvision NVR) can later substitute the
19809
- * wrapper provider for its device and serve its own clip catalog + URLs.
19810
- *
19811
- * A `Clip` is purely time-based (subtree-blind): playback resolves segments by
19812
- * temporal overlap, so the API never decides `continuous` vs `events`.
19813
- */
19814
19872
  var ClipSchema = object({
19815
19873
  /** Opaque, provider-namespaced id. The default provider encodes the time
19816
19874
  * window so `getClipPlayback` is self-contained (no event re-query). */
@@ -19827,8 +19885,65 @@ var ClipSchema = object({
19827
19885
  startMs: number(),
19828
19886
  endMs: number()
19829
19887
  }),
19830
- /** Thumbnail URL (lazy; e.g. analytics `getEventMedia`). Never inlined. */
19831
- thumbnail: string().optional()
19888
+ /**
19889
+ * Distinct object classes attached to this visit (`person`, `car`, …),
19890
+ * dominant first, capped at {@link MAX_CLIP_LABELS}. The ribbon renders these
19891
+ * instead of the bare kind — "Object" tells the operator nothing a colour bar
19892
+ * did not. Absent (never empty) when the visit attached no classified object
19893
+ * event, so a motion/audio-only visit keeps its kind label.
19894
+ */
19895
+ labels: array(string()).max(3).optional(),
19896
+ /**
19897
+ * Lazy thumbnail URL, never inlined.
19898
+ *
19899
+ * Recording-derived clips (events-mode keep-window, and the prepared
19900
+ * continuous event+fragment visit) MUST use the snapshot of the **main
19901
+ * event of the interval** — `getEventMedia({ eventId, kind: 'snapshot' })`
19902
+ * of the event that owns `kind` (object > motion > audio). Do not extract
19903
+ * a keyframe from the recorded segments. Other providers (onboard, HKSV)
19904
+ * mint their own stills.
19905
+ *
19906
+ * **VOUCHED, never fabricated.** A provider emits this only for an event it
19907
+ * has CONFIRMED owns at least one media row (its own, or its owning track's).
19908
+ * Absent is meaningful — "this visit has no event still" — never "we did not
19909
+ * look". Stamping it from a URL template made 35% of one camera's clips point
19910
+ * at a 404 (device 3836, 2026-08-17: 64 of 179 clips dead, 63 of them motion).
19911
+ * A read that FAILS drops the claim; it never invents it.
19912
+ */
19913
+ thumbnail: string().optional(),
19914
+ /**
19915
+ * An instant INSIDE this visit's footage, hole-safe, where a recorded still
19916
+ * can be decoded. Present whenever the visit came from recorded availability;
19917
+ * absent on a per-event padded window (there is no footage to promise).
19918
+ *
19919
+ * This is not a thumbnail and not a second byte path: it is the argument to
19920
+ * the recorder's existing still route. The surface — never the provider —
19921
+ * decides whether to use it. It is the midpoint of the visit's LONGEST
19922
+ * contiguous range, not of the visit: a visit spans its holes by
19923
+ * construction, so a naive midpoint lands in dead air.
19924
+ */
19925
+ stillAtMs: number().optional(),
19926
+ /**
19927
+ * Analytics event ids that overlap this visit — a BOUNDED sample, newest
19928
+ * first within kind (object → motion → audio), capped at
19929
+ * {@link MAX_CLIP_EVENT_IDS}. Empty on footage-only clips.
19930
+ *
19931
+ * Bounded because it is not a payload the surface pages through: one visit on
19932
+ * device 615 carried 2 345 ids, and `eventIds` was 99% of a 153 KB
19933
+ * camera-day. Read {@link eventCount} for the true total.
19934
+ */
19935
+ eventIds: array(string()).optional(),
19936
+ /** How many analytics events actually overlap this visit. Differs from
19937
+ * `eventIds.length` exactly when the sample was capped — so a truncated
19938
+ * list is never mistaken for a quiet visit. */
19939
+ eventCount: number().int().nonnegative().optional(),
19940
+ /** Intra-visit footage holes (GOP rolls, discarded segments) still shorter
19941
+ * than `VISIT_MERGE_GAP_MS`. Playback concatenates around them; the timeline
19942
+ * bar keeps showing them via `recording.getAvailability`. */
19943
+ holes: array(object({
19944
+ startMs: number(),
19945
+ endMs: number()
19946
+ })).optional()
19832
19947
  });
19833
19948
  var ClipPlaybackSchema = object({
19834
19949
  /** HLS master URL through the hub data-plane (Range + token in path). */
@@ -20292,7 +20407,14 @@ var SearchResultSchema = object({
20292
20407
  });
20293
20408
  var AutoUpdateSettingsSchema = object({
20294
20409
  channel: ChannelSchema,
20295
- intervalSeconds: number()
20410
+ intervalSeconds: number(),
20411
+ /**
20412
+ * Cadence of the "an update exists" POLLER, in seconds. Independent of
20413
+ * `channel`: the poller runs while auto-apply is `off`, because being told
20414
+ * about a publish and installing it are different decisions. Clamped
20415
+ * server-side to 900 s … 604800 s; defaults to 21600 s (6 h).
20416
+ */
20417
+ updateCheckIntervalSeconds: number()
20296
20418
  });
20297
20419
  var AddonAutoUpdateSchema = ChannelWithInheritSchema;
20298
20420
  var RestartAddonResultSchema = unknown();
@@ -20433,7 +20555,9 @@ method(_void(), array(AddonListItemSchema).readonly()), method(object({
20433
20555
  auth: "admin"
20434
20556
  }), method(_void(), AutoUpdateSettingsSchema, { auth: "admin" }), method(object({
20435
20557
  channel: ChannelSchema,
20436
- intervalSeconds: number().min(300).max(86400).optional()
20558
+ intervalSeconds: number().min(300).max(86400).optional(),
20559
+ /** Availability-poll cadence; see AutoUpdateSettingsSchema. */
20560
+ updateCheckIntervalSeconds: number().min(900).max(604800).optional()
20437
20561
  }), unknown(), {
20438
20562
  kind: "mutation",
20439
20563
  auth: "admin"
@@ -24426,7 +24550,9 @@ var ExportOptionsSchema = object({
24426
24550
  includeAudio: boolean(),
24427
24551
  maxLifeMs: number().int().positive(),
24428
24552
  deleteAfterDownload: boolean(),
24429
- title: string().max(200).optional()
24553
+ title: string().max(200).optional(),
24554
+ /** Notification-output target ids to ping when this export becomes ready. */
24555
+ notifyTargetIds: array(string().min(1)).max(20).optional()
24430
24556
  }).superRefine((v, ctx) => {
24431
24557
  if (v.speed !== void 0 && v.timelapse !== void 0) ctx.addIssue({
24432
24558
  code: ZodIssueCode.custom,
@@ -24485,10 +24611,18 @@ var ExportBytesSchema = object({
24485
24611
  });
24486
24612
  method(object({
24487
24613
  deviceId: number(),
24488
- profile: string(),
24614
+ /** @deprecated Prefer `profiles`. Kept so timelapse/notifiers keep working. */
24615
+ profile: string().optional(),
24616
+ profiles: array(string()).min(1).optional(),
24489
24617
  fromMs: number(),
24490
24618
  toMs: number(),
24491
24619
  options: ExportOptionsSchema
24620
+ }).superRefine((v, ctx) => {
24621
+ if ((v.profiles !== void 0 && v.profiles.length > 0 ? v.profiles : v.profile !== void 0 ? [v.profile] : []).length < 1) ctx.addIssue({
24622
+ code: ZodIssueCode.custom,
24623
+ message: "pass profiles[] (min 1) or legacy profile",
24624
+ path: ["profiles"]
24625
+ });
24492
24626
  }), ExportRecordSchema, {
24493
24627
  kind: "mutation",
24494
24628
  auth: "protected"
@@ -29088,6 +29222,12 @@ Object.freeze({
29088
29222
  addonId: null,
29089
29223
  access: "create"
29090
29224
  },
29225
+ "pipelineAnalytics.reconcileFromDisk": {
29226
+ capName: "pipeline-analytics",
29227
+ capScope: "device",
29228
+ addonId: null,
29229
+ access: "create"
29230
+ },
29091
29231
  "pipelineAnalytics.refreshStorageLocationsForMigration": {
29092
29232
  capName: "pipeline-analytics",
29093
29233
  capScope: "device",
@@ -29490,6 +29630,12 @@ Object.freeze({
29490
29630
  addonId: null,
29491
29631
  access: "view"
29492
29632
  },
29633
+ "pipelineOrchestrator.getReconcileFromDiskStatus": {
29634
+ capName: "pipeline-orchestrator",
29635
+ capScope: "system",
29636
+ addonId: null,
29637
+ access: "view"
29638
+ },
29493
29639
  "pipelineOrchestrator.listAgentSettings": {
29494
29640
  capName: "pipeline-orchestrator",
29495
29641
  capScope: "system",
@@ -29514,6 +29660,12 @@ Object.freeze({
29514
29660
  addonId: null,
29515
29661
  access: "create"
29516
29662
  },
29663
+ "pipelineOrchestrator.reconcileFromDisk": {
29664
+ capName: "pipeline-orchestrator",
29665
+ capScope: "system",
29666
+ addonId: null,
29667
+ access: "create"
29668
+ },
29517
29669
  "pipelineOrchestrator.removeAgentSettings": {
29518
29670
  capName: "pipeline-orchestrator",
29519
29671
  capScope: "system",
@@ -32505,6 +32657,11 @@ Object.freeze({
32505
32657
  form: "single",
32506
32658
  optional: true
32507
32659
  }],
32660
+ "pipelineAnalytics.reconcileFromDisk": [{
32661
+ name: "deviceId",
32662
+ form: "single",
32663
+ optional: false
32664
+ }],
32508
32665
  "pipelineAnalytics.restageRetrainTrack": [{
32509
32666
  name: "deviceId",
32510
32667
  form: "single",
@@ -33570,6 +33727,8 @@ DEFAULT_NATIVE_LEASE_SETTINGS.budgetMb;
33570
33727
  DEFAULT_NATIVE_LEASE_SETTINGS.activityMs;
33571
33728
  DEFAULT_NATIVE_LEASE_SETTINGS.tileBudgetMb;
33572
33729
  DEFAULT_NATIVE_LEASE_SETTINGS.admission;
33730
+ var MB = 1024 * 1024;
33731
+ 1024 * MB, 3072 * MB;
33573
33732
  //#endregion
33574
33733
  //#region src/static-turn.addon.ts
33575
33734
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-static-turn",
3
- "version": "1.2.19",
3
+ "version": "1.2.21",
4
4
  "description": "Static / self-hosted (coturn) TURN provider for CamStack",
5
5
  "keywords": [
6
6
  "camstack",