@camstack/system 1.2.474 → 1.2.476

package/dist/{dist-BugavoVR.mjs → dist-B_V9r61Z.mjs}

@@ -5484,7 +5484,7 @@ function errMsg(err) {
 	return String(err);
 }
 //#endregion
-//#region ../types/dist/composition-xz-ud5EQ.mjs
+//#region ../types/dist/composition-BJ8iAZb3.mjs
 var AUDIO_ENCODER_BY_CODEC = {
 	opus: "libopus",
 	aac: "aac",
@@ -5936,7 +5936,7 @@ portable("linux64"), portable("linuxarm64"), portable("macarm64"), portable("mac
 * ONE table for everyone who asks "is this device HIGH?": the
 * recorder's `RecordingTriggers.sensorDeviceIds` trigger, the post-analysis
 * sensor markers, the orchestrator's camera-sensors bridge and
-* the sources of a composite doorbell (`doorbellFeatureSources`, D671).
+* the sources of a pulse (`compilePulseOverride`, D936).
 * A second copy would diverge at the first cap added, and the symptom — "the
 * sensor rings the doorbell but does not record" — is exactly D62.
 *
@@ -15519,6 +15519,13 @@ var ComposerUnreadableBlockSchema = z.object({
 	/** The parse error, in the operator's words. */
 	error: z.string()
 });
+/** A confirmed release the hub did not accept. `deviceId` is the claim's device. */
+var UnreleasedClaimSchema = z.object({
+	deviceId: z.number().int(),
+	capName: z.string(),
+	owner: z.string(),
+	error: z.string()
+});
 var ComposerApplyInputSchema = z.object({
 	/** The shared Blocks integration; null until `core-blocks` has reconciled it. */
 	integrationId: z.string().nullable(),
@@ -15528,7 +15535,13 @@ var ComposerApplyInputSchema = z.object({
 	/** Operator restarts: rebuild these runtimes and re-resolve their sources. Stores nothing (D62). */
 	restartBlockIds: z.array(z.string()),
 	/** Composition rows that exist but do not parse: held, never withdrawn, reported failed. */
-	unreadableBlocks: z.array(ComposerUnreadableBlockSchema)
+	unreadableBlocks: z.array(ComposerUnreadableBlockSchema),
+	/**
+	* Operator-confirmed deletions. Their claims are released on this apply,
+	* before any replacement block claims. A block that merely vanished from the
+	* snapshot is not listed here and still waits for two applies (D49).
+	*/
+	retiredBlockIds: z.array(z.string()).optional()
 });
 var ComposerBlockVerdictSchema = z.object({
 	blockId: z.string(),
@@ -15552,7 +15565,13 @@ var composerCapability = {
 			* integration unknown, its own rows unread or read empty once). An empty
 			* apply the caller owes is paid off only by one the composer acted on (D49).
 			*/
-			acted: z.boolean()
+			acted: z.boolean(),
+			/**
+			* Confirmed releases this apply tried and the hub did not accept. Empty when
+			* every one landed (or there was nothing to hand back). Absent on a result
+			* that never got that far.
+			*/
+			unreleasedClaims: z.array(UnreleasedClaimSchema).optional()
 		}), {
 			kind: "mutation",
 			auth: "admin"
@@ -60151,20 +60170,68 @@ var BatteryStatusSchema = z.object({
 	*/
 	binary: z.boolean().optional()
 });
+var BATTERY_DEVICE_TYPES = [
+	DeviceType.Camera,
+	DeviceType.Sensor,
+	DeviceType.Button,
+	DeviceType.Switch,
+	DeviceType.PetFeeder,
+	DeviceType.Container,
+	DeviceType.Thermostat
+];
+/** Generic Customize target for the percentage reading (D936). */
+var batteryCustomize = {
+	version: 1,
+	targets: [{
+		id: "percentage",
+		cardinality: "scalar",
+		vocabulary: {
+			cap: "battery",
+			stateField: "percentage"
+		},
+		deviceTypes: BATTERY_DEVICE_TYPES,
+		apply: "add-or-replace",
+		path: "percentage",
+		sources: [{
+			kind: "field",
+			valueKinds: ["number", "string"],
+			transforms: [{ kind: "identity" }, {
+				kind: "linear",
+				defaultScale: 1,
+				defaultOffset: 0,
+				clampMin: 0,
+				clampMax: 100
+			}]
+		}],
+		companions: [
+			{
+				kind: "constant",
+				path: "charging",
+				value: "unknown",
+				when: "add"
+			},
+			{
+				kind: "constant",
+				path: "sleeping",
+				value: false,
+				when: "add"
+			},
+			{
+				kind: "clock",
+				path: "lastUpdated",
+				when: "add"
+			}
+		],
+		sourceReport: { status: "assignment-status" },
+		advancedExpression: true
+	}]
+};
 var batteryCapability = {
 	name: "battery",
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [
-		DeviceType.Camera,
-		DeviceType.Sensor,
-		DeviceType.Button,
-		DeviceType.Switch,
-		DeviceType.PetFeeder,
-		DeviceType.Container,
-		DeviceType.Thermostat
-	],
+	deviceTypes: BATTERY_DEVICE_TYPES,
 	methods: { 
 	/**
 	* Explicitly wake the camera from low-power sleep ahead of a
@@ -60248,6 +60315,7 @@ onStatusChanged: { data: z.object({
 		kind: "gauge",
 		unit: "%"
 	} } },
+	customize: batteryCustomize,
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
 	volatileStateFields: ["lastUpdated"]
@@ -61313,6 +61381,106 @@ var ConsumablesStatusSchema = z.object({
 	items: z.array(ConsumableItemSchema),
 	lastChangedAt: z.number()
 });
+/** Synthesize seed for a link-built status (no native provider).
+*
+*  ⚠ NO LIVE CALLER since 2026-08-08 (device-links deleted; see
+*  `CapabilityStatusSchema.empty`). The wiring guidance below was written for
+*  exactly the case the operator is asking about again — a Dreame's HA
+*  consumable-life sensors — so it is kept for that conversation, not because
+*  anything reads it today. */
+var EMPTY_STATUS = {
+	items: [],
+	lastChangedAt: 0
+};
+/** Seed for a NEW link-built consumable item. `key`/`label` are overwritten
+*  with the link's `itemKey` (see `status.itemArray`), so the placeholder
+*  empty strings never survive into a validated item. Link-built items are
+*  not resettable — there is no native provider to receive `reset()`.
+*
+*  Wiring guidance (HA vacuum consumable-life sensors):
+*  - a percent-remaining source (`numeric-sensor`, unit '%') → `level` via
+*    `identity` (or `linear` scale 1 offset 0 clamp [0,100] to be safe);
+*  - an hours-remaining source (e.g. Dreame 'Main Brush Time Left', unit 'h')
+*    → `level` via `linear` with scale = 100 / max-hours for that item
+*    (e.g. main brush 300 h → scale 0.3333) + clamp [0,100];
+*  - a discrete source (`enum-sensor`, e.g. mop pad 'installed') → `status`
+*    via `enum-map` (e.g. { installed: 'ok', missing: 'replace' }).
+*  A numeric→'replace' THRESHOLD (level < 10 → 'replace') is NOT expressible
+*  with the current transform kinds — leave `status` null (valid) until the
+*  expression transform lands. */
+/** Generic Customize target for one consumable item (D936). Native rows stay read-only. */
+var consumablesCustomize = {
+	version: 1,
+	targets: [{
+		id: "items",
+		cardinality: "keyedArray",
+		vocabulary: { cap: "consumables" },
+		deviceTypes: Object.values(DeviceType),
+		apply: "add",
+		path: "items",
+		keyField: "key",
+		labelField: "label",
+		itemSchema: ConsumableItemSchema,
+		nativeItems: "read-only",
+		sourceReport: { status: "assignment-status" },
+		fields: [
+			{
+				path: "level",
+				sources: [{
+					kind: "numeric",
+					transforms: [{ kind: "identity" }, {
+						kind: "linear",
+						defaultScale: 1,
+						defaultOffset: 0,
+						clampMin: 0,
+						clampMax: 100
+					}]
+				}]
+			},
+			{
+				path: "remaining.value",
+				sources: [{
+					kind: "numeric",
+					transforms: [{ kind: "identity" }]
+				}],
+				literals: [{
+					path: "remaining.unit",
+					values: [...ConsumableRemainingUnitSchema.options]
+				}]
+			},
+			{
+				path: "status",
+				sources: [{
+					kind: "enum",
+					transforms: [{
+						kind: "enum-map",
+						outputValues: [...ConsumableStatusSchema.options],
+						unmapped: null
+					}]
+				}]
+			}
+		],
+		traits: [{
+			path: "kind",
+			values: [...ConsumableKindSchema.options],
+			defaultValue: "wear"
+		}, {
+			path: "form",
+			values: [...ConsumableFormSchema.options],
+			defaultValue: "part"
+		}],
+		companions: [{
+			kind: "clock",
+			path: "lastChangedAt",
+			when: "add"
+		}, {
+			kind: "clock",
+			path: "lastFetchedAt",
+			when: "add"
+		}],
+		advancedExpression: true
+	}]
+};
 var consumablesCapability = {
 	name: "consumables",
 	scope: "device",
@@ -61350,10 +61518,7 @@ reset: method(z.object({
 	status: {
 		schema: ConsumablesStatusSchema,
 		kind: "push",
-		empty: {
-			items: [],
-			lastChangedAt: 0
-		},
+		empty: EMPTY_STATUS,
 		itemArray: {
 			path: "items",
 			keyField: "key",
@@ -61389,6 +61554,7 @@ reset: method(z.object({
 	* brush's remaining life and a dishwasher's salt are each recorded the moment
 	* their provider reports them; an item that appears later gets its series.
 	*/
+	customize: consumablesCustomize,
 	history: {
 		fields: {},
 		items: {
@@ -62177,6 +62343,36 @@ var dishwasherCapability = {
 		powerOn: { kind: "boolean" }
 	} }
 };
+/** Pulse override: a rising edge advances `lastPressedAt` and the press count. */
+var doorbellCustomize = {
+	version: 1,
+	targets: [{
+		id: "pressed",
+		cardinality: "event",
+		shape: "pulse",
+		vocabulary: {
+			cap: "doorbell",
+			eventName: "onPressed"
+		},
+		deviceTypes: [DeviceType.Camera],
+		apply: "add",
+		applyAuthority: { kind: "composition-claim" },
+		eventName: "onPressed",
+		edges: ["rising"],
+		timestampPath: "lastPressedAt",
+		counterPath: "pressCountSinceStart",
+		highWater: "composer-advance",
+		combine: "any",
+		debounce: {
+			kind: "rising-edge",
+			defaultDebounceMs: 2e3,
+			changedAtRequired: true
+		},
+		sources: [{ kind: "binary" }, { kind: "switch" }],
+		sourceReport: { status: "assignment-status" },
+		advancedExpression: true
+	}]
+};
 var DoorbellStatusSchema = z.object({
 	/** Ms epoch of the last press. null = never observed since this provider started. */
 	lastPressedAt: z.number().nullable(),
@@ -62243,7 +62439,8 @@ onPressed: {
 	/**
 	* History (D850): none — `pressCountSinceStart` resets with the addon, so it is not a monotonic meter; presses live in the events ledger.
 	*/
-	history: "none"
+	history: "none",
+	customize: doorbellCustomize
 };
 /**
 * Enum-state sensor — a string value picked from a finite option set.
@@ -64949,6 +65146,38 @@ authKey: z.string().optional() }), z.object({
 		}), { kind: "mutation" })
 	}
 };
+/** Span override: start on a rising edge, end on a fall or this timeout. */
+var motionCustomize = {
+	version: 1,
+	targets: [{
+		id: "detected",
+		cardinality: "event",
+		shape: "span",
+		vocabulary: {
+			cap: "motion",
+			eventName: "onMotionChanged"
+		},
+		deviceTypes: [DeviceType.Camera],
+		apply: "replace",
+		applyAuthority: {
+			kind: "camera-sensors",
+			timeoutField: "motionCooldownMs"
+		},
+		eventName: "onMotionChanged",
+		start: "rising-edge",
+		end: "falling-edge-or-timeout",
+		timeoutMs: 3e4,
+		combine: "any",
+		sourceModes: [
+			"in-addition",
+			"confirm",
+			"replace"
+		],
+		sources: [{ kind: "binary" }, { kind: "switch" }],
+		sourceReport: { status: "assignment-status" },
+		advancedExpression: false
+	}]
+};
 /**
 * Hardware / firmware motion sensor cap — binary detected state plus
 * a timestamp of the last observation. Distinct from
@@ -65113,7 +65342,8 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
 	history: { fields: { detected: {
 		kind: "boolean",
 		excludeDeviceTypes: [DeviceType.Camera]
-	} } }
+	} } },
+	customize: motionCustomize
 };
 /**
 * Motion-trigger toggle for accessory devices.
@@ -68202,6 +68432,8 @@ var ptzAutotrackCapability = {
 	*/
 	history: "none"
 };
+var RUNNING_POWER_START_DELAY_MS = 3e4;
+var RUNNING_POWER_STOP_DELAY_MS = 18e4;
 var RunningStateSourceSchema = z.enum(["native", "assigned"]);
 var RunningStateStatusSchema = z.object({
 	/** null = unknown — never coerced to false (D393). */
@@ -68210,19 +68442,100 @@ var RunningStateStatusSchema = z.object({
 	since: z.number().nullable(),
 	source: RunningStateSourceSchema,
 	phase: z.string().nullable(),
-	lastFetchedAt: z.number()
+	/** null until a reading has been published (D393). */
+	lastFetchedAt: z.number().nullable()
 });
 var RunningFlipEventDataSchema = z.object({
 	deviceId: z.number(),
 	since: z.number().nullable(),
 	phase: z.string().nullable()
 });
+var RUNNING_DEVICE_TYPES = Object.values(DeviceType);
+/** Generic Customize target for the running boolean (D936). */
+var runningCustomize = {
+	version: 1,
+	targets: [{
+		id: "running",
+		cardinality: "scalar",
+		vocabulary: {
+			cap: "running-state",
+			stateField: "running"
+		},
+		deviceTypes: [
+			DeviceType.Dishwasher,
+			DeviceType.Vacuum,
+			DeviceType.LawnMower,
+			DeviceType.MediaPlayer,
+			DeviceType.WaterHeater,
+			DeviceType.Humidifier,
+			DeviceType.Fan,
+			DeviceType.Climate,
+			DeviceType.Thermostat,
+			DeviceType.PetFeeder
+		],
+		apply: "add-or-replace",
+		path: "running",
+		sources: [
+			{
+				kind: "switch",
+				transforms: [{ kind: "identity" }]
+			},
+			{
+				kind: "binary",
+				transforms: [{ kind: "identity" }, { kind: "invert" }]
+			},
+			{
+				kind: "numeric",
+				requiredUnit: "W",
+				transforms: [{
+					kind: "threshold",
+					comparison: "gte",
+					defaultThreshold: 5,
+					defaultStartDwellMs: RUNNING_POWER_START_DELAY_MS,
+					defaultStopDwellMs: RUNNING_POWER_STOP_DELAY_MS,
+					thresholdUnit: "W"
+				}]
+			}
+		],
+		companions: [
+			{
+				kind: "constant",
+				path: "source",
+				value: "assigned",
+				when: "always"
+			},
+			{
+				kind: "constant",
+				path: "phase",
+				value: null,
+				when: "always"
+			},
+			{
+				kind: "clock",
+				path: "lastFetchedAt",
+				when: "always"
+			},
+			{
+				kind: "transition-time",
+				path: "since",
+				sourceChangedAt: "prefer"
+			}
+		],
+		sourceReport: {
+			status: "assignment-status",
+			runtimeField: "source",
+			nativeValue: "native",
+			assignedValue: "assigned"
+		},
+		advancedExpression: true
+	}]
+};
 var runningStateCapability = {
 	name: "running-state",
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: Object.values(DeviceType),
+	deviceTypes: RUNNING_DEVICE_TYPES,
 	methods: {},
 	events: {
 		onStarted: { data: RunningFlipEventDataSchema },
@@ -68235,7 +68548,8 @@ var runningStateCapability = {
 	runtimeState: RunningStateStatusSchema,
 	durability: "restored",
 	history: { fields: { running: { kind: "boolean" } } },
-	volatileStateFields: ["lastFetchedAt"]
+	volatileStateFields: ["lastFetchedAt"],
+	customize: runningCustomize
 };
 /**
 * reboot — device-scoped capability for "soft" device reboots (firmware
@@ -92966,6 +93280,103 @@ var HISTORY_ITEM_CATALOG = { "consumables": {
 		}
 	}
 } };
+DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat, DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher, DeviceType.Camera, DeviceType.Camera, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder;
+/**
+* A saved Customize assignment (D936). The schema is the type: callers use
+* `z.infer`, they do not restate the shape.
+*/
+var OverrideSourceSchema = z.object({
+	addonId: z.string().min(1),
+	stableId: z.string().min(1),
+	cap: z.string().min(1),
+	fieldPath: z.string().min(1)
+});
+var IdentityTransformDraftSchema = z.object({ kind: z.literal("identity") });
+var InvertTransformDraftSchema = z.object({ kind: z.literal("invert") });
+var ThresholdTransformDraftSchema = z.object({
+	kind: z.literal("threshold"),
+	comparison: z.enum(["gte", "lte"]),
+	threshold: z.number(),
+	startDwellMs: z.number().nonnegative(),
+	stopDwellMs: z.number().nonnegative()
+});
+var LinearTransformDraftSchema = z.object({
+	kind: z.literal("linear"),
+	scale: z.number(),
+	offset: z.number(),
+	clampMin: z.number().optional(),
+	clampMax: z.number().optional()
+});
+var EnumMapTransformDraftSchema = z.object({
+	kind: z.literal("enum-map"),
+	mapping: z.record(z.string(), z.string().nullable())
+});
+var NumberBridgeTransformDraftSchema = z.object({ kind: z.literal("number") });
+var CustomizeTransformDraftSchema = z.discriminatedUnion("kind", [
+	IdentityTransformDraftSchema,
+	InvertTransformDraftSchema,
+	ThresholdTransformDraftSchema,
+	LinearTransformDraftSchema,
+	EnumMapTransformDraftSchema,
+	NumberBridgeTransformDraftSchema
+]);
+var ScalarOverrideDraftSchema = z.object({
+	kind: z.literal("scalar"),
+	cap: z.string().min(1),
+	targetId: z.string().min(1),
+	source: OverrideSourceSchema,
+	transform: CustomizeTransformDraftSchema
+});
+var KeyedArrayOverrideDraftSchema = z.object({
+	kind: z.literal("keyedArray"),
+	cap: z.string().min(1),
+	targetId: z.string().min(1),
+	key: z.string().min(1),
+	label: z.string().min(1),
+	fieldPath: z.string().min(1),
+	source: OverrideSourceSchema,
+	transform: CustomizeTransformDraftSchema
+});
+var PulseOverrideDraftSchema = z.object({
+	kind: z.literal("pulse"),
+	cap: z.string().min(1),
+	targetId: z.string().min(1),
+	enabled: z.boolean(),
+	debounceMs: z.number().nonnegative(),
+	sources: z.array(OverrideSourceSchema).min(1)
+});
+var SpanSourceDraftSchema = OverrideSourceSchema.extend({ mode: z.enum([
+	"in-addition",
+	"confirm",
+	"replace"
+]).optional() });
+var SpanOverrideDraftSchema = z.object({
+	kind: z.literal("span"),
+	cap: z.string().min(1),
+	targetId: z.string().min(1),
+	timeoutMs: z.number().nonnegative(),
+	cooldownMs: z.number().nonnegative().optional(),
+	sources: z.array(SpanSourceDraftSchema)
+});
+z.discriminatedUnion("kind", [
+	ScalarOverrideDraftSchema,
+	KeyedArrayOverrideDraftSchema,
+	PulseOverrideDraftSchema,
+	SpanOverrideDraftSchema
+]);
+z.object({
+	targetId: z.string().min(1),
+	configured: z.boolean(),
+	source: z.enum(["native", "assigned"]),
+	state: z.enum([
+		"active",
+		"stale",
+		"released",
+		"unavailable"
+	]),
+	reason: z.string().nullable()
+});
+String.raw`rose\(active(\d+), changed(\d+), (\d+(?:\.\d+)?)\)`;
 var G711_SCALE_CORRECTION_DB = {
 	PCMU: 20 * Math.log10(4),
 	PCMA: 20 * Math.log10(8)