@camstack/types 1.2.18 → 1.2.20

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DETsT9rJ.js");
+const require_sleep = require("./sleep-mkNQLVPE.js");
 const require_event_category = require("./event-category-39bpf1r_.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/collection-array-methods.ts

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { A as parseJsonUnknown, Ct as DisposerChain, D as asString, F as ReadinessRegistry, I as ReadinessTimeoutError, M as nodePin, N as readNodePin, P as DATAPLANE_SECRET_HEADER, S as DeviceType, T as asJsonObject, a as viewerUiCapability, dt as BaseAddon, ft as normalizeAddonInitResult, ht as emitReadiness, i as deviceOpsCapability, m as expandCapMethods, o as adminUiCapability, s as createDeviceProxy, t as sleep, z as scopeKey } from "./sleep-B_Uaqbai.mjs";
+import { A as parseJsonUnknown, Ct as DisposerChain, D as asString, F as ReadinessRegistry, I as ReadinessTimeoutError, M as nodePin, N as readNodePin, P as DATAPLANE_SECRET_HEADER, S as DeviceType, T as asJsonObject, a as viewerUiCapability, dt as BaseAddon, ft as normalizeAddonInitResult, ht as emitReadiness, i as deviceOpsCapability, m as expandCapMethods, o as adminUiCapability, s as createDeviceProxy, t as sleep, z as scopeKey } from "./sleep-BYyv9gUM.mjs";
 import { t as EventCategory } from "./event-category-Bz24uP1U.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/collection-array-methods.ts

package/dist/capabilities/addons.cap.d.ts

@@ -634,8 +634,8 @@ export declare const addonsCapability: {
                 finishedAtMs: z.ZodNullable<z.ZodNumber>;
             }, z.core.$strip>>;
             state: z.ZodEnum<{
-                running: "running";
                 failed: "failed";
+                running: "running";
                 completed: "completed";
                 "partially-failed": "partially-failed";
                 cancelled: "cancelled";
@@ -710,8 +710,8 @@ export declare const addonsCapability: {
                 finishedAtMs: z.ZodNullable<z.ZodNumber>;
             }, z.core.$strip>>;
             state: z.ZodEnum<{
-                running: "running";
                 failed: "failed";
+                running: "running";
                 completed: "completed";
                 "partially-failed": "partially-failed";
                 cancelled: "cancelled";

package/dist/capabilities/llm-runtime.cap.d.ts

@@ -50,9 +50,9 @@ export type ManagedRuntimeConfig = z.infer<typeof ManagedRuntimeConfigSchema>;
 export declare const LlmRuntimeStatusSchema: z.ZodObject<{
     nodeId: z.ZodString;
     state: z.ZodEnum<{
-        ready: "ready";
         failed: "failed";
         stopped: "stopped";
+        ready: "ready";
         starting: "starting";
         downloading: "downloading";
         crashed: "crashed";
@@ -216,9 +216,9 @@ export declare const llmRuntimeCapability: {
         }, z.core.$strip>, z.ZodObject<{
             nodeId: z.ZodString;
             state: z.ZodEnum<{
-                ready: "ready";
                 failed: "failed";
                 stopped: "stopped";
+                ready: "ready";
                 starting: "starting";
                 downloading: "downloading";
                 crashed: "crashed";
@@ -237,9 +237,9 @@ export declare const llmRuntimeCapability: {
         readonly status: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
             nodeId: z.ZodString;
             state: z.ZodEnum<{
-                ready: "ready";
                 failed: "failed";
                 stopped: "stopped";
+                ready: "ready";
                 starting: "starting";
                 downloading: "downloading";
                 crashed: "crashed";

package/dist/capabilities/llm.cap.d.ts

@@ -139,9 +139,9 @@ export declare const LlmRuntimeNodeSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodObject<{
         nodeId: z.ZodString;
         state: z.ZodEnum<{
-            ready: "ready";
             failed: "failed";
             stopped: "stopped";
+            ready: "ready";
             starting: "starting";
             downloading: "downloading";
             crashed: "crashed";
@@ -491,9 +491,9 @@ export declare const llmCapability: {
             status: z.ZodOptional<z.ZodObject<{
                 nodeId: z.ZodString;
                 state: z.ZodEnum<{
-                    ready: "ready";
                     failed: "failed";
                     stopped: "stopped";
+                    ready: "ready";
                     starting: "starting";
                     downloading: "downloading";
                     crashed: "crashed";
@@ -547,9 +547,9 @@ export declare const llmCapability: {
         }, z.core.$strip>, z.ZodObject<{
             nodeId: z.ZodString;
             state: z.ZodEnum<{
-                ready: "ready";
                 failed: "failed";
                 stopped: "stopped";
+                ready: "ready";
                 starting: "starting";
                 downloading: "downloading";
                 crashed: "crashed";
@@ -570,9 +570,9 @@ export declare const llmCapability: {
         }, z.core.$strip>, z.ZodObject<{
             nodeId: z.ZodString;
             state: z.ZodEnum<{
-                ready: "ready";
                 failed: "failed";
                 stopped: "stopped";
+                ready: "ready";
                 starting: "starting";
                 downloading: "downloading";
                 crashed: "crashed";

package/dist/capabilities/motion.cap.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { type InferProvider } from './capability-definition.js';
 import { DeviceType } from '../device/device-type.js';
+import { type InferProvider } from './capability-definition.js';
 /**
  * Hardware / firmware motion sensor cap — binary detected state plus
  * a timestamp of the last observation. Distinct from
@@ -49,6 +49,18 @@ export declare const motionCapability: {
     readonly name: "motion";
     readonly scope: "device";
     readonly mode: "singleton";
+    /**
+     * Providers register per-device natives via `ctx.registerNativeCap`
+     * (Hikvision/Reolink/Amcrest/Wyze/HA/Homematic/Alexa/Matter) — there is
+     * NO system singleton provider. Without this flag `resolveCapMount`
+     * derived `{ kind: 'singleton' }`, so `motion.getStatus`/`isDetected`
+     * resolved via `registry.getSingleton('motion')` (always null) and every
+     * call 412'd "provider not available" while bindings listed a live
+     * `motion` native (2026-08-02). The flag routes the router through
+     * `requireDeviceScoped` → `getProviderForDevice`, like `motion-trigger`,
+     * `snapshot` and every other per-device native cap.
+     */
+    readonly deviceNative: true;
     readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Sensor];
     readonly methods: {
         /**

package/dist/capabilities/pipeline-analytics.cap.d.ts

@@ -1296,9 +1296,9 @@ export declare const pipelineAnalyticsCapability: {
         readonly getMediaRelocateStatus: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             jobId: z.ZodString;
             state: z.ZodEnum<{
-                running: "running";
                 done: "done";
                 failed: "failed";
+                running: "running";
                 cancelled: "cancelled";
             }>;
             fromLocationId: z.ZodString;

package/dist/capabilities/pipeline-executor.cap.d.ts

@@ -381,9 +381,9 @@ declare const EngineProvisioningSchema: z.ZodObject<{
     }>>;
     device: z.ZodNullable<z.ZodString>;
     state: z.ZodEnum<{
-        ready: "ready";
         failed: "failed";
         idle: "idle";
+        ready: "ready";
         installing: "installing";
         verifying: "verifying";
     }>;
@@ -530,9 +530,9 @@ export declare const pipelineExecutorCapability: {
             }>>;
             device: z.ZodNullable<z.ZodString>;
             state: z.ZodEnum<{
-                ready: "ready";
                 failed: "failed";
                 idle: "idle";
+                ready: "ready";
                 installing: "installing";
                 verifying: "verifying";
             }>;

package/dist/capabilities/pipeline-orchestrator.cap.d.ts

@@ -265,18 +265,18 @@ declare const CameraMotionStatusSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** Detection engine provisioning state (mirrors pipeline-executor provisioning states). */
 declare const CameraDetectionProvisioningStateSchema: z.ZodEnum<{
-    ready: "ready";
     failed: "failed";
     idle: "idle";
+    ready: "ready";
     installing: "installing";
     verifying: "verifying";
 }>;
 /** Detection provisioning sub-block. */
 declare const CameraDetectionProvisioningSchema: z.ZodObject<{
     state: z.ZodEnum<{
-        ready: "ready";
         failed: "failed";
         idle: "idle";
+        ready: "ready";
         installing: "installing";
         verifying: "verifying";
     }>;
@@ -306,9 +306,9 @@ declare const CameraDetectionStatusSchema: z.ZodObject<{
     avgInferenceMs: z.ZodNumber;
     provisioning: z.ZodObject<{
         state: z.ZodEnum<{
-            ready: "ready";
             failed: "failed";
             idle: "idle";
+            ready: "ready";
             installing: "installing";
             verifying: "verifying";
         }>;
@@ -419,9 +419,9 @@ declare const CameraStatusSchema: z.ZodObject<{
         avgInferenceMs: z.ZodNumber;
         provisioning: z.ZodObject<{
             state: z.ZodEnum<{
-                ready: "ready";
                 failed: "failed";
                 idle: "idle";
+                ready: "ready";
                 installing: "installing";
                 verifying: "verifying";
             }>;
@@ -1149,9 +1149,9 @@ export declare const pipelineOrchestratorCapability: {
                 avgInferenceMs: z.ZodNumber;
                 provisioning: z.ZodObject<{
                     state: z.ZodEnum<{
-                        ready: "ready";
                         failed: "failed";
                         idle: "idle";
+                        ready: "ready";
                         installing: "installing";
                         verifying: "verifying";
                     }>;
@@ -1259,9 +1259,9 @@ export declare const pipelineOrchestratorCapability: {
                 avgInferenceMs: z.ZodNumber;
                 provisioning: z.ZodObject<{
                     state: z.ZodEnum<{
-                        ready: "ready";
                         failed: "failed";
                         idle: "idle";
+                        ready: "ready";
                         installing: "installing";
                         verifying: "verifying";
                     }>;

package/dist/capabilities/recording-export.cap.d.ts

@@ -40,9 +40,9 @@ export declare const ExportOptionsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ExportOptions = z.infer<typeof ExportOptionsSchema>;
 export declare const ExportStateSchema: z.ZodEnum<{
-    ready: "ready";
     queued: "queued";
     failed: "failed";
+    ready: "ready";
     deleted: "deleted";
     rendering: "rendering";
     expired: "expired";
@@ -67,9 +67,9 @@ export declare const ExportRecordSchema: z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     state: z.ZodEnum<{
-        ready: "ready";
         queued: "queued";
         failed: "failed";
+        ready: "ready";
         deleted: "deleted";
         rendering: "rendering";
         expired: "expired";
@@ -131,9 +131,9 @@ export declare const recordingExportCapability: {
                 title: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
             state: z.ZodEnum<{
-                ready: "ready";
                 queued: "queued";
                 failed: "failed";
+                ready: "ready";
                 deleted: "deleted";
                 rendering: "rendering";
                 expired: "expired";
@@ -168,9 +168,9 @@ export declare const recordingExportCapability: {
                 title: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
             state: z.ZodEnum<{
-                ready: "ready";
                 queued: "queued";
                 failed: "failed";
+                ready: "ready";
                 deleted: "deleted";
                 rendering: "rendering";
                 expired: "expired";
@@ -204,9 +204,9 @@ export declare const recordingExportCapability: {
                 title: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
             state: z.ZodEnum<{
-                ready: "ready";
                 queued: "queued";
                 failed: "failed";
+                ready: "ready";
                 deleted: "deleted";
                 rendering: "rendering";
                 expired: "expired";
@@ -241,9 +241,9 @@ export declare const recordingExportCapability: {
                 title: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
             state: z.ZodEnum<{
-                ready: "ready";
                 queued: "queued";
                 failed: "failed";
+                ready: "ready";
                 deleted: "deleted";
                 rendering: "rendering";
                 expired: "expired";
@@ -278,9 +278,9 @@ export declare const recordingExportCapability: {
                 title: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>;
             state: z.ZodEnum<{
-                ready: "ready";
                 queued: "queued";
                 failed: "failed";
+                ready: "ready";
                 deleted: "deleted";
                 rendering: "rendering";
                 expired: "expired";

package/dist/capabilities/recording.cap.d.ts

@@ -478,9 +478,9 @@ export declare const recordingCapability: {
         readonly getRelocateStatus: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             jobId: z.ZodString;
             state: z.ZodEnum<{
-                running: "running";
                 done: "done";
                 failed: "failed";
+                running: "running";
                 cancelled: "cancelled";
             }>;
             fromLocationId: z.ZodString;

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export * from './types/config.js';
 export * from './types/entities.js';
 export * from './types/models.js';
 export * from './types/model-variant-groups.js';
-export type { EngineOutput, LetterboxMeta, ModelInputMeta } from './types/engine-output.js';
+export type { EngineOutput } from './types/engine-output.js';
 export * from './types/pipeline.js';
 export * from './types/pipeline-step.js';
 export type { CameraPipelineConfig, PipelineTemplate as CameraPipelineTemplate, } from './types/camera-pipeline.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DETsT9rJ.js");
+const require_sleep = require("./sleep-mkNQLVPE.js");
 const require_event_category = require("./event-category-39bpf1r_.js");
 const require_enums = require("./enums.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
@@ -10463,6 +10463,18 @@ var motionCapability = {
 	name: "motion",
 	scope: "device",
 	mode: "singleton",
+	/**
+	* Providers register per-device natives via `ctx.registerNativeCap`
+	* (Hikvision/Reolink/Amcrest/Wyze/HA/Homematic/Alexa/Matter) — there is
+	* NO system singleton provider. Without this flag `resolveCapMount`
+	* derived `{ kind: 'singleton' }`, so `motion.getStatus`/`isDetected`
+	* resolved via `registry.getSingleton('motion')` (always null) and every
+	* call 412'd "provider not available" while bindings listed a live
+	* `motion` native (2026-08-02). The flag routes the router through
+	* `requireDeviceScoped` → `getProviderForDevice`, like `motion-trigger`,
+	* `snapshot` and every other per-device native cap.
+	*/
+	deviceNative: true,
 	deviceTypes: [require_sleep.DeviceType.Camera, require_sleep.DeviceType.Sensor],
 	methods: { 
 	/**

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as ProfileSlotSchema, A as parseJsonUnknown, B as BrokerStatsSchema, C as asBoolean, Ct as DisposerChain, D as asString, E as asNumber, F as ReadinessRegistry, G as CamStreamResolutionSchema, H as CAM_PROFILE_ORDER, I as ReadinessTimeoutError, J as DecodedFrameSchema, K as CameraStreamSchema, L as emitDownForOwnedCaps, M as nodePin, N as readNodePin, O as parseJsonArray, P as DATAPLANE_SECRET_HEADER, Q as ProfileRtspEntrySchema, R as readinessKey, S as DeviceType, St as resolveHydratedFieldValue, T as asJsonObject, U as CamProfileSchema, V as BrokerStatusSchema, W as CamStreamKindSchema, X as FrameHandleFormatSchema, Y as EncodedPacketSchema, Z as FrameHandleSchema, _ as resolveCapMount, _t as WELL_KNOWN_TABS, a as viewerUiCapability, at as SubscribeFramesInputSchema, b as DeviceFeature, bt as collectHydratedFieldValues, c as createLazyTrpcSource, ct as makeSourceBrokerId, d as DEVICE_SETTINGS_CONTRIBUTION_METHODS, dt as BaseAddon, et as ProfileSlotStatusSchema, f as DEVICE_STATUS_METHOD, ft as normalizeAddonInitResult, g as method, gt as isEvent, h as isDeviceConfigCap, ht as emitReadiness, i as deviceOpsCapability, it as SubscribeAudioChunksResultSchema, j as CAP_NODE_PIN_CONTEXT_KEY, k as parseJsonObject, l as createMirrorSource, lt as parseProfileBrokerId, m as expandCapMethods, mt as createEvent, n as sleepCancellable, nt as StreamSourceSchema, o as adminUiCapability, ot as SubscribeFramesResultSchema, p as event, pt as createDurableState, q as DecodedAudioChunkSchema, r as RawStateResultSchema, rt as SubscribeAudioChunksInputSchema, s as createDeviceProxy, st as makeProfileBrokerId, t as sleep, tt as StreamSourceEntrySchema, u as createSliceHandle, ut as selectAssignedProfileSlots, v as systemMethod, vt as WELL_KNOWN_TAB_MAP, w as asJsonArray, x as DeviceRole, xt as hydrateSchema, y as ChargingStatus, yt as collectHydratedFieldEntries, z as scopeKey } from "./sleep-B_Uaqbai.mjs";
+import { $ as ProfileSlotSchema, A as parseJsonUnknown, B as BrokerStatsSchema, C as asBoolean, Ct as DisposerChain, D as asString, E as asNumber, F as ReadinessRegistry, G as CamStreamResolutionSchema, H as CAM_PROFILE_ORDER, I as ReadinessTimeoutError, J as DecodedFrameSchema, K as CameraStreamSchema, L as emitDownForOwnedCaps, M as nodePin, N as readNodePin, O as parseJsonArray, P as DATAPLANE_SECRET_HEADER, Q as ProfileRtspEntrySchema, R as readinessKey, S as DeviceType, St as resolveHydratedFieldValue, T as asJsonObject, U as CamProfileSchema, V as BrokerStatusSchema, W as CamStreamKindSchema, X as FrameHandleFormatSchema, Y as EncodedPacketSchema, Z as FrameHandleSchema, _ as resolveCapMount, _t as WELL_KNOWN_TABS, a as viewerUiCapability, at as SubscribeFramesInputSchema, b as DeviceFeature, bt as collectHydratedFieldValues, c as createLazyTrpcSource, ct as makeSourceBrokerId, d as DEVICE_SETTINGS_CONTRIBUTION_METHODS, dt as BaseAddon, et as ProfileSlotStatusSchema, f as DEVICE_STATUS_METHOD, ft as normalizeAddonInitResult, g as method, gt as isEvent, h as isDeviceConfigCap, ht as emitReadiness, i as deviceOpsCapability, it as SubscribeAudioChunksResultSchema, j as CAP_NODE_PIN_CONTEXT_KEY, k as parseJsonObject, l as createMirrorSource, lt as parseProfileBrokerId, m as expandCapMethods, mt as createEvent, n as sleepCancellable, nt as StreamSourceSchema, o as adminUiCapability, ot as SubscribeFramesResultSchema, p as event, pt as createDurableState, q as DecodedAudioChunkSchema, r as RawStateResultSchema, rt as SubscribeAudioChunksInputSchema, s as createDeviceProxy, st as makeProfileBrokerId, t as sleep, tt as StreamSourceEntrySchema, u as createSliceHandle, ut as selectAssignedProfileSlots, v as systemMethod, vt as WELL_KNOWN_TAB_MAP, w as asJsonArray, x as DeviceRole, xt as hydrateSchema, y as ChargingStatus, yt as collectHydratedFieldEntries, z as scopeKey } from "./sleep-BYyv9gUM.mjs";
 import { t as EventCategory } from "./event-category-Bz24uP1U.mjs";
 import { EventSourceType } from "./enums.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
@@ -10462,6 +10462,18 @@ var motionCapability = {
 	name: "motion",
 	scope: "device",
 	mode: "singleton",
+	/**
+	* Providers register per-device natives via `ctx.registerNativeCap`
+	* (Hikvision/Reolink/Amcrest/Wyze/HA/Homematic/Alexa/Matter) — there is
+	* NO system singleton provider. Without this flag `resolveCapMount`
+	* derived `{ kind: 'singleton' }`, so `motion.getStatus`/`isDetected`
+	* resolved via `registry.getSingleton('motion')` (always null) and every
+	* call 412'd "provider not available" while bindings listed a live
+	* `motion` native (2026-08-02). The flag routes the router through
+	* `requireDeviceScoped` → `getProviderForDevice`, like `motion-trigger`,
+	* `snapshot` and every other per-device native cap.
+	*/
+	deviceNative: true,
 	deviceTypes: [DeviceType.Camera, DeviceType.Sensor],
 	methods: { 
 	/**

package/dist/interfaces/addon.d.ts

@@ -851,7 +851,11 @@ export interface AddonDeclaration {
     readonly id: string;
     /** JS entry point relative to package root (e.g., "./dist/addon.js") */
     readonly entry?: string;
-    /** Human-readable name */
+    /**
+     * Human-readable name — the label every addon list renders. Say what the
+     * addon IS ("Admin UI", "Recorder"); no "CamStack " prefix, it carries no
+     * information inside a CamStack install and eats list width.
+     */
     readonly name?: string;
     /** Semver version */
     readonly version?: string;
@@ -1010,7 +1014,11 @@ export interface AddonPythonRequirements {
     readonly requirements: string;
 }
 export interface AddonPackageManifest {
-    /** Human-readable package name for UI display (e.g., "CamStack Vision") */
+    /**
+     * Human-readable package name for UI display (e.g., "Pipeline", "Core").
+     * No "CamStack " prefix — inside a CamStack install it carries no
+     * information and only eats the width of every list that renders it.
+     */
     readonly displayName?: string;
     /**
      * Optional 1-2 sentence description shown on the package card.

package/dist/interfaces/readiness.d.ts

@@ -68,8 +68,12 @@ export interface IReadinessRegistry<TCapName extends string = string> {
      * authoritative for are skipped. For each applied entry a one-shot
      * transition is dispatched to matching subscriptions so pending
      * `awaitReady` callers unblock without waiting for a fresh delta.
+     *
+     * Returns the number of records applied (added or advanced) — `0`
+     * means the snapshot matched local state and callers doing periodic
+     * reconciles should stay silent about it.
      */
-    hydrate(records: readonly IReadinessRegistryRecord[]): void;
+    hydrate(records: readonly IReadinessRegistryRecord[]): number;
     /**
      * Serializable snapshot for cross-process transport. Returned as an
      * array (MsgPack-friendly) rather than the internal Map.

package/dist/interfaces/relocate.d.ts

@@ -10,18 +10,18 @@ import { z } from 'zod';
  * row on the owning addon's surface.
  */
 export declare const RelocateJobStateSchema: z.ZodEnum<{
-    running: "running";
     done: "done";
     failed: "failed";
+    running: "running";
     cancelled: "cancelled";
 }>;
 export type RelocateJobState = z.infer<typeof RelocateJobStateSchema>;
 export declare const RelocateJobSchema: z.ZodObject<{
     jobId: z.ZodString;
     state: z.ZodEnum<{
-        running: "running";
         done: "done";
         failed: "failed";
+        running: "running";
         cancelled: "cancelled";
     }>;
     fromLocationId: z.ZodString;

package/dist/lifecycle/job.d.ts

@@ -91,8 +91,8 @@ export declare const lifecycleTaskSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type LifecycleTask = z.infer<typeof lifecycleTaskSchema>;
 export declare const lifecycleJobStateSchema: z.ZodEnum<{
-    running: "running";
     failed: "failed";
+    running: "running";
     completed: "completed";
     "partially-failed": "partially-failed";
     cancelled: "cancelled";
@@ -166,8 +166,8 @@ export declare const lifecycleJobSchema: z.ZodObject<{
         finishedAtMs: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>;
     state: z.ZodEnum<{
-        running: "running";
         failed: "failed";
+        running: "running";
         completed: "completed";
         "partially-failed": "partially-failed";
         cancelled: "cancelled";

package/dist/readiness/readiness-registry.d.ts

@@ -23,7 +23,7 @@
  */
 import type { IEventBus, ReadinessScope, ReadinessState } from '../interfaces/event-bus.js';
 import type { IScopedLogger } from '../interfaces/logging.js';
-import type { IReadinessRegistry, IReadinessHandler, IAwaitReadyOptions, IReadinessTransition } from '../interfaces/readiness.js';
+import type { IAwaitReadyOptions, IReadinessHandler, IReadinessRegistry, IReadinessTransition } from '../interfaces/readiness.js';
 /**
  * Concrete types live here; `interfaces/readiness.ts` declares the
  * matching narrow interfaces (`IReadinessTransition`,
@@ -74,6 +74,21 @@ export interface ReadinessRegistryOptions {
      * Clock source. Injectable for tests.
      */
     readonly now?: () => number;
+    /**
+     * Opt-in per-record debug logging for DEVICE-scoped transitions.
+     *
+     * Default `false` — and that default is load-bearing. Device-scoped
+     * readiness is O(caps × devices) (observed live: 776 pairs for one
+     * producer generation), and EVERY process runs a registry whose logs
+     * forward to the hub `LogManager`. With per-record logging on, one hub
+     * container boot produced 21 577 identical-shape debug lines in a
+     * single minute (776 pairs × ~28 processes, 2026-08-01 15:04Z) — noise
+     * that buried the lines that mattered while the operator was asking
+     * why the viewer stalled. Node/global-scoped transitions stay logged
+     * per-record unconditionally: they are low-cardinality and every
+     * readiness investigation so far has needed them.
+     */
+    readonly verboseDeviceScopeLogs?: boolean;
 }
 export declare class ReadinessRegistry implements IReadinessRegistry {
     private readonly bus;
@@ -81,6 +96,7 @@ export declare class ReadinessRegistry implements IReadinessRegistry {
     private readonly logger;
     private readonly now;
     private readonly generation;
+    private readonly verboseDeviceScopeLogs;
     private readonly snapshot;
     private readonly subscriptions;
     private readonly unsubscribeBus;
@@ -124,8 +140,22 @@ export declare class ReadinessRegistry implements IReadinessRegistry {
      * Every applied entry dispatches a one-shot transition to matching
      * subscriptions so pending `awaitReady` callers unblock without having
      * to wait for a fresh event.
+     *
+     * Returns the number of records APPLIED (added or advanced). Callers
+     * doing periodic reconciles use this to stay silent when the snapshot
+     * changed nothing — the every-60s "hydrated 1446 record(s)" heartbeat
+     * from every child process was pure noise (≈2 800 lines/hour observed
+     * live on 2026-08-01).
+     */
+    hydrate(records: readonly ReadinessRecord[]): number;
+    /**
+     * Per-record debug line, volume-gated: device-scoped records are logged
+     * only when `verboseDeviceScopeLogs` is set (see the option's doc for
+     * the 21 577-lines-per-boot-minute incident that forced the gate);
+     * node/global records always log. Device lines carry `tags.deviceId`
+     * so they group per-camera (CLAUDE.md logging rule).
      */
-    hydrate(records: readonly ReadinessRecord[]): void;
+    private logPerRecord;
     /**
      * True when THIS process is the origin authority for `record` — a
      * snapshot pulled from elsewhere must never overwrite it:

package/dist/{sleep-B_Uaqbai.mjs → sleep-BYyv9gUM.mjs}

@@ -1513,6 +1513,7 @@ var ReadinessRegistry = class {
 	logger;
 	now;
 	generation;
+	verboseDeviceScopeLogs;
 	snapshot = /* @__PURE__ */ new Map();
 	subscriptions = /* @__PURE__ */ new Set();
 	unsubscribeBus;
@@ -1523,6 +1524,7 @@ var ReadinessRegistry = class {
 		this.logger = options.logger;
 		this.now = options.now ?? (() => Date.now());
 		this.generation = options.generation ?? randomGeneration();
+		this.verboseDeviceScopeLogs = options.verboseDeviceScopeLogs ?? false;
 		this.unsubscribeBus = this.bus.subscribe({ category: "system.ready-state" }, (event) => this.ingest(event.data));
 		this.unsubscribeAgentOffline = this.bus.subscribe({ category: "agent.offline" }, (event) => this.synthesizeDownForNode(event.data.agentId));
 		if (typeof this.bus.getRecent === "function") try {
@@ -1576,9 +1578,16 @@ var ReadinessRegistry = class {
 	* Every applied entry dispatches a one-shot transition to matching
 	* subscriptions so pending `awaitReady` callers unblock without having
 	* to wait for a fresh event.
+	*
+	* Returns the number of records APPLIED (added or advanced). Callers
+	* doing periodic reconciles use this to stay silent when the snapshot
+	* changed nothing — the every-60s "hydrated 1446 record(s)" heartbeat
+	* from every child process was pure noise (≈2 800 lines/hour observed
+	* live on 2026-08-01).
 	*/
 	hydrate(records) {
 		const now = this.now();
+		let applied = 0;
 		for (const record of records) {
 			const key = readinessKey(record.capName, record.scope);
 			const prev = this.snapshot.get(key) ?? null;
@@ -1604,7 +1613,8 @@ var ReadinessRegistry = class {
 				sourceNodeId: record.sourceNodeId
 			};
 			this.snapshot.set(key, hydrated);
-			if (this.logger) this.logger.debug(`readiness: ${record.capName} (${scopeKey(record.scope)}) → ${record.state} (hydrated${prev !== null ? " update" : ""}, gen=${record.generation.slice(0, 6)})`);
+			applied++;
+			this.logPerRecord(record.scope, `readiness: ${record.capName} (${scopeKey(record.scope)}) → ${record.state} (hydrated${prev !== null ? " update" : ""}, gen=${record.generation.slice(0, 6)})`);
 			const transition = {
 				capName: record.capName,
 				scope: record.scope,
@@ -1625,6 +1635,23 @@ var ReadinessRegistry = class {
 				}
 			}
 		}
+		return applied;
+	}
+	/**
+	* Per-record debug line, volume-gated: device-scoped records are logged
+	* only when `verboseDeviceScopeLogs` is set (see the option's doc for
+	* the 21 577-lines-per-boot-minute incident that forced the gate);
+	* node/global records always log. Device lines carry `tags.deviceId`
+	* so they group per-camera (CLAUDE.md logging rule).
+	*/
+	logPerRecord(scope, message) {
+		if (!this.logger) return;
+		if (scope.type === "device") {
+			if (!this.verboseDeviceScopeLogs) return;
+			this.logger.debug(message, { tags: { deviceId: scope.deviceId } });
+			return;
+		}
+		this.logger.debug(message);
 	}
 	/**
 	* True when THIS process is the origin authority for `record` — a
@@ -1799,7 +1826,7 @@ var ReadinessRegistry = class {
 			ts: payload.ts,
 			durationInPrevState
 		};
-		if (this.logger) this.logger.debug(`readiness: ${payload.capName} (${scopeKey(payload.scope)}) → ${payload.state} epoch=${epoch} gen=${payload.generation.slice(0, 6)} (prev ${durationInPrevState}ms)`);
+		this.logPerRecord(payload.scope, `readiness: ${payload.capName} (${scopeKey(payload.scope)}) → ${payload.state} epoch=${epoch} gen=${payload.generation.slice(0, 6)} (prev ${durationInPrevState}ms)`);
 		for (const sub of this.subscriptions) {
 			if (sub.capName !== payload.capName) continue;
 			if (!scopesEqual(sub.scope, payload.scope)) continue;
@@ -1844,7 +1871,7 @@ var ReadinessRegistry = class {
 				ts: now,
 				durationInPrevState
 			};
-			if (this.logger) this.logger.debug(`readiness: ${record.capName} (${scopeKey(record.scope)}) → down (synthesized from agent.offline ${offlineNodeId})`);
+			this.logPerRecord(record.scope, `readiness: ${record.capName} (${scopeKey(record.scope)}) → down (synthesized from agent.offline ${offlineNodeId})`);
 			for (const sub of this.subscriptions) {
 				if (sub.capName !== record.capName) continue;
 				if (!scopesEqual(sub.scope, record.scope)) continue;

package/dist/{sleep-DETsT9rJ.js → sleep-mkNQLVPE.js}

@@ -1513,6 +1513,7 @@ var ReadinessRegistry = class {
 	logger;
 	now;
 	generation;
+	verboseDeviceScopeLogs;
 	snapshot = /* @__PURE__ */ new Map();
 	subscriptions = /* @__PURE__ */ new Set();
 	unsubscribeBus;
@@ -1523,6 +1524,7 @@ var ReadinessRegistry = class {
 		this.logger = options.logger;
 		this.now = options.now ?? (() => Date.now());
 		this.generation = options.generation ?? randomGeneration();
+		this.verboseDeviceScopeLogs = options.verboseDeviceScopeLogs ?? false;
 		this.unsubscribeBus = this.bus.subscribe({ category: "system.ready-state" }, (event) => this.ingest(event.data));
 		this.unsubscribeAgentOffline = this.bus.subscribe({ category: "agent.offline" }, (event) => this.synthesizeDownForNode(event.data.agentId));
 		if (typeof this.bus.getRecent === "function") try {
@@ -1576,9 +1578,16 @@ var ReadinessRegistry = class {
 	* Every applied entry dispatches a one-shot transition to matching
 	* subscriptions so pending `awaitReady` callers unblock without having
 	* to wait for a fresh event.
+	*
+	* Returns the number of records APPLIED (added or advanced). Callers
+	* doing periodic reconciles use this to stay silent when the snapshot
+	* changed nothing — the every-60s "hydrated 1446 record(s)" heartbeat
+	* from every child process was pure noise (≈2 800 lines/hour observed
+	* live on 2026-08-01).
 	*/
 	hydrate(records) {
 		const now = this.now();
+		let applied = 0;
 		for (const record of records) {
 			const key = readinessKey(record.capName, record.scope);
 			const prev = this.snapshot.get(key) ?? null;
@@ -1604,7 +1613,8 @@ var ReadinessRegistry = class {
 				sourceNodeId: record.sourceNodeId
 			};
 			this.snapshot.set(key, hydrated);
-			if (this.logger) this.logger.debug(`readiness: ${record.capName} (${scopeKey(record.scope)}) → ${record.state} (hydrated${prev !== null ? " update" : ""}, gen=${record.generation.slice(0, 6)})`);
+			applied++;
+			this.logPerRecord(record.scope, `readiness: ${record.capName} (${scopeKey(record.scope)}) → ${record.state} (hydrated${prev !== null ? " update" : ""}, gen=${record.generation.slice(0, 6)})`);
 			const transition = {
 				capName: record.capName,
 				scope: record.scope,
@@ -1625,6 +1635,23 @@ var ReadinessRegistry = class {
 				}
 			}
 		}
+		return applied;
+	}
+	/**
+	* Per-record debug line, volume-gated: device-scoped records are logged
+	* only when `verboseDeviceScopeLogs` is set (see the option's doc for
+	* the 21 577-lines-per-boot-minute incident that forced the gate);
+	* node/global records always log. Device lines carry `tags.deviceId`
+	* so they group per-camera (CLAUDE.md logging rule).
+	*/
+	logPerRecord(scope, message) {
+		if (!this.logger) return;
+		if (scope.type === "device") {
+			if (!this.verboseDeviceScopeLogs) return;
+			this.logger.debug(message, { tags: { deviceId: scope.deviceId } });
+			return;
+		}
+		this.logger.debug(message);
 	}
 	/**
 	* True when THIS process is the origin authority for `record` — a
@@ -1799,7 +1826,7 @@ var ReadinessRegistry = class {
 			ts: payload.ts,
 			durationInPrevState
 		};
-		if (this.logger) this.logger.debug(`readiness: ${payload.capName} (${scopeKey(payload.scope)}) → ${payload.state} epoch=${epoch} gen=${payload.generation.slice(0, 6)} (prev ${durationInPrevState}ms)`);
+		this.logPerRecord(payload.scope, `readiness: ${payload.capName} (${scopeKey(payload.scope)}) → ${payload.state} epoch=${epoch} gen=${payload.generation.slice(0, 6)} (prev ${durationInPrevState}ms)`);
 		for (const sub of this.subscriptions) {
 			if (sub.capName !== payload.capName) continue;
 			if (!scopesEqual(sub.scope, payload.scope)) continue;
@@ -1844,7 +1871,7 @@ var ReadinessRegistry = class {
 				ts: now,
 				durationInPrevState
 			};
-			if (this.logger) this.logger.debug(`readiness: ${record.capName} (${scopeKey(record.scope)}) → down (synthesized from agent.offline ${offlineNodeId})`);
+			this.logPerRecord(record.scope, `readiness: ${record.capName} (${scopeKey(record.scope)}) → down (synthesized from agent.offline ${offlineNodeId})`);
 			for (const sub of this.subscriptions) {
 				if (sub.capName !== record.capName) continue;
 				if (!scopesEqual(sub.scope, record.scope)) continue;

package/dist/types/detection.d.ts

@@ -1,4 +1,4 @@
-import type { BoundingBox as EngineBoundingBox, Landmark, FrameInput } from './io.js';
+import type { BoundingBox as EngineBoundingBox, FrameInput, Landmark } from './io.js';
 export interface SpatialDetection {
     readonly class: string;
     readonly originalClass: string;
@@ -248,6 +248,47 @@ export interface AudioDetection extends DetectionBase {
  * avoids an import-level collision.
  */
 export type DetectionEntry = ObjectDetection | AudioDetection;
+/**
+ * Why a POST-NMS box was dropped between the model and the overlay. One code
+ * per drop site — the diagnostic overlay shows the code verbatim, so a new
+ * drop site MUST add its own code here rather than reuse a neighbour's:
+ *  - `class-filter`: class not in the step's `enabledMacroClasses`, or a
+ *    COCO class the `classMap` does not map (both are class-identity drops
+ *    and both count toward the trace's model-saw/kept gap).
+ *  - `below-threshold`: score under the per-macro `minConfidence<Macro>`.
+ *  - `full-frame-guard`: the full-frame phantom guard
+ *    (`pipeline/full-frame-guard.ts`).
+ *  - `zone-gate`: dropped by a detection-stage zone rule AFTER the frame
+ *    result was built (`gateDetectionsByZoneRules`).
+ *
+ * NMS suppression is NOT a reason here: every engine's NMS runs in-process in
+ * the Python pool (`inference_pool.py` postprocessors) and the suppressed set
+ * is destroyed before the boundary — the trace's model-saw count is the only
+ * NMS visibility. A reason that can never fire does not belong in the union.
+ */
+export type DiscardReason = 'class-filter' | 'below-threshold' | 'full-frame-guard' | 'zone-gate';
+/**
+ * A post-NMS box the pipeline dropped before it could reach the overlay /
+ * tracker / events — always carried on `FrameResult.discarded` when a frame
+ * drops at least one box (the discarded set is post-NMS and
+ * post-confidence-floor: a handful of boxes per frame, not the raw
+ * candidate flood, which never leaves the Python pool).
+ *
+ * `bbox` is the executor's `[x1, y1, x2, y2]` tuple in ABSOLUTE
+ * analysis-frame pixels (the same space the executor's drop sites hold) —
+ * consumers normalise against `FrameResult.width`/`height` from the same
+ * frame. Deliberately NOT the survivors' `{x, y, width, height}` object:
+ * the tuple is what every drop site already holds, and the viewer's
+ * `parseDiscardedEvent` accepts it as-is.
+ */
+export interface DiscardedDetection {
+    /** `[x1, y1, x2, y2]` in absolute analysis-frame pixels. */
+    readonly bbox: readonly [number, number, number, number];
+    /** Macro class where the classMap resolves one, else the raw model class. */
+    readonly macroClass: string;
+    readonly score: number;
+    readonly reason: DiscardReason;
+}
 /**
  * Per-frame pipeline result — the canonical container emitted by
  * `pipelineExecutor.runPipeline` (one-shot benchmark + runtime dispatch)
@@ -263,6 +304,13 @@ export interface FrameResult {
     readonly width: number;
     readonly height: number;
     readonly detections: readonly ObjectDetection[];
+    /**
+     * Post-NMS boxes the pipeline dropped on this frame (see
+     * {@link DiscardedDetection}). Always populated when at least one box was
+     * dropped — absent means "nothing dropped", never "empty array". A frame
+     * that drops nothing allocates nothing and puts no field on the wire.
+     */
+    readonly discarded?: readonly DiscardedDetection[];
     readonly debug?: FrameDebug;
 }
 /**

package/dist/types/engine-output.d.ts

@@ -1,23 +1,23 @@
-export interface LetterboxMeta {
-    readonly scale: number;
-    readonly padX: number;
-    readonly padY: number;
-    readonly originalWidth: number;
-    readonly originalHeight: number;
-}
+/**
+ * Output envelope of an inference engine call.
+ *
+ * Every engine is a Python pool (`inference_pool.py`) and postprocessing runs
+ * in-process there — the pool returns a `structured` StepOutput payload. The
+ * former Node.js onnxruntime raw-tensor fields (`tensor` / `tensors` /
+ * `letterbox`) were removed with that path: the platform ships no Node ONNX
+ * runtime.
+ */
 export interface EngineOutput {
-    readonly tensor?: Float32Array;
-    readonly tensors?: Record<string, Float32Array>;
     readonly structured?: Record<string, unknown>;
-    readonly letterbox?: LetterboxMeta;
     readonly inferenceMs: number;
-}
-export interface ModelInputMeta {
-    readonly inputSize: {
-        readonly width: number;
-        readonly height: number;
-    };
-    readonly inputNormalization: 'zero-one' | 'imagenet' | 'none';
-    readonly inputLayout: 'nchw' | 'nhwc';
-    readonly preprocessMode: 'letterbox' | 'resize';
+    /**
+     * Overload shed: the inference pool DELIBERATELY did not run inference for
+     * this frame (the Python pool's per-model in-flight bound, or the TS-side
+     * worker in-flight cap). A shed output carries NO `structured` payload —
+     * consumers skip the frame the way any dropped frame is skipped. It is an
+     * expected flow-control outcome, never an error.
+     */
+    readonly dropped?: true;
+    /** Which bound shed the frame (e.g. `'worker-in-flight-cap'`). */
+    readonly shedReason?: string;
 }

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

@@ -1,7 +1,7 @@
-import type { ModelCatalogEntry } from './models.js';
+import type { ConfigField } from '../interfaces/config-ui.js';
 import type { ClassMapDefinition } from './labels.js';
+import type { ModelCatalogEntry } from './models.js';
 import type { PipelineSlot } from './pipeline.js';
-import type { ConfigField } from '../interfaces/config-ui.js';
 /**
  * Each pipeline step implements this interface as a class.
  * `definition` holds the static metadata; `getConfigSchema()` declares

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.18",
+  "version": "1.2.20",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",
@@ -48,7 +48,7 @@
   },
   "camstack": {
     "system": false,
-    "displayName": "CamStack Types",
+    "displayName": "Types",
     "description": "Shared cap definitions, schemas, and runtime contracts. Required at server boot; updating restarts the hub."
   },
   "files": [