@camstack/system 1.1.49 → 1.1.51

package/dist/addon-runner.js

@@ -1,6 +1,6 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-BDV1WKRg.js");
-const require_manifest_python_deps = require("./manifest-python-deps-DAA0ULwT.js");
+const require_dist = require("./dist-C3uHEBtP.js");
+const require_manifest_python_deps = require("./manifest-python-deps-CVcJ9hDX.js");
 const require_custom_action_registry = require("./custom-action-registry-vLYEFTtv.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

package/dist/addon-runner.mjs

@@ -1,5 +1,5 @@
-import { k as isCollectionArrayMethod, t as ALL_CAPABILITY_DEFINITIONS } from "./dist-8phgmJ6b.mjs";
-import { F as createUdsLoggerWithControl, I as LocalChildClient, i as createUdsAddonContext, it as setWorkerNativeCapsChangeListener, nt as getWorkerNativeCapSnapshot, ot as validateProviderRegistrations, t as installManifestPythonDeps, tt as getWorkerNativeCapProvider, vt as installManifestNativeDeps, yt as resolveAddonClass } from "./manifest-python-deps-B09I9ems.mjs";
+import { A as isCollectionArrayMethod, t as ALL_CAPABILITY_DEFINITIONS } from "./dist-BWQX9yUj.mjs";
+import { F as createUdsLoggerWithControl, I as LocalChildClient, bt as resolveAddonClass, i as createUdsAddonContext, it as setWorkerNativeCapsChangeListener, nt as getWorkerNativeCapSnapshot, ot as validateProviderRegistrations, t as installManifestPythonDeps, tt as getWorkerNativeCapProvider, vt as installManifestNativeDeps } from "./manifest-python-deps-BA6KA9If.mjs";
 import { t as CustomActionRegistry } from "./custom-action-registry-BEXwC-oo.mjs";
 import { register } from "node:module";
 import * as fs from "node:fs";

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-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

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

@@ -1,4 +1,4 @@
-import { ct as EventCategory, et as errMsg, f as addonPagesCapability, tt as BaseAddon } from "../../dist-8phgmJ6b.mjs";
+import { Ot as EventCategory, f as addonPagesCapability, nt as errMsg, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import * as fs from "node:fs";
 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-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);

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

@@ -1,4 +1,4 @@
-import { ct as EventCategory, et as errMsg, m as addonWidgetsCapability, tt as BaseAddon } from "../../dist-8phgmJ6b.mjs";
+import { Ot as EventCategory, m as addonWidgetsCapability, nt as errMsg, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import * as fs from "node:fs";
 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-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.js");
 //#region src/builtins/alerts/alerts.addon.ts
 var CATEGORY_MAPPINGS = {
 	"addon.crashed": {

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

@@ -1,4 +1,4 @@
-import { ct as EventCategory, et as errMsg, h as alertsCapability, ht as createEvent, n as AlertSchema, tt as BaseAddon } from "../../dist-8phgmJ6b.mjs";
+import { Ot as EventCategory, gt as createEvent, h as alertsCapability, n as AlertSchema, nt as errMsg, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
 //#region src/builtins/alerts/alerts.addon.ts
 var CATEGORY_MAPPINGS = {
 	"addon.crashed": {

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-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.js");
 let node_fs = require("node:fs");
 let node_fs$1 = require_chunk.__toESM(node_fs, 1);
 node_fs = require_chunk.__toESM(node_fs);

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

@@ -1,4 +1,4 @@
-import { ct as EventCategory, tt as BaseAddon, v as backupCapability } from "../../dist-8phgmJ6b.mjs";
+import { Ot as EventCategory, rt as BaseAddon, v as backupCapability } from "../../dist-BWQX9yUj.mjs";
 import * as fs from "node:fs";
 import Kt from "node:fs";
 import * as path$1 from "node:path";

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-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.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 { F as logDestinationCapability, tt as BaseAddon } from "../../dist-8phgmJ6b.mjs";
+import { I as logDestinationCapability, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

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

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.js");
 let _camstack_types_node = require("@camstack/types/node");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

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

@@ -1,4 +1,4 @@
-import { $ as validateExpressionSource, B as parseStreamParamsFormPatch, C as enumerateItemArrayFields, D as getByPath, Et as sleep, G as setByPath, S as deviceStatusCapability, T as evaluateLinkExpression, Z as toExpressionValue, a as DeviceStatusSchema, at as DeviceFeature, b as deviceManagerCapability, bt as isDeviceConfigCap, c as STREAM_PROFILE_META, ct as EventCategory, dt as WELL_KNOWN_TAB_MAP, et as errMsg, g as applyTransform, i as CAP_NAMES_WITH_STATUS, ot as DeviceRole, st as DeviceType, t as ALL_CAPABILITY_DEFINITIONS, tt as BaseAddon, w as enumerateSchemaFields, x as deviceStateCapability, y as buildStreamParamsConfigSchema, z as normalizeUnit } from "../../dist-8phgmJ6b.mjs";
+import { $ as toExpressionValue, B as normalizeUnit, C as enumerateItemArrayFields, Dt as sleep, H as parseStreamParamsFormPatch, O as getByPath, Ot as EventCategory, S as deviceStatusCapability, T as evaluateLinkExpression, a as DeviceStatusSchema, b as deviceManagerCapability, c as STREAM_PROFILE_META, ct as DeviceRole, ft as WELL_KNOWN_TAB_MAP, g as applyTransform, i as CAP_NAMES_WITH_STATUS, lt as DeviceType, nt as errMsg, q as setByPath, rt as BaseAddon, st as DeviceFeature, t as ALL_CAPABILITY_DEFINITIONS, tt as validateExpressionSource, w as enumerateSchemaFields, x as deviceStateCapability, xt as isDeviceConfigCap, y as buildStreamParamsConfigSchema } from "../../dist-BWQX9yUj.mjs";
 import { canonicalDeviceFingerprint } from "@camstack/types/node";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";

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-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.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 { F as logDestinationCapability, tt as BaseAddon } from "../../dist-8phgmJ6b.mjs";
+import { I as logDestinationCapability, rt as BaseAddon } from "../../dist-BWQX9yUj.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/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-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.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,4 +1,4 @@
-import { Q as userManagementCapability, _ as authProviderCapability, d as UserRecordSchema, l as ScopedTokenSchema, r as ApiKeyRecordSchema, tt as BaseAddon } from "../../dist-8phgmJ6b.mjs";
+import { _ as authProviderCapability, d as UserRecordSchema, et as userManagementCapability, l as ScopedTokenSchema, r as ApiKeyRecordSchema, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
 import { createRequire } from "node:module";
 import * as crypto$1 from "node:crypto";
 import { randomUUID } from "node: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-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.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 { P as localNetworkCapability, ct as EventCategory, tt as BaseAddon } from "../../dist-8phgmJ6b.mjs";
+import { F as localNetworkCapability, Ot as EventCategory, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
 import * as os from "node:os";
 //#region src/builtins/local-network/local-network.addon.ts
 /**

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-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");

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

@@ -1,4 +1,4 @@
-import { L as metricsProviderCapability, ct as EventCategory, ht as createEvent, tt as BaseAddon } from "../../dist-8phgmJ6b.mjs";
+import { Ot as EventCategory, R as metricsProviderCapability, gt as createEvent, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
 import * as fs from "node:fs";
 import { execFile, execFileSync } from "node:child_process";
 import { promisify } from "node:util";

package/dist/builtins/platform-probe/coral-accelerators.d.ts

@@ -0,0 +1,22 @@
+import { CoralInfo } from '@camstack/types';
+/**
+ * Filesystem seam for Coral USB Edge TPU detection — mirrors the
+ * `AcceleratorFs` pattern in `intel-accelerators.ts` so the classifier stays a
+ * pure, unit-testable function over injected reads.
+ */
+export interface CoralFs {
+    /** USB device directory names under `/sys/bus/usb/devices` (e.g. `2-4`). */
+    listUsbDevices(): readonly string[];
+    /** Read a `<sysfsNode>/<attr>` value (idVendor / idProduct), trimmed. */
+    readUsbAttr(device: string, attr: string): string;
+    /** Whether a filesystem path exists (the libedgetpu delegate). */
+    exists(path: string): boolean;
+}
+/**
+ * Detect a Coral USB Edge TPU. Present when EITHER a matching USB device is
+ * enumerated OR the libedgetpu delegate is installed (the delegate is the
+ * hub-provisioned runtime prerequisite; on a container whose `/sys` USB view is
+ * limited, its presence is a reliable operator-intent signal that the Coral is
+ * wired through). Returns `null` when neither signal is found.
+ */
+export declare function classifyCoralAccelerator(fsx: CoralFs): CoralInfo | null;

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

@@ -3,13 +3,59 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_child_process = require("node:child_process");
 let node_util = require("node:util");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
+//#region src/builtins/platform-probe/coral-accelerators.ts
+/**
+* Coral USB Edge TPU USB identifiers.
+*
+* The device enumerates as `1a6e:089a` (Global Unichip) BEFORE the libedgetpu
+* firmware loads, then re-enumerates as `18d1:9302` (Google) AFTER. Either id
+* means a Coral is physically attached, so both count as a positive signal.
+*/
+var CORAL_USB_IDS = [{
+	vendor: "1a6e",
+	product: "089a"
+}, {
+	vendor: "18d1",
+	product: "9302"
+}];
+/**
+* Default install path of the libedgetpu delegate on the hub, provisioned
+* out-of-band by `/data/deps/edgetpu-install.sh` (it is a system shared
+* library, not a pip package). Overridable via `CAMSTACK_EDGETPU_LIB` — kept in
+* sync with the Python pool's own default in `inference_pool.py`.
+*/
+var DEFAULT_EDGETPU_LIB = "/data/deps/edgetpu/lib/libedgetpu.so.1";
+/**
+* Detect a Coral USB Edge TPU. Present when EITHER a matching USB device is
+* enumerated OR the libedgetpu delegate is installed (the delegate is the
+* hub-provisioned runtime prerequisite; on a container whose `/sys` USB view is
+* limited, its presence is a reliable operator-intent signal that the Coral is
+* wired through). Returns `null` when neither signal is found.
+*/
+function classifyCoralAccelerator(fsx) {
+	for (const device of fsx.listUsbDevices()) {
+		const vendor = fsx.readUsbAttr(device, "idVendor").toLowerCase();
+		const product = fsx.readUsbAttr(device, "idProduct").toLowerCase();
+		if (CORAL_USB_IDS.some((id) => id.vendor === vendor && id.product === product)) return {
+			type: "coral-edgetpu",
+			bus: "usb"
+		};
+	}
+	const libPath = process.env["CAMSTACK_EDGETPU_LIB"] ?? DEFAULT_EDGETPU_LIB;
+	if (fsx.exists(libPath)) return {
+		type: "coral-edgetpu",
+		bus: "usb"
+	};
+	return null;
+}
+//#endregion
 //#region src/builtins/platform-probe/platform-scorer.ts
 /**
 * Promisified `execFile`. Used across the scorer so every subprocess
@@ -162,6 +208,24 @@ var PlatformScorer = class {
 		} });
 		let gpu = null;
 		let npu = null;
+		const coral = classifyCoralAccelerator({
+			listUsbDevices: () => {
+				try {
+					return node_fs.readdirSync("/sys/bus/usb/devices");
+				} catch {
+					return [];
+				}
+			},
+			readUsbAttr: (device, attr) => {
+				try {
+					return node_fs.readFileSync(`/sys/bus/usb/devices/${device}/${attr}`, "utf8").trim();
+				} catch {
+					return "";
+				}
+			},
+			exists: (p) => node_fs.existsSync(p)
+		});
+		if (coral) this.logger.info("Coral USB Edge TPU detected", { meta: { bus: coral.bus } });
 		if (platform === "darwin" && arch === "arm64") {
 			gpu = {
 				type: "apple",
@@ -220,7 +284,8 @@ var PlatformScorer = class {
 			totalRAM_MB,
 			availableRAM_MB,
 			gpu,
-			npu
+			npu,
+			coral
 		};
 	}
 	/**

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

@@ -1,8 +1,54 @@
-import { V as platformProbeCapability, W as scoreRuntimes, _t as emitReadiness, ct as EventCategory, et as errMsg, tt as BaseAddon } from "../../dist-8phgmJ6b.mjs";
+import { K as scoreRuntimes, Ot as EventCategory, U as platformProbeCapability, nt as errMsg, rt as BaseAddon, vt as emitReadiness } from "../../dist-BWQX9yUj.mjs";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import * as os from "node:os";
+//#region src/builtins/platform-probe/coral-accelerators.ts
+/**
+* Coral USB Edge TPU USB identifiers.
+*
+* The device enumerates as `1a6e:089a` (Global Unichip) BEFORE the libedgetpu
+* firmware loads, then re-enumerates as `18d1:9302` (Google) AFTER. Either id
+* means a Coral is physically attached, so both count as a positive signal.
+*/
+var CORAL_USB_IDS = [{
+	vendor: "1a6e",
+	product: "089a"
+}, {
+	vendor: "18d1",
+	product: "9302"
+}];
+/**
+* Default install path of the libedgetpu delegate on the hub, provisioned
+* out-of-band by `/data/deps/edgetpu-install.sh` (it is a system shared
+* library, not a pip package). Overridable via `CAMSTACK_EDGETPU_LIB` — kept in
+* sync with the Python pool's own default in `inference_pool.py`.
+*/
+var DEFAULT_EDGETPU_LIB = "/data/deps/edgetpu/lib/libedgetpu.so.1";
+/**
+* Detect a Coral USB Edge TPU. Present when EITHER a matching USB device is
+* enumerated OR the libedgetpu delegate is installed (the delegate is the
+* hub-provisioned runtime prerequisite; on a container whose `/sys` USB view is
+* limited, its presence is a reliable operator-intent signal that the Coral is
+* wired through). Returns `null` when neither signal is found.
+*/
+function classifyCoralAccelerator(fsx) {
+	for (const device of fsx.listUsbDevices()) {
+		const vendor = fsx.readUsbAttr(device, "idVendor").toLowerCase();
+		const product = fsx.readUsbAttr(device, "idProduct").toLowerCase();
+		if (CORAL_USB_IDS.some((id) => id.vendor === vendor && id.product === product)) return {
+			type: "coral-edgetpu",
+			bus: "usb"
+		};
+	}
+	const libPath = process.env["CAMSTACK_EDGETPU_LIB"] ?? DEFAULT_EDGETPU_LIB;
+	if (fsx.exists(libPath)) return {
+		type: "coral-edgetpu",
+		bus: "usb"
+	};
+	return null;
+}
+//#endregion
 //#region src/builtins/platform-probe/platform-scorer.ts
 /**
 * Promisified `execFile`. Used across the scorer so every subprocess
@@ -155,6 +201,24 @@ var PlatformScorer = class {
 		} });
 		let gpu = null;
 		let npu = null;
+		const coral = classifyCoralAccelerator({
+			listUsbDevices: () => {
+				try {
+					return fs.readdirSync("/sys/bus/usb/devices");
+				} catch {
+					return [];
+				}
+			},
+			readUsbAttr: (device, attr) => {
+				try {
+					return fs.readFileSync(`/sys/bus/usb/devices/${device}/${attr}`, "utf8").trim();
+				} catch {
+					return "";
+				}
+			},
+			exists: (p) => fs.existsSync(p)
+		});
+		if (coral) this.logger.info("Coral USB Edge TPU detected", { meta: { bus: coral.bus } });
 		if (platform === "darwin" && arch === "arm64") {
 			gpu = {
 				type: "apple",
@@ -213,7 +277,8 @@ var PlatformScorer = class {
 			totalRAM_MB,
 			availableRAM_MB,
 			gpu,
-			npu
+			npu,
+			coral
 		};
 	}
 	/**

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-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.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 { ct as EventCategory, tt as BaseAddon } from "../../dist-8phgmJ6b.mjs";
+import { Ot as EventCategory, rt as BaseAddon } from "../../dist-BWQX9yUj.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" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BDV1WKRg.js");
+const require_dist = require("../../dist-C3uHEBtP.js");
 let node_child_process = require("node:child_process");
 //#region src/builtins/snapshot/snapshot-coalescing.ts
 /**
@@ -200,12 +200,102 @@ function raceForResult(promise, timeoutMs) {
 	});
 }
 //#endregion
+//#region src/builtins/snapshot/snapshot-media-handler.ts
+/**
+* Parse the handler-relative path (`/<deviceId>.jpg?query`) into a request.
+* Returns null for a malformed / nested / non-numeric id so the handler answers
+* 404 without ever reaching `getMedia`.
+*/
+function parseSnapshotMediaRequest(url) {
+	const qIdx = url.indexOf("?");
+	const rawPath = qIdx === -1 ? url : url.slice(0, qIdx);
+	const query = qIdx === -1 ? "" : url.slice(qIdx + 1);
+	const segment = rawPath.replace(/^\/+/, "");
+	if (segment.length === 0 || segment.includes("/")) return null;
+	const idPart = segment.replace(/\.jpe?g$/i, "");
+	if (!/^\d+$/.test(idPart)) return null;
+	const deviceId = Number.parseInt(idPart, 10);
+	if (!Number.isSafeInteger(deviceId)) return null;
+	const params = new URLSearchParams(query);
+	const rawStream = params.get("streamId");
+	const streamId = rawStream !== null && rawStream.length > 0 ? rawStream : void 0;
+	const rawForce = params.get("force");
+	return {
+		deviceId,
+		streamId,
+		force: rawForce === "1" || rawForce === "true"
+	};
+}
+/**
+* Create a data-plane handler that serves per-device snapshots as JPEG images.
+* `deps.getMedia` is called once per request; null → 404, throw → 500. A
+* conditional GET with a matching `If-None-Match` produces a 304.
+*/
+function createSnapshotMediaHandler(deps) {
+	return async (req, res) => {
+		if (req.method !== "GET" && req.method !== "HEAD") {
+			res.writeHead(405, { allow: "GET, HEAD" }).end();
+			return;
+		}
+		const parsed = parseSnapshotMediaRequest(req.url ?? "/");
+		if (parsed === null) {
+			res.writeHead(404).end();
+			return;
+		}
+		let media;
+		try {
+			media = await deps.getMedia(parsed.deviceId, parsed.streamId, parsed.force);
+		} catch {
+			const body = "Internal server error";
+			res.writeHead(500, {
+				"content-type": "text/plain",
+				"content-length": String(Buffer.byteLength(body))
+			});
+			if (req.method === "HEAD") res.end();
+			else res.end(body);
+			return;
+		}
+		if (media === null) {
+			res.writeHead(404).end();
+			return;
+		}
+		const etag = `"${parsed.deviceId}-${media.capturedAt}"`;
+		const cacheControl = `private, max-age=${Math.max(0, Math.floor(media.maxAgeS))}`;
+		if (req.headers["if-none-match"] === etag) {
+			res.writeHead(304, {
+				etag,
+				"cache-control": cacheControl
+			}).end();
+			return;
+		}
+		res.writeHead(200, {
+			"content-type": media.contentType,
+			"cache-control": cacheControl,
+			etag,
+			"content-length": String(media.bytes.byteLength)
+		});
+		if (req.method === "HEAD") res.end();
+		else res.end(Buffer.from(media.bytes));
+	};
+}
+//#endregion
 //#region src/builtins/snapshot/snapshot.addon.ts
 /** Default cache window for non-battery cams (seconds). 10s feels live. */
 var NON_BATTERY_DEFAULT_MAX_AGE_S = 10;
 /** Default cache window for battery cams (seconds). 1h ≈ "don't wake the cam unless asked". */
 var BATTERY_DEFAULT_MAX_AGE_S = 3600;
 /**
+* Effective per-device max cache age (seconds): the operator override
+* (`snapshotMaxAgeS`) when a finite non-negative number, else the battery-aware
+* default. Shared by the freshness gate (`getSnapshot`) and the HTTP endpoint's
+* `Cache-Control: max-age` (so the browser/`expo-image` layer caches for exactly
+* as long as the wrapper considers the frame fresh).
+*/
+function effectiveMaxAgeS(prefs, isBattery) {
+	const def = isBattery ? BATTERY_DEFAULT_MAX_AGE_S : NON_BATTERY_DEFAULT_MAX_AGE_S;
+	return typeof prefs.snapshotMaxAgeS === "number" && prefs.snapshotMaxAgeS >= 0 ? prefs.snapshotMaxAgeS : def;
+}
+/**
 * SnapshotAddon — wrapper over the `snapshot` capability.
 *
 * Activated per-device (toggleable by user; default active). When active,
@@ -245,25 +335,86 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 	*/
 	ownerCache = null;
 	static OWNER_CACHE_TTL_MS = 3e4;
+	/**
+	* Handle for the `/addon/snapshot/media/<deviceId>.jpg` HTTP data-plane
+	* endpoint (§3.1). Null when the host provides no `ctx.dataPlane` facility
+	* (the tRPC `getSnapshot` base64 surface still works — the endpoint is a
+	* strictly-additive delivery path). Disposed on shutdown.
+	*/
+	mediaDataPlane = null;
 	constructor() {
 		super({ staleTtlMs: 6e4 });
 	}
 	async onInitialize() {
 		this.ctx.logger.info("Snapshot wrapper initialized");
+		const provider = {
+			getSnapshot: (input) => this.getSnapshot(input),
+			invalidateCache: (input) => this.invalidateCache(input),
+			getDeviceSettingsContribution: (input) => this.buildDeviceSettingsContribution(input.deviceId),
+			getDeviceLiveContribution: async () => null,
+			applyDeviceSettingsPatch: (input) => this.saveDeviceSettingsPatch(input.deviceId, input.patch),
+			getStatus: async (input) => this.getStatus(input.deviceId),
+			getSnapshotOverview: (input) => this.getSnapshotOverview(input)
+		};
+		await this.serveMediaDataPlane();
 		return [{
 			capability: require_dist.snapshotCapability,
-			provider: {
-				getSnapshot: (input) => this.getSnapshot(input),
-				invalidateCache: (input) => this.invalidateCache(input),
-				getDeviceSettingsContribution: (input) => this.buildDeviceSettingsContribution(input.deviceId),
-				getDeviceLiveContribution: async () => null,
-				applyDeviceSettingsPatch: (input) => this.saveDeviceSettingsPatch(input.deviceId, input.patch),
-				getStatus: async (input) => this.getStatus(input.deviceId),
-				getSnapshotOverview: (input) => this.getSnapshotOverview(input)
-			}
+			provider
 		}];
 	}
+	/**
+	* Serve the per-device snapshot image endpoint on the addon data-plane
+	* (§3.1). Delivery: `GET /addon/snapshot/media/<deviceId>.jpg` → raw JPEG with
+	* `ETag` + `Cache-Control: private, max-age=<device maxAgeS>`, so a grid is N
+	* independent `<Image>` tiles served from the coalesced server cache (no
+	* base64 tax, no batch head-of-line blocking, browser/`expo-image` caching for
+	* free). Best-effort: a host without a `dataPlane` facility keeps the tRPC
+	* base64 path.
+	*/
+	async serveMediaDataPlane() {
+		const handler = createSnapshotMediaHandler({ getMedia: (deviceId, streamId, force) => this.resolveSnapshotMedia(deviceId, streamId, force) });
+		try {
+			this.mediaDataPlane = await this.ctx.dataPlane?.serve({
+				prefix: "media",
+				access: "authenticated",
+				handler
+			}) ?? null;
+			this.ctx.logger.info("snapshot media data-plane served", { meta: { baseUrl: this.mediaDataPlane ? `/addon/${this.ctx.id}/media` : "(no dataPlane facility)" } });
+		} catch (err) {
+			this.ctx.logger.warn("snapshot media data-plane failed to serve", { meta: { error: require_dist.errMsg(err) } });
+			this.mediaDataPlane = null;
+		}
+	}
+	/**
+	* Resolve a device (+ optional stream, + force) to renderable JPEG bytes for
+	* the HTTP endpoint. Runs the same coalesced capture ladder as the tRPC
+	* `getSnapshot` (so every consumer shares one upstream pull), then decodes the
+	* base64 cache into raw bytes and stamps the frame identity: `capturedAt` from
+	* the cache entry (matching the ETag `getSnapshotOverview` advertises) and the
+	* effective per-device `maxAgeS` for `Cache-Control`. Null → 404.
+	*/
+	async resolveSnapshotMedia(deviceId, streamId, force) {
+		const image = await this.getSnapshot({
+			deviceId,
+			...streamId !== void 0 ? { streamId } : {},
+			force
+		});
+		if (!image) return null;
+		const capturedAt = this.cache.get(deviceId)?.ts ?? Date.now();
+		const prefs = await this.readDeviceSettings(deviceId).catch(() => ({}));
+		const isBattery = (await this.lookupDeviceMeta(deviceId))?.isBattery ?? false;
+		return {
+			bytes: Buffer.from(image.base64, "base64"),
+			contentType: image.contentType,
+			capturedAt,
+			maxAgeS: effectiveMaxAgeS(prefs, isBattery)
+		};
+	}
 	async onShutdown() {
+		if (this.mediaDataPlane) {
+			await this.mediaDataPlane.dispose().catch(() => void 0);
+			this.mediaDataPlane = null;
+		}
 		this.cache.clear();
 		this.captureFlight.clear();
 		this.ownerCache = null;
@@ -316,8 +467,7 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 			tags: { deviceId },
 			meta: { stream: effectiveStreamId ?? "auto" }
 		});
-		const defaultMaxAgeS = isBatteryDevice ? BATTERY_DEFAULT_MAX_AGE_S : NON_BATTERY_DEFAULT_MAX_AGE_S;
-		const effectiveMaxAgeMs = (typeof prefs.snapshotMaxAgeS === "number" && prefs.snapshotMaxAgeS >= 0 ? prefs.snapshotMaxAgeS : defaultMaxAgeS) * 1e3;
+		const effectiveMaxAgeMs = effectiveMaxAgeS(prefs, isBatteryDevice) * 1e3;
 		const decision = decideSnapshotServe({
 			now,
 			cachedAt: hit?.ts ?? null,