@camstack/addon-post-analysis 1.2.660 → 1.2.662

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.662] - 2026-11-01
+
+### Changed
+
+- An appliance that finishes its cycle now notifies by default as "<Device> ha terminato dopo N minuti", and the text can carry the energy used
+- The appliance finish notification reads the recorded run, so duration and energy survive a restart.
+
+## [1.2.661] - 2026-11-01
+
+### Changed
+
+- A capture request now expires exactly at its deadline instead of one millisecond after, so an abandoned confirmation crop no longer holds the head of the lane and sheds key frames.
+- Notification templates: {{camera}} is now {{device}}. Your saved rules, timelapse captions and text overrides are rewritten once at the first start; {{camera}} keeps rendering in a template an older app still writes
+
 ## [1.2.660] - 2026-11-01
 
 ### Changed

package/dist/{clip-model-registry-DAKPBZfa.js → clip-model-registry-C3N1NpST.js}

@@ -30,7 +30,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 let node_crypto = require("node:crypto");
-//#region ../types/dist/event-category-CaURIwQA.mjs
+//#region ../types/dist/event-category-BmPm98n0.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -514,6 +514,10 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["RunningStarted"] = "running.started";
 	/** Mirrors `runningStateCapability.events.onFinished`. */
 	EventCategory["RunningFinished"] = "running.finished";
+	/** Mirrors `deviceRunsCapability.events.onRunOpened` - a durable run record opened. */
+	EventCategory["DeviceRunOpened"] = "device-run.opened";
+	/** Mirrors `deviceRunsCapability.events.onRunClosed` - a durable run record closed. */
+	EventCategory["DeviceRunClosed"] = "device-run.closed";
 	/**
 	* Cap event fired by every device that registers the `event-emitter`
 	* capability. Mirrors `eventEmitterCapability.events.onEvent`. Carries
@@ -6052,7 +6056,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-CSYuxssh.mjs
+//#region ../types/dist/sleep-BKzhQTSm.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -6568,6 +6572,53 @@ function emitReadiness(bus, params) {
 		ts
 	}));
 }
+/** Why a catalogue entry is not a runnable body of its declared kind. */
+var AddonMigrationDefinitionError = class extends Error {
+	id;
+	constructor(id, message) {
+		super(`${id}: ${message}`);
+		this.id = id;
+		this.name = "AddonMigrationDefinitionError";
+	}
+};
+/**
+* Bind a catalogue to the addon's ports. Throws {@link AddonMigrationDefinitionError} when
+* an entry's `bodyKind` does not match the body it carries, or is `sql` (a hub-only
+* body). A throwing body never escapes `execute`: it is reported as a failed result.
+*/
+function defineAddonMigrations(catalogue, ports) {
+	return catalogue.map((entry) => {
+		const { meta } = entry;
+		if ("plan" in entry) {
+			if (meta.bodyKind !== "plan") throw new AddonMigrationDefinitionError(meta.id, `carries a plan body but declares "${meta.bodyKind}"`);
+			return {
+				meta,
+				execute: () => guarded(async () => ({
+					kind: "plan",
+					plan: await entry.plan(ports)
+				}))
+			};
+		}
+		if (meta.bodyKind !== "procedure") throw new AddonMigrationDefinitionError(meta.id, `carries a procedure body but declares "${meta.bodyKind}"`);
+		return {
+			meta,
+			execute: () => guarded(async () => ({
+				kind: "procedure",
+				result: await entry.procedure(ports)
+			}))
+		};
+	});
+}
+async function guarded(work) {
+	try {
+		return await work();
+	} catch (err) {
+		return {
+			kind: "failed",
+			error: errMsg(err)
+		};
+	}
+}
 var NOT_RUN = {
 	declared: false,
 	snapshot: null,
@@ -9771,6 +9822,7 @@ var CAP_NAMES = Object.freeze([
 	"device-ops",
 	"device-provider",
 	"device-removal-hook",
+	"device-runs",
 	"device-state",
 	"device-status",
 	"dishwasher",
@@ -11717,7 +11769,7 @@ Object.freeze({
 * can answer "may a rule actuate this?" without importing the schema barrel
 * (~144MB RSS per runner, D28).
 *
-* Coverage: 98 device-scoped capabilities.
+* Coverage: 99 device-scoped capabilities.
 */
 var DEVICE_SCOPED_CAPS = new Set([
 	"accessories",
@@ -11749,6 +11801,7 @@ var DEVICE_SCOPED_CAPS = new Set([
 	"device-discovery",
 	"device-extension",
 	"device-ops",
+	"device-runs",
 	"device-status",
 	"dishwasher",
 	"doorbell",
@@ -14489,7 +14542,13 @@ var MigrationLedgerEntrySchema = object({
 	/** Why it is `blocked` or `held` (`dependency-failed`, `snapshot-refused`, …). */
 	reason: string().nullable(),
 	nodeId: string().nullable(),
-	bootId: string().nullable()
+	bootId: string().nullable(),
+	/**
+	* The catalogued meta of this id (description, body kind, store, `dependsOn`…),
+	* joined by the engine from the catalogues it knows this boot. Absent when no
+	* catalogue lists the id (a newer database).
+	*/
+	meta: MigrationMetaSchema.optional()
 });
 /** A catalogued migration that is not applied, with where it stands. */
 var MigrationPendingEntrySchema = object({
@@ -20929,6 +20988,14 @@ var APPLIANCE_CAP_VOCABULARY = {
 			}
 		} }
 	},
+	"device-runs": {
+		scope: "device",
+		noun: t("Runs", "Esecuzioni"),
+		events: {
+			onRunOpened: { notOperatorFacing: "the durable record of a run that the running-state start flip already announces" },
+			onRunClosed: { notOperatorFacing: "the durable record of a run that the running-state finish flip already announces" }
+		}
+	},
 	update: {
 		scope: "device",
 		noun: t("Firmware update", "Aggiornamento firmware"),
@@ -49299,6 +49366,101 @@ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly())
 	kind: "mutation",
 	auth: "admin"
 });
+/**
+* device-runs - the durable record of ONE run of a device: a washing cycle, a
+* dishwasher cycle, later a mow or a clean (D992).
+*
+* A run is a DOCUMENT (opened at one instant, closed at another, carrying what
+* was measured over it), never a sample - device-history keeps the numbers over
+* time and its `device-runs` provider keeps these documents beside them, because
+* the energy of a run is a question about device-history's own series. The
+* record is written from the `running-state` flip on `DeviceStateChanged`; it
+* survives a restart (the open row is on disk) and a missed flip (boot compares
+* the open rows against the live snapshots).
+*
+* Every measurement is `number | null` and `null` means "could not be
+* measured", never `0` (D393). A run closed by the boot reconcile because the
+* device stopped while nobody was watching has `outcome: 'unknown'`.
+*/
+var DeviceRunKindSchema = _enum([
+	"appliance",
+	"mower",
+	"vacuum"
+]);
+var DeviceRunStateSchema = _enum(["open", "closed"]);
+var DeviceRunOutcomeSchema = _enum([
+	"completed",
+	"aborted",
+	"error",
+	"unknown"
+]);
+/** What opened or closed the run. `reconcile` is the boot comparison against live state. */
+var DeviceRunSourceSchema = _enum([
+	"running-state",
+	"activity",
+	"reconcile"
+]);
+/** How the energy of a run was obtained; `null` when it could not be. */
+var DeviceRunEnergyMethodSchema = _enum(["counter-delta", "history-integral"]);
+var DeviceRunPhaseSchema = object({
+	phase: string(),
+	at: number()
+});
+/** The kind-specific block; a later phase adds a branch, nothing else changes. */
+var DeviceRunDetailSchema = discriminatedUnion("kind", [object({
+	kind: literal("appliance"),
+	/** kWh used over the run. */
+	energyKwh: number().nullable().meta(readingMeta("energy")),
+	energyMethod: DeviceRunEnergyMethodSchema.nullable(),
+	/** Highest power seen while the run was open. */
+	peakW: number().nullable().meta(readingMeta("power")),
+	/** Time-weighted mean power while the run was open. */
+	avgW: number().nullable().meta(readingMeta("power")),
+	/** The program the appliance said it ran when the run opened. */
+	program: string().nullable(),
+	remainingAtStartSec: number().nullable().meta(readingMeta("duration")),
+	/** The last phase the device reported before the run closed. */
+	finalPhase: string().nullable(),
+	/**
+	* The meter's energy counter when the run opened; `null` when the meter had
+	* not said (or the run was opened late, by the boot reconcile). It lives in
+	* the row so a run that outlives a restart still ends with `end - start`.
+	*/
+	energyStartKwh: number().nullable().meta(readingMeta("energy")),
+	/** Milliseconds of power readings behind `avgW` - the weight a restart resumes the mean with. */
+	powerObservedMs: number()
+})]);
+var DeviceRunSchema = object({
+	/** `${deviceId}:${startedAt}`. */
+	runId: string(),
+	deviceId: number().int(),
+	kind: DeviceRunKindSchema,
+	state: DeviceRunStateSchema,
+	startedAt: number(),
+	endedAt: number().nullable(),
+	durationMs: number().nullable(),
+	outcome: DeviceRunOutcomeSchema.nullable(),
+	startSource: DeviceRunSourceSchema,
+	endSource: DeviceRunSourceSchema.nullable(),
+	/** Where the device's running bit came from (`running-state.source`); `null` when it did not say. */
+	runningSource: _enum(["native", "assigned"]).nullable(),
+	phases: array(DeviceRunPhaseSchema),
+	detail: DeviceRunDetailSchema
+});
+DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, method(object({
+	deviceId: number().int(),
+	outcome: DeviceRunOutcomeSchema.optional(),
+	atFrom: number().optional(),
+	atTo: number().optional(),
+	limit: number().int().positive().max(200).default(50),
+	cursor: string().optional()
+}), object({
+	runs: array(DeviceRunSchema).readonly(),
+	nextCursor: string().nullable()
+})), method(object({
+	deviceId: number().int(),
+	runId: string()
+}), DeviceRunSchema.nullable()), method(object({ deviceId: number().int() }), DeviceRunSchema.nullable());
 var DeviceCaStatusSchema = discriminatedUnion("state", [
 	object({ state: literal("absent") }),
 	object({
@@ -49434,8 +49596,8 @@ method(object({}), object({
 });
 var KeychainKeySourceSchema = object({
 	kind: _enum([
-		"config-file",
-		"previous-config-file",
+		"mounted-file",
+		"previous-mounted-file",
 		"platform",
 		"default-file"
 	]),
@@ -67944,10 +68106,7 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
 }), InstallPackageResultSchema, {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({ packageName: string() }), InstallPackageResultSchema, {
-	kind: "mutation",
-	auth: "admin"
-}), method(_void(), boolean()), method(_void(), array(unknown()).readonly()), method(object({
+}), method(object({
 	packageName: string().min(1),
 	nodeId: string().optional(),
 	everywhere: boolean().optional()
@@ -80661,7 +80820,7 @@ var ExternalIdentityKeySchema = object({
 	provider: string().min(1),
 	subject: string().min(1)
 });
-method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserInputSchema, UserSummarySchema, {
+method(_void(), array(UserSummarySchema), { auth: "admin" }), method(_void(), object({ defaultPasswordInUse: boolean() }), { auth: "admin" }), method(CreateUserInputSchema, UserSummarySchema, {
 	kind: "mutation",
 	auth: "admin",
 	access: "create"
@@ -83559,13 +83718,6 @@ Object.freeze({
 		access: "view",
 		role: "admin"
 	},
-	"addons.installFromWorkspace": {
-		capName: "addons",
-		capScope: "system",
-		addonId: null,
-		access: "create",
-		role: "admin"
-	},
 	"addons.installPackage": {
 		capName: "addons",
 		capScope: "system",
@@ -83573,13 +83725,6 @@ Object.freeze({
 		access: "create",
 		role: "admin"
 	},
-	"addons.isWorkspaceAvailable": {
-		capName: "addons",
-		capScope: "system",
-		addonId: null,
-		access: "view",
-		role: "admin"
-	},
 	"addons.list": {
 		capName: "addons",
 		capScope: "system",
@@ -83629,13 +83774,6 @@ Object.freeze({
 		access: "view",
 		role: "admin"
 	},
-	"addons.listWorkspacePackages": {
-		capName: "addons",
-		capScope: "system",
-		addonId: null,
-		access: "view",
-		role: "admin"
-	},
 	"addons.onAddonLogs": {
 		capName: "addons",
 		capScope: "system",
@@ -86303,6 +86441,27 @@ Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"deviceRuns.getCurrentRun": {
+		capName: "device-runs",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
+	"deviceRuns.getRun": {
+		capName: "device-runs",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
+	"deviceRuns.listRuns": {
+		capName: "device-runs",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
 	"deviceState.claimFields": {
 		capName: "device-state",
 		capScope: "system",
@@ -93016,6 +93175,13 @@ Object.freeze({
 		access: "view",
 		role: "admin"
 	},
+	"userManagement.getAdminBootstrapStatus": {
+		capName: "user-management",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "admin"
+	},
 	"userManagement.getTotpStatus": {
 		capName: "user-management",
 		capScope: "system",
@@ -94501,6 +94667,21 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"deviceRuns.getCurrentRun": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"deviceRuns.getRun": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"deviceRuns.listRuns": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"deviceState.claimFields": [{
 		name: "deviceId",
 		form: "single",
@@ -98789,8 +98970,9 @@ var STATE_SUMMARY_VARS = [
 ];
 var NC_TEMPLATE_VARS = [
 	{
-		name: "camera",
-		label: "Camera",
+		name: "device",
+		label: "Device",
+		description: "The device the event is about: the camera for a track, the appliance or sensor for a device event.",
 		example: "Front door",
 		group: "subject",
 		families: ["rule", "timelapse"],
@@ -99037,6 +99219,46 @@ var NC_TEMPLATE_VARS = [
 		fields: [...RULE_TEXT],
 		kinds: ["sensor"]
 	},
+	{
+		name: "duration",
+		label: "Cycle duration",
+		description: "How long a finished appliance cycle ran, e.g. \"52 minutes\" or \"1 h 12 min\"; empty when the start is unknown.",
+		example: "52 minuti",
+		group: "sensor",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["sensor"]
+	},
+	{
+		name: "energy",
+		label: "Cycle energy",
+		description: "Energy an appliance used over its finished cycle, e.g. \"0.84 kWh\"; empty without a power meter.",
+		example: "0,84 kWh",
+		group: "sensor",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["sensor"]
+	},
+	{
+		name: "afterDuration",
+		label: "\"after <duration>\" fragment",
+		description: "Leading space included; empty when the cycle duration is unknown.",
+		example: " dopo 52 minuti",
+		group: "sensor",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["sensor"]
+	},
+	{
+		name: "usedEnergy",
+		label: "\"used <energy>\" fragment",
+		description: "Leading space included; empty when the energy is unknown.",
+		example: " e ha consumato 0,84 kWh",
+		group: "sensor",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["sensor"]
+	},
 	{
 		name: "ai",
 		label: "AI sentence",
@@ -99175,6 +99397,16 @@ var NC_TEMPLATE_VARS = [
 		kinds: ["system"],
 		systemEventKinds: ["node-online", "node-offline"]
 	},
+	{
+		name: "graceMin",
+		label: "Update grace (minutes)",
+		example: "10",
+		group: "system",
+		families: ["rule"],
+		fields: [...RULE_TEXT],
+		kinds: ["system"],
+		systemEventKinds: ["node-offline"]
+	},
 	{
 		name: "offlineFor",
 		label: "Offline for",
@@ -99807,7 +100039,7 @@ function templateVarDeliveryApplies(d, ctx) {
 *  descriptor so the whole rule stays in one line of code. */
 var CAPTION_VARS = {
 	previewText: [
-		"camera",
+		"device",
 		"rule",
 		"from",
 		"to"
@@ -100757,7 +100989,7 @@ var TimelapseRuleInputSchema = object({
 * before this field existed still reads "Timelapse Camera front door" and
 * not the literal braces.
 */
-var DEFAULT_TIMELAPSE_PREVIEW_TEXT = "Timelapse {{camera}}";
+var DEFAULT_TIMELAPSE_PREVIEW_TEXT = "Timelapse {{device}}";
 /**
 * Partial patch for an update — any subset of the INPUT fields, with NO
 * defaults (an absent key means "leave unchanged", never "reset to default").
@@ -102991,6 +103223,12 @@ Object.defineProperty(exports, "customAction", {
 		return customAction;
 	}
 });
+Object.defineProperty(exports, "defineAddonMigrations", {
+	enumerable: true,
+	get: function() {
+		return defineAddonMigrations;
+	}
+});
 Object.defineProperty(exports, "defineCustomActions", {
 	enumerable: true,
 	get: function() {