@camstack/addon-provider-bosch 0.1.32 → 0.1.34

package/dist/shc/addon.mjs

@@ -1,4 +1,4 @@
-import { A as customAction, C as switchCapability, D as DeviceType, F as array, L as literal, O as errMsg, P as _enum, R as number, V as string, W as EventCategory, f as deviceAdoptionCapability, g as heatingValveCapability, j as defineCustomActions, l as climateControlCapability, n as BaseDeviceProvider, s as batteryCapability, t as BaseDevice, u as connectionTestCapability, w as temperatureSensorCapability, z as object } from "../dist-n4Mk3Uu1.mjs";
+import { A as customAction, C as switchCapability, D as DeviceType, F as array, L as literal, O as errMsg, P as _enum, R as number, V as string, W as EventCategory, f as deviceAdoptionCapability, g as heatingValveCapability, j as defineCustomActions, l as climateControlCapability, n as BaseDeviceProvider, s as batteryCapability, t as BaseDevice, u as connectionTestCapability, w as temperatureSensorCapability, z as object } from "../dist-BV6iLwfA.mjs";
 import { createRequire } from "node:module";
 import { randomUUID } from "node:crypto";
 import { request } from "node:https";
@@ -6,7 +6,6 @@ import { execFileSync } from "node:child_process";
 import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { createSocket } from "node:dgram";
 import { connect } from "node:net";
 //#region \0rolldown/runtime.js
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
@@ -333,78 +332,18 @@ async function registerShcClient(deps) {
 }
 //#endregion
 //#region src/shc/shc-controller-discovery.ts
-/** `prefilledConfig` flag: the scan opens the integration form instead of adopting a device. */
-var SHC_SETUP_INTEGRATION_KEY = "setupIntegration";
-/** Top bit of the question class: ask for a unicast reply (RFC 6762). */
-var MDNS_QU_CLASS = 32769;
-var SHC_MDNS_SERVICE = "_http._tcp.local";
+/** The controller announces itself as an `_http._tcp` service named `Bosch SHC`. */
+var SHC_MDNS_SERVICE = "_http._tcp";
 var SHC_CONTROLLER_NAME_PREFIX = "Bosch SHC";
-var SHC_DISCOVERY_TIMEOUT_MS = 1500;
-var MDNS_PORT = 5353;
-var MDNS_ADDRESS = "224.0.0.251";
-var PTR = 12;
-var A = 1;
-var SRV = 33;
+/** How the scan engine finds a controller: one mDNS browse, filtered on the instance name. */
+var SHC_DISCOVERY_MODES = [{
+	kind: "mdns",
+	serviceType: SHC_MDNS_SERVICE,
+	instancePattern: `^${SHC_CONTROLLER_NAME_PREFIX}`
+}];
 function isShcControllerName(name) {
 	return (name.split("._")[0] ?? name).toLowerCase().startsWith(SHC_CONTROLLER_NAME_PREFIX.toLowerCase());
 }
-function readName(buf, start) {
-	const labels = [];
-	let pos = start;
-	let end = start;
-	let jumped = false;
-	for (let hops = 0; hops < 16; hops++) {
-		if (pos < 0 || pos >= buf.length) return null;
-		const len = buf[pos] ?? 0;
-		if (len === 0) {
-			if (!jumped) end = pos + 1;
-			return {
-				name: labels.join("."),
-				end
-			};
-		}
-		if ((len & 192) === 192) {
-			if (pos + 1 >= buf.length) return null;
-			if (!jumped) end = pos + 2;
-			jumped = true;
-			pos = (len & 63) << 8 | (buf[pos + 1] ?? 0);
-			continue;
-		}
-		if ((len & 192) !== 0 || pos + 1 + len > buf.length) return null;
-		labels.push(buf.subarray(pos + 1, pos + 1 + len).toString("utf8"));
-		pos += 1 + len;
-		if (!jumped) end = pos;
-	}
-	return null;
-}
-function readRecords(buf, offset, count) {
-	const records = [];
-	let pos = offset;
-	for (let i = 0; i < count; i++) {
-		const name = readName(buf, pos);
-		if (name === null || name.end + 10 > buf.length) return null;
-		const type = buf.readUInt16BE(name.end);
-		const dataLength = buf.readUInt16BE(name.end + 8);
-		const dataOffset = name.end + 10;
-		if (dataOffset + dataLength > buf.length) return null;
-		records.push({
-			name: name.name,
-			type,
-			message: buf,
-			dataOffset,
-			dataLength
-		});
-		pos = dataOffset + dataLength;
-	}
-	return {
-		records,
-		next: pos
-	};
-}
-function ipv4(buf, offset, length) {
-	if (length !== 4 || offset + 4 > buf.length) return null;
-	return `${buf[offset] ?? 0}.${buf[offset + 1] ?? 0}.${buf[offset + 2] ?? 0}.${buf[offset + 3] ?? 0}`;
-}
 /** Identity used to recognise a controller already stored on an integration. */
 function shcControllerId(input) {
 	const service = input.serviceHost?.trim().toLowerCase() ?? "";
@@ -413,40 +352,24 @@ function shcControllerId(input) {
 	if (serial.length > 0) return serial;
 	return input.host;
 }
-function hostsFromRecords(records) {
-	const instances = [];
-	const srv = /* @__PURE__ */ new Map();
-	const addresses = /* @__PURE__ */ new Map();
-	for (const rec of records) {
-		const key = rec.name.toLowerCase();
-		if (rec.type === PTR) {
-			const target = readName(rec.message, rec.dataOffset);
-			if (target !== null && isShcControllerName(target.name)) instances.push(target.name);
-		} else if (rec.type === SRV && rec.dataLength >= 6) {
-			const target = readName(rec.message, rec.dataOffset + 6);
-			if (target !== null) srv.set(key, target.name);
-		} else if (rec.type === A) {
-			const ip = ipv4(rec.message, rec.dataOffset, rec.dataLength);
-			if (ip !== null) addresses.set(key, ip);
-		}
-	}
+/** Controllers among the engine's mDNS hits (a `Bosch SHC…` instance), one per host. */
+function shcHostsFromHits(hits) {
 	const out = [];
 	const seen = /* @__PURE__ */ new Set();
-	for (const instance of instances) {
-		const viaSrv = srv.get(instance.toLowerCase());
-		const host = (viaSrv !== void 0 ? addresses.get(viaSrv.toLowerCase()) : void 0) ?? addresses.get(instance.toLowerCase());
-		if (host === void 0 || seen.has(host)) continue;
-		seen.add(host);
-		const label = instance.split("._")[0] ?? instance;
-		const id = shcControllerId({
-			name: label,
-			host,
-			...viaSrv !== void 0 ? { serviceHost: viaSrv } : {}
-		});
+	for (const hit of hits) {
+		const mdns = hit.mdns;
+		if (mdns === void 0 || !isShcControllerName(mdns.instance)) continue;
+		if (hit.host.length === 0 || seen.has(hit.host)) continue;
+		seen.add(hit.host);
+		const name = mdns.instance.split("._")[0] ?? mdns.instance;
 		out.push({
-			host,
-			name: label,
-			id
+			host: hit.host,
+			name,
+			id: shcControllerId({
+				name,
+				host: hit.host,
+				serviceHost: mdns.host
+			})
 		});
 	}
 	return out;
@@ -466,11 +389,10 @@ function proposeShcControllers(found, existingHosts) {
 function shcDiscoveryCandidates(proposals) {
 	return proposals.map((found) => ({
 		stableId: `bosch-shc:${found.id}`,
+		type: DeviceType.Gateway,
 		suggestedName: found.name,
-		prefilledConfig: {
-			host: found.host,
-			[SHC_SETUP_INTEGRATION_KEY]: true
-		}
+		prefilledConfig: { host: found.host },
+		setupIntegration: true
 	}));
 }
 function shcDiscoverySummary(foundCount, proposedCount) {
@@ -478,101 +400,6 @@ function shcDiscoverySummary(foundCount, proposedCount) {
 	if (proposedCount === 0) return "No controller found on the network.";
 	return `Found ${proposedCount} ${proposedCount === 1 ? "controller" : "controllers"}.`;
 }
-/** Hosts advertised as a Bosch Smart Home Controller on one mDNS message. */
-function shcHostsFromDnsMessage(buf) {
-	if (buf.length < 12) return [];
-	const questions = buf.readUInt16BE(4);
-	const answers = buf.readUInt16BE(6);
-	const authorities = buf.readUInt16BE(8);
-	const extra = buf.readUInt16BE(10);
-	let pos = 12;
-	for (let i = 0; i < questions; i++) {
-		const name = readName(buf, pos);
-		if (name === null) return [];
-		pos = name.end + 4;
-		if (pos > buf.length) return [];
-	}
-	const answerRecords = readRecords(buf, pos, answers);
-	if (answerRecords === null) return [];
-	const authorityRecords = readRecords(buf, answerRecords.next, authorities);
-	if (authorityRecords === null) return [];
-	const extraRecords = readRecords(buf, authorityRecords.next, extra);
-	if (extraRecords === null) return [];
-	return hostsFromRecords([
-		...answerRecords.records,
-		...authorityRecords.records,
-		...extraRecords.records
-	]);
-}
-function mdnsPtrQuery(service) {
-	const encoded = service.split(".").filter((part) => part.length > 0).map((label) => Buffer.concat([Buffer.from([label.length]), Buffer.from(label)]));
-	const header = Buffer.alloc(12);
-	header.writeUInt16BE(1, 4);
-	const tail = Buffer.alloc(4);
-	tail.writeUInt16BE(PTR, 0);
-	tail.writeUInt16BE(MDNS_QU_CLASS, 2);
-	return Buffer.concat([
-		header,
-		...encoded,
-		Buffer.from([0]),
-		tail
-	]);
-}
-function closeQuietly(socket) {
-	try {
-		socket.close();
-	} catch {}
-}
-function exchangeMdns(query, timeoutMs) {
-	return new Promise((resolve) => {
-		let socket;
-		try {
-			socket = createSocket({
-				type: "udp4",
-				reuseAddr: true
-			});
-		} catch {
-			resolve([]);
-			return;
-		}
-		const packets = [];
-		let settled = false;
-		const finish = () => {
-			if (settled) return;
-			settled = true;
-			closeQuietly(socket);
-			resolve(packets);
-		};
-		socket.on("error", () => finish());
-		socket.on("message", (msg) => {
-			packets.push(Buffer.from(msg));
-		});
-		socket.bind(0, () => {
-			try {
-				socket.send(query, MDNS_PORT, MDNS_ADDRESS);
-			} catch {
-				finish();
-			}
-		});
-		setTimeout(finish, timeoutMs);
-	});
-}
-async function browseShcControllers(exchange = exchangeMdns) {
-	let packets;
-	try {
-		packets = await exchange(mdnsPtrQuery(SHC_MDNS_SERVICE), SHC_DISCOVERY_TIMEOUT_MS);
-	} catch {
-		return [];
-	}
-	const hosts = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const packet of packets) for (const found of shcHostsFromDnsMessage(packet)) {
-		if (seen.has(found.host)) continue;
-		seen.add(found.host);
-		hosts.push(found);
-	}
-	return hosts;
-}
 /** Manual host wins. Otherwise the address discovery filled in. */
 function resolveShcPairingHost(input) {
 	const manual = input.hostManual?.trim() ?? "";
@@ -582,6 +409,137 @@ function resolveShcPairingHost(input) {
 	throw new Error("Enter the controller host or IP address.");
 }
 //#endregion
+//#region src/shc/shc-gateway.ts
+/** In-process resolver: integrationId → live SHC connection surface. */
+var ShcConnectionResolver = class {
+	#surfaces = /* @__PURE__ */ new Map();
+	set(integrationId, surface) {
+		if (surface === null) {
+			this.#surfaces.delete(integrationId);
+			return;
+		}
+		this.#surfaces.set(integrationId, surface);
+	}
+	has(integrationId) {
+		return this.#surfaces.has(integrationId);
+	}
+	devices(integrationId) {
+		return this.#surfaces.get(integrationId)?.devices ?? [];
+	}
+	getClient(integrationId) {
+		return this.#surfaces.get(integrationId)?.client ?? null;
+	}
+	list() {
+		return Array.from(this.#surfaces.keys()).map((id) => ({ id }));
+	}
+	clear() {
+		for (const surface of this.#surfaces.values()) surface.client.close();
+		this.#surfaces.clear();
+	}
+};
+var shcConnections = new ShcConnectionResolver();
+//#endregion
+//#region src/shc/devices/shc-device-base.ts
+var shcDeviceSchema = object({
+	shcDeviceId: string().min(1).describe("Bosch SHC device id"),
+	brokerId: string().min(1).describe("Integration id"),
+	deviceModel: string().optional(),
+	system: literal("bosch-shc").optional(),
+	integrationId: string().optional(),
+	tempStep: number().positive().optional()
+});
+var ShcBaseDevice = class extends BaseDevice {
+	features = [];
+	shcDeviceId;
+	brokerId;
+	deviceModel;
+	stateUnsub = null;
+	constructor(ctx) {
+		const persisted = shcDeviceSchema.parse(ctx.persistedConfig ?? {});
+		super(ctx, shcDeviceSchema, { type: ctx.deviceMeta.type });
+		this.shcDeviceId = persisted.shcDeviceId;
+		this.brokerId = persisted.brokerId;
+		this.deviceModel = persisted.deviceModel;
+		this.online = shcConnections.has(this.brokerId);
+		this.updateSourceInfo({
+			id: this.shcDeviceId,
+			system: "bosch-shc"
+		});
+	}
+	resolveClient() {
+		return shcConnections.getClient(this.brokerId);
+	}
+	requireClient() {
+		const client = this.resolveClient();
+		if (client === null) throw new Error(`SHC client unavailable (device=${this.shcDeviceId})`);
+		return client;
+	}
+	async onActivate() {
+		await super.onActivate();
+		this.registerCaps();
+		this.attachStateListener();
+		await this.refreshFromController();
+	}
+	async removeDevice() {
+		if (this.stateUnsub) {
+			try {
+				this.stateUnsub();
+			} catch {}
+			this.stateUnsub = null;
+		}
+	}
+	attachStateListener() {
+		const client = this.resolveClient();
+		if (client === null) return;
+		const onEvent = (event) => {
+			if (event.deviceId !== this.shcDeviceId) return;
+			this.refreshFromController().catch((err) => {
+				this.deviceLog("warn", "SHC refresh after controller event failed", {
+					shcDeviceId: this.shcDeviceId,
+					error: errMsg(err)
+				});
+			});
+		};
+		this.stateUnsub = client.onStateChange(onEvent);
+	}
+	deviceLog(level, message, meta) {
+		const extras = {
+			tags: { deviceId: this.ctx.id },
+			...meta === void 0 ? {} : { meta }
+		};
+		if (level === "warn") this.ctx.logger.warn(message, extras);
+		else this.ctx.logger.info(message, extras);
+	}
+	unsupported(surface) {
+		throw new Error(`bosch-shc ${this.shcDeviceId}: ${surface} not supported`);
+	}
+};
+//#endregion
+//#region src/shc/devices/shc-gateway-device.ts
+/**
+* The Smart Home Controller box, as a {@link DeviceType.Gateway}. Its connection
+* lives on the INTEGRATION; this device is the box's presence in the device list
+* and follows the session's online state (the integration's connect and
+* disconnect callbacks flip it).
+*
+* It registers no action: the controller's local API offers no reboot or update
+* and the box serves no web page, so there is nothing real to expose. Rooms and
+* devices are NOT children of it; they are adopted as their own top-level
+* devices of the same integration.
+*/
+var ShcGatewayDevice = class extends BaseDevice {
+	features = [];
+	constructor(ctx) {
+		const cfg = shcDeviceSchema.parse(ctx.persistedConfig ?? {});
+		super(ctx, shcDeviceSchema, { type: DeviceType.Gateway });
+		this.online = shcConnections.has(cfg.brokerId);
+		this.updateSourceInfo({
+			id: cfg.shcDeviceId,
+			system: "bosch-shc"
+		});
+	}
+};
+//#endregion
 //#region src/shc/shc-domain-mapping.ts
 var ROOM_CLIMATE_MODEL = "ROOM_CLIMATE_CONTROL";
 /** Classify a normalised device summary into an adoption / driver kind. */
@@ -704,6 +662,11 @@ function buildRoomClimatePutBody(input) {
 }
 //#endregion
 //#region src/shc/shc-discovery.ts
+var GATEWAY_SUFFIX = ":controller";
+/** The `childNativeId` (and `shcDeviceId`) of the controller box itself, one per integration. */
+function shcGatewayNativeId(integrationId) {
+	return `${integrationId}${GATEWAY_SUFFIX}`;
+}
 function shouldSkipShcDevice(device) {
 	if (classifyShcDevice(device) === "unsupported") return true;
 	if (device.deviceModel.startsWith("HOMECONNECT_")) return true;
@@ -798,7 +761,21 @@ function leafCandidate(device, kind, adoptedId) {
 /** Map live SHC discovery rows to adoption candidates. Pure — no I/O. */
 function buildShcCandidates(input) {
 	const linkedTrvs = collectTrvsLinkedToRoomClimate(input.devices);
-	const out = [];
+	const gatewayId = shcGatewayNativeId(input.integrationId);
+	const gatewayAdopted = input.adopted.get(gatewayId) ?? null;
+	const out = [{
+		childNativeId: gatewayId,
+		name: input.integrationName,
+		type: DeviceType.Gateway,
+		status: "online",
+		metadata: {
+			manufacturer: "Bosch",
+			model: "Smart Home Controller"
+		},
+		alreadyAdopted: gatewayAdopted !== null,
+		adoptedDeviceId: gatewayAdopted,
+		capabilities: []
+	}];
 	for (const device of input.devices) {
 		if (shouldSkipShcDevice(device)) continue;
 		const kind = classifyShcDevice(device);
@@ -828,112 +805,6 @@ function shcStableIdSuffixFromDeviceId(shcDeviceId) {
 	return shcDeviceId.replace(/[^a-zA-Z0-9._-]+/g, "_");
 }
 //#endregion
-//#region src/shc/shc-gateway.ts
-/** In-process resolver: integrationId → live SHC connection surface. */
-var ShcConnectionResolver = class {
-	#surfaces = /* @__PURE__ */ new Map();
-	set(integrationId, surface) {
-		if (surface === null) {
-			this.#surfaces.delete(integrationId);
-			return;
-		}
-		this.#surfaces.set(integrationId, surface);
-	}
-	has(integrationId) {
-		return this.#surfaces.has(integrationId);
-	}
-	devices(integrationId) {
-		return this.#surfaces.get(integrationId)?.devices ?? [];
-	}
-	getClient(integrationId) {
-		return this.#surfaces.get(integrationId)?.client ?? null;
-	}
-	list() {
-		return Array.from(this.#surfaces.keys()).map((id) => ({ id }));
-	}
-	clear() {
-		for (const surface of this.#surfaces.values()) surface.client.close();
-		this.#surfaces.clear();
-	}
-};
-var shcConnections = new ShcConnectionResolver();
-//#endregion
-//#region src/shc/devices/shc-device-base.ts
-var shcDeviceSchema = object({
-	shcDeviceId: string().min(1).describe("Bosch SHC device id"),
-	brokerId: string().min(1).describe("Integration id"),
-	deviceModel: string().optional(),
-	system: literal("bosch-shc").optional(),
-	integrationId: string().optional(),
-	tempStep: number().positive().optional()
-});
-var ShcBaseDevice = class extends BaseDevice {
-	features = [];
-	shcDeviceId;
-	brokerId;
-	deviceModel;
-	stateUnsub = null;
-	constructor(ctx) {
-		const persisted = shcDeviceSchema.parse(ctx.persistedConfig ?? {});
-		super(ctx, shcDeviceSchema, { type: ctx.deviceMeta.type });
-		this.shcDeviceId = persisted.shcDeviceId;
-		this.brokerId = persisted.brokerId;
-		this.deviceModel = persisted.deviceModel;
-		this.online = shcConnections.has(this.brokerId);
-		this.updateSourceInfo({
-			id: this.shcDeviceId,
-			system: "bosch-shc"
-		});
-	}
-	resolveClient() {
-		return shcConnections.getClient(this.brokerId);
-	}
-	requireClient() {
-		const client = this.resolveClient();
-		if (client === null) throw new Error(`SHC client unavailable (device=${this.shcDeviceId})`);
-		return client;
-	}
-	async onActivate() {
-		await super.onActivate();
-		this.registerCaps();
-		this.attachStateListener();
-		await this.refreshFromController();
-	}
-	async removeDevice() {
-		if (this.stateUnsub) {
-			try {
-				this.stateUnsub();
-			} catch {}
-			this.stateUnsub = null;
-		}
-	}
-	attachStateListener() {
-		const client = this.resolveClient();
-		if (client === null) return;
-		const onEvent = (event) => {
-			if (event.deviceId !== this.shcDeviceId) return;
-			this.refreshFromController().catch((err) => {
-				this.deviceLog("warn", "SHC refresh after controller event failed", {
-					shcDeviceId: this.shcDeviceId,
-					error: errMsg(err)
-				});
-			});
-		};
-		this.stateUnsub = client.onStateChange(onEvent);
-	}
-	deviceLog(level, message, meta) {
-		const extras = {
-			tags: { deviceId: this.ctx.id },
-			...meta === void 0 ? {} : { meta }
-		};
-		if (level === "warn") this.ctx.logger.warn(message, extras);
-		else this.ctx.logger.info(message, extras);
-	}
-	unsupported(surface) {
-		throw new Error(`bosch-shc ${this.shcDeviceId}: ${surface} not supported`);
-	}
-};
-//#endregion
 //#region src/shc/shc-climate-schedules.ts
 /** Heating profiles from `GET /climate/schedule/{id}/HEATING`. */
 function heatingProfilesFromSchedule(body) {
@@ -1301,11 +1172,15 @@ async function adoptedMapForIntegration(integrationId, listAdoptedShc) {
 	return map;
 }
 function buildShcAdoptionProvider(deps) {
-	const { registry, hasIntegration, listIntegrations, listAdoptedShc, adoptDevice, removeDevice, findDeviceConfig, logger } = deps;
+	const { registry, hasIntegration, listIntegrations, integrationName, listAdoptedShc, adoptDevice, removeDevice, findDeviceConfig, logger } = deps;
 	async function allCandidatesForIntegration(integrationId) {
+		const devices = registry.devices(integrationId);
+		const adopted = await adoptedMapForIntegration(integrationId, listAdoptedShc);
 		return buildShcCandidates({
-			devices: registry.devices(integrationId),
-			adopted: await adoptedMapForIntegration(integrationId, listAdoptedShc)
+			integrationId,
+			integrationName: integrationName(integrationId) ?? "Bosch SHC",
+			devices,
+			adopted
 		});
 	}
 	return {
@@ -1366,6 +1241,22 @@ function buildShcAdoptionProvider(deps) {
 			const adopted = [];
 			let failures = 0;
 			for (const shcDeviceId of childNativeIds) try {
+				if (shcDeviceId === shcGatewayNativeId(integrationId)) {
+					const name = perCandidate?.[shcDeviceId]?.name ?? integrationName(integrationId) ?? "Bosch SHC";
+					const { deviceId } = await adoptDevice({
+						shcDeviceId,
+						integrationId,
+						type: DeviceType.Gateway,
+						name,
+						deviceModel: "Smart Home Controller"
+					});
+					adopted.push({
+						childNativeId: shcDeviceId,
+						parentDeviceId: deviceId,
+						accessoryDeviceIds: []
+					});
+					continue;
+				}
 				const dev = devices.find((d) => d.id === shcDeviceId);
 				if (dev === void 0) {
 					failures++;
@@ -1410,7 +1301,7 @@ function buildShcAdoptionProvider(deps) {
 			const integrationId = String(cfg["brokerId"]);
 			const shcDeviceId = String(cfg["shcDeviceId"]);
 			if (!hasIntegration(integrationId)) throw new Error(`bosch-shc resync: integration ${integrationId} not connected`);
-			if (!registry.devices(integrationId).some((d) => d.id === shcDeviceId)) throw new Error(`bosch-shc resync: device ${shcDeviceId} no longer on integration`);
+			if (!(shcDeviceId === shcGatewayNativeId(integrationId) || registry.devices(integrationId).some((d) => d.id === shcDeviceId))) throw new Error(`bosch-shc resync: device ${shcDeviceId} no longer on integration`);
 			return {
 				changed: false,
 				rebuiltChildren: 0
@@ -23635,6 +23526,10 @@ var ShcClientRegistry = class {
 			makeClient: opts.makeClient ?? this.#makeClient
 		}));
 	}
+	/** The integration's display name, or null when it is not registered. */
+	nameOf(integrationId) {
+		return this.#entries.get(integrationId)?.manager.getInfo().name ?? null;
+	}
 	setOnConnected(cb) {
 		this.#onConnected = cb;
 	}
@@ -23830,6 +23725,7 @@ var BoschShcProviderAddon = class extends BaseDeviceProvider {
 	addonId = "bosch-shc";
 	providerName = "Bosch SHC";
 	deviceClasses = {
+		[DeviceType.Gateway]: ShcGatewayDevice,
 		[DeviceType.Container]: ShcClimateRoomDevice,
 		[DeviceType.Climate]: ShcRoomClimateDevice,
 		[DeviceType.Thermostat]: ShcTrvDevice,
@@ -23865,14 +23761,15 @@ var BoschShcProviderAddon = class extends BaseDeviceProvider {
 			customActions: boschShcActions,
 			actionHandlers: {
 				discoverController: async () => {
-					const { proposals, summary } = await this.discoverShcControllers();
+					const { candidates } = await this.ctx.api.deviceManager.discoverProvider.mutate({ addonId: this.ctx.id });
+					const hosts = candidates.map((candidate) => ({
+						host: String(candidate.prefilledConfig["host"] ?? ""),
+						name: candidate.suggestedName,
+						id: candidate.stableId.replace(/^bosch-shc:/, "")
+					}));
 					return {
-						hosts: proposals.map((found) => ({
-							host: found.host,
-							name: found.name,
-							id: found.id
-						})),
-						summary
+						hosts,
+						summary: shcDiscoverySummary(hosts.length, hosts.length)
 					};
 				},
 				registerClient: async (input) => {
@@ -23908,24 +23805,21 @@ var BoschShcProviderAddon = class extends BaseDeviceProvider {
 	async supportsManualCreation() {
 		return false;
 	}
-	/**
-	* LAN mDNS probe. This addon is hub-only, so the socket is the hub's.
-	* The operator's hub is on br0 (its own LAN address), the same path the
-	* hub already uses to announce itself — multicast UDP 5353 reaches the
-	* LAN. The probe asks for a unicast reply and does not bind 5353, which
-	* the hub's announcer holds. Agents do not run this addon.
-	*/
+	/** A controller is found by the scan engine's mDNS browse; this addon only classifies the hits. */
 	async supportsDiscovery() {
 		return true;
 	}
-	async discoverDevices() {
-		const { proposals } = await this.discoverShcControllers();
-		return shcDiscoveryCandidates(proposals).map((candidate) => ({
-			stableId: candidate.stableId,
-			type: DeviceType.Hub,
-			suggestedName: candidate.suggestedName,
-			prefilledConfig: { ...candidate.prefilledConfig }
-		}));
+	async getDiscoveryModes() {
+		return SHC_DISCOVERY_MODES;
+	}
+	async classifyDiscoveryHits(input) {
+		const found = shcHostsFromHits(input.hits);
+		const proposals = proposeShcControllers(found, await this.knownControllerHosts());
+		if (found.length > proposals.length) this.ctx.logger.info("SHC discovery skipped controllers already added", { meta: {
+			found: found.length,
+			proposed: proposals.length
+		} });
+		return shcDiscoveryCandidates(proposals);
 	}
 	async adoptDiscoveredDevice(_input) {
 		throw new Error("Bosch SHC controllers are paired from the integration form");
@@ -23943,24 +23837,6 @@ var BoschShcProviderAddon = class extends BaseDeviceProvider {
 		if (typeof shcDeviceId !== "string" || shcDeviceId.length === 0) throw new Error("bosch-shc generateStableId: shcDeviceId required");
 		return `bosch-shc:${integrationId}:${shcDeviceId}`;
 	}
-	async discoverShcControllers() {
-		let found = [];
-		try {
-			found = await browseShcControllers();
-		} catch (err) {
-			this.ctx.logger.warn("SHC controller discovery failed", { meta: { error: errMsg(err) } });
-		}
-		const known = await this.knownControllerHosts();
-		const proposals = proposeShcControllers(found, known);
-		if (found.length > proposals.length) this.ctx.logger.info("SHC discovery skipped controllers already added", { meta: {
-			found: found.length,
-			proposed: proposals.length
-		} });
-		return {
-			proposals,
-			summary: shcDiscoverySummary(found.length, proposals.length)
-		};
-	}
 	async knownControllerHosts() {
 		try {
 			const all = await this.ctx.api.integrations.list.query();
@@ -24041,6 +23917,7 @@ var BoschShcProviderAddon = class extends BaseDeviceProvider {
 			logger: this.ctx.logger,
 			hasIntegration: (integrationId) => this.requireClients().has(integrationId),
 			listIntegrations: () => this.requireClients().list(),
+			integrationName: (integrationId) => this.requireClients().nameOf(integrationId),
 			listAdoptedShc: async () => {
 				const reg = this.ctx.kernel.deviceRegistry;
 				const devices = this.ctx.kernel.devices;
@@ -24060,8 +23937,25 @@ var BoschShcProviderAddon = class extends BaseDeviceProvider {
 				const devices = this.ctx.kernel.devices;
 				if (!devices) throw new Error("bosch-shc adopt: kernel.devices unavailable");
 				const summary = shcConnections.devices(integrationId).find((d) => d.id === shcDeviceId);
-				const kind = summary ? classifyShcDevice(summary) : "unsupported";
+				const kind = type === DeviceType.Gateway ? "gateway" : summary ? classifyShcDevice(summary) : "unsupported";
 				if (kind === "unsupported") throw new Error(`bosch-shc adopt: unsupported device ${shcDeviceId}`);
+				if (type === DeviceType.Gateway) {
+					const config = {
+						shcDeviceId,
+						brokerId: integrationId,
+						deviceModel,
+						system: "bosch-shc",
+						integrationId,
+						name
+					};
+					const stableId = this.generateStableId(DeviceType.Gateway, config);
+					const meta = {
+						type: DeviceType.Gateway,
+						name,
+						integrationId
+					};
+					return { deviceId: (await devices.create(stableId, ShcGatewayDevice, config, null, meta)).id };
+				}
 				const baseConfig = {
 					shcDeviceId,
 					brokerId: integrationId,