@camstack/addon-provider-homeassistant 1.2.5 → 1.2.7

package/dist/addon.mjs

@@ -7317,35 +7317,22 @@ function buildCapturingReply(envelope) {
 */
 var RecordingWeekdaySchema = number().int().min(0).max(6);
 var HHMM = /^([01]\d|2[0-3]):[0-5]\d$/;
-var RecordingScheduleSchema = discriminatedUnion("kind", [object({ kind: literal("always") }), object({
-	kind: literal("timeOfDay"),
-	start: string().regex(HHMM),
-	end: string().regex(HHMM),
-	/** Restrict to these weekdays; omit = every day. */
-	days: array(RecordingWeekdaySchema).optional()
-})]);
-var RecordingModeSchema = _enum([
-	"continuous",
-	"onMotion",
-	"onAudioThreshold"
-]);
 /**
-* First-class, authoritative per-camera storage mode — the explicit choice the
-* UI reads directly (never inferred from `rules`):
-*  - `off`        — not recording.
-*  - `events`     — record only around triggers (motion / audio threshold),
-*                   with pre/post-buffer.
-*  - `continuous` — record 24/7 within the schedule.
+* DERIVED per-camera storage summary — the single field cheap consumers read
+* (the viewer's status dot, the camera list) instead of walking `bands`:
+*  - `off`        — no band covers the camera (or it is disabled).
+*  - `events`     — every band records around triggers only.
+*  - `continuous` — at least one band records continuously.
 *
-* `mode` compiles one-way to the internal `rules[]` consumed by the policy
-* engine (see `compileRules`); `rules[]` is never authored directly anymore.
+* NEVER authored: the recorder stamps it from the authoritative `bands` on
+* every save (`activeModeForConfig`). Writing it has no effect.
 */
 var RecordingStorageModeSchema = _enum([
 	"off",
 	"events",
 	"continuous"
 ]);
-/** Which detectors trigger an `events`-mode recording. */
+/** Which detectors trigger an `events`-mode band. */
 var RecordingTriggersSchema = object({
 	motion: boolean().optional(),
 	audioThresholdDbfs: number().optional()
@@ -7381,18 +7368,6 @@ var RecordingBandSchema = object({
 	preBufferSec: number().min(0).optional(),
 	postBufferSec: number().min(0).optional()
 });
-var RecordingRuleSchema = object({
-	schedule: RecordingScheduleSchema,
-	mode: RecordingModeSchema,
-	/** Seconds of footage to retain BEFORE a trigger (applied at keep/discard). */
-	preBufferSec: number().min(0).default(0),
-	/** Keep recording until this many seconds after the last trigger. */
-	postBufferSec: number().min(0).default(0),
-	/** Each new trigger restarts the post-buffer window. */
-	resetTimeoutOnNewEvent: boolean().default(true),
-	/** onAudioThreshold only — dBFS level that counts as a trigger. */
-	thresholdDbfs: number().optional()
-});
 /**
 * Per-device retention overrides. Every field is optional; an unset or `0`
 * value inherits the node-wide recorder default. Only footage-lifetime limits
@@ -7426,40 +7401,28 @@ var ScrubThumbnailPresetSchema = _enum([
 /**
 * The full per-camera recording intent — the wire shape of a RecordingTarget.
 *
-* `mode` is the authoritative storage choice; `schedule`/`triggers`/`pre`/`post`
-* are its mode-specific parameters. `rules` is a DEPRECATED authoring input kept
-* only for transition + migration (`migrateRulesToMode`); the policy engine
-* consumes the compiled output of `compileRules(config)`, never `rules` directly.
+* `bands` is the ONLY authored recording intent: what to record, when, and on
+* which trigger. `mode` is a derived summary the recorder stamps on save; every
+* other field is a storage knob (profiles, segment length, retention, scrub).
+*
+* STRICT on purpose: the legacy authoring surface (`schedule`/`schedules`/
+* `triggers`/`preBufferSec`/`postBufferSec`/`rules`) was retired 2026-07-30.
+* A stale caller must fail loudly — silently stripping its legacy intent would
+* persist a band-less config, i.e. silently stop recording the camera.
 */
 var RecordingConfigSchema = object({
 	enabled: boolean(),
-	/** Authoritative storage mode. Absent on legacy targets → derived once via
-	*  `migrateRulesToMode`, then persisted. */
+	/** DERIVED summary of `bands`, stamped by the recorder on every save.
+	*  Authoring it has no effect — see {@link RecordingStorageModeSchema}. */
 	mode: RecordingStorageModeSchema.optional(),
 	profiles: array(CamProfileSchema).optional(),
 	segmentSeconds: number().int().positive().optional(),
-	/** Shared recording time-bands for `events` & `continuous` — record only when
-	*  the wall-clock falls inside one of these windows. Omit or empty = always.
-	*  `continuous` compiles to one rule per band; `events` to band × trigger. */
-	schedules: array(RecordingScheduleSchema).optional(),
-	/** Legacy single-band predecessor of `schedules`. Read-compat only — it is
-	*  normalized into `schedules` on read and never written going forward. (Not
-	*  tagged `@deprecated`: the normalization paths must read it cast-free.) */
-	schedule: RecordingScheduleSchema.optional(),
-	/** `events`-mode only — which detectors trigger a recording. */
-	triggers: RecordingTriggersSchema.optional(),
-	/** `events`-mode only — seconds retained before / after a trigger. */
-	preBufferSec: number().min(0).optional(),
-	postBufferSec: number().min(0).optional(),
-	/** DEPRECATED authoring input; retained for migration/transition. */
-	rules: array(RecordingRuleSchema).optional(),
 	/**
-	* AUTHORITATIVE mode-per-band recording model (recorder). When present it
-	* is the single source of truth; the legacy `mode`/`schedules`/`schedule`/
-	* `triggers`/`rules` fields above are kept for READ-COMPAT only and are
-	* derived into bands once via `migrateConfigToBands`.
+	* AUTHORITATIVE mode-per-band recording model — the single source of truth
+	* the recorder's band engine consumes. An empty array = record nothing;
+	* "off" is the absence of a covering band, never a band value.
 	*/
-	bands: array(RecordingBandSchema).optional(),
+	bands: array(RecordingBandSchema).default([]),
 	retention: RecordingRetentionSchema.optional(),
 	/**
 	* Per-camera scrub-thumbnail fidelity preset (resolution + JPEG quality for
@@ -7467,8 +7430,15 @@ var RecordingConfigSchema = object({
 	* windows only — existing sheets are immutable, and each window's index
 	* carries its own tile dims so mixed-preset history renders correctly.
 	*/
-	scrubThumbnails: ScrubThumbnailPresetSchema.optional()
-});
+	scrubThumbnails: ScrubThumbnailPresetSchema.optional(),
+	/**
+	* OPT-IN thumbnail-strip generation for this camera: every keyframe of the
+	* low recording saved as a JPEG (the fast-drag scrub depth), a derived
+	* cache that eviction reclaims with the footage. Absent/false = no strips
+	* are written and scrub reads exact keyframes at every velocity.
+	*/
+	stripsEnabled: boolean().optional()
+}).strict();
 /**
 * Ops-log — the durable, append-only operations audit shared by the
 * recordings and events management surfaces.
@@ -7487,7 +7457,8 @@ var OpsLogOpSchema = _enum([
 	"prune",
 	"manual-delete",
 	"rescan",
-	"retention-run"
+	"retention-run",
+	"relocate"
 ]);
 /** Why the operation ran. */
 var OpsLogReasonSchema = _enum([
@@ -7526,6 +7497,55 @@ var OpsLogQueryInputSchema = object({
 	limit: number().int().min(1).max(1e3).optional()
 });
 /**
+* Entity-relocation job state (storage entity-routing spec, Phase 4).
+*
+* One shape shared by the recorder's `relocateFootage` (segments + strips) and
+* pipeline-analytics' `relocateMedia` (event media blobs) so the admin Data
+* page renders both movers with one component. Jobs are in-RAM (a restart
+* forgets them — re-running is safe by construction: copy-if-absent, delete
+* after verify) and each completed/failed run also lands one durable ops-log
+* row on the owning addon's surface.
+*/
+var RelocateJobStateSchema = _enum([
+	"running",
+	"done",
+	"failed",
+	"cancelled"
+]);
+var RelocateJobSchema = object({
+	jobId: string(),
+	state: RelocateJobStateSchema,
+	/** Source location — for media relocation this is informational ('*': rows
+	*  move from wherever they are to the target). */
+	fromLocationId: string(),
+	toLocationId: string(),
+	/** Scoped device, or null = every device. */
+	deviceId: number().nullable(),
+	/** What the job moves (owner-addon specific: segments/strips or media). */
+	entities: array(string()),
+	filesMoved: number().int(),
+	bytesMoved: number().int(),
+	/** Total files discovered up front; null while (or when) unknown. */
+	filesTotal: number().int().nullable(),
+	startedAt: number(),
+	finishedAt: number().nullable(),
+	error: string().nullable()
+});
+var RelocateFootageInputSchema = object({
+	deviceId: number().optional(),
+	fromLocationId: string(),
+	toLocationId: string(),
+	entities: array(_enum(["segments", "strips"])).optional(),
+	/** Copy throttle in MB/s (default 40) — the drain is a background chore,
+	*  never allowed to starve live writers. */
+	throttleMbps: number().min(1).max(1e3).optional()
+});
+var RelocateMediaInputSchema = object({
+	deviceId: number().optional(),
+	toLocationId: string(),
+	throttleMbps: number().min(1).max(1e3).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
@@ -7575,6 +7595,13 @@ var StorageLocationSchema = object({
 	nodeId: string().optional(),
 	isDefault: boolean().default(false),
 	isSystem: boolean().default(false),
+	/** COMPUTED at read time by the orchestrator (statfs of the backing volume
+	*  for node-local locations it can reach) — never persisted, absent when the
+	*  volume is remote/unreachable. The single capacity truth every UI reads. */
+	capacity: object({
+		totalBytes: number(),
+		availableBytes: number()
+	}).nullable().optional(),
 	createdAt: number(),
 	updatedAt: number()
 });
@@ -7636,16 +7663,23 @@ var StorageLocationDeclarationSchema = object({
 	* Which node root the seeded `<id>:default` instance is placed under on a
 	* FRESH install:
 	* - `'data'` (default) — the node's data dir (`CAMSTACK_DATA` / boot dir),
-	*   the appData volume. Right for small/durable data (backups, logs, models).
+	*   the appData volume. Right for small/durable data (logs, models).
 	* - `'media'` — the dedicated media volume (`CAMSTACK_MEDIA_ROOT`) when that
 	*   env is set, else falls back to the data root. Right for bulky, hot media
 	*   (recordings, event media) that should stay off the appData disk.
+	* - `'backup'` — the dedicated backup volume (`CAMSTACK_BACKUP_ROOT`, default
+	*   `/backups` in the image) so archives live on their own mount rather than
+	*   filling the appData disk. Falls back to the data root when unset.
 	*
 	* Only affects the seeded default's `basePath`; operators can repoint any
 	* location afterwards, and a `defaultsTo` slot inherits its parent's root
 	* regardless of this field. Absent (the common case) is treated as `'data'`.
 	*/
-	defaultRoot: _enum(["data", "media"]).optional()
+	defaultRoot: _enum([
+		"data",
+		"media",
+		"backup"
+	]).optional()
 });
 var DecoderStatsSchema = object({
 	inputFps: number(),
@@ -8335,7 +8369,8 @@ var NcTaxonomyEntrySchema = object({
 	/** Macro/category parent for grouping ('car' → 'vehicle'); null for a top. */
 	parentKind: string().nullable()
 });
-object({
+/** The complete NC picker taxonomy — three grouped buckets. */
+var NcTaxonomySchema = object({
 	videoClasses: array(NcTaxonomyEntrySchema),
 	audioKinds: array(NcTaxonomyEntrySchema),
 	labels: array(NcTaxonomyEntrySchema)
@@ -9301,9 +9336,20 @@ var DEGRADE_ORDER = {
 		"markdown"
 	]
 };
-/** Pick the best target format the kind supports for a given source format. */
+/**
+* Pick the best target format the kind supports for a given source format.
+*
+* TOLERANT of a source outside the union. `NotificationSchema.format` carries
+* `.default('text')`, but that default only runs where the schema is PARSED —
+* the tRPC router. A cap call arriving from another addon (`ctx.api`) skips
+* that parse, so `format` reaches here `undefined`, and the bare
+* `DEGRADE_ORDER[source]` threw `is not iterable`. That broke the one promise
+* the degrade path makes ("never throws — degradation is reported, never
+* surfaced as an error") and dead-lettered every Notification-Center delivery
+* for a day (2026-07-30). An unknown source degrades like `text`.
+*/
 function resolveFormat(source, supported) {
-	for (const candidate of DEGRADE_ORDER[source]) if (supported.includes(candidate)) return candidate;
+	for (const candidate of DEGRADE_ORDER[source] ?? DEGRADE_ORDER.text) if (supported.includes(candidate)) return candidate;
 	return supported[0] ?? "text";
 }
 /** Transcode a body between formats. */
@@ -9348,7 +9394,7 @@ function resolveLevel(levels, n) {
 	})[0]);
 }
 function splitBody(body, maxLen) {
-	if (maxLen <= 0 || body.length <= maxLen) return [body];
+	if (!Number.isFinite(maxLen) || maxLen <= 0 || body.length <= maxLen) return [body];
 	const parts = [];
 	for (let i = 0; i < body.length; i += maxLen) parts.push(body.slice(i, i + maxLen));
 	return parts;
@@ -9431,147 +9477,849 @@ function prepareNotification(caps, n) {
 		renderedAs
 	};
 }
+new Set(["devices", "classes"]);
 /**
-* Generic device-level status snapshot. Auto-registered by `BaseDevice`
-* for every device, regardless of provider — the kernel needs a uniform
-* cap-keyed slice for the basic device flags every consumer expects to
-* read across processes (the `online` flag in particular). Driver-specific
-* caps (`battery`, `doorbell`, …) carry their domain-specific state on
-* their own slices.
+* Shared geometry vocabulary for on-frame shape caps — privacy-mask,
+* motion-zones, and the detection zones/lines editor all speak this one
+* language so a single drawing-plane editor and the providers stay
+* decoupled from each cap's storage.
 *
-* Pattern is identical to `battery`: schema-bearing `runtimeState`,
-* empty `methods`, single change event. Reads land at
-* `runtimeState.getCapState('device-status')`; writes at
-* `runtimeState.setCapState('device-status', …)`. Cross-process
-* consumers reach the same data via the `device-state` cap router
-* (`getCapSlice({deviceId, capName: 'device-status'})`).
+* All coordinates are normalized 0..1 of the camera frame (top-left
+* origin). Each cap composes the SUBSET of shape kinds it supports and
+* advertises it via `supportedShapes` in its `getOptions`.
 */
-var DeviceStatusSchema = object({
-	/**
-	* Device-level liveness. Drivers flip via `markOnline(boolean)` on
-	* `BaseDevice`. Provider semantics vary — RTSP aggregates broker
-	* stream-health, Reolink reads firmware push events, ONVIF tracks
-	* ping responses. This cap intentionally does NOT prescribe which
-	* signal drives the flag.
-	*/
-	online: boolean(),
-	/** Ms epoch of the last `online` transition. Lets consumers tell
-	*  apart "just came online" from "still online". */
-	lastChangedAt: number()
+/** A normalized 0..1 point (top-left origin). */
+var MaskPointSchema = object({
+	x: number(),
+	y: number()
+});
+/** Axis-aligned rectangle (normalized 0..1). */
+var MaskRectShapeSchema = object({
+	kind: literal("rect"),
+	x: number(),
+	y: number(),
+	width: number(),
+	height: number()
+});
+/** Free polygon — an ordered list of normalized vertices (≥3). */
+var MaskPolygonShapeSchema = object({
+	kind: literal("polygon"),
+	points: array(MaskPointSchema)
+});
+/** Boolean cell grid — row-major, length === gridWidth*gridHeight. */
+var MaskGridShapeSchema = object({
+	kind: literal("grid"),
+	gridWidth: number(),
+	gridHeight: number(),
+	cells: array(boolean())
+});
+discriminatedUnion("kind", [
+	MaskRectShapeSchema,
+	MaskPolygonShapeSchema,
+	MaskGridShapeSchema,
+	object({
+		kind: literal("line"),
+		points: array(MaskPointSchema)
+	})
+]);
+/** Every shape-kind discriminant, for `supportedShapes` advertisement. */
+var MaskShapeKindSchema = _enum([
+	"rect",
+	"polygon",
+	"grid",
+	"line"
+]);
+/** Polygon vertex bounds when a cap supports 'polygon' (e.g. Hikvision {min:4,max:4}). */
+var MaskPolygonVerticesSchema = object({
+	min: number(),
+	max: number()
+});
+/** Grid dimensions when a cap supports 'grid'. */
+var MaskGridDimsSchema = object({
+	width: number(),
+	height: number()
 });
-var deviceStatusCapability = {
-	name: "device-status",
-	scope: "device",
-	deviceNative: true,
-	mode: "singleton",
-	methods: {},
-	events: { 
-	/** Emitted when `online` transitions. Mirrors the semantics of
-	*  `battery.onStatusChanged`. */
-onStatusChanged: { data: object({
-		deviceId: number(),
-		status: DeviceStatusSchema
-	}) } },
-	status: {
-		schema: DeviceStatusSchema,
-		kind: "push"
-	},
-	runtimeState: DeviceStatusSchema
-};
 /**
-* Per-device feature/identity probe slice. Holds the runtime-resolved
-* truth about what a device CAN do — which the kernel uses to:
-*   1. Reconcile accessory children (hub-children spawn siren/floodlight/PIR
-*      based on what the firmware actually advertises).
-*   2. Compute the public `features: DeviceFeature[]` array surfaced via
-*      `device-manager.listAll`.
-*   3. Decide which optional caps (PTZ, intercom, doorbell, battery, …)
-*      to register on the device's capability surface.
+* notification-rules — the Notification Center rule surface (P1 core).
 *
-* Auto-registered by `BaseDevice` for every device. Drivers populate the
-* slice from `onProbe()` (kernel calls it once after register, before
-* accessory reconciliation). Consumers read via:
-*   `runtimeState.getCapState<FeatureProbeStatus>('feature-probe')`
+* Spec: `docs/superpowers/specs/2026-07-22-notification-center-requirements.md`
+* (operator decisions D-1/D-2/D-3 are binding):
 *
-* `flags` is an open record so each driver carries its own keys without
-* a centralized schema bottleneck — Reolink writes `hasPtz/hasIntercom`,
-* Hikvision writes `hasSupplementalLight/hasAlarmIo`, etc.
+*  - D-2: rule EVALUATION lives in `addon-post-analysis` (the
+*    `notification-center` module), hooked on the durable persistence
+*    moments (object-event insert, TrackCloser.closeExpired) with a
+*    persisted outbox + retry — never the lossy telemetry bus (D8).
+*  - D-3: urgency belongs to the RULE. `delivery: 'immediate'` fires on the
+*    FIRST persisted detection matching the conditions (per-track dedup,
+*    `maxPerTrack` fixed at 1 — see {@link NC_MAX_PER_TRACK_IMMEDIATE});
+*    `delivery: 'track-end'` evaluates the finalized track record at close.
+*  - DISPATCH stays behind `notification-output` (rules reference targets
+*    by id; per-backend params are a passthrough blob capped by the
+*    target kind's own caps/degrade engine).
 *
-* Replaces the older driver-local `deviceCache.has*` blob: the per-device
-* config is for operator-edited overrides + UI snapshots; runtime probe
-* results belong in runtime-state where the kernel handles persistence,
-* cross-process mirroring, and reactive updates.
+* P1 scope: admin-authored rules only (`createdBy` stamped from the
+* server-injected caller identity — the first `caller: 'required'`
+* adopter). The P1 condition subset is: devices, classes(+exclude),
+* minConfidence, admin zones (any/all + exclude), weekly schedule
+* windows, and the optional label/identity/plate matchers. User rules,
+* private zones, per-recipient fan-out and the wider condition table are
+* P2+ (see spec §7).
+*
+* All schemas here are the single source of truth — `NcRule` etc. are
+* `z.infer` exports; no duplicate interfaces (the advanced-notifier
+* schema/interface drift is explicitly not repeated).
 */
-var FeatureProbeStatusSchema = object({
-	/**
-	* Driver-specific flag bag. Each driver picks its own key names — the
-	* cap deliberately does NOT enforce a closed enum here. Reolink keys:
-	* `hasPtz`, `hasIntercom`, `hasDoorbell`, `hasFloodlight`, `hasSiren`,
-	* `hasPirSensor`, `hasAutotrack`, `hasBattery`. Hikvision keys:
-	* `hasSupplementalLight`, `lightHasWhiteLight`, `hasAlarmIo`, `hasPtz`.
-	*/
-	flags: record(string(), unknown()),
-	/**
-	* Coarse driver-classification — lets cross-process consumers tell apart
-	* cameras / battery-cams / NVRs without re-running the probe. `null`
-	* before the first probe completes.
-	*/
-	deviceType: string().nullable(),
-	/** Camera/firmware model string. `null` when the firmware doesn't expose it. */
-	model: string().nullable(),
-	/** Channel count for NVR/Hub devices; `1` for standalone cameras; `null` pre-probe. */
-	channelCount: number().nullable(),
-	/**
-	* Ms epoch of the last SUCCESSFUL probe. `0` before the first probe
-	* completes — drivers' `getAccessoryChildren()` should treat zero as
-	* "probe not done yet, return empty" so accessories aren't spawned
-	* before the firmware is queried.
-	*/
-	lastProbedAt: number(),
-	/**
-	* Framework convention: every runtime-state slice carries this for the
-	* createRuntimeStateBridge stale-check helper. We keep it in sync with
-	* `lastProbedAt` on every write.
-	*/
-	lastFetchedAt: number()
-});
-var featureProbeCapability = {
-	name: "feature-probe",
-	scope: "device",
-	deviceNative: true,
-	mode: "singleton",
-	methods: {},
-	events: { 
-	/** Fires whenever a fresh probe completes (kernel-driven `reprobe()`
-	*  or driver-initiated re-detect after a state change). */
-onProbeChanged: { data: object({
-		deviceId: number(),
-		status: FeatureProbeStatusSchema
-	}) } },
-	status: {
-		schema: FeatureProbeStatusSchema,
-		kind: "push"
-	},
-	runtimeState: FeatureProbeStatusSchema
-};
 /**
-* Multi-metric air-quality slice. Covers CO₂, total VOCs, particulate
-* matter at PM2.5 / PM10, and a derived AQI index — all optional so
-* a single-metric source populates only what it observes. Mirrors
-* the HA `sensor` device_class set (`co2`, `volatile_organic_compounds`,
-* `pm25`, `pm10`, `aqi`) collapsed into one cap because a typical
-* air-quality node reports several of these together; modelling them
-* as siblings keeps a single timestamp + one slice subscription.
+* D-3: the trigger/urgency of a rule — which persistence moment evaluates it.
+* The value maps 1:1 onto the evaluated record kind:
+*  - `immediate`     ↔ object-event persist (lowest-latency detection burst)
+*  - `track-end`     ↔ TrackCloser.closeExpired (finalized track record)
+*  - `device-event`  ↔ SensorEventStore insert (doorbell press / sensor state
+*                       change of a LINKED device, one row per linked camera)
+*  - `package-event` ↔ PackageDropDetector object-event insert (a `package`
+*                       delivery / pick-up)
+*
+* `immediate`/`track-end` carry the D-3 urgency semantics; `device-event`/
+* `package-event` are pure trigger kinds (no urgency dimension). Extending
+* this one field keeps the schema additive — a rule still declares exactly
+* one trigger.
 */
-var AirQualitySensorStatusSchema = object({
-	/** Carbon dioxide concentration in ppm. */
-	co2Ppm: number().min(0).optional(),
-	/** Total volatile organic compounds in ppb. */
-	vocPpb: number().min(0).optional(),
-	/** Particulate matter ≤ 2.5 μm in µg/m³. */
-	pm25: number().min(0).optional(),
-	/** Particulate matter ≤ 10 μm in µg/m³. */
-	pm10: number().min(0).optional(),
+var NcDeliverySchema = _enum([
+	"immediate",
+	"track-end",
+	"device-event",
+	"package-event"
+]);
+/** Weekly schedule — OR of windows; absence on the rule = always active. */
+var NcScheduleSchema = object({
+	windows: array(object({
+		/** Days of week the window STARTS on (0 = Sunday … 6 = Saturday). */
+		days: array(number().int().min(0).max(6)).min(1),
+		startMinute: number().int().min(0).max(1439),
+		endMinute: number().int().min(0).max(1439)
+	})).min(1),
+	/** IANA timezone; default = hub host timezone. */
+	timezone: string().optional(),
+	/** Active OUTSIDE the windows (e.g. "only outside business hours"). */
+	invert: boolean().optional()
+});
+/** Fuzzy plate matcher — OCR noise makes exact match useless (spec row 12/13). */
+var NcPlateMatcherSchema = object({
+	values: array(string().min(1)).min(1),
+	/** Max Levenshtein distance after normalization (uppercase alphanumeric). */
+	maxDistance: number().int().min(0).max(3).default(1)
+});
+/**
+* Occupancy condition (DEVICE-EVENT trigger). Fires on a ZoneAnalytics
+* occupancy edge for a device — optionally narrowed to a single admin
+* `zoneId` and/or object `className`. `op` selects the edge/threshold:
+*  - `became-occupied` (default) — count crossed 0 → ≥ `count`
+*  - `became-free`               — count crossed ≥ `count` → below it
+*  - `>=` / `<=`                 — count is at/over or at/under `count`
+* `sustainSeconds` requires the condition hold continuously that long
+* before firing (debounces flicker; 0 = fire on the first matching edge).
+* Fail-closed: no ZoneAnalytics snapshot / missing zone / null snapshot ⇒
+* the condition never matches. Confirmed edge-state survives addon restarts
+* (declared SQLite collection, reseeded on boot).
+*/
+var NcOccupancyConditionSchema = object({
+	/** Admin zone id to scope the count to; absent = whole-frame occupancy. */
+	zoneId: string().optional(),
+	/** Object class to count; absent = any class. */
+	className: string().optional(),
+	op: _enum([
+		"became-occupied",
+		"became-free",
+		">=",
+		"<="
+	]).default("became-occupied"),
+	count: number().int().min(0).default(1),
+	sustainSeconds: number().int().min(0).max(3600).default(15)
+});
+/** Admin-zone membership condition (zone IDs as stamped by the ZoneEngine). */
+var NcZoneConditionSchema = object({
+	ids: array(string().min(1)).min(1),
+	/** Quantifier over `ids` — at least one / every one visited. */
+	match: _enum(["any", "all"]).default("any")
+});
+/**
+* The P1 condition set — a flat AND of groups; absent group = pass;
+* membership lists are OR within the list (spec §2.3).
+*/
+var NcConditionsSchema = object({
+	/** Device scope — absent = all devices. */
+	devices: array(number()).optional(),
+	/** Detector class names (any overlap with the record's class set). */
+	classes: array(string().min(1)).optional(),
+	/** Veto classes — any overlap fails the rule. */
+	classesExclude: array(string().min(1)).optional(),
+	/** Minimum detection confidence 0–1 (fails when the record has none). */
+	minConfidence: number().min(0).max(1).optional(),
+	/** Admin zone membership over event `zones` / track `zonesVisited`. */
+	zones: NcZoneConditionSchema.optional(),
+	/** Veto zones — any hit fails the rule. */
+	zonesExclude: array(string().min(1)).optional(),
+	/**
+	* Exact (case-insensitive) match on the record's collapsed `label`
+	* (identity name / plate text / subclass).
+	*/
+	labelEquals: array(string().min(1)).optional(),
+	/**
+	* Identity matcher. P1 boundary: matched against the record's collapsed
+	* `label` (the identity display name propagated by the face pipeline) —
+	* identity-ID matching rides in P2 when identity ids reach the record.
+	*/
+	identities: array(string().min(1)).optional(),
+	/** Fuzzy plate matcher against the record's `label` (plate text). */
+	plates: NcPlateMatcherSchema.optional(),
+	/**
+	* Identity EXCLUDE — mirror of {@link identities} with `notIn` semantics.
+	* Same P1 boundary: matched against the record's collapsed `label` (the
+	* identity display name). A record with NO label passes (nothing to
+	* exclude), unlike the include variant which fails on an absent label.
+	*/
+	identitiesExclude: array(string().min(1)).optional(),
+	/**
+	* Minimum server-computed key-event importance in [0,1] (`Track.importance`).
+	* TRACK-END only: importance is scored at track close, so it does not exist
+	* at immediate / object-event evaluation time (see catalog `appliesTo`). At
+	* close the value is threaded via the close-time info (the `Track` clone is
+	* captured before the DB row is updated, so it would otherwise read stale).
+	* Fails when the record carries no importance (never guess quality — the
+	* `minConfidence` precedent). MVP cut: a single scalar threshold.
+	*/
+	minImportance: number().min(0).max(1).optional(),
+	/**
+	* Minimum track dwell in SECONDS — `(lastSeen − firstSeen) / 1000`.
+	* TRACK-END only: an `immediate` / object-event subject has no closed
+	* lifespan, so a dwell condition never matches immediate delivery
+	* (documented choice — the object-event record carries no `firstSeen`,
+	* so dwell cannot be computed from what the subject actually carries).
+	*/
+	minDwellSeconds: number().min(0).optional(),
+	/**
+	* Detection provenance filter. `any` (default / absent) matches every
+	* source; otherwise the subject's source must equal it. Legacy records
+	* with no stamped source are treated as `pipeline`. The union spans both
+	* record kinds — object events carry `pipeline` | `onboard`, synthetic
+	* tracks carry `sensor`.
+	*/
+	source: _enum([
+		"pipeline",
+		"onboard",
+		"sensor",
+		"any"
+	]).optional(),
+	/**
+	* Minimum identity / plate MATCH confidence in [0,1] — DISTINCT from the
+	* detector `minConfidence` (that gates the object-detection score; this
+	* gates the recognition/OCR match score). Fails when the subject carries
+	* no label-match confidence (never guess). TRACK-END only: the confidence
+	* lives on the recognition result and reaches the subject at track close.
+	*
+	* What it measures precisely (plumbed at track close — the closer threads
+	* the value into `NcTrackClosedInfo.labelConfidence`, the same seam as
+	* `importance`): the BEST recognition match confidence observed for the
+	* label the track carries at close — for a face, the peak cosine similarity
+	* of the ASSIGNED identity (`FaceMatch.score`, reset on an identity switch);
+	* for a plate, the peak OCR read score of the best-held plate
+	* (`plateText.confidence`). When BOTH a face and a plate were recognized on
+	* one track the higher of the two is used. A track that ended with no
+	* confident identity/plate match carries no value, so the condition fails
+	* closed for it (an un-recognized subject).
+	*/
+	minLabelConfidence: number().min(0).max(1).optional(),
+	/**
+	* DEVICE-EVENT only. Raw device event-type tokens (`EventFire.eventType`,
+	* e.g. a doorbell `press` / `press_long`) — matched case-insensitively
+	* against the token carried on the device-event subject (extracted from the
+	* event-emitter runtime slice's `lastEvent.eventType`). Fails when the
+	* subject carries no token. Doorbell-pulse / passive-sensor kinds emit no
+	* eventType, so gate those with {@link sensorKinds} instead.
+	*/
+	eventTypeTokens: array(string().min(1)).optional(),
+	/**
+	* DEVICE-EVENT only. Sensor/control taxonomy kinds (e.g. `doorbell`,
+	* `contact`, `button`, `device-event`) — matched against the persisted
+	* `SensorEvent.kind` (see `sensor-event-kinds.ts`). Membership is OR.
+	*/
+	sensorKinds: array(string().min(1)).optional(),
+	/**
+	* PACKAGE-EVENT only. Which package phase fires the rule — `delivered`
+	* (a parked parcel appeared), `picked-up` (it departed), or `both`. Fails
+	* when the subject's phase does not match (a subject always carries a phase
+	* on the package-event trigger).
+	*/
+	packagePhase: _enum([
+		"delivered",
+		"picked-up",
+		"both"
+	]).optional(),
+	/**
+	* PERSONAL-RULE custom zones (viewer-drawn). Inline normalized polygons
+	* (MaskShape vocabulary). A record passes when its bbox overlaps ANY
+	* listed polygon (ZoneEngine membership semantics). Evaluated only when
+	* the subject carries a bbox; absent bbox ⇒ the condition FAILS.
+	*/
+	customZones: array(MaskPolygonShapeSchema).optional(),
+	/**
+	* DEVICE-EVENT only. ZoneAnalytics occupancy edge — fires when a device's
+	* (optionally zone/class-scoped) occupancy count crosses the configured
+	* threshold and holds for `sustainSeconds`. Fail-closed on missing
+	* substrate (no snapshot / missing zone). See {@link NcOccupancyCondition}.
+	*/
+	occupancy: NcOccupancyConditionSchema.optional()
+});
+/** One delivery target: a `notification-output` Target ref + passthrough params. */
+var NcRuleTargetSchema = object({
+	/** `notification-output` Target id. */
+	targetId: string().min(1),
+	/**
+	* Per-backend passthrough. Recognized keys are mapped onto the canonical
+	* Notification (`priority`, `level`, `sound`, `clickUrl`, `ttl`); the
+	* degrade engine drops what the backend can't render.
+	*/
+	params: record(string(), unknown()).optional()
+});
+/**
+* Media attachment policy (P1 still-image subset).
+*  - `best` — the best AVAILABLE subject image at dispatch time (D-3).
+*  - `best-matching` — the media that explains WHY the rule fired: a rule
+*    matched on identities attaches the subject's `faceCrop`, one matched on
+*    plates attaches the `plateCrop`; a rule with no identity/plate condition
+*    (or when the specific crop is missing) degrades to `best`, then
+*    `keyFrame`, then no attachment — never delaying the send. The matched
+*    condition summary is frozen on the outbox row at enqueue (like the rule
+*    name), so the choice never drifts from the record that fired it.
+*  - `keyFrame` — the clean scene frame (no subject box).
+*  - `none` — no attachment.
+*/
+/**
+* WHAT THE PICTURE SHOWS — chosen explicitly, because the implicit ladders
+* conflate it with the selection strategy and betray the request: asking for
+* the clean scene frame on an object-event owner used to start at
+* `fullFrameBoxed`, i.e. the annotated frame (2026-07-30).
+*  - `cropped` — the subject, tight. What "who is at the door" wants.
+*  - `full`    — the clean scene, no annotation. What "what is going on" wants.
+*  - `boxed`   — the scene WITH the detection boxes drawn, for verifying what
+*                the pipeline actually saw.
+*/
+var NcMediaFrameSchema = _enum([
+	"cropped",
+	"full",
+	"boxed"
+]);
+var NcMediaPolicySchema = object({
+	attach: _enum([
+		"best",
+		"best-matching",
+		"keyFrame",
+		"none"
+	]).default("best"),
+	/** What the still shows. Absent = `cropped` (the historical `best` shape). */
+	frame: NcMediaFrameSchema.optional(),
+	/** Crop the attached still to the rule's condition-zone bbox (padded) —
+	*  "show me the ZONE", not the whole scene or the subject crop. */
+	zoneCrop: boolean().optional(),
+	/**
+	* Also attach a short GIF cut from the stream broker's clip ring around the
+	* event — NOT from the recording, so the camera does not have to be
+	* recording, and the window sits AROUND the moment instead of a segment
+	* behind it. Fail-closed: a window the ring does not cover contributes no
+	* gif, never a failed notification.
+	*/
+	gif: boolean().optional(),
+	/**
+	* Also attach a short MP4 CLIP of the same cut. Same source and the same
+	* fail-closed rule as `gif`. Prefer it where the backend takes video
+	* (telegram, discord, zentik, webhook); backends that do not are handled by
+	* the degrade engine, which drops the video and keeps the still.
+	*/
+	clip: boolean().optional(),
+	/** Seconds of footage BEFORE / AFTER the event instant. Defaults 3 / 7. */
+	clipPreRollSec: number().int().min(0).max(30).optional(),
+	clipPostRollSec: number().int().min(0).max(30).optional(),
+	/**
+	* Which stream profile the footage is cut from. Absent = the CHEAPEST
+	* assigned profile: a notification is watched on a phone, so the 4K
+	* rendition would burn CPU to produce a file the client downscales anyway.
+	* A profile that is not assigned falls back to the cheapest, and the render
+	* reports which one actually ran.
+	*/
+	profile: CamProfileSchema.optional()
+});
+/** Throttle — cooldown survives restarts (rebuilt from the outbox on boot). */
+var NcThrottleSchema = object({
+	cooldownSec: number().int().min(0).max(86400).default(60),
+	/** `rule` = one shared cooldown; `rule-device` = per-camera cooldown. */
+	scope: _enum(["rule", "rule-device"]).default("rule-device")
+});
+/** Client-supplied rule fields (server stamps id/createdBy/createdAt/updatedAt). */
+var NcRuleInputSchema = object({
+	name: string().min(1).max(200),
+	enabled: boolean().default(true),
+	delivery: NcDeliverySchema,
+	conditions: NcConditionsSchema.default({}),
+	schedule: NcScheduleSchema.optional(),
+	/** May be empty when `targetUsers` addresses at least one user — the
+	*  "at least one addressee" invariant is enforced by the provider, because
+	*  a cross-field refine here would break `NcRulePatchSchema.partial()`. */
+	targets: array(NcRuleTargetSchema),
+	/**
+	* USERS this rule addresses in addition to `targets` (Phase 4). At fire
+	* time each user fans out to the personal targets they own
+	* (`config.ownerUserId`), filtered by that user's `allowedDevices` for the
+	* firing camera — a user is never notified about a device they cannot open.
+	* Per-user opt-outs (`disabledTargetIds`) still apply to the fanned-out
+	* targets.
+	*/
+	targetUsers: array(string()).optional(),
+	media: NcMediaPolicySchema.default({ attach: "best" }),
+	throttle: NcThrottleSchema.default({
+		cooldownSec: 60,
+		scope: "rule-device"
+	}),
+	/** `{{var}}` templating over camera/class/label/zones/confidence/time. */
+	template: object({
+		title: string().max(500).optional(),
+		body: string().max(2e3).optional()
+	}).optional(),
+	/** Canonical notification priority ordinal (1..5); per-target overridable. */
+	priority: number().int().min(1).max(5).default(3),
+	/**
+	* Ownership/visibility key. Absent = admin/global rule (unchanged legacy
+	* behaviour, visible to all, read-only in the viewer). Present = personal
+	* rule owned by this userId. Server-stamped; never trusted from a client.
+	*/
+	ownerUserId: string().optional()
+});
+/**
+* Partial patch for `updateRule` — any subset of the input fields, plus the
+* persisted-only {@link NcRuleSchema} `disabledTargetIds` set. The latter is
+* NOT a client-authored input field (it lives on the persisted rule, not the
+* input), so it is added here explicitly to let the store's per-target opt-out
+* toggle round-trip through the shared `update` path. Viewer opt-out mutations
+* still flow through `nc.setRuleTargetEnabled` (owner-checked), never a raw
+* `updateRule` patch.
+*/
+var NcRulePatchSchema = NcRuleInputSchema.partial().extend({ disabledTargetIds: array(string()).optional() });
+/** A persisted rule. */
+var NcRuleSchema = NcRuleInputSchema.extend({
+	id: string(),
+	/** userId of the admin who created the rule (server-stamped caller). */
+	createdBy: string(),
+	createdAt: number(),
+	updatedAt: number(),
+	/**
+	* Per-target opt-out set. A targetId here is suppressed for THIS rule at
+	* send time. Only a target's OWNER may add/remove its id (server-checked
+	* in `nc.setRuleTargetEnabled`). Defaults to empty.
+	*/
+	disabledTargetIds: array(string()).default([])
+});
+var NcTestResultSchema = object({
+	recordId: string(),
+	recordKind: _enum([
+		"object-event",
+		"track",
+		"device-event",
+		"package-event"
+	]),
+	deviceId: number(),
+	timestamp: number(),
+	wouldFire: boolean(),
+	/** Condition id that failed (first failing group), when `wouldFire` is false. */
+	failedCondition: string().optional(),
+	className: string().optional(),
+	label: string().optional()
+});
+var NcConditionDescriptorSchema = object({
+	/** Field id inside `NcConditions` (or `'schedule'` for the rule-level group). */
+	id: string(),
+	group: _enum([
+		"scope",
+		"class",
+		"zones",
+		"quality",
+		"label",
+		"schedule",
+		"device",
+		"package",
+		"occupancy"
+	]),
+	label: string(),
+	/** Editor widget the UI renders — never hardcode per-condition forms. */
+	valueType: _enum([
+		"deviceIdList",
+		"stringList",
+		"number01",
+		"number",
+		"sourceSelect",
+		"zoneSelection",
+		"zoneIdList",
+		"schedule",
+		"plateMatcher",
+		"packagePhase",
+		"polygonDraw",
+		"occupancy"
+	]),
+	operator: _enum([
+		"in",
+		"notIn",
+		"anyOf",
+		"allOf",
+		"gte",
+		"fuzzyIn",
+		"withinSchedule"
+	]),
+	/** Which delivery kinds the condition applies to. */
+	appliesTo: array(NcDeliverySchema),
+	phase: string(),
+	description: string().optional()
+});
+/**
+* The delivery lifecycle status of a history row — a straight read of the
+* durable outbox row's own status (single source of truth):
+*  - `pending` — enqueued, in-flight or retrying with backoff
+*  - `sent`    — delivered (terminal)
+*  - `dead`    — dead-lettered after exhausting retries / a permanent
+*                backend rejection / a deleted target (terminal; carries
+*                the failure `error`)
+*
+* P1 has no `suppressed-quiet-hours` / `snoozed` states — those ride the P2
+* user dimension (quiet hours / snooze) and are additive when they land.
+*/
+var NcHistoryStatusSchema = _enum([
+	"pending",
+	"sent",
+	"dead"
+]);
+/** The evaluated record kind a history row descends from (one per trigger). */
+var NcHistoryRecordKindSchema = _enum([
+	"object-event",
+	"track-end",
+	"device-event",
+	"package-event"
+]);
+/** Subject summary frozen on the row at fire time (survives rule/record edits). */
+var NcHistorySubjectSchema = object({
+	className: string(),
+	label: string().optional(),
+	confidence: number().optional(),
+	zones: array(string()),
+	timestamp: number()
+});
+/**
+* One delivery-history row. This is a read-only VIEW over the durable
+* outbox row (single source of truth — the same row the drain loop drives;
+* NO second write path, so history can never drift from delivery state).
+* The §3.2 fields map directly: `ruleId`/`targetId`/`deviceId` are columns,
+* `eventRef` is `recordKind`+`recordId`, `timestamps` are `createdAt`
+* (fire) / `updatedAt` (last transition), `status` + `error` are the
+* lifecycle. `ruleName` + `subject` are the intent snapshot frozen at
+* enqueue. `userId?` (per-recipient history) is P2 — no user dimension in
+* P1 (admin scope only).
+*/
+var NcHistoryEntrySchema = object({
+	/** Outbox row id — the stable dedup id `ruleId:dedupRef:targetId`. */
+	id: string(),
+	ruleId: string(),
+	/** Rule name frozen at fire time (outlives a later rename / delete). */
+	ruleName: string(),
+	/** The rule urgency/trigger that produced this delivery. */
+	delivery: NcDeliverySchema,
+	targetId: string(),
+	deviceId: number(),
+	recordKind: NcHistoryRecordKindSchema,
+	/** Event / track ref of the evaluated record (§3.2 `eventRef`). */
+	recordId: string(),
+	/** Present for track-scoped deliveries (object-event / track-end). */
+	trackId: string().optional(),
+	status: NcHistoryStatusSchema,
+	/** Delivery attempts made so far. */
+	attempts: number().int(),
+	/** Fire time (outbox enqueue). */
+	createdAt: number(),
+	/** Last transition time (terminal for sent / dead). */
+	updatedAt: number(),
+	/** Failure detail — present on a `dead` row. */
+	error: string().optional(),
+	subject: NcHistorySubjectSchema
+});
+/**
+* Query filter for `getHistory` (spec §4.2). Every field is a narrowing
+* AND; absent = unbounded on that axis. `since`/`until` bound the fire time
+* (`createdAt`, epoch ms, inclusive). `limit` is clamped to
+* {@link NC_HISTORY_LIMIT_MAX}. `userId` (per-recipient filtering) is P2.
+*/
+var NcHistoryFilterSchema = object({
+	ruleId: string().optional(),
+	deviceId: number().optional(),
+	status: NcHistoryStatusSchema.optional(),
+	since: number().optional(),
+	until: number().optional(),
+	limit: number().int().min(1).max(500).default(100)
+});
+method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), method(object({ ruleId: string() }), object({ rule: NcRuleSchema.nullable() }), { auth: "admin" }), method(object({ rule: NcRuleInputSchema }), object({ rule: NcRuleSchema }), {
+	kind: "mutation",
+	auth: "admin",
+	caller: "required"
+}), method(object({
+	ruleId: string(),
+	patch: NcRulePatchSchema
+}), object({ rule: NcRuleSchema }), {
+	kind: "mutation",
+	auth: "admin",
+	caller: "required"
+}), method(object({ ruleId: string() }), object({ success: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({
+	ruleId: string(),
+	enabled: boolean()
+}), object({ success: literal(true) }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({
+	rule: NcRuleInputSchema,
+	lookbackMinutes: number().int().min(1).max(1440).default(60)
+}), object({ results: array(NcTestResultSchema) }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({}), object({
+	catalog: array(NcConditionDescriptorSchema),
+	taxonomy: NcTaxonomySchema.optional()
+})), method(object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), object({ entries: array(NcHistoryEntrySchema) }), { auth: "admin" });
+/**
+* TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
+*
+* Spec: `docs/superpowers/specs/2026-07-24-nc-occupancy-timelapse-design.md`
+* §3.2/§3.3.
+*
+* Deliberately NOT a capability definition and NOT an `NcRule`:
+*  - Every `NcDelivery` member is a *persisted-pipeline-record* trigger. A
+*    timelapse fires on a SCHEDULE WINDOW BOUNDARY, evaluates no pipeline
+*    record, and produces a video it assembled itself — so it rides no
+*    delivery-enum member (the enum is frozen) and no cap method. This file is
+*    a plain typed schema; it does NOT go through `npm run codegen`.
+*  - It shares only the delivery leg (`notification-output.send`) and the
+*    persistence/ownership patterns with the Notification Center, reusing
+*    {@link NcScheduleSchema} (weekly windows, midnight-crossing, invertible)
+*    and {@link NcRuleTargetSchema} (target ref + passthrough params).
+*
+* Ownership is SERVER-DERIVED. `ownerUserId` / `createdBy` / `createdAt` /
+* `updatedAt` / `id` / `lastGeneratedAt` live on the PERSISTED rule only —
+* {@link TimelapseRuleInputSchema} and {@link TimelapseRulePatchSchema} do not
+* carry them, so a forged client payload can never claim or re-own a rule
+* (Zod strips unknown keys). The store stamps them from the resolved caller.
+*/
+/** `{{var}}` templating over camera/rule/time — same vocabulary as `NcRule`. */
+var TimelapseTemplateSchema = object({
+	title: string().max(500).optional(),
+	body: string().max(2e3).optional()
+});
+var NameField = string().min(1).max(200);
+var DeviceIdsField = array(number()).min(1);
+var CadenceSecField = number().int().min(2).max(3600);
+var FramerateField = number().int().min(1).max(60);
+var TargetsField = array(NcRuleTargetSchema).min(1);
+var PriorityField = number().int().min(1).max(5);
+/**
+* Client-supplied timelapse-rule fields. The server stamps id / createdBy /
+* createdAt / updatedAt / ownerUserId / lastGeneratedAt — none of them appear
+* here (see the ownership note above).
+*/
+var TimelapseRuleInputSchema = object({
+	name: NameField,
+	enabled: boolean().default(true),
+	/** Cameras sampled by this rule — one scratch dir + one artifact per device. */
+	deviceIds: DeviceIdsField,
+	/**
+	* Activation window(s). REQUIRED (unlike `NcRule`, where an absent schedule
+	* means "always active"): a timelapse is defined by its window boundaries —
+	* open clears the scratch, close assembles and delivers.
+	*/
+	schedule: NcScheduleSchema,
+	/** Force-snapshot cadence inside the window, seconds (predecessor parity). */
+	cadenceSec: CadenceSecField.default(15),
+	/** Output frames per second of the assembled mp4 (predecessor parity). */
+	framerate: FramerateField.default(10),
+	/** `notification-output` targets the finished video/thumbnail is sent to. */
+	targets: TargetsField,
+	template: TimelapseTemplateSchema.optional(),
+	/** Canonical notification priority ordinal (1..5); per-target overridable. */
+	priority: PriorityField.default(3)
+});
+object({
+	name: NameField.optional(),
+	enabled: boolean().optional(),
+	deviceIds: DeviceIdsField.optional(),
+	schedule: NcScheduleSchema.optional(),
+	cadenceSec: CadenceSecField.optional(),
+	framerate: FramerateField.optional(),
+	targets: TargetsField.optional(),
+	template: TimelapseTemplateSchema.nullable().optional(),
+	priority: PriorityField.optional()
+});
+TimelapseRuleInputSchema.extend({
+	id: string(),
+	/**
+	* Ownership/visibility key. Absent = admin/global rule (visible to all).
+	* Present = personal rule owned by this userId. Server-stamped from the
+	* resolved caller; never trusted from a client payload.
+	*/
+	ownerUserId: string().optional(),
+	/**
+	* Epoch-ms of the last successful generation — the 1-hour re-generation
+	* guard's durable state (predecessor parity). Absent = never generated.
+	*/
+	lastGeneratedAt: number().optional(),
+	/** userId of the caller who created the rule (server-stamped). */
+	createdBy: string(),
+	createdAt: number(),
+	updatedAt: number()
+});
+/**
+* Generic device-level status snapshot. Auto-registered by `BaseDevice`
+* for every device, regardless of provider — the kernel needs a uniform
+* cap-keyed slice for the basic device flags every consumer expects to
+* read across processes (the `online` flag in particular). Driver-specific
+* caps (`battery`, `doorbell`, …) carry their domain-specific state on
+* their own slices.
+*
+* Pattern is identical to `battery`: schema-bearing `runtimeState`,
+* empty `methods`, single change event. Reads land at
+* `runtimeState.getCapState('device-status')`; writes at
+* `runtimeState.setCapState('device-status', …)`. Cross-process
+* consumers reach the same data via the `device-state` cap router
+* (`getCapSlice({deviceId, capName: 'device-status'})`).
+*/
+var DeviceStatusSchema = object({
+	/**
+	* Device-level liveness. Drivers flip via `markOnline(boolean)` on
+	* `BaseDevice`. Provider semantics vary — RTSP aggregates broker
+	* stream-health, Reolink reads firmware push events, ONVIF tracks
+	* ping responses. This cap intentionally does NOT prescribe which
+	* signal drives the flag.
+	*/
+	online: boolean(),
+	/** Ms epoch of the last `online` transition. Lets consumers tell
+	*  apart "just came online" from "still online". */
+	lastChangedAt: number()
+});
+var deviceStatusCapability = {
+	name: "device-status",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	methods: {},
+	events: { 
+	/** Emitted when `online` transitions. Mirrors the semantics of
+	*  `battery.onStatusChanged`. */
+onStatusChanged: { data: object({
+		deviceId: number(),
+		status: DeviceStatusSchema
+	}) } },
+	status: {
+		schema: DeviceStatusSchema,
+		kind: "push"
+	},
+	runtimeState: DeviceStatusSchema
+};
+/**
+* Per-device feature/identity probe slice. Holds the runtime-resolved
+* truth about what a device CAN do — which the kernel uses to:
+*   1. Reconcile accessory children (hub-children spawn siren/floodlight/PIR
+*      based on what the firmware actually advertises).
+*   2. Compute the public `features: DeviceFeature[]` array surfaced via
+*      `device-manager.listAll`.
+*   3. Decide which optional caps (PTZ, intercom, doorbell, battery, …)
+*      to register on the device's capability surface.
+*
+* Auto-registered by `BaseDevice` for every device. Drivers populate the
+* slice from `onProbe()` (kernel calls it once after register, before
+* accessory reconciliation). Consumers read via:
+*   `runtimeState.getCapState<FeatureProbeStatus>('feature-probe')`
+*
+* `flags` is an open record so each driver carries its own keys without
+* a centralized schema bottleneck — Reolink writes `hasPtz/hasIntercom`,
+* Hikvision writes `hasSupplementalLight/hasAlarmIo`, etc.
+*
+* Replaces the older driver-local `deviceCache.has*` blob: the per-device
+* config is for operator-edited overrides + UI snapshots; runtime probe
+* results belong in runtime-state where the kernel handles persistence,
+* cross-process mirroring, and reactive updates.
+*/
+var FeatureProbeStatusSchema = object({
+	/**
+	* Driver-specific flag bag. Each driver picks its own key names — the
+	* cap deliberately does NOT enforce a closed enum here. Reolink keys:
+	* `hasPtz`, `hasIntercom`, `hasDoorbell`, `hasFloodlight`, `hasSiren`,
+	* `hasPirSensor`, `hasAutotrack`, `hasBattery`. Hikvision keys:
+	* `hasSupplementalLight`, `lightHasWhiteLight`, `hasAlarmIo`, `hasPtz`.
+	*/
+	flags: record(string(), unknown()),
+	/**
+	* Coarse driver-classification — lets cross-process consumers tell apart
+	* cameras / battery-cams / NVRs without re-running the probe. `null`
+	* before the first probe completes.
+	*/
+	deviceType: string().nullable(),
+	/** Camera/firmware model string. `null` when the firmware doesn't expose it. */
+	model: string().nullable(),
+	/** Channel count for NVR/Hub devices; `1` for standalone cameras; `null` pre-probe. */
+	channelCount: number().nullable(),
+	/**
+	* Ms epoch of the last SUCCESSFUL probe. `0` before the first probe
+	* completes — drivers' `getAccessoryChildren()` should treat zero as
+	* "probe not done yet, return empty" so accessories aren't spawned
+	* before the firmware is queried.
+	*/
+	lastProbedAt: number(),
+	/**
+	* Framework convention: every runtime-state slice carries this for the
+	* createRuntimeStateBridge stale-check helper. We keep it in sync with
+	* `lastProbedAt` on every write.
+	*/
+	lastFetchedAt: number()
+});
+var featureProbeCapability = {
+	name: "feature-probe",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	methods: {},
+	events: { 
+	/** Fires whenever a fresh probe completes (kernel-driven `reprobe()`
+	*  or driver-initiated re-detect after a state change). */
+onProbeChanged: { data: object({
+		deviceId: number(),
+		status: FeatureProbeStatusSchema
+	}) } },
+	status: {
+		schema: FeatureProbeStatusSchema,
+		kind: "push"
+	},
+	runtimeState: FeatureProbeStatusSchema
+};
+/**
+* Multi-metric air-quality slice. Covers CO₂, total VOCs, particulate
+* matter at PM2.5 / PM10, and a derived AQI index — all optional so
+* a single-metric source populates only what it observes. Mirrors
+* the HA `sensor` device_class set (`co2`, `volatile_organic_compounds`,
+* `pm25`, `pm10`, `aqi`) collapsed into one cap because a typical
+* air-quality node reports several of these together; modelling them
+* as siblings keeps a single timestamp + one slice subscription.
+*/
+var AirQualitySensorStatusSchema = object({
+	/** Carbon dioxide concentration in ppm. */
+	co2Ppm: number().min(0).optional(),
+	/** Total volatile organic compounds in ppb. */
+	vocPpb: number().min(0).optional(),
+	/** Particulate matter ≤ 2.5 μm in µg/m³. */
+	pm25: number().min(0).optional(),
+	/** Particulate matter ≤ 10 μm in µg/m³. */
+	pm10: number().min(0).optional(),
 	/** Composite AQI value (typically 0..500). */
 	aqi: number().optional(),
 	/** Ms epoch when the slice was last updated. */
@@ -10350,6 +11098,28 @@ method(object({
 }), object({ success: literal(true) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	deviceId: number(),
+	/** Absent = the LOWEST assigned profile — a notification attachment is
+	*  watched on a phone, and the cheap rendition is the right default. */
+	profile: CamProfileSchema.optional(),
+	aroundMs: number(),
+	preRollSec: number().min(0).max(20).default(3),
+	postRollSec: number().min(0).max(20).default(5),
+	format: _enum(["gif", "mp4"]).default("gif"),
+	maxWidth: number().int().min(120).max(1920).default(480),
+	/** GIF only — MP4 keeps the source cadence. */
+	fps: number().int().min(1).max(15).default(5)
+}), object({
+	base64: string(),
+	mime: string(),
+	bytes: number().int(),
+	/** The profile actually rendered (what the default resolved to). */
+	profile: CamProfileSchema,
+	durationMs: number()
+}), {
+	kind: "mutation",
+	auth: "admin"
 }), method(_void(), array(CameraStreamSchema).readonly()), method(_void(), array(ProfileSlotSchema).readonly()), method(object({ brokerId: string() }), BrokerStatsSchema), method(object({ brokerId: string() }), object({
 	probed: boolean(),
 	summary: string()
@@ -13628,67 +14398,6 @@ var motionTriggerCapability = {
 	runtimeState: MotionTriggerRuntimeStateSchema
 };
 /**
-* Shared geometry vocabulary for on-frame shape caps — privacy-mask,
-* motion-zones, and the detection zones/lines editor all speak this one
-* language so a single drawing-plane editor and the providers stay
-* decoupled from each cap's storage.
-*
-* All coordinates are normalized 0..1 of the camera frame (top-left
-* origin). Each cap composes the SUBSET of shape kinds it supports and
-* advertises it via `supportedShapes` in its `getOptions`.
-*/
-/** A normalized 0..1 point (top-left origin). */
-var MaskPointSchema = object({
-	x: number(),
-	y: number()
-});
-/** Axis-aligned rectangle (normalized 0..1). */
-var MaskRectShapeSchema = object({
-	kind: literal("rect"),
-	x: number(),
-	y: number(),
-	width: number(),
-	height: number()
-});
-/** Free polygon — an ordered list of normalized vertices (≥3). */
-var MaskPolygonShapeSchema = object({
-	kind: literal("polygon"),
-	points: array(MaskPointSchema)
-});
-/** Boolean cell grid — row-major, length === gridWidth*gridHeight. */
-var MaskGridShapeSchema = object({
-	kind: literal("grid"),
-	gridWidth: number(),
-	gridHeight: number(),
-	cells: array(boolean())
-});
-discriminatedUnion("kind", [
-	MaskRectShapeSchema,
-	MaskPolygonShapeSchema,
-	MaskGridShapeSchema,
-	object({
-		kind: literal("line"),
-		points: array(MaskPointSchema)
-	})
-]);
-/** Every shape-kind discriminant, for `supportedShapes` advertisement. */
-var MaskShapeKindSchema = _enum([
-	"rect",
-	"polygon",
-	"grid",
-	"line"
-]);
-/** Polygon vertex bounds when a cap supports 'polygon' (e.g. Hikvision {min:4,max:4}). */
-var MaskPolygonVerticesSchema = object({
-	min: number(),
-	max: number()
-});
-/** Grid dimensions when a cap supports 'grid'. */
-var MaskGridDimsSchema = object({
-	width: number(),
-	height: number()
-});
-/**
 * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
 * on-camera motion-detection mask is a single `grid` region (a row-major
 * boolean cell lattice the camera's onboard VMD evaluates). Composing it as
@@ -17144,6 +17853,55 @@ method(object({
 	password: string()
 }), AuthResultSchema.nullable(), { kind: "mutation" }), method(object({ state: string() }), string()), method(record(string(), string()), AuthResultSchema, { kind: "mutation" }), method(object({ token: string() }), AuthResultSchema.nullable());
 /**
+* A live terminal session hosted by the provider addon. Output and input do
+* NOT flow through the capability — they use the addon data plane
+* (`GET /addon/terminal/<id>/out` SSE, `POST /addon/terminal/<id>/in`) because
+* terminal output must be ordered and lossless. The event bus is telemetry and
+* may drop chunks ([D8]), and a dropped chunk desynchronises the vt parser
+* permanently until a full repaint. The capability owns only lifecycle.
+*/
+var TerminalSessionInfoSchema = object({
+	/** Opaque session id minted by the provider on `openSession`. */
+	sessionId: string(),
+	/** The pre-declared profile this session runs (never a free-form command). */
+	profileId: string(),
+	/** Human-readable profile label for the UI session list. */
+	label: string(),
+	cols: number().int().positive(),
+	rows: number().int().positive(),
+	/** ms-epoch the session's pty was spawned. */
+	startedAt: number()
+});
+/**
+* A profile the operator may open — a pre-declared, allowlisted program
+* (`monitor` → `btm`). The capability accepts only these ids; a free-form
+* command string would be remote code execution as the server's user, so it is
+* deliberately not part of the contract.
+*/
+var TerminalProfileInfoSchema = object({
+	profileId: string(),
+	label: string(),
+	description: string().optional()
+});
+method(_void(), array(TerminalProfileInfoSchema).readonly(), { auth: "admin" }), method(_void(), array(TerminalSessionInfoSchema).readonly(), { auth: "admin" }), method(object({
+	profileId: string(),
+	cols: number().int().positive(),
+	rows: number().int().positive()
+}), TerminalSessionInfoSchema, {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({
+	sessionId: string(),
+	cols: number().int().positive(),
+	rows: number().int().positive()
+}), _void(), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ sessionId: string() }), _void(), {
+	kind: "mutation",
+	auth: "admin"
+});
+/**
 * Orchestrator-side destination metadata. The orchestrator computes
 * `id = <addonId>:<subId>` from its provider lookup so consumers
 * (admin UI, restore flow) see one canonical key.
@@ -17244,11 +18002,53 @@ var LocationStatSchema = object({
 	fileCount: number(),
 	present: boolean()
 });
+/**
+* A backup schedule — the N:M "entry" that binds one cron cadence to a
+* SET of destination locations. Supersedes the per-location cron on
+* `BackupDestinationPolicy`: an operator creates a schedule, picks the
+* `backups` locations it should write to, and the orchestrator fans a
+* single archive out to all of them when the cron fires.
+*
+* `retentionCount` is per-schedule (D-decision 2026-07-28): every
+* location targeted by this schedule keeps this many archives from
+* this schedule's runs.
+*
+* `dataSources` optionally narrows which top-level state locations
+* (db, addons, tls, …) are archived; omitted = the orchestrator's
+* default full set.
+*/
+var BackupScheduleSchema = object({
+	/** Stable id. Generated by the orchestrator on first upsert if absent. */
+	id: string(),
+	/** Operator-facing display name. */
+	label: string(),
+	/** 5-field POSIX cron. Empty = disabled cadence (kept for editing). */
+	cron: string(),
+	/** Master on/off toggle for the whole schedule. */
+	enabled: boolean(),
+	/** `backups`-location ids this schedule writes to (fan-out set). */
+	locationIds: array(string()).readonly(),
+	/** Archives kept per targeted location for this schedule. */
+	retentionCount: number().int().min(1).max(1e3),
+	/** Optional subset of source locations to include; omitted = all. */
+	dataSources: array(string()).readonly().optional(),
+	/** ms-epoch of last successful run. */
+	lastRunAt: number().optional(),
+	/** ms-epoch of next computed firing (read-only, filled on list). */
+	nextRunAt: number().optional()
+});
 method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }), method(object({
 	/** Subset of registered `backup-destination` addon ids to write to. */
 	destinations: array(string()).optional(),
 	locations: array(string()).optional(),
-	label: string().optional()
+	label: string().optional(),
+	/**
+	* Per-run retention override applied to every targeted
+	* destination. Used by schedule-driven runs (per-entry
+	* retention). Omitted = each destination's own policy
+	* retention (manual runs).
+	*/
+	retentionCount: number().int().min(1).max(1e3).optional()
 }).optional(), array(BackupEntrySchema).readonly(), {
 	kind: "mutation",
 	auth: "admin"
@@ -17297,7 +18097,21 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
 	ok: boolean(),
 	error: string().optional(),
 	nextRuns: array(number()).readonly()
-}));
+})), method(_void(), array(BackupScheduleSchema).readonly(), { auth: "admin" }), method(object({
+	id: string().optional(),
+	label: string(),
+	cron: string(),
+	enabled: boolean(),
+	locationIds: array(string()).readonly(),
+	retentionCount: number().int().min(1).max(1e3),
+	dataSources: array(string()).readonly().optional()
+}), BackupScheduleSchema, {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ id: string() }), _void(), {
+	kind: "mutation",
+	auth: "admin"
+});
 /**
 * `broker` — unified pub/sub broker registry, system-scoped collection.
 *
@@ -18992,997 +19806,539 @@ var MetricsGpuInfoSchema = object({
 	model: string(),
 	memoryUsedBytes: number(),
 	memoryTotalBytes: number(),
-	temperature: number().nullable()
-});
-var ProcessResourceInfoSchema = object({
-	openFds: number(),
-	threadCount: number(),
-	activeHandles: number(),
-	activeRequests: number()
-});
-var PressureAvgsSchema = object({
-	avg10: number(),
-	avg60: number(),
-	avg300: number()
-});
-var PressureInfoSchema = object({
-	some: PressureAvgsSchema,
-	full: PressureAvgsSchema.nullable()
-});
-var SystemResourceSnapshotSchema = object({
-	cpu: CpuBreakdownSchema,
-	memory: MemoryInfoSchema,
-	gpu: MetricsGpuInfoSchema.nullable(),
-	network: NetworkIoSnapshotSchema,
-	disk: DiskIoSnapshotSchema,
-	pressure: object({
-		cpu: PressureInfoSchema.nullable(),
-		memory: PressureInfoSchema.nullable(),
-		io: PressureInfoSchema.nullable()
-	}),
-	process: ProcessResourceInfoSchema,
-	cpuTemperature: number().nullable(),
-	timestampMs: number()
-});
-var DiskSpaceInfoSchema = object({
-	path: string(),
-	totalBytes: number(),
-	usedBytes: number(),
-	availableBytes: number(),
-	percent: number()
-});
-var PidResourceStatsSchema = object({
-	pid: number(),
-	cpu: number(),
-	memory: number(),
-	/**
-	* Private (anonymous) resident bytes — the per-process V8 heap + native
-	* allocations NOT shared with other processes (Linux RssAnon). This is the
-	* "real" per-runner cost; summing it across runners is meaningful, unlike
-	* `memory` (RSS), which double-counts the shared mmap'd framework code.
-	* Undefined where /proc is unavailable (e.g. macOS).
-	*/
-	privateBytes: number().optional(),
-	/**
-	* Shared file-backed resident bytes (Linux RssFile) — mmap'd framework/lib
-	* code shared copy-on-write across runners. Undefined on macOS.
-	*/
-	sharedBytes: number().optional()
-});
-var AddonInstanceSchema = object({
-	addonId: string(),
-	nodeId: string(),
-	role: _enum(["hub", "worker"]),
-	pid: number(),
-	state: _enum([
-		"starting",
-		"running",
-		"stopping",
-		"stopped",
-		"crashed"
-	]),
-	uptimeSec: number()
-});
-var NodeProcessSchema = object({
-	pid: number(),
-	ppid: number(),
-	pgid: number(),
-	classification: _enum([
-		"root",
-		"managed",
-		"system",
-		"ghost"
-	]),
-	/** `$process` addon binding when `managed`, else null. */
-	addonId: string().nullable(),
-	/** Kernel-reported nodeId when the process is a known agent/worker. */
-	nodeId: string().nullable(),
-	/** Truncated command line. */
-	command: string(),
-	cpuPercent: number(),
-	memoryRssBytes: number(),
-	/** Wall-clock uptime (seconds). Parsed from `ps etime`. */
-	uptimeSec: number(),
-	/** True when ancestor walk reaches `ppid=1` (reparented to init/launchd). */
-	orphaned: boolean()
-});
-var KillProcessInputSchema = object({
-	pid: number(),
-	/** Force = SIGKILL. Default is SIGTERM. */
-	force: boolean().optional()
-});
-var KillProcessResultSchema = object({
-	success: boolean(),
-	reason: string().optional(),
-	signal: _enum(["SIGTERM", "SIGKILL"]).optional()
-});
-var DumpHeapSnapshotInputSchema = object({ 
-/** The addon whose runner should dump a heap snapshot. */
-addonId: string() });
-var DumpHeapSnapshotResultSchema = object({
-	success: boolean(),
-	/** Path of the written .heapsnapshot inside the runner's container/host. */
-	path: string().optional(),
-	/** Process pid that was signalled. */
-	pid: number().optional(),
-	reason: string().optional()
-});
-var SystemMetricsSchema = object({
-	cpuPercent: number(),
-	memoryPercent: number(),
-	memoryUsedMB: number(),
-	memoryTotalMB: number(),
-	diskPercent: number().optional(),
-	temperature: number().optional(),
-	gpuPercent: number().optional(),
-	gpuMemoryPercent: number().optional()
-});
-method(_void(), SystemResourceSnapshotSchema), method(_void(), SystemResourceSnapshotSchema.nullable()), method(_void(), SystemMetricsSchema), method(object({ dirPath: string() }), DiskSpaceInfoSchema), method(_void(), MetricsGpuInfoSchema.nullable()), method(_void(), number().nullable()), method(object({ pids: array(number()) }), array(PidResourceStatsSchema)), method(_void(), array(AddonInstanceSchema).readonly()), method(object({ addonId: string() }), PidResourceStatsSchema.nullable()), method(_void(), array(NodeProcessSchema).readonly()), method(KillProcessInputSchema, KillProcessResultSchema, {
-	kind: "mutation",
-	auth: "admin"
-}), method(DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, {
-	kind: "mutation",
-	auth: "admin"
-});
-method(object({
-	sourceUrl: string(),
-	metadata: ModelConvertMetadataSchema,
-	targets: array(ConvertTargetSchema).min(1).readonly(),
-	calibrationRef: string().optional(),
-	sessionId: string().optional()
-}), ConvertResultSchema, {
-	kind: "mutation",
-	auth: "admin",
-	timeoutMs: 6e5
-});
-method(object({
-	nodeId: string(),
-	modelId: string(),
-	format: _enum(MODEL_FORMATS),
-	entry: ModelCatalogEntrySchema
-}), object({
-	ok: boolean(),
-	/** sha256 of the staged tarball (empty for a hub-local no-op). */
-	sha256: string(),
-	bytes: number(),
-	/** The target node's modelsDir the artifact landed in. */
-	path: string()
-}), {
-	kind: "mutation",
-	auth: "admin"
-});
-/**
-* `mqtt-broker` — broker-registry cap.
-*
-* NOT a pub/sub proxy. The cap exposes (a) a registry of configured
-* MQTT brokers (external + optionally an embedded `aedes`-backed one)
-* and (b) the connection details a consumer addon needs to spin up
-* its OWN `mqtt.js` client.
-*
-* Why: pub/sub routing over the system event-bus loses fidelity
-* (callback shape, QoS guarantees, will/retain semantics) and adds
-* refcount bookkeeping that addons would rather own themselves. The
-* canonical consumer (`addon-export-ha-mqtt`) needs raw `mqtt.js`
-* features anyway — give it the connection config, get out of the way.
-*
-* Consumer flow:
-*   const cfg = await ctx.api.mqttBroker.getBrokerConfig({ id })
-*   const client = mqtt.connect(cfg.url, { username: cfg.username, … })
-*   client.subscribe('zigbee2mqtt/+')
-*
-* Collection mode: multiple brokers (e.g. one local mosquitto + one
-* cloud bridge). The "embedded" entry (when present) is just another
-* broker in the registry — its lifecycle is owned by the addon that
-* spawned it.
-*/
-var BrokerKindSchema = _enum(["external", "embedded"]);
-/**
-* Broker live-probe status.
-*
-* - `connected` — last probe completed a clean CONNACK
-* - `disconnected` — no probe has run yet (cold cache)
-* - `auth-failed` — CONNACK refused with auth error (RC 4 / 5)
-* - `unreachable` — TCP connect timed out / refused
-* - `tls-error` — TLS handshake failed (cert / SNI / cipher)
-*/
-var BrokerStatusSchema$1 = _enum([
-	"connected",
-	"disconnected",
-	"auth-failed",
-	"unreachable",
-	"tls-error"
-]);
-var BrokerInfoSchema = object({
-	id: string(),
-	name: string(),
-	url: string(),
-	kind: BrokerKindSchema,
-	status: BrokerStatusSchema$1,
-	latencyMs: number().nullable(),
-	error: string().optional(),
-	/** Embedded brokers only: number of MQTT clients currently connected. */
-	connectedClients: number().int().nonnegative().optional(),
-	/** Epoch ms of the last live probe (external) or aedes snapshot (embedded). */
-	lastCheckedAt: number().optional()
-});
-/**
-* Connection details — what a consumer needs to call
-* `mqtt.connect(url, options)`. We split URL + credentials so the
-* consumer can pass them as `mqtt.connect(url, { username, password })`
-* instead of stuffing creds into the URL (which leaks them into logs).
-*/
-var BrokerConnectionDetailsSchema = object({
-	url: string(),
-	username: string().optional(),
-	password: string().optional(),
-	/**
-	* Suggested prefix for `clientId`. Each consumer should suffix this
-	* with its own discriminator (addon id, instance id) so reconnects
-	* don't kick each other off (MQTT spec: clientId must be unique per
-	* broker).
-	*/
-	clientIdPrefix: string().optional()
-});
-var AddBrokerInputSchema = object({
-	name: string().min(1),
-	url: string().regex(/^(mqtt|mqtts|ws|wss):\/\//, "URL must start with mqtt(s):// or ws(s)://"),
-	username: string().optional(),
-	password: string().optional(),
-	clientIdPrefix: string().optional()
+	temperature: number().nullable()
 });
-var AddBrokerResultSchema = object({ id: string() });
-var IdInputSchema = object({ id: string() });
-var TestResultSchema$1 = discriminatedUnion("ok", [object({
-	ok: literal(true),
-	latencyMs: number()
-}), object({
-	ok: literal(false),
-	error: string()
-})]);
-var StartEmbeddedInputSchema = object({
-	port: number().int().min(1).max(65535).default(1883),
-	/** Allow anonymous connect (no username/password). Default: false. */
-	allowAnonymous: boolean().default(false),
-	/** Optional shared username/password for clients. */
-	username: string().optional(),
-	password: string().optional()
+var ProcessResourceInfoSchema = object({
+	openFds: number(),
+	threadCount: number(),
+	activeHandles: number(),
+	activeRequests: number()
 });
-var StartEmbeddedResultSchema = object({
-	id: string(),
-	url: string()
+var PressureAvgsSchema = object({
+	avg10: number(),
+	avg60: number(),
+	avg300: number()
 });
-var StatusSchema = object({
-	brokerCount: number(),
-	embeddedRunning: boolean()
+var PressureInfoSchema = object({
+	some: PressureAvgsSchema,
+	full: PressureAvgsSchema.nullable()
 });
-method(_void(), array(BrokerInfoSchema)), method(IdInputSchema, BrokerConnectionDetailsSchema), method(AddBrokerInputSchema, AddBrokerResultSchema, { kind: "mutation" }), method(IdInputSchema, _void(), { kind: "mutation" }), method(IdInputSchema, TestResultSchema$1, { kind: "mutation" }), method(StartEmbeddedInputSchema, StartEmbeddedResultSchema, { kind: "mutation" }), method(IdInputSchema, _void(), { kind: "mutation" }), method(_void(), StatusSchema);
-var NetworkEndpointSchema = object({
-	url: string(),
-	hostname: string(),
-	port: number(),
-	protocol: _enum(["http", "https"])
+var SystemResourceSnapshotSchema = object({
+	cpu: CpuBreakdownSchema,
+	memory: MemoryInfoSchema,
+	gpu: MetricsGpuInfoSchema.nullable(),
+	network: NetworkIoSnapshotSchema,
+	disk: DiskIoSnapshotSchema,
+	pressure: object({
+		cpu: PressureInfoSchema.nullable(),
+		memory: PressureInfoSchema.nullable(),
+		io: PressureInfoSchema.nullable()
+	}),
+	process: ProcessResourceInfoSchema,
+	cpuTemperature: number().nullable(),
+	timestampMs: number()
 });
-var NetworkAccessStatusSchema = object({
-	connected: boolean(),
-	endpoint: NetworkEndpointSchema.nullable(),
-	error: string().optional()
+var DiskSpaceInfoSchema = object({
+	path: string(),
+	totalBytes: number(),
+	usedBytes: number(),
+	availableBytes: number(),
+	percent: number()
 });
-/**
-* Optional, richer endpoint shape returned by providers that expose
-* MORE than one ingress concurrently (Tailscale Ingress with mixed
-* serve+funnel rules, future ngrok multi-tunnel, …). Each entry carries
-* the originating provider config (mode + sourcePort) so the
-* orchestrator UI can label rows distinctly. Providers that expose only
-* one endpoint just omit `listEndpoints` from their provider impl.
-*/
-var NetworkEndpointEntrySchema = NetworkEndpointSchema.extend({
+var PidResourceStatsSchema = object({
+	pid: number(),
+	cpu: number(),
+	memory: number(),
 	/**
-	* Stable id within the provider — typically `<mode>-<sourcePort>` so
-	* the orchestrator can dedupe across `listEndpoints` polls.
+	* Private (anonymous) resident bytes — the per-process V8 heap + native
+	* allocations NOT shared with other processes (Linux RssAnon). This is the
+	* "real" per-runner cost; summing it across runners is meaningful, unlike
+	* `memory` (RSS), which double-counts the shared mmap'd framework code.
+	* Undefined where /proc is unavailable (e.g. macOS).
 	*/
-	id: string(),
-	/** Operator-facing label (mirrors `MeshEndpoint.label`). */
-	label: string(),
-	/** Optional provider-specific mode tag, used for icon/colour in admin UI. */
-	mode: string().optional(),
-	/** Originating local port the ingress fronts (informational). */
-	sourcePort: number().optional()
-});
-method(_void(), NetworkEndpointSchema, { kind: "mutation" }), method(_void(), _void(), { kind: "mutation" }), method(_void(), NetworkEndpointSchema.nullable()), method(_void(), NetworkAccessStatusSchema), method(_void(), array(NetworkEndpointEntrySchema).readonly());
-/**
-* notification-output — canonical, capability-gated notification delivery.
-*
-* Apprise-derived model (see
-* `docs/superpowers/specs/2026-07-03-notification-output-notifier-matrix.md`):
-* callers emit ONE canonical `Notification`; each provider declares a
-* per-kind capability descriptor (`TargetKind`), and the pure degrade
-* engine (`@camstack/types` `prepareNotification`) transcodes / degrades the
-* message to what the kind supports — callers never special-case a service.
-*
-* DESIGN DECISIONS (locked):
-*  - Target CRUD lives on THIS cap (`upsertTarget` / `deleteTarget` /
-*    `setTargetEnabled`), each provider persisting via the `settings-store`
-*    cap. Rationale: the admin UI needs one uniform surface across the
-*    notifiers addon AND the HA addon; the addon-`globalSettingsSchema`-array
-*    alternative would fork the UI per addon and cannot host the
-*    discovery→adopt flow.
-*  - `listTargetKinds` / `listTargets` / `discoverTargets` return arrays →
-*    the generated cap-mount auto-`concatCollection`-fans them across every
-*    registered provider (notifiers addon + HA addon) so one catalog is
-*    routable. `send` / `testTarget` / CRUD route to ONE provider by the
-*    `addonId` the generated collection router extracts from the call input.
-*  - `Attachment.bytes` is `Uint8Array`. Transport-safe: superjson (the tRPC
-*    transformer) + UDS MsgPack both round-trip typed arrays — already used by
-*    `storage` / `storage-provider` / `recording` caps over the same path. No
-*    base64 fallback needed.
-*
-* TODO (deferred, closed-set change — separate decision): add
-* `providerKind: 'notify'` so notification providers surface on the unified
-* admin "Integrations" page.
-*/
-/**
-* Zentik-derived typed-media enum — the superset across every kind. Each
-* adapter picks what it supports and the degrade engine filters the rest.
-*/
-var AttachmentMediaTypeSchema = _enum([
-	"image",
-	"video",
-	"gif",
-	"audio",
-	"icon"
-]);
-/**
-* A single attachment. Exactly one of `url` (remote source, most adapters
-* prefer this) or `bytes` (inline source; required for Pushover-style
-* bytes-only kinds) MUST be present — the degrade engine expresses a
-* url→bytes fetch as a `needsFetch` directive the adapter executes.
-*/
-var AttachmentSchema = object({
-	mediaType: AttachmentMediaTypeSchema,
-	url: string().optional(),
-	bytes: _instanceof(Uint8Array).optional(),
-	mime: string().optional(),
-	name: string().optional()
-}).refine((a) => a.url !== void 0 || a.bytes !== void 0, { message: "Attachment requires either `url` or `bytes`" });
-var NotificationFormatSchema = _enum([
-	"text",
-	"markdown",
-	"html"
-]);
-/** A single tap-through action button. */
-var NotificationActionSchema = object({
-	id: string(),
-	label: string(),
-	url: string().optional()
-});
-/**
-* The canonical notification. `body` is the only hard field (Apprise model).
-* `priority` is a 5-level ORDINAL (1=lowest … 3=normal(default) … 5=urgent),
-* NOT a fixed severity enum — each kind declares its own `caps.levels` and
-* the adapter maps this ordinal onto its native level. `level?` is an
-* optional kind-native level id (`emergency`, `silent`, …) that overrides
-* `priority` for that one target.
-*/
-var NotificationSchema = object({
-	body: string(),
-	title: string().optional(),
-	format: NotificationFormatSchema.default("text"),
-	priority: number().int().min(1).max(5).default(3),
-	level: string().optional(),
-	attachments: array(AttachmentSchema).optional(),
-	clickUrl: string().optional(),
-	actions: array(NotificationActionSchema).optional(),
-	sound: string().optional(),
-	ttl: number().optional(),
-	tag: string().optional(),
-	deviceId: number().optional(),
-	eventId: string().optional(),
-	metadata: record(string(), unknown()).optional()
+	privateBytes: number().optional(),
+	/**
+	* Shared file-backed resident bytes (Linux RssFile) — mmap'd framework/lib
+	* code shared copy-on-write across runners. Undefined on macOS.
+	*/
+	sharedBytes: number().optional()
 });
-/** One declared native severity/priority level for a kind. */
-var TargetKindLevelSchema = object({
-	id: string(),
-	label: string(),
-	/** Which canonical priority (1..5) this level maps to. `null` = qualitative-only. */
-	ordinal: number().int().min(1).max(5).nullable(),
-	flags: object({
-		critical: boolean().optional(),
-		silent: boolean().optional(),
-		noPush: boolean().optional()
-	}).optional(),
-	/** e.g. Pushover `emergency` requires `retry` / `expire`. */
-	requires: array(string()).optional(),
-	description: string().optional()
+var AddonInstanceSchema = object({
+	addonId: string(),
+	nodeId: string(),
+	role: _enum(["hub", "worker"]),
+	pid: number(),
+	state: _enum([
+		"starting",
+		"running",
+		"stopping",
+		"stopped",
+		"crashed"
+	]),
+	uptimeSec: number()
 });
-/** The full capability block consulted before dispatch. */
-var TargetKindCapsSchema = object({
-	attachments: object({
-		mediaTypes: array(AttachmentMediaTypeSchema),
-		mode: _enum([
-			"url",
-			"bytes",
-			"both"
-		]),
-		max: number().int().nonnegative(),
-		maxBytes: number().int().positive().optional()
-	}),
-	/** Max action buttons (0 = none). */
-	actions: number().int().nonnegative(),
-	levels: array(TargetKindLevelSchema),
-	format: array(NotificationFormatSchema),
-	clickUrl: boolean(),
-	sound: boolean(),
-	ttl: boolean(),
-	bodyMaxLen: number().int().positive()
+var NodeProcessSchema = object({
+	pid: number(),
+	ppid: number(),
+	pgid: number(),
+	classification: _enum([
+		"root",
+		"managed",
+		"system",
+		"ghost"
+	]),
+	/** `$process` addon binding when `managed`, else null. */
+	addonId: string().nullable(),
+	/** Kernel-reported nodeId when the process is a known agent/worker. */
+	nodeId: string().nullable(),
+	/** Truncated command line. */
+	command: string(),
+	cpuPercent: number(),
+	memoryRssBytes: number(),
+	/** Wall-clock uptime (seconds). Parsed from `ps etime`. */
+	uptimeSec: number(),
+	/** True when ancestor walk reaches `ppid=1` (reparented to init/launchd). */
+	orphaned: boolean()
 });
-/**
-* `configSchema` is a `ConfigUISchema` tree passed through to the admin
-* FormBuilder. Stored as `z.unknown()` at the cap seam (mirrors
-* `device-provider.getChildCreationSchema` `CreationSchemaOutputSchema`) —
-* the union is large and not meant for runtime validation here; the exported
-* `TargetKind` type re-tightens `configSchema` to `ConfigUISchema`.
-*/
-var ConfigSchemaPassthrough = unknown();
-var TargetKindSchema = object({
-	kind: string(),
-	label: string(),
-	icon: string(),
-	/** Stamped by each provider so the concat-fanned catalog stays routable. */
-	addonId: string(),
-	configSchema: ConfigSchemaPassthrough,
-	supportsDiscovery: boolean(),
-	caps: TargetKindCapsSchema
+var KillProcessInputSchema = object({
+	pid: number(),
+	/** Force = SIGKILL. Default is SIGTERM. */
+	force: boolean().optional()
 });
-/**
-* A persisted target. `config` holds secrets; providers REDACT secret fields
-* (return a presence marker only) when serving `listTargets` — never
-* round-trip a stored secret to the UI.
-*/
-var TargetSchema = object({
-	id: string(),
-	name: string(),
-	kind: string(),
-	addonId: string(),
-	enabled: boolean(),
-	config: record(string(), unknown())
+var KillProcessResultSchema = object({
+	success: boolean(),
+	reason: string().optional(),
+	signal: _enum(["SIGTERM", "SIGKILL"]).optional()
 });
-/** A discovery-surfaced candidate (config is partial + non-secret). */
-var DiscoveredTargetSchema = object({
-	kind: string(),
-	suggestedName: string(),
-	config: record(string(), unknown())
+var DumpHeapSnapshotInputSchema = object({ 
+/** The addon whose runner should dump a heap snapshot. */
+addonId: string() });
+var DumpHeapSnapshotResultSchema = object({
+	success: boolean(),
+	/** Path of the written .heapsnapshot inside the runner's container/host. */
+	path: string().optional(),
+	/** Process pid that was signalled. */
+	pid: number().optional(),
+	reason: string().optional()
 });
-/** The degrade engine's report — what was resolved / dropped / degraded. */
-var RenderedAsSchema = object({
-	level: string(),
-	format: NotificationFormatSchema,
-	attachmentsSent: number().int().nonnegative(),
-	actionsSent: number().int().nonnegative(),
-	truncated: boolean(),
-	dropped: array(string())
+var SystemMetricsSchema = object({
+	cpuPercent: number(),
+	memoryPercent: number(),
+	memoryUsedMB: number(),
+	memoryTotalMB: number(),
+	diskPercent: number().optional(),
+	temperature: number().optional(),
+	gpuPercent: number().optional(),
+	gpuMemoryPercent: number().optional()
 });
-var SendResultSchema = object({
-	success: boolean(),
-	error: string().optional(),
-	renderedAs: RenderedAsSchema.optional()
+method(_void(), SystemResourceSnapshotSchema), method(_void(), SystemResourceSnapshotSchema.nullable()), method(_void(), SystemMetricsSchema), method(object({ dirPath: string() }), DiskSpaceInfoSchema), method(_void(), MetricsGpuInfoSchema.nullable()), method(_void(), number().nullable()), method(object({ pids: array(number()) }), array(PidResourceStatsSchema)), method(_void(), array(AddonInstanceSchema).readonly()), method(object({ addonId: string() }), PidResourceStatsSchema.nullable()), method(_void(), array(NodeProcessSchema).readonly()), method(KillProcessInputSchema, KillProcessResultSchema, {
+	kind: "mutation",
+	auth: "admin"
+}), method(DumpHeapSnapshotInputSchema, DumpHeapSnapshotResultSchema, {
+	kind: "mutation",
+	auth: "admin"
+});
+method(object({
+	sourceUrl: string(),
+	metadata: ModelConvertMetadataSchema,
+	targets: array(ConvertTargetSchema).min(1).readonly(),
+	calibrationRef: string().optional(),
+	sessionId: string().optional()
+}), ConvertResultSchema, {
+	kind: "mutation",
+	auth: "admin",
+	timeoutMs: 6e5
+});
+method(object({
+	nodeId: string(),
+	modelId: string(),
+	format: _enum(MODEL_FORMATS),
+	entry: ModelCatalogEntrySchema
+}), object({
+	ok: boolean(),
+	/** sha256 of the staged tarball (empty for a hub-local no-op). */
+	sha256: string(),
+	bytes: number(),
+	/** The target node's modelsDir the artifact landed in. */
+	path: string()
+}), {
+	kind: "mutation",
+	auth: "admin"
 });
-/** Same shape as SendResult — kept as a distinct name for the test panel. */
-var TestResultSchema = SendResultSchema;
-var notificationOutputCapability = {
-	name: "notification-output",
-	scope: "system",
-	mode: "collection",
-	methods: {
-		listTargetKinds: method(object({}), array(TargetKindSchema)),
-		listTargets: method(object({}), array(TargetSchema)),
-		discoverTargets: method(object({
-			kind: string(),
-			config: record(string(), unknown()).optional()
-		}), array(DiscoveredTargetSchema)),
-		send: method(object({
-			targetId: string(),
-			notification: NotificationSchema
-		}), SendResultSchema, { kind: "mutation" }),
-		testTarget: method(object({
-			targetId: string(),
-			sample: NotificationSchema.optional()
-		}), TestResultSchema, { kind: "mutation" }),
-		upsertTarget: method(object({ target: TargetSchema }), TargetSchema, { kind: "mutation" }),
-		deleteTarget: method(object({ targetId: string() }), _void(), { kind: "mutation" }),
-		setTargetEnabled: method(object({
-			targetId: string(),
-			enabled: boolean()
-		}), _void(), { kind: "mutation" })
-	}
-};
 /**
-* notification-rules — the Notification Center rule surface (P1 core).
+* `mqtt-broker` — broker-registry cap.
 *
-* Spec: `docs/superpowers/specs/2026-07-22-notification-center-requirements.md`
-* (operator decisions D-1/D-2/D-3 are binding):
+* NOT a pub/sub proxy. The cap exposes (a) a registry of configured
+* MQTT brokers (external + optionally an embedded `aedes`-backed one)
+* and (b) the connection details a consumer addon needs to spin up
+* its OWN `mqtt.js` client.
 *
-*  - D-2: rule EVALUATION lives in `addon-post-analysis` (the
-*    `notification-center` module), hooked on the durable persistence
-*    moments (object-event insert, TrackCloser.closeExpired) with a
-*    persisted outbox + retry — never the lossy telemetry bus (D8).
-*  - D-3: urgency belongs to the RULE. `delivery: 'immediate'` fires on the
-*    FIRST persisted detection matching the conditions (per-track dedup,
-*    `maxPerTrack` fixed at 1 — see {@link NC_MAX_PER_TRACK_IMMEDIATE});
-*    `delivery: 'track-end'` evaluates the finalized track record at close.
-*  - DISPATCH stays behind `notification-output` (rules reference targets
-*    by id; per-backend params are a passthrough blob capped by the
-*    target kind's own caps/degrade engine).
+* Why: pub/sub routing over the system event-bus loses fidelity
+* (callback shape, QoS guarantees, will/retain semantics) and adds
+* refcount bookkeeping that addons would rather own themselves. The
+* canonical consumer (`addon-export-ha-mqtt`) needs raw `mqtt.js`
+* features anyway — give it the connection config, get out of the way.
 *
-* P1 scope: admin-authored rules only (`createdBy` stamped from the
-* server-injected caller identity — the first `caller: 'required'`
-* adopter). The P1 condition subset is: devices, classes(+exclude),
-* minConfidence, admin zones (any/all + exclude), weekly schedule
-* windows, and the optional label/identity/plate matchers. User rules,
-* private zones, per-recipient fan-out and the wider condition table are
-* P2+ (see spec §7).
+* Consumer flow:
+*   const cfg = await ctx.api.mqttBroker.getBrokerConfig({ id })
+*   const client = mqtt.connect(cfg.url, { username: cfg.username, … })
+*   client.subscribe('zigbee2mqtt/+')
 *
-* All schemas here are the single source of truth — `NcRule` etc. are
-* `z.infer` exports; no duplicate interfaces (the advanced-notifier
-* schema/interface drift is explicitly not repeated).
+* Collection mode: multiple brokers (e.g. one local mosquitto + one
+* cloud bridge). The "embedded" entry (when present) is just another
+* broker in the registry — its lifecycle is owned by the addon that
+* spawned it.
 */
+var BrokerKindSchema = _enum(["external", "embedded"]);
 /**
-* D-3: the trigger/urgency of a rule — which persistence moment evaluates it.
-* The value maps 1:1 onto the evaluated record kind:
-*  - `immediate`     ↔ object-event persist (lowest-latency detection burst)
-*  - `track-end`     ↔ TrackCloser.closeExpired (finalized track record)
-*  - `device-event`  ↔ SensorEventStore insert (doorbell press / sensor state
-*                       change of a LINKED device, one row per linked camera)
-*  - `package-event` ↔ PackageDropDetector object-event insert (a `package`
-*                       delivery / pick-up)
+* Broker live-probe status.
 *
-* `immediate`/`track-end` carry the D-3 urgency semantics; `device-event`/
-* `package-event` are pure trigger kinds (no urgency dimension). Extending
-* this one field keeps the schema additive — a rule still declares exactly
-* one trigger.
-*/
-var NcDeliverySchema = _enum([
-	"immediate",
-	"track-end",
-	"device-event",
-	"package-event"
-]);
-/** Weekly schedule — OR of windows; absence on the rule = always active. */
-var NcScheduleSchema = object({
-	windows: array(object({
-		/** Days of week the window STARTS on (0 = Sunday … 6 = Saturday). */
-		days: array(number().int().min(0).max(6)).min(1),
-		startMinute: number().int().min(0).max(1439),
-		endMinute: number().int().min(0).max(1439)
-	})).min(1),
-	/** IANA timezone; default = hub host timezone. */
-	timezone: string().optional(),
-	/** Active OUTSIDE the windows (e.g. "only outside business hours"). */
-	invert: boolean().optional()
-});
-/** Fuzzy plate matcher — OCR noise makes exact match useless (spec row 12/13). */
-var NcPlateMatcherSchema = object({
-	values: array(string().min(1)).min(1),
-	/** Max Levenshtein distance after normalization (uppercase alphanumeric). */
-	maxDistance: number().int().min(0).max(3).default(1)
-});
-/**
-* Occupancy condition (DEVICE-EVENT trigger). Fires on a ZoneAnalytics
-* occupancy edge for a device — optionally narrowed to a single admin
-* `zoneId` and/or object `className`. `op` selects the edge/threshold:
-*  - `became-occupied` (default) — count crossed 0 → ≥ `count`
-*  - `became-free`               — count crossed ≥ `count` → below it
-*  - `>=` / `<=`                 — count is at/over or at/under `count`
-* `sustainSeconds` requires the condition hold continuously that long
-* before firing (debounces flicker; 0 = fire on the first matching edge).
-* Fail-closed: no ZoneAnalytics snapshot / missing zone / null snapshot ⇒
-* the condition never matches. Confirmed edge-state survives addon restarts
-* (declared SQLite collection, reseeded on boot).
+* - `connected` — last probe completed a clean CONNACK
+* - `disconnected` — no probe has run yet (cold cache)
+* - `auth-failed` — CONNACK refused with auth error (RC 4 / 5)
+* - `unreachable` — TCP connect timed out / refused
+* - `tls-error` — TLS handshake failed (cert / SNI / cipher)
 */
-var NcOccupancyConditionSchema = object({
-	/** Admin zone id to scope the count to; absent = whole-frame occupancy. */
-	zoneId: string().optional(),
-	/** Object class to count; absent = any class. */
-	className: string().optional(),
-	op: _enum([
-		"became-occupied",
-		"became-free",
-		">=",
-		"<="
-	]).default("became-occupied"),
-	count: number().int().min(0).default(1),
-	sustainSeconds: number().int().min(0).max(3600).default(15)
-});
-/** Admin-zone membership condition (zone IDs as stamped by the ZoneEngine). */
-var NcZoneConditionSchema = object({
-	ids: array(string().min(1)).min(1),
-	/** Quantifier over `ids` — at least one / every one visited. */
-	match: _enum(["any", "all"]).default("any")
+var BrokerStatusSchema$1 = _enum([
+	"connected",
+	"disconnected",
+	"auth-failed",
+	"unreachable",
+	"tls-error"
+]);
+var BrokerInfoSchema = object({
+	id: string(),
+	name: string(),
+	url: string(),
+	kind: BrokerKindSchema,
+	status: BrokerStatusSchema$1,
+	latencyMs: number().nullable(),
+	error: string().optional(),
+	/** Embedded brokers only: number of MQTT clients currently connected. */
+	connectedClients: number().int().nonnegative().optional(),
+	/** Epoch ms of the last live probe (external) or aedes snapshot (embedded). */
+	lastCheckedAt: number().optional()
 });
 /**
-* The P1 condition set — a flat AND of groups; absent group = pass;
-* membership lists are OR within the list (spec §2.3).
+* Connection details — what a consumer needs to call
+* `mqtt.connect(url, options)`. We split URL + credentials so the
+* consumer can pass them as `mqtt.connect(url, { username, password })`
+* instead of stuffing creds into the URL (which leaks them into logs).
 */
-var NcConditionsSchema = object({
-	/** Device scope — absent = all devices. */
-	devices: array(number()).optional(),
-	/** Detector class names (any overlap with the record's class set). */
-	classes: array(string().min(1)).optional(),
-	/** Veto classes — any overlap fails the rule. */
-	classesExclude: array(string().min(1)).optional(),
-	/** Minimum detection confidence 0–1 (fails when the record has none). */
-	minConfidence: number().min(0).max(1).optional(),
-	/** Admin zone membership over event `zones` / track `zonesVisited`. */
-	zones: NcZoneConditionSchema.optional(),
-	/** Veto zones — any hit fails the rule. */
-	zonesExclude: array(string().min(1)).optional(),
-	/**
-	* Exact (case-insensitive) match on the record's collapsed `label`
-	* (identity name / plate text / subclass).
-	*/
-	labelEquals: array(string().min(1)).optional(),
-	/**
-	* Identity matcher. P1 boundary: matched against the record's collapsed
-	* `label` (the identity display name propagated by the face pipeline) —
-	* identity-ID matching rides in P2 when identity ids reach the record.
-	*/
-	identities: array(string().min(1)).optional(),
-	/** Fuzzy plate matcher against the record's `label` (plate text). */
-	plates: NcPlateMatcherSchema.optional(),
-	/**
-	* Identity EXCLUDE — mirror of {@link identities} with `notIn` semantics.
-	* Same P1 boundary: matched against the record's collapsed `label` (the
-	* identity display name). A record with NO label passes (nothing to
-	* exclude), unlike the include variant which fails on an absent label.
-	*/
-	identitiesExclude: array(string().min(1)).optional(),
-	/**
-	* Minimum server-computed key-event importance in [0,1] (`Track.importance`).
-	* TRACK-END only: importance is scored at track close, so it does not exist
-	* at immediate / object-event evaluation time (see catalog `appliesTo`). At
-	* close the value is threaded via the close-time info (the `Track` clone is
-	* captured before the DB row is updated, so it would otherwise read stale).
-	* Fails when the record carries no importance (never guess quality — the
-	* `minConfidence` precedent). MVP cut: a single scalar threshold.
-	*/
-	minImportance: number().min(0).max(1).optional(),
-	/**
-	* Minimum track dwell in SECONDS — `(lastSeen − firstSeen) / 1000`.
-	* TRACK-END only: an `immediate` / object-event subject has no closed
-	* lifespan, so a dwell condition never matches immediate delivery
-	* (documented choice — the object-event record carries no `firstSeen`,
-	* so dwell cannot be computed from what the subject actually carries).
-	*/
-	minDwellSeconds: number().min(0).optional(),
-	/**
-	* Detection provenance filter. `any` (default / absent) matches every
-	* source; otherwise the subject's source must equal it. Legacy records
-	* with no stamped source are treated as `pipeline`. The union spans both
-	* record kinds — object events carry `pipeline` | `onboard`, synthetic
-	* tracks carry `sensor`.
-	*/
-	source: _enum([
-		"pipeline",
-		"onboard",
-		"sensor",
-		"any"
-	]).optional(),
-	/**
-	* Minimum identity / plate MATCH confidence in [0,1] — DISTINCT from the
-	* detector `minConfidence` (that gates the object-detection score; this
-	* gates the recognition/OCR match score). Fails when the subject carries
-	* no label-match confidence (never guess). TRACK-END only: the confidence
-	* lives on the recognition result and reaches the subject at track close.
-	*
-	* What it measures precisely (plumbed at track close — the closer threads
-	* the value into `NcTrackClosedInfo.labelConfidence`, the same seam as
-	* `importance`): the BEST recognition match confidence observed for the
-	* label the track carries at close — for a face, the peak cosine similarity
-	* of the ASSIGNED identity (`FaceMatch.score`, reset on an identity switch);
-	* for a plate, the peak OCR read score of the best-held plate
-	* (`plateText.confidence`). When BOTH a face and a plate were recognized on
-	* one track the higher of the two is used. A track that ended with no
-	* confident identity/plate match carries no value, so the condition fails
-	* closed for it (an un-recognized subject).
-	*/
-	minLabelConfidence: number().min(0).max(1).optional(),
-	/**
-	* DEVICE-EVENT only. Raw device event-type tokens (`EventFire.eventType`,
-	* e.g. a doorbell `press` / `press_long`) — matched case-insensitively
-	* against the token carried on the device-event subject (extracted from the
-	* event-emitter runtime slice's `lastEvent.eventType`). Fails when the
-	* subject carries no token. Doorbell-pulse / passive-sensor kinds emit no
-	* eventType, so gate those with {@link sensorKinds} instead.
-	*/
-	eventTypeTokens: array(string().min(1)).optional(),
-	/**
-	* DEVICE-EVENT only. Sensor/control taxonomy kinds (e.g. `doorbell`,
-	* `contact`, `button`, `device-event`) — matched against the persisted
-	* `SensorEvent.kind` (see `sensor-event-kinds.ts`). Membership is OR.
-	*/
-	sensorKinds: array(string().min(1)).optional(),
-	/**
-	* PACKAGE-EVENT only. Which package phase fires the rule — `delivered`
-	* (a parked parcel appeared), `picked-up` (it departed), or `both`. Fails
-	* when the subject's phase does not match (a subject always carries a phase
-	* on the package-event trigger).
-	*/
-	packagePhase: _enum([
-		"delivered",
-		"picked-up",
-		"both"
-	]).optional(),
-	/**
-	* PERSONAL-RULE custom zones (viewer-drawn). Inline normalized polygons
-	* (MaskShape vocabulary). A record passes when its bbox overlaps ANY
-	* listed polygon (ZoneEngine membership semantics). Evaluated only when
-	* the subject carries a bbox; absent bbox ⇒ the condition FAILS.
-	*/
-	customZones: array(MaskPolygonShapeSchema).optional(),
+var BrokerConnectionDetailsSchema = object({
+	url: string(),
+	username: string().optional(),
+	password: string().optional(),
 	/**
-	* DEVICE-EVENT only. ZoneAnalytics occupancy edge — fires when a device's
-	* (optionally zone/class-scoped) occupancy count crosses the configured
-	* threshold and holds for `sustainSeconds`. Fail-closed on missing
-	* substrate (no snapshot / missing zone). See {@link NcOccupancyCondition}.
+	* Suggested prefix for `clientId`. Each consumer should suffix this
+	* with its own discriminator (addon id, instance id) so reconnects
+	* don't kick each other off (MQTT spec: clientId must be unique per
+	* broker).
 	*/
-	occupancy: NcOccupancyConditionSchema.optional()
+	clientIdPrefix: string().optional()
 });
-/** One delivery target: a `notification-output` Target ref + passthrough params. */
-var NcRuleTargetSchema = object({
-	/** `notification-output` Target id. */
-	targetId: string().min(1),
-	/**
-	* Per-backend passthrough. Recognized keys are mapped onto the canonical
-	* Notification (`priority`, `level`, `sound`, `clickUrl`, `ttl`); the
-	* degrade engine drops what the backend can't render.
-	*/
-	params: record(string(), unknown()).optional()
+var AddBrokerInputSchema = object({
+	name: string().min(1),
+	url: string().regex(/^(mqtt|mqtts|ws|wss):\/\//, "URL must start with mqtt(s):// or ws(s)://"),
+	username: string().optional(),
+	password: string().optional(),
+	clientIdPrefix: string().optional()
+});
+var AddBrokerResultSchema = object({ id: string() });
+var IdInputSchema = object({ id: string() });
+var TestResultSchema$1 = discriminatedUnion("ok", [object({
+	ok: literal(true),
+	latencyMs: number()
+}), object({
+	ok: literal(false),
+	error: string()
+})]);
+var StartEmbeddedInputSchema = object({
+	port: number().int().min(1).max(65535).default(1883),
+	/** Allow anonymous connect (no username/password). Default: false. */
+	allowAnonymous: boolean().default(false),
+	/** Optional shared username/password for clients. */
+	username: string().optional(),
+	password: string().optional()
+});
+var StartEmbeddedResultSchema = object({
+	id: string(),
+	url: string()
+});
+var StatusSchema = object({
+	brokerCount: number(),
+	embeddedRunning: boolean()
+});
+method(_void(), array(BrokerInfoSchema)), method(IdInputSchema, BrokerConnectionDetailsSchema), method(AddBrokerInputSchema, AddBrokerResultSchema, { kind: "mutation" }), method(IdInputSchema, _void(), { kind: "mutation" }), method(IdInputSchema, TestResultSchema$1, { kind: "mutation" }), method(StartEmbeddedInputSchema, StartEmbeddedResultSchema, { kind: "mutation" }), method(IdInputSchema, _void(), { kind: "mutation" }), method(_void(), StatusSchema);
+var NetworkEndpointSchema = object({
+	url: string(),
+	hostname: string(),
+	port: number(),
+	protocol: _enum(["http", "https"])
+});
+var NetworkAccessStatusSchema = object({
+	connected: boolean(),
+	endpoint: NetworkEndpointSchema.nullable(),
+	error: string().optional()
 });
 /**
-* Media attachment policy (P1 still-image subset).
-*  - `best` — the best AVAILABLE subject image at dispatch time (D-3).
-*  - `best-matching` — the media that explains WHY the rule fired: a rule
-*    matched on identities attaches the subject's `faceCrop`, one matched on
-*    plates attaches the `plateCrop`; a rule with no identity/plate condition
-*    (or when the specific crop is missing) degrades to `best`, then
-*    `keyFrame`, then no attachment — never delaying the send. The matched
-*    condition summary is frozen on the outbox row at enqueue (like the rule
-*    name), so the choice never drifts from the record that fired it.
-*  - `keyFrame` — the clean scene frame (no subject box).
-*  - `none` — no attachment.
+* Optional, richer endpoint shape returned by providers that expose
+* MORE than one ingress concurrently (Tailscale Ingress with mixed
+* serve+funnel rules, future ngrok multi-tunnel, …). Each entry carries
+* the originating provider config (mode + sourcePort) so the
+* orchestrator UI can label rows distinctly. Providers that expose only
+* one endpoint just omit `listEndpoints` from their provider impl.
 */
-var NcMediaPolicySchema = object({ attach: _enum([
-	"best",
-	"best-matching",
-	"keyFrame",
-	"none"
-]).default("best") });
-/** Throttle — cooldown survives restarts (rebuilt from the outbox on boot). */
-var NcThrottleSchema = object({
-	cooldownSec: number().int().min(0).max(86400).default(60),
-	/** `rule` = one shared cooldown; `rule-device` = per-camera cooldown. */
-	scope: _enum(["rule", "rule-device"]).default("rule-device")
-});
-/** Client-supplied rule fields (server stamps id/createdBy/createdAt/updatedAt). */
-var NcRuleInputSchema = object({
-	name: string().min(1).max(200),
-	enabled: boolean().default(true),
-	delivery: NcDeliverySchema,
-	conditions: NcConditionsSchema.default({}),
-	schedule: NcScheduleSchema.optional(),
-	targets: array(NcRuleTargetSchema).min(1),
-	media: NcMediaPolicySchema.default({ attach: "best" }),
-	throttle: NcThrottleSchema.default({
-		cooldownSec: 60,
-		scope: "rule-device"
-	}),
-	/** `{{var}}` templating over camera/class/label/zones/confidence/time. */
-	template: object({
-		title: string().max(500).optional(),
-		body: string().max(2e3).optional()
-	}).optional(),
-	/** Canonical notification priority ordinal (1..5); per-target overridable. */
-	priority: number().int().min(1).max(5).default(3),
-	/**
-	* Ownership/visibility key. Absent = admin/global rule (unchanged legacy
-	* behaviour, visible to all, read-only in the viewer). Present = personal
-	* rule owned by this userId. Server-stamped; never trusted from a client.
+var NetworkEndpointEntrySchema = NetworkEndpointSchema.extend({
+	/**
+	* Stable id within the provider — typically `<mode>-<sourcePort>` so
+	* the orchestrator can dedupe across `listEndpoints` polls.
 	*/
-	ownerUserId: string().optional()
+	id: string(),
+	/** Operator-facing label (mirrors `MeshEndpoint.label`). */
+	label: string(),
+	/** Optional provider-specific mode tag, used for icon/colour in admin UI. */
+	mode: string().optional(),
+	/** Originating local port the ingress fronts (informational). */
+	sourcePort: number().optional()
 });
+method(_void(), NetworkEndpointSchema, { kind: "mutation" }), method(_void(), _void(), { kind: "mutation" }), method(_void(), NetworkEndpointSchema.nullable()), method(_void(), NetworkAccessStatusSchema), method(_void(), array(NetworkEndpointEntrySchema).readonly());
 /**
-* Partial patch for `updateRule` — any subset of the input fields, plus the
-* persisted-only {@link NcRuleSchema} `disabledTargetIds` set. The latter is
-* NOT a client-authored input field (it lives on the persisted rule, not the
-* input), so it is added here explicitly to let the store's per-target opt-out
-* toggle round-trip through the shared `update` path. Viewer opt-out mutations
-* still flow through `nc.setRuleTargetEnabled` (owner-checked), never a raw
-* `updateRule` patch.
+* notification-output — canonical, capability-gated notification delivery.
+*
+* Apprise-derived model (see
+* `docs/superpowers/specs/2026-07-03-notification-output-notifier-matrix.md`):
+* callers emit ONE canonical `Notification`; each provider declares a
+* per-kind capability descriptor (`TargetKind`), and the pure degrade
+* engine (`@camstack/types` `prepareNotification`) transcodes / degrades the
+* message to what the kind supports — callers never special-case a service.
+*
+* DESIGN DECISIONS (locked):
+*  - Target CRUD lives on THIS cap (`upsertTarget` / `deleteTarget` /
+*    `setTargetEnabled`), each provider persisting via the `settings-store`
+*    cap. Rationale: the admin UI needs one uniform surface across the
+*    notifiers addon AND the HA addon; the addon-`globalSettingsSchema`-array
+*    alternative would fork the UI per addon and cannot host the
+*    discovery→adopt flow.
+*  - `listTargetKinds` / `listTargets` / `discoverTargets` return arrays →
+*    the generated cap-mount auto-`concatCollection`-fans them across every
+*    registered provider (notifiers addon + HA addon) so one catalog is
+*    routable. `send` / `testTarget` / CRUD route to ONE provider by the
+*    `addonId` the generated collection router extracts from the call input.
+*  - `Attachment.bytes` is `Uint8Array`. Transport-safe: superjson (the tRPC
+*    transformer) + UDS MsgPack both round-trip typed arrays — already used by
+*    `storage` / `storage-provider` / `recording` caps over the same path. No
+*    base64 fallback needed.
+*
+* TODO (deferred, closed-set change — separate decision): add
+* `providerKind: 'notify'` so notification providers surface on the unified
+* admin "Integrations" page.
 */
-var NcRulePatchSchema = NcRuleInputSchema.partial().extend({ disabledTargetIds: array(string()).optional() });
-/** A persisted rule. */
-var NcRuleSchema = NcRuleInputSchema.extend({
+/**
+* Zentik-derived typed-media enum — the superset across every kind. Each
+* adapter picks what it supports and the degrade engine filters the rest.
+*/
+var AttachmentMediaTypeSchema = _enum([
+	"image",
+	"video",
+	"gif",
+	"audio",
+	"icon"
+]);
+/**
+* A single attachment. Exactly one of `url` (remote source, most adapters
+* prefer this) or `bytes` (inline source; required for Pushover-style
+* bytes-only kinds) MUST be present — the degrade engine expresses a
+* url→bytes fetch as a `needsFetch` directive the adapter executes.
+*/
+var AttachmentSchema = object({
+	mediaType: AttachmentMediaTypeSchema,
+	url: string().optional(),
+	bytes: _instanceof(Uint8Array).optional(),
+	mime: string().optional(),
+	name: string().optional()
+}).refine((a) => a.url !== void 0 || a.bytes !== void 0, { message: "Attachment requires either `url` or `bytes`" });
+var NotificationFormatSchema = _enum([
+	"text",
+	"markdown",
+	"html"
+]);
+/** A single tap-through action button. */
+var NotificationActionSchema = object({
 	id: string(),
-	/** userId of the admin who created the rule (server-stamped caller). */
-	createdBy: string(),
-	createdAt: number(),
-	updatedAt: number(),
-	/**
-	* Per-target opt-out set. A targetId here is suppressed for THIS rule at
-	* send time. Only a target's OWNER may add/remove its id (server-checked
-	* in `nc.setRuleTargetEnabled`). Defaults to empty.
-	*/
-	disabledTargetIds: array(string()).default([])
+	label: string(),
+	url: string().optional()
 });
-var NcTestResultSchema = object({
-	recordId: string(),
-	recordKind: _enum([
-		"object-event",
-		"track",
-		"device-event",
-		"package-event"
-	]),
-	deviceId: number(),
-	timestamp: number(),
-	wouldFire: boolean(),
-	/** Condition id that failed (first failing group), when `wouldFire` is false. */
-	failedCondition: string().optional(),
-	className: string().optional(),
-	label: string().optional()
+/**
+* The canonical notification. `body` is the only hard field (Apprise model).
+* `priority` is a 5-level ORDINAL (1=lowest … 3=normal(default) … 5=urgent),
+* NOT a fixed severity enum — each kind declares its own `caps.levels` and
+* the adapter maps this ordinal onto its native level. `level?` is an
+* optional kind-native level id (`emergency`, `silent`, …) that overrides
+* `priority` for that one target.
+*/
+var NotificationSchema = object({
+	body: string(),
+	title: string().optional(),
+	format: NotificationFormatSchema.default("text"),
+	priority: number().int().min(1).max(5).default(3),
+	level: string().optional(),
+	attachments: array(AttachmentSchema).optional(),
+	clickUrl: string().optional(),
+	actions: array(NotificationActionSchema).optional(),
+	sound: string().optional(),
+	ttl: number().optional(),
+	tag: string().optional(),
+	deviceId: number().optional(),
+	eventId: string().optional(),
+	metadata: record(string(), unknown()).optional()
 });
-var NcConditionDescriptorSchema = object({
-	/** Field id inside `NcConditions` (or `'schedule'` for the rule-level group). */
+/** One declared native severity/priority level for a kind. */
+var TargetKindLevelSchema = object({
 	id: string(),
-	group: _enum([
-		"scope",
-		"class",
-		"zones",
-		"quality",
-		"label",
-		"schedule",
-		"device",
-		"package",
-		"occupancy"
-	]),
 	label: string(),
-	/** Editor widget the UI renders — never hardcode per-condition forms. */
-	valueType: _enum([
-		"deviceIdList",
-		"stringList",
-		"number01",
-		"number",
-		"sourceSelect",
-		"zoneSelection",
-		"zoneIdList",
-		"schedule",
-		"plateMatcher",
-		"packagePhase",
-		"polygonDraw",
-		"occupancy"
-	]),
-	operator: _enum([
-		"in",
-		"notIn",
-		"anyOf",
-		"allOf",
-		"gte",
-		"fuzzyIn",
-		"withinSchedule"
-	]),
-	/** Which delivery kinds the condition applies to. */
-	appliesTo: array(NcDeliverySchema),
-	phase: string(),
+	/** Which canonical priority (1..5) this level maps to. `null` = qualitative-only. */
+	ordinal: number().int().min(1).max(5).nullable(),
+	flags: object({
+		critical: boolean().optional(),
+		silent: boolean().optional(),
+		noPush: boolean().optional()
+	}).optional(),
+	/** e.g. Pushover `emergency` requires `retry` / `expire`. */
+	requires: array(string()).optional(),
 	description: string().optional()
 });
+/** The full capability block consulted before dispatch. */
+var TargetKindCapsSchema = object({
+	attachments: object({
+		mediaTypes: array(AttachmentMediaTypeSchema),
+		mode: _enum([
+			"url",
+			"bytes",
+			"both"
+		]),
+		max: number().int().nonnegative(),
+		maxBytes: number().int().positive().optional()
+	}),
+	/** Max action buttons (0 = none). */
+	actions: number().int().nonnegative(),
+	levels: array(TargetKindLevelSchema),
+	format: array(NotificationFormatSchema),
+	clickUrl: boolean(),
+	sound: boolean(),
+	ttl: boolean(),
+	bodyMaxLen: number().int().positive()
+});
 /**
-* The delivery lifecycle status of a history row — a straight read of the
-* durable outbox row's own status (single source of truth):
-*  - `pending` — enqueued, in-flight or retrying with backoff
-*  - `sent`    — delivered (terminal)
-*  - `dead`    — dead-lettered after exhausting retries / a permanent
-*                backend rejection / a deleted target (terminal; carries
-*                the failure `error`)
-*
-* P1 has no `suppressed-quiet-hours` / `snoozed` states — those ride the P2
-* user dimension (quiet hours / snooze) and are additive when they land.
+* `configSchema` is a `ConfigUISchema` tree passed through to the admin
+* FormBuilder. Stored as `z.unknown()` at the cap seam (mirrors
+* `device-provider.getChildCreationSchema` `CreationSchemaOutputSchema`) —
+* the union is large and not meant for runtime validation here; the exported
+* `TargetKind` type re-tightens `configSchema` to `ConfigUISchema`.
 */
-var NcHistoryStatusSchema = _enum([
-	"pending",
-	"sent",
-	"dead"
-]);
-/** The evaluated record kind a history row descends from (one per trigger). */
-var NcHistoryRecordKindSchema = _enum([
-	"object-event",
-	"track-end",
-	"device-event",
-	"package-event"
-]);
-/** Subject summary frozen on the row at fire time (survives rule/record edits). */
-var NcHistorySubjectSchema = object({
-	className: string(),
-	label: string().optional(),
-	confidence: number().optional(),
-	zones: array(string()),
-	timestamp: number()
+var ConfigSchemaPassthrough = unknown();
+var TargetKindSchema = object({
+	kind: string(),
+	label: string(),
+	icon: string(),
+	/** Stamped by each provider so the concat-fanned catalog stays routable. */
+	addonId: string(),
+	/**
+	* URL of the kind's bundled BRAND icon, served by the providing addon over
+	* its own `addon-routes` surface (`/addon/<addonId>/icons/<kind>`). Absent
+	* when the addon bundles no icon for that kind — the client then falls back
+	* to a neutral glyph rather than rendering the raw `icon` NAME as text.
+	*
+	* Root-relative on purpose: it resolves against whatever origin serves a web
+	* client, and a native client joins it onto its own hub base.
+	*
+	* DECLARED here deliberately. It used to travel as an undeclared passthrough
+	* field that survived only because the runtime cap-router forwards provider
+	* output verbatim — so every consumer had to re-declare it by hand to stop
+	* its own Zod parse from stripping it, and the whole arrangement would have
+	* broken silently the moment output validation was tightened anywhere.
+	*/
+	iconUrl: string().optional(),
+	/**
+	* Media type of {@link iconUrl} (`image/svg+xml`, `image/png`, …).
+	*
+	* The server knows this and therefore says it, because the client cannot
+	* safely guess: a React-Native client renders SVG and raster through two
+	* DIFFERENT components (`react-native-svg` vs `expo-image` — expo-image does
+	* not decode SVG on iOS/Android), so without this it silently fell back to a
+	* placeholder glyph for every vector icon while the web build looked fine.
+	*
+	* Absent when {@link iconUrl} is absent, or for a legacy provider that has
+	* not been updated — a client that cannot determine the type should prefer
+	* its raster path, which is the safe default for an unknown image.
+	*/
+	iconMediaType: string().optional(),
+	configSchema: ConfigSchemaPassthrough,
+	supportsDiscovery: boolean(),
+	caps: TargetKindCapsSchema
 });
 /**
-* One delivery-history row. This is a read-only VIEW over the durable
-* outbox row (single source of truth — the same row the drain loop drives;
-* NO second write path, so history can never drift from delivery state).
-* The §3.2 fields map directly: `ruleId`/`targetId`/`deviceId` are columns,
-* `eventRef` is `recordKind`+`recordId`, `timestamps` are `createdAt`
-* (fire) / `updatedAt` (last transition), `status` + `error` are the
-* lifecycle. `ruleName` + `subject` are the intent snapshot frozen at
-* enqueue. `userId?` (per-recipient history) is P2 — no user dimension in
-* P1 (admin scope only).
+* A persisted target. `config` holds secrets; providers REDACT secret fields
+* (return a presence marker only) when serving `listTargets` — never
+* round-trip a stored secret to the UI.
 */
-var NcHistoryEntrySchema = object({
-	/** Outbox row id — the stable dedup id `ruleId:dedupRef:targetId`. */
+var TargetSchema = object({
 	id: string(),
-	ruleId: string(),
-	/** Rule name frozen at fire time (outlives a later rename / delete). */
-	ruleName: string(),
-	/** The rule urgency/trigger that produced this delivery. */
-	delivery: NcDeliverySchema,
-	targetId: string(),
-	deviceId: number(),
-	recordKind: NcHistoryRecordKindSchema,
-	/** Event / track ref of the evaluated record (§3.2 `eventRef`). */
-	recordId: string(),
-	/** Present for track-scoped deliveries (object-event / track-end). */
-	trackId: string().optional(),
-	status: NcHistoryStatusSchema,
-	/** Delivery attempts made so far. */
-	attempts: number().int(),
-	/** Fire time (outbox enqueue). */
-	createdAt: number(),
-	/** Last transition time (terminal for sent / dead). */
-	updatedAt: number(),
-	/** Failure detail — present on a `dead` row. */
-	error: string().optional(),
-	subject: NcHistorySubjectSchema
+	name: string(),
+	kind: string(),
+	addonId: string(),
+	enabled: boolean(),
+	config: record(string(), unknown())
 });
-/**
-* Query filter for `getHistory` (spec §4.2). Every field is a narrowing
-* AND; absent = unbounded on that axis. `since`/`until` bound the fire time
-* (`createdAt`, epoch ms, inclusive). `limit` is clamped to
-* {@link NC_HISTORY_LIMIT_MAX}. `userId` (per-recipient filtering) is P2.
-*/
-var NcHistoryFilterSchema = object({
-	ruleId: string().optional(),
-	deviceId: number().optional(),
-	status: NcHistoryStatusSchema.optional(),
-	since: number().optional(),
-	until: number().optional(),
-	limit: number().int().min(1).max(500).default(100)
+/** A discovery-surfaced candidate (config is partial + non-secret). */
+var DiscoveredTargetSchema = object({
+	kind: string(),
+	suggestedName: string(),
+	config: record(string(), unknown())
 });
-method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), method(object({ ruleId: string() }), object({ rule: NcRuleSchema.nullable() }), { auth: "admin" }), method(object({ rule: NcRuleInputSchema }), object({ rule: NcRuleSchema }), {
-	kind: "mutation",
-	auth: "admin",
-	caller: "required"
-}), method(object({
-	ruleId: string(),
-	patch: NcRulePatchSchema
-}), object({ rule: NcRuleSchema }), {
-	kind: "mutation",
-	auth: "admin",
-	caller: "required"
-}), method(object({ ruleId: string() }), object({ success: literal(true) }), {
-	kind: "mutation",
-	auth: "admin"
-}), method(object({
-	ruleId: string(),
-	enabled: boolean()
-}), object({ success: literal(true) }), {
-	kind: "mutation",
-	auth: "admin"
-}), method(object({
-	rule: NcRuleInputSchema,
-	lookbackMinutes: number().int().min(1).max(1440).default(60)
-}), object({ results: array(NcTestResultSchema) }), {
-	kind: "mutation",
-	auth: "admin"
-}), method(object({}), object({ catalog: array(NcConditionDescriptorSchema) })), method(object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), object({ entries: array(NcHistoryEntrySchema) }), { auth: "admin" });
+/** The degrade engine's report — what was resolved / dropped / degraded. */
+var RenderedAsSchema = object({
+	level: string(),
+	format: NotificationFormatSchema,
+	attachmentsSent: number().int().nonnegative(),
+	actionsSent: number().int().nonnegative(),
+	truncated: boolean(),
+	dropped: array(string())
+});
+var SendResultSchema = object({
+	success: boolean(),
+	error: string().optional(),
+	renderedAs: RenderedAsSchema.optional()
+});
+/** Same shape as SendResult — kept as a distinct name for the test panel. */
+var TestResultSchema = SendResultSchema;
+var notificationOutputCapability = {
+	name: "notification-output",
+	scope: "system",
+	mode: "collection",
+	methods: {
+		listTargetKinds: method(object({}), array(TargetKindSchema)),
+		listTargets: method(object({}), array(TargetSchema)),
+		discoverTargets: method(object({
+			kind: string(),
+			config: record(string(), unknown()).optional()
+		}), array(DiscoveredTargetSchema)),
+		send: method(object({
+			targetId: string(),
+			notification: NotificationSchema
+		}), SendResultSchema, { kind: "mutation" }),
+		testTarget: method(object({
+			targetId: string(),
+			sample: NotificationSchema.optional()
+		}), TestResultSchema, { kind: "mutation" }),
+		upsertTarget: method(object({ target: TargetSchema }), TargetSchema, { kind: "mutation" }),
+		deleteTarget: method(object({ targetId: string() }), _void(), { kind: "mutation" }),
+		setTargetEnabled: method(object({
+			targetId: string(),
+			enabled: boolean()
+		}), _void(), { kind: "mutation" })
+	}
+};
 /**
 * Zod schemas for persisted record types.
 *
@@ -20662,6 +21018,15 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 }), method(object({ deviceId: number() }), EventPruneCountsSchema, {
 	kind: "mutation",
 	auth: "admin"
+}), method(RelocateMediaInputSchema, object({ jobId: string() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({}), array(RelocateJobSchema).readonly(), {
+	kind: "query",
+	auth: "admin"
+}), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
 	kind: "query",
 	auth: "admin"
@@ -23230,6 +23595,17 @@ var GetConnectionEndpointsResultSchema = object({ endpoints: array(object({
 	*/
 	priority: number()
 })).readonly() });
+/**
+* The chosen outbound endpoint for notification artifacts. `baseUrl: null` =
+* AUTO (resolved from the candidate ranking at send time); `resolved` reports
+* what AUTO currently picks, so the UI can show the effective value either way.
+*/
+var NotificationEndpointSchema = object({
+	/** The operator's explicit choice, or null for AUTO. */
+	baseUrl: string().nullable(),
+	/** What the ranking currently resolves to (null when nothing is reachable). */
+	resolved: string().nullable()
+});
 var AllowedAddressesSchema = object({ 
 /**
 * Allowlist of interface addresses operators have explicitly opted
@@ -23252,7 +23628,7 @@ method(_void(), ListResultSchema), method(_void(), PreferredSchema), method(obje
 	*  to avoid mixed-content blocks in the browser. The public
 	*  tunnel always emits `https://` regardless. */
 	scheme: _enum(["http", "https"]).optional()
-}), GetConnectionEndpointsResultSchema), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" });
+}), GetConnectionEndpointsResultSchema), method(_void(), NotificationEndpointSchema), method(object({ baseUrl: string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }), method(_void(), AllowedAddressesSchema), method(AllowedAddressesSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), AllowedAddressesSchema, { kind: "mutation" });
 /**
 * mesh-network — collection cap for mesh-VPN providers.
 *
@@ -24051,7 +24427,12 @@ var RecordingDeviceUsageSchema = object({
 var RecordingLocationUsageSchema = object({
 	/** StorageLocation id; null for the legacy/degraded single-root fallback. */
 	locationId: string().nullable(),
-	/** Bytes of recordings stored on this location. */
+	/** Every location id sharing this row's PHYSICAL volume (aliases). One row
+	*  is emitted per physical disk (2026-07-29): two locations on one root
+	*  previously rendered as two identical "disks" with a nonsensical used
+	*  split — hydrate attribution across aliases is arbitrary by nature. */
+	locationIds: array(string()).optional(),
+	/** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
 	usedBytes: number(),
 	/** Free bytes on the location's volume; null when capacity is unknown (remote). */
 	availableBytes: number().nullable(),
@@ -24163,6 +24544,44 @@ method(object({
 }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
 	kind: "query",
 	auth: "admin"
+}), method(object({
+	deviceId: number(),
+	aroundMs: number(),
+	preRollSec: number().min(0).max(30).default(2),
+	postRollSec: number().min(0).max(30).default(5),
+	maxWidth: number().int().min(120).max(1280).default(480),
+	fps: number().int().min(1).max(15).default(5)
+}), object({
+	gifBase64: string(),
+	fromMs: number(),
+	toMs: number()
+}), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({
+	deviceId: number(),
+	aroundMs: number(),
+	preRollSec: number().min(0).max(30).default(3),
+	postRollSec: number().min(0).max(30).default(7),
+	maxWidth: number().int().min(160).max(1920).default(640)
+}), object({
+	clipBase64: string(),
+	mime: string(),
+	fromMs: number(),
+	toMs: number(),
+	bytes: number().int()
+}), {
+	kind: "mutation",
+	auth: "admin"
+}), method(RelocateFootageInputSchema, object({ jobId: string() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({}), array(RelocateJobSchema).readonly(), {
+	kind: "query",
+	auth: "admin"
+}), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
+	kind: "mutation",
+	auth: "admin"
 });
 /**
 * `recordingExport` cap — render a footage time range into a single downloadable
@@ -25076,6 +25495,12 @@ Object.freeze({
 		addonId: null,
 		access: "delete"
 	},
+	"backup.deleteSchedule": {
+		capName: "backup",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"backup.getEntries": {
 		capName: "backup",
 		capScope: "system",
@@ -25106,6 +25531,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"backup.listSchedules": {
+		capName: "backup",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"backup.previewSchedule": {
 		capName: "backup",
 		capScope: "system",
@@ -25130,6 +25561,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"backup.upsertSchedule": {
+		capName: "backup",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"battery.wakeForStream": {
 		capName: "battery",
 		capScope: "device",
@@ -26630,6 +27067,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"localNetwork.getNotificationEndpoint": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"localNetwork.getPreferred": {
 		capName: "local-network",
 		capScope: "system",
@@ -26654,6 +27097,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"localNetwork.setNotificationEndpoint": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"lockControl.lock": {
 		capName: "lock-control",
 		capScope: "device",
@@ -27296,6 +27745,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.cancelMediaRelocate": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineAnalytics.clearTracks": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -27350,6 +27805,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getMediaRelocateStatus": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getMotionEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -27422,6 +27883,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineAnalytics.relocateMedia": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineAnalytics.searchObjectEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -28184,6 +28651,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"recording.cancelRelocate": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"recording.deleteFootprint": {
 		capName: "recording",
 		capScope: "system",
@@ -28214,6 +28687,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"recording.getRelocateStatus": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"recording.getStorageUsage": {
 		capName: "recording",
 		capScope: "system",
@@ -28244,6 +28723,24 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"recording.relocateFootage": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"recording.renderClip": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"recording.renderGif": {
+		capName: "recording",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"recording.rescanStorage": {
 		capName: "recording",
 		capScope: "system",
@@ -28838,6 +29335,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"streamBroker.renderPreBufferClip": {
+		capName: "stream-broker",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"streamBroker.restartProfile": {
 		capName: "stream-broker",
 		capScope: "system",
@@ -28964,6 +29467,36 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"terminalSession.close": {
+		capName: "terminal-session",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"terminalSession.listProfiles": {
+		capName: "terminal-session",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"terminalSession.listSessions": {
+		capName: "terminal-session",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"terminalSession.openSession": {
+		capName: "terminal-session",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"terminalSession.resize": {
+		capName: "terminal-session",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"toast.onToast": {
 		capName: "toast",
 		capScope: "system",
@@ -35803,6 +36336,17 @@ var HOME_ASSISTANT_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0
 * the admin UI is served from.
 */
 var HA_NOTIFICATION_ICON_URL = `/addon/${HA_ROUTE_ID}/icons/${HA_ICON_KIND}`;
+/**
+* Media type of {@link HA_NOTIFICATION_ICON_URL}, stamped onto the kind
+* descriptor beside the URL.
+*
+* Not decoration: a React-Native client renders SVG and raster through
+* DIFFERENT components (`react-native-svg` vs `expo-image`, and expo-image does
+* not decode SVG on iOS/Android), and it cannot infer the type from the URL
+* because the route path carries no file extension. Without this the viewer
+* treats the icon as raster and falls back to a placeholder glyph.
+*/
+var HA_NOTIFICATION_ICON_MEDIA_TYPE = "image/svg+xml";
 /** The icon's identity bytes plus every content coding we may serve, computed
 *  once at module load (the icon is immutable). */
 var HA_ICON_IDENTITY = Buffer.from(HOME_ASSISTANT_SVG, "utf8");
@@ -36239,10 +36783,14 @@ function createHaNotificationOutputProvider(deps) {
 	}
 	return {
 		listTargetKinds: async () => {
-			return [deps.iconUrl !== void 0 ? {
+			return [deps.iconUrl === void 0 ? descriptor : deps.iconMediaType !== void 0 ? {
+				...descriptor,
+				iconUrl: deps.iconUrl,
+				iconMediaType: deps.iconMediaType
+			} : {
 				...descriptor,
 				iconUrl: deps.iconUrl
-			} : descriptor];
+			}];
 		},
 		listTargets: async () => {
 			return (await store.list()).map((target) => ({
@@ -36826,6 +37374,7 @@ var HaProviderAddon = class HaProviderAddon extends BaseDeviceProvider {
 		return createHaNotificationOutputProvider({
 			addonId: this.ctx.id,
 			iconUrl: HA_NOTIFICATION_ICON_URL,
+			iconMediaType: HA_NOTIFICATION_ICON_MEDIA_TYPE,
 			store,
 			publish: async (brokerId, service, serviceData) => {
 				await this.requireRegistry().publish(brokerId, {