@camstack/types 1.2.173 → 1.2.176

package/dist/interfaces/addon.d.ts

@@ -230,7 +230,7 @@ export interface IKernelServices {
     readonly deviceRegistry?: import('../device/device-context.js').IDeviceRegistry;
     /**
      * Per-addon scoped device management — create, register, remove, list devices.
-     * Used by device provider addons (rtsp, onvif, frigate) to manage cameras.
+     * Used by device provider addons (rtsp, onvif) to manage cameras.
      */
     readonly devices: import('../device/device-context.js').DeviceManagerApi;
     /**

package/dist/interfaces/config-ui.d.ts

@@ -86,7 +86,7 @@ export type ConfigField = ConfigTextField | ConfigNumberField | ConfigBooleanFie
  *
  * A step's config schema is static, but whether a knob has any effect depends
  * on WHICH model the step runs: an NMS IoU threshold means nothing to a model
- * whose export fuses NMS into the graph (Frigate YOLO-NAS, TFLite SSD), a
+ * whose export fuses NMS into the graph (YOLO-NAS, TFLite SSD), a
  * per-macro confidence slider is moot for a macro the model's labelmap cannot
  * produce, and a class allow-list must offer the MODEL's labels, not the
  * catalog's. Computed server-side (`buildSchemaSlots` → the step's model

package/dist/interfaces/context.d.ts

@@ -5,7 +5,7 @@ import type { ISettingsBackend, IStorageProvider } from './storage.js';
  * CamstackContext -- injected into every provider, device, and addon.
  *
  * Each element receives a context scoped to its identity:
- * - logger is pre-scoped: (Frigate)[FrontDoor] for a device, (Frigate) for a provider
+ * - logger is pre-scoped: (Reolink)[FrontDoor] for a device, (Reolink) for a provider
  * - settingsBackend provides structured storage (DB) for config, events, etc.
  * - storageProvider resolves file paths per location type
  * - eventBus is shared (system-wide) but the source is pre-filled
@@ -15,7 +15,7 @@ import type { ISettingsBackend, IStorageProvider } from './storage.js';
  * It never changes even if the element is renamed.
  */
 export interface CamstackContext {
-    /** Immutable progressive ID of this element (e.g., 'provider:frigate-1', 'device:frigate-1/front-door') */
+    /** Immutable progressive ID of this element (e.g., 'provider:reolink-1', 'device:reolink-1/front-door') */
     readonly id: string;
     /** Pre-scoped logger -- logs automatically include this element's scope chain */
     readonly logger: IScopedLogger;

package/dist/interfaces/device-provider.d.ts

@@ -31,7 +31,7 @@ export interface IDeviceProvider {
     /**
      * Test/probe a single field value from the device config/settings form.
      * Called when the user clicks the test button on a 'probe' field.
-     * The provider implements the actual probing logic (e.g. ffprobe for RTSP URLs, API check for Frigate).
+     * The provider implements the actual probing logic (e.g. ffprobe for RTSP URLs, an API check for a hub).
      */
     testField?(key: string, value: unknown): Promise<FieldProbeResult>;
     subscribeLiveEvents(callback: (event: LiveEvent) => void): () => void;

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

@@ -798,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.173",
+  "version": "1.2.176",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",