@camstack/system 1.2.110 → 1.2.112

package/dist/addon-runner.js

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_manifest_python_deps = require("./manifest-python-deps-GejnH--L.js");
+const require_manifest_python_deps = require("./manifest-python-deps-MA_BZGBz.js");
 const require_custom_action_registry = require("./custom-action-registry-jY0NOZK8.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/addon-runner.mjs

@@ -1,4 +1,4 @@
-import { I as createUdsLoggerWithControl, L as LocalChildClient, Pt as startRunnerHeapWatch, at as setWorkerNativeCapsChangeListener, bt as installManifestNativeDeps, i as createUdsAddonContext, nt as getWorkerNativeCapProvider, rt as getWorkerNativeCapSnapshot, st as validateProviderRegistrations, t as installManifestPythonDeps, xt as resolveAddonClass } from "./manifest-python-deps-5ei2xVUh.mjs";
+import { I as createUdsLoggerWithControl, L as LocalChildClient, Pt as startRunnerHeapWatch, at as setWorkerNativeCapsChangeListener, bt as installManifestNativeDeps, i as createUdsAddonContext, nt as getWorkerNativeCapProvider, rt as getWorkerNativeCapSnapshot, st as validateProviderRegistrations, t as installManifestPythonDeps, xt as resolveAddonClass } from "./manifest-python-deps-Cb1ANt3i.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-F__gp_VX.mjs";
 import { register } from "node:module";
 import * as path$1 from "node:path";

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, v as addonPagesCapability, vt as errMsg, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { Gt as EventCategory, v as addonPagesCapability, vt as errMsg, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, b as addonWidgetsCapability, vt as errMsg, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { Gt as EventCategory, b as addonWidgetsCapability, vt as errMsg, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/alerts/alerts.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.

package/dist/builtins/alerts/alerts.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, Mt as createEvent, n as AlertSchema, vt as errMsg, x as alertsCapability, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { Gt as EventCategory, Mt as createEvent, n as AlertSchema, vt as errMsg, x as alertsCapability, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 let node_crypto = require("node:crypto");
 let buffer = require("buffer");
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { C as backupCapability, Gt as EventCategory, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { C as backupCapability, Gt as EventCategory, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import { randomBytes, randomUUID } from "node:crypto";
 import { Buffer as Buffer$1 } from "buffer";
 import * as fsp from "node:fs/promises";

package/dist/builtins/console-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/console-logging/index.mjs

@@ -1,4 +1,4 @@
-import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/core-blocks/core-blocks.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_chunk.__toESM(node_fs_promises);

package/dist/builtins/core-blocks/core-blocks.addon.mjs

@@ -1,4 +1,4 @@
-import { D as coreBlockAddonId, O as coreBlockIdFromAddonId, c as CoreBlockSchema, k as coreBlocksCapability, l as DeclaredDevices, o as CORE_BLOCKS_ADDON_ID, s as CORE_BLOCK_ADDON_PREFIX, vt as errMsg, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { D as coreBlockAddonId, O as coreBlockIdFromAddonId, c as CoreBlockSchema, k as coreBlocksCapability, l as DeclaredDevices, o as CORE_BLOCKS_ADDON_ID, s as CORE_BLOCK_ADDON_PREFIX, vt as errMsg, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import { randomUUID } from "node:crypto";
 import * as fs from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/device-manager/device-manager.addon.js

@@ -3,8 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
-const require_retired_settings_keys = require("../../retired-settings-keys-DCESas5O.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
+const require_retired_settings_keys = require("../../retired-settings-keys-B-I7w1Ta.js");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");
 //#region src/builtins/device-manager/adoption-job-engine.ts

package/dist/builtins/device-manager/device-manager.addon.mjs

@@ -1,5 +1,5 @@
-import { Ct as DeviceFeature, E as buildStreamParamsConfigSchema, F as deviceStatusCapability, Gt as EventCategory, Lt as isDeviceConfigCap, N as deviceManagerCapability, Ot as WELL_KNOWN_TAB_MAP, P as deviceStateCapability, R as enumerateItemArrayFields, Tt as DeviceType, Wt as sleep, a as CAP_NAMES_WITH_STATUS, at as runtimeStatePolicyFor, et as normalizeUnit, nt as parseStreamParamsFormPatch, p as STREAM_PROFILE_META, t as ALL_CAPABILITY_DEFINITIONS, u as DeviceStatusSchema, vt as errMsg, wt as DeviceRole, yt as BaseAddon, z as enumerateSchemaFields } from "../../dist-CW4Cims4.mjs";
-import { n as purgeRetiredSettingsRows } from "../../retired-settings-keys-DGgOxOir.mjs";
+import { Ct as DeviceFeature, E as buildStreamParamsConfigSchema, F as deviceStatusCapability, Gt as EventCategory, Lt as isDeviceConfigCap, N as deviceManagerCapability, Ot as WELL_KNOWN_TAB_MAP, P as deviceStateCapability, R as enumerateItemArrayFields, Tt as DeviceType, Wt as sleep, a as CAP_NAMES_WITH_STATUS, at as runtimeStatePolicyFor, et as normalizeUnit, nt as parseStreamParamsFormPatch, p as STREAM_PROFILE_META, t as ALL_CAPABILITY_DEFINITIONS, u as DeviceStatusSchema, vt as errMsg, wt as DeviceRole, yt as BaseAddon, z as enumerateSchemaFields } from "../../dist-bkg2-2g3.mjs";
+import { n as purgeRetiredSettingsRows } from "../../retired-settings-keys-C7rRSzbP.mjs";
 import { randomUUID } from "node:crypto";
 import { canonicalDeviceFingerprint } from "@camstack/types/node";
 //#region src/builtins/device-manager/adoption-job-engine.ts

package/dist/builtins/doorbell/virtual-doorbell.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/doorbell/virtual-doorbell.addon.mjs

@@ -1,4 +1,4 @@
-import { G as isSameAddonId, Gt as EventCategory, I as doorbellCapability, Mt as createEvent, Tt as DeviceType, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { G as isSameAddonId, Gt as EventCategory, I as doorbellCapability, Mt as createEvent, Tt as DeviceType, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/hub-forwarder/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/hub-forwarder/index.mjs

@@ -1,4 +1,4 @@
-import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/liveness-monitor/liveness-monitor.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/liveness-monitor/liveness-monitor.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, Mt as createEvent, vt as errMsg, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { Gt as EventCategory, Mt as createEvent, vt as errMsg, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/local-auth/local-auth.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 let node_crypto = require("node:crypto");
 node_crypto = require_chunk.__toESM(node_crypto);
 let crypto$1 = require("crypto");

package/dist/builtins/local-auth/local-auth.addon.mjs

@@ -1,5 +1,5 @@
 import { i as __require, o as __toESM, t as __commonJSMin } from "../../chunk-CNf5ZN-e.mjs";
-import { S as authProviderCapability, _ as UserRecordSchema, ht as userManagementCapability, m as ScopedTokenSchema, r as ApiKeyRecordSchema, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { S as authProviderCapability, _ as UserRecordSchema, ht as userManagementCapability, m as ScopedTokenSchema, r as ApiKeyRecordSchema, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import * as crypto$2 from "node:crypto";
 import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
 import nodeCrypto from "crypto";

package/dist/builtins/local-network/local-network.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 //#region src/builtins/local-network/local-network.addon.ts

package/dist/builtins/local-network/local-network.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, Y as localNetworkCapability, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { Gt as EventCategory, Y as localNetworkCapability, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import * as os from "node:os";
 //#region src/builtins/local-network/local-network.addon.ts
 /**

package/dist/builtins/loki-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/loki-logging/index.mjs

@@ -1,4 +1,4 @@
-import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { X as logDestinationCapability, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/native-metrics/native-metrics.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 let node_child_process = require("node:child_process");
 let node_util = require("node:util");
 let node_os = require("node:os");

package/dist/builtins/native-metrics/native-metrics.addon.mjs

@@ -1,4 +1,4 @@
-import { $ as metricsProviderCapability, Gt as EventCategory, Mt as createEvent, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { $ as metricsProviderCapability, Gt as EventCategory, Mt as createEvent, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import { execFile, execFileSync } from "node:child_process";
 import { promisify } from "node:util";
 import * as os from "node:os";

package/dist/builtins/platform-probe/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 let node_child_process = require("node:child_process");
 let node_util = require("node:util");
 let node_os = require("node:os");

package/dist/builtins/platform-probe/index.mjs

@@ -1,5 +1,5 @@
 import { o as __toESM } from "../../chunk-CNf5ZN-e.mjs";
-import { Gt as EventCategory, L as enumerateInferenceDevices, Pt as emitReadiness, ct as scoreRuntimes, rt as platformProbeCapability, vt as errMsg, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { Gt as EventCategory, L as enumerateInferenceDevices, Pt as emitReadiness, ct as scoreRuntimes, rt as platformProbeCapability, vt as errMsg, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import * as os from "node:os";

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Gt as EventCategory, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { Gt as EventCategory, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/snapshot/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQkr5Kw0.js");
+const require_dist = require("../../dist-IPLFQ_-A.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");
@@ -939,6 +939,24 @@ function pickWarmSnapshotBroker(ranked, devicePrefix) {
 //#endregion
 //#region src/builtins/snapshot/snapshot.addon.ts
 /**
+* States that make a dial pointless — the ladder is skipped entirely.
+*
+* `offline` is deliberately absent: a camera that is never probed can never be
+* observed to come back, and this layer's own capture is one of the two ways a
+* wrong `online:false` gets discovered (the other is the reachability poller
+* that set it).
+*/
+var CAPTURE_BLOCKING_REASONS = [
+	"disabled",
+	"sleeping",
+	"unreachable",
+	"waking"
+];
+/** True when this state must answer WITHOUT touching the camera. */
+function blocksCapture(reason) {
+	return CAPTURE_BLOCKING_REASONS.includes(reason);
+}
+/**
 * How long `getSnapshotLinks` waits for the capture it triggered before minting
 * the link over whatever frame it has.
 *
@@ -1681,7 +1699,7 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 			resolutionMeta.isBattery = isBatteryDevice;
 			delete resolutionMeta.stateReason;
 		}
-		if (state.reason !== void 0 && (!force || state.reason === "disabled" || state.reason === "unreachable" || state.reason === "waking")) {
+		if (state.reason !== void 0 && blocksCapture(state.reason) && (!force || state.reason !== "sleeping")) {
 			if (resolutionMeta) resolutionMeta.stateReason = state.reason;
 			log.debug("snapshot: camera state overrides raw cache", {
 				tags: { deviceId },
@@ -1709,7 +1727,8 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 					isBattery: isBatteryDevice
 				}
 			});
-			return hit ? hit.data : null;
+			if (!hit) return null;
+			return state.reason === "offline" ? await this.offlineImage(deviceId, deviceName, hit, resolutionMeta) : hit.data;
 		}
 		const flightKey = `${deviceId}:${effectiveStreamId ?? "auto"}`;
 		const flight = this.captureFlight.run(flightKey, () => this.captureFresh({
@@ -1722,16 +1741,19 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 		flight.catch(() => void 0);
 		const waitMs = !force && decision.staleFallback && hit !== void 0 ? Math.min(decision.waitMs, staleWaitCapMs) : decision.waitMs;
 		const raced = await raceForResult(flight, Math.min(Math.max(waitMs, minimumCaptureWaitMs), maximumCaptureWaitMs));
-		if (raced.settled) try {
-			const resolved = await this.resolveOutcome(raced.value, deviceId, hit, log);
-			if (resolved !== null) return resolved;
-			return meta?.online === false ? await this.courtesyImage(deviceId, "offline", deviceName) : null;
-		} catch (err) {
-			if (meta?.online === false) {
-				const courtesy = await this.courtesyImage(deviceId, "offline", deviceName);
-				if (courtesy !== null) return courtesy;
+		if (raced.settled) {
+			const captured = raced.value.ok && raced.value.image !== null;
+			try {
+				const resolved = await this.resolveOutcome(raced.value, deviceId, hit, log);
+				if (resolved !== null) return captured || state.reason !== "offline" ? resolved : await this.offlineImage(deviceId, deviceName, hit, resolutionMeta);
+				return state.reason === "offline" ? await this.offlineImage(deviceId, deviceName, void 0, resolutionMeta) : null;
+			} catch (err) {
+				if (state.reason === "offline") {
+					const stateFrame = await this.offlineImage(deviceId, deviceName, hit, resolutionMeta);
+					if (stateFrame !== null) return stateFrame;
+				}
+				throw err;
 			}
-			throw err;
 		}
 		if (decision.staleFallback && hit) {
 			if (prefs.snapshotDebug) log.debug("snapshot: SWR — returning stale frame; refresh continues in background", {
@@ -1741,11 +1763,11 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 					waitMs: decision.waitMs
 				}
 			});
-			return hit.data;
+			return state.reason === "offline" ? await this.offlineImage(deviceId, deviceName, hit, resolutionMeta) : hit.data;
 		}
-		if (meta?.online === false) {
-			const courtesy = await this.courtesyImage(deviceId, "offline", deviceName);
-			if (courtesy !== null) return courtesy;
+		if (state.reason === "offline") {
+			const stateFrame = await this.offlineImage(deviceId, deviceName, void 0, resolutionMeta);
+			if (stateFrame !== null) return stateFrame;
 		}
 		return null;
 	}
@@ -2104,7 +2126,12 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 				meta: { error: require_dist.errMsg(err) }
 			});
 		}
-		if (!(meta?.isBattery === true || batteryStatus !== null || waking)) return { isBattery: false };
+		const isBattery = meta?.isBattery === true || batteryStatus !== null || waking;
+		const unreachableVerdict = meta?.online === false ? {
+			isBattery,
+			reason: "offline"
+		} : null;
+		if (!isBattery) return unreachableVerdict ?? { isBattery: false };
 		if (waking) return {
 			isBattery: true,
 			reason: "waking"
@@ -2113,10 +2140,11 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 			status: batteryStatus,
 			nowMs: Date.now()
 		});
-		return presence === "awake" ? { isBattery: true } : {
+		if (presence !== "awake") return {
 			isBattery: true,
 			reason: presence
 		};
+		return unreachableVerdict ?? { isBattery: true };
 	}
 	isDeviceWaking(deviceId) {
 		const startedAt = this.wakingDevices.get(deviceId);
@@ -2299,6 +2327,32 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 		};
 	}
 	/**
+	* The answer for a camera the hub cannot reach: its last good frame, with
+	* `Offline` painted over it, and `offline` stamped on the response identity.
+	*
+	* Called only AFTER the ladder has run (offline is not in
+	* {@link CAPTURE_BLOCKING_REASONS}), so this dresses a frame that could not be
+	* refreshed — never one that just landed.
+	*
+	* The `stateReason` is set FIRST and unconditionally, because it is what a
+	* surface labels the tile from and what puts `offline` in the ETag: a client
+	* holding the live frame has to see a new identity the moment the camera
+	* drops, or it paints the unlabelled photograph until the camera comes back.
+	* A failed render therefore degrades to the raw frame rather than to nothing —
+	* the metadata still says offline, so the tile is still honest.
+	*/
+	async offlineImage(deviceId, deviceName, hit, resolutionMeta) {
+		if (resolutionMeta) resolutionMeta.stateReason = "offline";
+		this.ctx.logger.debug("snapshot: serving the offline treatment", {
+			tags: { deviceId },
+			meta: {
+				hasCache: hit !== void 0,
+				ageMs: hit ? Date.now() - hit.ts : null
+			}
+		});
+		return await this.stateImage(deviceId, "offline", deviceName, hit) ?? hit?.data ?? null;
+	}
+	/**
 	* Render a state-labelled answer. A cached real frame is the background, not
 	* the answer by itself; if it cannot be decoded, fall back to the generated
 	* courtesy background rather than leaking an unlabelled stale frame.

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { Ct as DeviceFeature, Gt as EventCategory, M as deriveBatteryPresence, Rt as nodePin, T as batteryCapability, Tt as DeviceType, i as BatteryStatusSchema, mt as streamQualityLabel, ut as snapshotCapability, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-CW4Cims4.mjs";
+import { Ct as DeviceFeature, Gt as EventCategory, M as deriveBatteryPresence, Rt as nodePin, T as batteryCapability, Tt as DeviceType, i as BatteryStatusSchema, mt as streamQualityLabel, ut as snapshotCapability, vt as errMsg, w as bareAddonId, yt as BaseAddon } from "../../dist-bkg2-2g3.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 import { signExpiringUrl, verifyExpiringUrl } from "@camstack/types/node";
@@ -933,6 +933,24 @@ function pickWarmSnapshotBroker(ranked, devicePrefix) {
 //#endregion
 //#region src/builtins/snapshot/snapshot.addon.ts
 /**
+* States that make a dial pointless — the ladder is skipped entirely.
+*
+* `offline` is deliberately absent: a camera that is never probed can never be
+* observed to come back, and this layer's own capture is one of the two ways a
+* wrong `online:false` gets discovered (the other is the reachability poller
+* that set it).
+*/
+var CAPTURE_BLOCKING_REASONS = [
+	"disabled",
+	"sleeping",
+	"unreachable",
+	"waking"
+];
+/** True when this state must answer WITHOUT touching the camera. */
+function blocksCapture(reason) {
+	return CAPTURE_BLOCKING_REASONS.includes(reason);
+}
+/**
 * How long `getSnapshotLinks` waits for the capture it triggered before minting
 * the link over whatever frame it has.
 *
@@ -1675,7 +1693,7 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 			resolutionMeta.isBattery = isBatteryDevice;
 			delete resolutionMeta.stateReason;
 		}
-		if (state.reason !== void 0 && (!force || state.reason === "disabled" || state.reason === "unreachable" || state.reason === "waking")) {
+		if (state.reason !== void 0 && blocksCapture(state.reason) && (!force || state.reason !== "sleeping")) {
 			if (resolutionMeta) resolutionMeta.stateReason = state.reason;
 			log.debug("snapshot: camera state overrides raw cache", {
 				tags: { deviceId },
@@ -1703,7 +1721,8 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 					isBattery: isBatteryDevice
 				}
 			});
-			return hit ? hit.data : null;
+			if (!hit) return null;
+			return state.reason === "offline" ? await this.offlineImage(deviceId, deviceName, hit, resolutionMeta) : hit.data;
 		}
 		const flightKey = `${deviceId}:${effectiveStreamId ?? "auto"}`;
 		const flight = this.captureFlight.run(flightKey, () => this.captureFresh({
@@ -1716,16 +1735,19 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 		flight.catch(() => void 0);
 		const waitMs = !force && decision.staleFallback && hit !== void 0 ? Math.min(decision.waitMs, staleWaitCapMs) : decision.waitMs;
 		const raced = await raceForResult(flight, Math.min(Math.max(waitMs, minimumCaptureWaitMs), maximumCaptureWaitMs));
-		if (raced.settled) try {
-			const resolved = await this.resolveOutcome(raced.value, deviceId, hit, log);
-			if (resolved !== null) return resolved;
-			return meta?.online === false ? await this.courtesyImage(deviceId, "offline", deviceName) : null;
-		} catch (err) {
-			if (meta?.online === false) {
-				const courtesy = await this.courtesyImage(deviceId, "offline", deviceName);
-				if (courtesy !== null) return courtesy;
+		if (raced.settled) {
+			const captured = raced.value.ok && raced.value.image !== null;
+			try {
+				const resolved = await this.resolveOutcome(raced.value, deviceId, hit, log);
+				if (resolved !== null) return captured || state.reason !== "offline" ? resolved : await this.offlineImage(deviceId, deviceName, hit, resolutionMeta);
+				return state.reason === "offline" ? await this.offlineImage(deviceId, deviceName, void 0, resolutionMeta) : null;
+			} catch (err) {
+				if (state.reason === "offline") {
+					const stateFrame = await this.offlineImage(deviceId, deviceName, hit, resolutionMeta);
+					if (stateFrame !== null) return stateFrame;
+				}
+				throw err;
 			}
-			throw err;
 		}
 		if (decision.staleFallback && hit) {
 			if (prefs.snapshotDebug) log.debug("snapshot: SWR — returning stale frame; refresh continues in background", {
@@ -1735,11 +1757,11 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 					waitMs: decision.waitMs
 				}
 			});
-			return hit.data;
+			return state.reason === "offline" ? await this.offlineImage(deviceId, deviceName, hit, resolutionMeta) : hit.data;
 		}
-		if (meta?.online === false) {
-			const courtesy = await this.courtesyImage(deviceId, "offline", deviceName);
-			if (courtesy !== null) return courtesy;
+		if (state.reason === "offline") {
+			const stateFrame = await this.offlineImage(deviceId, deviceName, void 0, resolutionMeta);
+			if (stateFrame !== null) return stateFrame;
 		}
 		return null;
 	}
@@ -2098,7 +2120,12 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 				meta: { error: errMsg(err) }
 			});
 		}
-		if (!(meta?.isBattery === true || batteryStatus !== null || waking)) return { isBattery: false };
+		const isBattery = meta?.isBattery === true || batteryStatus !== null || waking;
+		const unreachableVerdict = meta?.online === false ? {
+			isBattery,
+			reason: "offline"
+		} : null;
+		if (!isBattery) return unreachableVerdict ?? { isBattery: false };
 		if (waking) return {
 			isBattery: true,
 			reason: "waking"
@@ -2107,10 +2134,11 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 			status: batteryStatus,
 			nowMs: Date.now()
 		});
-		return presence === "awake" ? { isBattery: true } : {
+		if (presence !== "awake") return {
 			isBattery: true,
 			reason: presence
 		};
+		return unreachableVerdict ?? { isBattery: true };
 	}
 	isDeviceWaking(deviceId) {
 		const startedAt = this.wakingDevices.get(deviceId);
@@ -2293,6 +2321,32 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 		};
 	}
 	/**
+	* The answer for a camera the hub cannot reach: its last good frame, with
+	* `Offline` painted over it, and `offline` stamped on the response identity.
+	*
+	* Called only AFTER the ladder has run (offline is not in
+	* {@link CAPTURE_BLOCKING_REASONS}), so this dresses a frame that could not be
+	* refreshed — never one that just landed.
+	*
+	* The `stateReason` is set FIRST and unconditionally, because it is what a
+	* surface labels the tile from and what puts `offline` in the ETag: a client
+	* holding the live frame has to see a new identity the moment the camera
+	* drops, or it paints the unlabelled photograph until the camera comes back.
+	* A failed render therefore degrades to the raw frame rather than to nothing —
+	* the metadata still says offline, so the tile is still honest.
+	*/
+	async offlineImage(deviceId, deviceName, hit, resolutionMeta) {
+		if (resolutionMeta) resolutionMeta.stateReason = "offline";
+		this.ctx.logger.debug("snapshot: serving the offline treatment", {
+			tags: { deviceId },
+			meta: {
+				hasCache: hit !== void 0,
+				ageMs: hit ? Date.now() - hit.ts : null
+			}
+		});
+		return await this.stateImage(deviceId, "offline", deviceName, hit) ?? hit?.data ?? null;
+	}
+	/**
 	* Render a state-labelled answer. A cached real frame is the background, not
 	* the answer by itself; if it cannot be decoded, fall back to the generated
 	* courtesy background rather than leaking an unlabelled stale frame.