@camstack/types 1.2.278 → 1.2.280

package/dist/index.js

@@ -4990,6 +4990,44 @@ function pickClosestResolution(entries, target) {
 	}])].sort((a, b) => compareToTarget(a.pixels, b.pixels, targetPixels))[0]?.entry;
 }
 //#endregion
+//#region src/types/appearance.ts
+/**
+* A model-free appearance descriptor of one detection box (D683 §8).
+*
+* Computed on the runner from the analysis raster the frame already leased
+* (`pipeline-runner/appearance-descriptor.ts`), carried on `ObjectDetection`
+* and mirrored onto the tracker's `SpatialDetection`. A vector about a box,
+* never pixels (D9/D18). No learned weights, so no licence question (O6).
+*
+* Layout: the box shrunk 10 % per side, split into an upper and a lower half;
+* per half a hue–saturation histogram (8 hue × 4 saturation), a value histogram
+* (8) and a magnitude-weighted gradient-orientation histogram (8). Each block
+* is L1-normalised and quantised to integers 0–255. About 300 bytes of JSON.
+*/
+var APPEARANCE_DESCRIPTOR_VERSION = 1;
+var APPEARANCE_BIN_COUNT = 96;
+var APPEARANCE_BLOCKS = {
+	upperHs: [0, 32],
+	upperV: [32, 40],
+	upperGrad: [40, 48],
+	lowerHs: [48, 80],
+	lowerV: [80, 88],
+	lowerGrad: [88, 96]
+};
+/**
+* Whether appearance may influence anything at all (D683 §3.2, fix round 1
+* ruling 2026-09-30 on the Task 10 cost-bench STOP): OFF until the
+* descriptor is calibrated on tapes that carry it (Task 23, review M9).
+*
+* This is the ONE authority both addons read — never two settings that
+* could disagree (CLAUDE.md D62). The tracker's `TrackerV2Config.appearanceResolvesAmbiguity`
+* default reads it (`addon-post-analysis/pipeline/tracker-v2/types.ts`); the
+* runner's cost gate reads it too (`addon-pipeline/pipeline-runner/appearance-attach.ts`),
+* short-circuiting BEFORE any crop, resample or descriptor is computed, so a
+* disabled camera costs nothing extra per frame.
+*/
+var APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT = false;
+//#endregion
 //#region src/types/overlay-layer.ts
 var OVERLAY_LAYERS = [
 	"motion",
@@ -19012,8 +19050,14 @@ var NcSensorTransitionSchema = zod.z.enum(["raised", "cleared"]);
 /** Admin-zone membership condition (zone IDs as stamped by the ZoneEngine). */
 var NcZoneConditionSchema = zod.z.object({
 	ids: zod.z.array(zod.z.string().min(1)).min(1),
-	/** Quantifier over `ids` — at least one / every one visited. */
-	match: zod.z.enum(["any", "all"]).default("any")
+	/**
+	* LEGACY quantifier over `ids`. Absent = `any` (at least one visited), which
+	* is what both editors mean and all they write since D690: "all of" was
+	* removed from the editors because on an immediate rule it asked one
+	* detection to stand in every zone at once. Still ACCEPTED, and `all` still
+	* evaluated, so a stored rule keeps parsing and meaning what it meant.
+	*/
+	match: zod.z.enum(["any", "all"]).optional()
 });
 /**
 * The P1 condition set — a flat AND of groups; absent group = pass;
@@ -20340,7 +20384,7 @@ var NC_CONDITION_CATALOG = [
 			"package-event"
 		],
 		phase: "P1",
-		description: "Admin zone ids; quantifier any/all over the visited set."
+		description: "The zones the subject must be in (included) or never in (excluded)."
 	},
 	{
 		id: "zonesExclude",
@@ -20363,29 +20407,24 @@ var NC_CONDITION_CATALOG = [
 		options: [
 			{
 				value: "",
-				label: "Not set — entering",
-				hint: "Entries, and every detection that is not a crossing at all. Exits are excluded. This is what a rule without a crossing condition already does, and choosing it writes nothing to the rule."
-			},
-			{
-				value: "enter",
-				label: "Entered a zone",
-				hint: "The same matches as \"not set\", stated explicitly: entries and non-crossing detections pass, exits do not."
+				label: "Entering",
+				hint: "Entries and ordinary movement; never an exit."
 			},
 			{
 				value: "exit",
-				label: "Left a zone",
-				hint: "ONLY an exit crossing. A detection that is not a crossing fails, so this rule cannot fire on ordinary movement — pair it with the zones the subject must have left. Also matches a tripwire crossed against its drawn direction."
+				label: "Leaving",
+				hint: "Only an exit from a zone."
 			},
 			{
 				value: "any",
-				label: "Entered or left",
-				hint: "No direction filter: entries, exits and non-crossing detections alike. This is the only choice that adds exits to what the rule already matched."
+				label: "Entering or leaving",
+				hint: "Entries, exits and ordinary movement."
 			}
 		],
 		operator: "in",
 		appliesTo: ["immediate"],
 		phase: "P1",
-		description: "Direction of the zone crossing: enter (the default, and what every rule authored before this did) / exit / any. An exit rule matches only crossings."
+		description: "Which way the subject crosses the zone."
 	},
 	{
 		id: "labelEquals",
@@ -20522,7 +20561,7 @@ var NC_CONDITION_CATALOG = [
 			"package-event"
 		],
 		phase: "P3",
-		description: "Only fire while a scene is matched (the baseline is what we see) or diverged (it demonstrably is not) — “tell me about a person at the door, but only while the bin is still out”. A scene that cannot judge, or one this hub has not read yet, does NOT fire."
+		description: "Only fire while a scene is matched or diverged."
 	},
 	{
 		id: "sensorKinds",
@@ -24017,13 +24056,19 @@ var pipelineAnalyticsCapability = {
 		*
 		* Operator-driven from the DI Events page (batch delete). Routes through
 		* the same widened track-deletion cascade (design §5.2).
+		*
+		* `sparedMediaIds` (D683 Task 14): media rows the cascade LEFT because a
+		* live stationary entry vouches for them (its key frame, owned by a track
+		* that moved and was kept). Released when the entry retires. Optional:
+		* absent from a provider that predates it.
 		*/
 		deleteTracks: require_sleep.method(zod.z.object({
 			deviceId: zod.z.number(),
 			trackIds: zod.z.array(zod.z.string()).min(1)
 		}), zod.z.object({
 			deleted: zod.z.number().int(),
-			failed: zod.z.array(zod.z.string()).readonly()
+			failed: zod.z.array(zod.z.string()).readonly(),
+			sparedMediaIds: zod.z.array(zod.z.number().int()).readonly().optional()
 		}), {
 			kind: "mutation",
 			auth: "admin"
@@ -27368,6 +27413,42 @@ var SetCameraSensorsInputSchema = zod.z.object({
 	/** `null` removes the attachment: the camera goes back to `not-configured`. */
 	config: CameraSensorsConfigSchema.nullable()
 });
+/**
+* Why an early occupancy look (D691) was not scheduled.
+*
+* - `unknown-camera` — no session was ever dispatched for it, so there is no
+*   node and no config to attach a burst with.
+* - `out-of-range` — the ask is negative or further out than the orchestrator
+*   will hold a timer for; the parked-object cadence is the answer there.
+* - `no-burst-producer` — this build has no burst producer at all.
+* - `already-looked` — this camera's ONE early look since its last session has
+*   been spent. A look's own burst can re-arm a flickering flip, and a look
+*   per arm would chain a burst every ~30 s forever (review H2); the next
+*   real session re-arms the budget.
+*/
+var OccupancyLookRefusalSchema = zod.z.enum([
+	"unknown-camera",
+	"out-of-range",
+	"no-burst-producer",
+	"already-looked"
+]);
+/** The input of `requestOccupancyLook` (D691). */
+var OccupancyLookRequestSchema = zod.z.object({
+	deviceId: zod.z.number().int().nonnegative(),
+	/** How long from NOW until the pending flip's sustain window ends. RELATIVE,
+	*  so the caller's clock and the orchestrator's never have to agree. */
+	afterMs: zod.z.number().finite(),
+	/** Why, for the log. */
+	reason: zod.z.string()
+});
+/** The answer of `requestOccupancyLook` (D691). */
+var OccupancyLookAnswerSchema = zod.z.object({
+	scheduled: zod.z.boolean(),
+	/** When `scheduled`: how long until the burst is dialled. */
+	dueInMs: zod.z.number().optional(),
+	/** When not `scheduled`: why. */
+	refusedBecause: OccupancyLookRefusalSchema.optional()
+});
 var pipelineOrchestratorCapability = {
 	name: "pipeline-orchestrator",
 	scope: "system",
@@ -27375,6 +27456,19 @@ var pipelineOrchestratorCapability = {
 	nodeIdMode: "data",
 	exposesDeviceSettings: true,
 	methods: {
+		/**
+		* D691 — an occupancy flip is pending on this camera and can commit
+		* `afterMs` from now: dial ONE occupancy burst at the end of its sustain
+		* window instead of leaving the commit to the 300 s parked-object cadence.
+		* Called by the notification centre, the only component that knows a flip
+		* is pending; the dial is the recheck's own (attach on the last session
+		* node, `requestOccupancyBurst`, detach). One pending look per camera; a
+		* session open at the due time is the look, and no burst is dialled.
+		*/
+		requestOccupancyLook: require_sleep.method(OccupancyLookRequestSchema, OccupancyLookAnswerSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Internal storage-migration participant lease. While held, dispatch
 		* requests are accepted as pending but no new runner attachment starts. */
 		pauseForStorageMigration: require_sleep.method(StorageMigrationLeaseInputSchema, zod.z.object({ paused: zod.z.literal(true) }), {
@@ -57256,6 +57350,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"pipelineOrchestrator.requestOccupancyLook": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineOrchestrator.resetNodePipelineDefaults": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -61383,6 +61483,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineOrchestrator.requestOccupancyLook": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineOrchestrator.resolvePipeline": [{
 		name: "deviceId",
 		form: "single",
@@ -62218,6 +62323,7 @@ var SYSTEM_SCOPE_DEVICE_METHODS = [
 	"pipelineOrchestrator.getCameraSwitches",
 	"pipelineOrchestrator.getPipelineAssignment",
 	"pipelineOrchestrator.getPipelineDevicePin",
+	"pipelineOrchestrator.requestOccupancyLook",
 	"pipelineOrchestrator.resolvePipeline",
 	"pipelineOrchestrator.setCameraPipelineForAgent",
 	"pipelineOrchestrator.setCameraSensors",
@@ -63181,6 +63287,7 @@ function createSystemProxy(api) {
 			getDetectionConfigSchema: (input) => dispatch("pipelineExecutor", "getDetectionConfigSchema", "query", input)
 		},
 		pipelineOrchestrator: {
+			requestOccupancyLook: (input) => dispatch("pipelineOrchestrator", "requestOccupancyLook", "mutation", input),
 			pauseForStorageMigration: (input) => dispatch("pipelineOrchestrator", "pauseForStorageMigration", "mutation", input),
 			resumeForStorageMigration: (input) => dispatch("pipelineOrchestrator", "resumeForStorageMigration", "mutation", input),
 			rebalance: (input) => dispatch("pipelineOrchestrator", "rebalance", "mutation", input),
@@ -63939,6 +64046,27 @@ function pickerForCondition(conditionId, taxonomy) {
 	}
 	return null;
 }
+/** The taxonomy group the class picker appends the audio kinds under. */
+var AUDIO_GROUP_KEY = "audio";
+/**
+* The class picker a RULE's class scope uses: {@link pickerForCondition}'s
+* `classes` vocabulary WITHOUT the audio group (R13, D690).
+*
+* A detection rule that picked a sound there became the legacy one-sample audio
+* rule and broke itself; sounds are authored on a Sound rule
+* (`conditions.audio`). The plain `classes` picker keeps the audio group for
+* the surfaces where a sound IS a class — a snooze, a report, the simulator.
+*/
+function pickerForRuleClasses(taxonomy) {
+	const picker = pickerForCondition("classes", taxonomy);
+	if (picker === null) return null;
+	const groups = picker.groups.filter((group) => group.key !== AUDIO_GROUP_KEY);
+	return groups.length > 0 ? { groups } : null;
+}
+/** An audio kind (`audio-*`) — the one prefix every sound class carries. */
+function isAudioClassName(name) {
+	return name.trim().toLowerCase().startsWith(`${AUDIO_GROUP_KEY}-`);
+}
 /** All option values across a picker's groups (for custom-value detection). */
 function knownValues(picker) {
 	const set = /* @__PURE__ */ new Set();
@@ -64524,7 +64652,7 @@ var NC_RULE_KIND_SPECS = [
 	{
 		kind: "detection",
 		label: "Conditions",
-		excluded: {},
+		excluded: { audio: "A detection rule fires on what the camera SAW. Sounds are a Sound rule of their own — adding one here turned the rule into a sound rule and dropped every detection condition." },
 		editable: true,
 		carriesMedia: true,
 		carriesSubjectCrop: true
@@ -64532,7 +64660,7 @@ var NC_RULE_KIND_SPECS = [
 	{
 		kind: "sensor",
 		label: "Conditions",
-		/** Same argument as `detection`: `occupancy` converts, it does not confuse. */
+		/** `occupancy` is still offered here: authoring it converts a sensor rule into an occupancy rule. */
 		excluded: {},
 		editable: true,
 		carriesMedia: true,
@@ -64881,7 +65009,7 @@ function ruleSeedForSection(section) {
 		};
 		default: return {
 			delivery: "immediate",
-			conditions: {}
+			conditions: { source: "pipeline" }
 		};
 	}
 }
@@ -66283,6 +66411,170 @@ function packagePickerItems(packages) {
 	return [...pinned, ...addons];
 }
 //#endregion
+//#region src/i18n/state-labels.ts
+/** Every key the dictionary answers for, in a stable order. */
+var STATE_LABEL_KEYS = [
+	"disarmed",
+	"armed_home",
+	"armed_away",
+	"armed_night",
+	"armed_vacation",
+	"armed_custom_bypass",
+	"arming",
+	"disarming",
+	"pending",
+	"triggered",
+	"open",
+	"opening",
+	"closing",
+	"closed",
+	"stopped",
+	"locked",
+	"unlocked",
+	"locking",
+	"unlocking",
+	"jammed",
+	"on",
+	"off",
+	"home",
+	"not_home",
+	"matched",
+	"diverged",
+	"unknown",
+	"latched",
+	"live"
+];
+var STATE_LABELS = {
+	disarmed: {
+		en: "Disarmed",
+		it: "Disinserito"
+	},
+	armed_home: {
+		en: "Armed (home)",
+		it: "Inserito (in casa)"
+	},
+	armed_away: {
+		en: "Armed (away)",
+		it: "Inserito (fuori casa)"
+	},
+	armed_night: {
+		en: "Armed (night)",
+		it: "Inserito (notte)"
+	},
+	armed_vacation: {
+		en: "Armed (vacation)",
+		it: "Inserito (vacanza)"
+	},
+	armed_custom_bypass: {
+		en: "Armed (custom)",
+		it: "Inserito (personalizzato)"
+	},
+	arming: {
+		en: "Arming",
+		it: "In inserimento"
+	},
+	disarming: {
+		en: "Disarming",
+		it: "In disinserimento"
+	},
+	pending: {
+		en: "Pending (entry delay)",
+		it: "In attesa (ritardo ingresso)"
+	},
+	triggered: {
+		en: "Triggered",
+		it: "In allarme"
+	},
+	open: {
+		en: "Open",
+		it: "Aperto"
+	},
+	opening: {
+		en: "Opening",
+		it: "In apertura"
+	},
+	closing: {
+		en: "Closing",
+		it: "In chiusura"
+	},
+	closed: {
+		en: "Closed",
+		it: "Chiuso"
+	},
+	stopped: {
+		en: "Stopped",
+		it: "Fermo"
+	},
+	locked: {
+		en: "Locked",
+		it: "Bloccata"
+	},
+	unlocked: {
+		en: "Unlocked",
+		it: "Sbloccata"
+	},
+	locking: {
+		en: "Locking",
+		it: "In blocco"
+	},
+	unlocking: {
+		en: "Unlocking",
+		it: "In sblocco"
+	},
+	jammed: {
+		en: "Jammed",
+		it: "Inceppata"
+	},
+	on: {
+		en: "On",
+		it: "Acceso"
+	},
+	off: {
+		en: "Off",
+		it: "Spento"
+	},
+	home: {
+		en: "Home",
+		it: "In casa"
+	},
+	not_home: {
+		en: "Away",
+		it: "Fuori casa"
+	},
+	matched: {
+		en: "Matched (as captured)",
+		it: "Corrisponde (come acquisita)"
+	},
+	diverged: {
+		en: "Diverged (changed)",
+		it: "Diversa (cambiata)"
+	},
+	unknown: {
+		en: "Cannot judge",
+		it: "Non valutabile"
+	},
+	latched: {
+		en: "Latched",
+		it: "Memorizzato"
+	},
+	live: {
+		en: "Live",
+		it: "In tempo reale"
+	}
+};
+var KEY_SET = new Set(STATE_LABEL_KEYS);
+/** Is `key` one the dictionary answers for? An own key only — never `toString`. */
+function isStateLabelKey(key) {
+	return KEY_SET.has(key);
+}
+/**
+* The human label of a state word in `locale`, or the word itself when the
+* dictionary does not know it. Never throws.
+*/
+function stateLabel(key, locale) {
+	return isStateLabelKey(key) ? STATE_LABELS[key][locale] : key;
+}
+//#endregion
 //#region src/notification/timelapse-rule.ts
 /**
 * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -68704,6 +68996,10 @@ exports.ACCESSORY_LABEL = ACCESSORY_LABEL;
 exports.ACCESS_ROLES = ACCESS_ROLES;
 exports.ALEXA_EGRESS_PROFILE = ALEXA_EGRESS_PROFILE;
 exports.ALL_CAPABILITY_DEFINITIONS = ALL_CAPABILITY_DEFINITIONS;
+exports.APPEARANCE_BIN_COUNT = APPEARANCE_BIN_COUNT;
+exports.APPEARANCE_BLOCKS = APPEARANCE_BLOCKS;
+exports.APPEARANCE_DESCRIPTOR_VERSION = APPEARANCE_DESCRIPTOR_VERSION;
+exports.APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT = APPEARANCE_RESOLVES_AMBIGUITY_DEFAULT;
 exports.APPLE_SA_TO_MACRO = APPLE_SA_TO_MACRO;
 exports.ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT = ARCHIVED_DEBUG_NOTES_DEFAULT_LIMIT;
 exports.AUDIO_ANALYSIS_CAP_NAME = AUDIO_ANALYSIS_CAP_NAME;
@@ -69635,6 +69931,9 @@ exports.OWNER_ONLY_EVENT_CATEGORIES = require_event_category.OWNER_ONLY_EVENT_CA
 exports.OauthIntegrationDescriptorSchema = OauthIntegrationDescriptorSchema;
 exports.ObjectEventSchema = ObjectEventSchema;
 exports.OccupancyBurstRefusalSchema = OccupancyBurstRefusalSchema;
+exports.OccupancyLookAnswerSchema = OccupancyLookAnswerSchema;
+exports.OccupancyLookRefusalSchema = OccupancyLookRefusalSchema;
+exports.OccupancyLookRequestSchema = OccupancyLookRequestSchema;
 exports.OnboardFieldSupportSchema = OnboardFieldSupportSchema;
 exports.OnboardRecordTrackSchema = OnboardRecordTrackSchema;
 exports.OnboardScheduleSupportSchema = OnboardScheduleSupportSchema;
@@ -69853,6 +70152,8 @@ exports.SOURCE_CAP_ACTIVE_FIELD = require_composition.SOURCE_CAP_ACTIVE_FIELD;
 exports.SOURCE_CAP_CHANGED_AT_FIELD = require_composition.SOURCE_CAP_CHANGED_AT_FIELD;
 exports.SOURCE_DEVICE_TYPES = require_composition.SOURCE_DEVICE_TYPES;
 exports.SOURCE_INFO_METADATA_KEY = SOURCE_INFO_METADATA_KEY;
+exports.STATE_LABELS = STATE_LABELS;
+exports.STATE_LABEL_KEYS = STATE_LABEL_KEYS;
 exports.STATIONARY_OVERLAY_STYLE = STATIONARY_OVERLAY_STYLE;
 exports.STORAGE_ACCESS_FALLBACK = STORAGE_ACCESS_FALLBACK;
 exports.STORAGE_BYTES_PER_GB = STORAGE_BYTES_PER_GB;
@@ -70371,6 +70672,7 @@ exports.invocationFromEncodeProfile = require_composition.invocationFromEncodePr
 exports.isAgentOnlyPlacement = isAgentOnlyPlacement;
 exports.isArrayOutputSchema = isArrayOutputSchema;
 exports.isAudioChunkFormat = require_sleep.isAudioChunkFormat;
+exports.isAudioClassName = isAudioClassName;
 exports.isAudioLabelSelected = isAudioLabelSelected;
 exports.isAudioRule = isAudioRule;
 exports.isBaseConditionKey = isBaseConditionKey;
@@ -70401,6 +70703,7 @@ exports.isScheduleActive = isScheduleActive;
 exports.isSecretConfigField = isSecretConfigField;
 exports.isSoftwareDecode = require_composition.isSoftwareDecode;
 exports.isSourceCap = require_composition.isSourceCap;
+exports.isStateLabelKey = isStateLabelKey;
 exports.isStatefulBuiltin = require_composition.isStatefulBuiltin;
 exports.isStorageLocationMode = isStorageLocationMode;
 exports.isSystemDelivery = isSystemDelivery;
@@ -70514,6 +70817,7 @@ exports.pickPreferredRtspEntry = pickPreferredRtspEntry;
 exports.pickRestartCandidate = pickRestartCandidate;
 exports.pickVideoEncoder = require_composition.pickVideoEncoder;
 exports.pickerForCondition = pickerForCondition;
+exports.pickerForRuleClasses = pickerForRuleClasses;
 exports.pipelineAnalyticsCapability = pipelineAnalyticsCapability;
 exports.pipelineExecutorCapability = pipelineExecutorCapability;
 exports.pipelineOrchestratorCapability = pipelineOrchestratorCapability;
@@ -70627,6 +70931,7 @@ exports.smtpProviderCapability = smtpProviderCapability;
 exports.snapshotCapability = snapshotCapability;
 exports.ssoBridgeCapability = ssoBridgeCapability;
 exports.startReachabilityPoll = startReachabilityPoll;
+exports.stateLabel = stateLabel;
 exports.stateVocabularyFor = stateVocabularyFor;
 exports.stepModelRunsOnFormat = stepModelRunsOnFormat;
 exports.storageCapability = storageCapability;