@camstack/addon-pipeline 1.2.215 → 1.2.217

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.
Files changed (37) hide show
  1. package/dist/audio-analyzer/index.js +2 -2
  2. package/dist/audio-analyzer/index.mjs +2 -2
  3. package/dist/{default-detection-model-C2vYSX3O.mjs → default-detection-model-BwNEV8Wl.mjs} +1 -1
  4. package/dist/{default-detection-model-f0PImZnh.js → default-detection-model-DzzuINe-.js} +1 -1
  5. package/dist/detection-pipeline/index.js +5 -5
  6. package/dist/detection-pipeline/index.mjs +4 -4
  7. package/dist/{dist-DoHcimdu.js → dist-D7hxiBnC.js} +237 -16
  8. package/dist/{dist-DttqKvsQ.mjs → dist-DgeXZfwn.mjs} +237 -16
  9. package/dist/{lazy-sharp-BeeQGCUu.js → lazy-sharp-BSkbiuz5.js} +1 -1
  10. package/dist/motion-wasm/index.js +2 -2
  11. package/dist/motion-wasm/index.mjs +1 -1
  12. package/dist/{node-NtM7__8q.mjs → node-C9GcBrwk.mjs} +1 -1
  13. package/dist/{node-6uF72wri.js → node-DDhmPcOx.js} +1 -1
  14. package/dist/pipeline-runner/index.js +538 -24
  15. package/dist/pipeline-runner/index.mjs +537 -23
  16. package/dist/{process-memory-CddpCDWL.mjs → process-memory-Dw3CGS3D.mjs} +1 -1
  17. package/dist/{process-memory-BRdyl5fE.js → process-memory-ENqmiiis.js} +1 -1
  18. package/dist/recorder/index.js +148 -40
  19. package/dist/recorder/index.mjs +148 -40
  20. package/dist/{segment-demux-js-CsFtPVzH.mjs → segment-demux-js-BGbKlotF.mjs} +1 -1
  21. package/dist/{segment-demux-js-CkJPdyDH.js → segment-demux-js-sLs8mbZQ.js} +1 -1
  22. package/dist/session-decode/decode-worker-child.js +58 -45
  23. package/dist/session-decode/decode-worker-child.mjs +57 -44
  24. package/dist/stream-broker/_stub.js +2 -2
  25. package/dist/stream-broker/{_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-ZIja2AOe.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-BULotDCb.mjs} +3 -3
  26. package/dist/stream-broker/_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-yJ2CyixO.mjs +26 -0
  27. package/dist/stream-broker/{_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_ui_mf_2_library__loadShare__.js-Uxkwkgy5.mjs → _virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_ui_mf_2_library__loadShare__.js-DICVQkNi.mjs} +1 -1
  28. package/dist/stream-broker/demux-worker-child.js +1 -1
  29. package/dist/stream-broker/demux-worker-child.mjs +1 -1
  30. package/dist/stream-broker/{hostInit-DpatMS4g.mjs → hostInit-_RQxF72h.mjs} +3 -3
  31. package/dist/stream-broker/index.js +20 -21
  32. package/dist/stream-broker/index.mjs +20 -21
  33. package/dist/stream-broker/remoteEntry.js +1 -1
  34. package/dist/{worker-protocol-BWO2WNjw.js → worker-protocol-DGql9R4g.js} +1 -1
  35. package/dist/{worker-protocol-BKwkLZWT.mjs → worker-protocol-SzmaLNnP.mjs} +1 -1
  36. package/package.json +1 -1
  37. package/dist/stream-broker/_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-0MF-KL1v.mjs +0 -26
@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_dist = require("../dist-DoHcimdu.js");
6
- const require_process_memory = require("../process-memory-BRdyl5fE.js");
5
+ const require_dist = require("../dist-D7hxiBnC.js");
6
+ const require_process_memory = require("../process-memory-ENqmiiis.js");
7
7
  let node_fs = require("node:fs");
8
8
  node_fs = require_dist.__toESM(node_fs);
9
9
  let node_path = require("node:path");
@@ -1,6 +1,6 @@
1
1
  import { n as __require } from "../chunk-DnnnRqeS.mjs";
2
- import { Dt as resolvePoolMemoryPolicy, It as errMsg, Jt as hydrateSchema, M as audioAnalyzerCapability, S as PoolMemoryWatchdog, Ut as BaseAddon, j as audioAnalysisCapability, n as AUDIO_BACKEND_CHOICES, ot as mapAudioLabelToMacro, s as DEFAULT_AUDIO_ANALYZER_CONFIG, v as HF_BASE_URL } from "../dist-DttqKvsQ.mjs";
3
- import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-CddpCDWL.mjs";
2
+ import { Dt as resolvePoolMemoryPolicy, It as errMsg, Jt as hydrateSchema, M as audioAnalyzerCapability, S as PoolMemoryWatchdog, Ut as BaseAddon, j as audioAnalysisCapability, n as AUDIO_BACKEND_CHOICES, ot as mapAudioLabelToMacro, s as DEFAULT_AUDIO_ANALYZER_CONFIG, v as HF_BASE_URL } from "../dist-DgeXZfwn.mjs";
3
+ import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-Dw3CGS3D.mjs";
4
4
  import * as fs from "node:fs";
5
5
  import * as path$1 from "node:path";
6
6
  import { downloadFile } from "@camstack/system/addon-utils";
@@ -1,4 +1,4 @@
1
- import { N as audioKindId, a as COCO_80_LABELS, o as COCO_TO_MACRO, r as AUDIO_MACRO_LABELS, tt as hfModelUrl } from "./dist-DttqKvsQ.mjs";
1
+ import { N as audioKindId, a as COCO_80_LABELS, o as COCO_TO_MACRO, r as AUDIO_MACRO_LABELS, tt as hfModelUrl } from "./dist-DgeXZfwn.mjs";
2
2
  import { randomUUID } from "node:crypto";
3
3
  //#region src/detection-pipeline/pipeline/landmark-precision-gate.ts
4
4
  /**
@@ -1,4 +1,4 @@
1
- const require_dist = require("./dist-DoHcimdu.js");
1
+ const require_dist = require("./dist-D7hxiBnC.js");
2
2
  let node_crypto = require("node:crypto");
3
3
  //#region src/detection-pipeline/pipeline/landmark-precision-gate.ts
4
4
  /**
@@ -2,11 +2,11 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_dist = require("../dist-DoHcimdu.js");
6
- const require_node = require("../node-6uF72wri.js");
7
- const require_default_detection_model = require("../default-detection-model-f0PImZnh.js");
8
- const require_lazy_sharp = require("../lazy-sharp-BeeQGCUu.js");
9
- const require_process_memory = require("../process-memory-BRdyl5fE.js");
5
+ const require_dist = require("../dist-D7hxiBnC.js");
6
+ const require_node = require("../node-DDhmPcOx.js");
7
+ const require_default_detection_model = require("../default-detection-model-DzzuINe-.js");
8
+ const require_lazy_sharp = require("../lazy-sharp-BSkbiuz5.js");
9
+ const require_process_memory = require("../process-memory-ENqmiiis.js");
10
10
  let node_os = require("node:os");
11
11
  node_os = require_dist.__toESM(node_os);
12
12
  let node_fs = require("node:fs");
@@ -1,9 +1,9 @@
1
1
  import { n as __require } from "../chunk-DnnnRqeS.mjs";
2
- import { $t as parseJsonUnknown, B as defaultDeviceFor$1, Dt as resolvePoolMemoryPolicy, G as detectionPipelineCapability, It as errMsg, J as enumerateInferenceDevices, Jt as hydrateSchema, Pt as supportedRuntimes$1, Qt as nodePin, S as PoolMemoryWatchdog, Ut as BaseAddon, X as evaluateZoneRules, c as DEFAULT_CLUSTER_STEP_MODELS, gt as pickClusterStepSettings, hn as EventCategory, ht as pickClusterStepModels, in as array, it as loadContributionCapability, k as YAMNET_TO_MACRO, kt as runtimeDevices$1, l as DEFAULT_CLUSTER_STEP_SETTINGS, m as DEVICE_BACKEND_TO_FORMAT, mn as union, nn as sleep, nt as inferModelProvider, pn as string, pt as overlayClusterStepSettings, qt as createEvent, t as APPLE_SA_TO_MACRO, un as object, wt as resolveClusterStepModelId, yt as pipelineExecutorCapability } from "../dist-DttqKvsQ.mjs";
3
- import { o as readProcessCost } from "../node-NtM7__8q.mjs";
4
- import { a as ALL_PIPELINE_STEPS, c as getStep, d as landmarkPrecisionVerdict, l as getStepDefinition, n as resolveDefaultDetectionModel, o as ALL_STEPS, r as localFrameRegistry, s as getDefaultModelForFormat, u as resolveModelForFormat } from "../default-detection-model-C2vYSX3O.mjs";
2
+ import { $t as parseJsonUnknown, B as defaultDeviceFor$1, Dt as resolvePoolMemoryPolicy, G as detectionPipelineCapability, It as errMsg, J as enumerateInferenceDevices, Jt as hydrateSchema, Pt as supportedRuntimes$1, Qt as nodePin, S as PoolMemoryWatchdog, Ut as BaseAddon, X as evaluateZoneRules, c as DEFAULT_CLUSTER_STEP_MODELS, gt as pickClusterStepSettings, hn as EventCategory, ht as pickClusterStepModels, in as array, it as loadContributionCapability, k as YAMNET_TO_MACRO, kt as runtimeDevices$1, l as DEFAULT_CLUSTER_STEP_SETTINGS, m as DEVICE_BACKEND_TO_FORMAT, mn as union, nn as sleep, nt as inferModelProvider, pn as string, pt as overlayClusterStepSettings, qt as createEvent, t as APPLE_SA_TO_MACRO, un as object, wt as resolveClusterStepModelId, yt as pipelineExecutorCapability } from "../dist-DgeXZfwn.mjs";
3
+ import { o as readProcessCost } from "../node-C9GcBrwk.mjs";
4
+ import { a as ALL_PIPELINE_STEPS, c as getStep, d as landmarkPrecisionVerdict, l as getStepDefinition, n as resolveDefaultDetectionModel, o as ALL_STEPS, r as localFrameRegistry, s as getDefaultModelForFormat, u as resolveModelForFormat } from "../default-detection-model-BwNEV8Wl.mjs";
5
5
  import { t as getSharp } from "../lazy-sharp-DXsqwpph.mjs";
6
- import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-CddpCDWL.mjs";
6
+ import { n as pickNodePlatformArch, t as readProcessMemory } from "../process-memory-Dw3CGS3D.mjs";
7
7
  import * as os from "node:os";
8
8
  import * as fs from "node:fs";
9
9
  import * as path$1 from "node:path";
@@ -22,7 +22,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
22
22
  }) : target, mod));
23
23
  //#endregion
24
24
  let node_crypto = require("node:crypto");
25
- //#region ../types/dist/event-category-CnLqLOKs.mjs
25
+ //#region ../types/dist/event-category-DAXzJeTX.mjs
26
26
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
27
27
  EventCategory["SystemBoot"] = "system.boot";
28
28
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -614,7 +614,6 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
614
614
  * issue. Payload `PipelineAnalyticsPlateGalleryChangedPayload`.
615
615
  */
616
616
  EventCategory["PipelineAnalyticsPlateGalleryChanged"] = "pipeline-analytics.plate-gallery-changed";
617
- EventCategory["FrigateLiveEvent"] = "frigate.live-event";
618
617
  EventCategory["CameraStreamsProfileSlotsChanged"] = "camera-streams.onProfileSlotsChanged";
619
618
  /**
620
619
  * Stream-broker health watchdog. Per-broker (deviceId/profile) emission.
@@ -14679,7 +14678,7 @@ var detectionPipelineCapability = {
14679
14678
  var SourceInfoSchema = object({
14680
14679
  /** Live dispatch key — mutable when the source system allows rename. */
14681
14680
  id: string(),
14682
- /** Source system tag — e.g. 'homeassistant' | 'reolink' | 'frigate'. */
14681
+ /** Source system tag — e.g. 'homeassistant' | 'reolink' | 'onvif'. */
14683
14682
  system: string(),
14684
14683
  /** Immutable upstream identifier when available (HA `unique_id`, … ).
14685
14684
  * Used to detect rename when `id` changes. */
@@ -15166,7 +15165,7 @@ method(_void(), _void(), { kind: "mutation" }), method(_void(), _void(), { kind:
15166
15165
  * - `device-management.router.ts` (deleted in Phase 2)
15167
15166
  * - `device-ops.router.ts` (compat layer — deleted; device-provider ops absorbed here)
15168
15167
  *
15169
- * All device provider addons (rtsp, onvif, frigate, …) are hub-local: they may
15168
+ * All device provider addons (rtsp, onvif, …) are hub-local: they may
15170
15169
  * fork into separate processes but never run on remote cluster agents. Therefore:
15171
15170
  * - No nodeId routing needed — this is a pure hub singleton.
15172
15171
  * - The hub's DeviceRegistry is the single source of truth for all live devices.
@@ -19573,7 +19572,7 @@ var NcRuleInputSchema = object({
19573
19572
  * The measured seven-person arrival on device 590 spans 110 s with every
19574
19573
  * internal gap under 30 s. A 12 s fixed window cuts it into three groups; an
19575
19574
  * idle cutoff holds it as one and ends it when the arrival actually ends.
19576
- * 30 is Frigate's shipped value for the same decision.
19575
+ * 30 s is a widely shipped value for the same decision.
19577
19576
  *
19578
19577
  * ### What it replaces
19579
19578
  *
@@ -21799,6 +21798,13 @@ var ZoneCrossingSchema = object({
21799
21798
  /** Zone display name at crossing time (falls back to the id). */
21800
21799
  zoneName: string().optional()
21801
21800
  });
21801
+ /** One zone a box was stamped with, and how much of the BOX fell inside it. */
21802
+ var ZoneOverlapSchema = object({
21803
+ zoneId: string(),
21804
+ zoneName: string().optional(),
21805
+ /** Percentage of the BOX area inside the zone, 0–100. */
21806
+ overlapPct: number()
21807
+ });
21802
21808
  var ObjectEventSchema = object({
21803
21809
  ...BaseEventFields,
21804
21810
  kind: literal("object"),
@@ -21823,6 +21829,35 @@ var ObjectEventSchema = object({
21823
21829
  bbox: BoundingBoxSchema.optional(),
21824
21830
  /** Heavy JSON — omitted in slim projection. */
21825
21831
  zones: array(string()).readonly().optional(),
21832
+ /**
21833
+ * How far inside each stamped zone the box actually was, as a percentage of
21834
+ * the BOX area.
21835
+ *
21836
+ * Membership alone cannot express "at least a third of it inside", which is
21837
+ * the bar an operator argues with — and the number already existed: the
21838
+ * engine computed it, the pipeline logged it, and then discarded it. It
21839
+ * matters most on the events that carry no track, where a rule has nothing
21840
+ * else to judge by.
21841
+ */
21842
+ zoneOverlaps: array(ZoneOverlapSchema).readonly().optional(),
21843
+ /**
21844
+ * Present when this event describes a detection the TRACKER refused, so it
21845
+ * has no track and never will.
21846
+ *
21847
+ * A zone-scoped immediate rule asks "is there an animal in the flowerbed
21848
+ * NOW?"; tracking answers a different question ("is this the same subject as
21849
+ * before?") whose confirmation threshold presumes continuity. On 2026-09-09 a
21850
+ * dog at 0.7729, 100% inside a watched zone, was refused three times in six
21851
+ * seconds with three different candidate ids — seven analysed frames in the
21852
+ * window, the subject in a handful of them, metres apart — and produced no
21853
+ * event at all.
21854
+ *
21855
+ * It is NAMED rather than merely implied by a missing `trackId`: an event
21856
+ * with no track and no reason is indistinguishable from a track whose media
21857
+ * went missing, and a consumer that asks this one for a best shot or a
21858
+ * history is asking for something that never existed.
21859
+ */
21860
+ spawnRefused: string().optional(),
21826
21861
  /** Omitted in slim projection. */
21827
21862
  state: TrackStateSchema.optional(),
21828
21863
  /**
@@ -22896,6 +22931,60 @@ var NativeCropResultSchema = object({
22896
22931
  */
22897
22932
  tier: _enum(["native", "ram-fullframe"]).optional()
22898
22933
  });
22934
+ /**
22935
+ * What a PARKED frame is for — the `kind` half of the `(deviceId, trackId,
22936
+ * kind)` key ([D422](../../../docs/decisions/adr-0422-a-relevant-frame-is-parked-when-it-becomes-relevant.md)).
22937
+ *
22938
+ * - `keyFrame` — the track's clean best FULL frame at native width (capped by
22939
+ * the caller's `maxWidth`). What `keyFrame` + `keyFrameSmall` are written
22940
+ * from, and what the detail plane's full-frame rung cuts from.
22941
+ * - `thumbnail` — the best-shot subject slab: the caller's 16:9 central-square
22942
+ * window, cut by the runner at uncapped native resolution.
22943
+ *
22944
+ * The runner never interprets `trackId`; it is an opaque key the hub owns.
22945
+ */
22946
+ var ParkedFrameKindSchema = _enum(["keyFrame", "thumbnail"]);
22947
+ /**
22948
+ * Why a park did NOT happen. Every one is logged on the runner with
22949
+ * `tags: { deviceId }` and the handle's measured age, because a handle already
22950
+ * gone at park time IS the defect the 150–500 ms window exists to prevent —
22951
+ * never a reason to retry in a loop.
22952
+ *
22953
+ * - `handle-gone` — the native surface no longer resolves this handle (never
22954
+ * registered, past the lease bound, or the worker released it). `detail`
22955
+ * carries the runner's own miss reason.
22956
+ * - `encode-failed` — pixels resolved and the JPEG encode threw.
22957
+ */
22958
+ var ParkRefusalSchema = _enum(["handle-gone", "encode-failed"]);
22959
+ /** Answer to `parkTrackFrame` — a discriminated union, so "not parked" always names why. */
22960
+ var ParkTrackFrameResultSchema = discriminatedUnion("parked", [object({
22961
+ parked: literal(true),
22962
+ /** The node holding the parcel — what a later retrieval must be pinned to. */
22963
+ nodeId: string(),
22964
+ width: number().int().positive(),
22965
+ height: number().int().positive(),
22966
+ /** JPEG bytes the parcel costs on the node. */
22967
+ bytes: number().int().nonnegative(),
22968
+ /** Whether this park replaced a parcel already held for the key. */
22969
+ replaced: boolean()
22970
+ }), object({
22971
+ parked: literal(false),
22972
+ nodeId: string(),
22973
+ reason: ParkRefusalSchema,
22974
+ /** Age of the handle at the park, on the runner's clock; null if unknown. */
22975
+ handleAgeMs: number().nullable(),
22976
+ detail: string().optional()
22977
+ })]);
22978
+ /** A retrieved parcel — the runner's own JPEG, base64 for the wire. */
22979
+ var ParkedTrackFrameSchema = object({
22980
+ jpeg: string(),
22981
+ width: number().int().positive(),
22982
+ height: number().int().positive(),
22983
+ /** The frame instant the parcel shows (the caller's clock, echoed back). */
22984
+ timestamp: number(),
22985
+ /** When the node stored it (the node's clock). */
22986
+ parkedAt: number()
22987
+ });
22899
22988
  /** Parent detection context passed to `runDetailSubtree` — the crop's
22900
22989
  * originating detection, in FRAME-space coordinates. Reuses
22901
22990
  * `NativeCropBboxSchema`'s `{x,y,w,h}` shape (same numeric fields; here
@@ -23285,7 +23374,7 @@ var RunnerCameraConfigSchema = object({
23285
23374
  * - `analyzer`: ML/frame-diff motion detection (motion-wasm or other
23286
23375
  * analyzer providers) running on decoded frames in this runner.
23287
23376
  * - `onboard`: camera-native motion pushes (Reolink Baichuan, ONVIF
23288
- * analytics, Frigate motion). The provider emits ProviderMotion
23377
+ * analytics). The provider emits ProviderMotion
23289
23378
  * events; the orchestrator forwards to `reportMotion`.
23290
23379
  */
23291
23380
  motionSources: MotionSourcesSchema.default(["analyzer"]),
@@ -23667,7 +23756,60 @@ var pipelineRunnerCapability = {
23667
23756
  className: string(),
23668
23757
  /** Camera the pixels came from. Diagnostics + log tags ONLY — never routing. */
23669
23758
  sourceDeviceId: number()
23670
- }), RunStatelessStepResultSchema, { kind: "mutation" })
23759
+ }), RunStatelessStepResultSchema, { kind: "mutation" }),
23760
+ /**
23761
+ * PARK a frame for a track at the instant it is judged to matter
23762
+ * ([D422](../../../docs/decisions/adr-0422-a-relevant-frame-is-parked-when-it-becomes-relevant.md)).
23763
+ *
23764
+ * The hub's `BestDetectionTracker` — the single "best per track" policy —
23765
+ * concludes a frame is a track's best and calls this on the node that
23766
+ * owns `handle` (`nodePin(handle.nodeId)`), while the handle is young. The
23767
+ * runner cuts `bbox` from the native surface it already holds (a full
23768
+ * frame for `keyFrame`, the caller's subject window for `thumbnail`),
23769
+ * encodes ONE JPEG, and keeps it under `(deviceId, trackId, kind)`. Every
23770
+ * later consumer retrieves by that key (`getParkedTrackFrame`) — a lookup
23771
+ * that cannot miss on age. D52 holds: the rectangle is cut by the runner,
23772
+ * never a pre-cut tile the caller decided. D9/D18 hold: one compressed
23773
+ * encode at a decision point, never a stream.
23774
+ *
23775
+ * Idempotent per `(trackId, kind)`: a later park replaces (the ranking is
23776
+ * the hub's; this adds no second opinion), an out-of-order older instant
23777
+ * is ignored. Bounded per device and per node on the runner
23778
+ * (`parked-frame-store.ts`), oldest-first eviction, never a refusal for
23779
+ * space. A refusal names its reason and is logged on the runner with the
23780
+ * handle's measured age — it is never retried into a loop.
23781
+ */
23782
+ parkTrackFrame: method(object({
23783
+ deviceId: number(),
23784
+ /** Opaque to the runner — the hub's track id. */
23785
+ trackId: string(),
23786
+ kind: ParkedFrameKindSchema,
23787
+ handle: FrameHandleSchema,
23788
+ /** Normalized [0,1] window to cut. `{0,0,1,1}` for a full frame. */
23789
+ bbox: NativeCropBboxSchema,
23790
+ /** Width cap for a full-frame park (the `keyFrame` native cap). */
23791
+ maxWidth: number().int().positive().optional(),
23792
+ /** The frame instant (caller's clock) — orders parks for one key. */
23793
+ timestamp: number()
23794
+ }), ParkTrackFrameResultSchema, { kind: "mutation" }),
23795
+ /**
23796
+ * Retrieve a parked parcel by `(deviceId, trackId, kind)`. Pinned to the
23797
+ * node that answered the park (`ParkTrackFrameResult.nodeId`). `null` means
23798
+ * nothing was parked under that key on this node — never "too old".
23799
+ */
23800
+ getParkedTrackFrame: method(object({
23801
+ deviceId: number(),
23802
+ trackId: string(),
23803
+ kind: ParkedFrameKindSchema
23804
+ }), ParkedTrackFrameSchema.nullable()),
23805
+ /**
23806
+ * Drop every parcel of a track — the hub closed it. Idempotent. A track
23807
+ * whose release is lost ages out on the runner under a hard ceiling.
23808
+ */
23809
+ releaseParkedTrackFrames: method(object({
23810
+ deviceId: number(),
23811
+ trackId: string()
23812
+ }), object({ released: number().int().nonnegative() }), { kind: "mutation" })
23671
23813
  }
23672
23814
  };
23673
23815
  var CameraPipelineConfigSchema = object({
@@ -26729,8 +26871,8 @@ onStatusChanged: { data: object({
26729
26871
  /**
26730
26872
  * Runtime-state slice — every provider that registers this cap
26731
26873
  * stores the same shape under `device.runtimeState[battery]`.
26732
- * Cross-provider uniformity: a Reolink Argus, a Frigate sensor
26733
- * proxy, an ONVIF battery cam all read/write the same keys.
26874
+ * Cross-provider uniformity: a Reolink Argus, a sensor proxy,
26875
+ * an ONVIF battery cam all read/write the same keys.
26734
26876
  * Consumers (BatteryBadge, snapshot wrapper sleep gate) read once
26735
26877
  * via `device.runtimeState.getCapState('battery')` regardless of
26736
26878
  * the underlying driver.
@@ -26787,7 +26929,7 @@ DeviceType.Button, method(object({ deviceId: number().int().nonnegative() }), _v
26787
26929
  *
26788
26930
  * Implementations:
26789
26931
  * - Each camera-providing addon registers this cap natively per
26790
- * device (Reolink, Hikvision, RTSP, Frigate, ONVIF self).
26932
+ * device (Reolink, Hikvision, RTSP, ONVIF self).
26791
26933
  * - Returns a snapshot from the persisted device config blob — no
26792
26934
  * extra round-trip to the camera, no probing.
26793
26935
  * - The cap is admin-only (`auth: 'admin'`) — credentials must not
@@ -28173,7 +28315,7 @@ var AvailableIntegrationTypeSchema = object({
28173
28315
  * Which integration-marker cap the addon declared, so the wizard can
28174
28316
  * branch on CAP — never on addon name. `device-adoption` integrations
28175
28317
  * (Home Assistant, …) route through the broker step (Approach A);
28176
- * `device-provider` integrations (Reolink/Frigate/ONVIF) keep the
28318
+ * `device-provider` integrations (Reolink/ONVIF) keep the
28177
28319
  * legacy config → discovery flow.
28178
28320
  */
28179
28321
  kind: _enum(["device-adoption", "device-provider"]),
@@ -30730,13 +30872,31 @@ var RecordingManifestSchema = object({
30730
30872
  */
30731
30873
  playbackEndpoints: array(string())
30732
30874
  });
30733
- /** Recording storage usage for one camera (bytes on disk across all its
30734
- * profiles/subtrees/locations on this node). */
30875
+ /**
30876
+ * Recording storage usage for one camera — what the ARCHIVE holds for it,
30877
+ * across every profile and every resolvable location on this node.
30878
+ *
30879
+ * ## Archive vs residency, which is the whole point of this shape (D418)
30880
+ *
30881
+ * `usedBytes` / `oldestMs` / `segments` are the durable hour ledger's numbers:
30882
+ * the same quantity `RecordingLocationUsage.usedBytes` reports for the volume
30883
+ * this camera writes to, so the two can be added up and compared.
30884
+ *
30885
+ * They were not always. Until D418 this row came from the recorder's in-RAM
30886
+ * `RecordingIndex`, which since D287 holds only the live tail plus the hours
30887
+ * somebody hydrated — so a hub with 1.9 TB and 3.3 days of footage reported
30888
+ * 60.5 GB and "oldest: three hours ago" on the same page as the volume row
30889
+ * that said otherwise, and two people read it as retention eating recent
30890
+ * footage. Residency is still reported, under `residentBytes` /
30891
+ * `residentOldestMs`, which answer a different question and say so.
30892
+ */
30735
30893
  var RecordingDeviceUsageSchema = object({
30736
30894
  deviceId: number(),
30895
+ /** Bytes the ARCHIVE holds for this camera on this node's resolvable
30896
+ * recordings locations. */
30737
30897
  usedBytes: number(),
30738
30898
  /**
30739
- * Start of this camera's OLDEST indexed segment, across every profile and
30899
+ * Start of this camera's OLDEST ARCHIVED segment, across every profile and
30740
30900
  * location — the "Oldest footage" column in Recordings → Storage, and the
30741
30901
  * only honest answer to "is retention actually holding?" per camera.
30742
30902
  *
@@ -30746,7 +30906,24 @@ var RecordingDeviceUsageSchema = object({
30746
30906
  * (types) and the addon ship on different trains, and the addon is usually
30747
30907
  * the later of the two.
30748
30908
  */
30749
- oldestMs: number().nullable().optional()
30909
+ oldestMs: number().nullable().optional(),
30910
+ /** Segments the archive holds for this camera — the "M" beside `usedBytes`.
30911
+ * OPTIONAL for the same train-skew reason as `oldestMs`. */
30912
+ segments: number().optional(),
30913
+ /**
30914
+ * RESIDENCY, not the archive: bytes the recorder process currently holds in
30915
+ * its RAM index — the live tail plus the hours a reader hydrated.
30916
+ *
30917
+ * It answers "what can be served without touching the disk", never "how much
30918
+ * footage this camera has". A UI that renders it must label it as such, and
30919
+ * must never total it as storage. OPTIONAL: a recorder predating D418 omits
30920
+ * it, and so does a node whose ledger could not answer.
30921
+ */
30922
+ residentBytes: number().optional(),
30923
+ /** The residency counterpart of `oldestMs` — the oldest segment currently in
30924
+ * RAM, which on a healthy recorder is minutes ago and means nothing about
30925
+ * retention. `null` = nothing resident. */
30926
+ residentOldestMs: number().nullable().optional()
30750
30927
  });
30751
30928
  /** Recording storage usage + capacity for one storage location. */
30752
30929
  var RecordingLocationUsageSchema = object({
@@ -30784,6 +30961,17 @@ var RecordingStorageUsageSchema = object({
30784
30961
  totalUsedBytes: number(),
30785
30962
  devices: array(RecordingDeviceUsageSchema),
30786
30963
  /**
30964
+ * WHERE `devices[]` came from, so an empty table is never mistaken for empty
30965
+ * disks (D418).
30966
+ *
30967
+ * `archive` = the durable hour ledger answered. `unavailable` = this node
30968
+ * declared no ledger and the recorder REFUSED rather than answering the
30969
+ * question with the resident index (D295 rule 3) — the rows are UNKNOWN, not
30970
+ * zero, and a UI must say so. OPTIONAL: a recorder predating D418 omits it,
30971
+ * and its rows are residency.
30972
+ */
30973
+ devicesRead: _enum(["archive", "unavailable"]).optional(),
30974
+ /**
30787
30975
  * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
30788
30976
  * of the payload without it: the hub serves this method through a BAKED
30789
30977
  * router, so a hub whose framework train predates a change to this array
@@ -37585,6 +37773,24 @@ Object.freeze({
37585
37773
  addonId: null,
37586
37774
  access: "view"
37587
37775
  },
37776
+ "pipelineRunner.getParkedTrackFrame": {
37777
+ capName: "pipeline-runner",
37778
+ capScope: "system",
37779
+ addonId: null,
37780
+ access: "view"
37781
+ },
37782
+ "pipelineRunner.parkTrackFrame": {
37783
+ capName: "pipeline-runner",
37784
+ capScope: "system",
37785
+ addonId: null,
37786
+ access: "create"
37787
+ },
37788
+ "pipelineRunner.releaseParkedTrackFrames": {
37789
+ capName: "pipeline-runner",
37790
+ capScope: "system",
37791
+ addonId: null,
37792
+ access: "create"
37793
+ },
37588
37794
  "pipelineRunner.reportMotion": {
37589
37795
  capName: "pipeline-runner",
37590
37796
  capScope: "system",
@@ -40862,6 +41068,21 @@ Object.freeze({
40862
41068
  form: "single",
40863
41069
  optional: false
40864
41070
  }],
41071
+ "pipelineRunner.getParkedTrackFrame": [{
41072
+ name: "deviceId",
41073
+ form: "single",
41074
+ optional: false
41075
+ }],
41076
+ "pipelineRunner.parkTrackFrame": [{
41077
+ name: "deviceId",
41078
+ form: "single",
41079
+ optional: false
41080
+ }],
41081
+ "pipelineRunner.releaseParkedTrackFrames": [{
41082
+ name: "deviceId",
41083
+ form: "single",
41084
+ optional: false
41085
+ }],
40865
41086
  "pipelineRunner.reportMotion": [{
40866
41087
  name: "deviceId",
40867
41088
  form: "single",
@@ -41603,7 +41824,7 @@ var PreviewTextField = string().max(200);
41603
41824
  * Whether the notification's preview is a STILL or a short animation.
41604
41825
  *
41605
41826
  * The operator's ask, verbatim: *"inviato come gif o video (come per le altre
41606
- * rule)"* — his Scrypted advanced-notifier has a `gifRule`, and a ten-hour
41827
+ * rule)"* — the other rules already offer an animated preview, and a ten-hour
41607
41828
  * night reads better as three seconds of motion than as one frame of it. Both
41608
41829
  * modes get the SAME treatment (blurred frame, large centred title); `'gif'`
41609
41830
  * simply applies it to a dozen frames sampled across the render and assembles