@camstack/addon-provider-bosch 0.1.45 → 0.1.47

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.47] - 2026-11-09
+
+### Changed
+
+- A HomeCom gateway with a heat pump is adopted as one heat pump, with a climate child per circuit and a Hot water child; a circuit already adopted on its own stays there
+
+## [0.1.46] - 2026-11-09
+
+### Changed
+
+- A HomeCom heat pump whose gateway reports only its system modes is now offered for adoption.
+
 ## [0.1.45] - 2026-11-09
 
 ### Changed

package/dist/{account-integration-offline-DAEciV_Q.mjs → account-integration-offline-Bie4aS5e.mjs}

@@ -1,4 +1,4 @@
-import { X as errMsg } from "./bosch-instances-DXID-jMD.mjs";
+import { X as errMsg } from "./bosch-instances-DAqkAsRO.mjs";
 import { randomBytes } from "node:crypto";
 //#region src/shared/sign-in-redirects.ts
 /** The addresses each vendor sends the browser to after a sign-in; no browser can open them. Kept free of imports so the form schema can name them. */

package/dist/{account-integration-offline-BiXbzZsg.js → account-integration-offline-C6tzFB-H.js}

@@ -1,4 +1,4 @@
-const require_bosch_instances = require("./bosch-instances-DdklwoKS.js");
+const require_bosch_instances = require("./bosch-instances-D0eF-Jjy.js");
 let node_crypto = require("node:crypto");
 //#region src/shared/sign-in-redirects.ts
 /** The addresses each vendor sends the browser to after a sign-in; no browser can open them. Kept free of imports so the form schema can name them. */

package/dist/{bosch-instances-DdklwoKS.js → bosch-instances-D0eF-Jjy.js}

@@ -802,7 +802,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	return EventCategory;
 }({});
 //#endregion
-//#region ../types/dist/device-type-DTTZKB2I.mjs
+//#region ../types/dist/composed-stable-id-DLcPInGv.mjs
 /**
 import { errMsg } from '@camstack/types'
 * Extract a human-readable message from an unknown error value.
@@ -1204,6 +1204,12 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
 	DeviceRole["IrTransmitter"] = "ir-transmitter";
 	return DeviceRole;
 }({});
+/**
+* A composed device's stableId is this prefix plus the block id. Its own module,
+* free of zod, so the addon runner can read it through `@camstack/types/addon`
+* without loading the schema barrel (D28).
+*/
+var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
 //#endregion
 //#region ../../node_modules/zod/v4/core/core.js
 var _a$1;
@@ -6016,7 +6022,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-DnVqHJc4.mjs
+//#region ../types/dist/sleep-B36hHDDz.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -17406,7 +17412,7 @@ Object.freeze({
 	}
 });
 //#endregion
-//#region ../types/dist/composition-C6TZGqUb.mjs
+//#region ../types/dist/composition-BFJq1Y88.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -18361,8 +18367,6 @@ var HelperSpecSchema = discriminatedUnion("kind", [
 		source: HelperMemberSchema
 	})
 ]);
-/** A composed device's stableId is this prefix plus the block id. */
-var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
 /** Longest snippet a `code` source may carry (slice 4). */
 var MAX_COMPOSITION_CODE_LENGTH = 2e4;
 /** One field of one capability of one source device. */
@@ -44553,21 +44557,44 @@ var AutomationCapStepBaseSchema = object({
 	*/
 	argUnits: record(string(), string().min(1)).optional()
 });
-var AutomationCapStepSchema = AutomationCapStepBaseSchema.refine((step) => step.target !== void 0 || step.deviceId !== void 0, {
+/**
+* The steps an internal Action may contain: cap and wait, and nothing that can
+* call back into an Action — so an Action can never reach itself (no cycles).
+* This is the LEAF shape: no condition of its own.
+*/
+var LeafActionStepSchema = discriminatedUnion("kind", [AutomationWaitStepSchema, AutomationCapStepBaseSchema.refine((step) => step.target !== void 0 || step.deviceId !== void 0, {
 	message: "a cap step needs a target",
 	path: ["target"]
 }).refine((step) => step.target?.kind !== "domain" || step.actionId !== void 0, {
 	message: "a domain target needs the vocabulary action it applies to (actionId)",
 	path: ["actionId"]
-});
+})]);
 /**
-* The steps an internal Action may contain: cap and wait, and nothing that can
-* call back into an Action — so an Action can never reach itself (no cycles).
+* The optional guard of a step (#472): `if` is the ONE `when` tree (D980), read
+* on the state mirror when the step is reached; `else` runs when it is false.
+* An `else` holds leaf steps only — the nesting is bounded at ONE level, so a
+* branch can never grow a tree the trace has to draw.
 */
-var ActionStepSchema = discriminatedUnion("kind", [AutomationWaitStepSchema, AutomationCapStepSchema]);
+var stepGuardShape = {
+	if: AutomationWhenSchema.optional(),
+	else: array(LeafActionStepSchema).max(10).optional()
+};
+var elseNeedsIf = {
+	message: "an else list needs the condition it is the other side of (if)",
+	path: ["else"]
+};
+var GuardedWaitStepSchema = AutomationWaitStepSchema.extend(stepGuardShape).refine((step) => step.else === void 0 || step.if !== void 0, elseNeedsIf);
+var GuardedCapStepSchema = AutomationCapStepBaseSchema.extend(stepGuardShape).refine((step) => step.target !== void 0 || step.deviceId !== void 0, {
+	message: "a cap step needs a target",
+	path: ["target"]
+}).refine((step) => step.target?.kind !== "domain" || step.actionId !== void 0, {
+	message: "a domain target needs the vocabulary action it applies to (actionId)",
+	path: ["actionId"]
+}).refine((step) => step.else === void 0 || step.if !== void 0, elseNeedsIf);
+var ActionStepSchema = discriminatedUnion("kind", [GuardedWaitStepSchema, GuardedCapStepSchema]);
 var AutomationActionSchema = discriminatedUnion("kind", [
-	AutomationWaitStepSchema,
-	AutomationCapStepSchema,
+	GuardedWaitStepSchema,
+	GuardedCapStepSchema,
 	object({
 		kind: literal("action"),
 		/** An entry of the `actions` surface (`internal:<uuid>` or `<addonId>:<localId>`). */
@@ -44947,7 +44974,7 @@ var StepDeviceTraceSchema = object({
 	outcome: _enum(["ok", "error"]),
 	message: string().optional()
 });
-var AutomationStepTraceSchema = object({
+var StepTraceBaseSchema = object({
 	/** `actions.<i>` */
 	path: string().min(1),
 	kind: string().min(1),
@@ -44966,15 +44993,35 @@ var AutomationStepTraceSchema = object({
 	* is shown as {@link REDACTED_ARG}. Absent on traces written before it existed.
 	*/
 	args: record(string(), TraceValueSchema).optional(),
-	/** `empty`: the target resolved to no device, so nothing was done — never silently `ok`. */
+	/**
+	* The device values a templated arg printed as `—`, one `ref: reason` each
+	* (D1021): why a sentence says "—" where a number was expected. Bounded.
+	*/
+	templates: array(string()).max(20).optional(),
+	/**
+	* What the step's own `if` read when the step was reached (#472): `true` the
+	* step ran, `false` its `else` ran (or nothing did), `unknown` a state leaf
+	* could not be read, so NEITHER side ran. Absent on an unguarded step.
+	*/
+	condition: _enum([
+		"true",
+		"false",
+		"unknown"
+	]).optional(),
+	/** Why the condition read what it read, in the evaluator's own words. */
+	conditionReason: string().optional(),
+	/** `empty`: the target resolved to no device, so nothing was done — never silently `ok`. `skipped`: its `if` was false (or unknown) and nothing ran in its place. */
 	outcome: _enum([
 		"ok",
 		"error",
 		"not-run",
-		"empty"
+		"empty",
+		"skipped"
 	]),
 	message: string().optional()
 });
+/** A step trace; the `else` steps that ran are one level of the same shape (the nesting is bounded at one). */
+var AutomationStepTraceSchema = StepTraceBaseSchema.extend({ else: array(StepTraceBaseSchema).optional() });
 var AutomationRunTraceSchema = object({
 	runId: string().min(1),
 	startedAt: number$1(),
@@ -45150,6 +45197,7 @@ _enum([
 	"invalid-variables",
 	"invalid-steps",
 	"not-linked",
+	"template-scope",
 	"busy"
 ]);
 object({
@@ -52732,6 +52780,43 @@ method(InstancePinSchema, DeviceExportStatusSchema), method(_void(), array(Expor
 	auth: "admin"
 });
 var DeviceAliasSchema = string().max(64).regex(/^[a-z][a-z0-9_]*$/);
+var DeviceTemplateSchema = string().min(1).max(4096);
+var DeviceTemplateRefusalSchema = object({
+	reason: _enum([
+		"too-long",
+		"syntax",
+		"forbidden-syntax",
+		"forbidden-member",
+		"unknown-filter",
+		"ambiguous-field",
+		"busy",
+		"budget-exceeded",
+		"timeout",
+		"output-too-large",
+		"render-failed",
+		"out-of-scope",
+		"unavailable"
+	]),
+	message: string()
+});
+var DeviceTemplateTraceEntrySchema = object({
+	ref: string(),
+	reason: _enum([
+		"unknown-alias",
+		"unknown-field",
+		"no-field",
+		"unavailable"
+	])
+});
+var DeviceTemplateRenderSchema = discriminatedUnion("ok", [object({
+	ok: literal(true),
+	text: string(),
+	trace: array(DeviceTemplateTraceEntrySchema)
+}), object({
+	ok: literal(false),
+	refusal: DeviceTemplateRefusalSchema,
+	trace: array(DeviceTemplateTraceEntrySchema)
+})]);
 /**
 * A SITE ZONE — a named part of the property that several locations belong to.
 *
@@ -53539,7 +53624,13 @@ method(object({
 	auth: "admin"
 }), method(object({ deviceId: number$1() }), record(string(), unknown()), { auth: "admin" }), method(object({ deviceId: number$1() }), record(string(), unknown()), { auth: "admin" }), method(object({ deviceId: number$1() }), DeviceMetaSchema.nullable()), method(object({
 	deviceId: number$1(),
-	name: string()
+	name: string(),
+	/**
+	* Absent or true: an operator rename, which stamps `userNamed`.
+	* False: the system copying a block name onto the device. That write
+	* must not look like the operator's, or the next reconcile freezes it.
+	*/
+	stampUserNamed: boolean().optional()
 }), _void(), {
 	kind: "mutation",
 	auth: "admin"
@@ -53563,6 +53654,22 @@ method(object({
 	kind: "mutation",
 	auth: "admin"
 }), method(object({
+	templates: array(DeviceTemplateSchema).max(64),
+	allowedDeviceIds: array(number$1().int()).optional()
+}), object({ results: array(DeviceTemplateRenderSchema) }), { auth: "admin" }), method(object({
+	templates: array(string()).max(64),
+	allowedDeviceIds: array(number$1().int()).optional()
+}), object({ results: array(discriminatedUnion("ok", [object({
+	ok: literal(true),
+	aliases: array(object({
+		alias: string(),
+		deviceId: number$1().int().nullable(),
+		allowed: boolean()
+	}))
+}), object({
+	ok: literal(false),
+	refusal: DeviceTemplateRefusalSchema
+})])) }), { auth: "admin" }), method(object({
 	deviceId: number$1(),
 	location: string().nullable()
 }), _void(), {
@@ -57531,7 +57638,13 @@ var HeroTimedRunSlotSchema = object({
 	activeUntil: number$1().nullable(),
 	quickRun: TimedRunQuickRunSchema,
 	run: HeroActionSchema,
-	cancel: HeroActionSchema
+	cancel: HeroActionSchema,
+	/**
+	* Whole units left (the limit's unit, ceil). `null` while nothing is armed.
+	* A number, not words: the row formats it, and a text here would not fit the
+	* hero-layout declaration.
+	*/
+	remaining: number$1().nullable()
 });
 var HeroPowerSupplySlotSchema = object({
 	/** The plug's state; `null` = unknown, never off. */
@@ -57650,18 +57763,31 @@ var HeroModelSchema = object({
 *   4. a trailing fact (power, else battery, else consumables).
 *
 * Selection rules, all taken from the model:
-*   - ONE control is ever shown: the device's own power; else the FIRST control of
+*   - the primary control is the device's own power; else the FIRST control of
 *     the FIRST row that has any (a later row's control is never promoted). When
 *     the model lists that part in `gated`, the row has no inline control: the
 *     projection never falls through to another control the caller could use.
+*   - a timed run, when the model carries the slot, sits beside that primary:
+*     Run while idle, Stop while armed. Gating the slot hides the control.
 *   - the status line is the head (what plays, else the state) plus at most
-*     {@link ROW_STATUS_FACTS_MAX} facts, the trailing fact excluded;
+*     {@link ROW_STATUS_FACTS_MAX} facts, the trailing fact excluded, then the
+*     time left on an armed timed run;
 *   - the trailing fact is the first of power, battery, consumables.
 *
 * `projectDeviceRow` is pure and computes nothing: it selects from a
 * {@link HeroModel}. A row that needed a value the hero lacks would mean the
 * model is missing it, so the fix goes in the model.
 */
+/**
+* The row's timed-run control. `id` is `timed-run.run` while idle and
+* `timed-run.cancel` while armed; `duration` and `unit` are the one-tap run
+* a Run press starts.
+*/
+var HeroRowTimedRunSchema = object({
+	id: _enum(["timed-run.run", "timed-run.cancel"]),
+	duration: number$1(),
+	unit: _enum(["min", "s"])
+});
 var HeroRowModelSchema = object({
 	deviceId: number$1().int(),
 	name: string(),
@@ -57674,6 +57800,11 @@ var HeroRowModelSchema = object({
 	statusLine: array(HeroTextSchema),
 	/** `null` = the type has no inline control, or the caller may not act on it. */
 	primary: HeroControlSchema.nullable(),
+	/**
+	* Beside `primary` when the device offers a timed run: Run while idle, Stop
+	* while armed. `null` when there is no slot, or the caller may not act.
+	*/
+	timedRun: HeroRowTimedRunSchema.nullable(),
 	trailing: HeroFactSchema.nullable()
 });
 /**
@@ -84214,6 +84345,7 @@ var BaseDeviceProvider = class extends BaseAddon {
 		return toDeviceSummary(device, this.addonId);
 	}
 };
+DeviceType.HeatPump;
 DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.HeatPump, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Heater, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
 new Set(Object.values(DeviceType));
 /** Parses the raw slice with the cap's own schema; `undefined` when it does not parse. */
@@ -85960,7 +86092,7 @@ var CLIMATE_FAMILY_CONTRIBUTIONS = {
 /**
 * The heat pump's contribution to a hero (D1026): the compressor scene, every
 * circuit as a row with its own label and icon, the powers as pills (the
-* instantaneous COP only when both powers are known) and a "System" group with
+* instantaneous COP is "—" when it cannot be computed) and a "System" group with
 * one selector per mode. Values and their limits come from the slice, which the
 * gateway filled: a selector with no allowed value is not drawn, a missing
 * reading is never a 0 (D393).
@@ -86032,9 +86164,22 @@ function circuitRow(circuit) {
 	};
 }
 var kilowatts = (watts) => `${Number((watts / 1e3).toFixed(2))} kW`;
+/** A COP that cannot be computed is still the pill: "—", never an absent reading (D393). */
+function copPill(cop) {
+	if (cop === null) return {
+		icon: "gauge",
+		text: t("Instantaneous COP —", "COP istantaneo —"),
+		tone: "muted"
+	};
+	const text = String(Number(cop.toFixed(1)));
+	return {
+		icon: "gauge",
+		text: t(`Instantaneous COP ${text}`, `COP istantaneo ${text}`),
+		tone: "success"
+	};
+}
 function powerPills(status) {
 	const { thermalW, electricalW } = status.power;
-	const cop = heatPumpInstantCop(status.power);
 	const pills = [];
 	if (thermalW !== null) pills.push({
 		icon: "flame",
@@ -86046,14 +86191,7 @@ function powerPills(status) {
 		text: t(`Electrical ${kilowatts(electricalW)}`, `Elettrica ${kilowatts(electricalW)}`),
 		tone: "muted"
 	});
-	if (cop !== null) {
-		const text = String(Number(cop.toFixed(1)));
-		pills.push({
-			icon: "gauge",
-			text: t(`Instantaneous COP ${text}`, `COP istantaneo ${text}`),
-			tone: "success"
-		});
-	}
+	pills.push(copPill(heatPumpInstantCop(status.power)));
 	return pills;
 }
 /** The independent system modes, in the order the card draws them. */
@@ -89025,6 +89163,13 @@ Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"deviceManager.checkDeviceTemplates": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "admin"
+	},
 	"deviceManager.cleanupDeletedDevicesData": {
 		capName: "device-manager",
 		capScope: "system",
@@ -89424,6 +89569,13 @@ Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"deviceManager.renderDeviceTemplates": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "admin"
+	},
 	"deviceManager.reportDiscoveryObservations": {
 		capName: "device-manager",
 		capScope: "system",
@@ -97340,7 +97492,6 @@ function offered(received) {
 	};
 }
 offered(HA_AS), withheld(HOMEKIT_REASON), withheld(ALEXA_REASON), withheld(GOOGLE_REASON), withheld(MATTER_REASON);
-string().min(1).max(4096);
 Object.freeze({
 	"accessories.getStatus": [{
 		name: "deviceId",