@camstack/types 1.2.40 → 1.2.42

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_event_category = require("./event-category-BE4PDZ_3.js");
-const require_sleep = require("./sleep-DTce7-ch.js");
+const require_sleep = require("./sleep-Cvi1JxZp.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/collection-array-methods.ts
 /**

package/dist/addon.mjs

@@ -1,5 +1,5 @@
 import { t as EventCategory } from "./event-category-41fKf-q9.mjs";
-import { B as scopeKey, C as DeviceType, F as readNodePin, I as ReadinessRegistry, L as ReadinessTimeoutError, O as expandCapMethods, P as nodePin, a as asJsonObject, d as DEVICE_SCOPED_CAPS, f as isDeviceScopedCap, ft as DATAPLANE_SECRET_HEADER, ht as normalizeAddonInitResult, mt as BaseAddon, p as createDeviceProxy, pt as DisposerChain, s as asString, t as sleep, u as parseJsonUnknown, v as deviceOpsCapability, vt as emitReadiness, w as adminUiCapability, y as viewerUiCapability } from "./sleep-CXimb854.mjs";
+import { B as scopeKey, C as DeviceType, F as readNodePin, I as ReadinessRegistry, L as ReadinessTimeoutError, O as expandCapMethods, P as nodePin, a as asJsonObject, d as DEVICE_SCOPED_CAPS, f as isDeviceScopedCap, ft as DATAPLANE_SECRET_HEADER, ht as normalizeAddonInitResult, mt as BaseAddon, p as createDeviceProxy, pt as DisposerChain, s as asString, t as sleep, u as parseJsonUnknown, v as deviceOpsCapability, vt as emitReadiness, w as adminUiCapability, y as viewerUiCapability } from "./sleep-BmNKsY7v.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/collection-array-methods.ts
 /**

package/dist/canonical-hash-7nfBbEqR.mjs

@@ -0,0 +1,35 @@
+import { createHash } from "node:crypto";
+//#region src/utils/canonical-hash.ts
+/**
+* Deterministic SHA-256 hash of an arbitrary serialisable value. The
+* canonical form sorts object keys alphabetically at every depth so two
+* structurally-equal inputs with different key insertion orders produce
+* the same hash. Returns a 64-char lowercase hex digest.
+*
+* Used by export adapters (Alexa, HAP) to short-circuit re-discovery /
+* accessory-rebuild work when the upstream shape is byte-identical to
+* the last applied state — preventing user-visible "re-discovery"
+* notifications on every addon-runner respawn. Each respawn re-fires
+* `DeviceBindingsChanged` for every cap registration, which without
+* this guard would propagate redundant pushes.
+*
+* Note: this is a SYMPTOMATIC fix layered on top of the binding-change
+* subscription. The proper fix is a single "device ready" lifecycle
+* barrier so exports react only when the full cap set has landed —
+* tracked separately for post-HA-integration work.
+*/
+function canonicalHash(value) {
+	const canonical = JSON.stringify(value, replaceWithSortedKeys);
+	return createHash("sha256").update(canonical ?? "").digest("hex");
+}
+function replaceWithSortedKeys(_key, value) {
+	if (value && typeof value === "object" && !Array.isArray(value)) {
+		const obj = value;
+		const out = {};
+		for (const k of Object.keys(obj).toSorted()) out[k] = obj[k];
+		return out;
+	}
+	return value;
+}
+//#endregion
+export { canonicalHash as t };

package/dist/canonical-hash-BcZHRHIx.js

@@ -0,0 +1,40 @@
+let node_crypto = require("node:crypto");
+//#region src/utils/canonical-hash.ts
+/**
+* Deterministic SHA-256 hash of an arbitrary serialisable value. The
+* canonical form sorts object keys alphabetically at every depth so two
+* structurally-equal inputs with different key insertion orders produce
+* the same hash. Returns a 64-char lowercase hex digest.
+*
+* Used by export adapters (Alexa, HAP) to short-circuit re-discovery /
+* accessory-rebuild work when the upstream shape is byte-identical to
+* the last applied state — preventing user-visible "re-discovery"
+* notifications on every addon-runner respawn. Each respawn re-fires
+* `DeviceBindingsChanged` for every cap registration, which without
+* this guard would propagate redundant pushes.
+*
+* Note: this is a SYMPTOMATIC fix layered on top of the binding-change
+* subscription. The proper fix is a single "device ready" lifecycle
+* barrier so exports react only when the full cap set has landed —
+* tracked separately for post-HA-integration work.
+*/
+function canonicalHash(value) {
+	const canonical = JSON.stringify(value, replaceWithSortedKeys);
+	return (0, node_crypto.createHash)("sha256").update(canonical ?? "").digest("hex");
+}
+function replaceWithSortedKeys(_key, value) {
+	if (value && typeof value === "object" && !Array.isArray(value)) {
+		const obj = value;
+		const out = {};
+		for (const k of Object.keys(obj).toSorted()) out[k] = obj[k];
+		return out;
+	}
+	return value;
+}
+//#endregion
+Object.defineProperty(exports, "canonicalHash", {
+	enumerable: true,
+	get: function() {
+		return canonicalHash;
+	}
+});

package/dist/capabilities/index.d.ts

@@ -76,12 +76,12 @@ export { NetworkAccessStatusSchema, NetworkEndpointSchema, networkAccessCapabili
 export { type Attachment, type AttachmentMediaType, AttachmentMediaTypeSchema, AttachmentSchema, type DiscoveredTarget, DiscoveredTargetSchema, type INotificationOutputProvider, type NotificationAction, type NotificationActionIcon, NotificationActionIconSchema, NotificationActionSchema, type NotificationFormat, NotificationFormatSchema, NotificationSchema, notificationOutputCapability, type RenderedAs, RenderedAsSchema, type SendResult, SendResultSchema, type Target, type TargetKind, type TargetKindCaps, TargetKindCapsSchema, type TargetKindLevel, TargetKindLevelSchema, TargetKindSchema, TargetSchema, type TestResult, TestResultSchema, } from './notification-output.cap.js';
 export { type INotificationRulesProvider, NC_CONDITION_CATALOG, NC_HISTORY_LIMIT_DEFAULT, NC_HISTORY_LIMIT_MAX, NC_MAX_PER_TRACK_IMMEDIATE, NC_SNOOZE_MAX_MINUTES, type NcAlarmConfig, NcAlarmConfigSchema, type NcAlarmModeCoverage, NcAlarmModeCoverageSchema, type NcAlarmSettings, type NcAlarmSettingsPatch, NcAlarmSettingsPatchSchema, NcAlarmSettingsSchema, type NcConditionDescriptor, NcConditionDescriptorSchema, type NcConditions, NcConditionsSchema, type NcCrossing, NcCrossingSchema, type NcDelivery, NcDeliverySchema, type NcDeviceStateCondition, NcDeviceStateConditionSchema, type NcHistoryEntry, NcHistoryEntrySchema, type NcHistoryFilter, NcHistoryFilterSchema, type NcHistoryRecordKind, NcHistoryRecordKindSchema, type NcHistoryStatus, NcHistoryStatusSchema, type NcHistorySubject, NcHistorySubjectSchema, type NcMediaFrame, NcMediaFrameSchema, type NcMediaPolicy, NcMediaPolicySchema, type NcOccupancyCondition, NcOccupancyConditionSchema, type NcPlateMatcher, NcPlateMatcherSchema, type NcRule, type NcRuleAction, NcRuleActionSchema, type NcRuleActionSequence, NcRuleActionSequenceSchema, type NcRuleActions, NcRuleActionsSchema, type NcRuleInput, NcRuleInputSchema, type NcRuleNotificationButton, NcRuleNotificationButtonSchema, type NcRulePatch, NcRulePatchSchema, NcRuleSchema, type NcRuleTarget, NcRuleTargetSchema, type NcSchedule, NcScheduleSchema, type NcScheduleWindow, NcScheduleWindowSchema, type NcSnooze, type NcSnoozeInput, NcSnoozeInputSchema, NcSnoozeSchema, type NcSnoozeScope, NcSnoozeScopeSchema, type NcSnoozeSuppressed, NcSnoozeSuppressedSchema, type NcTestResult, NcTestResultSchema, type NcThrottle, type NcThrottleGranularity, NcThrottleGranularitySchema, NcThrottleSchema, type NcZoneCondition, NcZoneConditionSchema, notificationRulesCapability, } from './notification-rules.cap.js';
 export { type IOauthIntegrationProvider, type OauthIntegrationDescriptor, OauthIntegrationDescriptorSchema, oauthIntegrationCapability, } from './oauth-integration.cap.js';
-export { type AudioEvent, AudioEventSchema, type DetectionSource, DetectionSourceSchema, type EventKind, type EventKindCategory, EventKindCategorySchema, type EventKindDescriptor, EventKindDescriptorSchema, type EventKindIcon, EventKindIconSchema, EventKindSchema, type EventKindsForDevice, EventKindsForDeviceSchema, type EventPruneCounts, type EventStoreDeviceFootprint, type EventStoreFootprint, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type MediaFile, type MediaFileInfo, MediaFileInfoSchema, type MediaFileKind, MediaFileSchema, type MotionEvent, MotionEventSchema, type ObjectEvent, ObjectEventSchema, pipelineAnalyticsCapability, type RecentTracksPage, RecentTracksPageSchema, type RecentTracksQuery, RecentTracksQueryInput, type ScoredObjectEvent, ScoredObjectEventSchema, type SensorEvent, SensorEventSchema, type Track, type TrackCascadeCounts, TrackCascadeCountsSchema, type TrackEnvelope, TrackEnvelopeSchema, TrackedDetectionSchema, type TrackProjection, TrackProjectionSchema, TrackSchema, type TrackState, TrackStateSchema, type TrackZoneFilter, TrackZoneFilterSchema, type ZoneCrossing, type ZoneCrossingDirection, ZoneCrossingDirectionSchema, ZoneCrossingSchema, } from './pipeline-analytics.cap.js';
+export { type AudioEvent, AudioEventSchema, type DetectionSource, DetectionSourceSchema, type EventKind, type EventKindCategory, EventKindCategorySchema, type EventKindDescriptor, EventKindDescriptorSchema, type EventKindIcon, EventKindIconSchema, EventKindSchema, type EventKindsForDevice, EventKindsForDeviceSchema, type EventPruneCounts, type EventStoreDeviceFootprint, type EventStoreFootprint, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type MediaFile, type MediaFileInfo, MediaFileInfoSchema, type MediaFileKind, MediaFileSchema, type MotionEvent, MotionEventSchema, type ObjectEvent, ObjectEventSchema, pipelineAnalyticsCapability, type RecentTracksPage, RecentTracksPageSchema, type RecentTracksQuery, RecentTracksQueryInput, type ScoredObjectEvent, ScoredObjectEventSchema, type SensorEvent, SensorEventSchema, type Track, type TrackCascadeCounts, TrackCascadeCountsSchema, type TrackEnvelope, TrackEnvelopeSchema, TrackedDetectionSchema, type TrackFlags, type TrackFlagsPatch, TrackFlagsPatchSchema, TrackFlagsSchema, type TrackProjection, TrackProjectionSchema, TrackSchema, type TrackSource, TrackSourceSchema, type TrackState, TrackStateSchema, type TrackZoneFilter, TrackZoneFilterSchema, type ZoneCrossing, type ZoneCrossingDirection, ZoneCrossingDirectionSchema, ZoneCrossingSchema, } from './pipeline-analytics.cap.js';
 export type { NativeCropRef, PipelineStepInputOutput, PipelineValidationIssue, PipelineValidationResult, } from './pipeline-executor.cap.js';
 export { ModelSubstitutionSchema, NativeCropRefSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, pipelineExecutorCapability, } from './pipeline-executor.cap.js';
 export type { CameraAssignmentStatus, CameraAudioStatus, CameraBrokerProfile, CameraBrokerStatus, CameraDecoderShm, CameraDecoderStatus, CameraDetectionPhase, CameraDetectionProvisioning, CameraDetectionProvisioningState, CameraDetectionStatus, CameraMotionStatus, CameraRecordingMode, CameraRecordingStatus, CameraSourceStatus, CameraSourceStream, CameraStatus, IngestOwner, NodeInferenceDevice, NodeInferenceDevices, } from './pipeline-orchestrator.cap.js';
 export { AgentLoadSummarySchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusSchema, CapabilityBindingsSchema, GlobalMetricsSchema, IngestOwnerSchema, PipelineAssignmentSchema, pipelineOrchestratorCapability, } from './pipeline-orchestrator.cap.js';
-export type { DetailParent, DetailResult, MotionSource, MotionSources, ReportMotionInput, RunDetailSubtreeInput, RunDetailSubtreeResult, RunnerFrameSource, RunnerInferenceDevice, } from './pipeline-runner.cap.js';
+export type { DetailParent, DetailResult, MotionSource, MotionSources, ReportMotionInput, RunDetailSubtreeInput, RunDetailSubtreeResult, RunnerFrameSource, RunnerInferenceDevice, RunStatelessStepInput, RunStatelessStepResult, StatelessStepRefusal, } from './pipeline-runner.cap.js';
 export { MotionSourceEnum, MotionSourcesSchema, NativeCropBboxSchema, NativeCropResultSchema, pipelineRunnerCapability, ReportMotionInputSchema, RunnerCameraConfigSchema, RunnerCameraDeviceUIFields, RunnerFrameSourceSchema, RunnerInferenceDeviceSchema, RunnerLocalLoadSchema, RunnerLocalMetricsSchema, } from './pipeline-runner.cap.js';
 export { AudioChunkInputSchema, AudioClassificationLabelSchema, AudioLevelSchema, BoundingBoxSchema, FrameInputSchema, SpatialDetectionSchema, } from './schemas/detection-shared.js';
 export { CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, OrchestratorMetricsSchema, } from './schemas/orchestrator-metrics.js';

package/dist/capabilities/notification-rules.cap.d.ts

@@ -334,6 +334,7 @@ export declare const NcConditionsSchema: z.ZodObject<{
     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
     source: z.ZodOptional<z.ZodEnum<{
         sensor: "sensor";
+        audio: "audio";
         any: "any";
         pipeline: "pipeline";
         onboard: "onboard";
@@ -500,6 +501,7 @@ export declare const NcRuleInputSchema: z.ZodObject<{
         minDwellSeconds: z.ZodOptional<z.ZodNumber>;
         source: z.ZodOptional<z.ZodEnum<{
             sensor: "sensor";
+            audio: "audio";
             any: "any";
             pipeline: "pipeline";
             onboard: "onboard";
@@ -679,6 +681,7 @@ export declare const NcRulePatchSchema: z.ZodObject<{
         minDwellSeconds: z.ZodOptional<z.ZodNumber>;
         source: z.ZodOptional<z.ZodEnum<{
             sensor: "sensor";
+            audio: "audio";
             any: "any";
             pipeline: "pipeline";
             onboard: "onboard";
@@ -851,6 +854,7 @@ export declare const NcRuleSchema: z.ZodObject<{
         minDwellSeconds: z.ZodOptional<z.ZodNumber>;
         source: z.ZodOptional<z.ZodEnum<{
             sensor: "sensor";
+            audio: "audio";
             any: "any";
             pipeline: "pipeline";
             onboard: "onboard";
@@ -1343,6 +1347,7 @@ export declare const notificationRulesCapability: {
                     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
                     source: z.ZodOptional<z.ZodEnum<{
                         sensor: "sensor";
+                        audio: "audio";
                         any: "any";
                         pipeline: "pipeline";
                         onboard: "onboard";
@@ -1521,6 +1526,7 @@ export declare const notificationRulesCapability: {
                     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
                     source: z.ZodOptional<z.ZodEnum<{
                         sensor: "sensor";
+                        audio: "audio";
                         any: "any";
                         pipeline: "pipeline";
                         onboard: "onboard";
@@ -1697,6 +1703,7 @@ export declare const notificationRulesCapability: {
                     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
                     source: z.ZodOptional<z.ZodEnum<{
                         sensor: "sensor";
+                        audio: "audio";
                         any: "any";
                         pipeline: "pipeline";
                         onboard: "onboard";
@@ -1867,6 +1874,7 @@ export declare const notificationRulesCapability: {
                     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
                     source: z.ZodOptional<z.ZodEnum<{
                         sensor: "sensor";
+                        audio: "audio";
                         any: "any";
                         pipeline: "pipeline";
                         onboard: "onboard";
@@ -2046,6 +2054,7 @@ export declare const notificationRulesCapability: {
                     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
                     source: z.ZodOptional<z.ZodEnum<{
                         sensor: "sensor";
+                        audio: "audio";
                         any: "any";
                         pipeline: "pipeline";
                         onboard: "onboard";
@@ -2217,6 +2226,7 @@ export declare const notificationRulesCapability: {
                     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
                     source: z.ZodOptional<z.ZodEnum<{
                         sensor: "sensor";
+                        audio: "audio";
                         any: "any";
                         pipeline: "pipeline";
                         onboard: "onboard";
@@ -2363,6 +2373,36 @@ export declare const notificationRulesCapability: {
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodLiteral<true>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * PERMANENT per-camera mute — the notifications half of the per-camera
+         * function switch group ([D61](../../../../docs/decisions/adr-0067.md)).
+         *
+         * Deliberately NOT a snooze. A snooze is bounded at
+         * {@link NC_SNOOZE_MAX_MINUTES} on purpose — "a snooze that could not
+         * expire would be an outage the operator asked for once and forgot" — and
+         * widening it to express "this camera never notifies" would destroy that
+         * property for every snooze. A mute is the other thing: an explicit,
+         * indefinite, admin-only decision, visible in the switch group next to the
+         * other four, and reported on `CameraStatus.switchedOff` so a silent
+         * camera never reads as a working one.
+         *
+         * Returned as ONE list rather than a per-camera query: the group's reader
+         * needs every camera's state, and a per-camera fan-out over the viewer's
+         * single WebSocket is N frames serialised on one socket.
+         */
+        readonly listDeviceMutes: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
+            mutedDeviceIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Mute or unmute one camera. Idempotent; an unmute of a camera that was
+         * never muted succeeds.
+         */
+        readonly setDeviceMuted: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            muted: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            success: z.ZodLiteral<true>;
+        }, z.core.$strip>, "mutation">;
         /**
          * Dry-run a rule against recently persisted records (object events for
          * `immediate`, closed tracks for `track-end`). Mutation kind only to
@@ -2411,6 +2451,7 @@ export declare const notificationRulesCapability: {
                     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
                     source: z.ZodOptional<z.ZodEnum<{
                         sensor: "sensor";
+                        audio: "audio";
                         any: "any";
                         pipeline: "pipeline";
                         onboard: "onboard";

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

@@ -229,17 +229,48 @@ declare const TrackAudioLabelSchema: z.ZodObject<{
 export type TrackAudioLabel = z.infer<typeof TrackAudioLabelSchema>;
 /**
  * How a track was produced. `pipeline` (default / absent) = the spatial
- * detection+tracking pipeline. `sensor` = a SYNTHETIC track projected from a
- * linked sensor/control state change (no positions; carries a snapshot). The
- * spatial subsystems (tracker association, occupancy count, re-id/embedding,
- * resurrection) MUST skip `sensor` tracks — they have no bbox trajectory.
+ * detection+tracking pipeline. Every OTHER value is a SYNTHETIC projection —
+ * no positions, a single snapshot, and no bbox trajectory at all:
+ *
+ *  - `sensor` — a linked sensor/control device state change.
+ *  - `audio` — an audio event on the camera itself that was anomalous for
+ *    THAT camera, loud, and heard while nothing visual was happening (D62).
+ *
+ * The spatial subsystems (tracker association, occupancy count, re-id /
+ * embedding, resurrection) MUST skip every synthetic source. Test for that
+ * with `isSpatialTrack`, which allow-lists `pipeline` — a `!== 'sensor'`
+ * check silently readmits every source added after it was written.
  */
 export declare const TrackSourceSchema: z.ZodEnum<{
     sensor: "sensor";
+    audio: "audio";
     pipeline: "pipeline";
 }>;
 export type TrackSource = z.infer<typeof TrackSourceSchema>;
+/**
+ * The write half: a PARTIAL patch. An omitted key is left untouched, so setting
+ * one flag can never clear the other — the toggles are independent and are
+ * driven from three surfaces that do not know about each other.
+ */
+export declare const TrackFlagsPatchSchema: z.ZodObject<{
+    markForTrain: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TrackFlagsPatch = z.infer<typeof TrackFlagsPatchSchema>;
+/**
+ * The resolved flag state after a write. Both fields are REQUIRED here (absent
+ * collapses to `false`) so a caller can drive a toggle's checked state off the
+ * mutation result without a re-fetch.
+ */
+export declare const TrackFlagsSchema: z.ZodObject<{
+    trackId: z.ZodString;
+    markForTrain: z.ZodBoolean;
+    debug: z.ZodBoolean;
+}, z.core.$strip>;
+export type TrackFlags = z.infer<typeof TrackFlagsSchema>;
 declare const TrackSchema: z.ZodObject<{
+    markForTrain: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
     trackId: z.ZodString;
     deviceId: z.ZodNumber;
     className: z.ZodString;
@@ -247,6 +278,7 @@ declare const TrackSchema: z.ZodObject<{
     producingDeviceName: z.ZodOptional<z.ZodString>;
     source: z.ZodOptional<z.ZodEnum<{
         sensor: "sensor";
+        audio: "audio";
         pipeline: "pipeline";
     }>>;
     firstSeen: z.ZodNumber;
@@ -518,6 +550,8 @@ declare const RecentTracksQueryInput: z.ZodObject<{
 export type RecentTracksQuery = z.infer<typeof RecentTracksQueryInput>;
 declare const RecentTracksPageSchema: z.ZodObject<{
     tracks: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        markForTrain: z.ZodOptional<z.ZodBoolean>;
+        debug: z.ZodOptional<z.ZodBoolean>;
         trackId: z.ZodString;
         deviceId: z.ZodNumber;
         className: z.ZodString;
@@ -525,6 +559,7 @@ declare const RecentTracksPageSchema: z.ZodObject<{
         producingDeviceName: z.ZodOptional<z.ZodString>;
         source: z.ZodOptional<z.ZodEnum<{
             sensor: "sensor";
+            audio: "audio";
             pipeline: "pipeline";
         }>>;
         firstSeen: z.ZodNumber;
@@ -587,6 +622,8 @@ declare const RecentTracksPageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type RecentTracksPage = z.infer<typeof RecentTracksPageSchema>;
 declare const KeyEventSchema: z.ZodObject<{
+    markForTrain: z.ZodOptional<z.ZodBoolean>;
+    debug: z.ZodOptional<z.ZodBoolean>;
     id: z.ZodString;
     trackId: z.ZodString;
     timestamp: z.ZodNumber;
@@ -707,6 +744,8 @@ export declare const pipelineAnalyticsCapability: {
         readonly getActiveTracks: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            markForTrain: z.ZodOptional<z.ZodBoolean>;
+            debug: z.ZodOptional<z.ZodBoolean>;
             trackId: z.ZodString;
             deviceId: z.ZodNumber;
             className: z.ZodString;
@@ -714,6 +753,7 @@ export declare const pipelineAnalyticsCapability: {
             producingDeviceName: z.ZodOptional<z.ZodString>;
             source: z.ZodOptional<z.ZodEnum<{
                 sensor: "sensor";
+                audio: "audio";
                 pipeline: "pipeline";
             }>>;
             firstSeen: z.ZodNumber;
@@ -776,6 +816,8 @@ export declare const pipelineAnalyticsCapability: {
             deviceId: z.ZodNumber;
             trackId: z.ZodString;
         }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+            markForTrain: z.ZodOptional<z.ZodBoolean>;
+            debug: z.ZodOptional<z.ZodBoolean>;
             trackId: z.ZodString;
             deviceId: z.ZodNumber;
             className: z.ZodString;
@@ -783,6 +825,7 @@ export declare const pipelineAnalyticsCapability: {
             producingDeviceName: z.ZodOptional<z.ZodString>;
             source: z.ZodOptional<z.ZodEnum<{
                 sensor: "sensor";
+                audio: "audio";
                 pipeline: "pipeline";
             }>>;
             firstSeen: z.ZodNumber;
@@ -867,6 +910,8 @@ export declare const pipelineAnalyticsCapability: {
                 slim: "slim";
             }>>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            markForTrain: z.ZodOptional<z.ZodBoolean>;
+            debug: z.ZodOptional<z.ZodBoolean>;
             trackId: z.ZodString;
             deviceId: z.ZodNumber;
             className: z.ZodString;
@@ -874,6 +919,7 @@ export declare const pipelineAnalyticsCapability: {
             producingDeviceName: z.ZodOptional<z.ZodString>;
             source: z.ZodOptional<z.ZodEnum<{
                 sensor: "sensor";
+                audio: "audio";
                 pipeline: "pipeline";
             }>>;
             firstSeen: z.ZodNumber;
@@ -954,6 +1000,8 @@ export declare const pipelineAnalyticsCapability: {
             }>>;
         }, z.core.$strip>, z.ZodObject<{
             tracks: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                markForTrain: z.ZodOptional<z.ZodBoolean>;
+                debug: z.ZodOptional<z.ZodBoolean>;
                 trackId: z.ZodString;
                 deviceId: z.ZodNumber;
                 className: z.ZodString;
@@ -961,6 +1009,7 @@ export declare const pipelineAnalyticsCapability: {
                 producingDeviceName: z.ZodOptional<z.ZodString>;
                 source: z.ZodOptional<z.ZodEnum<{
                     sensor: "sensor";
+                    audio: "audio";
                     pipeline: "pipeline";
                 }>>;
                 firstSeen: z.ZodNumber;
@@ -1274,6 +1323,8 @@ export declare const pipelineAnalyticsCapability: {
             minImportance: z.ZodOptional<z.ZodNumber>;
             classFilter: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            markForTrain: z.ZodOptional<z.ZodBoolean>;
+            debug: z.ZodOptional<z.ZodBoolean>;
             id: z.ZodString;
             trackId: z.ZodString;
             timestamp: z.ZodNumber;
@@ -1370,6 +1421,37 @@ export declare const pipelineAnalyticsCapability: {
             deleted: z.ZodNumber;
             failed: z.ZodReadonly<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Set the per-track operator flags (`markForTrain`, `debug`) on ONE track.
+         * The patch is PARTIAL — an omitted key is left untouched — because the
+         * three surfaces that write it (admin Events grid, viewer track detail,
+         * viewer cluster detail) each own one toggle and must not clobber the other.
+         *
+         * Writes the track ROW: `markForTrain`/`debug` are per-TRACK state, so they
+         * live where `label` and `importance` live, not in any per-device settings
+         * store. Updates the in-RAM active track too, so a flag set on a live track
+         * survives its expiry-time persist.
+         *
+         * `auth: 'protected'` (the default), NOT `admin`: the viewer is an
+         * authenticated non-admin surface and two of the three call sites are
+         * there. Revisit if a flag ever gains an effect that costs storage —
+         * `deleteTracks` next door is admin for exactly that reason.
+         *
+         * Returns the RESOLVED state of both flags (absent → `false`) so a caller
+         * can drive its toggle without a re-fetch. Rejects an unknown track.
+         */
+        readonly setTrackFlags: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            trackId: z.ZodString;
+            flags: z.ZodObject<{
+                markForTrain: z.ZodOptional<z.ZodBoolean>;
+                debug: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            trackId: z.ZodString;
+            markForTrain: z.ZodBoolean;
+            debug: z.ZodBoolean;
+        }, z.core.$strip>, "mutation">;
         /**
          * Durable event-store footprint for the management UI: event rows
          * (motion + object + audio) counted per camera + total, plus the
@@ -1398,6 +1480,7 @@ export declare const pipelineAnalyticsCapability: {
                 operator: "operator";
                 retention: "retention";
                 quota: "quota";
+                maintenance: "maintenance";
             }>>;
         }, z.core.$strip>, z.ZodObject<{
             motion: z.ZodNumber;
@@ -1471,12 +1554,14 @@ export declare const pipelineAnalyticsCapability: {
                 rescan: "rescan";
                 "retention-run": "retention-run";
                 relocate: "relocate";
+                "orphan-audit": "orphan-audit";
             }>;
             reason: z.ZodEnum<{
                 manual: "manual";
                 operator: "operator";
                 retention: "retention";
                 quota: "quota";
+                maintenance: "maintenance";
             }>;
             deviceId: z.ZodNullable<z.ZodNumber>;
             nodeId: z.ZodString;
@@ -1664,9 +1749,9 @@ export declare const pipelineAnalyticsCapability: {
             deviceId: z.ZodOptional<z.ZodNumber>;
             since: z.ZodOptional<z.ZodNumber>;
             until: z.ZodOptional<z.ZodNumber>;
-            cropMargin: z.ZodOptional<z.ZodNumber>;
-            square: z.ZodOptional<z.ZodBoolean>;
             maxTracks: z.ZodOptional<z.ZodNumber>;
+            executeOnNodeId: z.ZodOptional<z.ZodString>;
+            pacingMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>, z.ZodObject<{
             started: z.ZodBoolean;
             alreadyRunning: z.ZodBoolean;
@@ -1677,6 +1762,8 @@ export declare const pipelineAnalyticsCapability: {
             rebuilt: z.ZodNumber;
             missingKeyFrame: z.ZodNumber;
             missingBbox: z.ZodNumber;
+            notRunnable: z.ZodNumber;
+            noCapableNode: z.ZodNumber;
             failed: z.ZodNumber;
             complete: z.ZodNullable<z.ZodBoolean>;
             startedAtMs: z.ZodNullable<z.ZodNumber>;

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

@@ -441,6 +441,13 @@ declare const CameraStatusSchema: z.ZodObject<{
         active: z.ZodBoolean;
         storageBytes: z.ZodNumber;
     }, z.core.$strip>>;
+    switchedOff: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        "audio-analysis": "audio-analysis";
+        recording: "recording";
+        "stream-broker": "stream-broker";
+        notifications: "notifications";
+        "object-detection": "object-detection";
+    }>>>;
     fetchedAt: z.ZodNumber;
 }, z.core.$strip>;
 declare const NodeInferenceDeviceSchema: z.ZodObject<{
@@ -1062,6 +1069,108 @@ export declare const pipelineOrchestratorCapability: {
                 settings: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * The whole per-camera function switch group, DERIVED — never a stored
+         * list ([D61](../../../../docs/decisions/adr-0067.md)).
+         *
+         * The group adds no state. Each switch is a view onto the authority that
+         * already owned it (`deviceManager.setDisabled`,
+         * `deviceManager.setWrapperActive`, `RecordingConfig.enabled`,
+         * `notificationRules.setDeviceMuted`), and `switch.authority` says which.
+         * Availability comes from `deviceManager.listBindableCapsForDeviceType`,
+         * so a deployment with no audio analyzer renders no audio switch.
+         *
+         * `auth: 'view'` deliberately — a NON-admin must be able to see that a
+         * camera is quiet because somebody switched it off. Only the mutation is
+         * admin-gated.
+         */
+        readonly getCameraSwitches: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            deviceId: z.ZodNumber;
+            switches: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodEnum<{
+                    "audio-analysis": "audio-analysis";
+                    recording: "recording";
+                    "stream-broker": "stream-broker";
+                    notifications: "notifications";
+                    "object-detection": "object-detection";
+                }>;
+                label: z.ZodString;
+                costWhenOff: z.ZodString;
+                available: z.ZodBoolean;
+                unavailableReason: z.ZodOptional<z.ZodEnum<{
+                    "no-provider": "no-provider";
+                    "source-unreachable": "source-unreachable";
+                }>>;
+                enabled: z.ZodBoolean;
+                authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"device-disabled">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"wrapper-binding">;
+                    capName: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"recording-config">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"notification-mute">;
+                }, z.core.$strip>], "kind">;
+            }, z.core.$strip>>>;
+            fetchedAt: z.ZodNumber;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Flip ONE switch, routed to its existing authority.
+         *
+         * Never writes a parallel map: `recording` patches `RecordingConfig.enabled`
+         * and leaves `bands` byte-identical (clearing bands to express "off"
+         * destroys the operator's authored schedule and turning the camera back on
+         * would silently record nothing), and the two pipeline switches write the
+         * SAME wrapper binding the legacy `pipelineEnabled` / `audioEnabled`
+         * booleans were migrated onto.
+         *
+         * Rejects a switch this camera does not offer rather than persisting a
+         * write nothing reads.
+         */
+        readonly setCameraSwitch: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            switchId: z.ZodEnum<{
+                "audio-analysis": "audio-analysis";
+                recording: "recording";
+                "stream-broker": "stream-broker";
+                notifications: "notifications";
+                "object-detection": "object-detection";
+            }>;
+            enabled: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodObject<{
+            deviceId: z.ZodNumber;
+            switches: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodEnum<{
+                    "audio-analysis": "audio-analysis";
+                    recording: "recording";
+                    "stream-broker": "stream-broker";
+                    notifications: "notifications";
+                    "object-detection": "object-detection";
+                }>;
+                label: z.ZodString;
+                costWhenOff: z.ZodString;
+                available: z.ZodBoolean;
+                unavailableReason: z.ZodOptional<z.ZodEnum<{
+                    "no-provider": "no-provider";
+                    "source-unreachable": "source-unreachable";
+                }>>;
+                enabled: z.ZodBoolean;
+                authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"device-disabled">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"wrapper-binding">;
+                    capName: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"recording-config">;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"notification-mute">;
+                }, z.core.$strip>], "kind">;
+            }, z.core.$strip>>>;
+            fetchedAt: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
         /**
          * Server-composed aggregated status for a single camera.
          *
@@ -1171,6 +1280,13 @@ export declare const pipelineOrchestratorCapability: {
                 active: z.ZodBoolean;
                 storageBytes: z.ZodNumber;
             }, z.core.$strip>>;
+            switchedOff: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                "audio-analysis": "audio-analysis";
+                recording: "recording";
+                "stream-broker": "stream-broker";
+                notifications: "notifications";
+                "object-detection": "object-detection";
+            }>>>;
             fetchedAt: z.ZodNumber;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
@@ -1281,6 +1397,13 @@ export declare const pipelineOrchestratorCapability: {
                 active: z.ZodBoolean;
                 storageBytes: z.ZodNumber;
             }, z.core.$strip>>;
+            switchedOff: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                "audio-analysis": "audio-analysis";
+                recording: "recording";
+                "stream-broker": "stream-broker";
+                notifications: "notifications";
+                "object-detection": "object-detection";
+            }>>>;
             fetchedAt: z.ZodNumber;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** List every template the operator has saved. */