@camstack/addon-provider-gree 0.1.9 → 0.1.10

package/dist/addon.js

@@ -4645,7 +4645,7 @@ function preprocess(fn, schema) {
 	});
 }
 //#endregion
-//#region ../types/dist/sleep-B3AOslwX.mjs
+//#region ../types/dist/sleep-C2M2zF7x.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -6213,6 +6213,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["Switch"] = "switch";
 	DeviceType["Sensor"] = "sensor";
 	DeviceType["Thermostat"] = "thermostat";
+	/** Air-conditioner / heat-pump climate device (HVAC) — shares the
+	*  `climate-control` cap surface with `Thermostat` but renders a
+	*  dedicated AC-appropriate control UI (mode chips, fan speed,
+	*  independent vertical/horizontal swing). Sources: native Gree, and
+	*  reusable by other AC integrations. */
+	DeviceType["Climate"] = "climate";
 	DeviceType["Button"] = "button";
 	/** Generic stateless event emitter — carries a device's EXACT declared
 	*  event vocabulary verbatim (no normalization). Installed with the
@@ -9008,7 +9014,7 @@ var climateControlCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Thermostat, DeviceType.Climate],
 	methods: {
 		setMode: method(object({
 			deviceId: number().int().nonnegative(),
@@ -13607,10 +13613,30 @@ var deviceProviderCapability = {
 			type: string()
 		}))),
 		supportsDiscovery: method(object({}), boolean()),
-		discoverDevices: method(object({}), array(DiscoveryCandidateSchema), {
+		/**
+		* Run a network scan. `params` carries optional provider-specific scan
+		* inputs (e.g. a broadcast address / subnet for cross-subnet discovery),
+		* shaped by `getDiscoveryParamsSchema`. Omitted for the generic scan
+		* (provider uses its local-network default).
+		*/
+		discoverDevices: method(object({ params: record(string(), unknown()).optional() }), array(DiscoveryCandidateSchema), {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Optional form schema (`ConfigUISchema`) for the EXTRA per-scan inputs a
+		* provider accepts (e.g. Gree's broadcast address for a different subnet).
+		* `null` when the provider takes no extra scan params — the generic
+		* aggregated scan never renders this; the per-integration scan does.
+		*/
+		getDiscoveryParamsSchema: method(object({}), CreationSchemaOutputSchema),
+		/**
+		* The DeviceType this provider creates via manual add (Camera for
+		* Reolink/ONVIF, Container for Gree, Hub for Ecowitt). `null` when the
+		* provider does not support manual creation. Lets the Add-Device dialog
+		* pick the right type instead of assuming Camera.
+		*/
+		getManualCreationType: method(object({}), object({ deviceType: _enum(DeviceType).nullable() })),
 		adoptDiscoveredDevice: method(object({ candidate: DiscoveryCandidateSchema }), DeviceSummarySchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -13734,9 +13760,23 @@ var BaseDeviceProvider = class extends BaseAddon {
 	async supportsDiscovery() {
 		return false;
 	}
-	async discoverDevices() {
+	async discoverDevices(_input) {
 		return [];
 	}
+	/** Extra per-scan input form (e.g. a broadcast address for another subnet).
+	*  Null = no extra params. Override in providers that support scoped scans. */
+	async getDiscoveryParamsSchema() {
+		return null;
+	}
+	/**
+	* The DeviceType this provider creates via manual add — derived from the
+	* `deviceClasses` map (first registered type). `null` when manual creation is
+	* unsupported. Lets the Add-Device dialog pick the right type per provider.
+	*/
+	async getManualCreationType() {
+		if (!await this.supportsManualCreation()) return { deviceType: null };
+		return { deviceType: Object.values(DeviceType).find((t) => this.deviceClasses[t] !== void 0) ?? null };
+	}
 	async adoptDiscoveredDevice(_input) {
 		throw new Error(`${this.providerName} provider does not support discovery-based adoption`);
 	}
@@ -15581,7 +15621,10 @@ method(object({
 }), FieldProbeResultSchema, {
 	kind: "mutation",
 	auth: "admin"
-}), method(ListCandidatesInputSchema.extend({ addonId: string() }), ListCandidatesOutputSchema, { auth: "admin" }), method(object({
+}), method(object({
+	addonId: string(),
+	integrationId: string()
+}), object({ filters: array(AdoptionFilterSchema) }), { auth: "admin" }), method(ListCandidatesInputSchema.extend({ addonId: string() }), ListCandidatesOutputSchema, { auth: "admin" }), method(object({
 	addonId: string(),
 	integrationId: string()
 }), AdoptionStatusSchema, {
@@ -15596,7 +15639,24 @@ method(object({
 }), method(ResyncInputSchema, ResyncResultSchema, {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({}), object({ providers: array(object({
+	addonId: string(),
+	label: string()
+})).readonly() }), { auth: "admin" }), method(object({}), object({ groups: array(object({
+	addonId: string(),
+	label: string(),
+	candidates: array(DiscoveryCandidateSchema).readonly(),
+	error: string().nullable()
+})).readonly() }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
+	addonId: string(),
+	params: record(string(), unknown()).optional()
+}), object({ candidates: array(DiscoveryCandidateSchema).readonly() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ addonId: string() }), object({ deviceType: _enum(DeviceType).nullable() }), { auth: "admin" }), method(object({ addonId: string() }), unknown(), { auth: "admin" }), method(object({
 	deviceId: number(),
 	key: string(),
 	value: unknown()
@@ -20719,6 +20779,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionListCandidateFilters": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.adoptionListCandidates": {
 		capName: "device-manager",
 		capScope: "system",
@@ -20767,12 +20833,30 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.discoverAllProviders": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.discoverDevices": {
 		capName: "device-manager",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.discoverProvider": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"deviceManager.discoveryProviders": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.enable": {
 		capName: "device-manager",
 		capScope: "system",
@@ -20923,6 +21007,18 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.providerCreationType": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"deviceManager.providerDiscoveryParamsSchema": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.registerDevice": {
 		capName: "device-manager",
 		capScope: "system",
@@ -21139,6 +21235,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceProvider.getDiscoveryParamsSchema": {
+		capName: "device-provider",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"deviceProvider.getManualCreationType": {
+		capName: "device-provider",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceProvider.getStatus": {
 		capName: "device-provider",
 		capScope: "system",
@@ -24128,6 +24236,34 @@ function buildConnectionFormSchema() {
 		]
 	}] };
 }
+/**
+* Extra params form for a PER-INTEGRATION network scan. Gree's UDP broadcast
+* only reaches the addon node's local subnet; to find ACs on a DIFFERENT subnet
+* (e.g. 192.168.20.x) the operator supplies that subnet's directed-broadcast
+* address (192.168.20.255). Empty = default local-subnet broadcast.
+*/
+function buildDiscoveryParamsFormSchema() {
+	return { sections: [{
+		id: "scan",
+		title: "Scan options",
+		description: "Leave empty to scan the local subnet. To find air conditioners on a different subnet, enter that subnet’s broadcast address (e.g. 192.168.20.255).",
+		columns: 1,
+		fields: [{
+			type: "text",
+			key: "broadcastAddress",
+			label: "Broadcast address",
+			required: false,
+			placeholder: "192.168.20.255"
+		}, {
+			type: "number",
+			key: "timeoutMs",
+			label: "UDP timeout (ms)",
+			min: 500,
+			max: 3e4,
+			default: 3e3
+		}]
+	}] };
+}
 //#endregion
 //#region ../../node_modules/@apocaliss92/nodegree/dist/index.js
 var GreeError = class extends Error {
@@ -24829,6 +24965,16 @@ function macKey(mac) {
 */
 var GreeConnectionResolver = class {
 	#surfaces = /* @__PURE__ */ new Map();
+	/**
+	* Per-connection "surface (re)published" subscribers. An AC accessory child
+	* activates from `restoreDevices` BEFORE its parent's manager finishes the
+	* async bind, so `getDevice` is null at `onActivate` time and its
+	* `stateChanged` listener never attaches → the climate slice stays frozen at
+	* cold-start (`lastFetchedAt: 0`, no temperature). Children subscribe here and
+	* (re)attach + recompute once the handle is published. A plain `Set` has no
+	* listener cap. Mirrors the Ecowitt facade-resolver fan-out.
+	*/
+	#subs = /* @__PURE__ */ new Map();
 	/** Publish or remove the connection surface for a connection key. `null` removes. */
 	set(connectionKey, surface) {
 		if (surface === null) {
@@ -24836,6 +24982,24 @@ var GreeConnectionResolver = class {
 			return;
 		}
 		this.#surfaces.set(connectionKey, surface);
+		const subs = this.#subs.get(connectionKey);
+		if (subs) for (const cb of subs) try {
+			cb();
+		} catch {}
+	}
+	/** Subscribe to surface (re)publish for a connection key. Returns unsubscribe. */
+	onSurface(connectionKey, cb) {
+		let set = this.#subs.get(connectionKey);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.#subs.set(connectionKey, set);
+		}
+		set.add(cb);
+		return () => {
+			const current = this.#subs.get(connectionKey);
+			current?.delete(cb);
+			if (current && current.size === 0) this.#subs.delete(connectionKey);
+		};
 	}
 	/** The bind-scan rows for a connection key, or empty when unknown. */
 	discovered(connectionKey) {
@@ -24859,6 +25023,7 @@ var GreeConnectionResolver = class {
 	/** Remove all registered surfaces (called on full shutdown). */
 	clear() {
 		this.#surfaces.clear();
+		this.#subs.clear();
 	}
 };
 /** The single in-process per-connection resolver shared between the AC device's
@@ -24869,7 +25034,7 @@ var greeConnections = new GreeConnectionResolver();
 function defaultFacade(config) {
 	return new Nodegree(toNodegreeOptions(config));
 }
-var DEFAULT_POLL_INTERVAL_MS = 3e4;
+var DEFAULT_POLL_INTERVAL_MS = 1e4;
 /**
 * Wraps exactly one `@apocaliss92/nodegree` facade bound to a SINGLE Gree AC
 * (standalone mode — the connection lives on the AC device). {@link start} runs a
@@ -25068,6 +25233,27 @@ function resolveBroadcastTarget(connection) {
 * The returned identity is what {@link import('./config.js').greeAcDeviceSchema}
 * persists on the new device; the live per-device manager re-binds on activate.
 */
+/**
+* One-shot LAN broadcast scan for Gree ACs — the network-discovery pass. Builds a
+* throwaway facade from default (or provided) UDP settings, runs the broadcast,
+* and returns every responder. No bind, no persistence. The provider's
+* `discoverDevices()` maps the responders to adoption candidates.
+*/
+async function discoverGreeDevices(input) {
+	const connection = settingsToGreeConfig({
+		...input.broadcastAddress ? { broadcastAddr: input.broadcastAddress } : {},
+		...input.timeoutMs ? { timeoutMs: input.timeoutMs } : {}
+	});
+	const facade = (input.makeFacade ?? defaultFacade)(connection);
+	try {
+		const broadcast = resolveBroadcastTarget(connection);
+		const opts = { timeoutMs: connection.timeoutMs };
+		if (broadcast.length > 0) opts.broadcastAddr = broadcast;
+		return await facade.discover(opts);
+	} finally {
+		await facade.close().catch(() => void 0);
+	}
+}
 async function bindOnce(input) {
 	const { connection, logger } = input;
 	const facade = (input.makeFacade ?? defaultFacade)(connection);
@@ -25366,7 +25552,19 @@ var greeAcSchema = object({
 	greeMac: string().min(1).describe("Gree AC MAC address"),
 	connectionKey: string().min(1).describe("Per-device connection resolver key"),
 	system: literal("gree").optional(),
-	integrationId: string().optional()
+	integrationId: string().optional(),
+	/** Operator filter — HVAC modes exposed in the control UI (subset of the
+	*  model's supported modes). Empty / omitted ⇒ expose all. `off` is always
+	*  exposed (power). */
+	enabledModes: array(string()).optional(),
+	/** Operator filter — fan speeds exposed in the control UI (subset of
+	*  `GREE_FAN_MODES`). Empty / omitted ⇒ expose all. */
+	enabledFanModes: array(string()).optional(),
+	/** Operator filter — expose the vertical-swing toggle. Default true. */
+	exposeVerticalSwing: boolean().optional(),
+	/** Operator filter — expose the horizontal-swing toggle (model-permitting).
+	*  Default true. */
+	exposeHorizontalSwing: boolean().optional()
 });
 /**
 * One Gree air conditioner as a CamStack `Thermostat`-type accessory child.
@@ -25406,17 +25604,16 @@ var GreeAcDevice = class extends BaseDevice$1 {
 	*/
 	get features() {
 		const caps = this.resolveAc()?.capabilities ?? getAcCapabilities();
-		const flags = [
-			DeviceFeature.ClimateFanMode,
-			DeviceFeature.ClimatePreset,
-			DeviceFeature.ClimateSwingVertical
-		];
-		if (caps.horizontalSwing) flags.push(DeviceFeature.ClimateSwingHorizontal);
+		const cfg = this.config.values;
+		const flags = [DeviceFeature.ClimateFanMode, DeviceFeature.ClimatePreset];
+		if (cfg.exposeVerticalSwing ?? true) flags.push(DeviceFeature.ClimateSwingVertical);
+		if (caps.horizontalSwing && (cfg.exposeHorizontalSwing ?? true)) flags.push(DeviceFeature.ClimateSwingHorizontal);
 		return flags;
 	}
 	greeMac;
 	connectionKey;
 	stateChangedUnsub = null;
+	surfaceUnsub = null;
 	constructor(ctx) {
 		const persisted = greeAcSchema.parse(ctx.persistedConfig ?? {});
 		super(ctx, greeAcSchema, { type: ctx.deviceMeta.type });
@@ -25441,8 +25638,21 @@ var GreeAcDevice = class extends BaseDevice$1 {
 		this.registerCaps();
 		this.attachStateListener();
 		this.recomputeSlices();
+		this.surfaceUnsub = greeConnections.onSurface(this.connectionKey, () => {
+			this.attachStateListener();
+			this.recomputeSlices();
+		});
 	}
 	async removeDevice() {
+		this.detachStateListener();
+		if (this.surfaceUnsub) {
+			try {
+				this.surfaceUnsub();
+			} catch {}
+			this.surfaceUnsub = null;
+		}
+	}
+	detachStateListener() {
 		if (this.stateChangedUnsub) {
 			try {
 				this.stateChangedUnsub();
@@ -25450,12 +25660,16 @@ var GreeAcDevice = class extends BaseDevice$1 {
 			this.stateChangedUnsub = null;
 		}
 	}
+	/** Attach the live `stateChanged` listener to the bound AC handle. Idempotent:
+	*  drops any prior listener first, so it is safe to call on every surface
+	*  (re)publish. No-op until the handle is actually bound. */
 	attachStateListener() {
 		const ac = this.resolveAc();
 		if (!ac) {
 			this.ctx.logger.debug("GreeAcDevice: handle not present; no live listener yet", { meta: { greeMac: this.greeMac } });
 			return;
 		}
+		this.detachStateListener();
 		const onState = () => {
 			try {
 				this.recomputeSlices();
@@ -25473,7 +25687,7 @@ var GreeAcDevice = class extends BaseDevice$1 {
 	}
 	registerCaps() {
 		this.ctx.registerNativeCap(climateControlCapability, {
-			getStatus: async () => this.runtimeState.getCapState(CLIMATE_CAP) ?? CLIMATE_COLD_START,
+			getStatus: async () => this.runtimeState.getCapState(CLIMATE_CAP) ?? this.applyClimateFilters(CLIMATE_COLD_START),
 			setMode: async ({ mode }) => {
 				const ac = this.requireAc();
 				const libMode = capModeToLibMode(mode);
@@ -25520,7 +25734,7 @@ var GreeAcDevice = class extends BaseDevice$1 {
 				await ac.setSwingHorizontal(boolToHorizontalSwing(on));
 			}
 		});
-		this.runtimeState.setCapState(CLIMATE_CAP, CLIMATE_COLD_START);
+		this.runtimeState.setCapState(CLIMATE_CAP, this.applyClimateFilters(CLIMATE_COLD_START));
 		this.ctx.registerNativeCap(fanControlCapability, {
 			getStatus: async () => this.runtimeState.getCapState(FAN_CAP) ?? FAN_COLD_START,
 			setPercentage: async ({ percentage }) => {
@@ -25567,7 +25781,7 @@ var GreeAcDevice = class extends BaseDevice$1 {
 			swingHorizontal: ac.capabilities.horizontalSwing ? horizontalSwingToBool(ac.swingHorizontal) : null,
 			lastFetchedAt: now
 		};
-		this.runtimeState.setCapState(CLIMATE_CAP, climateSlice);
+		this.runtimeState.setCapState(CLIMATE_CAP, this.applyClimateFilters(climateSlice));
 		const fanSlice = {
 			percentage: fanSpeedToPercentage(ac.fanSpeed),
 			percentageStep: GREE_FAN_PERCENTAGE_STEP,
@@ -25579,7 +25793,97 @@ var GreeAcDevice = class extends BaseDevice$1 {
 		};
 		this.runtimeState.setCapState(FAN_CAP, fanSlice);
 	}
+	/**
+	* Apply the operator's per-AC exposure filters to a climate slice: narrow
+	* `availableModes` / `availableFanModes` to the enabled subsets (empty ⇒ all;
+	* `off` is always kept) and null out a swing axis the operator has hidden.
+	* Pure — returns a new slice, never mutates the input.
+	*/
+	applyClimateFilters(slice) {
+		const cfg = this.config.values;
+		const enabledModes = cfg.enabledModes;
+		const enabledFanModes = cfg.enabledFanModes;
+		const exposeV = cfg.exposeVerticalSwing ?? true;
+		const exposeH = cfg.exposeHorizontalSwing ?? true;
+		const availableModes = enabledModes && enabledModes.length > 0 ? slice.availableModes.filter((m) => m === "off" || enabledModes.includes(m)) : slice.availableModes;
+		const availableFanModes = enabledFanModes && enabledFanModes.length > 0 ? slice.availableFanModes.filter((f) => enabledFanModes.includes(f)) : slice.availableFanModes;
+		return {
+			...slice,
+			availableModes,
+			availableFanModes,
+			swingVertical: exposeV ? slice.swingVertical : null,
+			swingHorizontal: exposeH ? slice.swingHorizontal : null
+		};
+	}
+	/**
+	* Per-AC exposure form (device-details settings). Lets the operator pick
+	* which modes / fan speeds / swing axes appear in the AC control UI. An empty
+	* multiselect means "expose all". The horizontal-swing toggle is only offered
+	* when the model advertises horizontal swing.
+	*/
+	getSettingsUISchema() {
+		const supportsHSwing = (this.resolveAc()?.capabilities ?? getAcCapabilities()).horizontalSwing;
+		const cfg = this.config.values;
+		const fields = [
+			{
+				type: "multiselect",
+				key: "enabledModes",
+				label: "Modes",
+				description: "Modes shown in the control UI. Empty = all. “Off” is always available.",
+				options: SUPPORTED_CAP_MODES.map((m) => ({
+					value: m,
+					label: titleCase(m)
+				}))
+			},
+			{
+				type: "multiselect",
+				key: "enabledFanModes",
+				label: "Fan speeds",
+				description: "Fan speeds shown in the control UI. Empty = all.",
+				options: GREE_FAN_MODES.map((f) => ({
+					value: f,
+					label: titleCase(f)
+				}))
+			},
+			{
+				type: "boolean",
+				style: "switch",
+				key: "exposeVerticalSwing",
+				label: "Vertical swing",
+				default: true
+			}
+		];
+		if (supportsHSwing) fields.push({
+			type: "boolean",
+			style: "switch",
+			key: "exposeHorizontalSwing",
+			label: "Horizontal swing",
+			default: true
+		});
+		return hydrateSchema({ sections: [{
+			id: "exposure",
+			title: "Exposed controls",
+			description: "Choose which modes, fan speeds and swing axes appear in the air-conditioner control UI.",
+			fields
+		}] }, {
+			enabledModes: cfg.enabledModes ?? [],
+			enabledFanModes: cfg.enabledFanModes ?? [],
+			exposeVerticalSwing: cfg.exposeVerticalSwing ?? true,
+			exposeHorizontalSwing: cfg.exposeHorizontalSwing ?? true
+		});
+	}
+	async applySettingsPatch(patch) {
+		const typed = greeAcSchema.partial().parse(patch);
+		await this.config.setAll(typed);
+		this.recomputeSlices();
+		await this.refreshFeatures();
+	}
 };
+/** 'fan_only' → 'Fan only', 'medium_low' → 'Medium low'. Pure. */
+function titleCase(value) {
+	const spaced = value.replace(/_/g, " ");
+	return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
 //#endregion
 //#region src/devices/gree-toggle-device.ts
 var SWITCH_CAP = "switch";
@@ -25622,6 +25926,7 @@ var GreeToggleDevice = class extends BaseDevice$1 {
 	greeMac;
 	connectionKey;
 	stateChangedUnsub = null;
+	surfaceUnsub = null;
 	constructor(ctx) {
 		const persisted = greeToggleSchema.parse(ctx.persistedConfig ?? {});
 		super(ctx, greeToggleSchema, { type: ctx.deviceMeta.type });
@@ -25673,8 +25978,21 @@ var GreeToggleDevice = class extends BaseDevice$1 {
 		this.registerCap();
 		this.attachStateListener();
 		this.recomputeSlice();
+		this.surfaceUnsub = greeConnections.onSurface(this.connectionKey, () => {
+			this.attachStateListener();
+			this.recomputeSlice();
+		});
 	}
 	async removeDevice() {
+		this.detachStateListener();
+		if (this.surfaceUnsub) {
+			try {
+				this.surfaceUnsub();
+			} catch {}
+			this.surfaceUnsub = null;
+		}
+	}
+	detachStateListener() {
 		if (this.stateChangedUnsub) {
 			try {
 				this.stateChangedUnsub();
@@ -25691,6 +26009,7 @@ var GreeToggleDevice = class extends BaseDevice$1 {
 			} });
 			return;
 		}
+		this.detachStateListener();
 		const onState = () => {
 			try {
 				this.recomputeSlice();
@@ -25850,7 +26169,7 @@ var GreeContainerDevice = class extends BaseDevice$1 {
 		return [{
 			stableIdSuffix: "ac",
 			meta: {
-				type: DeviceType.Thermostat,
+				type: DeviceType.Climate,
 				name: this.name,
 				linkDeviceId: this.id,
 				...this.integrationId !== void 0 ? { integrationId: this.integrationId } : {}
@@ -25936,9 +26255,10 @@ var GreeContainerDevice = class extends BaseDevice$1 {
 * `instanceMode: multiple` — many ACs may be added. Placement: any-node — Gree is
 * LOCAL UDP; the addon runs on whichever node shares the AC's subnet.
 *
-* LAN UDP-broadcast auto-discovery of multiple ACs is deliberately NOT
-* implemented here — that is the later Discovery-cap phase. Phase 1 is
-* add-one-AC-by-IP with a directed bind.
+* LAN UDP-broadcast auto-discovery is implemented via the `device-provider`
+* discovery surface (`supportsDiscovery`/`discoverDevices`/`adoptDiscoveredDevice`)
+* — the same one ONVIF uses and the aggregated "Scan network" modal fans out to.
+* Manual add-one-AC-by-IP (directed bind) remains available in parallel.
 */
 var GreeProviderAddon = class extends BaseDeviceProvider {
 	addonId = "provider-gree";
@@ -25948,7 +26268,41 @@ var GreeProviderAddon = class extends BaseDeviceProvider {
 		super({});
 	}
 	async supportsDiscovery() {
-		return false;
+		return true;
+	}
+	async getDiscoveryParamsSchema() {
+		return buildDiscoveryParamsFormSchema();
+	}
+	async discoverDevices(input) {
+		const broadcastAddress = typeof input?.params?.["broadcastAddress"] === "string" ? input.params["broadcastAddress"].trim() : void 0;
+		const timeoutMs = typeof input?.params?.["timeoutMs"] === "number" ? input.params["timeoutMs"] : void 0;
+		const responders = await discoverGreeDevices({
+			...broadcastAddress ? { broadcastAddress } : {},
+			...timeoutMs ? { timeoutMs } : {}
+		});
+		this.ctx.logger.info("Gree discovery complete", { meta: {
+			count: responders.length,
+			broadcastAddress: broadcastAddress ?? "local"
+		} });
+		return responders.map((d) => {
+			const displayName = d.name.length > 0 ? d.name : d.mac;
+			return {
+				stableId: `gree:${macKey(d.mac)}`,
+				type: DeviceType.Container,
+				suggestedName: displayName,
+				prefilledConfig: {
+					name: displayName,
+					host: d.ip,
+					...d.model !== void 0 ? { model: d.model } : {}
+				}
+			};
+		});
+	}
+	async adoptDiscoveredDevice(input) {
+		return this.createDevice({
+			type: DeviceType.Container,
+			config: input.candidate.prefilledConfig
+		});
 	}
 	async supportsManualCreation() {
 		return true;

package/dist/addon.mjs

@@ -4644,7 +4644,7 @@ function preprocess(fn, schema) {
 	});
 }
 //#endregion
-//#region ../types/dist/sleep-B3AOslwX.mjs
+//#region ../types/dist/sleep-C2M2zF7x.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -6212,6 +6212,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["Switch"] = "switch";
 	DeviceType["Sensor"] = "sensor";
 	DeviceType["Thermostat"] = "thermostat";
+	/** Air-conditioner / heat-pump climate device (HVAC) — shares the
+	*  `climate-control` cap surface with `Thermostat` but renders a
+	*  dedicated AC-appropriate control UI (mode chips, fan speed,
+	*  independent vertical/horizontal swing). Sources: native Gree, and
+	*  reusable by other AC integrations. */
+	DeviceType["Climate"] = "climate";
 	DeviceType["Button"] = "button";
 	/** Generic stateless event emitter — carries a device's EXACT declared
 	*  event vocabulary verbatim (no normalization). Installed with the
@@ -9007,7 +9013,7 @@ var climateControlCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Thermostat, DeviceType.Climate],
 	methods: {
 		setMode: method(object({
 			deviceId: number().int().nonnegative(),
@@ -13606,10 +13612,30 @@ var deviceProviderCapability = {
 			type: string()
 		}))),
 		supportsDiscovery: method(object({}), boolean()),
-		discoverDevices: method(object({}), array(DiscoveryCandidateSchema), {
+		/**
+		* Run a network scan. `params` carries optional provider-specific scan
+		* inputs (e.g. a broadcast address / subnet for cross-subnet discovery),
+		* shaped by `getDiscoveryParamsSchema`. Omitted for the generic scan
+		* (provider uses its local-network default).
+		*/
+		discoverDevices: method(object({ params: record(string(), unknown()).optional() }), array(DiscoveryCandidateSchema), {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Optional form schema (`ConfigUISchema`) for the EXTRA per-scan inputs a
+		* provider accepts (e.g. Gree's broadcast address for a different subnet).
+		* `null` when the provider takes no extra scan params — the generic
+		* aggregated scan never renders this; the per-integration scan does.
+		*/
+		getDiscoveryParamsSchema: method(object({}), CreationSchemaOutputSchema),
+		/**
+		* The DeviceType this provider creates via manual add (Camera for
+		* Reolink/ONVIF, Container for Gree, Hub for Ecowitt). `null` when the
+		* provider does not support manual creation. Lets the Add-Device dialog
+		* pick the right type instead of assuming Camera.
+		*/
+		getManualCreationType: method(object({}), object({ deviceType: _enum(DeviceType).nullable() })),
 		adoptDiscoveredDevice: method(object({ candidate: DiscoveryCandidateSchema }), DeviceSummarySchema, {
 			kind: "mutation",
 			auth: "admin"
@@ -13733,9 +13759,23 @@ var BaseDeviceProvider = class extends BaseAddon {
 	async supportsDiscovery() {
 		return false;
 	}
-	async discoverDevices() {
+	async discoverDevices(_input) {
 		return [];
 	}
+	/** Extra per-scan input form (e.g. a broadcast address for another subnet).
+	*  Null = no extra params. Override in providers that support scoped scans. */
+	async getDiscoveryParamsSchema() {
+		return null;
+	}
+	/**
+	* The DeviceType this provider creates via manual add — derived from the
+	* `deviceClasses` map (first registered type). `null` when manual creation is
+	* unsupported. Lets the Add-Device dialog pick the right type per provider.
+	*/
+	async getManualCreationType() {
+		if (!await this.supportsManualCreation()) return { deviceType: null };
+		return { deviceType: Object.values(DeviceType).find((t) => this.deviceClasses[t] !== void 0) ?? null };
+	}
 	async adoptDiscoveredDevice(_input) {
 		throw new Error(`${this.providerName} provider does not support discovery-based adoption`);
 	}
@@ -15580,7 +15620,10 @@ method(object({
 }), FieldProbeResultSchema, {
 	kind: "mutation",
 	auth: "admin"
-}), method(ListCandidatesInputSchema.extend({ addonId: string() }), ListCandidatesOutputSchema, { auth: "admin" }), method(object({
+}), method(object({
+	addonId: string(),
+	integrationId: string()
+}), object({ filters: array(AdoptionFilterSchema) }), { auth: "admin" }), method(ListCandidatesInputSchema.extend({ addonId: string() }), ListCandidatesOutputSchema, { auth: "admin" }), method(object({
 	addonId: string(),
 	integrationId: string()
 }), AdoptionStatusSchema, {
@@ -15595,7 +15638,24 @@ method(object({
 }), method(ResyncInputSchema, ResyncResultSchema, {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({}), object({ providers: array(object({
+	addonId: string(),
+	label: string()
+})).readonly() }), { auth: "admin" }), method(object({}), object({ groups: array(object({
+	addonId: string(),
+	label: string(),
+	candidates: array(DiscoveryCandidateSchema).readonly(),
+	error: string().nullable()
+})).readonly() }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
+	addonId: string(),
+	params: record(string(), unknown()).optional()
+}), object({ candidates: array(DiscoveryCandidateSchema).readonly() }), {
+	kind: "mutation",
+	auth: "admin"
+}), method(object({ addonId: string() }), object({ deviceType: _enum(DeviceType).nullable() }), { auth: "admin" }), method(object({ addonId: string() }), unknown(), { auth: "admin" }), method(object({
 	deviceId: number(),
 	key: string(),
 	value: unknown()
@@ -20718,6 +20778,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.adoptionListCandidateFilters": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.adoptionListCandidates": {
 		capName: "device-manager",
 		capScope: "system",
@@ -20766,12 +20832,30 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.discoverAllProviders": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"deviceManager.discoverDevices": {
 		capName: "device-manager",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.discoverProvider": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
+	"deviceManager.discoveryProviders": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.enable": {
 		capName: "device-manager",
 		capScope: "system",
@@ -20922,6 +21006,18 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceManager.providerCreationType": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"deviceManager.providerDiscoveryParamsSchema": {
+		capName: "device-manager",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceManager.registerDevice": {
 		capName: "device-manager",
 		capScope: "system",
@@ -21138,6 +21234,18 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceProvider.getDiscoveryParamsSchema": {
+		capName: "device-provider",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
+	"deviceProvider.getManualCreationType": {
+		capName: "device-provider",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceProvider.getStatus": {
 		capName: "device-provider",
 		capScope: "system",
@@ -24127,6 +24235,34 @@ function buildConnectionFormSchema() {
 		]
 	}] };
 }
+/**
+* Extra params form for a PER-INTEGRATION network scan. Gree's UDP broadcast
+* only reaches the addon node's local subnet; to find ACs on a DIFFERENT subnet
+* (e.g. 192.168.20.x) the operator supplies that subnet's directed-broadcast
+* address (192.168.20.255). Empty = default local-subnet broadcast.
+*/
+function buildDiscoveryParamsFormSchema() {
+	return { sections: [{
+		id: "scan",
+		title: "Scan options",
+		description: "Leave empty to scan the local subnet. To find air conditioners on a different subnet, enter that subnet’s broadcast address (e.g. 192.168.20.255).",
+		columns: 1,
+		fields: [{
+			type: "text",
+			key: "broadcastAddress",
+			label: "Broadcast address",
+			required: false,
+			placeholder: "192.168.20.255"
+		}, {
+			type: "number",
+			key: "timeoutMs",
+			label: "UDP timeout (ms)",
+			min: 500,
+			max: 3e4,
+			default: 3e3
+		}]
+	}] };
+}
 //#endregion
 //#region ../../node_modules/@apocaliss92/nodegree/dist/index.js
 var GreeError = class extends Error {
@@ -24828,6 +24964,16 @@ function macKey(mac) {
 */
 var GreeConnectionResolver = class {
 	#surfaces = /* @__PURE__ */ new Map();
+	/**
+	* Per-connection "surface (re)published" subscribers. An AC accessory child
+	* activates from `restoreDevices` BEFORE its parent's manager finishes the
+	* async bind, so `getDevice` is null at `onActivate` time and its
+	* `stateChanged` listener never attaches → the climate slice stays frozen at
+	* cold-start (`lastFetchedAt: 0`, no temperature). Children subscribe here and
+	* (re)attach + recompute once the handle is published. A plain `Set` has no
+	* listener cap. Mirrors the Ecowitt facade-resolver fan-out.
+	*/
+	#subs = /* @__PURE__ */ new Map();
 	/** Publish or remove the connection surface for a connection key. `null` removes. */
 	set(connectionKey, surface) {
 		if (surface === null) {
@@ -24835,6 +24981,24 @@ var GreeConnectionResolver = class {
 			return;
 		}
 		this.#surfaces.set(connectionKey, surface);
+		const subs = this.#subs.get(connectionKey);
+		if (subs) for (const cb of subs) try {
+			cb();
+		} catch {}
+	}
+	/** Subscribe to surface (re)publish for a connection key. Returns unsubscribe. */
+	onSurface(connectionKey, cb) {
+		let set = this.#subs.get(connectionKey);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.#subs.set(connectionKey, set);
+		}
+		set.add(cb);
+		return () => {
+			const current = this.#subs.get(connectionKey);
+			current?.delete(cb);
+			if (current && current.size === 0) this.#subs.delete(connectionKey);
+		};
 	}
 	/** The bind-scan rows for a connection key, or empty when unknown. */
 	discovered(connectionKey) {
@@ -24858,6 +25022,7 @@ var GreeConnectionResolver = class {
 	/** Remove all registered surfaces (called on full shutdown). */
 	clear() {
 		this.#surfaces.clear();
+		this.#subs.clear();
 	}
 };
 /** The single in-process per-connection resolver shared between the AC device's
@@ -24868,7 +25033,7 @@ var greeConnections = new GreeConnectionResolver();
 function defaultFacade(config) {
 	return new Nodegree(toNodegreeOptions(config));
 }
-var DEFAULT_POLL_INTERVAL_MS = 3e4;
+var DEFAULT_POLL_INTERVAL_MS = 1e4;
 /**
 * Wraps exactly one `@apocaliss92/nodegree` facade bound to a SINGLE Gree AC
 * (standalone mode — the connection lives on the AC device). {@link start} runs a
@@ -25067,6 +25232,27 @@ function resolveBroadcastTarget(connection) {
 * The returned identity is what {@link import('./config.js').greeAcDeviceSchema}
 * persists on the new device; the live per-device manager re-binds on activate.
 */
+/**
+* One-shot LAN broadcast scan for Gree ACs — the network-discovery pass. Builds a
+* throwaway facade from default (or provided) UDP settings, runs the broadcast,
+* and returns every responder. No bind, no persistence. The provider's
+* `discoverDevices()` maps the responders to adoption candidates.
+*/
+async function discoverGreeDevices(input) {
+	const connection = settingsToGreeConfig({
+		...input.broadcastAddress ? { broadcastAddr: input.broadcastAddress } : {},
+		...input.timeoutMs ? { timeoutMs: input.timeoutMs } : {}
+	});
+	const facade = (input.makeFacade ?? defaultFacade)(connection);
+	try {
+		const broadcast = resolveBroadcastTarget(connection);
+		const opts = { timeoutMs: connection.timeoutMs };
+		if (broadcast.length > 0) opts.broadcastAddr = broadcast;
+		return await facade.discover(opts);
+	} finally {
+		await facade.close().catch(() => void 0);
+	}
+}
 async function bindOnce(input) {
 	const { connection, logger } = input;
 	const facade = (input.makeFacade ?? defaultFacade)(connection);
@@ -25365,7 +25551,19 @@ var greeAcSchema = object({
 	greeMac: string().min(1).describe("Gree AC MAC address"),
 	connectionKey: string().min(1).describe("Per-device connection resolver key"),
 	system: literal("gree").optional(),
-	integrationId: string().optional()
+	integrationId: string().optional(),
+	/** Operator filter — HVAC modes exposed in the control UI (subset of the
+	*  model's supported modes). Empty / omitted ⇒ expose all. `off` is always
+	*  exposed (power). */
+	enabledModes: array(string()).optional(),
+	/** Operator filter — fan speeds exposed in the control UI (subset of
+	*  `GREE_FAN_MODES`). Empty / omitted ⇒ expose all. */
+	enabledFanModes: array(string()).optional(),
+	/** Operator filter — expose the vertical-swing toggle. Default true. */
+	exposeVerticalSwing: boolean().optional(),
+	/** Operator filter — expose the horizontal-swing toggle (model-permitting).
+	*  Default true. */
+	exposeHorizontalSwing: boolean().optional()
 });
 /**
 * One Gree air conditioner as a CamStack `Thermostat`-type accessory child.
@@ -25405,17 +25603,16 @@ var GreeAcDevice = class extends BaseDevice$1 {
 	*/
 	get features() {
 		const caps = this.resolveAc()?.capabilities ?? getAcCapabilities();
-		const flags = [
-			DeviceFeature.ClimateFanMode,
-			DeviceFeature.ClimatePreset,
-			DeviceFeature.ClimateSwingVertical
-		];
-		if (caps.horizontalSwing) flags.push(DeviceFeature.ClimateSwingHorizontal);
+		const cfg = this.config.values;
+		const flags = [DeviceFeature.ClimateFanMode, DeviceFeature.ClimatePreset];
+		if (cfg.exposeVerticalSwing ?? true) flags.push(DeviceFeature.ClimateSwingVertical);
+		if (caps.horizontalSwing && (cfg.exposeHorizontalSwing ?? true)) flags.push(DeviceFeature.ClimateSwingHorizontal);
 		return flags;
 	}
 	greeMac;
 	connectionKey;
 	stateChangedUnsub = null;
+	surfaceUnsub = null;
 	constructor(ctx) {
 		const persisted = greeAcSchema.parse(ctx.persistedConfig ?? {});
 		super(ctx, greeAcSchema, { type: ctx.deviceMeta.type });
@@ -25440,8 +25637,21 @@ var GreeAcDevice = class extends BaseDevice$1 {
 		this.registerCaps();
 		this.attachStateListener();
 		this.recomputeSlices();
+		this.surfaceUnsub = greeConnections.onSurface(this.connectionKey, () => {
+			this.attachStateListener();
+			this.recomputeSlices();
+		});
 	}
 	async removeDevice() {
+		this.detachStateListener();
+		if (this.surfaceUnsub) {
+			try {
+				this.surfaceUnsub();
+			} catch {}
+			this.surfaceUnsub = null;
+		}
+	}
+	detachStateListener() {
 		if (this.stateChangedUnsub) {
 			try {
 				this.stateChangedUnsub();
@@ -25449,12 +25659,16 @@ var GreeAcDevice = class extends BaseDevice$1 {
 			this.stateChangedUnsub = null;
 		}
 	}
+	/** Attach the live `stateChanged` listener to the bound AC handle. Idempotent:
+	*  drops any prior listener first, so it is safe to call on every surface
+	*  (re)publish. No-op until the handle is actually bound. */
 	attachStateListener() {
 		const ac = this.resolveAc();
 		if (!ac) {
 			this.ctx.logger.debug("GreeAcDevice: handle not present; no live listener yet", { meta: { greeMac: this.greeMac } });
 			return;
 		}
+		this.detachStateListener();
 		const onState = () => {
 			try {
 				this.recomputeSlices();
@@ -25472,7 +25686,7 @@ var GreeAcDevice = class extends BaseDevice$1 {
 	}
 	registerCaps() {
 		this.ctx.registerNativeCap(climateControlCapability, {
-			getStatus: async () => this.runtimeState.getCapState(CLIMATE_CAP) ?? CLIMATE_COLD_START,
+			getStatus: async () => this.runtimeState.getCapState(CLIMATE_CAP) ?? this.applyClimateFilters(CLIMATE_COLD_START),
 			setMode: async ({ mode }) => {
 				const ac = this.requireAc();
 				const libMode = capModeToLibMode(mode);
@@ -25519,7 +25733,7 @@ var GreeAcDevice = class extends BaseDevice$1 {
 				await ac.setSwingHorizontal(boolToHorizontalSwing(on));
 			}
 		});
-		this.runtimeState.setCapState(CLIMATE_CAP, CLIMATE_COLD_START);
+		this.runtimeState.setCapState(CLIMATE_CAP, this.applyClimateFilters(CLIMATE_COLD_START));
 		this.ctx.registerNativeCap(fanControlCapability, {
 			getStatus: async () => this.runtimeState.getCapState(FAN_CAP) ?? FAN_COLD_START,
 			setPercentage: async ({ percentage }) => {
@@ -25566,7 +25780,7 @@ var GreeAcDevice = class extends BaseDevice$1 {
 			swingHorizontal: ac.capabilities.horizontalSwing ? horizontalSwingToBool(ac.swingHorizontal) : null,
 			lastFetchedAt: now
 		};
-		this.runtimeState.setCapState(CLIMATE_CAP, climateSlice);
+		this.runtimeState.setCapState(CLIMATE_CAP, this.applyClimateFilters(climateSlice));
 		const fanSlice = {
 			percentage: fanSpeedToPercentage(ac.fanSpeed),
 			percentageStep: GREE_FAN_PERCENTAGE_STEP,
@@ -25578,7 +25792,97 @@ var GreeAcDevice = class extends BaseDevice$1 {
 		};
 		this.runtimeState.setCapState(FAN_CAP, fanSlice);
 	}
+	/**
+	* Apply the operator's per-AC exposure filters to a climate slice: narrow
+	* `availableModes` / `availableFanModes` to the enabled subsets (empty ⇒ all;
+	* `off` is always kept) and null out a swing axis the operator has hidden.
+	* Pure — returns a new slice, never mutates the input.
+	*/
+	applyClimateFilters(slice) {
+		const cfg = this.config.values;
+		const enabledModes = cfg.enabledModes;
+		const enabledFanModes = cfg.enabledFanModes;
+		const exposeV = cfg.exposeVerticalSwing ?? true;
+		const exposeH = cfg.exposeHorizontalSwing ?? true;
+		const availableModes = enabledModes && enabledModes.length > 0 ? slice.availableModes.filter((m) => m === "off" || enabledModes.includes(m)) : slice.availableModes;
+		const availableFanModes = enabledFanModes && enabledFanModes.length > 0 ? slice.availableFanModes.filter((f) => enabledFanModes.includes(f)) : slice.availableFanModes;
+		return {
+			...slice,
+			availableModes,
+			availableFanModes,
+			swingVertical: exposeV ? slice.swingVertical : null,
+			swingHorizontal: exposeH ? slice.swingHorizontal : null
+		};
+	}
+	/**
+	* Per-AC exposure form (device-details settings). Lets the operator pick
+	* which modes / fan speeds / swing axes appear in the AC control UI. An empty
+	* multiselect means "expose all". The horizontal-swing toggle is only offered
+	* when the model advertises horizontal swing.
+	*/
+	getSettingsUISchema() {
+		const supportsHSwing = (this.resolveAc()?.capabilities ?? getAcCapabilities()).horizontalSwing;
+		const cfg = this.config.values;
+		const fields = [
+			{
+				type: "multiselect",
+				key: "enabledModes",
+				label: "Modes",
+				description: "Modes shown in the control UI. Empty = all. “Off” is always available.",
+				options: SUPPORTED_CAP_MODES.map((m) => ({
+					value: m,
+					label: titleCase(m)
+				}))
+			},
+			{
+				type: "multiselect",
+				key: "enabledFanModes",
+				label: "Fan speeds",
+				description: "Fan speeds shown in the control UI. Empty = all.",
+				options: GREE_FAN_MODES.map((f) => ({
+					value: f,
+					label: titleCase(f)
+				}))
+			},
+			{
+				type: "boolean",
+				style: "switch",
+				key: "exposeVerticalSwing",
+				label: "Vertical swing",
+				default: true
+			}
+		];
+		if (supportsHSwing) fields.push({
+			type: "boolean",
+			style: "switch",
+			key: "exposeHorizontalSwing",
+			label: "Horizontal swing",
+			default: true
+		});
+		return hydrateSchema({ sections: [{
+			id: "exposure",
+			title: "Exposed controls",
+			description: "Choose which modes, fan speeds and swing axes appear in the air-conditioner control UI.",
+			fields
+		}] }, {
+			enabledModes: cfg.enabledModes ?? [],
+			enabledFanModes: cfg.enabledFanModes ?? [],
+			exposeVerticalSwing: cfg.exposeVerticalSwing ?? true,
+			exposeHorizontalSwing: cfg.exposeHorizontalSwing ?? true
+		});
+	}
+	async applySettingsPatch(patch) {
+		const typed = greeAcSchema.partial().parse(patch);
+		await this.config.setAll(typed);
+		this.recomputeSlices();
+		await this.refreshFeatures();
+	}
 };
+/** 'fan_only' → 'Fan only', 'medium_low' → 'Medium low'. Pure. */
+function titleCase(value) {
+	const spaced = value.replace(/_/g, " ");
+	return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
 //#endregion
 //#region src/devices/gree-toggle-device.ts
 var SWITCH_CAP = "switch";
@@ -25621,6 +25925,7 @@ var GreeToggleDevice = class extends BaseDevice$1 {
 	greeMac;
 	connectionKey;
 	stateChangedUnsub = null;
+	surfaceUnsub = null;
 	constructor(ctx) {
 		const persisted = greeToggleSchema.parse(ctx.persistedConfig ?? {});
 		super(ctx, greeToggleSchema, { type: ctx.deviceMeta.type });
@@ -25672,8 +25977,21 @@ var GreeToggleDevice = class extends BaseDevice$1 {
 		this.registerCap();
 		this.attachStateListener();
 		this.recomputeSlice();
+		this.surfaceUnsub = greeConnections.onSurface(this.connectionKey, () => {
+			this.attachStateListener();
+			this.recomputeSlice();
+		});
 	}
 	async removeDevice() {
+		this.detachStateListener();
+		if (this.surfaceUnsub) {
+			try {
+				this.surfaceUnsub();
+			} catch {}
+			this.surfaceUnsub = null;
+		}
+	}
+	detachStateListener() {
 		if (this.stateChangedUnsub) {
 			try {
 				this.stateChangedUnsub();
@@ -25690,6 +26008,7 @@ var GreeToggleDevice = class extends BaseDevice$1 {
 			} });
 			return;
 		}
+		this.detachStateListener();
 		const onState = () => {
 			try {
 				this.recomputeSlice();
@@ -25849,7 +26168,7 @@ var GreeContainerDevice = class extends BaseDevice$1 {
 		return [{
 			stableIdSuffix: "ac",
 			meta: {
-				type: DeviceType.Thermostat,
+				type: DeviceType.Climate,
 				name: this.name,
 				linkDeviceId: this.id,
 				...this.integrationId !== void 0 ? { integrationId: this.integrationId } : {}
@@ -25935,9 +26254,10 @@ var GreeContainerDevice = class extends BaseDevice$1 {
 * `instanceMode: multiple` — many ACs may be added. Placement: any-node — Gree is
 * LOCAL UDP; the addon runs on whichever node shares the AC's subnet.
 *
-* LAN UDP-broadcast auto-discovery of multiple ACs is deliberately NOT
-* implemented here — that is the later Discovery-cap phase. Phase 1 is
-* add-one-AC-by-IP with a directed bind.
+* LAN UDP-broadcast auto-discovery is implemented via the `device-provider`
+* discovery surface (`supportsDiscovery`/`discoverDevices`/`adoptDiscoveredDevice`)
+* — the same one ONVIF uses and the aggregated "Scan network" modal fans out to.
+* Manual add-one-AC-by-IP (directed bind) remains available in parallel.
 */
 var GreeProviderAddon = class extends BaseDeviceProvider {
 	addonId = "provider-gree";
@@ -25947,7 +26267,41 @@ var GreeProviderAddon = class extends BaseDeviceProvider {
 		super({});
 	}
 	async supportsDiscovery() {
-		return false;
+		return true;
+	}
+	async getDiscoveryParamsSchema() {
+		return buildDiscoveryParamsFormSchema();
+	}
+	async discoverDevices(input) {
+		const broadcastAddress = typeof input?.params?.["broadcastAddress"] === "string" ? input.params["broadcastAddress"].trim() : void 0;
+		const timeoutMs = typeof input?.params?.["timeoutMs"] === "number" ? input.params["timeoutMs"] : void 0;
+		const responders = await discoverGreeDevices({
+			...broadcastAddress ? { broadcastAddress } : {},
+			...timeoutMs ? { timeoutMs } : {}
+		});
+		this.ctx.logger.info("Gree discovery complete", { meta: {
+			count: responders.length,
+			broadcastAddress: broadcastAddress ?? "local"
+		} });
+		return responders.map((d) => {
+			const displayName = d.name.length > 0 ? d.name : d.mac;
+			return {
+				stableId: `gree:${macKey(d.mac)}`,
+				type: DeviceType.Container,
+				suggestedName: displayName,
+				prefilledConfig: {
+					name: displayName,
+					host: d.ip,
+					...d.model !== void 0 ? { model: d.model } : {}
+				}
+			};
+		});
+	}
+	async adoptDiscoveredDevice(input) {
+		return this.createDevice({
+			type: DeviceType.Container,
+			config: input.candidate.prefilledConfig
+		});
 	}
 	async supportsManualCreation() {
 		return true;

package/dist/index.js

@@ -18,7 +18,7 @@ function buildGreeCandidates(input) {
 		out.push({
 			childNativeId: macKey(device.mac),
 			name: device.name.length > 0 ? device.name : device.mac,
-			type: require_addon.DeviceType.Thermostat,
+			type: require_addon.DeviceType.Climate,
 			status: "online",
 			metadata: {
 				serialNumber: device.mac,

package/dist/index.mjs

@@ -17,7 +17,7 @@ function buildGreeCandidates(input) {
 		out.push({
 			childNativeId: macKey(device.mac),
 			name: device.name.length > 0 ? device.name : device.mac,
-			type: DeviceType.Thermostat,
+			type: DeviceType.Climate,
 			status: "online",
 			metadata: {
 				serialNumber: device.mac,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-gree",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "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",