@camstack/types 1.2.309 → 1.2.310

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-C3gDpn7G.js");
+const require_sleep = require("./sleep-DyF95STh.js");
 const require_event_category = require("./event-category-DmS_tLsU.js");
 const require_composition = require("./composition-BLWAivB2.js");
 const require_err_msg = require("./err-msg-Dx2Kor0g.js");
@@ -16116,7 +16116,143 @@ var filesystemBrowseCapability = {
 	}
 };
 //#endregion
+//#region src/capabilities/viewer-link-url.ts
+/** The central link domain the viewer app claims (Universal Links / App Links). */
+var CAMSTACK_APP_LINK_ORIGIN = "https://camstack.zentik.app";
+/** Where the hub serves the viewer SPA. */
+var HUB_VIEWER_MOUNT = "/viewer/camstack";
+/** True when `baseUrl` names the CamStack app link rather than a hub address. */
+function isAppLinkBase(baseUrl) {
+	if (baseUrl === null || baseUrl === void 0 || baseUrl === "") return false;
+	try {
+		return new URL(baseUrl).origin === CAMSTACK_APP_LINK_ORIGIN;
+	} catch {
+		return false;
+	}
+}
+/**
+* The base a viewer link is built on, from the flagged notification address:
+* the effective address is the explicit choice, else AUTO's `resolved`. The
+* one reading of that answer — the NC's tap and the Network page's preview
+* both go through it.
+*/
+function viewerLinkBaseOf(endpoint) {
+	const flagged = endpoint.baseUrl ?? endpoint.resolved;
+	return isAppLinkBase(flagged) ? {
+		form: "app",
+		hubBaseUrl: endpoint.appLinkHub ?? null
+	} : {
+		form: "hub",
+		hubBaseUrl: flagged
+	};
+}
+/**
+* Reduce a base URL to the bare origin the central page accepts as `hub=`,
+* or `null` when it cannot be one: not http(s), carries credentials, or does
+* not parse. A path/query/fragment is dropped — the central page mounts the
+* viewer under the origin itself.
+*/
+function toAppLinkHubOrigin(baseUrl) {
+	let parsed;
+	try {
+		parsed = new URL(baseUrl);
+	} catch {
+		return null;
+	}
+	if (parsed.protocol !== "https:" && parsed.protocol !== "http:") return null;
+	if (parsed.username !== "" || parsed.password !== "") return null;
+	if (parsed.hostname === "") return null;
+	return parsed.origin;
+}
+/**
+* The hub address an app link carries as `hub=`, chosen from the hub's OWN
+* advertised palette so it always agrees with what the Network page lists:
+* the public tunnel first, then the mesh (Tailscale MagicDNS) — HTTPS only,
+* because the app and the hosted viewer reach it from off the LAN. `null`
+* when the hub advertises neither.
+*/
+function pickAppLinkHub(endpoints) {
+	const rank = (e) => {
+		if (e.kind !== "public" || !e.baseUrl.startsWith("https://")) return null;
+		if (e.interfaceKind === "public") return 0;
+		if (e.interfaceKind === "vpn") return 1;
+		return null;
+	};
+	return endpoints.flatMap((e) => {
+		const r = rank(e);
+		const origin = toAppLinkHubOrigin(e.baseUrl);
+		return r === null || origin === null ? [] : [{
+			r,
+			p: e.priority,
+			origin
+		}];
+	}).toSorted((a, b) => a.r - b.r || a.p - b.p)[0]?.origin ?? null;
+}
+/** The viewer route for a destination, or null when it names nothing. */
+function viewerRoute(destination) {
+	switch (destination.kind) {
+		case "camera": {
+			if (!Number.isInteger(destination.deviceId) || destination.deviceId <= 0) return null;
+			const at = destination.atMs;
+			return {
+				path: `/camera/${String(destination.deviceId)}`,
+				query: at !== void 0 && Number.isFinite(at) ? [["at", String(Math.trunc(at))]] : []
+			};
+		}
+		case "events": return {
+			path: "/events",
+			query: []
+		};
+		case "notifications": return {
+			path: "/notifications",
+			query: []
+		};
+	}
+}
+function encodeQuery(query) {
+	if (query.length === 0) return "";
+	return `?${query.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join("&")}`;
+}
+/**
+* The link for a viewer destination, or `null` when none can be minted: an
+* unknown destination, or the `hub` form with no reachable base (a dead link
+* is worse than none).
+*/
+function buildViewerLink(input) {
+	const route = viewerRoute(input.destination);
+	if (route === null) return null;
+	const raw = input.base.hubBaseUrl;
+	const base = raw === null ? "" : raw.replace(/\/+$/, "");
+	if (input.base.form === "app") {
+		const origin = base === "" ? null : toAppLinkHubOrigin(base);
+		const query = origin === null ? route.query : [...route.query, ["hub", origin]];
+		return `${CAMSTACK_APP_LINK_ORIGIN}${route.path}${encodeQuery(query)}`;
+	}
+	if (base === "" || isAppLinkBase(base)) return null;
+	return `${base}${HUB_VIEWER_MOUNT}${route.path}${encodeQuery(route.query)}`;
+}
+//#endregion
 //#region src/capabilities/hub-address.ts
+var HUB_ADDRESS_ROLES = [
+	"viewer",
+	"notifications",
+	"agents",
+	"signIn"
+];
+var SINGLE_HUB_ADDRESS_ROLES = [
+	"notifications",
+	"agents",
+	"signIn"
+];
+function isSingleHubAddressRole(role) {
+	return role !== "viewer";
+}
+var AUTOMATIC_HUB_ADDRESS_FLAGS = {
+	viewer: [],
+	notifications: null,
+	agents: null,
+	signIn: null
+};
 var IPV4_LITERAL = /^\d{1,3}(?:\.\d{1,3}){3}$/;
 function hostnameOf(baseUrl) {
 	try {
@@ -16126,6 +16262,9 @@ function hostnameOf(baseUrl) {
 		return null;
 	}
 }
+function trimSlash(baseUrl) {
+	return baseUrl.replace(/\/+$/, "");
+}
 function isMesh(endpoint) {
 	return endpoint.kind === "public" && endpoint.interfaceKind === "vpn";
 }
@@ -16140,11 +16279,11 @@ function isLanIpv4Literal(endpoint) {
 	const host = hostnameOf(endpoint.baseUrl);
 	return host !== null && IPV4_LITERAL.test(host);
 }
-/** Lower = better; `null` = never this audience's answer. */
-function rankFor(audience, endpoint) {
-	if (endpoint.kind === "loopback" || endpoint.kind === "app-link") return null;
+/** Lower = better; `null` = never this role's AUTOMATIC answer. */
+function autoRankFor(role, endpoint) {
+	if (endpoint.kind === "loopback" || endpoint.kind === "app-link" || endpoint.kind === "custom") return null;
 	if (hostnameOf(endpoint.baseUrl) === null) return null;
-	if (audience === "cluster") {
+	if (role === "agents") {
 		if (isLanIpv4Literal(endpoint)) return 0;
 		if (isPlausibleLan(endpoint)) return 1;
 		if (isMesh(endpoint)) return 2;
@@ -16170,11 +16309,11 @@ function isLoopbackHost(hostname) {
 	return /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(h);
 }
 /**
-* Validate an operator-typed override: an http(s) URL with a host, no
+* Validate an operator-typed address: an http(s) URL with a host, no
 * credentials, no path, and never loopback (it would name whoever dials it).
 * Answers the normalised origin (`scheme://host[:port]`).
 */
-function validateHubAddressOverride(raw) {
+function validateCustomAddress(raw) {
 	const trimmed = raw.trim();
 	if (trimmed === "") return {
 		ok: false,
@@ -16214,47 +16353,125 @@ function validateHubAddressOverride(raw) {
 		baseUrl: parsed.origin
 	};
 }
+/** The reason a plain-http sign-in address is refused unless accepted. */
+var SIGN_IN_HTTP_REASON = "Sign-in needs an https:// address: passkeys and most identity providers refuse a plain-http origin. Accept http only for a sign-in that never leaves your own network.";
 /**
-* The hub's base URL for `audience`, without a trailing slash, or `null` when
-* the palette holds nothing that audience can reach. A valid operator
-* `override` wins outright; an empty one means automatic. Ties inside a rank
-* go to the palette's own `priority` (its preferred interface first).
+* May `baseUrl` carry `role`? The address check above, plus two role rules:
+* the app link carries `notifications` only (it is not a hub address), and a
+* plain-http address carries `signIn` only when the operator explicitly
+* accepted it (`acceptInsecureHttp`) — a LAN-only password or magic-link
+* sign-in works over http, a passkey or an OIDC callback does not.
 */
-function pickHubBaseUrl(endpoints, audience, override = null) {
-	return resolveHubAddress(endpoints, audience, override).resolved;
-}
-/** {@link pickHubBaseUrl}, saying where the answer came from. */
-function resolveHubAddress(endpoints, audience, override) {
-	if (override !== null && override !== "") {
-		const check = validateHubAddressOverride(override);
-		if (check.ok) return {
-			override,
-			resolved: check.baseUrl,
-			source: "override"
-		};
-	}
-	const auto = pickFromPalette(endpoints, audience);
-	return {
-		override: override === null || override === "" ? null : override,
-		resolved: auto,
-		source: auto === null ? "none" : "auto"
+function checkRoleAddress(role, baseUrl, options = {}) {
+	if (isAppLinkBase(baseUrl)) return role === "notifications" ? {
+		ok: true,
+		baseUrl: CAMSTACK_APP_LINK_ORIGIN
+	} : {
+		ok: false,
+		reason: "The CamStack app link is not a hub address — only notifications can use it."
 	};
+	const check = validateCustomAddress(baseUrl);
+	if (!check.ok) return check;
+	if (role === "signIn" && check.baseUrl.startsWith("http:") && options.acceptInsecureHttp !== true) return {
+		ok: false,
+		reason: SIGN_IN_HTTP_REASON
+	};
+	return check;
+}
+/** A stored flag that still validates (stored values are external data). */
+function validFlag(role, flag) {
+	if (flag === null || flag === "") return null;
+	const check = checkRoleAddress(role, flag, { acceptInsecureHttp: true });
+	return check.ok ? check.baseUrl : null;
 }
-function pickFromPalette(endpoints, audience) {
+function pickAuto(endpoints, role) {
 	const best = endpoints.flatMap((endpoint) => {
-		const rank = rankFor(audience, endpoint);
+		const rank = autoRankFor(role, endpoint);
 		return rank === null ? [] : [{
 			rank,
 			priority: endpoint.priority,
 			endpoint
 		}];
 	}).toSorted((a, b) => a.rank - b.rank || a.priority - b.priority)[0];
-	return best === void 0 ? null : best.endpoint.baseUrl.replace(/\/+$/, "");
+	return best === void 0 ? null : trimSlash(best.endpoint.baseUrl);
+}
+function resolveHubRole(endpoints, role, flag) {
+	const flagged = validFlag(role, flag);
+	if (flagged !== null) return {
+		flagged,
+		resolved: flagged,
+		source: "flagged"
+	};
+	const auto = pickAuto(endpoints, role);
+	return {
+		flagged: null,
+		resolved: auto,
+		source: auto === null ? "none" : "auto"
+	};
 }
-/** The bare hostname of {@link pickHubBaseUrl}'s answer, or `null`. */
-function pickHubHostname(endpoints, audience, override = null) {
-	const baseUrl = pickHubBaseUrl(endpoints, audience, override);
-	return baseUrl === null ? null : hostnameOf(baseUrl);
+/** `agents`: what agents and LAN devices pull from. */
+function resolveAgentsAddress(endpoints, flags) {
+	return resolveHubRole(endpoints, "agents", flags.agents);
+}
+/** `signIn`: sign-in links, OIDC callbacks, the relying party, OAuth2. */
+function resolveSignInAddress(endpoints, flags) {
+	return resolveHubRole(endpoints, "signIn", flags.signIn);
+}
+/** `notifications`: the flagged address, else the CamStack app link (D709). */
+function resolveNotificationsAddress(flags) {
+	const flagged = validFlag("notifications", flags.notifications);
+	if (flagged !== null && !isAppLinkBase(flagged)) return {
+		flagged,
+		resolved: flagged,
+		source: "flagged"
+	};
+	return {
+		flagged: null,
+		resolved: CAMSTACK_APP_LINK_ORIGIN,
+		source: "auto"
+	};
+}
+/** AUTO viewer race: LAN IPv4 + the public tunnel. Never IPv6, mesh, loopback or custom. */
+function isDefaultViewerEndpoint(endpoint) {
+	if (endpoint.kind === "lan-ipv4") return true;
+	return endpoint.kind === "public" && endpoint.interfaceKind === "public";
+}
+/**
+* The endpoints the apps race: the flagged ones that are in `endpoints`
+* (which carries the custom addresses flagged `viewer`), else AUTO. A flagged
+* set none of which is currently up falls back to AUTO rather than racing
+* nothing.
+*/
+function selectViewerEndpoints(endpoints, flags) {
+	const auto = endpoints.filter(isDefaultViewerEndpoint);
+	if (flags.viewer.length === 0) return auto;
+	const wanted = new Set(flags.viewer);
+	const explicit = endpoints.filter((e) => wanted.has(e.baseUrl));
+	return explicit.length > 0 ? explicit : auto;
+}
+/** `viewer`: what the apps race and connect to. */
+function resolveViewerAddresses(endpoints, flags) {
+	const wanted = new Set(flags.viewer);
+	const selected = selectViewerEndpoints(endpoints, flags);
+	const usedFlags = selected.some((e) => wanted.has(e.baseUrl));
+	return {
+		flagged: flags.viewer,
+		resolved: selected.map((e) => e.baseUrl),
+		source: selected.length === 0 ? "none" : usedFlags ? "flagged" : "auto"
+	};
+}
+/**
+* Every role at once, each through its own resolver. `viewerPalette` is what
+* the apps race (it carries the custom addresses flagged `viewer`);
+* `hubPalette` is the detected HTTPS palette agents and sign-in resolve over.
+*/
+function resolveHubAddressRoles(viewerPalette, hubPalette, flags) {
+	return {
+		viewer: resolveViewerAddresses(viewerPalette, flags),
+		notifications: resolveNotificationsAddress(flags),
+		agents: resolveAgentsAddress(hubPalette, flags),
+		signIn: resolveSignInAddress(hubPalette, flags)
+	};
 }
 /** The bare hostname of a base URL, or `null` when it does not parse. */
 function hubAddressHostname(baseUrl) {
@@ -32796,122 +33013,6 @@ var CLIP_PLAYBACK_OPTIONS = {
 	}
 };
 //#endregion
-//#region src/capabilities/viewer-link-url.ts
-/** The central link domain the viewer app claims (Universal Links / App Links). */
-var CAMSTACK_APP_LINK_ORIGIN = "https://camstack.zentik.app";
-/** Where the hub serves the viewer SPA. */
-var HUB_VIEWER_MOUNT = "/viewer/camstack";
-/** True when `baseUrl` names the CamStack app link rather than a hub address. */
-function isAppLinkBase(baseUrl) {
-	if (baseUrl === null || baseUrl === void 0 || baseUrl === "") return false;
-	try {
-		return new URL(baseUrl).origin === CAMSTACK_APP_LINK_ORIGIN;
-	} catch {
-		return false;
-	}
-}
-/**
-* The base a viewer link is built on, from the flagged notification address:
-* the effective address is the explicit choice, else AUTO's `resolved`. The
-* one reading of that answer — the NC's tap and the Network page's preview
-* both go through it.
-*/
-function viewerLinkBaseOf(endpoint) {
-	const flagged = endpoint.baseUrl ?? endpoint.resolved;
-	return isAppLinkBase(flagged) ? {
-		form: "app",
-		hubBaseUrl: endpoint.appLinkHub ?? null
-	} : {
-		form: "hub",
-		hubBaseUrl: flagged
-	};
-}
-/**
-* Reduce a base URL to the bare origin the central page accepts as `hub=`,
-* or `null` when it cannot be one: not http(s), carries credentials, or does
-* not parse. A path/query/fragment is dropped — the central page mounts the
-* viewer under the origin itself.
-*/
-function toAppLinkHubOrigin(baseUrl) {
-	let parsed;
-	try {
-		parsed = new URL(baseUrl);
-	} catch {
-		return null;
-	}
-	if (parsed.protocol !== "https:" && parsed.protocol !== "http:") return null;
-	if (parsed.username !== "" || parsed.password !== "") return null;
-	if (parsed.hostname === "") return null;
-	return parsed.origin;
-}
-/**
-* The hub address an app link carries as `hub=`, chosen from the hub's OWN
-* advertised palette so it always agrees with what the Network page lists:
-* the public tunnel first, then the mesh (Tailscale MagicDNS) — HTTPS only,
-* because the app and the hosted viewer reach it from off the LAN. `null`
-* when the hub advertises neither.
-*/
-function pickAppLinkHub(endpoints) {
-	const rank = (e) => {
-		if (e.kind !== "public" || !e.baseUrl.startsWith("https://")) return null;
-		if (e.interfaceKind === "public") return 0;
-		if (e.interfaceKind === "vpn") return 1;
-		return null;
-	};
-	return endpoints.flatMap((e) => {
-		const r = rank(e);
-		const origin = toAppLinkHubOrigin(e.baseUrl);
-		return r === null || origin === null ? [] : [{
-			r,
-			p: e.priority,
-			origin
-		}];
-	}).toSorted((a, b) => a.r - b.r || a.p - b.p)[0]?.origin ?? null;
-}
-/** The viewer route for a destination, or null when it names nothing. */
-function viewerRoute(destination) {
-	switch (destination.kind) {
-		case "camera": {
-			if (!Number.isInteger(destination.deviceId) || destination.deviceId <= 0) return null;
-			const at = destination.atMs;
-			return {
-				path: `/camera/${String(destination.deviceId)}`,
-				query: at !== void 0 && Number.isFinite(at) ? [["at", String(Math.trunc(at))]] : []
-			};
-		}
-		case "events": return {
-			path: "/events",
-			query: []
-		};
-		case "notifications": return {
-			path: "/notifications",
-			query: []
-		};
-	}
-}
-function encodeQuery(query) {
-	if (query.length === 0) return "";
-	return `?${query.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join("&")}`;
-}
-/**
-* The link for a viewer destination, or `null` when none can be minted: an
-* unknown destination, or the `hub` form with no reachable base (a dead link
-* is worse than none).
-*/
-function buildViewerLink(input) {
-	const route = viewerRoute(input.destination);
-	if (route === null) return null;
-	const raw = input.base.hubBaseUrl;
-	const base = raw === null ? "" : raw.replace(/\/+$/, "");
-	if (input.base.form === "app") {
-		const origin = base === "" ? null : toAppLinkHubOrigin(base);
-		const query = origin === null ? route.query : [...route.query, ["hub", origin]];
-		return `${CAMSTACK_APP_LINK_ORIGIN}${route.path}${encodeQuery(query)}`;
-	}
-	if (base === "" || isAppLinkBase(base)) return null;
-	return `${base}${HUB_VIEWER_MOUNT}${route.path}${encodeQuery(route.query)}`;
-}
-//#endregion
 //#region src/capabilities/webrtc-session.cap.ts
 /**
 * Optional client-side hints sent at session creation to help the provider
@@ -33419,6 +33520,35 @@ var webrtcSessionCapability = {
 			alive: zod.z.boolean()
 		})),
 		/**
+		* The viewer's downlink probe, for ONE live session (D733).
+		*
+		* The player measures `/adaptive-probe` after the session's first decoded
+		* frame (D635). It used to act on the reading itself, by opening a SECOND
+		* session with `hints.downlinkMbps` — every adaptive live open became two
+		* sessions, two ICE + DTLS handshakes and two server pipelines. It now
+		* hands the measurement to the session it already has; the provider picks
+		* the rung exactly as it would from an offer's hints (same viewport
+		* ceiling) and moves the session there — in place when the negotiated
+		* codec carries the new rendition, by the existing re-offer
+		* (`getSessionState.pendingRenegotiation`) when it cannot.
+		*
+		* A MEASUREMENT, never a tier: the client does not choose. A probe only
+		* raises the rung; lowering it stays the ladder's call on delivery.
+		* `held` answers why nothing moved (`not-adaptive`, `pinned`,
+		* `already-there`, `recorded`, …) — a client that gets ANY answer must not
+		* fall back to a reconnect; only a provider that does not know the method
+		* (an older hub) leaves the client its legacy second session.
+		*/
+		applyDownlinkProbe: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number().int().nonnegative(),
+			sessionId: zod.z.string(),
+			downlinkMbps: zod.z.number().nonnegative()
+		}), zod.z.object({
+			outcome: zod.z.enum(["switching", "held"]),
+			tier: require_sleep.CamProfileSchema.nullable(),
+			reason: zod.z.string()
+		}), { kind: "mutation" }),
+		/**
 		* The SERVER's half of the stream-debug overlay, for one live session.
 		*
 		* The client can measure its own transport (`getStats()`); it cannot see
@@ -37840,7 +37970,8 @@ var ConnectionEndpointSchema = zod.z.object({
 		"lan-ipv6",
 		"public",
 		"loopback",
-		"app-link"
+		"app-link",
+		"custom"
 	]),
 	/**
 	* Originating-interface kind — `lan`/`wifi`/`docker`/`vpn`/`other`/
@@ -37943,13 +38074,12 @@ var ViewerEndpointsSchema = zod.z.object({
 	resolved: zod.z.array(zod.z.string()).readonly()
 });
 /**
-* One audience's hub address (see `hub-address.ts`): the operator's stored
-* override, the address in use, and where it came from.
+* DEPRECATED compatibility shape of `getHubAddresses` (D729 amendment, kept
+* one release for addons built against it): `cluster` is the `agents` role,
+* `browser` the `signIn` role; `override` is the flagged address.
 */
 var HubAddressSnapshotSchema = zod.z.object({
-	/** The operator's override, or null for automatic. */
 	override: zod.z.string().nullable(),
-	/** The address in use, or null when nothing qualifies (never loopback). */
 	resolved: zod.z.string().nullable(),
 	source: zod.z.enum([
 		"override",
@@ -37958,11 +38088,67 @@ var HubAddressSnapshotSchema = zod.z.object({
 	])
 });
 var HubAddressesSchema = zod.z.object({
-	/** "Hub address for agents" — agents' bundle/model pulls, LAN devices. */
 	cluster: HubAddressSnapshotSchema,
-	/** "Public address for sign-in links" — e-mail links, OIDC, WebAuthn, OAuth2. */
 	browser: HubAddressSnapshotSchema
 });
+/**
+* What an address is used for (`hub-address.ts`). `viewer` is many-valued;
+* `notifications`, `agents` and `signIn` are carried by at most one address.
+*/
+var HubAddressRoleSchema = zod.z.enum([
+	"viewer",
+	"notifications",
+	"agents",
+	"signIn"
+]);
+var RoleSourceSchema = zod.z.enum([
+	"flagged",
+	"auto",
+	"none"
+]);
+/** One single-valued role: the flagged address, the one in use, and why. */
+var HubAddressRoleResolutionSchema = zod.z.object({
+	/** The address carrying the flag, or null = automatic. */
+	flagged: zod.z.string().nullable(),
+	/** The address in use, or null when nothing qualifies (never loopback). */
+	resolved: zod.z.string().nullable(),
+	source: RoleSourceSchema
+});
+var HubViewerResolutionSchema = zod.z.object({
+	/** The addresses flagged `viewer`, or empty = automatic. */
+	flagged: zod.z.array(zod.z.string()).readonly(),
+	/** What the apps race right now. */
+	resolved: zod.z.array(zod.z.string()).readonly(),
+	source: RoleSourceSchema
+});
+/**
+* One row of the Network page's Addresses table: a detected endpoint, an
+* operator-entered custom address, or the CamStack app link — flagged the
+* same way. A URL that is both detected and entered is ONE row.
+*/
+var HubAddressRowSchema = ConnectionEndpointSchema.extend({
+	/** In the hub's detected palette right now. */
+	detected: zod.z.boolean(),
+	/** Entered by the operator (removable). */
+	custom: zod.z.boolean(),
+	/** The roles explicitly flagged on this address. */
+	flags: zod.z.array(HubAddressRoleSchema).readonly(),
+	/** The roles this address serves right now — flagged or automatic. */
+	inUse: zod.z.array(HubAddressRoleSchema).readonly(),
+	/** The roles this address may be flagged with. */
+	eligible: zod.z.array(HubAddressRoleSchema).readonly()
+});
+var HubAddressBookSchema = zod.z.object({
+	rows: zod.z.array(HubAddressRowSchema).readonly(),
+	roles: zod.z.object({
+		viewer: HubViewerResolutionSchema,
+		notifications: HubAddressRoleResolutionSchema,
+		agents: HubAddressRoleResolutionSchema,
+		signIn: HubAddressRoleResolutionSchema
+	}),
+	/** The `hub=` an app link carries (D709), or null. */
+	appLinkHub: zod.z.string().nullable()
+});
 var AllowedAddressesSchema = zod.z.object({ 
 /**
 * Allowlist of interface addresses operators have explicitly opted
@@ -38075,46 +38261,78 @@ var localNetworkCapability = {
 		*/
 		getNotificationEndpoint: require_sleep.method(zod.z.void(), NotificationEndpointSchema),
 		/**
-		* Mark which endpoint notification artifacts use. `baseUrl: null` restores
-		* AUTO. The value is stored verbatim (not an index into the candidate
-		* list): interfaces come and go, and an index would silently re-point at a
-		* different address after a reboot.
+		* @deprecated Use `setAddressRole({ role: 'notifications', … })`. Kept so
+		* an older admin UI keeps working: it writes the same `notifications`
+		* flag, with the same validation. `baseUrl: null` restores automatic; an
+		* address that is not detected becomes a custom address.
 		*/
 		setNotificationEndpoint: require_sleep.method(zod.z.object({ baseUrl: zod.z.string().nullable() }), NotificationEndpointSchema, { kind: "mutation" }),
 		/**
-		* The endpoints the SDK / viewer races for API access. Empty `baseUrls`
-		* means AUTO: every LAN IPv4 address plus the public tunnel, never IPv6,
-		* never mesh, never loopback. `resolved` is that set (or the operator's
-		* explicit subset) as it stands right now.
+		* The `viewer` role as shipped apps read it: the flagged addresses
+		* (detected or custom), or empty for AUTO — every LAN IPv4 address plus
+		* the public tunnel, never IPv6, mesh, loopback or a custom address.
+		* `resolved` is the set as it stands right now; the custom ones in it are
+		* also in `getConnectionEndpoints`, which the apps filter by it.
 		*/
 		getViewerEndpoints: require_sleep.method(zod.z.void(), ViewerEndpointsSchema),
 		/**
-		* Replace the viewer race set. Empty `baseUrls` restores AUTO. Stored
-		* verbatim (not indices) so a temporarily-down tunnel is not silently
-		* dropped from the operator's choice.
+		* @deprecated Use `setAddressRole({ role: 'viewer', … })`. Kept so an
+		* older admin UI keeps working: it replaces the same `viewer` flags.
+		* Empty `baseUrls` restores automatic.
 		*/
 		setViewerEndpoints: require_sleep.method(zod.z.object({ baseUrls: zod.z.array(zod.z.string()).readonly() }), ViewerEndpointsSchema, { kind: "mutation" }),
 		/**
-		* The hub's address for each audience — agents (`cluster`) and sign-in
-		* links (`browser`) — as every consumer must read it: the operator's
-		* override when set, else the automatic pick from this cap's palette,
-		* never loopback. The ONE answer to "at which address is this hub
-		* reached?"; there is no environment variable for it.
+		* The Network page's Addresses table and every role's answer — the ONE
+		* reading of "which address is this hub reached at, for what": detected
+		* endpoints and custom addresses with their role flags, and per role the
+		* flagged address, the one in use and whether it is automatic. Agent
+		* deliveries, sign-in and LAN devices read `roles.agents` / `roles.signIn`
+		* here; nothing ranks the palette itself. `scheme` is the one the caller
+		* shows LAN rows in (as `getConnectionEndpoints`); agents and sign-in are
+		* always resolved over the HTTPS palette.
 		*/
-		getHubAddresses: require_sleep.method(zod.z.void(), HubAddressesSchema),
+		getAddresses: require_sleep.method(zod.z.object({ scheme: zod.z.enum(["http", "https"]).optional() }).optional(), HubAddressBookSchema),
 		/**
-		* Set or clear (`baseUrl: null`) one audience's override. Validated: an
-		* http(s) origin with a host, no credentials, no path, never loopback —
-		* an invalid value is refused with the reason, nothing is stored.
+		* Add a custom address. Validated: an http(s) origin with a host, no
+		* credentials, no path, never loopback — an invalid one is refused with
+		* the reason and nothing is stored. Adding an address that already exists
+		* only updates its label.
 		*/
-		setHubAddress: require_sleep.method(zod.z.object({
-			audience: zod.z.enum(["cluster", "browser"]),
-			baseUrl: zod.z.string().nullable()
-		}), HubAddressesSchema, {
+		addCustomAddress: require_sleep.method(zod.z.object({
+			baseUrl: zod.z.string(),
+			label: zod.z.string().max(80)
+		}), HubAddressBookSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/** Remove a custom address. Its role flags go with it (those roles turn automatic). */
+		removeCustomAddress: require_sleep.method(zod.z.object({ baseUrl: zod.z.string() }), HubAddressBookSchema, {
 			kind: "mutation",
 			auth: "admin"
 		}),
 		/**
+		* Flag (`enabled: true`) or unflag an address for a role. For a
+		* single-valued role, flagging moves the flag off every other address.
+		* `baseUrl: null` returns the role to automatic. The address must be a row
+		* of the table (detected, custom, or the app link for notifications);
+		* `signIn` on a plain-http address is refused unless `acceptInsecureHttp`.
+		*/
+		setAddressRole: require_sleep.method(zod.z.object({
+			role: HubAddressRoleSchema,
+			baseUrl: zod.z.string().nullable(),
+			enabled: zod.z.boolean(),
+			acceptInsecureHttp: zod.z.boolean().optional()
+		}), HubAddressBookSchema, {
+			kind: "mutation",
+			auth: "admin"
+		}),
+		/**
+		* @deprecated Read `getAddresses().roles.agents` / `.signIn`. Kept one
+		* release so an addon built against the D729 amendment keeps resolving:
+		* `cluster` = the `agents` role, `browser` = the `signIn` role.
+		*/
+		getHubAddresses: require_sleep.method(zod.z.void(), HubAddressesSchema),
+		/**
 		* Read the operator's allowlist. Empty = "auto" (no filter). Used
 		* by the admin UI's address selector to seed its checkbox state.
 		*/
@@ -53757,12 +53975,24 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"localNetwork.addCustomAddress": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"localNetwork.downloadCa": {
 		capName: "local-network",
 		capScope: "system",
 		addonId: null,
 		access: "view"
 	},
+	"localNetwork.getAddresses": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"localNetwork.getAllowedAddresses": {
 		capName: "local-network",
 		capScope: "system",
@@ -53817,6 +54047,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"localNetwork.removeCustomAddress": {
+		capName: "local-network",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"localNetwork.resetAllowlistToBestMatch": {
 		capName: "local-network",
 		capScope: "system",
@@ -53829,13 +54065,13 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
-	"localNetwork.setAllowedAddresses": {
+	"localNetwork.setAddressRole": {
 		capName: "local-network",
 		capScope: "system",
 		addonId: null,
 		access: "create"
 	},
-	"localNetwork.setHubAddress": {
+	"localNetwork.setAllowedAddresses": {
 		capName: "local-network",
 		capScope: "system",
 		addonId: null,
@@ -58089,6 +58325,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"webrtcSession.applyDownlinkProbe": {
+		capName: "webrtc-session",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"webrtcSession.closeSession": {
 		capName: "webrtc-session",
 		capScope: "device",
@@ -65363,6 +65605,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"webrtcSession.applyDownlinkProbe": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"webrtcSession.closeSession": [{
 		name: "deviceId",
 		form: "single",
@@ -66403,8 +66650,11 @@ function createSystemProxy(api) {
 			setNotificationEndpoint: (input) => dispatch("localNetwork", "setNotificationEndpoint", "mutation", input),
 			getViewerEndpoints: (input) => dispatch("localNetwork", "getViewerEndpoints", "query", input),
 			setViewerEndpoints: (input) => dispatch("localNetwork", "setViewerEndpoints", "mutation", input),
+			getAddresses: (input) => dispatch("localNetwork", "getAddresses", "query", input),
+			addCustomAddress: (input) => dispatch("localNetwork", "addCustomAddress", "mutation", input),
+			removeCustomAddress: (input) => dispatch("localNetwork", "removeCustomAddress", "mutation", input),
+			setAddressRole: (input) => dispatch("localNetwork", "setAddressRole", "mutation", input),
 			getHubAddresses: (input) => dispatch("localNetwork", "getHubAddresses", "query", input),
-			setHubAddress: (input) => dispatch("localNetwork", "setHubAddress", "mutation", input),
 			getAllowedAddresses: (input) => dispatch("localNetwork", "getAllowedAddresses", "query", input),
 			setAllowedAddresses: (input) => dispatch("localNetwork", "setAllowedAddresses", "mutation", input),
 			resetAllowlistToBestMatch: (input) => dispatch("localNetwork", "resetAllowlistToBestMatch", "mutation", input),
@@ -73591,6 +73841,7 @@ exports.AUDIO_NOT_CLASSIFIED_REASONS = AUDIO_NOT_CLASSIFIED_REASONS;
 exports.AUDIO_PRESETS = require_composition.AUDIO_PRESETS;
 exports.AUDIO_SCALE_EPOCH_ISO = AUDIO_SCALE_EPOCH_ISO;
 exports.AUDIO_SCALE_EPOCH_MS = AUDIO_SCALE_EPOCH_MS;
+exports.AUTOMATIC_HUB_ADDRESS_FLAGS = AUTOMATIC_HUB_ADDRESS_FLAGS;
 exports.AccessoriesStatusSchema = AccessoriesStatusSchema;
 exports.AccessoryKind = AccessoryKind;
 exports.AddBrokerInputSchema = AddBrokerInputSchema;
@@ -74158,12 +74409,14 @@ exports.HAP_KEYFRAME_INTERVAL_SEC = HAP_KEYFRAME_INTERVAL_SEC;
 exports.HF_BASE_URL = HF_BASE_URL;
 exports.HF_REPO = HF_REPO;
 exports.HOURS_PER_DAY = HOURS_PER_DAY;
+exports.HUB_ADDRESS_ROLES = HUB_ADDRESS_ROLES;
 exports.HUB_VIEWER_MOUNT = HUB_VIEWER_MOUNT;
 exports.HWACCEL_OPTIONS = HWACCEL_OPTIONS;
 exports.HealthStatusSchema = HealthStatusSchema;
 exports.HfModelResolutionSchema = HfModelResolutionSchema;
 exports.HistoryPointSchema = HistoryPointSchema;
 exports.HistoryResolutionEnum = HistoryResolutionEnum;
+exports.HubAddressRoleSchema = HubAddressRoleSchema;
 exports.HumidifierStatusSchema = HumidifierStatusSchema;
 exports.HumiditySensorStatusSchema = HumiditySensorStatusSchema;
 exports.HvacModeSchema = HvacModeSchema;
@@ -74823,6 +75076,8 @@ exports.SCOPE_PRESETS = SCOPE_PRESETS;
 exports.SENSOR_FEATURES = SENSOR_FEATURES;
 exports.SENSOR_MAP = SENSOR_MAP;
 exports.SHARE_VIEW_KINDS = require_sleep.SHARE_VIEW_KINDS;
+exports.SIGN_IN_HTTP_REASON = SIGN_IN_HTTP_REASON;
+exports.SINGLE_HUB_ADDRESS_ROLES = SINGLE_HUB_ADDRESS_ROLES;
 exports.SOURCE_CAPS = require_composition.SOURCE_CAPS;
 exports.SOURCE_CAP_ACTIVE_FIELD = require_composition.SOURCE_CAP_ACTIVE_FIELD;
 exports.SOURCE_CAP_CHANGED_AT_FIELD = require_composition.SOURCE_CAP_CHANGED_AT_FIELD;
@@ -75170,6 +75425,7 @@ exports.canConvertUnit = canConvertUnit;
 exports.canonicalEgressPlan = canonicalEgressPlan;
 exports.carbonMonoxideCapability = carbonMonoxideCapability;
 exports.cellsToRects = cellsToRects;
+exports.checkRoleAddress = checkRoleAddress;
 exports.classifyBearerPrincipal = classifyBearerPrincipal;
 exports.classifyStream = classifyStream;
 exports.classifyStreams = classifyStreams;
@@ -75404,6 +75660,7 @@ exports.isBatteryPresenceFault = isBatteryPresenceFault;
 exports.isClusterScopedStep = isClusterScopedStep;
 exports.isCollectionArrayMethod = isCollectionArrayMethod;
 exports.isDefaultAlarmProfileId = isDefaultAlarmProfileId;
+exports.isDefaultViewerEndpoint = isDefaultViewerEndpoint;
 exports.isDeployableToAgent = isDeployableToAgent;
 exports.isDetectionMacroClass = isDetectionMacroClass;
 exports.isDeviceConfigCap = require_sleep.isDeviceConfigCap;
@@ -75433,6 +75690,7 @@ exports.isRootSuppliableStepId = isRootSuppliableStepId;
 exports.isSameAddonId = isSameAddonId;
 exports.isScheduleActive = isScheduleActive;
 exports.isSecretConfigField = isSecretConfigField;
+exports.isSingleHubAddressRole = isSingleHubAddressRole;
 exports.isSoftwareDecode = require_composition.isSoftwareDecode;
 exports.isSourceCap = require_composition.isSourceCap;
 exports.isStateLabelKey = isStateLabelKey;
@@ -75549,8 +75807,6 @@ exports.pickAppLinkHub = pickAppLinkHub;
 exports.pickClusterStepModels = pickClusterStepModels;
 exports.pickClusterStepSettings = pickClusterStepSettings;
 exports.pickDetailCropConvention = pickDetailCropConvention;
-exports.pickHubBaseUrl = pickHubBaseUrl;
-exports.pickHubHostname = pickHubHostname;
 exports.pickInvalidClusterStepModels = pickInvalidClusterStepModels;
 exports.pickNativeLeaseOverride = pickNativeLeaseOverride;
 exports.pickPreferredRtspEntry = pickPreferredRtspEntry;
@@ -75611,6 +75867,7 @@ exports.resetPoolBaseline = resetPoolBaseline;
 exports.resolveAddonExecution = resolveAddonExecution;
 exports.resolveAddonGroup = resolveAddonGroup;
 exports.resolveAddonPlacement = resolveAddonPlacement;
+exports.resolveAgentsAddress = resolveAgentsAddress;
 exports.resolveBucketMs = resolveBucketMs;
 exports.resolveCapMount = require_sleep.resolveCapMount;
 exports.resolveClipSearchMinScore = resolveClipSearchMinScore;
@@ -75624,7 +75881,7 @@ exports.resolveDeviceProfile = resolveDeviceProfile;
 exports.resolveEgressDecodeHwAccel = resolveEgressDecodeHwAccel;
 exports.resolveExportProfiles = resolveExportProfiles;
 exports.resolveFormat = resolveFormat;
-exports.resolveHubAddress = resolveHubAddress;
+exports.resolveHubAddressRoles = resolveHubAddressRoles;
 exports.resolveHydratedFieldValue = require_sleep.resolveHydratedFieldValue;
 exports.resolveLocationIcon = resolveLocationIcon;
 exports.resolveLocationMode = resolveLocationMode;
@@ -75632,13 +75889,16 @@ exports.resolveMethodAuth = resolveMethodAuth;
 exports.resolveModeDelays = resolveModeDelays;
 exports.resolveModeNotifyPolicy = resolveModeNotifyPolicy;
 exports.resolveMutate = resolveMutate;
+exports.resolveNotificationsAddress = resolveNotificationsAddress;
 exports.resolvePoolMemoryPolicy = resolvePoolMemoryPolicy;
 exports.resolveRecordingProfiles = resolveRecordingProfiles;
 exports.resolveRootSupply = resolveRootSupply;
 exports.resolveRunnerId = resolveRunnerId;
+exports.resolveSignInAddress = resolveSignInAddress;
 exports.resolveStreamMaps = require_composition.resolveStreamMaps;
 exports.resolveVariantModelId = resolveVariantModelId;
 exports.resolveViewableDeviceIds = resolveViewableDeviceIds;
+exports.resolveViewerAddresses = resolveViewerAddresses;
 exports.roleSpec = roleSpec;
 exports.roomCompositionExample = roomCompositionExample;
 exports.rootSuppliesOf = rootSuppliesOf;
@@ -75672,6 +75932,7 @@ exports.scriptRunnerCapability = scriptRunnerCapability;
 exports.searchDisplayIcons = searchDisplayIcons;
 exports.secureActuationFor = secureActuationFor;
 exports.selectAssignedProfileSlots = require_sleep.selectAssignedProfileSlots;
+exports.selectViewerEndpoints = selectViewerEndpoints;
 exports.sendTimesForEditor = sendTimesForEditor;
 exports.sendTimesOfSchedule = sendTimesOfSchedule;
 exports.sensorRaisedOf = sensorRaisedOf;
@@ -75763,8 +76024,8 @@ exports.userManagementCapability = userManagementCapability;
 exports.userPasskeysCapability = userPasskeysCapability;
 exports.vacuumControlCapability = vacuumControlCapability;
 exports.validateComposition = validateComposition;
+exports.validateCustomAddress = validateCustomAddress;
 exports.validateExpressionSource = require_composition.validateExpressionSource;
-exports.validateHubAddressOverride = validateHubAddressOverride;
 exports.validateRecipeBounds = validateRecipeBounds;
 exports.valveCapability = valveCapability;
 exports.vectorDimFromBase64 = vectorDimFromBase64;