@camstack/types 1.2.75 → 1.2.77

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

@@ -28,8 +28,8 @@ export declare const DecoderSessionConfigSchema: z.ZodObject<{
     deviceId: z.ZodOptional<z.ZodNumber>;
     tag: z.ZodOptional<z.ZodString>;
     frameSink: z.ZodDefault<z.ZodEnum<{
-        shm: "shm";
         callback: "callback";
+        shm: "shm";
     }>>;
     debug: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -401,6 +401,14 @@ export interface CameraDetectionConfig {
      * Absent ⇒ the orchestrator's built-in default; `0` disables the hold.
      */
     readonly maxSessionHoldMs?: number;
+    /**
+     * Orchestrator quiet period (ms) closing an `audioMode: 'on-motion'` audio
+     * window, measured from the last motion event. Required because
+     * camera-native motion is a RISING EDGE ONLY — a window closing solely on
+     * `detected:false` never closes on an onboard-only camera. Absent ⇒ the
+     * orchestrator's built-in default.
+     */
+    readonly audioMotionWindowMs?: number;
     readonly audioStreamId?: string;
     /**
      * Operator-facing scheduling modes. Forwarded to `RunnerCameraConfig`;

package/dist/{sleep-B-mRsuDp.js → sleep-CoL-9qhR.js}

@@ -2920,6 +2920,7 @@ function createDeviceProxy(api, binding, opts) {
 			sceneMonitor: createSliceHandle(stateSource, binding.deviceId, "scene-monitor"),
 			scriptRunner: createSliceHandle(stateSource, binding.deviceId, "script-runner"),
 			smoke: createSliceHandle(stateSource, binding.deviceId, "smoke"),
+			streamCatalog: createSliceHandle(stateSource, binding.deviceId, "stream-catalog"),
 			streamParams: createSliceHandle(stateSource, binding.deviceId, "stream-params"),
 			switch: createSliceHandle(stateSource, binding.deviceId, "switch"),
 			tamper: createSliceHandle(stateSource, binding.deviceId, "tamper"),
@@ -3626,6 +3627,42 @@ function isDeviceScopedCap(capName) {
 	return DEVICE_SCOPED_CAPS.has(capName);
 }
 //#endregion
+//#region src/util/boot-recovery-backoff.ts
+/**
+* The ONE retry schedule for work that can fail simply because the node was
+* still booting.
+*
+* The measured failure (docs/design/boot-to-usable-camera.md, item E): a hub
+* boot that serialised its addon graph starved every driver dial on it. Fifteen
+* Hikvision devices logged `Initial probe did not complete — scheduling retry
+* chain {firstRetryMs=300000}` and then sat unprobed for five minutes, long
+* after the condition that caused the failure had gone. The Tailscale addon's
+* auto-rejoin carried a byte-identical schedule, armed from `initialize()`, for
+* the same reason.
+*
+* The shape that fixes it: **two cheap attempts first, then the long tail.**
+*
+*  - 15 s / 60 s — the boot window. Anything that failed because the node was
+*    busy is recovered here, before an operator can open the UI and see a
+*    camera that is wrong about itself.
+*  - 5 m → 90 m — the genuinely-offline case. A battery cam that is asleep, a
+*    VLAN that is down, a peer that has not come back. Unchanged in intent from
+*    the schedule this replaces (~3 h 30 m of coverage): here ~3 h 21 m, then
+*    the chain ends and manual re-arm (reprobe / restart) is the only path.
+*
+* Bounded on purpose — see D6. A chain that never gives up is a busy loop with
+* extra steps.
+*/
+var BOOT_RECOVERY_BACKOFF_MS = [
+	15e3,
+	6e4,
+	5 * 6e4,
+	15 * 6e4,
+	30 * 6e4,
+	60 * 6e4,
+	90 * 6e4
+];
+//#endregion
 //#region src/utils/json-safe.ts
 /**
 * Type-safe JSON parsing helpers.
@@ -3739,6 +3776,12 @@ function sleepCancellable(ms, signal) {
 	});
 }
 //#endregion
+Object.defineProperty(exports, "BOOT_RECOVERY_BACKOFF_MS", {
+	enumerable: true,
+	get: function() {
+		return BOOT_RECOVERY_BACKOFF_MS;
+	}
+});
 Object.defineProperty(exports, "BaseAddon", {
 	enumerable: true,
 	get: function() {

package/dist/{sleep-CQayd2Su.mjs → sleep-DlC2kJYf.mjs}

@@ -2920,6 +2920,7 @@ function createDeviceProxy(api, binding, opts) {
 			sceneMonitor: createSliceHandle(stateSource, binding.deviceId, "scene-monitor"),
 			scriptRunner: createSliceHandle(stateSource, binding.deviceId, "script-runner"),
 			smoke: createSliceHandle(stateSource, binding.deviceId, "smoke"),
+			streamCatalog: createSliceHandle(stateSource, binding.deviceId, "stream-catalog"),
 			streamParams: createSliceHandle(stateSource, binding.deviceId, "stream-params"),
 			switch: createSliceHandle(stateSource, binding.deviceId, "switch"),
 			tamper: createSliceHandle(stateSource, binding.deviceId, "tamper"),
@@ -3626,6 +3627,42 @@ function isDeviceScopedCap(capName) {
 	return DEVICE_SCOPED_CAPS.has(capName);
 }
 //#endregion
+//#region src/util/boot-recovery-backoff.ts
+/**
+* The ONE retry schedule for work that can fail simply because the node was
+* still booting.
+*
+* The measured failure (docs/design/boot-to-usable-camera.md, item E): a hub
+* boot that serialised its addon graph starved every driver dial on it. Fifteen
+* Hikvision devices logged `Initial probe did not complete — scheduling retry
+* chain {firstRetryMs=300000}` and then sat unprobed for five minutes, long
+* after the condition that caused the failure had gone. The Tailscale addon's
+* auto-rejoin carried a byte-identical schedule, armed from `initialize()`, for
+* the same reason.
+*
+* The shape that fixes it: **two cheap attempts first, then the long tail.**
+*
+*  - 15 s / 60 s — the boot window. Anything that failed because the node was
+*    busy is recovered here, before an operator can open the UI and see a
+*    camera that is wrong about itself.
+*  - 5 m → 90 m — the genuinely-offline case. A battery cam that is asleep, a
+*    VLAN that is down, a peer that has not come back. Unchanged in intent from
+*    the schedule this replaces (~3 h 30 m of coverage): here ~3 h 21 m, then
+*    the chain ends and manual re-arm (reprobe / restart) is the only path.
+*
+* Bounded on purpose — see D6. A chain that never gives up is a busy loop with
+* extra steps.
+*/
+var BOOT_RECOVERY_BACKOFF_MS = [
+	15e3,
+	6e4,
+	5 * 6e4,
+	15 * 6e4,
+	30 * 6e4,
+	60 * 6e4,
+	90 * 6e4
+];
+//#endregion
 //#region src/utils/json-safe.ts
 /**
 * Type-safe JSON parsing helpers.
@@ -3739,4 +3776,4 @@ function sleepCancellable(ms, signal) {
 	});
 }
 //#endregion
-export { FrameHandleFormatSchema as $, isDeviceConfigCap as A, emitDownForOwnedCaps as B, DeviceType as C, WELL_KNOWN_TAB_MAP as Ct, DEVICE_STATUS_METHOD as D, resolveHydratedFieldValue as Dt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as E, hydrateSchema as Et, nodePin as F, CAM_PROFILE_ORDER as G, scopeKey as H, readNodePin as I, CamStreamResolutionSchema as J, CamProfileSchema as K, toNodeId as L, resolveCapMount as M, systemMethod as N, event as O, CAP_NODE_PIN_CONTEXT_KEY as P, EncodedPacketSchema as Q, ReadinessRegistry as R, DeviceRole as S, WELL_KNOWN_TABS as St, DEFAULT_RUNTIME_STATE_DURABILITY as T, collectHydratedFieldValues as Tt, BrokerStatsSchema as U, readinessKey as V, BrokerStatusSchema as W, DecodedAudioChunkSchema as X, CameraStreamSchema as Y, DecodedFrameSchema as Z, RawStateResultSchema as _, normalizeAddonInitResult as _t, asJsonObject as a, StreamSourceSchema as at, ChargingStatus as b, emitReadiness as bt, parseJsonArray as c, SubscribeFramesInputSchema as ct, DEVICE_SCOPED_CAPS as d, makeSourceBrokerId as dt, FrameHandleSchema as et, isDeviceScopedCap as f, parseProfileBrokerId as ft, createSliceHandle as g, BaseAddon as gt, createMirrorSource as h, DisposerChain as ht, asJsonArray as i, StreamSourceEntrySchema$1 as it, method as j, expandCapMethods as k, parseJsonObject as l, SubscribeFramesResultSchema as lt, createLazyTrpcSource as m, DATAPLANE_SECRET_HEADER as mt, sleepCancellable as n, ProfileSlotSchema as nt, asNumber as o, SubscribeAudioChunksInputSchema as ot, createDeviceProxy as p, selectAssignedProfileSlots as pt, CamStreamKindSchema as q, asBoolean as r, ProfileSlotStatusSchema as rt, asString as s, SubscribeAudioChunksResultSchema as st, sleep as t, ProfileRtspEntrySchema as tt, parseJsonUnknown as u, makeProfileBrokerId as ut, deviceOpsCapability as v, createDurableState as vt, adminUiCapability as w, collectHydratedFieldEntries as wt, DeviceFeature as x, isEvent as xt, viewerUiCapability as y, createEvent as yt, ReadinessTimeoutError as z };
+export { EncodedPacketSchema as $, expandCapMethods as A, ReadinessTimeoutError as B, DeviceRole as C, WELL_KNOWN_TABS as Ct, DEVICE_SETTINGS_CONTRIBUTION_METHODS as D, hydrateSchema as Dt, DEFAULT_RUNTIME_STATE_DURABILITY as E, collectHydratedFieldValues as Et, CAP_NODE_PIN_CONTEXT_KEY as F, BrokerStatusSchema as G, readinessKey as H, nodePin as I, CamStreamKindSchema as J, CAM_PROFILE_ORDER as K, readNodePin as L, method as M, resolveCapMount as N, DEVICE_STATUS_METHOD as O, resolveHydratedFieldValue as Ot, systemMethod as P, DecodedFrameSchema as Q, toNodeId as R, DeviceFeature as S, isEvent as St, adminUiCapability as T, collectHydratedFieldEntries as Tt, scopeKey as U, emitDownForOwnedCaps as V, BrokerStatsSchema as W, CameraStreamSchema as X, CamStreamResolutionSchema as Y, DecodedAudioChunkSchema as Z, createSliceHandle as _, BaseAddon as _t, asJsonObject as a, StreamSourceEntrySchema$1 as at, viewerUiCapability as b, createEvent as bt, parseJsonArray as c, SubscribeAudioChunksResultSchema as ct, BOOT_RECOVERY_BACKOFF_MS as d, makeProfileBrokerId as dt, FrameHandleFormatSchema as et, DEVICE_SCOPED_CAPS as f, makeSourceBrokerId as ft, createMirrorSource as g, DisposerChain as gt, createLazyTrpcSource as h, DATAPLANE_SECRET_HEADER as ht, asJsonArray as i, ProfileSlotStatusSchema as it, isDeviceConfigCap as j, event as k, parseJsonObject as l, SubscribeFramesInputSchema as lt, createDeviceProxy as m, selectAssignedProfileSlots as mt, sleepCancellable as n, ProfileRtspEntrySchema as nt, asNumber as o, StreamSourceSchema as ot, isDeviceScopedCap as p, parseProfileBrokerId as pt, CamProfileSchema as q, asBoolean as r, ProfileSlotSchema as rt, asString as s, SubscribeAudioChunksInputSchema as st, sleep as t, FrameHandleSchema as tt, parseJsonUnknown as u, SubscribeFramesResultSchema as ut, RawStateResultSchema as v, normalizeAddonInitResult as vt, DeviceType as w, WELL_KNOWN_TAB_MAP as wt, ChargingStatus as x, emitReadiness as xt, deviceOpsCapability as y, createDurableState as yt, ReadinessRegistry as z };

package/dist/types/models.d.ts

@@ -121,8 +121,8 @@ export declare const ModelVariantGroupSchema: z.ZodObject<{
         int8: "int8";
     }>>;
     optimization: z.ZodOptional<z.ZodEnum<{
-        standard: "standard";
         fast: "fast";
+        standard: "standard";
     }>>;
     resolution: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -210,9 +210,9 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
         nhwc: "nhwc";
     }>>;
     inputNormalization: z.ZodOptional<z.ZodEnum<{
+        none: "none";
         "zero-one": "zero-one";
         imagenet: "imagenet";
-        none: "none";
     }>>;
     outputProbabilities: z.ZodOptional<z.ZodBoolean>;
     preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -240,8 +240,8 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
             int8: "int8";
         }>>;
         optimization: z.ZodOptional<z.ZodEnum<{
-            standard: "standard";
             fast: "fast";
+            standard: "standard";
         }>>;
         resolution: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -310,19 +310,19 @@ export declare const ModelConvertMetadataSchema: z.ZodObject<{
         nhwc: "nhwc";
     }>>;
     inputNormalization: z.ZodOptional<z.ZodEnum<{
+        none: "none";
         "zero-one": "zero-one";
         imagenet: "imagenet";
-        none: "none";
     }>>;
     preprocessMode: z.ZodOptional<z.ZodEnum<{
         letterbox: "letterbox";
         resize: "resize";
     }>>;
     outputFormat: z.ZodEnum<{
+        classification: "classification";
         yolo: "yolo";
         ssd: "ssd";
         embedding: "embedding";
-        classification: "classification";
         ocr: "ocr";
         segmentation: "segmentation";
     }>;
@@ -431,9 +431,9 @@ export declare const ConvertResultSchema: z.ZodObject<{
             nhwc: "nhwc";
         }>>;
         inputNormalization: z.ZodOptional<z.ZodEnum<{
+            none: "none";
             "zero-one": "zero-one";
             imagenet: "imagenet";
-            none: "none";
         }>>;
         outputProbabilities: z.ZodOptional<z.ZodBoolean>;
         preprocessMode: z.ZodOptional<z.ZodEnum<{
@@ -461,8 +461,8 @@ export declare const ConvertResultSchema: z.ZodObject<{
                 int8: "int8";
             }>>;
             optimization: z.ZodOptional<z.ZodEnum<{
-                standard: "standard";
                 fast: "fast";
+                standard: "standard";
             }>>;
             resolution: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;

package/dist/util/boot-recovery-backoff.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The ONE retry schedule for work that can fail simply because the node was
+ * still booting.
+ *
+ * The measured failure (docs/design/boot-to-usable-camera.md, item E): a hub
+ * boot that serialised its addon graph starved every driver dial on it. Fifteen
+ * Hikvision devices logged `Initial probe did not complete — scheduling retry
+ * chain {firstRetryMs=300000}` and then sat unprobed for five minutes, long
+ * after the condition that caused the failure had gone. The Tailscale addon's
+ * auto-rejoin carried a byte-identical schedule, armed from `initialize()`, for
+ * the same reason.
+ *
+ * The shape that fixes it: **two cheap attempts first, then the long tail.**
+ *
+ *  - 15 s / 60 s — the boot window. Anything that failed because the node was
+ *    busy is recovered here, before an operator can open the UI and see a
+ *    camera that is wrong about itself.
+ *  - 5 m → 90 m — the genuinely-offline case. A battery cam that is asleep, a
+ *    VLAN that is down, a peer that has not come back. Unchanged in intent from
+ *    the schedule this replaces (~3 h 30 m of coverage): here ~3 h 21 m, then
+ *    the chain ends and manual re-arm (reprobe / restart) is the only path.
+ *
+ * Bounded on purpose — see D6. A chain that never gives up is a busy loop with
+ * extra steps.
+ */
+export declare const BOOT_RECOVERY_BACKOFF_MS: readonly number[];

package/package.json

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