@camstack/addon-matter-broker 0.2.48 → 0.2.50

package/dist/addon.js

@@ -8110,6 +8110,13 @@ var MediaRelocateModeSchema = _enum([
 ]);
 var RelocateMediaInputSchema = object({
 	toLocationId: string$2(),
+	/**
+	* Restrict the pass to rows currently on this location. Omitted / `'*'` =
+	* every row that is not already on `toLocationId` (the historical
+	* behaviour). A named source is what a from→to migration needs: without it
+	* "move events off disk 2" also emptied disk 1.
+	*/
+	fromLocationId: string$2().optional(),
 	throttleMbps: number().min(1).max(1e3).optional(),
 	/** Omitted = `move`, the pre-existing behaviour. */
 	mode: MediaRelocateModeSchema.optional()
@@ -8177,6 +8184,19 @@ var StorageMigrationDestinationsSchema = object({
 	galleryMedia: string$2().min(1).optional()
 }).refine((value) => Object.keys(value).length > 0, { message: "select at least one storage class" });
 /**
+* Optional named source per class. Omitted = the class's current default
+* (the historical behaviour). A named source that is NOT the default is a
+* drain of that disk: bytes move, the default stays, and the source is
+* disabled when the move finishes.
+*/
+var StorageMigrationSourcesSchema = object({
+	recordings: string$2().min(1).optional(),
+	recordingsLow: string$2().min(1).optional(),
+	eventMedia: string$2().min(1).optional(),
+	backups: string$2().min(1).optional(),
+	galleryMedia: string$2().min(1).optional()
+}).optional();
+/**
 * How a migration sequences the cutover against the byte move.
 *
 *  - `blocking`     — the historical order: pause, move every byte, repoint,
@@ -8198,6 +8218,8 @@ var StorageMigrationModeSchema = _enum(["blocking", "nonBlocking"]);
 /** Shared input for planning and starting an orchestrated storage migration. */
 var StorageMigrationInputSchema = object({
 	destinations: StorageMigrationDestinationsSchema,
+	/** Omitted = each class's current default. */
+	sources: StorageMigrationSourcesSchema,
 	throttleMbps: number().min(1).max(1e3).optional(),
 	/** Omitted = `blocking`, which stays the default. */
 	mode: StorageMigrationModeSchema.optional()
@@ -8277,6 +8299,13 @@ var StorageMigrationMoveSchema = object({
 	storageClass: StorageMigrationClassSchema,
 	fromLocationId: string$2(),
 	toLocationId: string$2(),
+	/**
+	* True when `from` was NOT the class default at plan time. The move still
+	* copies bytes, but the default is left alone and the source is disabled
+	* once the copy verifies. Absent on jobs planned before this field existed
+	* — those jobs always repointed, which is `false`.
+	*/
+	freezeSource: boolean().optional(),
 	moverJobId: string$2().nullable(),
 	state: RelocateJobStateSchema.nullable(),
 	error: string$2().nullable(),
@@ -8290,6 +8319,7 @@ var StorageMigrationJobSchema = object({
 	*  can tell a seconds-long cutover from a thirty-hour one. */
 	mode: StorageMigrationModeSchema,
 	destinations: StorageMigrationDestinationsSchema,
+	sources: StorageMigrationSourcesSchema,
 	throttleMbps: number(),
 	moves: array(StorageMigrationMoveSchema),
 	pauseLeaseId: string$2().nullable(),
@@ -8315,6 +8345,7 @@ var StorageMigrationFindingSchema = object({
 });
 var StorageMigrationPlanSchema = object({
 	destinations: StorageMigrationDestinationsSchema,
+	sources: StorageMigrationSourcesSchema,
 	/** The mode this plan was built for. A plan is only valid for its mode: the
 	*  `eventMedia` seal gate and the single-cardinality refusal both depend on
 	*  it. */
@@ -8322,7 +8353,8 @@ var StorageMigrationPlanSchema = object({
 	moves: array(object({
 		storageClass: StorageMigrationClassSchema,
 		fromLocationId: string$2(),
-		toLocationId: string$2()
+		toLocationId: string$2(),
+		freezeSource: boolean().optional()
 	})),
 	findings: array(StorageMigrationFindingSchema)
 });
@@ -8500,10 +8532,51 @@ var LedgerWalkReportSchema = object({
 var RelocatableMediaCountSchema = object({ rows: number().int().nonnegative() }).nullable();
 var RelocatableMediaCountInputSchema = object({
 	toLocationId: string$2().min(1),
+	/** Restrict the count to one source; omitted / `'*'` = every non-target row. */
+	fromLocationId: string$2().optional(),
 	/** Omitted = `move`. */
 	mode: MediaRelocateModeSchema.optional()
 });
 /**
+* Operator cleanup of leftover analytics rows, optional debug media, and
+* ghost ledger entries on frozen footage locations.
+*
+* A pass is tens of minutes on a standing backlog. The hub method RETURNS
+* `{ jobId }` immediately; progress is `cleanupStatus`. Awaiting the work
+* is how `addons.custom` hit the 60 s UDS deadline while reclaim continued
+* with no operator-visible status.
+*/
+var StorageCleanupPhaseSchema = _enum([
+	"orphans",
+	"debug-media",
+	"ghost-ledger",
+	"done",
+	"failed",
+	"cancelled"
+]);
+var StorageCleanupInputSchema = object({ 
+/** Also walk motion stills / track filmstrips. Off by default. */
+includeDebugMedia: boolean().optional() });
+var StorageCleanupJobSchema = object({
+	jobId: string$2(),
+	phase: StorageCleanupPhaseSchema,
+	includeDebugMedia: boolean(),
+	orphansReclaimed: number().int().nonnegative(),
+	orphanBytesReclaimed: number().int().nonnegative(),
+	debugMediaReclaimed: number().int().nonnegative(),
+	debugMediaBytesReclaimed: number().int().nonnegative(),
+	ghostsForgotten: number().int().nonnegative(),
+	ghostBytesForgotten: number().int().nonnegative(),
+	/** Short operator-facing line: current collection, pass, or location. */
+	detail: string$2().nullable(),
+	cancelRequested: boolean(),
+	startedAt: number(),
+	updatedAt: number(),
+	finishedAt: number().nullable(),
+	error: string$2().nullable()
+});
+var StorageCleanupStatusInputSchema = object({ jobId: string$2().optional() });
+/**
 * `StorageLocationType` — an addon-declared id that identifies the *kind* of
 * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
 * so the persisted record schema and the consumer-facing cap can both consume it
@@ -8531,11 +8604,10 @@ var StorageLocationTypeSchema = string$2().regex(/^[a-z][a-zA-Z0-9-]*$/);
 * The default location for a type uses `id === <type>:default` by
 * convention (the bare type ref like `'backups'` resolves to it).
 *
-* `isSystem: true` marks a location as orchestrator-seeded and
-* undeletable. The bootstrap-installed defaults (one per type) carry
-* this flag; operator-added locations don't. Editing the config of
-* a system location is allowed (path migration, provider swap) but
-* deleting it is rejected at the cap level.
+* `isSystem` is a legacy persisted flag. Seed still creates the initial
+* `<type>:default` locations; the flag is no longer a lock, a badge, or a
+* prune selector. New writes leave it false. Deletion is gated on uniqueness
+* / last-enabled, not on this bit.
 */
 var StorageLocationSchema = object({
 	id: string$2().regex(/^[a-z][a-zA-Z0-9-]*:[a-zA-Z0-9-]+$/),
@@ -13127,6 +13199,12 @@ method(object({
 }), _void(), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	from: string$2(),
+	to: string$2()
+}), object({ moved: number() }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number(),
 	disabled: boolean()
@@ -15877,6 +15955,8 @@ var NcSystemEventKindSchema = _enum([
 	"device-offline",
 	"device-disabled",
 	"device-enabled",
+	"device-battery-low",
+	"device-battery-normal",
 	"stream-online",
 	"stream-offline",
 	"node-online",
@@ -19135,46 +19215,6 @@ var RecentTracksPageSchema = object({
 	/** Cursor for the next page, or null when this page is the last. */
 	nextCursor: string$2().nullable()
 });
-var LIST_GROUPS_DEFAULT_LIMIT = 40;
-var LIST_GROUPS_MAX_LIMIT = 100;
-var AnalyticsGroupRecordSchema = object({
-	id: string$2(),
-	deviceId: number().int(),
-	openedAt: number().int(),
-	closedAt: number().int(),
-	timestamp: number().int(),
-	memberCount: number().int(),
-	memberTrackIds: array(string$2()).readonly(),
-	className: string$2(),
-	classes: array(string$2()).readonly(),
-	/** Relative event-media path, or null when the group has no picture yet. */
-	mediaUrl: string$2().nullable(),
-	singleton: boolean()
-});
-var AnalyticsGroupMemberSchema = object({
-	trackId: string$2(),
-	deviceId: number().int(),
-	className: string$2(),
-	firstSeen: number().int(),
-	lastSeen: number().int(),
-	mediaUrl: string$2().nullable()
-});
-var AnalyticsGroupDetailSchema = AnalyticsGroupRecordSchema.extend({ members: array(AnalyticsGroupMemberSchema).readonly() });
-var ListGroupsQueryInput = object({
-	/** Devices to merge. An empty array yields `{ groups: [], nextCursor: null }`. */
-	deviceIds: array(number()),
-	/** Window lower bound on `closedAt` (inclusive). */
-	since: number().optional(),
-	/** Window upper bound on `openedAt` (inclusive). */
-	until: number().optional(),
-	limit: number().int().min(1).max(LIST_GROUPS_MAX_LIMIT).default(LIST_GROUPS_DEFAULT_LIMIT),
-	/** Opaque continuation cursor from a previous page's `nextCursor`. */
-	cursor: string$2().optional()
-});
-var ListGroupsPageSchema = object({
-	groups: array(AnalyticsGroupRecordSchema).readonly(),
-	nextCursor: string$2().nullable()
-});
 var KEY_EVENTS_DEFAULT_LIMIT = 50;
 var KEY_EVENTS_MAX_LIMIT = 200;
 var KeyEventQueryInput = object({
@@ -19278,9 +19318,7 @@ var TrackCascadeCountsSchema = object({
 	/** Unassigned plate reads removed (best-effort; plate leg deferred to plate-intelligence). */
 	plates: number().int(),
 	/** Per-track CLIP search vectors removed (best-effort). */
-	embeddings: number().int(),
-	/** Group membership + group rows removed with their last member (best-effort). */
-	groups: number().int()
+	embeddings: number().int()
 });
 /** Disk-wins reconcile: media rows whose blobs are gone, then empty tracks. */
 var DiskReconcileCountsSchema = object({
@@ -19450,6 +19488,47 @@ var RebuildStatusSchema = object({
 	/** Present when the pass ended by throwing. */
 	error: string$2().nullable()
 });
+/**
+* Acknowledgement that a debug-media reclaim STARTED.
+*
+* The pass is paced at ~2 MB/s over a standing 100 GB — tens of minutes — so
+* it runs detached and this returns immediately. Awaiting it is how the
+* `addons.custom` door hit the 60 s UDS deadline while the walk carried on
+* with no status. Poll {@link pipelineAnalyticsCapability.methods.getMediaReclaimStatus}.
+*/
+var MediaReclaimStartResultSchema = object({
+	started: boolean(),
+	/** True when a pass was already running; the new request is ignored. */
+	alreadyRunning: boolean()
+});
+var MediaReclaimInputSchema = object({
+	mode: _enum(["report", "reclaim"]).default("report"),
+	scopes: array(_enum(["motion-still", "track-filmstrip"])).min(1).optional(),
+	deviceIds: array(number().int()).min(1).optional(),
+	restart: boolean().optional(),
+	pageSize: number().int().min(50).max(5e3).optional(),
+	maxRowsPerDevice: number().int().min(1).max(5e5).optional(),
+	maxReclaimPerDevice: number().int().min(1).max(5e5).optional(),
+	maxBytesPerRun: number().int().min(1).optional(),
+	budgetMinutes: number().int().min(1).max(720).optional(),
+	throttleBytesPerSec: number().int().min(64 * 1024).optional(),
+	graceMinutes: number().int().min(1).max(10080).optional()
+});
+var MediaReclaimStatusSchema = object({
+	running: boolean(),
+	mode: _enum(["report", "reclaim"]).nullable(),
+	totalExamined: number(),
+	totalEligible: number(),
+	totalReclaimed: number(),
+	totalBytesReclaimed: number(),
+	totalRefused: number(),
+	/** Device+scope windows finished in this pass. */
+	devicesDone: number(),
+	complete: boolean().nullable(),
+	startedAtMs: number().nullable(),
+	finishedAtMs: number().nullable(),
+	error: string$2().nullable()
+});
 var ReplayFrameInputSchema = object({
 	timestamp: number(),
 	frame: PipelineRunResultBridge
@@ -19488,10 +19567,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	*  stationary registry). Default false: the timeline lists passages,
 	*  not parking records (operator decision, 2026-08-15). */
 	includeStationary: boolean().optional()
-}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(ListGroupsQueryInput, ListGroupsPageSchema), method(object({
-	deviceId: number(),
-	groupId: string$2().min(1)
-}), AnalyticsGroupDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
+}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
 }), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
@@ -19591,6 +19667,12 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
 	kind: "query",
 	auth: "admin"
+}), method(MediaReclaimInputSchema, MediaReclaimStartResultSchema, {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({}), MediaReclaimStatusSchema, {
+	kind: "query",
+	auth: "admin"
 }), method(object({ deviceIds: array(number()).optional() }), TrainingExportSummarySchema, {
 	kind: "query",
 	auth: "admin"
@@ -21561,7 +21643,13 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
 }), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string$2() }), {
 	kind: "mutation",
 	auth: "admin"
-});
+}), method(StorageCleanupInputSchema, object({ jobId: string$2() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(StorageCleanupStatusInputSchema, StorageCleanupJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string$2() }), object({ cancelled: boolean() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({}), array(StorageMigrationJobSchema).readonly(), { auth: "admin" });
 var ProviderInfoSchema = discriminatedUnion("shouldSaveDiskSpace", [object({
 	providerId: string$2().min(1),
 	displayName: string$2().min(1),
@@ -28671,6 +28759,33 @@ var RecordingRebalanceInputSchema = object({
 	minMoveGb: number().min(0).optional()
 });
 /**
+* Operator-facing placement of one camera onto a recordings location.
+*
+* `pinLocationId` is the operator instruction: a location id, or `null` for
+* Auto (the planner may move this camera). `locationId` is where high/mid
+* currently write — the plan, which may disagree with the pin when Auto.
+*/
+var RecordingDevicePlacementSchema = object({
+	deviceId: number().int(),
+	profile: string$2(),
+	locationId: string$2()
+});
+var RecordingDevicePinSchema = object({
+	deviceId: number().int(),
+	/** Recordings-class location this camera is pinned to. */
+	locationId: string$2()
+});
+var RecordingPlacementViewSchema = object({
+	assignments: array(RecordingDevicePlacementSchema),
+	pins: array(RecordingDevicePinSchema),
+	defaultLocations: record(string$2(), string$2())
+});
+var RecordingSetDevicePlacementInputSchema = object({
+	deviceId: number().int(),
+	/** `null` = Auto. Otherwise a `recordings:*` location id. */
+	locationId: string$2().nullable()
+});
+/**
 * Result of locating footage at a wall-clock instant for one device/profile.
 * `segment` carries the covering segment's window; `gap` reports the forward
 * nearest covered edge (`null` past the end of footage / when none exists)
@@ -28896,6 +29011,12 @@ method(object({
 }), method(RecordingRebalanceInputSchema, RecordingRebalancePlanSchema, {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({}), RecordingPlacementViewSchema, {
+	kind: "query",
+	auth: "admin"
+}), method(RecordingSetDevicePlacementInputSchema, object({ ok: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
 });
 /**
 * `recording-export` cap — render a footage time range into a single downloadable
@@ -33965,6 +34086,12 @@ Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"deviceManager.renameLocation": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.runDeviceAction": {
 		capName: "device-manager",
 		capScope: "system",
@@ -35657,19 +35784,19 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.getGroup": {
+	"pipelineAnalytics.getKeyEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.getKeyEvents": {
+	"pipelineAnalytics.getKeyEventsBatch": {
 		capName: "pipeline-analytics",
 		capScope: "device",
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.getKeyEventsBatch": {
+	"pipelineAnalytics.getMediaReclaimStatus": {
 		capName: "pipeline-analytics",
 		capScope: "device",
 		addonId: null,
@@ -35759,12 +35886,6 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.listGroups": {
-		capName: "pipeline-analytics",
-		capScope: "device",
-		addonId: null,
-		access: "view"
-	},
 	"pipelineAnalytics.listOpsLog": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -35849,6 +35970,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.reclaimDebugMedia": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineAnalytics.reconcileFromDisk": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -36773,6 +36900,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"recording.getPlacement": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"recording.getPlaybackManifest": {
 		capName: "recording",
 		capScope: "system",
@@ -36899,6 +37032,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"recording.setDevicePlacement": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"recording.startStorageMigrationMove": {
 		capName: "recording",
 		capScope: "system",
@@ -37343,12 +37482,36 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"storageMigration.cleanupCancel": {
+		capName: "storage-migration",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"storageMigration.cleanupStart": {
+		capName: "storage-migration",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"storageMigration.cleanupStatus": {
+		capName: "storage-migration",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"storageMigration.drain": {
 		capName: "storage-migration",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"storageMigration.history": {
+		capName: "storage-migration",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"storageMigration.movers": {
 		capName: "storage-migration",
 		capScope: "system",
@@ -39345,11 +39508,6 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
-	"pipelineAnalytics.getGroup": [{
-		name: "deviceId",
-		form: "single",
-		optional: false
-	}],
 	"pipelineAnalytics.getKeyEvents": [{
 		name: "deviceId",
 		form: "single",
@@ -39415,11 +39573,6 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
-	"pipelineAnalytics.listGroups": [{
-		name: "deviceIds",
-		form: "array",
-		optional: false
-	}],
 	"pipelineAnalytics.listOpsLog": [{
 		name: "deviceId",
 		form: "single",
@@ -39465,6 +39618,11 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"pipelineAnalytics.reclaimDebugMedia": [{
+		name: "deviceIds",
+		form: "array",
+		optional: true
+	}],
 	"pipelineAnalytics.reconcileFromDisk": [{
 		name: "deviceId",
 		form: "single",
@@ -39830,6 +39988,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"recording.setDevicePlacement": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"recording.startStorageMigrationMove": [{
 		name: "deviceId",
 		form: "single",

package/dist/addon.mjs

@@ -8108,6 +8108,13 @@ var MediaRelocateModeSchema = _enum([
 ]);
 var RelocateMediaInputSchema = object({
 	toLocationId: string$2(),
+	/**
+	* Restrict the pass to rows currently on this location. Omitted / `'*'` =
+	* every row that is not already on `toLocationId` (the historical
+	* behaviour). A named source is what a from→to migration needs: without it
+	* "move events off disk 2" also emptied disk 1.
+	*/
+	fromLocationId: string$2().optional(),
 	throttleMbps: number().min(1).max(1e3).optional(),
 	/** Omitted = `move`, the pre-existing behaviour. */
 	mode: MediaRelocateModeSchema.optional()
@@ -8175,6 +8182,19 @@ var StorageMigrationDestinationsSchema = object({
 	galleryMedia: string$2().min(1).optional()
 }).refine((value) => Object.keys(value).length > 0, { message: "select at least one storage class" });
 /**
+* Optional named source per class. Omitted = the class's current default
+* (the historical behaviour). A named source that is NOT the default is a
+* drain of that disk: bytes move, the default stays, and the source is
+* disabled when the move finishes.
+*/
+var StorageMigrationSourcesSchema = object({
+	recordings: string$2().min(1).optional(),
+	recordingsLow: string$2().min(1).optional(),
+	eventMedia: string$2().min(1).optional(),
+	backups: string$2().min(1).optional(),
+	galleryMedia: string$2().min(1).optional()
+}).optional();
+/**
 * How a migration sequences the cutover against the byte move.
 *
 *  - `blocking`     — the historical order: pause, move every byte, repoint,
@@ -8196,6 +8216,8 @@ var StorageMigrationModeSchema = _enum(["blocking", "nonBlocking"]);
 /** Shared input for planning and starting an orchestrated storage migration. */
 var StorageMigrationInputSchema = object({
 	destinations: StorageMigrationDestinationsSchema,
+	/** Omitted = each class's current default. */
+	sources: StorageMigrationSourcesSchema,
 	throttleMbps: number().min(1).max(1e3).optional(),
 	/** Omitted = `blocking`, which stays the default. */
 	mode: StorageMigrationModeSchema.optional()
@@ -8275,6 +8297,13 @@ var StorageMigrationMoveSchema = object({
 	storageClass: StorageMigrationClassSchema,
 	fromLocationId: string$2(),
 	toLocationId: string$2(),
+	/**
+	* True when `from` was NOT the class default at plan time. The move still
+	* copies bytes, but the default is left alone and the source is disabled
+	* once the copy verifies. Absent on jobs planned before this field existed
+	* — those jobs always repointed, which is `false`.
+	*/
+	freezeSource: boolean().optional(),
 	moverJobId: string$2().nullable(),
 	state: RelocateJobStateSchema.nullable(),
 	error: string$2().nullable(),
@@ -8288,6 +8317,7 @@ var StorageMigrationJobSchema = object({
 	*  can tell a seconds-long cutover from a thirty-hour one. */
 	mode: StorageMigrationModeSchema,
 	destinations: StorageMigrationDestinationsSchema,
+	sources: StorageMigrationSourcesSchema,
 	throttleMbps: number(),
 	moves: array(StorageMigrationMoveSchema),
 	pauseLeaseId: string$2().nullable(),
@@ -8313,6 +8343,7 @@ var StorageMigrationFindingSchema = object({
 });
 var StorageMigrationPlanSchema = object({
 	destinations: StorageMigrationDestinationsSchema,
+	sources: StorageMigrationSourcesSchema,
 	/** The mode this plan was built for. A plan is only valid for its mode: the
 	*  `eventMedia` seal gate and the single-cardinality refusal both depend on
 	*  it. */
@@ -8320,7 +8351,8 @@ var StorageMigrationPlanSchema = object({
 	moves: array(object({
 		storageClass: StorageMigrationClassSchema,
 		fromLocationId: string$2(),
-		toLocationId: string$2()
+		toLocationId: string$2(),
+		freezeSource: boolean().optional()
 	})),
 	findings: array(StorageMigrationFindingSchema)
 });
@@ -8498,10 +8530,51 @@ var LedgerWalkReportSchema = object({
 var RelocatableMediaCountSchema = object({ rows: number().int().nonnegative() }).nullable();
 var RelocatableMediaCountInputSchema = object({
 	toLocationId: string$2().min(1),
+	/** Restrict the count to one source; omitted / `'*'` = every non-target row. */
+	fromLocationId: string$2().optional(),
 	/** Omitted = `move`. */
 	mode: MediaRelocateModeSchema.optional()
 });
 /**
+* Operator cleanup of leftover analytics rows, optional debug media, and
+* ghost ledger entries on frozen footage locations.
+*
+* A pass is tens of minutes on a standing backlog. The hub method RETURNS
+* `{ jobId }` immediately; progress is `cleanupStatus`. Awaiting the work
+* is how `addons.custom` hit the 60 s UDS deadline while reclaim continued
+* with no operator-visible status.
+*/
+var StorageCleanupPhaseSchema = _enum([
+	"orphans",
+	"debug-media",
+	"ghost-ledger",
+	"done",
+	"failed",
+	"cancelled"
+]);
+var StorageCleanupInputSchema = object({ 
+/** Also walk motion stills / track filmstrips. Off by default. */
+includeDebugMedia: boolean().optional() });
+var StorageCleanupJobSchema = object({
+	jobId: string$2(),
+	phase: StorageCleanupPhaseSchema,
+	includeDebugMedia: boolean(),
+	orphansReclaimed: number().int().nonnegative(),
+	orphanBytesReclaimed: number().int().nonnegative(),
+	debugMediaReclaimed: number().int().nonnegative(),
+	debugMediaBytesReclaimed: number().int().nonnegative(),
+	ghostsForgotten: number().int().nonnegative(),
+	ghostBytesForgotten: number().int().nonnegative(),
+	/** Short operator-facing line: current collection, pass, or location. */
+	detail: string$2().nullable(),
+	cancelRequested: boolean(),
+	startedAt: number(),
+	updatedAt: number(),
+	finishedAt: number().nullable(),
+	error: string$2().nullable()
+});
+var StorageCleanupStatusInputSchema = object({ jobId: string$2().optional() });
+/**
 * `StorageLocationType` — an addon-declared id that identifies the *kind* of
 * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
 * so the persisted record schema and the consumer-facing cap can both consume it
@@ -8529,11 +8602,10 @@ var StorageLocationTypeSchema = string$2().regex(/^[a-z][a-zA-Z0-9-]*$/);
 * The default location for a type uses `id === <type>:default` by
 * convention (the bare type ref like `'backups'` resolves to it).
 *
-* `isSystem: true` marks a location as orchestrator-seeded and
-* undeletable. The bootstrap-installed defaults (one per type) carry
-* this flag; operator-added locations don't. Editing the config of
-* a system location is allowed (path migration, provider swap) but
-* deleting it is rejected at the cap level.
+* `isSystem` is a legacy persisted flag. Seed still creates the initial
+* `<type>:default` locations; the flag is no longer a lock, a badge, or a
+* prune selector. New writes leave it false. Deletion is gated on uniqueness
+* / last-enabled, not on this bit.
 */
 var StorageLocationSchema = object({
 	id: string$2().regex(/^[a-z][a-zA-Z0-9-]*:[a-zA-Z0-9-]+$/),
@@ -13125,6 +13197,12 @@ method(object({
 }), _void(), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	from: string$2(),
+	to: string$2()
+}), object({ moved: number() }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number(),
 	disabled: boolean()
@@ -15875,6 +15953,8 @@ var NcSystemEventKindSchema = _enum([
 	"device-offline",
 	"device-disabled",
 	"device-enabled",
+	"device-battery-low",
+	"device-battery-normal",
 	"stream-online",
 	"stream-offline",
 	"node-online",
@@ -19133,46 +19213,6 @@ var RecentTracksPageSchema = object({
 	/** Cursor for the next page, or null when this page is the last. */
 	nextCursor: string$2().nullable()
 });
-var LIST_GROUPS_DEFAULT_LIMIT = 40;
-var LIST_GROUPS_MAX_LIMIT = 100;
-var AnalyticsGroupRecordSchema = object({
-	id: string$2(),
-	deviceId: number().int(),
-	openedAt: number().int(),
-	closedAt: number().int(),
-	timestamp: number().int(),
-	memberCount: number().int(),
-	memberTrackIds: array(string$2()).readonly(),
-	className: string$2(),
-	classes: array(string$2()).readonly(),
-	/** Relative event-media path, or null when the group has no picture yet. */
-	mediaUrl: string$2().nullable(),
-	singleton: boolean()
-});
-var AnalyticsGroupMemberSchema = object({
-	trackId: string$2(),
-	deviceId: number().int(),
-	className: string$2(),
-	firstSeen: number().int(),
-	lastSeen: number().int(),
-	mediaUrl: string$2().nullable()
-});
-var AnalyticsGroupDetailSchema = AnalyticsGroupRecordSchema.extend({ members: array(AnalyticsGroupMemberSchema).readonly() });
-var ListGroupsQueryInput = object({
-	/** Devices to merge. An empty array yields `{ groups: [], nextCursor: null }`. */
-	deviceIds: array(number()),
-	/** Window lower bound on `closedAt` (inclusive). */
-	since: number().optional(),
-	/** Window upper bound on `openedAt` (inclusive). */
-	until: number().optional(),
-	limit: number().int().min(1).max(LIST_GROUPS_MAX_LIMIT).default(LIST_GROUPS_DEFAULT_LIMIT),
-	/** Opaque continuation cursor from a previous page's `nextCursor`. */
-	cursor: string$2().optional()
-});
-var ListGroupsPageSchema = object({
-	groups: array(AnalyticsGroupRecordSchema).readonly(),
-	nextCursor: string$2().nullable()
-});
 var KEY_EVENTS_DEFAULT_LIMIT = 50;
 var KEY_EVENTS_MAX_LIMIT = 200;
 var KeyEventQueryInput = object({
@@ -19276,9 +19316,7 @@ var TrackCascadeCountsSchema = object({
 	/** Unassigned plate reads removed (best-effort; plate leg deferred to plate-intelligence). */
 	plates: number().int(),
 	/** Per-track CLIP search vectors removed (best-effort). */
-	embeddings: number().int(),
-	/** Group membership + group rows removed with their last member (best-effort). */
-	groups: number().int()
+	embeddings: number().int()
 });
 /** Disk-wins reconcile: media rows whose blobs are gone, then empty tracks. */
 var DiskReconcileCountsSchema = object({
@@ -19448,6 +19486,47 @@ var RebuildStatusSchema = object({
 	/** Present when the pass ended by throwing. */
 	error: string$2().nullable()
 });
+/**
+* Acknowledgement that a debug-media reclaim STARTED.
+*
+* The pass is paced at ~2 MB/s over a standing 100 GB — tens of minutes — so
+* it runs detached and this returns immediately. Awaiting it is how the
+* `addons.custom` door hit the 60 s UDS deadline while the walk carried on
+* with no status. Poll {@link pipelineAnalyticsCapability.methods.getMediaReclaimStatus}.
+*/
+var MediaReclaimStartResultSchema = object({
+	started: boolean(),
+	/** True when a pass was already running; the new request is ignored. */
+	alreadyRunning: boolean()
+});
+var MediaReclaimInputSchema = object({
+	mode: _enum(["report", "reclaim"]).default("report"),
+	scopes: array(_enum(["motion-still", "track-filmstrip"])).min(1).optional(),
+	deviceIds: array(number().int()).min(1).optional(),
+	restart: boolean().optional(),
+	pageSize: number().int().min(50).max(5e3).optional(),
+	maxRowsPerDevice: number().int().min(1).max(5e5).optional(),
+	maxReclaimPerDevice: number().int().min(1).max(5e5).optional(),
+	maxBytesPerRun: number().int().min(1).optional(),
+	budgetMinutes: number().int().min(1).max(720).optional(),
+	throttleBytesPerSec: number().int().min(64 * 1024).optional(),
+	graceMinutes: number().int().min(1).max(10080).optional()
+});
+var MediaReclaimStatusSchema = object({
+	running: boolean(),
+	mode: _enum(["report", "reclaim"]).nullable(),
+	totalExamined: number(),
+	totalEligible: number(),
+	totalReclaimed: number(),
+	totalBytesReclaimed: number(),
+	totalRefused: number(),
+	/** Device+scope windows finished in this pass. */
+	devicesDone: number(),
+	complete: boolean().nullable(),
+	startedAtMs: number().nullable(),
+	finishedAtMs: number().nullable(),
+	error: string$2().nullable()
+});
 var ReplayFrameInputSchema = object({
 	timestamp: number(),
 	frame: PipelineRunResultBridge
@@ -19486,10 +19565,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	*  stationary registry). Default false: the timeline lists passages,
 	*  not parking records (operator decision, 2026-08-15). */
 	includeStationary: boolean().optional()
-}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(ListGroupsQueryInput, ListGroupsPageSchema), method(object({
-	deviceId: number(),
-	groupId: string$2().min(1)
-}), AnalyticsGroupDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
+}), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
 }), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
@@ -19589,6 +19665,12 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
 	kind: "query",
 	auth: "admin"
+}), method(MediaReclaimInputSchema, MediaReclaimStartResultSchema, {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({}), MediaReclaimStatusSchema, {
+	kind: "query",
+	auth: "admin"
 }), method(object({ deviceIds: array(number()).optional() }), TrainingExportSummarySchema, {
 	kind: "query",
 	auth: "admin"
@@ -21559,7 +21641,13 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
 }), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string$2() }), {
 	kind: "mutation",
 	auth: "admin"
-});
+}), method(StorageCleanupInputSchema, object({ jobId: string$2() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(StorageCleanupStatusInputSchema, StorageCleanupJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string$2() }), object({ cancelled: boolean() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({}), array(StorageMigrationJobSchema).readonly(), { auth: "admin" });
 var ProviderInfoSchema = discriminatedUnion("shouldSaveDiskSpace", [object({
 	providerId: string$2().min(1),
 	displayName: string$2().min(1),
@@ -28669,6 +28757,33 @@ var RecordingRebalanceInputSchema = object({
 	minMoveGb: number().min(0).optional()
 });
 /**
+* Operator-facing placement of one camera onto a recordings location.
+*
+* `pinLocationId` is the operator instruction: a location id, or `null` for
+* Auto (the planner may move this camera). `locationId` is where high/mid
+* currently write — the plan, which may disagree with the pin when Auto.
+*/
+var RecordingDevicePlacementSchema = object({
+	deviceId: number().int(),
+	profile: string$2(),
+	locationId: string$2()
+});
+var RecordingDevicePinSchema = object({
+	deviceId: number().int(),
+	/** Recordings-class location this camera is pinned to. */
+	locationId: string$2()
+});
+var RecordingPlacementViewSchema = object({
+	assignments: array(RecordingDevicePlacementSchema),
+	pins: array(RecordingDevicePinSchema),
+	defaultLocations: record(string$2(), string$2())
+});
+var RecordingSetDevicePlacementInputSchema = object({
+	deviceId: number().int(),
+	/** `null` = Auto. Otherwise a `recordings:*` location id. */
+	locationId: string$2().nullable()
+});
+/**
 * Result of locating footage at a wall-clock instant for one device/profile.
 * `segment` carries the covering segment's window; `gap` reports the forward
 * nearest covered edge (`null` past the end of footage / when none exists)
@@ -28894,6 +29009,12 @@ method(object({
 }), method(RecordingRebalanceInputSchema, RecordingRebalancePlanSchema, {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({}), RecordingPlacementViewSchema, {
+	kind: "query",
+	auth: "admin"
+}), method(RecordingSetDevicePlacementInputSchema, object({ ok: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
 });
 /**
 * `recording-export` cap — render a footage time range into a single downloadable
@@ -33963,6 +34084,12 @@ Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"deviceManager.renameLocation": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.runDeviceAction": {
 		capName: "device-manager",
 		capScope: "system",
@@ -35655,19 +35782,19 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.getGroup": {
+	"pipelineAnalytics.getKeyEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.getKeyEvents": {
+	"pipelineAnalytics.getKeyEventsBatch": {
 		capName: "pipeline-analytics",
 		capScope: "device",
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.getKeyEventsBatch": {
+	"pipelineAnalytics.getMediaReclaimStatus": {
 		capName: "pipeline-analytics",
 		capScope: "device",
 		addonId: null,
@@ -35757,12 +35884,6 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
-	"pipelineAnalytics.listGroups": {
-		capName: "pipeline-analytics",
-		capScope: "device",
-		addonId: null,
-		access: "view"
-	},
 	"pipelineAnalytics.listOpsLog": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -35847,6 +35968,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.reclaimDebugMedia": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineAnalytics.reconcileFromDisk": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -36771,6 +36898,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"recording.getPlacement": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"recording.getPlaybackManifest": {
 		capName: "recording",
 		capScope: "system",
@@ -36897,6 +37030,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"recording.setDevicePlacement": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"recording.startStorageMigrationMove": {
 		capName: "recording",
 		capScope: "system",
@@ -37341,12 +37480,36 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"storageMigration.cleanupCancel": {
+		capName: "storage-migration",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"storageMigration.cleanupStart": {
+		capName: "storage-migration",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"storageMigration.cleanupStatus": {
+		capName: "storage-migration",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"storageMigration.drain": {
 		capName: "storage-migration",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"storageMigration.history": {
+		capName: "storage-migration",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"storageMigration.movers": {
 		capName: "storage-migration",
 		capScope: "system",
@@ -39343,11 +39506,6 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
-	"pipelineAnalytics.getGroup": [{
-		name: "deviceId",
-		form: "single",
-		optional: false
-	}],
 	"pipelineAnalytics.getKeyEvents": [{
 		name: "deviceId",
 		form: "single",
@@ -39413,11 +39571,6 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
-	"pipelineAnalytics.listGroups": [{
-		name: "deviceIds",
-		form: "array",
-		optional: false
-	}],
 	"pipelineAnalytics.listOpsLog": [{
 		name: "deviceId",
 		form: "single",
@@ -39463,6 +39616,11 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"pipelineAnalytics.reclaimDebugMedia": [{
+		name: "deviceIds",
+		form: "array",
+		optional: true
+	}],
 	"pipelineAnalytics.reconcileFromDisk": [{
 		name: "deviceId",
 		form: "single",
@@ -39828,6 +39986,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"recording.setDevicePlacement": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"recording.startStorageMigrationMove": [{
 		name: "deviceId",
 		form: "single",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-matter-broker",
-  "version": "0.2.48",
+  "version": "0.2.50",
   "description": "Matter broker addon for CamStack — owns a Matter fabric (commissioning + the long-lived controller) via the matter.js controller and brokers commissioned Matter nodes into CamStack",
   "keywords": [
     "camstack",