@camstack/types 1.2.392 → 1.2.394

package/dist/capabilities/index.d.ts

@@ -46,7 +46,7 @@ export { CustomModelDescriptorSchema, customModelRegistryCapability, ImportModel
 export { type DataStoreEngineInfo, dataStoreProviderCapability, EngineInfoSchema as DataStoreEngineInfoSchema, type IDataStoreProvider, } from './data-store-provider.cap.js';
 export { type ArchiveSqliteSnapshot, ArchiveSqliteSnapshotSchema, DATABASE_SNAPSHOT_PARTIAL_SUFFIX, DATABASE_SNAPSHOT_SUFFIX, DATABASE_SNAPSHOT_TIMEOUT_MS, type DatabaseSnapshotRequest, DatabaseSnapshotRequestSchema, type DatabaseSnapshotResult, DatabaseSnapshotResultSchema, type DatabaseSnapshotTable, DatabaseSnapshotTableSchema, type DatabaseSnapshotTargets, DatabaseSnapshotTargetsSchema, type DatabaseSnapshotWritten, DatabaseSnapshotWrittenSchema, databaseSnapshotCapability, type IDatabaseSnapshotProvider, } from './database-snapshot.cap.js';
 export { CALLER_STAMPED_CAPABILITIES, withoutCallerStamp } from './caller-stamp.js';
-export { type IStorageAdminProvider, STORAGE_ADMIN_MOVED_COLLECTIONS, STORAGE_ADMIN_SCOPED_BASES, type StorageKind, StorageKindSchema, type StorageTable, StorageTableSchema, storageAdminCapability, } from './storage-admin.cap.js';
+export { type IStorageAdminProvider, type StorageKind, StorageKindSchema, type StorageTable, StorageTableSchema, storageAdminCapability, } from './storage-admin.cap.js';
 export { type DeclareKindResult, DeclareKindResultSchema, type IRecordsProvider, type RecordInput, RecordInputSchema, type RecordQueryInput, RecordQueryInputSchema, type RecordQueryResult, RecordQueryResultSchema, type RecordView, RecordViewSchema, type RecordWhere, RecordWhereSchema, type RecordWhereValue, RecordIdSchema, RecordBodySchema, RecordSecretRefsSchema, recordsCapability, } from './records.cap.js';
 export { type EntryKindInfo, EntryKindInfoSchema, type EntryView, EntryViewSchema, type IRecordEntriesProvider, recordEntriesCapability, } from './record-entries.cap.js';
 export { type IKeychainProvider, KEYCHAIN_MAX_REFS_PER_CALL, type KeychainResolveEntry, KeychainResolveEntrySchema, type KeychainResolveResult, KeychainResolveResultSchema, type KeychainSecretMeta, KeychainSecretMetaSchema, type KeychainState, KeychainStateSchema, type KeychainUnavailableReason, KeychainUnavailableReasonSchema, keychainCapability, } from './keychain.cap.js';

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

@@ -1097,6 +1097,7 @@ export declare const NcMediaPolicySchema: z.ZodObject<{
         "scene-boxes": "scene-boxes";
     }>>;
     showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+    showSubjectPath: z.ZodOptional<z.ZodBoolean>;
     attach: z.ZodOptional<z.ZodEnum<{
         best: "best";
         "best-matching": "best-matching";
@@ -1434,6 +1435,7 @@ export declare const NcRuleInputSchema: z.ZodObject<{
             "scene-boxes": "scene-boxes";
         }>>;
         showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+        showSubjectPath: z.ZodOptional<z.ZodBoolean>;
         attach: z.ZodOptional<z.ZodEnum<{
             best: "best";
             "best-matching": "best-matching";
@@ -1924,6 +1926,7 @@ export declare const NcRulePatchSchema: z.ZodObject<{
             "scene-boxes": "scene-boxes";
         }>>;
         showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+        showSubjectPath: z.ZodOptional<z.ZodBoolean>;
         attach: z.ZodOptional<z.ZodEnum<{
             best: "best";
             "best-matching": "best-matching";
@@ -2323,6 +2326,7 @@ export declare const NcRuleUpdateInputSchema: z.ZodObject<{
                 "scene-boxes": "scene-boxes";
             }>>;
             showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+            showSubjectPath: z.ZodOptional<z.ZodBoolean>;
             attach: z.ZodOptional<z.ZodEnum<{
                 best: "best";
                 "best-matching": "best-matching";
@@ -2575,6 +2579,7 @@ export declare const NcRuleSchema: z.ZodObject<{
             "scene-boxes": "scene-boxes";
         }>>;
         showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+        showSubjectPath: z.ZodOptional<z.ZodBoolean>;
         attach: z.ZodOptional<z.ZodEnum<{
             best: "best";
             "best-matching": "best-matching";
@@ -4706,6 +4711,7 @@ export declare const notificationRulesCapability: {
                         "scene-boxes": "scene-boxes";
                     }>>;
                     showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+                    showSubjectPath: z.ZodOptional<z.ZodBoolean>;
                     attach: z.ZodOptional<z.ZodEnum<{
                         best: "best";
                         "best-matching": "best-matching";
@@ -5073,6 +5079,7 @@ export declare const notificationRulesCapability: {
                         "scene-boxes": "scene-boxes";
                     }>>;
                     showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+                    showSubjectPath: z.ZodOptional<z.ZodBoolean>;
                     attach: z.ZodOptional<z.ZodEnum<{
                         best: "best";
                         "best-matching": "best-matching";
@@ -5438,6 +5445,7 @@ export declare const notificationRulesCapability: {
                         "scene-boxes": "scene-boxes";
                     }>>;
                     showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+                    showSubjectPath: z.ZodOptional<z.ZodBoolean>;
                     attach: z.ZodOptional<z.ZodEnum<{
                         best: "best";
                         "best-matching": "best-matching";
@@ -5797,6 +5805,7 @@ export declare const notificationRulesCapability: {
                         "scene-boxes": "scene-boxes";
                     }>>;
                     showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+                    showSubjectPath: z.ZodOptional<z.ZodBoolean>;
                     attach: z.ZodOptional<z.ZodEnum<{
                         best: "best";
                         "best-matching": "best-matching";
@@ -6287,6 +6296,7 @@ export declare const notificationRulesCapability: {
                         "scene-boxes": "scene-boxes";
                     }>>;
                     showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+                    showSubjectPath: z.ZodOptional<z.ZodBoolean>;
                     attach: z.ZodOptional<z.ZodEnum<{
                         best: "best";
                         "best-matching": "best-matching";
@@ -6537,6 +6547,7 @@ export declare const notificationRulesCapability: {
                         "scene-boxes": "scene-boxes";
                     }>>;
                     showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+                    showSubjectPath: z.ZodOptional<z.ZodBoolean>;
                     attach: z.ZodOptional<z.ZodEnum<{
                         best: "best";
                         "best-matching": "best-matching";
@@ -7095,6 +7106,7 @@ export declare const notificationRulesCapability: {
                         "scene-boxes": "scene-boxes";
                     }>>;
                     showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+                    showSubjectPath: z.ZodOptional<z.ZodBoolean>;
                     attach: z.ZodOptional<z.ZodEnum<{
                         best: "best";
                         "best-matching": "best-matching";
@@ -7479,6 +7491,7 @@ export declare const notificationRulesCapability: {
                         "scene-boxes": "scene-boxes";
                     }>>;
                     showTriggerZone: z.ZodOptional<z.ZodBoolean>;
+                    showSubjectPath: z.ZodOptional<z.ZodBoolean>;
                     attach: z.ZodOptional<z.ZodEnum<{
                         best: "best";
                         "best-matching": "best-matching";

package/dist/capabilities/storage-admin.cap.d.ts

@@ -102,25 +102,13 @@ export declare const StorageKindSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type StorageKind = z.infer<typeof StorageKindSchema>;
 /**
- * The collections retired by exact name by D870 (their data became keys of the
- * camera's settings). No addon declares any of them any more; the engine still
- * refuses one a running addon declared this boot. `dropCollection` may remove
- * these, the per-addon scoped `addon-settings` / `addon-devices` / `sections`
- * tables, and the tables of owners that are no longer installed - nothing else.
- * The records-migration leftovers (D871 `stats-5m`, the phase-0 tables) were
- * dropped by hand on the operator hubs and left this list with D900.
- */
-export declare const STORAGE_ADMIN_MOVED_COLLECTIONS: readonly string[];
-/** The per-addon blob tables a scoped name may carry. */
-export declare const STORAGE_ADMIN_SCOPED_BASES: readonly string[];
-/**
- * storage-admin - the operator's maintenance reach into the settings database:
- * list its tables, drop one that nothing owns any more (D870).
+ * storage-admin - the operator's maintenance reach into the databases: list
+ * their tables and record kinds, read a kind for diagnosis. Read-only: a table
+ * the code no longer creates is dropped by hand, offline (D901).
  *
  * Hub-only, internal and `auth: 'admin'` explicitly (`internal` does not gate
- * the mount, see `data-store-provider`). Both methods are LOGGED by the engine
- * with the table and the counts. `dropCollection` is a ONE-SHOT of the D870
- * migration and is marked for removal once the last hub has run it.
+ * the mount, see `data-store-provider`). `listTables` is LOGGED by the engine
+ * with the counts.
  *
  * `listTables` is READ-ONLY: it never creates a table, which `count` and `get`
  * on an undeclared scoped name used to do.
@@ -146,23 +134,6 @@ export declare const storageAdminCapability: {
                 declaredThisBoot: z.ZodBoolean;
             }, z.core.$strip>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
-        /**
-         * Drop one table. REFUSES when an addon declared it since the engine
-         * started (a running addon still owns it), when it is an engine or
-         * canonical table, when it does not exist, or when its row count is not
-         * `expectRows` - the caller states what it believes it is deleting. The
-         * engine also refuses anything but `<owner>:(addon-settings|addon-devices|
-         * sections)`, the retired collections by name, and tables of owners that
-         * are not installed (and refuses when it cannot read the installed list).
-         * Removed with the D870 migration script once the last hub ran it.
-         */
-        readonly dropCollection: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            collection: z.ZodString;
-            expectRows: z.ZodNumber;
-        }, z.core.$strip>, z.ZodObject<{
-            dropped: z.ZodLiteral<true>;
-            rows: z.ZodNumber;
-        }, z.core.$strip>, "mutation">;
         /** Every record kind of both files with rows, a size estimate, class and retention (D881). */
         readonly listKinds: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             owner: z.ZodOptional<z.ZodString>;

package/dist/client.d.ts

@@ -14,4 +14,4 @@
  * value this entry does not export — a missing name here is `undefined` at
  * runtime, not a build error.
  */
-export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CamProfileSchema, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_CERT_SIGNATURE, DEVICE_SIGNATURE_MESSAGE_VERSION, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, canonicalIconKey, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, deviceRefusalFromMessage, isDefinitiveDeviceRefusal, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, droppedConditionsForKind, iconCategoryLabel, iconEntry, iconsInCategory, isIconKey, isHeldBackTemplateVar, isSystemRuleKind, kindsForDiscriminator, locationIconKey, knownValues, nodePickerItems, parseDeviceEnrollmentLink, packagePickerItems, pickerForCondition, pickerForRuleClasses, parseRetrainRevisionConflict, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, summarizeReview, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, } from './index.js';
+export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CamProfileSchema, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_CERT_SIGNATURE, DEVICE_SIGNATURE_MESSAGE_VERSION, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, canonicalIconKey, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, deviceRefusalFromMessage, isDefinitiveDeviceRefusal, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, droppedConditionsForKind, iconCategoryLabel, iconEntry, iconsInCategory, isIconKey, isHeldBackTemplateVar, isSystemRuleKind, kindsForDiscriminator, locationIconKey, knownValues, nodePickerItems, parseDeviceEnrollmentLink, packagePickerItems, pickerForCondition, pickerForRuleClasses, parseRetrainRevisionConflict, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, summarizeReview, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, buildSubjectPath, isDrawableSubjectPath, projectSubjectPath, subjectPathSampleFromBox, subjectPathSvgPoints, } from './index.js';

package/dist/client.js

@@ -23121,6 +23121,15 @@ var NcMediaPolicySchema = zod.z.object({
 	* Replaces `zoneCrop`.
 	*/
 	showTriggerZone: zod.z.boolean().optional(),
+	/**
+	* Draw the SUBJECT'S PATH on the picture — a line in the subject's colour
+	* through the track's positions up to the frame shown, the same path the
+	* debug views draw (`buildSubjectPath`, D903). Every picture mode a subject
+	* is drawn on: a `crop` maps the path into the crop and clips it. Valid only
+	* on a rule whose subject is a tracked object (refused on a sound rule);
+	* dropped on `image: 'none'`. Absent = off.
+	*/
+	showSubjectPath: zod.z.boolean().optional(),
 	/** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
 	attach: zod.z.enum([
 		"best",
@@ -29375,6 +29384,182 @@ function ruleEditorSectionsForKind(kind) {
 	}
 	return sections;
 }
+var clamp01 = (n) => n < 0 ? 0 : n > 1 ? 1 : n;
+/** The sample of a normalised box: its centre, its extent. */
+function subjectPathSampleFromBox(bbox, timestamp) {
+	return {
+		x: bbox.x + bbox.w / 2,
+		y: bbox.y + bbox.h / 2,
+		w: bbox.w,
+		h: bbox.h,
+		...timestamp !== void 0 ? { timestamp } : {}
+	};
+}
+function isPlaceholder(s) {
+	return s.w !== void 0 && s.h !== void 0 && s.w >= .85 && s.h >= .85;
+}
+function downsample(xs, max) {
+	if (xs.length <= max || max < 2) return xs;
+	const step = (xs.length - 1) / (max - 1);
+	const out = [];
+	for (let i = 0; i < max - 1; i++) {
+		const x = xs[Math.round(i * step)];
+		if (x !== void 0) out.push(x);
+	}
+	const last = xs[xs.length - 1];
+	if (last !== void 0) out.push(last);
+	return out;
+}
+function isFiniteSample(s) {
+	return Number.isFinite(s.x) && Number.isFinite(s.y);
+}
+/**
+* The path of one track from its samples (normalised, oldest → newest).
+* Pure; never throws; malformed samples are skipped.
+*/
+function buildSubjectPath(samples, opts) {
+	const until = opts?.untilTimestamp;
+	const nodes = [];
+	let unlocalized = 0;
+	let tail = null;
+	for (let index = 0; index < samples.length; index++) {
+		const s = samples[index];
+		if (s === void 0 || !isFiniteSample(s)) continue;
+		if (until !== void 0 && s.timestamp !== void 0 && s.timestamp > until) continue;
+		if (isPlaceholder(s)) {
+			unlocalized += 1;
+			continue;
+		}
+		const ts = s.timestamp !== void 0 && Number.isFinite(s.timestamp) ? s.timestamp : index;
+		const x = clamp01(s.x);
+		const y = clamp01(s.y);
+		const prev = nodes[nodes.length - 1];
+		if (prev !== void 0 && Math.hypot(x - prev.x, y - prev.y) < .005) {
+			nodes[nodes.length - 1] = {
+				...prev,
+				samples: prev.samples + 1,
+				lastTs: Math.max(prev.lastTs, ts)
+			};
+			tail = {
+				x,
+				y,
+				samples: 1,
+				firstTs: ts,
+				lastTs: ts
+			};
+			continue;
+		}
+		tail = null;
+		nodes.push({
+			x,
+			y,
+			samples: 1,
+			firstTs: ts,
+			lastTs: ts
+		});
+	}
+	const end = nodes[nodes.length - 1];
+	if (tail !== null && end !== void 0 && end.samples > 1 && (tail.x !== end.x || tail.y !== end.y)) {
+		nodes[nodes.length - 1] = {
+			...end,
+			samples: end.samples - 1
+		};
+		nodes.push(tail);
+	}
+	return {
+		nodes: downsample(nodes, opts?.maxPoints ?? 120),
+		unlocalized
+	};
+}
+/** True when the path has something to draw (two nodes or more). */
+function isDrawableSubjectPath(path) {
+	return path.nodes.length >= 2;
+}
+function inside(p) {
+	return p.x >= 0 && p.x <= 1 && p.y >= 0 && p.y <= 1;
+}
+/** Liang–Barsky: the part of segment a→b inside the unit square, or null. */
+function clipSegment(a, b) {
+	const dx = b.x - a.x;
+	const dy = b.y - a.y;
+	let t0 = 0;
+	let t1 = 1;
+	const edges = [
+		[-dx, a.x],
+		[dx, 1 - a.x],
+		[-dy, a.y],
+		[dy, 1 - a.y]
+	];
+	for (const [p, q] of edges) {
+		if (p === 0) {
+			if (q < 0) return null;
+			continue;
+		}
+		const r = q / p;
+		if (p < 0) {
+			if (r > t1) return null;
+			if (r > t0) t0 = r;
+		} else {
+			if (r < t0) return null;
+			if (r < t1) t1 = r;
+		}
+	}
+	return [{
+		x: a.x + t0 * dx,
+		y: a.y + t0 * dy
+	}, {
+		x: a.x + t1 * dx,
+		y: a.y + t1 * dy
+	}];
+}
+function samePoint(a, b) {
+	return Math.abs(a.x - b.x) < 1e-9 && Math.abs(a.y - b.y) < 1e-9;
+}
+/**
+* The path as seen through `view` — a normalised rectangle of the frame (the
+* whole frame `{0,0,1,1}`, or the rectangle a crop cut). Points are re-mapped
+* into the view's own 0..1 space and the line is CLIPPED to it: a path that
+* leaves the crop and comes back is two runs. Runs of fewer than two points
+* are dropped, so an empty result means "nothing to draw".
+*/
+function projectSubjectPath(points, view) {
+	if (points.length < 2 || !(view.w > 0) || !(view.h > 0)) return [];
+	const local = points.map((p) => ({
+		x: (p.x - view.x) / view.w,
+		y: (p.y - view.y) / view.h
+	}));
+	const runs = [];
+	let run = [];
+	for (let i = 1; i < local.length; i++) {
+		const a = local[i - 1];
+		const b = local[i];
+		if (a === void 0 || b === void 0) continue;
+		const seg = clipSegment(a, b);
+		if (seg === null) {
+			if (run.length >= 2) runs.push(run);
+			run = [];
+			continue;
+		}
+		const [from, to] = seg;
+		const last = run[run.length - 1];
+		if (last === void 0 || !samePoint(last, from)) {
+			if (run.length >= 2) runs.push(run);
+			run = [from];
+		}
+		run.push(to);
+		if (!inside(b)) {
+			if (run.length >= 2) runs.push(run);
+			run = [];
+		}
+	}
+	if (run.length >= 2) runs.push(run);
+	return runs;
+}
+/** An SVG `points` attribute for a run in a `width` × `height` drawing ("x,y x,y …"). */
+function subjectPathSvgPoints(run, width, height) {
+	const fmt = (v) => String(Math.round(v * 100) / 100);
+	return run.map((p) => `${fmt(p.x * width)},${fmt(p.y * height)}`).join(" ");
+}
 //#endregion
 //#region src/notification/alarm-membership.ts
 var ARMED_WORD_PREFIX = "armed_";
@@ -31400,6 +31585,7 @@ exports.alarmDeviceSecureOnArm = alarmDeviceSecureOnArm;
 exports.alarmPatchLanded = alarmPatchLanded;
 exports.buildDeviceEnrollmentLink = buildDeviceEnrollmentLink;
 exports.buildDeviceSignatureMessage = buildDeviceSignatureMessage;
+exports.buildSubjectPath = buildSubjectPath;
 exports.canonicalIconKey = canonicalIconKey;
 exports.classifyRetrainReview = classifyRetrainReview;
 exports.conditionVisibleForKind = conditionVisibleForKind;
@@ -31410,6 +31596,7 @@ exports.iconCategoryLabel = iconCategoryLabel;
 exports.iconEntry = iconEntry;
 exports.iconsInCategory = iconsInCategory;
 exports.isDefinitiveDeviceRefusal = isDefinitiveDeviceRefusal;
+exports.isDrawableSubjectPath = isDrawableSubjectPath;
 exports.isHeldBackTemplateVar = isHeldBackTemplateVar;
 exports.isIconKey = isIconKey;
 exports.isSystemRuleKind = isSystemRuleKind;
@@ -31422,6 +31609,7 @@ exports.parseDeviceEnrollmentLink = parseDeviceEnrollmentLink;
 exports.parseRetrainRevisionConflict = parseRetrainRevisionConflict;
 exports.pickerForCondition = pickerForCondition;
 exports.pickerForRuleClasses = pickerForRuleClasses;
+exports.projectSubjectPath = projectSubjectPath;
 exports.resolveIconKey = resolveIconKey;
 exports.resolveModeDelays = resolveModeDelays;
 exports.retrainBoxIou = retrainBoxIou;
@@ -31436,6 +31624,8 @@ exports.searchIcons = searchIcons;
 exports.sensorTransitionNeverFires = sensorTransitionNeverFires;
 exports.sensorTransitionOffered = sensorTransitionOffered;
 exports.stateLabel = stateLabel;
+exports.subjectPathSampleFromBox = subjectPathSampleFromBox;
+exports.subjectPathSvgPoints = subjectPathSvgPoints;
 exports.summarizeReview = summarizeReview;
 exports.systemEventDeliveryProblems = systemEventDeliveryProblems;
 exports.systemEventFilterAppliesToAnyKind = systemEventFilterAppliesToAnyKind;

package/dist/client.mjs

@@ -23120,6 +23120,15 @@ var NcMediaPolicySchema = z.object({
 	* Replaces `zoneCrop`.
 	*/
 	showTriggerZone: z.boolean().optional(),
+	/**
+	* Draw the SUBJECT'S PATH on the picture — a line in the subject's colour
+	* through the track's positions up to the frame shown, the same path the
+	* debug views draw (`buildSubjectPath`, D903). Every picture mode a subject
+	* is drawn on: a `crop` maps the path into the crop and clips it. Valid only
+	* on a rule whose subject is a tracked object (refused on a sound rule);
+	* dropped on `image: 'none'`. Absent = off.
+	*/
+	showSubjectPath: z.boolean().optional(),
 	/** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
 	attach: z.enum([
 		"best",
@@ -29374,6 +29383,182 @@ function ruleEditorSectionsForKind(kind) {
 	}
 	return sections;
 }
+var clamp01 = (n) => n < 0 ? 0 : n > 1 ? 1 : n;
+/** The sample of a normalised box: its centre, its extent. */
+function subjectPathSampleFromBox(bbox, timestamp) {
+	return {
+		x: bbox.x + bbox.w / 2,
+		y: bbox.y + bbox.h / 2,
+		w: bbox.w,
+		h: bbox.h,
+		...timestamp !== void 0 ? { timestamp } : {}
+	};
+}
+function isPlaceholder(s) {
+	return s.w !== void 0 && s.h !== void 0 && s.w >= .85 && s.h >= .85;
+}
+function downsample(xs, max) {
+	if (xs.length <= max || max < 2) return xs;
+	const step = (xs.length - 1) / (max - 1);
+	const out = [];
+	for (let i = 0; i < max - 1; i++) {
+		const x = xs[Math.round(i * step)];
+		if (x !== void 0) out.push(x);
+	}
+	const last = xs[xs.length - 1];
+	if (last !== void 0) out.push(last);
+	return out;
+}
+function isFiniteSample(s) {
+	return Number.isFinite(s.x) && Number.isFinite(s.y);
+}
+/**
+* The path of one track from its samples (normalised, oldest → newest).
+* Pure; never throws; malformed samples are skipped.
+*/
+function buildSubjectPath(samples, opts) {
+	const until = opts?.untilTimestamp;
+	const nodes = [];
+	let unlocalized = 0;
+	let tail = null;
+	for (let index = 0; index < samples.length; index++) {
+		const s = samples[index];
+		if (s === void 0 || !isFiniteSample(s)) continue;
+		if (until !== void 0 && s.timestamp !== void 0 && s.timestamp > until) continue;
+		if (isPlaceholder(s)) {
+			unlocalized += 1;
+			continue;
+		}
+		const ts = s.timestamp !== void 0 && Number.isFinite(s.timestamp) ? s.timestamp : index;
+		const x = clamp01(s.x);
+		const y = clamp01(s.y);
+		const prev = nodes[nodes.length - 1];
+		if (prev !== void 0 && Math.hypot(x - prev.x, y - prev.y) < .005) {
+			nodes[nodes.length - 1] = {
+				...prev,
+				samples: prev.samples + 1,
+				lastTs: Math.max(prev.lastTs, ts)
+			};
+			tail = {
+				x,
+				y,
+				samples: 1,
+				firstTs: ts,
+				lastTs: ts
+			};
+			continue;
+		}
+		tail = null;
+		nodes.push({
+			x,
+			y,
+			samples: 1,
+			firstTs: ts,
+			lastTs: ts
+		});
+	}
+	const end = nodes[nodes.length - 1];
+	if (tail !== null && end !== void 0 && end.samples > 1 && (tail.x !== end.x || tail.y !== end.y)) {
+		nodes[nodes.length - 1] = {
+			...end,
+			samples: end.samples - 1
+		};
+		nodes.push(tail);
+	}
+	return {
+		nodes: downsample(nodes, opts?.maxPoints ?? 120),
+		unlocalized
+	};
+}
+/** True when the path has something to draw (two nodes or more). */
+function isDrawableSubjectPath(path) {
+	return path.nodes.length >= 2;
+}
+function inside(p) {
+	return p.x >= 0 && p.x <= 1 && p.y >= 0 && p.y <= 1;
+}
+/** Liang–Barsky: the part of segment a→b inside the unit square, or null. */
+function clipSegment(a, b) {
+	const dx = b.x - a.x;
+	const dy = b.y - a.y;
+	let t0 = 0;
+	let t1 = 1;
+	const edges = [
+		[-dx, a.x],
+		[dx, 1 - a.x],
+		[-dy, a.y],
+		[dy, 1 - a.y]
+	];
+	for (const [p, q] of edges) {
+		if (p === 0) {
+			if (q < 0) return null;
+			continue;
+		}
+		const r = q / p;
+		if (p < 0) {
+			if (r > t1) return null;
+			if (r > t0) t0 = r;
+		} else {
+			if (r < t0) return null;
+			if (r < t1) t1 = r;
+		}
+	}
+	return [{
+		x: a.x + t0 * dx,
+		y: a.y + t0 * dy
+	}, {
+		x: a.x + t1 * dx,
+		y: a.y + t1 * dy
+	}];
+}
+function samePoint(a, b) {
+	return Math.abs(a.x - b.x) < 1e-9 && Math.abs(a.y - b.y) < 1e-9;
+}
+/**
+* The path as seen through `view` — a normalised rectangle of the frame (the
+* whole frame `{0,0,1,1}`, or the rectangle a crop cut). Points are re-mapped
+* into the view's own 0..1 space and the line is CLIPPED to it: a path that
+* leaves the crop and comes back is two runs. Runs of fewer than two points
+* are dropped, so an empty result means "nothing to draw".
+*/
+function projectSubjectPath(points, view) {
+	if (points.length < 2 || !(view.w > 0) || !(view.h > 0)) return [];
+	const local = points.map((p) => ({
+		x: (p.x - view.x) / view.w,
+		y: (p.y - view.y) / view.h
+	}));
+	const runs = [];
+	let run = [];
+	for (let i = 1; i < local.length; i++) {
+		const a = local[i - 1];
+		const b = local[i];
+		if (a === void 0 || b === void 0) continue;
+		const seg = clipSegment(a, b);
+		if (seg === null) {
+			if (run.length >= 2) runs.push(run);
+			run = [];
+			continue;
+		}
+		const [from, to] = seg;
+		const last = run[run.length - 1];
+		if (last === void 0 || !samePoint(last, from)) {
+			if (run.length >= 2) runs.push(run);
+			run = [from];
+		}
+		run.push(to);
+		if (!inside(b)) {
+			if (run.length >= 2) runs.push(run);
+			run = [];
+		}
+	}
+	if (run.length >= 2) runs.push(run);
+	return runs;
+}
+/** An SVG `points` attribute for a run in a `width` × `height` drawing ("x,y x,y …"). */
+function subjectPathSvgPoints(run, width, height) {
+	const fmt = (v) => String(Math.round(v * 100) / 100);
+	return run.map((p) => `${fmt(p.x * width)},${fmt(p.y * height)}`).join(" ");
+}
 //#endregion
 //#region src/notification/alarm-membership.ts
 var ARMED_WORD_PREFIX = "armed_";
@@ -31336,4 +31521,4 @@ var TimelapseRuleSchema = TimelapseRuleInputSchema.extend({
 	updatedAt: z.number()
 });
 //#endregion
-export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CamProfileSchema, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_CERT_SIGNATURE, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_SIGNATURE_MESSAGE_VERSION, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, canonicalIconKey, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, deviceRefusalFromMessage, droppedConditionsForKind, iconCategoryLabel, iconEntry, iconsInCategory, isDefinitiveDeviceRefusal, isHeldBackTemplateVar, isIconKey, isSystemRuleKind, kindsForDiscriminator, knownValues, locationIconKey, nodePickerItems, packagePickerItems, parseDeviceEnrollmentLink, parseRetrainRevisionConflict, pickerForCondition, pickerForRuleClasses, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, summarizeReview, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies };
+export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CamProfileSchema, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_CERT_SIGNATURE, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_SIGNATURE_MESSAGE_VERSION, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, buildSubjectPath, canonicalIconKey, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, deviceRefusalFromMessage, droppedConditionsForKind, iconCategoryLabel, iconEntry, iconsInCategory, isDefinitiveDeviceRefusal, isDrawableSubjectPath, isHeldBackTemplateVar, isIconKey, isSystemRuleKind, kindsForDiscriminator, knownValues, locationIconKey, nodePickerItems, packagePickerItems, parseDeviceEnrollmentLink, parseRetrainRevisionConflict, pickerForCondition, pickerForRuleClasses, projectSubjectPath, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, subjectPathSampleFromBox, subjectPathSvgPoints, summarizeReview, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies };

package/dist/generated/addon-api.d.ts

@@ -9137,13 +9137,6 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof storageAdminCapability.methods.listTables.output>;
             meta: object;
         }>;
-        dropCollection: TRPCMutationProcedure<{
-            input: {
-                [x: string]: unknown;
-            } & z.input<typeof storageAdminCapability.methods.dropCollection.input>;
-            output: z.infer<typeof storageAdminCapability.methods.dropCollection.output>;
-            meta: object;
-        }>;
         listKinds: TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1382 method paths across 179 capabilities.
+ * Coverage: 1381 method paths across 179 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {