@camstack/addon-provider-gree 0.1.5 → 0.1.7

package/dist/addon.js

@@ -10080,15 +10080,18 @@ var humiditySensorCapability = {
 	runtimeState: HumiditySensorStatusSchema
 };
 /**
-* Image display cap. Models HA `image.*` entities — a single still image
-* exposed by an integration (a snapshot, a chart, a generated picture).
+* Image display cap. Models a single still image exposed by an integration —
+* a snapshot, a chart, a generated picture, or a robot's cleaning-map render.
 *
-* Read-only: there are no setters. The provider resolves the HA
-* `entity_picture` (a relative, signed-token path) into an ABSOLUTE URL
-* the browser loads directly — the token stays in the query string so no
-* auth header is required. The slice carries that URL plus the upstream
-* last-updated timestamp; the image changes when the entity state (a
-* timestamp) changes.
+* Read-only: there are no setters. The provider resolves whatever upstream
+* source it has into an ABSOLUTE URL the browser loads directly:
+*   - HA `image.*` entities → the `entity_picture` signed-token path
+*     (token stays in the query string, so no auth header is needed);
+*   - a Dreame/robot map → the cloud/OSS map-image URL (or an addon
+*     data-plane URL serving the rendered map bytes), exposed as its own
+*     Image child device grouped under the robot's container.
+* The slice carries that URL plus the upstream last-updated timestamp; the
+* image changes when the source's last-updated marker changes.
 */
 var ImageStatusSchema = object({
 	/** Absolute signed URL the browser loads directly. Null when the
@@ -10114,18 +10117,47 @@ var imageCapability = {
 	*/
 	runtimeState: ImageStatusSchema
 };
+/**
+* Robotic lawn-mower cap. Models HA `lawn_mower.*` entities — anything
+* with a mowing lifecycle plus a dock action.
+*
+* Activity follows HA's canonical lawn-mower lifecycle: `idle` /
+* `mowing` / `paused` / `docked` / `error`. `batteryLevel` (0..100) is
+* nullable — some mowers don't report a battery percentage.
+*
+* `startMowing` begins a mowing run, `pause` halts it in place, and
+* `dock` sends the mower back to its charging station.
+*/
+var LawnMowerActivitySchema = _enum([
+	"idle",
+	"mowing",
+	"paused",
+	"docked",
+	"error"
+]);
+/** Severity of the current device/error code — info (status), warning, error. */
+var DeviceCodeSeveritySchema = _enum([
+	"info",
+	"warning",
+	"error"
+]);
 var LawnMowerControlStatusSchema = object({
 	/** Lifecycle activity of the mower. */
-	activity: _enum([
-		"idle",
-		"mowing",
-		"paused",
-		"docked",
-		"error"
-	]),
+	activity: LawnMowerActivitySchema,
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
 	batteryLevel: number().min(0).max(100).nullable(),
+	/** 0..100 mowing-completion percentage of the current task, or null when no
+	*  task is active / progress is unavailable. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current device/event code (dynamic — mostly status, sometimes an error),
+	*  or null when unknown. */
+	currentCode: number().nullable(),
+	/** Human label for {@link currentCode}, or null when undecodable. */
+	currentCodeLabel: string().nullable(),
+	/** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
+	*  attention; `info` is normal status. */
+	severity: DeviceCodeSeveritySchema,
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -12351,6 +12383,7 @@ var VacuumStateSchema = _enum([
 	"paused",
 	"returning",
 	"docked",
+	"drying",
 	"error"
 ]);
 /**
@@ -12389,6 +12422,12 @@ var VacuumControlStatusSchema = object({
 	detergent: TankStatusSchema.nullable(),
 	/** Dust bin. Null when the hardware has no dust bin. */
 	dustBin: TankStatusSchema.nullable(),
+	/** 0..100 cleaning-completion percentage of the current task, or null. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current error code (0 / null = no error). */
+	errorCode: number().nullable(),
+	/** Human label for {@link errorCode}, or null when none / undecodable. */
+	errorLabel: string().nullable(),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -13355,9 +13394,29 @@ var BaseDevice$1 = class {
 	* is open (Reolink writes `hasPtz/hasIntercom`, Hikvision writes
 	* `hasSupplementalLight/hasAlarmIo`, etc).
 	*
-	* Default: no-op (driver had no probe to run).
+	* Default: nothing to probe → mark the device PROBED (set `lastProbedAt`) so
+	* the kernel treats it as ready immediately. A device that derives its shape
+	* from a spec (a container, or an accessory sensor) rather than from a
+	* hardware probe has no probe to "complete"; without stamping `lastProbedAt`
+	* it would look perpetually un-probed — logging "Initial probe did not
+	* complete" on every boot and spinning a pointless retry chain. Drivers that
+	* DO probe override this and write their own `feature-probe` slice (including
+	* `lastProbedAt`) once their probe actually succeeds.
 	*/
-	async onProbe() {}
+	async onProbe() {
+		const base = this.runtimeState.getCapState("feature-probe") ?? {
+			flags: {},
+			deviceType: null,
+			model: null,
+			channelCount: null,
+			lastProbedAt: 0,
+			lastFetchedAt: 0
+		};
+		this.runtimeState.setCapState("feature-probe", {
+			...base,
+			lastProbedAt: Date.now()
+		});
+	}
 	/**
 	* Phase 5 — fired after the device + its accessories are registered.
 	* Drivers publish streams to the broker, kick off background tasks,
@@ -14819,17 +14878,32 @@ var ReleaseInputSchema = object({
 	*  the parent cascades into every accessory. */
 	camDeviceId: number().int().nonnegative()
 });
-var ResyncInputSchema = object({ 
-/** Parent CamStack device id of an adopted device. The provider resolves its
-*  source (integration/broker + native id) and re-aligns the device's
-*  structural spec (type/role/capabilities/units) with the live mapping,
-*  rebuilding any child whose class changed while preserving operator edits. */
-camDeviceId: number().int().nonnegative() });
+var ResyncInputSchema = object({
+	/** Parent CamStack device id of an adopted device. The provider resolves its
+	*  source (integration/broker + native id) and re-aligns the device's
+	*  structural spec (type/role/capabilities/units) with the live mapping,
+	*  rebuilding any child whose class changed while preserving operator edits. */
+	camDeviceId: number().int().nonnegative(),
+	/** "Resync from zero" (#19). When true, the kernel PURGES every accessory
+	*  child of `camDeviceId` BEFORE the provider re-derives the device, so the
+	*  children are rebuilt fresh from source — correct names, coords, and units —
+	*  instead of being preserved by the incremental reconcile. Use to recover from
+	*  legacy generic/placeholder names that the normal name-precedence keeps frozen
+	*  (the operator's explicit reset). Push-driven integrations (no-op resync)
+	*  rebuild on their next snapshot; pull/command integrations rebuild in `resync`.
+	*  Operator edits on the PARENT (its name, layout, primary-child pick) survive —
+	*  only the children are torn down. Omitted/false ⇒ the normal incremental
+	*  re-sync that preserves children. */
+	resetToSource: boolean().optional()
+});
 var ResyncResultSchema = object({
 	/** True when the persisted spec actually changed (children may have been rebuilt). */
 	changed: boolean(),
 	/** Number of child devices rebuilt into a new class by this re-sync. */
-	rebuiltChildren: number().int().nonnegative()
+	rebuiltChildren: number().int().nonnegative(),
+	/** Number of accessory children torn down by a `resetToSource` purge before the
+	*  provider re-derived the device. 0/absent for a normal incremental re-sync. */
+	removedChildren: number().int().nonnegative().optional()
 });
 var deviceAdoptionCapability = {
 	name: "device-adoption",
@@ -16594,6 +16668,11 @@ var DeviceMetaSchema = object({
 	addonId: string(),
 	type: string(),
 	name: string(),
+	/** True once an operator explicitly renamed the device via `setName`. Drives
+	*  reconcile name-precedence (preserve operator name vs adopt fresh provider
+	*  name). Absent ⇒ treated as user-named (PRESERVE) for legacy rows. See
+	*  `DeviceMeta.userNamed`. */
+	userNamed: boolean().optional(),
 	location: string().nullable(),
 	disabled: boolean(),
 	parentDeviceId: number().nullable(),
@@ -16904,6 +16983,9 @@ method(object({
 }), method(ReleaseInputSchema.extend({ addonId: string() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
+}), method(ResyncInputSchema, ResyncResultSchema, {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number(),
 	key: string(),
@@ -20666,6 +20748,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionResync": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.allocateDeviceId": {
 		capName: "device-manager",
 		capScope: "system",
@@ -25537,6 +25625,90 @@ function swingToOscillating(vertical, horizontal) {
 function oscillatingToVerticalSwing(oscillating) {
 	return oscillating ? VerticalSwing.FullSwing : VerticalSwing.Default;
 }
+/**
+* Gree fan-speed names surfaced on the `climate-control` cap's `fanMode` /
+* `availableFanModes` strings, mirroring the HA Gree integration's `fan_modes`
+* attribute (`auto`/`low`/`medium_low`/`medium`/`medium_high`/`high`).
+*
+* NOTE: HA's Gree integration also folds `turbo` and `quiet` INTO `fan_modes`.
+* We deliberately keep turbo/quiet on the dedicated `preset` surface instead
+* (they are independent boolean device flags in the protocol — `Tur` / `Quiet`
+* — not points on the `WdSpd` speed axis), so the speed picker stays a pure
+* speed axis and the two flags stay independently togglable. The `fan-control`
+* percentage surface continues to mirror the same `WdSpd` speed for the
+* fan-style UI.
+*/
+var GREE_FAN_MODES = [
+	"auto",
+	"low",
+	"medium_low",
+	"medium",
+	"medium_high",
+	"high"
+];
+/** Map a library {@link FanSpeed} to its `climate-control` `fanMode` string. Pure. */
+function fanSpeedToFanMode(speed) {
+	switch (speed) {
+		case FanSpeed.Auto: return "auto";
+		case FanSpeed.Low: return "low";
+		case FanSpeed.MediumLow: return "medium_low";
+		case FanSpeed.Medium: return "medium";
+		case FanSpeed.MediumHigh: return "medium_high";
+		case FanSpeed.High: return "high";
+	}
+}
+/**
+* Map a `climate-control` `fanMode` string back to a library {@link FanSpeed},
+* or null when the string is not a known Gree speed. Pure.
+*/
+function fanModeToFanSpeed(fanMode) {
+	switch (fanMode) {
+		case "auto": return FanSpeed.Auto;
+		case "low": return FanSpeed.Low;
+		case "medium_low": return FanSpeed.MediumLow;
+		case "medium": return FanSpeed.Medium;
+		case "medium_high": return FanSpeed.MediumHigh;
+		case "high": return FanSpeed.High;
+		default: return null;
+	}
+}
+var GREE_PRESETS = [
+	"none",
+	"turbo",
+	"quiet",
+	"sleep",
+	"eco",
+	"8c_heat"
+];
+/**
+* Derive the single active `preset` string from the device's comfort flags.
+* Precedence is fixed (turbo > quiet > sleep > eco > 8c_heat) so a coherent
+* single value is reported even if the device has more than one flag set.
+* Returns `'none'` when no flag is set. Pure.
+*/
+function presetFromFlags(flags) {
+	if (flags.turbo) return "turbo";
+	if (flags.quiet) return "quiet";
+	if (flags.sleep) return "sleep";
+	if (flags.powerSave) return "eco";
+	if (flags.steadyHeat) return "8c_heat";
+	return "none";
+}
+/**
+* Resolve a requested `preset` string to the set of flag writes needed to make
+* it the active one — the chosen flag (if any) true, every other flag false.
+* Returns null when the string is not a known Gree preset. Pure.
+*/
+function presetToFlagWrites(preset) {
+	if (!GREE_PRESETS.includes(preset)) return null;
+	return {
+		turbo: preset === "turbo",
+		quiet: preset === "quiet",
+		sleep: preset === "sleep",
+		powerSave: preset === "eco",
+		steadyHeat: preset === "8c_heat"
+	};
+}
 //#endregion
 //#region src/devices/gree-ac-device.ts
 var CLIMATE_CAP = "climate-control";
@@ -25545,9 +25717,9 @@ var CLIMATE_COLD_START = {
 	mode: "off",
 	availableModes: [...ADVERTISED_CAP_MODES],
 	fanMode: "",
-	availableFanModes: [],
+	availableFanModes: [...GREE_FAN_MODES],
 	preset: "",
-	availablePresets: [],
+	availablePresets: [...GREE_PRESETS],
 	target: null,
 	targetHigh: null,
 	targetLow: null,
@@ -25583,17 +25755,21 @@ var greeAcSchema = object({
 * `stateChanged` push (and seeds on activate).
 *
 * Climate commands route to the bound handle: setMode `off`→`setPower(false)`,
-* any other→`setPower(true)`+`setMode()`; setTarget→`setTargetTemperature()`.
-* Fan commands: setPercentage→`setFanSpeed()` (percentage↔FanSpeed bucket);
+* any other→`setPower(true)`+`setMode()`; setTarget→`setTargetTemperature()`;
+* setFanMode→`setFanSpeed()` (climate `fanMode` string ↔ Gree speed); setPreset→
+* the comfort-flag setters (turbo/quiet/sleep/eco/8c_heat → `setTurbo`/`setQuiet`/
+* `setSleep`/`setPowerSave`/`setSteadyHeat`, exclusive). Fan commands:
+* setPercentage→`setFanSpeed()` (percentage↔FanSpeed bucket);
 * setOscillating→`setSwingVertical(FullSwing|Default)`.
 *
-* TODO (deferred): the cap's `heat_cool` dual-setpoint, `setTargetHumidity`,
-* fan-mode strings, and presets (turbo/quiet/sleep/powerSave/steadyHeat which the
-* library DOES expose) are not yet mapped — fan speed already occupies the
-* `fan-control` percentage surface, and the cap preset/fan-mode surfaces are left
-* empty. The fine-grained 12-position vertical / 7-position horizontal swing is
-* collapsed to a single `oscillating` boolean. A later phase could add a vendor
-* preset / swing-position cap.
+* TODO (deferred — needs protocol RE / live confirmation): `heat_cool`
+* dual-setpoint (Gree single-setpoint ACs have none), `setTargetHumidity`
+* (`Dwet`/`DwatSen` dehumidifier props exist in PROPS but the library exposes no
+* getter/setter yet), the light toggle (`setLight`), X-Fan / fresh-air / health
+* toggles (`setXfan`/`setFreshAir`/`setHealth`) — all real library setters with
+* no cap surface (a vendor toggle cap would carry them), and the fine-grained
+* 12-position vertical / 7-position horizontal swing (collapsed to a single
+* `oscillating` boolean — a vendor swing-position cap would carry them).
 */
 var GreeAcDevice = class extends BaseDevice$1 {
 	features = [];
@@ -25671,10 +25847,19 @@ var GreeAcDevice = class extends BaseDevice$1 {
 				await ac.setMode(libMode);
 			},
 			setFanMode: async ({ fanMode }) => {
-				throw new Error(`gree ac: fan-mode strings not supported (use fan-control); got "${fanMode}"`);
+				const speed = fanModeToFanSpeed(fanMode);
+				if (speed === null) throw new Error(`gree ac: unsupported fan mode "${fanMode}"`);
+				await this.requireAc().setFanSpeed(speed);
 			},
 			setPreset: async ({ preset }) => {
-				throw new Error(`gree ac: presets not yet supported (got "${preset}")`);
+				const writes = presetToFlagWrites(preset);
+				if (writes === null) throw new Error(`gree ac: unsupported preset "${preset}"`);
+				const ac = this.requireAc();
+				if (ac.turbo !== writes.turbo) await ac.setTurbo(writes.turbo);
+				if (ac.quiet !== writes.quiet) await ac.setQuiet(writes.quiet);
+				if (ac.sleep !== writes.sleep) await ac.setSleep(writes.sleep);
+				if (ac.powerSave !== writes.powerSave) await ac.setPowerSave(writes.powerSave);
+				if (ac.steadyHeat !== writes.steadyHeat) await ac.setSteadyHeat(writes.steadyHeat);
 			},
 			setTarget: async ({ target }) => {
 				await this.requireAc().setTargetTemperature(target);
@@ -25708,13 +25893,21 @@ var GreeAcDevice = class extends BaseDevice$1 {
 		const ac = this.resolveAc();
 		if (ac === null) return;
 		const now = Date.now();
+		const mode = ac.power ? libModeToCapMode(ac.mode) : "off";
+		const preset = presetFromFlags({
+			turbo: ac.turbo,
+			quiet: ac.quiet,
+			sleep: ac.sleep,
+			powerSave: ac.powerSave,
+			steadyHeat: ac.steadyHeat
+		});
 		const climateSlice = {
-			mode: ac.power ? libModeToCapMode(ac.mode) : "off",
+			mode,
 			availableModes: [...ADVERTISED_CAP_MODES],
-			fanMode: "",
-			availableFanModes: [],
-			preset: "",
-			availablePresets: [],
+			fanMode: fanSpeedToFanMode(ac.fanSpeed),
+			availableFanModes: [...GREE_FAN_MODES],
+			preset,
+			availablePresets: [...GREE_PRESETS],
 			target: ac.targetTemperature,
 			targetHigh: null,
 			targetLow: null,

package/dist/addon.mjs

@@ -10079,15 +10079,18 @@ var humiditySensorCapability = {
 	runtimeState: HumiditySensorStatusSchema
 };
 /**
-* Image display cap. Models HA `image.*` entities — a single still image
-* exposed by an integration (a snapshot, a chart, a generated picture).
+* Image display cap. Models a single still image exposed by an integration —
+* a snapshot, a chart, a generated picture, or a robot's cleaning-map render.
 *
-* Read-only: there are no setters. The provider resolves the HA
-* `entity_picture` (a relative, signed-token path) into an ABSOLUTE URL
-* the browser loads directly — the token stays in the query string so no
-* auth header is required. The slice carries that URL plus the upstream
-* last-updated timestamp; the image changes when the entity state (a
-* timestamp) changes.
+* Read-only: there are no setters. The provider resolves whatever upstream
+* source it has into an ABSOLUTE URL the browser loads directly:
+*   - HA `image.*` entities → the `entity_picture` signed-token path
+*     (token stays in the query string, so no auth header is needed);
+*   - a Dreame/robot map → the cloud/OSS map-image URL (or an addon
+*     data-plane URL serving the rendered map bytes), exposed as its own
+*     Image child device grouped under the robot's container.
+* The slice carries that URL plus the upstream last-updated timestamp; the
+* image changes when the source's last-updated marker changes.
 */
 var ImageStatusSchema = object({
 	/** Absolute signed URL the browser loads directly. Null when the
@@ -10113,18 +10116,47 @@ var imageCapability = {
 	*/
 	runtimeState: ImageStatusSchema
 };
+/**
+* Robotic lawn-mower cap. Models HA `lawn_mower.*` entities — anything
+* with a mowing lifecycle plus a dock action.
+*
+* Activity follows HA's canonical lawn-mower lifecycle: `idle` /
+* `mowing` / `paused` / `docked` / `error`. `batteryLevel` (0..100) is
+* nullable — some mowers don't report a battery percentage.
+*
+* `startMowing` begins a mowing run, `pause` halts it in place, and
+* `dock` sends the mower back to its charging station.
+*/
+var LawnMowerActivitySchema = _enum([
+	"idle",
+	"mowing",
+	"paused",
+	"docked",
+	"error"
+]);
+/** Severity of the current device/error code — info (status), warning, error. */
+var DeviceCodeSeveritySchema = _enum([
+	"info",
+	"warning",
+	"error"
+]);
 var LawnMowerControlStatusSchema = object({
 	/** Lifecycle activity of the mower. */
-	activity: _enum([
-		"idle",
-		"mowing",
-		"paused",
-		"docked",
-		"error"
-	]),
+	activity: LawnMowerActivitySchema,
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
 	batteryLevel: number().min(0).max(100).nullable(),
+	/** 0..100 mowing-completion percentage of the current task, or null when no
+	*  task is active / progress is unavailable. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current device/event code (dynamic — mostly status, sometimes an error),
+	*  or null when unknown. */
+	currentCode: number().nullable(),
+	/** Human label for {@link currentCode}, or null when undecodable. */
+	currentCodeLabel: string().nullable(),
+	/** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
+	*  attention; `info` is normal status. */
+	severity: DeviceCodeSeveritySchema,
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -12350,6 +12382,7 @@ var VacuumStateSchema = _enum([
 	"paused",
 	"returning",
 	"docked",
+	"drying",
 	"error"
 ]);
 /**
@@ -12388,6 +12421,12 @@ var VacuumControlStatusSchema = object({
 	detergent: TankStatusSchema.nullable(),
 	/** Dust bin. Null when the hardware has no dust bin. */
 	dustBin: TankStatusSchema.nullable(),
+	/** 0..100 cleaning-completion percentage of the current task, or null. */
+	progressPercent: number().min(0).max(100).nullable(),
+	/** Current error code (0 / null = no error). */
+	errorCode: number().nullable(),
+	/** Human label for {@link errorCode}, or null when none / undecodable. */
+	errorLabel: string().nullable(),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -13354,9 +13393,29 @@ var BaseDevice$1 = class {
 	* is open (Reolink writes `hasPtz/hasIntercom`, Hikvision writes
 	* `hasSupplementalLight/hasAlarmIo`, etc).
 	*
-	* Default: no-op (driver had no probe to run).
+	* Default: nothing to probe → mark the device PROBED (set `lastProbedAt`) so
+	* the kernel treats it as ready immediately. A device that derives its shape
+	* from a spec (a container, or an accessory sensor) rather than from a
+	* hardware probe has no probe to "complete"; without stamping `lastProbedAt`
+	* it would look perpetually un-probed — logging "Initial probe did not
+	* complete" on every boot and spinning a pointless retry chain. Drivers that
+	* DO probe override this and write their own `feature-probe` slice (including
+	* `lastProbedAt`) once their probe actually succeeds.
 	*/
-	async onProbe() {}
+	async onProbe() {
+		const base = this.runtimeState.getCapState("feature-probe") ?? {
+			flags: {},
+			deviceType: null,
+			model: null,
+			channelCount: null,
+			lastProbedAt: 0,
+			lastFetchedAt: 0
+		};
+		this.runtimeState.setCapState("feature-probe", {
+			...base,
+			lastProbedAt: Date.now()
+		});
+	}
 	/**
 	* Phase 5 — fired after the device + its accessories are registered.
 	* Drivers publish streams to the broker, kick off background tasks,
@@ -14818,17 +14877,32 @@ var ReleaseInputSchema = object({
 	*  the parent cascades into every accessory. */
 	camDeviceId: number().int().nonnegative()
 });
-var ResyncInputSchema = object({ 
-/** Parent CamStack device id of an adopted device. The provider resolves its
-*  source (integration/broker + native id) and re-aligns the device's
-*  structural spec (type/role/capabilities/units) with the live mapping,
-*  rebuilding any child whose class changed while preserving operator edits. */
-camDeviceId: number().int().nonnegative() });
+var ResyncInputSchema = object({
+	/** Parent CamStack device id of an adopted device. The provider resolves its
+	*  source (integration/broker + native id) and re-aligns the device's
+	*  structural spec (type/role/capabilities/units) with the live mapping,
+	*  rebuilding any child whose class changed while preserving operator edits. */
+	camDeviceId: number().int().nonnegative(),
+	/** "Resync from zero" (#19). When true, the kernel PURGES every accessory
+	*  child of `camDeviceId` BEFORE the provider re-derives the device, so the
+	*  children are rebuilt fresh from source — correct names, coords, and units —
+	*  instead of being preserved by the incremental reconcile. Use to recover from
+	*  legacy generic/placeholder names that the normal name-precedence keeps frozen
+	*  (the operator's explicit reset). Push-driven integrations (no-op resync)
+	*  rebuild on their next snapshot; pull/command integrations rebuild in `resync`.
+	*  Operator edits on the PARENT (its name, layout, primary-child pick) survive —
+	*  only the children are torn down. Omitted/false ⇒ the normal incremental
+	*  re-sync that preserves children. */
+	resetToSource: boolean().optional()
+});
 var ResyncResultSchema = object({
 	/** True when the persisted spec actually changed (children may have been rebuilt). */
 	changed: boolean(),
 	/** Number of child devices rebuilt into a new class by this re-sync. */
-	rebuiltChildren: number().int().nonnegative()
+	rebuiltChildren: number().int().nonnegative(),
+	/** Number of accessory children torn down by a `resetToSource` purge before the
+	*  provider re-derived the device. 0/absent for a normal incremental re-sync. */
+	removedChildren: number().int().nonnegative().optional()
 });
 var deviceAdoptionCapability = {
 	name: "device-adoption",
@@ -16593,6 +16667,11 @@ var DeviceMetaSchema = object({
 	addonId: string(),
 	type: string(),
 	name: string(),
+	/** True once an operator explicitly renamed the device via `setName`. Drives
+	*  reconcile name-precedence (preserve operator name vs adopt fresh provider
+	*  name). Absent ⇒ treated as user-named (PRESERVE) for legacy rows. See
+	*  `DeviceMeta.userNamed`. */
+	userNamed: boolean().optional(),
 	location: string().nullable(),
 	disabled: boolean(),
 	parentDeviceId: number().nullable(),
@@ -16903,6 +16982,9 @@ method(object({
 }), method(ReleaseInputSchema.extend({ addonId: string() }), _void(), {
 	kind: "mutation",
 	auth: "admin"
+}), method(ResyncInputSchema, ResyncResultSchema, {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	deviceId: number(),
 	key: string(),
@@ -20665,6 +20747,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionResync": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.allocateDeviceId": {
 		capName: "device-manager",
 		capScope: "system",
@@ -25536,6 +25624,90 @@ function swingToOscillating(vertical, horizontal) {
 function oscillatingToVerticalSwing(oscillating) {
 	return oscillating ? VerticalSwing.FullSwing : VerticalSwing.Default;
 }
+/**
+* Gree fan-speed names surfaced on the `climate-control` cap's `fanMode` /
+* `availableFanModes` strings, mirroring the HA Gree integration's `fan_modes`
+* attribute (`auto`/`low`/`medium_low`/`medium`/`medium_high`/`high`).
+*
+* NOTE: HA's Gree integration also folds `turbo` and `quiet` INTO `fan_modes`.
+* We deliberately keep turbo/quiet on the dedicated `preset` surface instead
+* (they are independent boolean device flags in the protocol — `Tur` / `Quiet`
+* — not points on the `WdSpd` speed axis), so the speed picker stays a pure
+* speed axis and the two flags stay independently togglable. The `fan-control`
+* percentage surface continues to mirror the same `WdSpd` speed for the
+* fan-style UI.
+*/
+var GREE_FAN_MODES = [
+	"auto",
+	"low",
+	"medium_low",
+	"medium",
+	"medium_high",
+	"high"
+];
+/** Map a library {@link FanSpeed} to its `climate-control` `fanMode` string. Pure. */
+function fanSpeedToFanMode(speed) {
+	switch (speed) {
+		case FanSpeed.Auto: return "auto";
+		case FanSpeed.Low: return "low";
+		case FanSpeed.MediumLow: return "medium_low";
+		case FanSpeed.Medium: return "medium";
+		case FanSpeed.MediumHigh: return "medium_high";
+		case FanSpeed.High: return "high";
+	}
+}
+/**
+* Map a `climate-control` `fanMode` string back to a library {@link FanSpeed},
+* or null when the string is not a known Gree speed. Pure.
+*/
+function fanModeToFanSpeed(fanMode) {
+	switch (fanMode) {
+		case "auto": return FanSpeed.Auto;
+		case "low": return FanSpeed.Low;
+		case "medium_low": return FanSpeed.MediumLow;
+		case "medium": return FanSpeed.Medium;
+		case "medium_high": return FanSpeed.MediumHigh;
+		case "high": return FanSpeed.High;
+		default: return null;
+	}
+}
+var GREE_PRESETS = [
+	"none",
+	"turbo",
+	"quiet",
+	"sleep",
+	"eco",
+	"8c_heat"
+];
+/**
+* Derive the single active `preset` string from the device's comfort flags.
+* Precedence is fixed (turbo > quiet > sleep > eco > 8c_heat) so a coherent
+* single value is reported even if the device has more than one flag set.
+* Returns `'none'` when no flag is set. Pure.
+*/
+function presetFromFlags(flags) {
+	if (flags.turbo) return "turbo";
+	if (flags.quiet) return "quiet";
+	if (flags.sleep) return "sleep";
+	if (flags.powerSave) return "eco";
+	if (flags.steadyHeat) return "8c_heat";
+	return "none";
+}
+/**
+* Resolve a requested `preset` string to the set of flag writes needed to make
+* it the active one — the chosen flag (if any) true, every other flag false.
+* Returns null when the string is not a known Gree preset. Pure.
+*/
+function presetToFlagWrites(preset) {
+	if (!GREE_PRESETS.includes(preset)) return null;
+	return {
+		turbo: preset === "turbo",
+		quiet: preset === "quiet",
+		sleep: preset === "sleep",
+		powerSave: preset === "eco",
+		steadyHeat: preset === "8c_heat"
+	};
+}
 //#endregion
 //#region src/devices/gree-ac-device.ts
 var CLIMATE_CAP = "climate-control";
@@ -25544,9 +25716,9 @@ var CLIMATE_COLD_START = {
 	mode: "off",
 	availableModes: [...ADVERTISED_CAP_MODES],
 	fanMode: "",
-	availableFanModes: [],
+	availableFanModes: [...GREE_FAN_MODES],
 	preset: "",
-	availablePresets: [],
+	availablePresets: [...GREE_PRESETS],
 	target: null,
 	targetHigh: null,
 	targetLow: null,
@@ -25582,17 +25754,21 @@ var greeAcSchema = object({
 * `stateChanged` push (and seeds on activate).
 *
 * Climate commands route to the bound handle: setMode `off`→`setPower(false)`,
-* any other→`setPower(true)`+`setMode()`; setTarget→`setTargetTemperature()`.
-* Fan commands: setPercentage→`setFanSpeed()` (percentage↔FanSpeed bucket);
+* any other→`setPower(true)`+`setMode()`; setTarget→`setTargetTemperature()`;
+* setFanMode→`setFanSpeed()` (climate `fanMode` string ↔ Gree speed); setPreset→
+* the comfort-flag setters (turbo/quiet/sleep/eco/8c_heat → `setTurbo`/`setQuiet`/
+* `setSleep`/`setPowerSave`/`setSteadyHeat`, exclusive). Fan commands:
+* setPercentage→`setFanSpeed()` (percentage↔FanSpeed bucket);
 * setOscillating→`setSwingVertical(FullSwing|Default)`.
 *
-* TODO (deferred): the cap's `heat_cool` dual-setpoint, `setTargetHumidity`,
-* fan-mode strings, and presets (turbo/quiet/sleep/powerSave/steadyHeat which the
-* library DOES expose) are not yet mapped — fan speed already occupies the
-* `fan-control` percentage surface, and the cap preset/fan-mode surfaces are left
-* empty. The fine-grained 12-position vertical / 7-position horizontal swing is
-* collapsed to a single `oscillating` boolean. A later phase could add a vendor
-* preset / swing-position cap.
+* TODO (deferred — needs protocol RE / live confirmation): `heat_cool`
+* dual-setpoint (Gree single-setpoint ACs have none), `setTargetHumidity`
+* (`Dwet`/`DwatSen` dehumidifier props exist in PROPS but the library exposes no
+* getter/setter yet), the light toggle (`setLight`), X-Fan / fresh-air / health
+* toggles (`setXfan`/`setFreshAir`/`setHealth`) — all real library setters with
+* no cap surface (a vendor toggle cap would carry them), and the fine-grained
+* 12-position vertical / 7-position horizontal swing (collapsed to a single
+* `oscillating` boolean — a vendor swing-position cap would carry them).
 */
 var GreeAcDevice = class extends BaseDevice$1 {
 	features = [];
@@ -25670,10 +25846,19 @@ var GreeAcDevice = class extends BaseDevice$1 {
 				await ac.setMode(libMode);
 			},
 			setFanMode: async ({ fanMode }) => {
-				throw new Error(`gree ac: fan-mode strings not supported (use fan-control); got "${fanMode}"`);
+				const speed = fanModeToFanSpeed(fanMode);
+				if (speed === null) throw new Error(`gree ac: unsupported fan mode "${fanMode}"`);
+				await this.requireAc().setFanSpeed(speed);
 			},
 			setPreset: async ({ preset }) => {
-				throw new Error(`gree ac: presets not yet supported (got "${preset}")`);
+				const writes = presetToFlagWrites(preset);
+				if (writes === null) throw new Error(`gree ac: unsupported preset "${preset}"`);
+				const ac = this.requireAc();
+				if (ac.turbo !== writes.turbo) await ac.setTurbo(writes.turbo);
+				if (ac.quiet !== writes.quiet) await ac.setQuiet(writes.quiet);
+				if (ac.sleep !== writes.sleep) await ac.setSleep(writes.sleep);
+				if (ac.powerSave !== writes.powerSave) await ac.setPowerSave(writes.powerSave);
+				if (ac.steadyHeat !== writes.steadyHeat) await ac.setSteadyHeat(writes.steadyHeat);
 			},
 			setTarget: async ({ target }) => {
 				await this.requireAc().setTargetTemperature(target);
@@ -25707,13 +25892,21 @@ var GreeAcDevice = class extends BaseDevice$1 {
 		const ac = this.resolveAc();
 		if (ac === null) return;
 		const now = Date.now();
+		const mode = ac.power ? libModeToCapMode(ac.mode) : "off";
+		const preset = presetFromFlags({
+			turbo: ac.turbo,
+			quiet: ac.quiet,
+			sleep: ac.sleep,
+			powerSave: ac.powerSave,
+			steadyHeat: ac.steadyHeat
+		});
 		const climateSlice = {
-			mode: ac.power ? libModeToCapMode(ac.mode) : "off",
+			mode,
 			availableModes: [...ADVERTISED_CAP_MODES],
-			fanMode: "",
-			availableFanModes: [],
-			preset: "",
-			availablePresets: [],
+			fanMode: fanSpeedToFanMode(ac.fanSpeed),
+			availableFanModes: [...GREE_FAN_MODES],
+			preset,
+			availablePresets: [...GREE_PRESETS],
 			target: ac.targetTemperature,
 			targetHigh: null,
 			targetLow: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-gree",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Gree air-conditioner device-provider addon for CamStack — wraps the @apocaliss92/nodegree local-UDP client (LAN discovery + AES control), exposing climate-control and fan-control",
   "keywords": [
     "camstack",
@@ -44,7 +44,7 @@
         "instanceMode": "multiple",
         "brokerKind": "gree",
         "execution": {
-          "placement": "any-node"
+          "placement": "hub-only"
         },
         "capabilities": [
           {