@camstack/types 1.2.44 → 1.2.45

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

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { SubscribeAudioChunksResult, SubscribeFramesInput, SubscribeFramesResult } from '../capabilities/schemas/streaming-shared.js';
+import type { BrokerStatsSchema, BrokerStatusSchema, SubscribeAudioChunksResult, SubscribeFramesInput, SubscribeFramesResult } from '../capabilities/schemas/streaming-shared.js';
 import type { BrokerConsumerAttribution } from '../capabilities/stream-broker.cap.js';
 import type { FrameFormat } from '../types/io.js';
 import type { FrameHandle } from './frame-handle.js';
@@ -161,72 +161,24 @@ export interface AudioSubscribeOptions {
      */
     readonly tag?: string;
 }
-export type BrokerStatus = 'idle' | 'connecting' | 'streaming' | 'error' | 'stopped';
-export interface BrokerStats {
-    readonly status: BrokerStatus;
-    readonly inputFps: number;
-    readonly decodeFps: number;
-    readonly encodedSubscribers: number;
-    readonly decodedSubscribers: number;
-    readonly uptimeMs: number;
-    /** Measured bitrate in kbps (averaged over 2s window) */
-    readonly bitrateKbps: number;
-    /** Time between last two keyframes in ms (IDR interval) */
-    readonly idrIntervalMs: number;
-    /** Detected video codec (h264, h265) */
-    readonly codec?: string;
-    /** Total bytes received since broker start */
-    readonly totalBytes: number;
-    /** Total encoded packets received since broker start */
-    readonly packetCount: number;
-    /** Number of connected RTSP restream clients */
-    readonly rtspClients: number;
-    /** Number of connected TCP pipe clients */
-    readonly pipeClients: number;
-    /** Pre-buffer configured duration in seconds */
-    readonly preBufferSec: number;
-    /** Pre-buffer actual buffered duration in ms */
-    readonly preBufferMs: number;
-    /** Pre-buffer packet count */
-    readonly preBufferPackets: number;
-    /**
-     * Moleculer node id of the decoder provider currently servicing this
-     * stream's decoded subscribers. `null` until the deferred decoder is
-     * created (no decoded clients yet, or codec not detected).
-     */
-    readonly decoderNodeId: string | null;
-    /**
-     * Detected audio track parameters from the RTSP DESCRIBE / SDP. Null
-     * when the stream has no audio track or the broker is still in cold
-     * start. `supported` reflects whether the local native + ffmpeg-based
-     * decoder pipeline can produce PCM chunks for downstream consumers
-     * (audio-analyzer). When `false`, the codec is detected but skipped.
-     */
-    readonly audio?: {
-        readonly codec: string;
-        readonly sampleRate: number;
-        readonly channels: number;
-        readonly supported: boolean;
-    } | null;
-    /**
-     * BROKER-SIDE AUDIO MUTE ([D83](../../../../docs/decisions/adr-0083.md)).
-     * `true` = this broker is deliberately distributing none of the device's
-     * audio, live or recorded. It is what tells a silent camera apart from a
-     * broken one on the stream panel: a broker holding an `audio` descriptor
-     * with `audioMuted: true` is doing exactly what it was asked.
-     *
-     * `audioMutedDropped` counts the audio units the mute threw away since the
-     * current dial — the proof the mute is on the packet path and not merely
-     * persisted.
-     *
-     * NOTE: this interface is the hand-written twin of `BrokerStatsSchema` in
-     * `capabilities/schemas/streaming-shared.ts`. They are not generated from
-     * each other; a field added to one and not the other compiles and then
-     * silently disappears on the wire.
-     */
-    readonly audioMuted?: boolean;
-    readonly audioMutedDropped?: number;
-}
+/**
+ * Broker lifecycle state. Inferred from `BrokerStatusSchema` — the enum the
+ * wire actually validates against.
+ */
+export type BrokerStatus = z.infer<typeof BrokerStatusSchema>;
+/**
+ * Live broker telemetry: the payload of `streamBroker.getBrokerStats` and of
+ * the stats push the admin-UI panel subscribes to.
+ *
+ * Inferred from `BrokerStatsSchema` in
+ * `capabilities/schemas/streaming-shared.ts`, which is the schema the cap
+ * method validates its output against — so the schema IS the type. This was a
+ * hand-written twin until 2026-08-08: two shapes, neither generated from the
+ * other, and a field added to one and not the other compiled fine and then
+ * silently disappeared on the wire. Every field is documented on the schema;
+ * do not restate it here, and never re-introduce a second declaration.
+ */
+export type BrokerStats = z.infer<typeof BrokerStatsSchema>;
 export interface IStreamBroker {
     readonly deviceId: string;
     readonly status: BrokerStatus;

package/dist/{sleep-eiC10_cX.js → sleep-BOI-sVEA.js}

@@ -3207,6 +3207,17 @@ function createDeviceProxy(api, binding, opts) {
 			listOpsLog: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listOpsLog", "query", input),
 			getTrainingExportSummary: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrainingExportSummary", "query", input),
 			getTrainingExportUrl: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrainingExportUrl", "query", input),
+			listRetrainStaging: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listRetrainStaging", "query", input),
+			listRetrainFrames: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listRetrainFrames", "query", input),
+			selectRetrainFrames: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "selectRetrainFrames", "mutation", input),
+			deselectRetrainFrame: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "deselectRetrainFrame", "mutation", input),
+			getRetrainFrameImage: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getRetrainFrameImage", "query", input),
+			proposeRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "proposeRetrainAnnotations", "mutation", input),
+			listRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listRetrainAnnotations", "query", input),
+			saveRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "saveRetrainAnnotations", "mutation", input),
+			completeRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "completeRetrainTrack", "mutation", input),
+			restageRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "restageRetrainTrack", "mutation", input),
+			getRetrainExportUrl: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getRetrainExportUrl", "query", input),
 			getEventMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMedia", "query", input),
 			getTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrackMedia", "query", input),
 			listTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listTrackMedia", "query", input),

package/dist/{sleep-cC4Fuup8.mjs → sleep-Bf5fBs7u.mjs}

@@ -3207,6 +3207,17 @@ function createDeviceProxy(api, binding, opts) {
 			listOpsLog: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listOpsLog", "query", input),
 			getTrainingExportSummary: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrainingExportSummary", "query", input),
 			getTrainingExportUrl: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrainingExportUrl", "query", input),
+			listRetrainStaging: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listRetrainStaging", "query", input),
+			listRetrainFrames: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listRetrainFrames", "query", input),
+			selectRetrainFrames: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "selectRetrainFrames", "mutation", input),
+			deselectRetrainFrame: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "deselectRetrainFrame", "mutation", input),
+			getRetrainFrameImage: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getRetrainFrameImage", "query", input),
+			proposeRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "proposeRetrainAnnotations", "mutation", input),
+			listRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listRetrainAnnotations", "query", input),
+			saveRetrainAnnotations: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "saveRetrainAnnotations", "mutation", input),
+			completeRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "completeRetrainTrack", "mutation", input),
+			restageRetrainTrack: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "restageRetrainTrack", "mutation", input),
+			getRetrainExportUrl: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getRetrainExportUrl", "query", input),
 			getEventMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMedia", "query", input),
 			getTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getTrackMedia", "query", input),
 			listTrackMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "listTrackMedia", "query", input),

package/dist/types/detection.d.ts

@@ -70,6 +70,24 @@ export interface ScoredLabel {
      * that carries it.
      */
     readonly detectionId?: string;
+    /**
+     * WHICH label slot this text may occupy on a track / ObjectEvent, copied
+     * VERBATIM from the producing step's `StepDefinition.labelTier` (roadmap
+     * 4g). 1 = sub-class (`dog`), 2 = instance (`Turdus migratorius`, `Alice`,
+     * a plate read).
+     *
+     * Absent means the producing step declares no tier — an internal marker
+     * (`embedding:512d`), or a step that was never given a declaration. The
+     * persistence write rule REFUSES an undeclared label rather than inferring
+     * a tier from the text or the step name, and says so in the log. Inheriting
+     * a label onto a parent copies the tier unchanged: the tier belongs to the
+     * step that decided the text, not to the entry that carries it.
+     */
+    readonly tier?: 1 | 2;
+    /** Step that decided this text — the tier's attribution. */
+    readonly stepId?: string;
+    /** Model that decided this text — the tier's attribution. */
+    readonly modelId?: string;
 }
 /** What kind of entry a detection is at the root of `detections[]`. */
 export type DetectionKind = 'first-level' | 'detail' | 'audio';
@@ -110,6 +128,19 @@ export interface DetectionDebug {
      * mapped to `macroClass: 'animal'`).
      */
     readonly originalClass?: string;
+    /**
+     * The label tier {@link originalClass} may occupy, from the ROOT detector
+     * step's `StepDefinition.labelTier` (roadmap 4g). Ships in the same
+     * `verbosity: 'full'` bag as the value it qualifies, so it costs nothing
+     * where `originalClass` costs nothing.
+     *
+     * Without it the raw class is a label with no declared tier and the write
+     * rule refuses it — which is the correct outcome, because outside
+     * `verbosity: 'full'` the FrameProcessor substitutes `det.macroClass` for a
+     * missing `originalClass` and a tier guessed here would put a MACRO class in
+     * a label slot. That is the exact regression the 2026-08-07 rule refuses.
+     */
+    readonly originalClassTier?: 1 | 2;
     /**
      * Full top-N ranked alternatives per source (classifier / recognizer).
      * The winner of each list already appears in `detection.labels[]` —

package/dist/types/pipeline-step.d.ts

@@ -42,6 +42,27 @@ export interface StepDefinition {
     readonly inputClasses: readonly string[] | null;
     /** Classes this step outputs (e.g., ['person','vehicle','animal'] for YOLO) */
     readonly outputClasses: readonly string[];
+    /**
+     * WHICH label tier this step's answer occupies on a track / ObjectEvent
+     * (roadmap 4g). **Declared here and nowhere else** — a consumer never infers
+     * a tier from `outputClasses`, from the step id, or from the shape of the
+     * text. A step that produces a label and declares no tier has its answer
+     * REFUSED and logged, because a guess here is exactly how a species ends up
+     * in the coarse slot and blocks the sub-class that should have gone there.
+     *
+     *  - `1` — a SUB-CLASS, finer than the macro class but still a taxonomy
+     *    token: `animal-classifier` (`animal-type`), `vehicle-classifier`
+     *    (`vehicle-type`), and `object-detection` itself (its raw class, when
+     *    finer than the macro it maps to — `dog` under `animal`).
+     *  - `2` — an INSTANCE, the finest thing sayable about this subject:
+     *    `bird-classifier` (`species`), `face-embedding` (`identity`),
+     *    `plate-ocr` (`plate-text`).
+     *
+     * Absent on a step that produces no label at all (a detector whose classes
+     * ARE macro classes, an embedder, a segmenter). Absence is not tier 0 — it
+     * means "this step never fills a label slot".
+     */
+    readonly labelTier?: 1 | 2;
     /** Available models for this step */
     readonly models: readonly ModelCatalogEntry[];
     /** Default model when no user preference is set */

package/package.json

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