@camstack/addon-post-analysis 1.2.73 → 1.2.75

package/dist/{dist-_D0jdUh4.mjs → dist-BA7ThdEJ.mjs}

@@ -1,4 +1,4 @@
-//#region ../types/dist/event-category-Cv9dO26A.mjs
+//#region ../types/dist/event-category-Bxo5yJjt.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -205,6 +205,33 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["PipelineCameraAssigned"] = "pipeline.camera-assigned";
 	EventCategory["PipelineCameraUnassigned"] = "pipeline.camera-unassigned";
 	/**
+	* A node the orchestrator would otherwise place cameras on has NO usable
+	* inference device: the operator enabled one or more accelerators there and
+	* the live probe reports every one of them unavailable. Emitted once per
+	* TRANSITION into that state (never per dispatch), and the node is dropped
+	* from the placement candidate set for as long as it holds.
+	*
+	* This exists because the state was previously invisible: little-unraid
+	* absorbed 283k inference errors in a day while still being handed cameras,
+	* and nothing in the system said so.
+	*
+	* A node with no accelerators configured at all is NOT this — its devices
+	* are `disabled`, not `unavailable`, and the runner's default CPU pool
+	* serves it exactly as before.
+	*/
+	EventCategory["PipelineNodeInferenceUnavailable"] = "pipeline.node-inference-unavailable";
+	/**
+	* A camera has an OPEN detection session and has produced no detection at
+	* all for longer than the blind threshold — the camera is being decoded and
+	* inferred and is returning nothing. Emitted once per transition into blind,
+	* per camera.
+	*
+	* The failure it reports: a 1h43 detection blackout on the entrance camera
+	* that nobody noticed, because "a camera that detects nothing" and "a quiet
+	* camera" produce byte-identical silence.
+	*/
+	EventCategory["PipelineDetectionBlind"] = "pipeline.detection-blind";
+	/**
 	* Per-camera pipeline config was mutated by the orchestrator
 	* (3-level settings change via `setAgentAddonDefaults` /
 	* `setCameraStepToggle` / `setCameraPipelineForAgent` or a
@@ -5369,6 +5396,12 @@ Object.fromEntries([
 		icon: "shapes",
 		order: 38
 	},
+	{
+		id: "scenes",
+		label: "Scenes",
+		icon: "scan-eye",
+		order: 36
+	},
 	{
 		id: "analytics",
 		label: "Analytics",
@@ -14549,6 +14582,8 @@ var NcSystemEventKindSchema = _enum([
 	"stream-offline",
 	"node-online",
 	"node-offline",
+	"node-inference-unavailable",
+	"detection-blind",
 	"addon-update-available",
 	"server-update-available",
 	"alarm-triggered",
@@ -15356,7 +15391,50 @@ var NcRuleInputSchema = object({
 	* tests every zone the track visited and a `crossing` condition can no longer
 	* be satisfied, because a closed track carries no crossing.
 	*/
-	waitForEnhancement: boolean().optional()
+	waitForEnhancement: boolean().optional(),
+	/**
+	* GROUP a burst of subjects into ONE notification that grows.
+	*
+	* Seconds of quiet after the last matching subject before the burst is
+	* considered over. While it is open, the first subject enqueues immediately —
+	* **exactly as today, with no added latency** — and every real growth (a new
+	* subject, or a name confirmed on one already in it) REPLACES that
+	* notification with an updated one naming everybody. The push carries the
+	* group's own coalescing tag, so the phone replaces rather than stacks.
+	*
+	* `0` / absent = off, and off is today's behaviour byte for byte.
+	*
+	* ### Why an idle cutoff and not a window
+	*
+	* The measured seven-person arrival on device 590 spans 110 s with every
+	* internal gap under 30 s. A 12 s fixed window cuts it into three groups; an
+	* idle cutoff holds it as one and ends it when the arrival actually ends.
+	* 30 is Frigate's shipped value for the same decision.
+	*
+	* ### What it replaces
+	*
+	* The blind cooldown, which collapses a burst by DISCARDING it. Measured on
+	* device 615 / *Persona su Uscio* over six days: 116 qualifying tracks → 74
+	* notifications, **44 (37.9%) suppressed outright**, 23 of them overlapping a
+	* track that did fire and 7 carrying a confirmed identity nobody heard about.
+	* A group collapses the same volume by MERGING, so the cooldown becomes a
+	* budget over GROUPS — which is what it always meant — and a growth is never
+	* throttled by the window its own first member spent.
+	*
+	* ### Interaction with {@link waitForEnhancement}
+	*
+	* They compose, and the order matters. `waitForEnhancement` defers the rule to
+	* TRACK CLOSE, so with both set the group is opened by the first member to
+	* CLOSE — already carrying its name — and grows as later members close. That
+	* is later, and complete. With grouping alone the group opens on the first
+	* object event and picks up names as they are confirmed, through the growth
+	* path. Neither combination fires twice for one subject.
+	*
+	* `.optional()` and deliberately NOT `.default()`: a Zod default does not run
+	* on the addon cap path, so absent must keep meaning what it meant before this
+	* field existed.
+	*/
+	groupIdleSec: number().int().min(0).max(600).optional()
 });
 /**
 * Partial patch for `updateRule` — any subset of the input fields, plus the
@@ -15543,6 +15621,14 @@ var NC_CONDITION_CATALOG = [
 				value: "node-offline",
 				label: "Node offline"
 			},
+			{
+				value: "node-inference-unavailable",
+				label: "Node has no usable inference device"
+			},
+			{
+				value: "detection-blind",
+				label: "Camera detecting nothing"
+			},
 			{
 				value: "addon-update-available",
 				label: "Addon update available"
@@ -16789,7 +16875,7 @@ var TrackEnvelopeSchema = object({
 * `snapshots[]` references — megabytes across a page of tracks. `slim`
 * keeps every scalar the list surfaces actually render (ids, class(es),
 * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
-* zonesVisited, bestEventId, envelope, hasFace) and returns `positions` /
+* zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
 * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
 * `getTrack`. Mirrors the event-store `projection` convention
 * (`getObjectEvents` et al.).
@@ -17076,6 +17162,28 @@ var TrackSchema = object({
 	* `=== true` and render nothing otherwise, never infer "no face".
 	*/
 	hasFace: boolean().optional(),
+	/**
+	* This subject CONTAINS a folded rider — a person the rider-pairing step
+	* ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
+	* so the passage is tracked once and as a VEHICLE.
+	*
+	* It exists because the fold's record was dishonest. D34 and the code both
+	* said "the person is not lost — it is reported so both entities stay on the
+	* record"; in fact the pair went into a per-processor RAM field behind an
+	* accessor nobody called, and every durable surface said `vehicle`, full
+	* stop. This is the composition note that makes the row true.
+	*
+	* A COMPOSITION, never a class and never a label. "This vehicle contains a
+	* person" is not an answer to "what is this" — both label tiers would refuse
+	* a macro token anyway (D89), and correctly. Nothing here changes what the
+	* subject IS: a cyclist stays one vehicle track, occupancy still counts one,
+	* and a `person` rule still does not fire for someone cycling past.
+	*
+	* **Absent ≠ false**, exactly like {@link hasFace}: every row written before
+	* the column, and every hub that predates the field, omits it. Test
+	* `=== true` and render nothing otherwise — never infer "no rider".
+	*/
+	hasRider: boolean().optional(),
 	...TrackFlagFields,
 	...TrackRetrainFields
 });
@@ -27371,9 +27479,38 @@ method(object({
 * settings-contribution methods. `status.kind:'push'` — the engine pushes on
 * every hysteresis flip / availability change; consumers never poll.
 */
-/** Extensible condition tag. Seeded 'day' | 'night'; open by design so more can
-*  be added without a wire break (matching falls back to any-condition refs). */
+/** Extensible condition tag. Seeded 'day' | 'ir' (the two variants the operator
+*  captures) plus 'night' | 'dawn' | 'dusk' from the resolver's sun-times band.
+*  Open by design so more can be added without a wire break.
+*
+*  Matching does NOT fall back across conditions: cross-condition cosines are
+*  not comparable, so "I have never seen this scene in this light" is reported
+*  as `unknown`, never guessed. A day reference scored against an IR frame
+*  collapses the cosine and would latch a false alarm every single night. */
 var SceneConditionSchema = string();
+/** Reserved, engine-owned state id standing for "the region no longer looks
+*  like ANY captured reference". Never authored by an operator, never stored in
+*  `states[]` — it is the synthetic candidate that makes divergence a
+*  first-class hysteresis input rather than a bare `return`. */
+var SCENE_DIVERGED = "__diverged__";
+/** `matched` = the baseline is what we see; `diverged` = it demonstrably is not;
+*  `unknown` = we cannot judge (no reference for this condition, encoder model
+*  changed, view shifted, no snapshot). `unknown` is a real value, not a null,
+*  and never counts toward hysteresis in either direction. */
+var SceneVerdictSchema = _enum([
+	"matched",
+	"diverged",
+	"unknown"
+]);
+/** Why a scene cannot judge. Named, because this feature's failure mode is
+*  silence that reads as "nothing has happened". */
+var SceneUnavailableSchema = _enum([
+	"no-reference-for-condition",
+	"view-shifted",
+	"no-vision-profile",
+	"encoder-model-changed",
+	"no-snapshot"
+]);
 /** One captured reference — condition-tagged, model-version-gated. `embedding`
 *  is `number[]` (Float32Array does NOT survive MsgPack/UDS). */
 var SceneReferenceSchema = object({
@@ -27381,7 +27518,14 @@ var SceneReferenceSchema = object({
 	modelId: string(),
 	condition: SceneConditionSchema,
 	capturedAt: number(),
-	thumbnailMediaId: string().optional()
+	thumbnailMediaId: string().optional(),
+	/** Whole-frame (downscaled) embedding captured alongside the ROI crop. The
+	*  anti-view-shift anchor: a bumped camera, a PTZ preset or a re-aim makes the
+	*  normalized rect frame a different piece of world, and the scene would
+	*  diverge forever with a perfectly plausible cosine. Checked LAZILY, only
+	*  when hysteresis is about to flip — one extra encode per candidate
+	*  transition, not per poll. */
+	anchorEmbedding: array(number()).optional()
 });
 var SceneMonitorStateSchema = object({
 	id: string(),
@@ -27403,6 +27547,26 @@ var SceneCheckSchema = discriminatedUnion("mode", [object({
 	profileId: string().optional(),
 	hysteresisCount: number().int().positive()
 })]);
+var SCENE_DEFAULT_ANCHOR_THRESHOLD = .85;
+var SCENE_CONFIRM_DEFAULT_TIMEOUT_MS = 8e3;
+/**
+* Vision-model adjudication of a candidate flip. Field names deliberately
+* mirror `NcConfirmSchema` so an operator meets one vocabulary, not two.
+*
+* `onTimeout` defaults to **'hold'**, the OPPOSITE of `NcConfirmGate`'s
+* fail-open: a notification suppressed is the worse error there, but a vision
+* model that timed out has not told us the bin is gone, and a latch is a
+* stateful claim that costs the operator a trip to reset.
+*/
+var SceneConfirmSchema = object({
+	enabled: boolean().default(false),
+	prompt: string().min(1).max(1e3),
+	profileId: string().optional(),
+	timeoutMs: number().int().min(1e3).max(2e4).default(SCENE_CONFIRM_DEFAULT_TIMEOUT_MS),
+	maxImagePx: number().int().min(64).max(2048).default(448),
+	/** What a timeout / unavailable model means for the PENDING flip. */
+	onTimeout: _enum(["flip", "hold"]).default("hold")
+});
 var SceneMonitorSchema = object({
 	id: string(),
 	label: string(),
@@ -27421,7 +27585,41 @@ var SceneMonitorSchema = object({
 	lastConfidence: number().nullable(),
 	currentCondition: SceneConditionSchema.nullable(),
 	availability: _enum(["ok", "unavailable"]),
-	unavailableReason: string().nullable()
+	unavailableReason: string().nullable(),
+	/** Which state is "the initial screen". `null` until the first capture. */
+	baselineStateId: string().nullable(),
+	/** Which boolean drives notification rules and any export. */
+	emit: _enum(["latched", "live"]).default("latched"),
+	/** Live: does the region match the baseline RIGHT NOW. */
+	verdict: SceneVerdictSchema,
+	/** Has it been `diverged` at least once since `armedAt` — the operator's boolean. */
+	latched: boolean(),
+	/** Last reset (or creation). */
+	armedAt: number(),
+	divergedAt: number().nullable(),
+	restoredAt: number().nullable(),
+	/** A check is only COUNTED when the device has been quiet this long. Motion
+	*  during the window DISCARDS the observation — a car pulling up in front of
+	*  the bin must not be able to spend hysteresis credit. */
+	quietSeconds: number().int().min(0).max(3600).default(60),
+	/** An observation only advances the pending count when it is at least this
+	*  far from the previously counted one, so N agreeing checks span real time
+	*  rather than N adjacent polls inside one occlusion. */
+	minObservationSpacingSec: number().int().min(0).max(3600).default(120),
+	/** Vision-model adjudication of a candidate flip. Similarity primary only. */
+	confirm: SceneConfirmSchema.optional(),
+	/** Whole-frame anchor cosine below which a flip is REFUSED as `view-shifted`. */
+	anchorThreshold: number().min(0).max(1).default(SCENE_DEFAULT_ANCHOR_THRESHOLD),
+	/** Clear the latch on its own when the scene matches again? Default false —
+	*  `restoredAt` and the `scene-restored` edge are recorded regardless, so an
+	*  automation can react to the bin coming back without the operator's own
+	*  alarm silently clearing itself. */
+	autoRestore: boolean().default(false),
+	/** Named cause when `verdict === 'unknown'`. */
+	unavailable: SceneUnavailableSchema.nullable(),
+	/** Conditions that have at least one comparable reference — the coverage line
+	*  ("day ✓ · ir ✓ · dusk ✗") that turns a silent fallback into a visible fact. */
+	coveredConditions: array(SceneConditionSchema)
 });
 var SceneMonitorStatusSchema = object({
 	monitors: array(SceneMonitorSchema),
@@ -27470,7 +27668,14 @@ var sceneMonitorCapability = {
 					"both"
 				]).optional(),
 				checkIntervalSec: number().optional(),
-				check: SceneCheckSchema.optional()
+				check: SceneCheckSchema.optional(),
+				emit: _enum(["latched", "live"]).optional(),
+				quietSeconds: number().int().min(0).max(3600).optional(),
+				minObservationSpacingSec: number().int().min(0).max(3600).optional(),
+				anchorThreshold: number().min(0).max(1).optional(),
+				autoRestore: boolean().optional(),
+				/** `null` clears the vision-model adjudicator. */
+				confirm: SceneConfirmSchema.nullable().optional()
 			})
 		}), _void(), {
 			kind: "mutation",
@@ -27511,6 +27716,26 @@ var sceneMonitorCapability = {
 		}), _void(), {
 			kind: "mutation",
 			auth: "admin"
+		}),
+		/**
+		* Clear the latch, re-arm, and — by default — RE-CAPTURE the baseline for
+		* the CURRENT condition. The bin never goes back in exactly the same spot;
+		* "reset" in the operator's head means *this is the new normal*, and
+		* re-capture is what makes the feature self-healing against slow drift
+		* instead of failing silently weeks later.
+		*
+		* Reachable from three surfaces on this one mutation: the scene card, a
+		* notification button (an `onTrigger` sequence with a `kind:'cap'` step —
+		* no new Notification-Center code at all), and tRPC for scripts.
+		*/
+		resetScene: method(object({
+			deviceId: number(),
+			monitorId: string(),
+			/** Defaults to TRUE at the provider seam — see `SCENE_RESET_RECAPTURES`. */
+			recapture: boolean().optional()
+		}), _void(), {
+			kind: "mutation",
+			auth: "admin"
 		})
 	},
 	status: {
@@ -34445,6 +34670,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"sceneMonitor.resetScene": {
+		capName: "scene-monitor",
+		capScope: "device",
+		addonId: null,
+		access: "delete"
+	},
 	"sceneMonitor.updateScene": {
 		capName: "scene-monitor",
 		capScope: "device",
@@ -37127,6 +37358,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"sceneMonitor.resetScene": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"sceneMonitor.updateScene": [{
 		name: "deviceId",
 		form: "single",
@@ -37961,4 +38197,4 @@ function vectorDimFromBase64(encoded) {
 	return Math.floor(Buffer.from(encoded, "base64").byteLength / 4);
 }
 //#endregion
-export { plateGalleryCapability as $, TIMELAPSE_DENSE_FLOOR_SEC as A, cosineSimilarity as B, NcSnoozeSchema as C, string as Ct, OpsLogEntrySchema as D, NcTaxonomySchema as E, addonWidgetsSourceCapability as F, encodeVectorBase64 as G, defineCustomActions as H, alarmPanelCapability as I, isDetectionMacroClass as J, faceGalleryCapability as K, assertTimelapseCadences as L, TimelapseRulePatchSchema as M, TimelapseRuleSchema as N, RECORDING_EXPORT_MAX_READ_BYTES as O, TrackSourceSchema as P, pipelineAnalyticsCapability as Q, audioMetricsCapability as R, NcSnoozeInputSchema as S, record as St, NcSystemEventKindSchema as T, EventCategory as Tt, deriveRecordingMode as U, customAction as V, embeddingEncoderCapability as W, kebabToCamel as X, isScheduleActive as Y, notificationRulesCapability as Z, NcRuleInputSchema as _, discriminatedUnion as _t, DETECTION_PIPELINE_CAP_NAME as a, zoneAnalyticsCapability as at, NcRuleTargetSchema as b, object as bt, EVENT_PAD_MS as c, DeviceType as ct, NC_ALARM_SYSTEM_EVENT_KINDS as d, isDeviceScopedCap as dt, readDeviceStateFrom as et, NC_CONDITION_CATALOG as f, nodePin as ft, NcConditionDescriptorSchema as g, boolean as gt, NC_TAXONOMY as h, array as ht, DETECTION_MACRO_CLASSES as i, videoclipsCapability as it, TimelapseRuleInputSchema as j, RetrainStatusSchema as k, LabelAttributionSchema as l, createEvent as lt, NC_SNOOZE_MAX_MINUTES as m, _enum as mt, DEFAULT_EVENT_COLOR as n, subKindsOf as nt, DeclaredDevices as o, errMsg as ot, NC_DEFAULT_SNOOZE_MINUTES as p, sleep as pt, hfModelUrl as q, DEFAULT_TIMELAPSE_PREVIEW_TEXT as r, vectorDimFromBase64 as rt, EVENT_KIND_BY_CAP as s, BaseAddon as st, BaseDevice as t, readTimelapseGeneratedAt as tt, MACRO_LABELS as u, hydrateSchema as ut, NcRulePatchSchema as v, literal as vt, NcSnoozeSuppressedSchema as w, unknown as wt, NcScheduleSchema as x, partialRecord as xt, NcRuleSchema as y, number as yt, buildEventKindDescriptor as z };
+export { isScheduleActive as $, SCENE_CONFIRM_DEFAULT_TIMEOUT_MS as A, EventCategory as At, alarmPanelCapability as B, NcSnoozeSchema as C, literal as Ct, OpsLogEntrySchema as D, record as Dt, NcTaxonomySchema as E, partialRecord as Et, TimelapseRuleInputSchema as F, customAction as G, audioMetricsCapability as H, TimelapseRulePatchSchema as I, embeddingEncoderCapability as J, defineCustomActions as K, TimelapseRuleSchema as L, SCENE_DIVERGED as M, SceneMonitorSchema as N, RECORDING_EXPORT_MAX_READ_BYTES as O, string as Ot, TIMELAPSE_DENSE_FLOOR_SEC as P, isDetectionMacroClass as Q, TrackSourceSchema as R, NcSnoozeInputSchema as S, discriminatedUnion as St, NcSystemEventKindSchema as T, object as Tt, buildEventKindDescriptor as U, assertTimelapseCadences as V, cosineSimilarity as W, faceGalleryCapability as X, encodeVectorBase64 as Y, hfModelUrl as Z, NcRuleInputSchema as _, nodePin as _t, DETECTION_PIPELINE_CAP_NAME as a, readTimelapseGeneratedAt as at, NcRuleTargetSchema as b, array as bt, EVENT_PAD_MS as c, vectorDimFromBase64 as ct, NC_ALARM_SYSTEM_EVENT_KINDS as d, errMsg as dt, kebabToCamel as et, NC_CONDITION_CATALOG as f, BaseAddon as ft, NcConditionDescriptorSchema as g, isDeviceScopedCap as gt, NC_TAXONOMY as h, hydrateSchema as ht, DETECTION_MACRO_CLASSES as i, readDeviceStateFrom as it, SCENE_DEFAULT_ANCHOR_THRESHOLD as j, RetrainStatusSchema as k, unknown as kt, LabelAttributionSchema as l, videoclipsCapability as lt, NC_SNOOZE_MAX_MINUTES as m, createEvent as mt, DEFAULT_EVENT_COLOR as n, pipelineAnalyticsCapability as nt, DeclaredDevices as o, sceneMonitorCapability as ot, NC_DEFAULT_SNOOZE_MINUTES as p, DeviceType as pt, deriveRecordingMode as q, DEFAULT_TIMELAPSE_PREVIEW_TEXT as r, plateGalleryCapability as rt, EVENT_KIND_BY_CAP as s, subKindsOf as st, BaseDevice as t, notificationRulesCapability as tt, MACRO_LABELS as u, zoneAnalyticsCapability as ut, NcRulePatchSchema as v, sleep as vt, NcSnoozeSuppressedSchema as w, number as wt, NcScheduleSchema as x, boolean as xt, NcRuleSchema as y, _enum as yt, addonWidgetsSourceCapability as z };