@camstack/types 1.2.172 → 1.2.175

package/dist/interfaces/event-bus.d.ts

@@ -345,6 +345,21 @@ export interface PipelineInferenceResultPayload {
      * → delivery latency. Undefined when the frame carried no capture stamp.
      */
     readonly capturedAt?: number;
+    /**
+     * Wall-clock (ms) read on the RUNNER's node at the instant this payload was
+     * handed to the bus. A consumer's `now - emittedAt` is the delivery lag —
+     * the one number that tells a late DELIVERY apart from a slow CONSUMER when
+     * both produce the same signature (a silence, then a burst-drain). See
+     * `addon-post-analysis/src/pipeline-analytics/frame-lag-observer.ts` for how
+     * it is read and why the absolute value is not a latency.
+     *
+     * Optional, and undefined is UNKNOWN, never 0 (D8): the bus is telemetry,
+     * and during a rolling deploy a runner older than this field emits payloads
+     * without it as the normal case. A consumer that folds an absent stamp in as
+     * 0 reports "delivered instantly" and fabricates exactly the verdict the
+     * field exists to establish.
+     */
+    readonly emittedAt?: number;
     /** Child steps enabled for this camera + their scheduling policy (from the catalog). */
     readonly detailSteps?: readonly DetailStepAnnounce[];
     readonly [key: string]: unknown;
@@ -783,7 +798,7 @@ export interface EventCatalog {
     };
     /**
      * Device online/offline aggregate. Emitted by the device's owning
-     * provider (rtsp / reolink / onvif / frigate) when the union of its
+     * provider (rtsp / reolink / onvif) when the union of its
      * stream-broker profile health flips. `online` fires when at least
      * one profile becomes healthy after all were offline; `offline` fires
      * when the last healthy profile goes stale (no packets for

package/dist/interfaces/pipeline-runner-capability.d.ts

@@ -252,4 +252,32 @@ export interface IPipelineRunnerProvider {
      * why the model pin is refused rather than substituted.
      */
     runStatelessStep(input: import('../capabilities/pipeline-runner.cap.js').RunStatelessStepInput): Promise<import('../capabilities/pipeline-runner.cap.js').RunStatelessStepResult>;
+    /**
+     * PARK a frame for a track at the instant the hub judged it relevant
+     * (D422). See `pipelineRunnerCapability.parkTrackFrame`
+     * (`capabilities/pipeline-runner.cap.ts`) for the contract; a refusal is
+     * an answer, never a retry.
+     */
+    parkTrackFrame(input: {
+        readonly deviceId: number;
+        readonly trackId: string;
+        readonly kind: import('../capabilities/pipeline-runner.cap.js').ParkedFrameKind;
+        readonly handle: import('./frame-handle.js').FrameHandle;
+        readonly bbox: import('../capabilities/pipeline-runner.cap.js').NativeCropBbox;
+        readonly maxWidth?: number;
+        readonly timestamp: number;
+    }): Promise<import('../capabilities/pipeline-runner.cap.js').ParkTrackFrameResult>;
+    /** A parked parcel by `(deviceId, trackId, kind)`; `null` = nothing parked here. */
+    getParkedTrackFrame(input: {
+        readonly deviceId: number;
+        readonly trackId: string;
+        readonly kind: import('../capabilities/pipeline-runner.cap.js').ParkedFrameKind;
+    }): Promise<import('../capabilities/pipeline-runner.cap.js').ParkedTrackFrame | null>;
+    /** Drop every parcel of a closed track. Idempotent. */
+    releaseParkedTrackFrames(input: {
+        readonly deviceId: number;
+        readonly trackId: string;
+    }): Promise<{
+        released: number;
+    }>;
 }

package/dist/interfaces/stream-broker.d.ts

@@ -47,8 +47,8 @@ export type Unsubscribe = () => void;
  *                   path falls back to AnnexB → writeVideoNals.
  *                   Reserved — implementation pending.
  * - `'push'`     — push mode. Provider addon delivers AnnexB packets
- *                   via `pushEncodedPacket()` (Reolink Baichuan,
- *                   Frigate event streams, etc.).
+ *                   via `pushEncodedPacket()` (Reolink Baichuan and
+ *                   other event-stream sources).
  * - `'push-rtp'` — push mode with raw RTP packets. Provider addon
  *                   delivers source RTP via `pushVideoRtp()` AND
  *                   AnnexB-equivalents via `pushEncodedPacket()` so
@@ -204,7 +204,7 @@ export interface IStreamBroker {
      * Push an encoded packet into the broker from an external source.
      *
      * Used by camera provider addons that deliver media data directly
-     * (e.g. Reolink Baichuan protocol, Frigate event streams) instead
+     * (e.g. the Reolink Baichuan protocol) instead
      * of exposing an RTSP URL for the broker to pull from.
      *
      * The broker fans out the packet to all consumers: pre-buffer, RTSP
@@ -212,8 +212,8 @@ export interface IStreamBroker {
      */
     pushEncodedPacket(packet: EncodedPacket): void;
     /**
-     * Push-source audio metadata. Push providers (Reolink Baichuan,
-     * Frigate, etc.) call this BEFORE the first audio EncodedPacket so
+     * Push-source audio metadata. Push providers (Reolink Baichuan and
+     * the like) call this BEFORE the first audio EncodedPacket so
      * the broker can wire the audio-codec capability — RTSP sources get
      * the same data from the SDP audio track. Repeat calls update the
      * declared codec; calling with `null` retracts (broker tears down
@@ -250,8 +250,8 @@ export interface IStreamBroker {
      * a packet-level repacketizer that preserves the original RTP header
      * layout — Chrome's HEVC depacketizer is sensitive to it.
      *
-     * Sources that don't have an underlying RTP wire (e.g. Frigate event
-     * streams that call `pushEncodedPacket`) MAY register zero callbacks
+     * Sources that don't have an underlying RTP wire (e.g. event streams
+     * that call `pushEncodedPacket`) MAY register zero callbacks
      * and emit nothing. `attribution` works the same as `onEncodedData`.
      */
     onVideoRtp(callback: (rtpData: Buffer) => void, attribution?: BrokerConsumerAttribution): Unsubscribe;

package/dist/notification/timelapse-rule.d.ts

@@ -39,7 +39,7 @@ export declare const TIMELAPSE_DENSE_FLOOR_SEC = 0.1;
  * Whether the notification's preview is a STILL or a short animation.
  *
  * The operator's ask, verbatim: *"inviato come gif o video (come per le altre
- * rule)"* — his Scrypted advanced-notifier has a `gifRule`, and a ten-hour
+ * rule)"* — the other rules already offer an animated preview, and a ten-hour
  * night reads better as three seconds of motion than as one frame of it. Both
  * modes get the SAME treatment (blurred frame, large centred title); `'gif'`
  * simply applies it to a dozen frames sampled across the render and assembles

package/dist/{sleep-Bo9cUOXp.js → sleep-CTHjJilA.js}

@@ -1,4 +1,4 @@
-const require_event_category = require("./event-category-BVo6ta6_.js");
+const require_event_category = require("./event-category-BNJ9EE5B.js");
 let zod = require("zod");
 //#region src/interfaces/config-ui.ts
 /** Predefined tabs with standard label, icon, and sort order.
@@ -3808,7 +3808,10 @@ function createDeviceProxy(api, binding, opts) {
 		pipelineRunner: {
 			detachCamera: (input) => dispatchSystem("pipelineRunner", "detachCamera", "mutation", input),
 			getCameraMetrics: (input) => dispatchSystem("pipelineRunner", "getCameraMetrics", "query", input),
-			runDetailSubtree: (input) => dispatchSystem("pipelineRunner", "runDetailSubtree", "mutation", input)
+			runDetailSubtree: (input) => dispatchSystem("pipelineRunner", "runDetailSubtree", "mutation", input),
+			parkTrackFrame: (input) => dispatchSystem("pipelineRunner", "parkTrackFrame", "mutation", input),
+			getParkedTrackFrame: (input) => dispatchSystem("pipelineRunner", "getParkedTrackFrame", "query", input),
+			releaseParkedTrackFrames: (input) => dispatchSystem("pipelineRunner", "releaseParkedTrackFrames", "mutation", input)
 		},
 		plateGallery: {
 			listPlates: (input) => dispatchSystem("plateGallery", "listPlates", "query", input),

package/dist/{sleep-DMghvp8F.mjs → sleep-ox21Ig4I.mjs}

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-CnLqLOKs.mjs";
+import { t as EventCategory } from "./event-category-DAXzJeTX.mjs";
 import { z } from "zod";
 //#region src/interfaces/config-ui.ts
 /** Predefined tabs with standard label, icon, and sort order.
@@ -3808,7 +3808,10 @@ function createDeviceProxy(api, binding, opts) {
 		pipelineRunner: {
 			detachCamera: (input) => dispatchSystem("pipelineRunner", "detachCamera", "mutation", input),
 			getCameraMetrics: (input) => dispatchSystem("pipelineRunner", "getCameraMetrics", "query", input),
-			runDetailSubtree: (input) => dispatchSystem("pipelineRunner", "runDetailSubtree", "mutation", input)
+			runDetailSubtree: (input) => dispatchSystem("pipelineRunner", "runDetailSubtree", "mutation", input),
+			parkTrackFrame: (input) => dispatchSystem("pipelineRunner", "parkTrackFrame", "mutation", input),
+			getParkedTrackFrame: (input) => dispatchSystem("pipelineRunner", "getParkedTrackFrame", "query", input),
+			releaseParkedTrackFrames: (input) => dispatchSystem("pipelineRunner", "releaseParkedTrackFrames", "mutation", input)
 		},
 		plateGallery: {
 			listPlates: (input) => dispatchSystem("plateGallery", "listPlates", "query", input),

package/dist/types/detection.d.ts

@@ -288,11 +288,9 @@ export interface NativeRecoveryEvidence {
  * that has moved is not in a later frame, and its absence there is not evidence
  * it was never here.
  *
- * This is the same discipline Scrypted enforces structurally: its decoded frame
- * is invalidated the moment the `for await` body returns
- * (`plugins/python-codecs/src/libav.py:105-112`), so every second look — face
- * crop, embedding, retained detection image — is taken IN BAND
- * (`plugins/objectdetector/src/main.ts:512-520`).
+ * The discipline is structural: a decoded frame is invalidated the moment the
+ * `for await` body returns, so every second look — face crop, embedding,
+ * retained detection image — is taken IN BAND.
  *
  * ## What it is NOT
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.172",
+  "version": "1.2.175",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",