@camstack/types 1.2.261 → 1.2.263

package/dist/index.d.ts

@@ -241,6 +241,7 @@ export { NC_SERVER_PACKAGE_NAME, NC_UPDATE_EVENT_PACKAGE_NAMES, type NcInstalled
 export type { TimelapseCadencePair, TimelapsePreviewMode, TimelapseRule, TimelapseRuleInput, TimelapseRulePatch, TimelapseTemplate, } from './notification/timelapse-rule.js';
 export { assertTimelapseCadences, DEFAULT_TIMELAPSE_PREVIEW_TEXT, readTimelapseGeneratedAt, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleInputSchema, TimelapseRulePatchSchema, TimelapseRuleSchema, TimelapseTemplateSchema, } from './notification/timelapse-rule.js';
 export { CLUSTER_MODEL_SCOPED_STEPS, CLUSTER_MODEL_SECTION_ID, CLUSTER_STEP_SETTING_FIELDS, type ClusterModelScopedStep, type ClusterStepModels, type ClusterStepSettingField, type ClusterStepSettings, clusterModelSettingKey, clusterStepSettingFieldsFor, clusterStepSettingKey, DEFAULT_CLUSTER_STEP_MODELS, DEFAULT_CLUSTER_STEP_SETTINGS, DEFAULT_MIN_LANDMARK_FACE_SIZE_PX, type HydratedClusterSection, type HydratedClusterView, interpretStoredClusterModel, type InvalidClusterStepModelEntry, invalidClusterStepModelEntries, isClusterScopedStep, overlayClusterStepSettings, pickClusterStepModels, pickClusterStepSettings, pickInvalidClusterStepModels, readClusterStepModels, readClusterStepSettings, resolveClusterStepModelId, type StepModelScope, type StoredClusterModelInterpretation, } from './pipeline/cluster-model-scope.js';
+export { type FormatRunnableModel, stepModelRunsOnFormat, } from './pipeline/step-format-runnable.js';
 export { DEFAULT_DETAIL_CROP_CONVENTION, DETAIL_CROP_PADDING_FIELD, DETAIL_CROP_PADDING_KEY, DETAIL_CROP_SECTION_ID, DETAIL_CROP_SQUARE_KEY, type DetailCropConvention, DetailCropConventionSchema, type DetailCropRect, deriveDetailCropRect, FULL_IMAGE_BBOX, type HydratedSettingsSection, type HydratedSettingsView, pickDetailCropConvention, readDetailCropConvention, } from './pipeline/detail-crop.js';
 export { DEFAULT_NATIVE_LEASE_SETTINGS, NATIVE_LEASE_ACTIVITY_FIELD, NATIVE_LEASE_ACTIVITY_KEY, NATIVE_LEASE_ADMISSION_FIELD, NATIVE_LEASE_ADMISSION_KEY, NATIVE_LEASE_BUDGET_FIELD, NATIVE_LEASE_BUDGET_KEY, NATIVE_LEASE_HOLD_FIELD, NATIVE_LEASE_HOLD_KEY, NATIVE_LEASE_SCENE_BUDGET_FIELD, NATIVE_LEASE_SCENE_BUDGET_KEY, NATIVE_LEASE_SECTION_ID, NATIVE_LEASE_TILE_BUDGET_FIELD, NATIVE_LEASE_TILE_BUDGET_KEY, type NativeLeaseAdmission, NativeLeaseAdmissionSchema, type NativeLeaseKnob, type NativeLeaseNumberKnob, type NativeLeaseSettings, type NativeLeaseSettingsOverride, NativeLeaseSettingsSchema, pickNativeLeaseOverride, readNativeLeaseOverride, } from './pipeline/native-lease.js';
 export { ACCESS_ROLES, type AccessRoleAssignment, type AccessRoleId, type AccessRoleSpec, buildRoleScopes, detectAccessRole, roleSpec, } from './schemas/access-roles.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-QxyLiUId.js");
+const require_sleep = require("./sleep-8K9gue-H.js");
 const require_event_category = require("./event-category-BVfsrBYA.js");
 const require_canonical_hash = require("./canonical-hash-CSE4ioRi.js");
 const require_enums = require("./enums.js");
@@ -7567,14 +7567,44 @@ var AudioClassificationLabelSchema = zod.z.object({
 	originalClass: zod.z.string().optional(),
 	score: zod.z.number()
 });
+/**
+* Why an audio window reached no classifier (D660). `superseded` is the ONLY
+* contention drop the analyzer makes: a camera's pending window replaced by
+* its own newer one while the single pipeline served other cameras. `error`
+* is an inference (or pipeline spawn) that failed, including a backend that
+* exited or was disposed mid-inference; `timeout` is an inference that did not
+* answer within the analyzer's bound (the backend is then killed and
+* respawned); `disposed` is a window still queued when the analyzer shut down.
+*/
+var AUDIO_NOT_CLASSIFIED_REASONS = [
+	"superseded",
+	"error",
+	"timeout",
+	"disposed"
+];
+/**
+* Did the classifier RUN on this window? (D660)
+*
+* `classified` with no labels means the model heard nothing above the
+* camera's floor. `not-classified` means nobody listened — and until D660 the
+* two were the same shape (`classification` absent), so a window the global
+* busy gate threw away read downstream exactly like a quiet one (D393).
+*/
+var AudioClassifyOutcomeSchema = zod.z.discriminatedUnion("state", [zod.z.object({ state: zod.z.literal("classified") }), zod.z.object({
+	state: zod.z.literal("not-classified"),
+	reason: zod.z.enum(AUDIO_NOT_CLASSIFIED_REASONS)
+})]);
 //#endregion
 //#region src/capabilities/audio-analyzer.cap.ts
 var AudioAnalysisResultSchema = zod.z.object({
 	level: AudioLevelSchema,
+	/** Labels at or above the camera's floor. Absent = none — read `classifyOutcome` to know whether the model ran at all. */
 	classification: zod.z.object({
 		labels: zod.z.array(AudioClassificationLabelSchema).readonly(),
 		inferenceMs: zod.z.number()
 	}).optional(),
+	/** Whether the classifier ran on this window (D660). */
+	classifyOutcome: AudioClassifyOutcomeSchema,
 	timestamp: zod.z.number()
 });
 var AudioAnalysisSettingsSchema = zod.z.object({
@@ -12510,8 +12540,22 @@ var LinkedDeviceSchema = zod.z.object({
 * The `linked-devices` extension slot's editable value (D648): the operator's
 * pick list, exactly what `_linkedDeviceIds` persists. Tree children are NOT
 * in it — they are always linked and are not a pick.
+*
+* `trackedDeviceIds` (D655) is the tracked-event opt-in, exactly what
+* `_linkedDeviceTrackedIds` persists: which linked devices materialize a
+* synthetic tracked event on the camera. A read always carries it AS STORED
+* (an absent key reads as `[]`, which is what the resolver makes of it —
+* NONE). On a write it is optional: absent leaves the opt-in untouched, so a
+* card built before D655 cannot erase it by saving the pick list. A present
+* list REPLACES the opt-in; each id must be a pick, a device the camera links
+* by structure (the row's `impliedSources`: tree children, a picked
+* container's child) or already stored — so what was read can always be
+* written back unchanged, and a NEW opt-in outside the linked set is refused.
 */
-var LinkedDevicesSlotValueSchema = zod.z.object({ deviceIds: zod.z.array(zod.z.number().int().positive()) });
+var LinkedDevicesSlotValueSchema = zod.z.object({
+	deviceIds: zod.z.array(zod.z.number().int().positive()),
+	trackedDeviceIds: zod.z.array(zod.z.number().int().positive()).optional()
+});
 /**
 * The `linked-devices` slot — a camera's companion devices, owned by the
 * device manager over `_linkedDeviceIds` (D648, D356). Any device may be a
@@ -12678,7 +12722,6 @@ var deviceManagerCapability = {
 	scope: "system",
 	mode: "singleton",
 	extensionSlots: [LINKED_DEVICES_SLOT],
-	exposesDeviceSettings: true,
 	methods: {
 		/** Reserve (or re-resolve) a progressive numeric id for `(addonId, stableId)`.
 		*  Idempotent: returns the existing id if one is already persisted for the
@@ -13185,8 +13228,8 @@ var deviceManagerCapability = {
 		* operator's persisted pick list (`mode` is always `manual` since D356:
 		* same-location devices are suggested by the picker, never linked on
 		* their own). Excludes the camera itself; deduped. The list is written by
-		* the settings section or the `linked-devices` extension slot, both over
-		* `_linkedDeviceIds` (see the module docblock).
+		* the `linked-devices` extension slot over `_linkedDeviceIds` (see the
+		* module docblock).
 		*/
 		getLinkedDevices: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.object({
 			mode: LinkedDevicesModeSchema,
@@ -17743,7 +17786,7 @@ var NcOccupancyConditionSchema = zod.z.object({
 });
 /**
 * The dBFS floor the analyzer reports on digital silence
-* (`audio-analyzer-provider.ts`: `dbfs = rms > 0 ? 20*log10(rms) : -96`).
+* (`AudioAnalyzerProvider.analyseChunk`: `dbfs = rms > 0 ? 20*log10(rms) : -96`).
 *
 * It is the lower bound of {@link NcAudioConditionSchema.shape.dbThreshold} for
 * one reason worth stating out loud: **the scale is dBFS and it is
@@ -21610,6 +21653,13 @@ var AudioEventSchema = zod.z.object({
 		originalClass: zod.z.string().optional(),
 		score: zod.z.number()
 	}).optional(),
+	/**
+	* Whether the classifier RAN on the window behind this row (D660). Absent
+	* on rows written before D660 — unknown, NOT classified: until then a
+	* window the analyzer's busy gate threw away was stored exactly like one
+	* that heard nothing above the floor.
+	*/
+	classifyOutcome: AudioClassifyOutcomeSchema.optional(),
 	/** Populated by B5 (recording playback URL for this event). */
 	mediaUrl: zod.z.string().optional()
 });
@@ -24081,7 +24131,14 @@ var pipelineExecutorCapability = {
 		*/
 		inferCached: require_sleep.method(zod.z.object({
 			stepId: zod.z.string(),
-			frameId: zod.z.number().int()
+			frameId: zod.z.number().int(),
+			/**
+			* The model to time — REQUIRED (D658). Without it the pool answered the
+			* step's ACTIVE variant (the first loaded after boot), so a benchmark
+			* of model B silently timed model A. Callers pass the `rootModelId`
+			* their warmup `runPipeline` reported: the model that actually ran.
+			*/
+			modelId: zod.z.string().min(1)
 		}), zod.z.record(zod.z.string(), zod.z.unknown()), { kind: "mutation" }),
 		/**
 		* Release a cached frame from the Python pool's memory.
@@ -30188,7 +30245,6 @@ var doorbellCapability = {
 	kind: "wrapper",
 	defaultActive: false,
 	deviceTypes: [require_sleep.DeviceType.Button, require_sleep.DeviceType.Camera],
-	exposesDeviceSettings: true,
 	extensionSlots: [DOORBELL_SOURCE_SLOT],
 	methods: {},
 	events: { 
@@ -30348,7 +30404,17 @@ var ExtensionSlotStateSchema = zod.z.object({
 	projects: zod.z.string().nullable(),
 	activation: ExtensionSlotActivationSchema.nullable(),
 	value: ExtensionSlotValueSchema,
-	sources: zod.z.array(ExtensionSlotSourceSchema)
+	sources: zod.z.array(ExtensionSlotSourceSchema),
+	/**
+	* Devices the owner links to the host ON ITS OWN, by structure, and that
+	* are therefore not in `value` (D655): a camera's device-tree children, and
+	* the child a picked container stands for (D356 — a container is never a
+	* pick, its children are). Read-only; the editor shows them and may offer
+	* per-device options on them (the linked-devices tracked-event opt-in).
+	* Absent when the owner links nothing beyond the picks, and from an owner
+	* older than D655.
+	*/
+	impliedSources: zod.z.array(ExtensionSlotSourceSchema).optional()
 });
 /**
 * A provider that could not answer `listSlots` at all. It could not name its
@@ -44570,7 +44636,8 @@ function createDeviceExtensionProvider(options) {
 					projects: EXTENSION_SLOTS[slot.slot].descriptor.projects ?? null,
 					activation: listing.activation,
 					value: listing.value,
-					sources: [...listing.sources]
+					sources: [...listing.sources],
+					...listing.impliedSources !== void 0 ? { impliedSources: [...listing.impliedSources] } : {}
 				});
 			}
 			return rows;
@@ -52174,12 +52241,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"deviceManager.applyDeviceSettingsPatch": {
-		capName: "device-manager",
-		capScope: "system",
-		addonId: null,
-		access: "create"
-	},
 	"deviceManager.applyInitialMeta": {
 		capName: "device-manager",
 		capScope: "system",
@@ -52282,12 +52343,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"deviceManager.getDeviceLiveContribution": {
-		capName: "device-manager",
-		capScope: "system",
-		addonId: null,
-		access: "view"
-	},
 	"deviceManager.getDeviceLiveInfoAggregate": {
 		capName: "device-manager",
 		capScope: "system",
@@ -52300,12 +52355,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"deviceManager.getDeviceSettingsContribution": {
-		capName: "device-manager",
-		capScope: "system",
-		addonId: null,
-		access: "view"
-	},
 	"deviceManager.getDeviceStatusAggregate": {
 		capName: "device-manager",
 		capScope: "system",
@@ -52810,24 +52859,6 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"doorbell.applyDeviceSettingsPatch": {
-		capName: "doorbell",
-		capScope: "device",
-		addonId: null,
-		access: "create"
-	},
-	"doorbell.getDeviceLiveContribution": {
-		capName: "doorbell",
-		capScope: "device",
-		addonId: null,
-		access: "view"
-	},
-	"doorbell.getDeviceSettingsContribution": {
-		capName: "doorbell",
-		capScope: "device",
-		addonId: null,
-		access: "view"
-	},
 	"doorbell.getStatus": {
 		capName: "doorbell",
 		capScope: "device",
@@ -64552,6 +64583,23 @@ function readTimelapseGeneratedAt(rule, deviceId) {
 	return rule.lastGeneratedAt ?? 0;
 }
 //#endregion
+//#region src/pipeline/step-format-runnable.ts
+/** True when `model` ships a build for `format`. */
+function hasBuild(model, format) {
+	return Boolean(model.formats[format]);
+}
+/**
+* Can a pool of `format` run a step whose catalog is `models`, given the model
+* the step names (`null`/absent = unpinned, the format default)?
+*/
+function stepModelRunsOnFormat(models, modelId, format) {
+	if (modelId !== void 0 && modelId !== null) {
+		const named = models.find((m) => m.id === modelId);
+		if (named !== void 0 && hasBuild(named, format)) return true;
+	}
+	return models.some((m) => m.legacy !== true && hasBuild(m, format));
+}
+//#endregion
 //#region src/pipeline/detail-crop.ts
 /**
 * THE detail-crop convention — the single derivation of the rectangle a
@@ -66988,6 +67036,7 @@ exports.AUDIO_ANALYSIS_CAP_NAME = AUDIO_ANALYSIS_CAP_NAME;
 exports.AUDIO_BACKEND_CHOICES = AUDIO_BACKEND_CHOICES;
 exports.AUDIO_CHUNK_FORMATS = require_sleep.AUDIO_CHUNK_FORMATS;
 exports.AUDIO_MACRO_LABELS = AUDIO_MACRO_LABELS;
+exports.AUDIO_NOT_CLASSIFIED_REASONS = AUDIO_NOT_CLASSIFIED_REASONS;
 exports.AUDIO_PRESETS = require_canonical_hash.AUDIO_PRESETS;
 exports.AUDIO_SCALE_EPOCH_ISO = AUDIO_SCALE_EPOCH_ISO;
 exports.AUDIO_SCALE_EPOCH_MS = AUDIO_SCALE_EPOCH_MS;
@@ -67041,6 +67090,7 @@ exports.AudioChunkInputSchema = AudioChunkInputSchema;
 exports.AudioClassSummarySchema = AudioClassSummarySchema;
 exports.AudioClassificationLabelSchema = AudioClassificationLabelSchema;
 exports.AudioClassificationResultSchema = AudioClassificationResultSchema;
+exports.AudioClassifyOutcomeSchema = AudioClassifyOutcomeSchema;
 exports.AudioCodecInfoSchema = AudioCodecInfoSchema;
 exports.AudioDecodeSessionConfigSchema = AudioDecodeSessionConfigSchema;
 exports.AudioDetachDeviceResultSchema = AudioDetachDeviceResultSchema;
@@ -68742,6 +68792,7 @@ exports.snapshotCapability = snapshotCapability;
 exports.ssoBridgeCapability = ssoBridgeCapability;
 exports.startReachabilityPoll = startReachabilityPoll;
 exports.stateVocabularyFor = stateVocabularyFor;
+exports.stepModelRunsOnFormat = stepModelRunsOnFormat;
 exports.storageCapability = storageCapability;
 exports.storageEvictableCapability = storageEvictableCapability;
 exports.storageMigrationCapability = storageMigrationCapability;